@astralyn/pi 1.4.8 → 1.4.9

package/dist/modes/interactive/tool-view/chat.d.ts

@@ -1,12 +1,13 @@
-import { Container } from "@earendil-works/pi-tui";
+import type { Container } from "@earendil-works/pi-tui";
 import { ToolExecutionComponent } from "../components/tool-execution.ts";
+import { TranscriptLayoutContainer } from "../transcript-layout.ts";
 /**
  * Chat container that keeps tool blocks compact and disposes them with the chat.
  *
  * Single-line tools read as one compact list; a multiline tool leaves a blank line before the
  * next tool. Clearing the chat disposes its tool rows, so renderer timers never outlive them.
  */
-export declare class ToolChatContainer extends Container {
+export declare class ToolChatContainer extends TranscriptLayoutContainer {
     render(width: number): string[];
     clear(): void;
 }

package/dist/modes/interactive/tool-view/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/tool-view/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AASzE;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA0B/B,KAAK,IAAI,IAAI;CAItB;AAED,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAC7D,KAAK,IAAI,IAAI;CAItB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAErD"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/tool-view/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AASpE;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,yBAAyB;IACtD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA0B/B,KAAK,IAAI,IAAI;CAItB;AAED,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAC7D,KAAK,IAAI,IAAI;CAItB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAErD"}

package/dist/modes/interactive/tool-view/chat.js

@@ -1,6 +1,6 @@
-import { Container } from "@earendil-works/pi-tui";
 import { stripAnsi } from "../../../utils/ansi.js";
 import { ToolExecutionComponent } from "../components/tool-execution.js";
+import { TranscriptLayoutContainer } from "../transcript-layout.js";
 function disposeAll(components) {
     for (const component of components) {
         const disposable = component;
@@ -14,7 +14,7 @@ function disposeAll(components) {
  * Single-line tools read as one compact list; a multiline tool leaves a blank line before the
  * next tool. Clearing the chat disposes its tool rows, so renderer timers never outlive them.
  */
-export class ToolChatContainer extends Container {
+export class ToolChatContainer extends TranscriptLayoutContainer {
     render(width) {
         let previous;
         let previousHeight = 0;
@@ -36,7 +36,7 @@ export class ToolChatContainer extends Container {
             }
             previous = child;
         }
-        // Keep Container's mouse layout in sync with the final spacing.
+        // Record child rows after the final tool spacing is known.
         return super.render(width);
     }
     clear() {

package/dist/modes/interactive/tool-view/chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../../src/modes/interactive/tool-view/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,SAAS,UAAU,CAAC,UAA6B;IAChD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,SAAqC,CAAC;QACzD,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU;YAAE,UAAU,CAAC,OAAO,EAAE,CAAC;IACpE,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACtC,MAAM,CAAC,KAAa;QAC5B,IAAI,QAA+B,CAAC;QACpC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC7C,uFAAuF;gBACvF,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3E,IAAI,KAAK,KAAK,CAAC,CAAC;oBAAE,SAAS;gBAC3B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;gBAC5E,KAAK,CAAC,aAAa,CAClB,QAAQ,YAAY,sBAAsB;oBACzC,CAAC,CAAC,cAAc,GAAG,CAAC;wBACnB,CAAC,CAAC,kBAAkB;wBACpB,CAAC,CAAC,SAAS;oBACZ,CAAC,CAAC,UAAU,CACb,CAAC;gBACF,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACvC,CAAC;YACD,QAAQ,GAAG,KAAK,CAAC;QAClB,CAAC;QACD,gEAAgE;QAChE,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEQ,KAAK;QACb,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACD;AAED,0EAA0E;AAC1E,MAAM,OAAO,cAAe,SAAQ,GAAmC;IAC7D,KAAK;QACb,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACD;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,IAAe;IAC9C,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import { type Component, Container } from \"@earendil-works/pi-tui\";\nimport { stripAnsi } from \"../../../utils/ansi.ts\";\nimport { ToolExecutionComponent } from \"../components/tool-execution.ts\";\n\nfunction disposeAll(components: Iterable<unknown>): void {\n\tfor (const component of components) {\n\t\tconst disposable = component as { dispose?: () => void };\n\t\tif (typeof disposable.dispose === \"function\") disposable.dispose();\n\t}\n}\n\n/**\n * Chat container that keeps tool blocks compact and disposes them with the chat.\n *\n * Single-line tools read as one compact list; a multiline tool leaves a blank line before the\n * next tool. Clearing the chat disposes its tool rows, so renderer timers never outlive them.\n */\nexport class ToolChatContainer extends Container {\n\toverride render(width: number): string[] {\n\t\tlet previous: Component | undefined;\n\t\tlet previousHeight = 0;\n\t\tfor (const child of this.children) {\n\t\t\tif (child instanceof ToolExecutionComponent) {\n\t\t\t\t// Measure at this width without external spacing, including wrapped titles and images.\n\t\t\t\tchild.setLeadingGap(0);\n\t\t\t\tconst lines = child.render(width);\n\t\t\t\tconst start = lines.findIndex((line) => stripAnsi(line).trim().length > 0);\n\t\t\t\tif (start === -1) continue;\n\t\t\t\tconst { afterTool, afterMultilineTool, afterOther } = child.getToolRowGap();\n\t\t\t\tchild.setLeadingGap(\n\t\t\t\t\tprevious instanceof ToolExecutionComponent\n\t\t\t\t\t\t? previousHeight > 1\n\t\t\t\t\t\t\t? afterMultilineTool\n\t\t\t\t\t\t\t: afterTool\n\t\t\t\t\t\t: afterOther,\n\t\t\t\t);\n\t\t\t\tpreviousHeight = lines.length - start;\n\t\t\t}\n\t\t\tprevious = child;\n\t\t}\n\t\t// Keep Container's mouse layout in sync with the final spacing.\n\t\treturn super.render(width);\n\t}\n\n\toverride clear(): void {\n\t\tdisposeAll(this.children);\n\t\tsuper.clear();\n\t}\n}\n\n/** Pending tool rows by call ID; clear() disposes the rows it forgets. */\nexport class PendingToolMap extends Map<string, ToolExecutionComponent> {\n\toverride clear(): void {\n\t\tdisposeAll(this.values());\n\t\tsuper.clear();\n\t}\n}\n\n/** Dispose every row still shown, for mode shutdown where the chat is not cleared. */\nexport function disposeChatRows(chat: Container): void {\n\tdisposeAll(chat.children);\n}\n"]}
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../../src/modes/interactive/tool-view/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,SAAS,UAAU,CAAC,UAA6B;IAChD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,SAAqC,CAAC;QACzD,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU;YAAE,UAAU,CAAC,OAAO,EAAE,CAAC;IACpE,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,yBAAyB;IACtD,MAAM,CAAC,KAAa;QAC5B,IAAI,QAA+B,CAAC;QACpC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC7C,uFAAuF;gBACvF,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3E,IAAI,KAAK,KAAK,CAAC,CAAC;oBAAE,SAAS;gBAC3B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;gBAC5E,KAAK,CAAC,aAAa,CAClB,QAAQ,YAAY,sBAAsB;oBACzC,CAAC,CAAC,cAAc,GAAG,CAAC;wBACnB,CAAC,CAAC,kBAAkB;wBACpB,CAAC,CAAC,SAAS;oBACZ,CAAC,CAAC,UAAU,CACb,CAAC;gBACF,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACvC,CAAC;YACD,QAAQ,GAAG,KAAK,CAAC;QAClB,CAAC;QACD,2DAA2D;QAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEQ,KAAK;QACb,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACD;AAED,0EAA0E;AAC1E,MAAM,OAAO,cAAe,SAAQ,GAAmC;IAC7D,KAAK;QACb,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACD;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,IAAe;IAC9C,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import type { Component, Container } from \"@earendil-works/pi-tui\";\nimport { stripAnsi } from \"../../../utils/ansi.ts\";\nimport { ToolExecutionComponent } from \"../components/tool-execution.ts\";\nimport { TranscriptLayoutContainer } from \"../transcript-layout.ts\";\n\nfunction disposeAll(components: Iterable<unknown>): void {\n\tfor (const component of components) {\n\t\tconst disposable = component as { dispose?: () => void };\n\t\tif (typeof disposable.dispose === \"function\") disposable.dispose();\n\t}\n}\n\n/**\n * Chat container that keeps tool blocks compact and disposes them with the chat.\n *\n * Single-line tools read as one compact list; a multiline tool leaves a blank line before the\n * next tool. Clearing the chat disposes its tool rows, so renderer timers never outlive them.\n */\nexport class ToolChatContainer extends TranscriptLayoutContainer {\n\toverride render(width: number): string[] {\n\t\tlet previous: Component | undefined;\n\t\tlet previousHeight = 0;\n\t\tfor (const child of this.children) {\n\t\t\tif (child instanceof ToolExecutionComponent) {\n\t\t\t\t// Measure at this width without external spacing, including wrapped titles and images.\n\t\t\t\tchild.setLeadingGap(0);\n\t\t\t\tconst lines = child.render(width);\n\t\t\t\tconst start = lines.findIndex((line) => stripAnsi(line).trim().length > 0);\n\t\t\t\tif (start === -1) continue;\n\t\t\t\tconst { afterTool, afterMultilineTool, afterOther } = child.getToolRowGap();\n\t\t\t\tchild.setLeadingGap(\n\t\t\t\t\tprevious instanceof ToolExecutionComponent\n\t\t\t\t\t\t? previousHeight > 1\n\t\t\t\t\t\t\t? afterMultilineTool\n\t\t\t\t\t\t\t: afterTool\n\t\t\t\t\t\t: afterOther,\n\t\t\t\t);\n\t\t\t\tpreviousHeight = lines.length - start;\n\t\t\t}\n\t\t\tprevious = child;\n\t\t}\n\t\t// Record child rows after the final tool spacing is known.\n\t\treturn super.render(width);\n\t}\n\n\toverride clear(): void {\n\t\tdisposeAll(this.children);\n\t\tsuper.clear();\n\t}\n}\n\n/** Pending tool rows by call ID; clear() disposes the rows it forgets. */\nexport class PendingToolMap extends Map<string, ToolExecutionComponent> {\n\toverride clear(): void {\n\t\tdisposeAll(this.values());\n\t\tsuper.clear();\n\t}\n}\n\n/** Dispose every row still shown, for mode shutdown where the chat is not cleared. */\nexport function disposeChatRows(chat: Container): void {\n\tdisposeAll(chat.children);\n}\n"]}

package/dist/modes/interactive/transcript-layout.d.ts

@@ -0,0 +1,23 @@
+import { type Component, Container } from "@earendil-works/pi-tui";
+export interface TranscriptLayoutChild {
+    readonly component: Component;
+    readonly row: number;
+    readonly height: number;
+}
+export interface TranscriptLayout {
+    readonly width: number;
+    readonly children: readonly TranscriptLayoutChild[];
+}
+/**
+ * A container that exposes the rows it has already rendered for transcript anchors.
+ *
+ * Mouse dispatch intentionally keeps using Container's fallback measurement. The
+ * layout is observational and never changes rendering or hit-testing behavior.
+ */
+export declare class TranscriptLayoutContainer extends Container {
+    private renderedLayout;
+    getRenderedLayout(): TranscriptLayout | undefined;
+    clear(): void;
+    render(width: number): string[];
+}
+//# sourceMappingURL=transcript-layout.d.ts.map

package/dist/modes/interactive/transcript-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-layout.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/transcript-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;IACvD,OAAO,CAAC,cAAc,CAA+B;IAErD,iBAAiB,IAAI,gBAAgB,GAAG,SAAS;IAIxC,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAWxC"}

package/dist/modes/interactive/transcript-layout.js

@@ -0,0 +1,29 @@
+import { Container } from "@earendil-works/pi-tui";
+/**
+ * A container that exposes the rows it has already rendered for transcript anchors.
+ *
+ * Mouse dispatch intentionally keeps using Container's fallback measurement. The
+ * layout is observational and never changes rendering or hit-testing behavior.
+ */
+export class TranscriptLayoutContainer extends Container {
+    getRenderedLayout() {
+        return this.renderedLayout;
+    }
+    clear() {
+        this.renderedLayout = undefined;
+        super.clear();
+    }
+    render(width) {
+        const lines = [];
+        const children = [];
+        for (const component of this.children) {
+            const childLines = component.render(width);
+            children.push({ component, row: lines.length, height: childLines.length });
+            for (const line of childLines)
+                lines.push(line);
+        }
+        this.renderedLayout = { width, children };
+        return lines;
+    }
+}
+//# sourceMappingURL=transcript-layout.js.map

package/dist/modes/interactive/transcript-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-layout.js","sourceRoot":"","sources":["../../../src/modes/interactive/transcript-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAanE;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAGvD,iBAAiB;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC5B,CAAC;IAEQ,KAAK;QACb,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEQ,MAAM,CAAC,KAAa;QAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,KAAK,MAAM,IAAI,IAAI,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACd,CAAC;CACD","sourcesContent":["import { type Component, Container } from \"@earendil-works/pi-tui\";\n\nexport interface TranscriptLayoutChild {\n\treadonly component: Component;\n\treadonly row: number;\n\treadonly height: number;\n}\n\nexport interface TranscriptLayout {\n\treadonly width: number;\n\treadonly children: readonly TranscriptLayoutChild[];\n}\n\n/**\n * A container that exposes the rows it has already rendered for transcript anchors.\n *\n * Mouse dispatch intentionally keeps using Container's fallback measurement. The\n * layout is observational and never changes rendering or hit-testing behavior.\n */\nexport class TranscriptLayoutContainer extends Container {\n\tprivate renderedLayout: TranscriptLayout | undefined;\n\n\tgetRenderedLayout(): TranscriptLayout | undefined {\n\t\treturn this.renderedLayout;\n\t}\n\n\toverride clear(): void {\n\t\tthis.renderedLayout = undefined;\n\t\tsuper.clear();\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tconst children: TranscriptLayoutChild[] = [];\n\t\tfor (const component of this.children) {\n\t\t\tconst childLines = component.render(width);\n\t\t\tchildren.push({ component, row: lines.length, height: childLines.length });\n\t\t\tfor (const line of childLines) lines.push(line);\n\t\t}\n\t\tthis.renderedLayout = { width, children };\n\t\treturn lines;\n\t}\n}\n"]}

package/docs/bundled/README.md

@@ -27,6 +27,7 @@ The following extensions are additions maintained by `@astralyn/pi`:
 | [Provider](extensions/provider.md) | `/provider` | Edit models.json providers: connection, API type, and models |
 | [Statusline](extensions/statusline.md) | Footer status | Show concise extension-managed activity state |
 | [Search](extensions/search.md) | `code_search`, `web_search` | Devin-driven semantic code search and web search with one shared key |
+| [Shell paths](extensions/shell-paths.md) | File tools | Resolve bash mount paths such as `/tmp` on Windows |
 | [Tasks](tasks.md) | `tasks`, `/tasks` | Inspect and control native shell and extension-owned executions |
 
 All bundled extensions use the public Extension API. Enable or disable them in `pi config` or through `builtin:<name>` entries in [settings](../settings.md#codemode-and-tool-selection). `--no-extensions` disables them; `-e builtin:<name>` loads one explicitly.

package/docs/bundled/extensions/shell-paths.md

@@ -0,0 +1,17 @@
+# Shell paths
+
+On Windows, the `bash` tool runs Git Bash, MSYS2, or Cygwin, which name files through their own mount table. A model that works in `/tmp/build` with `bash` and then calls `read /tmp/build/log.txt` would otherwise reach `C:\tmp\build\log.txt` on the current drive instead of the directory bash used.
+
+This extension resolves such paths for the `read`, `write`, `edit`, `ls`, `grep`, and `find` tools the way bash does:
+
+| Path from bash | Resolves to (Git for Windows defaults) |
+|---|---|
+| `/tmp/build/log.txt` | `C:\Users\<you>\AppData\Local\Temp\build\log.txt` |
+| `/usr/bin/bash.exe` | `C:\Program Files\Git\usr\bin\bash.exe` |
+| `/etc/gitconfig` | `C:\Program Files\Git\etc\gitconfig` |
+
+The first such call reads the mount table from the configured shell (`shellPath` or the detected bash) with `mount`, so custom `fstab` entries and non-default installations resolve correctly. Bash maps `/tmp` to the user's temp directory even when Pi runs with a different `TEMP`.
+
+Drive paths such as `/c/Users/...`, `/cygdrive/c/...`, and `/mnt/c/...` work without this extension. Windows paths, relative paths, UNC paths, and paths on other platforms are left unchanged. Legacy WSL bash (`System32\bash.exe`) is skipped because its mounts live inside the Linux filesystem.
+
+Disable `builtin:shell-paths` to resolve these paths against the current drive root instead.

package/docs/docs.json

@@ -104,6 +104,10 @@
           "title": "Search",
           "path": "bundled/extensions/search.md"
         },
+        {
+          "title": "Shell paths",
+          "path": "bundled/extensions/shell-paths.md"
+        },
         {
           "title": "Bundled themes",
           "path": "bundled/themes.md"

package/docs/usage.md

@@ -264,7 +264,7 @@ pi --no-extensions -e ./my-extension.ts
 | `-h`, `--help` | Show help |
 | `-v`, `--version` | Show version |
 
-In `fullscreen` mode, the transcript scrolls inside the terminal viewport while queued messages, working status, extension widgets, editor, and footer remain fixed at the bottom. Mouse/trackpad input scrolls the region under the pointer; keyboard viewport actions always remain available. Inline images work in terminals that support the Kitty graphics protocol, including Kitty and Ghostty. In iTerm2 they render as text placeholders because its inline-image protocol cannot delete or crop placements during application-owned scrolling. In `regular` mode, pi uses the main screen and terminal-owned scrollback, and iTerm2 inline images continue to render normally. See [Terminal setup](terminal-setup.md) for terminal-specific settings and workarounds.
+In `fullscreen` mode, the transcript scrolls inside the terminal viewport while queued messages, working status, extension widgets, editor, and footer remain fixed at the bottom. When a user message's first line scrolls above the viewport, a subdued one-line summary appears at the top; click it to scroll back to that message. Mouse/trackpad input scrolls the region under the pointer; keyboard viewport actions always remain available. Inline images work in terminals that support the Kitty graphics protocol, including Kitty and Ghostty. In iTerm2 they render as text placeholders because its inline-image protocol cannot delete or crop placements during application-owned scrolling. In `regular` mode, pi uses the main screen and terminal-owned scrollback, and iTerm2 inline images continue to render normally. See [Terminal setup](terminal-setup.md) for terminal-specific settings and workarounds.
 
 Set **TUI mode** in `/settings` to switch between `regular` and `fullscreen` immediately and choose the default for future sessions. **Fullscreen exit output** controls whether exiting fullscreen prints the final transcript or restores the previous screen and prints only the session resume hint.
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@astralyn/pi",
-	"version": "1.4.8",
+	"version": "1.4.9",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "1.4.8",
+			"version": "1.4.9",
 			"license": "MIT",
 			"dependencies": {
 				"@earendil-works/pi-agent-core": "1.4.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@astralyn/pi",
-	"version": "1.4.8",
+	"version": "1.4.9",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {