openfox 1.6.20 → 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-NFLWKJAO.js → auto-compaction-7LK3QGPI.js}

@@ -2,10 +2,10 @@ import {
   maybeAutoCompactContext,
   performManualContextCompaction,
   resolveCompactionStatsIdentity
-} from "./chunk-KOBGCNUE.js";
+} from "./chunk-4O3C2JMB.js";
 import "./chunk-NBU6KIOD.js";
 import "./chunk-574HZVLE.js";
-import "./chunk-55N6FAAZ.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-NFLWKJAO.js.map
+//# sourceMappingURL=auto-compaction-7LK3QGPI.js.map

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

@@ -10,11 +10,11 @@ import {
 } from "./chunk-AV45GQ7B.js";
 import {
   runChatTurn
-} from "./chunk-U3KMU3UE.js";
-import "./chunk-KOBGCNUE.js";
+} from "./chunk-BOEXJCOD.js";
+import "./chunk-4O3C2JMB.js";
 import "./chunk-NBU6KIOD.js";
 import "./chunk-574HZVLE.js";
-import "./chunk-55N6FAAZ.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-NFLWKJAO.js");
+    const { maybeAutoCompactContext } = await import("./auto-compaction-7LK3QGPI.js");
     await maybeAutoCompactContext({
       sessionManager,
       sessionId,
@@ -170,4 +171,4 @@ export {
   startChatSession,
   stopSessionExecution
 };
-//# sourceMappingURL=chat-handler-2RVTVNPF.js.map
+//# sourceMappingURL=chat-handler-ZU74RXED.js.map

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

@@ -12,8 +12,11 @@ import {
   getSessionProcessCount
 } from "./chunk-574HZVLE.js";
 import {
+  buildModelParams,
+  getBackendCapabilities,
+  getModelProfile,
   streamWithSegments
-} from "./chunk-55N6FAAZ.js";
+} from "./chunk-D4ZLSV6P.js";
 import {
   getContextMessages,
   getCurrentContextWindowId,
@@ -515,7 +518,7 @@ function computeAggregatedStats(input) {
 }
 
 // src/server/chat/stream-pure.ts
-function createEmptyStreamResult(aborted, xmlFormatError) {
+function createEmptyStreamResult(aborted, xmlFormatError, modelParams) {
   return {
     content: "",
     toolCalls: [],
@@ -523,12 +526,38 @@ function createEmptyStreamResult(aborted, xmlFormatError) {
     usage: { promptTokens: 0, completionTokens: 0 },
     timing: { ttft: 0, completionTime: 0, tps: 0, prefillTps: 0 },
     aborted,
-    xmlFormatError
+    xmlFormatError,
+    modelParams
   };
 }
 async function* streamLLMPure(options) {
   const { messageId, systemPrompt, llmClient, messages, tools, toolChoice, signal, disableThinking, onVisionFallbackStart, onVisionFallbackDone } = options;
   const llmMessages = [{ role: "system", content: systemPrompt }, ...messages];
+  const profile = getModelProfile(llmClient.getModel());
+  const backend = getBackendCapabilities(llmClient.getBackend());
+  const userTemp = options.modelSettings?.temperature;
+  const userTopP = options.modelSettings?.topP;
+  const userTopK = options.modelSettings?.topK;
+  const userMaxTokens = options.modelSettings?.maxTokens;
+  const temperature = userTemp ?? profile.temperature;
+  const maxTokens = userMaxTokens ?? profile.defaultMaxTokens;
+  const topP = userTopP ?? profile.topP;
+  const topK = userTopK ?? (backend.supportsTopK ? profile.topK : void 0);
+  const modelParams = buildModelParams({ temperature, topP, topK, maxTokens });
+  logger.debug("LLM request settings", {
+    model: llmClient.getModel(),
+    profile: profile.name,
+    temperature,
+    maxTokens,
+    topP,
+    topK,
+    userConfigured: {
+      temperature: userTemp !== void 0 ? `user:${userTemp}` : "default",
+      topP: userTopP !== void 0 ? `user:${userTopP}` : "default",
+      topK: userTopK !== void 0 ? `user:${userTopK}` : "default",
+      maxTokens: userMaxTokens !== void 0 ? `user:${userMaxTokens}` : "default"
+    }
+  });
   const stream = buildStreamRequest(llmClient, {
     messages: llmMessages,
     tools,
@@ -636,7 +665,7 @@ async function* streamLLMPure(options) {
     }
   }
   if (!result) {
-    return createEmptyStreamResult(aborted, xmlFormatError);
+    return createEmptyStreamResult(aborted, xmlFormatError, modelParams);
   }
   const baseResult = {
     content: result.content,
@@ -648,7 +677,8 @@ async function* streamLLMPure(options) {
     },
     timing: result.timing,
     aborted,
-    xmlFormatError
+    xmlFormatError,
+    modelParams
   };
   if (result.thinkingContent) {
     baseResult.thinkingContent = result.thinkingContent;
@@ -666,16 +696,20 @@ var TurnMetrics = class {
   totalToolTime = 0;
   // seconds
   llmCalls = [];
+  modelParams = {};
   constructor() {
     this.startTime = performance.now();
   }
   /** Add metrics from an LLM call */
-  addLLMCall(timing, promptTokens, completionTokens) {
+  addLLMCall(timing, promptTokens, completionTokens, modelParams) {
     const callIndex = this.llmCalls.length + 1;
     this.totalPrefillTokens += promptTokens;
     this.totalPrefillTime += timing.ttft;
     this.totalGenTokens += completionTokens;
     this.totalGenTime += timing.completionTime;
+    if (modelParams) {
+      this.modelParams = modelParams;
+    }
     this.llmCalls = [
       ...this.llmCalls,
       {
@@ -687,10 +721,18 @@ var TurnMetrics = class {
         prefillSpeed: timing.ttft > 0 ? Math.round(promptTokens / timing.ttft * 10) / 10 : 0,
         generationSpeed: timing.completionTime > 0 ? Math.round(completionTokens / timing.completionTime * 10) / 10 : 0,
         totalTime: Math.round((timing.ttft + timing.completionTime) * 10) / 10,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...this.modelParams.temperature !== void 0 && { temperature: this.modelParams.temperature },
+        ...this.modelParams.topP !== void 0 && { topP: this.modelParams.topP },
+        ...this.modelParams.topK !== void 0 && { topK: this.modelParams.topK },
+        ...this.modelParams.maxTokens !== void 0 && { maxTokens: this.modelParams.maxTokens }
       }
     ];
   }
+  /** Set model parameters for tracking */
+  setModelParams(params) {
+    this.modelParams = params;
+  }
   /** Add tool execution time (in milliseconds) */
   addToolTime(durationMs) {
     this.totalToolTime += durationMs / 1e3;
@@ -802,7 +844,7 @@ async function consumeStreamWithToolLoop(options) {
   let iterations = 0;
   for (; ; ) {
     if (signal?.aborted) {
-      return createEmptyStreamResult(true, false);
+      return createEmptyStreamResult(true, false, {});
     }
     if (++iterations > MAX_TOOL_LOOP_ITERATIONS) {
       throw new Error("Max tool loop iterations exceeded during compaction");
@@ -826,7 +868,7 @@ async function consumeStreamWithToolLoop(options) {
       currentMessages = [...currentMessages, correctionMsg];
       continue;
     }
-    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens);
+    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens, result.modelParams);
     if (result.toolCalls.length > 0) {
       const stats = turnMetrics.buildStats(statsIdentity, "compaction");
       onEvent(createMessageDoneEvent(messageId, {
@@ -2850,6 +2892,7 @@ async function runTopLevelAgentLoop(config, turnMetrics) {
       });
       doOnMessage(createChatVisionFallbackMessage({ type: "done", messageId: assistantMsgId, attachmentId, description }));
     };
+    const modelSettings = sessionManager.getCurrentModelSettings();
     const streamGen = streamLLMPure({
       messageId: assistantMsgId,
       systemPrompt: assembledRequest.systemPrompt,
@@ -2859,7 +2902,8 @@ async function runTopLevelAgentLoop(config, turnMetrics) {
       toolChoice: "auto",
       signal,
       onVisionFallbackStart,
-      onVisionFallbackDone
+      onVisionFallbackDone,
+      ...modelSettings && { modelSettings }
     });
     const result = await consumeStreamGenerator(streamGen, (event) => {
       eventStore.append(sessionId, event);
@@ -2881,7 +2925,7 @@ async function runTopLevelAgentLoop(config, turnMetrics) {
       emitPartialDoneEvents(sessionId, assistantMsgId, statsIdentity, mode, turnMetrics, assembledRequest.promptContext, eventStore);
       throw new Error("Aborted");
     }
-    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens);
+    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens, result.modelParams);
     sessionManager.setCurrentContextSize(sessionId, result.usage.promptTokens);
     if (result.toolCalls.length > 0) {
       eventStore.append(sessionId, createMessageDoneEvent(assistantMsgId, {
@@ -3135,7 +3179,7 @@ async function executeSubAgent(options) {
       eventStore.append(sessionId, createChatDoneEvent(assistantMsgId, "stopped", stats));
       throw new Error("Aborted");
     }
-    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens);
+    turnMetrics.addLLMCall(result.timing, result.usage.promptTokens, result.usage.completionTokens, result.modelParams);
     sessionManager.setCurrentContextSize(sessionId, result.usage.promptTokens, subAgentId);
     finalContent = result.content;
     customMessages.push({
@@ -3303,7 +3347,7 @@ var callSubAgentTool = {
       };
     }
     try {
-      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-ERJ3QRQU.js");
+      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-CSV7G554.js");
       const toolRegistry = getToolRegistryForAgent2(agentDef);
       const turnMetrics = new TurnMetrics();
       const result = await executeSubAgent({
@@ -4432,4 +4476,4 @@ export {
   getToolRegistryForAgent,
   createToolRegistry
 };
-//# sourceMappingURL=chunk-KOBGCNUE.js.map
+//# sourceMappingURL=chunk-4O3C2JMB.js.map

package/dist/{chunk-QY7BMXWT.js → chunk-B7E3BICY.js}

@@ -69,7 +69,11 @@ function buildSessionStats(messagesWithStats) {
         completionTime: call.completionTime,
         prefillSpeed: call.prefillSpeed,
         generationSpeed: call.generationSpeed,
-        totalTime: call.totalTime
+        totalTime: call.totalTime,
+        ...call.temperature !== void 0 && { temperature: call.temperature },
+        ...call.topP !== void 0 && { topP: call.topP },
+        ...call.topK !== void 0 && { topK: call.topK },
+        ...call.maxTokens !== void 0 && { maxTokens: call.maxTokens }
       });
     }
   }
@@ -121,4 +125,4 @@ function computeSessionStats(messages) {
 export {
   computeSessionStats
 };
-//# sourceMappingURL=chunk-QY7BMXWT.js.map
+//# sourceMappingURL=chunk-B7E3BICY.js.map

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

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

package/dist/{chunk-IN5EP4ZB.js → chunk-CJNQGEYG.js}

@@ -29,7 +29,7 @@ function isVisionFallbackEnabled() {
 async function ensureVisionFallbackConfigLoaded() {
   if (configLoaded) return;
   try {
-    const { loadGlobalConfig, getVisionFallback } = await import("./config-67AX6CNS.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-IN5EP4ZB.js.map
+//# sourceMappingURL=chunk-CJNQGEYG.js.map