@particle-academy/agent-integrations 0.51.0 → 0.53.0

package/dist/chunk-7HHZBPDE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/screens.ts"],"names":[],"mappings":"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","file":"chunk-7HHZBPDE.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 { emitActivity } from \"../presence/registry\";\nimport type { AgentTarget } from \"../presence/types\";\nimport { commit, hostErrorMessage } from \"./host-commit\";\n\n/**\n * Loose snapshot of a screen — what's in fancy-screens' ScreenMeta plus\n * the host's optional activity status. Kept here so this bridge has no\n * hard dep on fancy-screens.\n */\nexport type ScreenSnapshot = {\n  id: string;\n  title?: string;\n  /** Whether this screen is the one the human / agent is looking at. */\n  active: boolean;\n  /** Optional category / kind (e.g. \"form\", \"whiteboard\"). */\n  kind?: string;\n};\n\n/**\n * Spec for a dynamically-created screen. The host's `createScreen`\n * implementation looks up `kind` in its template registry and instantiates\n * the matching surface (form / whiteboard / sheet / chart / markdown / etc.).\n */\nexport type ScreenCreateSpec = {\n  id: string;\n  title?: string;\n  /** Template kind. Hosts decide the catalog. */\n  kind: string;\n  /** Template-specific config. Form: { fields }. Sheet: { headers }. etc. */\n  config?: Record<string, unknown>;\n};\n\n/**\n * What a mutating adapter method may resolve to, to acknowledge (or refuse)\n * a commit. `{ ok: false }` is a refusal the agent can act on: `error` is\n * shown to the agent verbatim, so keep it a human-readable sentence, never a\n * stack trace or an internal path. `code` is a machine-readable hint\n * (e.g. `\"conflict\"`) for the host's own use; it is not shown to the agent.\n */\nexport type ScreensAdapterResult = { ok: true } | { ok: false; error: string; code?: string };\n\n/**\n * Return type of every mutating adapter method. A sync `void` return keeps\n * the original behaviour. A Promise makes the bridge WAIT: the tool reports\n * success, and emits its AgentActivity event, only after the promise\n * resolves. A rejection or an `{ ok: false }` result becomes an error result\n * and emits no activity.\n */\nexport type ScreensAdapterCommit = void | Promise<void | ScreensAdapterResult>;\n\n/**\n * Adapter exposes the host's screen-navigation surface to the bridge.\n * Hosts wire this up against react-router, a custom tab state, or the\n * fancy-screens registry — wherever \"current screen\" lives.\n *\n * The optional create / destroy / update hooks let agents author screens\n * dynamically against a host-defined template catalog.\n *\n * Every mutating method may be sync (`void`) or async (`Promise`); see\n * {@link ScreensAdapterCommit}. Return a Promise when the host's commit is\n * authoritative — persisted, or able to refuse or conflict — so the agent is\n * told the truth instead of \"success\" before anything was committed.\n *\n * This bridge pushes NO undo entries: `agent_undo` cannot revert a screens\n * tool. A host that needs undo for navigation or screen authoring must keep\n * its own history.\n */\nexport type ScreensBridgeAdapter = {\n  /** List every available screen. */\n  listScreens: () => ScreenSnapshot[];\n  /** Read which screen is currently active. */\n  getActive: () => string | null;\n  /** Navigate to a screen by id. Host updates router / tab state. */\n  setActive: (screenId: string) => ScreensAdapterCommit;\n  /** Optional: instantiate a new screen from a template + config. */\n  createScreen?: (spec: ScreenCreateSpec) => ScreensAdapterCommit;\n  /** Optional: remove a previously-created screen. */\n  destroyScreen?: (screenId: string) => ScreensAdapterCommit;\n  /** Optional: shallow-merge new config into an existing screen. */\n  updateScreenContent?: (screenId: string, partial: Record<string, unknown>) => ScreensAdapterCommit;\n  /** Optional: enumerate the kinds the host knows how to instantiate. */\n  listKinds?: () => Array<{ kind: string; label?: string; description?: string; configSchema?: unknown }>;\n};\n\nexport type ScreensBridgeOptions = {\n  adapter: ScreensBridgeAdapter;\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerScreensBridge — top-level navigation bridge so agents can\n * switch between screens (`screens_navigate`) and discover what surfaces\n * exist (`screens_list`, `screens_describe_active`).\n *\n * Pair with the per-surface bridges (whiteboard, form, sheet, etc.) so\n * the agent has both navigation and per-screen control.\n */\nexport function registerScreensBridge(\n  host: ToolHost,\n  options: ScreensBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n  // The bridge id is also its registrant identity on the host: the same bridge\n  // may re-register (a remount), a different one claiming a name is refused.\n  const bridgeId = \"screens\";\n\n  // agent_undo / agent_redo / agent_history are registered whenever any bridge\n  // mounts, so undo availability doesn't hinge on which bridges are co-present.\n  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });\n\n  const target = (screenId: string): AgentTarget => ({\n    kind: \"screens\",\n    screenId,\n    label: `Screen ${screenId}`,\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    targetFromArgs?: (args: JsonObject) => AgentTarget,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try { return await handler(args); }\n      catch (e) { return errorResult(hostErrorMessage(e, `${name} failed.`)); }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name, agent, kind: \"screens\",\n          resolveTarget: ({ args }) => targetFromArgs?.(args) ?? null,\n        })\n      : wrapped;\n    disposers.push(\n      host.registerTool(\n        { name, description, inputSchema: { type: \"object\", properties: properties as any, required, additionalProperties: false } },\n        final as any,\n        { owner: bridgeId },\n      ),\n    );\n  };\n\n  reg(\n    \"screens_list\",\n    \"List every screen the host has registered. Returns id, title, active flag, and optional kind.\",\n    {},\n    [],\n    () => {\n      const screens = adapter.listScreens();\n      const text = screens\n        .map((s) => `${s.active ? \"▸\" : \" \"} ${s.id}${s.title ? ` — ${s.title}` : \"\"}${s.kind ? ` [${s.kind}]` : \"\"}`)\n        .join(\"\\n\");\n      return textResult(text || \"(no screens)\", { screens, active: adapter.getActive() });\n    },\n    false,\n  );\n\n  reg(\n    \"screens_describe_active\",\n    \"Get the currently-active screen id (or null).\",\n    {},\n    [],\n    () => {\n      const active = adapter.getActive();\n      return textResult(active ?? \"(none)\", { active });\n    },\n    false,\n  );\n\n  reg(\n    \"screens_list_kinds\",\n    \"List the screen kinds (templates) the host knows how to instantiate. Use this before screens_create to know what's available.\",\n    {},\n    [],\n    () => {\n      if (!adapter.listKinds) return errorResult(\"Host did not register a kind catalog. Cannot create screens dynamically.\");\n      const kinds = adapter.listKinds();\n      const text = kinds.map((k) => `${k.kind}${k.label ? ` — ${k.label}` : \"\"}${k.description ? ` (${k.description})` : \"\"}`).join(\"\\n\");\n      return textResult(text || \"(no kinds registered)\", kinds);\n    },\n    false,\n  );\n\n  reg(\n    \"screens_create\",\n    \"Instantiate a new screen from a template kind + config. Switches the active view to the new screen.\",\n    {\n      id: { type: \"string\", description: \"Stable screen id. Must be unique.\" },\n      title: { type: \"string\" },\n      kind: { type: \"string\", description: \"Template kind — call screens_list_kinds for the catalog.\" },\n      config: { type: \"object\", description: \"Template-specific config (e.g. { fields: [...] } for a form).\" },\n    },\n    [\"id\", \"kind\"],\n    async (args) => {\n      const createScreen = adapter.createScreen;\n      if (!createScreen) return errorResult(\"Host did not provide createScreen.\");\n      const id = String(args.id);\n      const kind = String(args.kind);\n      if (adapter.listScreens().find((s) => s.id === id)) {\n        return errorResult(`Screen ${id} already exists. Use screens_destroy first or pick a fresh id.`);\n      }\n      const created = await commit(() => createScreen({\n        id,\n        title: typeof args.title === \"string\" ? args.title : undefined,\n        kind,\n        config: (args.config && typeof args.config === \"object\") ? args.config as Record<string, unknown> : undefined,\n      }), `Host failed to create screen \"${id}\".`);\n      // Nothing was created, so there is nothing to activate.\n      if (!created.ok) return errorResult(created.error);\n\n      const activated = await commit(() => adapter.setActive(id), `Host failed to activate screen \"${id}\".`);\n      if (!activated.ok) {\n        // Partial commit: the screen EXISTS but is not showing. Reported as an\n        // error so an agent branching on isError does not go on to tell the\n        // human \"look at the new screen\". The create DID commit, though, and\n        // every committed mutation must be observable, so its activity is\n        // emitted here by hand (wrapToolWithActivity skips error results).\n        const state = { id, kind, created: true, activated: false };\n        emitActivity({\n          agentId: agent.id,\n          agentName: agent.name,\n          agentColor: agent.color,\n          target: target(id),\n          action: \"screens_create\",\n          timestamp: Date.now(),\n          meta: state,\n        });\n        return {\n          ...errorResult(\n            `Screen \"${id}\" was created but not activated: ${activated.error} ` +\n              \"The screen exists; do not call screens_create again. \" +\n              \"Call screens_navigate to show it, or screens_destroy to remove it.\",\n          ),\n          structuredContent: state,\n        };\n      }\n      return textResult(`Created ${kind} screen \"${id}\"`, { id, kind });\n    },\n    true,\n    (args) => target(String(args.id ?? \"\")),\n  );\n\n  reg(\n    \"screens_destroy\",\n    \"Remove a previously-created screen. Active screen falls back to the first remaining one (or null).\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    async (args) => {\n      const destroyScreen = adapter.destroyScreen;\n      if (!destroyScreen) return errorResult(\"Host did not provide destroyScreen.\");\n      const id = String(args.id);\n      if (!adapter.listScreens().find((s) => s.id === id)) {\n        return errorResult(`No screen with id ${id}`);\n      }\n      const done = await commit(() => destroyScreen(id), `Host failed to destroy screen \"${id}\".`);\n      if (!done.ok) return errorResult(done.error);\n      return textResult(`Destroyed screen ${id}`, { id });\n    },\n    true,\n    (args) => target(String(args.id ?? \"\")),\n  );\n\n  reg(\n    \"screens_set_layout\",\n    \"Change the layout of an existing composite screen. Layouts: 'single', 'split-h' (left/right), 'split-v' (top/bottom), 'grid-2x2', 'stack' (tabs).\",\n    {\n      id: { type: \"string\" },\n      layout: { type: \"string\", enum: [\"single\", \"split-h\", \"split-v\", \"grid-2x2\", \"stack\"] },\n    },\n    [\"id\", \"layout\"],\n    async (args) => {\n      const updateScreenContent = adapter.updateScreenContent;\n      if (!updateScreenContent) return errorResult(\"Host did not provide updateScreenContent.\");\n      const id = String(args.id);\n      const done = await commit(\n        () => updateScreenContent(id, { layout: String(args.layout) }),\n        `Host failed to change the layout of screen \"${id}\".`,\n      );\n      if (!done.ok) return errorResult(done.error);\n      return textResult(`Layout of ${args.id} → ${args.layout}`, { id: args.id, layout: args.layout });\n    },\n    true,\n    (args) => target(String(args.id ?? \"\")),\n  );\n\n  reg(\n    \"screens_update_content\",\n    \"Merge new config into an existing screen (e.g. add a field to a form, append a sheet column, change chart series).\",\n    {\n      id: { type: \"string\" },\n      partial: { type: \"object\", description: \"Shallow-merged into the screen's config.\" },\n    },\n    [\"id\", \"partial\"],\n    async (args) => {\n      const updateScreenContent = adapter.updateScreenContent;\n      if (!updateScreenContent) return errorResult(\"Host did not provide updateScreenContent.\");\n      const id = String(args.id);\n      const partial = (args.partial && typeof args.partial === \"object\") ? args.partial as Record<string, unknown> : {};\n      const done = await commit(() => updateScreenContent(id, partial), `Host failed to update screen \"${id}\".`);\n      if (!done.ok) return errorResult(done.error);\n      return textResult(`Updated content of ${id}`, { id });\n    },\n    true,\n    (args) => target(String(args.id ?? \"\")),\n  );\n\n  reg(\n    \"screens_navigate\",\n    \"Switch the human's view to a different screen. The host updates its router / tab state and re-renders.\",\n    { screen: { type: \"string\", description: \"Screen id to activate.\" } },\n    [\"screen\"],\n    async (args) => {\n      const screenId = String(args.screen ?? \"\");\n      const screens = adapter.listScreens();\n      if (!screens.find((s) => s.id === screenId)) {\n        return errorResult(`No screen registered with id \"${screenId}\". Call screens_list first.`);\n      }\n      const done = await commit(() => adapter.setActive(screenId), `Host failed to navigate to screen \"${screenId}\".`);\n      if (!done.ok) return errorResult(done.error);\n      return textResult(`Navigated to ${screenId}`, { screen: screenId });\n    },\n    true,\n    (args) => target(String(args.screen ?? \"\")),\n  );\n\n  return {\n    id: bridgeId,\n    title: \"Screens\",\n    dispose: () => { for (const d of disposers) d(); },\n  };\n}\n"]}

package/dist/chunk-AET2R7DJ.js

@@ -0,0 +1,391 @@
+import { commit, hostErrorMessage } from './chunk-DPBAEWB5.js';
+import { ensureUndoToolsRegistered } from './chunk-ZDKYKJFH.js';
+import { wrapToolWithActivity } from './chunk-2VENWGLZ.js';
+import { emitActivity } from './chunk-C3TYI5TJ.js';
+import { textResult, errorResult } from './chunk-3GFKC6OK.js';
+
+// src/bridges/multi-instance.ts
+var routers = /* @__PURE__ */ new WeakMap();
+var quoteAll = (ids) => ids.map((id) => `"${id}"`).join(", ");
+function joinInstanceRouter(host, options, id, instance) {
+  if (typeof id !== "string" || id.trim() === "") {
+    throw new Error(
+      `A ${options.family} on a shared host needs a non-empty string id (got ${JSON.stringify(id)}); agents select it by that id through the "${options.argument}" argument.`
+    );
+  }
+  let byFamily = routers.get(host);
+  if (!byFamily) {
+    byFamily = /* @__PURE__ */ new Map();
+    routers.set(host, byFamily);
+  }
+  let state = byFamily.get(options.family);
+  if (!state) {
+    const instances = /* @__PURE__ */ new Map();
+    const router = {
+      ids: () => [...instances.keys()],
+      entries: () => [...instances.entries()],
+      resolve: (requested) => resolve(options, instances, requested)
+    };
+    const uninstall = options.install(router);
+    state = { instances, router, uninstall };
+    byFamily.set(options.family, state);
+  }
+  const current = state;
+  current.instances.set(id, instance);
+  let left = false;
+  const leave = () => {
+    if (left) return;
+    left = true;
+    if (current.instances.get(id) !== instance) return;
+    current.instances.delete(id);
+    if (current.instances.size === 0 && byFamily.get(options.family) === current) {
+      byFamily.delete(options.family);
+      current.uninstall();
+    }
+  };
+  return { router: current.router, leave };
+}
+function resolve(options, instances, requested) {
+  const ids = [...instances.keys()];
+  const { family, argument, listTool } = options;
+  if (requested === void 0 || requested === null || requested === "") {
+    if (ids.length === 1) return { ok: true, id: ids[0], instance: instances.get(ids[0]) };
+    if (ids.length === 0) return { ok: false, error: `No ${family} is mounted.` };
+    return {
+      ok: false,
+      error: `${ids.length} ${family}s are mounted, so pass "${argument}" with one of: ${quoteAll(ids)}. ${listTool} describes them.`
+    };
+  }
+  if (typeof requested !== "string") {
+    return { ok: false, error: `"${argument}" must be a ${family} id string. Mounted: ${quoteAll(ids)}.` };
+  }
+  if (!instances.has(requested)) {
+    return {
+      ok: false,
+      error: `No ${family} "${requested}" is mounted. ` + (ids.length ? `Mounted: ${quoteAll(ids)}. ` : "") + `${listTool} lists what is open.`
+    };
+  }
+  return { ok: true, id: requested, instance: instances.get(requested) };
+}
+
+// src/bridges/forms.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+var FORM_TOOLS_OWNER = "form-bridge";
+var FORM_ARG = {
+  type: "string",
+  description: "Id of the form to act on (see form_list). Optional while exactly one form is mounted; required when several are."
+};
+var FORM_TOOL_DEFS = [
+  {
+    name: "form_describe",
+    description: "Describe a form \u2014 fields, types, options, required flags. Call this first to know what's fillable.",
+    properties: {},
+    required: []
+  },
+  { name: "form_get_value", description: "Read a single field's current value.", properties: { field: { type: "string" } }, required: ["field"] },
+  { name: "form_get_values", description: "Read every field's current value as a JSON object.", properties: {}, required: [] },
+  {
+    name: "form_set_value",
+    description: "Set one field's value. The host's controlled state updates and the human sees the field change.",
+    properties: {
+      field: { type: "string" },
+      value: { description: "Value to set. Type depends on the field's `type`." }
+    },
+    required: ["field", "value"]
+  },
+  {
+    name: "form_set_values",
+    description: "Set multiple fields atomically. Pass a `values` object keyed by field name.",
+    properties: { values: { type: "object" } },
+    required: ["values"]
+  },
+  {
+    name: "form_focus",
+    description: "Move browser focus to a field (host-implemented). Useful before streaming text into it.",
+    properties: { field: { type: "string" } },
+    required: ["field"]
+  },
+  {
+    name: "form_submit",
+    description: "Submit the form. Host returns ok + values (or an error). In pendingMode this is staged for the human to confirm first.",
+    properties: {},
+    required: []
+  }
+];
+function installFormTools(host, router) {
+  const disposers = [];
+  try {
+    for (const def of FORM_TOOL_DEFS) {
+      disposers.push(
+        host.registerTool(
+          {
+            name: def.name,
+            description: def.description,
+            inputSchema: {
+              type: "object",
+              properties: { form: FORM_ARG, ...def.properties },
+              required: def.required,
+              additionalProperties: false
+            }
+          },
+          async (args) => {
+            const target = router.resolve(args?.form);
+            if (!target.ok) return errorResult(target.error);
+            return target.instance.handlers[def.name](args);
+          },
+          { owner: FORM_TOOLS_OWNER }
+        )
+      );
+    }
+    disposers.push(
+      host.registerTool(
+        {
+          name: "form_list",
+          description: "List the forms mounted on this host \u2014 id, title, screen and fields. Pass an id as `form` to the other form tools when more than one is mounted.",
+          inputSchema: { type: "object", properties: {}, additionalProperties: false }
+        },
+        () => {
+          try {
+            const forms = router.entries().map(([id, { adapter }]) => ({
+              id,
+              title: adapter.title,
+              screenId: adapter.screenId,
+              fields: adapter.getFields()
+            }));
+            const text = forms.map((f) => `${f.id}${f.title ? ` \u2014 ${f.title}` : ""}: ${f.fields.map((x) => x.name).join(", ") || "(no fields)"}`).join("\n");
+            return textResult(text || "(no forms)", { forms });
+          } catch (e) {
+            return errorResult(hostErrorMessage(e, "form_list failed."));
+          }
+        },
+        { owner: FORM_TOOLS_OWNER }
+      )
+    );
+  } catch (e) {
+    for (const d of disposers) d();
+    throw e;
+  }
+  return () => {
+    for (const d of disposers) d();
+  };
+}
+function registerFormBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? true;
+  const formId = adapter?.id == null ? "" : String(adapter.id);
+  if (formId.trim() === "") {
+    throw new Error(
+      "registerFormBridge: adapter.id must be a non-empty string. It is how agents pick this form (the `form` argument) when several forms share a host."
+    );
+  }
+  const bridgeId = `form:${formId}`;
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const handlers = {};
+  let disposed = false;
+  const onDispose = /* @__PURE__ */ new Set();
+  const CLOSED = /* @__PURE__ */ Symbol("form-closed");
+  const untilClosed = (p) => {
+    if (disposed) {
+      p.catch(() => {
+      });
+      return Promise.resolve(CLOSED);
+    }
+    return new Promise((resolve2, reject) => {
+      const close = () => resolve2(CLOSED);
+      onDispose.add(close);
+      p.then(
+        (v) => {
+          onDispose.delete(close);
+          resolve2(v);
+        },
+        (e) => {
+          onDispose.delete(close);
+          reject(e);
+        }
+      );
+    });
+  };
+  const closedUnknown = (what) => errorResult(
+    `Form "${formId}" was closed before the host confirmed ${what}, so whether it was applied is unknown. Do not assume it was. If the form is open again, read it back (form_get_values) before retrying.`
+  );
+  const target = (args) => ({
+    kind: "form",
+    screenId: adapter.screenId,
+    elementId: typeof args?.field === "string" ? `${formId}:${args.field}` : formId,
+    label: typeof args?.field === "string" ? `${adapter.title ?? formId} \u2192 ${args.field}` : adapter.title ?? formId
+  });
+  const reg = (name, handler, isMutation) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(hostErrorMessage(e, `${name} failed.`));
+      }
+    };
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent: { id: agent.id, name: agent.name, color: agent.color },
+      kind: "form",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => target(args)
+    }) : wrapped;
+    handlers[name] = final;
+  };
+  reg(
+    "form_describe",
+    () => {
+      const fields = adapter.getFields();
+      const text = fields.map((f) => `${f.name}${f.required ? "*" : ""} (${f.type})${f.label ? ` \u2014 ${f.label}` : ""}`).join("\n");
+      return textResult(text || "(no fields)", { id: formId, title: adapter.title, fields });
+    },
+    false
+  );
+  reg(
+    "form_get_value",
+    (args) => {
+      const name = String(args.field ?? "");
+      if (!adapter.getFields().find((f) => f.name === name)) {
+        return errorResult(`Unknown field: ${name}`);
+      }
+      const value = adapter.getValue(name);
+      return textResult(JSON.stringify(value), { field: name, value });
+    },
+    false
+  );
+  reg(
+    "form_get_values",
+    () => {
+      const values = adapter.getValues();
+      return textResult(JSON.stringify(values, null, 2), values);
+    },
+    false
+  );
+  reg(
+    "form_set_value",
+    async (args) => {
+      const name = String(args.field ?? "");
+      const fieldDef = adapter.getFields().find((f) => f.name === name);
+      if (!fieldDef) return errorResult(`Unknown field: ${name}`);
+      const done = await untilClosed(
+        commit(() => adapter.setValue(name, args.value), `Host refused the write to "${name}".`)
+      );
+      if (done === CLOSED) return closedUnknown(`the write to "${name}"`);
+      if (!done.ok) return errorResult(done.error);
+      return textResult(`${name} \u2190 ${JSON.stringify(args.value)}`, { field: name, value: args.value });
+    },
+    true
+  );
+  reg(
+    "form_set_values",
+    async (args) => {
+      const values = args.values && typeof args.values === "object" ? args.values : {};
+      const fields = adapter.getFields();
+      const known = new Set(fields.map((f) => f.name));
+      const unknownKeys = Object.keys(values).filter((k) => !known.has(k));
+      if (unknownKeys.length) return errorResult(`Unknown fields: ${unknownKeys.join(", ")}`);
+      const setValues = adapter.setValues;
+      if (setValues) {
+        const done = await untilClosed(commit(() => setValues(values), "Host refused the write."));
+        if (done === CLOSED) return closedUnknown("the write");
+        if (!done.ok) return errorResult(done.error);
+      } else {
+        const keys = Object.keys(values);
+        const committed = [];
+        for (const [i, k] of keys.entries()) {
+          const done = await untilClosed(
+            commit(() => adapter.setValue(k, values[k]), `Host refused the write to "${k}".`)
+          );
+          if (done === CLOSED) {
+            return {
+              ...closedUnknown(`the write to "${k}"`),
+              structuredContent: { committed, pending: k, notAttempted: keys.slice(i + 1) }
+            };
+          }
+          if (!done.ok) {
+            const state = { committed, failed: k, notAttempted: keys.slice(i + 1) };
+            if (committed.length) {
+              emitActivity({
+                agentId: agent.id,
+                agentName: agent.name,
+                agentColor: agent.color,
+                target: target({}),
+                action: "form_set_values",
+                timestamp: Date.now(),
+                meta: state
+              });
+            }
+            return {
+              ...errorResult(
+                `"${k}" was refused: ${done.error} ` + (committed.length ? `Already committed and NOT rolled back: ${committed.join(", ")}. ` : "Nothing was committed. ") + (state.notAttempted.length ? `Not attempted: ${state.notAttempted.join(", ")}.` : "")
+              ),
+              structuredContent: state
+            };
+          }
+          committed.push(k);
+        }
+      }
+      return textResult(`Set ${Object.keys(values).length} field(s)`, { values });
+    },
+    true
+  );
+  reg(
+    "form_focus",
+    (args) => {
+      const name = String(args.field ?? "");
+      if (!adapter.focus) return errorResult("Host did not provide a focus implementation.");
+      if (!adapter.getFields().find((f) => f.name === name)) {
+        return errorResult(`Unknown field: ${name}`);
+      }
+      adapter.focus(name);
+      return textResult(`Focused ${name}`, { field: name });
+    },
+    true
+  );
+  reg(
+    "form_submit",
+    async () => {
+      if (!adapter.submit) return errorResult("Host did not provide a submit implementation.");
+      if (pendingMode && adapter.confirm) {
+        const confirm = adapter.confirm;
+        const ok = await untilClosed(Promise.resolve().then(() => confirm({
+          action: "submit",
+          form: formId,
+          title: adapter.title,
+          values: adapter.getValues()
+        })));
+        if (ok === CLOSED) {
+          return errorResult(`Form "${formId}" was closed before the submit was confirmed. Nothing was submitted.`);
+        }
+        if (!ok) return errorResult("Declined by user");
+      }
+      const submit = adapter.submit;
+      const result = await untilClosed(Promise.resolve().then(() => submit()));
+      if (result === CLOSED) return closedUnknown("the submit");
+      if (!result.ok) return errorResult(hostErrorMessage(result.error, "Submit failed"));
+      return textResult("Submitted", { values: result.values });
+    },
+    true
+  );
+  const membership = joinInstanceRouter(
+    host,
+    { family: "form", argument: "form", listTool: "form_list", install: (router) => installFormTools(host, router) },
+    formId,
+    { adapter, handlers }
+  );
+  return {
+    id: bridgeId,
+    title: adapter.title ?? formId,
+    dispose: () => {
+      if (disposed) return;
+      disposed = true;
+      membership.leave();
+      for (const close of [...onDispose]) close();
+      onDispose.clear();
+    }
+  };
+}
+
+export { registerFormBridge };
+//# sourceMappingURL=chunk-AET2R7DJ.js.map
+//# sourceMappingURL=chunk-AET2R7DJ.js.map

package/dist/chunk-AET2R7DJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/multi-instance.ts","../src/bridges/forms.ts"],"names":["resolve"],"mappings":"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","file":"chunk-AET2R7DJ.js","sourcesContent":["import type { ToolHost } from \"../mcp/tool-host\";\n\n/**\n * One bridge serving N instances on a host (docs/multi-form-hosts.md, option A).\n * Internal: not an entry point.\n *\n * A bridge whose tool names are not scoped to its adapter (`form_set_value`,\n * not `form_billing_set_value`) can only serve one instance per host unless the\n * instances share the tools. This is the sharing: the FIRST instance of a family\n * on a host installs the family's tools; later ones join a per-host router; each\n * tool resolves its target instance from an argument (`form`); the tools are\n * withdrawn when the last instance leaves. The tool list therefore stays the\n * same size however many instances come and go.\n *\n * Resolution rules, which are the agent-facing contract:\n *  - exactly one instance mounted: the argument is optional;\n *  - two or more: a call without it is refused with the ids listed;\n *  - an id that is not mounted is refused with the ids listed, even when only\n *    one is mounted (a call aimed at a form that closed must not land on another).\n *\n * The router does not register tools itself. `install` does, under one owner\n * the bridge chooses, so the 0.51.0 refusal still stops an unrelated registrant\n * taking a family tool name. If `install` throws (a name is already held), no\n * router is left behind.\n */\n\nexport type InstanceResolution<T> =\n  | { ok: true; id: string; instance: T }\n  | { ok: false; error: string };\n\nexport type InstanceRouter<T> = {\n  /** Mounted instance ids, in mount order. */\n  ids(): string[];\n  /** Mounted instances, in mount order. */\n  entries(): Array<[string, T]>;\n  /** Pick the instance a tool call targets, from the raw argument value. */\n  resolve(requested: unknown): InstanceResolution<T>;\n};\n\nexport type InstanceRouterOptions<T> = {\n  /** Family key: one router per (host, family). E.g. \"form\". */\n  family: string;\n  /** Name of the tool argument that selects an instance. E.g. \"form\". */\n  argument: string;\n  /** The family's listing tool, named in errors so an agent can recover. E.g. \"form_list\". */\n  listTool: string;\n  /**\n   * Register the family's shared tools on `host`, dispatching through `router`.\n   * Called once, when the first instance joins. Returns the disposer that\n   * withdraws them, called when the last instance leaves.\n   */\n  install: (router: InstanceRouter<T>) => () => void;\n};\n\nexport type InstanceMembership<T> = {\n  router: InstanceRouter<T>;\n  /** Remove THIS instance. Idempotent; a no-op if a later join replaced it. */\n  leave: () => void;\n};\n\ntype RouterState<T> = {\n  instances: Map<string, T>;\n  router: InstanceRouter<T>;\n  uninstall: () => void;\n};\n\nconst routers = new WeakMap<ToolHost, Map<string, RouterState<unknown>>>();\n\nconst quoteAll = (ids: string[]) => ids.map((id) => `\"${id}\"`).join(\", \");\n\n/**\n * Join `instance` under `id` to the host's router for `options.family`,\n * creating (and installing) the router if this is the first instance.\n *\n * A second join under an id that is already mounted REPLACES that entry: it\n * cannot be told apart from a remount whose cleanup has not run yet, and the\n * earlier membership's `leave` then becomes a no-op, so a late cleanup cannot\n * take the newer instance down.\n */\nexport function joinInstanceRouter<T>(\n  host: ToolHost,\n  options: InstanceRouterOptions<T>,\n  id: string,\n  instance: T,\n): InstanceMembership<T> {\n  if (typeof id !== \"string\" || id.trim() === \"\") {\n    throw new Error(\n      `A ${options.family} on a shared host needs a non-empty string id (got ${JSON.stringify(id)}); `\n        + `agents select it by that id through the \"${options.argument}\" argument.`,\n    );\n  }\n\n  let byFamily = routers.get(host);\n  if (!byFamily) {\n    byFamily = new Map();\n    routers.set(host, byFamily);\n  }\n\n  let state = byFamily.get(options.family) as RouterState<T> | undefined;\n  if (!state) {\n    const instances = new Map<string, T>();\n    const router: InstanceRouter<T> = {\n      ids: () => [...instances.keys()],\n      entries: () => [...instances.entries()],\n      resolve: (requested) => resolve(options, instances, requested),\n    };\n    // Installing may throw (a tool name held by an unrelated registrant). Nothing\n    // has been recorded yet, so a failed install leaves no router behind.\n    const uninstall = options.install(router);\n    state = { instances, router, uninstall };\n    byFamily.set(options.family, state as RouterState<unknown>);\n  }\n\n  const current = state;\n  current.instances.set(id, instance);\n  // Re-insertion keeps Map order; a remount should not jump the listing order.\n\n  let left = false;\n  const leave = () => {\n    if (left) return;\n    left = true;\n    if (current.instances.get(id) !== instance) return; // replaced by a later join\n    current.instances.delete(id);\n    if (current.instances.size === 0 && byFamily!.get(options.family) === current) {\n      byFamily!.delete(options.family);\n      current.uninstall();\n    }\n  };\n\n  return { router: current.router, leave };\n}\n\nfunction resolve<T>(\n  options: InstanceRouterOptions<T>,\n  instances: Map<string, T>,\n  requested: unknown,\n): InstanceResolution<T> {\n  const ids = [...instances.keys()];\n  const { family, argument, listTool } = options;\n  if (requested === undefined || requested === null || requested === \"\") {\n    if (ids.length === 1) return { ok: true, id: ids[0], instance: instances.get(ids[0]) as T };\n    if (ids.length === 0) return { ok: false, error: `No ${family} is mounted.` };\n    return {\n      ok: false,\n      error:\n        `${ids.length} ${family}s are mounted, so pass \"${argument}\" with one of: ${quoteAll(ids)}. `\n        + `${listTool} describes them.`,\n    };\n  }\n  if (typeof requested !== \"string\") {\n    return { ok: false, error: `\"${argument}\" must be a ${family} id string. Mounted: ${quoteAll(ids)}.` };\n  }\n  if (!instances.has(requested)) {\n    return {\n      ok: false,\n      error:\n        `No ${family} \"${requested}\" is mounted. `\n        + (ids.length ? `Mounted: ${quoteAll(ids)}. ` : \"\")\n        + `${listTool} lists what is open.`,\n    };\n  }\n  return { ok: true, id: requested, instance: instances.get(requested) as T };\n}\n","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\";\nimport { emitActivity } from \"../presence/registry\";\nimport { commit, hostErrorMessage } from \"./host-commit\";\nimport { joinInstanceRouter, type InstanceRouter } from \"./multi-instance\";\nimport type { CallToolResult } from \"../mcp/types\";\n\n/**\n * Field descriptor — what the host says about each form field. Mirrors the\n * subset of HTML / react-fancy input shapes agents care about.\n */\nexport type FormFieldDescriptor = {\n  /** Form-local field name. Matches the key the host uses in its values map. */\n  name: string;\n  /** Display label. */\n  label?: string;\n  /** Logical type. Drives validation + agent expectations. */\n  type:\n    | \"text\"\n    | \"textarea\"\n    | \"number\"\n    | \"email\"\n    | \"password\"\n    | \"url\"\n    | \"date\"\n    | \"select\"\n    | \"multi-select\"\n    | \"checkbox\"\n    | \"switch\"\n    | \"radio\"\n    | \"file\"\n    | \"json\";\n  /** Allowed values for select / radio. */\n  options?: Array<{ value: string; label: string }>;\n  /** Whether the field must be filled before submit. */\n  required?: boolean;\n  /** Free-text hint surfaced to the agent. */\n  description?: string;\n  /** Default value (presented in get_value when nothing set). */\n  defaultValue?: unknown;\n};\n\n/**\n * Adapter the host wires per form. Matches the controlled-state pattern\n * react-fancy already uses (`value` / `onValueChange`); this adapter just\n * exposes those state slots in a form-shaped way the bridge can call.\n *\n * `setValue` / `setValues` may be sync (`void`) or async (a Promise); see\n * {@link FormAdapterCommit}. Return a Promise when the host's write is\n * authoritative — a persisted draft, or one the host can refuse or report\n * stale — so the agent is told the truth instead of \"success\" before anything\n * was accepted.\n *\n * This bridge pushes NO undo entries: `agent_undo` cannot revert a form write.\n */\nexport type FormBridgeAdapter = {\n  /** Stable id for the form (used in form_describe + presence target). */\n  id: string;\n  /** Display title for human-readable logs. */\n  title?: string;\n  /** Optional fancy-screens screen id this form belongs to. */\n  screenId?: string;\n  /** Field descriptors. The bridge uses these for schema introspection\n   *  (form_describe). Agents call this first to know what to fill. */\n  getFields: () => FormFieldDescriptor[];\n  /** Read a single field's current value. */\n  getValue: (name: string) => unknown;\n  /** Read all values as { fieldName: value }. */\n  getValues: () => Record<string, unknown>;\n  /**\n   * Set a single field's value. The host wires this to its setState, or to\n   * an authoritative write it awaits. Sync `void` behaves as it always has; a\n   * Promise is awaited, and a rejection or `{ ok: false }` is the tool's error.\n   */\n  setValue: (name: string, value: unknown) => FormAdapterCommit;\n  /**\n   * Set many at once, ideally as one host commit. Same sync/async contract as\n   * `setValue`. When absent, the bridge awaits `setValue` once per field in\n   * order and stops at the first refusal (so that path is NOT atomic).\n   */\n  setValues?: (values: Record<string, unknown>) => FormAdapterCommit;\n  /** Programmatically focus a field (host implements DOM focus). Optional. */\n  focus?: (name: string) => void;\n  /** Submit the form. Returns the values that were submitted (or rejection). */\n  submit?: () => Promise<{ ok: boolean; values?: Record<string, unknown>; error?: string }>;\n  /**\n   * Human confirm gate for `form_submit` (trust-but-verify). When `pendingMode`\n   * is on, the bridge calls this before submitting; return false to decline.\n   * Wire it to a human control — submitting a form is a human-visible,\n   * often-destructive action (checkout, delete, invite).\n   */\n  confirm?: (request: FormConfirmRequest) => Promise<boolean> | boolean;\n};\n\n/**\n * What an async `setValue` / `setValues` may resolve to, to acknowledge (or\n * refuse) a write. `{ ok: false }` is a refusal the agent can act on: `error`\n * is shown to the agent verbatim, so keep it a human-readable sentence (e.g.\n * \"Draft changed since you read it; re-read and retry\"), never a stack trace or\n * an internal path. `code` (e.g. `\"stale\"`, `\"forbidden\"`) is for the host's own\n * use; it is not shown to the agent.\n */\nexport type FormAdapterResult = { ok: true } | { ok: false; error: string; code?: string };\n\n/**\n * Return type of `setValue` / `setValues`. A sync `void` return keeps the\n * original behaviour. A Promise makes the bridge WAIT: the tool reports\n * success, and emits its AgentActivity event, only after the promise resolves\n * (to `void` or `{ ok: true }`). A rejection or `{ ok: false }` becomes that\n * tool call's error result and emits no activity. If the bridge is disposed\n * while the write is pending, the call settles at once as an error saying the\n * outcome is unknown, and a later settle is ignored.\n */\nexport type FormAdapterCommit = void | Promise<void | FormAdapterResult>;\n\n/** What a `form_submit` confirm gate is asked to approve. */\nexport type FormConfirmRequest = {\n  action: \"submit\";\n  form: string;\n  title?: string;\n  values: Record<string, unknown>;\n};\n\nexport type FormBridgeOptions = {\n  adapter: FormBridgeAdapter;\n  /** Identity tagged into activity events. */\n  agent?: { id: string; name?: string; color?: string };\n  /**\n   * Stage `form_submit` for human confirmation via `adapter.confirm` instead of\n   * submitting immediately. **Default: ON** (matches the navigation bridge and\n   * the Human+ trust-but-verify contract). Set false only when auto-submit is\n   * safe. If on without an `adapter.confirm`, submit proceeds (nothing to gate).\n   */\n  pendingMode?: boolean;\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * The one registrant every form tool is held by. The tools are shared by all\n * forms on a host, so the forms themselves are not separate registrants; an\n * UNRELATED registrant claiming a form tool name is still refused (0.51.0).\n */\nconst FORM_TOOLS_OWNER = \"form-bridge\";\n\n/** Every form tool except `form_list` selects its form through this argument. */\nconst FORM_ARG = {\n  type: \"string\",\n  description: \"Id of the form to act on (see form_list). Optional while exactly one form is mounted; required when several are.\",\n};\n\ntype FormToolDef = {\n  name: string;\n  description: string;\n  properties: Record<string, unknown>;\n  required: string[];\n};\n\n/** The shared tool surface, registered once per host however many forms mount. */\nconst FORM_TOOL_DEFS: FormToolDef[] = [\n  {\n    name: \"form_describe\",\n    description: \"Describe a form — fields, types, options, required flags. Call this first to know what's fillable.\",\n    properties: {},\n    required: [],\n  },\n  { name: \"form_get_value\", description: \"Read a single field's current value.\", properties: { field: { type: \"string\" } }, required: [\"field\"] },\n  { name: \"form_get_values\", description: \"Read every field's current value as a JSON object.\", properties: {}, required: [] },\n  {\n    name: \"form_set_value\",\n    description: \"Set one field's value. The host's controlled state updates and the human sees the field change.\",\n    properties: {\n      field: { type: \"string\" },\n      value: { description: \"Value to set. Type depends on the field's `type`.\" },\n    },\n    required: [\"field\", \"value\"],\n  },\n  {\n    name: \"form_set_values\",\n    description: \"Set multiple fields atomically. Pass a `values` object keyed by field name.\",\n    properties: { values: { type: \"object\" } },\n    required: [\"values\"],\n  },\n  {\n    name: \"form_focus\",\n    description: \"Move browser focus to a field (host-implemented). Useful before streaming text into it.\",\n    properties: { field: { type: \"string\" } },\n    required: [\"field\"],\n  },\n  {\n    name: \"form_submit\",\n    description: \"Submit the form. Host returns ok + values (or an error). In pendingMode this is staged for the human to confirm first.\",\n    properties: {},\n    required: [],\n  },\n];\n\ntype FormHandler = (args: JsonObject) => Promise<CallToolResult>;\n\n/** One mounted form: its adapter plus handlers built with ITS options. */\ntype FormInstance = {\n  adapter: FormBridgeAdapter;\n  handlers: Record<string, FormHandler>;\n};\n\n/** Register the shared form tools on `host`, routing each call to one form. */\nfunction installFormTools(host: ToolHost, router: InstanceRouter<FormInstance>): () => void {\n  const disposers: Array<() => void> = [];\n  try {\n    for (const def of FORM_TOOL_DEFS) {\n      disposers.push(\n        host.registerTool(\n          {\n            name: def.name,\n            description: def.description,\n            inputSchema: {\n              type: \"object\",\n              properties: { form: FORM_ARG, ...def.properties } as any,\n              required: def.required,\n              additionalProperties: false,\n            },\n          },\n          async (args) => {\n            const target = router.resolve(args?.form);\n            if (!target.ok) return errorResult(target.error);\n            return target.instance.handlers[def.name](args);\n          },\n          { owner: FORM_TOOLS_OWNER },\n        ),\n      );\n    }\n    disposers.push(\n      host.registerTool(\n        {\n          name: \"form_list\",\n          description:\n            \"List the forms mounted on this host — id, title, screen and fields. Pass an id as `form` to the other form tools when more than one is mounted.\",\n          inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n        },\n        () => {\n          try {\n            const forms = router.entries().map(([id, { adapter }]) => ({\n              id,\n              title: adapter.title,\n              screenId: adapter.screenId,\n              fields: adapter.getFields(),\n            }));\n            const text = forms\n              .map((f) => `${f.id}${f.title ? ` — ${f.title}` : \"\"}: ${f.fields.map((x) => x.name).join(\", \") || \"(no fields)\"}`)\n              .join(\"\\n\");\n            return textResult(text || \"(no forms)\", { forms });\n          } catch (e) {\n            return errorResult(hostErrorMessage(e, \"form_list failed.\"));\n          }\n        },\n        { owner: FORM_TOOLS_OWNER },\n      ),\n    );\n  } catch (e) {\n    // A name was held by an unrelated registrant: withdraw what did register,\n    // so a refused mount leaves nothing half-installed.\n    for (const d of disposers) d();\n    throw e;\n  }\n  return () => {\n    for (const d of disposers) d();\n  };\n}\n\n/**\n * registerFormBridge — wires schema-driven MCP access to a form.\n *\n * Several forms may share one host. The first form on a host registers the\n * form tools; later ones JOIN them (since 0.53.0; before, a second form threw).\n * Each tool takes an optional `form` argument naming the form by `adapter.id`:\n * optional while exactly one form is mounted, so a single-form host behaves as\n * it always did, and required once two or more are. `form_list` lists what is\n * mounted. The returned `dispose()` removes only this form; the tools are\n * withdrawn when the last form on the host is disposed. A second registration\n * with an id that is already mounted replaces it (a remount); the earlier\n * registration's `dispose()` then leaves the newer one in place.\n *\n * `pendingMode`, the confirm gate, the agent identity and the activity target\n * stay per form. See `docs/multi-form-hosts.md`.\n */\nexport function registerFormBridge(\n  host: ToolHost,\n  options: FormBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const pendingMode = options.pendingMode ?? true;\n  const formId = adapter?.id == null ? \"\" : String(adapter.id);\n  if (formId.trim() === \"\") {\n    throw new Error(\n      \"registerFormBridge: adapter.id must be a non-empty string. It is how agents pick this form \" +\n        \"(the `form` argument) when several forms share a host.\",\n    );\n  }\n  // Surfaces in activity logs; per form, as before.\n  const bridgeId = `form:${formId}`;\n\n  // agent_undo / agent_redo / agent_history are registered whenever any bridge\n  // mounts, so undo availability doesn't hinge on which bridges are co-present.\n  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });\n  const handlers: Record<string, FormHandler> = {};\n\n  // Close handling. A host may dispose the bridge (the form unmounts) while a\n  // write or a human confirm is still pending; its promise may then never\n  // settle. Every awaited host call is raced against dispose, so the tool call\n  // settles at once instead of hanging, and a late settle is ignored.\n  let disposed = false;\n  const onDispose = new Set<() => void>();\n  const CLOSED: unique symbol = Symbol(\"form-closed\");\n  const untilClosed = <T>(p: Promise<T>): Promise<T | typeof CLOSED> => {\n    if (disposed) {\n      p.catch(() => {}); // a late rejection must never be unhandled\n      return Promise.resolve(CLOSED);\n    }\n    return new Promise<T | typeof CLOSED>((resolve, reject) => {\n      const close = () => resolve(CLOSED);\n      onDispose.add(close);\n      p.then(\n        (v) => { onDispose.delete(close); resolve(v); },\n        (e) => { onDispose.delete(close); reject(e); },\n      );\n    });\n  };\n  const closedUnknown = (what: string) =>\n    errorResult(\n      `Form \"${formId}\" was closed before the host confirmed ${what}, so whether it was applied is unknown. ` +\n        \"Do not assume it was. If the form is open again, read it back (form_get_values) before retrying.\",\n    );\n\n  const target =(args: any): AgentTarget => ({\n    kind: \"form\",\n    screenId: adapter.screenId,\n    elementId: typeof args?.field === \"string\" ? `${formId}:${args.field}` : formId,\n    label: typeof args?.field === \"string\"\n      ? `${adapter.title ?? formId} → ${args.field}`\n      : adapter.title ?? formId,\n  });\n\n  // Builds THIS form's handler for a shared tool. The tool definitions live in\n  // FORM_TOOL_DEFS; the router dispatches to these after resolving `form`.\n  const reg = (\n    name: string,\n    handler: (args: JsonObject) => Promise<any> | any,\n    isMutation: boolean,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try {\n        return await handler(args);\n      } catch (e) {\n        return errorResult(hostErrorMessage(e, `${name} failed.`));\n      }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent: { id: agent.id, name: agent.name, color: agent.color },\n          kind: \"form\",\n          screenId: adapter.screenId,\n          resolveTarget: ({ args }) => target(args),\n        })\n      : wrapped;\n    handlers[name] = final as FormHandler;\n  };\n\n  // ───────────── Read tools ─────────────\n\n  reg(\n    \"form_describe\",\n    () => {\n      const fields = adapter.getFields();\n      const text = fields\n        .map((f) => `${f.name}${f.required ? \"*\" : \"\"} (${f.type})${f.label ? ` — ${f.label}` : \"\"}`)\n        .join(\"\\n\");\n      return textResult(text || \"(no fields)\", { id: formId, title: adapter.title, fields });\n    },\n    false,\n  );\n\n  reg(\n    \"form_get_value\",\n    (args) => {\n      const name = String(args.field ?? \"\");\n      if (!adapter.getFields().find((f) => f.name === name)) {\n        return errorResult(`Unknown field: ${name}`);\n      }\n      const value = adapter.getValue(name);\n      return textResult(JSON.stringify(value), { field: name, value });\n    },\n    false,\n  );\n\n  reg(\n    \"form_get_values\",\n    () => {\n      const values = adapter.getValues();\n      return textResult(JSON.stringify(values, null, 2), values);\n    },\n    false,\n  );\n\n  // ───────────── Mutation tools ─────────────\n\n  reg(\n    \"form_set_value\",\n    async (args) => {\n      const name = String(args.field ?? \"\");\n      const fieldDef = adapter.getFields().find((f) => f.name === name);\n      if (!fieldDef) return errorResult(`Unknown field: ${name}`);\n      const done = await untilClosed(\n        commit(() => adapter.setValue(name, args.value), `Host refused the write to \"${name}\".`),\n      );\n      if (done === CLOSED) return closedUnknown(`the write to \"${name}\"`);\n      if (!done.ok) return errorResult(done.error);\n      return textResult(`${name} ← ${JSON.stringify(args.value)}`, { field: name, value: args.value });\n    },\n    true,\n  );\n\n  reg(\n    \"form_set_values\",\n    async (args) => {\n      const values = (args.values && typeof args.values === \"object\") ? args.values as Record<string, unknown> : {};\n      const fields = adapter.getFields();\n      const known = new Set(fields.map((f) => f.name));\n      const unknownKeys = Object.keys(values).filter((k) => !known.has(k));\n      if (unknownKeys.length) return errorResult(`Unknown fields: ${unknownKeys.join(\", \")}`);\n      const setValues = adapter.setValues;\n      if (setValues) {\n        const done = await untilClosed(commit(() => setValues(values), \"Host refused the write.\"));\n        if (done === CLOSED) return closedUnknown(\"the write\");\n        if (!done.ok) return errorResult(done.error);\n      } else {\n        // No batch setter: one host commit per field, in order, stopping at the\n        // first refusal. Earlier fields stay committed, so say exactly which.\n        const keys = Object.keys(values);\n        const committed: string[] = [];\n        for (const [i, k] of keys.entries()) {\n          const done = await untilClosed(\n            commit(() => adapter.setValue(k, values[k]), `Host refused the write to \"${k}\".`),\n          );\n          if (done === CLOSED) {\n            return {\n              ...closedUnknown(`the write to \"${k}\"`),\n              structuredContent: { committed, pending: k, notAttempted: keys.slice(i + 1) },\n            };\n          }\n          if (!done.ok) {\n            const state = { committed, failed: k, notAttempted: keys.slice(i + 1) };\n            if (committed.length) {\n              // Those writes DID commit; every committed mutation is observable,\n              // and wrapToolWithActivity skips error results, so emit it here.\n              emitActivity({\n                agentId: agent.id,\n                agentName: agent.name,\n                agentColor: agent.color,\n                target: target({}),\n                action: \"form_set_values\",\n                timestamp: Date.now(),\n                meta: state,\n              });\n            }\n            return {\n              ...errorResult(\n                `\"${k}\" was refused: ${done.error} ` +\n                  (committed.length\n                    ? `Already committed and NOT rolled back: ${committed.join(\", \")}. `\n                    : \"Nothing was committed. \") +\n                  (state.notAttempted.length ? `Not attempted: ${state.notAttempted.join(\", \")}.` : \"\"),\n              ),\n              structuredContent: state,\n            };\n          }\n          committed.push(k);\n        }\n      }\n      return textResult(`Set ${Object.keys(values).length} field(s)`, { values });\n    },\n    true,\n  );\n\n  reg(\n    \"form_focus\",\n    (args) => {\n      const name = String(args.field ?? \"\");\n      if (!adapter.focus) return errorResult(\"Host did not provide a focus implementation.\");\n      if (!adapter.getFields().find((f) => f.name === name)) {\n        return errorResult(`Unknown field: ${name}`);\n      }\n      adapter.focus(name);\n      return textResult(`Focused ${name}`, { field: name });\n    },\n    true,\n  );\n\n  reg(\n    \"form_submit\",\n    async () => {\n      if (!adapter.submit) return errorResult(\"Host did not provide a submit implementation.\");\n      // Trust-but-verify: a form submit is a human-visible / often-destructive\n      // action, so gate it on a human confirm when one is wired.\n      if (pendingMode && adapter.confirm) {\n        const confirm = adapter.confirm;\n        const ok = await untilClosed(Promise.resolve().then(() => confirm({\n          action: \"submit\",\n          form: formId,\n          title: adapter.title,\n          values: adapter.getValues(),\n        })));\n        // The form went away while the human was deciding: never submit a\n        // form that is no longer on screen, whatever the late answer is.\n        if (ok === CLOSED) {\n          return errorResult(`Form \"${formId}\" was closed before the submit was confirmed. Nothing was submitted.`);\n        }\n        if (!ok) return errorResult(\"Declined by user\");\n      }\n      const submit = adapter.submit;\n      const result = await untilClosed(Promise.resolve().then(() => submit()));\n      if (result === CLOSED) return closedUnknown(\"the submit\");\n      if (!result.ok) return errorResult(hostErrorMessage(result.error, \"Submit failed\"));\n      return textResult(\"Submitted\", { values: result.values });\n    },\n    true,\n  );\n\n  // Join the host's form router. The first form installs the shared tools; a\n  // refused install (a name held by an unrelated registrant) throws from here.\n  const membership = joinInstanceRouter<FormInstance>(\n    host,\n    { family: \"form\", argument: \"form\", listTool: \"form_list\", install: (router) => installFormTools(host, router) },\n    formId,\n    { adapter, handlers },\n  );\n\n  return {\n    id: bridgeId,\n    title: adapter.title ?? formId,\n    dispose: () => {\n      if (disposed) return;\n      disposed = true;\n      // Only this form leaves; the tools go when the last form does.\n      membership.leave();\n      // Settle every call still waiting on the host; see untilClosed.\n      for (const close of [...onDispose]) close();\n      onDispose.clear();\n    },\n  };\n}\n"]}

package/dist/chunk-DPBAEWB5.js

@@ -0,0 +1,28 @@
+// src/bridges/host-commit.ts
+function hostErrorMessage(e, fallback) {
+  let msg;
+  if (e instanceof Error) msg = e.message;
+  else if (typeof e === "string") msg = e;
+  else if (e && typeof e === "object" && typeof e.message === "string") {
+    msg = e.message;
+  }
+  const firstFrame = msg ? msg.search(/\n\s+at\s/) : -1;
+  if (msg && firstFrame >= 0) msg = msg.slice(0, firstFrame);
+  msg = msg?.trim();
+  return msg ? msg : fallback;
+}
+async function commit(run, fallback) {
+  try {
+    const r = await run();
+    if (r && typeof r === "object" && r.ok === false) {
+      return { ok: false, error: hostErrorMessage(r.error, fallback) };
+    }
+    return { ok: true };
+  } catch (e) {
+    return { ok: false, error: hostErrorMessage(e, fallback) };
+  }
+}
+
+export { commit, hostErrorMessage };
+//# sourceMappingURL=chunk-DPBAEWB5.js.map
+//# sourceMappingURL=chunk-DPBAEWB5.js.map

package/dist/chunk-DPBAEWB5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/host-commit.ts"],"names":[],"mappings":";AAqBO,SAAS,gBAAA,CAAiB,GAAY,QAAA,EAA0B;AACrE,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI,CAAA,YAAa,KAAA,EAAO,GAAA,GAAM,CAAA,CAAE,OAAA;AAAA,OAAA,IACvB,OAAO,CAAA,KAAM,QAAA,EAAU,GAAA,GAAM,CAAA;AAAA,OAAA,IAC7B,KAAK,OAAO,CAAA,KAAM,YAAY,OAAQ,CAAA,CAA4B,YAAY,QAAA,EAAU;AAC/F,IAAA,GAAA,GAAO,CAAA,CAA0B,OAAA;AAAA,EACnC;AACA,EAAA,MAAM,UAAA,GAAa,GAAA,GAAM,GAAA,CAAI,MAAA,CAAO,WAAW,CAAA,GAAI,EAAA;AACnD,EAAA,IAAI,OAAO,UAAA,IAAc,CAAA,QAAS,GAAA,CAAI,KAAA,CAAM,GAAG,UAAU,CAAA;AACzD,EAAA,GAAA,GAAM,KAAK,IAAA,EAAK;AAChB,EAAA,OAAO,MAAM,GAAA,GAAM,QAAA;AACrB;AAGA,eAAsB,MAAA,CACpB,KACA,QAAA,EACwB;AACxB,EAAA,IAAI;AACF,IAAA,MAAM,CAAA,GAAI,MAAM,GAAA,EAAI;AACpB,IAAA,IAAI,KAAK,OAAO,CAAA,KAAM,QAAA,IAAY,CAAA,CAAE,OAAO,KAAA,EAAO;AAChD,MAAA,OAAO,EAAE,IAAI,KAAA,EAAO,KAAA,EAAO,iBAAiB,CAAA,CAAE,KAAA,EAAO,QAAQ,CAAA,EAAE;AAAA,IACjE;AACA,IAAA,OAAO,EAAE,IAAI,IAAA,EAAK;AAAA,EACpB,SAAS,CAAA,EAAG;AACV,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,OAAO,gBAAA,CAAiB,CAAA,EAAG,QAAQ,CAAA,EAAE;AAAA,EAC3D;AACF","file":"chunk-DPBAEWB5.js","sourcesContent":["/**\n * Shared plumbing for bridges whose adapter mutators may commit asynchronously\n * (screens since 0.49.0, forms since 0.52.0). Internal: not an entry point.\n *\n * The contract: a mutator returns `void` (sync, unchanged behaviour) or a\n * Promise resolving to `void` or `{ ok: true } | { ok: false; error }`. The\n * bridge awaits it, and only an accepted commit counts as success.\n */\n\n/** What an async mutator may resolve to, to acknowledge or refuse a commit. */\nexport type HostCommitResult = { ok: true } | { ok: false; error: string; code?: string };\n\nexport type CommitOutcome = { ok: true } | { ok: false; error: string };\n\n/**\n * The agent-facing text for a host failure. Only the message is used — never\n * `stack`, which carries file paths — matching the other bridges. A message\n * that itself embeds stack frames is cut at the first frame. A non-Error\n * rejection (a plain object, a response) has no reliable message, so it gets\n * the fallback rather than \"[object Object]\".\n */\nexport function hostErrorMessage(e: unknown, fallback: string): string {\n  let msg: string | undefined;\n  if (e instanceof Error) msg = e.message;\n  else if (typeof e === \"string\") msg = e;\n  else if (e && typeof e === \"object\" && typeof (e as { message?: unknown }).message === \"string\") {\n    msg = (e as { message: string }).message;\n  }\n  const firstFrame = msg ? msg.search(/\\n\\s+at\\s/) : -1;\n  if (msg && firstFrame >= 0) msg = msg.slice(0, firstFrame);\n  msg = msg?.trim();\n  return msg ? msg : fallback;\n}\n\n/** Run one adapter commit, await it, and normalise every way it can fail. Never rejects. */\nexport async function commit(\n  run: () => void | Promise<void | HostCommitResult>,\n  fallback: string,\n): Promise<CommitOutcome> {\n  try {\n    const r = await run();\n    if (r && typeof r === \"object\" && r.ok === false) {\n      return { ok: false, error: hostErrorMessage(r.error, fallback) };\n    }\n    return { ok: true };\n  } catch (e) {\n    return { ok: false, error: hostErrorMessage(e, fallback) };\n  }\n}\n"]}