openfox 1.6.21 → 1.6.25

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-HWOYZ245.js → chunk-2V7VPPBP.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-3L3HLUVT.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-2V7VPPBP.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-SJVEX2NR.js → chunk-7LPL774T.js}

@@ -6,7 +6,7 @@ import {
   createVerifierNudgeConfig,
   runBuilderTurn,
   runChatTurn
-} from "./chunk-AU33PQAB.js";
+} from "./chunk-BOEXJCOD.js";
 import {
   TurnMetrics,
   agentExists,
@@ -47,7 +47,7 @@ import {
   setSkillEnabled,
   skillExists,
   spawnShellProcess
-} from "./chunk-HZP2V5Z6.js";
+} from "./chunk-4O3C2JMB.js";
 import {
   getPathSeparator,
   getPlatformShell,
@@ -57,18 +57,18 @@ import {
 import {
   createProviderManager,
   parseDefaultModelSelection
-} from "./chunk-WINI5HX7.js";
+} from "./chunk-PYBB34ZK.js";
 import {
   SessionNotFoundError,
   createLLMClient,
   detectModel,
   getLlmStatus
-} from "./chunk-FX4SUY2S.js";
+} from "./chunk-KSASIV4B.js";
 import {
   detectBackend,
   getBackendDisplayName,
   getModelProfile
-} from "./chunk-XYD5JXRM.js";
+} from "./chunk-D4ZLSV6P.js";
 import {
   createSession,
   deleteSession,
@@ -5479,7 +5479,7 @@ function createTerminalRoutes() {
 }
 
 // src/constants.ts
-var VERSION = "1.6.21";
+var VERSION = "1.6.25";
 
 // src/server/index.ts
 var __dirname2 = dirname5(fileURLToPath4(import.meta.url));
@@ -5716,7 +5716,7 @@ async function createServerHandle(config) {
       return res.status(400).json({ error: "providerId is required" });
     }
     sessionManager.setSessionProvider(sessionId, providerId, model ?? "auto");
-    const { loadGlobalConfig, saveGlobalConfig, setDefaultModelSelection } = await import("./config-SWDAJMQ3.js");
+    const { loadGlobalConfig, saveGlobalConfig, setDefaultModelSelection } = await import("./config-ACVEHBKG.js");
     const globalConfig = await loadGlobalConfig(config.mode ?? "production");
     const updatedConfig = setDefaultModelSelection(globalConfig, providerId, model ?? "auto");
     await saveGlobalConfig(config.mode ?? "production", updatedConfig);
@@ -5781,7 +5781,7 @@ async function createServerHandle(config) {
     if (!callId || approved === void 0) {
       return res.status(400).json({ error: "callId and approved are required" });
     }
-    const { providePathConfirmation: providePathConfirmation2 } = await import("./tools-4ODVFMW7.js");
+    const { providePathConfirmation: providePathConfirmation2 } = await import("./tools-CSV7G554.js");
     const result = providePathConfirmation2(callId, approved, alwaysAllow);
     if (!result.found) {
       return res.status(404).json({ error: "No pending path confirmation with that ID" });
@@ -5806,7 +5806,7 @@ async function createServerHandle(config) {
     if (!callId || !answer) {
       return res.status(400).json({ error: "callId and answer are required" });
     }
-    const { provideAnswer: provideAnswer2 } = await import("./tools-4ODVFMW7.js");
+    const { provideAnswer: provideAnswer2 } = await import("./tools-CSV7G554.js");
     const found = provideAnswer2(callId, answer);
     if (!found) {
       return res.status(404).json({ error: "No pending question with that ID" });
@@ -5842,8 +5842,8 @@ async function createServerHandle(config) {
     if (!session) {
       return res.status(404).json({ error: "Session not found" });
     }
-    const { stopSessionExecution } = await import("./chat-handler-JEMPI5UF.js");
-    const { cancelQuestionsForSession: cancelQuestionsForSession2, cancelPathConfirmationsForSession: cancelPathConfirmationsForSession2 } = await import("./tools-4ODVFMW7.js");
+    const { stopSessionExecution } = await import("./chat-handler-ZU74RXED.js");
+    const { cancelQuestionsForSession: cancelQuestionsForSession2, cancelPathConfirmationsForSession: cancelPathConfirmationsForSession2 } = await import("./tools-CSV7G554.js");
     stopSessionExecution(sessionId, sessionManager);
     abortSession(sessionId);
     cancelQuestionsForSession2(sessionId, "Session stopped by user");
@@ -5901,7 +5901,7 @@ async function createServerHandle(config) {
     let visionFallback;
     let globalWorkdir;
     try {
-      const { loadGlobalConfig, getVisionFallback } = await import("./config-SWDAJMQ3.js");
+      const { loadGlobalConfig, getVisionFallback } = await import("./config-ACVEHBKG.js");
       const globalConfig = await loadGlobalConfig(config.mode ?? "production");
       const fallback = getVisionFallback(globalConfig);
       if (fallback) {
@@ -5980,7 +5980,7 @@ async function createServerHandle(config) {
       return res.status(400).json({ error: "name, url, and backend are required" });
     }
     try {
-      const { loadGlobalConfig, saveGlobalConfig, addProvider, setDefaultModelSelection } = await import("./config-SWDAJMQ3.js");
+      const { loadGlobalConfig, saveGlobalConfig, addProvider, setDefaultModelSelection } = await import("./config-ACVEHBKG.js");
       const globalConfig = await loadGlobalConfig(config.mode ?? "production");
       const providerBackend = backend;
       const configWithProvider = addProvider(globalConfig, {
@@ -6013,7 +6013,7 @@ async function createServerHandle(config) {
   app.post("/api/init/config", async (req, res) => {
     const { workdir, visionFallback } = req.body;
     try {
-      const { loadGlobalConfig, saveGlobalConfig } = await import("./config-SWDAJMQ3.js");
+      const { loadGlobalConfig, saveGlobalConfig } = await import("./config-ACVEHBKG.js");
       const globalConfig = await loadGlobalConfig(config.mode ?? "production");
       const updatedConfig = {
         ...globalConfig,
@@ -6041,7 +6041,7 @@ async function createServerHandle(config) {
   });
   app.delete("/api/providers/:id", async (req, res) => {
     const { id } = req.params;
-    const { loadGlobalConfig, saveGlobalConfig, removeProvider } = await import("./config-SWDAJMQ3.js");
+    const { loadGlobalConfig, saveGlobalConfig, removeProvider } = await import("./config-ACVEHBKG.js");
     const globalConfig = await loadGlobalConfig(config.mode ?? "production");
     const updatedConfig = removeProvider(globalConfig, id);
     await saveGlobalConfig(config.mode ?? "production", updatedConfig);
@@ -6061,7 +6061,7 @@ async function createServerHandle(config) {
       return res.status(400).json({ error: result.error });
     }
     const llmClient = getLLMClient();
-    const { loadGlobalConfig, saveGlobalConfig, setDefaultModelSelection } = await import("./config-SWDAJMQ3.js");
+    const { loadGlobalConfig, saveGlobalConfig, setDefaultModelSelection } = await import("./config-ACVEHBKG.js");
     const globalConfig = await loadGlobalConfig(config.mode ?? "production");
     const updatedConfig = setDefaultModelSelection(globalConfig, id, llmClient.getModel());
     await saveGlobalConfig(config.mode ?? "production", updatedConfig);
@@ -6092,7 +6092,7 @@ async function createServerHandle(config) {
     if (!result.success) {
       return res.status(400).json({ error: result.error });
     }
-    const { loadGlobalConfig, saveGlobalConfig } = await import("./config-SWDAJMQ3.js");
+    const { loadGlobalConfig, saveGlobalConfig } = await import("./config-ACVEHBKG.js");
     const globalConfig = await loadGlobalConfig(config.mode ?? "production");
     const updatedProviders = providerManager.getProviders();
     const updatedConfig = {
@@ -6302,7 +6302,7 @@ async function createServerHandle(config) {
     providerManager
   );
   const wss = wssExports.wss;
-  const { QueueProcessor } = await import("./processor-VKFEOK46.js");
+  const { QueueProcessor } = await import("./processor-GAOK7TPI.js");
   const queueProcessor = new QueueProcessor({
     sessionManager,
     providerManager,
@@ -6375,4 +6375,4 @@ export {
   createServerHandle,
   createServer
 };
-//# sourceMappingURL=chunk-SJVEX2NR.js.map
+//# sourceMappingURL=chunk-7LPL774T.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