@adecore/agents-react 0.31.12 → 0.33.0

package/dist/chat/logic/tool-catalog.js

@@ -1,14 +1,14 @@
 import { Bot, Eye, FolderSearch, Globe, ListTodo, Search, SquarePen, Terminal, Workflow, Zap } from 'lucide-react';
 function entry(icon, summary, rest = {}) {
-    return {
-        icon,
-        summary,
-        grouped: true,
-        changesFiles: false,
-        readsImage: false,
-        shell: false,
-        ...rest
-    };
+  return {
+    icon,
+    summary,
+    grouped: true,
+    changesFiles: false,
+    readsImage: false,
+    shell: false,
+    ...rest
+  };
 }
 /*
  * Every tool the thread has a word for, in one table so a new name is never missing from a lookup. A
@@ -16,30 +16,50 @@ function entry(icon, summary, rest = {}) {
  * string of its input.
  */
 export const TOOL_CATALOG = {
-    Read: entry(Eye, ['file_path'], { readsImage: true }),
-    // Only `readImagePath` ever had this one, which is why it has no sentence of its own yet.
-    NotebookRead: entry(Eye, ['file_path', 'notebook_path'], { grouped: false, readsImage: true }),
-    // These three read as "Edited 3 files" through `changesFiles`, so they carry no copy of that sentence.
-    Edit: entry(SquarePen, ['file_path'], { grouped: false, changesFiles: true }),
-    Write: entry(SquarePen, ['file_path'], { changesFiles: true }),
-    MultiEdit: entry(SquarePen, ['file_path'], { grouped: false, changesFiles: true }),
-    NotebookEdit: entry(SquarePen, ['file_path', 'notebook_path']),
-    // Codex reports a patch as the paths it touches; its own input carries no path of its own.
-    ApplyPatch: entry(SquarePen, ['summary'], { grouped: false, changesFiles: true }),
-    // Codex's command executions arrive under this name too.
-    Bash: entry(Terminal, ['description', 'command'], { shell: true }),
-    Grep: entry(Search, ['pattern']),
-    Glob: entry(FolderSearch, ['pattern']),
-    WebFetch: entry(Globe, ['url', 'query']),
-    WebSearch: entry(Globe, ['url', 'query']),
-    Task: entry(Bot, ['description']),
-    Agent: entry(Bot, ['description']),
-    Skill: entry(Zap, ['skill']),
-    // A plan is a list of objects, so there is no line to lift out of it.
-    TodoWrite: entry(ListTodo, []),
-    // Its input is the whole script; the line takes what the CLI says the workflow is about instead.
-    Workflow: entry(Workflow, [], { grouped: false })
+  Read: entry(Eye, ['file_path'], {
+    readsImage: true
+  }),
+  // Only `readImagePath` ever had this one, which is why it has no sentence of its own yet.
+  NotebookRead: entry(Eye, ['file_path', 'notebook_path'], {
+    grouped: false,
+    readsImage: true
+  }),
+  // These three read as "Edited 3 files" through `changesFiles`, so they carry no copy of that sentence.
+  Edit: entry(SquarePen, ['file_path'], {
+    grouped: false,
+    changesFiles: true
+  }),
+  Write: entry(SquarePen, ['file_path'], {
+    changesFiles: true
+  }),
+  MultiEdit: entry(SquarePen, ['file_path'], {
+    grouped: false,
+    changesFiles: true
+  }),
+  NotebookEdit: entry(SquarePen, ['file_path', 'notebook_path']),
+  // Codex reports a patch as the paths it touches; its own input carries no path of its own.
+  ApplyPatch: entry(SquarePen, ['summary'], {
+    grouped: false,
+    changesFiles: true
+  }),
+  // Codex's command executions arrive under this name too.
+  Bash: entry(Terminal, ['description', 'command'], {
+    shell: true
+  }),
+  Grep: entry(Search, ['pattern']),
+  Glob: entry(FolderSearch, ['pattern']),
+  WebFetch: entry(Globe, ['url', 'query']),
+  WebSearch: entry(Globe, ['url', 'query']),
+  Task: entry(Bot, ['description']),
+  Agent: entry(Bot, ['description']),
+  Skill: entry(Zap, ['skill']),
+  // A plan is a list of objects, so there is no line to lift out of it.
+  TodoWrite: entry(ListTodo, []),
+  // Its input is the whole script; the line takes what the CLI says the workflow is about instead.
+  Workflow: entry(Workflow, [], {
+    grouped: false
+  })
 };
 export function toolEntry(name) {
-    return TOOL_CATALOG[name];
-}
+  return TOOL_CATALOG[name];
+}

package/dist/chat/logic/tools.js

@@ -1,139 +1,163 @@
 import { isRecord } from './json.js';
 import { toolEntry } from './tool-catalog.js';
 function str(value) {
-    return typeof value === 'string' ? value : null;
+  return typeof value === 'string' ? value : null;
 }
 /* The one line that says what a tool call is about: the command, the file, the pattern. */
 export function toolSummary(name, input) {
-    if (!isRecord(input)) {
-        return '';
-    }
-    const known = toolEntry(name);
-    if (known === undefined) {
-        // A tool nobody wrote down, an MCP one above all, gets its best guess from the first string it was given.
-        const first = Object.values(input).find((value) => typeof value === 'string');
-        return typeof first === 'string' ? first : '';
-    }
-    for (const key of known.summary) {
-        const value = str(input[key]);
-        if (value !== null) {
-            return value;
-        }
-    }
+  if (!isRecord(input)) {
     return '';
+  }
+  const known = toolEntry(name);
+  if (known === undefined) {
+    // A tool nobody wrote down, an MCP one above all, gets its best guess from the first string it was given.
+    const first = Object.values(input).find(value => typeof value === 'string');
+    return typeof first === 'string' ? first : '';
+  }
+  for (const key of known.summary) {
+    const value = str(input[key]);
+    if (value !== null) {
+      return value;
+    }
+  }
+  return '';
 }
 // The input keys whose value is a file a call is about.
 const PATH_KEYS = new Set(['file_path', 'notebook_path']);
 /* Whether the one line of a call is the path of a file, which a row cuts in the middle so the name stays. */
 export function toolSummaryIsPath(name, input) {
-    const known = toolEntry(name);
-    if (known === undefined || !isRecord(input)) {
-        return false;
-    }
-    const key = known.summary.find((candidate) => str(input[candidate]) !== null);
-    return key !== undefined && PATH_KEYS.has(key);
+  const known = toolEntry(name);
+  if (known === undefined || !isRecord(input)) {
+    return false;
+  }
+  const key = known.summary.find(candidate => str(input[candidate]) !== null);
+  return key !== undefined && PATH_KEYS.has(key);
 }
 /* The command of a shell call, as it was run; null for any other call or one without a command. */
 export function shellCommand(name, input) {
-    if (toolEntry(name)?.shell !== true || !isRecord(input)) {
-        return null;
-    }
-    const command = str(input.command);
-    return command === null || command.trim() === '' ? null : command;
+  if (toolEntry(name)?.shell !== true || !isRecord(input)) {
+    return null;
+  }
+  const command = str(input.command);
+  return command === null || command.trim() === '' ? null : command;
 }
 // A shell call's description is already the detail of its row.
 const SHELL_SHOWN = new Set(['command', 'description']);
 function valueText(value) {
-    // An empty string can be the point of a call (clearing a field), so it shows as one.
-    return typeof value === 'string' && value !== '' ? value : (JSON.stringify(value) ?? String(value));
+  // An empty string can be the point of a call (clearing a field), so it shows as one.
+  return typeof value === 'string' && value !== '' ? value : JSON.stringify(value) ?? String(value);
 }
 /* The input of a call as lines: a shell command as itself, every other key as `key value`, null included. */
 export function toolCallLines(name, input) {
-    if (!isRecord(input)) {
-        const text = input === null || input === undefined || input === '' ? null : valueText(input);
-        return { command: null, args: [], text };
-    }
-    const command = shellCommand(name, input);
-    const args = Object.entries(input)
-        .filter(([key, value]) => value !== undefined && !(command !== null && SHELL_SHOWN.has(key)))
-        .map(([key, value]) => [key, valueText(value)]);
-    return { command, args, text: null };
+  if (!isRecord(input)) {
+    const text = input === null || input === undefined || input === '' ? null : valueText(input);
+    return {
+      command: null,
+      args: [],
+      text
+    };
+  }
+  const command = shellCommand(name, input);
+  const args = Object.entries(input).filter(([key, value]) => value !== undefined && !(command !== null && SHELL_SHOWN.has(key))).map(([key, value]) => [key, valueText(value)]);
+  return {
+    command,
+    args,
+    text: null
+  };
 }
 /* A failed call's output with the exit code its tool put on the first line ("Exit code 1"), as Claude Code's shell does. */
 export function exitCodeOf(output) {
-    const match = /^Exit code (-?\d+)[ \t]*(?:\r?\n|$)/.exec(output);
-    if (match === null || Number(match[1]) === 0) {
-        return { code: null, rest: output };
-    }
-    return { code: Number(match[1]), rest: output.slice(match[0].length) };
+  const match = /^Exit code (-?\d+)[ \t]*(?:\r?\n|$)/.exec(output);
+  if (match === null || Number(match[1]) === 0) {
+    return {
+      code: null,
+      rest: output
+    };
+  }
+  return {
+    code: Number(match[1]),
+    rest: output.slice(match[0].length)
+  };
 }
 /* Whether an output says anything; whitespace alone does not. */
 export function hasOutput(output) {
-    return output !== null && output.trim() !== '';
+  return output !== null && output.trim() !== '';
 }
 /* Whether opening a call shows anything: a diff, the input it was given or what it answered. */
 export function hasToolBody(tool) {
-    if (hasFileChanges(tool) || hasOutput(tool.output)) {
-        return true;
-    }
-    const lines = toolCallLines(tool.name, tool.input);
-    return lines.command !== null || lines.args.length > 0 || lines.text !== null;
+  if (hasFileChanges(tool) || hasOutput(tool.output)) {
+    return true;
+  }
+  const lines = toolCallLines(tool.name, tool.input);
+  return lines.command !== null || lines.args.length > 0 || lines.text !== null;
 }
 // What `GET /fs/file` will serve; a path with another suffix is not worth asking the host about.
 const IMAGE_SUFFIXES = ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg'];
 /* The image file a tool call looked at, so the row can draw it; null for every other call. */
 export function readImagePath(name, input) {
-    if (toolEntry(name)?.readsImage !== true) {
-        return null;
-    }
-    const path = isRecord(input) ? str(input.file_path) : null;
-    if (path === null) {
-        return null;
-    }
-    const lowered = path.toLowerCase();
-    return IMAGE_SUFFIXES.some((suffix) => lowered.endsWith(suffix)) ? path : null;
+  if (toolEntry(name)?.readsImage !== true) {
+    return null;
+  }
+  const path = isRecord(input) ? str(input.file_path) : null;
+  if (path === null) {
+    return null;
+  }
+  const lowered = path.toLowerCase();
+  return IMAGE_SUFFIXES.some(suffix => lowered.endsWith(suffix)) ? path : null;
 }
 /* The before and after text of a file-changing tool call, so the thread can show it as a diff. */
 export function fileChanges(name, input) {
-    if (!isRecord(input)) {
-        return [];
-    }
-    const path = str(input.file_path) ?? '';
-    if (name === 'Edit') {
-        return [{ path, before: str(input.old_string) ?? '', after: str(input.new_string) ?? '' }];
-    }
-    if (name === 'Write') {
-        return [{ path, before: '', after: str(input.content) ?? '' }];
-    }
-    if (name === 'MultiEdit' && Array.isArray(input.edits)) {
-        return input.edits.filter(isRecord).map((edit) => ({ path, before: str(edit.old_string) ?? '', after: str(edit.new_string) ?? '' }));
-    }
+  if (!isRecord(input)) {
     return [];
+  }
+  const path = str(input.file_path) ?? '';
+  if (name === 'Edit') {
+    return [{
+      path,
+      before: str(input.old_string) ?? '',
+      after: str(input.new_string) ?? ''
+    }];
+  }
+  if (name === 'Write') {
+    return [{
+      path,
+      before: '',
+      after: str(input.content) ?? ''
+    }];
+  }
+  if (name === 'MultiEdit' && Array.isArray(input.edits)) {
+    return input.edits.filter(isRecord).map(edit => ({
+      path,
+      before: str(edit.old_string) ?? '',
+      after: str(edit.new_string) ?? ''
+    }));
+  }
+  return [];
 }
 export function isFileChange(name) {
-    return toolEntry(name)?.changesFiles === true;
+  return toolEntry(name)?.changesFiles === true;
 }
 /* The unified diffs a provider put next to a tool call; empty for one that reports before and after. */
 export function unifiedChanges(tool) {
-    return (tool.changes ?? []).filter((change) => change.diff !== '');
+  return (tool.changes ?? []).filter(change => change.diff !== '');
 }
 /* The same, for the copy an approval carries so the person can read what they are approving. */
 export function approvalChanges(input) {
-    const changes = isRecord(input) ? input.changes : null;
-    if (!Array.isArray(changes)) {
-        return [];
-    }
-    return changes.filter((change) => isRecord(change) && typeof change.path === 'string' && typeof change.diff === 'string' && change.diff !== '');
+  const changes = isRecord(input) ? input.changes : null;
+  if (!Array.isArray(changes)) {
+    return [];
+  }
+  return changes.filter(change => isRecord(change) && typeof change.path === 'string' && typeof change.diff === 'string' && change.diff !== '');
 }
 /* Whether a settled call is worth a row in the turn's changed files card. */
 export function hasFileChanges(tool) {
-    return unifiedChanges(tool).length > 0 || fileChanges(tool.name, tool.input).length > 0;
+  return unifiedChanges(tool).length > 0 || fileChanges(tool.name, tool.input).length > 0;
 }
 /* When a running call started: what the CLI reported, or the moment the call appeared. */
 export function toolStartedAt(tool) {
-    return tool.progress?.startedAt ?? tool.createdAt;
+  return tool.progress?.startedAt ?? tool.createdAt;
 }
 // Keep the full buffer so the renderer can carry ANSI state into the visible tail.
 export function liveOutput(tool) {
-    return tool.progress?.output || null;
-}
+  return tool.progress?.output || null;
+}

package/dist/chat/logic/visual-height.js

@@ -11,36 +11,36 @@ const MAX_CONTENT_HEIGHT_PX = 10_000_000;
  */
 const remembered = new Map();
 function keyOf(visualId, width) {
-    return `${visualId}@${Math.round(width)}`;
+  return `${visualId}@${Math.round(width)}`;
 }
 /* A height a page reported, held to the visual's own maximum and the limits, in whole pixels. */
 export function clampVisualHeight(visual, height) {
-    return Math.min(Math.max(Math.ceil(Math.min(height, visual.maxHeight)), VISUAL_LIMITS.minHeight), VISUAL_LIMITS.maxHeight);
+  return Math.min(Math.max(Math.ceil(Math.min(height, visual.maxHeight)), VISUAL_LIMITS.minHeight), VISUAL_LIMITS.maxHeight);
 }
 export function visualContentHeight(height) {
-    return Math.min(MAX_CONTENT_HEIGHT_PX, Math.max(VISUAL_LIMITS.minHeight, Math.ceil(height)));
+  return Math.min(MAX_CONTENT_HEIGHT_PX, Math.max(VISUAL_LIMITS.minHeight, Math.ceil(height)));
 }
 export function initialVisualContentHeight(visual, width) {
-    const cached = remembered.get(keyOf(visual.id, width));
-    if (cached !== undefined) {
-        return cached;
-    }
-    const below = visual.heights?.filter(([measured]) => measured <= width).sort((left, right) => right[0] - left[0])[0];
-    const above = visual.heights?.filter(([measured]) => measured >= width).sort((left, right) => left[0] - right[0])[0];
-    return below || above ? visualContentHeight(Math.max(below?.[1] ?? 0, above?.[1] ?? 0)) : DEFAULT_HEIGHT_PX;
+  const cached = remembered.get(keyOf(visual.id, width));
+  if (cached !== undefined) {
+    return cached;
+  }
+  const below = visual.heights?.filter(([measured]) => measured <= width).sort((left, right) => right[0] - left[0])[0];
+  const above = visual.heights?.filter(([measured]) => measured >= width).sort((left, right) => left[0] - right[0])[0];
+  return below || above ? visualContentHeight(Math.max(below?.[1] ?? 0, above?.[1] ?? 0)) : DEFAULT_HEIGHT_PX;
 }
 /*
  * The height a frame `width` CSS pixels wide starts at: what the page reported in a frame that wide
  * before, else what the host measured, else a modest default.
  */
 export function initialVisualHeight(visual, width) {
-    return remembered.get(keyOf(visual.id, width)) ?? visualFrameHeight(visual, width) ?? clampVisualHeight(visual, DEFAULT_HEIGHT_PX);
+  return remembered.get(keyOf(visual.id, width)) ?? visualFrameHeight(visual, width) ?? clampVisualHeight(visual, DEFAULT_HEIGHT_PX);
 }
 export function rememberVisualHeight(visualId, width, height) {
-    const key = keyOf(visualId, width);
-    remembered.delete(key);
-    remembered.set(key, height);
-    if (remembered.size > REMEMBERED_HEIGHTS) {
-        remembered.delete(remembered.keys().next().value);
-    }
-}
+  const key = keyOf(visualId, width);
+  remembered.delete(key);
+  remembered.set(key, height);
+  if (remembered.size > REMEMBERED_HEIGHTS) {
+    remembered.delete(remembered.keys().next().value);
+  }
+}

package/dist/chat/logic/visual-viewport.js

@@ -1,4 +1,7 @@
 export function visualViewportGeometry(contentHeight, availableHeight, top) {
-    const height = Math.max(1, Math.min(contentHeight, availableHeight));
-    return { height, top: Math.max(0, Math.min(-top, contentHeight - height)) };
-}
+  const height = Math.max(1, Math.min(contentHeight, availableHeight));
+  return {
+    height,
+    top: Math.max(0, Math.min(-top, contentHeight - height))
+  };
+}

package/dist/chat/logic/welcome.js

@@ -1,10 +1,10 @@
 export function dayPartOf(now) {
-    const hour = now.getHours();
-    if (hour < 5) {
-        return 'night';
-    }
-    if (hour < 12) {
-        return 'morning';
-    }
-    return hour < 18 ? 'afternoon' : 'evening';
-}
+  const hour = now.getHours();
+  if (hour < 5) {
+    return 'night';
+  }
+  if (hour < 12) {
+    return 'morning';
+  }
+  return hour < 18 ? 'afternoon' : 'evening';
+}

package/dist/chat/logic/workflow.d.ts

@@ -12,3 +12,13 @@ export interface WorkflowPhaseView {
 export declare function workflowAgentState(agent: ChatWorkflowAgent, workflowRunning: boolean): WorkflowAgentState;
 export declare function workflowPhases(workflow: ChatWorkflow, workflowRunning: boolean): WorkflowPhaseView[];
 export declare function workflowAgentTime(view: WorkflowAgentView): string | null;
+export interface WorkflowAgentPreview {
+    tool: string | null;
+    text: string | null;
+}
+export declare function workflowAgentPreview(view: WorkflowAgentView): WorkflowAgentPreview;
+export type WorkflowCounts = Record<WorkflowAgentState, number> & {
+    total: number;
+};
+export declare function workflowCounts(phases: WorkflowPhaseView[]): WorkflowCounts;
+export declare function workflowDescription(input: unknown): string | null;

package/dist/chat/logic/workflow.js

@@ -1,47 +1,145 @@
 import i18next from 'i18next';
 import { formatElapsedShort } from '@adecore/ui/format';
 export function workflowAgentState(agent, workflowRunning) {
-    if (agent.status !== 'running') {
-        return agent.status;
-    }
-    if (!workflowRunning) {
-        return 'stopped';
-    }
-    return agent.startedAt === null ? 'waiting' : 'running';
+  if (agent.status !== 'running') {
+    return agent.status;
+  }
+  if (!workflowRunning) {
+    return 'stopped';
+  }
+  return agent.startedAt === null ? 'waiting' : 'running';
 }
 /*
  * The phases in the order the script announced them, each with the agents it started in it. A phase
  * announced ahead of its agents is there without any, and agents of no known phase come first, untitled.
  */
 export function workflowPhases(workflow, workflowRunning) {
-    const known = new Map(workflow.phases.map((phase) => [phase.index, phase]));
-    const loose = [];
-    const byPhase = new Map();
-    for (const agent of workflow.agents) {
-        const view = { agent, state: workflowAgentState(agent, workflowRunning) };
-        if (agent.phaseIndex === null || !known.has(agent.phaseIndex)) {
-            loose.push(view);
-            continue;
-        }
-        byPhase.set(agent.phaseIndex, [...(byPhase.get(agent.phaseIndex) ?? []), view]);
+  const known = new Map(workflow.phases.map(phase => [phase.index, phase]));
+  const loose = [];
+  const byPhase = new Map();
+  for (const agent of workflow.agents) {
+    const view = {
+      agent,
+      state: workflowAgentState(agent, workflowRunning)
+    };
+    if (agent.phaseIndex === null || !known.has(agent.phaseIndex)) {
+      loose.push(view);
+      continue;
     }
-    const phases = workflow.phases.map((phase) => ({ key: `phase-${phase.index}`, title: phase.title, agents: byPhase.get(phase.index) ?? [] }));
-    return loose.length > 0 ? [{ key: 'loose', title: null, agents: loose }, ...phases] : phases;
+    byPhase.set(agent.phaseIndex, [...(byPhase.get(agent.phaseIndex) ?? []), view]);
+  }
+  const phases = workflow.phases.map(phase => ({
+    key: `phase-${phase.index}`,
+    title: phase.title,
+    agents: byPhase.get(phase.index) ?? []
+  }));
+  return loose.length > 0 ? [{
+    key: 'loose',
+    title: null,
+    agents: loose
+  }, ...phases] : phases;
 }
 /* What the line of an agent that is not at work says about its time; one at work counts on by itself. */
 export function workflowAgentTime(view) {
-    const duration = view.agent.durationMs === null ? null : formatElapsedShort(view.agent.durationMs);
-    switch (view.state) {
-        case 'running':
-            return null;
-        case 'waiting':
-            return i18next.t('agent-chat:rows.workflow.waiting');
-        case 'stopped':
-            return i18next.t('agent-chat:rows.workflow.stopped');
-        case 'done':
-        case 'failed':
-            return duration === null
-                ? i18next.t(`agent-chat:common.status.${view.state}`)
-                : i18next.t(`agent-chat:rows.subagent.${view.state}In`, { duration });
+  switch (view.state) {
+    case 'running':
+      return null;
+    case 'waiting':
+      return i18next.t('agent-chat:rows.workflow.waiting');
+    case 'stopped':
+      return i18next.t('agent-chat:rows.workflow.stopped');
+    case 'done':
+    case 'failed':
+      return view.agent.durationMs === null ? null : formatElapsedShort(view.agent.durationMs);
+  }
+}
+/* The CLI's previews start with a markdown heading as often as not, which says nothing on one line. */
+function firstLine(text) {
+  const line = text?.split('\n').map(part => part.replace(/^#+\s*/, '').trim()).find(part => part !== '');
+  return line === undefined ? null : line;
+}
+/* The second line of an agent: what it does while at work, what it answered once it stopped, what it was asked before. */
+export function workflowAgentPreview(view) {
+  const {
+    agent
+  } = view;
+  switch (view.state) {
+    case 'running':
+      return agent.lastTool === null ? {
+        tool: null,
+        text: firstLine(agent.promptPreview)
+      } : {
+        tool: agent.lastTool,
+        text: firstLine(agent.lastToolSummary)
+      };
+    case 'waiting':
+      return {
+        tool: null,
+        text: firstLine(agent.promptPreview)
+      };
+    case 'failed':
+      return {
+        tool: null,
+        text: firstLine(agent.error) ?? firstLine(agent.resultPreview)
+      };
+    case 'done':
+    case 'stopped':
+      return {
+        tool: null,
+        text: firstLine(agent.resultPreview) ?? firstLine(agent.promptPreview)
+      };
+  }
+}
+export function workflowCounts(phases) {
+  const counts = {
+    total: 0,
+    running: 0,
+    waiting: 0,
+    stopped: 0,
+    done: 0,
+    failed: 0
+  };
+  for (const view of phases.flatMap(phase => phase.agents)) {
+    counts.total += 1;
+    counts[view.state] += 1;
+  }
+  return counts;
+}
+const META_START = /export\s+const\s+meta\s*=\s*\{/;
+const DESCRIPTION = /\bdescription\s*:\s*(['"`])((?:\\.|(?!\1)[^\\])*)\1/;
+/* The literal from its opening brace to the one that closes it, skipping braces inside strings. */
+function metaLiteral(script) {
+  const start = META_START.exec(script);
+  if (start === null) {
+    return null;
+  }
+  const from = start.index + start[0].length - 1;
+  let depth = 0;
+  let quote = null;
+  for (let i = from; i < script.length; i++) {
+    const char = script[i];
+    if (quote !== null) {
+      if (char === '\\') {
+        i++;
+      } else if (char === quote) {
+        quote = null;
+      }
+      continue;
+    }
+    if (char === "'" || char === '"' || char === '`') {
+      quote = char;
+    } else if (char === '{') {
+      depth++;
+    } else if (char === '}' && --depth === 0) {
+      return script.slice(from, i + 1);
     }
+  }
+  return null;
 }
+/* The script's `meta` is a pure literal by the CLI's own rule, so its description reads without running anything. A saved workflow called by name has no script here. */
+export function workflowDescription(input) {
+  const script = typeof input === 'object' && input !== null && 'script' in input ? input.script : undefined;
+  const meta = typeof script === 'string' ? metaLiteral(script) : null;
+  const found = meta === null ? undefined : DESCRIPTION.exec(meta)?.[2]?.replace(/\\(.)/g, '$1').trim();
+  return found ? found : null;
+}