openfox 0.1.0

package/dist/server/index.d.ts

@@ -0,0 +1,479 @@
+import { aL as ToolCall, b as Attachment, H as Diagnostic, ar as Session, aD as SessionSummary, a2 as Project, ax as SessionMode, az as SessionPhase, M as Message, D as Criterion, F as CriterionStatus, an as QueuedMessage, w as ContextState, ap as ServerMessage, aI as StatsIdentity, aO as ToolResult, af as Provider, u as Config } from '../protocol-BJsm88OW.js';
+import { Server } from 'node:http';
+
+interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+    name?: string;
+    attachments?: Attachment[];
+}
+interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+interface LLMCompletionRequest {
+    messages: LLMMessage[];
+    tools?: LLMToolDefinition[];
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+    signal?: AbortSignal;
+    disableThinking?: boolean;
+}
+interface LLMCompletionResponse {
+    id: string;
+    content: string;
+    toolCalls?: ToolCall[];
+    thinkingContent?: string;
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'content_filter';
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+type LLMStreamEvent = {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'thinking_delta';
+    content: string;
+} | {
+    type: 'tool_call_delta';
+    index: number;
+    id?: string;
+    name?: string;
+    arguments?: string;
+} | {
+    type: 'done';
+    response: LLMCompletionResponse;
+} | {
+    type: 'error';
+    error: string;
+};
+interface LLMClient {
+    complete(request: LLMCompletionRequest): Promise<LLMCompletionResponse>;
+    stream(request: LLMCompletionRequest): AsyncIterable<LLMStreamEvent>;
+}
+
+/**
+ * Model-specific configuration profiles.
+ * Different models have different optimal settings and capabilities.
+ */
+interface ModelProfile {
+    /** Display name for the model */
+    name: string;
+    /** Sampling parameters */
+    temperature: number;
+    topP: number;
+    topK?: number;
+    /** Whether the model outputs reasoning/thinking content */
+    supportsReasoning: boolean;
+    /** Whether reasoning should be treated as regular content (for broken configs) */
+    reasoningAsContent: boolean;
+    /** Max tokens to generate if not specified */
+    defaultMaxTokens: number;
+}
+
+/**
+ * LLM Backend detection and capabilities.
+ * Supports vLLM, SGLang, Ollama, and llama.cpp inference engines.
+ */
+type Backend = 'vllm' | 'sglang' | 'ollama' | 'llamacpp' | 'unknown';
+
+interface LLMClientWithModel extends LLMClient {
+    getModel(): string;
+    setModel(model: string): void;
+    getProfile(): ModelProfile;
+    getBackend(): Backend;
+    setBackend(backend: Backend): void;
+}
+
+interface LspManagerInterface {
+    /**
+     * Notify the LSP that a file has changed and get diagnostics
+     * Returns diagnostics for the file (may be empty if no issues)
+     */
+    notifyFileChange(path: string, content: string): Promise<Diagnostic[]>;
+    /**
+     * Get current diagnostics for a file without triggering a change
+     */
+    getDiagnostics(path: string): Diagnostic[];
+    /**
+     * Check if LSP is available for a given file
+     */
+    isAvailableFor(path: string): boolean;
+    /**
+     * Shutdown all LSP servers
+     */
+    shutdown(): Promise<void>;
+}
+
+type Unsubscribe = () => void;
+
+/**
+ * Manages multiple LSP servers for a session.
+ * Lazy-starts servers on first file access for each language.
+ */
+declare class LspManager implements LspManagerInterface {
+    private workdir;
+    private sessionId;
+    private servers;
+    private unavailableServers;
+    private serverPromises;
+    constructor(workdir: string, sessionId: string);
+    private getOrCreateServer;
+    private startServer;
+    private getServerForFile;
+    /**
+     * Notify LSP that a file has changed and get diagnostics.
+     * This is the main entry point for tools like write_file and edit_file.
+     */
+    notifyFileChange(path: string, content: string): Promise<Diagnostic[]>;
+    /**
+     * Get current diagnostics for a file without triggering a change.
+     */
+    getDiagnostics(path: string): Diagnostic[];
+    /**
+     * Check if LSP is available for a given file type.
+     * Returns true if we have or can start a server for this file type.
+     */
+    isAvailableFor(path: string): boolean;
+    /**
+     * Shutdown all LSP servers.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get status of all servers.
+     */
+    getStatus(): {
+        language: string;
+        state: string;
+    }[];
+}
+
+type SessionEvent = {
+    type: 'session_created';
+    session: Session;
+} | {
+    type: 'session_updated';
+    session: Session;
+} | {
+    type: 'session_deleted';
+    sessionId: string;
+} | {
+    type: 'mode_changed';
+    sessionId: string;
+    from: SessionMode;
+    to: SessionMode;
+} | {
+    type: 'phase_changed';
+    sessionId: string;
+    phase: SessionPhase;
+} | {
+    type: 'running_changed';
+    sessionId: string;
+    isRunning: boolean;
+} | {
+    type: 'criteria_updated';
+    sessionId: string;
+    criteria: Criterion[];
+} | {
+    type: 'message_added';
+    sessionId: string;
+    message: Message;
+};
+declare class SessionManager {
+    private events;
+    private activeSessionId;
+    /**
+     * Create a new session. Emits session.initialized event.
+     */
+    createSession(projectId: string, title?: string, providerId?: string | null, providerModel?: string | null): Session;
+    /**
+     * Get a session by ID. Returns null if not found.
+     * Session state is derived from EventStore.
+     */
+    getSession(id: string): Session | null;
+    /**
+     * Get a session by ID. Throws if not found.
+     */
+    requireSession(id: string): Session;
+    /**
+     * List all sessions (summary only).
+     */
+    listSessions(): SessionSummary[];
+    /**
+     * List sessions for a project.
+     */
+    listSessionsByProject(projectId: string): SessionSummary[];
+    /**
+     * Delete a session and all its events.
+     */
+    deleteSession(id: string): void;
+    /**
+     * Get a project by ID.
+     */
+    getProject(projectId: string): Project | null;
+    /**
+     * Delete all sessions for a project.
+     */
+    deleteAllSessions(projectId: string, workdir: string): void;
+    /**
+     * Change session mode. Emits mode.changed event.
+     */
+    setMode(sessionId: string, toMode: SessionMode): Session;
+    /**
+     * Change session phase. Emits phase.changed event.
+     */
+    setPhase(sessionId: string, phase: SessionPhase): Session;
+    /**
+     * Set session running state. Emits running.changed event.
+     */
+    setRunning(sessionId: string, isRunning: boolean): Session;
+    /**
+     * Set session summary. Updates DB directly (metadata, not event).
+     */
+    setSummary(sessionId: string, summary: string): Session;
+    /**
+     * Set session provider/model. Updates DB directly.
+     */
+    setSessionProvider(sessionId: string, providerId: string | null, providerModel: string | null): Session;
+    /**
+     * Add to the cumulative token usage.
+     */
+    addTokensUsed(sessionId: string, tokens: number): void;
+    /**
+     * Increment tool call counter.
+     */
+    incrementToolCalls(sessionId: string): void;
+    /**
+     * Add a message. Delegates to EventStore.
+     */
+    addMessage(sessionId: string, message: Omit<Message, 'id' | 'timestamp'>): Message;
+    /**
+     * Add an assistant message. Delegates to EventStore.
+     */
+    addAssistantMessage(sessionId: string, message: Omit<Message, 'id' | 'timestamp' | 'role'>): Message;
+    /**
+     * Update message stats. Delegates to EventStore (emits message.done if needed).
+     */
+    updateMessageStats(sessionId: string, messageId: string, stats: Message['stats']): void;
+    /**
+     * Update a message. Delegates to EventStore.
+     */
+    updateMessage(sessionId: string, messageId: string, updates: Partial<Omit<Message, 'id' | 'timestamp' | 'role'>>): void;
+    /**
+     * Get messages for the current context window.
+     */
+    getCurrentWindowMessages(sessionId: string): Message[];
+    /**
+     * Compact context. Delegates to EventStore.
+     */
+    compactContext(sessionId: string, summary: string, tokenCountAtClose: number): void;
+    /**
+     * Set current context size (for token tracking).
+     * Emits a context.state event with the real promptTokens from the LLM.
+     */
+    setCurrentContextSize(sessionId: string, promptTokens: number): void;
+    /**
+     * Set criteria. Delegates to EventStore.
+     */
+    setCriteria(sessionId: string, criteria: Criterion[]): void;
+    /**
+     * Update criterion status. Delegates to EventStore.
+     */
+    updateCriterionStatus(sessionId: string, criterionId: string, status: CriterionStatus): void;
+    /**
+     * Reset all criteria verification attempts.
+     */
+    resetAllCriteriaAttempts(sessionId: string): void;
+    /**
+     * Add a criterion attempt.
+     */
+    addCriterionAttempt(sessionId: string, criterionId: string, attempt: Criterion['attempts'][number]): void;
+    /**
+     * Record that a file was modified.
+     */
+    addModifiedFile(sessionId: string, filePath: string): void;
+    /**
+     * Add a criterion. Returns the updated criteria list.
+     */
+    addCriterion(sessionId: string, criterion: Criterion): {
+        criteria: Criterion[];
+        actualId: string;
+    } | {
+        error: string;
+    };
+    /**
+     * Update criterion description.
+     */
+    updateCriterionFull(sessionId: string, criterionId: string, updates: Partial<Pick<Criterion, 'description'>>): Criterion[];
+    /**
+     * Remove a criterion.
+     */
+    removeCriterion(sessionId: string, criterionId: string): Criterion[];
+    private messageQueues;
+    queueMessage(sessionId: string, mode: 'asap' | 'completion', content: string, attachments?: Attachment[]): QueuedMessage;
+    cancelQueuedMessage(sessionId: string, queueId: string): boolean;
+    drainAsapMessages(sessionId: string): QueuedMessage[];
+    drainCompletionMessages(sessionId: string): QueuedMessage[];
+    getQueueState(sessionId: string): QueuedMessage[];
+    clearMessageQueue(sessionId: string): void;
+    private readFilesCache;
+    /**
+     * Record that a file was read.
+     */
+    recordFileRead(sessionId: string, filePath: string, contentHash: string): void;
+    /**
+     * Get read files cache.
+     */
+    getReadFiles(sessionId: string): Record<string, {
+        hash: string;
+        readAt: string;
+    }>;
+    /**
+     * Update file hash after write.
+     */
+    updateFileHash(sessionId: string, filePath: string, contentHash: string): void;
+    /**
+     * Record a tool failure.
+     */
+    recordToolFailure(sessionId: string, tool: string, reason: string): void;
+    /**
+     * Reset tool failures.
+     */
+    resetToolFailures(sessionId: string): void;
+    /**
+     * Update execution state.
+     */
+    updateExecutionState(sessionId: string, updates: Record<string, unknown>): void;
+    /**
+     * @deprecated Use addMessage + compactContext instead
+     */
+    compactMessages(sessionId: string, _messageIds: string[], summary: string): Message;
+    /**
+     * @deprecated Use addTokensUsed instead
+     */
+    incrementTokenCount(sessionId: string, tokens: number): void;
+    /**
+     * Get the current context state for a session.
+     */
+    getContextState(sessionId: string): ContextState;
+    /**
+     * Get the LSP manager for a session.
+     */
+    getLspManager(sessionId: string): LspManager;
+    setActiveSession(id: string | null): void;
+    getActiveSessionId(): string | null;
+    subscribe(callback: (event: SessionEvent) => void): Unsubscribe;
+    subscribeToSession(sessionId: string, callback: (event: SessionEvent) => void): Unsubscribe;
+    private emit;
+    /**
+     * Build a full Session object from DB session + EventStore state
+     */
+    private buildSessionFromDb;
+}
+
+interface ToolContext {
+    workdir: string;
+    sessionId: string;
+    sessionManager: SessionManager;
+    signal?: AbortSignal | undefined;
+    onProgress?: ((message: string) => void) | undefined;
+    onEvent?: ((event: ServerMessage) => void) | undefined;
+    lspManager?: LspManagerInterface | undefined;
+    llmClient?: LLMClientWithModel | undefined;
+    statsIdentity?: StatsIdentity | undefined;
+}
+interface Tool {
+    name: string;
+    definition: LLMToolDefinition;
+    execute: (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult>;
+}
+interface ToolRegistry {
+    tools: Tool[];
+    definitions: LLMToolDefinition[];
+    execute: (name: string, args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult>;
+}
+
+interface ProviderManager {
+    getProviders(): Provider[];
+    getActiveProvider(): Provider | undefined;
+    getActiveProviderId(): string | undefined;
+    getCurrentModel(): string | undefined;
+    getLLMClient(): LLMClientWithModel;
+    activateProvider(providerId: string, options?: {
+        model?: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    addProvider(provider: Omit<Provider, 'id' | 'createdAt'>): Provider;
+    removeProvider(providerId: string): boolean;
+    setProviders(providers: Provider[], defaultModelSelection?: string): void;
+    getProviderStatus(providerId: string): 'connected' | 'disconnected' | 'unknown';
+    getProviderModels(providerId: string): Promise<string[]>;
+    setDefaultModelSelection(providerId: string, model: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+
+/**
+ * Server Context
+ *
+ * Holds all server dependencies in a single object that can be passed through
+ * the application. This replaces singleton imports and enables:
+ * - Easy testing with isolated instances
+ * - Parallel test execution
+ * - Clear dependency flow
+ */
+
+interface ServerContext {
+    config: Config;
+    sessionManager: SessionManager;
+    llmClient: LLMClientWithModel;
+    toolRegistry: ToolRegistry;
+    providerManager?: ProviderManager;
+}
+interface ServerHandle {
+    httpServer: Server;
+    ctx: ServerContext;
+    /** Start listening on the given port (0 for dynamic) */
+    start: (port?: number) => Promise<{
+        port: number;
+    }>;
+    /** Gracefully close the server */
+    close: () => Promise<void>;
+}
+
+/**
+ * Create a server handle that can be started on any port.
+ * Returns a ServerHandle with start() and close() methods.
+ *
+ * Use this for:
+ * - In-process testing with isolated instances
+ * - Programmatic server control
+ */
+declare function createServerHandle(config: Config): Promise<ServerHandle>;
+/**
+ * Create and start a server (convenience function for CLI).
+ * Starts listening immediately on the configured port.
+ * Sets up SIGINT/SIGTERM handlers.
+ */
+declare function createServer(config: Config): Promise<void>;
+
+export { createServer, createServerHandle };

package/dist/server/index.js

@@ -0,0 +1,20 @@
+import {
+  createServer,
+  createServerHandle
+} from "../chunk-YQ36AK5A.js";
+import "../chunk-IKAWIOXM.js";
+import "../chunk-MTX5Y3V3.js";
+import "../chunk-N2XYX4ZA.js";
+import "../chunk-4Z2OZ6NX.js";
+import "../chunk-QY7BMXWT.js";
+import "../chunk-IVHCPQO2.js";
+import "../chunk-6MOGZMGX.js";
+import "../chunk-FF6Z2MC3.js";
+import "../chunk-26NRL3HX.js";
+import "../chunk-U62ZECSQ.js";
+import "../chunk-AF7XS4OI.js";
+export {
+  createServer,
+  createServerHandle
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/settings-D5O3TMLD.js

@@ -0,0 +1,17 @@
+import {
+  SETTINGS_KEYS,
+  deleteSetting,
+  getAllSettings,
+  getSetting,
+  setSetting
+} from "./chunk-MTX5Y3V3.js";
+import "./chunk-4Z2OZ6NX.js";
+import "./chunk-U62ZECSQ.js";
+export {
+  SETTINGS_KEYS,
+  deleteSetting,
+  getAllSettings,
+  getSetting,
+  setSetting
+};
+//# sourceMappingURL=settings-D5O3TMLD.js.map

package/dist/settings-D5O3TMLD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/shared/index.d.ts

@@ -0,0 +1,19 @@
+import { M as Message, S as SessionStats } from '../protocol-BJsm88OW.js';
+export { A as AgentEvent, a as AskUserEvent, b as Attachment, C as CallStatsDataPoint, c as ChatDeltaPayload, d as ChatDonePayload, e as ChatErrorPayload, f as ChatFormatRetryPayload, g as ChatMessagePayload, h as ChatMessageUpdatedPayload, i as ChatPathConfirmationPayload, j as ChatProgressPayload, k as ChatSendPayload, l as ChatSummaryPayload, m as ChatThinkingPayload, n as ChatTodoPayload, o as ChatToolCallPayload, p as ChatToolOutputPayload, q as ChatToolPreparingPayload, r as ChatToolResultPayload, s as ClientMessage, t as ClientMessageType, u as Config, v as ContextCompactionEvent, w as ContextState, x as ContextStatePayload, y as ContextWindow, z as CriteriaEditPayload, B as CriteriaUpdatedPayload, D as Criterion, E as CriterionAttempt, F as CriterionStatus, G as CriterionValidation, H as Diagnostic, I as EditContextEdit, J as EditContextLine, K as EditContextRegion, L as ErrorPayload, N as ExecutionState, O as FileReadEntry, P as InjectedFile, Q as LLMCallStats, R as LlmBackend, T as LspDiagnosticsPayload, U as MessageRole, V as MessageSegment, W as MessageStats, X as ModeChangedPayload, Y as ModeSwitchPayload, Z as ModelSessionStats, _ as PathConfirmPayload, $ as PathConfirmationReason, a0 as PhaseChangedPayload, a1 as PreparingToolCall, a2 as Project, a3 as ProjectCreatePayload, a4 as ProjectCreateWithDirPayload, a5 as ProjectDeletePayload, a6 as ProjectDeletedPayload, a7 as ProjectListPayload, a8 as ProjectLoadPayload, a9 as ProjectStatePayload, aa as ProjectUpdatePayload, ab as PromptContext, ac as PromptContextMessage, ad as PromptContextTool, ae as PromptRequestOptions, af as Provider, ag as ProviderActivatePayload, ah as ProviderBackend, ai as ProviderChangedPayload, aj as QueueAsapPayload, ak as QueueCancelPayload, al as QueueCompletionPayload, am as QueueStatePayload, an as QueuedMessage, ao as RecentUserPrompt, ap as ServerMessage, aq as ServerMessageType, ar as Session, as as SessionCreatePayload, at as SessionDeleteAllPayload, au as SessionListPayload, av as SessionLoadPayload, aw as SessionMetadata, ax as SessionMode, ay as SessionNameGeneratedPayload, az as SessionPhase, aA as SessionRunningPayload, aB as SessionSetProviderPayload, aC as SessionStatePayload, aD as SessionSummary, aE as SettingsGetPayload, aF as SettingsSetPayload, aG as SettingsValuePayload, aH as StatsDataPoint, aI as StatsIdentity, aJ as TaskCompletedPayload, aK as Todo, aL as ToolCall, aM as ToolMode, aN as ToolName, aO as ToolResult, aP as ValidationResult, aQ as createClientMessage, aR as createServerMessage, aS as isClientMessage, aT as isServerMessage } from '../protocol-BJsm88OW.js';
+
+/**
+ * Session stats computation - aggregates response-level MessageStats from
+ * multiple assistant messages into SessionStats for benchmarking and trends.
+ */
+
+/**
+ * Compute aggregated session stats from an array of messages.
+ *
+ * Returns null if no messages have stats.
+ *
+ * Weighted average for speeds: totalTokens / totalTime
+ * This gives accurate average throughput across varying context sizes.
+ */
+declare function computeSessionStats(messages: Message[]): SessionStats | null;
+
+export { Message, SessionStats, computeSessionStats };

package/dist/shared/index.js

@@ -0,0 +1,17 @@
+import {
+  computeSessionStats
+} from "../chunk-QY7BMXWT.js";
+import {
+  createClientMessage,
+  createServerMessage,
+  isClientMessage,
+  isServerMessage
+} from "../chunk-IVHCPQO2.js";
+export {
+  computeSessionStats,
+  createClientMessage,
+  createServerMessage,
+  isClientMessage,
+  isServerMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skill-defaults/defaults/playwright-cli.skill.md

@@ -0,0 +1,38 @@
+---
+id: playwright-cli
+name: Playwright CLI
+description: Interactive browser control via playwright-cli commands (open, snapshot, click, fill, screenshot, etc.)
+version: 1.0.0
+---
+
+# playwright-cli
+
+You have access to `npx playwright-cli` for interactive browser automation via the terminal.
+Use `run_command` to execute these commands.
+
+## Core Workflow
+
+The typical workflow is: open a page -> snapshot to get element refs -> interact using refs -> snapshot again.
+
+```bash
+# Open a URL
+npx playwright-cli open https://example.com
+# Take a snapshot to see the page and get element refs
+npx playwright-cli snapshot
+# Click an element by ref number from snapshot
+npx playwright-cli click 42
+# Fill a form field by ref
+npx playwright-cli fill 15 "hello world"
+# Take a screenshot
+npx playwright-cli screenshot
+```
+
+## Screenshot workflow
+
+After doing `npx playwright-cli screenshot`, always use the `read_file` tool on the path of the image returned by playwright-cli.
+This allows you to see the image, and for the user to see it as well.
+
+## All Commands
+
+- `open [url]` -- open the browser (optionally to a URL)
+- use `npx playwright-cli --help` to get all available commands

package/dist/tools-R4YQAYUF.js

@@ -0,0 +1,46 @@
+import {
+  AskUserInterrupt,
+  PathAccessDeniedError,
+  addAllowedPaths,
+  cancelPathConfirmation,
+  cancelPathConfirmationsForSession,
+  cancelQuestion,
+  cancelQuestionsForSession,
+  clearAllowedPaths,
+  clearTodos,
+  createToolRegistry,
+  getTodos,
+  getToolRegistryForAgent,
+  getToolRegistryForSubAgent,
+  provideAnswer,
+  providePathConfirmation,
+  requestPathAccess,
+  setTodoUpdateCallback
+} from "./chunk-IKAWIOXM.js";
+import "./chunk-MTX5Y3V3.js";
+import "./chunk-N2XYX4ZA.js";
+import "./chunk-4Z2OZ6NX.js";
+import "./chunk-IVHCPQO2.js";
+import "./chunk-26NRL3HX.js";
+import "./chunk-U62ZECSQ.js";
+import "./chunk-AF7XS4OI.js";
+export {
+  AskUserInterrupt,
+  PathAccessDeniedError,
+  addAllowedPaths,
+  cancelPathConfirmation,
+  cancelPathConfirmationsForSession,
+  cancelQuestion,
+  cancelQuestionsForSession,
+  clearAllowedPaths,
+  clearTodos,
+  createToolRegistry,
+  getTodos,
+  getToolRegistryForAgent,
+  getToolRegistryForSubAgent,
+  provideAnswer,
+  providePathConfirmation,
+  requestPathAccess,
+  setTodoUpdateCallback
+};
+//# sourceMappingURL=tools-R4YQAYUF.js.map

package/dist/tools-R4YQAYUF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}