@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7195.1.b5efd1d51a

package/dist/modules/workflows/lib/server-output-contract.js

@@ -0,0 +1,65 @@
+import { ZodType } from "zod";
+import "./activity-registry-bootstrap.js";
+import { getActivityType } from "./activity-registry.js";
+import {
+  bindAgentOutcomeSchemaResolver,
+  bindCallApiResponseSchemaResolver
+} from "./activity-types.js";
+import { findEndpointResponseSchema } from "./endpoint-catalog.js";
+import { flattenSchemaToContract } from "./ledger-schema-flatten.js";
+bindCallApiResponseSchemaResolver((endpoint, method) => findEndpointResponseSchema(endpoint, method) ?? "unknown");
+let agentOutcomeContracts = null;
+let agentOutcomeWarmup = null;
+bindAgentOutcomeSchemaResolver((agentId) => agentOutcomeContracts?.get(agentId) ?? "unknown");
+function toAgentOutcomeContract(snapshot) {
+  const { agentId, resultKind, schema } = snapshot;
+  if (typeof agentId !== "string" || agentId.length === 0) return null;
+  if (resultKind !== "research" && resultKind !== "proposal") return null;
+  if (!(schema instanceof ZodType)) return null;
+  return { resultKind, schema };
+}
+async function loadAgentOutcomeContracts(container) {
+  let bridge;
+  try {
+    bridge = container.resolve("agentWorkflowBridge");
+  } catch {
+    bridge = void 0;
+  }
+  if (!bridge || typeof bridge.listAgentOutcomeContracts !== "function") {
+    agentOutcomeContracts = /* @__PURE__ */ new Map();
+    return;
+  }
+  const resolved = /* @__PURE__ */ new Map();
+  try {
+    for (const snapshot of await bridge.listAgentOutcomeContracts()) {
+      const contract = toAgentOutcomeContract(snapshot);
+      if (contract && typeof snapshot.agentId === "string") resolved.set(snapshot.agentId, contract);
+    }
+  } catch {
+    agentOutcomeContracts = /* @__PURE__ */ new Map();
+    return;
+  }
+  agentOutcomeContracts = resolved;
+}
+async function ensureWorkflowAgentOutcomeContracts(container) {
+  if (!agentOutcomeWarmup) agentOutcomeWarmup = loadAgentOutcomeContracts(container);
+  await agentOutcomeWarmup;
+}
+function clearWorkflowAgentOutcomeContractsForTests() {
+  agentOutcomeContracts = null;
+  agentOutcomeWarmup = null;
+}
+const resolveServerOutputContract = (activityType, config) => {
+  const entry = getActivityType(activityType);
+  const contract = entry?.outputContract;
+  if (typeof contract !== "function") return "unknown";
+  const resolved = contract(config);
+  if (!(resolved instanceof ZodType)) return "unknown";
+  return flattenSchemaToContract(resolved);
+};
+export {
+  clearWorkflowAgentOutcomeContractsForTests,
+  ensureWorkflowAgentOutcomeContracts,
+  resolveServerOutputContract
+};
+//# sourceMappingURL=server-output-contract.js.map

package/dist/modules/workflows/lib/server-output-contract.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/server-output-contract.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - server-side output-contract resolver.\n *\n * NOT pure: this is the concrete implementation server callers (the\n * context-schema API route) inject into `computeContextLedger`'s\n * `resolveOutputContract` seam. It is only meaningful in the server runtime,\n * where the activity registry is bootstrapped (guaranteed by the bootstrap\n * import below) and the command registry holds the loaded command handlers \u2014\n * `commandRegistry.outputSchemaOf` is sync over already-registered handlers,\n * so UPDATE_ENTITY's outputContract resolves a real Zod schema there and\n * degrades honestly to 'unknown' elsewhere. The browser-side ledger never\n * resolves contracts locally; it consumes the resolved entries from the\n * context-schema API response.\n *\n * A registry entry's `outputContract` yields `ZodTypeAny | 'unknown'`\n * (activity-registry.ts); the instanceof guard also keeps third-party entries\n * honest at runtime before flattening.\n */\n\nimport { ZodType } from 'zod'\nimport './activity-registry-bootstrap'\nimport { getActivityType } from './activity-registry'\nimport {\n  bindAgentOutcomeSchemaResolver,\n  bindCallApiResponseSchemaResolver,\n  type AgentOutcomeContract,\n} from './activity-types'\nimport { findEndpointResponseSchema } from './endpoint-catalog'\nimport { flattenSchemaToContract } from './ledger-schema-flatten'\nimport type { ResolveOutputContract } from './context-ledger'\n\n/**\n * CALL_API's registry outputContract reaches the server-only endpoint\n * catalog through this binding (mirroring bindActivityExecutor). The sync\n * lookup reads the per-process catalog cache, so callers that want CALL_API\n * contracts resolved must `await ensureWorkflowEndpointCatalog()` first \u2014\n * the context-schema route does; unwarmed processes degrade to 'unknown'.\n */\nbindCallApiResponseSchemaResolver((endpoint, method) => findEndpointResponseSchema(endpoint, method) ?? 'unknown')\n\n/**\n * INVOKE_AGENT's registry outputContract reaches the OPTIONAL agent_orchestrator\n * peer the same way the executor does: through DI, never an import. The peer's\n * `agentWorkflowBridge` service may expose `listAgentOutcomeContracts()` (an\n * additive, optional method \u2014 an older peer without it is simply a peer without\n * agent typing); this module caches the returned OUTCOME schemas per process and\n * the bound resolver reads that cache synchronously. Callers that want agent\n * contracts resolved must `await ensureWorkflowAgentOutcomeContracts(container)`\n * first \u2014 the context-schema route does; unwarmed processes, an absent peer, and\n * a failing lookup all degrade to 'unknown' without throwing.\n */\ntype AgentOutcomeContractSnapshot = {\n  agentId?: unknown\n  resultKind?: unknown\n  schema?: unknown\n}\n\ntype AgentOutcomeBridgeLike = {\n  listAgentOutcomeContracts?: () => Promise<AgentOutcomeContractSnapshot[]>\n}\n\ntype ServiceContainer = {\n  resolve: <T>(name: string) => T\n}\n\nlet agentOutcomeContracts: Map<string, AgentOutcomeContract> | null = null\nlet agentOutcomeWarmup: Promise<void> | null = null\n\nbindAgentOutcomeSchemaResolver((agentId) => agentOutcomeContracts?.get(agentId) ?? 'unknown')\n\nfunction toAgentOutcomeContract(snapshot: AgentOutcomeContractSnapshot): AgentOutcomeContract | null {\n  const { agentId, resultKind, schema } = snapshot\n  if (typeof agentId !== 'string' || agentId.length === 0) return null\n  if (resultKind !== 'research' && resultKind !== 'proposal') return null\n  if (!(schema instanceof ZodType)) return null\n  return { resultKind, schema }\n}\n\nasync function loadAgentOutcomeContracts(container: ServiceContainer): Promise<void> {\n  let bridge: AgentOutcomeBridgeLike | undefined\n  try {\n    bridge = container.resolve<AgentOutcomeBridgeLike>('agentWorkflowBridge')\n  } catch {\n    bridge = undefined\n  }\n  if (!bridge || typeof bridge.listAgentOutcomeContracts !== 'function') {\n    agentOutcomeContracts = new Map()\n    return\n  }\n  const resolved = new Map<string, AgentOutcomeContract>()\n  try {\n    for (const snapshot of await bridge.listAgentOutcomeContracts()) {\n      const contract = toAgentOutcomeContract(snapshot)\n      if (contract && typeof snapshot.agentId === 'string') resolved.set(snapshot.agentId, contract)\n    }\n  } catch {\n    agentOutcomeContracts = new Map()\n    return\n  }\n  agentOutcomeContracts = resolved\n}\n\nexport async function ensureWorkflowAgentOutcomeContracts(container: ServiceContainer): Promise<void> {\n  if (!agentOutcomeWarmup) agentOutcomeWarmup = loadAgentOutcomeContracts(container)\n  await agentOutcomeWarmup\n}\n\nexport function clearWorkflowAgentOutcomeContractsForTests(): void {\n  agentOutcomeContracts = null\n  agentOutcomeWarmup = null\n}\n\nexport const resolveServerOutputContract: ResolveOutputContract = (activityType, config) => {\n  const entry = getActivityType(activityType)\n  const contract = entry?.outputContract\n  if (typeof contract !== 'function') return 'unknown'\n  const resolved = contract(config)\n  if (!(resolved instanceof ZodType)) return 'unknown'\n  return flattenSchemaToContract(resolved)\n}\n"],
+  "mappings": "AAmBA,SAAS,eAAe;AACxB,OAAO;AACP,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,kCAAkC;AAC3C,SAAS,+BAA+B;AAUxC,kCAAkC,CAAC,UAAU,WAAW,2BAA2B,UAAU,MAAM,KAAK,SAAS;AA2BjH,IAAI,wBAAkE;AACtE,IAAI,qBAA2C;AAE/C,+BAA+B,CAAC,YAAY,uBAAuB,IAAI,OAAO,KAAK,SAAS;AAE5F,SAAS,uBAAuB,UAAqE;AACnG,QAAM,EAAE,SAAS,YAAY,OAAO,IAAI;AACxC,MAAI,OAAO,YAAY,YAAY,QAAQ,WAAW,EAAG,QAAO;AAChE,MAAI,eAAe,cAAc,eAAe,WAAY,QAAO;AACnE,MAAI,EAAE,kBAAkB,SAAU,QAAO;AACzC,SAAO,EAAE,YAAY,OAAO;AAC9B;AAEA,eAAe,0BAA0B,WAA4C;AACnF,MAAI;AACJ,MAAI;AACF,aAAS,UAAU,QAAgC,qBAAqB;AAAA,EAC1E,QAAQ;AACN,aAAS;AAAA,EACX;AACA,MAAI,CAAC,UAAU,OAAO,OAAO,8BAA8B,YAAY;AACrE,4BAAwB,oBAAI,IAAI;AAChC;AAAA,EACF;AACA,QAAM,WAAW,oBAAI,IAAkC;AACvD,MAAI;AACF,eAAW,YAAY,MAAM,OAAO,0BAA0B,GAAG;AAC/D,YAAM,WAAW,uBAAuB,QAAQ;AAChD,UAAI,YAAY,OAAO,SAAS,YAAY,SAAU,UAAS,IAAI,SAAS,SAAS,QAAQ;AAAA,IAC/F;AAAA,EACF,QAAQ;AACN,4BAAwB,oBAAI,IAAI;AAChC;AAAA,EACF;AACA,0BAAwB;AAC1B;AAEA,eAAsB,oCAAoC,WAA4C;AACpG,MAAI,CAAC,mBAAoB,sBAAqB,0BAA0B,SAAS;AACjF,QAAM;AACR;AAEO,SAAS,6CAAmD;AACjE,0BAAwB;AACxB,uBAAqB;AACvB;AAEO,MAAM,8BAAqD,CAAC,cAAc,WAAW;AAC1F,QAAM,QAAQ,gBAAgB,YAAY;AAC1C,QAAM,WAAW,OAAO;AACxB,MAAI,OAAO,aAAa,WAAY,QAAO;AAC3C,QAAM,WAAW,SAAS,MAAM;AAChC,MAAI,EAAE,oBAAoB,SAAU,QAAO;AAC3C,SAAO,wBAAwB,QAAQ;AACzC;",
+  "names": []
+}

package/dist/modules/workflows/lib/set-variable.js

@@ -0,0 +1,47 @@
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSetVariableOutput(output) {
+  if (!isPlainObject(output)) return false;
+  const assignments = output.assignments;
+  return Array.isArray(assignments) && assignments.every((assignment) => {
+    if (!isPlainObject(assignment) || typeof assignment.path !== "string") return false;
+    const segments = splitAssignmentPath(assignment.path);
+    return segments !== null && segments.length > 0;
+  });
+}
+const FORBIDDEN_ASSIGNMENT_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function splitAssignmentPath(path) {
+  const segments = path.split(".").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+  if (segments.some((segment) => FORBIDDEN_ASSIGNMENT_SEGMENTS.has(segment))) return null;
+  return segments;
+}
+function buildSetVariableContextPatch(baseContext, assignments) {
+  const patch = {};
+  for (const assignment of assignments) {
+    const segments = splitAssignmentPath(assignment.path);
+    if (segments === null || segments.length === 0) continue;
+    const [rootKey, ...nestedSegments] = segments;
+    if (nestedSegments.length === 0) {
+      patch[rootKey] = assignment.value;
+      continue;
+    }
+    const currentRoot = rootKey in patch ? patch[rootKey] : baseContext[rootKey];
+    const clonedRoot = isPlainObject(currentRoot) ? { ...currentRoot } : {};
+    let cursor = clonedRoot;
+    for (const segment of nestedSegments.slice(0, -1)) {
+      const nextValue = cursor[segment];
+      cursor[segment] = isPlainObject(nextValue) ? { ...nextValue } : {};
+      cursor = cursor[segment];
+    }
+    cursor[nestedSegments[nestedSegments.length - 1]] = assignment.value;
+    patch[rootKey] = clonedRoot;
+  }
+  return patch;
+}
+export {
+  buildSetVariableContextPatch,
+  isSetVariableOutput,
+  splitAssignmentPath
+};
+//# sourceMappingURL=set-variable.js.map

package/dist/modules/workflows/lib/set-variable.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/set-variable.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - SET_VARIABLE context assignment helpers\n *\n * Pure path-application logic for the SET_VARIABLE activity type. The engine\n * merges sync activity outputs into workflow context under a namespaced key\n * (activityName || activityType); SET_VARIABLE instead lands each assignment\n * at its dot path in top-level context (spec 2026-07-26-workflows-ux-redesign\n * section 3.2). Both sync merge points \u2014 the intra-transition merge in\n * activity-executor's executeActivities and the persistence merge in\n * transition-handler \u2014 detect SET_VARIABLE outputs with `isSetVariableOutput`\n * and apply `buildSetVariableContextPatch` instead of namespacing.\n *\n * Kept in its own pure module (no React, no ORM, no container) so\n * transition-handler tests exercise the real path application even when the\n * whole activity-executor module is mocked.\n */\n\nexport interface SetVariableAssignment {\n  path: string\n  value?: unknown\n}\n\nexport interface SetVariableOutput {\n  assignments: SetVariableAssignment[]\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nexport function isSetVariableOutput(output: unknown): output is SetVariableOutput {\n  if (!isPlainObject(output)) return false\n  const assignments = output.assignments\n  return (\n    Array.isArray(assignments) &&\n    assignments.every((assignment) => {\n      if (!isPlainObject(assignment) || typeof assignment.path !== 'string') return false\n      const segments = splitAssignmentPath(assignment.path)\n      return segments !== null && segments.length > 0\n    })\n  )\n}\n\nconst FORBIDDEN_ASSIGNMENT_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype'])\n\n/**\n * Splits a dot path into trimmed, non-empty segments. Returns `null` when any\n * segment is a prototype-pollution vector (`__proto__`, `constructor`,\n * `prototype`) \u2014 such an assignment is never legitimate, so callers reject the\n * whole assignment instead of applying it.\n */\nexport function splitAssignmentPath(path: string): string[] | null {\n  const segments = path\n    .split('.')\n    .map((segment) => segment.trim())\n    .filter((segment) => segment.length > 0)\n  if (segments.some((segment) => FORBIDDEN_ASSIGNMENT_SEGMENTS.has(segment))) return null\n  return segments\n}\n\n/**\n * Build a shallow top-level patch that lands every assignment at its dot\n * path. Nested paths clone the existing objects along the way (the base is\n * never mutated) and preserve sibling keys; missing or non-object\n * intermediates become fresh objects. Later assignments in the same batch see\n * earlier ones. The result spreads into the engine's existing shallow context\n * merge without clobbering untouched top-level keys.\n */\nexport function buildSetVariableContextPatch(\n  baseContext: Record<string, unknown>,\n  assignments: SetVariableAssignment[],\n): Record<string, unknown> {\n  const patch: Record<string, unknown> = {}\n  for (const assignment of assignments) {\n    const segments = splitAssignmentPath(assignment.path)\n    if (segments === null || segments.length === 0) continue\n    const [rootKey, ...nestedSegments] = segments\n    if (nestedSegments.length === 0) {\n      patch[rootKey] = assignment.value\n      continue\n    }\n    const currentRoot = rootKey in patch ? patch[rootKey] : baseContext[rootKey]\n    const clonedRoot: Record<string, unknown> = isPlainObject(currentRoot) ? { ...currentRoot } : {}\n    let cursor = clonedRoot\n    for (const segment of nestedSegments.slice(0, -1)) {\n      const nextValue = cursor[segment]\n      cursor[segment] = isPlainObject(nextValue) ? { ...nextValue } : {}\n      cursor = cursor[segment] as Record<string, unknown>\n    }\n    cursor[nestedSegments[nestedSegments.length - 1]] = assignment.value\n    patch[rootKey] = clonedRoot\n  }\n  return patch\n}\n"],
+  "mappings": "AA0BA,SAAS,cAAc,OAAkD;AACvE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEO,SAAS,oBAAoB,QAA8C;AAChF,MAAI,CAAC,cAAc,MAAM,EAAG,QAAO;AACnC,QAAM,cAAc,OAAO;AAC3B,SACE,MAAM,QAAQ,WAAW,KACzB,YAAY,MAAM,CAAC,eAAe;AAChC,QAAI,CAAC,cAAc,UAAU,KAAK,OAAO,WAAW,SAAS,SAAU,QAAO;AAC9E,UAAM,WAAW,oBAAoB,WAAW,IAAI;AACpD,WAAO,aAAa,QAAQ,SAAS,SAAS;AAAA,EAChD,CAAC;AAEL;AAEA,MAAM,gCAAgC,oBAAI,IAAI,CAAC,aAAa,eAAe,WAAW,CAAC;AAQhF,SAAS,oBAAoB,MAA+B;AACjE,QAAM,WAAW,KACd,MAAM,GAAG,EACT,IAAI,CAAC,YAAY,QAAQ,KAAK,CAAC,EAC/B,OAAO,CAAC,YAAY,QAAQ,SAAS,CAAC;AACzC,MAAI,SAAS,KAAK,CAAC,YAAY,8BAA8B,IAAI,OAAO,CAAC,EAAG,QAAO;AACnF,SAAO;AACT;AAUO,SAAS,6BACd,aACA,aACyB;AACzB,QAAM,QAAiC,CAAC;AACxC,aAAW,cAAc,aAAa;AACpC,UAAM,WAAW,oBAAoB,WAAW,IAAI;AACpD,QAAI,aAAa,QAAQ,SAAS,WAAW,EAAG;AAChD,UAAM,CAAC,SAAS,GAAG,cAAc,IAAI;AACrC,QAAI,eAAe,WAAW,GAAG;AAC/B,YAAM,OAAO,IAAI,WAAW;AAC5B;AAAA,IACF;AACA,UAAM,cAAc,WAAW,QAAQ,MAAM,OAAO,IAAI,YAAY,OAAO;AAC3E,UAAM,aAAsC,cAAc,WAAW,IAAI,EAAE,GAAG,YAAY,IAAI,CAAC;AAC/F,QAAI,SAAS;AACb,eAAW,WAAW,eAAe,MAAM,GAAG,EAAE,GAAG;AACjD,YAAM,YAAY,OAAO,OAAO;AAChC,aAAO,OAAO,IAAI,cAAc,SAAS,IAAI,EAAE,GAAG,UAAU,IAAI,CAAC;AACjE,eAAS,OAAO,OAAO;AAAA,IACzB;AACA,WAAO,eAAe,eAAe,SAAS,CAAC,CAAC,IAAI,WAAW;AAC/D,UAAM,OAAO,IAAI;AAAA,EACnB;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/workflows/lib/signal-handler.js

@@ -1,6 +1,12 @@
 import { findOneWithDecryption, findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
 import { WorkflowInstance, WorkflowBranchInstance, WorkflowDefinition, StepInstance } from "../data/entities.js";
+import { INVOKE_AGENT_SIGNAL_NAME, SUB_WORKFLOW_SIGNAL_NAME } from "./activity-executor.js";
 import { resolveCodeDefinitionForInstance } from "./find-definition.js";
+import {
+  WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY,
+  buildAgentOutcomeContextEntry,
+  mapDispositionToAgentOutcome
+} from "./outcome-routing.js";
 import { createLogger } from "@open-mercato/shared/lib/logger";
 const logger = createLogger("workflows");
 class SignalError extends Error {
@@ -12,7 +18,16 @@ class SignalError extends Error {
   }
 }
 async function sendSignal(em, container, options) {
-  const { instanceId, signalName, payload, userId, tenantId, organizationId } = options;
+  const {
+    instanceId,
+    signalName,
+    payload,
+    agentOutcome,
+    agentProposalId,
+    userId,
+    tenantId,
+    organizationId
+  } = options;
   const eventLogger = container.resolve("eventLogger");
   const stepHandler = container.resolve("stepHandler");
   const transitionHandler = container.resolve("transitionHandler");
@@ -126,14 +141,17 @@ async function sendSignal(em, container, options) {
   const currentStep = definition.definition.steps.find(
     (s) => s.stepId === instance.currentStepId
   );
-  if (!currentStep || currentStep.stepType !== "WAIT_FOR_SIGNAL") {
+  const isInvokeAgentStep = !!currentStep && Array.isArray(currentStep.activities) && currentStep.activities.some((a) => a?.activityType === "INVOKE_AGENT");
+  const isSubWorkflowStep = !!currentStep && currentStep.stepType === "SUB_WORKFLOW";
+  const stepCanReceiveSignal = !!currentStep && (currentStep.stepType === "WAIT_FOR_SIGNAL" || !!currentStep.signalConfig?.signalName || isInvokeAgentStep || isSubWorkflowStep);
+  if (!stepCanReceiveSignal) {
     throw new SignalError(
       "Workflow is not waiting for signal",
       "NOT_WAITING_FOR_SIGNAL",
       { instanceId, currentStepId: instance.currentStepId }
     );
   }
-  const expectedSignalName = currentStep.signalConfig?.signalName || currentStep.stepId;
+  const expectedSignalName = currentStep.signalConfig?.signalName || (isInvokeAgentStep ? INVOKE_AGENT_SIGNAL_NAME : isSubWorkflowStep ? SUB_WORKFLOW_SIGNAL_NAME : currentStep.stepId);
   if (expectedSignalName !== signalName) {
     throw new SignalError(
       "Signal name mismatch",
@@ -150,6 +168,22 @@ async function sendSignal(em, container, options) {
       [`signal_${signalName}_receivedAt`]: now.toISOString()
     };
   }
+  if (isInvokeAgentStep && instance.currentStepId) {
+    const resolvedOutcome = agentOutcome ?? mapDispositionToAgentOutcome(
+      payload?.disposition
+    );
+    if (resolvedOutcome) {
+      const proposalId = agentProposalId ?? payload?.agentProposalId ?? payload?.proposalId;
+      instance.context = {
+        ...instance.context,
+        [WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY]: buildAgentOutcomeContextEntry(
+          instance.currentStepId,
+          resolvedOutcome,
+          typeof proposalId === "string" ? proposalId : void 0
+        )
+      };
+    }
+  }
   instance.updatedAt = now;
   await eventLogger.logWorkflowEvent(em, {
     workflowInstanceId: instance.id,
@@ -181,6 +215,29 @@ async function sendSignal(em, container, options) {
       payload
     });
   }
+  instance.status = "RUNNING";
+  await em.flush();
+  const { dispatchAgentOutcomeForCurrentStep } = await import("./workflow-executor.js");
+  const outcomeDispatch = await dispatchAgentOutcomeForCurrentStep(
+    em,
+    container,
+    instance,
+    definition.definition,
+    { workflowContext: instance.context, userId }
+  );
+  if (outcomeDispatch && outcomeDispatch.kind !== "default") {
+    if (outcomeDispatch.kind === "failed") {
+      await workflowExecutor.completeWorkflow(em, container, instance.id, "FAILED", {
+        error: outcomeDispatch.error
+      });
+      return;
+    }
+    if (outcomeDispatch.kind === "parked") return;
+    if (outcomeDispatch.paused) return;
+    await em.flush();
+    await workflowExecutor.executeWorkflow(em, container, instance.id, { userId });
+    return;
+  }
   const autoTransitions = (definition.definition.transitions || []).filter(
     (t) => t.fromStepId === instance.currentStepId && t.trigger === "auto"
   );
@@ -205,13 +262,15 @@ async function sendSignal(em, container, options) {
     await em.flush();
     return;
   }
+  instance.status = "RUNNING";
+  await em.flush();
   const transitionResult = await transitionHandler.executeTransition(
     em,
     container,
     instance,
     instance.currentStepId,
     firstValidTransition.transition.toStepId,
-    transitionContext
+    { ...transitionContext, transitionId: firstValidTransition.transition.transitionId }
   );
   if (!transitionResult.success) {
     throw new SignalError(

package/dist/modules/workflows/lib/signal-handler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/signal-handler.ts"],
-  "sourcesContent": ["/**\n * Signal Handler Service\n *\n * Receives external signals and resumes workflows waiting for them.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { WorkflowInstance, WorkflowBranchInstance, WorkflowDefinition, StepInstance } from '../data/entities'\nimport type * as eventLoggerModule from './event-logger'\nimport type * as stepHandlerModule from './step-handler'\nimport type * as transitionHandlerModule from './transition-handler'\nimport type * as workflowExecutorModule from './workflow-executor'\nimport { resolveCodeDefinitionForInstance } from './find-definition'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\nexport interface SendSignalOptions {\n  /**\n   * Workflow instance ID\n   */\n  instanceId: string\n\n  /**\n   * Signal name to match against WAIT_FOR_SIGNAL step config\n   */\n  signalName: string\n\n  /**\n   * Optional payload to merge into workflow context\n   */\n  payload?: Record<string, any>\n\n  /**\n   * User ID sending the signal\n   */\n  userId?: string\n\n  /**\n   * Tenant/org scope\n   */\n  tenantId: string\n  organizationId: string\n}\n\nexport class SignalError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'SignalError'\n  }\n}\n\n/**\n * Send signal to workflow instance and resume execution\n */\nexport async function sendSignal(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: SendSignalOptions\n): Promise<void> {\n  const { instanceId, signalName, payload, userId, tenantId, organizationId } = options\n\n  const eventLogger = container.resolve<typeof eventLoggerModule>('eventLogger')\n  const stepHandler = container.resolve<typeof stepHandlerModule>('stepHandler')\n  const transitionHandler = container.resolve<typeof transitionHandlerModule>('transitionHandler')\n  const workflowExecutor = container.resolve<typeof workflowExecutorModule>('workflowExecutor')\n\n  // Fetch workflow instance\n  const instance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      id: instanceId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  if (!instance) {\n    throw new SignalError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  // Branch-scoped signal: a FORKED instance routes the signal to the branch\n  // paused at a matching WAIT_FOR_SIGNAL step.\n  if (instance.status === 'FORKED') {\n    const branchDefinition = (await findOneWithDecryption(\n      em as PostgreSqlEntityManager,\n      WorkflowDefinition,\n      { id: instance.definitionId, tenantId: instance.tenantId, organizationId: instance.organizationId, deletedAt: null },\n      undefined,\n      { tenantId: instance.tenantId, organizationId: instance.organizationId },\n    )) ?? resolveCodeDefinitionForInstance(instance)\n    if (!branchDefinition) {\n      throw new SignalError('Workflow definition not found', 'DEFINITION_NOT_FOUND', { definitionId: instance.definitionId })\n    }\n\n    const pausedBranches = await em.find(WorkflowBranchInstance, {\n      workflowInstanceId: instanceId,\n      status: 'PAUSED',\n      tenantId,\n      organizationId,\n    })\n\n    let targetBranch: WorkflowBranchInstance | null = null\n    for (const candidate of pausedBranches) {\n      const step = branchDefinition.definition.steps.find((s: any) => s.stepId === candidate.currentStepId)\n      if (step?.stepType === 'WAIT_FOR_SIGNAL') {\n        const candidateSignal = step.signalConfig?.signalName || step.stepId\n        if (candidateSignal === signalName) {\n          targetBranch = candidate\n          break\n        }\n      }\n    }\n\n    if (!targetBranch) {\n      throw new SignalError('No parallel branch awaiting this signal', 'NO_BRANCH_AWAITING_SIGNAL', { instanceId, signalName })\n    }\n\n    const branchStepInstance = await em.findOne(StepInstance, {\n      workflowInstanceId: instanceId,\n      branchInstanceId: targetBranch.id,\n      stepId: targetBranch.currentStepId,\n      status: 'ACTIVE',\n    })\n\n    await eventLogger.logWorkflowEvent(em, {\n      workflowInstanceId: instanceId,\n      stepInstanceId: branchStepInstance?.id,\n      branchInstanceId: targetBranch.id,\n      eventType: 'SIGNAL_RECEIVED',\n      eventData: { signalName, branch: true },\n      userId,\n      tenantId,\n      organizationId,\n    })\n\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId,\n      branchInstanceId: targetBranch.id,\n      tenantId,\n      organizationId,\n      contextMerge: payload,\n      exitStepInstanceId: branchStepInstance?.id ?? null,\n      exitOutput: { signalName, payload },\n    })\n    if (resumed) {\n      await workflowExecutor.executeWorkflow(em, container, instanceId, { userId })\n    }\n    return\n  }\n\n  // Verify workflow is paused\n  if (instance.status !== 'PAUSED') {\n    throw new SignalError(\n      'Workflow is not paused',\n      'WORKFLOW_NOT_PAUSED',\n      { instanceId, status: instance.status }\n    )\n  }\n\n  // Load workflow definition with tenant/org scope to check current step\n  const definition = (await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowDefinition,\n    {\n      id: instance.definitionId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      deletedAt: null,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )) ?? resolveCodeDefinitionForInstance(instance)\n  if (!definition) {\n    throw new SignalError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find current step\n  const currentStep = definition.definition.steps.find(\n    (s: any) => s.stepId === instance.currentStepId\n  )\n\n  if (!currentStep || currentStep.stepType !== 'WAIT_FOR_SIGNAL') {\n    throw new SignalError(\n      'Workflow is not waiting for signal',\n      'NOT_WAITING_FOR_SIGNAL',\n      { instanceId, currentStepId: instance.currentStepId }\n    )\n  }\n\n  // Check signal name matches\n  const expectedSignalName = currentStep.signalConfig?.signalName || currentStep.stepId\n  if (expectedSignalName !== signalName) {\n    throw new SignalError(\n      'Signal name mismatch',\n      'SIGNAL_NAME_MISMATCH',\n      { expected: expectedSignalName, received: signalName }\n    )\n  }\n\n  const now = new Date()\n\n  // Merge signal payload into workflow context\n  if (payload) {\n    instance.context = {\n      ...instance.context,\n      ...payload,\n      [`signal_${signalName}_payload`]: payload,\n      [`signal_${signalName}_receivedAt`]: now.toISOString(),\n    }\n  }\n\n  instance.updatedAt = now\n\n  // Log signal received event\n  await eventLogger.logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    eventType: 'SIGNAL_RECEIVED',\n    eventData: {\n      signalName,\n      payload,\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Find active step instance and exit it\n  const stepInstance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    StepInstance,\n    {\n      workflowInstanceId: instance.id,\n      stepId: instance.currentStepId,\n      status: 'ACTIVE',\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, {\n      signalName,\n      payload,\n    })\n  }\n\n  // Find automatic transitions from current step\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === instance.currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    // No automatic transitions, mark as RUNNING but stay at current step\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Find valid transitions\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    instance.currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find((t) => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    // No valid transitions, mark as RUNNING anyway\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Execute transition to next step\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    instance.currentStepId,\n    firstValidTransition.transition.toStepId,\n    transitionContext\n  )\n\n  if (!transitionResult.success) {\n    throw new SignalError(\n      'Transition failed after signal',\n      'TRANSITION_FAILED',\n      { error: transitionResult.error }\n    )\n  }\n\n  // Resume workflow execution\n  await workflowExecutor.executeWorkflow(em, container, instance.id, { userId })\n}\n\n/**\n * Send signal by correlation key (finds all waiting instances)\n */\nexport async function sendSignalByCorrelationKey(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: Omit<SendSignalOptions, 'instanceId'> & { correlationKey: string }\n): Promise<number> {\n  const { correlationKey, signalName, payload, userId, tenantId, organizationId } = options\n\n  // Find all paused instances with this correlation key\n  const instances = await findWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      correlationKey,\n      status: 'PAUSED',\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  let signalsProcessed = 0\n\n  for (const instance of instances) {\n    try {\n      await sendSignal(em, container, {\n        instanceId: instance.id,\n        signalName,\n        payload,\n        userId,\n        tenantId,\n        organizationId,\n      })\n      signalsProcessed++\n    } catch (error) {\n      // Log error but continue processing other instances\n      logger.error('Failed to send signal to instance', { instanceId: instance.id, err: error })\n    }\n  }\n\n  return signalsProcessed\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Signal Handler Service\n *\n * Receives external signals and resumes workflows waiting for them.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { WorkflowInstance, WorkflowBranchInstance, WorkflowDefinition, StepInstance } from '../data/entities'\nimport { INVOKE_AGENT_SIGNAL_NAME, SUB_WORKFLOW_SIGNAL_NAME } from './activity-executor'\nimport type * as eventLoggerModule from './event-logger'\nimport type * as stepHandlerModule from './step-handler'\nimport type * as transitionHandlerModule from './transition-handler'\nimport type * as workflowExecutorModule from './workflow-executor'\nimport { resolveCodeDefinitionForInstance } from './find-definition'\nimport {\n  WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY,\n  buildAgentOutcomeContextEntry,\n  mapDispositionToAgentOutcome,\n  type AgentOutcomeKind,\n} from './outcome-routing'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\nexport interface SendSignalOptions {\n  /**\n   * Workflow instance ID\n   */\n  instanceId: string\n\n  /**\n   * Signal name to match against WAIT_FOR_SIGNAL step config\n   */\n  signalName: string\n\n  /**\n   * Optional payload to merge into workflow context\n   */\n  payload?: Record<string, any>\n\n  /** Engine-owned outcome metadata kept separate from author-visible mappings. */\n  agentOutcome?: AgentOutcomeKind\n\n  /** Proposal identifier associated with `agentOutcome`, when present. */\n  agentProposalId?: string\n\n  /**\n   * User ID sending the signal\n   */\n  userId?: string\n\n  /**\n   * Tenant/org scope\n   */\n  tenantId: string\n  organizationId: string\n}\n\nexport class SignalError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'SignalError'\n  }\n}\n\n/**\n * Send signal to workflow instance and resume execution\n */\nexport async function sendSignal(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: SendSignalOptions\n): Promise<void> {\n  const {\n    instanceId,\n    signalName,\n    payload,\n    agentOutcome,\n    agentProposalId,\n    userId,\n    tenantId,\n    organizationId,\n  } = options\n\n  const eventLogger = container.resolve<typeof eventLoggerModule>('eventLogger')\n  const stepHandler = container.resolve<typeof stepHandlerModule>('stepHandler')\n  const transitionHandler = container.resolve<typeof transitionHandlerModule>('transitionHandler')\n  const workflowExecutor = container.resolve<typeof workflowExecutorModule>('workflowExecutor')\n\n  // Fetch workflow instance\n  const instance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      id: instanceId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  if (!instance) {\n    throw new SignalError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  // Branch-scoped signal: a FORKED instance routes the signal to the branch\n  // paused at a matching WAIT_FOR_SIGNAL step.\n  if (instance.status === 'FORKED') {\n    const branchDefinition = (await findOneWithDecryption(\n      em as PostgreSqlEntityManager,\n      WorkflowDefinition,\n      { id: instance.definitionId, tenantId: instance.tenantId, organizationId: instance.organizationId, deletedAt: null },\n      undefined,\n      { tenantId: instance.tenantId, organizationId: instance.organizationId },\n    )) ?? resolveCodeDefinitionForInstance(instance)\n    if (!branchDefinition) {\n      throw new SignalError('Workflow definition not found', 'DEFINITION_NOT_FOUND', { definitionId: instance.definitionId })\n    }\n\n    const pausedBranches = await em.find(WorkflowBranchInstance, {\n      workflowInstanceId: instanceId,\n      status: 'PAUSED',\n      tenantId,\n      organizationId,\n    })\n\n    let targetBranch: WorkflowBranchInstance | null = null\n    for (const candidate of pausedBranches) {\n      const step = branchDefinition.definition.steps.find((s: any) => s.stepId === candidate.currentStepId)\n      if (step?.stepType === 'WAIT_FOR_SIGNAL') {\n        const candidateSignal = step.signalConfig?.signalName || step.stepId\n        if (candidateSignal === signalName) {\n          targetBranch = candidate\n          break\n        }\n      }\n    }\n\n    if (!targetBranch) {\n      throw new SignalError('No parallel branch awaiting this signal', 'NO_BRANCH_AWAITING_SIGNAL', { instanceId, signalName })\n    }\n\n    const branchStepInstance = await em.findOne(StepInstance, {\n      workflowInstanceId: instanceId,\n      branchInstanceId: targetBranch.id,\n      stepId: targetBranch.currentStepId,\n      status: 'ACTIVE',\n    })\n\n    await eventLogger.logWorkflowEvent(em, {\n      workflowInstanceId: instanceId,\n      stepInstanceId: branchStepInstance?.id,\n      branchInstanceId: targetBranch.id,\n      eventType: 'SIGNAL_RECEIVED',\n      eventData: { signalName, branch: true },\n      userId,\n      tenantId,\n      organizationId,\n    })\n\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId,\n      branchInstanceId: targetBranch.id,\n      tenantId,\n      organizationId,\n      contextMerge: payload,\n      exitStepInstanceId: branchStepInstance?.id ?? null,\n      exitOutput: { signalName, payload },\n    })\n    if (resumed) {\n      await workflowExecutor.executeWorkflow(em, container, instanceId, { userId })\n    }\n    return\n  }\n\n  // Verify workflow is paused\n  if (instance.status !== 'PAUSED') {\n    throw new SignalError(\n      'Workflow is not paused',\n      'WORKFLOW_NOT_PAUSED',\n      { instanceId, status: instance.status }\n    )\n  }\n\n  // Load workflow definition with tenant/org scope to check current step\n  const definition = (await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowDefinition,\n    {\n      id: instance.definitionId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      deletedAt: null,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )) ?? resolveCodeDefinitionForInstance(instance)\n  if (!definition) {\n    throw new SignalError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find current step\n  const currentStep = definition.definition.steps.find(\n    (s: any) => s.stepId === instance.currentStepId\n  )\n\n  // A dedicated WAIT_FOR_SIGNAL step \u2014 OR any step that parked while declaring a\n  // `signalConfig.signalName` (e.g. an AUTOMATED step whose INVOKE_AGENT activity\n  // routed its proposal to a human) \u2014 can be resumed by a matching signal. The\n  // resume path below (merge payload \u2192 exit step \u2192 run auto transitions) is\n  // step-type-agnostic, so widening this guard is additive and safe.\n  //\n  // INVOKE_AGENT steps run their agent asynchronously (off the workflow\n  // transaction) and park on `agent_orchestrator.proposal.ready`; recognize them\n  // even when the definition omits an explicit `signalConfig.signalName` (e.g.\n  // seeded blueprints not re-saved through the visual editor) so the activity\n  // worker can resume them after the agent completes.\n  const isInvokeAgentStep =\n    !!currentStep &&\n    Array.isArray(currentStep.activities) &&\n    currentStep.activities.some((a: any) => a?.activityType === 'INVOKE_AGENT')\n  // SUB_WORKFLOW steps park while their child instance runs its own async/agent\n  // steps and resume on SUB_WORKFLOW_SIGNAL_NAME once the child terminates;\n  // recognize them even without an explicit signalConfig.signalName.\n  const isSubWorkflowStep = !!currentStep && currentStep.stepType === 'SUB_WORKFLOW'\n  const stepCanReceiveSignal =\n    !!currentStep &&\n    (currentStep.stepType === 'WAIT_FOR_SIGNAL' ||\n      !!currentStep.signalConfig?.signalName ||\n      isInvokeAgentStep ||\n      isSubWorkflowStep)\n  if (!stepCanReceiveSignal) {\n    throw new SignalError(\n      'Workflow is not waiting for signal',\n      'NOT_WAITING_FOR_SIGNAL',\n      { instanceId, currentStepId: instance.currentStepId }\n    )\n  }\n\n  // Check signal name matches\n  const expectedSignalName =\n    currentStep.signalConfig?.signalName ||\n    (isInvokeAgentStep\n      ? INVOKE_AGENT_SIGNAL_NAME\n      : isSubWorkflowStep\n        ? SUB_WORKFLOW_SIGNAL_NAME\n        : currentStep.stepId)\n  if (expectedSignalName !== signalName) {\n    throw new SignalError(\n      'Signal name mismatch',\n      'SIGNAL_NAME_MISMATCH',\n      { expected: expectedSignalName, received: signalName }\n    )\n  }\n\n  const now = new Date()\n\n  // Merge signal payload into workflow context\n  if (payload) {\n    instance.context = {\n      ...instance.context,\n      ...payload,\n      [`signal_${signalName}_payload`]: payload,\n      [`signal_${signalName}_receivedAt`]: now.toISOString(),\n    }\n  }\n\n  // Outcome routing (spec 7.2). The signal is how EVERY resolved disposition\n  // reaches a parked agent step \u2014 the activity worker's auto_approved and\n  // researcher resumes and the human dispose path alike \u2014 so this is the one\n  // place the disposition has to be translated into the engine-owned outcome\n  // marker the executor routes on. Recorded regardless of who sent the signal;\n  // the author-visible `disposition` key stays untouched and unread by routing.\n  if (isInvokeAgentStep && instance.currentStepId) {\n    const resolvedOutcome = agentOutcome ?? mapDispositionToAgentOutcome(\n      (payload as Record<string, unknown> | undefined)?.disposition,\n    )\n    if (resolvedOutcome) {\n      const proposalId = agentProposalId\n        ?? (payload as Record<string, unknown> | undefined)?.agentProposalId\n        ?? (payload as Record<string, unknown> | undefined)?.proposalId\n      instance.context = {\n        ...instance.context,\n        [WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY]: buildAgentOutcomeContextEntry(\n          instance.currentStepId,\n          resolvedOutcome,\n          typeof proposalId === 'string' ? proposalId : undefined,\n        ),\n      }\n    }\n  }\n\n  instance.updatedAt = now\n\n  // Log signal received event\n  await eventLogger.logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    eventType: 'SIGNAL_RECEIVED',\n    eventData: {\n      signalName,\n      payload,\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Find active step instance and exit it\n  const stepInstance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    StepInstance,\n    {\n      workflowInstanceId: instance.id,\n      stepId: instance.currentStepId,\n      status: 'ACTIVE',\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, {\n      signalName,\n      payload,\n    })\n  }\n\n  // Outcome routing (spec 7.2). A resumed agent step is advanced HERE, not by\n  // the executor loop, so the wired outcome route has to be honoured here too \u2014\n  // routing it in only one of the two places would silently send every\n  // human-dispositioned proposal down the happy path.\n  //\n  // Resume from the paused wait BEFORE dispatching, exactly as the ordinary\n  // resume path below does. On this path the instance is PAUSED by definition \u2014\n  // it is parked on the very signal being delivered \u2014 and two things depended on\n  // that being cleared first: the executor's defence-in-depth PAUSED guard stops\n  // a routed run at its first step, and `instance.status === 'PAUSED'` below\n  // could never mean \"this dispatch parked the run\" while the pre-existing pause\n  // was still set. Every routed outcome therefore returned early and the run sat\n  // on its route target, PAUSED, forever (TC-WF-051, TC-WF-052).\n  instance.status = 'RUNNING'\n  await em.flush()\n\n  // Imported lazily rather than read off the DI-resolved executor: the resolved\n  // service is the module, and reaching for a named export on it couples this\n  // path to every test double that stubs only the two methods it needed.\n  const { dispatchAgentOutcomeForCurrentStep } = await import('./workflow-executor')\n  const outcomeDispatch = await dispatchAgentOutcomeForCurrentStep(\n    em,\n    container,\n    instance,\n    definition.definition,\n    { workflowContext: instance.context, userId },\n  )\n  if (outcomeDispatch && outcomeDispatch.kind !== 'default') {\n    if (outcomeDispatch.kind === 'failed') {\n      await workflowExecutor.completeWorkflow(em, container, instance.id, 'FAILED', {\n        error: outcomeDispatch.error,\n      })\n      return\n    }\n    if (outcomeDispatch.kind === 'parked') return\n    // `paused` is the dispatch's own report that IT parked the run (a\n    // step-through release, a wait step on the far side of the route).\n    if (outcomeDispatch.paused) return\n    await em.flush()\n    await workflowExecutor.executeWorkflow(em, container, instance.id, { userId })\n    return\n  }\n\n  // Find automatic transitions from current step\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === instance.currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    // No automatic transitions, mark as RUNNING but stay at current step\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Find valid transitions\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    instance.currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find((t) => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    // No valid transitions, mark as RUNNING anyway\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Resume from the paused wait: flip to RUNNING before executing the transition\n  // and re-entering executeWorkflow. Without this the executor's defense-in-depth\n  // PAUSED check stops the run after the first traversed step, so an intermediate\n  // AUTOMATED step (e.g. an emit-event \"flag\") between the waiting step and END\n  // leaves the instance permanently parked \u2014 and any parent sub-workflow waiting on\n  // its completion never resumes. The no-transition branches above already do this.\n  instance.status = 'RUNNING'\n  await em.flush()\n\n  // Execute transition to next step\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    instance.currentStepId,\n    firstValidTransition.transition.toStepId,\n    { ...transitionContext, transitionId: firstValidTransition.transition.transitionId },\n  )\n\n  if (!transitionResult.success) {\n    throw new SignalError(\n      'Transition failed after signal',\n      'TRANSITION_FAILED',\n      { error: transitionResult.error }\n    )\n  }\n\n  // Resume workflow execution\n  await workflowExecutor.executeWorkflow(em, container, instance.id, { userId })\n}\n\n/**\n * Send signal by correlation key (finds all waiting instances)\n */\nexport async function sendSignalByCorrelationKey(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: Omit<SendSignalOptions, 'instanceId'> & { correlationKey: string }\n): Promise<number> {\n  const { correlationKey, signalName, payload, userId, tenantId, organizationId } = options\n\n  // Find all paused instances with this correlation key\n  const instances = await findWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      correlationKey,\n      status: 'PAUSED',\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  let signalsProcessed = 0\n\n  for (const instance of instances) {\n    try {\n      await sendSignal(em, container, {\n        instanceId: instance.id,\n        signalName,\n        payload,\n        userId,\n        tenantId,\n        organizationId,\n      })\n      signalsProcessed++\n    } catch (error) {\n      // Log error but continue processing other instances\n      logger.error('Failed to send signal to instance', { instanceId: instance.id, err: error })\n    }\n  }\n\n  return signalsProcessed\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/start-fixtures.js

@@ -0,0 +1,42 @@
+const WORKFLOW_START_FIXTURES_MAX_CHARS = 65536;
+const WORKFLOW_START_FIXTURE_NAME_MAX = 80;
+const WORKFLOW_START_FIXTURES_MAX_COUNT = 25;
+function normalizeName(name) {
+  return name.trim();
+}
+function upsertStartFixture(fixtures, name, context, savedAt) {
+  const trimmed = normalizeName(name);
+  if (!trimmed) return { ok: false, reason: "emptyName" };
+  if (trimmed.length > WORKFLOW_START_FIXTURE_NAME_MAX) return { ok: false, reason: "nameTooLong" };
+  const next = { ...fixtures ?? {} };
+  const isNew = !(trimmed in next);
+  if (isNew && Object.keys(next).length >= WORKFLOW_START_FIXTURES_MAX_COUNT) {
+    return { ok: false, reason: "tooMany" };
+  }
+  next[trimmed] = { name: trimmed, savedAt, context };
+  if (JSON.stringify(next).length > WORKFLOW_START_FIXTURES_MAX_CHARS) {
+    return { ok: false, reason: "tooLarge" };
+  }
+  return { ok: true, fixtures: next };
+}
+function removeStartFixture(fixtures, name) {
+  const next = { ...fixtures ?? {} };
+  delete next[normalizeName(name)];
+  return next;
+}
+function listStartFixtures(fixtures) {
+  const entries = Object.values(fixtures ?? {});
+  return [...entries].sort((left, right) => {
+    if (left.savedAt !== right.savedAt) return left.savedAt < right.savedAt ? 1 : -1;
+    return left.name.localeCompare(right.name);
+  });
+}
+export {
+  WORKFLOW_START_FIXTURES_MAX_CHARS,
+  WORKFLOW_START_FIXTURES_MAX_COUNT,
+  WORKFLOW_START_FIXTURE_NAME_MAX,
+  listStartFixtures,
+  removeStartFixture,
+  upsertStartFixture
+};
+//# sourceMappingURL=start-fixtures.js.map

package/dist/modules/workflows/lib/start-fixtures.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/start-fixtures.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 Start fixtures (spec section 8.1)\n *\n * *\"fixtures (named start contexts \u2014 \"happy path\", \"missing phone\")\"*.\n *\n * Fixtures are deliberately a DIFFERENT thing from pinned samples (section 3.6),\n * and the spec says so: a sample is per-STEP data feeding previews and the\n * ledger, a fixture is a whole START context. Conflating them would make \"which\n * one wins\" a question with no answer. They share a home\n * (`metadata.editor.*`) and a cap discipline, nothing else.\n *\n * Like samples, fixture data is stored VERBATIM and is neither redacted nor\n * encrypted \u2014 keep the warning copy wherever a fixture is saved.\n *\n * PURE: no ORM, no DI, no React.\n */\n\nexport const WORKFLOW_START_FIXTURES_MAX_CHARS = 65536\nexport const WORKFLOW_START_FIXTURE_NAME_MAX = 80\nexport const WORKFLOW_START_FIXTURES_MAX_COUNT = 25\n\nexport type WorkflowStartFixture = {\n  name: string\n  savedAt: string\n  context: Record<string, unknown>\n}\n\nexport type WorkflowStartFixtures = Record<string, WorkflowStartFixture>\n\nexport type FixtureWriteResult =\n  | { ok: true; fixtures: WorkflowStartFixtures }\n  | { ok: false; reason: 'emptyName' | 'nameTooLong' | 'tooMany' | 'tooLarge' }\n\nfunction normalizeName(name: string): string {\n  return name.trim()\n}\n\n/**\n * Add or replace a fixture.\n *\n * Every limit is checked against the RESULT, not the input, so replacing an\n * existing fixture with a smaller one always succeeds even when the collection\n * is already at its cap \u2014 the alternative would strand an author who is trying\n * to shrink their way back under it.\n */\nexport function upsertStartFixture(\n  fixtures: WorkflowStartFixtures | null | undefined,\n  name: string,\n  context: Record<string, unknown>,\n  savedAt: string,\n): FixtureWriteResult {\n  const trimmed = normalizeName(name)\n  if (!trimmed) return { ok: false, reason: 'emptyName' }\n  if (trimmed.length > WORKFLOW_START_FIXTURE_NAME_MAX) return { ok: false, reason: 'nameTooLong' }\n\n  const next: WorkflowStartFixtures = { ...(fixtures ?? {}) }\n  const isNew = !(trimmed in next)\n  if (isNew && Object.keys(next).length >= WORKFLOW_START_FIXTURES_MAX_COUNT) {\n    return { ok: false, reason: 'tooMany' }\n  }\n\n  next[trimmed] = { name: trimmed, savedAt, context }\n\n  if (JSON.stringify(next).length > WORKFLOW_START_FIXTURES_MAX_CHARS) {\n    return { ok: false, reason: 'tooLarge' }\n  }\n\n  return { ok: true, fixtures: next }\n}\n\nexport function removeStartFixture(\n  fixtures: WorkflowStartFixtures | null | undefined,\n  name: string,\n): WorkflowStartFixtures {\n  const next: WorkflowStartFixtures = { ...(fixtures ?? {}) }\n  delete next[normalizeName(name)]\n  return next\n}\n\n/**\n * List fixtures for display, newest save first, name as the stable tiebreaker\n * (never a bare `.sort()` \u2014 an unordered picker reshuffles under the author's\n * cursor between renders).\n */\nexport function listStartFixtures(\n  fixtures: WorkflowStartFixtures | null | undefined,\n): WorkflowStartFixture[] {\n  const entries = Object.values(fixtures ?? {})\n  return [...entries].sort((left, right) => {\n    if (left.savedAt !== right.savedAt) return left.savedAt < right.savedAt ? 1 : -1\n    return left.name.localeCompare(right.name)\n  })\n}\n"],
+  "mappings": "AAiBO,MAAM,oCAAoC;AAC1C,MAAM,kCAAkC;AACxC,MAAM,oCAAoC;AAcjD,SAAS,cAAc,MAAsB;AAC3C,SAAO,KAAK,KAAK;AACnB;AAUO,SAAS,mBACd,UACA,MACA,SACA,SACoB;AACpB,QAAM,UAAU,cAAc,IAAI;AAClC,MAAI,CAAC,QAAS,QAAO,EAAE,IAAI,OAAO,QAAQ,YAAY;AACtD,MAAI,QAAQ,SAAS,gCAAiC,QAAO,EAAE,IAAI,OAAO,QAAQ,cAAc;AAEhG,QAAM,OAA8B,EAAE,GAAI,YAAY,CAAC,EAAG;AAC1D,QAAM,QAAQ,EAAE,WAAW;AAC3B,MAAI,SAAS,OAAO,KAAK,IAAI,EAAE,UAAU,mCAAmC;AAC1E,WAAO,EAAE,IAAI,OAAO,QAAQ,UAAU;AAAA,EACxC;AAEA,OAAK,OAAO,IAAI,EAAE,MAAM,SAAS,SAAS,QAAQ;AAElD,MAAI,KAAK,UAAU,IAAI,EAAE,SAAS,mCAAmC;AACnE,WAAO,EAAE,IAAI,OAAO,QAAQ,WAAW;AAAA,EACzC;AAEA,SAAO,EAAE,IAAI,MAAM,UAAU,KAAK;AACpC;AAEO,SAAS,mBACd,UACA,MACuB;AACvB,QAAM,OAA8B,EAAE,GAAI,YAAY,CAAC,EAAG;AAC1D,SAAO,KAAK,cAAc,IAAI,CAAC;AAC/B,SAAO;AACT;AAOO,SAAS,kBACd,UACwB;AACxB,QAAM,UAAU,OAAO,OAAO,YAAY,CAAC,CAAC;AAC5C,SAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,UAAU;AACxC,QAAI,KAAK,YAAY,MAAM,QAAS,QAAO,KAAK,UAAU,MAAM,UAAU,IAAI;AAC9E,WAAO,KAAK,KAAK,cAAc,MAAM,IAAI;AAAA,EAC3C,CAAC;AACH;",
+  "names": []
+}

package/dist/modules/workflows/lib/status-colors.js

@@ -1,47 +1,178 @@
 const STATUS_COLORS = {
   completed: {
-    bg: "bg-emerald-100",
-    border: "border-emerald-300",
-    text: "text-emerald-900",
-    icon: "text-emerald-600",
-    hex: "#10b981"
+    bg: "bg-status-success-bg",
+    border: "border-status-success-border",
+    text: "text-status-success-text",
+    icon: "text-status-success-icon",
+    hex: "var(--status-success-icon)"
   },
   in_progress: {
-    bg: "bg-blue-100",
-    border: "border-blue-300",
-    text: "text-blue-900",
-    icon: "text-blue-600",
-    hex: "#3b82f6"
+    bg: "bg-status-info-bg",
+    border: "border-status-info-border",
+    text: "text-status-info-text",
+    icon: "text-status-info-icon",
+    hex: "var(--status-info-icon)"
   },
   pending: {
-    bg: "bg-yellow-100",
-    border: "border-yellow-300",
-    text: "text-yellow-900",
-    icon: "text-yellow-600",
-    hex: "#eab308"
+    bg: "bg-status-warning-bg",
+    border: "border-status-warning-border",
+    text: "text-status-warning-text",
+    icon: "text-status-warning-icon",
+    hex: "var(--status-warning-icon)"
+  },
+  failed: {
+    bg: "bg-status-error-bg",
+    border: "border-status-error-border",
+    text: "text-status-error-text",
+    icon: "text-status-error-icon",
+    hex: "var(--status-error-icon)"
+  },
+  paused: {
+    bg: "bg-status-warning-bg",
+    border: "border-status-warning-border",
+    text: "text-status-warning-text",
+    icon: "text-status-warning-icon",
+    hex: "var(--status-warning-icon)"
   },
   not_started: {
     bg: "bg-muted",
     border: "border-border",
     text: "text-foreground",
     icon: "text-muted-foreground",
-    hex: "#6b7280"
+    hex: "var(--muted-foreground)"
+  },
+  error: {
+    bg: "bg-status-error-bg",
+    border: "border-status-error-border",
+    text: "text-status-error-text",
+    icon: "text-status-error-icon",
+    hex: "var(--status-error-icon)"
+  },
+  working: {
+    bg: "bg-status-info-bg",
+    border: "border-status-info-border",
+    text: "text-status-info-text",
+    icon: "text-status-info-icon",
+    hex: "var(--status-info-icon)"
+  },
+  waiting: {
+    bg: "bg-status-warning-bg",
+    border: "border-status-warning-border",
+    text: "text-status-warning-text",
+    icon: "text-status-warning-icon",
+    hex: "var(--status-warning-icon)"
+  },
+  // "Destructive-adjacent" (spec Part 2): a parked run is not a failed run, so
+  // it does not get `failed`'s glyph — but it does need a human, so it borrows
+  // the error tokens rather than sitting quietly in amber next to a timer.
+  needs_attention: {
+    bg: "bg-status-error-bg",
+    border: "border-status-error-border",
+    text: "text-status-error-text",
+    icon: "text-status-error-icon",
+    hex: "var(--status-error-icon)"
   }
 };
+function toWorkflowStatus(status) {
+  if (!status || status === "pending") return "not_started";
+  if (status === "running" || status === "in_progress" || status === "active") return "in_progress";
+  if (status === "completed") return "completed";
+  if (status === "failed" || status === "error") return "failed";
+  if (status === "working") return "working";
+  if (status === "waiting") return "waiting";
+  if (status === "needs_attention") return "needs_attention";
+  if (status === "waiting_for_activities") return "working";
+  if (status === "paused") return "paused";
+  return "not_started";
+}
 const EDGE_COLORS = {
   completed: {
-    stroke: "#10b981",
-    strokeClass: "stroke-emerald-500",
-    dashed: false
+    stroke: "var(--status-success-icon)",
+    strokeClass: "stroke-status-success-icon",
+    strokeWidth: 2,
+    dashed: false,
+    dashArray: void 0
   },
   pending: {
-    stroke: "#9ca3af",
+    stroke: "color-mix(in oklab, var(--muted-foreground) 70%, transparent)",
     strokeClass: "stroke-muted-foreground",
-    dashed: true
+    strokeWidth: 1.5,
+    dashed: false,
+    dashArray: void 0
+  },
+  error: {
+    stroke: "var(--status-error-icon)",
+    strokeClass: "stroke-status-error-icon",
+    strokeWidth: 2,
+    dashed: true,
+    dashArray: "8,4"
+  }
+};
+const STEP_STATUS_STYLES = {
+  completed: {
+    backgroundColor: "var(--status-success-bg)",
+    color: "var(--status-success-text)",
+    borderColor: "var(--status-success-border)",
+    borderWidth: "3px",
+    borderRadius: "16px"
+  },
+  active: {
+    backgroundColor: "var(--status-info-bg)",
+    color: "var(--status-info-text)",
+    borderColor: "var(--status-info-border)",
+    borderWidth: "3px",
+    borderRadius: "16px",
+    boxShadow: "0 0 0 3px var(--status-info-border)"
+  },
+  failed: {
+    backgroundColor: "var(--status-error-bg)",
+    color: "var(--status-error-text)",
+    borderColor: "var(--status-error-border)",
+    borderWidth: "3px",
+    borderRadius: "16px"
+  },
+  skipped: {
+    backgroundColor: "var(--status-warning-bg)",
+    color: "var(--status-warning-text)",
+    borderColor: "var(--status-warning-border)",
+    borderWidth: "3px",
+    borderRadius: "16px"
+  },
+  paused: {
+    backgroundColor: "var(--status-warning-bg)",
+    color: "var(--status-warning-text)",
+    borderColor: "var(--status-warning-icon)",
+    borderWidth: "3px",
+    borderRadius: "16px"
+  },
+  pending: {
+    backgroundColor: "var(--status-neutral-bg)",
+    color: "var(--status-neutral-text)",
+    borderColor: "var(--status-neutral-border)",
+    borderWidth: "2px",
+    borderRadius: "8px"
   }
 };
+const PRESENTATION_STEP_STYLES = {
+  working: STEP_STATUS_STYLES.active,
+  waiting: STEP_STATUS_STYLES.paused,
+  attention: {
+    backgroundColor: "var(--status-warning-bg)",
+    color: "var(--status-error-text)",
+    borderColor: "var(--status-error-icon)",
+    borderWidth: "3px",
+    borderRadius: "16px"
+  },
+  completed: STEP_STATUS_STYLES.completed,
+  failed: STEP_STATUS_STYLES.failed,
+  skipped: STEP_STATUS_STYLES.skipped,
+  not_started: STEP_STATUS_STYLES.pending
+};
 export {
   EDGE_COLORS,
-  STATUS_COLORS
+  PRESENTATION_STEP_STYLES,
+  STATUS_COLORS,
+  STEP_STATUS_STYLES,
+  toWorkflowStatus
 };
 //# sourceMappingURL=status-colors.js.map