@agentproto/corpus-cli 0.1.1 → 0.3.0

package/dist/specs/resources/aip-14/draft/TOOL.schema.json

@@ -4,7 +4,7 @@
   "title": "TOOL.md frontmatter — agenttool/v1 (abstract agent contract)",
   "description": "Validates the YAML frontmatter portion of an AIP-14 TOOL.md manifest. Implementation-specific fields (code/run/runner/secrets/network/entry) are NOT part of this schema — they live on the AIP-30 PROVIDER schema.",
   "type": "object",
-  "required": ["name", "id", "description", "version", "inputs", "outputs"],
+  "required": ["name", "id", "description", "version"],
   "additionalProperties": false,
   "properties": {
     "name": {

package/dist/specs/resources/aip-45/draft/AGENT-CLI.schema.json

@@ -104,6 +104,11 @@
       "items": { "$ref": "#/$defs/option" },
       "description": "Independent typed knobs the CLI accepts. The host picks any subset per turn via OPERATOR.runtime.config.options. Patches apply in declaration order, AFTER mode patches."
     },
+    "presets": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/preset" },
+      "description": "AIP-45 gateway presets this adapter can drive (Anthropic/OpenAI-compatible backends). Merged into the provider-preset catalog (agentproto presets list / list_provider_presets) alongside the built-in registry, deduped by id (built-in wins on collision). Lets an external adapter surface a gateway the built-in registry doesn't know about."
+    },
     "continuation": { "$ref": "#/$defs/continuation" },
     "requires": { "$ref": "https://agentproto.sh/docs/aip-29/CLI.schema.json#/properties/requires" },
     "examples": {
@@ -259,6 +264,11 @@
           "description": "Stable id. The operator config references this id."
         },
         "description": { "type": "string" },
+        "bin_args_prepend": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Extra argv prepended before the manifest's bin_args when this mode is active."
+        },
         "bin_args_append": {
           "type": "array",
           "items": { "type": "string" },
@@ -268,6 +278,19 @@
           "type": "object",
           "additionalProperties": { "type": "string" },
           "description": "Extra env vars merged into the spawn env when this mode is active."
+        },
+        "env_unset": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Env keys to DELETE from the spawn env when this mode is active. Applied at the runtime's env-merge point after ambient process.env + mode/option env are combined, so a mode can scrub a credential that must never reach a non-native endpoint (e.g. a gateway mode scrubbing ANTHROPIC_API_KEY so it can't leak to a third-party Anthropic-compatible host). Unlike `env`, deletion is the only safe semantics for scrubbing."
+        },
+        "status": {
+          "enum": ["active", "noop", "planned"],
+          "description": "Honest support status surfaced to clients. active = does what its description claims; noop = declared and accepted but measured to have no effect; planned = declared surface not wired yet. Absent ⇒ treated as active."
+        },
+        "status_note": {
+          "type": "string",
+          "description": "Human-readable reason backing `status` (e.g. what was measured)."
         }
       }
     },
@@ -303,6 +326,11 @@
           "type": "integer",
           "description": "Upper bound when type=integer."
         },
+        "bin_args_prepend": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Argv template prepended before the manifest's bin_args when the option has a non-default value. The literal token `{value}` is replaced with the option's value (stringified)."
+        },
         "bin_args_template": {
           "type": "array",
           "items": { "type": "string" },
@@ -317,6 +345,11 @@
           "type": "object",
           "additionalProperties": { "type": "string" },
           "description": "Env vars to merge when the option has a non-default value. Values may contain `{value}` for templating."
+        },
+        "env_unset": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Env keys to DELETE from the spawn env when the option has a non-default value. Symmetric with mode.env_unset and applied at the same runtime env-merge point. Lets a value-bearing option (e.g. base_url pointing at a third-party Anthropic-compatible gateway) scrub the ambient credential (ANTHROPIC_API_KEY) it must displace, without forcing the operator to also pick a preset mode."
         }
       },
       "allOf": [
@@ -326,6 +359,35 @@
         }
       ]
     },
+    "preset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "label", "schemaFlavor", "baseUrl", "keyEnv"],
+      "description": "A gateway preset this adapter can drive — a backend an Anthropic/OpenAI-compatible client can front. Declared in the manifest so the catalog surfaces adapter-contributed presets alongside the built-in registry. No adapter projection (env/env_unset/bin_args) here; that stays in modes/options.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Stable preset id. SHOULD equal the mode id if the adapter projects this preset as a mode. Catalog dedupes built-in vs adapter-declared by id; an adapter-declared id colliding with a built-in is ignored in favor of the built-in (registry is source of truth for canonical providers)."
+        },
+        "label": { "type": "string", "minLength": 1, "description": "Human label for the catalog UI." },
+        "description": { "type": "string" },
+        "schemaFlavor": { "enum": ["anthropic", "openai"], "description": "API schema flavor — selects which adapter family can consume the preset." },
+        "baseUrl": { "type": "string", "minLength": 1, "description": "Base URL the client hits." },
+        "keyEnv": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Conventional env var holding this provider's API key. Catalog status is derived from its presence in the daemon's environment (ready vs available)."
+        },
+        "scrubEnv": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Env vars to scrub when this preset is active. Optional — an adapter that scrubs in code may omit it. Not surfaced to catalog clients."
+        },
+        "defaultModel": { "type": "string", "description": "Conventional default model id for this provider, if any." },
+        "homepage": { "type": "string", "description": "Optional homepage/docs URL for the catalog UI." }
+      }
+    },
     "continuation": {
       "type": "object",
       "additionalProperties": false,

package/dist/specs/resources/aip-52/draft/HARNESS.schema.json

@@ -0,0 +1,254 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-52/HARNESS.schema.json",
+  "title": "HarnessDefinition",
+  "description": "Validates the YAML frontmatter of a .harness/<slug>.md file. A Harness is a stateful conversational shell with modes, threads, tool-approval gates, subagents, and observational memory. Today the canonical runtime is Mastra's Harness class (@mastra/core/harness); the spec is implementation-agnostic.",
+  "$comment": "Relationship to other AIPs: a Harness HAS agents (via modes[].agent and HarnessConfig.agent) but IS NOT a subtype of AIP-42. AIP-42 agents are referenced from harness manifests via $resolver. See also AIP-12 for agent pack ingestion — packs can auto-generate .harness/ manifests from modes/*.md files.",
+  "type": "object",
+  "required": ["spec", "id", "name", "version", "storage", "modes", "models"],
+  "additionalProperties": false,
+  "properties": {
+    "spec": {
+      "const": "harness/v1",
+      "description": "Pins the spec version this manifest conforms to."
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Unique harness identifier (kebab-case). Used as the $id in the resolver registry."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "description": "Human-readable harness name."
+    },
+    "description": {
+      "type": "string",
+      "description": "One-sentence description of this harness's purpose."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Manifest semver. Bump on breaking mode/subagent changes."
+    },
+    "storage": {
+      "$ref": "#/$defs/refOrString",
+      "description": "Storage backend resolver. Must resolve to a MastraCompositeStore."
+    },
+    "stateSchema": {
+      "$ref": "#/$defs/refOrString",
+      "description": "Optional JSON Schema defining the conversation state shape (validated by the Harness)."
+    },
+    "initialState": {
+      "description": "Default values for the state schema fields."
+    },
+    "modes": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/mode" },
+      "description": "Operational modes (e.g. plan/execute, brief/draft/review). At least one required."
+    },
+    "memory": {
+      "$ref": "#/$defs/refOrString",
+      "description": "Optional memory resolver. Observational Memory is configured via omConfig on the Harness constructor, not here."
+    },
+    "workspace": {
+      "$ref": "#/$defs/refOrString",
+      "description": "Optional workspace resolver (Mastra Workspace or WorkspaceConfig)."
+    },
+    "models": {
+      "type": "object",
+      "required": ["resolver"],
+      "properties": {
+        "resolver": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Resolver for (modelId: string) => LanguageModel. Used as Harness.resolveModel."
+        },
+        "access": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Optional model access checker resolver (ModelAuthChecker)."
+        }
+      },
+      "additionalProperties": false
+    },
+    "subagents": {
+      "type": "array",
+      "default": [],
+      "items": { "$ref": "#/$defs/subagent" },
+      "description": "Child agents that can be spawned by the builtin subagent tool."
+    },
+    "extensions": {
+      "type": "object",
+      "properties": {
+        "consumes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Extension slugs this harness consumes from the host (e.g. 'workspace:files')."
+        },
+        "exposes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Extension slugs this harness makes available to subagents."
+        }
+      },
+      "additionalProperties": false
+    },
+    "heartbeats": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/refOrString" },
+      "default": [],
+      "description": "Periodic background handlers (e.g. OM reflector, progress reporter)."
+    },
+    "observability": {
+      "$ref": "#/$defs/refOrString",
+      "description": "Optional observability entrypoint resolver."
+    }
+  },
+  "$defs": {
+    "refOrString": {
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1,
+          "description": "Inline string value."
+        },
+        {
+          "type": "object",
+          "required": ["$ref"],
+          "properties": {
+            "$ref": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false,
+          "description": "Reference to a named value in the resolver registry."
+        },
+        {
+          "type": "object",
+          "required": ["$resolver"],
+          "properties": {
+            "$resolver": { "type": "string", "minLength": 1 },
+            "input": {}
+          },
+          "additionalProperties": false,
+          "description": "Dynamic resolver invocation with optional typed input."
+        }
+      ]
+    },
+    "mode": {
+      "type": "object",
+      "required": ["id", "agent", "model"],
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Unique mode identifier within this harness (e.g. 'plan', 'execute', 'review')."
+        },
+        "name": { "type": "string", "description": "Human-readable mode label." },
+        "description": { "type": "string" },
+        "default": {
+          "type": "boolean",
+          "description": "If true, this mode is activated on new sessions."
+        },
+        "color": {
+          "type": "string",
+          "description": "UI hint — hex or CSS color name."
+        },
+        "transitionsTo": {
+          "type": "string",
+          "description": "Mode id to switch to after submit_plan approval completes."
+        },
+        "defaultModelId": {
+          "type": "string",
+          "description": "Bootstrap model id for this mode. Falls back to the harness-level resolveModel."
+        },
+        "agent": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Backing Mastra Agent. Prefer a single shared agent on HarnessConfig.agent with per-mode instructions layered on top."
+        },
+        "model": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Model resolution config for this mode. Resolver must produce a { modelId, defaultModelId?, allowed? } object."
+        },
+        "tools": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Tools for this mode. Mutually exclusive with additionalTools — setting this REPLACES agent tools."
+        },
+        "prompt": {
+          "type": "object",
+          "properties": {
+            "blocks": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/refOrString" },
+              "default": [],
+              "description": "Ordered instruction blocks. Resolved to strings and concatenated for the mode's instructions field."
+            }
+          }
+        },
+        "builtins": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "ask_user": { "type": "boolean", "default": true },
+            "submit_plan": {
+              "oneOf": [{ "type": "boolean" }, { "const": "required" }],
+              "default": false
+            },
+            "task_write": { "type": "boolean", "default": true },
+            "task_check": { "type": "boolean", "default": true },
+            "subagent": { "type": "boolean", "default": false }
+          }
+        },
+        "permissions": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Default permission rules for this mode (PermissionRules from @mastra/core/harness)."
+        }
+      }
+    },
+    "subagent": {
+      "type": "object",
+      "required": ["id", "name", "description", "agent"],
+      "additionalProperties": true,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string" },
+        "description": { "type": "string" },
+        "agent": {
+          "$ref": "#/$defs/refOrString",
+          "description": "Backing agent resolver. The bridge instantiateHarness() derives instructions from prompt.blocks."
+        },
+        "model": { "$ref": "#/$defs/refOrString" },
+        "tools": { "$ref": "#/$defs/refOrString" },
+        "forked": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, inherits parent thread + prompt cache (cheaper). If false, gets a fresh isolated thread."
+        },
+        "maxSteps": { "type": "integer", "minimum": 1 },
+        "allowedHarnessTools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Subset of parent harness builtin tools available to this subagent."
+        },
+        "allowedWorkspaceTools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Subset of workspace tools available to this subagent."
+        },
+        "prompt": {
+          "type": "object",
+          "properties": {
+            "blocks": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/refOrString" },
+              "description": "Instruction blocks. Flattened to a string and passed as HarnessSubagent.instructions (required by Mastra API)."
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/corpus-cli",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "@agentproto/corpus-cli — the `corpus` binary. Validate, lint, and operate an AIP-10 corpus workspace from the command line. Local-topology host for @agentproto/corpus — pair with a local backing engine (qdrant docker / gbrain) for a fully offline corpus runtime.",
   "keywords": [
     "agentproto",
@@ -52,8 +52,8 @@
     "gray-matter": "^4.0.3",
     "zod": "^4.4.3",
     "@agentproto/cli-exec": "0.1.0-alpha.1",
-    "@agentproto/corpus": "0.1.1",
-    "@agentproto/corpus-presets": "0.1.1"
+    "@agentproto/corpus": "0.2.1",
+    "@agentproto/corpus-presets": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",