ghostykit 0.6.3 → 0.7.0

package/README.md

@@ -97,34 +97,109 @@ const ref = useRef<PilotoHandle>(null);
   draft={{ text: "Why did the monitor fail?", key: row.id }} // prefilled + focused, not sent
   threadId={conversationId}                                   // reopen a stored thread
   context={() => ({ screen: "crons", selected })}            // AG-UI `context`, every run
-  toolVerbs={{ run_cron: { one: "Ran a cron", many: "Ran %n crons", running: "Running the cron…" } }}
-  upload={async (file) => ({ url: await myUpload(file) })}
-  transcribe={async (audio) => myWhisper(audio)}
   onTurnDone={({ text }) => refreshMyData()}
-  slots={{ renderDeliveries: (turn) => <MyFiles turn={turn} />, composerExtras: <MyButton /> }}
+  plugins={PLUGINS}                                           // everything else: see Customize
 />;
 
 ref.current?.addReference({ id: "12", label: "#12 Rosa" }); // "@" a row into the message
 ref.current?.send("Why did this fail?");                     // ask on the user's behalf
 ```
 
-Other options: `strings`, `toolIcons`, `formatUserText`, `markdown`, `features`
-(`attachments`, `retry`, `copy`, `usage`, `replyOptions`, `duration`, `steer`), `references` /
-`onReferencesChange`, `voiceNoteText`, `placeholder`, `avatar`, `initialTurns`, `loadOlder` (earlier
-pages of a long thread), `forwardedProps` (extra keys for every run, e.g. `{permissions: "ask"}`), the
-slots `sidePanel` and `aboveComposer` (both may take the `pilot`), and the callbacks `onTurnStart`,
-`onTitle`, `onState`, `onEvent` (every raw AG-UI event), `onSend`. The agent's shared state
-(`STATE_SNAPSHOT` + `STATE_DELTA`) is `pilot.state.agentState`, and each turn's `CUSTOM` events are
-`turn.custom` (what `renderDeliveries` draws).
+Other props: `features` (`attachments`, `retry`, `copy`, `usage`, `replyOptions`, `duration`,
+`steer`), `references` / `onReferencesChange`, `placeholder`, `avatar`, `initialTurns`, `loadOlder`
+(earlier pages of a long thread), `forwardedProps` (extra keys for every run, e.g.
+`{permissions: "ask"}`), and the callbacks `onTurnStart`, `onTitle`, `onState`, `onEvent` (every raw
+AG-UI event), `onSend`. The agent's shared state (`STATE_SNAPSHOT` + `STATE_DELTA`) is
+`pilot.state.agentState`, and each turn's `CUSTOM` events are `turn.custom`.
 
 Subagents (`state.subagents.tasks`) are `pilot.subagents`; `pilot.stopSubagent(id)` stops one, and
-`<Subagents pilot={pilot} />` is a ready-made bar ("2 agents working", one row each, *Stop*):
-`slots={{ aboveComposer: (pilot) => <Subagents pilot={pilot} /> }}`. A message the server can't take
-while a run is live (`409 run_active`) waits in `pilot.state.queued` and is sent when that run ends.
-`pilot.refresh()` asks for the thread again (when your own event bus says something changed). To read the state outside the chat, call `usePilot(transport)` yourself
-and pass the result as `pilot`. Every piece is
-exported (`AgentBubble`, `AgentSteps`, `Composer`, `ConfirmCard`, `Markdown`, …) if you want to build
-your own layout.
+`<Subagents pilot={pilot} />` is a ready-made bar ("2 agents working", one row each, *Stop*). A
+message the server can't take while a run is live (`409 run_active`) waits in `pilot.state.queued`
+and is sent when that run ends. `pilot.refresh()` asks for the thread again (when your own event bus
+says something changed). To read the state outside the chat, call `usePilot(transport)` yourself and
+pass the result as `pilot`. Every piece is exported (`AgentBubble`, `AgentSteps`, `Composer`,
+`ConfirmCard`, `Markdown`, …) if you want to build your own layout.
+
+## Customize
+
+There is **one** way to customize `<Piloto>`: **plugins**. A plugin is an object with a `name` and
+named extension points. Everything a plugin draws is a React **component**: it is mounted as
+`<View ctx={…} />`, so it can use hooks. Branding is the skin plus `--piloto-*` tokens.
+
+```tsx
+import { Piloto, definePlugin } from "ghostykit";
+import { livePage, modelPicker, pilotDevtools } from "ghostykit/plugins";
+
+const crm = definePlugin({
+  name: "crm",
+  requires: { events: ["crm.card"] },                       // what it handles, visible at a glance
+  tools: { verbs: { find_lead: { one: "Found the lead", many: "Found %n leads", running: "Looking…" } } },
+  message: { custom: { "crm.card": ({ entry, ctx }) => <LeadCard lead={entry.value} onOpen={() => ctx.send("Open it")} /> } },
+  composer: { actions: ({ ctx }) => <PointButton onPick={(row) => ctx.addReference(row)} /> },
+});
+
+// Create them ONCE (module scope or useMemo): some plugins keep state.
+const PLUGINS = [crm, modelPicker({ onChange: (model) => api.setModel(model) }), livePage(), pilotDevtools()];
+
+<Piloto transport={transport} skin="ghosty" plugins={PLUGINS} />;
+```
+
+| Point | What it does | Example |
+|---|---|---|
+| `name` | Unique. Marks everything it draws with `data-plugin="<name>"`. | `"crm"` |
+| `styles` | Whose styles its views use. `"host"` (default): your app's; ghostykit's utilities stay out (`data-piloto-isolate`), so they never override your classes. `"ghostykit"`: for views built from ghostykit components (`<Subagents>`, `ModelPicker`). | `"ghostykit"` |
+| `requires` | `{events, state}` it handles. Derived from `events`/`state`/`message.custom` if missing; in development a mismatch is a warning. | `{ events: ["ghosty.page"] }` |
+| `strings` | Texts over the locale's. | `{ stop: "Para" }` |
+| `markdown.transform` | Rewrites the answer's markdown, with the turn at hand (chained). | `(md, turn) => md.replace(/#(\d+)/g, "[#$1](#folio-$1)")` |
+| `markdown.onLinkClick` | A click on a link; `true` if handled (asked in order). | open in-app |
+| `markdown.blocks` | Fenced blocks by name (```` ```eb-file ````) taken out of the text and drawn as cards under the answer; one still being written comes with `complete: false`. | `{ "eb-file": FileCard }` |
+| `vars`, `className` | Branding on the root: `--piloto-*` tokens and classes. | `{ "--piloto-radius-bubble": "6px" }` |
+| `tools.verbs` | How each tool is named in the steps. | `{ run_cron: { one, many, running } }` |
+| `tools.icons` | Icon by tool name or `kind`. | `{ run_cron: Clock }` |
+| `tools.render` | A tool's own view, under the steps, by tool name or `kind`. | `{ create_image: ImagePreview }` |
+| `events` | Handlers by AG-UI type, by `CUSTOM` name, or `*`. | `{ "ghosty.ui": (e, ctx) => board.open(e.value) }` |
+| `state` | Called when that key of `agentState` changes. | `{ model: (v, ctx) => … }` |
+| `message.custom` | Draws a `turn.custom` entry by its name (deliveries, CRM cards). | `{ "ghosty.delivery": DeliveryCard }` |
+| `message.assistantBefore` | Before each answer's text, under its steps. | live page progress, "Creating image…" |
+| `message.user` / `message.assistant` | Extras under each user message / answer. | `({ turn, live }) => …` |
+| `message.formatUserText` | How the user's text is shown (chained). | strip app plumbing |
+| `composer.actions` | Buttons in the composer bar, between the image button and the clip. | "My files", "Point" |
+| `composer.actionsEnd` | Buttons after the clip. | model picker |
+| `composer.above` | Above the message box. | `<Subagents pilot={ctx.pilot} />` |
+| `composer.below` | Under the message box. | suggestion chips |
+| `composer.attachments` | `upload`, `transcribe`, `voiceNoteText`. | `{ upload: async (f) => ({ url }) }` |
+| `header` | Top right, over the thread. | share button |
+| `sidePanel` | Next to the chat. | live page, subagents |
+| `aboveThread` | Above the messages. | a banner |
+| `empty` | The empty thread (instead of the greeting). | onboarding |
+| `waiting` | While the agent hasn't answered (instead of the waiting phrase). Gets `step`, `since`. | "Creating your image…" |
+| `wrap` | A provider around the whole chat (`{ctx, children}`); the first plugin is outermost. | artifacts panel |
+| `onTurnStart` / `onTurnDone` | This client started / finished a turn. | open the last delivery |
+
+Every view gets `ctx`: `{pilot, agentState, strings, send, addReference, addAttachments, setDraft, focus, plugins}`.
+`addAttachments` takes `File`s (they go through `upload`) or ready `Attachment`s (e.g. from "My files"),
+and they can be sent without text. The `ref` of `<Piloto>` is the same handle (without `plugins`,
+`strings`, `agentState`), so the app never needs a separate `usePilot`: `ref.current.addReference(…)`,
+`ref.current.pilot.reconnect()` (when your own event bus says the thread changed),
+`ref.current.pilot.stop()`. `initialPrompt` sends a message as soon as the thread is open (a question
+in the URL).
+
+**Order and precedence**, in the order of the `plugins` list:
+
+- **Maps** (`strings`, `tools.verbs`, `tools.icons`, `vars`) are merged, and later plugins win. `markdown` and `formatUserText` are chained.
+- **`events` and `state`** call every handler, in order.
+- **Keyed or single views** (`tools.render`, `message.custom`, `markdown.blocks`, `empty`, `waiting`, `composer.attachments`): the first plugin that declares one wins. A clash is a development warning.
+- **Lists** (`header`, `sidePanel`, `aboveThread`, `composer.actions`/`actionsEnd`/`above`/`below`, `message.user`/`assistant`/`assistantBefore`, `wrap`, `onTurnStart`/`onTurnDone`) all apply, in order.
+
+In development, ghostykit also warns once about a `CUSTOM` event that nothing handles.
+
+**Ready-made plugins** (`ghostykit/plugins`), usable as they are and as templates:
+
+| Plugin | What it does |
+|---|---|
+| `modelPicker({ onChange, stateKey? })` | The model picker in the composer bar, from `agentState.model = {current, options}`. Switching is your API (`onChange`). |
+| `livePage({ width? })` | A side panel that follows `CUSTOM ghosty.page` (plan, sections, ready, error) with the link at the end. |
+| `pilotDevtools({ events? })` | Prints the mounted plugins, their points and what they handle; with `events: true`, every event and who handles it. |
 
 ### Skins and theming
 

package/dist/chunks/{chunk-LFFJLMDO.js → chunk-FWBUIGTC.js}

@@ -193,7 +193,7 @@ function toolLabel(t, v) {
   if (str(x.title)) patch.label = str(x.title);
   if (str(x.kind)) patch.kind = str(x.kind);
   if (str(x.path)) patch.path = str(x.path);
-  if (str(x.detail)) patch.detail = str(x.detail);
+  if (str(x.detail)) Object.assign(patch, { detail: str(x.detail), detailFromServer: true });
   t.tools = (t.tools ?? []).map((y) => y.id === x.toolCallId ? { ...y, ...patch } : y);
 }
 function applyStoredCustom(t, m) {
@@ -259,7 +259,8 @@ function applySnapshot(s, messages) {
     const tools = t.tools?.map((x) => {
       const prev = o?.role === t.role ? o.tools?.find((y) => y.id === x.id) : void 0;
       const status = x.status === "pending" && (prev?.status ?? (live ? "in_progress" : void 0));
-      return { ...prev, ...x, ...status ? { status } : {} };
+      const keepDetail = prev?.detailFromServer && !x.detailFromServer ? { detail: prev.detail, detailFromServer: true } : {};
+      return { ...prev, ...x, ...status ? { status } : {}, ...keepDetail };
     });
     const base = tools ? { ...t, tools } : t;
     if (!o || o.role !== t.role) return base;
@@ -325,6 +326,7 @@ function reduceAgUiEvent(prev, e, now = Date.now()) {
     }
     case "TOOL_CALL_END": {
       const known = s.turns[s.turns.length - 1]?.tools?.find((x) => x.id === e.toolCallId);
+      if (known?.detailFromServer) return s;
       return upsertTool(s, e.toolCallId, { detail: argsDetail(known?.args) });
     }
     case "TOOL_CALL_RESULT": {
@@ -369,7 +371,7 @@ function reduceAgUiEvent(prev, e, now = Date.now()) {
         if (str(v.title)) patch.label = str(v.title);
         if (str(v.kind)) patch.kind = str(v.kind);
         if (str(v.path)) patch.path = str(v.path);
-        if (str(v.detail)) patch.detail = str(v.detail);
+        if (str(v.detail)) Object.assign(patch, { detail: str(v.detail), detailFromServer: true });
         return upsertTool(s, v.toolCallId, patch);
       }
       if (e.name === "ghosty.replace") {
@@ -538,7 +540,7 @@ function isNarration(chunk) {
   const t = chunk.trim();
   return t.length > 0 && t.length <= 300 && !/\n\s*\n/.test(t) && !t.includes("```");
 }
-function splitNarration(text, cuts) {
+function splitNarration(text, cuts, closed = false) {
   if (cuts?.length) {
     const valid = cuts.filter((c) => c > 0 && c <= text.length);
     if (valid.length) {
@@ -550,7 +552,9 @@ function splitNarration(text, cuts) {
         from = c;
       }
       if (chunks.every(isNarration)) {
-        return { steps: chunks.map((t) => t.replace(/\s*\n\s*/g, " ")), rest: text.slice(from).replace(/^\s+/, "") };
+        const rest = text.slice(from).replace(/^\s+/, "");
+        if (closed && !rest.trim()) return { steps: chunks.slice(0, -1).map((t) => t.replace(/\s*\n\s*/g, " ")), rest: chunks[chunks.length - 1] };
+        return { steps: chunks.map((t) => t.replace(/\s*\n\s*/g, " ")), rest };
       }
     }
     return { steps: [], rest: text };
@@ -574,6 +578,30 @@ function narrationToMarkdown(chunks, answer) {
 
 ${answer.trim()}` : list;
 }
+function extractBlocks(text, langs, cuts) {
+  if (!langs.length || !text.includes("```")) return { text, cuts, blocks: [] };
+  const want = new Set(langs);
+  const blocks = [];
+  const removed = [];
+  const re = /(^|\n)```([\w.-]+)[^\n]*\n([\s\S]*?)(\n```[ \t]*(?=\n|$)|$)/g;
+  for (let m = re.exec(text); m; m = re.exec(text)) {
+    if (!want.has(m[2])) continue;
+    const start = m.index + m[1].length;
+    const end = m.index + m[0].length;
+    blocks.push({ lang: m[2], body: m[3], complete: Boolean(m[4]) });
+    removed.push([start, end]);
+  }
+  if (!removed.length) return { text, cuts, blocks };
+  let out = "";
+  let from = 0;
+  for (const [a, b] of removed) {
+    out += text.slice(from, a);
+    from = b;
+  }
+  out += text.slice(from);
+  const shift = (c) => c - removed.reduce((n, [a, b]) => n + (c >= b ? b - a : c > a ? c - a : 0), 0);
+  return { text: out, ...cuts ? { cuts: cuts.map(shift) } : {}, blocks };
+}
 
 // src/core/options.ts
 var BULLET = /^\s*(?:[-*•+]|(\d{1,2})[.)])\s+(.+?)\s*$/;
@@ -604,140 +632,6 @@ function cleanReplyOption(t) {
   return s.charAt(0).toLocaleUpperCase() + s.slice(1);
 }
 
-// src/core/steps.ts
-var isRunning = (t) => t.status !== "completed" && t.status !== "failed" && t.status !== "cancelled";
-function toolNames(t) {
-  const title = t.title ?? "";
-  if (!title) return [];
-  const out = [title];
-  const double = /^mcp__.+?__(.+)$/i.exec(title);
-  if (double) out.push(double[1]);
-  else if (/^mcp_/i.test(title)) {
-    const parts = title.slice(4).split("_");
-    for (let i = 0; i < parts.length; i++) out.push(parts.slice(i).join("_"));
-  }
-  return [...new Set(out)];
-}
-function toolName(t) {
-  const names = toolNames(t);
-  return /^mcp__/i.test(names[0] ?? "") ? names[1] ?? names[0] : names[0] ?? null;
-}
-function namedVerb(t, verbs) {
-  for (const name of toolNames(t)) if (verbs[name]) return { key: name, verb: verbs[name] };
-  return null;
-}
-function stepLabel(t, verbs, fallback = "Paso") {
-  if (t.label) return t.label;
-  const named = namedVerb(t, verbs);
-  if (named) return isRunning(t) && named.verb.running ? named.verb.running : named.verb.one;
-  return t.title ?? t.kind ?? fallback;
-}
-function summarizeTools(tools, verbs) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const t of tools) {
-    const named = namedVerb(t, verbs);
-    const key = named?.key ?? t.kind ?? "other";
-    const g = groups.get(key) ?? { n: 0, verb: named?.verb ?? verbs[key] };
-    g.n++;
-    groups.set(key, g);
-  }
-  const parts = [];
-  for (const [key, { n, verb }] of groups) {
-    if (verb) parts.push(n === 1 ? verb.one : verb.many.replace("%n", String(n)));
-    else parts.push(`${n} \xD7 ${key.replace(/[_-]/g, " ")}`);
-  }
-  return parts.join(" \xB7 ");
-}
-function groupSteps(tools, label) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const t of tools) {
-    const k = `${label(t)}\0${t.detail ?? ""}`;
-    const g = groups.get(k);
-    if (!g) {
-      groups.set(k, { tool: t, times: 1 });
-      continue;
-    }
-    g.times++;
-    const wins = isRunning(t) || t.status === "failed" || !(isRunning(g.tool) || g.tool.status === "failed");
-    if (wins) g.tool = { ...t, id: g.tool.id };
-  }
-  return [...groups.values()];
-}
-var TOOL_VERBS_ES = {
-  read: { one: "Le\xED un archivo", many: "Le\xED %n archivos" },
-  read_file: { one: "Le\xED un archivo", many: "Le\xED %n archivos" },
-  write: { one: "Escrib\xED un archivo", many: "Escrib\xED %n archivos" },
-  write_file: { one: "Escrib\xED un archivo", many: "Escrib\xED %n archivos" },
-  edit: { one: "Edit\xE9 un archivo", many: "Edit\xE9 %n archivos" },
-  edit_file: { one: "Edit\xE9 un archivo", many: "Edit\xE9 %n archivos" },
-  bash: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
-  shell: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
-  terminal: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
-  execute: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
-  grep: { one: "Busqu\xE9 en el c\xF3digo", many: "Busqu\xE9 en el c\xF3digo" },
-  glob: { one: "Busqu\xE9 archivos", many: "Busqu\xE9 archivos" },
-  search: { one: "Busqu\xE9", many: "Busqu\xE9 %n veces" },
-  tool_search: { one: "Busqu\xE9 una herramienta", many: "Busqu\xE9 %n herramientas" },
-  web_search: { one: "Busqu\xE9 en la web", many: "Busqu\xE9 en la web" },
-  web_fetch: { one: "Abr\xED una p\xE1gina", many: "Abr\xED %n p\xE1ginas" },
-  fetch: { one: "Abr\xED una p\xE1gina", many: "Abr\xED %n p\xE1ginas" },
-  site_publish: { one: "Publiqu\xE9 una p\xE1gina", many: "Publiqu\xE9 %n p\xE1ginas" },
-  pdf: { one: "Gener\xE9 un PDF", many: "Gener\xE9 %n PDF" },
-  connector: { one: "Us\xE9 tu sistema", many: "Us\xE9 tu sistema %n veces" },
-  mcp: { one: "Us\xE9 una herramienta", many: "Us\xE9 %n herramientas" },
-  browser: { one: "Us\xE9 el navegador", many: "Us\xE9 el navegador" },
-  todo: { one: "Anot\xE9 el plan", many: "Anot\xE9 el plan" },
-  delete: { one: "Borr\xE9 un archivo", many: "Borr\xE9 %n archivos" },
-  move: { one: "Mov\xED un archivo", many: "Mov\xED %n archivos" },
-  think: { one: "Lo pens\xE9", many: "Lo pens\xE9" },
-  image: { one: "Cre\xE9 una imagen", many: "Cre\xE9 %n im\xE1genes" },
-  delegate: { one: "Delegu\xE9 una tarea", many: "Delegu\xE9 %n tareas" },
-  collect: { one: "Recog\xED un resultado", many: "Recog\xED %n resultados" },
-  status: { one: "Pregunt\xE9 c\xF3mo iba", many: "Pregunt\xE9 %n veces c\xF3mo iba" },
-  stop: { one: "Detuve una tarea", many: "Detuve %n tareas" },
-  guide: { one: "Le\xED una gu\xEDa", many: "Le\xED %n gu\xEDas" },
-  deliver: { one: "Entregu\xE9 un archivo", many: "Entregu\xE9 %n archivos" },
-  sheet: { one: "Consult\xE9 una hoja", many: "Consult\xE9 %n hojas" },
-  view: { one: "Arm\xE9 una vista", many: "Arm\xE9 %n vistas" }
-};
-var TOOL_VERBS_EN = {
-  read: { one: "Read a file", many: "Read %n files" },
-  read_file: { one: "Read a file", many: "Read %n files" },
-  write: { one: "Wrote a file", many: "Wrote %n files" },
-  write_file: { one: "Wrote a file", many: "Wrote %n files" },
-  edit: { one: "Edited a file", many: "Edited %n files" },
-  edit_file: { one: "Edited a file", many: "Edited %n files" },
-  bash: { one: "Ran a command", many: "Ran %n commands" },
-  shell: { one: "Ran a command", many: "Ran %n commands" },
-  terminal: { one: "Ran a command", many: "Ran %n commands" },
-  execute: { one: "Ran a command", many: "Ran %n commands" },
-  grep: { one: "Searched the code", many: "Searched the code" },
-  glob: { one: "Searched for files", many: "Searched for files" },
-  search: { one: "Searched", many: "Searched %n times" },
-  tool_search: { one: "Looked for a tool", many: "Looked for %n tools" },
-  web_search: { one: "Searched the web", many: "Searched the web" },
-  web_fetch: { one: "Opened a page", many: "Opened %n pages" },
-  fetch: { one: "Opened a page", many: "Opened %n pages" },
-  site_publish: { one: "Published a page", many: "Published %n pages" },
-  pdf: { one: "Generated a PDF", many: "Generated %n PDFs" },
-  connector: { one: "Used your system", many: "Used your system %n times" },
-  mcp: { one: "Used a tool", many: "Used %n tools" },
-  browser: { one: "Used the browser", many: "Used the browser" },
-  todo: { one: "Wrote down the plan", many: "Wrote down the plan" },
-  delete: { one: "Deleted a file", many: "Deleted %n files" },
-  move: { one: "Moved a file", many: "Moved %n files" },
-  think: { one: "Thought it through", many: "Thought it through" },
-  image: { one: "Created an image", many: "Created %n images" },
-  delegate: { one: "Delegated a task", many: "Delegated %n tasks" },
-  collect: { one: "Collected a result", many: "Collected %n results" },
-  status: { one: "Checked how it was going", many: "Checked %n times how it was going" },
-  stop: { one: "Stopped a task", many: "Stopped %n tasks" },
-  guide: { one: "Read a guide", many: "Read %n guides" },
-  deliver: { one: "Delivered a file", many: "Delivered %n files" },
-  sheet: { one: "Checked a sheet", many: "Checked %n sheets" },
-  view: { one: "Built a view", many: "Built %n views" }
-};
-
 export {
   applyJsonPatch,
   createPilotState,
@@ -761,14 +655,7 @@ export {
   isNarration,
   splitNarration,
   narrationToMarkdown,
+  extractBlocks,
   extractReplyOptions,
-  cleanReplyOption,
-  isRunning,
-  toolNames,
-  toolName,
-  stepLabel,
-  summarizeTools,
-  groupSteps,
-  TOOL_VERBS_ES,
-  TOOL_VERBS_EN
+  cleanReplyOption
 };

package/dist/chunks/chunk-UUH37KXA.js

@@ -0,0 +1,144 @@
+// src/core/steps.ts
+var isRunning = (t) => t.status !== "completed" && t.status !== "failed" && t.status !== "cancelled";
+function toolNames(t) {
+  const title = t.title ?? "";
+  if (!title) return [];
+  const out = [title];
+  const double = /^mcp__.+?__(.+)$/i.exec(title);
+  if (double) out.push(double[1]);
+  else if (/^mcp_/i.test(title)) {
+    const parts = title.slice(4).split("_");
+    for (let i = 0; i < parts.length; i++) out.push(parts.slice(i).join("_"));
+  }
+  return [...new Set(out)];
+}
+function toolName(t) {
+  const names = toolNames(t);
+  return /^mcp__/i.test(names[0] ?? "") ? names[1] ?? names[0] : names[0] ?? null;
+}
+function namedVerb(t, verbs) {
+  for (const name of toolNames(t)) if (verbs[name]) return { key: name, verb: verbs[name] };
+  return null;
+}
+function stepLabel(t, verbs, fallback = "Paso") {
+  if (t.label) return t.label;
+  const named = namedVerb(t, verbs);
+  if (named) return isRunning(t) && named.verb.running ? named.verb.running : named.verb.one;
+  return t.title ?? t.kind ?? fallback;
+}
+function summarizeTools(tools, verbs) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const t of tools) {
+    const named = namedVerb(t, verbs);
+    const key = named?.key ?? t.kind ?? "other";
+    const g = groups.get(key) ?? { n: 0, verb: named?.verb ?? verbs[key] };
+    g.n++;
+    groups.set(key, g);
+  }
+  const parts = [];
+  for (const [key, { n, verb }] of groups) {
+    if (verb) parts.push(n === 1 ? verb.one : verb.many.replace("%n", String(n)));
+    else parts.push(`${n} \xD7 ${key.replace(/[_-]/g, " ")}`);
+  }
+  return parts.join(" \xB7 ");
+}
+function groupSteps(tools, label) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const t of tools) {
+    const k = `${label(t)}\0${t.detail ?? ""}`;
+    const g = groups.get(k);
+    if (!g) {
+      groups.set(k, { tool: t, times: 1 });
+      continue;
+    }
+    g.times++;
+    const wins = isRunning(t) || t.status === "failed" || !(isRunning(g.tool) || g.tool.status === "failed");
+    if (wins) g.tool = { ...t, id: g.tool.id };
+  }
+  return [...groups.values()];
+}
+var TOOL_VERBS_ES = {
+  read: { one: "Le\xED un archivo", many: "Le\xED %n archivos" },
+  read_file: { one: "Le\xED un archivo", many: "Le\xED %n archivos" },
+  write: { one: "Escrib\xED un archivo", many: "Escrib\xED %n archivos" },
+  write_file: { one: "Escrib\xED un archivo", many: "Escrib\xED %n archivos" },
+  edit: { one: "Edit\xE9 un archivo", many: "Edit\xE9 %n archivos" },
+  edit_file: { one: "Edit\xE9 un archivo", many: "Edit\xE9 %n archivos" },
+  bash: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
+  shell: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
+  terminal: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
+  execute: { one: "Corr\xED un comando", many: "Corr\xED %n comandos" },
+  grep: { one: "Busqu\xE9 en el c\xF3digo", many: "Busqu\xE9 en el c\xF3digo" },
+  glob: { one: "Busqu\xE9 archivos", many: "Busqu\xE9 archivos" },
+  search: { one: "Busqu\xE9", many: "Busqu\xE9 %n veces" },
+  tool_search: { one: "Busqu\xE9 una herramienta", many: "Busqu\xE9 %n herramientas" },
+  web_search: { one: "Busqu\xE9 en la web", many: "Busqu\xE9 en la web" },
+  web_fetch: { one: "Abr\xED una p\xE1gina", many: "Abr\xED %n p\xE1ginas" },
+  fetch: { one: "Abr\xED una p\xE1gina", many: "Abr\xED %n p\xE1ginas" },
+  site_publish: { one: "Publiqu\xE9 una p\xE1gina", many: "Publiqu\xE9 %n p\xE1ginas" },
+  pdf: { one: "Gener\xE9 un PDF", many: "Gener\xE9 %n PDF" },
+  connector: { one: "Us\xE9 tu sistema", many: "Us\xE9 tu sistema %n veces" },
+  mcp: { one: "Us\xE9 una herramienta", many: "Us\xE9 %n herramientas" },
+  browser: { one: "Us\xE9 el navegador", many: "Us\xE9 el navegador" },
+  todo: { one: "Anot\xE9 el plan", many: "Anot\xE9 el plan" },
+  delete: { one: "Borr\xE9 un archivo", many: "Borr\xE9 %n archivos" },
+  move: { one: "Mov\xED un archivo", many: "Mov\xED %n archivos" },
+  think: { one: "Lo pens\xE9", many: "Lo pens\xE9" },
+  image: { one: "Cre\xE9 una imagen", many: "Cre\xE9 %n im\xE1genes" },
+  delegate: { one: "Delegu\xE9 una tarea", many: "Delegu\xE9 %n tareas" },
+  collect: { one: "Recog\xED un resultado", many: "Recog\xED %n resultados" },
+  status: { one: "Pregunt\xE9 c\xF3mo iba", many: "Pregunt\xE9 %n veces c\xF3mo iba" },
+  stop: { one: "Detuve una tarea", many: "Detuve %n tareas" },
+  guide: { one: "Le\xED una gu\xEDa", many: "Le\xED %n gu\xEDas" },
+  deliver: { one: "Entregu\xE9 un archivo", many: "Entregu\xE9 %n archivos" },
+  sheet: { one: "Consult\xE9 una hoja", many: "Consult\xE9 %n hojas" },
+  view: { one: "Arm\xE9 una vista", many: "Arm\xE9 %n vistas" }
+};
+var TOOL_VERBS_EN = {
+  read: { one: "Read a file", many: "Read %n files" },
+  read_file: { one: "Read a file", many: "Read %n files" },
+  write: { one: "Wrote a file", many: "Wrote %n files" },
+  write_file: { one: "Wrote a file", many: "Wrote %n files" },
+  edit: { one: "Edited a file", many: "Edited %n files" },
+  edit_file: { one: "Edited a file", many: "Edited %n files" },
+  bash: { one: "Ran a command", many: "Ran %n commands" },
+  shell: { one: "Ran a command", many: "Ran %n commands" },
+  terminal: { one: "Ran a command", many: "Ran %n commands" },
+  execute: { one: "Ran a command", many: "Ran %n commands" },
+  grep: { one: "Searched the code", many: "Searched the code" },
+  glob: { one: "Searched for files", many: "Searched for files" },
+  search: { one: "Searched", many: "Searched %n times" },
+  tool_search: { one: "Looked for a tool", many: "Looked for %n tools" },
+  web_search: { one: "Searched the web", many: "Searched the web" },
+  web_fetch: { one: "Opened a page", many: "Opened %n pages" },
+  fetch: { one: "Opened a page", many: "Opened %n pages" },
+  site_publish: { one: "Published a page", many: "Published %n pages" },
+  pdf: { one: "Generated a PDF", many: "Generated %n PDFs" },
+  connector: { one: "Used your system", many: "Used your system %n times" },
+  mcp: { one: "Used a tool", many: "Used %n tools" },
+  browser: { one: "Used the browser", many: "Used the browser" },
+  todo: { one: "Wrote down the plan", many: "Wrote down the plan" },
+  delete: { one: "Deleted a file", many: "Deleted %n files" },
+  move: { one: "Moved a file", many: "Moved %n files" },
+  think: { one: "Thought it through", many: "Thought it through" },
+  image: { one: "Created an image", many: "Created %n images" },
+  delegate: { one: "Delegated a task", many: "Delegated %n tasks" },
+  collect: { one: "Collected a result", many: "Collected %n results" },
+  status: { one: "Checked how it was going", many: "Checked %n times how it was going" },
+  stop: { one: "Stopped a task", many: "Stopped %n tasks" },
+  guide: { one: "Read a guide", many: "Read %n guides" },
+  deliver: { one: "Delivered a file", many: "Delivered %n files" },
+  sheet: { one: "Checked a sheet", many: "Checked %n sheets" },
+  view: { one: "Built a view", many: "Built %n views" }
+};
+
+export {
+  isRunning,
+  toolNames,
+  toolName,
+  stepLabel,
+  summarizeTools,
+  groupSteps,
+  TOOL_VERBS_ES,
+  TOOL_VERBS_EN
+};