@mono-agent/agent-runtime 0.14.0 → 0.15.1

package/types/ai/pi-interop.d.ts

@@ -0,0 +1,113 @@
+/**
+ * List defensive snapshots of Pi's built-in models for one provider.
+ *
+ * @param {string} providerId
+ * @returns {PiBuiltinModelSnapshot[]}
+ */
+export function listPiBuiltinModels(providerId: string): PiBuiltinModelSnapshot[];
+/**
+ * Read a defensive snapshot of one Pi built-in model.
+ *
+ * @param {string} providerId
+ * @param {string} modelId
+ * @returns {PiBuiltinModelSnapshot|undefined}
+ */
+export function getPiBuiltinModel(providerId: string, modelId: string): PiBuiltinModelSnapshot | undefined;
+/**
+ * Translate Pi's model-native thinking levels to mono-agent effort spelling.
+ *
+ * @param {PiBuiltinModelSnapshot} model
+ * @returns {PiReasoningLevel[]}
+ */
+export function reasoningLevelsForPiModel(model: PiBuiltinModelSnapshot): PiReasoningLevel[];
+/**
+ * Resolve an OAuth-backed API key without allowing Pi to mutate the caller's
+ * credential record or returning Pi-owned credential objects.
+ *
+ * @param {string} providerId
+ * @param {Object<string, PiOAuthCredentialsSnapshot>} credentials
+ * @returns {Promise<{apiKey: string, newCredentials: PiOAuthCredentialsSnapshot}|null>}
+ */
+export function resolvePiOAuthApiKey(providerId: string, credentials: {
+    [x: string]: PiOAuthCredentialsSnapshot;
+}): Promise<{
+    apiKey: string;
+    newCredentials: PiOAuthCredentialsSnapshot;
+} | null>;
+/**
+ * Run a supported Pi OAuth login flow without exposing Pi's mutable provider
+ * registry or provider instances.
+ *
+ * @param {string} providerId
+ * @param {PiOAuthLoginCallbacks} callbacks
+ * @returns {Promise<PiOAuthCredentialsSnapshot>}
+ */
+export function loginPiOAuth(providerId: string, callbacks: PiOAuthLoginCallbacks): Promise<PiOAuthCredentialsSnapshot>;
+export type PiBuiltinModelSnapshot = {
+    id: string;
+    name: string;
+    api: string;
+    provider: string;
+    baseUrl: string;
+    reasoning: boolean;
+    input: Array<"text" | "image">;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        tiers?: Array<{
+            inputTokensAbove: number;
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        }>;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    thinkingLevelMap?: {
+        [x: string]: string | null;
+    };
+    compat?: {
+        [x: string]: any;
+    };
+    headers?: {
+        [x: string]: string;
+    };
+    [key: string]: any;
+};
+export type PiReasoningLevel = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export type PiOAuthCredentialsSnapshot = {
+    refresh: string;
+    access: string;
+    expires: number;
+    [key: string]: any;
+};
+export type PiOAuthLoginCallbacks = {
+    onAuth: (info: {
+        url: string;
+        instructions?: string;
+    }) => void;
+    onDeviceCode: (info: {
+        userCode: string;
+        verificationUri: string;
+        intervalSeconds?: number;
+        expiresInSeconds?: number;
+    }) => void;
+    onPrompt: (prompt: {
+        message: string;
+        placeholder?: string;
+        allowEmpty?: boolean;
+    }) => Promise<string>;
+    onProgress?: (message: string) => void;
+    onManualCodeInput?: () => Promise<string>;
+    onSelect: (prompt: {
+        message: string;
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+    }) => Promise<string | undefined>;
+    signal?: AbortSignal;
+};

package/types/ai/providers/claude-cli.d.ts

@@ -155,9 +155,10 @@ export function generateCliResponse(systemPrompt: any, options?: {}): Promise<{
         context_compaction_applied: any;
     };
 }>;
-export namespace claudeCodeBackend {
-    export let kind: string;
-    export namespace capabilities {
+export namespace claudeCodeRuntimeBridge {
+    let id: string;
+    let kind: string;
+    namespace capabilities {
         export let streaming: boolean;
         export let structured_output: boolean;
         export let supports_session_resume: boolean;
@@ -171,33 +172,8 @@ export namespace claudeCodeBackend {
         export { kind_1 as kind };
         export let runtime: string;
     }
-    export { generateCliResponse as execute };
-}
-export namespace codexCliBackend {
-    let kind_2: string;
-    export { kind_2 as kind };
-    export namespace capabilities_1 {
-        let kind_3: string;
-        export { kind_3 as kind };
-        let runtime_1: string;
-        export { runtime_1 as runtime };
-    }
-    export { capabilities_1 as capabilities };
-    export { generateCliResponse as execute };
-}
-export namespace claudeCodeRuntimeBridge {
-    export let id: string;
-    let kind_4: string;
-    export { kind_4 as kind };
-    export namespace capabilities_2 {
-        let kind_5: string;
-        export { kind_5 as kind };
-        let runtime_2: string;
-        export { runtime_2 as runtime };
-    }
-    export { capabilities_2 as capabilities };
-    export function supports(ref: any, options: any): boolean;
-    export function execute(systemPrompt: any, options: any): Promise<{
+    function supports(ref: any, options: any): boolean;
+    function execute(systemPrompt: any, options: any): Promise<{
         text: any;
         structuredResult: any;
         structuredResultSource: any;

package/types/ai/providers/claude-sdk.d.ts

@@ -129,17 +129,10 @@ export function generateClaudeResponse(systemPrompt: any, options: any): Promise
         context_compaction_applied: any;
     };
 }>;
-export namespace claudeSdkBackend {
-    export let kind: string;
-    export let capabilities: any;
-    export { generateClaudeResponse as execute };
-}
 export namespace claudeRuntimeBridge {
     export let id: string;
-    let kind_1: string;
-    export { kind_1 as kind };
-    let capabilities_1: any;
-    export { capabilities_1 as capabilities };
+    export let kind: string;
+    export let capabilities: any;
     export function supports(ref: any): boolean;
     export { generateClaudeResponse as execute };
 }

package/types/ai/providers/codex-app.d.ts

@@ -62,7 +62,7 @@ export function generateCodexAppResponse(systemPrompt: any, options?: {}): Promi
     };
     durationMs: number;
     numTurns: number;
-    model: string;
+    model: any;
     effort: any;
     sdk: string;
     providerSessionId: any;
@@ -124,22 +124,16 @@ export function generateCodexAppResponse(systemPrompt: any, options?: {}): Promi
         context_compaction_applied: any;
     };
 }>;
-export namespace codexAppBackend {
-    export let kind: string;
-    export { CODEX_APP_CAPABILITIES as capabilities };
-    export { generateCodexAppResponse as execute };
-}
 export namespace codexAppRuntimeBridge {
     export let id: string;
-    let kind_1: string;
-    export { kind_1 as kind };
+    export let kind: string;
     export { CODEX_APP_CAPABILITIES as capabilities };
     export function supports(ref: any, options: any): boolean;
     export { generateCodexAppResponse as execute };
 }
 declare namespace CODEX_APP_CAPABILITIES {
-    let kind_2: string;
-    export { kind_2 as kind };
+    let kind_1: string;
+    export { kind_1 as kind };
     export let runtime: string;
     export let streaming: boolean;
     export let structured_output: boolean;

package/types/ai/providers/pi-messages.d.ts

@@ -1,4 +1,3 @@
-export function promptTextFromMessages(messages: any): string;
 export function toAgentMessages(messages: any, model: any): any[];
 export function textFromContent(content: any): string;
 export function thinkingFromContent(content: any): string;

package/types/ai/providers/pi-native/result-builder.d.ts

@@ -11,7 +11,7 @@ export function usageFromMessages(messages?: Array<any>): {
     cost: number;
 };
 /**
- * Normalize the final provider request's usage into an exact context snapshot.
+ * Normalize one provider request's usage into an exact context snapshot.
  * Unlike usageFromMessages(), this deliberately does not aggregate earlier
  * requests in the run: the last assistant usage is the same provider-counted
  * value Pi's compaction logic trusts, so it can decrease after compaction.
@@ -40,9 +40,9 @@ export function failureKindForPiError(message: string | null, diagnostics: Recor
 }): string | null;
 /**
  * Emit the per-run cache / cost / provider-completed events.
- * @param {{onEvent: (event: any) => void, resolved: any, reference: string, usage: {input: number, output: number, cacheRead: number, cacheWrite: number, cost: number}, contextUsage?: {input: number, output: number, cacheRead: number, cacheCreation: number, total: number}|null, contextWindow?: number, estimatedCost: number, start: number, externalAbort: boolean}} params
+ * @param {{onEvent: (event: any) => void, resolved: any, reference: string, usage: {input: number, output: number, cacheRead: number, cacheWrite: number, cost: number}, estimatedCost: number, start: number, externalAbort: boolean}} params
  */
-export function emitUsageCostEvents({ onEvent, resolved, reference, usage, contextUsage, contextWindow, estimatedCost, start, externalAbort, }: {
+export function emitUsageCostEvents({ onEvent, resolved, reference, usage, estimatedCost, start, externalAbort, }: {
     onEvent: (event: any) => void;
     resolved: any;
     reference: string;
@@ -53,14 +53,6 @@ export function emitUsageCostEvents({ onEvent, resolved, reference, usage, conte
         cacheWrite: number;
         cost: number;
     };
-    contextUsage?: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheCreation: number;
-        total: number;
-    } | null;
-    contextWindow?: number;
     estimatedCost: number;
     start: number;
     externalAbort: boolean;

package/types/ai/providers/pi-native/stream-subscriber.d.ts

@@ -17,14 +17,16 @@
  * abort; it is already constructed when this is wired (subscribe follows the
  * AgentHarness constructor).
  * @param {StreamSubscriberState} runState
- * @param {{onEvent: (event: any) => void, options: any, toolLimits: any, harness: any}} deps
+ * @param {{onEvent: (event: any) => void, options: any, toolLimits: any, harness: any, sdk: string, model: string}} deps
  * @returns {(event: any) => void}
  */
-export function createStreamSubscriber(runState: StreamSubscriberState, { onEvent, options, toolLimits, harness }: {
+export function createStreamSubscriber(runState: StreamSubscriberState, { onEvent, options, toolLimits, harness, sdk, model }: {
     onEvent: (event: any) => void;
     options: any;
     toolLimits: any;
     harness: any;
+    sdk: string;
+    model: string;
 }): (event: any) => void;
 /**
  * The slice of run state the stream subscriber reads and mutates. A structural

package/types/ai/providers/pi-native/turn-runner.d.ts

@@ -32,7 +32,7 @@ export function thinkingLevelForEffort(effort: string, capabilities: any): strin
  * @param {any} params
  * @returns {any}
  */
-export function buildTurnHarness(runState: any, { cwd, session, piModels, model, thinkingLevel, systemPrompt, outputSchema, tools, transport, maxRetries, maxRetryDelayMs, steeringMode, onEvent, options, toolLimits, }: any): any;
+export function buildTurnHarness(runState: any, { cwd, session, piModels, model, thinkingLevel, systemPrompt, outputSchema, tools, transport, maxRetries, maxRetryDelayMs, steeringMode, onEvent, options, toolLimits, sdk, reference, }: any): any;
 /**
  * Start the live-input steering consumer. Consumes follow-up messages and steers
  * the harness mid-run; the consumer is tied to run completion (an internal

package/types/ai/runtime/live-input-events.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @typedef {{body: string, id?: string, receivedAt?: string, acknowledge?: () => void, reject?: (reason?: unknown) => void}} RuntimeLiveInputMessage
+ * @typedef {{type: "live_input_applied", inputId: string, receivedAt?: string}} LiveInputAppliedEvent
+ */
+/**
+ * @param {AsyncIterable<RuntimeLiveInputMessage>|undefined} liveInput
+ * @param {(event: LiveInputAppliedEvent) => void} onApplied
+ * @returns {AsyncIterable<RuntimeLiveInputMessage>|undefined}
+ */
+export function instrumentLiveInputAppliedEvents(liveInput: AsyncIterable<RuntimeLiveInputMessage> | undefined, onApplied: (event: LiveInputAppliedEvent) => void): AsyncIterable<RuntimeLiveInputMessage> | undefined;
+export type RuntimeLiveInputMessage = {
+    body: string;
+    id?: string;
+    receivedAt?: string;
+    acknowledge?: () => void;
+    reject?: (reason?: unknown) => void;
+};
+export type LiveInputAppliedEvent = {
+    type: "live_input_applied";
+    inputId: string;
+    receivedAt?: string;
+};

package/types/ai/types.d.ts

@@ -102,9 +102,10 @@
  * @property {string} [executionMode]                     "sdk" (default) or "cli"; selects which bridge variant handles the model.
  * @property {string} [sessionId]                         Host conversation/session key for resumable bridges.
  * @property {string} [providerSessionId]                 Provider-owned resume id for resumable bridges.
+ * @property {typeof import("@anthropic-ai/claude-agent-sdk").query} [claudeAgentQuery] Advanced programmatic/test seam for the Claude SDK route; omitted runs use the runtime's pinned SDK query implementation.
  * @property {boolean} [sessionKeepAlive]                 Keep resumable provider state alive after the turn.
  * @property {number} [sessionIdleTimeoutMs]              Idle TTL for resumable provider state.
- * @property {AsyncIterable<{body: string, id?: string}>} [liveInput] Stream of in-flight user messages for steering an active run.
+ * @property {AsyncIterable<{body: string, id?: string, receivedAt?: string, acknowledge?: () => void, reject?: (error?: unknown) => void}>} [liveInput] Stream of in-flight user messages for steering an active run. Providers acknowledge only after accepting a message into the active turn.
  * @property {ReadonlyArray<*>} [observers]               Per-call observers (see RuntimeObserver) merged with host-level (createRuntime) observers.
  * @property {(event: RuntimeEvent) => void} [onEvent]
  * @property {ReadonlyArray<Object>} [messages]
@@ -481,6 +482,10 @@ export type RuntimeRunOptions = {
      * Provider-owned resume id for resumable bridges.
      */
     providerSessionId?: string;
+    /**
+     * Advanced programmatic/test seam for the Claude SDK route; omitted runs use the runtime's pinned SDK query implementation.
+     */
+    claudeAgentQuery?: typeof import("@anthropic-ai/claude-agent-sdk").query;
     /**
      * Keep resumable provider state alive after the turn.
      */
@@ -490,11 +495,14 @@ export type RuntimeRunOptions = {
      */
     sessionIdleTimeoutMs?: number;
     /**
-     * Stream of in-flight user messages for steering an active run.
+     * Stream of in-flight user messages for steering an active run. Providers acknowledge only after accepting a message into the active turn.
      */
     liveInput?: AsyncIterable<{
         body: string;
         id?: string;
+        receivedAt?: string;
+        acknowledge?: () => void;
+        reject?: (error?: unknown) => void;
     }>;
     /**
      * Per-call observers (see RuntimeObserver) merged with host-level (createRuntime) observers.

package/src/ai/backend.js

@@ -1,17 +0,0 @@
-import { RUNTIME_CAPABILITIES, runtimeCapabilities } from "./runtime/capabilities.js";
-
-// Back-compat export name for callers that still ask for backend capabilities.
-// The canonical source is the runtime bridge registry.
-export const BACKEND_CAPABILITIES = RUNTIME_CAPABILITIES;
-
-export function backendCapabilities(sdkOrModel) {
-  return runtimeCapabilities(sdkOrModel);
-}
-
-export function backendUsesExecenvConfig(sdk) {
-  return !!RUNTIME_CAPABILITIES[sdk]?.native_runtime_config;
-}
-
-export function backendSupportsSessionResume(sdk) {
-  return !!RUNTIME_CAPABILITIES[sdk]?.supports_session_resume;
-}

package/src/ai/registry.js

@@ -1,5 +0,0 @@
-export {
-  listRuntimeBridges as listProviders,
-  resolveRuntimeBridge as findProviderForModel,
-  runtimeCapabilities,
-} from "./runtime/registry.js";

package/types/ai/backend.d.ts

@@ -1,57 +0,0 @@
-export function backendCapabilities(sdkOrModel: any): any;
-export function backendUsesExecenvConfig(sdk: any): boolean;
-export function backendSupportsSessionResume(sdk: any): boolean;
-export const BACKEND_CAPABILITIES: {
-    claude: {
-        supports_session_resume: boolean;
-        streaming: boolean;
-        structured_output: boolean;
-        native_runtime_config: any;
-        supports_mcp: boolean;
-        supports_skills: boolean;
-        supports_builtin_tools: boolean;
-        supports_live_input: boolean;
-        supports_native_subagents: boolean;
-        supports_fast_mode: boolean;
-        runtime: string;
-    };
-    pi: {
-        supports_session_resume: boolean;
-        supports_native_subagents: boolean;
-        streaming: boolean;
-        structured_output: boolean;
-        native_runtime_config: any;
-        supports_mcp: boolean;
-        supports_skills: boolean;
-        supports_builtin_tools: boolean;
-        supports_live_input: boolean;
-        supports_fast_mode: boolean;
-        runtime: string;
-    };
-    codex: {
-        supports_session_resume: boolean;
-        supports_fast_mode: boolean;
-        streaming: boolean;
-        structured_output: boolean;
-        native_runtime_config: any;
-        supports_mcp: boolean;
-        supports_skills: boolean;
-        supports_builtin_tools: boolean;
-        supports_live_input: boolean;
-        supports_native_subagents: boolean;
-        runtime: string;
-    };
-    opencode: {
-        structured_output: boolean;
-        supports_session_resume: boolean;
-        supports_mcp: boolean;
-        supports_skills: boolean;
-        supports_live_input: boolean;
-        supports_native_subagents: boolean;
-        streaming: boolean;
-        native_runtime_config: any;
-        supports_builtin_tools: boolean;
-        supports_fast_mode: boolean;
-        runtime: string;
-    };
-};

package/types/ai/registry.d.ts

@@ -1 +0,0 @@
-export { listRuntimeBridges as listProviders, resolveRuntimeBridge as findProviderForModel, runtimeCapabilities } from "./runtime/registry.js";