@stigmer/react 0.2.0 → 0.2.1

package/runner/__tests__/useRunnerFileBrowser.test.js

@@ -0,0 +1,179 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { renderHook, act, waitFor } from "@testing-library/react";
+import { StigmerContext } from "../../context";
+import { useRunnerFileBrowser } from "../useRunnerFileBrowser";
+function buildListDirectoryResponse(resolvedPath, entries, homeDirectory = "/home/user", currentDirectory = "/home/user/projects") {
+    return {
+        requestId: "req-1",
+        result: {
+            case: "listDirectory",
+            value: {
+                resolvedPath,
+                entries: entries.map((e) => ({
+                    name: e.name,
+                    isDirectory: e.isDirectory,
+                    isHidden: e.isHidden,
+                    $typeName: "ai.stigmer.agentic.runner.v1.DirectoryEntry",
+                })),
+                homeDirectory,
+                currentDirectory,
+                $typeName: "ai.stigmer.agentic.runner.v1.ListDirectoryResponse",
+            },
+        },
+        $typeName: "ai.stigmer.agentic.runner.v1.RunnerCommandResponse",
+    };
+}
+function buildErrorResponse(message) {
+    return {
+        requestId: "req-1",
+        result: {
+            case: "error",
+            value: {
+                message,
+                $typeName: "ai.stigmer.agentic.runner.v1.RunnerCommandError",
+            },
+        },
+        $typeName: "ai.stigmer.agentic.runner.v1.RunnerCommandResponse",
+    };
+}
+function buildMockClient(sendCommand) {
+    return {
+        runner: { sendCommand },
+    };
+}
+function makeWrapper(client) {
+    return ({ children }) => (_jsx(StigmerContext.Provider, { value: client, children: children }));
+}
+describe("useRunnerFileBrowser", () => {
+    let sendCommandMock;
+    let client;
+    beforeEach(() => {
+        sendCommandMock = vi.fn();
+        client = buildMockClient(sendCommandMock);
+    });
+    it("fetches home directory on initial mount with runnerId", async () => {
+        sendCommandMock.mockResolvedValueOnce(buildListDirectoryResponse("/home/user", [
+            { name: "projects", isDirectory: true, isHidden: false },
+            { name: ".config", isDirectory: true, isHidden: true },
+            { name: ".bashrc", isDirectory: false, isHidden: true },
+        ]));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        expect(sendCommandMock).toHaveBeenCalledOnce();
+        expect(result.current.currentPath).toBe("/home/user");
+        expect(result.current.entries).toHaveLength(3);
+        expect(result.current.homeDirectory).toBe("/home/user");
+        expect(result.current.currentDirectory).toBe("/home/user/projects");
+        expect(result.current.segments).toHaveLength(3);
+        expect(result.current.segments[0].name).toBe("/");
+        expect(result.current.segments[2].name).toBe("user");
+    });
+    it("does not fetch when runnerId is null", () => {
+        renderHook(() => useRunnerFileBrowser(null), {
+            wrapper: makeWrapper(client),
+        });
+        expect(sendCommandMock).not.toHaveBeenCalled();
+    });
+    it("navigates into a child directory", async () => {
+        sendCommandMock
+            .mockResolvedValueOnce(buildListDirectoryResponse("/home/user", [
+            { name: "projects", isDirectory: true, isHidden: false },
+        ]))
+            .mockResolvedValueOnce(buildListDirectoryResponse("/home/user/projects", [
+            { name: "my-app", isDirectory: true, isHidden: false },
+        ]));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        await act(async () => {
+            result.current.navigateTo("projects");
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.currentPath).toBe("/home/user/projects");
+        expect(result.current.entries).toHaveLength(1);
+        expect(result.current.entries[0].name).toBe("my-app");
+    });
+    it("navigates up to parent directory", async () => {
+        sendCommandMock
+            .mockResolvedValueOnce(buildListDirectoryResponse("/home/user/projects", []))
+            .mockResolvedValueOnce(buildListDirectoryResponse("/home/user", [
+            { name: "projects", isDirectory: true, isHidden: false },
+        ]));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        await act(async () => {
+            result.current.navigateUp();
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.currentPath).toBe("/home/user");
+    });
+    it("handles runner error responses", async () => {
+        sendCommandMock.mockResolvedValueOnce(buildErrorResponse("permission denied: /root"));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.error).not.toBeNull();
+        expect(result.current.error.message).toBe("permission denied: /root");
+    });
+    it("handles network errors", async () => {
+        sendCommandMock.mockRejectedValueOnce(new Error("runner unavailable"));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.error).not.toBeNull();
+        expect(result.current.error.message).toBe("runner unavailable");
+    });
+    it("toggles hidden files", async () => {
+        sendCommandMock.mockResolvedValueOnce(buildListDirectoryResponse("/home/user", []));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.showHidden).toBe(false);
+        act(() => {
+            result.current.toggleHidden();
+        });
+        expect(result.current.showHidden).toBe(true);
+        act(() => {
+            result.current.toggleHidden();
+        });
+        expect(result.current.showHidden).toBe(false);
+    });
+    it("retries the last failed request", async () => {
+        sendCommandMock
+            .mockRejectedValueOnce(new Error("timeout"))
+            .mockResolvedValueOnce(buildListDirectoryResponse("/home/user", []));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.error).not.toBeNull());
+        await act(async () => {
+            result.current.retry();
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.error).toBeNull();
+        expect(result.current.currentPath).toBe("/home/user");
+        expect(sendCommandMock).toHaveBeenCalledTimes(2);
+    });
+    it("reports isAtRoot correctly", async () => {
+        sendCommandMock.mockResolvedValueOnce(buildListDirectoryResponse("/", [
+            { name: "home", isDirectory: true, isHidden: false },
+        ]));
+        const { result } = renderHook(() => useRunnerFileBrowser("rnr_1"), {
+            wrapper: makeWrapper(client),
+        });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        expect(result.current.isAtRoot).toBe(true);
+    });
+});
+//# sourceMappingURL=useRunnerFileBrowser.test.js.map

package/runner/__tests__/useRunnerFileBrowser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunnerFileBrowser.test.js","sourceRoot":"","sources":["../../../src/runner/__tests__/useRunnerFileBrowser.test.tsx"],"names":[],"mappings":"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"}

package/runner/index.d.ts

@@ -10,6 +10,10 @@ export { useDeleteRunner } from "./useDeleteRunner";
 export type { UseDeleteRunnerReturn } from "./useDeleteRunner";
 export { RunnerPicker } from "./RunnerPicker";
 export type { RunnerPickerProps } from "./RunnerPicker";
+export { RunnerFileBrowser } from "./RunnerFileBrowser";
+export type { RunnerFileBrowserProps } from "./RunnerFileBrowser";
+export { useRunnerFileBrowser } from "./useRunnerFileBrowser";
+export type { UseRunnerFileBrowserReturn, PathSegment, } from "./useRunnerFileBrowser";
 export { RunnerListPanel } from "./RunnerListPanel";
 export type { RunnerListPanelProps } from "./RunnerListPanel";
 export { phaseLabel, phaseDotColor, isActivePhase, isTransitionalPhase, PHASE_SORT_ORDER, } from "./phase";

package/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,0BAA0B,EAC1B,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/runner/index.js

@@ -4,6 +4,8 @@ export { useRunnerCredential } from "./useRunnerCredential";
 export { useStopRunner } from "./useStopRunner";
 export { useDeleteRunner } from "./useDeleteRunner";
 export { RunnerPicker } from "./RunnerPicker";
+export { RunnerFileBrowser } from "./RunnerFileBrowser";
+export { useRunnerFileBrowser } from "./useRunnerFileBrowser";
 export { RunnerListPanel } from "./RunnerListPanel";
 export { phaseLabel, phaseDotColor, isActivePhase, isTransitionalPhase, PHASE_SORT_ORDER, } from "./phase";
 //# sourceMappingURL=index.js.map

package/runner/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/runner/useRunnerFileBrowser.d.ts

@@ -0,0 +1,78 @@
+import { type DirectoryEntry } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+/** A single segment of the breadcrumb path bar. */
+export interface PathSegment {
+    /** Display name (directory name, or "/" for root). */
+    readonly name: string;
+    /** Absolute path up to and including this segment. */
+    readonly path: string;
+}
+/** Return value of {@link useRunnerFileBrowser}. */
+export interface UseRunnerFileBrowserReturn {
+    /** Current resolved absolute path. */
+    readonly currentPath: string;
+    /** Directory entries for the current path. */
+    readonly entries: readonly DirectoryEntry[];
+    /** Breadcrumb segments for the current path. */
+    readonly segments: readonly PathSegment[];
+    /** Runner's home directory (enables Home shortcut). */
+    readonly homeDirectory: string;
+    /** Runner process's current working directory (enables CWD shortcut). */
+    readonly currentDirectory: string;
+    /** Whether hidden files are shown. */
+    readonly showHidden: boolean;
+    /** Toggle hidden file visibility. */
+    readonly toggleHidden: () => void;
+    /** True while a directory listing is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last navigation attempt. */
+    readonly error: Error | null;
+    /** Navigate into a child directory by name. */
+    readonly navigateTo: (name: string) => void;
+    /** Navigate to an absolute path. */
+    readonly navigateToPath: (path: string) => void;
+    /** Navigate to the parent directory. */
+    readonly navigateUp: () => void;
+    /** Navigate to the runner's home directory. */
+    readonly navigateHome: () => void;
+    /** Navigate to the runner's current working directory. */
+    readonly navigateCwd: () => void;
+    /** Retry the last failed navigation. */
+    readonly retry: () => void;
+    /** True when at the filesystem root (no parent). */
+    readonly isAtRoot: boolean;
+}
+/**
+ * Behavior hook that drives a filesystem browser against a connected runner.
+ *
+ * Sends `ListDirectory` commands via the runner's bidi stream (through the
+ * `sendCommand` unary RPC) and manages navigation state, breadcrumbs,
+ * loading/error handling, and hidden file filtering.
+ *
+ * Designed for composition with {@link RunnerFileBrowser} but usable
+ * standalone by platform builders who want custom rendering.
+ *
+ * @param runnerId - ID of the runner to browse. When `null`, the hook
+ *   is inert (no requests are made, entries are empty).
+ *
+ * @example
+ * ```tsx
+ * function MyFilePicker({ runnerId }: { runnerId: string }) {
+ *   const browser = useRunnerFileBrowser(runnerId);
+ *
+ *   return (
+ *     <div>
+ *       <p>Path: {browser.currentPath}</p>
+ *       {browser.entries
+ *         .filter(e => e.isDirectory)
+ *         .map(e => (
+ *           <button key={e.name} onClick={() => browser.navigateTo(e.name)}>
+ *             {e.name}
+ *           </button>
+ *         ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRunnerFileBrowser(runnerId: string | null): UseRunnerFileBrowserReturn;
+//# sourceMappingURL=useRunnerFileBrowser.d.ts.map

package/runner/useRunnerFileBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunnerFileBrowser.d.ts","sourceRoot":"","sources":["../../src/runner/useRunnerFileBrowser.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oDAAoD,CAAC;AAI5D,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA0FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,0BAA0B,CAgI5B"}

package/runner/useRunnerFileBrowser.js

@@ -0,0 +1,191 @@
+"use client";
+import { useCallback, useEffect, useReducer, useRef } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RunnerSendCommandInputSchema, ListDirectoryRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+function reducer(state, action) {
+    switch (action.type) {
+        case "NAVIGATE":
+            return {
+                ...state,
+                requestedPath: action.path,
+                isLoading: true,
+                error: null,
+            };
+        case "SUCCESS":
+            return {
+                ...state,
+                currentPath: action.resolvedPath,
+                entries: action.entries,
+                homeDirectory: action.homeDirectory || state.homeDirectory,
+                currentDirectory: action.currentDirectory || state.currentDirectory,
+                isLoading: false,
+                error: null,
+            };
+        case "FAILURE":
+            return { ...state, isLoading: false, error: action.error };
+        case "TOGGLE_HIDDEN":
+            return { ...state, showHidden: !state.showHidden };
+    }
+}
+const INITIAL_STATE = {
+    currentPath: "",
+    entries: [],
+    homeDirectory: "",
+    currentDirectory: "",
+    showHidden: false,
+    isLoading: false,
+    error: null,
+    requestedPath: "",
+};
+// ---------------------------------------------------------------------------
+// Path utilities
+// ---------------------------------------------------------------------------
+function buildSegments(path) {
+    if (!path)
+        return [];
+    const segments = [{ name: "/", path: "/" }];
+    const parts = path.split("/").filter(Boolean);
+    let accumulated = "";
+    for (const part of parts) {
+        accumulated += `/${part}`;
+        segments.push({ name: part, path: accumulated });
+    }
+    return segments;
+}
+function parentPath(path) {
+    if (!path || path === "/")
+        return "/";
+    const idx = path.lastIndexOf("/");
+    return idx <= 0 ? "/" : path.slice(0, idx);
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Behavior hook that drives a filesystem browser against a connected runner.
+ *
+ * Sends `ListDirectory` commands via the runner's bidi stream (through the
+ * `sendCommand` unary RPC) and manages navigation state, breadcrumbs,
+ * loading/error handling, and hidden file filtering.
+ *
+ * Designed for composition with {@link RunnerFileBrowser} but usable
+ * standalone by platform builders who want custom rendering.
+ *
+ * @param runnerId - ID of the runner to browse. When `null`, the hook
+ *   is inert (no requests are made, entries are empty).
+ *
+ * @example
+ * ```tsx
+ * function MyFilePicker({ runnerId }: { runnerId: string }) {
+ *   const browser = useRunnerFileBrowser(runnerId);
+ *
+ *   return (
+ *     <div>
+ *       <p>Path: {browser.currentPath}</p>
+ *       {browser.entries
+ *         .filter(e => e.isDirectory)
+ *         .map(e => (
+ *           <button key={e.name} onClick={() => browser.navigateTo(e.name)}>
+ *             {e.name}
+ *           </button>
+ *         ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useRunnerFileBrowser(runnerId) {
+    const stigmer = useStigmer();
+    const [state, dispatch] = useReducer(reducer, INITIAL_STATE);
+    const requestIdRef = useRef(0);
+    const fetchDirectory = useCallback(async (path) => {
+        if (!runnerId)
+            return;
+        const id = ++requestIdRef.current;
+        dispatch({ type: "NAVIGATE", path });
+        try {
+            const response = await stigmer.runner.sendCommand(create(RunnerSendCommandInputSchema, {
+                runnerId,
+                command: {
+                    case: "listDirectory",
+                    value: create(ListDirectoryRequestSchema, { path }),
+                },
+            }));
+            // Stale response guard — a newer navigation has started.
+            if (id !== requestIdRef.current)
+                return;
+            if (response.result.case === "error") {
+                dispatch({
+                    type: "FAILURE",
+                    error: new Error(response.result.value.message),
+                });
+                return;
+            }
+            if (response.result.case === "listDirectory") {
+                const listing = response.result.value;
+                dispatch({
+                    type: "SUCCESS",
+                    resolvedPath: listing.resolvedPath,
+                    entries: listing.entries,
+                    homeDirectory: listing.homeDirectory,
+                    currentDirectory: listing.currentDirectory,
+                });
+            }
+        }
+        catch (err) {
+            if (id !== requestIdRef.current)
+                return;
+            dispatch({ type: "FAILURE", error: toError(err) });
+        }
+    }, [runnerId, stigmer]);
+    // Initial load: fetch home directory when runnerId becomes available.
+    const initializedForRef = useRef(null);
+    useEffect(() => {
+        if (!runnerId) {
+            initializedForRef.current = null;
+            return;
+        }
+        if (initializedForRef.current !== runnerId) {
+            initializedForRef.current = runnerId;
+            fetchDirectory("");
+        }
+    }, [runnerId, fetchDirectory]);
+    const navigateTo = useCallback((name) => {
+        const next = state.currentPath === "/"
+            ? `/${name}`
+            : `${state.currentPath}/${name}`;
+        fetchDirectory(next);
+    }, [state.currentPath, fetchDirectory]);
+    const navigateToPath = useCallback((path) => fetchDirectory(path), [fetchDirectory]);
+    const navigateUp = useCallback(() => fetchDirectory(parentPath(state.currentPath)), [state.currentPath, fetchDirectory]);
+    const navigateHome = useCallback(() => fetchDirectory(state.homeDirectory || "~"), [state.homeDirectory, fetchDirectory]);
+    const navigateCwd = useCallback(() => {
+        if (state.currentDirectory)
+            fetchDirectory(state.currentDirectory);
+    }, [state.currentDirectory, fetchDirectory]);
+    const retry = useCallback(() => fetchDirectory(state.requestedPath), [state.requestedPath, fetchDirectory]);
+    const toggleHidden = useCallback(() => dispatch({ type: "TOGGLE_HIDDEN" }), []);
+    const segments = buildSegments(state.currentPath);
+    const isAtRoot = state.currentPath === "/";
+    return {
+        currentPath: state.currentPath,
+        entries: state.entries,
+        segments,
+        homeDirectory: state.homeDirectory,
+        currentDirectory: state.currentDirectory,
+        showHidden: state.showHidden,
+        toggleHidden,
+        isLoading: state.isLoading,
+        error: state.error,
+        navigateTo,
+        navigateToPath,
+        navigateUp,
+        navigateHome,
+        navigateCwd,
+        retry,
+        isAtRoot,
+    };
+}
+//# sourceMappingURL=useRunnerFileBrowser.js.map

package/runner/useRunnerFileBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunnerFileBrowser.js","sourceRoot":"","sources":["../../src/runner/useRunnerFileBrowser.ts"],"names":[],"mappings":"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"}

package/src/composer/SessionComposer.tsx

@@ -402,18 +402,29 @@ export function SessionComposer({
   const showAttach = enableAttachments;
 
   // ---------------------------------------------------------------------------
-  // Runner name resolution — for the workspace contextual hint
+  // Runner resolution — name for contextual hint + ID for file browsing
   // ---------------------------------------------------------------------------
 
-  const { runners: runnerListForName } = useRunnerList(
-    showRunner && runnerId ? (org ?? null) : null,
+  const needsRunnerList = showRunner && (runnerId || (showWorkspace && enableLocal));
+
+  const { runners: runnerListForBrowse } = useRunnerList(
+    needsRunnerList ? (org ?? null) : null,
   );
 
   const selectedRunnerName = useMemo(() => {
     if (!runnerId) return undefined;
-    const runner = runnerListForName.find((r) => r.metadata?.id === runnerId);
+    const runner = runnerListForBrowse.find((r) => r.metadata?.id === runnerId);
     return runner?.metadata?.name;
-  }, [runnerId, runnerListForName]);
+  }, [runnerId, runnerListForBrowse]);
+
+  const browseRunnerId = useMemo(() => {
+    if (runnerId) return runnerId;
+    if (!enableLocal) return null;
+    const active = runnerListForBrowse.find((r) =>
+      isActivePhase(r.status?.phase ?? RunnerPhase.UNSPECIFIED),
+    );
+    return active?.metadata?.id ?? null;
+  }, [runnerId, enableLocal, runnerListForBrowse]);
 
   // ---------------------------------------------------------------------------
   // Configure menu state — drives the Tier 2 drill-down popover
@@ -1351,6 +1362,7 @@ export function SessionComposer({
                   gitHubConnection={gitHubConnection}
                   enableGitHub={enableGitHub}
                   enableLocal={enableLocal}
+                  runnerId={browseRunnerId}
                   onBrowseLocalFolder={onBrowseLocalFolder}
                   runnerName={selectedRunnerName}
                 />

package/src/index.ts

@@ -685,7 +685,9 @@ export {
   useRunnerCredential,
   useStopRunner,
   useDeleteRunner,
+  useRunnerFileBrowser,
   RunnerPicker,
+  RunnerFileBrowser,
   RunnerListPanel,
   phaseLabel,
   phaseDotColor,
@@ -704,6 +706,9 @@ export type {
   StopRunnerInput,
   UseStopRunnerReturn,
   UseDeleteRunnerReturn,
+  UseRunnerFileBrowserReturn,
+  PathSegment,
   RunnerPickerProps,
+  RunnerFileBrowserProps,
   RunnerListPanelProps,
 } from "./runner";