@protolabsai/proto 0.25.8 → 0.25.10

package/README.md

@@ -159,6 +159,14 @@ Tools are exposed as `mcp__<server_name>__<tool_name>` and available to the agen
 
 proto auto-discovers Claude Code plugins installed at `~/.claude/plugins/`. Any plugin's `commands/` directory is automatically loaded as slash commands — no additional config needed.
 
+### Environment variable overrides
+
+| Variable                        | Default | Description                                                                                     |
+| ------------------------------- | ------- | ----------------------------------------------------------------------------------------------- |
+| `PROTO_STREAM_STALL_TIMEOUT_MS` | `90000` | Max ms to wait between streaming chunks before declaring the connection stalled (then retrying) |
+| `PROTO_SYSTEM_DEFAULTS_PATH`    | —       | Override path to the system defaults settings file                                              |
+| `PROTO_SYSTEM_SETTINGS_PATH`    | —       | Override path to the system settings override file                                              |
+
 ## Observability
 
 proto supports [Langfuse](https://langfuse.com) tracing out of the box. Set three environment variables and every session is fully traced — LLM calls (all providers), tool executions, subagent lifecycles, and turn hierarchy.
@@ -331,15 +339,20 @@ Results are cached at `.proto/repo-map-cache.json` and auto-invalidate on file c
 
 proto ships with 22 bundled skills for agentic workflows:
 
-- **browser-automation** — Web browser automation
+- **adversarial-verification** — Adversarial review and stress-testing of agent output
 - **brainstorming** — Structured ideation
+- **browser-automation** — Web browser automation
+- **coding-agent-standards** — Enforced coding conventions for agent-written code
 - **dispatching-parallel-agents** — Fan-out/fan-in subagent patterns
 - **executing-plans** — Step-by-step plan execution
 - **finishing-a-development-branch** — Pre-merge cleanup
+- **harness-reference** — Sprint contracts, verification gates, and retry logic reference
+- **loop** — Iterative refinement loops
 - **qc-helper** — Quality control checks
 - **receiving-code-review** — Process review feedback
 - **requesting-code-review** — Generate review requests
 - **review** — Code review workflow
+- **sprint-contract** — Scope lock and contract negotiation
 - **subagent-driven-development** — Delegate to specialized subagents
 - **systematic-debugging** — Structured debug methodology
 - **test-driven-development** — TDD workflow
@@ -457,11 +470,16 @@ Any user-defined sub-agent from `.proto/agents/` can also be used as a member ty
 
 ## Keyboard Shortcuts
 
-| Shortcut  | Action                   |
-| --------- | ------------------------ |
-| `Ctrl+C`  | Cancel current operation |
-| `Ctrl+D`  | Exit (on empty line)     |
-| `Up/Down` | Navigate command history |
+| Shortcut    | Action                                                          |
+| ----------- | --------------------------------------------------------------- |
+| `Ctrl+C`    | Cancel ongoing request. Press twice to exit.                    |
+| `Ctrl+D`    | Exit if input is empty.                                         |
+| `Ctrl+L`    | Clear the screen                                                |
+| `Ctrl+Y`    | Retry the last failed request                                   |
+| `Shift+Tab` | Cycle approval modes: `plan` → `default` → `auto-edit` → `yolo` |
+| `Up/Down`   | Navigate command history                                        |
+
+See [Keyboard Shortcuts reference](docs/reference/keyboard-shortcuts.md) for the full list.
 
 ## Voice Integration
 

package/cli.js

@@ -170887,7 +170887,7 @@ __export(geminiContentGenerator_exports, {
   createGeminiContentGenerator: () => createGeminiContentGenerator
 });
 function createGeminiContentGenerator(config2, gcConfig) {
-  const version2 = "0.25.8";
+  const version2 = "0.25.10";
   const userAgent2 = config2.userAgent || `QwenCode/${version2} (${process.platform}; ${process.arch})`;
   const baseHeaders = {
     "User-Agent": userAgent2
@@ -414864,7 +414864,7 @@ __name(getPackageJson, "getPackageJson");
 // packages/cli/src/utils/version.ts
 async function getCliVersion() {
   const pkgJson = await getPackageJson();
-  return "0.25.8";
+  return "0.25.10";
 }
 __name(getCliVersion, "getCliVersion");
 
@@ -422636,7 +422636,7 @@ var formatDuration = /* @__PURE__ */ __name((milliseconds) => {
 
 // packages/cli/src/generated/git-commit.ts
 init_esbuild_shims();
-var GIT_COMMIT_INFO = "7fcd8c75a";
+var GIT_COMMIT_INFO = "08c8a70da";
 
 // packages/cli/src/utils/systemInfo.ts
 async function getNpmVersion() {
@@ -453851,6 +453851,7 @@ var Command = /* @__PURE__ */ ((Command2) => {
   Command2["EXIT"] = "exit";
   Command2["SHOW_MORE_LINES"] = "showMoreLines";
   Command2["RETRY_LAST"] = "retryLast";
+  Command2["BACKGROUND_SESSION"] = "backgroundSession";
   Command2["REVERSE_SEARCH"] = "reverseSearch";
   Command2["SUBMIT_REVERSE_SEARCH"] = "submitReverseSearch";
   Command2["ACCEPT_SUGGESTION_REVERSE_SEARCH"] = "acceptSuggestionReverseSearch";
@@ -453927,6 +453928,7 @@ var defaultKeyBindings = {
   ["exit" /* EXIT */]: [{ key: "d", ctrl: true }],
   ["showMoreLines" /* SHOW_MORE_LINES */]: [{ key: "s", ctrl: true }],
   ["retryLast" /* RETRY_LAST */]: [{ key: "y", ctrl: true }],
+  ["backgroundSession" /* BACKGROUND_SESSION */]: [{ key: "b", ctrl: true }],
   // Shell commands
   ["reverseSearch" /* REVERSE_SEARCH */]: [{ key: "r", ctrl: true }],
   // Note: original logic ONLY checked ctrl=false, ignored meta/shift/paste
@@ -475103,7 +475105,11 @@ function tildify(p2) {
   return p2.startsWith(homePrefix) ? `~${p2.slice(home.length)}` : p2;
 }
 __name(tildify, "tildify");
-var StatusBar = /* @__PURE__ */ __name(({ cwd: cwd6, terminalWidth }) => {
+var StatusBar = /* @__PURE__ */ __name(({
+  cwd: cwd6,
+  terminalWidth,
+  bgSessionActive
+}) => {
   const branch = useGitBranchName(cwd6);
   const diff4 = useGitDiffStat(cwd6);
   const { activeAgents } = useBackgroundAgentProgress();
@@ -475131,6 +475137,10 @@ var StatusBar = /* @__PURE__ */ __name(({ cwd: cwd6, terminalWidth }) => {
             /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Badge, { children: /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Text3, { color: theme.text.secondary, children: label }) })
           ] }, agent.agentId);
         }),
+        bgSessionActive && /* @__PURE__ */ (0, import_jsx_runtime137.jsxs)(import_jsx_runtime137.Fragment, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Sep, {}),
+          /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Badge, { children: /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Text3, { color: theme.text.secondary, children: "\u27F3 bg session" }) })
+        ] }),
         hasDiff && /* @__PURE__ */ (0, import_jsx_runtime137.jsxs)(import_jsx_runtime137.Fragment, { children: [
           /* @__PURE__ */ (0, import_jsx_runtime137.jsx)(Sep, {}),
           /* @__PURE__ */ (0, import_jsx_runtime137.jsxs)(Badge, { children: [
@@ -475212,7 +475222,14 @@ var DefaultAppLayout = /* @__PURE__ */ __name(() => {
       ] })
     ] }),
     hasAgents && !uiState.dialogsVisible && /* @__PURE__ */ (0, import_jsx_runtime138.jsx)(AgentTabBar, {}),
-    /* @__PURE__ */ (0, import_jsx_runtime138.jsx)(StatusBar, { cwd: config2.getTargetDir(), terminalWidth })
+    /* @__PURE__ */ (0, import_jsx_runtime138.jsx)(
+      StatusBar,
+      {
+        cwd: config2.getTargetDir(),
+        terminalWidth,
+        bgSessionActive: uiState.streamingState === "backgrounded" /* Backgrounded */
+      }
+    )
   ] });
 }, "DefaultAppLayout");
 
@@ -478300,6 +478317,9 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
   const lastPromptRef = (0, import_react148.useRef)(null);
   const lastPromptErroredRef = (0, import_react148.useRef)(false);
   const [isResponding, setIsResponding] = (0, import_react148.useState)(false);
+  const isBackgroundedRef = (0, import_react148.useRef)(false);
+  const bgResponseTextRef = (0, import_react148.useRef)("");
+  const [isBackgrounded, setIsBackgrounded] = (0, import_react148.useState)(false);
   const pendingCompletedToolsRef = (0, import_react148.useRef)([]);
   const [thought, setThought] = (0, import_react148.useState)(null);
   const [pendingHistoryItem, pendingHistoryItemRef, setPendingHistoryItem] = useStateAndRef(null);
@@ -478458,13 +478478,16 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
     })) {
       return "waiting_for_confirmation" /* WaitingForConfirmation */;
     }
+    if (isBackgrounded) {
+      return "backgrounded" /* Backgrounded */;
+    }
     if (isResponding || toolCalls.some(
       (tc) => tc.status === "executing" || tc.status === "scheduled" || tc.status === "validating" || (tc.status === "success" || tc.status === "error" || tc.status === "cancelled") && !tc.responseSubmittedToGemini
     )) {
       return "responding" /* Responding */;
     }
     return "idle" /* Idle */;
-  }, [isResponding, toolCalls]);
+  }, [isResponding, toolCalls, isBackgrounded]);
   (0, import_react148.useEffect)(() => {
     if (config2.getApprovalMode() === ApprovalMode.YOLO && streamingState === "idle" /* Idle */) {
       const lastUserMessageIndex = history.findLastIndex(
@@ -478480,7 +478503,7 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
     }
   }, [streamingState, config2, history]);
   const cancelOngoingRequest = (0, import_react148.useCallback)(() => {
-    if (streamingState !== "responding" /* Responding */) {
+    if (streamingState !== "responding" /* Responding */ && streamingState !== "backgrounded" /* Backgrounded */) {
       return;
     }
     if (turnCancelledRef.current) {
@@ -478523,6 +478546,24 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
     config2,
     getPromptCount
   ]);
+  const backgroundCurrentSession = (0, import_react148.useCallback)(() => {
+    if (streamingState !== "responding" /* Responding */) return;
+    if (pendingHistoryItemRef.current) {
+      addItem(pendingHistoryItemRef.current, Date.now());
+      setPendingHistoryItem(null);
+    }
+    isBackgroundedRef.current = true;
+    bgResponseTextRef.current = "";
+    setIsBackgrounded(true);
+    setIsResponding(false);
+    addItem(
+      {
+        type: "info" /* INFO */,
+        text: "\u2193 Running in background \u2014 you'll be notified when done"
+      },
+      Date.now()
+    );
+  }, [streamingState, pendingHistoryItemRef, addItem, setPendingHistoryItem]);
   const prepareQueryForGemini = (0, import_react148.useCallback)(
     async (query, userMessageTimestamp, abortSignal, prompt_id) => {
       if (turnCancelledRef.current) {
@@ -478618,6 +478659,10 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
       if (turnCancelledRef.current) {
         return "";
       }
+      if (isBackgroundedRef.current) {
+        bgResponseTextRef.current += eventValue;
+        return currentGeminiMessageBuffer;
+      }
       let newGeminiMessageBuffer = currentGeminiMessageBuffer + eventValue;
       if (pendingHistoryItemRef.current?.type !== "gemini" && pendingHistoryItemRef.current?.type !== "gemini_content") {
         if (pendingHistoryItemRef.current) {
@@ -478667,6 +478712,9 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
       if (turnCancelledRef.current) {
         return "";
       }
+      if (isBackgroundedRef.current) {
+        return currentThoughtBuffer;
+      }
       const thoughtText = eventValue.description ?? "";
       if (!thoughtText) {
         return currentThoughtBuffer;
@@ -479014,7 +479062,7 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
           return;
         }
       }
-      if ((streamingState === "responding" /* Responding */ || streamingState === "waiting_for_confirmation" /* WaitingForConfirmation */) && !bypassGuard) {
+      if ((streamingState === "responding" /* Responding */ || streamingState === "waiting_for_confirmation" /* WaitingForConfirmation */ || streamingState === "backgrounded" /* Backgrounded */) && !bypassGuard) {
         if (generation !== null) queryGuardRef.current.end(generation);
         return;
       }
@@ -479110,6 +479158,9 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
         } catch (error40) {
           if (error40 instanceof UnauthorizedError) {
             onAuthError("Session expired or is unauthorized.");
+          } else if (isBackgroundedRef.current && isNodeError(error40) && error40.name === "AbortError") {
+          } else if (isBackgroundedRef.current) {
+            lastPromptErroredRef.current = true;
           } else if (!isNodeError(error40) || error40.name !== "AbortError") {
             lastPromptErroredRef.current = true;
             const retryHint = t4("Press Ctrl+Y to retry");
@@ -479123,6 +479174,42 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
             });
           }
         } finally {
+          if (isBackgroundedRef.current) {
+            const wasCancelled = turnCancelledRef.current;
+            const hadError = lastPromptErroredRef.current;
+            const response = bgResponseTextRef.current.trim();
+            isBackgroundedRef.current = false;
+            bgResponseTextRef.current = "";
+            setIsBackgrounded(false);
+            if (wasCancelled) {
+              addItem(
+                {
+                  type: "info" /* INFO */,
+                  text: "\u2193 Background session cancelled"
+                },
+                Date.now()
+              );
+            } else if (hadError) {
+              addItem(
+                {
+                  type: "warning" /* WARNING */,
+                  text: "\u2193 Background session failed"
+                },
+                Date.now()
+              );
+            } else {
+              const preview = response.length > 0 ? response.length > 300 ? response.slice(0, 300) + "\u2026" : response : "(no response)";
+              addItem(
+                {
+                  type: "info" /* INFO */,
+                  text: `\u2713 Background session complete
+
+${preview}`
+                },
+                Date.now()
+              );
+            }
+          }
           setIsResponding(false);
           if (generation !== null) queryGuardRef.current.end(generation);
           Promise.resolve().then(() => (init_dist4(), dist_exports)).then((core) => {
@@ -479181,7 +479268,7 @@ var useGeminiStream = /* @__PURE__ */ __name((geminiClient, history, addItem, co
     ]
   );
   const retryLastPrompt = (0, import_react148.useCallback)(async () => {
-    if (streamingState === "responding" /* Responding */ || streamingState === "waiting_for_confirmation" /* WaitingForConfirmation */) {
+    if (streamingState === "responding" /* Responding */ || streamingState === "waiting_for_confirmation" /* WaitingForConfirmation */ || streamingState === "backgrounded" /* Backgrounded */) {
       return;
     }
     const lastPrompt = lastPromptRef.current;
@@ -479531,7 +479618,8 @@ ${verifyResult}` });
     pendingToolCalls: toolCalls,
     handleApprovalModeChange,
     activePtyId,
-    loopDetectionConfirmationRequest
+    loopDetectionConfirmationRequest,
+    backgroundCurrentSession
   };
 }, "useGeminiStream");
 
@@ -480126,7 +480214,8 @@ function useKeyboardHandling(params) {
     ideContextState,
     handleExit,
     handleSlashCommand: handleSlashCommand2,
-    debugKeystrokeLogging
+    debugKeystrokeLogging,
+    onBackgroundSession
   } = params;
   const [showToolDescriptions, setShowToolDescriptions] = (0, import_react151.useState)(false);
   const [ctrlCPressedOnce, setCtrlCPressedOnce] = (0, import_react151.useState)(false);
@@ -480246,6 +480335,9 @@ function useKeyboardHandling(params) {
       if (activePtyId || embeddedShellFocused) {
         setEmbeddedShellFocused((prev) => !prev);
       }
+    } else if (keyMatchers["backgroundSession" /* BACKGROUND_SESSION */](key) && onBackgroundSession) {
+      onBackgroundSession();
+      return;
     }
   };
   const handleGlobalKeypress = (0, import_react151.useCallback)(
@@ -485150,7 +485242,8 @@ var AppContainer = /* @__PURE__ */ __name((props) => {
     retryLastPrompt,
     handleApprovalModeChange,
     activePtyId,
-    loopDetectionConfirmationRequest
+    loopDetectionConfirmationRequest,
+    backgroundCurrentSession
   } = useGeminiStream(
     config2.getGeminiClient(),
     historyManager.history,
@@ -485616,7 +485709,8 @@ ${migrationResult.failedFiles.map((f5) => `  \u2022 ${f5.file}: ${f5.error}`).jo
     config: config2,
     ideContextState,
     handleExit,
-    debugKeystrokeLogging: settings2.merged.general?.debugKeystrokeLogging
+    debugKeystrokeLogging: settings2.merged.general?.debugKeystrokeLogging,
+    onBackgroundSession: backgroundCurrentSession
   });
   useWindowTitle(
     streamingState,
@@ -490068,7 +490162,7 @@ var QwenAgent = class {
   async initialize(args2) {
     this.clientCapabilities = args2.clientCapabilities;
     const authMethods = buildAuthMethods();
-    const version2 = "0.25.8";
+    const version2 = "0.25.10";
     return {
       protocolVersion: PROTOCOL_VERSION,
       agentInfo: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protolabsai/proto",
-  "version": "0.25.8",
+  "version": "0.25.10",
   "description": "proto - AI-powered coding agent",
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
     "bundled"
   ],
   "config": {
-    "sandboxImageUri": "ghcr.io/qwenlm/qwen-code:0.25.8"
+    "sandboxImageUri": "ghcr.io/qwenlm/qwen-code:0.25.10"
   },
   "dependencies": {},
   "optionalDependencies": {