@agentproto/corpus-cli 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/specs/resources/aip-48/draft/MultiAgentRuntime.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-48/MultiAgentRuntime.schema.json",
+  "title": "MultiAgentRuntime",
+  "description": "Manifest format for agentruntimes/v1 — a composable multi-agent execution kernel. See AIP-48.",
+  "type": "object",
+  "required": ["schema", "kind", "id", "participants", "substrate", "dispatcher"],
+  "additionalProperties": true,
+  "properties": {
+    "schema": {
+      "const": "agentruntimes/v1",
+      "description": "Schema discriminator. MUST be 'agentruntimes/v1'."
+    },
+    "kind": {
+      "const": "MultiAgentRuntime",
+      "description": "Kind discriminator. MUST be 'MultiAgentRuntime'."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Unique slug for this runtime within its scope. Lower-kebab."
+    },
+    "participants": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/Participant" }
+    },
+    "substrate": { "$ref": "#/$defs/AdapterConfig" },
+    "dispatcher": { "$ref": "#/$defs/AdapterConfig" },
+    "state": { "$ref": "#/$defs/AdapterConfig" },
+    "lifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "onTurnEnd": { "type": "boolean" },
+        "onMention": { "type": "boolean" },
+        "onIdle": { "type": "boolean" }
+      },
+      "description": "Advisory flags — whether the runtime's lifecycle hooks should fire. Adapter implementations decide what onTurnEnd / onMention / onIdle actually do."
+    },
+    "effectors": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/EffectorBinding" }
+    },
+    "provisioning": { "$ref": "#/$defs/AdapterConfig" }
+  },
+  "$defs": {
+    "Participant": {
+      "type": "object",
+      "required": ["id", "executor"],
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]*$",
+          "description": "Stable id used in mentions and self-skip. Lower-kebab + underscore."
+        },
+        "executor": {
+          "type": "string",
+          "description": "Key into the runtime's adapter registry. Examples: 'agent-cli', 'db-operator', 'inline'."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Human name. The mention dispatcher matches @<displayName> exactly (case-sensitive substring) and falls back to first-word matching for multi-word names."
+        },
+        "role": {
+          "type": "string",
+          "description": "Path to an AIP-47 ROLE.md (preferred) or inline role text. Paths resolve relative to the manifest directory."
+        },
+        "meta": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Adapter-specific extras — operator id, runtime ref slug, capability tags."
+        }
+      }
+    },
+    "AdapterConfig": {
+      "type": "object",
+      "required": ["kind"],
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "Adapter kind. The runtime registry resolves this to an implementation."
+        }
+      },
+      "description": "Adapter configuration block. Schema is open by design — each adapter validates its own additional fields."
+    },
+    "EffectorBinding": {
+      "type": "object",
+      "required": ["participantId", "tools"],
+      "additionalProperties": false,
+      "properties": {
+        "participantId": { "type": "string" },
+        "tools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Tool names this participant may invoke at execution time."
+        },
+        "mcpServers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Optional list of MCP server ids whose tools are available to this participant."
+        }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-5/draft/TEMPLATE.schema.json

@@ -0,0 +1,231 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-5/TEMPLATE.schema.json",
+  "title": "CANVAKIT.md frontmatter (AIP-5)",
+  "description": "Validates the YAML frontmatter portion of an AIP-5 *.canvakit.* template.",
+  "type": "object",
+  "required": ["template", "name", "version"],
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "canvakit/v1",
+      "description": "Spec version pin. Hosts that find an unknown schema MUST refuse rather than guess."
+    },
+    "template": {
+      "type": "boolean",
+      "const": true,
+      "description": "Required marker. Tooling that loads files by glob uses this to catch 'renamed but not a template' mistakes."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 64,
+      "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+      "description": "Slug-safe machine name. Lowercase, digits, dashes."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$",
+      "description": "Semver. Bump on breaking change to the rendered shape or variables contract."
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 2000,
+      "description": "One-sentence purpose for the gallery card."
+    },
+    "author": {
+      "type": "string",
+      "description": "Optional locally; required for gallery publish — (author, name, version) is the canonical key."
+    },
+    "renderer": {
+      "enum": ["mustache", "handlebars", "mdx"],
+      "default": "mustache",
+      "description": "Template engine. v1 default 'mustache' is universally supported; others are spec-legal but optional."
+    },
+    "design": {
+      "type": "string",
+      "description": "Designkit fallback hint. Used only when no workspace design is active. Schemes: dk:<preset>, ws:<path>, kit:<slug>, or a bare *.md path."
+    },
+    "forceDesign": {
+      "type": "string",
+      "description": "Designkit override. Bypasses workspace selection. Same scheme grammar as 'design'."
+    },
+    "refreshEvery": {
+      "anyOf": [
+        { "enum": ["manual", "on-tool-change"] },
+        {
+          "type": "string",
+          "pattern": "^\\d+(ms|s|m|h)$",
+          "description": "Duration string — e.g. 60s, 5m, 1h."
+        }
+      ],
+      "default": "manual",
+      "description": "Declarative cadence hint. Honored opportunistically; runtimes that can't honor SHOULD treat as 'manual'."
+    },
+    "variables": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/variable" },
+      "default": {},
+      "description": "Caller inputs with author defaults. Substituted into sources params before resolution."
+    },
+    "sources": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/source" },
+      "default": {},
+      "description": "Named data sources resolved in parallel and merged into the render context."
+    },
+    "imports": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/import" },
+      "default": {},
+      "description": "Nested canvases. Each renders in isolation; output exposed under {{{imports.<name>}}}."
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+      "default": []
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "default": {},
+      "description": "Host-specific extension surface. Other hosts MUST tolerate unknown metadata.<host>.* keys."
+    }
+  },
+  "$defs": {
+    "variable": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "type": { "enum": ["string", "number", "boolean", "object", "array"] },
+        "required": { "type": "boolean", "default": false },
+        "default": {},
+        "description": { "type": "string" }
+      }
+    },
+    "source": {
+      "oneOf": [
+        { "$ref": "#/$defs/sourceTool" },
+        { "$ref": "#/$defs/sourceStatic" },
+        { "$ref": "#/$defs/sourceFile" },
+        { "$ref": "#/$defs/sourceQuery" }
+      ],
+      "description": "Discriminated by 'kind'. One of: tool, static, file, query."
+    },
+    "sourceTool": {
+      "type": "object",
+      "required": ["kind", "ref"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "tool" },
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Tool identifier. Flat ('searchFlights'), namespaced ('stripe.mrr'), or MCP-qualified ('mcp://server/tool'). Resolution: exact > longest wildcard > MCP."
+        },
+        "params": {
+          "type": "object",
+          "additionalProperties": true,
+          "default": {},
+          "description": "JSON params passed verbatim to the resolver. String values may interpolate {{variables.*}}."
+        },
+        "args": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Legacy alias for 'params'. Hosts SHOULD accept and warn."
+        }
+      }
+    },
+    "sourceStatic": {
+      "type": "object",
+      "required": ["kind", "value"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "static" },
+        "value": {
+          "description": "Literal pass-through. Never fetched, never parsed."
+        }
+      }
+    },
+    "sourceFile": {
+      "type": "object",
+      "required": ["kind", "path"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "file" },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Filesystem path relative to the render filesystem. Parsed by extension per the format contract."
+        },
+        "workspace": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Resolve `path` against a named workspace instead of the render filesystem. The host's workspace resolver supplies the filesystem (and enforces access); unconfigured cross-workspace refs surface as status:error rather than silently reading the wrong scope."
+        }
+      }
+    },
+    "sourceQuery": {
+      "type": "object",
+      "required": ["kind", "include"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "query" },
+        "include": {
+          "anyOf": [
+            { "type": "string", "minLength": 1 },
+            {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "minItems": 1
+            }
+          ],
+          "description": "Glob or array of globs. Bare directory paths are rewritten to <path>/**/*.md."
+        },
+        "where": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Field predicates against parsed shape. Supports equality and operators _in, _contains, _before, _after."
+        },
+        "sort": {
+          "type": "string",
+          "pattern": "^-?[A-Za-z_][A-Za-z0-9_.]*$",
+          "description": "field (asc) or -field (desc) on a parsed key."
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 50
+        },
+        "fields": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Project to a subset of parsed keys."
+        },
+        "workspace": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Resolve the glob against a named workspace instead of the render filesystem. The host's workspace resolver supplies the filesystem (and enforces access); unconfigured cross-workspace refs surface as status:error rather than silently reading the wrong scope."
+        }
+      }
+    },
+    "import": {
+      "type": "object",
+      "required": ["template"],
+      "additionalProperties": false,
+      "properties": {
+        "template": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Path to a sibling *.canvakit.* file."
+        },
+        "variables": {
+          "type": "object",
+          "additionalProperties": true,
+          "default": {},
+          "description": "Values passed to the imported canvas. Imports do NOT inherit parent variables; pass explicitly."
+        }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-6/draft/COMPANY.schema.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-6/COMPANY.schema.json",
+  "title": "agentcompanies/v1 doctype frontmatter (AIP-6)",
+  "description": "Validates the YAML frontmatter portion of any agentcompanies/v1 doctype file. The `doctype` field discriminates between company / role / objective; each branch enforces the doctype-specific shape. Operator doctype is sketched here but the normative definition lives in AIP-8 — only company / role / objective are normative under AIP-6.",
+  "type": "object",
+  "required": ["schema", "doctype", "id"],
+  "properties": {
+    "schema": {
+      "const": "agentcompanies/v1",
+      "description": "Format identifier. MUST be the literal string `agentcompanies/v1`."
+    },
+    "doctype": {
+      "enum": ["company", "role", "objective"],
+      "description": "Discriminator. Selects the doctype-specific branch under `oneOf`."
+    },
+    "id": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 64,
+      "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+      "description": "Slug identifier. Lowercase, digits, dashes. Stable across renames; references use this, never database IDs."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$",
+      "description": "Spec version of THIS file. Bump on breaking change."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "Human-readable display name."
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 2000,
+      "description": "One-paragraph purpose."
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+      "default": []
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "default": {},
+      "description": "Vendor-specific extensions. Authors stash hints under namespaced keys `metadata.<vendor>.…`; other readers MUST tolerate unknown keys."
+    }
+  },
+  "oneOf": [
+    { "$ref": "#/$defs/company" },
+    { "$ref": "#/$defs/role" },
+    { "$ref": "#/$defs/objective" }
+  ],
+  "$defs": {
+    "company": {
+      "type": "object",
+      "required": ["doctype", "name", "mission"],
+      "properties": {
+        "doctype": { "const": "company" },
+        "mission": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1000,
+          "description": "One-paragraph mission. Read by every operator at boot."
+        },
+        "values": {
+          "type": "array",
+          "items": { "type": "string", "maxLength": 200 },
+          "default": [],
+          "description": "Short value statements; surfaced in role prompts."
+        },
+        "structure": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "positions": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+              },
+              "default": [],
+              "description": "Slugs of the company's seats — each typically materialized as an operator under `operators/<slug>/OPERATOR.md`. A position is a seat one operator holds; several positions may share one AIP-47 catalog role. See AIP-47 §Role vs Position vs Access role."
+            },
+            "roles": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+              },
+              "default": [],
+              "deprecated": true,
+              "description": "DEPRECATED alias of `positions`. Readers MUST accept both; when both are present, `positions` wins. Historically documented as role slugs but used in practice for seats."
+            },
+            "objectives": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+              },
+              "default": [],
+              "description": "Slugs of top-level objectives defined under `objectives/<slug>/OBJECTIVE.md`."
+            },
+            "reports_to": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+              },
+              "default": {},
+              "description": "Map of position-slug → position-slug expressing the reporting tree. The key reports to the value. Positions not in the map are top-level."
+            }
+          }
+        },
+        "imports": {
+          "type": "array",
+          "default": [],
+          "items": { "$ref": "#/$defs/import" },
+          "description": "External roles or objectives pulled from a registry. Resolved by the adapter at load time."
+        }
+      }
+    },
+    "role": {
+      "type": "object",
+      "required": ["doctype", "name", "mandate"],
+      "properties": {
+        "doctype": { "const": "role" },
+        "mandate": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000,
+          "description": "One-paragraph statement of what this role is responsible for. Defines the role's bounded autonomy."
+        },
+        "reports_to": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "description": "Slug of the parent role. Omit for top-level roles."
+        },
+        "scope": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "owns": {
+              "type": "array",
+              "items": { "type": "string", "maxLength": 200 },
+              "default": [],
+              "description": "Free-text list of resource classes this role owns (e.g. `outbound-email`, `q3-pipeline`)."
+            },
+            "capabilities": {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+              "default": [],
+              "description": "Capability slugs the role grants — referenced by AIP-7 governance and AIP-8 operators."
+            }
+          }
+        },
+        "objectives": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$" },
+          "default": [],
+          "description": "Slugs of objectives this role pursues. Each MUST resolve to an `objectives/<slug>/OBJECTIVE.md`."
+        },
+        "tools": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$" },
+          "default": [],
+          "description": "Slugs of AIP-14 tools the role may call. Adapter resolves against the host's tool catalog."
+        },
+        "workflows": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$" },
+          "default": [],
+          "description": "Slugs of AIP-15 workflows the role may execute."
+        }
+      }
+    },
+    "objective": {
+      "type": "object",
+      "required": ["doctype", "name", "statement"],
+      "properties": {
+        "doctype": { "const": "objective" },
+        "statement": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000,
+          "description": "One-paragraph statement of the desired outcome."
+        },
+        "owner": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "description": "Slug of the role accountable for this objective."
+        },
+        "horizon": {
+          "enum": ["sprint", "quarter", "year", "ongoing"],
+          "default": "quarter",
+          "description": "Time horizon. Adapter MAY use this to surface stale objectives."
+        },
+        "status": {
+          "enum": ["proposed", "active", "paused", "achieved", "abandoned"],
+          "default": "active"
+        },
+        "key_results": {
+          "type": "array",
+          "default": [],
+          "items": {
+            "type": "object",
+            "required": ["id", "statement"],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+              },
+              "statement": { "type": "string", "maxLength": 500 },
+              "target": { "type": "string", "maxLength": 200 },
+              "progress": { "type": "number", "minimum": 0, "maximum": 1 }
+            }
+          }
+        },
+        "parent": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "description": "Slug of the parent objective (for decomposition trees). Omit for top-level objectives."
+        },
+        "children": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$" },
+          "default": [],
+          "description": "Slugs of child sub-objectives. Adapter validates the parent/children edges agree."
+        },
+        "depends_on": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$" },
+          "default": [],
+          "description": "Slugs of objectives this one depends on."
+        }
+      }
+    },
+    "import": {
+      "type": "object",
+      "required": ["from", "as"],
+      "additionalProperties": false,
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source ref. Format: `<registry>/<package>@<version>` or a relative path."
+        },
+        "as": {
+          "enum": ["role", "objective"],
+          "description": "Imported doctype."
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "description": "Local slug to bind the import under."
+        },
+        "alias": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "description": "Override the import's local slug if it would collide."
+        }
+      }
+    }
+  }
+}