@arbidocs/blocks 0.4.75 → 0.4.76

package/dist/workflow-canvas/index.cjs

@@ -2,10 +2,10 @@
 'use strict';
 
 var chunkMUMH3Z6K_cjs = require('../chunk-MUMH3Z6K.cjs');
-var chunkF4LUD3YC_cjs = require('../chunk-F4LUD3YC.cjs');
+var chunk7FKARMA3_cjs = require('../chunk-7FKARMA3.cjs');
 require('../chunk-YJQVLVBJ.cjs');
 require('../chunk-ZW6FPIFC.cjs');
-var chunkP2RBE3FD_cjs = require('../chunk-P2RBE3FD.cjs');
+var chunkVYRKO3XU_cjs = require('../chunk-VYRKO3XU.cjs');
 require('../chunk-7RGLTF76.cjs');
 require('../chunk-3AFWGEDJ.cjs');
 require('../chunk-VFUWWH52.cjs');
@@ -16,11 +16,11 @@ require('../chunk-IXALYQT7.cjs');
 require('../chunk-Z5VUZ6YD.cjs');
 require('../chunk-7D737FLE.cjs');
 require('../chunk-OB5F4577.cjs');
+require('../chunk-C54XEN5T.cjs');
 require('../chunk-B4SRYJLM.cjs');
 require('../chunk-7UTB4PHM.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-PPCATBOY.cjs');
-require('../chunk-C54XEN5T.cjs');
 require('../chunk-KDG6FER6.cjs');
 require('../chunk-ULWRNGGE.cjs');
 require('../chunk-MHVNT4J3.cjs');
@@ -48,11 +48,11 @@ function withSteps(workflow, steps, layout) {
   const run = workflow.run.kind === "steps" ? workflow.run : { kind: "steps", steps: [] };
   return {
     ...workflow,
-    run: { ...run, steps: chunkP2RBE3FD_cjs.orderSteps(steps), layout: layout ?? run.layout }
+    run: { ...run, steps: chunkVYRKO3XU_cjs.orderSteps(steps), layout: layout ?? run.layout }
   };
 }
 var layoutOf = (workflow) => workflow.run.kind === "steps" && workflow.run.layout || {};
-var explicit = (steps) => steps.map((s) => ({ ...s, after: chunkP2RBE3FD_cjs.stepDependencies(steps, s.id) }));
+var explicit = (steps) => steps.map((s) => ({ ...s, after: chunkVYRKO3XU_cjs.stepDependencies(steps, s.id) }));
 function stepIdFor(steps, title) {
   const base = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/^[^a-z]+/, "") || "step";
   const taken = new Set(steps.map((s) => s.id));
@@ -80,7 +80,7 @@ function blankStep(kind, id, title) {
   }
 }
 function addStep(workflow, kind, options = {}) {
-  const steps = explicit(chunkP2RBE3FD_cjs.workflowSteps(workflow));
+  const steps = explicit(chunkVYRKO3XU_cjs.workflowSteps(workflow));
   const title = options.title ?? DEFAULT_TITLES[kind];
   const id = stepIdFor(steps, title);
   const step = { ...blankStep(kind, id, title), after: options.after ? [options.after] : [] };
@@ -89,7 +89,7 @@ function addStep(workflow, kind, options = {}) {
   return { workflow: withSteps(workflow, [...steps, step], layout), id };
 }
 function removeStep(workflow, id) {
-  const steps = explicit(chunkP2RBE3FD_cjs.workflowSteps(workflow));
+  const steps = explicit(chunkVYRKO3XU_cjs.workflowSteps(workflow));
   const removed = steps.find((s) => s.id === id);
   if (!removed) return workflow;
   const bridged = steps.filter((s) => s.id !== id).map(
@@ -102,8 +102,8 @@ function removeStep(workflow, id) {
   return withSteps(workflow, bridged, layout);
 }
 function connectSteps(workflow, from, to) {
-  const steps = explicit(chunkP2RBE3FD_cjs.workflowSteps(workflow));
-  if (from === to || !steps.some((s) => s.id === from) || chunkP2RBE3FD_cjs.dependsOn(steps, from, to)) {
+  const steps = explicit(chunkVYRKO3XU_cjs.workflowSteps(workflow));
+  if (from === to || !steps.some((s) => s.id === from) || chunkVYRKO3XU_cjs.dependsOn(steps, from, to)) {
     return workflow;
   }
   return withSteps(
@@ -113,16 +113,16 @@ function connectSteps(workflow, from, to) {
     )
   );
 }
-var wouldCycle = (workflow, from, to) => from === to || chunkP2RBE3FD_cjs.dependsOn(chunkP2RBE3FD_cjs.workflowSteps(workflow), from, to);
+var wouldCycle = (workflow, from, to) => from === to || chunkVYRKO3XU_cjs.dependsOn(chunkVYRKO3XU_cjs.workflowSteps(workflow), from, to);
 function disconnectSteps(workflow, from, to) {
-  const steps = explicit(chunkP2RBE3FD_cjs.workflowSteps(workflow));
+  const steps = explicit(chunkVYRKO3XU_cjs.workflowSteps(workflow));
   return withSteps(
     workflow,
     steps.map((s) => s.id === to ? { ...s, after: (s.after ?? []).filter((d) => d !== from) } : s)
   );
 }
 function updateStep(workflow, id, patch) {
-  const steps = explicit(chunkP2RBE3FD_cjs.workflowSteps(workflow));
+  const steps = explicit(chunkVYRKO3XU_cjs.workflowSteps(workflow));
   return withSteps(
     workflow,
     steps.map(
@@ -136,7 +136,7 @@ var renameIn = (text, from, to) => text.replace(
 );
 function renameInput(workflow, from, to) {
   if (from === to) return workflow;
-  const steps = chunkP2RBE3FD_cjs.workflowSteps(workflow).map((s) => {
+  const steps = chunkVYRKO3XU_cjs.workflowSteps(workflow).map((s) => {
     if (s.kind === "agent")
       return {
         ...s,
@@ -150,13 +150,13 @@ function renameInput(workflow, from, to) {
   return withSteps(workflow, steps);
 }
 function moveStep(workflow, id, position) {
-  return withSteps(workflow, chunkP2RBE3FD_cjs.workflowSteps(workflow), { ...layoutOf(workflow), [id]: position });
+  return withSteps(workflow, chunkVYRKO3XU_cjs.workflowSteps(workflow), { ...layoutOf(workflow), [id]: position });
 }
 var COLUMN = 300;
 var ROW = 140;
 function autoLayout(steps) {
   const layout = {};
-  chunkP2RBE3FD_cjs.stepLevels(steps).forEach(
+  chunkVYRKO3XU_cjs.stepLevels(steps).forEach(
     (level, x) => level.forEach((s, y) => {
       layout[s.id] = { x: x * COLUMN, y: (y - (level.length - 1) / 2) * ROW };
     })
@@ -164,9 +164,225 @@ function autoLayout(steps) {
   return layout;
 }
 function layoutWithDefaults(workflow) {
-  const auto = autoLayout(chunkP2RBE3FD_cjs.workflowSteps(workflow));
+  const auto = autoLayout(chunkVYRKO3XU_cjs.workflowSteps(workflow));
   return { ...auto, ...layoutOf(workflow) };
 }
+var DEFAULT_SIGNALS_EDITOR_LABELS = {
+  heading: "When done, signal\u2026",
+  hint: "Another workflow can start on a signal (\u201CWhen a step signals\u201D), as its own thread linked to this one.",
+  add: "Add signal",
+  name: "Signal",
+  namePlaceholder: "e.g. risk-high",
+  when: "When",
+  always: "Whenever it is done",
+  fieldEquals: "A field equals",
+  answerContains: "The answer contains",
+  answerMatches: "The answer matches (regex)",
+  approved: "It is approved",
+  field: "Field",
+  value: "Value",
+  phrase: "Phrase",
+  phrasePlaceholder: "e.g. Risk rating: High",
+  pattern: "Pattern",
+  remove: "Remove signal"
+};
+function signalConditions(kind) {
+  switch (kind) {
+    case "form":
+      return ["always", "field"];
+    case "agent":
+      return ["always", "contains", "matches"];
+    case "review":
+      return ["approved", "always"];
+    default:
+      return ["always"];
+  }
+}
+function conditionOf(when) {
+  if (!when) return "always";
+  if ("field" in when) return "field";
+  if ("contains" in when) return "contains";
+  if ("matches" in when) return "matches";
+  return "approved";
+}
+function signalSlug(text) {
+  return text.toLowerCase().replace(/[^a-z0-9_.-]+/g, "-").replace(/^[^a-z0-9]+/, "").slice(0, 64);
+}
+function startCondition(kind, step) {
+  switch (kind) {
+    case "field":
+      return { field: step.kind === "form" ? step.inputs[0]?.name ?? "" : "", equals: "" };
+    case "contains":
+      return { contains: "" };
+    case "matches":
+      return { matches: "" };
+    case "approved":
+      return { approved: true };
+    default:
+      return void 0;
+  }
+}
+function newSignal(step, taken) {
+  const base = signalSlug(step.id) || "signal";
+  let name = `${base}-done`;
+  let n = 2;
+  while (taken.includes(name)) name = `${base}-done-${n++}`;
+  const when = startCondition(signalConditions(step.kind)[0], step);
+  return when ? { name, when } : { name };
+}
+var selectClass = "flex h-8 w-full rounded-md border border-input bg-background px-2 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring";
+function SignalsEditor({
+  step,
+  onChange,
+  labels,
+  testId = "signals-editor"
+}) {
+  const l = { ...DEFAULT_SIGNALS_EDITOR_LABELS, ...labels };
+  const signals = step.signals ?? [];
+  const conditions = signalConditions(step.kind);
+  const conditionLabel = {
+    always: l.always,
+    field: l.fieldEquals,
+    contains: l.answerContains,
+    matches: l.answerMatches,
+    approved: l.approved
+  };
+  const emit = (next) => onChange(next.length ? next : void 0);
+  const set = (i, signal) => emit(signals.map((s, j) => j === i ? signal : s));
+  const fields = step.kind === "form" ? step.inputs : [];
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", "data-testid": testId, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.heading }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-2", children: [
+      signals.map((signal, i) => {
+        const condition = conditionOf(signal.when);
+        const when = signal.when;
+        return /* @__PURE__ */ jsxRuntime.jsxs(
+          "div",
+          {
+            className: ui.cn(
+              "space-y-1.5 rounded-md border p-2",
+              chunkVYRKO3XU_cjs.isIncompleteSignal(signal) ? "border-destructive/50" : "border-border"
+            ),
+            "data-incomplete": chunkVYRKO3XU_cjs.isIncompleteSignal(signal) || void 0,
+            "data-testid": `${testId}-${i}`,
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  ui.Input,
+                  {
+                    value: signal.name,
+                    "aria-label": l.name,
+                    placeholder: l.namePlaceholder,
+                    onChange: (e) => set(i, { ...signal, name: signalSlug(e.target.value) }),
+                    className: "h-8 font-mono text-xs",
+                    "data-testid": `${testId}-${i}-name`
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "button",
+                  {
+                    type: "button",
+                    "aria-label": l.remove,
+                    onClick: () => emit(signals.filter((_, j) => j !== i)),
+                    "data-testid": `${testId}-${i}-remove`,
+                    children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { className: "size-4 text-muted-foreground" })
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "select",
+                {
+                  "aria-label": l.when,
+                  className: selectClass,
+                  value: condition,
+                  onChange: (e) => {
+                    const nextWhen = startCondition(e.target.value, step);
+                    set(i, nextWhen ? { name: signal.name, when: nextWhen } : { name: signal.name });
+                  },
+                  "data-testid": `${testId}-${i}-when`,
+                  children: [...conditions, ...conditions.includes(condition) ? [] : [condition]].map(
+                    (c) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: c, children: conditionLabel[c] }, c)
+                  )
+                }
+              ),
+              when && "field" in when && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
+                /* @__PURE__ */ jsxRuntime.jsxs(
+                  "select",
+                  {
+                    "aria-label": l.field,
+                    className: ui.cn(selectClass, "flex-1"),
+                    value: when.field,
+                    onChange: (e) => set(i, { ...signal, when: { ...when, field: e.target.value } }),
+                    "data-testid": `${testId}-${i}-field`,
+                    children: [
+                      fields.map((f) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: f.name, children: f.label }, f.name)),
+                      !fields.some((f) => f.name === when.field) && /* @__PURE__ */ jsxRuntime.jsx("option", { value: when.field, children: when.field || "\u2014" })
+                    ]
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  ui.Input,
+                  {
+                    "aria-label": l.value,
+                    placeholder: l.value,
+                    value: String(when.equals),
+                    onChange: (e) => set(i, { ...signal, when: { ...when, equals: e.target.value } }),
+                    className: "h-8 flex-1",
+                    "data-testid": `${testId}-${i}-equals`
+                  }
+                )
+              ] }),
+              when && "contains" in when && /* @__PURE__ */ jsxRuntime.jsx(
+                ui.Input,
+                {
+                  "aria-label": l.phrase,
+                  placeholder: l.phrasePlaceholder,
+                  value: when.contains,
+                  onChange: (e) => set(i, { ...signal, when: { contains: e.target.value } }),
+                  className: "h-8",
+                  "data-testid": `${testId}-${i}-contains`
+                }
+              ),
+              when && "matches" in when && /* @__PURE__ */ jsxRuntime.jsx(
+                ui.Input,
+                {
+                  "aria-label": l.pattern,
+                  placeholder: "risk rating:\\s*high",
+                  value: when.matches,
+                  onChange: (e) => set(i, { ...signal, when: { matches: e.target.value } }),
+                  className: "h-8 font-mono text-xs",
+                  "data-testid": `${testId}-${i}-matches`
+                }
+              )
+            ]
+          },
+          i
+        );
+      }),
+      /* @__PURE__ */ jsxRuntime.jsxs(
+        ui.Button,
+        {
+          variant: "outline",
+          size: "sm",
+          onClick: () => emit([
+            ...signals,
+            newSignal(
+              step,
+              signals.map((s) => s.name)
+            )
+          ]),
+          "data-testid": `${testId}-add`,
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Plus, { className: "size-4" }),
+            " ",
+            l.add
+          ]
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-muted-foreground", children: l.hint })
+  ] });
+}
 var DEFAULT_STEP_INSPECTOR_LABELS = {
   workflow: "Workflow",
   title: "Title",
@@ -199,7 +415,7 @@ var DEFAULT_STEP_INSPECTOR_LABELS = {
   deleteStep: "Delete step"
 };
 var FIELD_TYPES = ["text", "longtext", "boolean", "number", "date", "scope"];
-var selectClass = "flex h-9 w-full rounded-md border border-input bg-background px-2 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring";
+var selectClass2 = "flex h-9 w-full rounded-md border border-input bg-background px-2 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring";
 function Field({ label, children, hint }) {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
     /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: label }),
@@ -221,10 +437,11 @@ function StepInspector({
   onSelect,
   workflows = [],
   labels,
+  signalLabels,
   testId = "step-inspector"
 }) {
   const l = { ...DEFAULT_STEP_INSPECTOR_LABELS, ...labels };
-  const steps = chunkP2RBE3FD_cjs.workflowSteps(workflow);
+  const steps = chunkVYRKO3XU_cjs.workflowSteps(workflow);
   const step = steps.find((s) => s.id === stepId);
   const run = workflow.run.kind === "steps" ? workflow.run : void 0;
   if (!step || !run) {
@@ -249,7 +466,7 @@ function StepInspector({
     ] });
   }
   const patch = (p) => onChange(updateStep(workflow, step.id, p));
-  const deps = chunkP2RBE3FD_cjs.stepDependencies(steps, step.id);
+  const deps = chunkVYRKO3XU_cjs.stepDependencies(steps, step.id);
   const titleOf = (id) => steps.find((s) => s.id === id)?.title ?? id;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-4", "data-testid": `${testId}-step`, children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-2", children: [
@@ -338,7 +555,7 @@ function StepInspector({
       {
         step,
         workflows,
-        fields: chunkP2RBE3FD_cjs.runFields(workflow).map((f) => f.name),
+        fields: chunkVYRKO3XU_cjs.runFields(workflow).map((f) => f.name),
         patch,
         l,
         testId
@@ -353,6 +570,15 @@ function StepInspector({
         "data-testid": `${testId}-instructions`
       }
     ) }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      SignalsEditor,
+      {
+        step,
+        onChange: (signals) => patch({ signals }),
+        labels: signalLabels,
+        testId: `${testId}-signals`
+      }
+    ),
     /* @__PURE__ */ jsxRuntime.jsxs(
       ui.Button,
       {
@@ -414,7 +640,7 @@ function FormFields({
           "select",
           {
             "aria-label": l.fieldType,
-            className: ui.cn(selectClass, "h-8"),
+            className: ui.cn(selectClass2, "h-8"),
             value: f.type,
             onChange: (e) => set(i, { type: e.target.value }),
             children: FIELD_TYPES.map((t) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: t, children: t }, t))
@@ -481,7 +707,7 @@ function AgentSettings({
     /* @__PURE__ */ jsxRuntime.jsx(Field, { label: l.runs, children: /* @__PURE__ */ jsxRuntime.jsxs(
       "select",
       {
-        className: selectClass,
+        className: selectClass2,
         value,
         onChange: (e) => {
           const id = e.target.value;
@@ -538,7 +764,7 @@ function AgentSettings({
     /* @__PURE__ */ jsxRuntime.jsx(Field, { label: l.thread, children: /* @__PURE__ */ jsxRuntime.jsxs(
       "select",
       {
-        className: selectClass,
+        className: selectClass2,
         value: step.branch ? "branch" : "main",
         onChange: (e) => patch({ branch: e.target.value === "branch" || void 0 }),
         "data-testid": `${testId}-thread`,
@@ -551,7 +777,7 @@ function AgentSettings({
     /* @__PURE__ */ jsxRuntime.jsx(Field, { label: l.output, children: /* @__PURE__ */ jsxRuntime.jsxs(
       "select",
       {
-        className: selectClass,
+        className: selectClass2,
         value: step.output ?? "answer",
         onChange: (e) => patch({ output: e.target.value === "artifact" ? "artifact" : void 0 }),
         children: [
@@ -562,6 +788,138 @@ function AgentSettings({
     ) })
   ] });
 }
+
+// src/workflow-canvas/trigger.ts
+var WORKFLOW_SIGNAL_EVENT = "workflow_signal";
+var DEFAULT_WORKFLOW_TRIGGER = {
+  start: "manual",
+  runAt: "",
+  rrule: "",
+  timezone: typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC",
+  eventKind: "",
+  signal: "",
+  afterTaskId: "",
+  agentId: "",
+  access: "ask_each_run"
+};
+function triggerProblem(trigger) {
+  if (trigger.start === "once" && !trigger.runAt) return "runAt";
+  if (trigger.start === "repeat" && !trigger.rrule.trim()) return "rrule";
+  if (trigger.start === "event" && !trigger.eventKind.trim()) return "event";
+  if (isSignalTrigger(trigger) && !trigger.signal.trim()) return "signal";
+  if (trigger.start === "task" && !trigger.afterTaskId) return "task";
+  return null;
+}
+var isSignalTrigger = (trigger) => trigger.start === "event" && trigger.eventKind.trim() === WORKFLOW_SIGNAL_EVENT;
+function eventFilter(trigger) {
+  if (trigger.start !== "event") return null;
+  if (isSignalTrigger(trigger)) return { signal: trigger.signal.trim() };
+  return trigger.eventFilter && Object.keys(trigger.eventFilter).length ? trigger.eventFilter : null;
+}
+function triggerFields(trigger, clearOthers) {
+  const none = clearOthers ? null : void 0;
+  const filter = eventFilter(trigger);
+  return {
+    timezone: trigger.timezone,
+    rrule: trigger.start === "repeat" ? trigger.rrule.trim() : none,
+    run_at: trigger.start === "once" ? chunk7FKARMA3_cjs.localInputToIso(trigger.runAt) : none,
+    event_kind: trigger.start === "event" ? trigger.eventKind.trim() : none,
+    // A step signal is `workflow_signal` narrowed to one signal name.
+    event_filter: filter ?? none,
+    after_conversation_ext_id: trigger.start === "task" ? trigger.afterTaskId : none,
+    on_demand: trigger.start === "manual"
+  };
+}
+var authMode = (trigger) => trigger.start === "manual" ? "run_now_temp" : trigger.access === "standing" ? "scheduled_permanent" : "scheduled_require_auth";
+var withoutUndefined = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
+function plan(value, options) {
+  return {
+    goal: value.workflow.description,
+    criteria: [],
+    max_passes: 3,
+    documents: [],
+    steps: chunkVYRKO3XU_cjs.toPlanSteps(value.workflow, options)
+  };
+}
+function builderToWorkflowRequest(value, workspaceId, options = {}) {
+  return withoutUndefined({
+    workspace_ext_id: workspaceId,
+    name: value.workflow.title,
+    description: value.workflow.description,
+    active: true,
+    shared: true,
+    ...triggerFields(value.trigger, false),
+    prompt: "",
+    skill_ref: null,
+    skill_inputs: null,
+    agent_ext_id: value.trigger.agentId || null,
+    auth_mode: authMode(value.trigger),
+    plan: plan(value, options)
+  });
+}
+function builderToWorkflowUpdate(value, options = {}) {
+  return withoutUndefined({
+    name: value.workflow.title,
+    description: value.workflow.description,
+    ...triggerFields(value.trigger, true),
+    // The steps are what runs (a classic automation's single prompt or skill becomes its one step).
+    prompt: "",
+    skill_ref: null,
+    skill_inputs: null,
+    agent_ext_id: value.trigger.agentId || null,
+    auth_mode: authMode(value.trigger),
+    plan: plan(value, options)
+  });
+}
+function workflowRecordToBuilder(record) {
+  const planned = record.plan?.steps ?? [];
+  const steps = planned.length ? chunkVYRKO3XU_cjs.fromPlanSteps(planned) : record.prompt || record.skill_ref ? [
+    {
+      id: "work",
+      kind: "agent",
+      title: record.name,
+      ...record.skill_ref ? { workflow: record.skill_ref } : { run: { kind: "prompt", promptTemplate: record.prompt } }
+    }
+  ] : [];
+  const when = chunk7FKARMA3_cjs.workflowWhen(record);
+  return {
+    workflow: {
+      id: record.external_id,
+      title: record.name,
+      description: record.description ?? "",
+      inputs: [],
+      landing: "chat",
+      schedulable: false,
+      run: { kind: "steps", steps, layout: chunkVYRKO3XU_cjs.layoutFromPlanSteps(planned ?? []) }
+    },
+    trigger: {
+      ...DEFAULT_WORKFLOW_TRIGGER,
+      start: when === "now" ? "manual" : when,
+      runAt: chunk7FKARMA3_cjs.isoToLocalInput(record.run_at),
+      rrule: record.rrule ?? "",
+      timezone: record.timezone || DEFAULT_WORKFLOW_TRIGGER.timezone,
+      eventKind: record.event_kind ?? "",
+      signal: record.event_kind === WORKFLOW_SIGNAL_EVENT && typeof record.event_filter?.signal === "string" ? record.event_filter.signal : "",
+      eventFilter: record.event_kind && record.event_kind !== WORKFLOW_SIGNAL_EVENT && record.event_filter ? record.event_filter : void 0,
+      afterTaskId: record.after_conversation_ext_id ?? "",
+      agentId: record.agent_ext_id ?? "",
+      access: record.auth_mode === "scheduled_permanent" ? "standing" : "ask_each_run"
+    }
+  };
+}
+function declaredSignals(records, current) {
+  const out = /* @__PURE__ */ new Map();
+  const add = (workflow, steps) => {
+    for (const step of steps)
+      for (const signal of step.signals ?? [])
+        if (signal.name && !out.has(signal.name))
+          out.set(signal.name, { value: signal.name, label: `${workflow} \u203A ${step.title}` });
+  };
+  for (const record of records)
+    add(record.name, record.plan?.steps ?? []);
+  if (current?.run.kind === "steps") add(current.title, current.run.steps);
+  return [...out.values()];
+}
 var DEFAULT_TRIGGER_INSPECTOR_LABELS = {
   heading: "Start",
   start: "Starts",
@@ -575,6 +933,11 @@ var DEFAULT_TRIGGER_INSPECTOR_LABELS = {
   runAt: "When",
   event: "Event",
   eventPlaceholder: "Pick an event",
+  stepSignals: "When a step signals",
+  signal: "Signal",
+  signalPlaceholder: "e.g. risk-high",
+  signalHint: "Starts as its own thread, linked to the thread whose step raised it, with that run\u2019s inputs.",
+  signalSummary: "When a step signals \u201C{signal}\u201D",
   afterTask: "After this task",
   afterTaskPlaceholder: "Pick a task",
   agent: "Runs as",
@@ -588,8 +951,10 @@ function triggerSummary(trigger, options = {}) {
     case "once":
       return trigger.runAt ? new Date(trigger.runAt).toLocaleString() : l.starts.once;
     case "repeat":
-      return trigger.rrule ? chunkF4LUD3YC_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
+      return trigger.rrule ? chunk7FKARMA3_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
     case "event":
+      if (isSignalTrigger(trigger))
+        return trigger.signal ? l.signalSummary.replace("{signal}", trigger.signal) : l.stepSignals;
       return trigger.eventKind && options.eventLabel?.(trigger.eventKind) || trigger.eventKind || l.starts.event;
     case "task":
       return trigger.afterTaskId && options.taskLabel?.(trigger.afterTaskId) || l.starts.task;
@@ -597,7 +962,7 @@ function triggerSummary(trigger, options = {}) {
       return l.starts.manual;
   }
 }
-var selectClass2 = "flex h-9 w-full rounded-md border border-input bg-background px-2 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring";
+var selectClass3 = "flex h-9 w-full rounded-md border border-input bg-background px-2 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring";
 var STARTS = ["manual", "once", "repeat", "event", "task"];
 function TriggerInspector({
   trigger,
@@ -605,11 +970,13 @@ function TriggerInspector({
   agents = [],
   eventKinds = [],
   tasks = [],
+  signals = [],
   labels,
   testId = "trigger-inspector"
 }) {
   const l = { ...DEFAULT_TRIGGER_INSPECTOR_LABELS, ...labels };
   const set = (patch) => onChange({ ...trigger, ...patch });
+  const events = eventKinds.some((k) => k.value === WORKFLOW_SIGNAL_EVENT) ? eventKinds : [...eventKinds, { value: WORKFLOW_SIGNAL_EVENT, label: l.stepSignals }];
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-4", "data-testid": testId, children: [
     /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm font-semibold", children: l.heading }),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
@@ -643,29 +1010,45 @@ function TriggerInspector({
         }
       )
     ] }),
-    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunkF4LUD3YC_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
+    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunk7FKARMA3_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
     trigger.start === "event" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.event }),
       /* @__PURE__ */ jsxRuntime.jsxs(
         "select",
         {
-          className: selectClass2,
+          className: selectClass3,
           value: trigger.eventKind,
-          onChange: (e) => set({ eventKind: e.target.value }),
+          onChange: (e) => set({ eventKind: e.target.value, eventFilter: void 0 }),
           "data-testid": `${testId}-event`,
           children: [
             /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", children: l.eventPlaceholder }),
-            eventKinds.map((k) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: k.value, children: k.label }, k.value))
+            events.map((k) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: k.value, children: k.label }, k.value))
           ]
         }
       )
     ] }),
+    isSignalTrigger(trigger) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", htmlFor: `${testId}-signal`, children: l.signal }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        ui.Input,
+        {
+          id: `${testId}-signal`,
+          list: `${testId}-signal-options`,
+          value: trigger.signal,
+          placeholder: l.signalPlaceholder,
+          onChange: (e) => set({ signal: e.target.value.trim().toLowerCase() }),
+          "data-testid": `${testId}-signal`
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("datalist", { id: `${testId}-signal-options`, children: signals.map((s) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: s.value, children: s.label }, s.value)) }),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-muted-foreground", children: l.signalHint })
+    ] }),
     trigger.start === "task" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.afterTask }),
       /* @__PURE__ */ jsxRuntime.jsxs(
         "select",
         {
-          className: selectClass2,
+          className: selectClass3,
           value: trigger.afterTaskId,
           onChange: (e) => set({ afterTaskId: e.target.value }),
           "data-testid": `${testId}-after-task`,
@@ -679,7 +1062,7 @@ function TriggerInspector({
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.agent }),
       /* @__PURE__ */ jsxRuntime.jsx(
-        chunkF4LUD3YC_cjs.AgentSelect,
+        chunk7FKARMA3_cjs.AgentSelect,
         {
           agents,
           value: trigger.agentId,
@@ -694,7 +1077,7 @@ function TriggerInspector({
       /* @__PURE__ */ jsxRuntime.jsxs(
         "select",
         {
-          className: selectClass2,
+          className: selectClass3,
           value: trigger.access,
           onChange: (e) => set({ access: e.target.value === "standing" ? "standing" : "ask_each_run" }),
           "data-testid": `${testId}-access`,
@@ -928,12 +1311,12 @@ function WorkflowCanvas({
   testId = "workflow-canvas"
 }) {
   const l = react.useMemo(() => ({ ...DEFAULT_WORKFLOW_CANVAS_LABELS, ...labels }), [labels]);
-  const steps = chunkP2RBE3FD_cjs.workflowSteps(workflow);
+  const steps = chunkVYRKO3XU_cjs.workflowSteps(workflow);
   const editable = !!onChange;
   const built = react.useMemo(() => {
     const layout = layoutWithDefaults(workflow);
-    const all = chunkP2RBE3FD_cjs.workflowSteps(workflow);
-    const roots = all.filter((s) => chunkP2RBE3FD_cjs.stepDependencies(all, s.id).length === 0);
+    const all = chunkVYRKO3XU_cjs.workflowSteps(workflow);
+    const roots = all.filter((s) => chunkVYRKO3XU_cjs.stepDependencies(all, s.id).length === 0);
     const triggerNode = trigger ? [
       {
         id: TRIGGER_NODE,
@@ -970,7 +1353,7 @@ function WorkflowCanvas({
   react.useEffect(() => setNodes(built), [built]);
   const edges = react.useMemo(
     () => steps.flatMap((s) => {
-      const deps = chunkP2RBE3FD_cjs.stepDependencies(steps, s.id);
+      const deps = chunkVYRKO3XU_cjs.stepDependencies(steps, s.id);
       const from = deps.length ? deps : trigger ? [TRIGGER_NODE] : [];
       return from.map((d) => ({
         id: `${d}->${s.id}`,
@@ -1190,6 +1573,7 @@ function WorkflowBuilder({
   agents = [],
   eventKinds = [],
   tasks = [],
+  signals = [],
   compose,
   renderIcon,
   actions,
@@ -1210,8 +1594,8 @@ function WorkflowBuilder({
   const [mode, setMode] = react.useState("design");
   const [adding, setAdding] = react.useState(false);
   const { workflow, trigger } = value;
-  const steps = chunkP2RBE3FD_cjs.workflowSteps(workflow);
-  const problems = chunkP2RBE3FD_cjs.validateWorkflowGraph(steps);
+  const steps = chunkVYRKO3XU_cjs.workflowSteps(workflow);
+  const problems = chunkVYRKO3XU_cjs.validateWorkflowGraph(steps);
   const titles = react.useMemo(() => new Map(workflows.map((w) => [w.id, w.title])), [workflows]);
   const setWorkflow = (next) => onChange({ ...value, workflow: next });
   const addAfter = (from, kind) => {
@@ -1372,6 +1756,12 @@ function WorkflowBuilder({
                 agents,
                 eventKinds,
                 tasks,
+                signals: [
+                  ...signals,
+                  ...declaredSignals([], workflow).filter(
+                    (d) => !signals.some((s) => s.value === d.value)
+                  )
+                ],
                 labels: triggerLabels,
                 testId: `${testId}-trigger`
               }
@@ -1426,13 +1816,13 @@ function WorkflowPreview({
   renderIcon,
   testId
 }) {
-  const run = chunkF4LUD3YC_cjs.useWorkflowPreview(workflow, {
+  const run = chunk7FKARMA3_cjs.useWorkflowPreview(workflow, {
     resolveWorkflow: (id) => workflows.find((w) => w.id === id),
     compose,
     answer
   });
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunkP2RBE3FD_cjs.WorkflowRunner,
+    chunkVYRKO3XU_cjs.WorkflowRunner,
     {
       workflow,
       run,
@@ -1449,111 +1839,6 @@ function WorkflowPreview({
     }
   );
 }
-
-// src/workflow-canvas/trigger.ts
-var DEFAULT_WORKFLOW_TRIGGER = {
-  start: "manual",
-  runAt: "",
-  rrule: "",
-  timezone: typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC",
-  eventKind: "",
-  afterTaskId: "",
-  agentId: "",
-  access: "ask_each_run"
-};
-function triggerProblem(trigger) {
-  if (trigger.start === "once" && !trigger.runAt) return "runAt";
-  if (trigger.start === "repeat" && !trigger.rrule.trim()) return "rrule";
-  if (trigger.start === "event" && !trigger.eventKind.trim()) return "event";
-  if (trigger.start === "task" && !trigger.afterTaskId) return "task";
-  return null;
-}
-function triggerFields(trigger, clearOthers) {
-  const none = clearOthers ? null : void 0;
-  return {
-    timezone: trigger.timezone,
-    rrule: trigger.start === "repeat" ? trigger.rrule.trim() : none,
-    run_at: trigger.start === "once" ? chunkF4LUD3YC_cjs.localInputToIso(trigger.runAt) : none,
-    event_kind: trigger.start === "event" ? trigger.eventKind.trim() : none,
-    after_conversation_ext_id: trigger.start === "task" ? trigger.afterTaskId : none,
-    on_demand: trigger.start === "manual"
-  };
-}
-var authMode = (trigger) => trigger.start === "manual" ? "run_now_temp" : trigger.access === "standing" ? "scheduled_permanent" : "scheduled_require_auth";
-var withoutUndefined = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
-function plan(value, options) {
-  return {
-    goal: value.workflow.description,
-    criteria: [],
-    max_passes: 3,
-    documents: [],
-    steps: chunkP2RBE3FD_cjs.toPlanSteps(value.workflow, options)
-  };
-}
-function builderToWorkflowRequest(value, workspaceId, options = {}) {
-  return withoutUndefined({
-    workspace_ext_id: workspaceId,
-    name: value.workflow.title,
-    description: value.workflow.description,
-    active: true,
-    shared: true,
-    ...triggerFields(value.trigger, false),
-    prompt: "",
-    skill_ref: null,
-    skill_inputs: null,
-    agent_ext_id: value.trigger.agentId || null,
-    auth_mode: authMode(value.trigger),
-    plan: plan(value, options)
-  });
-}
-function builderToWorkflowUpdate(value, options = {}) {
-  return withoutUndefined({
-    name: value.workflow.title,
-    description: value.workflow.description,
-    ...triggerFields(value.trigger, true),
-    // The steps are what runs (a classic automation's single prompt or skill becomes its one step).
-    prompt: "",
-    skill_ref: null,
-    skill_inputs: null,
-    agent_ext_id: value.trigger.agentId || null,
-    auth_mode: authMode(value.trigger),
-    plan: plan(value, options)
-  });
-}
-function workflowRecordToBuilder(record) {
-  const planned = record.plan?.steps ?? [];
-  const steps = planned.length ? chunkP2RBE3FD_cjs.fromPlanSteps(planned) : record.prompt || record.skill_ref ? [
-    {
-      id: "work",
-      kind: "agent",
-      title: record.name,
-      ...record.skill_ref ? { workflow: record.skill_ref } : { run: { kind: "prompt", promptTemplate: record.prompt } }
-    }
-  ] : [];
-  const when = chunkF4LUD3YC_cjs.workflowWhen(record);
-  return {
-    workflow: {
-      id: record.external_id,
-      title: record.name,
-      description: record.description ?? "",
-      inputs: [],
-      landing: "chat",
-      schedulable: false,
-      run: { kind: "steps", steps, layout: chunkP2RBE3FD_cjs.layoutFromPlanSteps(planned ?? []) }
-    },
-    trigger: {
-      ...DEFAULT_WORKFLOW_TRIGGER,
-      start: when === "now" ? "manual" : when,
-      runAt: chunkF4LUD3YC_cjs.isoToLocalInput(record.run_at),
-      rrule: record.rrule ?? "",
-      timezone: record.timezone || DEFAULT_WORKFLOW_TRIGGER.timezone,
-      eventKind: record.event_kind ?? "",
-      afterTaskId: record.after_conversation_ext_id ?? "",
-      agentId: record.agent_ext_id ?? "",
-      access: record.auth_mode === "scheduled_permanent" ? "standing" : "ask_each_run"
-    }
-  };
-}
 var DEFAULT_CONNECTED_WORKFLOW_BUILDER_LABELS = {
   save: "Save",
   saving: "Saving\u2026",
@@ -1566,7 +1851,8 @@ var DEFAULT_WORKFLOW_EVENT_KINDS = [
   { value: "conversation_ready", label: "Work is ready for me" },
   { value: "mention", label: "Someone mentions me" },
   { value: "workflow_completed", label: "Another workflow finishes" },
-  { value: "workflow_failed", label: "Another workflow fails" }
+  { value: "workflow_failed", label: "Another workflow fails" },
+  { value: "workflow_signal", label: "When a step signals" }
 ];
 function ConnectedWorkflowBuilder({
   workflowId,
@@ -1605,7 +1891,7 @@ function ConnectedWorkflowBuilder({
     () => [
       ...hostWorkflows,
       ...(skills.data ?? []).map(
-        (s) => chunkP2RBE3FD_cjs.skillToWorkflow({
+        (s) => chunkVYRKO3XU_cjs.skillToWorkflow({
           name: s.name,
           slug: s.slug,
           description: s.description,
@@ -1621,7 +1907,7 @@ function ConnectedWorkflowBuilder({
   }));
   const tasks = (conversations.data ?? []).filter((c) => c.status && c.status !== "done").map((c) => ({ value: c.external_id, label: c.title || c.external_id }));
   const options = { resolveWorkflow: (wid) => workflows.find((w) => w.id === wid), compose };
-  const problem = triggerProblem(value.trigger) ?? (chunkP2RBE3FD_cjs.validateWorkflowGraph(chunkP2RBE3FD_cjs.workflowSteps(value.workflow)).length ? "graph" : null);
+  const problem = triggerProblem(value.trigger) ?? (chunkVYRKO3XU_cjs.validateWorkflowGraph(chunkVYRKO3XU_cjs.workflowSteps(value.workflow)).length ? "graph" : null);
   const busy = create.isPending || update.isPending || run.isPending;
   const save = async () => {
     if (!workspaceId) return void 0;
@@ -1643,6 +1929,7 @@ function ConnectedWorkflowBuilder({
       agents,
       eventKinds,
       tasks,
+      signals: declaredSignals(saved.data ?? []),
       compose,
       testId,
       actions: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
@@ -1689,15 +1976,18 @@ function ConnectedWorkflowBuilder({
 
 exports.ConnectedWorkflowBuilder = ConnectedWorkflowBuilder;
 exports.DEFAULT_CONNECTED_WORKFLOW_BUILDER_LABELS = DEFAULT_CONNECTED_WORKFLOW_BUILDER_LABELS;
+exports.DEFAULT_SIGNALS_EDITOR_LABELS = DEFAULT_SIGNALS_EDITOR_LABELS;
 exports.DEFAULT_STEP_INSPECTOR_LABELS = DEFAULT_STEP_INSPECTOR_LABELS;
 exports.DEFAULT_TRIGGER_INSPECTOR_LABELS = DEFAULT_TRIGGER_INSPECTOR_LABELS;
 exports.DEFAULT_WORKFLOW_BUILDER_LABELS = DEFAULT_WORKFLOW_BUILDER_LABELS;
 exports.DEFAULT_WORKFLOW_CANVAS_LABELS = DEFAULT_WORKFLOW_CANVAS_LABELS;
 exports.DEFAULT_WORKFLOW_EVENT_KINDS = DEFAULT_WORKFLOW_EVENT_KINDS;
 exports.DEFAULT_WORKFLOW_TRIGGER = DEFAULT_WORKFLOW_TRIGGER;
+exports.SignalsEditor = SignalsEditor;
 exports.StepInspector = StepInspector;
 exports.TRIGGER_NODE = TRIGGER_NODE;
 exports.TriggerInspector = TriggerInspector;
+exports.WORKFLOW_SIGNAL_EVENT = WORKFLOW_SIGNAL_EVENT;
 exports.WorkflowBuilder = WorkflowBuilder;
 exports.WorkflowCanvas = WorkflowCanvas;
 exports.addStep = addStep;
@@ -1705,11 +1995,15 @@ exports.autoLayout = autoLayout;
 exports.builderToWorkflowRequest = builderToWorkflowRequest;
 exports.builderToWorkflowUpdate = builderToWorkflowUpdate;
 exports.connectSteps = connectSteps;
+exports.declaredSignals = declaredSignals;
 exports.disconnectSteps = disconnectSteps;
+exports.isSignalTrigger = isSignalTrigger;
 exports.layoutWithDefaults = layoutWithDefaults;
 exports.moveStep = moveStep;
 exports.newSteppedWorkflow = newSteppedWorkflow;
 exports.removeStep = removeStep;
+exports.signalConditions = signalConditions;
+exports.signalSlug = signalSlug;
 exports.stepIdFor = stepIdFor;
 exports.triggerProblem = triggerProblem;
 exports.triggerSummary = triggerSummary;