@arbidocs/blocks 0.4.75 → 0.4.76

package/dist/agents/index.js

@@ -1,8 +1,8 @@
 "use client";
-export { AgentAvatarField, AgentBar, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarProbeAnswer, AgentBarQueuedNote, AgentBarStatus, AgentCard, AgentCreateView, AgentCreatedView, AgentCreator, AgentEditView, AgentGallery, AgentMainView, AgentSelect, AgentTypeSelector, CapabilityGrid, CapabilityTile, ConfigField, ConfigForm, ConsentActions, ConsentBulletList, ConsentCard, ConsentFootnote, ConsentHeader, ConsentMessage, ConsentNotice, ConsentPage, ConsentPermissionList, ConsentSection, ConsentStrong, ConsentText, ConversationListView, ConversationTurnSpeaker, CopyableUrl, DEFAULT_AGENT_AVATAR_FIELD_LABELS, DEFAULT_AGENT_BAR_LABELS, DEFAULT_AGENT_CARD_LABELS, DEFAULT_AGENT_CREATOR_LABELS, DEFAULT_AGENT_GALLERY_LABELS, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_AGENT_STEPS_LABELS, DEFAULT_AGENT_TYPE_SELECTOR_LABELS, DEFAULT_AUTHORIZE_AGENT_LABELS, DEFAULT_CONFIG_FIELD_LABELS, DEFAULT_CONFIG_FORM_LABELS, DEFAULT_CONSENT_ACTIONS_LABELS, DEFAULT_COPYABLE_URL_LABELS, DEFAULT_NEW_THREAD_DIALOG_LABELS, DEFAULT_PILL_SELECT_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_LABELS, DEFAULT_SKILL_CARD_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, DEFAULT_SKILL_ROW_LABELS, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, DEFAULT_SUBAGENT_ROSTER_LABELS, DEFAULT_TASKS_CHROME_LABELS, DEFAULT_TASK_ACTIVITY_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_LIST_LABELS, DEFAULT_TASK_OUTPUTS_CELL_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TASK_STATUS_PILL_LABELS, DEFAULT_TASK_THREAD_CHIP_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOWS_CHROME_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, DERIVED_NAME_WORDS, EMPTY_NEW_THREAD, GoalCriteria, MAX_TASK_DEPTH, NewThreadDialog, PersonPill, PillSelect, RecurrenceBuilder, STATUS_LABELS, STATUS_ORDER, STATUS_TONE, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TASK_COLUMN_ORDER, TRIGGER_LABELS, TaskActivityDialog, TaskActivityTimeline, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TaskTriggerChip, TasksToolbar, ThreadActivity, ThreadNotifyDialog, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowThreadStrip, WorkflowsTable, WorkflowsToolbar, agentConfigSectionToValues, agentCreatorToConfigSection, asTaskStatus, authModeFor, buildRRule, buildTaskRows, buildWorkflowScopeSource, compactThreadActivity, composePersona, composerToTaskQuery, composerToWorkRequest, composerToWorkflowRequest, composerToWorkflowUpdate, createTaskColumns, createWorkflowColumns, createsWork, defaultScopeRenderer, defaultTaskComposerValues, deriveAgentName, deriveWorkflowName, descendantIds, describeRRule, filterConversationRows, firstWords, formatElapsed, goalProgress, groupThreadActivity, hasTaskFields, hasTrigger, humanizeSection, indexTasks, inferType, inputDocumentIds, isAgenticWorkflow, isOutOfBounds, isPlainTodo, isSkillRow, isValidAgentName, isoToLocalInput, localInputToIso, matchWorkflowScope, moveTargets, newThreadToRequest, nextCriterionId, ownerExtId, parseRRule, prettifyKey, resolveScopeInputs, skillSlug, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowFromSkillMarkdown, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowToSkillMarkdown, workflowTriggerType, workflowWhen } from '../chunk-LT2UORRG.js';
+export { AgentAvatarField, AgentBar, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarProbeAnswer, AgentBarQueuedNote, AgentBarStatus, AgentCard, AgentCreateView, AgentCreatedView, AgentCreator, AgentEditView, AgentGallery, AgentMainView, AgentSelect, AgentTypeSelector, CapabilityGrid, CapabilityTile, ConfigField, ConfigForm, ConsentActions, ConsentBulletList, ConsentCard, ConsentFootnote, ConsentHeader, ConsentMessage, ConsentNotice, ConsentPage, ConsentPermissionList, ConsentSection, ConsentStrong, ConsentText, ConversationListView, ConversationTurnSpeaker, CopyableUrl, DEFAULT_AGENT_AVATAR_FIELD_LABELS, DEFAULT_AGENT_BAR_LABELS, DEFAULT_AGENT_CARD_LABELS, DEFAULT_AGENT_CREATOR_LABELS, DEFAULT_AGENT_GALLERY_LABELS, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_AGENT_STEPS_LABELS, DEFAULT_AGENT_TYPE_SELECTOR_LABELS, DEFAULT_AUTHORIZE_AGENT_LABELS, DEFAULT_CONFIG_FIELD_LABELS, DEFAULT_CONFIG_FORM_LABELS, DEFAULT_CONSENT_ACTIONS_LABELS, DEFAULT_COPYABLE_URL_LABELS, DEFAULT_NEW_THREAD_DIALOG_LABELS, DEFAULT_PILL_SELECT_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_LABELS, DEFAULT_SKILL_CARD_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, DEFAULT_SKILL_ROW_LABELS, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, DEFAULT_SUBAGENT_ROSTER_LABELS, DEFAULT_TASKS_CHROME_LABELS, DEFAULT_TASK_ACTIVITY_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_LIST_LABELS, DEFAULT_TASK_OUTPUTS_CELL_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TASK_STATUS_PILL_LABELS, DEFAULT_TASK_THREAD_CHIP_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOWS_CHROME_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, DERIVED_NAME_WORDS, EMPTY_NEW_THREAD, GoalCriteria, MAX_TASK_DEPTH, NewThreadDialog, PersonPill, PillSelect, RecurrenceBuilder, STATUS_LABELS, STATUS_ORDER, STATUS_TONE, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TASK_COLUMN_ORDER, TRIGGER_LABELS, TaskActivityDialog, TaskActivityTimeline, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TaskTriggerChip, TasksToolbar, ThreadActivity, ThreadNotifyDialog, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowThreadStartedBy, WorkflowThreadStrip, WorkflowsTable, WorkflowsToolbar, agentConfigSectionToValues, agentCreatorToConfigSection, asTaskStatus, authModeFor, buildRRule, buildTaskRows, buildWorkflowScopeSource, compactThreadActivity, composePersona, composerToTaskQuery, composerToWorkRequest, composerToWorkflowRequest, composerToWorkflowUpdate, createTaskColumns, createWorkflowColumns, createsWork, defaultScopeRenderer, defaultTaskComposerValues, deriveAgentName, deriveWorkflowName, descendantIds, describeRRule, filterConversationRows, firstWords, formatElapsed, goalProgress, groupThreadActivity, hasTaskFields, hasTrigger, humanizeSection, indexTasks, inferType, inputDocumentIds, isAgenticWorkflow, isOutOfBounds, isPlainTodo, isSkillRow, isValidAgentName, isoToLocalInput, linkedRunsFromActivity, localInputToIso, matchWorkflowScope, moveTargets, newThreadToRequest, nextCriterionId, ownerExtId, parseRRule, prettifyKey, resolveScopeInputs, skillSlug, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowFromSkillMarkdown, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowToSkillMarkdown, workflowTriggerType, workflowWhen } from '../chunk-TKB7TVMW.js';
 import '../chunk-CKB64Z4R.js';
 import '../chunk-P6GHJSLR.js';
-export { DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, WorkflowRunner, buildLaunch, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runThreadTitle, skillToWorkflow, stepDependencies, stepLevels, stepPhase, stepStatesFromActivity, toPlanSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-YWYVIQ7T.js';
+export { DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, WorkflowRunner, buildLaunch, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isIncompleteSignal, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runThreadTitle, skillToWorkflow, stepDependencies, stepLevels, stepPhase, stepStatesFromActivity, toPlanSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-22P5KNIM.js';
 import '../chunk-4WWM3GQ5.js';
 import '../chunk-RFXJYIDV.js';
 import '../chunk-DPLRHEJZ.js';
@@ -13,11 +13,11 @@ import '../chunk-ZPLG7QYF.js';
 import '../chunk-DDF5GPIJ.js';
 import '../chunk-XD2M6LIG.js';
 import '../chunk-S7PSMMRG.js';
+import '../chunk-76JDDMSP.js';
 import '../chunk-HOXKR26S.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
-import '../chunk-76JDDMSP.js';
 import '../chunk-OXF2IFXG.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-7F6CBP3Z.js';

package/dist/agents/tasks/TaskActivityTimeline.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-export type TaskActivityKind = 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed';
+export type TaskActivityKind = 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'linked_run';
 /** One event of a task's history, as the backend returns it (oldest first). */
 export interface TaskActivityEvent {
     external_id: string;

package/dist/agents/tasks/WorkflowThreadStrip.d.ts

@@ -3,6 +3,8 @@
  * to come), with everything that actually happened in the thread attached to the step it happened
  * during — the assistant's turns, a draft sent back, people's messages and edits, notifications.
  * What happened before the first step or after the last stays as ordinary entries at either end.
+ * Linked runs show too: a signal a step raised and the linked thread it started (after the step),
+ * and, for a thread a signal started, "Started by <step> in <thread>" (before the steps).
  * A thread without a workflow shows `TaskFlow` instead.
  */
 import type { ReactNode } from 'react';
@@ -36,8 +38,34 @@ export interface WorkflowThreadStripLabels {
     happened: string;
     nothingYet: string;
     skip: string;
+    /** A linked run's origin; `{step}` and `{thread}` are replaced. */
+    startedBy: string;
+    /** A raised signal's tooltip; `{signal}` is replaced. */
+    signalled: string;
+    /** A linked thread's tooltip; `{signal}` is replaced. */
+    linkedRun: string;
 }
 export declare const DEFAULT_WORKFLOW_THREAD_STRIP_LABELS: WorkflowThreadStripLabels;
+/** A linked thread a signal started, as the host names it. */
+export interface WorkflowThreadLinkedRun {
+    id: string;
+    /** The thread's title, or its workflow's name. */
+    label: string;
+    onSelect?: () => void;
+}
+/** A signal one of the run's steps raised, and the linked threads it started. */
+export interface WorkflowThreadSignal {
+    step: string;
+    signal: string;
+    runs: WorkflowThreadLinkedRun[];
+}
+/** Where a linked run came from: the step and the parent thread whose signal started it. */
+export interface WorkflowThreadOrigin {
+    stepTitle: string;
+    threadTitle: string;
+    signal?: string;
+    onSelect?: () => void;
+}
 export interface WorkflowThreadStripProps {
     steps: WorkflowStep[];
     /** Each step's state (from `stepStatesFromActivity`). */
@@ -52,7 +80,16 @@ export interface WorkflowThreadStripProps {
     onSkip?: (stepId: string) => void;
     /** The host's action for a person's step (fill in the form, approve…), shown in its popover. */
     renderStepAction?: (step: WorkflowStep, phase: WorkflowStepPhase) => ReactNode;
+    /** Signals the steps raised and the linked threads they started (`linkedRunsFromActivity`). */
+    signals?: readonly WorkflowThreadSignal[];
+    /** For a thread a signal started: where it came from. */
+    startedBy?: WorkflowThreadOrigin;
     labels?: Partial<WorkflowThreadStripLabels>;
     className?: string;
 }
-export declare function WorkflowThreadStrip({ steps, states, items, renderIcon, onSkip, renderStepAction, labels, className, }: WorkflowThreadStripProps): import("react").JSX.Element;
+/** "Started by <step> in <thread>": a linked run's way back to the thread that started it. */
+export declare function WorkflowThreadStartedBy({ origin, labels, }: {
+    origin: WorkflowThreadOrigin;
+    labels?: Partial<WorkflowThreadStripLabels>;
+}): import("react").JSX.Element;
+export declare function WorkflowThreadStrip({ steps, states, items, renderIcon, onSkip, renderStepAction, signals, startedBy, labels, className, }: WorkflowThreadStripProps): import("react").JSX.Element;

package/dist/agents/tasks/index.d.ts

@@ -23,7 +23,8 @@ export { TaskStatusPill, DEFAULT_TASK_STATUS_PILL_LABELS, type TaskStatusPillPro
 export { TaskActivityTimeline, DEFAULT_TASK_ACTIVITY_LABELS, type TaskActivityEvent, type TaskActivityKind, type TaskActivityLabels, type TaskActivityTimelineProps, } from './TaskActivityTimeline';
 export { TaskActivityDialog, type TaskActivityDialogProps } from './TaskActivityDialog';
 export { TaskFlow, ThreadActivity, type TaskFlowItem } from './TaskFlow';
-export { WorkflowThreadStrip, groupThreadActivity, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, type WorkflowThreadItem, type WorkflowThreadStripProps, type WorkflowThreadStripLabels, type GroupedThreadActivity, } from './WorkflowThreadStrip';
+export { WorkflowThreadStrip, groupThreadActivity, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, type WorkflowThreadItem, type WorkflowThreadStripProps, type WorkflowThreadStripLabels, type GroupedThreadActivity, WorkflowThreadStartedBy, type WorkflowThreadSignal, type WorkflowThreadOrigin, type WorkflowThreadLinkedRun, } from './WorkflowThreadStrip';
+export { linkedRunsFromActivity, type WorkflowRunLinks, type WorkflowRaisedSignal, type WorkflowRunOrigin, type WorkflowLinkedRunRef, } from './linkedRuns';
 export { compactThreadActivity, type CompactThreadActivity } from './compact-thread-activity';
 export { TaskOutputsCell, DEFAULT_TASK_OUTPUTS_CELL_LABELS, type TaskOutput, type TaskOutputsCellProps, type TaskOutputsCellLabels, } from './TaskOutputsCell';
 export { TaskThreadChip, DEFAULT_TASK_THREAD_CHIP_LABELS, type TaskThreadChipProps, type TaskThreadChipLabels, } from './TaskThreadChip';

package/dist/agents/tasks/linkedRuns.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Linked runs, read from a thread's activity log: the signals its steps raised (`step_signal`), the
+ * linked workflows each one started (`linked_run`, pointing at the new thread), and, for a thread a
+ * signal started, where it came from (its `created` event's `linked_from`). The thread's top bar
+ * shows them (`WorkflowThreadStrip`); the host resolves the threads' titles and navigation.
+ */
+import type { WorkflowActivityEvent } from '../workflows/run';
+/** A thread a signal started. */
+export interface WorkflowLinkedRunRef {
+    conversationId: string;
+    /** The workflow that started on the signal (`wfl-…`). */
+    workflowId?: string;
+}
+/** A signal one of the thread's steps raised, and the linked threads it started. */
+export interface WorkflowRaisedSignal {
+    step: string;
+    signal: string;
+    runs: WorkflowLinkedRunRef[];
+}
+/** Where a linked run came from: the step (and its signal) in the parent thread that started it. */
+export interface WorkflowRunOrigin {
+    conversationId: string;
+    step?: string;
+    signal?: string;
+}
+export interface WorkflowRunLinks {
+    raised: WorkflowRaisedSignal[];
+    startedBy?: WorkflowRunOrigin;
+}
+/** The thread's linked runs from its activity log (oldest first). */
+export declare function linkedRunsFromActivity(events: readonly WorkflowActivityEvent[] | null | undefined): WorkflowRunLinks;

package/dist/agents/workflows/index.d.ts

@@ -8,7 +8,7 @@ export { WorkflowLauncher, type WorkflowLauncherProps } from './WorkflowLauncher
 export { buildWorkflowScopeSource, matchWorkflowScope, type WorkflowScopeDocument, type WorkflowScopeLabel, } from './workspaceScope';
 export { WorkflowDocumentsField, type WorkflowDocumentsFieldProps } from './WorkflowDocumentsField';
 export { workflowSteps, isSteppedWorkflow, stepDependencies, dependsOn, orderSteps, validateWorkflowGraph, stepLevels, stepStatesFromActivity, runFields, initialRunInputs, stepPhase, isRunFinished, isPersonStep, nextAction, validateStep, fillRunText, fillStepInputs, runThreadTitle, reviewInstructions, composeStepPrompt, type StepComposeOptions, type WorkflowActivityEvent, type WorkflowGraphProblem, type WorkflowStepPhase, type WorkflowNextAction, } from './run';
-export { toPlanSteps, fromPlanSteps, layoutFromPlanSteps, type TaskPlanStep, type ToPlanOptions, } from './planSteps';
+export { toPlanSteps, fromPlanSteps, layoutFromPlanSteps, isIncompleteSignal, type TaskPlanStep, type ToPlanOptions, } from './planSteps';
 export { workflowToSkillMarkdown, workflowFromSkillMarkdown, skillSlug } from './skillMarkdown';
 export { useWorkflowView, type UseWorkflowViewOptions, type WorkflowRunView, } from './useWorkflowView';
 export { useWorkflowPreview, type UseWorkflowPreviewOptions } from './useWorkflowPreview';

package/dist/agents/workflows/planSteps.d.ts

@@ -6,7 +6,7 @@
  */
 import type { components } from '@arbidocs/client';
 import { type StepComposeOptions } from './run';
-import type { WorkflowDefinition, WorkflowInputs, WorkflowStep } from './types';
+import type { WorkflowDefinition, WorkflowInputs, WorkflowSignal, WorkflowStep } from './types';
 export type TaskPlanStep = components['schemas']['TaskPlanStep'];
 export type TaskPlan = components['schemas']['TaskPlan'];
 export interface ToPlanOptions extends StepComposeOptions {
@@ -19,6 +19,8 @@ export interface ToPlanOptions extends StepComposeOptions {
 }
 /** The plan steps a run thread (or a saved workflow) carries for `workflow`. */
 export declare function toPlanSteps(workflow: WorkflowDefinition, options?: ToPlanOptions): TaskPlanStep[];
+/** A signal the builder holds that is not finished yet: no name, or a condition with nothing in it. */
+export declare function isIncompleteSignal(signal: WorkflowSignal): boolean;
 /** Steps from a run's (or a saved workflow's) plan: what the runner, the builder and the top bar show. */
 export declare function fromPlanSteps(steps: TaskPlanStep[] | null | undefined): WorkflowStep[];
 /** Where each step sits on the builder's canvas, as the plan keeps it. */

package/dist/agents/workflows/types.d.ts

@@ -92,6 +92,31 @@ export type WorkflowRun =
         y: number;
     }>;
 };
+/**
+ * When a step's signal is raised, tested against the step's outcome once it is done (a skipped or
+ * failed step never signals): a form field equals a value (case-insensitive text), the agent's
+ * answer contains a phrase or matches a regex, or a review is approved. Absent = whenever it is done.
+ */
+export type WorkflowSignalWhen = {
+    field: string;
+    equals: string | number | boolean;
+} | {
+    contains: string;
+} | {
+    matches: string;
+} | {
+    approved: true;
+};
+/**
+ * A named signal a step raises when it is done and its condition holds. Another workflow starts on
+ * it ("When a step signals") as its own thread linked to this one, so the if/then between
+ * workflows lives in the link and each workflow stays short.
+ */
+export interface WorkflowSignal {
+    /** A slug (`[a-z0-9][a-z0-9_.-]*`), e.g. `risk-high`: what a linked workflow listens for. */
+    name: string;
+    when?: WorkflowSignalWhen;
+}
 interface WorkflowStepBase {
     /** Unique within the workflow (`[a-z][a-z0-9_-]*`): the thread's progress is keyed by it. */
     id: string;
@@ -113,6 +138,8 @@ interface WorkflowStepBase {
      * sequence. `[]`: it starts with the run. A step waiting for several waits for them all.
      */
     after?: string[];
+    /** Signals the step raises when it is done and their condition holds. */
+    signals?: WorkflowSignal[];
 }
 /** Ask for inputs. Every step's fields share the run's one input namespace (`{{name}}`). */
 export interface WorkflowFormStep extends WorkflowStepBase {

package/dist/{chunk-YWYVIQ7T.js → chunk-22P5KNIM.js}

@@ -738,10 +738,29 @@ function toPlanSteps(workflow, options = {}) {
       branch: step.kind === "agent" && !!step.branch,
       requires_files: false,
       ui,
+      // An unfinished signal (still being typed) is not saved: the server would refuse it.
+      ...step.signals?.some((s) => !isIncompleteSignal(s)) ? { signals: step.signals.filter((s) => !isIncompleteSignal(s)).map(toPlanSignal) } : {},
       ...step.kind === "agent" ? agentStep(workflow, step, options) : { skill: null, inputs: null, prompt: null }
     };
   });
 }
+function toPlanSignal(signal) {
+  return signal.when ? { name: signal.name, when: signal.when } : { name: signal.name };
+}
+function isIncompleteSignal(signal) {
+  const when = signal.when;
+  if (!signal.name.trim()) return true;
+  if (!when) return false;
+  if ("field" in when) return !when.field || String(when.equals).trim() === "";
+  if ("contains" in when) return !when.contains.trim();
+  if ("matches" in when) return !when.matches.trim();
+  return false;
+}
+function fromPlanSignal(signal) {
+  const w = signal.when;
+  const when = w?.field != null && w.equals != null ? { field: w.field, equals: w.equals } : w?.contains != null ? { contains: w.contains } : w?.matches != null ? { matches: w.matches } : w?.approved ? { approved: true } : void 0;
+  return when ? { name: signal.name, when } : { name: signal.name };
+}
 function fromPlanSteps(steps) {
   return (steps ?? []).map((p) => {
     const ui = p.ui ?? {};
@@ -752,7 +771,8 @@ function fromPlanSteps(steps) {
       icon: ui.icon,
       commit: ui.commit,
       nextLabel: ui.next_label,
-      ...p.after != null ? { after: p.after } : {}
+      ...p.after != null ? { after: p.after } : {},
+      ...p.signals?.length ? { signals: p.signals.map(fromPlanSignal) } : {}
     };
     switch (p.kind) {
       case "form":
@@ -1397,6 +1417,6 @@ function AgentStepBody({
   ] });
 }
 
-export { DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, WorkflowRunner, buildLaunch, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runThreadTitle, skillToWorkflow, stepDependencies, stepLevels, stepPhase, stepStatesFromActivity, toPlanSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost };
-//# sourceMappingURL=chunk-YWYVIQ7T.js.map
-//# sourceMappingURL=chunk-YWYVIQ7T.js.map
+export { DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, WorkflowRunner, buildLaunch, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isIncompleteSignal, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runThreadTitle, skillToWorkflow, stepDependencies, stepLevels, stepPhase, stepStatesFromActivity, toPlanSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost };
+//# sourceMappingURL=chunk-22P5KNIM.js.map
+//# sourceMappingURL=chunk-22P5KNIM.js.map