muonroi-cli 1.2.0

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,239 @@
+import { type ModelMessage } from "ai";
+import { type ScheduleDaemonStatus, type StoredSchedule } from "../tools/schedule";
+import type { AgentMode, ChatEntry, ModelInfo, SessionInfo, SessionSnapshot, StreamChunk, SubagentStatus, TaskRequest, ToolCall, ToolResult, VerifyRecipe } from "../types/index";
+import { type PermissionMode } from "../utils/permission-mode.js";
+import { type SandboxMode, type SandboxSettings } from "../utils/settings";
+import { type SideQuestionResult } from "../utils/side-question";
+import type { ProviderId } from "../providers/types.js";
+export type { ProviderFactory as LegacyProvider, ResolvedModelRuntime } from "../providers/runtime.js";
+/** @deprecated Use ModelInfo from "../types/index" instead. */
+export type ModelInfoStub = ModelInfo;
+export interface BatchClientOptions {
+    apiKey: string;
+    baseURL?: string;
+    signal?: AbortSignal;
+}
+export interface BatchChatMessage {
+    role: string;
+    content: any;
+    tool_call_id?: string;
+    tool_calls?: any[];
+    name?: string;
+}
+export interface BatchFunctionTool {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: unknown;
+    };
+}
+export interface BatchToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface BatchChatCompletionRequest {
+    model: string;
+    messages: BatchChatMessage[];
+    tools?: BatchFunctionTool[];
+    temperature?: number;
+    max_tokens?: number;
+    reasoning_effort?: string;
+}
+export interface BatchChatCompletionResponse {
+    choices: Array<{
+        message: {
+            role: string;
+            content: string | null;
+            tool_calls?: BatchToolCall[];
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        input_tokens?: number;
+        output_tokens?: number;
+        cost_in_usd_ticks?: number;
+    };
+}
+interface AgentOptions {
+    persistSession?: boolean;
+    session?: string;
+    sandboxMode?: SandboxMode;
+    sandboxSettings?: SandboxSettings;
+    batchApi?: boolean;
+    /** Optional external AbortContext (from src/index.ts SIGINT handler). When provided,
+     *  the orchestrator uses its signal instead of creating a new AbortController per turn.
+     *  TUI-04: Ctrl+C mid-tool-call abort safety. */
+    abortContext?: import("./abort.js").AbortContext;
+    /** Optional PendingCallsLog for Pitfall 9 staged-write tracking per tool call. */
+    pendingCalls?: import("./pending-calls.js").PendingCallsLog;
+    /** Permission mode controlling which tool calls require manual approval.
+     *  safe (default) = confirm all; auto-edit = auto-approve file ops; yolo = auto-approve all. */
+    permissionMode?: PermissionMode;
+}
+type ProcessMessageFinishReason = "stop" | "length" | "content-filter" | "tool-calls" | "error" | "other";
+export interface ProcessMessageUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    costUsdTicks?: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+}
+export interface ProcessMessageStepStart {
+    stepNumber: number;
+    timestamp: number;
+}
+export interface ProcessMessageStepFinish {
+    stepNumber: number;
+    timestamp: number;
+    finishReason: ProcessMessageFinishReason;
+    usage: ProcessMessageUsage;
+}
+export interface ProcessMessageToolStart {
+    toolCall: ToolCall;
+    timestamp: number;
+}
+export interface ProcessMessageToolFinish {
+    toolCall: ToolCall;
+    toolResult: ToolResult;
+    timestamp: number;
+}
+export interface ProcessMessageError {
+    message: string;
+    timestamp: number;
+}
+export interface ProcessMessageObserver {
+    onStepStart?(info: ProcessMessageStepStart): void;
+    onStepFinish?(info: ProcessMessageStepFinish): void;
+    onToolStart?(info: ProcessMessageToolStart): void;
+    onToolFinish?(info: ProcessMessageToolFinish): void;
+    onError?(info: ProcessMessageError): void;
+}
+export declare class Agent {
+    private provider;
+    private providerId;
+    private apiKey;
+    private baseURL;
+    private bash;
+    private delegations;
+    private schedules;
+    private sessionStore;
+    private workspace;
+    private session;
+    private messages;
+    private messageSeqs;
+    private abortController;
+    private maxToolRounds;
+    private mode;
+    private modelId;
+    private maxTokens;
+    private planContext;
+    private subagentStatusListeners;
+    private sendTelegramFile;
+    private batchApi;
+    private sessionStartHookFired;
+    /** PIL context for current turn — set after runPipeline, cleared after recordUsage. */
+    private _pilActive;
+    private _pilEnrichmentDelta;
+    /** External abort context from src/index.ts SIGINT handler (TUI-04). */
+    private externalAbortContext;
+    /** Pending calls log for Pitfall 9 staged-write tracking. */
+    private pendingCalls;
+    /** Active permission mode — controls which tool calls auto-approve vs require user confirmation. */
+    private permissionMode;
+    /** Flow run init promise — awaited before first message turn. */
+    private _flowReady;
+    /** Active .muonroi-flow/ run ID for this session. */
+    private _activeRunId;
+    /** Resume digest loaded from active flow run state.md. */
+    private _resumeDigest;
+    /** Whether compaction already ran during the current turn (prevents double-compact). */
+    private _compactedThisTurn;
+    constructor(apiKey: string | undefined, baseURL?: string, model?: string, maxToolRounds?: number, options?: AgentOptions);
+    /**
+     * Initialize .muonroi-flow/ run for this session.
+     * Fail-open: any error sets _activeRunId = null silently.
+     */
+    private _initFlow;
+    getModel(): string;
+    getActiveRunId(): string | null;
+    setModel(model: string): void;
+    getMode(): AgentMode;
+    getSandboxMode(): SandboxMode;
+    setSandboxMode(mode: SandboxMode): void;
+    getSandboxSettings(): SandboxSettings;
+    setSandboxSettings(settings: SandboxSettings): void;
+    setMode(mode: AgentMode): void;
+    setPlanContext(ctx: string | null): void;
+    setSendTelegramFile(fn: ((filePath: string) => Promise<ToolResult>) | null): void;
+    hasApiKey(): boolean;
+    setApiKey(apiKey: string, baseURL?: string): void;
+    setProviderAndKey(providerId: ProviderId, apiKey: string, baseURL?: string): void;
+    getProviderId(): ProviderId;
+    getCwd(): string;
+    getMessages(): ModelMessage[];
+    listSchedules(): Promise<StoredSchedule[]>;
+    removeSchedule(id: string): Promise<string>;
+    getScheduleDaemonStatus(): Promise<ScheduleDaemonStatus>;
+    getContextStats(contextWindow: number, inFlightText?: string): {
+        contextWindow: number;
+        usedTokens: number;
+        remainingTokens: number;
+        ratioUsed: number;
+        ratioRemaining: number;
+    };
+    generateTitle(userMessage: string): Promise<string>;
+    askSideQuestion(question: string, signal?: AbortSignal): Promise<SideQuestionResult>;
+    abort(): void;
+    cleanup(): Promise<void>;
+    respondToToolApproval(approvalId: string, approved: boolean): void;
+    clearHistory(): Promise<void>;
+    startNewSession(): SessionSnapshot | null;
+    getSessionInfo(): SessionInfo | null;
+    getSessionId(): string | null;
+    getSessionTitle(): string | null;
+    getChatEntries(): ChatEntry[];
+    getSessionSnapshot(): SessionSnapshot | null;
+    onSubagentStatus(listener: (status: SubagentStatus | null) => void): () => void;
+    private emitSubagentStatus;
+    private discardAbortedTurn;
+    private recordUsage;
+    consumeBackgroundNotifications(): Promise<string[]>;
+    private getBatchClientOptions;
+    private executeBatchToolCall;
+    private runTaskRequestBatch;
+    runTaskRequest(request: TaskRequest, onActivity?: (detail: string) => void, abortSignal?: AbortSignal): Promise<ToolResult>;
+    private runTask;
+    private runDelegation;
+    private readDelegation;
+    private listDelegations;
+    private getCompactionSettings;
+    private compactForContext;
+    private postTurnCompact;
+    private _councilStats;
+    private _councilGenerate;
+    private _buildDiscussPrompt;
+    runCouncilRound(topic: string, observer?: ProcessMessageObserver, rounds?: number): AsyncGenerator<StreamChunk, void, unknown>;
+    private processMessageBatchTurn;
+    private appendCompletedTurn;
+    private fireHook;
+    processMessage(userMessage: string, observer?: ProcessMessageObserver, images?: Array<{
+        path: string;
+        mediaType: string;
+        base64: string;
+    }>): AsyncGenerator<StreamChunk, void, unknown>;
+    private _buildRecentTurnsSummary;
+    private _estimateProjectSize;
+    private _countFilesTouched;
+    private requireProvider;
+    detectVerifyRecipe(settings?: SandboxSettings, abortSignal?: AbortSignal): Promise<VerifyRecipe | null>;
+    runVerify(onProgress?: (detail: string) => void, abortSignal?: AbortSignal): Promise<ToolResult>;
+}