@mono-agent/agent-runtime 0.4.0 → 0.5.0

package/types/ai/file-change-stats.d.ts

@@ -0,0 +1,75 @@
+export function readFileChangeSnapshot(path: any): {
+    exists: boolean;
+    line_count: number;
+    size?: undefined;
+    unavailable_reason?: undefined;
+    content?: undefined;
+} | {
+    exists: boolean;
+    size: number;
+    unavailable_reason: string;
+    line_count?: undefined;
+    content?: undefined;
+} | {
+    exists: boolean;
+    size: number;
+    content: string;
+    line_count: number;
+    unavailable_reason?: undefined;
+} | {
+    exists: boolean;
+    line_count: number;
+    unavailable_reason: any;
+    size?: undefined;
+    content?: undefined;
+};
+export function statsForCompletedChange(change: any, before: any, after: any): {
+    before_lines: number;
+    after_lines: number;
+    added_lines: number;
+    removed_lines: number;
+    changed_lines: number;
+} | {
+    before_lines: any;
+    after_lines: any;
+    unavailable_reason: any;
+};
+export function fileChangeSummary(changes: any): {
+    files: any;
+    added_lines: any;
+    removed_lines: any;
+    changed_lines: any;
+    unavailable_count: any;
+};
+export function createFileChangePayload(raw: any, { cwd, snapshots }?: {
+    cwd?: string;
+    snapshots?: Map<any, any>;
+}): {
+    summary?: any;
+    changes: any;
+    status: any;
+};
+export function createFileEditToolUseEvent(id: any, payload: any): {
+    type: string;
+    message: {
+        content: {
+            type: string;
+            id: any;
+            name: string;
+            input: any;
+        }[];
+    };
+};
+export function createFileEditToolResultEvent(id: any, payload: any, { isError }?: {
+    isError?: boolean;
+}): {
+    type: string;
+    message: {
+        content: {
+            type: string;
+            tool_use_id: any;
+            content: any;
+            is_error: boolean;
+        }[];
+    };
+};

package/types/ai/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./registry.js";
+export * from "./runtime/model-refs.js";
+export * from "./runtime/registry.js";
+export { createSessionRegistry, disposeAllProviderSessions, disposeProviderSession } from "./runtime/sessions.js";
+export { createMetricsObserver, createObserverHub } from "./observer.js";
+export { generatePiNativeResponse, piNativeRuntimeBridge } from "./providers/pi-native.js";
+export { buildCapabilitiesUsed, toolCompactionAppliedFromWarnings, UNKNOWN_CAPABILITY } from "./runtime/capabilities-used.js";

package/types/ai/live-input-prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {string} text
+ * @param {import('./types.js').RuntimePromptOverrides} [prompts]
+ * @returns {string}
+ */
+export function formatLiveInputGuidance(text: string, prompts?: import("./types.js").RuntimePromptOverrides): string;

package/types/ai/observer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @typedef Observer
+ * @property {string=} name
+ * @property {(event: object) => void} recordEvent
+ * @property {(metric: object) => void=} recordMetric
+ * @property {() => (void | Promise<void>)=} flush
+ */
+export function createObserverHub({ observers, onEvent }?: {
+    observers?: any[];
+    onEvent?: any;
+}): {
+    emit: (event: any) => void;
+    recordMetric: (metric: any) => void;
+    flush: () => Promise<void>;
+    observers: () => any[];
+};
+export function createMetricsObserver({ name }?: {
+    name?: string;
+}): {
+    name: string;
+    recordEvent: (event: any) => void;
+    recordMetric: () => void;
+    snapshot: () => {
+        events: {
+            total: number;
+            byType: any;
+        };
+        tokens: {
+            input: number;
+            output: number;
+            cacheReadTokens: number;
+            cacheCreationTokens: number;
+        };
+        cost: {
+            cumulativeUsd: number;
+        };
+        cache: {
+            hits: number;
+            misses: number;
+            hitRatio: number;
+            readTokensFromEvents: number;
+        };
+        tools: {
+            callsByName: any;
+            errorsByName: any;
+        };
+        errors: {
+            total: number;
+            byKind: any;
+        };
+        turns: {
+            count: number;
+            latencyMsP50: any;
+            latencyMsP95: any;
+        };
+        approvals: {
+            pending: number;
+            granted: number;
+            denied: number;
+        };
+    };
+};
+export type Observer = {
+    name?: string | undefined;
+    recordEvent: (event: object) => void;
+    recordMetric?: ((metric: object) => void) | undefined;
+    flush?: (() => (void | Promise<void>)) | undefined;
+};

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

@@ -0,0 +1,211 @@
+export function createThinkingBuffer(): {
+    isStreamShape: (raw: any) => boolean;
+    onStreamEvent: (raw: any) => void;
+    rehydrate: (assistantRaw: any) => any;
+};
+export function normalizeCliEvent(raw: any, context?: {}): any;
+export function buildCliCommand({ sdk, model, effort, cwd, schemaPath, outputSchema, systemPrompt, prompt, mcpConfigPath, mcpServers, allowedTools, disallowedTools, permissionMode, maxTurns, skillDirs, resumeSessionId, nativeSubagents, contextWindow, }: {
+    sdk: any;
+    model: any;
+    effort: any;
+    cwd: any;
+    schemaPath: any;
+    outputSchema: any;
+    systemPrompt: any;
+    prompt: any;
+    mcpConfigPath: any;
+    mcpServers: any;
+    allowedTools: any;
+    disallowedTools: any;
+    permissionMode: any;
+    maxTurns: any;
+    skillDirs: any;
+    resumeSessionId: any;
+    nativeSubagents: any;
+    contextWindow: any;
+}): {
+    command: string;
+    args: any[];
+    cwd: any;
+};
+export function generateCliResponse(systemPrompt: any, options?: {}): Promise<{
+    text: any;
+    structuredResult: undefined;
+    structuredResultSource: string;
+    events: any[];
+    usage: {
+        input_tokens: any;
+        output_tokens: any;
+        cache_read_tokens: any;
+        cache_creation_tokens: any;
+        cost_usd: number;
+    };
+    durationMs: number;
+    numTurns: number;
+    model: string;
+    effort: any;
+    sdk: any;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    stderrTail: string;
+    diagnostics: {
+        had_partial_progress?: boolean;
+        pi_error_code?: string;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+} | {
+    text: any;
+    structuredResult: undefined;
+    structuredResultSource: string;
+    events: any[];
+    usage: {};
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: any;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    stderrTail: string;
+    diagnostics: {
+        had_partial_progress?: boolean;
+        pi_error_code?: string;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+}>;
+export namespace claudeCodeBackend {
+    export let kind: string;
+    export namespace capabilities {
+        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;
+        let kind_1: string;
+        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<{
+        text: any;
+        structuredResult: undefined;
+        structuredResultSource: string;
+        events: any[];
+        usage: {
+            input_tokens: any;
+            output_tokens: any;
+            cache_read_tokens: any;
+            cache_creation_tokens: any;
+            cost_usd: number;
+        };
+        durationMs: number;
+        numTurns: number;
+        model: string;
+        effort: any;
+        sdk: any;
+        providerSessionId: any;
+        provider_session_id: any;
+        cancelled: boolean;
+        error: any;
+        failureKind: string;
+        stderrTail: string;
+        diagnostics: {
+            had_partial_progress?: boolean;
+            pi_error_code?: string;
+        };
+        capabilitiesUsed: {
+            prompt_cache_active: any;
+            thinking_enabled: any;
+            structured_output_enforced: boolean;
+            subagent_invoked: any;
+            mcp_servers_used: any[];
+            native_subagents_used: any[];
+            tool_compaction_applied: boolean;
+            context_compaction_applied: any;
+        };
+    } | {
+        text: any;
+        structuredResult: undefined;
+        structuredResultSource: string;
+        events: any[];
+        usage: {};
+        durationMs: number;
+        numTurns: number;
+        model: any;
+        effort: any;
+        sdk: any;
+        providerSessionId: any;
+        provider_session_id: any;
+        cancelled: boolean;
+        error: any;
+        failureKind: string;
+        stderrTail: string;
+        diagnostics: {
+            had_partial_progress?: boolean;
+            pi_error_code?: string;
+        };
+        capabilitiesUsed: {
+            prompt_cache_active: any;
+            thinking_enabled: any;
+            structured_output_enforced: boolean;
+            subagent_invoked: any;
+            mcp_servers_used: any[];
+            native_subagents_used: any[];
+            tool_compaction_applied: boolean;
+            context_compaction_applied: any;
+        };
+    }>;
+}

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

@@ -0,0 +1,66 @@
+export function toolPayloadLimit(options: any): {
+    bytes: number;
+    usedSettings: boolean;
+};
+export function generateClaudeResponse(systemPrompt: any, options: any): Promise<{
+    text: string;
+    structuredResult: any;
+    structuredResultSource: string;
+    events: any[];
+    usage: {
+        input_tokens: any;
+        output_tokens: any;
+        cache_read_tokens: any;
+        cache_creation_tokens: any;
+        cost_usd: number;
+    };
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: string;
+    cancelled: boolean;
+    error: any;
+    errorDetails: {
+        claude_error_subtype: any;
+        last_text_excerpt: string;
+        last_tool_name: any;
+        had_partial_progress: boolean;
+        tool_results_seen: number;
+        turn_count: number;
+        max_turns_hit: boolean;
+        structured_output_retry_exhausted: boolean;
+        last_structured_output_rejection: any;
+        provider_session_id: any;
+    };
+    failureKind: string;
+    providerSessionId: string;
+    runtimeWarnings: {
+        warning_kind: string;
+        message: any;
+    }[];
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        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 function supports(ref: any): boolean;
+    export { generateClaudeResponse as execute };
+}

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

@@ -0,0 +1,2 @@
+export function claudeNativeAgentDefinitions(nativeSubagents: any): {};
+export function claudeToolsWithNativeSubagents(allowedTools: any, nativeSubagents: any): any;

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

@@ -0,0 +1,151 @@
+/**
+ * @param {{command?: string, args?: string[], cwd?: any, env?: any, onNotification?: (msg: any) => void}} [options]
+ */
+export function createCodexAppServerClient({ command, args, cwd, env, onNotification, }?: {
+    command?: string;
+    args?: string[];
+    cwd?: any;
+    env?: any;
+    onNotification?: (msg: any) => void;
+}): {
+    request: (method: any, params: any, { timeoutMs }?: {
+        timeoutMs?: number;
+    }) => Promise<any>;
+    close: () => void;
+    child: import("child_process").ChildProcessWithoutNullStreams;
+    closed: Promise<any>;
+};
+export function generateCodexAppResponse(systemPrompt: any, options?: {}): Promise<{
+    text: any;
+    structuredResult: any;
+    structuredResultSource: any;
+    events: any[];
+    usage: {};
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: string;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: any;
+    diagnostics: {
+        codex_error_code: any;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+} | {
+    text: any;
+    structuredResult: any;
+    structuredResultSource: any;
+    events: any[];
+    usage: {
+        input_tokens: any;
+        output_tokens: any;
+        cache_read_tokens: any;
+        cache_creation_tokens: any;
+        cost_usd: number;
+    };
+    durationMs: number;
+    numTurns: number;
+    model: string;
+    effort: any;
+    sdk: string;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    diagnostics: {
+        had_partial_progress?: boolean;
+        codex_error_code?: string;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+} | {
+    text: any;
+    structuredResult: any;
+    structuredResultSource: any;
+    events: any[];
+    usage: {};
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: string;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    diagnostics: {
+        had_partial_progress?: boolean;
+        codex_error_code?: undefined;
+    } | {
+        had_partial_progress?: boolean;
+        stderr_tail?: any;
+        codex_error_code: string;
+        codex_request_method: any;
+        codex_request_timeout_ms: any;
+    } | {
+        had_partial_progress?: boolean;
+        codex_error_code: string;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        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 { 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 };
+    export let runtime: string;
+    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 {};

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

@@ -0,0 +1,95 @@
+export function opencodeMcpConfig(mcpServers?: {}): {};
+export function mapErrorFailureKind(error: any): "usage_limit" | "provider_unavailable" | "cancelled";
+export function mapSpawnFailureKind(err: any): "spawn" | "provider_unavailable";
+export namespace opencodeAppRuntimeBridge {
+    export let id: string;
+    export let kind: string;
+    export { OPENCODE_APP_CAPABILITIES as capabilities };
+    export function supports(ref: any, options: any): boolean;
+    export { generateOpencodeAppResponse as execute };
+}
+declare namespace OPENCODE_APP_CAPABILITIES {
+    let kind_1: string;
+    export { kind_1 as kind };
+    export let runtime: string;
+    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;
+}
+declare function generateOpencodeAppResponse(systemPrompt: any, options?: {}): Promise<{
+    text: string;
+    structuredResult: any;
+    structuredResultSource: any;
+    events: any[];
+    usage: {
+        cost_usd: any;
+        input_tokens?: any;
+        output_tokens?: any;
+        cache_read_tokens?: any;
+        cache_creation_tokens?: any;
+    };
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: string;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    diagnostics: {};
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+} | {
+    text: string;
+    structuredResult: any;
+    structuredResultSource: any;
+    events: any[];
+    usage: {
+        cost_usd: number;
+        input_tokens: any;
+        output_tokens: any;
+        cache_read_tokens: any;
+        cache_creation_tokens: any;
+    };
+    durationMs: number;
+    numTurns: number;
+    model: any;
+    effort: any;
+    sdk: string;
+    providerSessionId: any;
+    provider_session_id: any;
+    cancelled: boolean;
+    error: any;
+    failureKind: string;
+    diagnostics: {
+        had_partial_progress?: boolean;
+    };
+    capabilitiesUsed: {
+        prompt_cache_active: any;
+        thinking_enabled: any;
+        structured_output_enforced: boolean;
+        subagent_invoked: any;
+        mcp_servers_used: any[];
+        native_subagents_used: any[];
+        tool_compaction_applied: boolean;
+        context_compaction_applied: any;
+    };
+}>;
+export {};

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

@@ -0,0 +1,4 @@
+export function discoverOpencodeProviders({ createServer }?: {
+    createServer?: typeof createOpencode;
+}): Promise<any>;
+import { createOpencode } from "@opencode-ai/sdk";

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

@@ -0,0 +1,3 @@
+export function normalizePiErrorMessage(message: any): any;
+export function isContextLimitError(message: any): boolean;
+export function parseContextLimitFromError(message: any): number;