@stigmer/react 3.1.17 → 3.2.0

package/workflow/thread/task-presentation.d.ts

@@ -0,0 +1,73 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import type { JsonValue } from "@bufbuild/protobuf";
+import type { DerivedTaskState } from "../../internal/store/workflow-execution-event-store.js";
+/**
+ * Disclosure mode for a task card, mirroring the session's rule — "does the
+ * body carry content the one-line row cannot?":
+ *
+ * - `"preview"` — I/O-bearing kinds: the card keeps an always-visible,
+ *   bounded body of the task's output (the session's shell/edit/MCP model).
+ * - `"summary"` — thin/derived kinds: a compact row with a chevron-gated
+ *   detail body.
+ */
+export type WorkflowTaskDisclosure = "preview" | "summary";
+/** The resolved presentation primitives for one task card. */
+export interface WorkflowTaskPreview {
+    /**
+     * Bounded one-line preview of what the task did (e.g. `set orderId,
+     * total`, `3 errors`, `emitted ticket.classified`). The empty string when
+     * there is nothing kind-specific to say — consumers hide the line rather
+     * than render filler.
+     */
+    readonly previewLine: string;
+    /** Disclosure mode for the card. Pure function of the task kind. */
+    readonly disclosure: WorkflowTaskDisclosure;
+}
+/**
+ * Optional per-kind overrides for the preview line and disclosure — the
+ * workflow twin of the session's `ToolPresenter` (minus `runGroupable`:
+ * workflow tasks are one card per task).
+ */
+export interface WorkflowTaskPresenter {
+    /**
+     * Overrides the kind-specific preview line. Return `null` to fall back to
+     * the built-in line for the kind. Status lines (awaiting approval, the
+     * failure message, "Skipped") always take precedence and are not
+     * overridable — they are correctness surfaces, not wording.
+     */
+    readonly previewLine?: (state: DerivedTaskState) => string | null;
+    /** Overrides the default disclosure mode for the kind. */
+    readonly disclosure?: (state: DerivedTaskState) => WorkflowTaskDisclosure;
+}
+/**
+ * Registers a custom presenter for a {@link WorkflowTaskKind}, overriding
+ * the built-in preview line and/or disclosure. Call once at app startup.
+ * This is the extension point for platform builders embedding the workflow
+ * execution UI who want product-specific wording without forking the
+ * components — the same seam as the session's `registerToolPresenter`.
+ *
+ * Returns a disposer that unregisters the presenter, restoring the previous
+ * one for that kind (or the default). Most apps register once at startup
+ * and ignore it; tests and dynamic hosts use it to avoid leaking global
+ * state.
+ */
+export declare function registerTaskPresenter(kind: WorkflowTaskKind, presenter: WorkflowTaskPresenter): () => void;
+/** Returns the registered presenter for a kind, if any. */
+export declare function getTaskPresenter(kind: WorkflowTaskKind): WorkflowTaskPresenter | undefined;
+/** Default disclosure mode for a task kind. */
+export declare function defaultDisclosureForKind(kind: WorkflowTaskKind): WorkflowTaskDisclosure;
+/**
+ * Resolves the presentation primitives for one task card.
+ *
+ * Precedence for the line: universal status lines first (awaiting approval,
+ * the failure's first line, "Skipped") — these are correctness surfaces —
+ * then the registered presenter's line, then the built-in per-kind line.
+ */
+export declare function resolveTaskPreview(state: DerivedTaskState): WorkflowTaskPreview;
+/**
+ * One-line snippet of an arbitrary JSON value: scalars verbatim (strings
+ * quoted), containers as a shape summary. Used where a kind's output has
+ * no documented structure to name (transform results, raw LLM text).
+ */
+export declare function valueSnippet(value: JsonValue): string;
+//# sourceMappingURL=task-presentation.d.ts.map

package/workflow/thread/task-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-presentation.d.ts","sourceRoot":"","sources":["../../../src/workflow/thread/task-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAC1F,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AA+B/F;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,MAAM,GAAG,IAAI,CAAC;IAClE,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,sBAAsB,CAAC;CAC3E;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,qBAAqB,GAC/B,MAAM,IAAI,CAUZ;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,GACrB,qBAAqB,GAAG,SAAS,CAEnC;AAkCD,+CAA+C;AAC/C,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GACrB,sBAAsB,CAExB;AASD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,GACtB,mBAAmB,CAarB;AAyLD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAwBrD"}

package/workflow/thread/task-presentation.js

@@ -0,0 +1,331 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { formatDuration } from "../format-utils.js";
+// ---------------------------------------------------------------------------
+// Registry (the platform-builder extension seam)
+// ---------------------------------------------------------------------------
+const registry = new Map();
+/**
+ * Registers a custom presenter for a {@link WorkflowTaskKind}, overriding
+ * the built-in preview line and/or disclosure. Call once at app startup.
+ * This is the extension point for platform builders embedding the workflow
+ * execution UI who want product-specific wording without forking the
+ * components — the same seam as the session's `registerToolPresenter`.
+ *
+ * Returns a disposer that unregisters the presenter, restoring the previous
+ * one for that kind (or the default). Most apps register once at startup
+ * and ignore it; tests and dynamic hosts use it to avoid leaking global
+ * state.
+ */
+export function registerTaskPresenter(kind, presenter) {
+    const previous = registry.get(kind);
+    registry.set(kind, presenter);
+    return () => {
+        if (previous === undefined) {
+            registry.delete(kind);
+        }
+        else {
+            registry.set(kind, previous);
+        }
+    };
+}
+/** Returns the registered presenter for a kind, if any. */
+export function getTaskPresenter(kind) {
+    return registry.get(kind);
+}
+// ---------------------------------------------------------------------------
+// Disclosure defaults
+// ---------------------------------------------------------------------------
+/**
+ * Kinds whose output can be the point of the task — their cards keep an
+ * always-visible bounded body (the session's "preview" categories). The
+ * body renders only when output actually exists (the `showBody` gate), so
+ * a kind whose runner writes no output — today's invocation kinds, until
+ * the output-envelope follow-up standardizes them (DD-T04-3) — stays a
+ * clean one-line row with zero cost. `set_vars` earns its place from live
+ * data: the runner writes the seeded variables to task output (T05, R2-5).
+ *
+ * Only genuinely body-less kinds (control flow, `wait`/`listen`, and the
+ * snapshot fallback's `unspecified`) stay compact summary rows.
+ */
+const PREVIEW_KINDS = new Set([
+    WorkflowTaskKind.transform,
+    WorkflowTaskKind.validate,
+    WorkflowTaskKind.llm_call,
+    WorkflowTaskKind.eval,
+    WorkflowTaskKind.emit_event,
+    WorkflowTaskKind.notification,
+    WorkflowTaskKind.agent_call,
+    WorkflowTaskKind.set_vars,
+    WorkflowTaskKind.human_input,
+    WorkflowTaskKind.http_call,
+    WorkflowTaskKind.grpc_call,
+    WorkflowTaskKind.activity_call,
+    WorkflowTaskKind.run_workflow,
+]);
+/** Default disclosure mode for a task kind. */
+export function defaultDisclosureForKind(kind) {
+    return PREVIEW_KINDS.has(kind) ? "preview" : "summary";
+}
+// ---------------------------------------------------------------------------
+// Resolution
+// ---------------------------------------------------------------------------
+/** Hard cap on the preview line — it is a header suffix, not a body. */
+const PREVIEW_LINE_MAX_CHARS = 80;
+/**
+ * Resolves the presentation primitives for one task card.
+ *
+ * Precedence for the line: universal status lines first (awaiting approval,
+ * the failure's first line, "Skipped") — these are correctness surfaces —
+ * then the registered presenter's line, then the built-in per-kind line.
+ */
+export function resolveTaskPreview(state) {
+    const override = registry.get(state.taskKind);
+    const disclosure = override?.disclosure?.(state) ?? defaultDisclosureForKind(state.taskKind);
+    const statusLine = statusPreviewLine(state);
+    if (statusLine !== null) {
+        return { previewLine: truncateLine(statusLine), disclosure };
+    }
+    const line = override?.previewLine?.(state) ?? defaultPreviewLine(state) ?? "";
+    return { previewLine: truncateLine(line), disclosure };
+}
+/** Universal status lines that outrank any kind-specific preview. */
+function statusPreviewLine(state) {
+    if (state.status === "waiting_approval")
+        return "Awaiting approval";
+    if (state.status === "failed" && state.error)
+        return firstLine(state.error);
+    if (state.status === "skipped")
+        return "Skipped";
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Built-in per-kind lines
+// ---------------------------------------------------------------------------
+function defaultPreviewLine(state) {
+    switch (state.taskKind) {
+        case WorkflowTaskKind.agent_call:
+            return agentCallLine(state);
+        case WorkflowTaskKind.set_vars:
+            return setVarsLine(state.inputSummary);
+        case WorkflowTaskKind.transform:
+            return transformLine(state);
+        case WorkflowTaskKind.validate:
+            return validateLine(state.outputSummary);
+        case WorkflowTaskKind.llm_call:
+            return llmCallLine(state);
+        case WorkflowTaskKind.eval:
+            return evalLine(state.outputSummary);
+        case WorkflowTaskKind.emit_event:
+            return emitEventLine(state);
+        case WorkflowTaskKind.notification:
+            return notificationLine(state);
+        case WorkflowTaskKind.human_input:
+            return humanInputLine(state.outputSummary);
+        case WorkflowTaskKind.wait:
+            return waitLine(state);
+        case WorkflowTaskKind.listen:
+            return listenLine(state);
+        default:
+            // Control flow (branch-taken / fork progress need graph topology the
+            // thread does not have — deferred), raise_error (the failure
+            // precedence already shows the message), the invocation kinds
+            // (pending the backend output-envelope follow-up), and the snapshot
+            // fallback's `unspecified` all stay status-only.
+            return null;
+    }
+}
+/**
+ * The flagship agent-call line: `slug · running <tool> · N msgs · M tools`.
+ * Field-for-field the pre-T04 card line — kept here so the thread has one
+ * source of preview semantics.
+ */
+function agentCallLine(state) {
+    const parts = [];
+    if (state.agentSlug)
+        parts.push(state.agentSlug);
+    if (state.status === "running" && state.currentToolName) {
+        parts.push(`running ${state.currentToolName}`);
+    }
+    if (state.messagesCount > 0 || state.toolCallsCount > 0) {
+        parts.push(`${state.messagesCount} msgs · ${state.toolCallsCount} tools`);
+    }
+    return parts.length > 0 ? parts.join(" · ") : null;
+}
+/** `set orderId, total +2 more` — from the resolved variables map. */
+function setVarsLine(input) {
+    if (!input)
+        return null;
+    // The summary may nest the map under `variables` (the config field) or
+    // carry the resolved variables at the top level — accept both.
+    const vars = asObject(input["variables"]) ?? input;
+    const keys = Object.keys(vars);
+    if (keys.length === 0)
+        return null;
+    const shown = keys.slice(0, 3).join(", ");
+    const rest = keys.length - 3;
+    return rest > 0 ? `set ${shown} +${rest} more` : `set ${shown}`;
+}
+/** `jq → 42` while settled; the engine alone while running. */
+function transformLine(state) {
+    const engine = asString(state.inputSummary?.["engine"])?.toLowerCase() ?? null;
+    if (state.outputSummary) {
+        const snippet = valueSnippet(state.outputSummary);
+        return engine ? `${engine} → ${snippet}` : `→ ${snippet}`;
+    }
+    return engine;
+}
+/** `valid` / `3 errors` — from the documented `{valid, errors[]}` shape. */
+function validateLine(output) {
+    if (!output)
+        return null;
+    const valid = output["valid"];
+    if (valid === true)
+        return "valid";
+    if (valid === false) {
+        const errors = Array.isArray(output["errors"]) ? output["errors"].length : 0;
+        return errors > 0 ? `${errors} ${errors === 1 ? "error" : "errors"}` : "invalid";
+    }
+    return null;
+}
+/** `claude-sonnet · "snippet…"` — model from input, text from output. */
+function llmCallLine(state) {
+    const parts = [];
+    const model = asString(state.inputSummary?.["model"]);
+    if (model)
+        parts.push(model);
+    if (state.outputSummary)
+        parts.push(valueSnippet(state.outputSummary));
+    return parts.length > 0 ? parts.join(" · ") : null;
+}
+/** `pass · score 0.82` — from the documented `{pass, score}` shape. */
+function evalLine(output) {
+    if (!output)
+        return null;
+    const pass = output["pass"];
+    const score = output["score"];
+    if (typeof pass !== "boolean")
+        return null;
+    const verdict = pass ? "pass" : "fail";
+    return typeof score === "number" ? `${verdict} · score ${score}` : verdict;
+}
+/** `emitted ticket.classified` — the CloudEvents `type` is the identity. */
+function emitEventLine(state) {
+    const emittedType = asString(state.outputSummary?.["type"]);
+    if (emittedType)
+        return `emitted ${emittedType}`;
+    const configured = asString(asObject(state.inputSummary?.["event"])?.["type"]);
+    return configured ? `emitting ${configured}` : null;
+}
+/** `sent via slack` / `delivery failed` — from `{channel, delivered}`. */
+function notificationLine(state) {
+    const output = state.outputSummary;
+    const channel = asString(output?.["channel"]) ?? asString(state.inputSummary?.["channel"]);
+    if (output && output["delivered"] === false)
+        return "delivery failed";
+    if (output && channel)
+        return `sent via ${channel}`;
+    return channel;
+}
+/** `approve · by suresh` — the settled decision from the task output. */
+function humanInputLine(output) {
+    // The gating state is covered by the universal "Awaiting approval" line;
+    // this renders only the settled decision record.
+    const outcome = asString(output?.["outcome"]);
+    if (!outcome)
+        return null;
+    const reviewer = asString(output?.["reviewer"]);
+    return reviewer ? `${outcome} · by ${reviewer}` : outcome;
+}
+/** `waiting 10s` / `waited 10s` / `until <timestamp>`. */
+function waitLine(state) {
+    const input = state.inputSummary;
+    if (!input)
+        return null;
+    const verb = state.status === "running" ? "waiting" : "waited";
+    const duration = asObject(input["duration"]);
+    if (duration) {
+        const label = formatWaitDuration(duration);
+        return label ? `${verb} ${label}` : null;
+    }
+    const until = asString(input["until"]);
+    return until ? `${verb} until ${until}` : null;
+}
+/** `waiting for signal` / `signal received` — status-verbed. */
+function listenLine(state) {
+    if (state.status === "running")
+        return "waiting for signal";
+    if (state.status === "completed")
+        return "signal received";
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Struct-reading helpers (defensive by construction)
+// ---------------------------------------------------------------------------
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function asObject(value) {
+    return value !== null &&
+        value !== undefined &&
+        typeof value === "object" &&
+        !Array.isArray(value)
+        ? value
+        : null;
+}
+/**
+ * One-line snippet of an arbitrary JSON value: scalars verbatim (strings
+ * quoted), containers as a shape summary. Used where a kind's output has
+ * no documented structure to name (transform results, raw LLM text).
+ */
+export function valueSnippet(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return `"${firstLine(value)}"`;
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.length} ${value.length === 1 ? "item" : "items"}]`;
+    }
+    const keys = Object.keys(value);
+    // A single-field wrapper is usually an envelope (`{result: …}`) — unwrap
+    // one level so the snippet names the payload, not the wrapper.
+    if (keys.length === 1) {
+        const inner = value[keys[0]];
+        if (inner === null ||
+            typeof inner === "string" ||
+            typeof inner === "number" ||
+            typeof inner === "boolean") {
+            return valueSnippet(inner);
+        }
+    }
+    return `{${keys.length} ${keys.length === 1 ? "field" : "fields"}}`;
+}
+/**
+ * Formats the WaitTaskConfig `Duration` shape (`{days, hours, minutes,
+ * seconds, milliseconds}`) via the shared duration formatter. Unknown or
+ * empty shapes yield `null`.
+ */
+function formatWaitDuration(duration) {
+    const num = (key) => {
+        const v = duration[key];
+        return typeof v === "number" && Number.isFinite(v) ? v : 0;
+    };
+    const totalMs = num("days") * 86_400_000 +
+        num("hours") * 3_600_000 +
+        num("minutes") * 60_000 +
+        num("seconds") * 1_000 +
+        num("milliseconds");
+    return totalMs > 0 ? formatDuration(totalMs) : null;
+}
+function firstLine(text) {
+    const nl = text.indexOf("\n");
+    return nl === -1 ? text : text.slice(0, nl);
+}
+function truncateLine(line) {
+    return line.length > PREVIEW_LINE_MAX_CHARS
+        ? `${line.slice(0, PREVIEW_LINE_MAX_CHARS - 1)}\u2026`
+        : line;
+}
+//# sourceMappingURL=task-presentation.js.map

package/workflow/thread/task-presentation.js.map

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

package/workflow/thread/thread-presentation.d.ts

@@ -0,0 +1,28 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+/**
+ * Presentation variant for a task card in the workflow task thread.
+ *
+ * Deliberately NOT a new task-kind classification (D-T02-3): variants are a
+ * thin presentation projection of the canonical categories from
+ * `kind-metadata.ts` (`categorizeKind` — the single source of truth that
+ * already consolidated three drifted client-side classifications), plus one
+ * kind-level special case for the flagship `agent_call` card.
+ *
+ * - `agent-call` — the flagship: live agent slug, current tool, message and
+ *   tool-call counts, transcript expansion (D-T02-2).
+ * - `control` — control-flow tasks (switch/fork/for-each/try-catch/wait).
+ * - `gate` — governance tasks (human_input); the stop-sign of the thread.
+ * - `event` — signal/timing tasks (listen/emit/notification/raise-error).
+ * - `action` — everything else (invocations, data transforms, LLM calls);
+ *   also the fallback for `unspecified` kinds, which the snapshot-derived
+ *   fallback task map produces when the event log is empty.
+ */
+export type WorkflowThreadCardVariant = "agent-call" | "control" | "gate" | "event" | "action";
+/**
+ * Resolves the thread card variant for a task kind.
+ *
+ * `agent_call` is the one kind-level special case (the flagship card);
+ * every other kind flows through the canonical category classification.
+ */
+export declare function threadCardVariant(kind: WorkflowTaskKind): WorkflowThreadCardVariant;
+//# sourceMappingURL=thread-presentation.d.ts.map

package/workflow/thread/thread-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-presentation.d.ts","sourceRoot":"","sources":["../../../src/workflow/thread/thread-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAK1F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,yBAAyB,GACjC,YAAY,GACZ,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAmBb;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,GACrB,yBAAyB,CAG3B"}

package/workflow/thread/thread-presentation.js

@@ -0,0 +1,28 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { categorizeKind } from "../kind-metadata.js";
+import { taskKindToString } from "../workflow-graph-conversions.js";
+/**
+ * Canonical category → card variant. Data, not branches — the same table
+ * pattern the graph's visual registry and the session's tool taxonomy use.
+ */
+const VARIANT_FOR_CATEGORY = new Map([
+    ["ai", "action"], // agent_call is special-cased below; llm_call/eval read as actions
+    ["control_flow", "control"],
+    ["invocation", "action"],
+    ["data", "action"],
+    ["governance", "gate"],
+    ["event", "event"],
+    ["unspecified", "action"],
+]);
+/**
+ * Resolves the thread card variant for a task kind.
+ *
+ * `agent_call` is the one kind-level special case (the flagship card);
+ * every other kind flows through the canonical category classification.
+ */
+export function threadCardVariant(kind) {
+    if (kind === WorkflowTaskKind.agent_call)
+        return "agent-call";
+    return VARIANT_FOR_CATEGORY.get(categorizeKind(taskKindToString(kind))) ?? "action";
+}
+//# sourceMappingURL=thread-presentation.js.map

package/workflow/thread/thread-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-presentation.js","sourceRoot":"","sources":["../../../src/workflow/thread/thread-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAE1F,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AA2BpE;;;GAGG;AACH,MAAM,oBAAoB,GAGtB,IAAI,GAAG,CAAC;IACV,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,mEAAmE;IACrF,CAAC,cAAc,EAAE,SAAS,CAAC;IAC3B,CAAC,YAAY,EAAE,QAAQ,CAAC;IACxB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAClB,CAAC,YAAY,EAAE,MAAM,CAAC;IACtB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,aAAa,EAAE,QAAQ,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAsB;IAEtB,IAAI,IAAI,KAAK,gBAAgB,CAAC,UAAU;QAAE,OAAO,YAAY,CAAC;IAC9D,OAAO,oBAAoB,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;AACtF,CAAC"}

package/workflow/thread/useWorkflowThreadItems.d.ts

@@ -0,0 +1,16 @@
+import type { DerivedTaskState } from "../../internal/store/workflow-execution-event-store.js";
+import { type WorkflowThreadProjection } from "./project-thread-items.js";
+/**
+ * Behavior hook binding {@link projectThreadItems} to a render loop with
+ * structural sharing: items whose fields did not change keep their object
+ * identity across event appends, so memoized card rows bail (DD-010).
+ *
+ * The projection is cheap (one pass over the task map), so it recomputes
+ * per render of the (memoized) thread organism rather than adding a
+ * `useMemo` whose dependency — the store's `taskStates` — changes identity
+ * on every event append anyway. The ref carries only the previous items
+ * for identity reuse; it holds no state of its own (single source of truth
+ * stays the store).
+ */
+export declare function useWorkflowThreadItems(taskStates: ReadonlyMap<string, DerivedTaskState>, totalTasks: number): WorkflowThreadProjection;
+//# sourceMappingURL=useWorkflowThreadItems.d.ts.map

package/workflow/thread/useWorkflowThreadItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowThreadItems.d.ts","sourceRoot":"","sources":["../../../src/workflow/thread/useWorkflowThreadItems.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACjD,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAS1B"}

package/workflow/thread/useWorkflowThreadItems.js

@@ -0,0 +1,22 @@
+"use client";
+import { useRef } from "react";
+import { projectThreadItems, } from "./project-thread-items.js";
+/**
+ * Behavior hook binding {@link projectThreadItems} to a render loop with
+ * structural sharing: items whose fields did not change keep their object
+ * identity across event appends, so memoized card rows bail (DD-010).
+ *
+ * The projection is cheap (one pass over the task map), so it recomputes
+ * per render of the (memoized) thread organism rather than adding a
+ * `useMemo` whose dependency — the store's `taskStates` — changes identity
+ * on every event append anyway. The ref carries only the previous items
+ * for identity reuse; it holds no state of its own (single source of truth
+ * stays the store).
+ */
+export function useWorkflowThreadItems(taskStates, totalTasks) {
+    const previousItemsRef = useRef([]);
+    const projection = projectThreadItems(taskStates, totalTasks, previousItemsRef.current);
+    previousItemsRef.current = projection.items;
+    return projection;
+}
+//# sourceMappingURL=useWorkflowThreadItems.js.map

package/workflow/thread/useWorkflowThreadItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowThreadItems.js","sourceRoot":"","sources":["../../../src/workflow/thread/useWorkflowThreadItems.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,OAAO,EACL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAiD,EACjD,UAAkB;IAElB,MAAM,gBAAgB,GAAG,MAAM,CAAoC,EAAE,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,kBAAkB,CACnC,UAAU,EACV,UAAU,EACV,gBAAgB,CAAC,OAAO,CACzB,CAAC;IACF,gBAAgB,CAAC,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;IAC5C,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/workflow/useApprovalBoundary.d.ts

@@ -0,0 +1,38 @@
+import type { DerivedTaskState } from "../internal/store/workflow-execution-event-store.js";
+/**
+ * Tasks that crossed the `waiting_approval` boundary in one commit of the
+ * derived task-state map, in the map's (first-started) order.
+ */
+export interface ApprovalBoundaryCrossing {
+    /** Task names that transitioned INTO `waiting_approval` (a gate opened). */
+    readonly entered: readonly string[];
+    /** Task names that transitioned OUT of `waiting_approval` (a gate resolved). */
+    readonly exited: readonly string[];
+}
+/**
+ * Behavior hook that watches the live derived task-state map and reports
+ * when any task crosses the `waiting_approval` boundary — the client-side
+ * mirror of the stream's `approval_requested` / `approval_resolved` events.
+ *
+ * Why this exists: the execution SNAPSHOT (`status.pending_approvals` /
+ * `status.pending_file_reviews`) is fetched once and carries the gate
+ * payloads, while the event STREAM is live but carries only task status.
+ * A boundary crossing is precisely the moment the snapshot goes stale, so
+ * consumers refetch it then — derived-over-stored: the stream is the
+ * signal, the snapshot stays the single source for gate payloads. The
+ * `WorkflowExecutionViewer` additionally auto-selects a newly gated task so
+ * the decision surface (the panel's Inspect Approval tab) is never hidden
+ * while the run is blocked.
+ *
+ * Same diffing shape as {@link useExecutionAnnouncements} (prev-map ref,
+ * diff on each map commit). A task first observed already in
+ * `waiting_approval` counts as entered — with rAF-coalesced commits the
+ * running→waiting transition can collapse into the task's first appearance.
+ *
+ * `enabled` gates the CALLBACK, not the tracking: state is tracked even
+ * while disabled so enabling later never replays stale crossings. Keep it
+ * `false` for terminal executions — their event-history replay crosses the
+ * boundary for long-decided gates.
+ */
+export declare function useApprovalBoundary(taskStates: ReadonlyMap<string, DerivedTaskState>, enabled: boolean, onCrossing: (crossing: ApprovalBoundaryCrossing) => void): void;
+//# sourceMappingURL=useApprovalBoundary.d.ts.map

package/workflow/useApprovalBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApprovalBoundary.d.ts","sourceRoot":"","sources":["../../src/workflow/useApprovalBoundary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACjD,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,GACvD,IAAI,CA0BN"}

package/workflow/useApprovalBoundary.js

@@ -0,0 +1,55 @@
+"use client";
+import { useEffect, useRef } from "react";
+/**
+ * Behavior hook that watches the live derived task-state map and reports
+ * when any task crosses the `waiting_approval` boundary — the client-side
+ * mirror of the stream's `approval_requested` / `approval_resolved` events.
+ *
+ * Why this exists: the execution SNAPSHOT (`status.pending_approvals` /
+ * `status.pending_file_reviews`) is fetched once and carries the gate
+ * payloads, while the event STREAM is live but carries only task status.
+ * A boundary crossing is precisely the moment the snapshot goes stale, so
+ * consumers refetch it then — derived-over-stored: the stream is the
+ * signal, the snapshot stays the single source for gate payloads. The
+ * `WorkflowExecutionViewer` additionally auto-selects a newly gated task so
+ * the decision surface (the panel's Inspect Approval tab) is never hidden
+ * while the run is blocked.
+ *
+ * Same diffing shape as {@link useExecutionAnnouncements} (prev-map ref,
+ * diff on each map commit). A task first observed already in
+ * `waiting_approval` counts as entered — with rAF-coalesced commits the
+ * running→waiting transition can collapse into the task's first appearance.
+ *
+ * `enabled` gates the CALLBACK, not the tracking: state is tracked even
+ * while disabled so enabling later never replays stale crossings. Keep it
+ * `false` for terminal executions — their event-history replay crosses the
+ * boundary for long-decided gates.
+ */
+export function useApprovalBoundary(taskStates, enabled, onCrossing) {
+    const prevStatesRef = useRef(new Map());
+    // Render-synced ref so the diff effect never re-runs (and never fires
+    // spuriously) because a consumer passed a fresh callback identity.
+    const onCrossingRef = useRef(onCrossing);
+    onCrossingRef.current = onCrossing;
+    useEffect(() => {
+        const prev = prevStatesRef.current;
+        prevStatesRef.current = taskStates;
+        if (!enabled)
+            return;
+        const entered = [];
+        const exited = [];
+        for (const [name, state] of taskStates) {
+            const prevStatus = prev.get(name)?.status;
+            if (prevStatus === state.status)
+                continue;
+            if (state.status === "waiting_approval")
+                entered.push(name);
+            else if (prevStatus === "waiting_approval")
+                exited.push(name);
+        }
+        if (entered.length > 0 || exited.length > 0) {
+            onCrossingRef.current({ entered, exited });
+        }
+    }, [taskStates, enabled]);
+}
+//# sourceMappingURL=useApprovalBoundary.js.map

package/workflow/useApprovalBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApprovalBoundary.js","sourceRoot":"","sources":["../../src/workflow/useApprovalBoundary.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAc1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAiD,EACjD,OAAgB,EAChB,UAAwD;IAExD,MAAM,aAAa,GAAG,MAAM,CAAwC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/E,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC;QACnC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAC1C,IAAI,UAAU,KAAK,KAAK,CAAC,MAAM;gBAAE,SAAS;YAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBACvD,IAAI,UAAU,KAAK,kBAAkB;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5B,CAAC"}