@mono-agent/agent-runtime 0.15.0 → 0.15.2

package/src/runtime.js

@@ -40,6 +40,7 @@ import {
 import { createToolContext, updateToolContext } from "./agent/tools/shared/tool-context.js";
 import { resolveRuntimeBrand } from "./runtime-brand.js";
 import { retireDurableNativeSession } from "./ai/providers/pi-native/session-lifecycle.js";
+import { instrumentLiveInputAppliedEvents } from "./ai/runtime/live-input-events.js";
 
 /**
  * @typedef {import('./ai/types.js').AgentRuntimeHostOptions} AgentRuntimeHostOptions
@@ -159,6 +160,7 @@ export function createRuntime(host = {}) {
         observers: [...hostObservers, ...callObservers],
         onEvent: options.onEvent,
       });
+      const liveInput = instrumentLiveInputAppliedEvents(options.liveInput, hub.emit);
       const prompts = resolvePrompts(host.prompts, options.prompts);
       const result = await bridge.execute(systemPrompt, {
         ...hostDefaults,
@@ -172,6 +174,7 @@ export function createRuntime(host = {}) {
         toolContext,
         observerHub: hub,
         onEvent: hub.emit,
+        ...(liveInput === undefined ? {} : { liveInput }),
         // Merged AFTER the spreads so the per-field run>host>default precedence
         // wins over either bag's whole-object `prompts`.
         ...(prompts === undefined ? {} : { prompts }),

package/types/agent/compaction.d.ts

@@ -84,8 +84,6 @@ export type AgentCompactionPolicy = {
     summaryMaxTokens: number;
     fixedOverheadEnabled: boolean;
     compactionMinSavingsTokens: number;
-    toolPayloadCompactionTriggerChars: number;
-    toolPruneTriggerTokens: number;
     toolTextLimitChars: number;
     bashOutputLimitChars: number;
     mcpTextLimitChars: number;

package/types/agent/prompt/skill-index.d.ts

@@ -8,6 +8,9 @@ export function buildSkillPathNote({ assetsPath, skillsRoot }?: {
     skillsRoot?: any;
 }): string;
 /**
+ * Render a complete skill body plus its path note. Omitting `maxChars` returns
+ * the full text; pass a positive `maxChars` only when explicit truncation is
+ * required by the caller.
  * @param {{body?: string, assetsPath?: string, skillsRoot?: any, maxChars?: number}} [options]
  */
 export function formatSkillBodyWithPathNote({ body, assetsPath, skillsRoot, maxChars }?: {

package/types/ai/index.d.ts

@@ -3,5 +3,6 @@ export * from "./runtime/registry.js";
 export { createSessionRegistry, disposeAllProviderSessions, disposeProviderSession, invalidateProviderSession, refreshProviderSession, syncProviderSession } from "./runtime/sessions.js";
 export { createMetricsObserver, createObserverHub } from "./observer.js";
 export { generatePiNativeResponse, piNativeRuntimeBridge } from "./providers/pi-native.js";
+export { getPiBuiltinModel, listPiBuiltinModels, loginPiOAuth, reasoningLevelsForPiModel, resolvePiOAuthApiKey } from "./pi-interop.js";
 export { CLAUDE_SDK_CATALOG_VERSION, createClaudeSdkDiscoveryIsolation, curatedClaudeSdkModels, discoverClaudeSdkModels, normalizeClaudeSdkCatalog, normalizeClaudeSdkModelId } from "./providers/claude-sdk-discovery.js";
 export { buildCapabilitiesUsed, toolCompactionAppliedFromWarnings, UNKNOWN_CAPABILITY } from "./runtime/capabilities-used.js";

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

@@ -168,6 +168,7 @@ export namespace claudeCodeRuntimeBridge {
         export let supports_builtin_tools: boolean;
         export let supports_live_input: boolean;
         export let supports_native_subagents: boolean;
+        export { TOOL_POLICY_PROJECTED as tool_policy };
         let kind_1: string;
         export { kind_1 as kind };
         export let runtime: string;
@@ -301,3 +302,4 @@ export namespace claudeCodeRuntimeBridge {
         };
     }>;
 }
+import { TOOL_POLICY_PROJECTED } from "../runtime/tool-policy.js";

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

@@ -145,5 +145,7 @@ declare namespace CODEX_APP_CAPABILITIES {
     export let supports_live_input: boolean;
     export let supports_native_subagents: boolean;
     export let supports_fast_mode: boolean;
+    export { TOOL_POLICY_ALLOW_ALL_ONLY as tool_policy };
 }
+import { TOOL_POLICY_ALLOW_ALL_ONLY } from "../runtime/tool-policy.js";
 export {};

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

@@ -27,6 +27,7 @@ declare namespace OPENCODE_APP_CAPABILITIES {
     export let supports_live_input: boolean;
     export let supports_native_subagents: boolean;
     export let supports_fast_mode: boolean;
+    export { TOOL_POLICY_ALLOW_ALL_ONLY as tool_policy };
 }
 declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): Promise<{
     text: any;
@@ -91,4 +92,5 @@ declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): P
         context_compaction_applied: any;
     };
 }>;
+import { TOOL_POLICY_ALLOW_ALL_ONLY } from "../runtime/tool-policy.js";
 export {};

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

@@ -1,15 +1,16 @@
 export function runtimeCapabilities(sdkOrModel: any): any;
 export namespace COMMON_CAPABILITIES {
-    let streaming: boolean;
-    let structured_output: boolean;
-    let supports_session_resume: boolean;
-    let native_runtime_config: any;
-    let supports_mcp: boolean;
-    let supports_skills: boolean;
-    let supports_builtin_tools: boolean;
-    let supports_live_input: boolean;
-    let supports_native_subagents: boolean;
-    let supports_fast_mode: boolean;
+    export let streaming: boolean;
+    export let structured_output: boolean;
+    export let supports_session_resume: boolean;
+    export let native_runtime_config: any;
+    export let supports_mcp: boolean;
+    export let supports_skills: boolean;
+    export let supports_builtin_tools: boolean;
+    export let supports_live_input: boolean;
+    export let supports_native_subagents: boolean;
+    export let supports_fast_mode: boolean;
+    export { TOOL_POLICY_PROJECTED as tool_policy };
 }
 export namespace RUNTIME_CAPABILITIES {
     namespace claude {
@@ -30,6 +31,7 @@ export namespace RUNTIME_CAPABILITIES {
         export { supports_session_resume_3 as supports_session_resume };
         let supports_fast_mode_1: boolean;
         export { supports_fast_mode_1 as supports_fast_mode };
+        export { TOOL_POLICY_ALLOW_ALL_ONLY as tool_policy };
         let runtime_2: string;
         export { runtime_2 as runtime };
     }
@@ -46,7 +48,10 @@ export namespace RUNTIME_CAPABILITIES {
         export { supports_live_input_1 as supports_live_input };
         let supports_native_subagents_2: boolean;
         export { supports_native_subagents_2 as supports_native_subagents };
+        export { TOOL_POLICY_ALLOW_ALL_ONLY as tool_policy };
         let runtime_3: string;
         export { runtime_3 as runtime };
     }
 }
+import { TOOL_POLICY_PROJECTED } from "./tool-policy.js";
+import { TOOL_POLICY_ALLOW_ALL_ONLY } from "./tool-policy.js";

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/runtime/tool-policy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * True when a tool policy is semantically unrestricted.
+ *
+ * An omitted allowlist and any allowlist containing the global `"*"` sentinel
+ * both mean allow-all. A denylist still makes the policy restrictive.
+ *
+ * @param {*} allowedTools
+ * @param {*} disallowedTools
+ * @returns {boolean}
+ */
+export function isAllowAllToolPolicy(allowedTools: any, disallowedTools: any): boolean;
+/** @type {"projected"} */
+export const TOOL_POLICY_PROJECTED: "projected";
+/** @type {"allow_all_only"} */
+export const TOOL_POLICY_ALLOW_ALL_ONLY: "allow_all_only";

package/types/ai/types.d.ts

@@ -33,7 +33,12 @@
  * 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 {"mono-agent-monotonic"|"mono-agent-policy"|"provider-representable"|"exact-allow-all"|"unsupported"} RuntimeRouteToolsContract
+ * `exact-allow-all` is a stable telemetry token. It describes an effective
+ * unrestricted contract, including mixed allowlists that contain `"*"`;
+ * it does not require the literal one-element array `["*"]`.
+ */
 /**
  * @typedef {Object} RuntimeRouteSafetyContract
  * Bounded, credential-free description of the sandbox/tool contract applied
@@ -102,6 +107,7 @@
  * @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, 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.
@@ -190,6 +196,10 @@
  * @property {boolean} [supports_live_input]
  * @property {boolean} [supports_native_subagents]
  * @property {boolean} [supports_fast_mode]
+ * @property {"projected"|"allow_all_only"} [tool_policy] Whether the bridge can
+ *   project named allow/deny policies or accepts only a semantically unrestricted
+ *   policy. Built-in bridges always report this field; omission means unknown
+ *   for custom structural capability objects.
  */
 /**
  * @typedef {Object} RuntimeBridge
@@ -340,6 +350,11 @@ export type RuntimeRouteSafetyMode = "uniform" | "per-route-native";
  * 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";
+/**
+ * `exact-allow-all` is a stable telemetry token. It describes an effective
+ * unrestricted contract, including mixed allowlists that contain `"*"`;
+ * it does not require the literal one-element array `["*"]`.
+ */
 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
@@ -481,6 +496,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.
      */
@@ -649,6 +668,13 @@ export type RuntimeCapabilities = {
     supports_live_input?: boolean;
     supports_native_subagents?: boolean;
     supports_fast_mode?: boolean;
+    /**
+     * Whether the bridge can
+     * project named allow/deny policies or accepts only a semantically unrestricted
+     * policy. Built-in bridges always report this field; omission means unknown
+     * for custom structural capability objects.
+     */
+    tool_policy?: "projected" | "allow_all_only";
 };
 /**
  * A fully loaded bridge (registry.js's resolveRuntimeBridge result): the

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";