@stigmer/react 3.1.1 → 3.1.3

package/execution/useArtifactCopy.js

@@ -0,0 +1,75 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactContentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/** How long the transient `copied` flag stays true after a successful copy. */
+const COPIED_FEEDBACK_MS = 2000;
+/**
+ * Behavior hook that copies an execution artifact's text to the clipboard on
+ * demand.
+ *
+ * The imperative sibling of {@link useArtifactDownload}: it fetches content at
+ * click time via `getArtifactContent` (CORS-safe, through the Stigmer API)
+ * rather than requiring the caller to have loaded it. This suits content-free
+ * surfaces — a plan card that detects the artifact by convention and never
+ * fetches until the user acts — where a mount-time {@link useArtifactContent}
+ * would be wasteful.
+ *
+ * Returns an imperative `copy(storageKey)` action plus a transient `copied`
+ * flag for feedback, mirroring the modal's copy affordance so every surface
+ * shares one implementation.
+ *
+ * @param executionId - Execution that produced the artifacts, or `null` to
+ *   disable (the action becomes a no-op).
+ *
+ * @example
+ * ```tsx
+ * const { copy, isCopying, copied } = useArtifactCopy(executionId);
+ * <button onClick={() => copy(artifact.storageKey)} disabled={isCopying}>
+ *   {copied ? "Copied" : "Copy"}
+ * </button>
+ * ```
+ *
+ * @see useArtifactDownload — imperative save-to-disk counterpart
+ * @see useArtifactContent — declarative content reader (preview rendering)
+ */
+export function useArtifactCopy(executionId) {
+    const stigmer = useStigmer();
+    const [isCopying, setIsCopying] = useState(false);
+    const [copied, setCopied] = useState(false);
+    const [error, setError] = useState(null);
+    // Clear the pending "copied" timer on unmount so a resolved copy never sets
+    // state on an unmounted component.
+    const copiedTimer = useRef(null);
+    useEffect(() => {
+        return () => {
+            if (copiedTimer.current !== null)
+                clearTimeout(copiedTimer.current);
+        };
+    }, []);
+    const copy = useCallback(async (storageKey) => {
+        if (!executionId || !storageKey || isCopying)
+            return;
+        setIsCopying(true);
+        setError(null);
+        try {
+            const result = await stigmer.agentExecution.getArtifactContent(create(GetArtifactContentRequestSchema, { executionId, storageKey }));
+            const text = new TextDecoder().decode(result.content);
+            await navigator.clipboard.writeText(text);
+            setCopied(true);
+            if (copiedTimer.current !== null)
+                clearTimeout(copiedTimer.current);
+            copiedTimer.current = setTimeout(() => setCopied(false), COPIED_FEEDBACK_MS);
+        }
+        catch (err) {
+            setError(toError(err));
+        }
+        finally {
+            setIsCopying(false);
+        }
+    }, [executionId, stigmer, isCopying]);
+    return useMemo(() => ({ copy, isCopying, copied, error }), [copy, isCopying, copied, error]);
+}
+//# sourceMappingURL=useArtifactCopy.js.map

package/execution/useArtifactCopy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArtifactCopy.js","sourceRoot":"","sources":["../../src/execution/useArtifactCopy.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,+BAA+B,EAAE,MAAM,4DAA4D,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,+EAA+E;AAC/E,MAAM,kBAAkB,GAAG,IAAI,CAAC;AA0BhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,eAAe,CAC7B,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,4EAA4E;IAC5E,mCAAmC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACtE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,UAAkB,EAAE,EAAE;QAC3B,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,IAAI,SAAS;YAAE,OAAO;QACrD,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAC5D,MAAM,CAAC,+BAA+B,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CACrE,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACpE,WAAW,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAClC,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAC1C,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC"}

package/execution/useArtifactDownload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useArtifactDownload.d.ts","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAQA,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,yBAAyB,CA8B3B"}
+{"version":3,"file":"useArtifactDownload.d.ts","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAQA,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,yBAAyB,CAuC3B"}

package/execution/useArtifactDownload.js

@@ -40,7 +40,16 @@ export function useArtifactDownload(executionId) {
         setIsDownloading(true);
         setError(null);
         try {
-            const result = await stigmer.agentExecution.getArtifactDownloadUrl(create(GetArtifactDownloadUrlRequestSchema, { executionId, storageKey }));
+            const result = await stigmer.agentExecution.getArtifactDownloadUrl(create(GetArtifactDownloadUrlRequestSchema, {
+                executionId,
+                storageKey,
+                // This is a save-to-disk action, so mint a URL that forces a
+                // browser download (Content-Disposition: attachment). Browsers
+                // ignore the anchor's `download` attribute cross-origin, so the
+                // disposition must ride on the URL itself. Contrast
+                // useArtifactDownloadUrl, which stays inline for `<img src>`.
+                asAttachment: true,
+            }));
             if (result.downloadUrl) {
                 triggerBrowserDownload(result.downloadUrl, fileName);
             }
@@ -55,10 +64,13 @@ export function useArtifactDownload(executionId) {
     return useMemo(() => ({ download, isDownloading, error }), [download, isDownloading, error]);
 }
 /**
- * Trigger a browser download for a URL via a transient anchor click. The
- * `download` hint is best-effort: browsers ignore it for cross-origin URLs
- * (e.g. R2), in which case the navigation still serves the file. Falls back to
- * a new tab in non-DOM environments.
+ * Trigger a browser download for a URL via a transient anchor click.
+ *
+ * The URL minted for this flow carries `Content-Disposition: attachment`
+ * (requested via `asAttachment`), so the browser saves the file even
+ * cross-origin — where it would ignore the anchor's `download` attribute. The
+ * `download` hint is still set as a same-origin nicety. Falls back to a new tab
+ * in non-DOM environments.
  */
 function triggerBrowserDownload(url, fileName) {
     if (typeof document === "undefined") {

package/execution/useArtifactDownload.js.map

@@ -1 +1 @@
-{"version":3,"file":"useArtifactDownload.js","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,mCAAmC,EAAE,MAAM,4DAA4D,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAqBjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,WAAW,CAC1B,KAAK,EAAE,UAAkB,EAAE,QAAiB,EAAE,EAAE;QAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,IAAI,aAAa;YAAE,OAAO;QACzD,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAChE,MAAM,CAAC,mCAAmC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CACzE,CAAC;YACF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,sBAAsB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CACtC,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAC1C,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,GAAW,EAAE,QAAiB;IAC5D,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACpD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,GAAG,GAAG,qBAAqB,CAAC;IACnC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"useArtifactDownload.js","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,mCAAmC,EAAE,MAAM,4DAA4D,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAqBjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,WAAW,CAC1B,KAAK,EAAE,UAAkB,EAAE,QAAiB,EAAE,EAAE;QAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,IAAI,aAAa;YAAE,OAAO;QACzD,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAChE,MAAM,CAAC,mCAAmC,EAAE;gBAC1C,WAAW;gBACX,UAAU;gBACV,6DAA6D;gBAC7D,+DAA+D;gBAC/D,gEAAgE;gBAChE,oDAAoD;gBACpD,8DAA8D;gBAC9D,YAAY,EAAE,IAAI;aACnB,CAAC,CACH,CAAC;YACF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,sBAAsB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CACtC,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAC1C,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sBAAsB,CAAC,GAAW,EAAE,QAAiB;IAC5D,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACpD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,GAAG,GAAG,qBAAqB,CAAC;IACnC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/execution/useCreateAgentExecution.d.ts

@@ -47,6 +47,18 @@ export interface CreateAgentExecutionInput {
      * Maps to `ExecutionConfig.interaction_mode` in the proto.
      */
     readonly interactionMode?: "agent" | "plan";
+    /**
+     * Marks this execution as a Build-from-plan turn: the user approved a
+     * plan from a prior Plan-mode execution and asked the agent to implement
+     * it. The runner injects the implement-plan directive (pointing at the
+     * attached approved plan when present); the thread hides the turn's
+     * machine-written message entirely — the plan card above it is the
+     * visible cause. Surfaces without that treatment (the CLI, history)
+     * show the message text as-is.
+     *
+     * Maps to `ExecutionConfig.build_from_plan` in the proto.
+     */
+    readonly buildFromPlan?: boolean;
     /**
      * Auto-approve every tool call for this execution.
      *

package/execution/useCreateAgentExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateAgentExecution.d.ts","sourceRoot":"","sources":["../../src/execution/useCreateAgentExecution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKjE,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,UAAU,CAAC;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,yBAAyB,KAC7B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,uBAAuB,IAAI,6BAA6B,CAwDvE"}
+{"version":3,"file":"useCreateAgentExecution.d.ts","sourceRoot":"","sources":["../../src/execution/useCreateAgentExecution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKjE,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,UAAU,CAAC;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,yBAAyB,KAC7B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,uBAAuB,IAAI,6BAA6B,CA6DvE"}

package/execution/useCreateAgentExecution.js

@@ -50,7 +50,10 @@ export function useCreateAgentExecution() {
         setIsCreating(true);
         setError(null);
         try {
-            const hasConfig = input.modelName || input.interactionMode || input.structuredOutputSchema;
+            const hasConfig = input.modelName ||
+                input.interactionMode ||
+                input.structuredOutputSchema ||
+                input.buildFromPlan;
             const executionConfig = hasConfig
                 ? {
                     ...(input.modelName ? { modelName: input.modelName } : {}),
@@ -60,6 +63,7 @@ export function useCreateAgentExecution() {
                     ...(input.structuredOutputSchema
                         ? { structuredOutputSchema: input.structuredOutputSchema }
                         : {}),
+                    ...(input.buildFromPlan ? { buildFromPlan: true } : {}),
                 }
                 : undefined;
             const execution = await stigmer.agentExecution.create({

package/execution/useCreateAgentExecution.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateAgentExecution.js","sourceRoot":"","sources":["../../src/execution/useCreateAgentExecution.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAoGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EACH,KAAgC,EACK,EAAE;QACvC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,sBAAsB,CAAC;YAC3F,MAAM,eAAe,GAAG,SAAS;gBAC/B,CAAC,CAAC;oBACE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1D,GAAG,CAAC,KAAK,CAAC,eAAe;wBACvB,CAAC,CAAC,EAAE,eAAe,EAAE,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE;wBACpE,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,KAAK,CAAC,sBAAsB;wBAC9B,CAAC,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,EAAE;wBAC1D,CAAC,CAAC,EAAE,CAAC;iBACR;gBACH,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC;gBACpD,IAAI,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE;gBAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,eAAe;gBACf,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;aAC3C,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,QAAS,CAAC,EAAE;gBACnC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"useCreateAgentExecution.js","sourceRoot":"","sources":["../../src/execution/useCreateAgentExecution.ts"],"names":[],"mappings":"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"}

package/github/decodeGitHubContent.d.ts

@@ -0,0 +1,29 @@
+import { type WorkspaceFileContent } from "../workspace/WorkspaceFileReader.js";
+/**
+ * Decode a GitHub base64 payload to raw bytes.
+ *
+ * GitHub's Contents API line-wraps its base64 with `\n` every 60 chars, and
+ * `atob` rejects embedded newlines in some engines — strip all ASCII
+ * whitespace first.
+ */
+export declare function base64ToBytes(b64: string): Uint8Array;
+/** Detect binary content via a NUL byte in the head of the buffer. */
+export declare function detectBinary(bytes: Uint8Array): boolean;
+/**
+ * Decode bytes as strict UTF-8, returning `null` when the sequence is invalid.
+ * `{ fatal: true }` makes `TextDecoder` throw rather than emit replacement
+ * characters, so undecodable files degrade to the binary/unknown fallback
+ * instead of silently rendering mojibake.
+ */
+export declare function bytesToText(bytes: Uint8Array): string | null;
+/**
+ * Turn decoded bytes into a {@link WorkspaceFileContent}, applying binary
+ * detection and the shared 1 MB display cap.
+ *
+ * @param bytes    the full decoded bytes as delivered by GitHub
+ * @param fullSize the file's true size in bytes (GitHub's `size` field), which
+ *                 may exceed `bytes.length` when the caller has already capped
+ *                 the download — reported verbatim as `size`.
+ */
+export declare function normalizeGitHubContent(bytes: Uint8Array, fullSize: number): WorkspaceFileContent;
+//# sourceMappingURL=decodeGitHubContent.d.ts.map

package/github/decodeGitHubContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeGitHubContent.d.ts","sourceRoot":"","sources":["../../src/github/decodeGitHubContent.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qCAAqC,CAAC;AAM7C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAIrD;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAqBtB"}

package/github/decodeGitHubContent.js

@@ -0,0 +1,72 @@
+// Pure byte/text decode helpers for the GitHub file reader.
+// Kept free of React and fetch so the Slice 0 spike behavior (base64 decode,
+// binary detection, the 1 MB cap) is unit-testable in isolation.
+import { MAX_WORKSPACE_FILE_READ_BYTES, } from "../workspace/WorkspaceFileReader.js";
+// Scan only the head for a NUL byte — git uses the first 8000 bytes as its
+// text/binary heuristic, and scanning the whole buffer buys nothing.
+const BINARY_SNIFF_BYTES = 8000;
+/**
+ * Decode a GitHub base64 payload to raw bytes.
+ *
+ * GitHub's Contents API line-wraps its base64 with `\n` every 60 chars, and
+ * `atob` rejects embedded newlines in some engines — strip all ASCII
+ * whitespace first.
+ */
+export function base64ToBytes(b64) {
+    const clean = b64.replace(/\s/g, "");
+    const binary = atob(clean);
+    return Uint8Array.from(binary, (ch) => ch.charCodeAt(0));
+}
+/** Detect binary content via a NUL byte in the head of the buffer. */
+export function detectBinary(bytes) {
+    const limit = Math.min(bytes.length, BINARY_SNIFF_BYTES);
+    for (let i = 0; i < limit; i++) {
+        if (bytes[i] === 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * Decode bytes as strict UTF-8, returning `null` when the sequence is invalid.
+ * `{ fatal: true }` makes `TextDecoder` throw rather than emit replacement
+ * characters, so undecodable files degrade to the binary/unknown fallback
+ * instead of silently rendering mojibake.
+ */
+export function bytesToText(bytes) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Turn decoded bytes into a {@link WorkspaceFileContent}, applying binary
+ * detection and the shared 1 MB display cap.
+ *
+ * @param bytes    the full decoded bytes as delivered by GitHub
+ * @param fullSize the file's true size in bytes (GitHub's `size` field), which
+ *                 may exceed `bytes.length` when the caller has already capped
+ *                 the download — reported verbatim as `size`.
+ */
+export function normalizeGitHubContent(bytes, fullSize) {
+    if (detectBinary(bytes)) {
+        return { text: null, isBinary: true, size: fullSize, encoding: "base64" };
+    }
+    // Decode the full buffer, then cap the resulting *string* — capping the bytes
+    // first could split a multibyte char at the boundary and make the fatal
+    // decoder reject an otherwise-valid file.
+    const text = bytesToText(bytes);
+    if (text === null) {
+        return { text: null, isBinary: false, size: fullSize, encoding: "unknown" };
+    }
+    const truncated = bytes.length > MAX_WORKSPACE_FILE_READ_BYTES;
+    return {
+        text: truncated ? text.slice(0, MAX_WORKSPACE_FILE_READ_BYTES) : text,
+        isBinary: false,
+        size: fullSize,
+        encoding: "utf-8",
+        ...(truncated ? { truncated: true } : {}),
+    };
+}
+//# sourceMappingURL=decodeGitHubContent.js.map

package/github/decodeGitHubContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeGitHubContent.js","sourceRoot":"","sources":["../../src/github/decodeGitHubContent.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6EAA6E;AAC7E,iEAAiE;AAEjE,OAAO,EACL,6BAA6B,GAE9B,MAAM,qCAAqC,CAAC;AAE7C,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAiB,EACjB,QAAgB;IAEhB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IAED,8EAA8E;IAC9E,wEAAwE;IACxE,0CAA0C;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,6BAA6B,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC,IAAI;QACrE,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,OAAO;QACjB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/github/index.d.ts

@@ -3,5 +3,6 @@ export { useGitHubRepos, type GitHubRepo, type GitHubBranch, type UseGitHubRepos
 export { useGitHubSearch, type UseGitHubSearchReturn, } from "./useGitHubSearch.js";
 export { GitHubRepoPicker, type GitHubRepoPickerProps, } from "./GitHubRepoPicker.js";
 export { useGitHubTreeLister } from "./useGitHubTreeLister.js";
+export { useGitHubFileReader } from "./useGitHubFileReader.js";
 export { parseGitUrl, type ParsedGitRepo } from "./parseGitUrl.js";
 //# sourceMappingURL=index.d.ts.map

package/github/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/github/index.js

@@ -3,5 +3,6 @@ export { useGitHubRepos, } from "./useGitHubRepos.js";
 export { useGitHubSearch, } from "./useGitHubSearch.js";
 export { GitHubRepoPicker, } from "./GitHubRepoPicker.js";
 export { useGitHubTreeLister } from "./useGitHubTreeLister.js";
+export { useGitHubFileReader } from "./useGitHubFileReader.js";
 export { parseGitUrl } from "./parseGitUrl.js";
 //# sourceMappingURL=index.js.map

package/github/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAK7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAK7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC"}

package/github/useGitHubFileReader.d.ts

@@ -0,0 +1,26 @@
+import type { WorkspaceFileReader } from "../workspace/WorkspaceFileReader.js";
+/**
+ * Creates a {@link WorkspaceFileReader} backed by the GitHub Contents API,
+ * with a Blob-API fallback for files above the Contents 1 MB cap.
+ *
+ * Uses the same client-side OAuth token as {@link useGitHubTreeLister}
+ * (`Authorization: Bearer`), inheriting its private-repo scope. Returns
+ * `undefined` when no token is present, mirroring the tree lister so callers
+ * can treat "no reader" and "no lister" identically.
+ *
+ * The reader itself:
+ * - Returns `null` when the entry is not a readable GitHub git repo
+ *   (non-git entry, missing/unparseable URL) — the "unsupported here" state.
+ * - **Throws** on a real failure: a non-OK response, or a directory path
+ *   (which the Contents API returns as a JSON array). Consumers surface these
+ *   as an error, distinct from the null "unsupported" state.
+ *
+ * @example
+ * ```tsx
+ * const gitHubConnection = useGitHubConnection(org);
+ * const fileReader = useGitHubFileReader(gitHubConnection.token);
+ * <SessionViewer workspaceFileReader={fileReader} />
+ * ```
+ */
+export declare function useGitHubFileReader(token: string | null): WorkspaceFileReader | undefined;
+//# sourceMappingURL=useGitHubFileReader.d.ts.map

package/github/useGitHubFileReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitHubFileReader.d.ts","sourceRoot":"","sources":["../../src/github/useGitHubFileReader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAuC7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,mBAAmB,GAAG,SAAS,CA8CjC"}

package/github/useGitHubFileReader.js

@@ -0,0 +1,106 @@
+"use client";
+import { useCallback } from "react";
+import { base64ToBytes, normalizeGitHubContent } from "./decodeGitHubContent.js";
+import { parseGitUrl } from "./parseGitUrl.js";
+const GITHUB_API = "https://api.github.com/repos";
+/**
+ * Upper bound on files we will pull through the Blob API (Gate 1, Option B).
+ *
+ * The Contents API caps at ~1 MB and signals larger files with
+ * `encoding: "none"`; the Blob API then serves them in full (up to GitHub's own
+ * ~100 MB blob limit). Since we only ever display the first ~1 MB, downloading
+ * a 90 MB blob to show 1 MB is wasteful — so above this ceiling we report the
+ * file as too-large
+ * (`text: null`, `truncated: true`) using the size GitHub already told us,
+ * without downloading anything.
+ */
+const BLOB_FETCH_CEILING_BYTES = 10 * 1024 * 1024; // 10 MiB
+/** Encode a repo-relative path per segment, preserving the slashes. */
+function encodePath(path) {
+    return path.split("/").map(encodeURIComponent).join("/");
+}
+/**
+ * Creates a {@link WorkspaceFileReader} backed by the GitHub Contents API,
+ * with a Blob-API fallback for files above the Contents 1 MB cap.
+ *
+ * Uses the same client-side OAuth token as {@link useGitHubTreeLister}
+ * (`Authorization: Bearer`), inheriting its private-repo scope. Returns
+ * `undefined` when no token is present, mirroring the tree lister so callers
+ * can treat "no reader" and "no lister" identically.
+ *
+ * The reader itself:
+ * - Returns `null` when the entry is not a readable GitHub git repo
+ *   (non-git entry, missing/unparseable URL) — the "unsupported here" state.
+ * - **Throws** on a real failure: a non-OK response, or a directory path
+ *   (which the Contents API returns as a JSON array). Consumers surface these
+ *   as an error, distinct from the null "unsupported" state.
+ *
+ * @example
+ * ```tsx
+ * const gitHubConnection = useGitHubConnection(org);
+ * const fileReader = useGitHubFileReader(gitHubConnection.token);
+ * <SessionViewer workspaceFileReader={fileReader} />
+ * ```
+ */
+export function useGitHubFileReader(token) {
+    const reader = useCallback(async (entry, path) => {
+        if (entry.type !== "git" || !entry.gitUrl || !token)
+            return null;
+        const parsed = parseGitUrl(entry.gitUrl);
+        if (!parsed)
+            return null;
+        const branch = entry.gitBranch || "main";
+        const url = `${GITHUB_API}/${parsed.owner}/${parsed.repo}/contents/${encodePath(path)}` +
+            `?ref=${encodeURIComponent(branch)}`;
+        const resp = await fetch(url, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!resp.ok) {
+            throw new Error(`GitHub content fetch failed for ${path} (HTTP ${resp.status})`);
+        }
+        const data = await resp.json();
+        // The Contents API returns an array for a directory — a misdirected read,
+        // not an unsupported substrate, so fail loudly rather than return null.
+        if (Array.isArray(data)) {
+            throw new Error(`Cannot read "${path}": path is a directory`);
+        }
+        const file = data;
+        if (file.encoding === "base64") {
+            return normalizeGitHubContent(base64ToBytes(file.content), file.size);
+        }
+        // encoding: "none" is GitHub's signal that the file exceeds the Contents
+        // API's ~1 MB cap; the bytes live only behind the Blob API.
+        return readViaBlob(parsed, file, token);
+    }, [token]);
+    if (!token)
+        return undefined;
+    return reader;
+}
+/**
+ * Gate 1 / Option B — size-gated blob fetch for files the Contents API refused
+ * (`encoding: "none"`). Isolated so the large-file policy can change without
+ * touching the reader's control flow.
+ */
+async function readViaBlob(parsed, file, token) {
+    // Above the ceiling we never download — GitHub already told us the size, so
+    // report it as too-large-to-preview without spending the bandwidth.
+    if (file.size > BLOB_FETCH_CEILING_BYTES) {
+        return {
+            text: null,
+            isBinary: false,
+            size: file.size,
+            encoding: "none",
+            truncated: true,
+        };
+    }
+    const url = `${GITHUB_API}/${parsed.owner}/${parsed.repo}/git/blobs/${file.sha}`;
+    const resp = await fetch(url, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!resp.ok) {
+        throw new Error(`GitHub blob fetch failed for ${file.sha} (HTTP ${resp.status})`);
+    }
+    const blob = await resp.json();
+    return normalizeGitHubContent(base64ToBytes(blob.content), blob.size);
+}
+//# sourceMappingURL=useGitHubFileReader.js.map

package/github/useGitHubFileReader.js.map

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

package/github/useGitHubTreeLister.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGitHubTreeLister.d.ts","sourceRoot":"","sources":["../../src/github/useGitHubTreeLister.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AA6BnG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,mBAAmB,GAAG,SAAS,CAqCjC"}
+{"version":3,"file":"useGitHubTreeLister.d.ts","sourceRoot":"","sources":["../../src/github/useGitHubTreeLister.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAiCnG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,mBAAmB,GAAG,SAAS,CAqCjC"}

package/github/useGitHubTreeLister.js

@@ -3,12 +3,16 @@ import { useCallback } from "react";
 import { parseGitUrl } from "./parseGitUrl.js";
 const GITHUB_TREES_API = "https://api.github.com/repos";
 /**
- * Sentinel entry appended to the listing when the GitHub API indicates
- * that the tree was truncated (repository exceeds the API's entry limit).
+ * Advisory entry appended to the listing when the GitHub API indicates that the
+ * tree was truncated (repository exceeds the API's entry limit). Flagged with
+ * `notice: true` so generic consumers treat it as a "results incomplete" banner
+ * rather than an openable file (see `workspaceListingCache`) — never a tree leaf,
+ * never a search hit.
  */
 const TRUNCATION_MARKER = {
     path: "... (tree truncated by GitHub — repository has too many files)",
     isDirectory: false,
+    notice: true,
 };
 /**
  * Creates a {@link WorkspaceFileLister} backed by the GitHub Trees API.

package/github/useGitHubTreeLister.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGitHubTreeLister.js","sourceRoot":"","sources":["../../src/github/useGitHubTreeLister.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAgBxD;;;GAGG;AACH,MAAM,iBAAiB,GAAuB;IAC5C,IAAI,EAAE,gEAAgE;IACtE,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAqB,EAAwC,EAAE;QACpE,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAEjE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,gBAAgB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,cAAc,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC;QAErH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,IAAI,GAAuB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEnD,MAAM,OAAO,GAAyB,IAAI,CAAC,IAAI;aAC5C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM;SAClC,CAAC,CAAC,CAAC;QAEN,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"useGitHubTreeLister.js","sourceRoot":"","sources":["../../src/github/useGitHubTreeLister.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAgBxD;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAuB;IAC5C,IAAI,EAAE,gEAAgE;IACtE,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,IAAI;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAqB,EAAwC,EAAE;QACpE,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAEjE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,gBAAgB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,cAAc,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC;QAErH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,IAAI,GAAuB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEnD,MAAM,OAAO,GAAyB,IAAI,CAAC,IAAI;aAC5C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM;SAClC,CAAC,CAAC,CAAC;QAEN,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/index.d.ts

@@ -13,14 +13,14 @@ export { type DeploymentMode, isResourceAvailable, ApiResourceKind } from "@stig
 export { CloudFeatureNotice, type CloudFeatureNoticeProps } from "./internal/CloudFeatureNotice.js";
 export { DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PROVIDERS, modelKey, parseModelKey, fetchModelRegistry, parseRegistryJson, useModelRegistry, ModelRegistryContext, ModelSelector, HarnessSelector, DEFAULT_HARNESS, HARNESS_LABELS, toProtoHarness, fromProtoHarness, } from "./models/index.js";
 export type { ModelInfo, ModelRegistryState, ParsedModelKey, Provider, CostTier, UseModelRegistryReturn, UseModelRegistryOptions, ModelSelectorProps, HarnessSelectorProps, HarnessOption, } from "./models/index.js";
-export { useWorkspaceEntries, useWorkspaceFiles, useWorkspaceSources, WorkspaceEditor, WorkspaceEntryFiles, WorkspaceSummary, } from "./workspace/index.js";
-export type { WorkspaceEntry, WorkspaceFileEntry, WorkspaceFileLister, UseWorkspaceEntriesReturn, UseWorkspaceFilesOptions, UseWorkspaceFilesReturn, WorkspaceEntryFilesProps, UseWorkspaceSourcesOptions, UseWorkspaceSourcesReturn, WorkspaceEditorProps, WorkspaceSummaryProps, } from "./workspace/index.js";
-export { useCreateSession, useUpdateSession, useSession, useSessionList, useSessionExecutions, useSessionConversation, useSessionArtifacts, useSessionWriteBacks, useSessionFileChanges, useSessionUsage, useAgentRefFromSession, useNewSessionFlow, useSessionPageFlow, usePersistedModel, useEditSessionPrep, CREATOR_AGENTS, parseDraftType, parseDraftParams, groupSessionsByTime, groupSearchResultsByTime, useSessionSearch, PENDING_SUBJECT, resolvedSubject, SessionViewer, NewSessionViewer, SessionInspector, useSessionInspector, buildVisibleTabs, SetupTab, } from "./session/index.js";
-export type { SharedSessionFields, CreateSessionInput, CreateSessionResult, UseCreateSessionReturn, UseUpdateSessionReturn, UseSessionReturn, UseSessionListOptions, UseSessionListReturn, UseSessionSearchOptions, UseSessionSearchReturn, UseSessionExecutionsReturn, SendFollowUpOptions, UseSessionConversationReturn, SessionArtifactEntry, UseSessionArtifactsReturn, SessionWriteBackEntry, UseSessionWriteBacksReturn, UseSessionFileChangesReturn, ModelCostEntry, UseSessionUsageReturn, UseAgentRefFromSessionReturn, UseNewSessionFlowOptions, UseNewSessionFlowReturn, UseSessionPageFlowOptions, UseSessionPageFlowReturn, UsePersistedModelOptions, UsePersistedModelReturn, UseEditSessionPrepReturn, DraftResourceType, DraftParams, SessionGroup, SearchResultGroup, SessionViewerProps, NewSessionViewerProps, ExecutionTargetOption, RuntimeEnvProvider, SessionAudience, SessionInspectorProps, SessionInspectorTabId, UseSessionInspectorOptions, UseSessionInspectorReturn, SetupTabProps, SetupTabMutationCallbacks, SelectedThreadItem, } from "./session/index.js";
+export { useWorkspaceEntries, useWorkspaceFiles, useWorkspaceFileContent, useWorkspaceFileSearch, useWorkspaceContentSearch, useWorkspaceSources, MAX_WORKSPACE_FILE_READ_BYTES, WorkspaceEditor, WorkspaceFileSearch, WorkspaceContentSearch, WorkspaceSummary, FileViewer, WorkspaceSurface, ExplorerTree, virtualEntryId, isVirtualEntryId, } from "./workspace/index.js";
+export type { WorkspaceEntry, WorkspaceFileEntry, WorkspaceFileLister, WorkspaceFileContent, WorkspaceFileReader, UseWorkspaceEntriesReturn, UseWorkspaceFilesOptions, UseWorkspaceFilesReturn, UseWorkspaceFileContentOptions, UseWorkspaceFileContentReturn, UseWorkspaceFileSearchOptions, UseWorkspaceFileSearchReturn, WorkspaceFileSearchGroup, WorkspaceFileMatch, WorkspaceFileSearchProps, WorkspaceContentMatch, WorkspaceContentSearchResult, WorkspaceContentSearcher, UseWorkspaceContentSearchOptions, UseWorkspaceContentSearchReturn, WorkspaceContentSearchGroup, WorkspaceContentSearchProps, FileViewerProps, FileViewerHandle, SelectedWorkspaceFile, UseWorkspaceSourcesOptions, UseWorkspaceSourcesReturn, WorkspaceEditorProps, WorkspaceSummaryProps, WorkspaceSurfaceProps, SurfaceRailView, SurfaceVirtualDocument, ExplorerTreeProps, OpenEditor, OpenFileOptions, RevealTarget, } from "./workspace/index.js";
+export { useCreateSession, useUpdateSession, useSession, useSessionList, useSessionExecutions, useSessionConversation, useSessionArtifacts, useSessionWriteBacks, useSessionFileChanges, useSessionUsage, useAgentRefFromSession, useNewSessionFlow, useSessionPageFlow, usePersistedModel, useEditSessionPrep, CREATOR_AGENTS, parseDraftType, parseDraftParams, groupSessionsByTime, groupSearchResultsByTime, useSessionSearch, PENDING_SUBJECT, resolvedSubject, SessionViewer, NewSessionViewer, useSessionPanel, usePlanDraft, planDraftKey, PlanEditor, PlanStreamingDocument, PLAN_DOCUMENT_ENTRY_ID, PLAN_DOCUMENT_PATH, SetupTab, } from "./session/index.js";
+export type { SharedSessionFields, CreateSessionInput, CreateSessionResult, UseCreateSessionReturn, UseUpdateSessionReturn, UseSessionReturn, UseSessionListOptions, UseSessionListReturn, UseSessionSearchOptions, UseSessionSearchReturn, UseSessionExecutionsReturn, SendFollowUpOptions, UseSessionConversationReturn, SessionArtifactEntry, UseSessionArtifactsReturn, SessionWriteBackEntry, UseSessionWriteBacksReturn, UseSessionFileChangesReturn, ModelCostEntry, UseSessionUsageReturn, UseAgentRefFromSessionReturn, UseNewSessionFlowOptions, UseNewSessionFlowReturn, UseSessionPageFlowOptions, UseSessionPageFlowReturn, UsePersistedModelOptions, UsePersistedModelReturn, UseEditSessionPrepReturn, DraftResourceType, DraftParams, SessionGroup, SearchResultGroup, SessionViewerProps, NewSessionViewerProps, SessionPanelController, UseSessionPanelOptions, PlanDraftController, PlanEditorProps, PlanStreamingDocumentProps, ExecutionTargetOption, RuntimeEnvProvider, SessionAudience, SetupTabProps, SetupTabMutationCallbacks, SelectedThreadItem, } from "./session/index.js";
 export { useRecentActivity, groupRecentActivityByTime, } from "./activity/index.js";
 export type { RecentActivityType, RecentActivityEntry, RecentActivityGroup, UseRecentActivityOptions, UseRecentActivityReturn, } from "./activity/index.js";
-export { isTerminalPhase, useCreateAgentExecution, useExecutionStream, useAgentExecutionActions, useSubmitApproval, useFileReview, fileDecisionKey, fileReviewability, changeSetReviewability, deriveEffectiveVerdicts, changeForRowPath, fileReviewRowState, foldFileReviewEventStream, displayFileChangeSets, toDisplayFileChange, ExecutionPhaseBadge, InteractionModeBadge, SetupProgress, ExecutionProgress, TodoList, TodoCard, TodoInProgressIcon, findActiveTodo, todoCompletionSummary, UsageWidget, ContextGauge, SummarizationBadge, SummarizationCard, PlanCompletionCard, useContextWindow, formatCost, formatTokenCount, ToolCallGroup, ToolCallDetail, ResultView, summarizeResultView, TerminalSession, useToolPresentation, registerToolPresenter, getToolPresenter, resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, defaultDisclosureForCategory, McpToolDetail, parseMcpResult, formatDuration, humanizeToolName, ToolCallItem, SubAgentSection, MessageEntry, MessageThread, ThreadSkeleton, FollowUpInput, ApprovalCard, ApprovalCardHeader, ApprovalCardBody, FileReviewCard, FileReviewDock, ApprovalContext, useApproval, FileReviewContext, useFileReviewRowState, ArtifactCard, ArtifactContentRenderer, ArtifactPreviewContent, ArtifactPreviewModal, ArtifactsWidget, WriteBacksWidget, ToolArgsView, McpArgsView, McpMetadataRow, FilePathLink, FilePathContext, classifyPath, resolveGitBrowseUrl, resolvePathAction, useSessionVariables, SessionVariablesInput, useExecutionArtifacts, useArtifactContent, useArtifactDownloadUrl, useArtifactDownload, useToolOutputContent, useFileChangeContent, execIdFromStorageKey, useWorkspaceWriteBacks, WriteBackCard, FileChangesView, FileChangeDiff, EmptyChangeNotice, isTextArtifact, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./execution/index.js";
-export type { CreateAgentExecutionInput, CreateAgentExecutionResult, UseCreateAgentExecutionReturn, UseExecutionStreamReturn, UseAgentExecutionActionsOptions, UseAgentExecutionActionsReturn, UseSubmitApprovalReturn, UseFileReviewReturn, FileDecisionOptions, FileReviewability, FileBlockReason, ChangeSetReviewability, FileReviewRowState, ExecutionPhaseBadgeProps, InteractionModeBadgeProps, SetupProgressProps, ExecutionProgressProps, TodoListProps, TodoCardProps, UsageWidgetProps, ContextGaugeProps, SummarizationBadgeProps, SummarizationCardProps, PlanCompletionCardProps, ContextHealth, SummarizationEventView, UseContextWindowReturn, ToolCallGroupProps, ToolCallDetailProps, ResultViewProps, TerminalSessionProps, ToolPresentation, ToolPresenter, ToolDisclosure, McpToolDetailProps, McpArgsViewProps, McpMetadataRowProps, ToolArgsViewProps, ToolCallItemProps, SubAgentSectionProps, MessageEntryProps, MessageThreadProps, ThreadSkeletonProps, FollowUpInputProps, ApprovalCardProps, ApprovalCardHeaderProps, ApprovalCardBodyProps, FileReviewCardProps, FileReviewDockProps, ApprovalContextValue, UseApprovalResult, FileReviewContextValue, ArtifactCardProps, ArtifactContentRendererProps, ArtifactRenderMode, ArtifactPreviewContentProps, ArtifactPreviewModalProps, ArtifactsWidgetProps, WriteBacksWidgetProps, FilePathLinkProps, FilePathContextValue, PathClassification, ResolvedPathAction, SessionVariableEntry, UseSessionVariablesReturn, SessionVariablesInputProps, UseExecutionArtifactsReturn, UseArtifactContentReturn, UseArtifactDownloadUrlReturn, UseArtifactDownloadUrlOptions, UseArtifactDownloadReturn, UseToolOutputContentReturn, ToolOutputRefLike, UseFileChangeContentReturn, UseWorkspaceWriteBacksReturn, WriteBackCardProps, FileChangesViewProps, FileChangeDiffProps, EmptyChangeNoticeProps, EmptyChangeKind, } from "./execution/index.js";
+export { isTerminalPhase, useCreateAgentExecution, useExecutionStream, useAgentExecutionActions, useSubmitApproval, useFileReview, fileDecisionKey, fileReviewability, changeSetReviewability, deriveEffectiveVerdicts, changeForRowPath, fileReviewRowState, foldFileReviewEventStream, displayFileChangeSets, toDisplayFileChange, ExecutionPhaseBadge, InteractionModeBadge, SetupProgress, ExecutionProgress, TodoList, TodoCard, TodoInProgressIcon, findActiveTodo, todoCompletionSummary, UsageWidget, ContextGauge, SummarizationBadge, SummarizationCard, PlanCompletionCard, PlanArtifactCard, PlanStreamingCard, PlanDocumentMessage, useContextWindow, formatCost, formatTokenCount, ToolCallGroup, ToolCallDetail, ResultView, summarizeResultView, TerminalSession, useToolPresentation, registerToolPresenter, getToolPresenter, resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, defaultDisclosureForCategory, extractPrimaryArg, McpToolDetail, parseMcpResult, formatDuration, humanizeToolName, ToolCallItem, SubAgentSection, MessageEntry, MessageThread, ThreadSkeleton, FollowUpInput, ApprovalCard, ApprovalCardHeader, ApprovalCardBody, FileReviewCard, FileReviewDock, FileChangeProgressBar, ApprovalContext, useApproval, FileReviewContext, useFileReviewRowState, ArtifactCard, ArtifactContentRenderer, ArtifactPreviewContent, ArtifactPreviewModal, ArtifactsWidget, WriteBacksWidget, ToolArgsView, McpArgsView, McpMetadataRow, FilePathLink, FilePathContext, classifyPath, resolveGitBrowseUrl, resolvePathAction, useSessionVariables, SessionVariablesInput, useExecutionArtifacts, useArtifactContent, useArtifactDownloadUrl, useArtifactDownload, useArtifactCopy, useToolOutputContent, useFileChangeContent, execIdFromStorageKey, useWorkspaceWriteBacks, WriteBackCard, FileChangesView, FileChangeDiff, EmptyChangeNotice, isTextArtifact, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./execution/index.js";
+export type { CreateAgentExecutionInput, CreateAgentExecutionResult, UseCreateAgentExecutionReturn, UseExecutionStreamReturn, UseAgentExecutionActionsOptions, UseAgentExecutionActionsReturn, UseSubmitApprovalReturn, UseFileReviewReturn, FileDecisionOptions, FileReviewability, FileBlockReason, ChangeSetReviewability, FileReviewRowState, ExecutionPhaseBadgeProps, InteractionModeBadgeProps, SetupProgressProps, ExecutionProgressProps, TodoListProps, TodoCardProps, UsageWidgetProps, ContextGaugeProps, SummarizationBadgeProps, SummarizationCardProps, PlanCompletionCardProps, PlanArtifactCardProps, PlanStreamingCardProps, PlanDocumentMessageProps, ContextHealth, SummarizationEventView, UseContextWindowReturn, ToolCallGroupProps, ToolCallDetailProps, ResultViewProps, TerminalSessionProps, ToolPresentation, ToolPresenter, ToolDisclosure, McpToolDetailProps, McpArgsViewProps, McpMetadataRowProps, ToolArgsViewProps, ToolCallItemProps, SubAgentSectionProps, MessageEntryProps, MessageThreadProps, ThreadContentColumn, ThreadSkeletonProps, FollowUpInputProps, ApprovalCardProps, ApprovalCardHeaderProps, ApprovalCardBodyProps, FileReviewCardProps, FileReviewDockProps, FileChangeProgressBarProps, ApprovalContextValue, UseApprovalResult, FileReviewContextValue, ArtifactCardProps, ArtifactContentRendererProps, ArtifactRenderMode, ArtifactPreviewContentProps, ArtifactPreviewModalProps, ArtifactsWidgetProps, WriteBacksWidgetProps, FilePathLinkProps, FilePathContextValue, PathClassification, ResolvedPathAction, SessionVariableEntry, UseSessionVariablesReturn, SessionVariablesInputProps, UseExecutionArtifactsReturn, UseArtifactContentReturn, UseArtifactDownloadUrlReturn, UseArtifactDownloadUrlOptions, UseArtifactDownloadReturn, UseArtifactCopyReturn, UseToolOutputContentReturn, ToolOutputRefLike, UseFileChangeContentReturn, UseWorkspaceWriteBacksReturn, WriteBackCardProps, FileChangesViewProps, FileChangeDiffProps, EmptyChangeNoticeProps, EmptyChangeKind, } from "./execution/index.js";
 export type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
 export { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 export { useAttachments, AttachmentChipList, MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment/index.js";
@@ -34,7 +34,7 @@ export { useMcpServer, useMcpServerCount, useMcpServerList, useMcpServerSearch,
 export type { UseMcpServerReturn, UseMcpServerCountOptions, UseMcpServerCountReturn, UseMcpServerListOptions, UseMcpServerListReturn, UseMcpServerSearchOptions, UseMcpServerSearchReturn, UseMcpServerSetupReturn, SubmitMcpEnvVarsOptions, McpServerSetupEntry, McpServerSetupPhase, McpServerSetupState, McpServerPickerProps, McpServerSetupIntegration, McpServerConfigPanelProps, McpServerCredentialsProps, McpServerOAuthSignInProps, McpServerDetailViewProps, McpServerConnectDialogProps, CapabilityTab, McpToolSelectorProps, UseMcpServerConnectReturn, UseMcpServerOAuthConnectReturn, OAuthConnectPhase, OAuthCallbackHandlerProps, OAuthCallbackParams, UseMcpServerCredentialsReturn, UseOAuthGrantStatusReturn, UseDisconnectOAuthReturn, McpServerAuthMode, UseCreateMcpServerReturn, UseUpdateMcpServerReturn, McpServerCreationWizardProps, McpServerCreationResult, McpServerWizardData, } from "./mcp-server/index.js";
 export { useSkill, useSkillCount, useSkillList, useSkillSearch, SkillPicker, SkillDetailView, usePushSkill, useSkillUpload, useSkillArtifact, useSkillVersions, useSkillDiff, useSkillDuplicateCheck, SkillUploader, SkillFileBrowser, SkillDiffDialog, } from "./skill/index.js";
 export type { UseSkillReturn, UseSkillCountOptions, UseSkillCountReturn, UseSkillListOptions, UseSkillListReturn, UseSkillSearchOptions, UseSkillSearchReturn, SkillPickerProps, SkillDetailViewProps, PushSkillInput, UsePushSkillReturn, SkillUploadPreview, SkillFileEntry, UseSkillUploadReturn, UseSkillArtifactReturn, UseSkillVersionsReturn, UseSkillDiffReturn, UseSkillDuplicateCheckReturn, SkillDiffDialogProps, SkillDiffDialogState, SkillUploaderProps, SkillFileBrowserProps, } from "./skill/index.js";
-export { useGitHubConnection, useGitHubRepos, useGitHubSearch, useGitHubTreeLister, parseGitUrl, GitHubRepoPicker, GITHUB_CALLBACK_MESSAGE_TYPE, } from "./github/index.js";
+export { useGitHubConnection, useGitHubRepos, useGitHubSearch, useGitHubTreeLister, useGitHubFileReader, parseGitUrl, GitHubRepoPicker, GITHUB_CALLBACK_MESSAGE_TYPE, } from "./github/index.js";
 export type { GitHubUser, GitHubConnectOptions, UseGitHubConnectionConfig, UseGitHubConnectionReturn, GitHubRepo, GitHubBranch, UseGitHubReposReturn, UseGitHubSearchReturn, GitHubRepoPickerProps, ParsedGitRepo, } from "./github/index.js";
 export { useAgent, useAgentCount, useAgentList, useAgentSearch, AgentPicker, AgentDetailView, AgentEnvForm, diffEnv, useAgentSetup, useDefaultAgent, useCreateAgent, useUpdateAgent, agentToInput, AgentCreationWizard, } from "./agent/index.js";
 export type { UseAgentReturn, UseAgentCountOptions, UseAgentCountReturn, UseAgentListOptions, UseAgentListReturn, UseAgentSearchOptions, UseAgentSearchReturn, AgentPickerProps, AgentDetailViewProps, AgentEnvFormProps, AgentEnvFormSubmitOptions, AgentEnvFormVariable, AgentSetupResult, AgentSetupReadyResult, AgentSetupState, AgentSetupPhase, AgentResolution, SubmitEnvVarsOptions, UseAgentSetupReturn, UseDefaultAgentReturn, UseCreateAgentReturn, UseUpdateAgentReturn, AgentCreationWizardProps, AgentCreationResult, AgentWizardData, } from "./agent/index.js";
@@ -76,8 +76,8 @@ export { useOrgInvitations, useCreateInvitation, useRevokeInvitation, useInvitat
 export type { UseOrgInvitationsReturn, UseCreateInvitationReturn, UseRevokeInvitationReturn, UseInvitationPreviewReturn, UseRedeemInvitationReturn, InvitationCreatedAlertProps, InvitationManagerProps, InvitationRedemptionProps, } from "./invitation/index.js";
 export { ErrorMessage, SecretFlowErrorGuide, isSecretFlowError } from "./error/index.js";
 export type { ErrorMessageProps, SecretFlowErrorGuideProps } from "./error/index.js";
-export { LibraryBreadcrumbProvider, useBreadcrumbLabel, useBreadcrumbOverride, ScopeToggle, ResourceCountCard, detectStigmerResource, useDetectStigmerResource, isSkillPackage, detectSkillPackage, useDetectSkillPackage, isPlanArtifact, findPlanArtifact, parseResourceYaml, serializeAgentYaml, serializeMcpServerYaml, serializeAgentInputYaml, serializeMcpServerInputYaml, useApplyResource, useExportResource, useImportResource, ImportResourceDialog, VisibilitySelector, VisibilityBadge, blueprintVisibilityLevels, INSTANCE_VISIBILITY_LEVELS, visibilityLabel, useUpdateVisibility, } from "./library/index.js";
-export type { ScopeToggleProps, ResourceCountCardProps, StigmerResourceKind, StigmerResourceDetection, SkillPackageDetection, UseDetectSkillPackageReturn, ParsedResource, UseApplyResourceReturn, ApplyResourceResult, PushSkillParams, UseExportResourceOptions, UseExportResourceReturn, ImportFormat, ImportPreview, UseImportResourceReturn, ImportResourceDialogProps, VisibilitySelectorProps, VisibilityLevelOption, BlueprintVisibilityLevelsContext, VisibilityResourceKind, UseUpdateVisibilityReturn, } from "./library/index.js";
+export { LibraryBreadcrumbProvider, useBreadcrumbLabel, useBreadcrumbOverride, ScopeToggle, ResourceCountCard, detectStigmerResource, useDetectStigmerResource, isSkillPackage, detectSkillPackage, useDetectSkillPackage, isPlanArtifact, isPlanArtifactName, findPlanArtifact, findLatestSessionPlan, findStreamingPlan, PLAN_ARTIFACT_NAME, PLAN_ARTIFACT_SUFFIX, parseResourceYaml, serializeAgentYaml, serializeMcpServerYaml, serializeAgentInputYaml, serializeMcpServerInputYaml, useApplyResource, useExportResource, useImportResource, ImportResourceDialog, VisibilitySelector, VisibilityBadge, blueprintVisibilityLevels, INSTANCE_VISIBILITY_LEVELS, visibilityLabel, useUpdateVisibility, } from "./library/index.js";
+export type { ScopeToggleProps, ResourceCountCardProps, StigmerResourceKind, StigmerResourceDetection, SkillPackageDetection, SessionPlan, StreamingPlan, UseDetectSkillPackageReturn, ParsedResource, UseApplyResourceReturn, ApplyResourceResult, PushSkillParams, UseExportResourceOptions, UseExportResourceReturn, ImportFormat, ImportPreview, UseImportResourceReturn, ImportResourceDialogProps, VisibilitySelectorProps, VisibilityLevelOption, BlueprintVisibilityLevelsContext, VisibilityResourceKind, UseUpdateVisibilityReturn, } from "./library/index.js";
 export { ActionMenu } from "./action-menu/index.js";
 export type { ActionMenuProps, ActionMenuTriggerProps, ActionMenuContentProps, ActionMenuItemProps, ActionMenuSeparatorProps, ActionMenuGroupProps, } from "./action-menu/index.js";
 export { StigmerToaster, toast } from "./feedback/index.js";