@agentproto/cli 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -98,6 +98,33 @@ declare function runServe(args: readonly string[]): Promise<number>;
  */
 declare function runAcp(args: readonly string[]): Promise<number>;
 
+declare function runPackSkill(args: readonly string[]): Promise<number>;
+
+/**
+ * Single shared `zip` implementation for a skill pack directory. Used by
+ * `claude-plugin.ts` (consumer-side install, `agentproto install skill/...`)
+ * and by a package's own release-time build script (producer-side, see
+ * `packages/skill-pack-<name>/scripts/build.mjs`) — one zip technique, not
+ * one per caller.
+ */
+interface ZipPackResult {
+    zipped: boolean;
+    zipPath: string;
+}
+/**
+ * Best-effort zip of `dirToZip` into `<dirToZip>.zip` (or `zipPath` when
+ * given). The directory is the canonical artifact; the archive is a
+ * convenience — `zip` may be absent on minimal/Windows environments, so a
+ * failure to zip is reported via `zipped: false` rather than thrown.
+ *
+ * Runs `zip` with cwd set to `dirToZip`'s parent and zips its bare basename,
+ * so archive entries read as `<name>/...` — not the full absolute path a
+ * naive `zip -r <zipPath> <dirToZip>` would bake in when `dirToZip` is
+ * absolute (as every caller here passes it). Unzipping must not recreate
+ * the machine's own directory tree.
+ */
+declare function zipPackDir(dirToZip: string, zipPath?: string): Promise<ZipPackResult>;
+
 /**
  * Resolve a slug like "claude-code" to a runnable `AgentCliHandle`.
  *
@@ -185,6 +212,19 @@ interface AdapterInfo {
      *  `provider`/`mode` are undefined for a bare-string entry — an
      *  unstated provider is never guessed here (see AdapterModelInfo). */
     modelDetails: AdapterModelInfo[];
+    /**
+     * How this adapter selects a model (AIP-45 `models.apply`, defaulted the
+     * same way the driver does — omitted manifest field ⇒ `"config"`). Tells
+     * a client whether a mid-session model switch (`POST /sessions/:id/
+     * model`) can even work for this adapter: `"arg"` bakes the model into
+     * spawn-time argv, so EVERY switch attempt reports `requires-restart`
+     * regardless of target model — a picker should mark every row that way
+     * rather than let the user discover it per-pick. Absent for the ACP
+     * generic-config adapter family (`listAcpGenericAdapters`), which has no
+     * `models.apply` concept of its own; treat an absent value as `"config"`,
+     * the same default the manifest schema applies.
+     */
+    modelApply?: "config" | "command" | "arg";
 }
 /** One entry of an adapter's declared model menu, projected from a
  *  `models.allowed` item — bare string or {@link AgentCliModelEntry}.
@@ -231,14 +271,23 @@ declare function listInstalledAdapters(opts?: {
  * with its runtime availability status:
  *
  *   "supported" — known to agentproto, package not importable (not installed)
- *   "available" — package resolves; requiresSetup but no ledger yet
- *   "ready"     — package resolves + setup complete (or no setup needed)
+ *   "available" — package resolves; requiresSetup but no ledger yet, OR
+ *                 authRequired but no billing credential resolves
+ *   "ready"     — package resolves + setup complete (or no setup needed) AND
+ *                 (authRequired is false, or a credential DOES resolve)
  *
  * Also appends any adapters discovered in node_modules that aren't in the
  * catalog, so locally-installed custom adapters still appear.
  *
  * Status is derived via the kit's `computeStatus`: resolved × requiresSetup ×
- * ledger-exists — never via `handle.check()` (per OQ-5).
+ * ledger-exists × (authRequired × authConfigured) — never via `handle.check()`
+ * (per OQ-5). The auth axis is independent of `requiresSetup`: claude-code
+ * declares no `setup[]` at all (`requiresSetup` is always false for it) but
+ * `authEnforce:"always"` hard-fails every spawn without a billing credential
+ * — `authProbe` (wired to the runtime's `isAgentCliAuthConfigured`, which
+ * mirrors `resolveAuthSpec`'s exact precedence including the explicit-gate
+ * on the providers store, PR #321) is what makes that honest instead of the
+ * old `!requiresSetup` short-circuit reporting "ready" on zero credentials.
  *
  * A fourth status, `"unresolvable"`, sits outside that kit-owned vocabulary:
  * when `resolveAdapter` falls back to its last-known-good cache (see there),
@@ -369,4 +418,4 @@ declare function listAcpGenericAdapters(opts?: {
     excludeSlugs?: ReadonlySet<string>;
 }): Promise<AcpGenericListEntry[]>;
 
-export { ACP_CATALOG, type AcpAgentSpec, type AcpGenericListEntry, type AcpSpecSource, type AdapterInfo, type AdapterListing, type ResolvedAdapter, acpHandleFromSpec, binOnPath, listAcpGenericAdapters, listAdaptersWithAcp, listAdaptersWithCatalog, listInstalledAdapters, resolveAcpSpec, resolveAdapter, runAcp, runInstall, runRun, runServe };
+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 };