@astralyn/pi 0.81.1-2 → 0.82.1

package/docs/rpc.md

@@ -23,7 +23,7 @@ Common options:
 - **Responses**: JSON objects with `type: "response"` indicating command success/failure
 - **Events**: Agent events streamed to stdout as JSON lines
 
-All commands support an optional `id` field for request/response correlation. If provided, the corresponding response will include the same `id`.
+All commands support an optional `id` field for request/response correlation. If provided, the corresponding response will include the same `id`. `bash_execution_update` events also include the `id` of their originating `bash` command.
 
 ### Framing
 
@@ -455,15 +455,18 @@ Response:
 
 #### bash
 
-Execute a shell command and add output to conversation context.
+Execute a shell command and add output to conversation context. Output streams as `bash_execution_update` events while the command runs; the response contains the final result.
 
 ```json
-{"type": "bash", "command": "ls -la"}
+{"id": "req-1", "type": "bash", "command": "ls -la"}
 ```
 
+Include an `id` to associate streamed `bash_execution_update` events with this command.
+
 Response:
 ```json
 {
+  "id": "req-1",
   "type": "response",
   "command": "bash",
   "success": true,
@@ -494,7 +497,7 @@ If output was truncated, includes `fullOutputPath`:
 
 **How bash results reach the LLM:**
 
-The `bash` command executes immediately and returns a `BashResult`. Internally, a `BashExecutionMessage` is created and stored in the agent's message state. This message does NOT emit an event.
+The `bash` command executes immediately and returns a `BashResult`. Internally, a `BashExecutionMessage` is created and stored in the agent's message state.
 
 When the next `prompt` command is sent, all messages (including `BashExecutionMessage`) are transformed before being sent to the LLM. The `BashExecutionMessage` is converted to a `UserMessage` with this format:
 
@@ -509,7 +512,6 @@ drwxr-xr-x ...
 This means:
 1. Bash output is included in the LLM context on the **next prompt**, not immediately
 2. Multiple bash commands can be executed before a prompt; all outputs will be included
-3. No event is emitted for the `BashExecutionMessage` itself
 
 #### abort_bash
 
@@ -829,7 +831,7 @@ Each command has:
 
 ## Events
 
-Events are streamed to stdout as JSON lines during agent operation. Events do NOT include an `id` field (only responses do).
+Events are streamed to stdout as JSON lines during agent operation. Events do not generally include an `id` field; `bash_execution_update` includes the `id` of its originating `bash` command when one was provided.
 
 ### Event Types
 
@@ -843,6 +845,7 @@ Events are streamed to stdout as JSON lines during agent operation. Events do NO
 | `message_start` | Message begins |
 | `message_update` | Streaming update (text/thinking/toolcall deltas) |
 | `message_end` | Message completes |
+| `bash_execution_update` | Direct RPC bash command output chunk |
 | `tool_execution_start` | Tool begins execution |
 | `tool_execution_update` | Tool execution progress (streaming output) |
 | `tool_execution_end` | Tool completes |
@@ -951,6 +954,20 @@ Example streaming a text response:
 {"type":"message_update","message":{...},"assistantMessageEvent":{"type":"text_end","contentIndex":0,"content":"Hello world","partial":{...}}}
 ```
 
+### bash_execution_update
+
+Emitted once for each output chunk from a direct `bash` command. `id` matches the command's `id`, allowing clients to associate output with the correct command.
+
+Events stream all output while the command runs, even if the final `bash` response's `output` is truncated.
+
+```json
+{
+  "type": "bash_execution_update",
+  "id": "req-1",
+  "delta": "total 48\n"
+}
+```
+
 ### tool_execution_start / tool_execution_update / tool_execution_end
 
 Emitted when a tool begins, streams progress, and completes execution.

package/docs/settings.md

@@ -142,7 +142,7 @@ Version checks read the latest `@astralyn/pi` version from npm. Set `PI_SKIP_VER
 | `retry.provider.maxRetries` | number | `0` | Provider/SDK retry attempts |
 | `retry.provider.maxRetryDelayMs` | number | `60000` | Max server-requested delay before failing (60s) |
 
-When a provider requests a retry delay longer than `retry.provider.maxRetryDelayMs` (e.g., Google's "quota will reset after 5h"), the request fails immediately with an informative error instead of waiting silently. Set to `0` to disable the cap.
+When a provider requests a retry delay longer than `retry.provider.maxRetryDelayMs`, the request fails immediately with an informative error instead of waiting silently. Set it to `0` to disable the limit.
 
 Keep `retry.provider.maxRetries` at `0` unless provider-level retries are explicitly needed. Setting it above `0` can make SDK/provider retries handle out-of-usage-limit errors before Pi sees them, which may block the agent until the provider quota resets in some circumstances.
 

package/docs/usage.md

@@ -289,19 +289,6 @@ pi --tools read,grep,find,ls -p "Review the code"
 pi --exclude-tools ask_question
 ```
 
-### Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `PI_CODING_AGENT_DIR` | Override config directory; default is `~/.pi/agent` |
-| `PI_CODING_AGENT_SESSION_DIR` | Override session storage directory; overridden by `--session-dir` |
-| `PI_PACKAGE_DIR` | Override package directory, useful for Nix/Guix store paths |
-| `PI_OFFLINE` | Disable startup network operations, including npm version checks, package update checks, and model refresh |
-| `PI_SKIP_VERSION_CHECK` | Skip the Pi version update check at startup. This prevents the npm registry latest-version request |
-| `PI_TELEMETRY` | Override optional provider attribution headers: `1`/`true`/`yes` or `0`/`false`/`no`. This does not disable version checks |
-| `PI_CACHE_RETENTION` | Set to `long` for extended prompt cache where supported |
-| `VISUAL`, `EDITOR` | Fallback external editor for Ctrl+G when `externalEditor` is unset; defaults to Notepad on Windows and `nano` elsewhere |
-
 ## Design Principles
 
 Pi keeps the core small and pushes workflow-specific behavior into extensions, skills, prompt templates, and packages.

package/examples/extensions/custom-compaction.ts

@@ -15,6 +15,7 @@
 
 import type { ExtensionAPI } from "@astralyn/pi";
 import { convertToLlm, serializeConversation } from "@astralyn/pi";
+import { uuidv7 } from "@earendil-works/pi-ai";
 import { complete } from "@earendil-works/pi-ai/compat";
 
 export default function (pi: ExtensionAPI) {
@@ -96,6 +97,8 @@ ${conversationText}
 					env: auth.env,
 					maxTokens: 8192,
 					signal,
+					cacheRetention: "none",
+					sessionId: uuidv7(),
 				},
 			);
 

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.81.1",
+  "version": "0.82.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.81.1",
+      "version": "0.82.0",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-anthropic",
   "private": true,
-  "version": "0.81.1",
+  "version": "0.82.0",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-gitlab-duo",
   "private": true,
-  "version": "0.81.1",
+  "version": "0.82.0",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/gondolin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-gondolin",
-	"version": "0.81.1",
+	"version": "0.82.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-gondolin",
-			"version": "0.81.1",
+			"version": "0.82.0",
 			"dependencies": {
 				"@earendil-works/gondolin": "0.12.0"
 			}

package/examples/extensions/gondolin/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-gondolin",
 	"private": true,
-	"version": "0.81.1",
+	"version": "0.82.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/handoff.ts

@@ -15,6 +15,7 @@
 import type { ExtensionAPI, SessionEntry } from "@astralyn/pi";
 import { BorderedLoader, convertToLlm, serializeConversation } from "@astralyn/pi";
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import { uuidv7 } from "@earendil-works/pi-ai";
 import { complete, type Message } from "@earendil-works/pi-ai/compat";
 
 const SYSTEM_PROMPT = `You are a context transfer assistant. Given a conversation history and the user's goal for a new thread, generate a focused prompt that:
@@ -136,7 +137,14 @@ export default function (pi: ExtensionAPI) {
 					const response = await complete(
 						ctx.model!,
 						{ systemPrompt: SYSTEM_PROMPT, messages: [userMessage] },
-						{ apiKey: auth.apiKey, headers: auth.headers, env: auth.env, signal: loader.signal },
+						{
+							apiKey: auth.apiKey,
+							headers: auth.headers,
+							env: auth.env,
+							signal: loader.signal,
+							cacheRetention: "none",
+							sessionId: uuidv7(),
+						},
 					);
 
 					if (response.stopReason === "aborted") {

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-sandbox",
-	"version": "1.11.1",
+	"version": "1.12.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "1.11.1",
+			"version": "1.12.0",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "^0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-sandbox",
 	"private": true,
-	"version": "1.11.1",
+	"version": "1.12.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/summarize.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@astralyn/pi";
 import { DynamicBorder, getMarkdownTheme } from "@astralyn/pi";
+import { uuidv7 } from "@earendil-works/pi-ai";
 import { complete, getModel } from "@earendil-works/pi-ai/compat";
 import { Container, Markdown, matchesKey, Text } from "@earendil-works/pi-tui";
 
@@ -193,6 +194,8 @@ export default function (pi: ExtensionAPI) {
 					headers: auth.headers,
 					env: auth.env,
 					reasoningEffort: "high",
+					cacheRetention: "none",
+					sessionId: uuidv7(),
 				},
 			);
 

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.81.1",
+  "version": "0.82.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.81.1",
+      "version": "0.82.0",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "0.81.1",
+  "version": "0.82.0",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.81.1-2",
+	"version": "0.82.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "0.81.1-2",
+			"version": "0.82.1",
 			"license": "MIT",
 			"dependencies": {
-				"@earendil-works/pi-agent-core": "^0.81.1",
-				"@earendil-works/pi-ai": "^0.81.1",
-				"@earendil-works/pi-tui": "^0.81.1",
+				"@earendil-works/pi-agent-core": "^0.82.0",
+				"@earendil-works/pi-ai": "^0.82.0",
+				"@earendil-works/pi-tui": "^0.82.0",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"chalk": "5.6.2",
 				"cross-spawn": "7.0.6",
@@ -474,11 +474,12 @@
 			}
 		},
 		"node_modules/@earendil-works/pi-agent-core": {
-			"version": "0.81.1",
-			"resolved": "https://registry.npmjs.org/@earendil-works/pi-agent-core/-/pi-agent-core-0.81.1.tgz",
+			"version": "0.82.0",
+			"resolved": "https://registry.npmjs.org/@earendil-works/pi-agent-core/-/pi-agent-core-0.82.0.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"@earendil-works/pi-ai": "^0.81.1",
+				"@earendil-works/pi-ai": "^0.82.0",
+				"diff": "8.0.4",
 				"ignore": "7.0.5",
 				"typebox": "1.1.38",
 				"yaml": "2.9.0"
@@ -488,8 +489,8 @@
 			}
 		},
 		"node_modules/@earendil-works/pi-ai": {
-			"version": "0.81.1",
-			"resolved": "https://registry.npmjs.org/@earendil-works/pi-ai/-/pi-ai-0.81.1.tgz",
+			"version": "0.82.0",
+			"resolved": "https://registry.npmjs.org/@earendil-works/pi-ai/-/pi-ai-0.82.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",
@@ -512,8 +513,8 @@
 			}
 		},
 		"node_modules/@earendil-works/pi-tui": {
-			"version": "0.81.1",
-			"resolved": "https://registry.npmjs.org/@earendil-works/pi-tui/-/pi-tui-0.81.1.tgz",
+			"version": "0.82.0",
+			"resolved": "https://registry.npmjs.org/@earendil-works/pi-tui/-/pi-tui-0.82.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",
@@ -1592,9 +1593,9 @@
 			}
 		},
 		"node_modules/protobufjs": {
-			"version": "7.6.4",
-			"resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.6.4.tgz",
-			"integrity": "sha512-RJJPTTpvFfHcWLkIa2JFWK4XvtSzS0yEWDmunqHXli1h3JlkbcQZXDZdcWxv+JK3Xsl5/UFDPZ0iGm7DAengYw==",
+			"version": "7.6.5",
+			"resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.6.5.tgz",
+			"integrity": "sha512-/FPD0nUc9jH6rfFjji9IBqOz4pcSE3CsT1m7Ep6Mdb0LxSUMj8hgl6GomOvZzpNpAqqGaXA0P3VSrZLFzIhQrw==",
 			"license": "BSD-3-Clause",
 			"dependencies": {
 				"@protobufjs/aspromise": "^1.1.2",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.81.1-2",
+	"version": "0.82.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -39,9 +39,9 @@
 		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap"
 	},
 	"dependencies": {
-		"@earendil-works/pi-agent-core": "^0.81.1",
-		"@earendil-works/pi-ai": "^0.81.1",
-		"@earendil-works/pi-tui": "^0.81.1",
+		"@earendil-works/pi-agent-core": "^0.82.0",
+		"@earendil-works/pi-ai": "^0.82.0",
+		"@earendil-works/pi-tui": "^0.82.0",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",
@@ -59,6 +59,7 @@
 		"yaml": "2.9.0"
 	},
 	"overrides": {
+		"protobufjs": "7.6.5",
 		"rimraf": "6.1.2",
 		"gaxios": {
 			"rimraf": "6.1.2"

package/dist/core/tools/bash-command-summary.d.ts

@@ -1,7 +0,0 @@
-/**
- * Return unique, ordered command names when a command is a safe multi-command
- * chain suitable for a compact display summary. Returns undefined when the
- * command contains unsupported shell syntax or an unrecognized command.
- */
-export declare function summarizeBashCommand(command: string): string[] | undefined;
-//# sourceMappingURL=bash-command-summary.d.ts.map

package/dist/core/tools/bash-command-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bash-command-summary.d.ts","sourceRoot":"","sources":["../../../src/core/tools/bash-command-summary.ts"],"names":[],"mappings":"AA6PA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAY1E","sourcesContent":["const SUMMARIZABLE_COMMANDS = new Set([\n\t\"cd\",\n\t\"ls\",\n\t\"find\",\n\t\"fd\",\n\t\"rg\",\n\t\"grep\",\n\t\"git\",\n\t\"gh\",\n\t\"npm\",\n\t\"pnpm\",\n\t\"yarn\",\n\t\"bun\",\n\t\"cat\",\n\t\"head\",\n\t\"tail\",\n\t\"sed\",\n\t\"awk\",\n\t\"jq\",\n\t\"sort\",\n\t\"uniq\",\n\t\"wc\",\n\t\"mkdir\",\n\t\"cp\",\n\t\"mv\",\n\t\"rm\",\n\t\"touch\",\n\t\"curl\",\n\t\"wget\",\n\t\"make\",\n\t\"cmake\",\n\t\"cargo\",\n\t\"go\",\n\t\"docker\",\n\t\"kubectl\",\n]);\n\nconst SHELL_KEYWORDS = new Set([\n\t\"case\",\n\t\"do\",\n\t\"done\",\n\t\"elif\",\n\t\"else\",\n\t\"esac\",\n\t\"fi\",\n\t\"for\",\n\t\"function\",\n\t\"if\",\n\t\"in\",\n\t\"select\",\n\t\"then\",\n\t\"until\",\n\t\"while\",\n]);\n\ntype CommandSeparator = \"&&\" | \"||\" | \"|\" | \"|&\" | \";\" | \"\\n\";\n\nfunction splitTopLevelCommands(command: string): string[] | undefined {\n\tconst segments: string[] = [];\n\tlet current = \"\";\n\tlet quote: \"'\" | '\"' | undefined;\n\tlet escaped = false;\n\tlet sawSeparator = false;\n\tlet trailingSeparator: CommandSeparator | undefined;\n\n\tconst pushSegment = (separator: CommandSeparator): boolean => {\n\t\tconst segment = current.trim();\n\t\tif (!segment) return false;\n\t\tsegments.push(segment);\n\t\tcurrent = \"\";\n\t\tsawSeparator = true;\n\t\ttrailingSeparator = separator;\n\t\treturn true;\n\t};\n\n\tfor (let i = 0; i < command.length; i++) {\n\t\tconst char = command[i];\n\t\tconst next = command[i + 1];\n\n\t\tif (escaped) {\n\t\t\tif (char !== \"\\n\") current += char;\n\t\t\tescaped = false;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"\\\\\") {\n\t\t\tif (next === \"\\n\") {\n\t\t\t\ti++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tescaped = true;\n\t\t\tcurrent += char;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (quote) {\n\t\t\tcurrent += char;\n\t\t\tif (char === quote) quote = undefined;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"'\" || char === '\"') {\n\t\t\tquote = char;\n\t\t\tcurrent += char;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"`\" || (char === \"$\" && (next === \"(\" || next === \"{\"))) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// Redirections, grouping, comments, and background execution need more\n\t\t// shell grammar than a display-only summary should attempt to model.\n\t\tif (char === \"<\" || char === \">\" || char === \"(\" || char === \")\" || char === \"#\") {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (char === \"&\") {\n\t\t\tif (next !== \"&\") return undefined;\n\t\t\tif (!pushSegment(\"&&\")) return undefined;\n\t\t\tcurrent = \"\";\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"|\") {\n\t\t\tif (next === \"|\") {\n\t\t\t\tif (!pushSegment(\"||\")) return undefined;\n\t\t\t\ti++;\n\t\t\t} else if (next === \"&\") {\n\t\t\t\tif (!pushSegment(\"|&\")) return undefined;\n\t\t\t\ti++;\n\t\t\t} else if (!pushSegment(\"|\")) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tcurrent = \"\";\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \";\") {\n\t\t\tif (next === \";\" || next === \"&\") return undefined;\n\t\t\tif (!pushSegment(\";\")) return undefined;\n\t\t\tcurrent = \"\";\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"\\n\") {\n\t\t\tif (!current.trim() && trailingSeparator && trailingSeparator !== \";\" && trailingSeparator !== \"\\n\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!pushSegment(\"\\n\")) return undefined;\n\t\t\tcurrent = \"\";\n\t\t\tcontinue;\n\t\t}\n\n\t\tcurrent += char;\n\t}\n\n\tif (escaped || quote) return undefined;\n\tif (current.trim()) {\n\t\tsegments.push(current.trim());\n\t} else if (trailingSeparator && trailingSeparator !== \";\" && trailingSeparator !== \"\\n\") {\n\t\treturn undefined;\n\t}\n\n\treturn sawSeparator && segments.length > 1 ? segments : undefined;\n}\n\nfunction tokenizeSimpleCommand(segment: string): string[] | undefined {\n\tconst tokens: string[] = [];\n\tlet current = \"\";\n\tlet quote: \"'\" | '\"' | undefined;\n\tlet escaped = false;\n\tlet tokenStarted = false;\n\n\tconst pushToken = () => {\n\t\tif (!tokenStarted) return;\n\t\ttokens.push(current);\n\t\tcurrent = \"\";\n\t\ttokenStarted = false;\n\t};\n\n\tfor (let i = 0; i < segment.length; i++) {\n\t\tconst char = segment[i];\n\n\t\tif (escaped) {\n\t\t\tif (char !== \"\\n\") current += char;\n\t\t\tescaped = false;\n\t\t\ttokenStarted = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"\\\\\") {\n\t\t\tescaped = true;\n\t\t\ttokenStarted = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (quote) {\n\t\t\tif (char === quote) {\n\t\t\t\tquote = undefined;\n\t\t\t} else {\n\t\t\t\tcurrent += char;\n\t\t\t}\n\t\t\ttokenStarted = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === \"'\" || char === '\"') {\n\t\t\tquote = char;\n\t\t\ttokenStarted = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (/\\s/.test(char)) {\n\t\t\tpushToken();\n\t\t\tcontinue;\n\t\t}\n\n\t\tcurrent += char;\n\t\ttokenStarted = true;\n\t}\n\n\tif (escaped || quote) return undefined;\n\tpushToken();\n\treturn tokens.length > 0 ? tokens : undefined;\n}\n\nfunction normalizeCommandName(token: string): string | undefined {\n\tif (!token || token.startsWith(\"$\")) return undefined;\n\tconst lastSlash = token.lastIndexOf(\"/\");\n\tif (lastSlash !== -1) {\n\t\tif (token.startsWith(\"./\") || token.startsWith(\"../\")) return undefined;\n\t\ttoken = token.slice(lastSlash + 1);\n\t}\n\n\tconst normalized = token.toLowerCase().replace(/\\.exe$/, \"\");\n\treturn SUMMARIZABLE_COMMANDS.has(normalized) ? normalized : undefined;\n}\n\nfunction extractSimpleCommandName(segment: string): string | undefined {\n\tconst tokens = tokenizeSimpleCommand(segment);\n\tif (!tokens) return undefined;\n\n\tlet index = 0;\n\twhile (index < tokens.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[index])) {\n\t\tindex++;\n\t}\n\tconst command = tokens[index];\n\tif (!command || SHELL_KEYWORDS.has(command)) return undefined;\n\treturn normalizeCommandName(command);\n}\n\n/**\n * Return unique, ordered command names when a command is a safe multi-command\n * chain suitable for a compact display summary. Returns undefined when the\n * command contains unsupported shell syntax or an unrecognized command.\n */\nexport function summarizeBashCommand(command: string): string[] | undefined {\n\tconst segments = splitTopLevelCommands(command);\n\tif (!segments) return undefined;\n\n\tconst names: string[] = [];\n\tfor (const segment of segments) {\n\t\tconst name = extractSimpleCommandName(segment);\n\t\tif (!name) return undefined;\n\t\tif (!names.includes(name)) names.push(name);\n\t}\n\n\treturn names.length > 0 ? names : undefined;\n}\n"]}