@stigmer/react 3.0.9-dev.20260616060535 → 3.1.1

package/execution/useArtifactDownload.js

@@ -0,0 +1,80 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactDownloadUrlRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that downloads an execution artifact on demand.
+ *
+ * Mirrors the click → mint fresh URL → browser download flow established by
+ * `WorkflowExecutionArtifactPanel`, generalized so every artifact "Download"
+ * affordance shares one implementation. The URL is minted at click time from
+ * the stable `storageKey` via `getArtifactDownloadUrl`, so it is always valid —
+ * unlike the previously persisted, short-lived URL that expired after an hour.
+ *
+ * Returns an imperative `download(storageKey, fileName?)` action rather than a
+ * URL, because a download is a user action, not render data. For rendering an
+ * image or showing a link, use {@link useArtifactDownloadUrl} instead.
+ *
+ * @param executionId - Execution that produced the artifacts, or `null` to
+ *   disable (the action becomes a no-op).
+ *
+ * @example
+ * ```tsx
+ * const { download, isDownloading } = useArtifactDownload(executionId);
+ * <button onClick={() => download(artifact.storageKey, artifact.name)} disabled={isDownloading}>
+ *   Download
+ * </button>
+ * ```
+ *
+ * @see useArtifactDownloadUrl — declarative URL resolver (image src, links)
+ */
+export function useArtifactDownload(executionId) {
+    const stigmer = useStigmer();
+    const [isDownloading, setIsDownloading] = useState(false);
+    const [error, setError] = useState(null);
+    const download = useCallback(async (storageKey, fileName) => {
+        if (!executionId || !storageKey || isDownloading)
+            return;
+        setIsDownloading(true);
+        setError(null);
+        try {
+            const result = await stigmer.agentExecution.getArtifactDownloadUrl(create(GetArtifactDownloadUrlRequestSchema, { executionId, storageKey }));
+            if (result.downloadUrl) {
+                triggerBrowserDownload(result.downloadUrl, fileName);
+            }
+        }
+        catch (err) {
+            setError(toError(err));
+        }
+        finally {
+            setIsDownloading(false);
+        }
+    }, [executionId, stigmer, isDownloading]);
+    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.
+ */
+function triggerBrowserDownload(url, fileName) {
+    if (typeof document === "undefined") {
+        if (typeof window !== "undefined") {
+            window.open(url, "_blank", "noopener,noreferrer");
+        }
+        return;
+    }
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    if (fileName)
+        anchor.download = fileName;
+    anchor.rel = "noopener noreferrer";
+    anchor.target = "_blank";
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+}
+//# sourceMappingURL=useArtifactDownload.js.map

package/execution/useArtifactDownload.js.map

@@ -0,0 +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"}

package/execution/useArtifactDownloadUrl.d.ts

@@ -0,0 +1,67 @@
+/** Return value of {@link useArtifactDownloadUrl}. */
+export interface UseArtifactDownloadUrlReturn {
+    /**
+     * A freshly minted presigned download URL for the artifact, or `null` when:
+     * - Fetching is skipped (`enabled` is `false`, or `executionId`/`storageKey` is `null`)
+     * - The request is in-flight
+     * - The request failed
+     */
+    readonly url: string | null;
+    /** `true` while the URL request is in-flight (first load). */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Re-fetch the URL (e.g. to mint a fresh one after the previous expired). */
+    readonly refetch: () => void;
+}
+/** Options for {@link useArtifactDownloadUrl}. */
+export interface UseArtifactDownloadUrlOptions {
+    /**
+     * Gate the request. When `false`, the hook stays idle and returns `null` —
+     * use this to defer minting a URL until it is actually needed (e.g. only
+     * when an image becomes visible, or after a truncation is detected).
+     * Defaults to `true`.
+     */
+    readonly enabled?: boolean;
+}
+/**
+ * Data hook that resolves a **fresh** presigned download URL for an execution
+ * artifact on demand via `stigmer.agentExecution.getArtifactDownloadUrl()`.
+ *
+ * This exists because presigned URLs expire. The runner once baked a
+ * short-lived URL into the persisted execution status and the UI rendered it
+ * verbatim — so any link opened after the URL's lifetime failed with
+ * `ExpiredRequest`. Minting the URL at view time from the stable `storageKey`
+ * guarantees it is always valid, and works for every historical execution
+ * (the `storageKey` never expires).
+ *
+ * Use this for surfaces that genuinely need a URL — an `<img src>` for an
+ * offloaded screenshot, or a direct browser download of a large/binary
+ * artifact. For text that should render in-app, prefer {@link useArtifactContent}
+ * (CORS-safe, no presign).
+ *
+ * The URL is cached cross-mount by `storageKey` (DD-014), so repeated renders
+ * and remounts reuse the same minted URL instead of re-hitting the API.
+ *
+ * Pass `enabled: false` (or `null` for either id) to skip fetching — consistent
+ * with the `useArtifactContent(null, null)` convention.
+ *
+ * @param executionId - Execution that produced the artifact, or `null` to skip.
+ * @param storageKey - Storage key from the artifact/output ref, or `null` to skip.
+ * @param options - Optional gating (`enabled`).
+ *
+ * @example
+ * ```tsx
+ * // Render an offloaded screenshot with an always-fresh URL.
+ * const { url, isLoading } = useArtifactDownloadUrl(executionId, storageKey);
+ * if (isLoading) return <Skeleton />;
+ * return url ? <img src={url} alt="Tool output" /> : null;
+ * ```
+ *
+ * @see useArtifactContent — reads artifact bytes through the API (text preview)
+ * @see useArtifactDownload — imperative click-to-download counterpart
+ */
+export declare function useArtifactDownloadUrl(executionId: string | null, storageKey: string | null, options?: UseArtifactDownloadUrlOptions): UseArtifactDownloadUrlReturn;
+//# sourceMappingURL=useArtifactDownloadUrl.d.ts.map

package/execution/useArtifactDownloadUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArtifactDownloadUrl.d.ts","sourceRoot":"","sources":["../../src/execution/useArtifactDownloadUrl.ts"],"names":[],"mappings":"AAQA,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAQD,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,CAAC,EAAE,6BAA6B,GACtC,4BAA4B,CA0B9B"}

package/execution/useArtifactDownloadUrl.js

@@ -0,0 +1,59 @@
+"use client";
+import { useMemo } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactDownloadUrlRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+const EMPTY = { url: null };
+/**
+ * Data hook that resolves a **fresh** presigned download URL for an execution
+ * artifact on demand via `stigmer.agentExecution.getArtifactDownloadUrl()`.
+ *
+ * This exists because presigned URLs expire. The runner once baked a
+ * short-lived URL into the persisted execution status and the UI rendered it
+ * verbatim — so any link opened after the URL's lifetime failed with
+ * `ExpiredRequest`. Minting the URL at view time from the stable `storageKey`
+ * guarantees it is always valid, and works for every historical execution
+ * (the `storageKey` never expires).
+ *
+ * Use this for surfaces that genuinely need a URL — an `<img src>` for an
+ * offloaded screenshot, or a direct browser download of a large/binary
+ * artifact. For text that should render in-app, prefer {@link useArtifactContent}
+ * (CORS-safe, no presign).
+ *
+ * The URL is cached cross-mount by `storageKey` (DD-014), so repeated renders
+ * and remounts reuse the same minted URL instead of re-hitting the API.
+ *
+ * Pass `enabled: false` (or `null` for either id) to skip fetching — consistent
+ * with the `useArtifactContent(null, null)` convention.
+ *
+ * @param executionId - Execution that produced the artifact, or `null` to skip.
+ * @param storageKey - Storage key from the artifact/output ref, or `null` to skip.
+ * @param options - Optional gating (`enabled`).
+ *
+ * @example
+ * ```tsx
+ * // Render an offloaded screenshot with an always-fresh URL.
+ * const { url, isLoading } = useArtifactDownloadUrl(executionId, storageKey);
+ * if (isLoading) return <Skeleton />;
+ * return url ? <img src={url} alt="Tool output" /> : null;
+ * ```
+ *
+ * @see useArtifactContent — reads artifact bytes through the API (text preview)
+ * @see useArtifactDownload — imperative click-to-download counterpart
+ */
+export function useArtifactDownloadUrl(executionId, storageKey, options) {
+    const stigmer = useStigmer();
+    const enabled = options?.enabled ?? true;
+    const active = enabled && !!executionId && !!storageKey;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(active
+        ? () => stigmer.agentExecution
+            .getArtifactDownloadUrl(create(GetArtifactDownloadUrlRequestSchema, {
+            executionId: executionId,
+            storageKey: storageKey,
+        }))
+            .then((result) => ({ url: result.downloadUrl || null }))
+        : null, [executionId, storageKey, active, stigmer], EMPTY, { cacheKey: storageKey ? `artifact-url:${storageKey}` : undefined });
+    return useMemo(() => ({ url: data.url, isLoading, isRefetching, error, refetch }), [data.url, isLoading, isRefetching, error, refetch]);
+}
+//# sourceMappingURL=useArtifactDownloadUrl.js.map

package/execution/useArtifactDownloadUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArtifactDownloadUrl.js","sourceRoot":"","sources":["../../src/execution/useArtifactDownloadUrl.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,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,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA6BnD,MAAM,KAAK,GAAY,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA0B,EAC1B,UAAyB,EACzB,OAAuC;IAEvC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC;IAExD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAChE,MAAM;QACJ,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,cAAc;aACnB,sBAAsB,CACrB,MAAM,CAAC,mCAAmC,EAAE;YAC1C,WAAW,EAAE,WAAY;YACzB,UAAU,EAAE,UAAW;SACxB,CAAC,CACH;aACA,IAAI,CAAC,CAAC,MAAM,EAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,IAAI,EACR,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAC1C,KAAK,EACL,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CACpE,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAClE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CACpD,CAAC;AACJ,CAAC"}

package/execution/useCreateAgentExecution.js

@@ -1,8 +1,8 @@
 "use client";
 import { useCallback, useState } from "react";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
-import { toProtoInteractionMode } from "../composer/interaction-mode";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+import { toProtoInteractionMode } from "../composer/interaction-mode.js";
 /**
  * Behavior hook that wraps `agentExecution.create()` with loading/error
  * state.

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,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAoGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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":"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"}

package/execution/useExecutionStream.d.ts

@@ -1,7 +1,7 @@
 import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import { type BackoffOptions } from "../internal/backoff";
-import { ConversationStore } from "../internal/store";
+import { type BackoffOptions } from "../internal/backoff.js";
+import { ConversationStore } from "../internal/store/index.js";
 /** Return value of {@link useExecutionStream}. */
 export interface UseExecutionStreamReturn {
     /** Latest full execution snapshot from the stream, or `null` before the first update arrives. */

package/execution/useExecutionStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionStream.d.ts","sourceRoot":"","sources":["../../src/execution/useExecutionStream.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAW9F,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,cAAc,GAAG;QAC3C,wDAAwD;QACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,wBAAwB,CA8P1B"}
+{"version":3,"file":"useExecutionStream.d.ts","sourceRoot":"","sources":["../../src/execution/useExecutionStream.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAW9F,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,cAAc,GAAG;QAC3C,wDAAwD;QACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,wBAAwB,CA8P1B"}

package/execution/useExecutionStream.js

@@ -2,13 +2,13 @@
 import { startTransition, useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore, } from "react";
 import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { isTransientStreamError } from "@stigmer/sdk";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
-import { useStreamRate } from "../internal/dev";
-import { StreamController, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_SLOW_THRESHOLD_MS, } from "../internal/stream-controller";
-import { computeBackoffDelay, sleep, DEFAULT_RECONNECT_MAX_ATTEMPTS, } from "../internal/backoff";
-import { ConversationStore } from "../internal/store";
-import { isTerminalPhase } from "./execution-phases";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+import { useStreamRate } from "../internal/dev/index.js";
+import { StreamController, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_SLOW_THRESHOLD_MS, } from "../internal/stream-controller.js";
+import { computeBackoffDelay, sleep, DEFAULT_RECONNECT_MAX_ATTEMPTS, } from "../internal/backoff.js";
+import { ConversationStore } from "../internal/store/index.js";
+import { isTerminalPhase } from "./execution-phases.js";
 /**
  * Behavior hook that subscribes to real-time {@link AgentExecution}
  * updates via `stigmer.agentExecution.subscribe()`.

package/execution/useExecutionStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionStream.js","sourceRoot":"","sources":["../../src/execution/useExecutionStream.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,eAAe,EACf,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,EACR,oBAAoB,GACrB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,KAAK,EACL,8BAA8B,GAE/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA2GrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA0B,EAC1B,OAAmC;IAEnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,4EAA4E;IAC5E,iEAAiE;IACjE,iEAAiE;IACjE,qBAAqB;IACrB,MAAM,gBAAgB,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QACjD,gBAAgB,CAAC,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,gBAAgB,CAAC,OAAQ,CAAC;IAE1D,4EAA4E;IAC5E,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEhD,8EAA8E;IAC9E,8EAA8E;IAC9E,0EAA0E;IAC1E,6EAA6E;IAC7E,uEAAuE;IACvE,2DAA2D;IAC3D,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,4EAA4E;IAC5E,MAAM,aAAa,GAAG,MAAM,CAA0B,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAyB;YACjC,cAAc,CAAC,QAAQ;gBACrB,eAAe,CAAC,GAAG,EAAE;oBACnB,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;YACL,CAAC;YACD,cAAc,CAAC,KAAK;gBAClB,eAAe,CAAC,GAAG,EAAE;oBACnB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC,CAAC,CAAC;YACL,CAAC;YACD,gBAAgB;gBACd,IAAI,qBAAqB,CAAC,OAAO,EAAE,CAAC;oBAClC,oEAAoE;oBACpE,kEAAkE;oBAClE,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,iEAAiE;oBACjE,oEAAoE;oBACpE,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC;oBACrC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,OAAO,CAAC,KAAK;gBACX,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;SACF,CAAC;QACF,aAAa,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE;YACvE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,0BAA0B;YACzE,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,yBAAyB;SACvE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC;IAEzC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,wEAAwE;QACxE,kEAAkE;QAClE,qBAAqB,CAAC,OAAO,GAAG,KAAK,CAAC;QACtC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,4EAA4E;IAC5E,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IAEnC,+EAA+E;IAC/E,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC;IACrD,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAExD,2EAA2E;IAC3E,6EAA6E;IAC7E,sEAAsE;IACtE,MAAM,kBAAkB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEvD,4EAA4E;IAC5E,0EAA0E;IAC1E,qEAAqE;IACrE,6EAA6E;IAC7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;YAClC,qBAAqB,CAAC,OAAO,GAAG,KAAK,CAAC;YACtC,OAAO;QACT,CAAC;QAED,0EAA0E;QAC1E,sEAAsE;QACtE,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,IACE,kBAAkB,CAAC,OAAO,KAAK,IAAI;YACnC,kBAAkB,CAAC,OAAO,KAAK,WAAW,EAC1C,CAAC;YACD,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,sEAAsE;YACtE,uEAAuE;YACvE,qBAAqB,CAAC,OAAO,GAAG,KAAK,CAAC;QACxC,CAAC;QACD,kBAAkB,CAAC,OAAO,GAAG,WAAW,CAAC;QAEzC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;QACtC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE9B,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GACtD,SAAS,CAAC,OAAO,CAAC;YACpB,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,8BAA8B,CAAC;YAE3E,kEAAkE;YAClE,oEAAoE;YACpE,qEAAqE;YACrE,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,sEAAsE;YACtE,oEAAoE;YACpE,gEAAgE;YAChE,uEAAuE;YACvE,MAAM,aAAa,GAAG,KAAK,EAAE,KAAY,EAAoB,EAAE;gBAC7D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;oBACpC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;oBAC9B,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,IAAI,CAAC,CAAC;gBACb,UAAU,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC9C,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC7D,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC,CAAC,sBAAsB;gBACtC,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACzB,CAAC,CAAC;YAEF,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,IAAI,WAAW,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC;oBACH,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,SAAS,CAC3D,WAAW,EACX,MAAM,CACP,EAAE,CAAC;wBACF,IAAI,MAAM,CAAC,OAAO;4BAAE,OAAO;wBAE3B,OAAO,GAAG,CAAC,CAAC,CAAC,8CAA8C;wBAC3D,mEAAmE;wBACnE,mEAAmE;wBACnE,yCAAyC;wBACzC,qBAAqB,CAAC,OAAO,GAAG,KAAK,CAAC;wBACtC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;wBAChC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;wBACpC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;wBAEnE,MAAM,KAAK,GACT,QAAQ,CAAC,MAAM,EAAE,KAAK;4BACtB,cAAc,CAAC,2BAA2B,CAAC;wBAC7C,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC3B,WAAW,GAAG,IAAI,CAAC;4BACnB,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,MAAM,CAAC,OAAO;wBAAE,OAAO;oBAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC3B,mEAAmE;oBACnE,gEAAgE;oBAChE,kEAAkE;oBAClE,IAAI,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC5C,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;wBAC9B,OAAO;oBACT,CAAC;oBACD,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC;wBAAE,SAAS;oBACzC,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO;gBAE3B,IAAI,WAAW,EAAE,CAAC;oBAChB,+DAA+D;oBAC/D,mEAAmE;oBACnE,4CAA4C;oBAC5C,UAAU,CAAC,eAAe,EAAE,CAAC;oBAC7B,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBAChC,OAAO;gBACT,CAAC;gBAED,sEAAsE;gBACtE,iEAAiE;gBACjE,qEAAqE;gBACrE,oEAAoE;gBACpE,4CAA4C;gBAC5C,IAAI,MAAM,aAAa,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,EAAE,CAAC;oBACtE,SAAS;gBACX,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,eAAe,CAAC,KAAK,EAAE,CAAC;YACxB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAEvC,6EAA6E;IAC7E,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,oBAAoB,CACtC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,cAAc,CACrB,CAAC;IACF,MAAM,eAAe,GAAG,oBAAoB,CAC1C,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,kBAAkB,CACzB,CAAC;IACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEpE,4EAA4E;IAC5E,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,cAAc,CAAC,2BAA2B,EACxE,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,KAAK,WAAW,CAAC;IACtD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,KAAK,YAAY,CAAC;IACxD,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,KAAK,cAAc,CAAC;IAC5D,MAAM,gBAAgB,GACpB,WAAW,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvE,OAAO;QACL,SAAS;QACT,KAAK;QACL,WAAW;QACX,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,KAAK;QACL,eAAe;QACf,MAAM;QACN,SAAS;KACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useExecutionStream.js","sourceRoot":"","sources":["../../src/execution/useExecutionStream.ts"],"names":[],"mappings":"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"}

package/execution/useFileChangeContent.d.ts

@@ -0,0 +1,61 @@
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+/** Return value of {@link useFileChangeContent}. */
+export interface UseFileChangeContentReturn {
+    /**
+     * Before-side text for diffing. `""` for an absent side (e.g. CREATE has no
+     * before). `null` while an offloaded side is in-flight or failed to load.
+     */
+    readonly beforeText: string | null;
+    /**
+     * After-side text for diffing. `""` for an absent side (e.g. DELETE has no
+     * after). `null` while an offloaded side is in-flight or failed to load.
+     */
+    readonly afterText: string | null;
+    /** `true` when either side is binary — render "binary file changed", not a diff. */
+    readonly isBinary: boolean;
+    /** `true` while an offloaded side's content request is in flight. */
+    readonly isLoading: boolean;
+    /** Error from a failed offloaded-side fetch, or `null`. */
+    readonly error: Error | null;
+    /**
+     * `true` when an offloaded side exceeded the server's content-size limit and
+     * was truncated — the inline diff would be incomplete; offer {@link downloadUrl}.
+     */
+    readonly isTruncated: boolean;
+    /**
+     * Direct download URL for an offloaded side (the after side preferred), used
+     * as the fallback when content is truncated. `null` when neither side is offloaded.
+     */
+    readonly downloadUrl: string | null;
+}
+/**
+ * Behavior hook that resolves a {@link FileChange}'s before/after sides to the
+ * text the diff renderer needs.
+ *
+ * Small bodies are carried inline on the proto and returned with zero cost.
+ * Large bodies were offloaded to artifact storage by the runner
+ * (`FileContent.ref`); this hook lazily fetches them via
+ * {@link useArtifactContent} through the server proxy (CORS-safe). The fetch's
+ * `executionId` is derived from the ref's own `storageKey`
+ * (`artifacts/{executionId}/...`), so a net diff whose two sides originated in
+ * different executions still resolves each side correctly.
+ *
+ * This is the single place offload refs are dereferenced — the SDK's
+ * `tool-view` deliberately stays fetch-free, deferring all ref handling here.
+ *
+ * Rules-of-hooks safe: both sides always issue a (possibly skipped)
+ * `useArtifactContent` call; inline/absent sides pass `null` and never fetch.
+ *
+ * @param change - The file change whose content to resolve.
+ *
+ * @see useSessionFileChanges — produces the changes this resolves
+ * @see FileChangeDiff — renders the resolved content
+ */
+export declare function useFileChangeContent(change: FileChange): UseFileChangeContentReturn;
+/**
+ * Extracts the execution id from an artifact storage key of the form
+ * `artifacts/{executionId}/...`. Returns `null` for an unexpected shape so the
+ * caller skips the fetch rather than issuing a request the server would reject.
+ */
+export declare function execIdFromStorageKey(storageKey: string): string | null;
+//# sourceMappingURL=useFileChangeContent.d.ts.map

package/execution/useFileChangeContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileChangeContent.d.ts","sourceRoot":"","sources":["../../src/execution/useFileChangeContent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,iEAAiE,CAAC;AAIzE,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,GACjB,0BAA0B,CAmD5B;AAqBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE"}

package/execution/useFileChangeContent.js

@@ -0,0 +1,89 @@
+"use client";
+import { useMemo } from "react";
+import { useArtifactContent } from "./useArtifactContent.js";
+import { useArtifactDownloadUrl } from "./useArtifactDownloadUrl.js";
+/**
+ * Behavior hook that resolves a {@link FileChange}'s before/after sides to the
+ * text the diff renderer needs.
+ *
+ * Small bodies are carried inline on the proto and returned with zero cost.
+ * Large bodies were offloaded to artifact storage by the runner
+ * (`FileContent.ref`); this hook lazily fetches them via
+ * {@link useArtifactContent} through the server proxy (CORS-safe). The fetch's
+ * `executionId` is derived from the ref's own `storageKey`
+ * (`artifacts/{executionId}/...`), so a net diff whose two sides originated in
+ * different executions still resolves each side correctly.
+ *
+ * This is the single place offload refs are dereferenced — the SDK's
+ * `tool-view` deliberately stays fetch-free, deferring all ref handling here.
+ *
+ * Rules-of-hooks safe: both sides always issue a (possibly skipped)
+ * `useArtifactContent` call; inline/absent sides pass `null` and never fetch.
+ *
+ * @param change - The file change whose content to resolve.
+ *
+ * @see useSessionFileChanges — produces the changes this resolves
+ * @see FileChangeDiff — renders the resolved content
+ */
+export function useFileChangeContent(change) {
+    const beforeRef = refOf(change.before);
+    const afterRef = refOf(change.after);
+    const beforeFetch = useArtifactContent(beforeRef ? execIdFromStorageKey(beforeRef.storageKey) : null, beforeRef ? beforeRef.storageKey : null, null, beforeRef?.contentHash);
+    const afterFetch = useArtifactContent(afterRef ? execIdFromStorageKey(afterRef.storageKey) : null, afterRef ? afterRef.storageKey : null, null, afterRef?.contentHash);
+    // The download fallback is needed only when an offloaded side was truncated.
+    // Resolve a fresh URL on demand from the stable storageKey (after side
+    // preferred), gated on truncation so we don't mint a URL we won't use.
+    const isTruncated = beforeFetch.isTruncated || afterFetch.isTruncated;
+    const downloadRef = afterRef ?? beforeRef;
+    const { url: downloadUrl } = useArtifactDownloadUrl(downloadRef ? execIdFromStorageKey(downloadRef.storageKey) : null, downloadRef ? downloadRef.storageKey : null, { enabled: isTruncated });
+    return useMemo(() => ({
+        beforeText: sideText(change.before, beforeFetch.content),
+        afterText: sideText(change.after, afterFetch.content),
+        isBinary: Boolean(change.before?.isBinary || change.after?.isBinary),
+        isLoading: beforeFetch.isLoading || afterFetch.isLoading,
+        error: beforeFetch.error ?? afterFetch.error,
+        isTruncated,
+        downloadUrl,
+    }), [
+        change.before,
+        change.after,
+        beforeFetch.content,
+        afterFetch.content,
+        beforeFetch.isLoading,
+        afterFetch.isLoading,
+        beforeFetch.error,
+        afterFetch.error,
+        isTruncated,
+        downloadUrl,
+    ]);
+}
+/** The offload pointer of a side, or null when the side is absent/inline/binary. */
+function refOf(side) {
+    if (!side || side.isBinary)
+        return null;
+    return side.body.case === "ref" ? side.body.value : null;
+}
+/**
+ * Resolves one side to text: absent → "" (empty file), inline → its value,
+ * offloaded → the fetched content (`null` until it loads).
+ */
+function sideText(side, fetched) {
+    if (!side || side.isBinary)
+        return "";
+    if (side.body.case === "inline")
+        return side.body.value;
+    return fetched;
+}
+/**
+ * Extracts the execution id from an artifact storage key of the form
+ * `artifacts/{executionId}/...`. Returns `null` for an unexpected shape so the
+ * caller skips the fetch rather than issuing a request the server would reject.
+ */
+export function execIdFromStorageKey(storageKey) {
+    const parts = storageKey.split("/");
+    if (parts.length >= 3 && parts[0] === "artifacts" && parts[1]) {
+        return parts[1];
+    }
+    return null;
+}
+//# sourceMappingURL=useFileChangeContent.js.map

package/execution/useFileChangeContent.js.map

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

package/execution/useFileReview.d.ts

@@ -0,0 +1,89 @@
+import { FileDecisionAction, FileDecisionScope } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/** Options narrowing a file decision to a single file and binding its digest. */
+export interface FileDecisionOptions {
+    /**
+     * Decision scope. Defaults to `FILE` when {@link fileChangeId} is set, else
+     * `CHANGE_SET` (the whole-set decision that covers every file).
+     */
+    readonly scope?: FileDecisionScope;
+    /** The captured file this decision targets; required for `FILE` scope. */
+    readonly fileChangeId?: string;
+    /**
+     * The digest the reviewer saw (`aggregate_digest` for CHANGE_SET,
+     * `file_digest` for FILE). The server enforces it at decision time and the
+     * runner re-verifies it at reconcile — "what you approve is what gets applied".
+     */
+    readonly expectedDigest?: string;
+    /** Optional free-text comment recorded on the decision (audit trail). */
+    readonly reason?: string;
+    /**
+     * Set on an APPROVE to consciously KEEP a change whose diff could not be fully
+     * reviewed. Honored only for a binary file at `FILE` scope (a binary has no
+     * text diff, but its exact bytes are captured and reconcilable). It never
+     * relaxes the digest gate, and is ignored for other incompleteness. See DD-16.
+     */
+    readonly acknowledgeUnreviewable?: boolean;
+}
+/** Return value of {@link useFileReview}. */
+export interface UseFileReviewReturn {
+    /**
+     * Submit an approve/reject decision for a change set (or one file within it).
+     * Resolves when the backend accepts the decision; the execution stream will
+     * deliver the updated `file_change_sets` projection.
+     */
+    readonly submitFileDecision: (executionId: string, changeSetId: string, action: FileDecisionAction, options?: FileDecisionOptions) => Promise<void>;
+    /**
+     * Keys (`changeSetId` for a whole-set decision, `changeSetId:fileChangeId` for
+     * a per-file one) currently being submitted — drives per-button loading state
+     * when a reviewer decides files independently. Build a key with
+     * {@link fileDecisionKey}.
+     */
+    readonly submittingDecisionKeys: ReadonlySet<string>;
+    /**
+     * Per-decision failures, keyed exactly like {@link submittingDecisionKeys}
+     * (via {@link fileDecisionKey}). This is the per-target parallel of the
+     * in-flight Set: a review card has many decision targets (the whole set plus
+     * each file), so a failure must be attributable to the *one* control that
+     * failed — a single scalar cannot say which file. {@link FileReviewCard}
+     * consumes this map to render the error in-card, beside the failed control.
+     */
+    readonly decisionErrors: ReadonlyMap<string, Error>;
+    /** Clear the error for one decision key (e.g. before a retry of that target). */
+    readonly clearDecisionError: (key: string) => void;
+    /**
+     * The most-recent decision failure, or `null` when healthy — a convenience
+     * mirror of {@link decisionErrors} for a headless consumer that wants a single
+     * error value (a banner). The map is authoritative for per-control surfacing.
+     */
+    readonly error: Error | null;
+    /** Reset every decision error (both {@link decisionErrors} and {@link error}). */
+    readonly clearError: () => void;
+}
+/**
+ * The loading-state key for a file decision: the change set id for a whole-set
+ * (CHANGE_SET) decision, or `changeSetId:fileChangeId` for a per-file one.
+ */
+export declare function fileDecisionKey(changeSetId: string, fileChangeId?: string): string;
+/**
+ * Behavior hook that wraps `agentExecution.submitFileDecision()` with per-decision
+ * loading state and error management — the file-review sibling of
+ * {@link useSubmitApproval}.
+ *
+ * File edits are reviewed as a captured change set (the `file_change_sets`
+ * projection), NOT as tool-call approvals. Platform builders who want full
+ * control over the review UI use this hook directly; those who prefer a drop-in
+ * surface use {@link FileReviewCard}, which accepts the callback shape this
+ * hook produces.
+ *
+ * @example
+ * ```tsx
+ * const { submitFileDecision, submittingDecisionKeys } = useFileReview();
+ *
+ * // Approve the whole change set:
+ * await submitFileDecision(executionId, changeSet.id, FileDecisionAction.APPROVE, {
+ *   expectedDigest: changeSet.aggregateDigest,
+ * });
+ * ```
+ */
+export declare function useFileReview(): UseFileReviewReturn;
+//# sourceMappingURL=useFileReview.d.ts.map

package/execution/useFileReview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileReview.d.ts","sourceRoot":"","sources":["../../src/execution/useFileReview.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,8DAA8D,CAAC;AAKtE,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAElF;AAKD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAqFnD"}