@particle-academy/agent-integrations 0.20.0 → 0.21.0

package/dist/chunk-267JS64O.js

@@ -0,0 +1,308 @@
+import { ensureUndoToolsRegistered, pushUndoEntry } from './chunk-KJ5AOOV7.js';
+import { wrapToolWithActivity } from './chunk-ULJL53DL.js';
+import { textResult, errorResult } from './chunk-4KAIV6OD.js';
+
+// src/bridges/catalog.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var num = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+function registerCatalogBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? true;
+  const catalogId = adapter.id ?? "catalog";
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const target = (elementId, label) => ({
+    kind: "custom",
+    screenId: adapter.screenId,
+    elementId,
+    label: label ?? catalogId
+  });
+  const reg = (name, description, properties, required, handler, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "custom",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => resolveTarget(args)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
+        final
+      )
+    );
+  };
+  const guardDestructive = async (action, id, label, hasConfirmArg) => {
+    if (!pendingMode) return null;
+    if (options.confirm) {
+      const ok = await options.confirm({ action, id, label });
+      return ok ? null : errorResult(`Declined: ${action} ${id} (human did not confirm).`);
+    }
+    if (!hasConfirmArg) {
+      return errorResult(`${action} is staged (pendingMode). Re-call with confirm:true to apply, or wire a host confirm hook.`);
+    }
+    return null;
+  };
+  reg(
+    "catalog_list_products",
+    "List products: { id, name, active, lookupKey, priceCount }. Pass withTrashed:true to include soft-deleted.",
+    { withTrashed: { type: "boolean" } },
+    [],
+    async (args) => {
+      const products = await adapter.products.all({ withTrashed: args.withTrashed === true });
+      const list = await Promise.all(
+        products.map(async (p) => ({
+          id: p.id,
+          name: p.name,
+          active: p.active ?? true,
+          lookupKey: p.lookupKey ?? null,
+          priceCount: (await adapter.prices.forProduct(p.id)).length
+        }))
+      );
+      return textResult(JSON.stringify(list, null, 2), list);
+    },
+    false
+  );
+  reg(
+    "catalog_get_product",
+    "Read a product's full JSON plus its prices.",
+    { id: { type: "string" }, withTrashed: { type: "boolean" } },
+    ["id"],
+    async (args) => {
+      const id = str(args.id);
+      const product = await adapter.products.find(id, { withTrashed: args.withTrashed === true });
+      if (!product) return errorResult(`No product with id ${id}`);
+      const prices = await adapter.prices.forProduct(id, { withTrashed: args.withTrashed === true });
+      const out = { product, prices };
+      return textResult(JSON.stringify(out, null, 2), out);
+    },
+    false
+  );
+  reg(
+    "catalog_list_prices",
+    "List prices for a product (pass productId), or every price (omit it).",
+    { productId: { type: "string" }, withTrashed: { type: "boolean" } },
+    [],
+    async (args) => {
+      const withTrashed = args.withTrashed === true;
+      const prices = args.productId !== void 0 ? await adapter.prices.forProduct(str(args.productId), { withTrashed }) : await adapter.prices.all({ withTrashed });
+      const list = prices.map((p) => ({
+        id: p.id,
+        productId: p.productId,
+        currency: p.currency,
+        unitAmount: p.unitAmount,
+        type: p.type,
+        active: p.active ?? true,
+        externalId: p.externalId ?? null
+      }));
+      return textResult(JSON.stringify(list, null, 2), list);
+    },
+    false
+  );
+  reg(
+    "catalog_create_product",
+    "Create a product. `name` is required; id (ULID) is auto-assigned. Returns the created product.",
+    {
+      name: { type: "string" },
+      description: { type: "string" },
+      active: { type: "boolean" },
+      lookupKey: { type: "string" },
+      metadata: { type: "object" }
+    },
+    ["name"],
+    async (args) => {
+      const name = str(args.name);
+      if (!name) return errorResult("name is required.");
+      const product = await adapter.createProduct({
+        name,
+        ...args.description !== void 0 ? { description: str(args.description) } : {},
+        ...args.active !== void 0 ? { active: args.active === true } : {},
+        ...args.lookupKey !== void 0 ? { lookupKey: str(args.lookupKey) } : {},
+        ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
+      });
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: catalogId,
+        action: "catalog_create_product",
+        label: `Created product ${product.id} (${product.name})`,
+        undo: () => void adapter.products.remove(product.id),
+        redo: () => void adapter.createProduct({ ...product })
+      });
+      return textResult(`Created product ${product.id} (${product.name})`, product);
+    },
+    (args) => target(void 0, `create product ${str(args.name)}`)
+  );
+  reg(
+    "catalog_create_price",
+    "Create a price under a product. unitAmount is integer minor units (cents). type is 'recurring' | 'one_time'.",
+    {
+      productId: { type: "string" },
+      currency: { type: "string", description: "ISO-4217, e.g. 'USD'." },
+      unitAmount: { type: "number", description: "Price in cents." },
+      type: { type: "string", enum: ["recurring", "one_time"] },
+      recurringInterval: { type: "string", description: "'month' | 'year' | \u2026 (recurring only)." },
+      nickname: { type: "string" },
+      lookupKey: { type: "string" },
+      metadata: { type: "object" }
+    },
+    ["productId", "currency", "unitAmount", "type"],
+    async (args) => {
+      const productId = str(args.productId);
+      const product = await adapter.products.find(productId);
+      if (!product) return errorResult(`No product with id ${productId}`);
+      const type = str(args.type);
+      if (type !== "recurring" && type !== "one_time") return errorResult("type must be 'recurring' or 'one_time'.");
+      const price = await adapter.createPrice({
+        productId,
+        currency: str(args.currency),
+        unitAmount: num(args.unitAmount),
+        type,
+        ...args.recurringInterval !== void 0 ? { recurringInterval: str(args.recurringInterval) } : {},
+        ...args.nickname !== void 0 ? { nickname: str(args.nickname) } : {},
+        ...args.lookupKey !== void 0 ? { lookupKey: str(args.lookupKey) } : {},
+        ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
+      });
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: catalogId,
+        action: "catalog_create_price",
+        label: `Created price ${price.id} on ${productId}`,
+        undo: () => void adapter.prices.remove(price.id),
+        redo: () => void adapter.createPrice({ ...price })
+      });
+      return textResult(`Created ${type} price ${price.id} on ${productId}`, price);
+    },
+    (args) => target(str(args.productId), `create price on ${str(args.productId)}`)
+  );
+  reg(
+    "catalog_delete_product",
+    "Soft-delete a product (preserves financial history). Staged in pendingMode \u2014 pass confirm:true or wire a host confirm hook.",
+    { id: { type: "string" }, confirm: { type: "boolean" } },
+    ["id"],
+    async (args) => {
+      const id = str(args.id);
+      const product = await adapter.products.find(id, { withTrashed: true });
+      if (!product) return errorResult(`No product with id ${id}`);
+      const blocked = await guardDestructive("catalog_delete_product", id, product.name, args.confirm === true);
+      if (blocked) return blocked;
+      const snapshot = { ...product };
+      await adapter.products.remove(id);
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: catalogId,
+        action: "catalog_delete_product",
+        label: `Deleted product ${id} (${product.name})`,
+        undo: () => void adapter.createProduct({ ...snapshot }),
+        redo: () => void adapter.products.remove(id)
+      });
+      return textResult(`Deleted product ${id}`, { id });
+    },
+    (args) => target(str(args.id), `delete product ${str(args.id)}`)
+  );
+  reg(
+    "catalog_delete_price",
+    "Soft-delete a price (mirrors Stripe archiving). Staged in pendingMode \u2014 pass confirm:true or wire a host confirm hook.",
+    { id: { type: "string" }, confirm: { type: "boolean" } },
+    ["id"],
+    async (args) => {
+      const id = str(args.id);
+      const price = await adapter.prices.find(id, { withTrashed: true });
+      if (!price) return errorResult(`No price with id ${id}`);
+      const blocked = await guardDestructive("catalog_delete_price", id, id, args.confirm === true);
+      if (blocked) return blocked;
+      const snapshot = { ...price };
+      await adapter.prices.remove(id);
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: catalogId,
+        action: "catalog_delete_price",
+        label: `Deleted price ${id}`,
+        undo: () => void adapter.createPrice({ ...snapshot }),
+        redo: () => void adapter.prices.remove(id)
+      });
+      return textResult(`Deleted price ${id}`, { id });
+    },
+    (args) => target(str(args.id), `delete price ${str(args.id)}`)
+  );
+  reg(
+    "catalog_sync_product",
+    "Push a product + its prices to Stripe (creates/updates the Stripe Product + Prices, stamps external ids).",
+    { id: { type: "string" } },
+    ["id"],
+    async (args) => {
+      if (!adapter.syncProductAndPrices) return errorResult("Host did not wire Stripe sync.");
+      const id = str(args.id);
+      const product = await adapter.products.find(id);
+      if (!product) return errorResult(`No product with id ${id}`);
+      const synced = await adapter.syncProductAndPrices(product);
+      return textResult(`Synced product ${id} to Stripe (${synced.externalId ?? "no external id"})`, synced);
+    },
+    (args) => target(str(args.id), `sync product ${str(args.id)}`)
+  );
+  reg(
+    "catalog_test_connection",
+    "Verify the Stripe connection \u2014 returns { success, message, productCount? }.",
+    {},
+    [],
+    async () => {
+      if (!adapter.testConnection) return errorResult("Host did not wire a Stripe connection test.");
+      const result = await adapter.testConnection();
+      return textResult(JSON.stringify(result, null, 2), result);
+    },
+    false
+  );
+  reg(
+    "catalog_create_checkout",
+    "Build a hosted Stripe Checkout URL for a price. Recurring prices \u2192 subscription; one-time \u2192 payment (pass quantity). Requires the price be synced to Stripe first.",
+    {
+      priceId: { type: "string" },
+      successUrl: { type: "string" },
+      cancelUrl: { type: "string" },
+      customer: { type: "string", description: "Stripe customer id (optional \u2014 Checkout collects one if omitted)." },
+      quantity: { type: "number", description: "One-time checkouts only. Default 1." },
+      metadata: { type: "object" }
+    },
+    ["priceId", "successUrl", "cancelUrl"],
+    async (args) => {
+      const priceId = str(args.priceId);
+      const price = await adapter.prices.find(priceId);
+      if (!price) return errorResult(`No price with id ${priceId}`);
+      const checkoutArgs = {
+        successUrl: str(args.successUrl),
+        cancelUrl: str(args.cancelUrl),
+        ...args.customer !== void 0 ? { customer: str(args.customer) } : {},
+        ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
+      };
+      let url;
+      if (price.type === "recurring") {
+        if (!adapter.getSubscriptionCheckoutUrl) return errorResult("Host did not wire subscription checkout.");
+        url = await adapter.getSubscriptionCheckoutUrl(price, checkoutArgs);
+      } else {
+        if (!adapter.getOneTimeCheckoutUrl) return errorResult("Host did not wire one-time checkout.");
+        url = await adapter.getOneTimeCheckoutUrl(price, { ...checkoutArgs, quantity: num(args.quantity, 1) });
+      }
+      return textResult(url || "(no url)", { priceId, type: price.type, url });
+    },
+    (args) => target(str(args.priceId), `checkout ${str(args.priceId)}`)
+  );
+  return {
+    id: `catalog:${catalogId}`,
+    title: adapter.title ?? "Catalog",
+    dispose: () => {
+      for (const d of disposers.splice(0)) d();
+    }
+  };
+}
+
+export { registerCatalogBridge };
+//# sourceMappingURL=chunk-267JS64O.js.map
+//# sourceMappingURL=chunk-267JS64O.js.map

package/dist/chunk-267JS64O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/catalog.ts"],"names":[],"mappings":"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","file":"chunk-267JS64O.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 type { AgentTarget } from \"../presence/types\";\nimport { pushUndoEntry } from \"../undo/undo-stack\";\nimport { ensureUndoToolsRegistered } from \"../undo/undo-tools\";\n\n/**\n * Headless bridge for `@particle-academy/fancy-catalog` — a Stripe catalog with\n * NO UI surface. The adapter exposes the catalog's STORES + operations (not UI\n * getters/setters), and the tools are CRUD over products / prices + checkout +\n * Stripe sync. Mutations still funnel through `wrapToolWithActivity` so presence\n * + undo compose, and the destructive delete is `pendingMode`-gated.\n *\n * The adapter shapes below are STRUCTURAL mirrors of fancy-catalog's public\n * `Catalog` + store interfaces, defined LOCALLY so this bridge builds with the\n * sibling package absent (it's an optional peer). A real `Catalog` instance is\n * assignable to `CatalogBridgeAdapter` with no import — TypeScript is structural.\n */\n\n/** Minimal product shape crossing the MCP wire (mirror of fancy-catalog `Product`). */\nexport type CatalogProduct = {\n  id: string;\n  name: string;\n  description?: string | null;\n  active?: boolean;\n  lookupKey?: string | null;\n  externalId?: string | null;\n  metadata?: Record<string, unknown> | null;\n  [k: string]: unknown;\n};\n\n/** Minimal price shape crossing the MCP wire (mirror of fancy-catalog `Price`). */\nexport type CatalogPrice = {\n  id: string;\n  productId: string;\n  active?: boolean;\n  currency: string;\n  unitAmount: number;\n  type: \"recurring\" | \"one_time\";\n  externalId?: string | null;\n  [k: string]: unknown;\n};\n\n/** Common checkout args (mirror of fancy-catalog `CheckoutArgs`). */\nexport type CatalogCheckoutArgs = {\n  customer?: string;\n  successUrl: string;\n  cancelUrl: string;\n  metadata?: Record<string, string>;\n  /** One-time checkouts only. */\n  quantity?: number;\n};\n\n/**\n * Adapter = the catalog instance / stores. A live `Catalog` from fancy-catalog\n * satisfies this directly (`catalog.products`, `catalog.createProduct`, …); a\n * host can also hand-roll one over its own persistence.\n */\nexport type CatalogBridgeAdapter = {\n  /** Stable id for this catalog instance (multiple catalogs ⇒ distinct ids). */\n  id?: string;\n  /** Display label for logs / presence. */\n  title?: string;\n  /** Optional fancy-screens screen id (usually unset — this is headless). */\n  screenId?: string;\n\n  /** Product store — `catalog.products`. */\n  products: {\n    find(id: string, opts?: { withTrashed?: boolean }): CatalogProduct | null | Promise<CatalogProduct | null>;\n    all(opts?: { withTrashed?: boolean }): CatalogProduct[] | Promise<CatalogProduct[]>;\n    remove(id: string): void | Promise<void>;\n  };\n  /** Price store — `catalog.prices`. */\n  prices: {\n    find(id: string, opts?: { withTrashed?: boolean }): CatalogPrice | null | Promise<CatalogPrice | null>;\n    forProduct(productId: string, opts?: { withTrashed?: boolean }): CatalogPrice[] | Promise<CatalogPrice[]>;\n    all(opts?: { withTrashed?: boolean }): CatalogPrice[] | Promise<CatalogPrice[]>;\n    remove(id: string): void | Promise<void>;\n  };\n\n  /** Authoring helpers — `catalog.createProduct` / `catalog.createPrice` (ULIDs auto-assigned). */\n  createProduct(input: Partial<CatalogProduct> & { name: string }): Promise<CatalogProduct> | CatalogProduct;\n  createPrice(\n    input: Partial<CatalogPrice> & { productId: string; currency: string; unitAmount: number; type: \"recurring\" | \"one_time\" },\n  ): Promise<CatalogPrice> | CatalogPrice;\n\n  /** Stripe sync — `catalog.syncProductAndPrices`. Optional (no-op when absent). */\n  syncProductAndPrices?(product: CatalogProduct): Promise<CatalogProduct> | CatalogProduct;\n  /** Connection test — `catalog.testConnection`. Optional. */\n  testConnection?(): Promise<{ success: boolean; message: string; productCount?: number }> | { success: boolean; message: string; productCount?: number };\n\n  /** Hosted Checkout — `catalog.getSubscriptionCheckoutUrl` / `getOneTimeCheckoutUrl`. Optional. */\n  getSubscriptionCheckoutUrl?(price: CatalogPrice, args: CatalogCheckoutArgs): Promise<string> | string;\n  getOneTimeCheckoutUrl?(price: CatalogPrice, args: CatalogCheckoutArgs): Promise<string> | string;\n};\n\nexport type CatalogBridgeOptions = {\n  adapter: CatalogBridgeAdapter;\n  /** Identity stamped on activity + undo entries. */\n  agent?: { id: string; name?: string; color?: string };\n  /**\n   * Trust-but-verify. When on (default), destructive ops (`catalog_delete_product`,\n   * `catalog_delete_price`) route through `adapter`-less staging: they require an\n   * explicit `confirm: true` arg OR a host `confirm` callback. Read + create +\n   * checkout-url tools are unaffected.\n   */\n  pendingMode?: boolean;\n  /** Host confirm hook for destructive ops (pendingMode). Resolves true to proceed. */\n  confirm?: (req: { action: string; id: string; label: string }) => Promise<boolean> | boolean;\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\nconst str = (v: unknown, fallback = \"\"): string => (typeof v === \"string\" ? v : fallback);\nconst num = (v: unknown, fallback = 0): number => (typeof v === \"number\" && Number.isFinite(v) ? v : fallback);\n\n/**\n * registerCatalogBridge — full MCP tool set over a headless Stripe catalog.\n *\n *   catalog_list_products    list products ({ id, name, active, priceCount })\n *   catalog_get_product      full product JSON + its prices\n *   catalog_create_product   create a product (ULID auto-assigned)\n *   catalog_delete_product   soft-delete a product (pendingMode-gated, undoable*)\n *   catalog_list_prices      list a product's prices (or all)\n *   catalog_create_price     create a price under a product\n *   catalog_delete_price     soft-delete a price (pendingMode-gated)\n *   catalog_sync_product     push a product + its prices to Stripe\n *   catalog_test_connection  verify the Stripe connection\n *   catalog_create_checkout  build a hosted Checkout URL for a price\n *\n * *delete undo is best-effort: stores expose soft-delete (`remove`) but no\n *  un-delete, so the undo closure re-creates from the captured snapshot.\n */\nexport function registerCatalogBridge(host: ToolHost, options: CatalogBridgeOptions): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const pendingMode = options.pendingMode ?? true;\n  const catalogId = adapter.id ?? \"catalog\";\n  const disposers: Array<() => void> = [];\n\n  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });\n\n  const target = (elementId?: string, label?: string): AgentTarget => ({\n    kind: \"custom\",\n    screenId: adapter.screenId,\n    elementId,\n    label: label ?? catalogId,\n  });\n\n  const reg = (\n    name: string,\n    description: string,\n    properties: Record<string, unknown>,\n    required: string[],\n    handler: (args: JsonObject) => Promise<unknown> | unknown,\n    resolveTarget: false | ((args: JsonObject) => AgentTarget),\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 = resolveTarget\n      ? wrapToolWithActivity(wrapped as never, {\n          toolName: name,\n          agent,\n          kind: \"custom\",\n          screenId: adapter.screenId,\n          resolveTarget: ({ args }) => resolveTarget(args as JsonObject),\n        })\n      : wrapped;\n    disposers.push(\n      host.registerTool(\n        { name, description, inputSchema: { type: \"object\", properties: properties as Record<string, never>, required, additionalProperties: false } },\n        final as never,\n      ),\n    );\n  };\n\n  /** Stage a destructive op behind the human (pendingMode). Returns null to proceed, or an errorResult to block. */\n  const guardDestructive = async (action: string, id: string, label: string, hasConfirmArg: boolean) => {\n    if (!pendingMode) return null;\n    if (options.confirm) {\n      const ok = await options.confirm({ action, id, label });\n      return ok ? null : errorResult(`Declined: ${action} ${id} (human did not confirm).`);\n    }\n    // No host confirm hook → require an explicit confirm:true arg as the staged ack.\n    if (!hasConfirmArg) {\n      return errorResult(`${action} is staged (pendingMode). Re-call with confirm:true to apply, or wire a host confirm hook.`);\n    }\n    return null;\n  };\n\n  // ─── Read tools ──────────────────────────────────────────────────────────\n\n  reg(\n    \"catalog_list_products\",\n    \"List products: { id, name, active, lookupKey, priceCount }. Pass withTrashed:true to include soft-deleted.\",\n    { withTrashed: { type: \"boolean\" } },\n    [],\n    async (args) => {\n      const products = await adapter.products.all({ withTrashed: args.withTrashed === true });\n      const list = await Promise.all(\n        products.map(async (p) => ({\n          id: p.id,\n          name: p.name,\n          active: p.active ?? true,\n          lookupKey: p.lookupKey ?? null,\n          priceCount: (await adapter.prices.forProduct(p.id)).length,\n        })),\n      );\n      return textResult(JSON.stringify(list, null, 2), list);\n    },\n    false,\n  );\n\n  reg(\n    \"catalog_get_product\",\n    \"Read a product's full JSON plus its prices.\",\n    { id: { type: \"string\" }, withTrashed: { type: \"boolean\" } },\n    [\"id\"],\n    async (args) => {\n      const id = str(args.id);\n      const product = await adapter.products.find(id, { withTrashed: args.withTrashed === true });\n      if (!product) return errorResult(`No product with id ${id}`);\n      const prices = await adapter.prices.forProduct(id, { withTrashed: args.withTrashed === true });\n      const out = { product, prices };\n      return textResult(JSON.stringify(out, null, 2), out);\n    },\n    false,\n  );\n\n  reg(\n    \"catalog_list_prices\",\n    \"List prices for a product (pass productId), or every price (omit it).\",\n    { productId: { type: \"string\" }, withTrashed: { type: \"boolean\" } },\n    [],\n    async (args) => {\n      const withTrashed = args.withTrashed === true;\n      const prices = args.productId !== undefined\n        ? await adapter.prices.forProduct(str(args.productId), { withTrashed })\n        : await adapter.prices.all({ withTrashed });\n      const list = prices.map((p) => ({\n        id: p.id,\n        productId: p.productId,\n        currency: p.currency,\n        unitAmount: p.unitAmount,\n        type: p.type,\n        active: p.active ?? true,\n        externalId: p.externalId ?? null,\n      }));\n      return textResult(JSON.stringify(list, null, 2), list);\n    },\n    false,\n  );\n\n  // ─── Create tools ────────────────────────────────────────────────────────\n\n  reg(\n    \"catalog_create_product\",\n    \"Create a product. `name` is required; id (ULID) is auto-assigned. Returns the created product.\",\n    {\n      name: { type: \"string\" },\n      description: { type: \"string\" },\n      active: { type: \"boolean\" },\n      lookupKey: { type: \"string\" },\n      metadata: { type: \"object\" },\n    },\n    [\"name\"],\n    async (args) => {\n      const name = str(args.name);\n      if (!name) return errorResult(\"name is required.\");\n      const product = await adapter.createProduct({\n        name,\n        ...(args.description !== undefined ? { description: str(args.description) } : {}),\n        ...(args.active !== undefined ? { active: args.active === true } : {}),\n        ...(args.lookupKey !== undefined ? { lookupKey: str(args.lookupKey) } : {}),\n        ...(args.metadata && typeof args.metadata === \"object\" ? { metadata: args.metadata as Record<string, unknown> } : {}),\n      });\n      pushUndoEntry(agent.id, {\n        timestamp: Date.now(),\n        bridgeId: catalogId,\n        action: \"catalog_create_product\",\n        label: `Created product ${product.id} (${product.name})`,\n        undo: () => void adapter.products.remove(product.id),\n        redo: () => void adapter.createProduct({ ...product }),\n      });\n      return textResult(`Created product ${product.id} (${product.name})`, product);\n    },\n    (args) => target(undefined, `create product ${str(args.name)}`),\n  );\n\n  reg(\n    \"catalog_create_price\",\n    \"Create a price under a product. unitAmount is integer minor units (cents). type is 'recurring' | 'one_time'.\",\n    {\n      productId: { type: \"string\" },\n      currency: { type: \"string\", description: \"ISO-4217, e.g. 'USD'.\" },\n      unitAmount: { type: \"number\", description: \"Price in cents.\" },\n      type: { type: \"string\", enum: [\"recurring\", \"one_time\"] },\n      recurringInterval: { type: \"string\", description: \"'month' | 'year' | … (recurring only).\" },\n      nickname: { type: \"string\" },\n      lookupKey: { type: \"string\" },\n      metadata: { type: \"object\" },\n    },\n    [\"productId\", \"currency\", \"unitAmount\", \"type\"],\n    async (args) => {\n      const productId = str(args.productId);\n      const product = await adapter.products.find(productId);\n      if (!product) return errorResult(`No product with id ${productId}`);\n      const type = str(args.type) as \"recurring\" | \"one_time\";\n      if (type !== \"recurring\" && type !== \"one_time\") return errorResult(\"type must be 'recurring' or 'one_time'.\");\n      const price = await adapter.createPrice({\n        productId,\n        currency: str(args.currency),\n        unitAmount: num(args.unitAmount),\n        type,\n        ...(args.recurringInterval !== undefined ? { recurringInterval: str(args.recurringInterval) } : {}),\n        ...(args.nickname !== undefined ? { nickname: str(args.nickname) } : {}),\n        ...(args.lookupKey !== undefined ? { lookupKey: str(args.lookupKey) } : {}),\n        ...(args.metadata && typeof args.metadata === \"object\" ? { metadata: args.metadata as Record<string, unknown> } : {}),\n      });\n      pushUndoEntry(agent.id, {\n        timestamp: Date.now(),\n        bridgeId: catalogId,\n        action: \"catalog_create_price\",\n        label: `Created price ${price.id} on ${productId}`,\n        undo: () => void adapter.prices.remove(price.id),\n        redo: () => void adapter.createPrice({ ...price }),\n      });\n      return textResult(`Created ${type} price ${price.id} on ${productId}`, price);\n    },\n    (args) => target(str(args.productId), `create price on ${str(args.productId)}`),\n  );\n\n  // ─── Destructive tools (pendingMode-gated) ───────────────────────────────\n\n  reg(\n    \"catalog_delete_product\",\n    \"Soft-delete a product (preserves financial history). Staged in pendingMode — pass confirm:true or wire a host confirm hook.\",\n    { id: { type: \"string\" }, confirm: { type: \"boolean\" } },\n    [\"id\"],\n    async (args) => {\n      const id = str(args.id);\n      const product = await adapter.products.find(id, { withTrashed: true });\n      if (!product) return errorResult(`No product with id ${id}`);\n      const blocked = await guardDestructive(\"catalog_delete_product\", id, product.name, args.confirm === true);\n      if (blocked) return blocked;\n      const snapshot = { ...product };\n      await adapter.products.remove(id);\n      pushUndoEntry(agent.id, {\n        timestamp: Date.now(),\n        bridgeId: catalogId,\n        action: \"catalog_delete_product\",\n        label: `Deleted product ${id} (${product.name})`,\n        undo: () => void adapter.createProduct({ ...snapshot }),\n        redo: () => void adapter.products.remove(id),\n      });\n      return textResult(`Deleted product ${id}`, { id });\n    },\n    (args) => target(str(args.id), `delete product ${str(args.id)}`),\n  );\n\n  reg(\n    \"catalog_delete_price\",\n    \"Soft-delete a price (mirrors Stripe archiving). Staged in pendingMode — pass confirm:true or wire a host confirm hook.\",\n    { id: { type: \"string\" }, confirm: { type: \"boolean\" } },\n    [\"id\"],\n    async (args) => {\n      const id = str(args.id);\n      const price = await adapter.prices.find(id, { withTrashed: true });\n      if (!price) return errorResult(`No price with id ${id}`);\n      const blocked = await guardDestructive(\"catalog_delete_price\", id, id, args.confirm === true);\n      if (blocked) return blocked;\n      const snapshot = { ...price };\n      await adapter.prices.remove(id);\n      pushUndoEntry(agent.id, {\n        timestamp: Date.now(),\n        bridgeId: catalogId,\n        action: \"catalog_delete_price\",\n        label: `Deleted price ${id}`,\n        undo: () => void adapter.createPrice({ ...snapshot }),\n        redo: () => void adapter.prices.remove(id),\n      });\n      return textResult(`Deleted price ${id}`, { id });\n    },\n    (args) => target(str(args.id), `delete price ${str(args.id)}`),\n  );\n\n  // ─── Stripe sync ─────────────────────────────────────────────────────────\n\n  reg(\n    \"catalog_sync_product\",\n    \"Push a product + its prices to Stripe (creates/updates the Stripe Product + Prices, stamps external ids).\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    async (args) => {\n      if (!adapter.syncProductAndPrices) return errorResult(\"Host did not wire Stripe sync.\");\n      const id = str(args.id);\n      const product = await adapter.products.find(id);\n      if (!product) return errorResult(`No product with id ${id}`);\n      const synced = await adapter.syncProductAndPrices(product);\n      return textResult(`Synced product ${id} to Stripe (${synced.externalId ?? \"no external id\"})`, synced);\n    },\n    (args) => target(str(args.id), `sync product ${str(args.id)}`),\n  );\n\n  reg(\n    \"catalog_test_connection\",\n    \"Verify the Stripe connection — returns { success, message, productCount? }.\",\n    {},\n    [],\n    async () => {\n      if (!adapter.testConnection) return errorResult(\"Host did not wire a Stripe connection test.\");\n      const result = await adapter.testConnection();\n      return textResult(JSON.stringify(result, null, 2), result);\n    },\n    false,\n  );\n\n  // ─── Checkout ────────────────────────────────────────────────────────────\n\n  reg(\n    \"catalog_create_checkout\",\n    \"Build a hosted Stripe Checkout URL for a price. Recurring prices → subscription; one-time → payment (pass quantity). Requires the price be synced to Stripe first.\",\n    {\n      priceId: { type: \"string\" },\n      successUrl: { type: \"string\" },\n      cancelUrl: { type: \"string\" },\n      customer: { type: \"string\", description: \"Stripe customer id (optional — Checkout collects one if omitted).\" },\n      quantity: { type: \"number\", description: \"One-time checkouts only. Default 1.\" },\n      metadata: { type: \"object\" },\n    },\n    [\"priceId\", \"successUrl\", \"cancelUrl\"],\n    async (args) => {\n      const priceId = str(args.priceId);\n      const price = await adapter.prices.find(priceId);\n      if (!price) return errorResult(`No price with id ${priceId}`);\n      const checkoutArgs: CatalogCheckoutArgs = {\n        successUrl: str(args.successUrl),\n        cancelUrl: str(args.cancelUrl),\n        ...(args.customer !== undefined ? { customer: str(args.customer) } : {}),\n        ...(args.metadata && typeof args.metadata === \"object\" ? { metadata: args.metadata as Record<string, string> } : {}),\n      };\n      let url: string;\n      if (price.type === \"recurring\") {\n        if (!adapter.getSubscriptionCheckoutUrl) return errorResult(\"Host did not wire subscription checkout.\");\n        url = await adapter.getSubscriptionCheckoutUrl(price, checkoutArgs);\n      } else {\n        if (!adapter.getOneTimeCheckoutUrl) return errorResult(\"Host did not wire one-time checkout.\");\n        url = await adapter.getOneTimeCheckoutUrl(price, { ...checkoutArgs, quantity: num(args.quantity, 1) });\n      }\n      return textResult(url || \"(no url)\", { priceId, type: price.type, url });\n    },\n    (args) => target(str(args.priceId), `checkout ${str(args.priceId)}`),\n  );\n\n  return {\n    id: `catalog:${catalogId}`,\n    title: adapter.title ?? \"Catalog\",\n    dispose: () => {\n      for (const d of disposers.splice(0)) d();\n    },\n  };\n}\n"]}

package/dist/chunk-XQZGB4FP.js

@@ -0,0 +1,221 @@
+import { ensureUndoToolsRegistered, pushUndoEntry } from './chunk-KJ5AOOV7.js';
+import { wrapToolWithActivity } from './chunk-ULJL53DL.js';
+import { textResult, errorResult } from './chunk-4KAIV6OD.js';
+
+// src/bridges/features.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var num = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+function registerFeaturesBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? true;
+  const featuresId = adapter.id ?? "features";
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const target = (elementId, label) => ({
+    kind: "custom",
+    screenId: adapter.screenId,
+    elementId,
+    label: label ?? featuresId
+  });
+  const reg = (name, description, properties, required, handler, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "custom",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => resolveTarget(args)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
+        final
+      )
+    );
+  };
+  const guardGrant = async (action, subject, groupKey, hasConfirmArg) => {
+    if (!pendingMode) return null;
+    if (options.confirm) {
+      const ok = await options.confirm({ action, subject, groupKey });
+      return ok ? null : errorResult(`Declined: ${action} ${groupKey} (human did not confirm).`);
+    }
+    if (!hasConfirmArg) {
+      return errorResult(`${action} is staged (pendingMode). Re-call with confirm:true to apply, or wire a host confirm hook.`);
+    }
+    return null;
+  };
+  reg(
+    "features_list",
+    "List the feature keys enabled for a subject. Pass `subject` (a string id or object).",
+    { subject: { description: "Opaque subject \u2014 string id or { id, \u2026 } object." }, context: { description: "Optional resolution context." } },
+    [],
+    async (args) => {
+      const keys = await adapter.enabled(args.subject, args.context);
+      return textResult(JSON.stringify(keys, null, 2), { subject: args.subject, enabled: keys });
+    },
+    false
+  );
+  reg(
+    "features_check",
+    "Check whether a subject can access a feature. For resource features also returns the remaining quota.",
+    { feature: { type: "string" }, subject: { description: "Opaque subject." }, context: { description: "Optional context." } },
+    ["feature"],
+    async (args) => {
+      const feature = str(args.feature);
+      const allowed = await adapter.canAccess(feature, args.subject, args.context);
+      const remaining = await adapter.remaining(feature, args.subject, args.context);
+      const out = { feature, allowed, remaining };
+      return textResult(JSON.stringify(out), out);
+    },
+    false
+  );
+  reg(
+    "features_explain",
+    "Trace why a feature is on/off for a subject \u2014 returns the AccessResult (source, remaining, limit, used).",
+    { feature: { type: "string" }, subject: { description: "Opaque subject." }, context: { description: "Optional context." } },
+    ["feature"],
+    async (args) => {
+      if (!adapter.explain) return errorResult("Host did not wire explain().");
+      const result = await adapter.explain(str(args.feature), args.subject, args.context);
+      return textResult(JSON.stringify(result, null, 2), result);
+    },
+    false
+  );
+  reg(
+    "features_groups",
+    "List the feature groups a subject is assigned to.",
+    { subject: { description: "Opaque subject." } },
+    ["subject"],
+    async (args) => {
+      const groups = await adapter.listGroups(args.subject);
+      return textResult(JSON.stringify(groups, null, 2), { subject: args.subject, groups });
+    },
+    false
+  );
+  reg(
+    "features_define",
+    "Register a feature definition. type 'boolean' (on/off) or 'resource' (metered with a `limit`). `enabled` sets the default gate.",
+    {
+      key: { type: "string" },
+      name: { type: "string" },
+      description: { type: "string" },
+      type: { type: "string", enum: ["boolean", "resource"] },
+      enabled: { type: "boolean" },
+      limit: { type: "number", description: "Resource quota per period (resource type)." }
+    },
+    ["key"],
+    (args) => {
+      const key = str(args.key);
+      if (!key) return errorResult("key is required.");
+      const existed = adapter.registryKeys().includes(key);
+      const definition = {
+        ...args.name !== void 0 ? { name: str(args.name) } : {},
+        ...args.description !== void 0 ? { description: str(args.description) } : {},
+        ...args.type !== void 0 ? { type: str(args.type) } : {},
+        ...args.enabled !== void 0 ? { enabled: args.enabled === true } : {},
+        ...args.limit !== void 0 ? { limit: num(args.limit) } : {}
+      };
+      adapter.registerFeature(key, definition);
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: featuresId,
+        action: "features_define",
+        // Registry has no unregister; undo re-registers the prior definition when we had one.
+        label: existed ? `Redefined feature ${key}` : `Defined feature ${key}`,
+        undo: () => {
+        },
+        redo: () => adapter.registerFeature(key, definition)
+      });
+      return textResult(`${existed ? "Redefined" : "Defined"} feature ${key} (${definition.type ?? "boolean"})`, { key, definition });
+    },
+    (args) => target(str(args.key), `define ${str(args.key)}`)
+  );
+  reg(
+    "features_grant",
+    "Grant a subject access by assigning it to a feature group. Staged in pendingMode \u2014 pass confirm:true or wire a host confirm hook.",
+    { subject: { description: "Opaque subject." }, group: { type: "string", description: "Feature group key." }, confirm: { type: "boolean" } },
+    ["subject", "group"],
+    async (args) => {
+      const groupKey = str(args.group);
+      if (!groupKey) return errorResult("group is required.");
+      const blocked = await guardGrant("features_grant", args.subject, groupKey, args.confirm === true);
+      if (blocked) return blocked;
+      const already = (await adapter.listGroups(args.subject)).includes(groupKey);
+      await adapter.assignGroup(args.subject, groupKey);
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: featuresId,
+        action: "features_grant",
+        label: `Granted group ${groupKey}`,
+        // Only reverse if WE added it (idempotent assign — don't revoke a pre-existing grant).
+        undo: () => {
+          if (!already) void adapter.detachGroup(args.subject, groupKey);
+        },
+        redo: () => void adapter.assignGroup(args.subject, groupKey)
+      });
+      return textResult(`Granted group ${groupKey}`, { subject: args.subject, group: groupKey });
+    },
+    (args) => target(str(args.group), `grant ${str(args.group)}`)
+  );
+  reg(
+    "features_revoke",
+    "Revoke access by detaching a subject from a feature group. Staged in pendingMode \u2014 pass confirm:true or wire a host confirm hook.",
+    { subject: { description: "Opaque subject." }, group: { type: "string" }, confirm: { type: "boolean" } },
+    ["subject", "group"],
+    async (args) => {
+      const groupKey = str(args.group);
+      if (!groupKey) return errorResult("group is required.");
+      const blocked = await guardGrant("features_revoke", args.subject, groupKey, args.confirm === true);
+      if (blocked) return blocked;
+      const had = (await adapter.listGroups(args.subject)).includes(groupKey);
+      await adapter.detachGroup(args.subject, groupKey);
+      pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: featuresId,
+        action: "features_revoke",
+        label: `Revoked group ${groupKey}`,
+        undo: () => {
+          if (had) void adapter.assignGroup(args.subject, groupKey);
+        },
+        redo: () => void adapter.detachGroup(args.subject, groupKey)
+      });
+      return textResult(`Revoked group ${groupKey}`, { subject: args.subject, group: groupKey });
+    },
+    (args) => target(str(args.group), `revoke ${str(args.group)}`)
+  );
+  reg(
+    "features_consume",
+    "Meter a resource feature: atomic check-and-increment. Returns ok:false if the quota would be exceeded (nothing recorded).",
+    { feature: { type: "string" }, subject: { description: "Opaque subject." }, amount: { type: "number", description: "Units to consume. Default 1." }, context: { description: "Optional context." } },
+    ["feature", "subject"],
+    async (args) => {
+      if (!adapter.tryConsume) return errorResult("Host did not wire usage metering (tryConsume).");
+      const feature = str(args.feature);
+      const amount = num(args.amount, 1);
+      const ok = await adapter.tryConsume(feature, args.subject, amount, args.context);
+      const remaining = await adapter.remaining(feature, args.subject, args.context);
+      const out = { feature, ok, amount, remaining };
+      return textResult(JSON.stringify(out), out);
+    },
+    (args) => target(str(args.feature), `consume ${str(args.feature)}`)
+  );
+  return {
+    id: `features:${featuresId}`,
+    title: adapter.title ?? "Features",
+    dispose: () => {
+      for (const d of disposers.splice(0)) d();
+    }
+  };
+}
+
+export { registerFeaturesBridge };
+//# sourceMappingURL=chunk-XQZGB4FP.js.map
+//# sourceMappingURL=chunk-XQZGB4FP.js.map