@mono-agent/agent-runtime 0.6.1 → 0.8.0

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

@@ -1,17 +1,21 @@
 /**
- * @param {{command?: string, args?: string[], cwd?: any, env?: any, onNotification?: (msg: any) => void}} [options]
+ * @param {{command?: string, args?: string[], cwd?: any, env?: any, redactionValues?: string[], onNotification?: (msg: any) => void, onServerRequest?: (msg: any) => Promise<any> | any, shutdownGraceMs?: number, killGraceMs?: number}} [options]
  */
-export function createCodexAppServerClient({ command, args, cwd, env, onNotification, }?: {
+export function createCodexAppServerClient({ command, args, cwd, env, redactionValues, onNotification, onServerRequest, shutdownGraceMs, killGraceMs, }?: {
     command?: string;
     args?: string[];
     cwd?: any;
     env?: any;
+    redactionValues?: string[];
     onNotification?: (msg: any) => void;
+    onServerRequest?: (msg: any) => Promise<any> | any;
+    shutdownGraceMs?: number;
+    killGraceMs?: number;
 }): {
     request: (method: any, params: any, { timeoutMs }?: {
         timeoutMs?: number;
     }) => Promise<any>;
-    close: () => void;
+    close: () => Promise<void>;
     child: import("child_process").ChildProcessWithoutNullStreams;
     closed: Promise<any>;
 };
@@ -64,7 +68,7 @@ export function generateCodexAppResponse(systemPrompt: any, options?: {}): Promi
     providerSessionId: any;
     provider_session_id: any;
     cancelled: boolean;
-    error: any;
+    error: string;
     failureKind: string;
     diagnostics: {
         had_partial_progress?: boolean;
@@ -94,16 +98,16 @@ export function generateCodexAppResponse(systemPrompt: any, options?: {}): Promi
     providerSessionId: any;
     provider_session_id: any;
     cancelled: boolean;
-    error: any;
+    error: string;
     failureKind: string;
     diagnostics: {
         had_partial_progress?: boolean;
         codex_error_code?: undefined;
     } | {
         had_partial_progress?: boolean;
-        stderr_tail?: any;
+        stderr_tail?: string;
         codex_error_code: string;
-        codex_request_method: any;
+        codex_request_method: string;
         codex_request_timeout_ms: any;
     } | {
         had_partial_progress?: boolean;

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

@@ -1,5 +1,10 @@
-export function opencodeMcpConfig(mcpServers?: {}): {};
-export function mapErrorFailureKind(error: any): "usage_limit" | "provider_unavailable" | "cancelled";
+/**
+ * Extract only SDK-declared human-readable fields. In particular, never
+ * stringify API error objects: `responseBody`, response headers, and metadata
+ * can contain provider credentials or echoed request secrets.
+ */
+export function safeOpenCodeErrorMessage(error: any, fallback?: string): any;
+export function mapErrorFailureKind(error: any): "usage_limit" | "provider_unavailable" | "provider_auth" | "cancelled";
 export function mapSpawnFailureKind(err: any): "spawn" | "provider_unavailable";
 export namespace opencodeAppRuntimeBridge {
     export let id: string;
@@ -24,17 +29,11 @@ declare namespace OPENCODE_APP_CAPABILITIES {
     export let supports_fast_mode: boolean;
 }
 declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): Promise<{
-    text: string;
+    text: any;
     structuredResult: any;
     structuredResultSource: any;
     events: any[];
-    usage: {
-        cost_usd: any;
-        input_tokens?: any;
-        output_tokens?: any;
-        cache_read_tokens?: any;
-        cache_creation_tokens?: any;
-    };
+    usage: {};
     durationMs: number;
     numTurns: number;
     model: any;
@@ -45,7 +44,9 @@ declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): P
     cancelled: boolean;
     error: any;
     failureKind: string;
-    diagnostics: {};
+    diagnostics: {
+        opencode_error_code: any;
+    };
     capabilitiesUsed: {
         prompt_cache_active: any;
         thinking_enabled: any;
@@ -63,10 +64,6 @@ declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): P
     events: any[];
     usage: {
         cost_usd: number;
-        input_tokens: any;
-        output_tokens: any;
-        cache_read_tokens: any;
-        cache_creation_tokens: any;
     };
     durationMs: number;
     numTurns: number;
@@ -77,8 +74,10 @@ declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): P
     provider_session_id: any;
     cancelled: boolean;
     error: any;
-    failureKind: string;
+    failureKind: any;
     diagnostics: {
+        opencode_permission_id?: any;
+        opencode_error_code?: any;
         had_partial_progress?: boolean;
     };
     capabilitiesUsed: {

package/types/ai/providers/opencode-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Start one OpenCode server with mono-agent-owned process state.
+ *
+ * OpenCode stores sessions and project-wide permission approvals in SQLite. A
+ * unique per-run DB prevents pre-existing user approvals and other conversations
+ * from entering this tool environment. The normal OpenCode data home remains
+ * mounted so auth refresh rotation persists; global/repo config, external
+ * plugins, and external skills are disabled below. State is deleted after close.
+ */
+export function createIsolatedOpencode(options?: {}): Promise<{
+    client: import("@opencode-ai/sdk/v2").OpencodeClient;
+    server: {
+        url: any;
+        close: () => any;
+    };
+}>;
+/** Internal test cleanup for any server state left by an interrupted test/process. */
+export function disposeIsolatedOpenCodeState(): Promise<void>;
+/** Cached security preflight for the CLI features/event contract this bridge requires. */
+export function verifyOpenCodeVersion(): any;

package/types/ai/runtime/capabilities.d.ts

@@ -9,6 +9,7 @@ export namespace COMMON_CAPABILITIES {
     let supports_builtin_tools: boolean;
     let supports_live_input: boolean;
     let supports_native_subagents: boolean;
+    let supports_fast_mode: boolean;
 }
 export namespace RUNTIME_CAPABILITIES {
     namespace claude {
@@ -27,7 +28,25 @@ export namespace RUNTIME_CAPABILITIES {
     namespace codex {
         let supports_session_resume_3: boolean;
         export { supports_session_resume_3 as supports_session_resume };
+        let supports_fast_mode_1: boolean;
+        export { supports_fast_mode_1 as supports_fast_mode };
         let runtime_2: string;
         export { runtime_2 as runtime };
     }
+    namespace opencode {
+        let structured_output_1: boolean;
+        export { structured_output_1 as structured_output };
+        let supports_session_resume_4: boolean;
+        export { supports_session_resume_4 as supports_session_resume };
+        let supports_mcp_1: boolean;
+        export { supports_mcp_1 as supports_mcp };
+        let supports_skills_1: boolean;
+        export { supports_skills_1 as supports_skills };
+        let supports_live_input_1: boolean;
+        export { supports_live_input_1 as supports_live_input };
+        let supports_native_subagents_2: boolean;
+        export { supports_native_subagents_2 as supports_native_subagents };
+        let runtime_3: string;
+        export { runtime_3 as runtime };
+    }
 }

package/types/ai/runtime/context-windows.d.ts

@@ -1,5 +1,6 @@
 export function normalizeContextWindow(value: any): "default" | "1m";
 export function stripContextWindowSuffix(model: any): string;
+export function hasExplicitOneMillionContextWindow(model: any): boolean;
 export function claudeModelSupportsOneMillionContext(model: any): boolean;
 export function claudeModelSupportsContextWindow(model: any, contextWindow: any): boolean;
 export function modelWithContextWindow(model: any, contextWindow: any): string;

package/types/ai/runtime/router.d.ts

@@ -1,33 +1,21 @@
-/**
- * @typedef {import('../types.js').RuntimeModelRef} RuntimeModelRef
- * @typedef {import('../types.js').AgentRuntimeHostOptions} AgentRuntimeHostOptions
- * @typedef {import('../types.js').AgentRuntimeInstance} AgentRuntimeInstance
- * @typedef {import('../types.js').RuntimeRunOptions} RuntimeRunOptions
- * @typedef {import('../types.js').RuntimeResult} RuntimeResult
- */
-/**
- * @typedef {Object} RouterChainEntryInput
- * A chain entry as accepted by createRouterRuntime: either the shorthand bare
- * RuntimeModelRef, or the full `{model, executionMode?, requires?}` form.
- * @property {RuntimeModelRef} model
- * @property {string} [executionMode]
- * @property {Object<string, *>} [requires]
- */
-/**
- * @typedef {Object} RouterChainEntry
- * @property {RuntimeModelRef} model
- * @property {string|null} executionMode
- * @property {Object<string, *>|null} requires
- */
 /**
  * @param {Object} [options]
  * @param {AgentRuntimeHostOptions} [options.host]
  * @param {ReadonlyArray<RuntimeModelRef|RouterChainEntryInput>} [options.chain]
+ * @param {"uniform"|"per-route-native"} [options.routeSafety]
+ * @param {(input: {model: RuntimeModelRef, executionMode: string|null, attemptIndex: number, routeSafety: "uniform"|"per-route-native"}) => (RouterAttemptResolution|Promise<RouterAttemptResolution>)} [options.resolveAttempt]
  * @returns {AgentRuntimeInstance & {chain: () => Array<RouterChainEntry>}}
  */
-export function createRouterRuntime({ host, chain }?: {
+export function createRouterRuntime({ host, chain, routeSafety, resolveAttempt }?: {
     host?: AgentRuntimeHostOptions;
     chain?: ReadonlyArray<RuntimeModelRef | RouterChainEntryInput>;
+    routeSafety?: "uniform" | "per-route-native";
+    resolveAttempt?: (input: {
+        model: RuntimeModelRef;
+        executionMode: string | null;
+        attemptIndex: number;
+        routeSafety: "uniform" | "per-route-native";
+    }) => (RouterAttemptResolution | Promise<RouterAttemptResolution>);
 }): AgentRuntimeInstance & {
     chain: () => Array<RouterChainEntry>;
 };
@@ -38,11 +26,12 @@ export type RuntimeRunOptions = import("../types.js").RuntimeRunOptions;
 export type RuntimeResult = import("../types.js").RuntimeResult;
 /**
  * A chain entry as accepted by createRouterRuntime: either the shorthand bare
- * RuntimeModelRef, or the full `{model, executionMode?, requires?}` form.
+ * RuntimeModelRef, or the full `{model, executionMode?, effort?, requires?}` form.
  */
 export type RouterChainEntryInput = {
     model: RuntimeModelRef;
     executionMode?: string;
+    effort?: string | null;
     requires?: {
         [x: string]: any;
     };
@@ -50,7 +39,19 @@ export type RouterChainEntryInput = {
 export type RouterChainEntry = {
     model: RuntimeModelRef;
     executionMode: string | null;
+    effort: string | null | undefined;
     requires: {
         [x: string]: any;
     } | null;
 };
+/**
+ * Private host seam for route-specific provider options/runtime ownership.
+ * Returned options are never copied into router telemetry.
+ */
+export type RouterAttemptResolution = {
+    runtime?: AgentRuntimeInstance;
+    options?: {
+        [x: string]: any;
+    };
+    cleanup?: () => (void | Promise<void>);
+};

package/types/ai/streaming/codex-events.d.ts

@@ -1,12 +1,21 @@
 export function normalizeCodexItemType(type: any): any;
 export function normalizeCodexItemEvent(raw: any, context?: {}): {
+    is_error: boolean;
+    error?: any;
+    summary?: any;
+    type: string;
+    id: any;
+    status: any;
+    changes: any;
+    message?: undefined;
+} | {
     type: string;
     message: {
         content: {
             type: string;
-            tool_use_id: any;
-            content: any;
-            is_error: boolean;
+            id: any;
+            name: any;
+            input: any;
         }[];
     };
 } | {
@@ -14,9 +23,9 @@ export function normalizeCodexItemEvent(raw: any, context?: {}): {
     message: {
         content: {
             type: string;
-            id: any;
-            name: any;
-            input: any;
+            tool_use_id: any;
+            content: any;
+            is_error: boolean;
         }[];
     };
 } | {

package/types/ai/types.d.ts

@@ -25,6 +25,23 @@
  * every event kind (tool_approval_pending, provider_failover_started,
  * context_compaction_applied, ...) adds its own extra fields.
  */
+/** @typedef {"uniform"|"per-route-native"} RuntimeRouteSafetyMode */
+/**
+ * @typedef {"mono-agent-monotonic"|"disabled"|"mono-agent-srt"|"mono-agent-srt-unsafe-host-fallback"|"provider-native"|"codex-native"|"unsupported"} RuntimeRouteSandboxContract
+ * Fixed telemetry vocabulary for a route's sandbox posture. The
+ * `mono-agent-srt-unsafe-host-fallback` describes a policy that prefers SRT but
+ * explicitly permits host execution if unavailable; it does not claim which
+ * branch ran for a particular command.
+ */
+/** @typedef {"mono-agent-monotonic"|"mono-agent-policy"|"provider-representable"|"exact-allow-all"|"unsupported"} RuntimeRouteToolsContract */
+/**
+ * @typedef {Object} RuntimeRouteSafetyContract
+ * Bounded, credential-free description of the sandbox/tool contract applied
+ * to one fallback route.
+ * @property {RuntimeRouteSafetyMode} mode
+ * @property {RuntimeRouteSandboxContract} sandbox
+ * @property {RuntimeRouteToolsContract} tools
+ */
 /**
  * @typedef {Object} RuntimeObserver
  * Per-call or host-level observer merged by createObserverHub (ai/observer.js).
@@ -82,6 +99,10 @@
  * The options object a host passes to `createRuntime(host).run(systemPrompt, options)`.
  * @property {RuntimeModelRef} model                     Resolved model reference; see parseRuntimeModelReference.
  * @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 {boolean} [sessionKeepAlive]                 Keep resumable provider state alive after the turn.
+ * @property {number} [sessionIdleTimeoutMs]              Idle TTL for resumable provider state.
  * @property {boolean} [liveInput]                        Whether this run expects a live/streaming input channel.
  * @property {ReadonlyArray<*>} [observers]               Per-call observers (see RuntimeObserver) merged with host-level (createRuntime) observers.
  * @property {(event: RuntimeEvent) => void} [onEvent]
@@ -90,6 +111,7 @@
  * @property {boolean} [fastMode]
  * @property {string} [cwd]
  * @property {Object<string, Object>} [mcpServers]
+ * @property {ReadonlyArray<Object>} [skills]             Runtime skill metadata for progressive disclosure.
  * @property {ReadonlyArray<string>} [allowedTools]
  * @property {ReadonlyArray<string>} [disallowedTools]
  * @property {string} [permissionMode]
@@ -146,7 +168,8 @@
  * @property {Array<Object>} [runtimeWarnings]
  * @property {Object} [diagnostics]
  * @property {Object} [capabilitiesUsed]
- * @property {Array<{model: RuntimeModelRef, failureKind: (string|null), requestId?: (string|null), retryableSubkind?: (string|null), requirements?: Object}>} [failoverHistory] Set by createRouterRuntime (ai/runtime/router.js) on every attempt after the first.
+ * @property {Array<{model: RuntimeModelRef, failureKind: (string|null), requestId?: (string|null), retryableSubkind?: (string|null), requirements?: Object, routeSafety?: RuntimeRouteSafetyMode, safetyContract?: RuntimeRouteSafetyContract}>} [failoverHistory] Set by createRouterRuntime (ai/runtime/router.js) on every failed/skipped attempt.
+ * @property {Array<{attemptIndex: number, model: RuntimeModelRef, routeSafety: RuntimeRouteSafetyMode, safetyContract: RuntimeRouteSafetyContract, status: string}>} [routeSafetyHistory] Bounded route-safety audit emitted by createRouterRuntime.
  */
 /**
  * @typedef {Object} RuntimeCapabilities
@@ -304,6 +327,24 @@ export type RuntimeEvent = {
     type: string;
     [key: string]: any;
 };
+export type RuntimeRouteSafetyMode = "uniform" | "per-route-native";
+/**
+ * Fixed telemetry vocabulary for a route's sandbox posture. The
+ * `mono-agent-srt-unsafe-host-fallback` describes a policy that prefers SRT but
+ * explicitly permits host execution if unavailable; it does not claim which
+ * branch ran for a particular command.
+ */
+export type RuntimeRouteSandboxContract = "mono-agent-monotonic" | "disabled" | "mono-agent-srt" | "mono-agent-srt-unsafe-host-fallback" | "provider-native" | "codex-native" | "unsupported";
+export type RuntimeRouteToolsContract = "mono-agent-monotonic" | "mono-agent-policy" | "provider-representable" | "exact-allow-all" | "unsupported";
+/**
+ * Bounded, credential-free description of the sandbox/tool contract applied
+ * to one fallback route.
+ */
+export type RuntimeRouteSafetyContract = {
+    mode: RuntimeRouteSafetyMode;
+    sandbox: RuntimeRouteSandboxContract;
+    tools: RuntimeRouteToolsContract;
+};
 /**
  * Per-call or host-level observer merged by createObserverHub (ai/observer.js).
  * Loose on purpose: observer.js is not a kernel seam file.
@@ -426,6 +467,22 @@ export type RuntimeRunOptions = {
      * "sdk" (default) or "cli"; selects which bridge variant handles the model.
      */
     executionMode?: string;
+    /**
+     * Host conversation/session key for resumable bridges.
+     */
+    sessionId?: string;
+    /**
+     * Provider-owned resume id for resumable bridges.
+     */
+    providerSessionId?: string;
+    /**
+     * Keep resumable provider state alive after the turn.
+     */
+    sessionKeepAlive?: boolean;
+    /**
+     * Idle TTL for resumable provider state.
+     */
+    sessionIdleTimeoutMs?: number;
     /**
      * Whether this run expects a live/streaming input channel.
      */
@@ -442,6 +499,10 @@ export type RuntimeRunOptions = {
     mcpServers?: {
         [x: string]: any;
     };
+    /**
+     * Runtime skill metadata for progressive disclosure.
+     */
+    skills?: ReadonlyArray<any>;
     allowedTools?: ReadonlyArray<string>;
     disallowedTools?: ReadonlyArray<string>;
     permissionMode?: string;
@@ -535,7 +596,7 @@ export type RuntimeResult = {
     diagnostics?: any;
     capabilitiesUsed?: any;
     /**
-     * Set by createRouterRuntime (ai/runtime/router.js) on every attempt after the first.
+     * Set by createRouterRuntime (ai/runtime/router.js) on every failed/skipped attempt.
      */
     failoverHistory?: Array<{
         model: RuntimeModelRef;
@@ -543,6 +604,18 @@ export type RuntimeResult = {
         requestId?: (string | null);
         retryableSubkind?: (string | null);
         requirements?: any;
+        routeSafety?: RuntimeRouteSafetyMode;
+        safetyContract?: RuntimeRouteSafetyContract;
+    }>;
+    /**
+     * Bounded route-safety audit emitted by createRouterRuntime.
+     */
+    routeSafetyHistory?: Array<{
+        attemptIndex: number;
+        model: RuntimeModelRef;
+        routeSafety: RuntimeRouteSafetyMode;
+        safetyContract: RuntimeRouteSafetyContract;
+        status: string;
     }>;
 };
 /**

package/types/index.d.ts

@@ -5,3 +5,4 @@ export * from "./ai/index.js";
 export * from "./agent/index.js";
 export { configureToolRuntime, readToolRuntime, readRuntimeBrand, resetToolRuntime } from "./agent/tools/shared/runtime-context.js";
 export { DEFAULT_RUNTIME_BRAND, resolveRuntimeBrand } from "./runtime-brand.js";
+export { CLAUDE_SDK_CATALOG_VERSION, discoverClaudeSdkModels, normalizeClaudeSdkCatalog, normalizeClaudeSdkModelId } from "./ai/providers/claude-sdk-discovery.js";