@agentproto/corpus-cli 0.2.0 → 0.3.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/corpus-cli",
-  "version": "0.2.0",
+  "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.2.0",
-    "@agentproto/corpus-presets": "0.2.0"
+    "@agentproto/corpus": "0.2.1",
+    "@agentproto/corpus-presets": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",