@agentproto/cli 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { AgentCliMode, AgentCliHandle } from '@agentproto/driver-agent-cli';
-import { AdapterCatalogEntry } from '@agentproto/provider-kit';
+import { AgentCliMode, AgentCliRouteSelection, AgentCliHandle } from '@agentproto/driver-agent-cli';
+import { CapabilityStrategy, AdapterCatalogEntry } from '@agentproto/provider-kit';
 import { AcpAgentConfigEntry, AgentprotoConfig } from '@agentproto/runtime/config';
+import { AdapterInstallResult } from '@agentproto/runtime';
 
 /**
  * `agentproto install <slug>`
@@ -76,6 +77,7 @@ declare function runRun(args: readonly string[]): Promise<number>;
  * `~/.agentproto/policy.toml` allowlist (see project_agentproto_repos
  * memory). The token is the only access control today.
  */
+
 declare function runServe(args: readonly string[]): Promise<number>;
 
 /**
@@ -98,6 +100,17 @@ declare function runServe(args: readonly string[]): Promise<number>;
  */
 declare function runAcp(args: readonly string[]): Promise<number>;
 
+/**
+ * `agentproto preset` — CRUD for user-owned session presets.
+ *
+ * Singular on purpose: `agentproto presets` remains the read-only catalogue
+ * of static provider gateway presets; this command manages combinations a
+ * user has saved for their own spawns.
+ */
+declare function runPreset(args: readonly string[]): Promise<number>;
+
+declare function runProviderPresets(args: readonly string[]): Promise<number>;
+
 declare function runPackSkill(args: readonly string[]): Promise<number>;
 
 /**
@@ -157,6 +170,11 @@ interface ResolvedAdapter {
      *  spawning don't need to check it, callers that surface status
      *  (`listAdaptersWithCatalog`) must not report it as plain "ready". */
     readonly stale?: true;
+    /** The adapter's optional `<camelSlug>Capabilities` export (harness
+     *  capability-discovery layer) — present when the adapter's module
+     *  exports one, absent otherwise (falls back to
+     *  `deriveDeclaredCapabilities` at the call site). */
+    readonly capabilitiesStrategy?: CapabilityStrategy;
 }
 /** Mode metadata surfaced in `adapter_list` — the UI-safe subset of an
  *  AIP-45 `modes[]` entry. Omits the spawn internals (`bin_args_*`, `env`)
@@ -225,6 +243,17 @@ interface AdapterInfo {
      * the same default the manifest schema applies.
      */
     modelApply?: "config" | "command" | "arg";
+    /**
+     * How this adapter's spawn ROUTE relates to the chosen model (AIP-45
+     * launch-menu drill-down, WP1) — projected verbatim from the manifest's
+     * `routeSelection`. A capability-derived spawn/config drill-down reads
+     * this to decide whether the connection step is a real choice (`"free"`)
+     * or a read-only badge (`"derived-from-model"`, the route falls out of the
+     * model id's vendor prefix). Undefined ⇒ `"free"` (back-compat: an adapter
+     * that never declared the axis keeps presenting a route choice). Distinct
+     * from the auth-derivation axis (`modelDerivedApiKey`).
+     */
+    routeSelection?: AgentCliRouteSelection;
 }
 /** One entry of an adapter's declared model menu, projected from a
  *  `models.allowed` item — bare string or {@link AgentCliModelEntry}.
@@ -418,4 +447,84 @@ declare function listAcpGenericAdapters(opts?: {
     excludeSlugs?: ReadonlySet<string>;
 }): Promise<AcpGenericListEntry[]>;
 
-export { ACP_CATALOG, type AcpAgentSpec, type AcpGenericListEntry, type AcpSpecSource, type AdapterInfo, type AdapterListing, type ResolvedAdapter, type ZipPackResult, acpHandleFromSpec, binOnPath, listAcpGenericAdapters, listAdaptersWithAcp, listAdaptersWithCatalog, listInstalledAdapters, resolveAcpSpec, resolveAdapter, runAcp, runInstall, runPackSkill, runRun, runServe, zipPackDir };
+/**
+ * `installAdapter(slug)` — install an agent CLI adapter (harness) by slug,
+ * the mutation companion to `listAdaptersWithAcp`.
+ *
+ * Two install classes, decided purely by `planAdapterInstall` (below):
+ *
+ *   - **acp-catalog / acp-config** — a generic ACP CLI with no
+ *     `@agentproto/adapter-*` package (gemini-cli, qwen-code, iflow-cli, or a
+ *     user's `config.acpAgents` entry). Its harness lives in an npm package
+ *     named only in the entry's `install_hint` ("npm install -g …"); we parse
+ *     that and run `npm i -g <package>` directly. `agentproto install <slug>`
+ *     can't do this — a generic ACP handle's only install step is
+ *     `{method:"vendored"}`, which the install runner treats as BYO-binary.
+ *
+ *   - **first-party** — a native `@agentproto/adapter-*` adapter in the
+ *     catalog (claude-code, opencode, …). Driven through the existing
+ *     `agentproto install <slug>` pipeline (`runInstall`), which bootstraps
+ *     the adapter package then runs its manifest `install[]` steps.
+ *
+ * Wired into the daemon as `createGateway({ installAgentAdapter })` — the
+ * runtime stays cli-free and only exposes the `adapter_install` MCP tool +
+ * `POST /adapters/:slug/install` route. Never throws for an ordinary install
+ * failure: reports it via `{ ok:false, message }` so the tool/route return a
+ * clean result rather than a 500.
+ */
+
+/** The minimal slice of an adapter listing `planAdapterInstall` reads —
+ *  a structural subset of {@link AdapterListing} so the planner stays pure
+ *  and trivially unit-testable. */
+interface AdapterInstallCandidate {
+    slug: string;
+    status?: "supported" | "available" | "ready" | "unresolvable";
+    /** Present ONLY on generic ACP entries (`acp-catalog` / `acp-config`);
+     *  absent on native `@agentproto/adapter-*` catalog entries. */
+    source?: "acp-config" | "acp-catalog";
+    /** Human "how to install" line — for acp entries this carries the npm
+     *  package (`npm install -g @google/gemini-cli`). */
+    hint?: string;
+}
+/** A resolved install strategy. `command`/`args` name exactly what will run
+ *  (for logs + error surfaces); `already-installed`/`unsupported` run
+ *  nothing. */
+type AdapterInstallPlan = {
+    kind: "already-installed";
+} | {
+    kind: "npm-global";
+    packageName: string;
+    command: "npm";
+    args: string[];
+} | {
+    kind: "agentproto-install";
+    slug: string;
+    command: "agentproto";
+    args: string[];
+} | {
+    kind: "unsupported";
+    reason: string;
+};
+/**
+ * Pull the npm package out of an acp entry's `install_hint`
+ * (`"npm install -g @google/gemini-cli"` → `"@google/gemini-cli"`). Accepts
+ * both `install`/`i` and `-g`/`--global` spellings. Returns `undefined` when
+ * the hint isn't an npm-global install line (a BYO-binary agent, a `brew`
+ * hint, etc.) — the caller then reports it as unsupported rather than
+ * guessing a package.
+ */
+declare function parseNpmPackageFromHint(hint?: string): string | undefined;
+/**
+ * Decide how to install `entry` — pure, so it's the unit-tested heart of the
+ * install flow. See the module header for the two classes.
+ */
+declare function planAdapterInstall(entry: AdapterInstallCandidate): AdapterInstallPlan;
+/**
+ * Install the adapter named by `slug` and report the outcome (never throws
+ * for an ordinary failure). Lists adapters first to classify the slug, plans
+ * the install, runs it, then re-reads the listing so the result carries the
+ * adapter's fresh readiness `status`.
+ */
+declare function installAdapter(slug: string): Promise<AdapterInstallResult>;
+
+export { ACP_CATALOG, type AcpAgentSpec, type AcpGenericListEntry, type AcpSpecSource, type AdapterInfo, type AdapterInstallCandidate, type AdapterInstallPlan, type AdapterListing, type ResolvedAdapter, type ZipPackResult, acpHandleFromSpec, binOnPath, installAdapter, listAcpGenericAdapters, listAdaptersWithAcp, listAdaptersWithCatalog, listInstalledAdapters, parseNpmPackageFromHint, planAdapterInstall, resolveAcpSpec, resolveAdapter, runAcp, runInstall, runPackSkill, runPreset, runProviderPresets, runRun, runServe, zipPackDir };