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

package/dist/modules/workflows/lib/advanced-config.js

@@ -0,0 +1,31 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
+const logger = createLogger("workflows");
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseAdvancedConfigValue(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "object") {
+    if (!isPlainRecord(value)) {
+      logger.error("Advanced Configuration must be a JSON object", { received: Array.isArray(value) ? "array" : typeof value });
+      throw new Error("workflows.validation.invalidAdvancedConfigJson");
+    }
+    return Object.keys(value).length > 0 ? value : void 0;
+  }
+  if (!value.trim()) return void 0;
+  try {
+    const parsed = JSON.parse(value);
+    if (!isPlainRecord(parsed)) {
+      throw new Error("[internal] advanced configuration must parse to a JSON object");
+    }
+    return Object.keys(parsed).length > 0 ? parsed : void 0;
+  } catch (error) {
+    logger.error("Invalid JSON in Advanced Configuration", { err: error });
+    throw new Error("workflows.validation.invalidAdvancedConfigJson");
+  }
+}
+export {
+  isPlainRecord,
+  parseAdvancedConfigValue
+};
+//# sourceMappingURL=advanced-config.js.map

package/dist/modules/workflows/lib/advanced-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/advanced-config.ts"],
+  "sourcesContent": ["/**\n * Advanced Configuration value handling shared by the node and edge form transforms.\n *\n * The CrudForm dialogs render the Advanced Configuration field with JsonBuilder,\n * which emits the PARSED OBJECT on every valid edit. Legacy callers (and tests)\n * may still hand the transforms a JSON string. The transform boundary accepts\n * both: objects are used directly, strings are trimmed and parsed. Invalid\n * strings and non-object payloads surface the existing i18n validation key.\n */\n\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\nexport type AdvancedConfigValue = Record<string, unknown> | string | undefined\n\nexport function isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nexport function parseAdvancedConfigValue(value: AdvancedConfigValue): Record<string, unknown> | undefined {\n  if (value === undefined || value === null) return undefined\n  if (typeof value === 'object') {\n    if (!isPlainRecord(value)) {\n      logger.error('Advanced Configuration must be a JSON object', { received: Array.isArray(value) ? 'array' : typeof value })\n      throw new Error('workflows.validation.invalidAdvancedConfigJson')\n    }\n    return Object.keys(value).length > 0 ? value : undefined\n  }\n  if (!value.trim()) return undefined\n  try {\n    const parsed: unknown = JSON.parse(value)\n    if (!isPlainRecord(parsed)) {\n      throw new Error('[internal] advanced configuration must parse to a JSON object')\n    }\n    return Object.keys(parsed).length > 0 ? parsed : undefined\n  } catch (error) {\n    logger.error('Invalid JSON in Advanced Configuration', { err: error })\n    throw new Error('workflows.validation.invalidAdvancedConfigJson')\n  }\n}\n"],
+  "mappings": "AAUA,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW;AAIhC,SAAS,cAAc,OAAkD;AAC9E,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEO,SAAS,yBAAyB,OAAiE;AACxG,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,CAAC,cAAc,KAAK,GAAG;AACzB,aAAO,MAAM,gDAAgD,EAAE,UAAU,MAAM,QAAQ,KAAK,IAAI,UAAU,OAAO,MAAM,CAAC;AACxH,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AACA,WAAO,OAAO,KAAK,KAAK,EAAE,SAAS,IAAI,QAAQ;AAAA,EACjD;AACA,MAAI,CAAC,MAAM,KAAK,EAAG,QAAO;AAC1B,MAAI;AACF,UAAM,SAAkB,KAAK,MAAM,KAAK;AACxC,QAAI,CAAC,cAAc,MAAM,GAAG;AAC1B,YAAM,IAAI,MAAM,+DAA+D;AAAA,IACjF;AACA,WAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AAAA,EACnD,SAAS,OAAO;AACd,WAAO,MAAM,0CAA0C,EAAE,KAAK,MAAM,CAAC;AACrE,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACF;",
+  "names": []
+}

package/dist/modules/workflows/lib/agent-disposition-task.js

@@ -0,0 +1,198 @@
+import { StepInstance, UserTask, WorkflowInstance } from "../data/entities.js";
+import { calculateDueDate } from "./duration.js";
+import { scheduleUserTaskSla } from "./task-sla.js";
+import { emitWorkflowsEvent } from "../events.js";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+const logger = createLogger("workflows");
+function resolveDueDate(duration, now, proposalId) {
+  if (typeof duration !== "string" || !duration.length) return null;
+  try {
+    return calculateDueDate(duration, now);
+  } catch (error) {
+    logger.warn("Agent review deadline skipped because it is not a valid duration", {
+      component: "agent-disposition-task",
+      proposalId,
+      duration
+    });
+    return null;
+  }
+}
+async function createAgentDispositionTask(em, container, options) {
+  const { tenantId, organizationId } = options;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const instance = await em.findOne(WorkflowInstance, {
+    id: options.workflowInstanceId,
+    tenantId,
+    organizationId
+  });
+  if (!instance) {
+    throw new Error(
+      `[internal] workflow instance ${options.workflowInstanceId} not found for agent disposition task`
+    );
+  }
+  const stepInstance = await em.findOne(StepInstance, {
+    workflowInstanceId: options.workflowInstanceId,
+    stepId: options.stepId,
+    status: "ACTIVE",
+    tenantId,
+    organizationId
+  });
+  const review = options.review ?? null;
+  const assignedTo = review?.assignedTo?.length ? review.assignedTo : null;
+  const assignedToRoles = review?.assignedToRoles?.length ? review.assignedToRoles : null;
+  const dueDate = resolveDueDate(review?.deadlineDuration, now, options.proposalId);
+  const task = em.create(UserTask, {
+    workflowInstanceId: options.workflowInstanceId,
+    // The step instance is what the SLA scheduler, the run view and the §6.4
+    // gate address. Falling back to the workflow instance id (as the inline
+    // version did) writes a value that is not a step instance at all.
+    stepInstanceId: stepInstance?.id ?? options.workflowInstanceId,
+    branchInstanceId: stepInstance?.branchInstanceId ?? null,
+    taskName: options.taskName,
+    description: options.description,
+    status: "PENDING",
+    formSchema: {
+      proposalId: options.proposalId,
+      payload: options.proposalPayload,
+      confidence: options.confidence
+    },
+    assignedTo,
+    // Always the backoffice namespace: a proposal is disposed from the operator
+    // caseload, and no portal surface can dispose one.
+    assigneeKind: "user",
+    assignedToRoles,
+    priority: review?.priority ?? null,
+    dueDate,
+    tenantId,
+    organizationId,
+    createdAt: now,
+    updatedAt: now
+  });
+  em.persist(task);
+  await em.flush();
+  await logDispositionTaskEvent(em, container, {
+    workflowInstanceId: options.workflowInstanceId,
+    stepInstanceId: task.stepInstanceId,
+    branchInstanceId: task.branchInstanceId ?? null,
+    eventType: "USER_TASK_CREATED",
+    eventData: {
+      userTaskId: task.id,
+      taskName: task.taskName,
+      assignedTo: task.assignedTo,
+      assignedToRoles: task.assignedToRoles,
+      proposalId: options.proposalId,
+      agentId: options.agentId,
+      ...task.priority ? { priority: task.priority } : {},
+      ...dueDate ? { dueDate: dueDate.toISOString() } : {}
+    },
+    userId: options.userId,
+    tenantId,
+    organizationId
+  });
+  await emitDispositionTaskAssigned(task, instance);
+  await scheduleUserTaskSla({
+    workflowInstanceId: options.workflowInstanceId,
+    stepInstanceId: task.stepInstanceId,
+    branchInstanceId: task.branchInstanceId ?? null,
+    userTaskId: task.id,
+    dueDate,
+    reminders: review?.reminders ?? null,
+    tenantId,
+    organizationId,
+    userId: options.userId,
+    now
+  });
+  return {
+    userTaskId: task.id,
+    stepInstanceId: task.stepInstanceId,
+    assignedTo,
+    assignedToRoles,
+    dueDate
+  };
+}
+const OPEN_TASK_STATUSES = ["PENDING", "IN_PROGRESS"];
+async function closeAgentDispositionTask(em, container, options) {
+  const { tenantId, organizationId } = options;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const task = await em.findOne(UserTask, {
+    id: options.userTaskId,
+    tenantId,
+    organizationId
+  });
+  if (!task) return "noop";
+  const claimed = await em.nativeUpdate(
+    UserTask,
+    {
+      id: task.id,
+      tenantId,
+      organizationId,
+      status: { $in: [...OPEN_TASK_STATUSES] }
+    },
+    {
+      status: "COMPLETED",
+      completedAt: now,
+      completedBy: options.closedBy ?? null,
+      updatedAt: now
+    }
+  );
+  if (claimed === 0) return "noop";
+  await logDispositionTaskEvent(em, container, {
+    workflowInstanceId: task.workflowInstanceId,
+    stepInstanceId: task.stepInstanceId,
+    ...task.branchInstanceId ? { branchInstanceId: task.branchInstanceId } : {},
+    eventType: "USER_TASK_COMPLETED",
+    eventData: {
+      userTaskId: task.id,
+      taskName: task.taskName,
+      closedBy: "agent_disposition",
+      disposition: options.disposition
+    },
+    tenantId,
+    organizationId
+  });
+  return "closed";
+}
+async function emitDispositionTaskAssigned(task, instance) {
+  try {
+    await emitWorkflowsEvent(
+      "workflows.task.assigned",
+      {
+        taskId: task.id,
+        taskName: task.taskName,
+        workflowInstanceId: instance.id,
+        workflowId: instance.workflowId,
+        workflowName: instance.workflowId,
+        assignedUserId: task.assignedTo ?? null,
+        assignedToRoles: task.assignedToRoles ?? null,
+        dueDate: task.dueDate ? task.dueDate.toISOString() : null,
+        entityBindings: task.entityBindings ?? null,
+        tenantId: instance.tenantId,
+        organizationId: instance.organizationId ?? null
+      },
+      { persistent: true }
+    );
+  } catch (error) {
+    logger.error("Failed to emit workflows.task.assigned for an agent disposition task", {
+      component: "agent-disposition-task",
+      taskId: task.id,
+      err: error
+    });
+  }
+}
+async function logDispositionTaskEvent(em, container, event) {
+  try {
+    const eventLogger = container.resolve("eventLogger");
+    await eventLogger.logWorkflowEvent(em, event);
+  } catch (error) {
+    logger.error("Failed to log an agent disposition task workflow event", {
+      component: "agent-disposition-task",
+      eventType: event.eventType,
+      err: error
+    });
+  }
+}
+export {
+  closeAgentDispositionTask,
+  createAgentDispositionTask
+};
+//# sourceMappingURL=agent-disposition-task.js.map

package/dist/modules/workflows/lib/agent-disposition-task.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/agent-disposition-task.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 the implicit agent-disposition task (spec \u00A77.5).\n *\n * When an INVOKE_AGENT step's confidence gate routes to a human, the enterprise\n * `dispositionService` raises a workflows `USER_TASK` for that decision. Until\n * now it built that row itself, inline, with no assignee, no role queue, no\n * deadline, no audit event and no assignment event \u2014 which under the \u00A76.4\n * visibility model produces a task that is visible only to administrative\n * oversight and ACTABLE BY NOBODY (`currentTaskOwnerId` is null, so\n * `ownsTheRow` is false for every principal), and which never reaches the\n * notification subscriber at all.\n *\n * The disposition task is supposed to be \"a real Work Inbox task\" (\u00A77.5), so\n * the row is built HERE, by the module that owns the entity, the audit log, the\n * assignment event and the SLA scheduler \u2014 and the enterprise service passes\n * the authored Review descriptor in. `agent_orchestrator` stays an optional\n * peer in both directions: it reaches this module through a dynamic import\n * guarded by its own try/catch, exactly as `lib/disposition/resume.ts` reaches\n * `sendSignal`.\n */\n\nimport type { EntityManager } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport { StepInstance, UserTask, WorkflowInstance } from '../data/entities'\nimport { calculateDueDate } from './duration'\nimport { scheduleUserTaskSla } from './task-sla'\nimport { emitWorkflowsEvent } from '../events'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n/**\n * The already-resolved Review section: assignment interpolated against the run\n * context and the deadline still expressed as a DURATION, because a disposition\n * deadline is anchored to when the task is created \u2014 not to when the agent was\n * enqueued, which can be minutes earlier.\n */\nexport interface AgentDispositionReview {\n  assignedTo?: string | null\n  assignedToRoles?: string[] | null\n  priority?: string | null\n  deadlineDuration?: string | null\n  reminders?: { offset: string }[] | null\n}\n\nexport interface CreateAgentDispositionTaskOptions {\n  workflowInstanceId: string\n  stepId: string\n  proposalId: string\n  agentId: string\n  proposalPayload: unknown\n  confidence: number | null\n  taskName: string\n  description: string\n  review?: AgentDispositionReview | null\n  tenantId: string\n  organizationId: string\n  userId?: string\n  now?: Date\n}\n\nexport interface CreatedAgentDispositionTask {\n  userTaskId: string\n  stepInstanceId: string\n  assignedTo: string | null\n  assignedToRoles: string[] | null\n  dueDate: Date | null\n}\n\nfunction resolveDueDate(\n  duration: string | null | undefined,\n  now: Date,\n  proposalId: string,\n): Date | null {\n  if (typeof duration !== 'string' || !duration.length) return null\n  try {\n    return calculateDueDate(duration, now)\n  } catch (error) {\n    // An unparseable deadline must not cost the operator the task. A USER_TASK\n    // step fails the step here; a disposition task cannot, because the agent has\n    // already run and its proposal is already pending \u2014 losing the review task\n    // would strand the proposal with nobody able to see it.\n    logger.warn('Agent review deadline skipped because it is not a valid duration', {\n      component: 'agent-disposition-task',\n      proposalId,\n      duration,\n    })\n    return null\n  }\n}\n\n/**\n * Create the disposition task for a pending proposal.\n *\n * Returns the created task; throws only when the workflow instance the caller\n * named cannot be read, which is the caller's signal to fall back to its\n * synthetic id.\n */\nexport async function createAgentDispositionTask(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: CreateAgentDispositionTaskOptions,\n): Promise<CreatedAgentDispositionTask> {\n  const { tenantId, organizationId } = options\n  const now = options.now ?? new Date()\n\n  const instance = await em.findOne(WorkflowInstance, {\n    id: options.workflowInstanceId,\n    tenantId,\n    organizationId,\n  })\n  if (!instance) {\n    throw new Error(\n      `[internal] workflow instance ${options.workflowInstanceId} not found for agent disposition task`,\n    )\n  }\n\n  const stepInstance = await em.findOne(StepInstance, {\n    workflowInstanceId: options.workflowInstanceId,\n    stepId: options.stepId,\n    status: 'ACTIVE',\n    tenantId,\n    organizationId,\n  })\n\n  const review = options.review ?? null\n  const assignedTo = review?.assignedTo?.length ? review.assignedTo : null\n  const assignedToRoles = review?.assignedToRoles?.length ? review.assignedToRoles : null\n  const dueDate = resolveDueDate(review?.deadlineDuration, now, options.proposalId)\n\n  const task = em.create(UserTask, {\n    workflowInstanceId: options.workflowInstanceId,\n    // The step instance is what the SLA scheduler, the run view and the \u00A76.4\n    // gate address. Falling back to the workflow instance id (as the inline\n    // version did) writes a value that is not a step instance at all.\n    stepInstanceId: stepInstance?.id ?? options.workflowInstanceId,\n    branchInstanceId: stepInstance?.branchInstanceId ?? null,\n    taskName: options.taskName,\n    description: options.description,\n    status: 'PENDING',\n    formSchema: {\n      proposalId: options.proposalId,\n      payload: options.proposalPayload,\n      confidence: options.confidence,\n    },\n    assignedTo,\n    // Always the backoffice namespace: a proposal is disposed from the operator\n    // caseload, and no portal surface can dispose one.\n    assigneeKind: 'user',\n    assignedToRoles,\n    priority: review?.priority ?? null,\n    dueDate,\n    tenantId,\n    organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  em.persist(task)\n  await em.flush()\n\n  await logDispositionTaskEvent(em, container, {\n    workflowInstanceId: options.workflowInstanceId,\n    stepInstanceId: task.stepInstanceId,\n    branchInstanceId: task.branchInstanceId ?? null,\n    eventType: 'USER_TASK_CREATED',\n    eventData: {\n      userTaskId: task.id,\n      taskName: task.taskName,\n      assignedTo: task.assignedTo,\n      assignedToRoles: task.assignedToRoles,\n      proposalId: options.proposalId,\n      agentId: options.agentId,\n      ...(task.priority ? { priority: task.priority } : {}),\n      ...(dueDate ? { dueDate: dueDate.toISOString() } : {}),\n    },\n    userId: options.userId,\n    tenantId,\n    organizationId,\n  })\n\n  await emitDispositionTaskAssigned(task, instance)\n\n  // Reminders and the deadline breach ride the SAME queue-backed scheduler a\n  // USER_TASK's do \u2014 one job per authored offset plus one for the deadline, all\n  // enqueued here with the deadline ABSOLUTE on the payload. A task with no\n  // deadline schedules nothing. What the breach then DOES is escalate-only\n  // (`lib/task-sla.ts` \u2192 `applyBreachHandling`): it never disposes the proposal\n  // and never routes the run past it.\n  await scheduleUserTaskSla({\n    workflowInstanceId: options.workflowInstanceId,\n    stepInstanceId: task.stepInstanceId,\n    branchInstanceId: task.branchInstanceId ?? null,\n    userTaskId: task.id,\n    dueDate,\n    reminders: review?.reminders ?? null,\n    tenantId,\n    organizationId,\n    userId: options.userId,\n    now,\n  })\n\n  return {\n    userTaskId: task.id,\n    stepInstanceId: task.stepInstanceId,\n    assignedTo,\n    assignedToRoles,\n    dueDate,\n  }\n}\n\nexport interface CloseAgentDispositionTaskOptions {\n  userTaskId: string\n  /** The verdict that closed it \u2014 audit only; it never decides anything here. */\n  disposition: string\n  closedBy?: string | null\n  tenantId: string\n  organizationId: string\n  now?: Date\n}\n\n/** Statuses a disposition task is still open in \u2014 anything else is already closed. */\nconst OPEN_TASK_STATUSES = ['PENDING', 'IN_PROGRESS'] as const\n\n/**\n * Close the review task a disposed proposal no longer needs (A7).\n *\n * The decision has already been made and committed by the caller; this only\n * clears the work item so the operator's inbox stops offering a decision that\n * has already been taken. It deliberately does NOT complete the task through\n * `completeUserTask`: that would ADVANCE the run, and the run resumes on\n * `agent_orchestrator.proposal.ready` instead. Closing a task and advancing a\n * workflow are different acts, and only the second one belongs to the engine.\n *\n * Idempotent by construction: the status change is claimed with a conditional\n * UPDATE, so a redelivered close (or a task a human already completed) updates\n * zero rows and returns `noop`.\n */\nexport async function closeAgentDispositionTask(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: CloseAgentDispositionTaskOptions,\n): Promise<'closed' | 'noop'> {\n  const { tenantId, organizationId } = options\n  const now = options.now ?? new Date()\n\n  const task = await em.findOne(UserTask, {\n    id: options.userTaskId,\n    tenantId,\n    organizationId,\n  })\n  if (!task) return 'noop'\n\n  const claimed = await em.nativeUpdate(\n    UserTask,\n    {\n      id: task.id,\n      tenantId,\n      organizationId,\n      status: { $in: [...OPEN_TASK_STATUSES] },\n    },\n    {\n      status: 'COMPLETED',\n      completedAt: now,\n      completedBy: options.closedBy ?? null,\n      updatedAt: now,\n    },\n  )\n  if (claimed === 0) return 'noop'\n\n  await logDispositionTaskEvent(em, container, {\n    workflowInstanceId: task.workflowInstanceId,\n    stepInstanceId: task.stepInstanceId,\n    ...(task.branchInstanceId ? { branchInstanceId: task.branchInstanceId } : {}),\n    eventType: 'USER_TASK_COMPLETED',\n    eventData: {\n      userTaskId: task.id,\n      taskName: task.taskName,\n      closedBy: 'agent_disposition',\n      disposition: options.disposition,\n    },\n    tenantId,\n    organizationId,\n  })\n\n  return 'closed'\n}\n\n/**\n * Publish `workflows.task.assigned` for a disposition task, so it reaches the\n * notification subscriber the same way every other task does. Best-effort by\n * contract: the proposal is already pending and the task row already committed,\n * so a bus failure must never turn into a failed disposition.\n */\nasync function emitDispositionTaskAssigned(\n  task: UserTask,\n  instance: WorkflowInstance,\n): Promise<void> {\n  try {\n    await emitWorkflowsEvent(\n      'workflows.task.assigned',\n      {\n        taskId: task.id,\n        taskName: task.taskName,\n        workflowInstanceId: instance.id,\n        workflowId: instance.workflowId,\n        workflowName: instance.workflowId,\n        assignedUserId: task.assignedTo ?? null,\n        assignedToRoles: task.assignedToRoles ?? null,\n        dueDate: task.dueDate ? task.dueDate.toISOString() : null,\n        entityBindings: task.entityBindings ?? null,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId ?? null,\n      },\n      { persistent: true },\n    )\n  } catch (error) {\n    logger.error('Failed to emit workflows.task.assigned for an agent disposition task', {\n      component: 'agent-disposition-task',\n      taskId: task.id,\n      err: error,\n    })\n  }\n}\n\nasync function logDispositionTaskEvent(\n  em: EntityManager,\n  container: AwilixContainer,\n  event: Record<string, unknown>,\n): Promise<void> {\n  try {\n    const eventLogger = container.resolve<{\n      logWorkflowEvent: (em: EntityManager, event: Record<string, unknown>) => Promise<unknown>\n    }>('eventLogger')\n    await eventLogger.logWorkflowEvent(em, event)\n  } catch (error) {\n    logger.error('Failed to log an agent disposition task workflow event', {\n      component: 'agent-disposition-task',\n      eventType: event.eventType,\n      err: error,\n    })\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/agent-outcome-paths.js

@@ -0,0 +1,82 @@
+const MAX_OUTCOME_DEPTH = 3;
+const ENVELOPE_PATHS = [
+  { path: "kind", type: "text", container: false },
+  { path: "disposition", type: "text", container: false },
+  { path: "agentId", type: "text", container: false },
+  { path: "proposalId", type: "text", container: false }
+];
+const JSON_TYPE_LABELS = {
+  string: "text",
+  number: "number",
+  integer: "number",
+  boolean: "boolean",
+  object: "object",
+  array: "array"
+};
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function labelFor(node) {
+  const type = node?.type;
+  return typeof type === "string" ? JSON_TYPE_LABELS[type] ?? "unknown" : "unknown";
+}
+function agentOutcomeRootKey(resultKind) {
+  return resultKind === "research" ? "data" : "proposalPayload";
+}
+function describesProperties(node) {
+  const properties = node.properties;
+  return isPlainObject(properties) && Object.keys(properties).length > 0;
+}
+function collectOutcomePaths(node, prefix, depth, collected) {
+  const properties = node.properties;
+  if (!isPlainObject(properties)) return;
+  for (const [name, child] of Object.entries(properties)) {
+    if (!name || !isPlainObject(child)) continue;
+    const childNode = child;
+    const path = `${prefix}.${name}`;
+    const expandable = childNode.type === "object" && describesProperties(childNode) && depth < MAX_OUTCOME_DEPTH;
+    collected.push({ path, type: labelFor(childNode), container: !expandable && childNode.type === "object" });
+    if (expandable) collectOutcomePaths(childNode, path, depth + 1, collected);
+  }
+}
+function buildAgentSourcePaths(resultKind, outcomeSchema) {
+  if (!resultKind || !isPlainObject(outcomeSchema)) return [];
+  const rootKey = agentOutcomeRootKey(resultKind);
+  const root = outcomeSchema;
+  const paths = [
+    ...ENVELOPE_PATHS,
+    { path: rootKey, type: "object", container: !describesProperties(root) }
+  ];
+  collectOutcomePaths(root, rootKey, 1, paths);
+  return paths;
+}
+function isTemplateExpression(value) {
+  return /\{\{.*\}\}/.test(value);
+}
+function isKnownAgentSourcePath(paths, value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return true;
+  if (paths.length === 0) return true;
+  return paths.some(
+    (candidate) => candidate.path === trimmed || candidate.container && trimmed.startsWith(`${candidate.path}.`)
+  );
+}
+function agentSampleInputKeys(sampleInput) {
+  return isPlainObject(sampleInput) ? Object.keys(sampleInput) : [];
+}
+function agentSampleInputRows(sampleInput) {
+  if (!isPlainObject(sampleInput)) return [];
+  return Object.entries(sampleInput).map(([key, value]) => ({
+    key,
+    value: typeof value === "string" ? value : JSON.stringify(value) ?? ""
+  }));
+}
+export {
+  agentOutcomeRootKey,
+  agentSampleInputKeys,
+  agentSampleInputRows,
+  buildAgentSourcePaths,
+  isKnownAgentSourcePath,
+  isTemplateExpression
+};
+//# sourceMappingURL=agent-outcome-paths.js.map

package/dist/modules/workflows/lib/agent-outcome-paths.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/agent-outcome-paths.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - INVOKE_AGENT source-path vocabulary (spec\n * 2026-07-26-workflows-ux-redesign.md sections 3.4 / 7.1).\n *\n * Pure translation of an agent's declared OUTCOME JSON-Schema (served by the\n * optional agent_orchestrator peer on `/api/agent_orchestrator/agents`) into\n * the dot paths an `outputMapping` row may read from. The vocabulary is the\n * normalized result envelope `mapAgentResultToContext` builds: the platform's\n * own `kind`/`disposition`/`agentId`/`proposalId` keys, plus the agent's OUTCOME\n * under `data` (researcher agents) or `proposalPayload` (proposal ones).\n *\n * No React, no network, no registry \u2014 the editor feeds it the fetched schema and\n * gets back plain data, so the same helper backs the source picker, the\n * author-time path check, and the \"Insert sample\" rows.\n */\n\nexport type AgentResultKind = 'research' | 'proposal'\n\nexport interface AgentOutcomeSchemaNode {\n  type?: string\n  properties?: Record<string, AgentOutcomeSchemaNode>\n  items?: AgentOutcomeSchemaNode\n}\n\nexport interface AgentSourcePath {\n  path: string\n  type: string\n  /**\n   * True only for an object whose properties this vocabulary does NOT describe\n   * (declared without `properties`, or nested past the depth cap). Deeper paths\n   * below such a node stay valid; a fully described object is closed, so an\n   * undeclared property under it is an author error.\n   */\n  container: boolean\n}\n\nexport interface AgentInputRow {\n  key: string\n  value: string\n}\n\nconst MAX_OUTCOME_DEPTH = 3\n\nconst ENVELOPE_PATHS: ReadonlyArray<AgentSourcePath> = [\n  { path: 'kind', type: 'text', container: false },\n  { path: 'disposition', type: 'text', container: false },\n  { path: 'agentId', type: 'text', container: false },\n  { path: 'proposalId', type: 'text', container: false },\n]\n\nconst JSON_TYPE_LABELS: Record<string, string> = {\n  string: 'text',\n  number: 'number',\n  integer: 'number',\n  boolean: 'boolean',\n  object: 'object',\n  array: 'array',\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction labelFor(node: AgentOutcomeSchemaNode | undefined): string {\n  const type = node?.type\n  return typeof type === 'string' ? JSON_TYPE_LABELS[type] ?? 'unknown' : 'unknown'\n}\n\nexport function agentOutcomeRootKey(resultKind: AgentResultKind): 'data' | 'proposalPayload' {\n  return resultKind === 'research' ? 'data' : 'proposalPayload'\n}\n\nfunction describesProperties(node: AgentOutcomeSchemaNode): boolean {\n  const properties = node.properties\n  return isPlainObject(properties) && Object.keys(properties).length > 0\n}\n\nfunction collectOutcomePaths(\n  node: AgentOutcomeSchemaNode,\n  prefix: string,\n  depth: number,\n  collected: AgentSourcePath[],\n): void {\n  const properties = node.properties\n  if (!isPlainObject(properties)) return\n  for (const [name, child] of Object.entries(properties)) {\n    if (!name || !isPlainObject(child)) continue\n    const childNode = child as AgentOutcomeSchemaNode\n    const path = `${prefix}.${name}`\n    const expandable =\n      childNode.type === 'object' && describesProperties(childNode) && depth < MAX_OUTCOME_DEPTH\n    collected.push({ path, type: labelFor(childNode), container: !expandable && childNode.type === 'object' })\n    if (expandable) collectOutcomePaths(childNode, path, depth + 1, collected)\n  }\n}\n\n/**\n * Every source path an outputMapping row may reference for the selected agent.\n * Returns an empty list when the agent declares no usable OUTCOME shape \u2014 the\n * caller then keeps free text and skips the author-time check rather than\n * flagging paths it cannot verify.\n */\nexport function buildAgentSourcePaths(\n  resultKind: AgentResultKind | undefined,\n  outcomeSchema: unknown,\n): AgentSourcePath[] {\n  if (!resultKind || !isPlainObject(outcomeSchema)) return []\n  const rootKey = agentOutcomeRootKey(resultKind)\n  const root = outcomeSchema as AgentOutcomeSchemaNode\n  const paths: AgentSourcePath[] = [\n    ...ENVELOPE_PATHS,\n    { path: rootKey, type: 'object', container: !describesProperties(root) },\n  ]\n  collectOutcomePaths(root, rootKey, 1, paths)\n  return paths\n}\n\nexport function isTemplateExpression(value: string): boolean {\n  return /\\{\\{.*\\}\\}/.test(value)\n}\n\n/**\n * A source path resolves when it names a declared path or descends into an\n * object this vocabulary does not describe. A blank path (a row still being\n * written) and an agent with no declared OUTCOME both resolve \u2014 the check only\n * fires where the schema can actually prove the path wrong.\n */\nexport function isKnownAgentSourcePath(paths: ReadonlyArray<AgentSourcePath>, value: string): boolean {\n  const trimmed = value.trim()\n  if (trimmed.length === 0) return true\n  if (paths.length === 0) return true\n  return paths.some(\n    (candidate) =>\n      candidate.path === trimmed || (candidate.container && trimmed.startsWith(`${candidate.path}.`)),\n  )\n}\n\nexport function agentSampleInputKeys(sampleInput: unknown): string[] {\n  return isPlainObject(sampleInput) ? Object.keys(sampleInput) : []\n}\n\n/**\n * The `input` rows an agent's SAMPLE input fills in. String values are inserted\n * verbatim (they may already be `{{context.*}}` pills); anything else is\n * serialized so the author sees the exact literal the step will send.\n */\nexport function agentSampleInputRows(sampleInput: unknown): AgentInputRow[] {\n  if (!isPlainObject(sampleInput)) return []\n  return Object.entries(sampleInput).map(([key, value]) => ({\n    key,\n    value: typeof value === 'string' ? value : JSON.stringify(value) ?? '',\n  }))\n}\n"],
+  "mappings": "AAyCA,MAAM,oBAAoB;AAE1B,MAAM,iBAAiD;AAAA,EACrD,EAAE,MAAM,QAAQ,MAAM,QAAQ,WAAW,MAAM;AAAA,EAC/C,EAAE,MAAM,eAAe,MAAM,QAAQ,WAAW,MAAM;AAAA,EACtD,EAAE,MAAM,WAAW,MAAM,QAAQ,WAAW,MAAM;AAAA,EAClD,EAAE,MAAM,cAAc,MAAM,QAAQ,WAAW,MAAM;AACvD;AAEA,MAAM,mBAA2C;AAAA,EAC/C,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AACT;AAEA,SAAS,cAAc,OAAkD;AACvE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,SAAS,MAAkD;AAClE,QAAM,OAAO,MAAM;AACnB,SAAO,OAAO,SAAS,WAAW,iBAAiB,IAAI,KAAK,YAAY;AAC1E;AAEO,SAAS,oBAAoB,YAAyD;AAC3F,SAAO,eAAe,aAAa,SAAS;AAC9C;AAEA,SAAS,oBAAoB,MAAuC;AAClE,QAAM,aAAa,KAAK;AACxB,SAAO,cAAc,UAAU,KAAK,OAAO,KAAK,UAAU,EAAE,SAAS;AACvE;AAEA,SAAS,oBACP,MACA,QACA,OACA,WACM;AACN,QAAM,aAAa,KAAK;AACxB,MAAI,CAAC,cAAc,UAAU,EAAG;AAChC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACtD,QAAI,CAAC,QAAQ,CAAC,cAAc,KAAK,EAAG;AACpC,UAAM,YAAY;AAClB,UAAM,OAAO,GAAG,MAAM,IAAI,IAAI;AAC9B,UAAM,aACJ,UAAU,SAAS,YAAY,oBAAoB,SAAS,KAAK,QAAQ;AAC3E,cAAU,KAAK,EAAE,MAAM,MAAM,SAAS,SAAS,GAAG,WAAW,CAAC,cAAc,UAAU,SAAS,SAAS,CAAC;AACzG,QAAI,WAAY,qBAAoB,WAAW,MAAM,QAAQ,GAAG,SAAS;AAAA,EAC3E;AACF;AAQO,SAAS,sBACd,YACA,eACmB;AACnB,MAAI,CAAC,cAAc,CAAC,cAAc,aAAa,EAAG,QAAO,CAAC;AAC1D,QAAM,UAAU,oBAAoB,UAAU;AAC9C,QAAM,OAAO;AACb,QAAM,QAA2B;AAAA,IAC/B,GAAG;AAAA,IACH,EAAE,MAAM,SAAS,MAAM,UAAU,WAAW,CAAC,oBAAoB,IAAI,EAAE;AAAA,EACzE;AACA,sBAAoB,MAAM,SAAS,GAAG,KAAK;AAC3C,SAAO;AACT;AAEO,SAAS,qBAAqB,OAAwB;AAC3D,SAAO,aAAa,KAAK,KAAK;AAChC;AAQO,SAAS,uBAAuB,OAAuC,OAAwB;AACpG,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,SAAO,MAAM;AAAA,IACX,CAAC,cACC,UAAU,SAAS,WAAY,UAAU,aAAa,QAAQ,WAAW,GAAG,UAAU,IAAI,GAAG;AAAA,EACjG;AACF;AAEO,SAAS,qBAAqB,aAAgC;AACnE,SAAO,cAAc,WAAW,IAAI,OAAO,KAAK,WAAW,IAAI,CAAC;AAClE;AAOO,SAAS,qBAAqB,aAAuC;AAC1E,MAAI,CAAC,cAAc,WAAW,EAAG,QAAO,CAAC;AACzC,SAAO,OAAO,QAAQ,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;AAAA,IACxD;AAAA,IACA,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK,KAAK;AAAA,EACtE,EAAE;AACJ;",
+  "names": []
+}

package/dist/modules/workflows/lib/agent-result-mapping.js

@@ -0,0 +1,54 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
+const logger = createLogger("workflows").child({ component: "agent-result-mapping" });
+function getNestedValue(obj, path) {
+  return path.split(".").reduce((current, key) => current?.[key], obj);
+}
+function setNestedValue(obj, path, value) {
+  const keys = path.split(".");
+  const lastKey = keys.pop();
+  const target = keys.reduce((current, key) => {
+    if (!(key in current)) current[key] = {};
+    return current[key];
+  }, obj);
+  target[lastKey] = value;
+}
+function warnOnTemplateMapping(sourcePath) {
+  if (/\{\{.*\}\}/.test(sourcePath)) {
+    logger.warn(
+      'INVOKE_AGENT outputMapping value looks like a {{ }} template, but mapping values are plain dot-paths into the agent result envelope (e.g. "proposalPayload.riskScore"). This entry will not resolve and is being ignored.',
+      { sourcePath }
+    );
+  }
+}
+function mapAgentResultToContext(envelope, outputMapping) {
+  if (!outputMapping || Object.keys(outputMapping).length === 0) return null;
+  const source = {
+    kind: envelope.kind,
+    // `artifact` reports as `researcher` here for the same reason it routes onto
+    // that handle: the disposition vocabulary describes DECISIONS, and producing
+    // a file is not one. The `kind` above still says what actually came back.
+    //
+    // Note the two spellings are deliberate: `research` is the agent RESULT kind
+    // (unification spec §7), `researcher` the core-owned outcome handle it routes
+    // to. Renaming the handle would rewrite persisted workflow graphs.
+    disposition: envelope.kind === "research" || envelope.kind === "artifact" ? "researcher" : envelope.kind,
+    agentId: envelope.agentId,
+    proposalId: envelope.proposalId,
+    proposalPayload: envelope.proposalPayload,
+    data: envelope.data,
+    artifacts: envelope.artifacts
+  };
+  const result = {};
+  for (const [targetKey, sourcePath] of Object.entries(outputMapping)) {
+    warnOnTemplateMapping(sourcePath);
+    const value = getNestedValue(source, sourcePath);
+    if (value !== void 0) {
+      setNestedValue(result, targetKey, value);
+    }
+  }
+  return result;
+}
+export {
+  mapAgentResultToContext
+};
+//# sourceMappingURL=agent-result-mapping.js.map

package/dist/modules/workflows/lib/agent-result-mapping.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/agent-result-mapping.ts"],
+  "sourcesContent": ["/**\n * Maps an INVOKE_AGENT result into a workflow-context patch.\n *\n * An INVOKE_AGENT activity may declare an optional `outputMapping` (mirroring\n * SUB_WORKFLOW). When present, the agent's result is routed into the chosen\n * context keys instead of the legacy fixed keys. The mapping reads from a\n * normalized envelope so authors address a stable contract regardless of the\n * runtime (in-process vs OpenCode) or the resolution path (inline branch vs\n * parked-and-resumed worker).\n *\n * Returns the mapped patch when a non-empty mapping is provided, otherwise\n * `null` to signal the caller should fall back to its legacy fixed-key payload \u2014\n * keeping existing definitions byte-for-byte backward compatible.\n */\n\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows').child({ component: 'agent-result-mapping' })\n\nexport type AgentResultEnvelope = {\n  kind: 'auto_approved' | 'research' | 'user_task' | 'none_proposed' | 'artifact'\n  agentId?: string\n  proposalId?: string\n  proposalPayload?: unknown\n  data?: unknown\n  /** Set for an `artifact` result: the files the run produced, by reference. */\n  artifacts?: unknown[]\n}\n\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj)\n}\n\nfunction setNestedValue(obj: Record<string, any>, path: string, value: any): void {\n  const keys = path.split('.')\n  const lastKey = keys.pop()!\n  const target = keys.reduce<Record<string, any>>((current, key) => {\n    if (!(key in current)) current[key] = {}\n    return current[key]\n  }, obj)\n  target[lastKey] = value\n}\n\nfunction warnOnTemplateMapping(sourcePath: string): void {\n  if (/\\{\\{.*\\}\\}/.test(sourcePath)) {\n    logger.warn(\n      'INVOKE_AGENT outputMapping value looks like a {{ }} template, but mapping values are plain ' +\n        'dot-paths into the agent result envelope (e.g. \"proposalPayload.riskScore\"). This entry ' +\n        'will not resolve and is being ignored.',\n      { sourcePath }\n    )\n  }\n}\n\nexport function mapAgentResultToContext(\n  envelope: AgentResultEnvelope,\n  outputMapping: Record<string, string> | undefined | null\n): Record<string, any> | null {\n  if (!outputMapping || Object.keys(outputMapping).length === 0) return null\n\n  const source = {\n    kind: envelope.kind,\n    // `artifact` reports as `researcher` here for the same reason it routes onto\n    // that handle: the disposition vocabulary describes DECISIONS, and producing\n    // a file is not one. The `kind` above still says what actually came back.\n    //\n    // Note the two spellings are deliberate: `research` is the agent RESULT kind\n    // (unification spec \u00A77), `researcher` the core-owned outcome handle it routes\n    // to. Renaming the handle would rewrite persisted workflow graphs.\n    disposition:\n      envelope.kind === 'research' || envelope.kind === 'artifact' ? 'researcher' : envelope.kind,\n    agentId: envelope.agentId,\n    proposalId: envelope.proposalId,\n    proposalPayload: envelope.proposalPayload,\n    data: envelope.data,\n    artifacts: envelope.artifacts,\n  }\n\n  const result: Record<string, any> = {}\n  for (const [targetKey, sourcePath] of Object.entries(outputMapping)) {\n    warnOnTemplateMapping(sourcePath)\n    const value = getNestedValue(source, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n  return result\n}\n"],
+  "mappings": "AAeA,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW,EAAE,MAAM,EAAE,WAAW,uBAAuB,CAAC;AAYpF,SAAS,eAAe,KAAU,MAAmB;AACnD,SAAO,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,SAAS,QAAQ,UAAU,GAAG,GAAG,GAAG;AACrE;AAEA,SAAS,eAAe,KAA0B,MAAc,OAAkB;AAChF,QAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,QAAM,UAAU,KAAK,IAAI;AACzB,QAAM,SAAS,KAAK,OAA4B,CAAC,SAAS,QAAQ;AAChE,QAAI,EAAE,OAAO,SAAU,SAAQ,GAAG,IAAI,CAAC;AACvC,WAAO,QAAQ,GAAG;AAAA,EACpB,GAAG,GAAG;AACN,SAAO,OAAO,IAAI;AACpB;AAEA,SAAS,sBAAsB,YAA0B;AACvD,MAAI,aAAa,KAAK,UAAU,GAAG;AACjC,WAAO;AAAA,MACL;AAAA,MAGA,EAAE,WAAW;AAAA,IACf;AAAA,EACF;AACF;AAEO,SAAS,wBACd,UACA,eAC4B;AAC5B,MAAI,CAAC,iBAAiB,OAAO,KAAK,aAAa,EAAE,WAAW,EAAG,QAAO;AAEtE,QAAM,SAAS;AAAA,IACb,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQf,aACE,SAAS,SAAS,cAAc,SAAS,SAAS,aAAa,eAAe,SAAS;AAAA,IACzF,SAAS,SAAS;AAAA,IAClB,YAAY,SAAS;AAAA,IACrB,iBAAiB,SAAS;AAAA,IAC1B,MAAM,SAAS;AAAA,IACf,WAAW,SAAS;AAAA,EACtB;AAEA,QAAM,SAA8B,CAAC;AACrC,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,aAAa,GAAG;AACnE,0BAAsB,UAAU;AAChC,UAAM,QAAQ,eAAe,QAAQ,UAAU;AAC/C,QAAI,UAAU,QAAW;AACvB,qBAAe,QAAQ,WAAW,KAAK;AAAA,IACzC;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/workflows/lib/agent-review-inspector.js

@@ -0,0 +1,61 @@
+const AGENT_REVIEW_ON_BREACH_ACTIONS = [
+  "notify",
+  "reassign",
+  "attention"
+];
+const AGENT_REVIEW_ASSIGNMENT_MODES = [
+  "role",
+  "user",
+  "dynamic"
+];
+function isAgentReviewPriority(value) {
+  return value === "low" || value === "medium" || value === "high" || value === "extreme";
+}
+function deriveAgentReviewAssignmentMode(assignedTo) {
+  if (!assignedTo.length) return "role";
+  return assignedTo.includes("{{") ? "dynamic" : "user";
+}
+function agentReviewToFormValues(review) {
+  const assignedTo = typeof review?.assignedTo === "string" ? review.assignedTo : "";
+  return {
+    reviewAssignmentMode: deriveAgentReviewAssignmentMode(assignedTo),
+    reviewAssignedTo: assignedTo,
+    reviewAssignedToRoles: Array.isArray(review?.assignedToRoles) ? [...review.assignedToRoles] : [],
+    reviewAssignmentRule: "",
+    reviewPriority: isAgentReviewPriority(review?.priority) ? review.priority : "",
+    reviewDeadline: typeof review?.deadline?.duration === "string" ? review.deadline.duration : "",
+    reviewReminders: (review?.reminders ?? []).map((reminder) => typeof reminder?.offset === "string" ? reminder.offset : "").filter((offset) => offset.length > 0),
+    reviewOnBreach: {
+      action: review?.onBreach?.action ?? "",
+      reassignTo: review?.onBreach?.reassignTo ?? ""
+    }
+  };
+}
+function formValuesToAgentReview(values) {
+  const mode = values?.reviewAssignmentMode;
+  const assignedTo = mode === "role" ? "" : (values?.reviewAssignedTo ?? "").trim();
+  const assignedToRoles = (values?.reviewAssignedToRoles ?? []).map((role) => typeof role === "string" ? role.trim() : "").filter((role) => role.length > 0);
+  const deadline = (values?.reviewDeadline ?? "").trim();
+  const reminders = (values?.reviewReminders ?? []).map((offset) => typeof offset === "string" ? offset.trim() : "").filter((offset) => offset.length > 0).map((offset) => ({ offset }));
+  const breachAction = values?.reviewOnBreach?.action;
+  const reassignTo = (values?.reviewOnBreach?.reassignTo ?? "").trim();
+  const review = {
+    ...assignedTo ? { assignedTo } : {},
+    ...assignedToRoles.length ? { assignedToRoles } : {},
+    ...isAgentReviewPriority(values?.reviewPriority) ? { priority: values.reviewPriority } : {},
+    ...deadline ? { deadline: { duration: deadline } } : {},
+    ...reminders.length ? { reminders } : {},
+    ...breachAction ? {
+      onBreach: breachAction === "reassign" && reassignTo ? { action: breachAction, reassignTo } : { action: breachAction }
+    } : {}
+  };
+  return Object.keys(review).length ? review : void 0;
+}
+export {
+  AGENT_REVIEW_ASSIGNMENT_MODES,
+  AGENT_REVIEW_ON_BREACH_ACTIONS,
+  agentReviewToFormValues,
+  deriveAgentReviewAssignmentMode,
+  formValuesToAgentReview
+};
+//# sourceMappingURL=agent-review-inspector.js.map

package/dist/modules/workflows/lib/agent-review-inspector.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/agent-review-inspector.ts"],
+  "sourcesContent": ["/**\n * Editor-side drafts for the Invoke Agent node's Review section (spec \u00A77.5).\n *\n * The sibling of `lib/task-inspector-config.ts`, and deliberately shaped like\n * it: the Review section authors the same Who/When vocabulary a task does, so\n * the drafts are the same drafts and the inspector reuses the same field\n * components. What differs is the breach action set \u2014 a disposition deadline\n * escalates and never decides, so `route` is absent and `attention` is present.\n *\n * PURE: no React, ORM, DI or registry imports.\n */\n\nimport type { AgentReviewConfig, AgentReviewOnBreach } from '../data/activity-config-schemas'\nimport type { TaskAssignmentMode } from './task-inspector-config'\n\nexport const AGENT_REVIEW_ON_BREACH_ACTIONS: readonly AgentReviewOnBreach['action'][] = [\n  'notify',\n  'reassign',\n  'attention',\n] as const\n\n/**\n * A proposal is disposed from the backoffice caseload, so the Rule tab has no\n * engine behind it here \u2014 `resolveAgentReview` reads exactly the three tabs\n * below. Offering a fourth would be authoring config nothing honours.\n */\nexport const AGENT_REVIEW_ASSIGNMENT_MODES: readonly TaskAssignmentMode[] = [\n  'role',\n  'user',\n  'dynamic',\n] as const\n\nexport interface AgentReviewOnBreachDraft {\n  action: '' | AgentReviewOnBreach['action']\n  reassignTo: string\n}\n\nexport interface AgentReviewFormValues {\n  reviewAssignmentMode: TaskAssignmentMode\n  reviewAssignedTo: string\n  reviewAssignedToRoles: string[]\n  reviewAssignmentRule: string\n  reviewPriority: string\n  reviewDeadline: string\n  reviewReminders: string[]\n  reviewOnBreach: AgentReviewOnBreachDraft\n}\n\nfunction isAgentReviewPriority(value: unknown): value is NonNullable<AgentReviewConfig['priority']> {\n  return value === 'low' || value === 'medium' || value === 'high' || value === 'extreme'\n}\n\n/**\n * Which tab a stored Review belongs to. Derived exactly as the task inspector\n * derives its own: an individual assignee that carries a `{{\u2026}}` pill is a\n * Dynamic assignment, a literal one is a User assignment, and everything else\n * is the role queue.\n */\nexport function deriveAgentReviewAssignmentMode(assignedTo: string): TaskAssignmentMode {\n  if (!assignedTo.length) return 'role'\n  return assignedTo.includes('{{') ? 'dynamic' : 'user'\n}\n\nexport function agentReviewToFormValues(\n  review: AgentReviewConfig | null | undefined,\n): AgentReviewFormValues {\n  const assignedTo = typeof review?.assignedTo === 'string' ? review.assignedTo : ''\n  return {\n    reviewAssignmentMode: deriveAgentReviewAssignmentMode(assignedTo),\n    reviewAssignedTo: assignedTo,\n    reviewAssignedToRoles: Array.isArray(review?.assignedToRoles) ? [...review.assignedToRoles] : [],\n    reviewAssignmentRule: '',\n    reviewPriority: isAgentReviewPriority(review?.priority) ? review.priority : '',\n    reviewDeadline: typeof review?.deadline?.duration === 'string' ? review.deadline.duration : '',\n    reviewReminders: (review?.reminders ?? [])\n      .map((reminder) => (typeof reminder?.offset === 'string' ? reminder.offset : ''))\n      .filter((offset) => offset.length > 0),\n    reviewOnBreach: {\n      action: review?.onBreach?.action ?? '',\n      reassignTo: review?.onBreach?.reassignTo ?? '',\n    },\n  }\n}\n\n/**\n * Persist only what the author actually configured.\n *\n * Returns `undefined` for an untouched section so a step that never opened it\n * serializes byte-identically to one authored before the section existed \u2014\n * the same \"absent stays absent\" rule the task inspector holds to.\n */\nexport function formValuesToAgentReview(\n  values: Partial<AgentReviewFormValues> | undefined,\n): AgentReviewConfig | undefined {\n  const mode = values?.reviewAssignmentMode\n  const assignedTo = mode === 'role' ? '' : (values?.reviewAssignedTo ?? '').trim()\n  const assignedToRoles = (values?.reviewAssignedToRoles ?? [])\n    .map((role) => (typeof role === 'string' ? role.trim() : ''))\n    .filter((role) => role.length > 0)\n  const deadline = (values?.reviewDeadline ?? '').trim()\n  const reminders = (values?.reviewReminders ?? [])\n    .map((offset) => (typeof offset === 'string' ? offset.trim() : ''))\n    .filter((offset) => offset.length > 0)\n    .map((offset) => ({ offset }))\n  const breachAction = values?.reviewOnBreach?.action\n  const reassignTo = (values?.reviewOnBreach?.reassignTo ?? '').trim()\n\n  const review: AgentReviewConfig = {\n    ...(assignedTo ? { assignedTo } : {}),\n    ...(assignedToRoles.length ? { assignedToRoles } : {}),\n    ...(isAgentReviewPriority(values?.reviewPriority) ? { priority: values.reviewPriority } : {}),\n    ...(deadline ? { deadline: { duration: deadline } } : {}),\n    ...(reminders.length ? { reminders } : {}),\n    ...(breachAction\n      ? {\n          onBreach:\n            breachAction === 'reassign' && reassignTo\n              ? { action: breachAction, reassignTo }\n              : { action: breachAction },\n        }\n      : {}),\n  }\n\n  return Object.keys(review).length ? review : undefined\n}\n"],
+  "mappings": "AAeO,MAAM,iCAA2E;AAAA,EACtF;AAAA,EACA;AAAA,EACA;AACF;AAOO,MAAM,gCAA+D;AAAA,EAC1E;AAAA,EACA;AAAA,EACA;AACF;AAkBA,SAAS,sBAAsB,OAAqE;AAClG,SAAO,UAAU,SAAS,UAAU,YAAY,UAAU,UAAU,UAAU;AAChF;AAQO,SAAS,gCAAgC,YAAwC;AACtF,MAAI,CAAC,WAAW,OAAQ,QAAO;AAC/B,SAAO,WAAW,SAAS,IAAI,IAAI,YAAY;AACjD;AAEO,SAAS,wBACd,QACuB;AACvB,QAAM,aAAa,OAAO,QAAQ,eAAe,WAAW,OAAO,aAAa;AAChF,SAAO;AAAA,IACL,sBAAsB,gCAAgC,UAAU;AAAA,IAChE,kBAAkB;AAAA,IAClB,uBAAuB,MAAM,QAAQ,QAAQ,eAAe,IAAI,CAAC,GAAG,OAAO,eAAe,IAAI,CAAC;AAAA,IAC/F,sBAAsB;AAAA,IACtB,gBAAgB,sBAAsB,QAAQ,QAAQ,IAAI,OAAO,WAAW;AAAA,IAC5E,gBAAgB,OAAO,QAAQ,UAAU,aAAa,WAAW,OAAO,SAAS,WAAW;AAAA,IAC5F,kBAAkB,QAAQ,aAAa,CAAC,GACrC,IAAI,CAAC,aAAc,OAAO,UAAU,WAAW,WAAW,SAAS,SAAS,EAAG,EAC/E,OAAO,CAAC,WAAW,OAAO,SAAS,CAAC;AAAA,IACvC,gBAAgB;AAAA,MACd,QAAQ,QAAQ,UAAU,UAAU;AAAA,MACpC,YAAY,QAAQ,UAAU,cAAc;AAAA,IAC9C;AAAA,EACF;AACF;AASO,SAAS,wBACd,QAC+B;AAC/B,QAAM,OAAO,QAAQ;AACrB,QAAM,aAAa,SAAS,SAAS,MAAM,QAAQ,oBAAoB,IAAI,KAAK;AAChF,QAAM,mBAAmB,QAAQ,yBAAyB,CAAC,GACxD,IAAI,CAAC,SAAU,OAAO,SAAS,WAAW,KAAK,KAAK,IAAI,EAAG,EAC3D,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AACnC,QAAM,YAAY,QAAQ,kBAAkB,IAAI,KAAK;AACrD,QAAM,aAAa,QAAQ,mBAAmB,CAAC,GAC5C,IAAI,CAAC,WAAY,OAAO,WAAW,WAAW,OAAO,KAAK,IAAI,EAAG,EACjE,OAAO,CAAC,WAAW,OAAO,SAAS,CAAC,EACpC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE;AAC/B,QAAM,eAAe,QAAQ,gBAAgB;AAC7C,QAAM,cAAc,QAAQ,gBAAgB,cAAc,IAAI,KAAK;AAEnE,QAAM,SAA4B;AAAA,IAChC,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA,IACnC,GAAI,gBAAgB,SAAS,EAAE,gBAAgB,IAAI,CAAC;AAAA,IACpD,GAAI,sBAAsB,QAAQ,cAAc,IAAI,EAAE,UAAU,OAAO,eAAe,IAAI,CAAC;AAAA,IAC3F,GAAI,WAAW,EAAE,UAAU,EAAE,UAAU,SAAS,EAAE,IAAI,CAAC;AAAA,IACvD,GAAI,UAAU,SAAS,EAAE,UAAU,IAAI,CAAC;AAAA,IACxC,GAAI,eACA;AAAA,MACE,UACE,iBAAiB,cAAc,aAC3B,EAAE,QAAQ,cAAc,WAAW,IACnC,EAAE,QAAQ,aAAa;AAAA,IAC/B,IACA,CAAC;AAAA,EACP;AAEA,SAAO,OAAO,KAAK,MAAM,EAAE,SAAS,SAAS;AAC/C;",
+  "names": []
+}

package/dist/modules/workflows/lib/agent-review.js

@@ -0,0 +1,66 @@
+import { resolveBreachReassignTarget } from "./breach-routing.js";
+import {
+  resolveTaskAssignment
+} from "./task-resolution.js";
+const INVOKE_AGENT_ACTIVITY_TYPE = "INVOKE_AGENT";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function findAgentReviewConfig(step) {
+  const activity = (step?.activities ?? []).find(
+    (candidate) => candidate?.activityType === INVOKE_AGENT_ACTIVITY_TYPE
+  );
+  const review = activity?.config?.review;
+  return isRecord(review) ? review : null;
+}
+function findAgentReviewConfigForStep(definition, stepId) {
+  const step = (definition?.steps ?? []).find((candidate) => candidate?.stepId === stepId);
+  return findAgentReviewConfig(step);
+}
+function resolveAgentReview(review, interpolate) {
+  const assignment = resolveTaskAssignment(
+    {
+      assignedTo: review?.assignedTo,
+      assignedToRoles: review?.assignedToRoles
+    },
+    interpolate
+  );
+  const reminders = (review?.reminders ?? []).filter(
+    (reminder) => typeof reminder?.offset === "string" && reminder.offset.length > 0
+  );
+  return {
+    ...assignment,
+    priority: review?.priority ?? null,
+    deadlineDuration: typeof review?.deadline?.duration === "string" && review.deadline.duration.length ? review.deadline.duration : null,
+    reminders: reminders.length ? reminders : null
+  };
+}
+function toAgentDispositionReview(resolved) {
+  const descriptor = {
+    ...resolved.assignedTo ? { assignedTo: resolved.assignedTo } : {},
+    ...resolved.assignedToRoles?.length ? { assignedToRoles: resolved.assignedToRoles } : {},
+    ...resolved.priority ? { priority: resolved.priority } : {},
+    ...resolved.deadlineDuration ? { deadlineDuration: resolved.deadlineDuration } : {},
+    ...resolved.reminders?.length ? { reminders: resolved.reminders } : {}
+  };
+  return Object.keys(descriptor).length ? descriptor : null;
+}
+function resolveAgentReviewBreachHandling(onBreach) {
+  const action = onBreach?.action;
+  if (action === "notify") return { kind: "notify" };
+  if (action === "attention") return { kind: "attention" };
+  if (action === "reassign") {
+    const target = resolveBreachReassignTarget(onBreach?.reassignTo);
+    return target ? { kind: "reassign", ...target } : { kind: "none" };
+  }
+  return { kind: "none" };
+}
+export {
+  INVOKE_AGENT_ACTIVITY_TYPE,
+  findAgentReviewConfig,
+  findAgentReviewConfigForStep,
+  resolveAgentReview,
+  resolveAgentReviewBreachHandling,
+  toAgentDispositionReview
+};
+//# sourceMappingURL=agent-review.js.map

package/dist/modules/workflows/lib/agent-review.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/agent-review.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 the Invoke Agent node's Review section (spec \u00A77.5).\n *\n * \"Who reviews a proposal this step raises, and by when.\" The thing being\n * authored is a real task \u2014 the implicit disposition task the enterprise\n * `dispositionService` raises when the confidence gate routes to a human \u2014 so\n * every rule here delegates to the \u00A76.1 task resolvers rather than restating\n * them. What is NEW is the breach vocabulary, and what is new about it is what\n * it LACKS.\n *\n * ## A breached disposition deadline escalates. It never decides.\n *\n * `resolveAgentReviewBreachHandling` has no `route` arm and no verdict arm, and\n * that absence is the feature. Auto-rejecting a proposal nobody answered \u2014 or\n * auto-approving it, or routing the run past it \u2014 is a disposition reached\n * without a human, which is precisely the boundary\n * `agent_orchestrator/AGENTS.md` guards (\"Ask before changing \u2026 the auto-approve\n * vs `user_task` boundary\"). The maintainer decision for this phase is explicit:\n * on breach, notify / reassign / mark for attention; the proposal stays\n * `pending` until a person acts. The accepted cost is that a breached proposal\n * can sit indefinitely if nobody picks it up \u2014 which is a queue that is visibly\n * behind, not a decision made by a timer.\n *\n * PURE: no ORM, DI, React or registry imports. Callers pass plain definition\n * JSON and an `interpolate` bound to the run context.\n */\n\nimport type { AgentReviewConfig, AgentReviewOnBreach } from '../data/activity-config-schemas'\nimport type { AgentDispositionReview } from './agent-disposition-task'\nimport { resolveBreachReassignTarget } from './breach-routing'\nimport {\n  resolveTaskAssignment,\n  type ResolvedTaskAssignment,\n  type TaskInterpolate,\n} from './task-resolution'\n\nexport const INVOKE_AGENT_ACTIVITY_TYPE = 'INVOKE_AGENT'\n\nexport interface AgentReviewStepLike {\n  activities?: { activityType?: string; config?: { review?: unknown } }[] | null\n}\n\nexport interface AgentReviewDefinitionLike {\n  steps?: ({ stepId?: string } & AgentReviewStepLike)[] | null\n}\n\nexport interface ResolvedAgentReview extends ResolvedTaskAssignment {\n  priority: string | null\n  /** Authored deadline duration; the absolute due date is anchored to task creation. */\n  deadlineDuration: string | null\n  reminders: { offset: string }[] | null\n}\n\nexport type AgentReviewBreachHandling =\n  | { kind: 'notify' }\n  | { kind: 'reassign'; assignedTo: string | null; assignedToRoles: string[] | null }\n  | { kind: 'attention' }\n  | { kind: 'none' }\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/**\n * The Review config authored on a step's INVOKE_AGENT activity.\n *\n * Read structurally rather than through the zod schema so a definition the\n * engine can still execute is never rejected here: a malformed Review block\n * degrades to \"no review configured\", which is the behaviour every definition\n * authored before this section existed already has.\n */\nexport function findAgentReviewConfig(\n  step: AgentReviewStepLike | null | undefined,\n): AgentReviewConfig | null {\n  const activity = (step?.activities ?? []).find(\n    (candidate) => candidate?.activityType === INVOKE_AGENT_ACTIVITY_TYPE,\n  )\n  const review = activity?.config?.review\n  return isRecord(review) ? (review as AgentReviewConfig) : null\n}\n\n/** The Review config of one step of a definition, addressed by step id. */\nexport function findAgentReviewConfigForStep(\n  definition: AgentReviewDefinitionLike | null | undefined,\n  stepId: string,\n): AgentReviewConfig | null {\n  const step = (definition?.steps ?? []).find((candidate) => candidate?.stepId === stepId)\n  return findAgentReviewConfig(step)\n}\n\n/**\n * Resolve the authored Review section against the run context.\n *\n * Assignment goes through the SAME `resolveTaskAssignment` a USER_TASK step\n * uses, so a dynamic assignee that resolves to nothing falls back to the\n * authored role queue here exactly as it does there \u2014 never to an unassigned\n * row, which under the \u00A76.4 visibility model is a row nobody can act on.\n *\n * `assigneeKind` is always `'user'`: a proposal is disposed from the backoffice\n * caseload, and a portal principal has no surface that could dispose one.\n */\nexport function resolveAgentReview(\n  review: AgentReviewConfig | null | undefined,\n  interpolate: TaskInterpolate,\n): ResolvedAgentReview {\n  const assignment = resolveTaskAssignment(\n    {\n      assignedTo: review?.assignedTo,\n      assignedToRoles: review?.assignedToRoles,\n    },\n    interpolate,\n  )\n\n  const reminders = (review?.reminders ?? []).filter(\n    (reminder) => typeof reminder?.offset === 'string' && reminder.offset.length > 0,\n  )\n\n  return {\n    ...assignment,\n    priority: review?.priority ?? null,\n    deadlineDuration:\n      typeof review?.deadline?.duration === 'string' && review.deadline.duration.length\n        ? review.deadline.duration\n        : null,\n    reminders: reminders.length ? reminders : null,\n  }\n}\n\n/**\n * Project a resolved Review onto the descriptor that crosses the bridge to\n * `agent_orchestrator`.\n *\n * Returns null when the author configured nothing, so a step that never opened\n * the Review section sends no descriptor at all and the disposition service\n * takes exactly the path it took before.\n */\nexport function toAgentDispositionReview(\n  resolved: ResolvedAgentReview,\n): AgentDispositionReview | null {\n  const descriptor: AgentDispositionReview = {\n    ...(resolved.assignedTo ? { assignedTo: resolved.assignedTo } : {}),\n    ...(resolved.assignedToRoles?.length ? { assignedToRoles: resolved.assignedToRoles } : {}),\n    ...(resolved.priority ? { priority: resolved.priority } : {}),\n    ...(resolved.deadlineDuration ? { deadlineDuration: resolved.deadlineDuration } : {}),\n    ...(resolved.reminders?.length ? { reminders: resolved.reminders } : {}),\n  }\n  return Object.keys(descriptor).length ? descriptor : null\n}\n\n/**\n * The single decision point for a breached disposition deadline.\n *\n * Every fall-through is `none`, which is what a step that authored no breach\n * action has always done. Note what cannot be returned: nothing here disposes\n * the proposal, and nothing here advances the run past it.\n */\nexport function resolveAgentReviewBreachHandling(\n  onBreach: AgentReviewOnBreach | null | undefined,\n): AgentReviewBreachHandling {\n  const action = onBreach?.action\n\n  if (action === 'notify') return { kind: 'notify' }\n  if (action === 'attention') return { kind: 'attention' }\n\n  if (action === 'reassign') {\n    const target = resolveBreachReassignTarget(onBreach?.reassignTo)\n    return target ? { kind: 'reassign', ...target } : { kind: 'none' }\n  }\n\n  return { kind: 'none' }\n}\n"],
+  "mappings": "AA6BA,SAAS,mCAAmC;AAC5C;AAAA,EACE;AAAA,OAGK;AAEA,MAAM,6BAA6B;AAuB1C,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAUO,SAAS,sBACd,MAC0B;AAC1B,QAAM,YAAY,MAAM,cAAc,CAAC,GAAG;AAAA,IACxC,CAAC,cAAc,WAAW,iBAAiB;AAAA,EAC7C;AACA,QAAM,SAAS,UAAU,QAAQ;AACjC,SAAO,SAAS,MAAM,IAAK,SAA+B;AAC5D;AAGO,SAAS,6BACd,YACA,QAC0B;AAC1B,QAAM,QAAQ,YAAY,SAAS,CAAC,GAAG,KAAK,CAAC,cAAc,WAAW,WAAW,MAAM;AACvF,SAAO,sBAAsB,IAAI;AACnC;AAaO,SAAS,mBACd,QACA,aACqB;AACrB,QAAM,aAAa;AAAA,IACjB;AAAA,MACE,YAAY,QAAQ;AAAA,MACpB,iBAAiB,QAAQ;AAAA,IAC3B;AAAA,IACA;AAAA,EACF;AAEA,QAAM,aAAa,QAAQ,aAAa,CAAC,GAAG;AAAA,IAC1C,CAAC,aAAa,OAAO,UAAU,WAAW,YAAY,SAAS,OAAO,SAAS;AAAA,EACjF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU,QAAQ,YAAY;AAAA,IAC9B,kBACE,OAAO,QAAQ,UAAU,aAAa,YAAY,OAAO,SAAS,SAAS,SACvE,OAAO,SAAS,WAChB;AAAA,IACN,WAAW,UAAU,SAAS,YAAY;AAAA,EAC5C;AACF;AAUO,SAAS,yBACd,UAC+B;AAC/B,QAAM,aAAqC;AAAA,IACzC,GAAI,SAAS,aAAa,EAAE,YAAY,SAAS,WAAW,IAAI,CAAC;AAAA,IACjE,GAAI,SAAS,iBAAiB,SAAS,EAAE,iBAAiB,SAAS,gBAAgB,IAAI,CAAC;AAAA,IACxF,GAAI,SAAS,WAAW,EAAE,UAAU,SAAS,SAAS,IAAI,CAAC;AAAA,IAC3D,GAAI,SAAS,mBAAmB,EAAE,kBAAkB,SAAS,iBAAiB,IAAI,CAAC;AAAA,IACnF,GAAI,SAAS,WAAW,SAAS,EAAE,WAAW,SAAS,UAAU,IAAI,CAAC;AAAA,EACxE;AACA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,aAAa;AACvD;AASO,SAAS,iCACd,UAC2B;AAC3B,QAAM,SAAS,UAAU;AAEzB,MAAI,WAAW,SAAU,QAAO,EAAE,MAAM,SAAS;AACjD,MAAI,WAAW,YAAa,QAAO,EAAE,MAAM,YAAY;AAEvD,MAAI,WAAW,YAAY;AACzB,UAAM,SAAS,4BAA4B,UAAU,UAAU;AAC/D,WAAO,SAAS,EAAE,MAAM,YAAY,GAAG,OAAO,IAAI,EAAE,MAAM,OAAO;AAAA,EACnE;AAEA,SAAO,EAAE,MAAM,OAAO;AACxB;",
+  "names": []
+}