openfox 1.6.21 → 1.6.23

package/README.md

@@ -4,10 +4,20 @@
 
 Autonomous coding agent for local LLMs with contract-driven execution.
 
+*Session — Criteria tracking, tool calls, and streaming responses*
+![Session](docs/screenshots/session.png)
+
+*Providers — Local LLM backend configuration*
+![Providers](docs/screenshots/providers.png)
+
+*Workflows — Contract-driven execution pipeline*
+![Workflows](docs/screenshots/workflows.png)
+
 ## Quick Start
 
 ```bash
-npx openfox
+npm i -g openfox
+openfox
 ```
 
 On first run, OpenFox automatically detects your local LLM backend (vLLM, sglang, ollama, llamacpp) and configures itself.
@@ -16,25 +26,22 @@ On first run, OpenFox automatically detects your local LLM backend (vLLM, sglang
 
 ```bash
 # Start server for current project
-npx openfox
+openfox
 
 # Start on custom port
-npx openfox --port 8080
+openfox --port 8080
 
 # Start without opening browser
-npx openfox --no-browser
-
-# Interactive configuration setup
-npx openfox init
+openfox --no-browser
 
 # Show current configuration
-npx openfox config
+openfox config
 
 # Manage LLM providers
-npx openfox provider add      # Add new provider
-npx openfox provider list     # List configured providers
-npx openfox provider use      # Switch active provider
-npx openfox provider remove   # Remove provider
+openfox provider add      # Add new provider
+openfox provider list     # List configured providers
+openfox provider use      # Switch active provider
+openfox provider remove   # Remove provider
 ```
 
 ## CLI Options
@@ -63,6 +70,32 @@ npx openfox provider remove   # Remove provider
 - **LSP Integration**: Immediate feedback on code validity
 - **Real-Time Metrics**: Prefill time, generation speed, context usage
 
+## Screenshots
+
+*Homepage — Project overview and session history*
+![Homepage](docs/screenshots/homepage.png)
+
+*Project Selected — Active session with context stats*
+![Project Selected](docs/screenshots/project-selected.png)
+
+*Stats — Prefill time, generation speed, token usage*
+![Stats](docs/screenshots/stats.png)
+
+*Terminal — Integrated terminal for running commands*
+![Terminal](docs/screenshots/terminal.png)
+
+*Notifications — Event log and system messages*
+![Notifications](docs/screenshots/notifications.png)
+
+*Agents — Sub-agent management and execution*
+![Agents](docs/screenshots/agents.png)
+
+*General Instructions — Global custom instructions*
+![General Instructions](docs/screenshots/general-instructions.png)
+
+*Vision Fallback — Image processing configuration*
+![Vision Fallback](docs/screenshots/vision-fallback.png)
+
 ## License
 
-MIT
+MIT

package/dist/{auto-compaction-U75EINMB.js → auto-compaction-7LK3QGPI.js}

@@ -2,10 +2,10 @@ import {
   maybeAutoCompactContext,
   performManualContextCompaction,
   resolveCompactionStatsIdentity
-} from "./chunk-HZP2V5Z6.js";
+} from "./chunk-4O3C2JMB.js";
 import "./chunk-NBU6KIOD.js";
 import "./chunk-574HZVLE.js";
-import "./chunk-XYD5JXRM.js";
+import "./chunk-D4ZLSV6P.js";
 import "./chunk-PMDJEJYY.js";
 import "./chunk-EEPU4INU.js";
 import "./chunk-DZHZ3UUR.js";
@@ -16,10 +16,11 @@ import "./chunk-3EHGGBWE.js";
 import "./chunk-Y6HBEACI.js";
 import "./chunk-R4HADRYO.js";
 import "./chunk-TVQOONDR.js";
+import "./chunk-CJNQGEYG.js";
 import "./chunk-PNBH3RAX.js";
 export {
   maybeAutoCompactContext,
   performManualContextCompaction,
   resolveCompactionStatsIdentity
 };
-//# sourceMappingURL=auto-compaction-U75EINMB.js.map
+//# sourceMappingURL=auto-compaction-7LK3QGPI.js.map

package/dist/{chat-handler-JEMPI5UF.js → chat-handler-ZU74RXED.js}

@@ -10,11 +10,11 @@ import {
 } from "./chunk-AV45GQ7B.js";
 import {
   runChatTurn
-} from "./chunk-AU33PQAB.js";
-import "./chunk-HZP2V5Z6.js";
+} from "./chunk-BOEXJCOD.js";
+import "./chunk-4O3C2JMB.js";
 import "./chunk-NBU6KIOD.js";
 import "./chunk-574HZVLE.js";
-import "./chunk-XYD5JXRM.js";
+import "./chunk-D4ZLSV6P.js";
 import {
   getEventStore
 } from "./chunk-PMDJEJYY.js";
@@ -31,6 +31,7 @@ import "./chunk-3EHGGBWE.js";
 import "./chunk-Y6HBEACI.js";
 import "./chunk-R4HADRYO.js";
 import "./chunk-TVQOONDR.js";
+import "./chunk-CJNQGEYG.js";
 import {
   logger
 } from "./chunk-PNBH3RAX.js";
@@ -61,7 +62,7 @@ async function startChatSession(sessionId, content, deps, options) {
   sessionManager.setRunning(sessionId, true);
   broadcastForSession(sessionId, createSessionRunningMessage(true));
   try {
-    const { maybeAutoCompactContext } = await import("./auto-compaction-U75EINMB.js");
+    const { maybeAutoCompactContext } = await import("./auto-compaction-7LK3QGPI.js");
     await maybeAutoCompactContext({
       sessionManager,
       sessionId,
@@ -170,4 +171,4 @@ export {
   startChatSession,
   stopSessionExecution
 };
-//# sourceMappingURL=chat-handler-JEMPI5UF.js.map
+//# sourceMappingURL=chat-handler-ZU74RXED.js.map

package/dist/{chunk-HZP2V5Z6.js → chunk-4O3C2JMB.js}

@@ -12,10 +12,11 @@ import {
   getSessionProcessCount
 } from "./chunk-574HZVLE.js";
 import {
+  buildModelParams,
   getBackendCapabilities,
   getModelProfile,
   streamWithSegments
-} from "./chunk-XYD5JXRM.js";
+} from "./chunk-D4ZLSV6P.js";
 import {
   getContextMessages,
   getCurrentContextWindowId,
@@ -542,12 +543,7 @@ async function* streamLLMPure(options) {
   const maxTokens = userMaxTokens ?? profile.defaultMaxTokens;
   const topP = userTopP ?? profile.topP;
   const topK = userTopK ?? (backend.supportsTopK ? profile.topK : void 0);
-  const modelParams = {
-    ...temperature !== void 0 && { temperature },
-    ...topP !== void 0 && { topP },
-    ...topK !== void 0 && { topK },
-    ...maxTokens !== void 0 && { maxTokens }
-  };
+  const modelParams = buildModelParams({ temperature, topP, topK, maxTokens });
   logger.debug("LLM request settings", {
     model: llmClient.getModel(),
     profile: profile.name,
@@ -3351,7 +3347,7 @@ var callSubAgentTool = {
       };
     }
     try {
-      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-4ODVFMW7.js");
+      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-CSV7G554.js");
       const toolRegistry = getToolRegistryForAgent2(agentDef);
       const turnMetrics = new TurnMetrics();
       const result = await executeSubAgent({
@@ -4480,4 +4476,4 @@ export {
   getToolRegistryForAgent,
   createToolRegistry
 };
-//# sourceMappingURL=chunk-HZP2V5Z6.js.map
+//# sourceMappingURL=chunk-4O3C2JMB.js.map

package/dist/{chunk-AU33PQAB.js → chunk-BOEXJCOD.js}

@@ -13,7 +13,7 @@ import {
   getToolRegistryForAgent,
   loadAllAgentsDefault,
   runTopLevelAgentLoop
-} from "./chunk-HZP2V5Z6.js";
+} from "./chunk-4O3C2JMB.js";
 import {
   getCurrentContextWindowId,
   getEventStore
@@ -293,4 +293,4 @@ export {
   runBuilderTurn,
   runVerifierTurn
 };
-//# sourceMappingURL=chunk-AU33PQAB.js.map
+//# sourceMappingURL=chunk-BOEXJCOD.js.map

package/dist/{chunk-6NPMZFMP.js → chunk-CJNQGEYG.js}

@@ -29,7 +29,7 @@ function isVisionFallbackEnabled() {
 async function ensureVisionFallbackConfigLoaded() {
   if (configLoaded) return;
   try {
-    const { loadGlobalConfig, getVisionFallback } = await import("./config-SWDAJMQ3.js");
+    const { loadGlobalConfig, getVisionFallback } = await import("./config-ACVEHBKG.js");
     const { getRuntimeConfig } = await import("./runtime-config-2XJJIMSC.js");
     const runtimeConfig = getRuntimeConfig();
     const mode = runtimeConfig.mode ?? "production";
@@ -135,4 +135,4 @@ export {
   describeImage,
   describeImageFromDataUrl
 };
-//# sourceMappingURL=chunk-6NPMZFMP.js.map
+//# sourceMappingURL=chunk-CJNQGEYG.js.map

package/dist/{chunk-XYD5JXRM.js → chunk-D4ZLSV6P.js}

@@ -1,3 +1,6 @@
+import {
+  describeImageFromDataUrl
+} from "./chunk-CJNQGEYG.js";
 import {
   logger
 } from "./chunk-PNBH3RAX.js";
@@ -360,6 +363,289 @@ function getModelProfile(modelName) {
   return DEFAULT_PROFILE;
 }
 
+// src/server/llm/client-pure.ts
+function buildModelParams(params) {
+  return {
+    ...params.temperature !== void 0 && { temperature: params.temperature },
+    ...params.topP !== void 0 && { topP: params.topP },
+    ...params.topK !== void 0 && { topK: params.topK },
+    ...params.maxTokens !== void 0 && { maxTokens: params.maxTokens }
+  };
+}
+function buildAttachmentContent(msgContent, attachments, modelSupportsVision) {
+  const content = [];
+  if (msgContent?.trim()) {
+    content.push({ type: "text", text: msgContent });
+  }
+  for (const attachment of attachments) {
+    content.push(convertAttachmentSync(attachment, modelSupportsVision));
+  }
+  return content;
+}
+async function convertMessagesWithOptions(messages, profile, visionFallbackEnabled, signal, onVisionFallbackStart, onVisionFallbackDone) {
+  const modelSupportsVision = profile.supportsVision ?? false;
+  const options = {
+    modelSupportsVision,
+    visionFallbackEnabled,
+    signal,
+    onVisionFallbackStart,
+    onVisionFallbackDone
+  };
+  return needsVisionFallback(messages, modelSupportsVision, visionFallbackEnabled) ? await convertMessagesWithFallback(messages, options) : convertMessages(messages, { modelSupportsVision, visionFallbackEnabled: false });
+}
+function convertToolCalls(toolCalls) {
+  return toolCalls.map((toolCall) => ({
+    id: toolCall.id,
+    type: "function",
+    function: {
+      name: toolCall.name,
+      arguments: JSON.stringify(toolCall.arguments)
+    }
+  }));
+}
+function convertAttachmentSync(attachment, modelSupportsVision) {
+  if (modelSupportsVision) {
+    return {
+      type: "image_url",
+      image_url: { url: attachment.data }
+    };
+  }
+  return {
+    type: "text",
+    text: `[Image: ${attachment.filename || "image"}] (vision not supported, cannot describe)`
+  };
+}
+function createAttachmentForConversion(data, filename, id) {
+  return {
+    data,
+    ...filename !== void 0 && { filename },
+    ...id !== void 0 && { id }
+  };
+}
+async function convertAttachmentWithFallback(attachment, options) {
+  logger.debug("[VisionFallback] convertAttachmentWithFallback called", { filename: attachment.filename, id: attachment.id, hasCallbacks: !!options.onVisionFallbackStart });
+  if (options.modelSupportsVision) {
+    logger.debug("[VisionFallback] Model supports vision - passing image directly");
+    return {
+      type: "image_url",
+      image_url: { url: attachment.data }
+    };
+  }
+  if (!options.visionFallbackEnabled) {
+    logger.debug("[VisionFallback] Fallback disabled - returning placeholder");
+    return {
+      type: "text",
+      text: `[Image: ${attachment.filename || "image"}] (vision not supported)`
+    };
+  }
+  const attachmentId = attachment.id ?? crypto.randomUUID();
+  const filename = attachment.filename;
+  logger.debug("[VisionFallback] Starting delegation for:", { attachmentId, filename });
+  options.onVisionFallbackStart?.(attachmentId, filename);
+  const context = filename ? `File: ${filename}` : void 0;
+  const description = await describeImageFromDataUrl(attachment.data, { context, signal: options.signal });
+  logger.debug("[VisionFallback] Delegation complete:", { attachmentId, descriptionLength: description.length });
+  options.onVisionFallbackDone?.(attachmentId, description);
+  return {
+    type: "text",
+    text: `[Image: ${attachment.filename || "image"}] ${description}`
+  };
+}
+async function buildAttachmentContentWithFallback(msgContent, attachments, options) {
+  const content = [];
+  if (msgContent?.trim()) {
+    content.push({ type: "text", text: msgContent });
+  }
+  for (const attachment of attachments) {
+    const convertedContent = await convertAttachmentWithFallback(
+      createAttachmentForConversion(attachment.data, attachment.filename, attachment.id),
+      options
+    );
+    content.push(convertedContent);
+  }
+  return content;
+}
+function convertMessages(messages, options) {
+  const filtered = messages.filter((msg) => {
+    return !(msg.role === "assistant" && !msg.content?.trim() && (!msg.toolCalls || msg.toolCalls.length === 0));
+  });
+  return filtered.map((msg) => {
+    if (msg.role === "tool") {
+      if (msg.attachments && msg.attachments.length > 0) {
+        const content = buildAttachmentContent(msg.content, msg.attachments, options.modelSupportsVision);
+        return {
+          role: "tool",
+          content,
+          tool_call_id: msg.toolCallId
+        };
+      }
+      return {
+        role: "tool",
+        content: msg.content,
+        tool_call_id: msg.toolCallId
+      };
+    }
+    if (msg.role === "assistant" && msg.toolCalls?.length) {
+      return {
+        role: "assistant",
+        content: msg.content || null,
+        tool_calls: convertToolCalls(msg.toolCalls)
+      };
+    }
+    if (msg.role === "user" && msg.attachments && msg.attachments.length > 0) {
+      const content = buildAttachmentContent(msg.content, msg.attachments, options.modelSupportsVision);
+      return {
+        role: "user",
+        content
+      };
+    }
+    return {
+      role: msg.role,
+      content: msg.content
+    };
+  });
+}
+async function convertMessagesWithFallback(messages, options) {
+  logger.debug("[VisionFallback] convertMessagesWithFallback called", { messageCount: messages.length });
+  const filtered = messages.filter((msg) => {
+    return !(msg.role === "assistant" && !msg.content?.trim() && (!msg.toolCalls || msg.toolCalls.length === 0));
+  });
+  const converted = [];
+  for (const msg of filtered) {
+    if (msg.role === "tool") {
+      if (msg.attachments && msg.attachments.length > 0) {
+        const content = await buildAttachmentContentWithFallback(msg.content, msg.attachments, options);
+        converted.push({
+          role: "tool",
+          content,
+          tool_call_id: msg.toolCallId
+        });
+      } else {
+        converted.push({
+          role: "tool",
+          content: msg.content,
+          tool_call_id: msg.toolCallId
+        });
+      }
+      continue;
+    }
+    if (msg.role === "assistant" && msg.toolCalls?.length) {
+      converted.push({
+        role: "assistant",
+        content: msg.content || null,
+        tool_calls: convertToolCalls(msg.toolCalls)
+      });
+      continue;
+    }
+    if (msg.role === "user" && msg.attachments && msg.attachments.length > 0) {
+      const content = await buildAttachmentContentWithFallback(msg.content, msg.attachments, options);
+      converted.push({
+        role: "user",
+        content
+      });
+      continue;
+    }
+    converted.push({
+      role: msg.role,
+      content: msg.content
+    });
+  }
+  return converted;
+}
+function convertTools(tools) {
+  return tools.map((tool) => ({
+    type: "function",
+    function: {
+      name: tool.function.name,
+      description: tool.function.description,
+      parameters: tool.function.parameters
+    }
+  }));
+}
+function needsVisionFallback(messages, modelSupportsVision, visionFallbackEnabled) {
+  const hasAttachments = messages.some(
+    (msg) => msg.attachments && msg.attachments.length > 0 || msg.role === "tool" && msg.attachments && msg.attachments.length > 0
+  );
+  const result = hasAttachments && !modelSupportsVision && visionFallbackEnabled;
+  logger.debug("[VisionFallback] needsVisionFallback check", {
+    hasAttachments,
+    modelSupportsVision,
+    visionFallbackEnabled,
+    result
+  });
+  return result;
+}
+async function buildChatCompletionCreateParams(model, request, profile, capabilities, disableThinking, visionFallbackEnabled, isStreaming, onVisionFallbackStart, onVisionFallbackDone) {
+  const convertedMessages = await convertMessagesWithOptions(
+    request.messages,
+    profile,
+    visionFallbackEnabled,
+    request.signal,
+    onVisionFallbackStart,
+    onVisionFallbackDone
+  );
+  const temperature = request.temperature ?? profile.temperature;
+  const maxTokens = request.maxTokens ?? profile.defaultMaxTokens;
+  const topP = profile.topP;
+  const topK = capabilities.supportsTopK ? profile.topK : void 0;
+  const params = {
+    model,
+    messages: convertedMessages,
+    ...request.tools ? { tools: convertTools(request.tools) } : {},
+    ...request.toolChoice ? { tool_choice: request.toolChoice } : {},
+    temperature,
+    max_tokens: maxTokens,
+    top_p: topP,
+    stream: isStreaming,
+    ...isStreaming ? { stream_options: { include_usage: true } } : {}
+  };
+  if (topK !== void 0) {
+    ;
+    params["top_k"] = topK;
+  }
+  const shouldDisableThinking = isStreaming ? disableThinking || request.disableThinking : disableThinking;
+  if (capabilities.supportsChatTemplateKwargs && profile.supportsReasoning && shouldDisableThinking) {
+    ;
+    params["chat_template_kwargs"] = { enable_thinking: false };
+  }
+  const modelParams = buildModelParams({ temperature, topP, topK, maxTokens });
+  return { params, modelParams };
+}
+async function buildCreateParamsFromInput(input, isStreaming) {
+  const { model, request, profile, capabilities, disableThinking, visionFallbackEnabled = false, onVisionFallbackStart, onVisionFallbackDone } = input;
+  return buildChatCompletionCreateParams(model, request, profile, capabilities, !!disableThinking, visionFallbackEnabled, isStreaming, onVisionFallbackStart, onVisionFallbackDone);
+}
+var buildNonStreamingCreateParams = (input) => buildCreateParamsFromInput(input, false);
+var buildStreamingCreateParams = (input) => buildCreateParamsFromInput(input, true);
+function mapFinishReason(reason) {
+  switch (reason) {
+    case "stop":
+      return "stop";
+    case "tool_calls":
+      return "tool_calls";
+    case "length":
+      return "length";
+    case "content_filter":
+      return "content_filter";
+    default:
+      return "stop";
+  }
+}
+function extractThinking(content) {
+  const thinkRegex = /<think>([\s\S]*?)<\/think>/g;
+  let thinkingContent = "";
+  let cleanContent = content;
+  let match;
+  while ((match = thinkRegex.exec(content)) !== null) {
+    thinkingContent += match[1];
+    cleanContent = cleanContent.replace(match[0], "");
+  }
+  return {
+    content: cleanContent.trim(),
+    thinkingContent: thinkingContent.trim() || null
+  };
+}
+
 // src/server/llm/streaming.ts
 var XML_TOOL_PATTERNS = ["<tool_call>", "<function=", "</tool_call>", "<parameter="];
 function hasXmlToolPattern(text) {
@@ -478,6 +764,11 @@ export {
   getBackendCapabilities,
   detectBackend,
   getBackendDisplayName,
+  buildModelParams,
+  buildNonStreamingCreateParams,
+  buildStreamingCreateParams,
+  mapFinishReason,
+  extractThinking,
   streamWithSegments
 };
-//# sourceMappingURL=chunk-XYD5JXRM.js.map
+//# sourceMappingURL=chunk-D4ZLSV6P.js.map

package/dist/{chunk-HWOYZ245.js → chunk-FTJPNCAV.js}

@@ -27,7 +27,7 @@ Options:
 }
 async function runNetworkSetup(mode) {
   const { loadAuthConfig, saveAuthConfig, encryptPassword } = await import("./auth-JF2HDJ6P.js");
-  const { saveGlobalConfig } = await import("./config-SWDAJMQ3.js");
+  const { saveGlobalConfig } = await import("./config-ACVEHBKG.js");
   const { getAuthKeyPath } = await import("./paths-ZRI56O63.js");
   const existingAuth = await loadAuthConfig(mode);
   if (existingAuth) {
@@ -88,7 +88,7 @@ async function runNetworkSetup(mode) {
   console.log("\u2713 Configuration saved!\n");
 }
 async function runConfig(mode) {
-  const { loadGlobalConfig, getActiveProvider, getDefaultModel } = await import("./config-SWDAJMQ3.js");
+  const { loadGlobalConfig, getActiveProvider, getDefaultModel } = await import("./config-ACVEHBKG.js");
   const { getGlobalConfigPath } = await import("./paths-ZRI56O63.js");
   const config = await loadGlobalConfig(mode);
   const configPath = getGlobalConfigPath(mode);
@@ -143,18 +143,18 @@ async function runCli(options) {
       break;
     }
     case "provider": {
-      const { runProviderCommand } = await import("./provider-CDM4LQAC.js");
+      const { runProviderCommand } = await import("./provider-RLQMVV2Z.js");
       const [, subcommand] = positionals;
       await runProviderCommand(mode, subcommand);
       break;
     }
     default: {
-      const { configFileExists } = await import("./config-SWDAJMQ3.js");
+      const { configFileExists } = await import("./config-ACVEHBKG.js");
       const configExists = await configFileExists(mode);
       if (!configExists) {
         await runNetworkSetup(mode);
       }
-      const { runServe } = await import("./serve-X3PKC27B.js");
+      const { runServe } = await import("./serve-IBJ3SN3Q.js");
       await runServe({
         mode,
         port: values.port ? parseInt(values.port) : void 0,
@@ -167,4 +167,4 @@ async function runCli(options) {
 export {
   runCli
 };
-//# sourceMappingURL=chunk-HWOYZ245.js.map
+//# sourceMappingURL=chunk-FTJPNCAV.js.map