@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7194.1.ab4fc81f82

package/dist/modules/workflows/components/run/RunStatusBadge.js

@@ -0,0 +1,82 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Check, Circle, CircleAlert, Pause, Play, SkipForward, Undo2, XCircle } from "lucide-react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { STATUS_COLORS } from "../../lib/status-colors.js";
+const STEP_STATUS_BADGES = {
+  completed: { tone: "completed", Icon: Check, fallbackLabel: "Completed" },
+  active: { tone: "in_progress", Icon: Play, fallbackLabel: "Running" },
+  failed: { tone: "failed", Icon: XCircle, fallbackLabel: "Failed" },
+  skipped: { tone: "pending", Icon: SkipForward, fallbackLabel: "Skipped" },
+  paused: { tone: "paused", Icon: Pause, fallbackLabel: "Waiting" },
+  pending: { tone: "not_started", Icon: Circle, fallbackLabel: "Not started" }
+};
+const INSTANCE_STATUS_BADGES = {
+  RUNNING: { tone: "in_progress", Icon: Play, fallbackLabel: "Running" },
+  PAUSED: { tone: "paused", Icon: Pause, fallbackLabel: "Paused" },
+  WAITING_FOR_ACTIVITIES: { tone: "paused", Icon: Pause, fallbackLabel: "Waiting for activities" },
+  FORKED: { tone: "in_progress", Icon: Play, fallbackLabel: "Forked" },
+  COMPLETED: { tone: "completed", Icon: Check, fallbackLabel: "Completed" },
+  FAILED: { tone: "failed", Icon: XCircle, fallbackLabel: "Failed" },
+  CANCELLED: { tone: "not_started", Icon: SkipForward, fallbackLabel: "Cancelled" },
+  COMPENSATING: { tone: "pending", Icon: CircleAlert, fallbackLabel: "Compensating" },
+  COMPENSATED: { tone: "pending", Icon: Undo2, fallbackLabel: "Compensated" }
+};
+const UNKNOWN_BADGE = { tone: "not_started", Icon: Circle, fallbackLabel: "Unknown" };
+function stepStatusLabelKey(status) {
+  const descriptor = STEP_STATUS_BADGES[status] ?? UNKNOWN_BADGE;
+  return { key: `workflows.instances.run.stepStatus.${status}`, fallback: descriptor.fallbackLabel };
+}
+function instanceStatusBadgeClass(status) {
+  const colors = STATUS_COLORS[(INSTANCE_STATUS_BADGES[status] ?? UNKNOWN_BADGE).tone];
+  return `${colors.bg} ${colors.text}`;
+}
+function Badge({
+  descriptor,
+  label,
+  className
+}) {
+  const colors = STATUS_COLORS[descriptor.tone];
+  const { Icon } = descriptor;
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: `inline-flex items-center gap-1.5 rounded px-2 py-1 text-xs font-medium ${colors.bg} ${colors.text} ${className}`,
+      children: [
+        /* @__PURE__ */ jsx(Icon, { className: `h-3.5 w-3.5 shrink-0 ${colors.icon}`, "aria-hidden": "true" }),
+        label
+      ]
+    }
+  );
+}
+function RunStatusBadge({ status, className = "" }) {
+  const t = useT();
+  const descriptor = STEP_STATUS_BADGES[status] ?? UNKNOWN_BADGE;
+  return /* @__PURE__ */ jsx(
+    Badge,
+    {
+      descriptor,
+      label: t(`workflows.instances.run.stepStatus.${status}`, descriptor.fallbackLabel),
+      className
+    }
+  );
+}
+function InstanceStatusBadge({ status, className = "" }) {
+  const t = useT();
+  const descriptor = INSTANCE_STATUS_BADGES[status] ?? UNKNOWN_BADGE;
+  return /* @__PURE__ */ jsx(
+    Badge,
+    {
+      descriptor,
+      label: t(`workflows.instances.status.${status}`, descriptor.fallbackLabel),
+      className
+    }
+  );
+}
+export {
+  InstanceStatusBadge,
+  RunStatusBadge,
+  instanceStatusBadgeClass,
+  stepStatusLabelKey
+};
+//# sourceMappingURL=RunStatusBadge.js.map

package/dist/modules/workflows/components/run/RunStatusBadge.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/RunStatusBadge.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { Check, Circle, CircleAlert, Pause, Play, SkipForward, Undo2, XCircle } from 'lucide-react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { STATUS_COLORS, type WorkflowStatus, type StepRunStatus } from '../../lib/status-colors'\n\ntype BadgeDescriptor = {\n  tone: WorkflowStatus\n  Icon: React.ComponentType<{ className?: string }>\n  fallbackLabel: string\n}\n\n/**\n * `toWorkflowStatus` is the CANVAS mapping and deliberately collapses anything\n * it does not know to `not_started`, which would paint a skipped step and a\n * never-run step identically. A badge carries a label, so it can afford \u2014 and\n * needs \u2014 the finer vocabulary.\n */\nconst STEP_STATUS_BADGES: Record<StepRunStatus, BadgeDescriptor> = {\n  completed: { tone: 'completed', Icon: Check, fallbackLabel: 'Completed' },\n  active: { tone: 'in_progress', Icon: Play, fallbackLabel: 'Running' },\n  failed: { tone: 'failed', Icon: XCircle, fallbackLabel: 'Failed' },\n  skipped: { tone: 'pending', Icon: SkipForward, fallbackLabel: 'Skipped' },\n  paused: { tone: 'paused', Icon: Pause, fallbackLabel: 'Waiting' },\n  pending: { tone: 'not_started', Icon: Circle, fallbackLabel: 'Not started' },\n}\n\nconst INSTANCE_STATUS_BADGES: Record<string, BadgeDescriptor> = {\n  RUNNING: { tone: 'in_progress', Icon: Play, fallbackLabel: 'Running' },\n  PAUSED: { tone: 'paused', Icon: Pause, fallbackLabel: 'Paused' },\n  WAITING_FOR_ACTIVITIES: { tone: 'paused', Icon: Pause, fallbackLabel: 'Waiting for activities' },\n  FORKED: { tone: 'in_progress', Icon: Play, fallbackLabel: 'Forked' },\n  COMPLETED: { tone: 'completed', Icon: Check, fallbackLabel: 'Completed' },\n  FAILED: { tone: 'failed', Icon: XCircle, fallbackLabel: 'Failed' },\n  CANCELLED: { tone: 'not_started', Icon: SkipForward, fallbackLabel: 'Cancelled' },\n  COMPENSATING: { tone: 'pending', Icon: CircleAlert, fallbackLabel: 'Compensating' },\n  COMPENSATED: { tone: 'pending', Icon: Undo2, fallbackLabel: 'Compensated' },\n}\n\nconst UNKNOWN_BADGE: BadgeDescriptor = { tone: 'not_started', Icon: Circle, fallbackLabel: 'Unknown' }\n\n/** The i18n key + English fallback for one step status, shared with the Gantt. */\nexport function stepStatusLabelKey(status: StepRunStatus): { key: string; fallback: string } {\n  const descriptor = STEP_STATUS_BADGES[status] ?? UNKNOWN_BADGE\n  return { key: `workflows.instances.run.stepStatus.${status}`, fallback: descriptor.fallbackLabel }\n}\n\n/**\n * Class-only form, for the mobile overview which takes a class callback rather\n * than a component. Reads the same descriptor table, so the two surfaces can\n * never drift apart.\n */\nexport function instanceStatusBadgeClass(status: string): string {\n  const colors = STATUS_COLORS[(INSTANCE_STATUS_BADGES[status] ?? UNKNOWN_BADGE).tone]\n  return `${colors.bg} ${colors.text}`\n}\n\nfunction Badge({\n  descriptor,\n  label,\n  className,\n}: {\n  descriptor: BadgeDescriptor\n  label: string\n  className: string\n}) {\n  const colors = STATUS_COLORS[descriptor.tone]\n  const { Icon } = descriptor\n  return (\n    <span\n      className={`inline-flex items-center gap-1.5 rounded px-2 py-1 text-xs font-medium ${colors.bg} ${colors.text} ${className}`}\n    >\n      <Icon className={`h-3.5 w-3.5 shrink-0 ${colors.icon}`} aria-hidden=\"true\" />\n      {label}\n    </span>\n  )\n}\n\n/**\n * Spec \u00A74.6 acceptance criterion \u2014 status is never colour-only. Every badge\n * pairs its DS status token with its own glyph shape AND a text label, so the\n * same red is never the sole difference between two states.\n */\nexport function RunStatusBadge({ status, className = '' }: { status: StepRunStatus; className?: string }) {\n  const t = useT()\n  const descriptor = STEP_STATUS_BADGES[status] ?? UNKNOWN_BADGE\n  return (\n    <Badge\n      descriptor={descriptor}\n      label={t(`workflows.instances.run.stepStatus.${status}`, descriptor.fallbackLabel)}\n      className={className}\n    />\n  )\n}\n\n/**\n * Instance-level counterpart. `WorkflowInstance.status` is a wider vocabulary\n * than the step one (it carries the compensation states), so it gets its own\n * map rather than being squeezed through the step vocabulary.\n */\nexport function InstanceStatusBadge({ status, className = '' }: { status: string; className?: string }) {\n  const t = useT()\n  const descriptor = INSTANCE_STATUS_BADGES[status] ?? UNKNOWN_BADGE\n  return (\n    <Badge\n      descriptor={descriptor}\n      label={t(`workflows.instances.status.${status}`, descriptor.fallbackLabel)}\n      className={className}\n    />\n  )\n}\n"],
+  "mappings": ";AAsEI,SAGE,KAHF;AAnEJ,SAAS,OAAO,QAAQ,aAAa,OAAO,MAAM,aAAa,OAAO,eAAe;AACrF,SAAS,YAAY;AACrB,SAAS,qBAA8D;AAcvE,MAAM,qBAA6D;AAAA,EACjE,WAAW,EAAE,MAAM,aAAa,MAAM,OAAO,eAAe,YAAY;AAAA,EACxE,QAAQ,EAAE,MAAM,eAAe,MAAM,MAAM,eAAe,UAAU;AAAA,EACpE,QAAQ,EAAE,MAAM,UAAU,MAAM,SAAS,eAAe,SAAS;AAAA,EACjE,SAAS,EAAE,MAAM,WAAW,MAAM,aAAa,eAAe,UAAU;AAAA,EACxE,QAAQ,EAAE,MAAM,UAAU,MAAM,OAAO,eAAe,UAAU;AAAA,EAChE,SAAS,EAAE,MAAM,eAAe,MAAM,QAAQ,eAAe,cAAc;AAC7E;AAEA,MAAM,yBAA0D;AAAA,EAC9D,SAAS,EAAE,MAAM,eAAe,MAAM,MAAM,eAAe,UAAU;AAAA,EACrE,QAAQ,EAAE,MAAM,UAAU,MAAM,OAAO,eAAe,SAAS;AAAA,EAC/D,wBAAwB,EAAE,MAAM,UAAU,MAAM,OAAO,eAAe,yBAAyB;AAAA,EAC/F,QAAQ,EAAE,MAAM,eAAe,MAAM,MAAM,eAAe,SAAS;AAAA,EACnE,WAAW,EAAE,MAAM,aAAa,MAAM,OAAO,eAAe,YAAY;AAAA,EACxE,QAAQ,EAAE,MAAM,UAAU,MAAM,SAAS,eAAe,SAAS;AAAA,EACjE,WAAW,EAAE,MAAM,eAAe,MAAM,aAAa,eAAe,YAAY;AAAA,EAChF,cAAc,EAAE,MAAM,WAAW,MAAM,aAAa,eAAe,eAAe;AAAA,EAClF,aAAa,EAAE,MAAM,WAAW,MAAM,OAAO,eAAe,cAAc;AAC5E;AAEA,MAAM,gBAAiC,EAAE,MAAM,eAAe,MAAM,QAAQ,eAAe,UAAU;AAG9F,SAAS,mBAAmB,QAA0D;AAC3F,QAAM,aAAa,mBAAmB,MAAM,KAAK;AACjD,SAAO,EAAE,KAAK,sCAAsC,MAAM,IAAI,UAAU,WAAW,cAAc;AACnG;AAOO,SAAS,yBAAyB,QAAwB;AAC/D,QAAM,SAAS,eAAe,uBAAuB,MAAM,KAAK,eAAe,IAAI;AACnF,SAAO,GAAG,OAAO,EAAE,IAAI,OAAO,IAAI;AACpC;AAEA,SAAS,MAAM;AAAA,EACb;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,SAAS,cAAc,WAAW,IAAI;AAC5C,QAAM,EAAE,KAAK,IAAI;AACjB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,0EAA0E,OAAO,EAAE,IAAI,OAAO,IAAI,IAAI,SAAS;AAAA,MAE1H;AAAA,4BAAC,QAAK,WAAW,wBAAwB,OAAO,IAAI,IAAI,eAAY,QAAO;AAAA,QAC1E;AAAA;AAAA;AAAA,EACH;AAEJ;AAOO,SAAS,eAAe,EAAE,QAAQ,YAAY,GAAG,GAAkD;AACxG,QAAM,IAAI,KAAK;AACf,QAAM,aAAa,mBAAmB,MAAM,KAAK;AACjD,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,EAAE,sCAAsC,MAAM,IAAI,WAAW,aAAa;AAAA,MACjF;AAAA;AAAA,EACF;AAEJ;AAOO,SAAS,oBAAoB,EAAE,QAAQ,YAAY,GAAG,GAA2C;AACtG,QAAM,IAAI,KAAK;AACf,QAAM,aAAa,uBAAuB,MAAM,KAAK;AACrD,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,EAAE,8BAA8B,MAAM,IAAI,WAAW,aAAa;AAAA,MACzE;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/dist/modules/workflows/components/run/RunStepInspector.js

@@ -0,0 +1,116 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Button } from "@open-mercato/ui/primitives/button";
+import { JsonDisplay } from "@open-mercato/ui/backend/JsonDisplay";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { RunStatusBadge } from "./RunStatusBadge.js";
+import { formatRunDuration } from "../../lib/run-duration.js";
+import { stepInstanceStatusToRunStatus } from "../../lib/run-execution.js";
+function ExecutionRecord({
+  execution,
+  attemptLabel
+}) {
+  const t = useT();
+  const duration = formatRunDuration(execution.enteredAt, execution.exitedAt, execution.executionTimeMs);
+  const attempts = typeof execution.retryCount === "number" ? execution.retryCount + 1 : 1;
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-lg border border-border bg-card p-4", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+      /* @__PURE__ */ jsx(RunStatusBadge, { status: stepInstanceStatusToRunStatus(execution.status) }),
+      attemptLabel ? /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: attemptLabel }) : null,
+      execution.branchInstanceId ? /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: t("workflows.instances.run.inspector.branch", "Parallel branch") }) : null
+    ] }),
+    /* @__PURE__ */ jsxs("dl", { className: "mt-3 grid grid-cols-2 gap-3 text-sm md:grid-cols-4", children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { className: "text-xs font-medium text-muted-foreground", children: t("workflows.instances.run.inspector.startedAt", "Started") }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-0.5 text-foreground", children: execution.enteredAt ? new Date(execution.enteredAt).toLocaleString() : "-" })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { className: "text-xs font-medium text-muted-foreground", children: t("workflows.instances.run.inspector.endedAt", "Ended") }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-0.5 text-foreground", children: execution.exitedAt ? new Date(execution.exitedAt).toLocaleString() : "-" })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { className: "text-xs font-medium text-muted-foreground", children: t("workflows.instances.run.inspector.duration", "Duration") }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-0.5 text-foreground", children: duration ?? "-" })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { className: "text-xs font-medium text-muted-foreground", children: t("workflows.instances.run.inspector.attempts", "Attempts") }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-0.5 text-foreground", children: attempts })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "mt-4 space-y-3", children: [
+      /* @__PURE__ */ jsx(
+        JsonDisplay,
+        {
+          data: execution.inputData ?? null,
+          title: t("workflows.instances.run.inspector.input", "Input"),
+          maxInitialDepth: 1
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        JsonDisplay,
+        {
+          data: execution.outputData ?? null,
+          title: t("workflows.instances.run.inspector.output", "Output"),
+          maxInitialDepth: 1
+        }
+      ),
+      execution.errorData ? /* @__PURE__ */ jsx(
+        JsonDisplay,
+        {
+          data: execution.errorData,
+          title: t("workflows.instances.run.inspector.error", "Error"),
+          className: "border-status-error-border bg-status-error-bg",
+          maxInitialDepth: 1
+        }
+      ) : null
+    ] })
+  ] });
+}
+function RunStepInspector({
+  stepId,
+  stepLabel,
+  executions,
+  childInstanceIds = [],
+  onOpenChildInstance,
+  isLoading = false
+}) {
+  const t = useT();
+  if (!stepId) {
+    return /* @__PURE__ */ jsx("div", { className: "rounded-lg border border-dashed border-border p-6 text-sm text-muted-foreground", children: t("workflows.instances.run.inspector.empty", "Select a step on the canvas to inspect its input, output and timing.") });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-2", children: [
+      /* @__PURE__ */ jsx("h3", { className: "text-base font-semibold text-foreground", children: stepLabel || stepId }),
+      /* @__PURE__ */ jsx("span", { className: "font-mono text-xs text-muted-foreground", children: stepId })
+    ] }),
+    childInstanceIds.length > 0 && onOpenChildInstance ? /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2", children: childInstanceIds.map((childId) => /* @__PURE__ */ jsxs(
+      Button,
+      {
+        type: "button",
+        variant: "outline",
+        size: "sm",
+        onClick: () => onOpenChildInstance(childId),
+        children: [
+          t("workflows.instances.run.inspector.openSubWorkflow", "Open sub-workflow"),
+          " #",
+          childId.slice(0, 8)
+        ]
+      },
+      childId
+    )) }) : null,
+    isLoading ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: t("common.loading") }) : executions.length === 0 ? /* @__PURE__ */ jsx("p", { className: "rounded-lg border border-dashed border-border p-6 text-sm text-muted-foreground", children: t("workflows.instances.run.inspector.notExecuted", "This step has not executed in this run.") }) : /* @__PURE__ */ jsx("div", { className: "space-y-3", children: executions.map((execution, index) => /* @__PURE__ */ jsx(
+      ExecutionRecord,
+      {
+        execution,
+        attemptLabel: executions.length > 1 ? t("workflows.instances.run.inspector.execution", "Execution {n}", { n: String(index + 1) }) : null
+      },
+      execution.id ?? `${execution.stepId}-${index}`
+    )) })
+  ] });
+}
+var RunStepInspector_default = RunStepInspector;
+export {
+  RunStepInspector,
+  RunStepInspector_default as default
+};
+//# sourceMappingURL=RunStepInspector.js.map

package/dist/modules/workflows/components/run/RunStepInspector.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/RunStepInspector.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { Button } from '@open-mercato/ui/primitives/button'\nimport { JsonDisplay } from '@open-mercato/ui/backend/JsonDisplay'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { RunStatusBadge } from './RunStatusBadge'\nimport { formatRunDuration } from '../../lib/run-duration'\nimport type { RunStepInstanceInput } from '../../lib/run-execution'\nimport { stepInstanceStatusToRunStatus } from '../../lib/run-execution'\n\nexport type RunStepInspectorProps = {\n  /** The node the author selected on the painted canvas, `null` when nothing is selected. */\n  stepId: string | null\n  stepLabel?: string | null\n  /**\n   * Every recorded execution of that step, newest last. A step can run more\n   * than once (a loop, a failure route back, a rerun), and collapsing them\n   * would hide exactly the attempt an operator is looking for.\n   */\n  executions: readonly RunStepInstanceInput[]\n  /** Sub-workflow instances this step spawned, if any. */\n  childInstanceIds?: readonly string[]\n  onOpenChildInstance?: (instanceId: string) => void\n  isLoading?: boolean\n}\n\nfunction ExecutionRecord({\n  execution,\n  attemptLabel,\n}: {\n  execution: RunStepInstanceInput\n  attemptLabel: string | null\n}) {\n  const t = useT()\n  const duration = formatRunDuration(execution.enteredAt, execution.exitedAt, execution.executionTimeMs)\n  const attempts = typeof execution.retryCount === 'number' ? execution.retryCount + 1 : 1\n\n  return (\n    <div className=\"rounded-lg border border-border bg-card p-4\">\n      <div className=\"flex flex-wrap items-center gap-2\">\n        <RunStatusBadge status={stepInstanceStatusToRunStatus(execution.status)} />\n        {attemptLabel ? <span className=\"text-xs text-muted-foreground\">{attemptLabel}</span> : null}\n        {execution.branchInstanceId ? (\n          <span className=\"text-xs text-muted-foreground\">\n            {t('workflows.instances.run.inspector.branch', 'Parallel branch')}\n          </span>\n        ) : null}\n      </div>\n\n      <dl className=\"mt-3 grid grid-cols-2 gap-3 text-sm md:grid-cols-4\">\n        <div>\n          <dt className=\"text-xs font-medium text-muted-foreground\">\n            {t('workflows.instances.run.inspector.startedAt', 'Started')}\n          </dt>\n          <dd className=\"mt-0.5 text-foreground\">\n            {execution.enteredAt ? new Date(execution.enteredAt).toLocaleString() : '-'}\n          </dd>\n        </div>\n        <div>\n          <dt className=\"text-xs font-medium text-muted-foreground\">\n            {t('workflows.instances.run.inspector.endedAt', 'Ended')}\n          </dt>\n          <dd className=\"mt-0.5 text-foreground\">\n            {execution.exitedAt ? new Date(execution.exitedAt).toLocaleString() : '-'}\n          </dd>\n        </div>\n        <div>\n          <dt className=\"text-xs font-medium text-muted-foreground\">\n            {t('workflows.instances.run.inspector.duration', 'Duration')}\n          </dt>\n          <dd className=\"mt-0.5 text-foreground\">{duration ?? '-'}</dd>\n        </div>\n        <div>\n          <dt className=\"text-xs font-medium text-muted-foreground\">\n            {t('workflows.instances.run.inspector.attempts', 'Attempts')}\n          </dt>\n          <dd className=\"mt-0.5 text-foreground\">{attempts}</dd>\n        </div>\n      </dl>\n\n      <div className=\"mt-4 space-y-3\">\n        <JsonDisplay\n          data={execution.inputData ?? null}\n          title={t('workflows.instances.run.inspector.input', 'Input')}\n          maxInitialDepth={1}\n        />\n        <JsonDisplay\n          data={execution.outputData ?? null}\n          title={t('workflows.instances.run.inspector.output', 'Output')}\n          maxInitialDepth={1}\n        />\n        {execution.errorData ? (\n          <JsonDisplay\n            data={execution.errorData}\n            title={t('workflows.instances.run.inspector.error', 'Error')}\n            className=\"border-status-error-border bg-status-error-bg\"\n            maxInitialDepth={1}\n          />\n        ) : null}\n      </div>\n    </div>\n  )\n}\n\n/**\n * Per-step I/O inspector (spec \u00A78.3): \"clicking a node shows its I/O in the\n * inspector \u2026 input, output, duration, attempts \u2014 from `StepInstance`\".\n */\nexport function RunStepInspector({\n  stepId,\n  stepLabel,\n  executions,\n  childInstanceIds = [],\n  onOpenChildInstance,\n  isLoading = false,\n}: RunStepInspectorProps) {\n  const t = useT()\n\n  if (!stepId) {\n    return (\n      <div className=\"rounded-lg border border-dashed border-border p-6 text-sm text-muted-foreground\">\n        {t('workflows.instances.run.inspector.empty', 'Select a step on the canvas to inspect its input, output and timing.')}\n      </div>\n    )\n  }\n\n  return (\n    <div className=\"space-y-3\">\n      <div className=\"flex flex-wrap items-baseline gap-2\">\n        <h3 className=\"text-base font-semibold text-foreground\">{stepLabel || stepId}</h3>\n        <span className=\"font-mono text-xs text-muted-foreground\">{stepId}</span>\n      </div>\n\n      {childInstanceIds.length > 0 && onOpenChildInstance ? (\n        <div className=\"flex flex-wrap gap-2\">\n          {childInstanceIds.map((childId) => (\n            <Button\n              key={childId}\n              type=\"button\"\n              variant=\"outline\"\n              size=\"sm\"\n              onClick={() => onOpenChildInstance(childId)}\n            >\n              {t('workflows.instances.run.inspector.openSubWorkflow', 'Open sub-workflow')} #{childId.slice(0, 8)}\n            </Button>\n          ))}\n        </div>\n      ) : null}\n\n      {isLoading ? (\n        <p className=\"text-sm text-muted-foreground\">{t('common.loading')}</p>\n      ) : executions.length === 0 ? (\n        <p className=\"rounded-lg border border-dashed border-border p-6 text-sm text-muted-foreground\">\n          {t('workflows.instances.run.inspector.notExecuted', 'This step has not executed in this run.')}\n        </p>\n      ) : (\n        <div className=\"space-y-3\">\n          {executions.map((execution, index) => (\n            <ExecutionRecord\n              key={execution.id ?? `${execution.stepId}-${index}`}\n              execution={execution}\n              attemptLabel={\n                executions.length > 1\n                  ? t('workflows.instances.run.inspector.execution', 'Execution {n}', { n: String(index + 1) })\n                  : null\n              }\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport default RunStepInspector\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/components/run/WouldDoReport.js

@@ -0,0 +1,52 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AlertTriangle, Ban, Bot, CircleCheck, ShieldAlert, UserCheck } from "lucide-react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { JsonDisplay } from "@open-mercato/ui/backend/JsonDisplay";
+import { Alert, AlertDescription, AlertTitle } from "@open-mercato/ui/primitives/alert";
+const KIND_ICON = {
+  activity: CircleCheck,
+  refusal: Ban,
+  userTask: UserCheck,
+  businessRule: ShieldAlert
+};
+const SEVERITY_STYLE = {
+  error: { dot: "bg-status-error-icon", text: "text-status-error-icon" },
+  warning: { dot: "bg-status-warning-icon", text: "text-status-warning-icon" },
+  info: { dot: "bg-status-info-icon", text: "text-status-info-icon" }
+};
+function WouldDoReport({ report }) {
+  const t = useT();
+  if (!report || !report.isDryRun) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+    /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-semibold", children: t("workflows.dryRun.report.title") }),
+      /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t("workflows.dryRun.report.description") })
+    ] }),
+    report.stoppedByRefusal && /* @__PURE__ */ jsxs(Alert, { status: "warning", icon: /* @__PURE__ */ jsx(AlertTriangle, { "aria-hidden": "true" }), children: [
+      /* @__PURE__ */ jsx(AlertTitle, { children: t("workflows.dryRun.report.stoppedTitle") }),
+      /* @__PURE__ */ jsx(AlertDescription, { children: t("workflows.dryRun.report.stoppedDescription") })
+    ] }),
+    report.entries.length === 0 ? /* @__PURE__ */ jsx("p", { className: "rounded-lg border bg-card px-3 py-6 text-center text-sm text-muted-foreground", children: t("workflows.dryRun.report.empty") }) : /* @__PURE__ */ jsx("ol", { className: "space-y-2", children: report.entries.map((entry) => {
+      const Icon = KIND_ICON[entry.kind] ?? Bot;
+      const severity = SEVERITY_STYLE[entry.severity] ?? SEVERITY_STYLE.info;
+      return /* @__PURE__ */ jsx("li", { className: "rounded-lg border bg-card p-3", children: /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2", children: [
+        /* @__PURE__ */ jsx("span", { className: `mt-1 size-2.5 shrink-0 rounded-full ${severity.dot}`, "aria-hidden": "true" }),
+        /* @__PURE__ */ jsx(Icon, { className: `mt-0.5 size-4 shrink-0 ${severity.text}`, "aria-hidden": "true" }),
+        /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1 space-y-1", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "sr-only", children: t(`workflows.dryRun.report.severity.${entry.severity}`) }),
+            /* @__PURE__ */ jsx("span", { className: "text-sm font-medium", children: t(`workflows.dryRun.report.kind.${entry.kind}`) }),
+            /* @__PURE__ */ jsx("span", { className: "font-mono text-xs text-muted-foreground", children: entry.subject }),
+            entry.stepId ? /* @__PURE__ */ jsx("span", { className: "text-overline text-muted-foreground", children: entry.stepId }) : null
+          ] }),
+          /* @__PURE__ */ jsx(JsonDisplay, { data: entry.detail, maxInitialDepth: 1 })
+        ] })
+      ] }) }, entry.id);
+    }) })
+  ] });
+}
+export {
+  WouldDoReport
+};
+//# sourceMappingURL=WouldDoReport.js.map

package/dist/modules/workflows/components/run/WouldDoReport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/WouldDoReport.tsx"],
+  "sourcesContent": ["'use client'\n\n/**\n * The \"Would do\" report (spec section 8.2) \u2014 an ordered list of every side\n * effect a dry run suppressed.\n *\n * Severity pairs its DS token with an icon AND an `sr-only` name, per the\n * section 4.6 rule that status is never colour-only.\n */\n\nimport * as React from 'react'\nimport { AlertTriangle, Ban, Bot, CircleCheck, ShieldAlert, UserCheck } from 'lucide-react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { JsonDisplay } from '@open-mercato/ui/backend/JsonDisplay'\nimport { Alert, AlertDescription, AlertTitle } from '@open-mercato/ui/primitives/alert'\nimport type { WouldDoEntry, WouldDoEntryKind } from '../../lib/dry-run'\n\nexport type WouldDoReportPayload = {\n  isDryRun: boolean\n  entries: WouldDoEntry[]\n  stoppedByRefusal: boolean\n}\n\nconst KIND_ICON: Record<WouldDoEntryKind, React.ComponentType<{ className?: string }>> = {\n  activity: CircleCheck,\n  refusal: Ban,\n  userTask: UserCheck,\n  businessRule: ShieldAlert,\n}\n\nconst SEVERITY_STYLE: Record<string, { dot: string; text: string }> = {\n  error: { dot: 'bg-status-error-icon', text: 'text-status-error-icon' },\n  warning: { dot: 'bg-status-warning-icon', text: 'text-status-warning-icon' },\n  info: { dot: 'bg-status-info-icon', text: 'text-status-info-icon' },\n}\n\nexport function WouldDoReport({ report }: { report: WouldDoReportPayload | null }) {\n  const t = useT()\n\n  if (!report || !report.isDryRun) return null\n\n  return (\n    <div className=\"space-y-3\">\n      <div className=\"space-y-1\">\n        <h2 className=\"text-sm font-semibold\">{t('workflows.dryRun.report.title')}</h2>\n        <p className=\"text-xs text-muted-foreground\">{t('workflows.dryRun.report.description')}</p>\n      </div>\n\n      {report.stoppedByRefusal && (\n        <Alert status=\"warning\" icon={<AlertTriangle aria-hidden=\"true\" />}>\n          <AlertTitle>{t('workflows.dryRun.report.stoppedTitle')}</AlertTitle>\n          <AlertDescription>{t('workflows.dryRun.report.stoppedDescription')}</AlertDescription>\n        </Alert>\n      )}\n\n      {report.entries.length === 0 ? (\n        <p className=\"rounded-lg border bg-card px-3 py-6 text-center text-sm text-muted-foreground\">\n          {t('workflows.dryRun.report.empty')}\n        </p>\n      ) : (\n        <ol className=\"space-y-2\">\n          {report.entries.map((entry) => {\n            const Icon = KIND_ICON[entry.kind] ?? Bot\n            const severity = SEVERITY_STYLE[entry.severity] ?? SEVERITY_STYLE.info\n            return (\n              <li key={entry.id} className=\"rounded-lg border bg-card p-3\">\n                <div className=\"flex items-start gap-2\">\n                  <span className={`mt-1 size-2.5 shrink-0 rounded-full ${severity.dot}`} aria-hidden=\"true\" />\n                  <Icon className={`mt-0.5 size-4 shrink-0 ${severity.text}`} aria-hidden=\"true\" />\n                  <div className=\"min-w-0 flex-1 space-y-1\">\n                    <div className=\"flex flex-wrap items-baseline gap-2\">\n                      <span className=\"sr-only\">\n                        {t(`workflows.dryRun.report.severity.${entry.severity}`)}\n                      </span>\n                      <span className=\"text-sm font-medium\">\n                        {t(`workflows.dryRun.report.kind.${entry.kind}`)}\n                      </span>\n                      <span className=\"font-mono text-xs text-muted-foreground\">{entry.subject}</span>\n                      {entry.stepId ? (\n                        <span className=\"text-overline text-muted-foreground\">{entry.stepId}</span>\n                      ) : null}\n                    </div>\n                    <JsonDisplay data={entry.detail} maxInitialDepth={1} />\n                  </div>\n                </div>\n              </li>\n            )\n          })}\n        </ol>\n      )}\n    </div>\n  )\n}\n"],
+  "mappings": ";AA2CM,SACE,KADF;AAhCN,SAAS,eAAe,KAAK,KAAK,aAAa,aAAa,iBAAiB;AAC7E,SAAS,YAAY;AACrB,SAAS,mBAAmB;AAC5B,SAAS,OAAO,kBAAkB,kBAAkB;AASpD,MAAM,YAAmF;AAAA,EACvF,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,cAAc;AAChB;AAEA,MAAM,iBAAgE;AAAA,EACpE,OAAO,EAAE,KAAK,wBAAwB,MAAM,yBAAyB;AAAA,EACrE,SAAS,EAAE,KAAK,0BAA0B,MAAM,2BAA2B;AAAA,EAC3E,MAAM,EAAE,KAAK,uBAAuB,MAAM,wBAAwB;AACpE;AAEO,SAAS,cAAc,EAAE,OAAO,GAA4C;AACjF,QAAM,IAAI,KAAK;AAEf,MAAI,CAAC,UAAU,CAAC,OAAO,SAAU,QAAO;AAExC,SACE,qBAAC,SAAI,WAAU,aACb;AAAA,yBAAC,SAAI,WAAU,aACb;AAAA,0BAAC,QAAG,WAAU,yBAAyB,YAAE,+BAA+B,GAAE;AAAA,MAC1E,oBAAC,OAAE,WAAU,iCAAiC,YAAE,qCAAqC,GAAE;AAAA,OACzF;AAAA,IAEC,OAAO,oBACN,qBAAC,SAAM,QAAO,WAAU,MAAM,oBAAC,iBAAc,eAAY,QAAO,GAC9D;AAAA,0BAAC,cAAY,YAAE,sCAAsC,GAAE;AAAA,MACvD,oBAAC,oBAAkB,YAAE,4CAA4C,GAAE;AAAA,OACrE;AAAA,IAGD,OAAO,QAAQ,WAAW,IACzB,oBAAC,OAAE,WAAU,iFACV,YAAE,+BAA+B,GACpC,IAEA,oBAAC,QAAG,WAAU,aACX,iBAAO,QAAQ,IAAI,CAAC,UAAU;AAC7B,YAAM,OAAO,UAAU,MAAM,IAAI,KAAK;AACtC,YAAM,WAAW,eAAe,MAAM,QAAQ,KAAK,eAAe;AAClE,aACE,oBAAC,QAAkB,WAAU,iCAC3B,+BAAC,SAAI,WAAU,0BACb;AAAA,4BAAC,UAAK,WAAW,uCAAuC,SAAS,GAAG,IAAI,eAAY,QAAO;AAAA,QAC3F,oBAAC,QAAK,WAAW,0BAA0B,SAAS,IAAI,IAAI,eAAY,QAAO;AAAA,QAC/E,qBAAC,SAAI,WAAU,4BACb;AAAA,+BAAC,SAAI,WAAU,uCACb;AAAA,gCAAC,UAAK,WAAU,WACb,YAAE,oCAAoC,MAAM,QAAQ,EAAE,GACzD;AAAA,YACA,oBAAC,UAAK,WAAU,uBACb,YAAE,gCAAgC,MAAM,IAAI,EAAE,GACjD;AAAA,YACA,oBAAC,UAAK,WAAU,2CAA2C,gBAAM,SAAQ;AAAA,YACxE,MAAM,SACL,oBAAC,UAAK,WAAU,uCAAuC,gBAAM,QAAO,IAClE;AAAA,aACN;AAAA,UACA,oBAAC,eAAY,MAAM,MAAM,QAAQ,iBAAiB,GAAG;AAAA,WACvD;AAAA,SACF,KAnBO,MAAM,EAoBf;AAAA,IAEJ,CAAC,GACH;AAAA,KAEJ;AAEJ;",
+  "names": []
+}

package/dist/modules/workflows/components/run/useAgentLabels.js

@@ -0,0 +1,28 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+const EMPTY_LABELS = /* @__PURE__ */ new Map();
+function useAgentLabels(enabled) {
+  const { data } = useQuery({
+    queryKey: ["workflow-agent-labels"],
+    enabled,
+    staleTime: 5 * 60 * 1e3,
+    queryFn: async () => {
+      const result = await apiCall("/api/agent_orchestrator/agents", void 0, {
+        fallback: { items: [] }
+      });
+      const labels = /* @__PURE__ */ new Map();
+      for (const item of result.result?.items ?? []) {
+        if (typeof item?.id !== "string" || item.id.length === 0) continue;
+        if (typeof item.label !== "string" || item.label.length === 0) continue;
+        labels.set(item.id, item.label);
+      }
+      return labels;
+    }
+  });
+  return data ?? EMPTY_LABELS;
+}
+export {
+  useAgentLabels
+};
+//# sourceMappingURL=useAgentLabels.js.map

package/dist/modules/workflows/components/run/useAgentLabels.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/useAgentLabels.ts"],
+  "sourcesContent": ["'use client'\n\nimport { useQuery } from '@tanstack/react-query'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\n\ntype AgentsResponse = { items?: Array<{ id?: unknown; label?: unknown }> }\n\nconst EMPTY_LABELS: ReadonlyMap<string, string> = new Map()\n\n/**\n * Agent id \u2192 author-facing label, for the run views' reason line.\n *\n * \"Use the agent's label, never its definition key\" is an existing rule in this\n * module, and the label lives in the OPTIONAL `agent_orchestrator` peer's\n * registry \u2014 the same endpoint `AgentSelector` and `AgentInvokeConfigField`\n * read. When the peer is not installed the route 404s and this stays empty, so\n * the caller falls back to the id rather than to an invented name.\n *\n * `enabled` is the caller's answer to \"does this run contain an agent step at\n * all\"; a run without one must not pay for the request.\n */\nexport function useAgentLabels(enabled: boolean): ReadonlyMap<string, string> {\n  const { data } = useQuery({\n    queryKey: ['workflow-agent-labels'],\n    enabled,\n    staleTime: 5 * 60 * 1000,\n    queryFn: async () => {\n      const result = await apiCall<AgentsResponse>('/api/agent_orchestrator/agents', undefined, {\n        fallback: { items: [] },\n      })\n      const labels = new Map<string, string>()\n      for (const item of result.result?.items ?? []) {\n        if (typeof item?.id !== 'string' || item.id.length === 0) continue\n        if (typeof item.label !== 'string' || item.label.length === 0) continue\n        labels.set(item.id, item.label)\n      }\n      return labels as ReadonlyMap<string, string>\n    },\n  })\n\n  return data ?? EMPTY_LABELS\n}\n"],
+  "mappings": ";AAEA,SAAS,gBAAgB;AACzB,SAAS,eAAe;AAIxB,MAAM,eAA4C,oBAAI,IAAI;AAcnD,SAAS,eAAe,SAA+C;AAC5E,QAAM,EAAE,KAAK,IAAI,SAAS;AAAA,IACxB,UAAU,CAAC,uBAAuB;AAAA,IAClC;AAAA,IACA,WAAW,IAAI,KAAK;AAAA,IACpB,SAAS,YAAY;AACnB,YAAM,SAAS,MAAM,QAAwB,kCAAkC,QAAW;AAAA,QACxF,UAAU,EAAE,OAAO,CAAC,EAAE;AAAA,MACxB,CAAC;AACD,YAAM,SAAS,oBAAI,IAAoB;AACvC,iBAAW,QAAQ,OAAO,QAAQ,SAAS,CAAC,GAAG;AAC7C,YAAI,OAAO,MAAM,OAAO,YAAY,KAAK,GAAG,WAAW,EAAG;AAC1D,YAAI,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,WAAW,EAAG;AAC/D,eAAO,IAAI,KAAK,IAAI,KAAK,KAAK;AAAA,MAChC;AACA,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AAED,SAAO,QAAQ;AACjB;",
+  "names": []
+}

package/dist/modules/workflows/components/run/useLastRunOverlay.js

@@ -0,0 +1,89 @@
+"use client";
+import * as React from "react";
+import { useQuery } from "@tanstack/react-query";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+import { useAgentLabels } from "./useAgentLabels.js";
+import {
+  deriveRunExecution
+} from "../../lib/run-execution.js";
+const EMPTY_AGENT_LABELS = /* @__PURE__ */ new Map();
+const EMPTY_OVERLAY = {
+  instance: null,
+  execution: null,
+  agentLabels: EMPTY_AGENT_LABELS,
+  isLoading: false,
+  isUnavailable: false
+};
+function useLastRunOverlay(options) {
+  const { workflowId, enabled } = options;
+  const active = enabled && !!workflowId;
+  const instanceQuery = useQuery({
+    queryKey: ["workflow-last-run", workflowId],
+    enabled: active,
+    queryFn: async () => {
+      const params = new URLSearchParams({ workflowId, limit: "1" });
+      const result = await apiCall(`/api/workflows/instances?${params.toString()}`);
+      if (!result.ok) throw new Error("[internal] Failed to load the last workflow run");
+      return result.result?.data?.[0] ?? null;
+    }
+  });
+  const instanceId = instanceQuery.data?.id ?? null;
+  const stepsQuery = useQuery({
+    queryKey: ["workflow-last-run-steps", instanceId],
+    enabled: active && !!instanceId,
+    queryFn: async () => {
+      const result = await apiCall(
+        `/api/workflows/instances/${instanceId}/steps?limit=100`
+      );
+      if (!result.ok) throw new Error("[internal] Failed to load the last run step executions");
+      return result.result?.data ?? [];
+    }
+  });
+  const eventsQuery = useQuery({
+    queryKey: ["workflow-last-run-events", instanceId],
+    enabled: active && !!instanceId,
+    queryFn: async () => {
+      const result = await apiCall(
+        `/api/workflows/instances/${instanceId}/events?eventType=TRANSITION_EXECUTED&limit=100`
+      );
+      if (!result.ok) throw new Error("[internal] Failed to load the last run transitions");
+      return result.result?.data ?? [];
+    }
+  });
+  const parkEventsQuery = useQuery({
+    queryKey: ["workflow-last-run-park-events", instanceId],
+    enabled: active && !!instanceId,
+    queryFn: async () => {
+      const result = await apiCall(
+        `/api/workflows/instances/${instanceId}/events?limit=100`
+      );
+      if (!result.ok) throw new Error("[internal] Failed to load the last run events");
+      return result.result?.data ?? [];
+    }
+  });
+  const agentLabels = useAgentLabels(active && !!instanceId);
+  const execution = React.useMemo(() => {
+    if (!active || !instanceQuery.data) return null;
+    return deriveRunExecution({
+      events: [...eventsQuery.data ?? [], ...parkEventsQuery.data ?? []],
+      stepInstances: stepsQuery.data ?? [],
+      currentStepId: instanceQuery.data.currentStepId,
+      instanceStatus: instanceQuery.data.status,
+      attention: instanceQuery.data.metadata?.attention
+    });
+  }, [active, instanceQuery.data, eventsQuery.data, parkEventsQuery.data, stepsQuery.data]);
+  if (!active) return EMPTY_OVERLAY;
+  return {
+    instance: instanceQuery.data ?? null,
+    execution,
+    agentLabels,
+    isLoading: instanceQuery.isLoading || stepsQuery.isLoading || eventsQuery.isLoading || parkEventsQuery.isLoading,
+    // A definition that has never run is not an error — the toggle says so
+    // instead of painting an empty overlay that reads like "nothing executed".
+    isUnavailable: !instanceQuery.isLoading && !instanceQuery.data
+  };
+}
+export {
+  useLastRunOverlay
+};
+//# sourceMappingURL=useLastRunOverlay.js.map

package/dist/modules/workflows/components/run/useLastRunOverlay.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/useLastRunOverlay.ts"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { useQuery } from '@tanstack/react-query'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\nimport { useAgentLabels } from './useAgentLabels'\nimport {\n  deriveRunExecution,\n  type RunExecution,\n  type RunEventInput,\n  type RunStepInstanceInput,\n} from '../../lib/run-execution'\n\ntype InstanceSummary = {\n  id: string\n  workflowId: string\n  status: string\n  currentStepId: string | null\n  startedAt: string\n  completedAt: string | null\n  /** Engine-owned markers; only `attention` is read here. */\n  metadata?: { attention?: unknown } | null\n}\n\ntype InstancesResponse = { data: InstanceSummary[] }\ntype StepsResponse = { data: RunStepInstanceInput[] }\ntype EventsResponse = { data: RunEventInput[] }\n\nexport type LastRunOverlay = {\n  instance: InstanceSummary | null\n  execution: RunExecution | null\n  /**\n   * Agent id \u2192 label for the reason line. Travels WITH the overlay so the\n   * Studio canvas names an agent exactly the way the run detail page does.\n   */\n  agentLabels: ReadonlyMap<string, string>\n  isLoading: boolean\n  isUnavailable: boolean\n}\n\nconst EMPTY_AGENT_LABELS: ReadonlyMap<string, string> = new Map()\n\nconst EMPTY_OVERLAY: LastRunOverlay = {\n  instance: null,\n  execution: null,\n  agentLabels: EMPTY_AGENT_LABELS,\n  isLoading: false,\n  isUnavailable: false,\n}\n\n/**\n * \"Show last run\" for the Studio canvas (spec \u00A78.3).\n *\n * Reads the most recent instance of the definition being edited and derives the\n * SAME `RunExecution` the run detail page paints from, so the two surfaces can\n * never disagree about what a run did.\n *\n * Nothing here is fetched unless the toggle is on: an author editing a\n * definition should not pay for three requests they never asked for.\n */\nexport function useLastRunOverlay(options: {\n  workflowId?: string | null\n  enabled: boolean\n}): LastRunOverlay {\n  const { workflowId, enabled } = options\n  const active = enabled && !!workflowId\n\n  const instanceQuery = useQuery({\n    queryKey: ['workflow-last-run', workflowId],\n    enabled: active,\n    queryFn: async () => {\n      const params = new URLSearchParams({ workflowId: workflowId!, limit: '1' })\n      const result = await apiCall<InstancesResponse>(`/api/workflows/instances?${params.toString()}`)\n      if (!result.ok) throw new Error('[internal] Failed to load the last workflow run')\n      return result.result?.data?.[0] ?? null\n    },\n  })\n\n  const instanceId = instanceQuery.data?.id ?? null\n\n  const stepsQuery = useQuery({\n    queryKey: ['workflow-last-run-steps', instanceId],\n    enabled: active && !!instanceId,\n    queryFn: async () => {\n      const result = await apiCall<StepsResponse>(\n        `/api/workflows/instances/${instanceId}/steps?limit=100`\n      )\n      if (!result.ok) throw new Error('[internal] Failed to load the last run step executions')\n      return result.result?.data ?? []\n    },\n  })\n\n  // Events carry the TAKEN PATH \u2014 a transition leaves no row of its own, so the\n  // route overlay has no other source.\n  const eventsQuery = useQuery({\n    queryKey: ['workflow-last-run-events', instanceId],\n    enabled: active && !!instanceId,\n    queryFn: async () => {\n      const result = await apiCall<EventsResponse>(\n        `/api/workflows/instances/${instanceId}/events?eventType=TRANSITION_EXECUTED&limit=100`\n      )\n      if (!result.ok) throw new Error('[internal] Failed to load the last run transitions')\n      return result.result?.data ?? []\n    },\n  })\n\n  // The park events (spec Part 2) come from a SECOND, unfiltered page rather\n  // than by widening the query above: the list route's `eventType` filter is a\n  // single equality, and dropping it would let a long run's transitions fall off\n  // the same 100-row page the taken path depends on. Two cheap reads, both only\n  // once the toggle is on.\n  const parkEventsQuery = useQuery({\n    queryKey: ['workflow-last-run-park-events', instanceId],\n    enabled: active && !!instanceId,\n    queryFn: async () => {\n      const result = await apiCall<EventsResponse>(\n        `/api/workflows/instances/${instanceId}/events?limit=100`\n      )\n      if (!result.ok) throw new Error('[internal] Failed to load the last run events')\n      return result.result?.data ?? []\n    },\n  })\n\n  // Only worth a request once there is a run to overlay at all.\n  const agentLabels = useAgentLabels(active && !!instanceId)\n\n  const execution = React.useMemo(() => {\n    if (!active || !instanceQuery.data) return null\n    return deriveRunExecution({\n      events: [...(eventsQuery.data ?? []), ...(parkEventsQuery.data ?? [])],\n      stepInstances: stepsQuery.data ?? [],\n      currentStepId: instanceQuery.data.currentStepId,\n      instanceStatus: instanceQuery.data.status,\n      attention: instanceQuery.data.metadata?.attention,\n    })\n  }, [active, instanceQuery.data, eventsQuery.data, parkEventsQuery.data, stepsQuery.data])\n\n  if (!active) return EMPTY_OVERLAY\n\n  return {\n    instance: instanceQuery.data ?? null,\n    execution,\n    agentLabels,\n    isLoading:\n      instanceQuery.isLoading || stepsQuery.isLoading || eventsQuery.isLoading || parkEventsQuery.isLoading,\n    // A definition that has never run is not an error \u2014 the toggle says so\n    // instead of painting an empty overlay that reads like \"nothing executed\".\n    isUnavailable: !instanceQuery.isLoading && !instanceQuery.data,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/components/run/useLiveAgentActions.js

@@ -0,0 +1,41 @@
+"use client";
+import * as React from "react";
+import { useAppEvent } from "@open-mercato/ui/backend/injection/useAppEvent";
+const MAX_LIVE_AGENT_ACTIONS = 50;
+function useLiveAgentActions({
+  instanceId,
+  enabled = true
+}) {
+  const [actions, setActions] = React.useState([]);
+  useAppEvent(
+    "workflows.agent.action",
+    (event) => {
+      if (!enabled) return;
+      const payload = event.payload;
+      if (!payload || typeof payload !== "object") return;
+      const record = payload;
+      if (instanceId) {
+        const payloadInstanceId = record.id ?? record.instanceId;
+        if (typeof payloadInstanceId !== "string" || payloadInstanceId !== instanceId) return;
+      }
+      const stepIndex = typeof record.stepIndex === "number" ? record.stepIndex : 0;
+      const toolCallCount = typeof record.toolCallCount === "number" ? record.toolCallCount : 0;
+      const kind = typeof record.kind === "string" ? record.kind : "step_finish";
+      const name = typeof record.name === "string" ? record.name : void 0;
+      setActions((prev) => {
+        const next = [
+          ...prev,
+          { key: `${stepIndex}-${prev.length}`, kind, name, stepIndex, toolCallCount }
+        ];
+        return next.length > MAX_LIVE_AGENT_ACTIONS ? next.slice(next.length - MAX_LIVE_AGENT_ACTIONS) : next;
+      });
+    },
+    [enabled, instanceId]
+  );
+  return actions;
+}
+export {
+  MAX_LIVE_AGENT_ACTIONS,
+  useLiveAgentActions
+};
+//# sourceMappingURL=useLiveAgentActions.js.map

package/dist/modules/workflows/components/run/useLiveAgentActions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/useLiveAgentActions.ts"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { useAppEvent } from '@open-mercato/ui/backend/injection/useAppEvent'\n\n/**\n * Live agent-action telemetry for the run view (workflows spec Phase 2).\n *\n * Subscribes to the `workflows.agent.action` DOM-bridge event the optional\n * `agent_orchestrator` peer emits per AI-SDK step while an INVOKE_AGENT step\n * runs, and ACCUMULATES a bounded, append-only list \u2014 unlike `useLiveRunUpdates`\n * (which refetches run state), these are ephemeral telemetry rendered directly.\n * Nothing is persisted: a reopened finished run shows no history, and a browser\n * that connects late simply misses earlier actions. Steps + tool calls only \u2014\n * no token text.\n */\nexport type LiveAgentAction = {\n  key: string\n  kind: 'tool_call' | 'step_finish' | string\n  name?: string\n  stepIndex: number\n  toolCallCount: number\n}\n\n/** Keep the live log bounded \u2014 a long agent run must never grow memory unbounded. */\nexport const MAX_LIVE_AGENT_ACTIONS = 50\n\nexport type UseLiveAgentActionsOptions = {\n  /** Only actions carrying this instance id are kept. */\n  instanceId?: string | null\n  /** Turn the subscription off (e.g. before the instance has loaded). */\n  enabled?: boolean\n}\n\nexport function useLiveAgentActions({\n  instanceId,\n  enabled = true,\n}: UseLiveAgentActionsOptions): LiveAgentAction[] {\n  const [actions, setActions] = React.useState<LiveAgentAction[]>([])\n\n  useAppEvent(\n    'workflows.agent.action',\n    (event) => {\n      if (!enabled) return\n      const payload = event.payload\n      if (!payload || typeof payload !== 'object') return\n      const record = payload as Record<string, unknown>\n      if (instanceId) {\n        const payloadInstanceId = record.id ?? record.instanceId\n        if (typeof payloadInstanceId !== 'string' || payloadInstanceId !== instanceId) return\n      }\n      const stepIndex = typeof record.stepIndex === 'number' ? record.stepIndex : 0\n      const toolCallCount = typeof record.toolCallCount === 'number' ? record.toolCallCount : 0\n      const kind = typeof record.kind === 'string' ? record.kind : 'step_finish'\n      const name = typeof record.name === 'string' ? record.name : undefined\n      setActions((prev) => {\n        const next = [\n          ...prev,\n          { key: `${stepIndex}-${prev.length}`, kind, name, stepIndex, toolCallCount },\n        ]\n        return next.length > MAX_LIVE_AGENT_ACTIONS\n          ? next.slice(next.length - MAX_LIVE_AGENT_ACTIONS)\n          : next\n      })\n    },\n    [enabled, instanceId]\n  )\n\n  return actions\n}\n"],
+  "mappings": ";AAEA,YAAY,WAAW;AACvB,SAAS,mBAAmB;AAsBrB,MAAM,yBAAyB;AAS/B,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA,UAAU;AACZ,GAAkD;AAChD,QAAM,CAAC,SAAS,UAAU,IAAI,MAAM,SAA4B,CAAC,CAAC;AAElE;AAAA,IACE;AAAA,IACA,CAAC,UAAU;AACT,UAAI,CAAC,QAAS;AACd,YAAM,UAAU,MAAM;AACtB,UAAI,CAAC,WAAW,OAAO,YAAY,SAAU;AAC7C,YAAM,SAAS;AACf,UAAI,YAAY;AACd,cAAM,oBAAoB,OAAO,MAAM,OAAO;AAC9C,YAAI,OAAO,sBAAsB,YAAY,sBAAsB,WAAY;AAAA,MACjF;AACA,YAAM,YAAY,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAC5E,YAAM,gBAAgB,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB;AACxF,YAAM,OAAO,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAC7D,YAAM,OAAO,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAC7D,iBAAW,CAAC,SAAS;AACnB,cAAM,OAAO;AAAA,UACX,GAAG;AAAA,UACH,EAAE,KAAK,GAAG,SAAS,IAAI,KAAK,MAAM,IAAI,MAAM,MAAM,WAAW,cAAc;AAAA,QAC7E;AACA,eAAO,KAAK,SAAS,yBACjB,KAAK,MAAM,KAAK,SAAS,sBAAsB,IAC/C;AAAA,MACN,CAAC;AAAA,IACH;AAAA,IACA,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/workflows/components/run/useLiveRunUpdates.js

@@ -0,0 +1,57 @@
+"use client";
+import * as React from "react";
+import { useAppEvent } from "@open-mercato/ui/backend/injection/useAppEvent";
+const BRIDGE_RECONNECTED_EVENT = "om:bridge:reconnected";
+const LIVE_REFRESH_THROTTLE_MS = 1500;
+function useLiveRunUpdates({
+  instanceId,
+  onRefresh,
+  enabled = true,
+  throttleMs = LIVE_REFRESH_THROTTLE_MS
+}) {
+  const onRefreshRef = React.useRef(onRefresh);
+  onRefreshRef.current = onRefresh;
+  const timerRef = React.useRef(null);
+  const lastRunRef = React.useRef(0);
+  const scheduleRefresh = React.useCallback(() => {
+    if (timerRef.current !== null) return;
+    const sinceLast = Date.now() - lastRunRef.current;
+    const delay = Math.max(throttleMs - sinceLast, 0);
+    timerRef.current = setTimeout(() => {
+      timerRef.current = null;
+      lastRunRef.current = Date.now();
+      onRefreshRef.current();
+    }, delay);
+  }, [throttleMs]);
+  React.useEffect(
+    () => () => {
+      if (timerRef.current !== null) clearTimeout(timerRef.current);
+    },
+    []
+  );
+  useAppEvent(
+    "workflows.instance.*",
+    (event) => {
+      if (!enabled) return;
+      if (instanceId) {
+        const payloadInstanceId = event.payload?.id;
+        if (typeof payloadInstanceId !== "string" || payloadInstanceId !== instanceId) return;
+      }
+      scheduleRefresh();
+    },
+    [enabled, instanceId, scheduleRefresh]
+  );
+  useAppEvent(
+    BRIDGE_RECONNECTED_EVENT,
+    () => {
+      if (!enabled) return;
+      scheduleRefresh();
+    },
+    [enabled, scheduleRefresh]
+  );
+}
+export {
+  LIVE_REFRESH_THROTTLE_MS,
+  useLiveRunUpdates
+};
+//# sourceMappingURL=useLiveRunUpdates.js.map

package/dist/modules/workflows/components/run/useLiveRunUpdates.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/workflows/components/run/useLiveRunUpdates.ts"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { useAppEvent } from '@open-mercato/ui/backend/injection/useAppEvent'\n\n/** The DOM Event Bridge dispatches this after re-establishing a dropped SSE stream. */\nconst BRIDGE_RECONNECTED_EVENT = 'om:bridge:reconnected'\n\n/**\n * A busy tenant can advance dozens of instances a second, and every step\n * advance re-emits `workflows.instance.started`. Collapsing the burst into one\n * refresh is what keeps a live run list from refetching per event.\n */\nexport const LIVE_REFRESH_THROTTLE_MS = 1500\n\nexport type UseLiveRunUpdatesOptions = {\n  /**\n   * When set, only events carrying this instance id refresh. Omit on the run\n   * list, which cares about every instance in scope.\n   */\n  instanceId?: string | null\n  onRefresh: () => void\n  /** Turn the subscription off entirely (e.g. before the instance has loaded). */\n  enabled?: boolean\n  throttleMs?: number\n}\n\n/**\n * Live run updates (spec \u00A78.3): \"`workflows.instance.*` lifecycle events gain\n * `clientBroadcast: true`; run views subscribe via the DOM Event Bridge.\"\n *\n * The bridge is best-effort by design \u2014 the stream can drop, and the platform\n * caps an SSE payload at 4KB and replaces anything larger with a stub. So a\n * refresh is always a REFETCH, never an attempt to patch state from the\n * payload, and the hook also refreshes on the bridge's reconnect event to\n * close whatever gap the disconnection left.\n */\nexport function useLiveRunUpdates({\n  instanceId,\n  onRefresh,\n  enabled = true,\n  throttleMs = LIVE_REFRESH_THROTTLE_MS,\n}: UseLiveRunUpdatesOptions): void {\n  const onRefreshRef = React.useRef(onRefresh)\n  onRefreshRef.current = onRefresh\n\n  const timerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null)\n  const lastRunRef = React.useRef(0)\n\n  const scheduleRefresh = React.useCallback(() => {\n    if (timerRef.current !== null) return\n    const sinceLast = Date.now() - lastRunRef.current\n    const delay = Math.max(throttleMs - sinceLast, 0)\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null\n      lastRunRef.current = Date.now()\n      onRefreshRef.current()\n    }, delay)\n  }, [throttleMs])\n\n  React.useEffect(\n    () => () => {\n      if (timerRef.current !== null) clearTimeout(timerRef.current)\n    },\n    []\n  )\n\n  useAppEvent(\n    'workflows.instance.*',\n    (event) => {\n      if (!enabled) return\n      if (instanceId) {\n        const payloadInstanceId = event.payload?.id\n        if (typeof payloadInstanceId !== 'string' || payloadInstanceId !== instanceId) return\n      }\n      scheduleRefresh()\n    },\n    [enabled, instanceId, scheduleRefresh]\n  )\n\n  useAppEvent(\n    BRIDGE_RECONNECTED_EVENT,\n    () => {\n      if (!enabled) return\n      scheduleRefresh()\n    },\n    [enabled, scheduleRefresh]\n  )\n}\n"],
+  "mappings": ";AAEA,YAAY,WAAW;AACvB,SAAS,mBAAmB;AAG5B,MAAM,2BAA2B;AAO1B,MAAM,2BAA2B;AAwBjC,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,aAAa;AACf,GAAmC;AACjC,QAAM,eAAe,MAAM,OAAO,SAAS;AAC3C,eAAa,UAAU;AAEvB,QAAM,WAAW,MAAM,OAA6C,IAAI;AACxE,QAAM,aAAa,MAAM,OAAO,CAAC;AAEjC,QAAM,kBAAkB,MAAM,YAAY,MAAM;AAC9C,QAAI,SAAS,YAAY,KAAM;AAC/B,UAAM,YAAY,KAAK,IAAI,IAAI,WAAW;AAC1C,UAAM,QAAQ,KAAK,IAAI,aAAa,WAAW,CAAC;AAChD,aAAS,UAAU,WAAW,MAAM;AAClC,eAAS,UAAU;AACnB,iBAAW,UAAU,KAAK,IAAI;AAC9B,mBAAa,QAAQ;AAAA,IACvB,GAAG,KAAK;AAAA,EACV,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM;AAAA,IACJ,MAAM,MAAM;AACV,UAAI,SAAS,YAAY,KAAM,cAAa,SAAS,OAAO;AAAA,IAC9D;AAAA,IACA,CAAC;AAAA,EACH;AAEA;AAAA,IACE;AAAA,IACA,CAAC,UAAU;AACT,UAAI,CAAC,QAAS;AACd,UAAI,YAAY;AACd,cAAM,oBAAoB,MAAM,SAAS;AACzC,YAAI,OAAO,sBAAsB,YAAY,sBAAsB,WAAY;AAAA,MACjF;AACA,sBAAgB;AAAA,IAClB;AAAA,IACA,CAAC,SAAS,YAAY,eAAe;AAAA,EACvC;AAEA;AAAA,IACE;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,QAAS;AACd,sBAAgB;AAAA,IAClB;AAAA,IACA,CAAC,SAAS,eAAe;AAAA,EAC3B;AACF;",
+  "names": []
+}