@agentproto/cli 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentCliHandle } from '@agentproto/driver-agent-cli';
+import { AgentCliMode, AgentCliHandle } from '@agentproto/driver-agent-cli';
 
 /**
  * `agentproto install <slug>`
@@ -49,7 +49,7 @@ declare function runRun(args: readonly string[]): Promise<number>;
  * `--connect <url>` is set. With or without the tunnel:
  *
  *   - HTTP /sessions, /sessions/agent, /sessions/:id/* routes work
- *   - MCP tools (start_agent_session, prompt_agent_session, …) are
+ *   - MCP tools (agent_start, agent_prompt, …) are
  *     reachable via the daemon's /mcp transport
  *   - the LocalDaemonSessionsCard in guilde-web sees every spawn
  *
@@ -102,10 +102,21 @@ interface ResolvedAdapter {
     readonly source: "npm" | "file" | "bundled";
     readonly packageName?: string;
 }
+/** Mode metadata surfaced in `adapter_list` — the UI-safe subset of an
+ *  AIP-45 `modes[]` entry. Omits the spawn internals (`bin_args_*`, `env`)
+ *  since those aren't information a picker needs; carries the honest
+ *  `status`/`status_note` so a declared-but-no-op mode is visible. */
+interface AdapterMode {
+    id: string;
+    description?: string;
+    /** Absent in the manifest ⇒ normalised to "active" here. */
+    status: NonNullable<AgentCliMode["status"]>;
+    status_note?: string;
+}
 /**
  * Compact metadata about an installed adapter — the shape returned
  * by `listInstalledAdapters()` and exposed via the daemon's
- * `GET /adapters` route + `list_adapters` MCP tool. Only fields
+ * `GET /adapters` route + `adapter_list` MCP tool. Only fields
  * safe to surface in a UI list (no install scripts, no env keys).
  * For full handle access call `resolveAdapter(slug)`.
  */
@@ -129,15 +140,20 @@ interface AdapterInfo {
     /** Known-valid model identifiers for this adapter, drawn from the
      *  adapter manifest's `models.allowed` field. Empty when the adapter
      *  doesn't declare a model list (accepts whatever the underlying
-     *  binary accepts). Pass one of these as `model` in `start_agent_session`
+     *  binary accepts). Pass one of these as `model` in `agent_start`
      *  to avoid trial-and-error validation errors. */
     models: string[];
+    /** AIP-45 `modes[]` the adapter declares, projected to the UI-safe
+     *  subset (id + description + honest status). Empty when the adapter
+     *  declares no modes. `status` defaults to "active" when the manifest
+     *  omits it, so a declared mode is never silently statusless. */
+    modes: AdapterMode[];
 }
 declare function resolveAdapter(slug: string): Promise<ResolvedAdapter>;
 /**
  * Enumerate every `@agentproto/adapter-*` package reachable from the
  * current node module-resolution path. Used by the daemon's
- * `GET /adapters` route and `list_adapters` MCP tool so UIs (web
+ * `GET /adapters` route and `adapter_list` MCP tool so UIs (web
  * spawn dialog) and operators can pick from the installed set
  * without trial-and-error against `resolveAdapter(slug)`.
  *