universal-ai-brain
Version:
🧠UNIVERSAL AI BRAIN 3.3 - The world's most advanced cognitive architecture with 24 specialized systems, MongoDB 8.1 $rankFusion hybrid search, latest Voyage 3.5 embeddings, and framework-agnostic design. Works with Mastra, Vercel AI, LangChain, OpenAI A
455 lines (454 loc) • 13 kB
JSON
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "agent_goal_hierarchies.schema.json",
"title": "Agent Goal Hierarchies Schema",
"description": "Schema for hierarchical goal management with materialized paths and tree operations",
"type": "object",
"required": [
"agentId",
"path",
"level",
"goal",
"status",
"progress",
"timeline",
"dependencies",
"successCriteria",
"context",
"learning",
"metadata"
],
"properties": {
"_id": {
"type": "string",
"description": "MongoDB ObjectId"
},
"agentId": {
"type": "string",
"description": "Unique identifier for the agent",
"minLength": 1,
"maxLength": 100
},
"sessionId": {
"type": "string",
"description": "Session identifier for goal tracking",
"minLength": 1,
"maxLength": 100
},
"path": {
"type": "string",
"description": "Materialized path for hierarchical structure",
"pattern": "^/root(/[a-zA-Z0-9_-]+)*$",
"maxLength": 500
},
"parentId": {
"type": "string",
"description": "Parent goal ObjectId"
},
"level": {
"type": "integer",
"description": "Hierarchy level (0 = root, 1 = top-level, etc.)",
"minimum": 0,
"maximum": 10
},
"goal": {
"type": "object",
"description": "Goal definition and metadata",
"required": ["title", "description", "type", "priority", "category"],
"properties": {
"title": {
"type": "string",
"description": "Goal title",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"description": "Detailed goal description",
"minLength": 1,
"maxLength": 1000
},
"type": {
"type": "string",
"description": "Type of goal",
"enum": ["objective", "task", "milestone", "action", "constraint"]
},
"priority": {
"type": "string",
"description": "Goal priority level",
"enum": ["critical", "high", "medium", "low"]
},
"category": {
"type": "string",
"description": "Goal category",
"maxLength": 100
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"description": "Current goal status",
"enum": ["not_started", "in_progress", "blocked", "completed", "failed", "cancelled"]
},
"progress": {
"type": "object",
"description": "Goal progress tracking",
"required": ["percentage", "completedSubGoals", "totalSubGoals", "lastUpdated"],
"properties": {
"percentage": {
"type": "number",
"description": "Progress percentage (0-100)",
"minimum": 0,
"maximum": 100
},
"completedSubGoals": {
"type": "integer",
"description": "Number of completed sub-goals",
"minimum": 0
},
"totalSubGoals": {
"type": "integer",
"description": "Total number of sub-goals",
"minimum": 0
},
"lastUpdated": {
"type": "string",
"format": "date-time",
"description": "When progress was last updated"
}
},
"additionalProperties": false
},
"timeline": {
"type": "object",
"description": "Goal timeline and scheduling",
"required": ["estimatedDuration"],
"properties": {
"estimatedDuration": {
"type": "number",
"description": "Estimated duration in minutes",
"minimum": 0
},
"actualDuration": {
"type": "number",
"description": "Actual duration in minutes",
"minimum": 0
},
"startTime": {
"type": "string",
"format": "date-time",
"description": "When goal was started"
},
"endTime": {
"type": "string",
"format": "date-time",
"description": "When goal was completed"
},
"deadline": {
"type": "string",
"format": "date-time",
"description": "Goal deadline"
}
},
"additionalProperties": false
},
"dependencies": {
"type": "object",
"description": "Goal dependencies and relationships",
"required": ["requiredGoals", "blockedBy", "enables", "conflicts"],
"properties": {
"requiredGoals": {
"type": "array",
"description": "Goals that must be completed first",
"items": {
"type": "string"
},
"maxItems": 20
},
"blockedBy": {
"type": "array",
"description": "Goals currently blocking this one",
"items": {
"type": "string"
},
"maxItems": 10
},
"enables": {
"type": "array",
"description": "Goals that this one enables",
"items": {
"type": "string"
},
"maxItems": 20
},
"conflicts": {
"type": "array",
"description": "Goals that conflict with this one",
"items": {
"type": "string"
},
"maxItems": 10
}
},
"additionalProperties": false
},
"successCriteria": {
"type": "object",
"description": "Success criteria and verification",
"required": ["conditions", "verification"],
"properties": {
"conditions": {
"type": "array",
"description": "Success conditions",
"items": {
"type": "object",
"required": ["type", "description", "target", "achieved"],
"properties": {
"type": {
"type": "string",
"enum": ["metric", "boolean", "threshold", "approval"]
},
"description": {
"type": "string",
"maxLength": 500
},
"target": {
"description": "Target value for success"
},
"current": {
"description": "Current value"
},
"achieved": {
"type": "boolean",
"description": "Whether condition is achieved"
}
}
},
"maxItems": 10
},
"verification": {
"type": "string",
"description": "How success is verified",
"enum": ["automatic", "manual", "external"]
}
},
"additionalProperties": false
},
"context": {
"type": "object",
"description": "Goal context and reasoning",
"required": ["trigger", "reasoning", "assumptions", "risks"],
"properties": {
"trigger": {
"type": "string",
"description": "What initiated this goal",
"maxLength": 500
},
"reasoning": {
"type": "string",
"description": "Why this goal is important",
"maxLength": 1000
},
"assumptions": {
"type": "array",
"description": "Assumptions made",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 10
},
"risks": {
"type": "array",
"description": "Identified risks",
"items": {
"type": "object",
"required": ["description", "probability", "impact"],
"properties": {
"description": {
"type": "string",
"maxLength": 300
},
"probability": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"impact": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"mitigation": {
"type": "string",
"maxLength": 300
}
}
},
"maxItems": 5
}
},
"additionalProperties": false
},
"learning": {
"type": "object",
"description": "Learning and adaptation data",
"required": ["difficulty", "satisfaction", "lessons", "improvements"],
"properties": {
"difficulty": {
"type": "number",
"description": "How difficult was this goal (0-1)",
"minimum": 0,
"maximum": 1
},
"satisfaction": {
"type": "number",
"description": "Satisfaction with outcome (0-1)",
"minimum": 0,
"maximum": 1
},
"lessons": {
"type": "array",
"description": "Lessons learned",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 10
},
"improvements": {
"type": "array",
"description": "Suggested improvements",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 10
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"description": "Goal metadata",
"required": ["framework", "createdBy", "tags", "version"],
"properties": {
"framework": {
"type": "string",
"description": "AI framework used",
"enum": ["mastra", "vercel-ai", "langchain", "openai-agents", "custom"]
},
"createdBy": {
"type": "string",
"description": "Who created this goal",
"enum": ["agent", "user", "system"]
},
"tags": {
"type": "array",
"description": "Goal tags",
"items": {
"type": "string",
"maxLength": 50
},
"maxItems": 10
},
"version": {
"type": "string",
"description": "Schema version",
"pattern": "^\\d+\\.\\d+\\.\\d+$"
}
},
"additionalProperties": false
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "When this document was created"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "When this document was last updated"
}
},
"additionalProperties": false,
"examples": [
{
"agentId": "customer-support-agent-001",
"sessionId": "session_goal_123",
"path": "/root/customer_service/resolve_billing_issue",
"level": 2,
"goal": {
"title": "Resolve Customer Billing Issue",
"description": "Help customer understand and resolve their billing discrepancy",
"type": "task",
"priority": "high",
"category": "customer_service"
},
"status": "in_progress",
"progress": {
"percentage": 60,
"completedSubGoals": 3,
"totalSubGoals": 5,
"lastUpdated": "2024-01-15T10:30:00Z"
},
"timeline": {
"estimatedDuration": 30,
"actualDuration": 25,
"startTime": "2024-01-15T10:00:00Z",
"deadline": "2024-01-15T11:00:00Z"
},
"dependencies": {
"requiredGoals": [],
"blockedBy": [],
"enables": ["follow_up_satisfaction_survey"],
"conflicts": []
},
"successCriteria": {
"conditions": [
{
"type": "boolean",
"description": "Customer understands the billing",
"target": true,
"current": true,
"achieved": true
},
{
"type": "metric",
"description": "Customer satisfaction score",
"target": 4,
"current": 4.2,
"achieved": true
}
],
"verification": "manual"
},
"context": {
"trigger": "Customer complaint about billing discrepancy",
"reasoning": "Customer satisfaction is critical for retention",
"assumptions": ["Customer has access to billing portal", "Issue is resolvable"],
"risks": [
{
"description": "Customer may escalate if not resolved quickly",
"probability": 0.3,
"impact": 0.7,
"mitigation": "Escalate to supervisor if needed"
}
]
},
"learning": {
"difficulty": 0.6,
"satisfaction": 0.8,
"lessons": ["Customer was confused about new billing format"],
"improvements": ["Provide clearer billing explanations upfront"]
},
"metadata": {
"framework": "mastra",
"createdBy": "agent",
"tags": ["billing", "customer_service", "urgent"],
"version": "1.0.0"
}
}
]
}