@particle-academy/agent-integrations 0.11.1 → 0.13.0

package/dist/chunk-57KAMBAR.js

@@ -0,0 +1,275 @@
+import { ensureUndoToolsRegistered } from './chunk-KJ5AOOV7.js';
+import { wrapToolWithActivity } from './chunk-ULJL53DL.js';
+import { textResult, errorResult } from './chunk-4KAIV6OD.js';
+
+// src/bridges/terminal.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+var truncate = (s, n = 60) => s.length > n ? s.slice(0, n) + "\u2026" : s;
+function registerTerminalBridge(host, options) {
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? false;
+  const screenId = options.screenId ?? options.adapter?.screenId;
+  const disposers = [];
+  const staged = /* @__PURE__ */ new Map();
+  let seq = 0;
+  ensureUndoToolsRegistered(host);
+  const listTerminals = () => {
+    if (options.terminals) return options.terminals();
+    if (options.adapter) return [{ id: "terminal", label: "Terminal", active: true, ...options.adapter }];
+    return [];
+  };
+  const resolve = (id) => {
+    const list = listTerminals();
+    if (typeof id === "string" && id !== "") return list.find((t) => t.id === id);
+    return list.find((t) => t.active) ?? list[0];
+  };
+  const anyMulti = !!options.terminals;
+  const canClear = anyMulti || !!options.adapter?.clear;
+  const canShells = anyMulti || !!options.adapter?.listShells;
+  const canSetShell = anyMulti || !!options.adapter?.setShell;
+  const target = (label, terminalId) => ({
+    kind: "terminal",
+    screenId,
+    elementId: terminalId ?? screenId ?? "terminal",
+    label: label ?? "terminal"
+  });
+  const TERMINAL_ARG = {
+    terminal: {
+      type: "string",
+      description: "Terminal id to target (call terminal_list for ids). Omit for the active / only terminal."
+    }
+  };
+  const reg = (name, description, properties, required, handler, isMutation, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "terminal",
+      screenId,
+      resolveTarget: ({ args, result }) => resolveTarget?.(args, result) ?? target()
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
+        },
+        final
+      )
+    );
+  };
+  const need = (args) => {
+    const t = resolve(args.terminal);
+    if (!t) {
+      const ids = listTerminals().map((x) => x.id).join(", ") || "(none)";
+      throw new Error(
+        typeof args.terminal === "string" && args.terminal ? `Unknown terminal '${args.terminal}'. Available: ${ids}. Use terminal_list.` : "No terminal available."
+      );
+    }
+    return t;
+  };
+  async function exec(t, kind, data) {
+    if (kind === "run") {
+      if (t.runCommand) await t.runCommand(data);
+      else t.write(data + "\r");
+    } else {
+      t.write(data);
+    }
+  }
+  async function stageOrExec(t, kind, data) {
+    if (!pendingMode) {
+      await exec(t, kind, data);
+      return textResult(`${kind === "run" ? "ran" : "wrote"} on ${t.id}: ${truncate(data)}`, {
+        kind,
+        data,
+        terminal: t.id,
+        executed: true
+      });
+    }
+    const id = `t${++seq}`;
+    const entry = { id, kind, data, terminalId: t.id };
+    staged.set(id, entry);
+    options.onPending?.(entry);
+    return textResult(
+      `Staged ${kind} on ${t.id} (id ${id}) \u2014 awaiting human confirmation: ${truncate(data)}`,
+      { ...entry, pending: true }
+    );
+  }
+  reg(
+    "terminal_list",
+    "List the terminals on this screen (id, label, which is active) \u2014 so you can reach into another terminal, not just the active one. Pass the chosen id as `terminal` to the other tools.",
+    {},
+    [],
+    () => {
+      const list = listTerminals().map((t) => ({ id: t.id, label: t.label ?? t.id, active: !!t.active }));
+      const text = list.length ? list.map((t) => `${t.active ? "* " : "  "}${t.id} \u2014 ${t.label}`).join("\n") : "(no terminals)";
+      return textResult(text, { terminals: list });
+    },
+    false
+  );
+  reg(
+    "terminal_read",
+    "Read a terminal's visible buffer as text \u2014 what the user sees. Pass `tail` for only the last N lines, `terminal` to read a specific one.",
+    { ...TERMINAL_ARG, tail: { type: "number", description: "Return only the last N lines." } },
+    [],
+    (args) => {
+      const t = need(args);
+      let buf = t.getBuffer();
+      const tail = typeof args.tail === "number" ? args.tail : void 0;
+      if (tail && tail > 0) buf = buf.split("\n").slice(-tail).join("\n");
+      return textResult(buf, { buffer: buf, terminal: t.id });
+    },
+    false
+  );
+  reg(
+    "terminal_pending",
+    "List commands staged for human confirmation (pendingMode).",
+    {},
+    [],
+    () => {
+      const list = [...staged.values()];
+      return textResult(
+        list.length ? list.map((s) => `${s.id}: ${s.kind} on ${s.terminalId} ${truncate(s.data)}`).join("\n") : "(none)",
+        { pending: list }
+      );
+    },
+    false
+  );
+  reg(
+    "terminal_write",
+    "Write raw data / keystrokes to a terminal (input, control chars, ANSI). Pass `terminal` to target a specific one. In pendingMode this stages instead of executing.",
+    { ...TERMINAL_ARG, data: { type: "string", description: "Raw bytes to write." } },
+    ["data"],
+    (args) => stageOrExec(need(args), "write", String(args.data)),
+    true,
+    (args) => target(`write:${String(args.terminal ?? "")}`, resolve(args.terminal)?.id)
+  );
+  reg(
+    "terminal_run",
+    "Run a shell command in a terminal \u2014 writes the command + Enter (or the host's runner). Pass `terminal` to target a specific one. In pendingMode this stages it for confirmation.",
+    { ...TERMINAL_ARG, command: { type: "string", description: "The command line to run." } },
+    ["command"],
+    (args) => stageOrExec(need(args), "run", String(args.command)),
+    true,
+    (args) => target(truncate(String(args.command ?? "")), resolve(args.terminal)?.id)
+  );
+  reg(
+    "terminal_confirm",
+    "Confirm + execute a staged command by id (pendingMode).",
+    { id: { type: "string" } },
+    ["id"],
+    async (args) => {
+      const id = String(args.id);
+      const entry = staged.get(id);
+      if (!entry) return errorResult(`No staged command ${id}`);
+      const t = resolve(entry.terminalId);
+      if (!t) return errorResult(`Terminal '${entry.terminalId}' is gone \u2014 cannot run ${id}`);
+      staged.delete(id);
+      await exec(t, entry.kind, entry.data);
+      return textResult(`Confirmed ${id}: ${entry.kind} on ${t.id} ${truncate(entry.data)}`, { ...entry, executed: true });
+    },
+    true,
+    (args) => {
+      const e = staged.get(String(args.id));
+      return target(`confirm:${String(args.id ?? "")}`, e?.terminalId);
+    }
+  );
+  reg(
+    "terminal_reject",
+    "Drop a staged command by id without executing it.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = String(args.id);
+      if (!staged.delete(id)) return errorResult(`No staged command ${id}`);
+      return textResult(`Rejected ${id}`, { id, rejected: true });
+    },
+    false
+  );
+  if (canClear) {
+    reg(
+      "terminal_clear",
+      "Clear a terminal's viewport. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG },
+      [],
+      (args) => {
+        const t = need(args);
+        if (!t.clear) return errorResult(`Terminal '${t.id}' can't be cleared.`);
+        t.clear();
+        return textResult(`cleared ${t.id}`, { terminal: t.id });
+      },
+      true,
+      (args) => target(`clear:${String(args.terminal ?? "")}`, resolve(args.terminal)?.id)
+    );
+  }
+  if (canShells) {
+    reg(
+      "terminal_list_shells",
+      "List the shells a terminal can switch to (cmd, PowerShell, Git Bash, \u2026) \u2014 id + label, active one marked. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG },
+      [],
+      (args) => {
+        const t = need(args);
+        if (!t.listShells) return errorResult(`Terminal '${t.id}' has no switchable shells.`);
+        const shells = t.listShells();
+        const active = t.getShell?.();
+        const text = shells.length ? shells.map((s) => `${s.id === active ? "* " : "  "}${s.id} \u2014 ${s.label}`).join("\n") : "(none)";
+        return textResult(text, { shells, active, terminal: t.id });
+      },
+      false
+    );
+  }
+  if (canSetShell) {
+    reg(
+      "terminal_set_shell",
+      "Switch a terminal's active shell by id (e.g. 'powershell', 'git-bash'). Call terminal_list_shells first for valid ids. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG, id: { type: "string", description: "Shell id to switch to." } },
+      ["id"],
+      async (args) => {
+        const t = need(args);
+        if (!t.setShell) return errorResult(`Terminal '${t.id}' can't switch shells.`);
+        const id = String(args.id);
+        const shells = t.listShells?.();
+        if (shells && shells.length && !shells.some((s) => s.id === id)) {
+          return errorResult(`Unknown shell '${id}' for ${t.id}. Use terminal_list_shells for valid ids.`);
+        }
+        await t.setShell(id);
+        return textResult(`Switched ${t.id} shell to ${id}`, { shell: id, terminal: t.id });
+      },
+      true,
+      (args) => target(`shell:${String(args.id ?? "")}`, resolve(args.terminal)?.id)
+    );
+  }
+  return {
+    id: "terminal",
+    title: "Terminal",
+    dispose: () => {
+      disposers.forEach((d) => d());
+      disposers.length = 0;
+      staged.clear();
+    },
+    confirm: (id) => {
+      const e = staged.get(id);
+      if (e) {
+        const t = resolve(e.terminalId);
+        staged.delete(id);
+        if (t) void exec(t, e.kind, e.data);
+      }
+    },
+    reject: (id) => {
+      staged.delete(id);
+    },
+    pending: () => [...staged.values()]
+  };
+}
+
+export { registerTerminalBridge };
+//# sourceMappingURL=chunk-57KAMBAR.js.map
+//# sourceMappingURL=chunk-57KAMBAR.js.map

package/dist/chunk-57KAMBAR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/terminal.ts"],"names":[],"mappings":";;;;;AA2FA,IAAM,gBAAgB,EAAE,EAAA,EAAI,SAAS,IAAA,EAAM,OAAA,EAAS,OAAO,SAAA,EAAU;AAErE,IAAM,QAAA,GAAW,CAAC,CAAA,EAAW,CAAA,GAAI,EAAA,KAAgB,CAAA,CAAE,MAAA,GAAS,CAAA,GAAI,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,IAAI,QAAA,GAAM,CAAA;AAiB/E,SAAS,sBAAA,CAAuB,MAAgB,OAAA,EAAgD;AACrG,EAAA,MAAM,KAAA,GAAQ,EAAE,GAAG,aAAA,EAAe,GAAI,OAAA,CAAQ,KAAA,IAAS,EAAC,EAAG;AAC3D,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,KAAA;AAC3C,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,QAAA,IAAY,OAAA,CAAQ,OAAA,EAAS,QAAA;AACtD,EAAA,MAAM,YAA+B,EAAC;AACtC,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAoB;AACvC,EAAA,IAAI,GAAA,GAAM,CAAA;AAGV,EAAA,yBAAA,CAA0B,IAAI,CAAA;AAI9B,EAAA,MAAM,gBAAgB,MAAqB;AACzC,IAAA,IAAI,OAAA,CAAQ,SAAA,EAAW,OAAO,OAAA,CAAQ,SAAA,EAAU;AAChD,IAAA,IAAI,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAC,EAAE,EAAA,EAAI,UAAA,EAAY,KAAA,EAAO,UAAA,EAAY,MAAA,EAAQ,IAAA,EAAM,GAAG,OAAA,CAAQ,SAAS,CAAA;AACpG,IAAA,OAAO,EAAC;AAAA,EACV,CAAA;AAGA,EAAA,MAAM,OAAA,GAAU,CAAC,EAAA,KAA0C;AACzD,IAAA,MAAM,OAAO,aAAA,EAAc;AAC3B,IAAA,IAAI,OAAO,EAAA,KAAO,QAAA,IAAY,EAAA,KAAO,EAAA,EAAI,OAAO,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,EAAA,KAAO,EAAE,CAAA;AAC5E,IAAA,OAAO,IAAA,CAAK,KAAK,CAAC,CAAA,KAAM,EAAE,MAAM,CAAA,IAAK,KAAK,CAAC,CAAA;AAAA,EAC7C,CAAA;AAIA,EAAA,MAAM,QAAA,GAAW,CAAC,CAAC,OAAA,CAAQ,SAAA;AAC3B,EAAA,MAAM,QAAA,GAAW,QAAA,IAAY,CAAC,CAAC,QAAQ,OAAA,EAAS,KAAA;AAChD,EAAA,MAAM,SAAA,GAAY,QAAA,IAAY,CAAC,CAAC,QAAQ,OAAA,EAAS,UAAA;AACjD,EAAA,MAAM,WAAA,GAAc,QAAA,IAAY,CAAC,CAAC,QAAQ,OAAA,EAAS,QAAA;AAEnD,EAAA,MAAM,MAAA,GAAS,CAAC,KAAA,EAAgB,UAAA,MAAsC;AAAA,IACpE,IAAA,EAAM,UAAA;AAAA,IACN,QAAA;AAAA,IACA,SAAA,EAAW,cAAc,QAAA,IAAY,UAAA;AAAA,IACrC,OAAO,KAAA,IAAS;AAAA,GAClB,CAAA;AAEA,EAAA,MAAM,YAAA,GAAe;AAAA,IACnB,QAAA,EAAU;AAAA,MACR,IAAA,EAAM,QAAA;AAAA,MACN,WAAA,EAAa;AAAA;AACf,GACF;AAEA,EAAA,MAAM,GAAA,GAAM,CACV,IAAA,EACA,WAAA,EACA,YACA,QAAA,EACA,OAAA,EACA,YACA,aAAA,KACG;AACH,IAAA,MAAM,OAAA,GAAU,OAAO,IAAA,KAAqB;AAC1C,MAAA,IAAI;AACF,QAAA,OAAO,MAAM,QAAQ,IAAI,CAAA;AAAA,MAC3B,SAAS,CAAA,EAAG;AACV,QAAA,OAAO,YAAY,CAAA,YAAa,KAAA,GAAQ,EAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,MAC/D;AAAA,IACF,CAAA;AACA,IAAA,MAAM,KAAA,GAAQ,UAAA,GACV,oBAAA,CAAqB,OAAA,EAAS;AAAA,MAC5B,QAAA,EAAU,IAAA;AAAA,MACV,KAAA;AAAA,MACA,IAAA,EAAM,UAAA;AAAA,MACN,QAAA;AAAA,MACA,aAAA,EAAe,CAAC,EAAE,IAAA,EAAM,MAAA,OAAa,aAAA,GAAgB,IAAA,EAAM,MAAM,CAAA,IAAK,MAAA;AAAO,KAC9E,CAAA,GACD,OAAA;AACJ,IAAA,SAAA,CAAU,IAAA;AAAA,MACR,IAAA,CAAK,YAAA;AAAA,QACH;AAAA,UACE,IAAA;AAAA,UACA,WAAA;AAAA,UACA,aAAa,EAAE,IAAA,EAAM,UAAU,UAAA,EAA+B,QAAA,EAAU,sBAAsB,KAAA;AAAM,SACtG;AAAA,QACA;AAAA;AACF,KACF;AAAA,EACF,CAAA;AAGA,EAAA,MAAM,IAAA,GAAO,CAAC,IAAA,KAAkC;AAC9C,IAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA;AAC/B,IAAA,IAAI,CAAC,CAAA,EAAG;AACN,MAAA,MAAM,GAAA,GAAM,aAAA,EAAc,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,EAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,IAAK,QAAA;AAC3D,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,OAAO,IAAA,CAAK,QAAA,KAAa,QAAA,IAAY,IAAA,CAAK,QAAA,GACtC,CAAA,kBAAA,EAAqB,IAAA,CAAK,QAAQ,CAAA,cAAA,EAAiB,GAAG,CAAA,oBAAA,CAAA,GACtD;AAAA,OACN;AAAA,IACF;AACA,IAAA,OAAO,CAAA;AAAA,EACT,CAAA;AAEA,EAAA,eAAe,IAAA,CAAK,CAAA,EAAgB,IAAA,EAAkB,IAAA,EAA6B;AACjF,IAAA,IAAI,SAAS,KAAA,EAAO;AAClB,MAAA,IAAI,CAAA,CAAE,UAAA,EAAY,MAAM,CAAA,CAAE,WAAW,IAAI,CAAA;AAAA,WACpC,CAAA,CAAE,KAAA,CAAM,IAAA,GAAO,IAAI,CAAA;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,CAAA,CAAE,MAAM,IAAI,CAAA;AAAA,IACd;AAAA,EACF;AAEA,EAAA,eAAe,WAAA,CAAY,CAAA,EAAgB,IAAA,EAAkB,IAAA,EAAc;AACzE,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA,MAAM,IAAA,CAAK,CAAA,EAAG,IAAA,EAAM,IAAI,CAAA;AACxB,MAAA,OAAO,UAAA,CAAW,CAAA,EAAG,IAAA,KAAS,KAAA,GAAQ,KAAA,GAAQ,OAAO,CAAA,IAAA,EAAO,CAAA,CAAE,EAAE,CAAA,EAAA,EAAK,QAAA,CAAS,IAAI,CAAC,CAAA,CAAA,EAAI;AAAA,QACrF,IAAA;AAAA,QACA,IAAA;AAAA,QACA,UAAU,CAAA,CAAE,EAAA;AAAA,QACZ,QAAA,EAAU;AAAA,OACX,CAAA;AAAA,IACH;AACA,IAAA,MAAM,EAAA,GAAK,CAAA,CAAA,EAAI,EAAE,GAAG,CAAA,CAAA;AACpB,IAAA,MAAM,QAAgB,EAAE,EAAA,EAAI,MAAM,IAAA,EAAM,UAAA,EAAY,EAAE,EAAA,EAAG;AACzD,IAAA,MAAA,CAAO,GAAA,CAAI,IAAI,KAAK,CAAA;AACpB,IAAA,OAAA,CAAQ,YAAY,KAAK,CAAA;AACzB,IAAA,OAAO,UAAA;AAAA,MACL,CAAA,OAAA,EAAU,IAAI,CAAA,IAAA,EAAO,CAAA,CAAE,EAAE,QAAQ,EAAE,CAAA,sCAAA,EAAoC,QAAA,CAAS,IAAI,CAAC,CAAA,CAAA;AAAA,MACrF,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,IAAA;AAAK,KAC5B;AAAA,EACF;AAGA,EAAA,GAAA;AAAA,IACE,eAAA;AAAA,IACA,6LAAA;AAAA,IACA,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,MAAM,IAAA,GAAO,eAAc,CAAE,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,IAAI,CAAA,CAAE,EAAA,EAAI,OAAO,CAAA,CAAE,KAAA,IAAS,EAAE,EAAA,EAAI,MAAA,EAAQ,CAAC,CAAC,CAAA,CAAE,QAAO,CAAE,CAAA;AAClG,MAAA,MAAM,IAAA,GAAO,KAAK,MAAA,GACd,IAAA,CAAK,IAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,MAAA,GAAS,IAAA,GAAO,IAAI,CAAA,EAAG,CAAA,CAAE,EAAE,CAAA,QAAA,EAAM,CAAA,CAAE,KAAK,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,GAC1E,gBAAA;AACJ,MAAA,OAAO,UAAA,CAAW,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,IAC7C,CAAA;AAAA,IACA;AAAA,GACF;AAGA,EAAA,GAAA;AAAA,IACE,eAAA;AAAA,IACA,+IAAA;AAAA,IACA,EAAE,GAAG,YAAA,EAAc,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,WAAA,EAAa,+BAAA,EAAgC,EAAE;AAAA,IAC1F,EAAC;AAAA,IACD,CAAC,IAAA,KAAS;AACR,MAAA,MAAM,CAAA,GAAI,KAAK,IAAI,CAAA;AACnB,MAAA,IAAI,GAAA,GAAM,EAAE,SAAA,EAAU;AACtB,MAAA,MAAM,OAAO,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,GAAW,KAAK,IAAA,GAAO,MAAA;AACzD,MAAA,IAAI,IAAA,IAAQ,IAAA,GAAO,CAAA,EAAG,GAAA,GAAM,GAAA,CAAI,KAAA,CAAM,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,IAAI,CAAA,CAAE,KAAK,IAAI,CAAA;AAClE,MAAA,OAAO,UAAA,CAAW,KAAK,EAAE,MAAA,EAAQ,KAAK,QAAA,EAAU,CAAA,CAAE,IAAI,CAAA;AAAA,IACxD,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,kBAAA;AAAA,IACA,4DAAA;AAAA,IACA,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,MAAM,IAAA,GAAO,CAAC,GAAG,MAAA,CAAO,QAAQ,CAAA;AAChC,MAAA,OAAO,UAAA;AAAA,QACL,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,CAAC,MAAM,CAAA,EAAG,CAAA,CAAE,EAAE,CAAA,EAAA,EAAK,CAAA,CAAE,IAAI,OAAO,CAAA,CAAE,UAAU,CAAA,CAAA,EAAI,QAAA,CAAS,CAAA,CAAE,IAAI,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,GAAI,QAAA;AAAA,QACxG,EAAE,SAAS,IAAA;AAAK,OAClB;AAAA,IACF,CAAA;AAAA,IACA;AAAA,GACF;AAGA,EAAA,GAAA;AAAA,IACE,gBAAA;AAAA,IACA,oKAAA;AAAA,IACA,EAAE,GAAG,YAAA,EAAc,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,WAAA,EAAa,qBAAA,EAAsB,EAAE;AAAA,IAChF,CAAC,MAAM,CAAA;AAAA,IACP,CAAC,IAAA,KAAS,WAAA,CAAY,IAAA,CAAK,IAAI,GAAG,OAAA,EAAS,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,IAC5D,IAAA;AAAA,IACA,CAAC,IAAA,KAAS,MAAA,CAAO,CAAA,MAAA,EAAS,OAAO,IAAA,CAAK,QAAA,IAAY,EAAE,CAAC,CAAA,CAAA,EAAI,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,EAAE;AAAA,GACrF;AAEA,EAAA,GAAA;AAAA,IACE,cAAA;AAAA,IACA,uLAAA;AAAA,IACA,EAAE,GAAG,YAAA,EAAc,OAAA,EAAS,EAAE,IAAA,EAAM,QAAA,EAAU,WAAA,EAAa,0BAAA,EAA2B,EAAE;AAAA,IACxF,CAAC,SAAS,CAAA;AAAA,IACV,CAAC,IAAA,KAAS,WAAA,CAAY,IAAA,CAAK,IAAI,GAAG,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAC7D,IAAA;AAAA,IACA,CAAC,IAAA,KAAS,MAAA,CAAO,QAAA,CAAS,OAAO,IAAA,CAAK,OAAA,IAAW,EAAE,CAAC,CAAA,EAAG,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,EAAE;AAAA,GACnF;AAEA,EAAA,GAAA;AAAA,IACE,kBAAA;AAAA,IACA,yDAAA;AAAA,IACA,EAAE,EAAA,EAAI,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,IACzB,CAAC,IAAI,CAAA;AAAA,IACL,OAAO,IAAA,KAAS;AACd,MAAA,MAAM,EAAA,GAAK,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA;AACzB,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC3B,MAAA,IAAI,CAAC,KAAA,EAAO,OAAO,WAAA,CAAY,CAAA,kBAAA,EAAqB,EAAE,CAAA,CAAE,CAAA;AACxD,MAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAClC,MAAA,IAAI,CAAC,GAAG,OAAO,WAAA,CAAY,aAAa,KAAA,CAAM,UAAU,CAAA,4BAAA,EAA0B,EAAE,CAAA,CAAE,CAAA;AACtF,MAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAChB,MAAA,MAAM,IAAA,CAAK,CAAA,EAAG,KAAA,CAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AACpC,MAAA,OAAO,UAAA,CAAW,aAAa,EAAE,CAAA,EAAA,EAAK,MAAM,IAAI,CAAA,IAAA,EAAO,EAAE,EAAE,CAAA,CAAA,EAAI,SAAS,KAAA,CAAM,IAAI,CAAC,CAAA,CAAA,EAAI,EAAE,GAAG,KAAA,EAAO,QAAA,EAAU,MAAM,CAAA;AAAA,IACrH,CAAA;AAAA,IACA,IAAA;AAAA,IACA,CAAC,IAAA,KAAS;AACR,MAAA,MAAM,IAAI,MAAA,CAAO,GAAA,CAAI,MAAA,CAAO,IAAA,CAAK,EAAE,CAAC,CAAA;AACpC,MAAA,OAAO,MAAA,CAAO,WAAW,MAAA,CAAO,IAAA,CAAK,MAAM,EAAE,CAAC,CAAA,CAAA,EAAI,CAAA,EAAG,UAAU,CAAA;AAAA,IACjE;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,iBAAA;AAAA,IACA,mDAAA;AAAA,IACA,EAAE,EAAA,EAAI,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,IACzB,CAAC,IAAI,CAAA;AAAA,IACL,CAAC,IAAA,KAAS;AACR,MAAA,MAAM,EAAA,GAAK,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA;AACzB,MAAA,IAAI,CAAC,OAAO,MAAA,CAAO,EAAE,GAAG,OAAO,WAAA,CAAY,CAAA,kBAAA,EAAqB,EAAE,CAAA,CAAE,CAAA;AACpE,MAAA,OAAO,UAAA,CAAW,YAAY,EAAE,CAAA,CAAA,EAAI,EAAE,EAAA,EAAI,QAAA,EAAU,MAAM,CAAA;AAAA,IAC5D,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,GAAA;AAAA,MACE,gBAAA;AAAA,MACA,wEAAA;AAAA,MACA,EAAE,GAAG,YAAA,EAAa;AAAA,MAClB,EAAC;AAAA,MACD,CAAC,IAAA,KAAS;AACR,QAAA,MAAM,CAAA,GAAI,KAAK,IAAI,CAAA;AACnB,QAAA,IAAI,CAAC,EAAE,KAAA,EAAO,OAAO,YAAY,CAAA,UAAA,EAAa,CAAA,CAAE,EAAE,CAAA,mBAAA,CAAqB,CAAA;AACvE,QAAA,CAAA,CAAE,KAAA,EAAM;AACR,QAAA,OAAO,UAAA,CAAW,WAAW,CAAA,CAAE,EAAE,IAAI,EAAE,QAAA,EAAU,CAAA,CAAE,EAAA,EAAI,CAAA;AAAA,MACzD,CAAA;AAAA,MACA,IAAA;AAAA,MACA,CAAC,IAAA,KAAS,MAAA,CAAO,CAAA,MAAA,EAAS,OAAO,IAAA,CAAK,QAAA,IAAY,EAAE,CAAC,CAAA,CAAA,EAAI,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,EAAE;AAAA,KACrF;AAAA,EACF;AAGA,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,GAAA;AAAA,MACE,sBAAA;AAAA,MACA,8JAAA;AAAA,MACA,EAAE,GAAG,YAAA,EAAa;AAAA,MAClB,EAAC;AAAA,MACD,CAAC,IAAA,KAAS;AACR,QAAA,MAAM,CAAA,GAAI,KAAK,IAAI,CAAA;AACnB,QAAA,IAAI,CAAC,EAAE,UAAA,EAAY,OAAO,YAAY,CAAA,UAAA,EAAa,CAAA,CAAE,EAAE,CAAA,2BAAA,CAA6B,CAAA;AACpF,QAAA,MAAM,MAAA,GAAS,EAAE,UAAA,EAAW;AAC5B,QAAA,MAAM,MAAA,GAAS,EAAE,QAAA,IAAW;AAC5B,QAAA,MAAM,IAAA,GAAO,OAAO,MAAA,GAChB,MAAA,CAAO,IAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,EAAA,KAAO,MAAA,GAAS,OAAO,IAAI,CAAA,EAAG,CAAA,CAAE,EAAE,CAAA,QAAA,EAAM,CAAA,CAAE,KAAK,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,GACnF,QAAA;AACJ,QAAA,OAAO,UAAA,CAAW,MAAM,EAAE,MAAA,EAAQ,QAAQ,QAAA,EAAU,CAAA,CAAE,IAAI,CAAA;AAAA,MAC5D,CAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,IAAI,WAAA,EAAa;AACf,IAAA,GAAA;AAAA,MACE,oBAAA;AAAA,MACA,kKAAA;AAAA,MACA,EAAE,GAAG,YAAA,EAAc,EAAA,EAAI,EAAE,IAAA,EAAM,QAAA,EAAU,WAAA,EAAa,wBAAA,EAAyB,EAAE;AAAA,MACjF,CAAC,IAAI,CAAA;AAAA,MACL,OAAO,IAAA,KAAS;AACd,QAAA,MAAM,CAAA,GAAI,KAAK,IAAI,CAAA;AACnB,QAAA,IAAI,CAAC,EAAE,QAAA,EAAU,OAAO,YAAY,CAAA,UAAA,EAAa,CAAA,CAAE,EAAE,CAAA,sBAAA,CAAwB,CAAA;AAC7E,QAAA,MAAM,EAAA,GAAK,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA;AACzB,QAAA,MAAM,MAAA,GAAS,EAAE,UAAA,IAAa;AAC9B,QAAA,IAAI,MAAA,IAAU,MAAA,CAAO,MAAA,IAAU,CAAC,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,EAAA,KAAO,EAAE,CAAA,EAAG;AAC/D,UAAA,OAAO,YAAY,CAAA,eAAA,EAAkB,EAAE,CAAA,MAAA,EAAS,CAAA,CAAE,EAAE,CAAA,yCAAA,CAA2C,CAAA;AAAA,QACjG;AACA,QAAA,MAAM,CAAA,CAAE,SAAS,EAAE,CAAA;AACnB,QAAA,OAAO,UAAA,CAAW,CAAA,SAAA,EAAY,CAAA,CAAE,EAAE,CAAA,UAAA,EAAa,EAAE,CAAA,CAAA,EAAI,EAAE,KAAA,EAAO,EAAA,EAAI,QAAA,EAAU,CAAA,CAAE,IAAI,CAAA;AAAA,MACpF,CAAA;AAAA,MACA,IAAA;AAAA,MACA,CAAC,IAAA,KAAS,MAAA,CAAO,CAAA,MAAA,EAAS,OAAO,IAAA,CAAK,EAAA,IAAM,EAAE,CAAC,CAAA,CAAA,EAAI,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,EAAE;AAAA,KAC/E;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,UAAA;AAAA,IACJ,KAAA,EAAO,UAAA;AAAA,IACP,SAAS,MAAM;AACb,MAAA,SAAA,CAAU,OAAA,CAAQ,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA;AAC5B,MAAA,SAAA,CAAU,MAAA,GAAS,CAAA;AACnB,MAAA,MAAA,CAAO,KAAA,EAAM;AAAA,IACf,CAAA;AAAA,IACA,OAAA,EAAS,CAAC,EAAA,KAAe;AACvB,MAAA,MAAM,CAAA,GAAI,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AACvB,MAAA,IAAI,CAAA,EAAG;AACL,QAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,CAAA,CAAE,UAAU,CAAA;AAC9B,QAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAChB,QAAA,IAAI,GAAG,KAAK,IAAA,CAAK,GAAG,CAAA,CAAE,IAAA,EAAM,EAAE,IAAI,CAAA;AAAA,MACpC;AAAA,IACF,CAAA;AAAA,IACA,MAAA,EAAQ,CAAC,EAAA,KAAe;AACtB,MAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,SAAS,MAAM,CAAC,GAAG,MAAA,CAAO,QAAQ;AAAA,GACpC;AACF","file":"chunk-57KAMBAR.js","sourcesContent":["import { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport type { JsonObject } from \"../mcp/types\";\nimport type { Bridge } from \"./types\";\nimport { wrapToolWithActivity } from \"../presence/wrap-tool-with-activity\";\nimport { ensureUndoToolsRegistered } from \"../undo/undo-tools\";\nimport type { AgentTarget } from \"../presence/types\";\n\n/**\n * A shell/profile an agent can switch a terminal to. Mirrors fancy-term's\n * `ShellProfile` (kept local so the bridge never imports fancy-term).\n */\nexport type TerminalShell = { id: string; label: string; icon?: string };\n\n/**\n * One terminal the bridge can drive. A Human+ app often hosts **several**\n * terminals on a screen (a build pane, a server pane, an agent scratch shell);\n * each is a `TerminalRef` with a stable `id` so an agent can read/write any of\n * them — not just \"its own\". Wire the function fields to that terminal's\n * fancy-term `TerminalHandle`.\n */\nexport type TerminalRef = {\n  /** Stable id used to address this terminal (`terminal_list` enumerates them). */\n  id: string;\n  /** Human label, e.g. \"Build\", \"Server\". Defaults to the id. */\n  label?: string;\n  /** True for the focused terminal — the default target when no id is passed. */\n  active?: boolean;\n  /** Read the visible buffer as text (wire to `TerminalHandle.getBuffer`). */\n  getBuffer: () => string;\n  /** Write raw data / keystrokes (wire to `TerminalHandle.write`). */\n  write: (data: string) => void;\n  /** Run a command. Defaults to writing `${command}\\r`; override for a real runner. */\n  runCommand?: (command: string) => void | Promise<void>;\n  /** Clear the viewport (wire to `TerminalHandle.clear`). */\n  clear?: () => void;\n  /** Current text selection (wire to `TerminalHandle.getSelection`). */\n  getSelection?: () => string;\n  /** Shells this terminal offers (cmd, PowerShell, …). */\n  listShells?: () => TerminalShell[];\n  /** Switch this terminal's active shell by id. */\n  setShell?: (id: string) => void | Promise<void>;\n  /** This terminal's active shell id. */\n  getShell?: () => string | undefined;\n};\n\n/**\n * Single-terminal adapter (back-compat). A `TerminalRef` without the\n * `id`/`label`/`active` bookkeeping — pass it as `{ adapter }` and the bridge\n * treats it as the one (active) terminal. Use `{ terminals }` for multiple.\n */\nexport type TerminalBridgeAdapter = Omit<TerminalRef, \"id\" | \"label\" | \"active\"> & {\n  /** fancy-screens screen id (optional) so activity events know which screen the terminal lives in. */\n  screenId?: string;\n};\n\ntype StagedKind = \"write\" | \"run\";\ntype Staged = { id: string; kind: StagedKind; data: string; terminalId: string };\n\nexport type TerminalBridgeOptions = {\n  /** A single terminal (back-compat). Mutually exclusive with `terminals`. */\n  adapter?: TerminalBridgeAdapter;\n  /**\n   * The live list of terminals on the screen. Use this when the app hosts more\n   * than one terminal so an agent can `terminal_list` then target any of them by\n   * id — i.e. reach into another terminal in the same screen.\n   */\n  terminals?: () => TerminalRef[];\n  /** fancy-screens screen id for activity events (defaults to `adapter.screenId`). */\n  screenId?: string;\n  agent?: { id: string; name?: string; color?: string };\n  /**\n   * Trust-but-verify (Human+ contract for inhabited surfaces). When on,\n   * `terminal_write` + `terminal_run` don't execute — they **stage** the command\n   * (returning a pending id) and fire `onPending`. A human confirms via the\n   * `terminal_confirm` tool or the returned bridge's `confirm(id)`. Default off.\n   */\n  pendingMode?: boolean;\n  /** Notified when a command is staged (pendingMode) — show it + offer confirm / reject. */\n  onPending?: (pending: Staged) => void;\n};\n\nexport type TerminalBridge = Bridge & {\n  /** Execute a staged command by id — wire a host confirm button to this. No-op if not pending. */\n  confirm: (id: string) => void;\n  /** Drop a staged command by id without executing. */\n  reject: (id: string) => void;\n  /** Commands currently awaiting confirmation. */\n  pending: () => Staged[];\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\nconst truncate = (s: string, n = 60): string => (s.length > n ? s.slice(0, n) + \"…\" : s);\n\n/**\n * registerTerminalBridge — MCP access to one **or many** terminal surfaces on a\n * screen. An agent reads the visible buffer (`terminal_read`), writes input\n * (`terminal_write`), and runs commands (`terminal_run`) through the host; every\n * mutation broadcasts an `AgentActivity` event. With `pendingMode`, destructive\n * actions are staged for human confirmation (`terminal_confirm` / `terminal_reject`\n * / `terminal_pending`).\n *\n * **Multi-terminal:** pass `{ terminals }` (vs a single `{ adapter }`) and every\n * tool takes an optional `terminal` id; `terminal_list` enumerates them. This is\n * how an agent **reaches into another terminal in the same screen** rather than\n * being stuck in one. When a terminal offers shells, the agent can also list\n * (`terminal_list_shells`) and switch (`terminal_set_shell`) its shell. Tool\n * prefix `terminal_*`.\n */\nexport function registerTerminalBridge(host: ToolHost, options: TerminalBridgeOptions): TerminalBridge {\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const pendingMode = options.pendingMode ?? false;\n  const screenId = options.screenId ?? options.adapter?.screenId;\n  const disposers: Array<() => void> = [];\n  const staged = new Map<string, Staged>();\n  let seq = 0;\n\n  // Enables agent_history (a log of what agents did across every bridge).\n  ensureUndoToolsRegistered(host);\n\n  // The live terminal list — from `terminals()` (multi) or the single `adapter`\n  // normalized to one active ref with the id \"terminal\".\n  const listTerminals = (): TerminalRef[] => {\n    if (options.terminals) return options.terminals();\n    if (options.adapter) return [{ id: \"terminal\", label: \"Terminal\", active: true, ...options.adapter }];\n    return [];\n  };\n\n  /** Resolve a terminal by id; with no id, the active one, else the first. */\n  const resolve = (id?: unknown): TerminalRef | undefined => {\n    const list = listTerminals();\n    if (typeof id === \"string\" && id !== \"\") return list.find((t) => t.id === id);\n    return list.find((t) => t.active) ?? list[0];\n  };\n\n  // Whether any host config can offer these capabilities (gates tool registration;\n  // per-call we still check the *resolved* terminal supports it).\n  const anyMulti = !!options.terminals;\n  const canClear = anyMulti || !!options.adapter?.clear;\n  const canShells = anyMulti || !!options.adapter?.listShells;\n  const canSetShell = anyMulti || !!options.adapter?.setShell;\n\n  const target = (label?: string, terminalId?: string): AgentTarget => ({\n    kind: \"terminal\",\n    screenId,\n    elementId: terminalId ?? screenId ?? \"terminal\",\n    label: label ?? \"terminal\",\n  });\n\n  const TERMINAL_ARG = {\n    terminal: {\n      type: \"string\",\n      description: \"Terminal id to target (call terminal_list for ids). Omit for the active / only terminal.\",\n    },\n  };\n\n  const reg = (\n    name: string,\n    description: string,\n    properties: Record<string, unknown>,\n    required: string[],\n    handler: (args: JsonObject) => Promise<any> | any,\n    isMutation: boolean,\n    resolveTarget?: (args: JsonObject, result: any) => AgentTarget | null,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try {\n        return await handler(args);\n      } catch (e) {\n        return errorResult(e instanceof Error ? e.message : String(e));\n      }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent,\n          kind: \"terminal\",\n          screenId,\n          resolveTarget: ({ args, result }) => resolveTarget?.(args, result) ?? target(),\n        })\n      : wrapped;\n    disposers.push(\n      host.registerTool(\n        {\n          name,\n          description,\n          inputSchema: { type: \"object\", properties: properties as any, required, additionalProperties: false },\n        },\n        final as any,\n      ),\n    );\n  };\n\n  /** Resolve the targeted terminal or throw a clear error for the agent. */\n  const need = (args: JsonObject): TerminalRef => {\n    const t = resolve(args.terminal);\n    if (!t) {\n      const ids = listTerminals().map((x) => x.id).join(\", \") || \"(none)\";\n      throw new Error(\n        typeof args.terminal === \"string\" && args.terminal\n          ? `Unknown terminal '${args.terminal}'. Available: ${ids}. Use terminal_list.`\n          : \"No terminal available.\",\n      );\n    }\n    return t;\n  };\n\n  async function exec(t: TerminalRef, kind: StagedKind, data: string): Promise<void> {\n    if (kind === \"run\") {\n      if (t.runCommand) await t.runCommand(data);\n      else t.write(data + \"\\r\");\n    } else {\n      t.write(data);\n    }\n  }\n\n  async function stageOrExec(t: TerminalRef, kind: StagedKind, data: string) {\n    if (!pendingMode) {\n      await exec(t, kind, data);\n      return textResult(`${kind === \"run\" ? \"ran\" : \"wrote\"} on ${t.id}: ${truncate(data)}`, {\n        kind,\n        data,\n        terminal: t.id,\n        executed: true,\n      });\n    }\n    const id = `t${++seq}`;\n    const entry: Staged = { id, kind, data, terminalId: t.id };\n    staged.set(id, entry);\n    options.onPending?.(entry);\n    return textResult(\n      `Staged ${kind} on ${t.id} (id ${id}) — awaiting human confirmation: ${truncate(data)}`,\n      { ...entry, pending: true },\n    );\n  }\n\n  // ── List ──────────────────────────────────────────────────────────────────\n  reg(\n    \"terminal_list\",\n    \"List the terminals on this screen (id, label, which is active) — so you can reach into another terminal, not just the active one. Pass the chosen id as `terminal` to the other tools.\",\n    {},\n    [],\n    () => {\n      const list = listTerminals().map((t) => ({ id: t.id, label: t.label ?? t.id, active: !!t.active }));\n      const text = list.length\n        ? list.map((t) => `${t.active ? \"* \" : \"  \"}${t.id} — ${t.label}`).join(\"\\n\")\n        : \"(no terminals)\";\n      return textResult(text, { terminals: list });\n    },\n    false,\n  );\n\n  // ── Read ──────────────────────────────────────────────────────────────────\n  reg(\n    \"terminal_read\",\n    \"Read a terminal's visible buffer as text — what the user sees. Pass `tail` for only the last N lines, `terminal` to read a specific one.\",\n    { ...TERMINAL_ARG, tail: { type: \"number\", description: \"Return only the last N lines.\" } },\n    [],\n    (args) => {\n      const t = need(args);\n      let buf = t.getBuffer();\n      const tail = typeof args.tail === \"number\" ? args.tail : undefined;\n      if (tail && tail > 0) buf = buf.split(\"\\n\").slice(-tail).join(\"\\n\");\n      return textResult(buf, { buffer: buf, terminal: t.id });\n    },\n    false,\n  );\n\n  reg(\n    \"terminal_pending\",\n    \"List commands staged for human confirmation (pendingMode).\",\n    {},\n    [],\n    () => {\n      const list = [...staged.values()];\n      return textResult(\n        list.length ? list.map((s) => `${s.id}: ${s.kind} on ${s.terminalId} ${truncate(s.data)}`).join(\"\\n\") : \"(none)\",\n        { pending: list },\n      );\n    },\n    false,\n  );\n\n  // ── Mutations ───────────────────────────────────────────────────────────────\n  reg(\n    \"terminal_write\",\n    \"Write raw data / keystrokes to a terminal (input, control chars, ANSI). Pass `terminal` to target a specific one. In pendingMode this stages instead of executing.\",\n    { ...TERMINAL_ARG, data: { type: \"string\", description: \"Raw bytes to write.\" } },\n    [\"data\"],\n    (args) => stageOrExec(need(args), \"write\", String(args.data)),\n    true,\n    (args) => target(`write:${String(args.terminal ?? \"\")}`, resolve(args.terminal)?.id),\n  );\n\n  reg(\n    \"terminal_run\",\n    \"Run a shell command in a terminal — writes the command + Enter (or the host's runner). Pass `terminal` to target a specific one. In pendingMode this stages it for confirmation.\",\n    { ...TERMINAL_ARG, command: { type: \"string\", description: \"The command line to run.\" } },\n    [\"command\"],\n    (args) => stageOrExec(need(args), \"run\", String(args.command)),\n    true,\n    (args) => target(truncate(String(args.command ?? \"\")), resolve(args.terminal)?.id),\n  );\n\n  reg(\n    \"terminal_confirm\",\n    \"Confirm + execute a staged command by id (pendingMode).\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    async (args) => {\n      const id = String(args.id);\n      const entry = staged.get(id);\n      if (!entry) return errorResult(`No staged command ${id}`);\n      const t = resolve(entry.terminalId);\n      if (!t) return errorResult(`Terminal '${entry.terminalId}' is gone — cannot run ${id}`);\n      staged.delete(id);\n      await exec(t, entry.kind, entry.data);\n      return textResult(`Confirmed ${id}: ${entry.kind} on ${t.id} ${truncate(entry.data)}`, { ...entry, executed: true });\n    },\n    true,\n    (args) => {\n      const e = staged.get(String(args.id));\n      return target(`confirm:${String(args.id ?? \"\")}`, e?.terminalId);\n    },\n  );\n\n  reg(\n    \"terminal_reject\",\n    \"Drop a staged command by id without executing it.\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const id = String(args.id);\n      if (!staged.delete(id)) return errorResult(`No staged command ${id}`);\n      return textResult(`Rejected ${id}`, { id, rejected: true });\n    },\n    false,\n  );\n\n  if (canClear) {\n    reg(\n      \"terminal_clear\",\n      \"Clear a terminal's viewport. Pass `terminal` to target a specific one.\",\n      { ...TERMINAL_ARG },\n      [],\n      (args) => {\n        const t = need(args);\n        if (!t.clear) return errorResult(`Terminal '${t.id}' can't be cleared.`);\n        t.clear();\n        return textResult(`cleared ${t.id}`, { terminal: t.id });\n      },\n      true,\n      (args) => target(`clear:${String(args.terminal ?? \"\")}`, resolve(args.terminal)?.id),\n    );\n  }\n\n  // ── Shells ──────────────────────────────────────────────────────────────────\n  if (canShells) {\n    reg(\n      \"terminal_list_shells\",\n      \"List the shells a terminal can switch to (cmd, PowerShell, Git Bash, …) — id + label, active one marked. Pass `terminal` to target a specific one.\",\n      { ...TERMINAL_ARG },\n      [],\n      (args) => {\n        const t = need(args);\n        if (!t.listShells) return errorResult(`Terminal '${t.id}' has no switchable shells.`);\n        const shells = t.listShells();\n        const active = t.getShell?.();\n        const text = shells.length\n          ? shells.map((s) => `${s.id === active ? \"* \" : \"  \"}${s.id} — ${s.label}`).join(\"\\n\")\n          : \"(none)\";\n        return textResult(text, { shells, active, terminal: t.id });\n      },\n      false,\n    );\n  }\n\n  if (canSetShell) {\n    reg(\n      \"terminal_set_shell\",\n      \"Switch a terminal's active shell by id (e.g. 'powershell', 'git-bash'). Call terminal_list_shells first for valid ids. Pass `terminal` to target a specific one.\",\n      { ...TERMINAL_ARG, id: { type: \"string\", description: \"Shell id to switch to.\" } },\n      [\"id\"],\n      async (args) => {\n        const t = need(args);\n        if (!t.setShell) return errorResult(`Terminal '${t.id}' can't switch shells.`);\n        const id = String(args.id);\n        const shells = t.listShells?.();\n        if (shells && shells.length && !shells.some((s) => s.id === id)) {\n          return errorResult(`Unknown shell '${id}' for ${t.id}. Use terminal_list_shells for valid ids.`);\n        }\n        await t.setShell(id);\n        return textResult(`Switched ${t.id} shell to ${id}`, { shell: id, terminal: t.id });\n      },\n      true,\n      (args) => target(`shell:${String(args.id ?? \"\")}`, resolve(args.terminal)?.id),\n    );\n  }\n\n  return {\n    id: \"terminal\",\n    title: \"Terminal\",\n    dispose: () => {\n      disposers.forEach((d) => d());\n      disposers.length = 0;\n      staged.clear();\n    },\n    confirm: (id: string) => {\n      const e = staged.get(id);\n      if (e) {\n        const t = resolve(e.terminalId);\n        staged.delete(id);\n        if (t) void exec(t, e.kind, e.data);\n      }\n    },\n    reject: (id: string) => {\n      staged.delete(id);\n    },\n    pending: () => [...staged.values()],\n  };\n}\n"]}

package/dist/chunk-GO2Y6H6U.js

@@ -0,0 +1,62 @@
+// src/connectors/mcpb.ts
+var MCPB_MANIFEST_VERSION = "0.2";
+var MCPB_MIN_NODE = ">=18.0.0";
+var DEFAULT_MCPB_ENTRY_POINT = "server/proxy.js";
+function buildMcpbManifest(input) {
+  const entryPoint = input.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;
+  return {
+    manifest_version: MCPB_MANIFEST_VERSION,
+    name: input.name,
+    display_name: input.display_name ?? input.name,
+    version: input.version,
+    description: input.description,
+    ...input.long_description ? { long_description: input.long_description } : {},
+    author: input.author,
+    ...input.homepage ? { homepage: input.homepage } : {},
+    ...input.documentation ? { documentation: input.documentation } : {},
+    ...input.support ? { support: input.support } : {},
+    server: {
+      type: "node",
+      entry_point: entryPoint,
+      mcp_config: {
+        command: "npx",
+        args: ["-y", "mcp-remote", input.mcpUrl]
+      }
+    },
+    tools: input.tools ?? [],
+    tools_generated: false,
+    prompts_generated: false,
+    ...input.keywords ? { keywords: input.keywords } : {},
+    license: input.license ?? "MIT",
+    compatibility: {
+      claude_desktop: ">=0.10.0",
+      platforms: ["darwin", "win32", "linux"],
+      runtimes: { node: MCPB_MIN_NODE }
+    }
+  };
+}
+function buildMcpbProxyStub(mcpUrl) {
+  const urlLiteral = JSON.stringify(mcpUrl);
+  return `#!/usr/bin/env node
+// MCPB proxy shim (generated by @particle-academy/agent-integrations).
+//
+// MCPB (Claude Desktop Extensions) only supports local stdio servers, but this
+// MCP server is a remote HTTP endpoint. The manifest's \`mcp_config\` invokes
+// \`npx -y mcp-remote <url>\` to bridge the gap \u2014 this file is the entry_point
+// fallback the manifest validator requires. If you're seeing this run,
+// mcp_config wasn't honored; spawn mcp-remote directly so the bundle still works.
+
+const { spawn } = require("node:child_process");
+
+const url = ${urlLiteral};
+const child = spawn("npx", ["-y", "mcp-remote", url], { stdio: "inherit" });
+
+child.on("exit", (code) => process.exit(code ?? 0));
+process.on("SIGINT", () => child.kill("SIGINT"));
+process.on("SIGTERM", () => child.kill("SIGTERM"));
+`;
+}
+
+export { DEFAULT_MCPB_ENTRY_POINT, MCPB_MANIFEST_VERSION, MCPB_MIN_NODE, buildMcpbManifest, buildMcpbProxyStub };
+//# sourceMappingURL=chunk-GO2Y6H6U.js.map
+//# sourceMappingURL=chunk-GO2Y6H6U.js.map

package/dist/chunk-GO2Y6H6U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/mcpb.ts"],"names":[],"mappings":";AAiBO,IAAM,qBAAA,GAAwB;AAG9B,IAAM,aAAA,GAAgB;AAmCtB,IAAM,wBAAA,GAA2B;AAOjC,SAAS,kBACd,KAAA,EACyB;AACzB,EAAA,MAAM,UAAA,GAAa,MAAM,UAAA,IAAc,wBAAA;AACvC,EAAA,OAAO;AAAA,IACL,gBAAA,EAAkB,qBAAA;AAAA,IAClB,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,YAAA,EAAc,KAAA,CAAM,YAAA,IAAgB,KAAA,CAAM,IAAA;AAAA,IAC1C,SAAS,KAAA,CAAM,OAAA;AAAA,IACf,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,GAAI,MAAM,gBAAA,GACN,EAAE,kBAAkB,KAAA,CAAM,gBAAA,KAC1B,EAAC;AAAA,IACL,QAAQ,KAAA,CAAM,MAAA;AAAA,IACd,GAAI,MAAM,QAAA,GAAW,EAAE,UAAU,KAAA,CAAM,QAAA,KAAa,EAAC;AAAA,IACrD,GAAI,MAAM,aAAA,GAAgB,EAAE,eAAe,KAAA,CAAM,aAAA,KAAkB,EAAC;AAAA,IACpE,GAAI,MAAM,OAAA,GAAU,EAAE,SAAS,KAAA,CAAM,OAAA,KAAY,EAAC;AAAA,IAClD,MAAA,EAAQ;AAAA,MACN,IAAA,EAAM,MAAA;AAAA,MACN,WAAA,EAAa,UAAA;AAAA,MACb,UAAA,EAAY;AAAA,QACV,OAAA,EAAS,KAAA;AAAA,QACT,IAAA,EAAM,CAAC,IAAA,EAAM,YAAA,EAAc,MAAM,MAAM;AAAA;AACzC,KACF;AAAA,IACA,KAAA,EAAO,KAAA,CAAM,KAAA,IAAS,EAAC;AAAA,IACvB,eAAA,EAAiB,KAAA;AAAA,IACjB,iBAAA,EAAmB,KAAA;AAAA,IACnB,GAAI,MAAM,QAAA,GAAW,EAAE,UAAU,KAAA,CAAM,QAAA,KAAa,EAAC;AAAA,IACrD,OAAA,EAAS,MAAM,OAAA,IAAW,KAAA;AAAA,IAC1B,aAAA,EAAe;AAAA,MACb,cAAA,EAAgB,UAAA;AAAA,MAChB,SAAA,EAAW,CAAC,QAAA,EAAU,OAAA,EAAS,OAAO,CAAA;AAAA,MACtC,QAAA,EAAU,EAAE,IAAA,EAAM,aAAA;AAAc;AAClC,GACF;AACF;AAOO,SAAS,mBAAmB,MAAA,EAAwB;AAEzD,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AACxC,EAAA,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA,YAAA,EAWK,UAAU,CAAA;AAAA;;AAAA;AAAA;AAAA;AAAA,CAAA;AAOxB","file":"chunk-GO2Y6H6U.js","sourcesContent":["// MCPB (Claude Desktop \"Extensions\" bundle) manifest + proxy generation.\n//\n// PURE — no filesystem, no child_process — so it's trivially testable. The\n// `writeMcpbBundle` Node helper (./build) layers fs + the official mcpb CLI on\n// top of these.\n//\n// The hard fact MCPB forces on you: it is STDIO-ONLY. The manifest's\n// `server.type` is one of `node` / `python` / `binary` / `uv` — there is no\n// `type: \"http\"`. So to bundle a REMOTE MCP server (what fancy-* apps almost\n// always are) you ship a thin `node` server whose `mcp_config` runs\n// `npx -y mcp-remote <url>`, bridging stdio→HTTP. The manifest validator still\n// requires `entry_point`, so an (otherwise unused) proxy stub is emitted too.\n//\n// Future-proof: when MCPB grows a real `type: \"http\"`, drop the proxy and point\n// straight at the URL — the call site here doesn't change.\n\n/** The MCPB manifest schema version this helper emits. */\nexport const MCPB_MANIFEST_VERSION = \"0.2\";\n\n/** Minimum Node the mcp-remote proxy needs on the user's machine. */\nexport const MCPB_MIN_NODE = \">=18.0.0\";\n\n/** A tool advertised in the bundle manifest (display-only metadata). */\nexport interface McpbTool {\n  name: string;\n  description?: string;\n}\n\n/** Inputs for {@link buildMcpbManifest} / `writeMcpbBundle`. */\nexport interface McpbManifestInput {\n  /** Machine name, e.g. `\"decksmith\"` (lowercase, no spaces). */\n  name: string;\n  /** Human display name, e.g. `\"Decksmith\"`. Defaults to `name`. */\n  display_name?: string;\n  /** Bundle version, e.g. `\"0.2.0\"`. */\n  version: string;\n  /** Short one-line description. */\n  description: string;\n  /** Optional longer description shown on the extension's detail view. */\n  long_description?: string;\n  author: { name: string; url?: string; email?: string };\n  homepage?: string;\n  documentation?: string;\n  support?: string;\n  /** The remote MCP endpoint the bundle proxies to. */\n  mcpUrl: string;\n  /** Advertised tools (display metadata only). */\n  tools?: McpbTool[];\n  keywords?: string[];\n  license?: string;\n  /** Entry-point path inside the bundle. Defaults to `\"server/proxy.js\"`. */\n  entryPoint?: string;\n}\n\n/** The default entry-point path the proxy stub is written to. */\nexport const DEFAULT_MCPB_ENTRY_POINT = \"server/proxy.js\";\n\n/**\n * Build the full MCPB `manifest.json` object for a remote MCP server, wrapping\n * it with `npx -y mcp-remote <url>` (stdio→HTTP). Returns a plain object ready\n * to `JSON.stringify`.\n */\nexport function buildMcpbManifest(\n  input: McpbManifestInput,\n): Record<string, unknown> {\n  const entryPoint = input.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;\n  return {\n    manifest_version: MCPB_MANIFEST_VERSION,\n    name: input.name,\n    display_name: input.display_name ?? input.name,\n    version: input.version,\n    description: input.description,\n    ...(input.long_description\n      ? { long_description: input.long_description }\n      : {}),\n    author: input.author,\n    ...(input.homepage ? { homepage: input.homepage } : {}),\n    ...(input.documentation ? { documentation: input.documentation } : {}),\n    ...(input.support ? { support: input.support } : {}),\n    server: {\n      type: \"node\",\n      entry_point: entryPoint,\n      mcp_config: {\n        command: \"npx\",\n        args: [\"-y\", \"mcp-remote\", input.mcpUrl],\n      },\n    },\n    tools: input.tools ?? [],\n    tools_generated: false,\n    prompts_generated: false,\n    ...(input.keywords ? { keywords: input.keywords } : {}),\n    license: input.license ?? \"MIT\",\n    compatibility: {\n      claude_desktop: \">=0.10.0\",\n      platforms: [\"darwin\", \"win32\", \"linux\"],\n      runtimes: { node: MCPB_MIN_NODE },\n    },\n  };\n}\n\n/**\n * The `server/proxy.js` stub. MCPB requires an `entry_point` file even though\n * `mcp_config.command` overrides it; if it ever DOES run, it spawns\n * `npx -y mcp-remote <url>` itself so the bundle still works.\n */\nexport function buildMcpbProxyStub(mcpUrl: string): string {\n  // JSON.stringify gives us a safely-quoted JS string literal for the URL.\n  const urlLiteral = JSON.stringify(mcpUrl);\n  return `#!/usr/bin/env node\n// MCPB proxy shim (generated by @particle-academy/agent-integrations).\n//\n// MCPB (Claude Desktop Extensions) only supports local stdio servers, but this\n// MCP server is a remote HTTP endpoint. The manifest's \\`mcp_config\\` invokes\n// \\`npx -y mcp-remote <url>\\` to bridge the gap — this file is the entry_point\n// fallback the manifest validator requires. If you're seeing this run,\n// mcp_config wasn't honored; spawn mcp-remote directly so the bundle still works.\n\nconst { spawn } = require(\"node:child_process\");\n\nconst url = ${urlLiteral};\nconst child = spawn(\"npx\", [\"-y\", \"mcp-remote\", url], { stdio: \"inherit\" });\n\nchild.on(\"exit\", (code) => process.exit(code ?? 0));\nprocess.on(\"SIGINT\", () => child.kill(\"SIGINT\"));\nprocess.on(\"SIGTERM\", () => child.kill(\"SIGTERM\"));\n`;\n}\n"]}

package/dist/connectors/build.d.cts

@@ -0,0 +1,56 @@
+import { M as McpbManifestInput } from '../mcpb-BXOrsRnv.cjs';
+export { a as McpbTool } from '../mcpb-BXOrsRnv.cjs';
+
+interface WriteMcpbBundleOptions {
+    /** Where to write the packed `.mcpb` (absolute or cwd-relative). */
+    outFile: string;
+    /** The manifest inputs (server name, version, mcpUrl, tools, …). */
+    manifest: McpbManifestInput;
+    /**
+     * The mcpb CLI to shell out to. Default: `["npx", "-y", "@anthropic-ai/mcpb"]`.
+     * Pass a locally-installed binary path (string) or argv (array) to avoid the
+     * npx network fetch.
+     */
+    mcpbBin?: string | string[];
+    /** Run `mcpb validate` before packing. Default true. */
+    validate?: boolean;
+    /** Keep the temp work dir instead of removing it (debugging). Default false. */
+    keepWorkDir?: boolean;
+    /** Working directory the CLI runs in. Default `process.cwd()`. */
+    cwd?: string;
+}
+interface WriteMcpbBundleResult {
+    /** Absolute path to the written `.mcpb`. */
+    outFile: string;
+    /** Size of the written bundle in bytes. */
+    bytes: number;
+    /** The manifest object that was packed. */
+    manifest: Record<string, unknown>;
+    /** The work dir used (returned even after cleanup, for logging). */
+    workDir: string;
+}
+/**
+ * Generate a `manifest.json` + `server/proxy.js` for a remote MCP server, then
+ * validate and pack them into a `.mcpb` using the official `@anthropic-ai/mcpb`
+ * CLI. Returns the output path + size.
+ *
+ * ```ts
+ * import { writeMcpbBundle } from "@particle-academy/agent-integrations/connectors/build";
+ *
+ * await writeMcpbBundle({
+ *   outFile: "public/decksmith.mcpb",
+ *   manifest: {
+ *     name: "decksmith",
+ *     display_name: "Decksmith",
+ *     version: "0.2.0",
+ *     description: "Agent-driven slide deck builder.",
+ *     author: { name: "Particle Academy", url: "https://decksmith.dev" },
+ *     mcpUrl: "https://decksmith.dev/mcp",
+ *     tools: [{ name: "start_session", description: "…" }],
+ *   },
+ * });
+ * ```
+ */
+declare function writeMcpbBundle(opts: WriteMcpbBundleOptions): Promise<WriteMcpbBundleResult>;
+
+export { McpbManifestInput, type WriteMcpbBundleOptions, type WriteMcpbBundleResult, writeMcpbBundle };

package/dist/connectors/build.d.ts

@@ -0,0 +1,56 @@
+import { M as McpbManifestInput } from '../mcpb-BXOrsRnv.js';
+export { a as McpbTool } from '../mcpb-BXOrsRnv.js';
+
+interface WriteMcpbBundleOptions {
+    /** Where to write the packed `.mcpb` (absolute or cwd-relative). */
+    outFile: string;
+    /** The manifest inputs (server name, version, mcpUrl, tools, …). */
+    manifest: McpbManifestInput;
+    /**
+     * The mcpb CLI to shell out to. Default: `["npx", "-y", "@anthropic-ai/mcpb"]`.
+     * Pass a locally-installed binary path (string) or argv (array) to avoid the
+     * npx network fetch.
+     */
+    mcpbBin?: string | string[];
+    /** Run `mcpb validate` before packing. Default true. */
+    validate?: boolean;
+    /** Keep the temp work dir instead of removing it (debugging). Default false. */
+    keepWorkDir?: boolean;
+    /** Working directory the CLI runs in. Default `process.cwd()`. */
+    cwd?: string;
+}
+interface WriteMcpbBundleResult {
+    /** Absolute path to the written `.mcpb`. */
+    outFile: string;
+    /** Size of the written bundle in bytes. */
+    bytes: number;
+    /** The manifest object that was packed. */
+    manifest: Record<string, unknown>;
+    /** The work dir used (returned even after cleanup, for logging). */
+    workDir: string;
+}
+/**
+ * Generate a `manifest.json` + `server/proxy.js` for a remote MCP server, then
+ * validate and pack them into a `.mcpb` using the official `@anthropic-ai/mcpb`
+ * CLI. Returns the output path + size.
+ *
+ * ```ts
+ * import { writeMcpbBundle } from "@particle-academy/agent-integrations/connectors/build";
+ *
+ * await writeMcpbBundle({
+ *   outFile: "public/decksmith.mcpb",
+ *   manifest: {
+ *     name: "decksmith",
+ *     display_name: "Decksmith",
+ *     version: "0.2.0",
+ *     description: "Agent-driven slide deck builder.",
+ *     author: { name: "Particle Academy", url: "https://decksmith.dev" },
+ *     mcpUrl: "https://decksmith.dev/mcp",
+ *     tools: [{ name: "start_session", description: "…" }],
+ *   },
+ * });
+ * ```
+ */
+declare function writeMcpbBundle(opts: WriteMcpbBundleOptions): Promise<WriteMcpbBundleResult>;
+
+export { McpbManifestInput, type WriteMcpbBundleOptions, type WriteMcpbBundleResult, writeMcpbBundle };