@agentproto/runtime 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -13,8 +13,8 @@ export { CostBudget, CostBudgetScope } from '@agentproto/auth';
 import { R as ResolvedContextContinuityPolicy } from './context-continuity-ib9_bVYM.js';
 import { SandboxMode } from '@agentproto/command-sandbox';
 import { AdapterHandle, SetupField, AdapterResolver, AdapterLister, CredsStore, HarnessCapabilities, AdapterEntry } from '@agentproto/provider-kit';
-import { R as ResolvedAuthSpec, D as DeclaredAdapterOption, A as AdapterAuthDescriptor } from './spawn-defaults-D4W661ui.js';
-export { a as AuthEcho, b as AuthResolutionError, C as CLAUDE_CODE_OAUTH_SOURCE, c as CredentialSource, d as DefaultsAdapterAuthConfig, e as DefaultsAdapterConfig, f as ResolveSubscriptionCredentialInput, g as ResolvedSpawnAuthMaterial, h as ResolvedSpawnDefaults, S as SpawnDefaultsConfig, i as SubscriptionCredentialResolution, j as SubscriptionSourceError, k as credentialFingerprint, n as normalizeSkillsOption, r as resolveAuthSpec, l as resolveSpawnDefaults, m as resolveSubscriptionCredential } from './spawn-defaults-D4W661ui.js';
+import { R as ResolvedAuthSpec, D as DeclaredAdapterOption, A as AdapterAuthDescriptor } from './spawn-defaults-CwI9Puwy.js';
+export { a as AuthEcho, b as AuthResolutionError, C as CLAUDE_CODE_OAUTH_SOURCE, c as CredentialSource, d as DefaultsAdapterAuthConfig, e as DefaultsAdapterConfig, f as ResolveSubscriptionCredentialInput, g as ResolvedSpawnAuthMaterial, h as ResolvedSpawnDefaults, S as SpawnDefaultsConfig, i as SubscriptionCredentialResolution, j as SubscriptionSourceError, k as credentialFingerprint, n as normalizeSkillsOption, r as resolveAuthSpec, l as resolveSpawnDefaults, m as resolveSubscriptionCredential } from './spawn-defaults-CwI9Puwy.js';
 import { CatalogModelsQuery, CatalogModelsResponse } from './catalog-models.js';
 export { CatalogAdapterInput, CatalogAdapterModelInput, CatalogPricing, CatalogProduct, CatalogRoute, CatalogRouteSummary, CatalogVendor, buildCatalogModels } from './catalog-models.js';
 import { FooterSession } from './pr-provenance.js';
@@ -3010,7 +3010,7 @@ interface InboundMessage {
 type InboundEnqueuePrompt = (sessionId: string, text: string, opts?: {
     interrupt?: boolean;
     queue?: boolean;
-}) => Promise<void> | void;
+}) => Promise<unknown> | void;
 /** Whether `sessionId` is currently live enough to route into without a
  *  restart first. */
 type InboundIsSessionAlive = (sessionId: string) => boolean;
@@ -3331,6 +3331,12 @@ interface OrchestratorGatewayDeps {
      *  spawn is rejected with `sandbox_provider_not_found`, exactly as the
      *  root gateway would be without it. */
     resolveSandboxProvider?: SandboxProviderResolver;
+    /** Forwarded to `registerSessionTools` — config.json
+     *  `defaults.agentPromptInterrupt`, the unset-default for `interrupt` on
+     *  `agent_prompt` / `message_parent`. Threaded here so a child driving its
+     *  parent/peers (or reporting up via `message_parent`) through this scoped
+     *  gateway honours the same daemon default as the root `/mcp` surface. */
+    defaultAgentPromptInterrupt?: boolean;
 }
 type OrchestratorMcpServerFactory = (scope: OrchestratorScope) => Promise<McpServer>;
 /**
@@ -4727,6 +4733,16 @@ interface QueuedPrompt {
      *  falls back to `source`, then `"user"`. */
     origin?: string;
 }
+/** What `enqueuePrompt` resolved to — lets a caller (e.g. MCP `agent_prompt`)
+ *  tell the user whether the prompt was delivered/started now or PARKED behind
+ *  an in-flight turn. `queued: true` fires ONLY on the mid-turn queue arm
+ *  (`opts.queue` true, session busy, no `interrupt`): the prompt sits in
+ *  `promptQueue` and won't run until the current turn ends. Every other path —
+ *  idle dispatch, an interrupt that redirected the live turn, a structured-
+ *  question answer — resolves `queued: false`. */
+interface EnqueuePromptResult {
+    queued: boolean;
+}
 /** One entry in the after-the-fact queue listing (`listQueuedPrompts` /
  *  `session_queue_list` / `GET /sessions/:id/queue`). `position` is the
  *  array index (0 = next to dispatch). */
@@ -5165,8 +5181,12 @@ interface SessionDescriptor {
      * so a restarted daemon can still show the hand-off / review links. */
     openedPrs?: readonly OpenedPullRequest[];
     /** Adapter slug for agent-cli sessions — restart uses this with
-     *  `/sessions/agent` to spin up a fresh ACP runtime. Undefined for
-     *  pty/command kinds. */
+     *  `/sessions/agent` to spin up a fresh ACP runtime. ALSO stamped on a
+     *  conversation-terminal PTY (`isConversationTerminal` — a native
+     *  provider TUI launch like `claude`, classified at `spawnPty`), so the
+     *  Sessions list, the link probe, and the harness switch know which
+     *  provider the terminal is. Undefined for plain-shell PTYs and command
+     *  kinds. */
     adapterSlug?: string;
     /** Manifest-declared `capabilities.resumable` for this session's adapter
      *  (AIP-45), stamped from {@link AgentAdapterResolver}'s resolved
@@ -5260,6 +5280,15 @@ interface SessionDescriptor {
      *  posture or a raw `{ harnessModeId }` sourced from the harness's ACP mode
      *  registry (SPEC §3.4a). */
     posture?: Posture;
+    /**
+     * Read-surface echo of the live harness's advertised ACP session modes
+     * (`SessionModeState.availableModes`, #482) — stamped at READ TIME from the
+     * live agent session by `list()`/`get()`, never persisted. A client posture
+     * picker resolves the native (enforced, live-switchable) rows from this;
+     * absent for arms with no native mode registry (print/proprietary) and for a
+     * session whose live runtime handle is gone.
+     */
+    availableModes?: SessionMode[];
     /** Endpoint / gateway rail (SPEC §3.1 axis 4). `baseUrl` is carried only
      *  for a custom gateway the catalog can't resolve; `access` is downstream
      *  of this axis (SPEC §1c). */
@@ -5361,6 +5390,14 @@ interface SessionDescriptor {
      *  Keys are adapter-specific so future adapters can add their own
      *  ("hermesResumeId", etc.) without changing this type. */
     resumeMetadata?: Record<string, string>;
+    /** Conversation-terminal link probe verdict — `"ambiguous"` when MORE
+     *  than one fresh native transcript matched this PTY's cwd + start time,
+     *  so the daemon refused to bind any of them (never bind a sibling —
+     *  same invariant as the fs-probe's exact-bind rule). Absent while the
+     *  probe is still looking, and cleared once an unambiguous link lands
+     *  (`adapterSessionId` + `resumeMetadata`). Only ever set on
+     *  conversation-terminal rows (`isConversationTerminal`). */
+    linkStatus?: "ambiguous";
     /** Extra env this PTY (`kind: "terminal"`) session was spawned with, on
      *  top of `process.env` — e.g. `{ CLAUDE_CONFIG_DIR: "..." }` for a
      *  `pty-native` restart of a claude-code session (see
@@ -5701,6 +5738,17 @@ interface SessionSummary {
     origin?: string;
     parentSessionId?: string;
     depth?: number;
+    /**
+     * Server-computed Sessions-panel lane verdict, stamped by `listSummaries`
+     * against the daemon's FULL in-memory session map (archived and dead
+     * parents included) — so a client paging summaries never has to re-derive
+     * lineage from whatever happens to be on its current page, and a row's
+     * lane cannot flip between page 1 and page N. Absent on shell-only rows
+     * (`isShellOnlyRow` — plain-shell PTYs and command rows belong to the
+     * Activity panel, not either lane; a conversation terminal DOES get a
+     * lane) and on rows from older daemons.
+     */
+    lane?: "agents" | "auto";
     priorCommandSessionId?: string;
     continuedFrom?: string;
     continuedTo?: string;
@@ -6048,7 +6096,7 @@ interface SessionsRegistry {
         queue?: boolean;
         force?: boolean;
         queueId?: string;
-    }): Promise<void>;
+    }): Promise<EnqueuePromptResult>;
     /** Cancel one not-yet-dispatched item in `SessionDescriptor.promptQueue`
      *  by id — the composer's per-item "remove" action. Idempotent: an
      *  unknown session or an id that's already gone (dispatched, already
@@ -6227,6 +6275,7 @@ interface SessionsRegistry {
      */
     listSummaries(opts?: {
         includeArchived?: boolean;
+        lane?: "agents" | "auto";
         limit?: number;
         offset?: number;
     }): {
@@ -7533,14 +7582,17 @@ declare function registerBuiltinRoutes(opts?: {
  * kind-organized catalogs, so NO adapters, NO profiles, NO host wiring.
  * `getModelsByProvider` is itself router-aware: OpenRouter's route table is
  * spread into `LLM_PRICING_CATALOG` upstream (`llm/catalog.ts`), so an
- * `openrouter` query returns that full, large list with bare ids; Requesty
- * and HuggingFace are NOT spread into that catalog — spreading a second
- * router's bare-id pricing there would repoint direct-vendor ids at router
- * pricing (`route-identity/index.ts`) — so `getModelsByProvider` instead
- * folds their generated route tables in directly, emitting `vendor/
- * product@route` ids. All three routers enumerate through the same path;
- * the picker paginates client-side. NEVER log the rows: OpenRouter alone is
- * thousands.
+ * `openrouter` query returns that full, large list with bare ids; Requesty,
+ * HuggingFace and OpenCode's two hosted endpoints (`opencode-go`,
+ * `opencode`) are NOT spread into that catalog — spreading a second router's
+ * bare-id pricing there would repoint direct-vendor ids at router pricing
+ * (`route-identity/index.ts`) — so `getModelsByProvider` instead folds their
+ * generated route tables in directly. The emitted id is whatever the ref
+ * formats to: `vendor/product@route` for the vendor-namespacing routers, and
+ * the bare `opencode-go/glm-5.3` form for the OpenCode endpoints, whose route
+ * IS the id's leading segment. Every provider enumerates through the same
+ * path; the picker paginates client-side. NEVER log the rows: OpenRouter
+ * alone is thousands.
  */
 
 interface CatalogProviderModelsQuery {