@stigmer/react 3.2.2 → 3.2.3

package/execution/agent-execution-document.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-execution-document.js","sourceRoot":"","sources":["../../src/execution/agent-execution-document.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mEAAmE;AACnE,4EAA4E;AAC5E,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,oEAAoE;AACpE,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,2BAA2B;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,gBAAwB,EACxB,QAAgB;IAEhB,OAAO,GAAG,gBAAgB,IAAI,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/src/execution/__tests__/agent-execution-document.test.ts

@@ -1,45 +0,0 @@
-import { describe, it, expect } from "vitest";
-import {
-  AGENT_EXECUTION_DOCUMENT_ENTRY_ID,
-  agentExecutionTabPath,
-  parseAgentExecutionTabPath,
-} from "../agent-execution-document";
-import { ARTIFACT_DOCUMENT_ENTRY_ID } from "../artifact-document";
-import { FILE_CHANGE_DOCUMENT_ENTRY_ID } from "../file-change-document";
-
-describe("agent-execution-document identity", () => {
-  it("has a distinct family id from the other virtual-document families", () => {
-    expect(AGENT_EXECUTION_DOCUMENT_ENTRY_ID).not.toBe(ARTIFACT_DOCUMENT_ENTRY_ID);
-    expect(AGENT_EXECUTION_DOCUMENT_ENTRY_ID).not.toBe(FILE_CHANGE_DOCUMENT_ENTRY_ID);
-    // NUL-namespaced so it can never alias a real workspace entry id.
-    expect(AGENT_EXECUTION_DOCUMENT_ENTRY_ID.startsWith("\u0000")).toBe(true);
-  });
-
-  it("labels the tab with the task name (path basename)", () => {
-    const path = agentExecutionTabPath("aex_abc123", "summarize-report");
-    expect(path).toBe("aex_abc123/summarize-report");
-    expect(path.split("/").pop()).toBe("summarize-report");
-  });
-
-  it("round-trips the child execution id", () => {
-    const path = agentExecutionTabPath("aex_abc123", "summarize-report");
-    expect(parseAgentExecutionTabPath(path)).toBe("aex_abc123");
-  });
-
-  it("round-trips the id when the task name itself contains a separator", () => {
-    const path = agentExecutionTabPath("aex_abc123", "stage/publish");
-    expect(parseAgentExecutionTabPath(path)).toBe("aex_abc123");
-  });
-
-  it("keeps two calls to the same agent distinct (per-child identity)", () => {
-    const first = agentExecutionTabPath("aex_1", "call-agent");
-    const second = agentExecutionTabPath("aex_2", "call-agent");
-    expect(first).not.toBe(second);
-    expect(parseAgentExecutionTabPath(first)).toBe("aex_1");
-    expect(parseAgentExecutionTabPath(second)).toBe("aex_2");
-  });
-
-  it("degrades to the whole path when no separator is present", () => {
-    expect(parseAgentExecutionTabPath("aex_bare")).toBe("aex_bare");
-  });
-});

package/src/execution/agent-execution-document.ts

@@ -1,54 +0,0 @@
-// Identity of agent-execution transcript tabs in the workspace surface's
-// editor group. Domain: execution (the transcript renderer and the
-// AgentExecution data model are execution-domain; the workflow panel is the
-// first host, and a future session-side consumer — e.g. sub-agent expansion —
-// would share this identity rather than minting a divergent one).
-//
-// Kept in its own module (not in a component file) so behavior-only
-// consumers — the panel controller opens the tabs, the viewer routes them —
-// depend on the identity without pulling the transcript renderer into their
-// module graph (DD-003 headless-first). Mirrors artifact-document.ts and
-// file-change-document.ts.
-
-import { virtualEntryId } from "../internal/store/index.js";
-
-/**
- * Virtual entry id of the agent-execution transcript document FAMILY. Like
- * artifacts and file changes (and unlike the session's single plan tab),
- * transcripts are many: every opened child AgentExecution shares this one
- * entry id and is distinguished by its id-derived tab path, so
- * `editorKey(AGENT_EXECUTION_DOCUMENT_ENTRY_ID, path)` yields one tab per
- * child execution — the VS Code "each file is a tab" model. The
- * NUL-namespaced virtual id can never alias a real workspace entry, and its
- * distinct `"agentexec"` kind can never collide with the
- * `"artifact"`/`"filechange"`/`"plan"` families.
- */
-export const AGENT_EXECUTION_DOCUMENT_ENTRY_ID = virtualEntryId("agentexec");
-
-/**
- * The identity of a child AgentExecution's transcript tab within the family.
- *
- * The path deliberately CARRIES the child execution id (unlike artifact tabs,
- * which need an owner-level record map to resolve content): a transcript
- * needs only the id to fetch/stream itself, so the viewer parses it straight
- * back out with {@link parseAgentExecutionTabPath} — no lookup map to keep in
- * sync. The suffix is the AGENT_CALL task name because the editor tab's LABEL
- * is the path's basename: the task name correlates the tab with the DAG node
- * the user opened it from, and keeps two calls to the same agent distinct.
- */
-export function agentExecutionTabPath(
-  childExecutionId: string,
-  taskName: string,
-): string {
-  return `${childExecutionId}/${taskName}`;
-}
-
-/**
- * Recovers the child execution id from a transcript tab's path — the inverse
- * of {@link agentExecutionTabPath}. Splits on the FIRST separator: execution
- * ids never contain `/`, so a task name that does still round-trips.
- */
-export function parseAgentExecutionTabPath(path: string): string {
-  const separator = path.indexOf("/");
-  return separator === -1 ? path : path.slice(0, separator);
-}

package/src/workflow/WorkflowAgentExecutionDocument.tsx

@@ -1,283 +0,0 @@
-"use client";
-
-// Editor-area document rendering one child AgentExecution's full transcript.
-// Domain: workflow (the AGENT_CALL counterpart of WorkflowArtifactDocument).
-
-import { memo, useCallback, useMemo } from "react";
-import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
-import {
-  FileChangeSetStatus,
-  type FileDecisionAction,
-} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import type { FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
-import { displayFileChangeSets } from "@stigmer/sdk";
-import { cn } from "@stigmer/theme";
-import { useLiveAgentExecution } from "../execution/useLiveAgentExecution.js";
-import { MessageThread } from "../execution/MessageThread.js";
-import { ThreadSkeleton } from "../execution/ThreadSkeleton.js";
-import { ExecutionPhaseBadge } from "../execution/ExecutionPhaseBadge.js";
-import { FileReviewDock } from "../execution/FileReviewDock.js";
-import type { FileDecisionOptions } from "../execution/useFileReview.js";
-import { isTerminalPhase } from "../execution/execution-phases.js";
-import type { UseWorkflowExecutionActionsReturn } from "./useWorkflowExecutionActions.js";
-
-/** Stable empty list so the thread's memoized rows keep identity (DD-010). */
-const EMPTY_EXECUTIONS: readonly AgentExecution[] = [];
-
-/**
- * The HITL wiring for a child transcript: the slice of
- * {@link UseWorkflowExecutionActionsReturn} the document needs to submit
- * child-gate decisions at the WORKFLOW level.
- *
- * A `Pick` (not a new shape) so the bundle can never drift from the actions
- * hook — the viewer builds it from its single `useWorkflowExecutionActions`
- * instance, which is the same keyed in-flight/error state the bottom
- * Approvals tab renders. One instance, two surfaces: a spinner or failure on
- * a gate is identical wherever that gate is shown.
- */
-export type WorkflowAgentExecutionHitl = Pick<
-  UseWorkflowExecutionActionsReturn,
-  | "submitApproval"
-  | "approvalSubmittingToolCallIds"
-  | "approvalErrorsByToolCallId"
-  | "submitFileDecision"
-  | "fileDecisionSubmittingKeys"
-  | "fileDecisionErrorsByKey"
->;
-
-/** Props for {@link WorkflowAgentExecutionDocument}. */
-export interface WorkflowAgentExecutionDocumentProps {
-  /** ID of the child AgentExecution whose transcript to render. */
-  readonly childExecutionId: string;
-  /** The AGENT_CALL task that spawned the child — the document's title. */
-  readonly taskName: string;
-  /** Slug of the agent the task called, when known (subtitle context). */
-  readonly agentSlug?: string;
-  /**
-   * Open the child execution as a standalone page — the pop-out escape hatch
-   * preserved from the inspector's Agent tab. Host-routed (DD-004).
-   */
-  readonly onNavigateToAgentExecution?: (agentExecutionId: string) => void;
-  /**
-   * Workflow-level HITL handlers (S5 of the UX-parity project). When
-   * provided, the transcript becomes interactive: tool-approval gates render
-   * their decision cards inline on the gated rows, and pending file reviews
-   * dock at the bottom of the document. When omitted, the transcript is
-   * read-only — gates show status only (backward compatible, DD-011).
-   */
-  readonly hitl?: WorkflowAgentExecutionHitl;
-  /** Additional CSS classes for the root element. */
-  readonly className?: string;
-}
-
-/**
- * The editor-pane rendering of a child AgentExecution's transcript — the
- * `SurfaceVirtualDocument` body the workflow execution panel mounts when an
- * AGENT_CALL task is opened in place (S4 of the UX-parity project). This is
- * the full session-grade experience — streaming `MessageThread` with tool
- * calls, sub-agents, plan cards, and (with {@link
- * WorkflowAgentExecutionDocumentProps.hitl | hitl}) in-place HITL —
- * replacing the inspector's cramped `max-h-[50vh]` thumbnail.
- *
- * HITL ROUTING. Child gates are decided through the WORKFLOW-level RPCs
- * (`WorkflowExecution.submitApproval` / `submitFileDecision`), never the
- * child's own `agentExecution.*` submit path. The two paths are
- * server-equivalent (the workflow RPC forwards to the child — see
- * workflowexecution command.proto), but they differ in authorization: the
- * workflow RPC checks `can_edit` on the workflow execution — the resource
- * the operator owns — while the child path checks the runner-spawned
- * AgentExecution, which the operator may not. Every workflow HITL surface
- * (bottom Approvals tab, inspector) routes this way; the transcript joins
- * them via the same actions instance, so in-flight/error state never forks.
- *
- * FILE-REVIEW DOCK. Pending (AWAITING_REVIEW) sets derive from the CHILD's
- * own live stream — the freshest source this document already holds — not
- * from the parent's `status.pending_file_reviews`: the parent snapshot is
- * fetched once at mount and may lag a mid-run gate, which would blank the
- * dock exactly when the reviewer is watching live. The server validates
- * routing against its own (fresh) stored status at submit time, so a
- * too-early decision degrades to a retryable in-card error, the same
- * treatment tool approvals get. Docked below the thread (mirroring the
- * session's composer dock) so a decision the agent is blocked on can never
- * scroll out of view; settled sets render as read-only records in-thread
- * (`showFileReviewRecords`), never in the dock — the two surfaces partition
- * by the same pending test `MessageThread` uses.
- *
- * Lifecycle: the surface's editor area mounts only the ACTIVE virtual
- * document, so `useLiveAgentExecution` fetches/streams only while this tab
- * is foregrounded (DD-LIVE-006 — at most one child stream is ever live) and
- * a tab-return re-renders instantly from the DD-014 fetch cache.
- *
- * All visual properties flow through `--stgm-*` tokens (DD-005).
- */
-export const WorkflowAgentExecutionDocument = memo(
-  function WorkflowAgentExecutionDocument({
-    childExecutionId,
-    taskName,
-    agentSlug,
-    onNavigateToAgentExecution,
-    hitl,
-    className,
-  }: WorkflowAgentExecutionDocumentProps) {
-    const { execution, phase, isLoading, isStreaming, isReconnecting, error, reconnect } =
-      useLiveAgentExecution(childExecutionId);
-
-    // Pending file reviews from the child's own (streamed) status — see the
-    // component doc for why the parent's pending_file_reviews is not the
-    // source. Terminal executions never dock: their AWAITING_REVIEW sets are
-    // settled history ("not reviewed") and render as in-thread records — the
-    // exact complement of MessageThread's pending test, so no set ever
-    // appears in both surfaces.
-    const terminal = isTerminalPhase(phase);
-    const pendingReviewSets = useMemo<readonly FileChangeSet[]>(() => {
-      if (terminal) return [];
-      return displayFileChangeSets(execution?.status).filter(
-        (cs) =>
-          cs.status === FileChangeSetStatus.AWAITING_REVIEW &&
-          cs.changes.length > 0,
-      );
-    }, [execution?.status, terminal]);
-
-    // Bind the child id into the dock's card-level submit signature. Deps are
-    // the specific method (DD-010), so the callback survives unrelated
-    // in-flight churn on the actions instance.
-    const submitFileDecision = hitl?.submitFileDecision;
-    const handleFileDecision = useCallback(
-      (changeSetId: string, action: FileDecisionAction, options?: FileDecisionOptions) => {
-        submitFileDecision?.(childExecutionId, changeSetId, action, options);
-      },
-      [submitFileDecision, childExecutionId],
-    );
-
-    return (
-      <div
-        role="article"
-        aria-label={`Agent execution for task ${taskName}`}
-        className={cn("flex h-full min-w-0 flex-col", className)}
-      >
-        {/* Slim identity header: task name (the DAG node this transcript
-            belongs to), agent slug, live/phase state, and the standalone
-            pop-out. Wraps on narrow panes rather than overflowing. */}
-        <div className="flex min-w-0 shrink-0 flex-wrap items-center gap-x-3 gap-y-1 border-b border-border bg-background px-4 py-2">
-          <span className="truncate text-sm font-medium text-foreground">
-            {taskName}
-          </span>
-          {agentSlug && (
-            <span className="shrink-0 text-xs text-muted-foreground">
-              {agentSlug}
-            </span>
-          )}
-
-          <span className="shrink-0">
-            {isStreaming ? (
-              <span className="inline-flex items-center gap-1.5 text-xs font-medium text-primary">
-                <span className="inline-block size-1.5 animate-pulse rounded-full bg-primary" aria-hidden="true" />
-                Live
-              </span>
-            ) : isReconnecting ? (
-              <span className="text-xs text-muted-foreground">Reconnecting…</span>
-            ) : isTerminalPhase(phase) ? (
-              <ExecutionPhaseBadge phase={phase} />
-            ) : null}
-          </span>
-
-          {onNavigateToAgentExecution && (
-            <button
-              type="button"
-              onClick={() => onNavigateToAgentExecution(childExecutionId)}
-              className="ml-auto inline-flex shrink-0 items-center gap-1.5 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded-sm"
-            >
-              <PopOutIcon />
-              Open standalone
-            </button>
-          )}
-        </div>
-
-        {/* The thread owns the scrolling (its auto-scroll machine + jump-to-
-            latest need the scroll container); h-full keeps the surrounding
-            editor-pane wrapper inert, so there is exactly one scrollbar. */}
-        <div className="min-h-0 min-w-0 flex-1">
-          {execution ? (
-            <MessageThread
-              executions={EMPTY_EXECUTIONS}
-              activeStreamExecution={execution}
-              onApprovalSubmit={hitl?.submitApproval}
-              submittingApprovalIds={hitl?.approvalSubmittingToolCallIds}
-              approvalErrors={hitl?.approvalErrorsByToolCallId}
-              showFileReviewRecords={hitl != null}
-              className="h-full"
-            />
-          ) : isLoading ? (
-            <ThreadSkeleton className="px-4 py-4" />
-          ) : error ? (
-            <div
-              role="alert"
-              className="mx-auto flex w-full max-w-3xl flex-col items-center gap-2 px-4 py-8 text-center"
-            >
-              <p className="text-xs text-destructive">{error.message}</p>
-              <button
-                type="button"
-                onClick={reconnect}
-                className="rounded border border-border px-3 py-1.5 text-xs font-medium text-foreground hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-              >
-                Retry
-              </button>
-            </div>
-          ) : (
-            <div
-              role="status"
-              className="mx-auto flex w-full max-w-3xl flex-col items-center gap-1 px-4 py-8 text-center"
-            >
-              <p className="text-xs font-medium text-foreground">
-                This agent execution is no longer available.
-              </p>
-              <p className="text-xs text-muted-foreground">
-                It may have been removed, or the workflow run predates
-                transcript retention.
-              </p>
-            </div>
-          )}
-        </div>
-
-        {/* Pending file reviews dock here — pinned below the thread (the
-            document has no composer, so the panel bottom is the fixed strip)
-            where the decision the child is blocked on can never scroll out
-            of view. Same shape as the session's composer dock. */}
-        {hitl && pendingReviewSets.length > 0 && (
-          <FileReviewDock
-            changeSets={pendingReviewSets}
-            onSubmit={handleFileDecision}
-            submittingDecisionKeys={hitl.fileDecisionSubmittingKeys}
-            decisionErrors={hitl.fileDecisionErrorsByKey}
-            className="shrink-0"
-          />
-        )}
-      </div>
-    );
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Inline SVG icons (SDK independence — no lucide dependency)
-// ---------------------------------------------------------------------------
-
-function PopOutIcon() {
-  return (
-    <svg
-      width="12"
-      height="12"
-      viewBox="0 0 12 12"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="1.3"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      className="shrink-0"
-      aria-hidden="true"
-    >
-      <path d="M10.5 4.5V1.5H7.5" />
-      <path d="M10.5 1.5L6 6" />
-      <path d="M8.5 7v3a1 1 0 0 1-1 1h-5a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h3" />
-    </svg>
-  );
-}

package/workflow/WorkflowAgentExecutionDocument.d.ts

@@ -1,79 +0,0 @@
-import type { UseWorkflowExecutionActionsReturn } from "./useWorkflowExecutionActions.js";
-/**
- * The HITL wiring for a child transcript: the slice of
- * {@link UseWorkflowExecutionActionsReturn} the document needs to submit
- * child-gate decisions at the WORKFLOW level.
- *
- * A `Pick` (not a new shape) so the bundle can never drift from the actions
- * hook — the viewer builds it from its single `useWorkflowExecutionActions`
- * instance, which is the same keyed in-flight/error state the bottom
- * Approvals tab renders. One instance, two surfaces: a spinner or failure on
- * a gate is identical wherever that gate is shown.
- */
-export type WorkflowAgentExecutionHitl = Pick<UseWorkflowExecutionActionsReturn, "submitApproval" | "approvalSubmittingToolCallIds" | "approvalErrorsByToolCallId" | "submitFileDecision" | "fileDecisionSubmittingKeys" | "fileDecisionErrorsByKey">;
-/** Props for {@link WorkflowAgentExecutionDocument}. */
-export interface WorkflowAgentExecutionDocumentProps {
-    /** ID of the child AgentExecution whose transcript to render. */
-    readonly childExecutionId: string;
-    /** The AGENT_CALL task that spawned the child — the document's title. */
-    readonly taskName: string;
-    /** Slug of the agent the task called, when known (subtitle context). */
-    readonly agentSlug?: string;
-    /**
-     * Open the child execution as a standalone page — the pop-out escape hatch
-     * preserved from the inspector's Agent tab. Host-routed (DD-004).
-     */
-    readonly onNavigateToAgentExecution?: (agentExecutionId: string) => void;
-    /**
-     * Workflow-level HITL handlers (S5 of the UX-parity project). When
-     * provided, the transcript becomes interactive: tool-approval gates render
-     * their decision cards inline on the gated rows, and pending file reviews
-     * dock at the bottom of the document. When omitted, the transcript is
-     * read-only — gates show status only (backward compatible, DD-011).
-     */
-    readonly hitl?: WorkflowAgentExecutionHitl;
-    /** Additional CSS classes for the root element. */
-    readonly className?: string;
-}
-/**
- * The editor-pane rendering of a child AgentExecution's transcript — the
- * `SurfaceVirtualDocument` body the workflow execution panel mounts when an
- * AGENT_CALL task is opened in place (S4 of the UX-parity project). This is
- * the full session-grade experience — streaming `MessageThread` with tool
- * calls, sub-agents, plan cards, and (with {@link
- * WorkflowAgentExecutionDocumentProps.hitl | hitl}) in-place HITL —
- * replacing the inspector's cramped `max-h-[50vh]` thumbnail.
- *
- * HITL ROUTING. Child gates are decided through the WORKFLOW-level RPCs
- * (`WorkflowExecution.submitApproval` / `submitFileDecision`), never the
- * child's own `agentExecution.*` submit path. The two paths are
- * server-equivalent (the workflow RPC forwards to the child — see
- * workflowexecution command.proto), but they differ in authorization: the
- * workflow RPC checks `can_edit` on the workflow execution — the resource
- * the operator owns — while the child path checks the runner-spawned
- * AgentExecution, which the operator may not. Every workflow HITL surface
- * (bottom Approvals tab, inspector) routes this way; the transcript joins
- * them via the same actions instance, so in-flight/error state never forks.
- *
- * FILE-REVIEW DOCK. Pending (AWAITING_REVIEW) sets derive from the CHILD's
- * own live stream — the freshest source this document already holds — not
- * from the parent's `status.pending_file_reviews`: the parent snapshot is
- * fetched once at mount and may lag a mid-run gate, which would blank the
- * dock exactly when the reviewer is watching live. The server validates
- * routing against its own (fresh) stored status at submit time, so a
- * too-early decision degrades to a retryable in-card error, the same
- * treatment tool approvals get. Docked below the thread (mirroring the
- * session's composer dock) so a decision the agent is blocked on can never
- * scroll out of view; settled sets render as read-only records in-thread
- * (`showFileReviewRecords`), never in the dock — the two surfaces partition
- * by the same pending test `MessageThread` uses.
- *
- * Lifecycle: the surface's editor area mounts only the ACTIVE virtual
- * document, so `useLiveAgentExecution` fetches/streams only while this tab
- * is foregrounded (DD-LIVE-006 — at most one child stream is ever live) and
- * a tab-return re-renders instantly from the DD-014 fetch cache.
- *
- * All visual properties flow through `--stgm-*` tokens (DD-005).
- */
-export declare const WorkflowAgentExecutionDocument: import("react").NamedExoticComponent<WorkflowAgentExecutionDocumentProps>;
-//# sourceMappingURL=WorkflowAgentExecutionDocument.d.ts.map

package/workflow/WorkflowAgentExecutionDocument.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkflowAgentExecutionDocument.d.ts","sourceRoot":"","sources":["../../src/workflow/WorkflowAgentExecutionDocument.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAK1F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,iCAAiC,EAC/B,gBAAgB,GAChB,+BAA+B,GAC/B,4BAA4B,GAC5B,oBAAoB,GACpB,4BAA4B,GAC5B,yBAAyB,CAC5B,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,mCAAmC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,0BAA0B,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,8BAA8B,2EAiJ1C,CAAC"}

package/workflow/WorkflowAgentExecutionDocument.js

@@ -1,87 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Editor-area document rendering one child AgentExecution's full transcript.
-// Domain: workflow (the AGENT_CALL counterpart of WorkflowArtifactDocument).
-import { memo, useCallback, useMemo } from "react";
-import { FileChangeSetStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import { displayFileChangeSets } from "@stigmer/sdk";
-import { cn } from "@stigmer/theme";
-import { useLiveAgentExecution } from "../execution/useLiveAgentExecution.js";
-import { MessageThread } from "../execution/MessageThread.js";
-import { ThreadSkeleton } from "../execution/ThreadSkeleton.js";
-import { ExecutionPhaseBadge } from "../execution/ExecutionPhaseBadge.js";
-import { FileReviewDock } from "../execution/FileReviewDock.js";
-import { isTerminalPhase } from "../execution/execution-phases.js";
-/** Stable empty list so the thread's memoized rows keep identity (DD-010). */
-const EMPTY_EXECUTIONS = [];
-/**
- * The editor-pane rendering of a child AgentExecution's transcript — the
- * `SurfaceVirtualDocument` body the workflow execution panel mounts when an
- * AGENT_CALL task is opened in place (S4 of the UX-parity project). This is
- * the full session-grade experience — streaming `MessageThread` with tool
- * calls, sub-agents, plan cards, and (with {@link
- * WorkflowAgentExecutionDocumentProps.hitl | hitl}) in-place HITL —
- * replacing the inspector's cramped `max-h-[50vh]` thumbnail.
- *
- * HITL ROUTING. Child gates are decided through the WORKFLOW-level RPCs
- * (`WorkflowExecution.submitApproval` / `submitFileDecision`), never the
- * child's own `agentExecution.*` submit path. The two paths are
- * server-equivalent (the workflow RPC forwards to the child — see
- * workflowexecution command.proto), but they differ in authorization: the
- * workflow RPC checks `can_edit` on the workflow execution — the resource
- * the operator owns — while the child path checks the runner-spawned
- * AgentExecution, which the operator may not. Every workflow HITL surface
- * (bottom Approvals tab, inspector) routes this way; the transcript joins
- * them via the same actions instance, so in-flight/error state never forks.
- *
- * FILE-REVIEW DOCK. Pending (AWAITING_REVIEW) sets derive from the CHILD's
- * own live stream — the freshest source this document already holds — not
- * from the parent's `status.pending_file_reviews`: the parent snapshot is
- * fetched once at mount and may lag a mid-run gate, which would blank the
- * dock exactly when the reviewer is watching live. The server validates
- * routing against its own (fresh) stored status at submit time, so a
- * too-early decision degrades to a retryable in-card error, the same
- * treatment tool approvals get. Docked below the thread (mirroring the
- * session's composer dock) so a decision the agent is blocked on can never
- * scroll out of view; settled sets render as read-only records in-thread
- * (`showFileReviewRecords`), never in the dock — the two surfaces partition
- * by the same pending test `MessageThread` uses.
- *
- * Lifecycle: the surface's editor area mounts only the ACTIVE virtual
- * document, so `useLiveAgentExecution` fetches/streams only while this tab
- * is foregrounded (DD-LIVE-006 — at most one child stream is ever live) and
- * a tab-return re-renders instantly from the DD-014 fetch cache.
- *
- * All visual properties flow through `--stgm-*` tokens (DD-005).
- */
-export const WorkflowAgentExecutionDocument = memo(function WorkflowAgentExecutionDocument({ childExecutionId, taskName, agentSlug, onNavigateToAgentExecution, hitl, className, }) {
-    const { execution, phase, isLoading, isStreaming, isReconnecting, error, reconnect } = useLiveAgentExecution(childExecutionId);
-    // Pending file reviews from the child's own (streamed) status — see the
-    // component doc for why the parent's pending_file_reviews is not the
-    // source. Terminal executions never dock: their AWAITING_REVIEW sets are
-    // settled history ("not reviewed") and render as in-thread records — the
-    // exact complement of MessageThread's pending test, so no set ever
-    // appears in both surfaces.
-    const terminal = isTerminalPhase(phase);
-    const pendingReviewSets = useMemo(() => {
-        if (terminal)
-            return [];
-        return displayFileChangeSets(execution?.status).filter((cs) => cs.status === FileChangeSetStatus.AWAITING_REVIEW &&
-            cs.changes.length > 0);
-    }, [execution?.status, terminal]);
-    // Bind the child id into the dock's card-level submit signature. Deps are
-    // the specific method (DD-010), so the callback survives unrelated
-    // in-flight churn on the actions instance.
-    const submitFileDecision = hitl?.submitFileDecision;
-    const handleFileDecision = useCallback((changeSetId, action, options) => {
-        submitFileDecision?.(childExecutionId, changeSetId, action, options);
-    }, [submitFileDecision, childExecutionId]);
-    return (_jsxs("div", { role: "article", "aria-label": `Agent execution for task ${taskName}`, className: cn("flex h-full min-w-0 flex-col", className), children: [_jsxs("div", { className: "flex min-w-0 shrink-0 flex-wrap items-center gap-x-3 gap-y-1 border-b border-border bg-background px-4 py-2", children: [_jsx("span", { className: "truncate text-sm font-medium text-foreground", children: taskName }), agentSlug && (_jsx("span", { className: "shrink-0 text-xs text-muted-foreground", children: agentSlug })), _jsx("span", { className: "shrink-0", children: isStreaming ? (_jsxs("span", { className: "inline-flex items-center gap-1.5 text-xs font-medium text-primary", children: [_jsx("span", { className: "inline-block size-1.5 animate-pulse rounded-full bg-primary", "aria-hidden": "true" }), "Live"] })) : isReconnecting ? (_jsx("span", { className: "text-xs text-muted-foreground", children: "Reconnecting\u2026" })) : isTerminalPhase(phase) ? (_jsx(ExecutionPhaseBadge, { phase: phase })) : null }), onNavigateToAgentExecution && (_jsxs("button", { type: "button", onClick: () => onNavigateToAgentExecution(childExecutionId), className: "ml-auto inline-flex shrink-0 items-center gap-1.5 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded-sm", children: [_jsx(PopOutIcon, {}), "Open standalone"] }))] }), _jsx("div", { className: "min-h-0 min-w-0 flex-1", children: execution ? (_jsx(MessageThread, { executions: EMPTY_EXECUTIONS, activeStreamExecution: execution, onApprovalSubmit: hitl?.submitApproval, submittingApprovalIds: hitl?.approvalSubmittingToolCallIds, approvalErrors: hitl?.approvalErrorsByToolCallId, showFileReviewRecords: hitl != null, className: "h-full" })) : isLoading ? (_jsx(ThreadSkeleton, { className: "px-4 py-4" })) : error ? (_jsxs("div", { role: "alert", className: "mx-auto flex w-full max-w-3xl flex-col items-center gap-2 px-4 py-8 text-center", children: [_jsx("p", { className: "text-xs text-destructive", children: error.message }), _jsx("button", { type: "button", onClick: reconnect, className: "rounded border border-border px-3 py-1.5 text-xs font-medium text-foreground hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: "Retry" })] })) : (_jsxs("div", { role: "status", className: "mx-auto flex w-full max-w-3xl flex-col items-center gap-1 px-4 py-8 text-center", children: [_jsx("p", { className: "text-xs font-medium text-foreground", children: "This agent execution is no longer available." }), _jsx("p", { className: "text-xs text-muted-foreground", children: "It may have been removed, or the workflow run predates transcript retention." })] })) }), hitl && pendingReviewSets.length > 0 && (_jsx(FileReviewDock, { changeSets: pendingReviewSets, onSubmit: handleFileDecision, submittingDecisionKeys: hitl.fileDecisionSubmittingKeys, decisionErrors: hitl.fileDecisionErrorsByKey, className: "shrink-0" }))] }));
-});
-// ---------------------------------------------------------------------------
-// Inline SVG icons (SDK independence — no lucide dependency)
-// ---------------------------------------------------------------------------
-function PopOutIcon() {
-    return (_jsxs("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.3", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0", "aria-hidden": "true", children: [_jsx("path", { d: "M10.5 4.5V1.5H7.5" }), _jsx("path", { d: "M10.5 1.5L6 6" }), _jsx("path", { d: "M8.5 7v3a1 1 0 0 1-1 1h-5a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h3" })] }));
-}
-//# sourceMappingURL=WorkflowAgentExecutionDocument.js.map

package/workflow/WorkflowAgentExecutionDocument.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkflowAgentExecutionDocument.js","sourceRoot":"","sources":["../../src/workflow/WorkflowAgentExecutionDocument.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,6EAA6E;AAC7E,6EAA6E;AAE7E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,EACL,mBAAmB,GAEpB,MAAM,8DAA8D,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,8EAA8E;AAC9E,MAAM,gBAAgB,GAA8B,EAAE,CAAC;AAgDvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAChD,SAAS,8BAA8B,CAAC,EACtC,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,0BAA0B,EAC1B,IAAI,EACJ,SAAS,GAC2B;IACpC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,GAClF,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAE1C,wEAAwE;IACxE,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,iBAAiB,GAAG,OAAO,CAA2B,GAAG,EAAE;QAC/D,IAAI,QAAQ;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CACpD,CAAC,EAAE,EAAE,EAAE,CACL,EAAE,CAAC,MAAM,KAAK,mBAAmB,CAAC,eAAe;YACjD,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CACxB,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElC,0EAA0E;IAC1E,mEAAmE;IACnE,2CAA2C;IAC3C,MAAM,kBAAkB,GAAG,IAAI,EAAE,kBAAkB,CAAC;IACpD,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,WAAmB,EAAE,MAA0B,EAAE,OAA6B,EAAE,EAAE;QACjF,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,EACD,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CACvC,CAAC;IAEF,OAAO,CACL,eACE,IAAI,EAAC,SAAS,gBACF,4BAA4B,QAAQ,EAAE,EAClD,SAAS,EAAE,EAAE,CAAC,8BAA8B,EAAE,SAAS,CAAC,aAKxD,eAAK,SAAS,EAAC,6GAA6G,aAC1H,eAAM,SAAS,EAAC,8CAA8C,YAC3D,QAAQ,GACJ,EACN,SAAS,IAAI,CACZ,eAAM,SAAS,EAAC,wCAAwC,YACrD,SAAS,GACL,CACR,EAED,eAAM,SAAS,EAAC,UAAU,YACvB,WAAW,CAAC,CAAC,CAAC,CACb,gBAAM,SAAS,EAAC,mEAAmE,aACjF,eAAM,SAAS,EAAC,6DAA6D,iBAAa,MAAM,GAAG,YAE9F,CACR,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CACnB,eAAM,SAAS,EAAC,+BAA+B,mCAAqB,CACrE,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC3B,KAAC,mBAAmB,IAAC,KAAK,EAAE,KAAK,GAAI,CACtC,CAAC,CAAC,CAAC,IAAI,GACH,EAEN,0BAA0B,IAAI,CAC7B,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,EAC3D,SAAS,EAAC,sOAAsO,aAEhP,KAAC,UAAU,KAAG,uBAEP,CACV,IACG,EAKN,cAAK,SAAS,EAAC,wBAAwB,YACpC,SAAS,CAAC,CAAC,CAAC,CACX,KAAC,aAAa,IACZ,UAAU,EAAE,gBAAgB,EAC5B,qBAAqB,EAAE,SAAS,EAChC,gBAAgB,EAAE,IAAI,EAAE,cAAc,EACtC,qBAAqB,EAAE,IAAI,EAAE,6BAA6B,EAC1D,cAAc,EAAE,IAAI,EAAE,0BAA0B,EAChD,qBAAqB,EAAE,IAAI,IAAI,IAAI,EACnC,SAAS,EAAC,QAAQ,GAClB,CACH,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CACd,KAAC,cAAc,IAAC,SAAS,EAAC,WAAW,GAAG,CACzC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACV,eACE,IAAI,EAAC,OAAO,EACZ,SAAS,EAAC,iFAAiF,aAE3F,YAAG,SAAS,EAAC,0BAA0B,YAAE,KAAK,CAAC,OAAO,GAAK,EAC3D,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,SAAS,EAClB,SAAS,EAAC,qKAAqK,sBAGxK,IACL,CACP,CAAC,CAAC,CAAC,CACF,eACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,iFAAiF,aAE3F,YAAG,SAAS,EAAC,qCAAqC,6DAE9C,EACJ,YAAG,SAAS,EAAC,+BAA+B,6FAGxC,IACA,CACP,GACG,EAML,IAAI,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,CACvC,KAAC,cAAc,IACb,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,sBAAsB,EAAE,IAAI,CAAC,0BAA0B,EACvD,cAAc,EAAE,IAAI,CAAC,uBAAuB,EAC5C,SAAS,EAAC,UAAU,GACpB,CACH,IACG,CACP,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,SAAS,UAAU;IACjB,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,SAAS,EAAC,UAAU,iBACR,MAAM,aAElB,eAAM,CAAC,EAAC,mBAAmB,GAAG,EAC9B,eAAM,CAAC,EAAC,eAAe,GAAG,EAC1B,eAAM,CAAC,EAAC,2DAA2D,GAAG,IAClE,CACP,CAAC;AACJ,CAAC"}