openfox 0.1.0

package/dist/protocol-BJsm88OW.d.ts

@@ -0,0 +1,760 @@
+interface Project {
+    id: string;
+    name: string;
+    workdir: string;
+    customInstructions?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+type SessionMode = string;
+type ToolMode = string;
+type SessionPhase = 'plan' | 'build' | 'verification' | 'blocked' | 'done';
+interface Session {
+    id: string;
+    projectId: string;
+    workdir: string;
+    mode: SessionMode;
+    phase: SessionPhase;
+    isRunning: boolean;
+    summary: string | null;
+    providerId?: string | null;
+    providerModel?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messages: Message[];
+    criteria: Criterion[];
+    contextWindows: ContextWindow[];
+    executionState: ExecutionState | null;
+    metadata: SessionMetadata;
+}
+interface ContextWindow {
+    id: string;
+    sessionId: string;
+    sequenceNumber: number;
+    createdAt: string;
+    summaryOfPrevious?: string;
+    summaryTokenCount?: number;
+    closedAt?: string;
+    tokenCountAtClose?: number;
+}
+interface SessionMetadata {
+    title?: string;
+    totalTokensUsed: number;
+    totalToolCalls: number;
+    iterationCount: number;
+}
+interface RecentUserPrompt {
+    id: string;
+    content: string;
+    timestamp: string;
+}
+interface SessionSummary {
+    id: string;
+    projectId: string;
+    title?: string;
+    workdir: string;
+    mode: SessionMode;
+    phase: SessionPhase;
+    isRunning: boolean;
+    providerId?: string | null;
+    providerModel?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    criteriaCount: number;
+    criteriaCompleted: number;
+    recentUserPrompts?: RecentUserPrompt[];
+}
+type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+type MessageSegment = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'thinking';
+    content: string;
+} | {
+    type: 'tool_call';
+    toolCallId: string;
+};
+interface MessageStats {
+    providerId: string;
+    providerName: string;
+    backend: ProviderBackend;
+    model: string;
+    mode: ToolMode;
+    totalTime: number;
+    toolTime: number;
+    prefillTokens: number;
+    prefillSpeed: number;
+    generationTokens: number;
+    generationSpeed: number;
+    llmCalls?: LLMCallStats[];
+}
+interface LLMCallStats {
+    providerId: string;
+    providerName: string;
+    backend: ProviderBackend;
+    model: string;
+    callIndex: number;
+    promptTokens: number;
+    completionTokens: number;
+    ttft: number;
+    completionTime: number;
+    prefillSpeed: number;
+    generationSpeed: number;
+    totalTime: number;
+    timestamp?: string;
+}
+interface StatsDataPoint {
+    messageId: string;
+    timestamp: string;
+    providerId: string;
+    providerName: string;
+    backend: ProviderBackend;
+    model: string;
+    mode: ToolMode;
+    responseIndex: number;
+    prefillTokens: number;
+    generationTokens: number;
+    prefillSpeed: number;
+    generationSpeed: number;
+    totalTime: number;
+    aiTime: number;
+    toolTime: number;
+}
+interface CallStatsDataPoint {
+    messageId: string;
+    timestamp: string;
+    providerId: string;
+    providerName: string;
+    backend: ProviderBackend;
+    model: string;
+    mode: ToolMode;
+    responseIndex: number;
+    sessionCallIndex: number;
+    callIndex: number;
+    promptTokens: number;
+    completionTokens: number;
+    ttft: number;
+    completionTime: number;
+    prefillSpeed: number;
+    generationSpeed: number;
+    totalTime: number;
+}
+interface SessionStats {
+    totalTime: number;
+    aiTime: number;
+    toolTime: number;
+    prefillTokens: number;
+    generationTokens: number;
+    avgPrefillSpeed: number;
+    avgGenerationSpeed: number;
+    responseCount: number;
+    llmCallCount: number;
+    dataPoints: StatsDataPoint[];
+    callDataPoints: CallStatsDataPoint[];
+    modelGroups: ModelSessionStats[];
+}
+interface StatsIdentity {
+    providerId: string;
+    providerName: string;
+    backend: ProviderBackend;
+    model: string;
+}
+interface ModelSessionStats extends StatsIdentity {
+    key: string;
+    label: string;
+    totalTime: number;
+    aiTime: number;
+    toolTime: number;
+    prefillTokens: number;
+    generationTokens: number;
+    avgPrefillSpeed: number;
+    avgGenerationSpeed: number;
+    responseCount: number;
+    llmCallCount: number;
+    dataPoints: StatsDataPoint[];
+    callDataPoints: CallStatsDataPoint[];
+}
+interface PromptContext {
+    systemPrompt: string;
+    injectedFiles: InjectedFile[];
+    userMessage: string;
+    messages: PromptContextMessage[];
+    tools: PromptContextTool[];
+    requestOptions: PromptRequestOptions;
+}
+interface PromptContextMessage {
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+    source: 'history' | 'runtime';
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    toolCallId?: string;
+    attachments?: Attachment[];
+}
+interface PromptContextTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface PromptRequestOptions {
+    toolChoice: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    disableThinking: boolean;
+}
+interface InjectedFile {
+    path: string;
+    content: string;
+    source: 'agents-md' | 'global' | 'project';
+}
+interface PreparingToolCall {
+    index: number;
+    name: string;
+}
+interface Attachment {
+    id: string;
+    filename: string;
+    mimeType: 'image/png' | 'image/jpeg' | 'image/gif';
+    size: number;
+    data: string;
+}
+interface Message {
+    id: string;
+    role: MessageRole;
+    content: string;
+    contextWindowId?: string;
+    toolCalls?: ToolCall[];
+    preparingToolCalls?: PreparingToolCall[];
+    thinkingContent?: string;
+    toolCallId?: string;
+    toolName?: string;
+    toolResult?: ToolResult;
+    timestamp: string;
+    tokenCount?: number;
+    isCompacted?: boolean;
+    originalMessageIds?: string[];
+    segments?: MessageSegment[];
+    stats?: MessageStats;
+    partial?: boolean;
+    isSystemGenerated?: boolean;
+    isStreaming?: boolean;
+    messageKind?: 'correction' | 'auto-prompt' | 'context-reset' | 'task-completed' | 'workflow-started' | 'command';
+    isCompactionSummary?: boolean;
+    subAgentId?: string;
+    subAgentType?: string;
+    promptContext?: PromptContext;
+    attachments?: Attachment[];
+}
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: ToolResult;
+    startedAt?: number;
+    streamingOutput?: Array<{
+        stream: 'stdout' | 'stderr';
+        content: string;
+    }>;
+    parseError?: string;
+    rawArguments?: string;
+}
+/** A single line of context around an edit */
+interface EditContextLine {
+    lineNumber: number;
+    content: string;
+}
+/** A single edit within a region (for replace_all with multiple matches) */
+interface EditContextEdit {
+    startLine: number;
+    endLine: number;
+    oldContent: string;
+    newContent: string;
+}
+/**
+ * A region of the file showing context around one or more edits.
+ * Multiple edits are merged when their contexts overlap.
+ */
+interface EditContextRegion {
+    beforeContext: EditContextLine[];
+    afterContext: EditContextLine[];
+    startLine: number;
+    endLine: number;
+    oldContent: string;
+    newContent: string;
+    edits: EditContextEdit[];
+}
+interface ToolResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    durationMs: number;
+    truncated: boolean;
+    diagnostics?: Diagnostic[];
+    editContext?: {
+        regions: EditContextRegion[];
+    };
+    metadata?: Record<string, unknown>;
+}
+type ToolName = 'read_file' | 'write_file' | 'edit_file' | 'run_command' | 'glob' | 'grep' | 'ask_user' | 'add_criterion' | 'update_criterion' | 'remove_criterion' | 'get_criteria' | 'complete_criterion' | 'pass_criterion' | 'fail_criterion' | 'todo_write' | 'web_fetch';
+interface Criterion {
+    id: string;
+    description: string;
+    status: CriterionStatus;
+    attempts: CriterionAttempt[];
+}
+type CriterionStatus = {
+    type: 'pending';
+} | {
+    type: 'in_progress';
+} | {
+    type: 'completed';
+    completedAt: string;
+    reason?: string;
+} | {
+    type: 'passed';
+    verifiedAt: string;
+    reason?: string;
+} | {
+    type: 'failed';
+    reason: string;
+    failedAt: string;
+};
+interface CriterionAttempt {
+    attemptNumber: number;
+    status: 'passed' | 'failed';
+    timestamp: string;
+    details?: string;
+}
+interface Todo {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+}
+interface FileReadEntry {
+    hash: string;
+    readAt: string;
+}
+interface ExecutionState {
+    iteration: number;
+    modifiedFiles: string[];
+    readFiles: Record<string, FileReadEntry>;
+    consecutiveFailures: number;
+    lastFailedTool?: string;
+    lastFailureReason?: string;
+    currentTokenCount: number;
+    messageCountAtLastUpdate: number;
+    compactionCount: number;
+    startedAt: string;
+    lastActivityAt: string;
+}
+interface ContextState {
+    currentTokens: number;
+    maxTokens: number;
+    compactionCount: number;
+    dangerZone: boolean;
+    canCompact: boolean;
+}
+interface ValidationResult {
+    allPassed: boolean;
+    results: CriterionValidation[];
+}
+interface CriterionValidation {
+    criterionId: string;
+    status: 'pass' | 'fail';
+    reasoning: string;
+    issues: string[];
+}
+interface Diagnostic {
+    path: string;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    message: string;
+    source: string;
+    code?: string | number;
+}
+/** Supported LLM inference backends */
+type LlmBackend = 'vllm' | 'sglang' | 'ollama' | 'llamacpp' | 'unknown';
+/** Extended backend type including cloud providers */
+type ProviderBackend = LlmBackend | 'openai' | 'anthropic' | 'auto';
+/** LLM provider configuration */
+interface Provider {
+    id: string;
+    name: string;
+    url: string;
+    backend: ProviderBackend;
+    apiKey?: string | undefined;
+    maxContext?: number | undefined;
+    isActive: boolean;
+    createdAt: string;
+}
+interface Config {
+    llm: {
+        baseUrl: string;
+        model: string;
+        timeout: number;
+        idleTimeout: number;
+        /** Backend type - 'auto' for auto-detection, or explicit backend name */
+        backend: LlmBackend | 'auto';
+        /** Disable thinking/reasoning globally (for e2e tests) */
+        disableThinking?: boolean;
+    };
+    context: {
+        maxTokens: number;
+        compactionThreshold: number;
+        compactionTarget: number;
+    };
+    agent: {
+        maxIterations: number;
+        maxConsecutiveFailures: number;
+        toolTimeout: number;
+    };
+    server: {
+        port: number;
+        host: string;
+        openBrowser?: boolean;
+    };
+    database: {
+        path: string;
+    };
+    logging?: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+    };
+    mode?: 'development' | 'production';
+    dev?: boolean;
+    /** Configured providers (loaded from global config) */
+    providers?: Provider[] | undefined;
+    /** Default model selection in format "providerId/modelName" */
+    defaultModelSelection?: string | undefined;
+    /** ID of the active provider (deprecated, use defaultModelSelection) */
+    activeProviderId?: string | undefined;
+    /** Workspace directory for projects */
+    workdir: string;
+    /** Active workflow ID (defaults to "default") */
+    activeWorkflowId?: string | undefined;
+}
+
+type ClientMessageType = 'project.create' | 'project.create-with-dir' | 'project.list' | 'project.load' | 'project.update' | 'project.delete' | 'session.create' | 'session.load' | 'session.list' | 'session.delete' | 'session.deleteAll' | 'chat.send' | 'chat.stop' | 'chat.continue' | 'mode.switch' | 'mode.accept' | 'criteria.edit' | 'context.compact' | 'runner.launch' | 'path.confirm' | 'settings.get' | 'settings.set' | 'provider.activate' | 'session.setProvider' | 'queue.asap' | 'queue.completion' | 'queue.cancel';
+interface ClientMessage<T = unknown> {
+    id: string;
+    type: ClientMessageType;
+    payload: T;
+}
+interface ProjectCreatePayload {
+    name: string;
+    workdir: string;
+}
+interface ProjectCreateWithDirPayload {
+    name: string;
+}
+interface ProjectLoadPayload {
+    projectId: string;
+}
+interface ProjectUpdatePayload {
+    projectId: string;
+    name?: string;
+    customInstructions?: string | null;
+}
+interface ProjectDeletePayload {
+    projectId: string;
+}
+interface SessionCreatePayload {
+    projectId: string;
+    title?: string;
+}
+interface SessionLoadPayload {
+    sessionId: string;
+    lastEventSeq?: number;
+}
+interface SessionDeleteAllPayload {
+    projectId: string;
+}
+interface ChatSendPayload {
+    content: string;
+    attachments?: Attachment[];
+    messageKind?: 'command';
+    isSystemGenerated?: boolean;
+}
+interface ModeSwitchPayload {
+    mode: SessionMode;
+}
+interface CriteriaEditPayload {
+    criteria: Criterion[];
+}
+interface SettingsGetPayload {
+    key: string;
+}
+interface SettingsSetPayload {
+    key: string;
+    value: string;
+}
+interface SettingsValuePayload {
+    key: string;
+    value: string | null;
+}
+interface ProviderActivatePayload {
+    providerId: string;
+}
+interface SessionSetProviderPayload {
+    providerId: string;
+    model?: string;
+}
+interface QueueAsapPayload {
+    content: string;
+    attachments?: Attachment[];
+}
+interface QueueCompletionPayload {
+    content: string;
+    attachments?: Attachment[];
+}
+interface QueueCancelPayload {
+    queueId: string;
+}
+interface QueuedMessage {
+    queueId: string;
+    mode: 'asap' | 'completion';
+    content: string;
+    attachments?: Attachment[];
+    queuedAt: string;
+}
+type ServerMessageType = 'project.state' | 'project.list' | 'project.deleted' | 'session.state' | 'session.list' | 'session.deleted' | 'session.deletedAll' | 'session.running' | 'session.name_generated' | 'chat.delta' | 'chat.thinking' | 'chat.tool_preparing' | 'chat.tool_call' | 'chat.tool_output' | 'chat.tool_result' | 'chat.todo' | 'chat.summary' | 'chat.progress' | 'chat.format_retry' | 'chat.message' | 'chat.message_updated' | 'chat.done' | 'chat.error' | 'chat.path_confirmation' | 'mode.changed' | 'phase.changed' | 'task.completed' | 'criteria.updated' | 'context.state' | 'settings.value' | 'provider.changed' | 'queue.state' | 'lsp.diagnostics' | 'error' | 'ack';
+interface ServerMessage<T = unknown> {
+    id?: string;
+    type: ServerMessageType;
+    payload: T;
+    seq?: number;
+    sessionId?: string;
+}
+interface ProjectStatePayload {
+    project: Project;
+}
+interface ProjectListPayload {
+    projects: Project[];
+}
+interface ProjectDeletedPayload {
+    projectId: string;
+}
+interface SessionStatePayload {
+    session: Session;
+    messages: Message[];
+}
+interface SessionListPayload {
+    sessions: SessionSummary[];
+}
+interface SessionRunningPayload {
+    isRunning: boolean;
+}
+interface SessionNameGeneratedPayload {
+    name: string;
+}
+interface ChatDeltaPayload {
+    messageId: string;
+    content: string;
+}
+interface ChatThinkingPayload {
+    messageId: string;
+    content: string;
+}
+interface ChatToolPreparingPayload {
+    messageId: string;
+    index: number;
+    name: string;
+}
+interface ChatToolCallPayload {
+    messageId: string;
+    callId: string;
+    tool: string;
+    args: Record<string, unknown>;
+}
+interface ChatToolResultPayload {
+    messageId: string;
+    callId: string;
+    tool: string;
+    result: ToolResult;
+}
+interface ChatToolOutputPayload {
+    messageId: string;
+    callId: string;
+    output: string;
+    stream: 'stdout' | 'stderr';
+}
+interface ChatTodoPayload {
+    todos: Todo[];
+}
+interface ChatSummaryPayload {
+    summary: string;
+}
+interface ChatProgressPayload {
+    message: string;
+    phase?: 'summary' | 'mode_switch' | 'starting' | 'context_warning' | 'context_error';
+}
+interface ChatFormatRetryPayload {
+    attempt: number;
+    maxAttempts: number;
+}
+interface ChatMessagePayload {
+    message: Message;
+}
+interface ChatMessageUpdatedPayload {
+    messageId: string;
+    updates: Partial<Pick<Message, 'content' | 'thinkingContent' | 'toolCalls' | 'isStreaming' | 'stats' | 'promptContext' | 'partial'>>;
+}
+interface ChatDonePayload {
+    messageId: string;
+    reason: 'complete' | 'stopped' | 'error' | 'waiting_for_user';
+    stats?: {
+        model: string;
+        mode: ToolMode;
+        totalTime: number;
+        toolTime: number;
+        prefillTokens: number;
+        prefillSpeed: number;
+        generationTokens: number;
+        generationSpeed: number;
+    };
+}
+interface ChatErrorPayload {
+    error: string;
+    recoverable: boolean;
+}
+type PathConfirmationReason = 'outside_workdir' | 'sensitive_file' | 'both';
+interface ChatPathConfirmationPayload {
+    callId: string;
+    tool: string;
+    paths: string[];
+    workdir: string;
+    reason: PathConfirmationReason;
+}
+interface PathConfirmPayload {
+    callId: string;
+    approved: boolean;
+}
+interface ModeChangedPayload {
+    mode: SessionMode;
+    auto: boolean;
+    reason?: string;
+}
+interface PhaseChangedPayload {
+    phase: SessionPhase;
+}
+interface TaskCompletedPayload {
+    summary: string | null;
+    iterations: number;
+    totalTimeSeconds: number;
+    totalToolCalls: number;
+    totalTokensGenerated: number;
+    avgGenerationSpeed: number;
+    responseCount: number;
+    llmCallCount: number;
+    criteria: Array<{
+        id: string;
+        description: string;
+        status: string;
+    }>;
+    workflowName?: string;
+    workflowId?: string;
+    workflowColor?: string;
+}
+interface CriteriaUpdatedPayload {
+    criteria: Criterion[];
+    changedId?: string;
+}
+interface ContextStatePayload {
+    context: ContextState;
+}
+interface ProviderChangedPayload {
+    providerId: string;
+    providerName: string;
+    model: string;
+    backend: string;
+}
+interface QueueStatePayload {
+    messages: QueuedMessage[];
+}
+interface LspDiagnosticsPayload {
+    path: string;
+    diagnostics: Diagnostic[];
+}
+interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface ContextCompactionEvent {
+    beforeTokens: number;
+    afterTokens: number;
+}
+interface AskUserEvent {
+    question: string;
+    callId: string;
+}
+type AgentEvent = {
+    type: 'aborted';
+} | {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'thinking';
+    content: string;
+} | {
+    type: 'error';
+    error: string;
+    recoverable: boolean;
+} | {
+    type: 'context_compaction';
+    beforeTokens: number;
+    afterTokens: number;
+} | {
+    type: 'done';
+    allCriteriaPassed: boolean;
+    summary: string;
+    stats: ChatDonePayload['stats'];
+} | {
+    type: 'stuck';
+    reason: string;
+    failedAttempts: number;
+} | {
+    type: 'tool_call';
+    callId: string;
+    tool: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    callId: string;
+    tool: string;
+    result: ToolResult;
+} | {
+    type: 'tool_error';
+    callId: string;
+    tool: string;
+    error: string;
+    willRetry: boolean;
+} | {
+    type: 'ask_user';
+    question: string;
+    callId: string;
+} | {
+    type: 'format_retry';
+    attempt: number;
+    maxAttempts: number;
+};
+declare function createClientMessage<T>(type: ClientMessageType, payload: T): ClientMessage<T>;
+declare function createServerMessage<T>(type: ServerMessageType, payload: T, correlationId?: string): ServerMessage<T>;
+declare function isClientMessage(msg: unknown): msg is ClientMessage;
+declare function isServerMessage(msg: unknown): msg is ServerMessage;
+
+export { type PathConfirmationReason as $, type AgentEvent as A, type CriteriaUpdatedPayload as B, type CallStatsDataPoint as C, type Criterion as D, type CriterionAttempt as E, type CriterionStatus as F, type CriterionValidation as G, type Diagnostic as H, type EditContextEdit as I, type EditContextLine as J, type EditContextRegion as K, type ErrorPayload as L, type Message as M, type ExecutionState as N, type FileReadEntry as O, type InjectedFile as P, type LLMCallStats as Q, type LlmBackend as R, type SessionStats as S, type LspDiagnosticsPayload as T, type MessageRole as U, type MessageSegment as V, type MessageStats as W, type ModeChangedPayload as X, type ModeSwitchPayload as Y, type ModelSessionStats as Z, type PathConfirmPayload as _, type AskUserEvent as a, type PhaseChangedPayload as a0, type PreparingToolCall as a1, type Project as a2, type ProjectCreatePayload as a3, type ProjectCreateWithDirPayload as a4, type ProjectDeletePayload as a5, type ProjectDeletedPayload as a6, type ProjectListPayload as a7, type ProjectLoadPayload as a8, type ProjectStatePayload as a9, type SessionRunningPayload as aA, type SessionSetProviderPayload as aB, type SessionStatePayload as aC, type SessionSummary as aD, type SettingsGetPayload as aE, type SettingsSetPayload as aF, type SettingsValuePayload as aG, type StatsDataPoint as aH, type StatsIdentity as aI, type TaskCompletedPayload as aJ, type Todo as aK, type ToolCall as aL, type ToolMode as aM, type ToolName as aN, type ToolResult as aO, type ValidationResult as aP, createClientMessage as aQ, createServerMessage as aR, isClientMessage as aS, isServerMessage as aT, type ProjectUpdatePayload as aa, type PromptContext as ab, type PromptContextMessage as ac, type PromptContextTool as ad, type PromptRequestOptions as ae, type Provider as af, type ProviderActivatePayload as ag, type ProviderBackend as ah, type ProviderChangedPayload as ai, type QueueAsapPayload as aj, type QueueCancelPayload as ak, type QueueCompletionPayload as al, type QueueStatePayload as am, type QueuedMessage as an, type RecentUserPrompt as ao, type ServerMessage as ap, type ServerMessageType as aq, type Session as ar, type SessionCreatePayload as as, type SessionDeleteAllPayload as at, type SessionListPayload as au, type SessionLoadPayload as av, type SessionMetadata as aw, type SessionMode as ax, type SessionNameGeneratedPayload as ay, type SessionPhase as az, type Attachment as b, type ChatDeltaPayload as c, type ChatDonePayload as d, type ChatErrorPayload as e, type ChatFormatRetryPayload as f, type ChatMessagePayload as g, type ChatMessageUpdatedPayload as h, type ChatPathConfirmationPayload as i, type ChatProgressPayload as j, type ChatSendPayload as k, type ChatSummaryPayload as l, type ChatThinkingPayload as m, type ChatTodoPayload as n, type ChatToolCallPayload as o, type ChatToolOutputPayload as p, type ChatToolPreparingPayload as q, type ChatToolResultPayload as r, type ClientMessage as s, type ClientMessageType as t, type Config as u, type ContextCompactionEvent as v, type ContextState as w, type ContextStatePayload as x, type ContextWindow as y, type CriteriaEditPayload as z };