@stigmer/react 3.1.17 → 3.2.0

package/workflow/task-detail/task-approval.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The human_input gate's data model for the thread card — the review
+ * material a pending gate presents and the decision record a resolved gate
+ * reports (T06).
+ *
+ * Ported from `execution-inspector/derive-task-detail.ts` when the Inspect
+ * drill-down was removed and the review surface moved onto the gating
+ * task's card. The event-scan join died with the inspector: the request /
+ * resolution payloads are captured by the event store's single canonical
+ * walk (`DerivedTaskState.approvalRequest` / `.approvalResolution`), and
+ * these projections work off that capture plus the card's O(1) snapshot
+ * lookup — never the event log (DD-T04-5, D-T02-4).
+ *
+ * No React dependencies — independently testable (DD-003).
+ */
+import type { ApprovalRequestedPayload, ApprovalResolvedPayload } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+import { type JsonObject, type JsonValue } from "@bufbuild/protobuf";
+/**
+ * The review material of a pending human_input gate, projected to the plain
+ * shape `WorkflowTaskReviewGate` renders — prompt, outcomes, form schema,
+ * and the resolved payload (inline value or artifact reference).
+ */
+export interface TaskApprovalRequestView {
+    /** Resolved prompt text from the task config, rendered as markdown. */
+    readonly prompt: string;
+    /** Configured outcomes; empty falls back to Approve / Reject. */
+    readonly outcomes: readonly {
+        readonly name: string;
+        readonly label: string;
+    }[];
+    /** JSON Schema for the reviewer's input form, or `null` when none. */
+    readonly formSchema: JsonObject | null;
+    /**
+     * Inline review payload, unwrapped from the event's
+     * `google.protobuf.Value` to plain JSON. `null` when the gate carries no
+     * payload or when it was promoted to an artifact (see
+     * {@link payloadArtifactId} — the two are mutually exclusive).
+     */
+    readonly payload: JsonValue | null;
+    /** Renderer discriminator from the task config's `ui_hint`; `""` = none. */
+    readonly uiHint: string;
+    /** Artifact holding a promoted payload, or `null` when inline. */
+    readonly payloadArtifactId: string | null;
+}
+/**
+ * A resolved human_input decision, sourced from the canonical task-output
+ * record (the runner stores the reviewer's full response as the task
+ * output) and enriched with timing from the `approval_resolved` event.
+ *
+ * `outcome` is the empty string during the brief window after a decision
+ * is signalled but before the status snapshot reflects the task output —
+ * consumers render a "finalizing" affordance in that state.
+ */
+export interface TaskDetailApprovalDecision {
+    /** Chosen outcome identifier (e.g. "approve", "pause_campaigns"). */
+    readonly outcome: string;
+    /** Reviewer who made the decision. */
+    readonly reviewer: string;
+    /** ISO-8601 timestamp the decision was recorded, or `null`. */
+    readonly respondedAt: string | null;
+    /** Free-text comment the reviewer attached, or the empty string. */
+    readonly comment: string;
+    /** Structured form answers submitted with the decision, or `null`. */
+    readonly formData: JsonObject | null;
+    /** How long the gate was pending, in milliseconds (from the event). */
+    readonly waitDurationMs: number;
+    /** `true` when a timeout policy resolved the gate without a human. */
+    readonly autoResolved: boolean;
+}
+/**
+ * Projects the captured `approval_requested` payload to the plain view the
+ * review gate renders. Pure and cheap — consumers memoize on the payload
+ * message's identity (the store keeps it reference-stable).
+ */
+export declare function deriveTaskApprovalRequest(request: ApprovalRequestedPayload): TaskApprovalRequestView;
+/**
+ * Builds the resolved-decision record for a decided human_input gate, or
+ * `null` while no decision exists.
+ *
+ * The task's output IS the canonical decision record: the runner persists
+ * the reviewer's full response ({ outcome, reviewer, responded_at, comment,
+ * form_data, auto_resolved }) as the task output, a google.protobuf.Struct,
+ * so every field survives. Prefer it, and fall back to the lightweight
+ * `approval_resolved` event for fields the output snapshot has not captured
+ * yet (the brief window after a decision is signalled but before the status
+ * snapshot refreshes).
+ */
+export declare function deriveTaskApprovalDecision(resolution: ApprovalResolvedPayload | null, taskOutput: JsonObject | undefined): TaskDetailApprovalDecision | null;
+//# sourceMappingURL=task-approval.d.ts.map

package/workflow/task-detail/task-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-approval.d.ts","sourceRoot":"","sources":["../../../src/workflow/task-detail/task-approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,kEAAkE,CAAC;AAC1E,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO7E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAmBzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,uBAAuB,GAAG,IAAI,EAC1C,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,0BAA0B,GAAG,IAAI,CAenC"}

package/workflow/task-detail/task-approval.js

@@ -0,0 +1,84 @@
+/**
+ * The human_input gate's data model for the thread card — the review
+ * material a pending gate presents and the decision record a resolved gate
+ * reports (T06).
+ *
+ * Ported from `execution-inspector/derive-task-detail.ts` when the Inspect
+ * drill-down was removed and the review surface moved onto the gating
+ * task's card. The event-scan join died with the inspector: the request /
+ * resolution payloads are captured by the event store's single canonical
+ * walk (`DerivedTaskState.approvalRequest` / `.approvalResolution`), and
+ * these projections work off that capture plus the card's O(1) snapshot
+ * lookup — never the event log (DD-T04-5, D-T02-4).
+ *
+ * No React dependencies — independently testable (DD-003).
+ */
+import { toJson } from "@bufbuild/protobuf";
+import { ValueSchema } from "@bufbuild/protobuf/wkt";
+// ---------------------------------------------------------------------------
+// Projections
+// ---------------------------------------------------------------------------
+/**
+ * Projects the captured `approval_requested` payload to the plain view the
+ * review gate renders. Pure and cheap — consumers memoize on the payload
+ * message's identity (the store keeps it reference-stable).
+ */
+export function deriveTaskApprovalRequest(request) {
+    return {
+        prompt: request.prompt,
+        outcomes: (request.outcomes ?? []).map((o) => ({
+            name: o.name,
+            label: o.label,
+        })),
+        formSchema: request.formSchema
+            ? request.formSchema
+            : null,
+        // The payload rides the event as a google.protobuf.Value message;
+        // unwrap it to plain JSON once here so all consumers downstream
+        // (renderers, fallback card) work with ordinary values.
+        payload: request.payload
+            ? toJson(ValueSchema, request.payload)
+            : null,
+        uiHint: request.uiHint,
+        payloadArtifactId: request.payloadArtifactId || null,
+    };
+}
+/**
+ * Builds the resolved-decision record for a decided human_input gate, or
+ * `null` while no decision exists.
+ *
+ * The task's output IS the canonical decision record: the runner persists
+ * the reviewer's full response ({ outcome, reviewer, responded_at, comment,
+ * form_data, auto_resolved }) as the task output, a google.protobuf.Struct,
+ * so every field survives. Prefer it, and fall back to the lightweight
+ * `approval_resolved` event for fields the output snapshot has not captured
+ * yet (the brief window after a decision is signalled but before the status
+ * snapshot refreshes).
+ */
+export function deriveTaskApprovalDecision(resolution, taskOutput) {
+    const outputOutcome = readSnapshotString(taskOutput, "outcome");
+    if (resolution === null && outputOutcome === "")
+        return null;
+    return {
+        outcome: outputOutcome,
+        reviewer: readSnapshotString(taskOutput, "reviewer") || (resolution?.resolvedBy ?? ""),
+        respondedAt: readSnapshotString(taskOutput, "responded_at") || null,
+        comment: readSnapshotString(taskOutput, "comment") || (resolution?.comment ?? ""),
+        formData: readSnapshotObject(taskOutput, "form_data"),
+        waitDurationMs: resolution ? Number(resolution.waitDurationMs) : 0,
+        autoResolved: taskOutput?.["auto_resolved"] === true,
+    };
+}
+/** Reads a string field from a task-output Struct, or `""` when absent. */
+function readSnapshotString(obj, key) {
+    const value = obj?.[key];
+    return typeof value === "string" ? value : "";
+}
+/** Reads a nested object field from a task-output Struct, or `null`. */
+function readSnapshotObject(obj, key) {
+    const value = obj?.[key];
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=task-approval.js.map

package/workflow/task-detail/task-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-approval.js","sourceRoot":"","sources":["../../../src/workflow/task-detail/task-approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,MAAM,EAAmC,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAyDrD,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAiC;IAEjC,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;YAC5B,CAAC,CAAE,OAAO,CAAC,UAAoC;YAC/C,CAAC,CAAC,IAAI;QACR,kEAAkE;QAClE,gEAAgE;QAChE,wDAAwD;QACxD,OAAO,EAAE,OAAO,CAAC,OAAO;YACtB,CAAC,CAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAe;YACrD,CAAC,CAAC,IAAI;QACR,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA0C,EAC1C,UAAkC;IAElC,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,UAAU,KAAK,IAAI,IAAI,aAAa,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAE7D,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,QAAQ,EACN,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE,CAAC;QAC9E,WAAW,EAAE,kBAAkB,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,IAAI;QACnE,OAAO,EACL,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;QAC1E,QAAQ,EAAE,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC;QACrD,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,YAAY,EAAE,UAAU,EAAE,CAAC,eAAe,CAAC,KAAK,IAAI;KACrD,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,kBAAkB,CAAC,GAA2B,EAAE,GAAW;IAClE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,wEAAwE;AACxE,SAAS,kBAAkB,CACzB,GAA2B,EAC3B,GAAW;IAEX,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAoB;QACvB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/workflow/task-detail/task-detail-io.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The canonical task-I/O model and its fallback ladder — shared by the
+ * thread card body and the Inspect drill-down (T04).
+ *
+ * Extracted from `execution-inspector/derive-task-detail.ts`: this pair is
+ * not inspector-specific, and the thread must not reach into an "inspector"
+ * folder for shared infrastructure. Deliberately ONLY the I/O ladder lives
+ * here — the full `deriveTaskDetail` join (retries, event log, agent and
+ * approval sections) scans the whole event log and stays in
+ * `execution-inspector/`, where exactly one task is derived at a time. The
+ * card body pairs `buildIO` with an O(1) snapshot lookup instead; wiring the
+ * full join into every always-visible card body would be O(cards × events)
+ * per event append.
+ *
+ * No React dependencies — independently testable (DD-003).
+ *
+ * @since T04 (Session-Parity Task Cards)
+ */
+import type { JsonObject } from "@bufbuild/protobuf";
+/**
+ * One side (input or output) of a task's I/O, with provenance.
+ *
+ * `source` records which rung of the fallback ladder supplied `data`:
+ * `"snapshot"` is the full value from `status.tasks[]`; `"event-summary"`
+ * is the truncated Struct off the live event stream — consumers surface
+ * the truncation honestly (a banner) rather than presenting it as complete.
+ */
+export interface TaskDetailIO {
+    readonly data: JsonObject;
+    readonly summary: JsonObject | null;
+    readonly artifactIds: readonly string[];
+    readonly source: "snapshot" | "event-summary";
+}
+/**
+ * The I/O fallback ladder: the full snapshot value when present, else the
+ * truncated event summary, else `null` (nothing to show).
+ */
+export declare function buildIO(snapshotData: JsonObject | undefined, eventSummary: JsonObject | null, artifactIds: readonly string[]): TaskDetailIO | null;
+//# sourceMappingURL=task-detail-io.d.ts.map

package/workflow/task-detail/task-detail-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-detail-io.d.ts","sourceRoot":"","sources":["../../../src/workflow/task-detail/task-detail-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,UAAU,GAAG,SAAS,EACpC,YAAY,EAAE,UAAU,GAAG,IAAI,EAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,YAAY,GAAG,IAAI,CAoBrB"}

package/workflow/task-detail/task-detail-io.js

@@ -0,0 +1,42 @@
+/**
+ * The canonical task-I/O model and its fallback ladder — shared by the
+ * thread card body and the Inspect drill-down (T04).
+ *
+ * Extracted from `execution-inspector/derive-task-detail.ts`: this pair is
+ * not inspector-specific, and the thread must not reach into an "inspector"
+ * folder for shared infrastructure. Deliberately ONLY the I/O ladder lives
+ * here — the full `deriveTaskDetail` join (retries, event log, agent and
+ * approval sections) scans the whole event log and stays in
+ * `execution-inspector/`, where exactly one task is derived at a time. The
+ * card body pairs `buildIO` with an O(1) snapshot lookup instead; wiring the
+ * full join into every always-visible card body would be O(cards × events)
+ * per event append.
+ *
+ * No React dependencies — independently testable (DD-003).
+ *
+ * @since T04 (Session-Parity Task Cards)
+ */
+/**
+ * The I/O fallback ladder: the full snapshot value when present, else the
+ * truncated event summary, else `null` (nothing to show).
+ */
+export function buildIO(snapshotData, eventSummary, artifactIds) {
+    if (snapshotData && Object.keys(snapshotData).length > 0) {
+        return {
+            data: snapshotData,
+            summary: eventSummary,
+            artifactIds,
+            source: "snapshot",
+        };
+    }
+    if (eventSummary && Object.keys(eventSummary).length > 0) {
+        return {
+            data: eventSummary,
+            summary: eventSummary,
+            artifactIds,
+            source: "event-summary",
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=task-detail-io.js.map

package/workflow/task-detail/task-detail-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-detail-io.js","sourceRoot":"","sources":["../../../src/workflow/task-detail/task-detail-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmBH;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,YAAoC,EACpC,YAA+B,EAC/B,WAA8B;IAE9B,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,YAAY;YACrB,WAAW;YACX,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,YAAY;YACrB,WAAW;YACX,MAAM,EAAE,eAAe;SACxB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/workflow/thread/WorkflowTaskThread.d.ts

@@ -0,0 +1,91 @@
+import type { WorkflowPendingApproval, WorkflowPendingFileReview, WorkflowTask } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { DerivedTaskState } from "../../internal/store/workflow-execution-event-store.js";
+import type { UseWorkflowExecutionActionsReturn } from "../useWorkflowExecutionActions.js";
+/**
+ * The workflow-level HITL wiring a decision-capable thread needs — a `Pick`
+ * of the single `useWorkflowExecutionActions` instance's return (cannot
+ * drift; same convention as `WorkflowAgentExecutionHitl`). Covers all three
+ * gate kinds: child tool approvals, child file reviews, and task-level
+ * (human_input) approvals — since T06 the gating card is the ONLY decision
+ * surface, so the thread carries the full set. Decisions route through the
+ * WORKFLOW-level RPCs only — never the child's own `agentExecution.*` path,
+ * whose authorization checks the runner-spawned child rather than the
+ * workflow execution the operator owns (S5 rationale).
+ */
+export type WorkflowThreadHitl = Pick<UseWorkflowExecutionActionsReturn, "submitApproval" | "approvalSubmittingToolCallIds" | "approvalErrorsByToolCallId" | "submitTaskApproval" | "taskApprovalSubmittingTaskNames" | "taskApprovalErrorsByTaskName" | "submitFileDecision" | "fileDecisionSubmittingKeys" | "fileDecisionErrorsByKey">;
+/** Props for {@link WorkflowTaskThread}. */
+export interface WorkflowTaskThreadProps {
+    /** Live derived task states from the execution event stream. */
+    readonly taskStates: ReadonlyMap<string, DerivedTaskState>;
+    /** Total planned tasks (from `execution_started`); `0` when unknown. */
+    readonly totalTasks: number;
+    /** Whether the execution is still running (drives streaming affordances). */
+    readonly isRunning: boolean;
+    /**
+     * Callback to open an AGENT_CALL task's child transcript in the panel's
+     * editor area (the S4 in-place expansion). Omitted → the affordance is
+     * not rendered.
+     */
+    readonly onOpenAgentExecution?: (childExecutionId: string, taskName: string) => void;
+    /**
+     * Workflow-level HITL wiring (see {@link WorkflowThreadHitl}). When
+     * provided, a gating task's card renders its decision surface directly in
+     * the thread — always visible while the gate is pending, never behind the
+     * expand chevron (the run is blocked). Omitted → the thread is read-only
+     * and behaves exactly as before (DD-011; the S5 omitted-`hitl` precedent).
+     */
+    readonly hitl?: WorkflowThreadHitl;
+    /**
+     * The parent workflow's surfaced child tool-approval gates
+     * (`status.pending_approvals`). Only read when {@link hitl} is provided.
+     */
+    readonly pendingApprovals?: readonly WorkflowPendingApproval[];
+    /**
+     * The parent workflow's surfaced child file-review references
+     * (`status.pending_file_reviews`). Only read when {@link hitl} is provided.
+     */
+    readonly pendingFileReviews?: readonly WorkflowPendingFileReview[];
+    /**
+     * Per-task status snapshots (`status.tasks[]`) keyed by task name — the
+     * FULL I/O source for card bodies (T04), never an event-log scan
+     * (DD-T04-5). The map's identity changes only on a snapshot refetch
+     * (rare), never on stream event appends, so memoized cards keep bailing
+     * during streaming. Omitted → bodies degrade to the truncated event
+     * summaries already on the items.
+     */
+    readonly taskSnapshotsByName?: ReadonlyMap<string, WorkflowTask>;
+    /** Additional CSS class names for the root container. */
+    readonly className?: string;
+}
+/**
+ * Session-style task thread for a workflow execution: one card per task in
+ * execution order (first-started first — D-T02-1), streaming live as the
+ * run progresses, with a collapsed preview and an expandable detail body
+ * per card — the workflow analog of the session viewer's tool-call cards.
+ *
+ * Pending tasks render no cards (D-T02-5); the progress header keeps
+ * overall status visible. Retries collapse into one card with an attempt
+ * indicator (D-T02-6). AGENT_CALL cards carry an always-visible body with
+ * an "Open transcript" affordance (D-T02-2) — the full transcript opens as
+ * a panel document, never inline. Since T04 the card is the PRIMARY surface
+ * for a task's data (kind-aware preview line + bounded I/O body); since T06
+ * it is the ONLY one — the Inspect drill-down is gone, and cards compose
+ * the session card language exactly (expand-or-none headers, no selection).
+ *
+ * Auto-follow uses the session thread's mechanism: an IntersectionObserver
+ * sentinel keeps the list pinned to the latest card until the user scrolls
+ * up, with a jump-to-latest affordance to re-engage.
+ *
+ * With `hitl` wired, a gating task's card carries its decision surface
+ * in-thread (S10/T06): the canonical `ApprovalCard`s for child tool gates,
+ * the child-streaming `FileReviewCard`s for file gates, and the full
+ * `WorkflowTaskReviewGate` (custom review renderers included) for
+ * task-level human_input gates — with a read-only
+ * `WorkflowTaskApprovalSummary` once the gate resolves.
+ *
+ * This component is designed to work identically whether rendered in the
+ * Stigmer Console or embedded in a third-party dashboard. No dependencies
+ * on Console routing, auth, or layout context.
+ */
+export declare const WorkflowTaskThread: import("react").NamedExoticComponent<WorkflowTaskThreadProps>;
+//# sourceMappingURL=WorkflowTaskThread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTaskThread.d.ts","sourceRoot":"","sources":["../../../src/workflow/thread/WorkflowTaskThread.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACb,MAAM,gEAAgE,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAgB/F,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAmB3F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,iCAAiC,EAC/B,gBAAgB,GAChB,+BAA+B,GAC/B,4BAA4B,GAC5B,oBAAoB,GACpB,iCAAiC,GACjC,8BAA8B,GAC9B,oBAAoB,GACpB,4BAA4B,GAC5B,yBAAyB,CAC5B,CAAC;AAYF,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,KACb,IAAI,CAAC;IACV;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACnE;;;;;;;OAOG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjE,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,kBAAkB,+DAmF7B,CAAC"}