@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ai/Agent.json

@@ -343,6 +343,209 @@
         "organization",
         "private"
       ]
+    },
+    "planning": {
+      "description": "Autonomous reasoning and planning configuration",
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "default": "react",
+          "description": "Autonomous reasoning strategy",
+          "type": "string",
+          "enum": [
+            "react",
+            "plan_and_execute",
+            "reflexion",
+            "tree_of_thought"
+          ]
+        },
+        "maxIterations": {
+          "default": 10,
+          "description": "Maximum planning loop iterations",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "allowReplan": {
+          "default": true,
+          "description": "Allow dynamic re-planning based on intermediate results",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "strategy",
+        "maxIterations",
+        "allowReplan"
+      ],
+      "additionalProperties": false
+    },
+    "memory": {
+      "description": "Agent memory management",
+      "type": "object",
+      "properties": {
+        "shortTerm": {
+          "description": "Short-term / working memory",
+          "type": "object",
+          "properties": {
+            "maxMessages": {
+              "default": 50,
+              "description": "Max recent messages in working memory",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "maxTokens": {
+              "description": "Max tokens for short-term context window",
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "maxMessages"
+          ],
+          "additionalProperties": false
+        },
+        "longTerm": {
+          "description": "Long-term / persistent memory",
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "default": false,
+              "description": "Enable long-term memory persistence",
+              "type": "boolean"
+            },
+            "store": {
+              "default": "vector",
+              "description": "Long-term memory storage backend",
+              "type": "string",
+              "enum": [
+                "vector",
+                "database",
+                "redis"
+              ]
+            },
+            "maxEntries": {
+              "description": "Max entries in long-term memory",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "enabled",
+            "store"
+          ],
+          "additionalProperties": false
+        },
+        "reflectionInterval": {
+          "description": "Reflect every N interactions to improve behavior",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "additionalProperties": false
+    },
+    "guardrails": {
+      "description": "Safety guardrails for the agent",
+      "type": "object",
+      "properties": {
+        "maxTokensPerInvocation": {
+          "description": "Token budget per single invocation",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "maxExecutionTimeSec": {
+          "description": "Max execution time in seconds",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "blockedTopics": {
+          "description": "Forbidden topics or action names",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "structuredOutput": {
+      "description": "Structured output format and validation configuration",
+      "type": "object",
+      "properties": {
+        "format": {
+          "type": "string",
+          "enum": [
+            "json_object",
+            "json_schema",
+            "regex",
+            "grammar",
+            "xml"
+          ],
+          "description": "Expected output format"
+        },
+        "schema": {
+          "description": "JSON Schema definition for output",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "strict": {
+          "default": false,
+          "description": "Enforce exact schema compliance",
+          "type": "boolean"
+        },
+        "retryOnValidationFailure": {
+          "default": true,
+          "description": "Retry generation when output fails validation",
+          "type": "boolean"
+        },
+        "maxRetries": {
+          "default": 3,
+          "description": "Maximum retries on validation failure",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "fallbackFormat": {
+          "description": "Fallback format if primary format fails",
+          "type": "string",
+          "enum": [
+            "json_object",
+            "json_schema",
+            "regex",
+            "grammar",
+            "xml"
+          ]
+        },
+        "transformPipeline": {
+          "description": "Post-processing steps applied to output",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "trim",
+              "parse_json",
+              "validate",
+              "coerce_types"
+            ],
+            "description": "Post-processing step for structured output"
+          }
+        }
+      },
+      "required": [
+        "format",
+        "strict",
+        "retryOnValidationFailure",
+        "maxRetries"
+      ],
+      "additionalProperties": false
     }
   },
   "required": [

package/json-schema/ai/AgentCommunicationProtocol.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "message_passing",
+    "shared_memory",
+    "blackboard"
+  ]
+}

package/json-schema/ai/AgentGroupMember.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "agentId": {
+      "type": "string",
+      "description": "Agent identifier (reference to AgentSchema.name)"
+    },
+    "role": {
+      "type": "string",
+      "enum": [
+        "coordinator",
+        "specialist",
+        "critic",
+        "executor"
+      ],
+      "description": "Agent role within the group"
+    },
+    "capabilities": {
+      "description": "List of capabilities this agent contributes",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "dependencies": {
+      "description": "Agent IDs this agent depends on for input",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "priority": {
+      "description": "Execution priority (0 = highest)",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "agentId",
+    "role"
+  ],
+  "additionalProperties": false
+}

package/json-schema/ai/AgentGroupRole.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "coordinator",
+    "specialist",
+    "critic",
+    "executor"
+  ]
+}

package/json-schema/ai/DevOpsAgent.json

@@ -344,6 +344,209 @@
         "private"
       ]
     },
+    "planning": {
+      "description": "Autonomous reasoning and planning configuration",
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "default": "react",
+          "description": "Autonomous reasoning strategy",
+          "type": "string",
+          "enum": [
+            "react",
+            "plan_and_execute",
+            "reflexion",
+            "tree_of_thought"
+          ]
+        },
+        "maxIterations": {
+          "default": 10,
+          "description": "Maximum planning loop iterations",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "allowReplan": {
+          "default": true,
+          "description": "Allow dynamic re-planning based on intermediate results",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "strategy",
+        "maxIterations",
+        "allowReplan"
+      ],
+      "additionalProperties": false
+    },
+    "memory": {
+      "description": "Agent memory management",
+      "type": "object",
+      "properties": {
+        "shortTerm": {
+          "description": "Short-term / working memory",
+          "type": "object",
+          "properties": {
+            "maxMessages": {
+              "default": 50,
+              "description": "Max recent messages in working memory",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "maxTokens": {
+              "description": "Max tokens for short-term context window",
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "maxMessages"
+          ],
+          "additionalProperties": false
+        },
+        "longTerm": {
+          "description": "Long-term / persistent memory",
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "default": false,
+              "description": "Enable long-term memory persistence",
+              "type": "boolean"
+            },
+            "store": {
+              "default": "vector",
+              "description": "Long-term memory storage backend",
+              "type": "string",
+              "enum": [
+                "vector",
+                "database",
+                "redis"
+              ]
+            },
+            "maxEntries": {
+              "description": "Max entries in long-term memory",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "enabled",
+            "store"
+          ],
+          "additionalProperties": false
+        },
+        "reflectionInterval": {
+          "description": "Reflect every N interactions to improve behavior",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "additionalProperties": false
+    },
+    "guardrails": {
+      "description": "Safety guardrails for the agent",
+      "type": "object",
+      "properties": {
+        "maxTokensPerInvocation": {
+          "description": "Token budget per single invocation",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "maxExecutionTimeSec": {
+          "description": "Max execution time in seconds",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "blockedTopics": {
+          "description": "Forbidden topics or action names",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "structuredOutput": {
+      "description": "Structured output format and validation configuration",
+      "type": "object",
+      "properties": {
+        "format": {
+          "type": "string",
+          "enum": [
+            "json_object",
+            "json_schema",
+            "regex",
+            "grammar",
+            "xml"
+          ],
+          "description": "Expected output format"
+        },
+        "schema": {
+          "description": "JSON Schema definition for output",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "strict": {
+          "default": false,
+          "description": "Enforce exact schema compliance",
+          "type": "boolean"
+        },
+        "retryOnValidationFailure": {
+          "default": true,
+          "description": "Retry generation when output fails validation",
+          "type": "boolean"
+        },
+        "maxRetries": {
+          "default": 3,
+          "description": "Maximum retries on validation failure",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "fallbackFormat": {
+          "description": "Fallback format if primary format fails",
+          "type": "string",
+          "enum": [
+            "json_object",
+            "json_schema",
+            "regex",
+            "grammar",
+            "xml"
+          ]
+        },
+        "transformPipeline": {
+          "description": "Post-processing steps applied to output",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "trim",
+              "parse_json",
+              "validate",
+              "coerce_types"
+            ],
+            "description": "Post-processing step for structured output"
+          }
+        }
+      },
+      "required": [
+        "format",
+        "strict",
+        "retryOnValidationFailure",
+        "maxRetries"
+      ],
+      "additionalProperties": false
+    },
     "developmentConfig": {
       "type": "object",
       "properties": {

package/json-schema/ai/MCPClientConfig.json

@@ -773,6 +773,126 @@
             "type": "string",
             "format": "date-time",
             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "streaming": {
+            "description": "Streaming configuration",
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable streaming for MCP communication"
+              },
+              "chunkSize": {
+                "description": "Size of each streamed chunk in bytes",
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "heartbeatIntervalMs": {
+                "default": 30000,
+                "description": "Heartbeat interval in milliseconds",
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "backpressure": {
+                "description": "Backpressure handling strategy",
+                "type": "string",
+                "enum": [
+                  "drop",
+                  "buffer",
+                  "block"
+                ]
+              }
+            },
+            "required": [
+              "enabled",
+              "heartbeatIntervalMs"
+            ],
+            "additionalProperties": false
+          },
+          "toolApproval": {
+            "description": "Tool approval configuration",
+            "type": "object",
+            "properties": {
+              "requireApproval": {
+                "default": false,
+                "description": "Require approval before tool execution",
+                "type": "boolean"
+              },
+              "approvalStrategy": {
+                "type": "string",
+                "enum": [
+                  "human_in_loop",
+                  "auto_approve",
+                  "policy_based"
+                ],
+                "description": "Approval strategy for tool execution"
+              },
+              "dangerousToolPatterns": {
+                "description": "Regex patterns for tools needing approval",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "autoApproveTimeout": {
+                "description": "Auto-approve timeout in seconds",
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "requireApproval",
+              "approvalStrategy"
+            ],
+            "additionalProperties": false
+          },
+          "sampling": {
+            "description": "LLM sampling configuration",
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable LLM sampling"
+              },
+              "maxTokens": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "description": "Maximum tokens to generate"
+              },
+              "temperature": {
+                "description": "Sampling temperature",
+                "type": "number",
+                "minimum": 0,
+                "maximum": 2
+              },
+              "stopSequences": {
+                "description": "Stop sequences to end generation",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "modelPreferences": {
+                "description": "Preferred model IDs in priority order",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "systemPrompt": {
+                "description": "System prompt for sampling context",
+                "type": "string"
+              }
+            },
+            "required": [
+              "enabled",
+              "maxTokens"
+            ],
+            "additionalProperties": false
           }
         },
         "required": [
@@ -833,6 +953,54 @@
         "warn",
         "error"
       ]
+    },
+    "roots": {
+      "description": "Root directories/resources configuration",
+      "type": "object",
+      "properties": {
+        "roots": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "uri": {
+                "type": "string",
+                "description": "Root URI (e.g., file:///path/to/project)"
+              },
+              "name": {
+                "description": "Human-readable root name",
+                "type": "string"
+              },
+              "readOnly": {
+                "description": "Whether the root is read-only",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "uri"
+            ],
+            "additionalProperties": false,
+            "description": "A single root directory or resource"
+          },
+          "description": "Root directories or resources available to the client"
+        },
+        "watchForChanges": {
+          "default": false,
+          "description": "Watch root directories for filesystem changes",
+          "type": "boolean"
+        },
+        "notifyOnChange": {
+          "default": true,
+          "description": "Notify server when root contents change",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "roots",
+        "watchForChanges",
+        "notifyOnChange"
+      ],
+      "additionalProperties": false
     }
   },
   "required": [

package/json-schema/ai/MCPRootEntry.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "uri": {
+      "type": "string",
+      "description": "Root URI (e.g., file:///path/to/project)"
+    },
+    "name": {
+      "description": "Human-readable root name",
+      "type": "string"
+    },
+    "readOnly": {
+      "description": "Whether the root is read-only",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "uri"
+  ],
+  "additionalProperties": false,
+  "description": "A single root directory or resource"
+}