@objectstack/spec 2.0.6 → 2.0.7

package/json-schema/ai/MCPRootsConfig.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Roots configuration for MCP client"
+}

package/json-schema/ai/MCPSamplingConfig.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Sampling configuration for MCP"
+}

package/json-schema/ai/MCPServerConfig.json

@@ -768,6 +768,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": [

package/json-schema/ai/MCPStreamingConfig.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Streaming configuration for MCP communication"
+}

package/json-schema/ai/MCPToolApproval.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Tool approval configuration for MCP"
+}

package/json-schema/ai/MultiAgentGroup.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z_][a-z0-9_]*$",
+      "description": "Group unique identifier (snake_case)"
+    },
+    "label": {
+      "type": "string",
+      "description": "Group display name"
+    },
+    "description": {
+      "type": "string"
+    },
+    "strategy": {
+      "type": "string",
+      "enum": [
+        "sequential",
+        "parallel",
+        "debate",
+        "hierarchical",
+        "swarm"
+      ],
+      "description": "Multi-agent orchestration strategy"
+    },
+    "agents": {
+      "minItems": 2,
+      "type": "array",
+      "items": {
+        "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
+      },
+      "description": "Agent members (minimum 2)"
+    },
+    "communication": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "enum": [
+            "message_passing",
+            "shared_memory",
+            "blackboard"
+          ],
+          "description": "Inter-agent communication protocol"
+        },
+        "messageQueue": {
+          "description": "Message queue identifier for async communication",
+          "type": "string"
+        },
+        "maxRounds": {
+          "description": "Maximum communication rounds before forced termination",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "protocol"
+      ],
+      "additionalProperties": false,
+      "description": "Communication configuration"
+    },
+    "conflictResolution": {
+      "description": "How conflicts between agents are resolved",
+      "type": "string",
+      "enum": [
+        "voting",
+        "priorityBased",
+        "consensusBased",
+        "coordinatorDecides"
+      ]
+    },
+    "timeout": {
+      "description": "Maximum execution time in seconds for the group",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "active": {
+      "default": true,
+      "description": "Whether this agent group is active",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "name",
+    "label",
+    "strategy",
+    "agents",
+    "communication",
+    "active"
+  ],
+  "additionalProperties": false
+}

package/json-schema/ai/StructuredOutputConfig.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Structured output configuration for agent responses"
+}

package/json-schema/ai/StructuredOutputFormat.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "json_object",
+    "json_schema",
+    "regex",
+    "grammar",
+    "xml"
+  ],
+  "description": "Output format for structured agent responses"
+}

package/json-schema/ai/TransformPipelineStep.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "trim",
+    "parse_json",
+    "validate",
+    "coerce_types"
+  ],
+  "description": "Post-processing step for structured output"
+}