@withpotter/components 0.13.0-next.101

package/dist/potter/potter-tools.js

@@ -0,0 +1,184 @@
+"use client";
+import { bookingsApi } from "@withpotter/lib/api/bookings";
+import { inventoryApi } from "@withpotter/lib/api/inventory";
+import { invoicesApi } from "@withpotter/lib/api/invoices";
+import { analyticsApi } from "@withpotter/lib/api/analytics";
+function isoDay(d) {
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(
+    d.getDate()
+  ).padStart(2, "0")}`;
+}
+function daysAgo(n) {
+  const d = /* @__PURE__ */ new Date();
+  d.setDate(d.getDate() - n);
+  return d;
+}
+function count(n, singular, plural) {
+  return `${n} ${n === 1 ? singular : plural}`;
+}
+async function bookingsToday(slug, labels) {
+  const today = isoDay(/* @__PURE__ */ new Date());
+  const res = await bookingsApi.list(slug, {
+    dateFrom: today,
+    dateTo: today,
+    limit: 100
+  });
+  const rows = res?.data ?? [];
+  const n = res?.total ?? rows.length;
+  if (n === 0) {
+    return {
+      reply: `Nothing on the book today.`,
+      blocks: [
+        { kind: "empty", href: "/dashboard/bookings", cta: "Open the day" }
+      ]
+    };
+  }
+  return {
+    reply: `${count(n, labels.singular.toLowerCase(), labels.plural.toLowerCase())} today.`,
+    blocks: [
+      {
+        /**
+         * THE LABEL NAMES THE THING, because the value cannot.
+         *
+         * It read "Today / 1" — John: *"why this tho"*, and he is right that a
+         * card saying a bare 1 says nothing. Every other metric on this surface
+         * carries its unit in the VALUE ("Owed to you / ₦412,000"), which a
+         * count cannot do: a currency has a symbol and an appointment has only
+         * a noun. So the noun goes in the label, and it is this business's noun
+         * rather than "bookings" — a clinic's are appointments and a studio's
+         * are sessions.
+         *
+         * "Today" also said nothing the sentence above had not already said.
+         */
+        kind: "metric",
+        label: `${labels.plural} today`,
+        value: String(n),
+        href: "/dashboard/bookings",
+        cta: "Open the day"
+      }
+    ]
+  };
+}
+async function lowStock(slug, labels) {
+  const res = await inventoryApi.list(slug, {
+    stockStatus: "lowStock",
+    limit: 20
+  });
+  const rows = res?.items ?? [];
+  const n = res?.total ?? rows.length;
+  if (n === 0) {
+    return { reply: `Nothing is running low.`, blocks: [] };
+  }
+  return {
+    reply: `${count(n, labels.singular.toLowerCase(), labels.plural.toLowerCase())} running low.`,
+    blocks: [
+      {
+        kind: "list",
+        rows: rows.slice(0, 6).map((p) => ({
+          id: p.id,
+          title: p.title,
+          meta: `${(p.quantity ?? 0) - (p.reserved ?? 0)} left`,
+          href: `/dashboard/catalog/${p.id}`
+        })),
+        href: "/dashboard/catalog?stock=low",
+        cta: "Open the catalogue"
+      }
+    ]
+  };
+}
+async function moneyOwed(slug, formatMoney) {
+  const [stats, overdue] = await Promise.all([
+    invoicesApi.getStats(slug),
+    invoicesApi.list(slug, { status: "overdue", limit: 5 })
+  ]);
+  const owed = Number(stats?.totalOutstanding ?? 0);
+  const bills = stats?.outstanding;
+  const lateCount = Number(stats?.overdue ?? 0);
+  if (owed <= 0) {
+    return { reply: `Nobody owes you anything right now.`, blocks: [] };
+  }
+  const across = typeof bills === "number" && bills > 0 ? ` across ${count(bills, "bill", "bills")}` : "";
+  return {
+    reply: `${formatMoney(owed)}${across}` + (lateCount > 0 ? `, ${lateCount} overdue.` : "."),
+    blocks: [
+      {
+        kind: "metric",
+        label: "Owed to you",
+        value: formatMoney(owed),
+        sub: lateCount > 0 ? `${lateCount} overdue` : void 0,
+        href: "/dashboard/invoices?status=unpaid",
+        cta: "Open invoices"
+      },
+      ...overdue?.invoices?.length ? [
+        {
+          kind: "list",
+          rows: overdue.invoices.slice(0, 5).map((i) => ({
+            id: i.id,
+            title: i.customerName || i.invoiceNumber || "Invoice",
+            meta: formatMoney(Number(i.amountDue ?? i.total ?? 0)),
+            href: `/dashboard/invoices/${i.id}`
+          })),
+          href: "/dashboard/invoices?status=overdue",
+          cta: "Open overdue"
+        }
+      ] : []
+    ]
+  };
+}
+const MIN_ORDERS = 5;
+const THIN_ORDERS = 12;
+async function salesCompare(slug, formatMoney, windowDays = 7) {
+  const [now, prior] = await Promise.all([
+    analyticsApi.getDashboard(slug, {
+      startDate: isoDay(daysAgo(windowDays)),
+      endDate: isoDay(/* @__PURE__ */ new Date())
+    }),
+    analyticsApi.getDashboard(slug, {
+      startDate: isoDay(daysAgo(windowDays * 2)),
+      endDate: isoDay(daysAgo(windowDays + 1))
+    })
+  ]);
+  const revenue = Number(now?.sales?.totalRevenue ?? 0);
+  const before = Number(prior?.sales?.totalRevenue ?? 0);
+  const orders = Number(now?.sales?.totalOrders ?? 0);
+  const period = windowDays === 7 ? "week" : `${windowDays} days`;
+  if (orders < MIN_ORDERS) {
+    return {
+      reply: `Only ${count(orders, "order", "orders")} this ${period} \u2014 too few to compare against last.`,
+      blocks: [
+        {
+          kind: "metric",
+          label: `This ${period}`,
+          value: formatMoney(revenue),
+          sub: `${orders} orders`,
+          href: "/dashboard/analytics",
+          cta: "Open analytics"
+        }
+      ]
+    };
+  }
+  const delta = before === 0 ? null : (revenue - before) / before * 100;
+  const direction = delta === null ? "nothing to compare against" : `${delta >= 0 ? "up" : "down"} ${Math.abs(Math.round(delta))}%`;
+  const hedge = orders < THIN_ORDERS ? `, off ${count(orders, "order", "orders")}` : "";
+  return {
+    reply: `${formatMoney(revenue)} this ${period}, ${direction} on the ${period} before${hedge}.`,
+    blocks: [
+      {
+        kind: "metric",
+        label: `This ${period}`,
+        value: formatMoney(revenue),
+        sub: `${orders} orders \xB7 was ${formatMoney(before)}`,
+        delta: delta ?? void 0,
+        href: "/dashboard/analytics",
+        cta: "Open analytics"
+      }
+    ]
+  };
+}
+export {
+  bookingsToday,
+  lowStock,
+  moneyOwed,
+  salesCompare
+};
+//# sourceMappingURL=potter-tools.js.map

package/dist/potter/potter-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/potter/potter-tools.ts"],"sourcesContent":["'use client';\n\nimport { bookingsApi } from '@withpotter/lib/api/bookings';\nimport { inventoryApi } from '@withpotter/lib/api/inventory';\nimport { invoicesApi } from '@withpotter/lib/api/invoices';\nimport type { Invoice } from '@withpotter/lib/api/types/customers';\nimport { analyticsApi } from '@withpotter/lib/api/analytics';\nimport type { PotterBlock } from './potter-blocks';\n\n/**\n * What Box can actually look up.\n *\n * THE POINT OF THIS FILE. Until now nothing Box said had read a single row\n * of the merchant's data — `potter-answer.ts` is a keyword router over a help\n * corpus and says so in capitals at the top of itself. These are the reads that\n * make the four questions the intro OFFERS true, which is the whole of the\n * promise `ask-placeholders.ts` is written to keep.\n *\n * EACH ONE WRAPS A CLIENT METHOD THAT ALREADY EXISTS. No new endpoint, no new\n * query, no second way to count an invoice — `docs/POTTER_BRAIN_SPEC.md` chose\n * this deliberately and the reason is the Agent Lee failure quoted in it: an\n * assistant that gets its own data path gets its own permissions, and then its\n * own bugs about whose data it is. These run through `apiFetch`, which means\n * the proxy, which means the merchant's own session and the tenant scoping we\n * already have. Box never holds a credential.\n *\n * THEY RETURN BLOCKS, NOT PROSE. A tool hands back a sentence and a closed\n * union of renderable things (`PotterBlock`), so an answer that cannot be built\n * out of real rows cannot be produced at all. That is the honesty rule from the\n * spec, enforced by the type rather than by a system prompt.\n *\n * NO MODEL IS INVOLVED YET. `potter-data.ts` picks the tool by pattern, which\n * is exact for the handful of questions the product actually offers and refuses\n * everything else. When the answering endpoint lands, the model picks the tool\n * instead and these do not change.\n */\n\nexport interface ToolAnswer {\n  /** The sentence Box says. It must contain the answer, not describe it. */\n  reply: string;\n  blocks: PotterBlock[];\n  /**\n   * Which lookups ran. Set by the caller that chose them rather than by the\n   * tools themselves — a tool knows what it read, not what it was called as\n   * part of, and the fan-out needs to report the ones that actually returned.\n   */\n  tools?: string[];\n}\n\n/** yyyy-mm-dd in the viewer's own timezone, which is the day they mean. */\nfunction isoDay(d: Date): string {\n  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(\n    d.getDate(),\n  ).padStart(2, '0')}`;\n}\n\nfunction daysAgo(n: number): Date {\n  const d = new Date();\n  d.setDate(d.getDate() - n);\n  return d;\n}\n\n/** \"3 appointments\", \"1 appointment\" — the noun is the archetype's. */\nfunction count(n: number, singular: string, plural: string): string {\n  return `${n} ${n === 1 ? singular : plural}`;\n}\n\n// ── The tools ───────────────────────────────────────────────────────────────\n\n/**\n * What is on the book today.\n *\n * Answers \"how many appointments today\", which is the question John used to\n * show that Box answered none of them: it matched `find` on the word\n * \"appointments\" and returned a name search for the whole sentence.\n */\nexport async function bookingsToday(\n  slug: string,\n  labels: { singular: string; plural: string },\n): Promise<ToolAnswer> {\n  const today = isoDay(new Date());\n  const res = await bookingsApi.list(slug, {\n    dateFrom: today,\n    dateTo: today,\n    limit: 100,\n  });\n  const rows = res?.data ?? [];\n  const n = res?.total ?? rows.length;\n\n  if (n === 0) {\n    return {\n      reply: `Nothing on the book today.`,\n      blocks: [\n        { kind: 'empty', href: '/dashboard/bookings', cta: 'Open the day' },\n      ],\n    };\n  }\n  return {\n    reply: `${count(n, labels.singular.toLowerCase(), labels.plural.toLowerCase())} today.`,\n    blocks: [\n      {\n        /**\n         * THE LABEL NAMES THE THING, because the value cannot.\n         *\n         * It read \"Today / 1\" — John: *\"why this tho\"*, and he is right that a\n         * card saying a bare 1 says nothing. Every other metric on this surface\n         * carries its unit in the VALUE (\"Owed to you / ₦412,000\"), which a\n         * count cannot do: a currency has a symbol and an appointment has only\n         * a noun. So the noun goes in the label, and it is this business's noun\n         * rather than \"bookings\" — a clinic's are appointments and a studio's\n         * are sessions.\n         *\n         * \"Today\" also said nothing the sentence above had not already said.\n         */\n        kind: 'metric',\n        label: `${labels.plural} today`,\n        value: String(n),\n        href: '/dashboard/bookings',\n        cta: 'Open the day',\n      },\n    ],\n  };\n}\n\n/**\n * What is running out.\n *\n * `stockStatus: 'lowStock'` is the server's own filter, so this cannot disagree\n * with the Catalogue's own count the way the home's low-stock blocker did — it\n * had its own arithmetic, ignored `trackInventory`, and told every business\n * that keeps no stock that all of it was running out.\n */\nexport async function lowStock(\n  slug: string,\n  labels: { singular: string; plural: string },\n): Promise<ToolAnswer> {\n  const res = await inventoryApi.list(slug, {\n    stockStatus: 'lowStock',\n    limit: 20,\n  });\n  const rows = res?.items ?? [];\n  const n = res?.total ?? rows.length;\n\n  if (n === 0) {\n    return { reply: `Nothing is running low.`, blocks: [] };\n  }\n  return {\n    reply: `${count(n, labels.singular.toLowerCase(), labels.plural.toLowerCase())} running low.`,\n    blocks: [\n      {\n        kind: 'list',\n        rows: rows.slice(0, 6).map((p) => ({\n          id: p.id,\n          title: p.title,\n          meta: `${(p.quantity ?? 0) - (p.reserved ?? 0)} left`,\n          href: `/dashboard/catalog/${p.id}`,\n        })),\n        href: '/dashboard/catalog?stock=low',\n        cta: 'Open the catalogue',\n      },\n    ],\n  };\n}\n\n/**\n * Who has not paid.\n *\n * Overdue AND sent, because \"owes me\" is not \"is late\" — a bill that went out\n * yesterday is owed and is not yet overdue, and answering with only the late\n * ones would understate the number every time.\n */\nexport async function moneyOwed(\n  slug: string,\n  formatMoney: (n: number) => string,\n): Promise<ToolAnswer> {\n  /**\n   * THE STATS ENDPOINT, NOT A PAGE OF INVOICES.\n   *\n   * This summed `amount` over two 50-row pages, so a business with more than\n   * fifty unpaid bills was told a number that was quietly short — and it is a\n   * money number, the one kind that must never be approximately right. It also\n   * missed `viewed` and `partially_paid`, which are owed and are neither\n   * \"sent\" nor \"overdue\".\n   *\n   * `totalOutstanding` is the server's own figure over every unpaid invoice,\n   * drafts excluded because nobody has been asked to pay those yet. The list\n   * call stays, capped small, purely to name a few of them.\n   */\n  const [stats, overdue] = await Promise.all([\n    invoicesApi.getStats(slug),\n    invoicesApi.list(slug, { status: 'overdue', limit: 5 }),\n  ]);\n\n  const owed = Number(stats?.totalOutstanding ?? 0);\n  /* `outstanding` is optional on an API deployed before it shipped. Falling\n     back to the two statuses we can count is worse than saying nothing about\n     how many, so the sentence simply drops that clause. */\n  const bills = stats?.outstanding;\n  const lateCount = Number(stats?.overdue ?? 0);\n\n  if (owed <= 0) {\n    return { reply: `Nobody owes you anything right now.`, blocks: [] };\n  }\n\n  const across =\n    typeof bills === 'number' && bills > 0\n      ? ` across ${count(bills, 'bill', 'bills')}`\n      : '';\n\n  return {\n    reply:\n      `${formatMoney(owed)}${across}` +\n      (lateCount > 0 ? `, ${lateCount} overdue.` : '.'),\n    blocks: [\n      {\n        kind: 'metric',\n        label: 'Owed to you',\n        value: formatMoney(owed),\n        sub: lateCount > 0 ? `${lateCount} overdue` : undefined,\n        href: '/dashboard/invoices?status=unpaid',\n        cta: 'Open invoices',\n      },\n      ...(overdue?.invoices?.length\n        ? ([\n            {\n              kind: 'list',\n              rows: overdue.invoices.slice(0, 5).map((i: Invoice) => ({\n                id: i.id,\n                title: i.customerName || i.invoiceNumber || 'Invoice',\n                meta: formatMoney(Number(i.amountDue ?? i.total ?? 0)),\n                href: `/dashboard/invoices/${i.id}`,\n              })),\n              href: '/dashboard/invoices?status=overdue',\n              cta: 'Open overdue',\n            },\n          ] as PotterBlock[])\n        : []),\n    ],\n  };\n}\n\n/**\n * This period against the last one.\n *\n * `potter-analytics-strictness` applies and it is why the sample size travels\n * with the number: a model — or a merchant — will read a swing off four orders\n * as a trend. Under `MIN_ORDERS` this says the count and refuses the comparison\n * rather than dressing noise up as a direction.\n */\nconst MIN_ORDERS = 5;\n/**\n * Above the floor and still thin: say the number, and say what it is off.\n *\n * The first run of this told a spa it was \"up 229% on the week before\" off\n * five orders, which is true and is not a fact anybody should act on. The\n * floor stops the worst of it; between the floor and here the sentence carries\n * its own base so the swing cannot be read without it.\n */\nconst THIN_ORDERS = 12;\n\nexport async function salesCompare(\n  slug: string,\n  formatMoney: (n: number) => string,\n  windowDays = 7,\n): Promise<ToolAnswer> {\n  const [now, prior] = await Promise.all([\n    analyticsApi.getDashboard(slug, {\n      startDate: isoDay(daysAgo(windowDays)),\n      endDate: isoDay(new Date()),\n    }),\n    analyticsApi.getDashboard(slug, {\n      startDate: isoDay(daysAgo(windowDays * 2)),\n      endDate: isoDay(daysAgo(windowDays + 1)),\n    }),\n  ]);\n\n  const revenue = Number(now?.sales?.totalRevenue ?? 0);\n  const before = Number(prior?.sales?.totalRevenue ?? 0);\n  const orders = Number(now?.sales?.totalOrders ?? 0);\n  const period = windowDays === 7 ? 'week' : `${windowDays} days`;\n\n  if (orders < MIN_ORDERS) {\n    return {\n      reply: `Only ${count(orders, 'order', 'orders')} this ${period} — too few to compare against last.`,\n      blocks: [\n        {\n          kind: 'metric',\n          label: `This ${period}`,\n          value: formatMoney(revenue),\n          sub: `${orders} orders`,\n          href: '/dashboard/analytics',\n          cta: 'Open analytics',\n        },\n      ],\n    };\n  }\n\n  const delta = before === 0 ? null : ((revenue - before) / before) * 100;\n  const direction =\n    delta === null\n      ? 'nothing to compare against'\n      : `${delta >= 0 ? 'up' : 'down'} ${Math.abs(Math.round(delta))}%`;\n\n  const hedge =\n    orders < THIN_ORDERS ? `, off ${count(orders, 'order', 'orders')}` : '';\n\n  return {\n    reply: `${formatMoney(revenue)} this ${period}, ${direction} on the ${period} before${hedge}.`,\n    blocks: [\n      {\n        kind: 'metric',\n        label: `This ${period}`,\n        value: formatMoney(revenue),\n        sub: `${orders} orders · was ${formatMoney(before)}`,\n        delta: delta ?? undefined,\n        href: '/dashboard/analytics',\n        cta: 'Open analytics',\n      },\n    ],\n  };\n}\n"],"mappings":";AAEA,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAE5B,SAAS,oBAAoB;AA4C7B,SAAS,OAAO,GAAiB;AAC/B,SAAO,GAAG,EAAE,YAAY,CAAC,IAAI,OAAO,EAAE,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI;AAAA,IACxE,EAAE,QAAQ;AAAA,EACZ,EAAE,SAAS,GAAG,GAAG,CAAC;AACpB;AAEA,SAAS,QAAQ,GAAiB;AAChC,QAAM,IAAI,oBAAI,KAAK;AACnB,IAAE,QAAQ,EAAE,QAAQ,IAAI,CAAC;AACzB,SAAO;AACT;AAGA,SAAS,MAAM,GAAW,UAAkB,QAAwB;AAClE,SAAO,GAAG,CAAC,IAAI,MAAM,IAAI,WAAW,MAAM;AAC5C;AAWA,eAAsB,cACpB,MACA,QACqB;AACrB,QAAM,QAAQ,OAAO,oBAAI,KAAK,CAAC;AAC/B,QAAM,MAAM,MAAM,YAAY,KAAK,MAAM;AAAA,IACvC,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,OAAO;AAAA,EACT,CAAC;AACD,QAAM,OAAO,KAAK,QAAQ,CAAC;AAC3B,QAAM,IAAI,KAAK,SAAS,KAAK;AAE7B,MAAI,MAAM,GAAG;AACX,WAAO;AAAA,MACL,OAAO;AAAA,MACP,QAAQ;AAAA,QACN,EAAE,MAAM,SAAS,MAAM,uBAAuB,KAAK,eAAe;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL,OAAO,GAAG,MAAM,GAAG,OAAO,SAAS,YAAY,GAAG,OAAO,OAAO,YAAY,CAAC,CAAC;AAAA,IAC9E,QAAQ;AAAA,MACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAcE,MAAM;AAAA,QACN,OAAO,GAAG,OAAO,MAAM;AAAA,QACvB,OAAO,OAAO,CAAC;AAAA,QACf,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;AAUA,eAAsB,SACpB,MACA,QACqB;AACrB,QAAM,MAAM,MAAM,aAAa,KAAK,MAAM;AAAA,IACxC,aAAa;AAAA,IACb,OAAO;AAAA,EACT,CAAC;AACD,QAAM,OAAO,KAAK,SAAS,CAAC;AAC5B,QAAM,IAAI,KAAK,SAAS,KAAK;AAE7B,MAAI,MAAM,GAAG;AACX,WAAO,EAAE,OAAO,2BAA2B,QAAQ,CAAC,EAAE;AAAA,EACxD;AACA,SAAO;AAAA,IACL,OAAO,GAAG,MAAM,GAAG,OAAO,SAAS,YAAY,GAAG,OAAO,OAAO,YAAY,CAAC,CAAC;AAAA,IAC9E,QAAQ;AAAA,MACN;AAAA,QACE,MAAM;AAAA,QACN,MAAM,KAAK,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO;AAAA,UACjC,IAAI,EAAE;AAAA,UACN,OAAO,EAAE;AAAA,UACT,MAAM,IAAI,EAAE,YAAY,MAAM,EAAE,YAAY,EAAE;AAAA,UAC9C,MAAM,sBAAsB,EAAE,EAAE;AAAA,QAClC,EAAE;AAAA,QACF,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;AASA,eAAsB,UACpB,MACA,aACqB;AAcrB,QAAM,CAAC,OAAO,OAAO,IAAI,MAAM,QAAQ,IAAI;AAAA,IACzC,YAAY,SAAS,IAAI;AAAA,IACzB,YAAY,KAAK,MAAM,EAAE,QAAQ,WAAW,OAAO,EAAE,CAAC;AAAA,EACxD,CAAC;AAED,QAAM,OAAO,OAAO,OAAO,oBAAoB,CAAC;AAIhD,QAAM,QAAQ,OAAO;AACrB,QAAM,YAAY,OAAO,OAAO,WAAW,CAAC;AAE5C,MAAI,QAAQ,GAAG;AACb,WAAO,EAAE,OAAO,uCAAuC,QAAQ,CAAC,EAAE;AAAA,EACpE;AAEA,QAAM,SACJ,OAAO,UAAU,YAAY,QAAQ,IACjC,WAAW,MAAM,OAAO,QAAQ,OAAO,CAAC,KACxC;AAEN,SAAO;AAAA,IACL,OACE,GAAG,YAAY,IAAI,CAAC,GAAG,MAAM,MAC5B,YAAY,IAAI,KAAK,SAAS,cAAc;AAAA,IAC/C,QAAQ;AAAA,MACN;AAAA,QACE,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,YAAY,IAAI;AAAA,QACvB,KAAK,YAAY,IAAI,GAAG,SAAS,aAAa;AAAA,QAC9C,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAAA,MACA,GAAI,SAAS,UAAU,SAClB;AAAA,QACC;AAAA,UACE,MAAM;AAAA,UACN,MAAM,QAAQ,SAAS,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,OAAgB;AAAA,YACtD,IAAI,EAAE;AAAA,YACN,OAAO,EAAE,gBAAgB,EAAE,iBAAiB;AAAA,YAC5C,MAAM,YAAY,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAAA,YACrD,MAAM,uBAAuB,EAAE,EAAE;AAAA,UACnC,EAAE;AAAA,UACF,MAAM;AAAA,UACN,KAAK;AAAA,QACP;AAAA,MACF,IACA,CAAC;AAAA,IACP;AAAA,EACF;AACF;AAUA,MAAM,aAAa;AASnB,MAAM,cAAc;AAEpB,eAAsB,aACpB,MACA,aACA,aAAa,GACQ;AACrB,QAAM,CAAC,KAAK,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,IACrC,aAAa,aAAa,MAAM;AAAA,MAC9B,WAAW,OAAO,QAAQ,UAAU,CAAC;AAAA,MACrC,SAAS,OAAO,oBAAI,KAAK,CAAC;AAAA,IAC5B,CAAC;AAAA,IACD,aAAa,aAAa,MAAM;AAAA,MAC9B,WAAW,OAAO,QAAQ,aAAa,CAAC,CAAC;AAAA,MACzC,SAAS,OAAO,QAAQ,aAAa,CAAC,CAAC;AAAA,IACzC,CAAC;AAAA,EACH,CAAC;AAED,QAAM,UAAU,OAAO,KAAK,OAAO,gBAAgB,CAAC;AACpD,QAAM,SAAS,OAAO,OAAO,OAAO,gBAAgB,CAAC;AACrD,QAAM,SAAS,OAAO,KAAK,OAAO,eAAe,CAAC;AAClD,QAAM,SAAS,eAAe,IAAI,SAAS,GAAG,UAAU;AAExD,MAAI,SAAS,YAAY;AACvB,WAAO;AAAA,MACL,OAAO,QAAQ,MAAM,QAAQ,SAAS,QAAQ,CAAC,SAAS,MAAM;AAAA,MAC9D,QAAQ;AAAA,QACN;AAAA,UACE,MAAM;AAAA,UACN,OAAO,QAAQ,MAAM;AAAA,UACrB,OAAO,YAAY,OAAO;AAAA,UAC1B,KAAK,GAAG,MAAM;AAAA,UACd,MAAM;AAAA,UACN,KAAK;AAAA,QACP;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,QAAQ,WAAW,IAAI,QAAS,UAAU,UAAU,SAAU;AACpE,QAAM,YACJ,UAAU,OACN,+BACA,GAAG,SAAS,IAAI,OAAO,MAAM,IAAI,KAAK,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC;AAElE,QAAM,QACJ,SAAS,cAAc,SAAS,MAAM,QAAQ,SAAS,QAAQ,CAAC,KAAK;AAEvE,SAAO;AAAA,IACL,OAAO,GAAG,YAAY,OAAO,CAAC,SAAS,MAAM,KAAK,SAAS,WAAW,MAAM,UAAU,KAAK;AAAA,IAC3F,QAAQ;AAAA,MACN;AAAA,QACE,MAAM;AAAA,QACN,OAAO,QAAQ,MAAM;AAAA,QACrB,OAAO,YAAY,OAAO;AAAA,QAC1B,KAAK,GAAG,MAAM,oBAAiB,YAAY,MAAM,CAAC;AAAA,QAClD,OAAO,SAAS;AAAA,QAChB,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/potter/potter-turn-actions.d.ts

@@ -0,0 +1,4 @@
+export declare function TurnActions({ text, turnId, }: {
+    text: string;
+    turnId?: string;
+}): import("react").JSX.Element;

package/dist/potter/potter-turn-actions.js

@@ -0,0 +1,137 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { AnimatePresence, motion } from "motion/react";
+import { Check, Copy } from "lucide-react";
+import { openFeedback } from "@withpotter/components/feedback-widget";
+import { useFeedbackSignal } from "@withpotter/components/feedback";
+import { ThumbVote } from "@withpotter/ui-kit";
+import { PRESS_SCALE_LARGE, springs } from "@withpotter/lib/motion";
+import { cn } from "@withpotter/lib/utils";
+function TurnAction({
+  label,
+  active = false,
+  onClick,
+  children
+}) {
+  return /* @__PURE__ */ jsx(
+    motion.button,
+    {
+      type: "button",
+      "aria-label": label,
+      "aria-pressed": active || void 0,
+      onClick,
+      whileTap: { scale: PRESS_SCALE_LARGE },
+      transition: springs.snappy,
+      className: cn(
+        // Matches `ThumbVote`'s phone target. Left at 24px it would have sat
+        // beside two 44px thumbs in the same row, which is worse than either
+        // size on its own.
+        "grid size-11 place-items-center rounded-[var(--radius-card)] lg:size-6",
+        "transition-colors duration-[var(--motion-fast)]",
+        "hover:bg-[var(--interactive-hover)] hover:text-[var(--text-primary)]",
+        active ? "text-[var(--text-primary)]" : "text-[var(--text-tertiary)]"
+      ),
+      children: /* @__PURE__ */ jsx(
+        motion.span,
+        {
+          className: "grid place-items-center",
+          animate: { scale: active ? 1.12 : 1 },
+          transition: springs.bouncy,
+          children
+        }
+      )
+    }
+  );
+}
+function hashText(text) {
+  let hash = 0;
+  for (let i = 0; i < text.length; i += 1) {
+    hash = hash * 31 + text.charCodeAt(i) | 0;
+  }
+  return Math.abs(hash).toString(36);
+}
+function TurnActions({
+  text,
+  turnId
+}) {
+  const [copied, setCopied] = useState(false);
+  const [rating, setRating] = useState(null);
+  const { record } = useFeedbackSignal();
+  const subjectId = turnId ?? `text:${hashText(text)}`;
+  const vote = (next) => {
+    setRating(next);
+    if (!next) return;
+    void record({
+      kind: "thumb",
+      promptKey: "potter.answer.thumb",
+      score: next === "up" ? 1 : -1,
+      subjectType: "potter-turn",
+      subjectId
+    }).catch(() => {
+    });
+    if (next === "down") {
+      openFeedback({
+        category: "question",
+        description: `Box answered: "${text}"
+
+What it should have said:`
+      });
+    }
+  };
+  useEffect(() => {
+    if (!copied) return;
+    const t = setTimeout(() => setCopied(false), 1600);
+    return () => clearTimeout(t);
+  }, [copied]);
+  return (
+    /* The row ARRIVES, a beat after the sentence it belongs to. Landing with
+       the text would read as part of the answer; a short delay makes it read as
+       something offered about the answer, which is what it is. */
+    /* @__PURE__ */ jsxs(
+      motion.div,
+      {
+        initial: { opacity: 0, y: 4 },
+        animate: { opacity: 1, y: 0 },
+        transition: { ...springs.gentle, delay: 0.12 },
+        className: "flex items-center gap-0.5",
+        children: [
+          /* @__PURE__ */ jsx(
+            ThumbVote,
+            {
+              value: rating,
+              onVote: vote,
+              upLabel: "Good answer",
+              downLabel: "Bad answer"
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            TurnAction,
+            {
+              label: copied ? "Copied" : "Copy",
+              onClick: () => {
+                void navigator.clipboard?.writeText(text).then(() => setCopied(true));
+              },
+              children: /* @__PURE__ */ jsx(AnimatePresence, { mode: "wait", initial: false, children: /* @__PURE__ */ jsx(
+                motion.span,
+                {
+                  initial: { opacity: 0, scale: 0.6 },
+                  animate: { opacity: 1, scale: 1 },
+                  exit: { opacity: 0, scale: 0.6 },
+                  transition: springs.bouncy,
+                  className: "grid place-items-center",
+                  children: copied ? /* @__PURE__ */ jsx(Check, { className: "size-[13px]" }) : /* @__PURE__ */ jsx(Copy, { className: "size-[13px]" })
+                },
+                copied ? "done" : "copy"
+              ) })
+            }
+          )
+        ]
+      }
+    )
+  );
+}
+export {
+  TurnActions
+};
+//# sourceMappingURL=potter-turn-actions.js.map

package/dist/potter/potter-turn-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/potter/potter-turn-actions.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useState } from 'react';\nimport { AnimatePresence, motion } from 'motion/react';\nimport { Check, Copy } from 'lucide-react';\nimport { openFeedback } from '@withpotter/components/feedback-widget';\nimport { useFeedbackSignal } from '@withpotter/components/feedback';\nimport { ThumbVote, type ThumbValue } from '@withpotter/ui-kit';\nimport { PRESS_SCALE_LARGE, springs } from '@withpotter/lib/motion';\nimport { cn } from '@withpotter/lib/utils';\n\n/**\n * One 24px ghost control. Three of them make the row under an answer.\n *\n * IT PRESSES, and the glyph POPS when the control becomes active. Two separate\n * motions doing two separate jobs: `PRESS_SCALE` on the whole button is the\n * feedback every control in this app gives under a finger, and the spring on\n * the glyph is the one that carries meaning — a thumb that goes down without\n * moving is the \"snapping\" John banned outright, because the only thing telling\n * you it registered is a colour you were not looking at.\n *\n * `springs.bouncy` is the deliberate-delight spring and this is where it is\n * allowed: rating an answer is rare, and the overshoot is the whole\n * acknowledgement. The press is `snappy`, which is what a button gets.\n */\nfunction TurnAction({\n  label,\n  active = false,\n  onClick,\n  children,\n}: {\n  label: string;\n  active?: boolean;\n  onClick: () => void;\n  children: React.ReactNode;\n}) {\n  return (\n    <motion.button\n      type=\"button\"\n      aria-label={label}\n      aria-pressed={active || undefined}\n      onClick={onClick}\n      whileTap={{ scale: PRESS_SCALE_LARGE }}\n      transition={springs.snappy}\n      className={cn(\n        // Matches `ThumbVote`'s phone target. Left at 24px it would have sat\n        // beside two 44px thumbs in the same row, which is worse than either\n        // size on its own.\n        'grid size-11 place-items-center rounded-[var(--radius-card)] lg:size-6',\n        'transition-colors duration-[var(--motion-fast)]',\n        'hover:bg-[var(--interactive-hover)] hover:text-[var(--text-primary)]',\n        active ? 'text-[var(--text-primary)]' : 'text-[var(--text-tertiary)]',\n      )}\n    >\n      <motion.span\n        className=\"grid place-items-center\"\n        animate={{ scale: active ? 1.12 : 1 }}\n        transition={springs.bouncy}\n      >\n        {children}\n      </motion.span>\n    </motion.button>\n  );\n}\n\n/**\n * The row under Box's answer: was this any good, and let me keep it.\n *\n * NEITHER THUMB IS DECORATION, which is the bar everything on this surface has\n * to clear. This comment used to say the up-vote was a local acknowledgement\n * and nothing more, BECAUSE THERE WAS NO RATINGS ENDPOINT — a thumb that\n * silently POSTed nowhere would have been the exact lie the mic and the removed\n * `+` button were careful not to tell.\n *\n * There is one now (`POST /feedback/signals`, keyed `potter.answer.thumb` with\n * the turn as its subject), so the honest thing changed and this did with it:\n *\n *   up    records the turn as good. It is a real answer to a real question now,\n *         which is what it always looked like.\n *   down  records it AND opens the feedback sheet, prefilled with the answer.\n *         A score says how often Box is wrong; only the sheet says how, and\n *         the tally alone would be the polite version of not asking.\n *   copy  the answer is the thing that gets pasted to a colleague.\n *\n * Recorded against a SUBJECT rather than as a one-per-account prompt, which is\n * what stops it closing itself: every answer gets its own thumbs, forever.\n *\n * The rating is per-turn and lives in this component rather than on the\n * message, deliberately: it is not part of the conversation, it does not\n * belong in the archive, and a thread reopened tomorrow should not still be\n * showing yesterday's thumb.\n */\n/**\n * A short stable id for an answer with no id of its own. Not a security hash —\n * it only has to be the same string twice for the same answer, so that two\n * votes on one turn are two votes on one turn.\n */\nfunction hashText(text: string): string {\n  let hash = 0;\n  for (let i = 0; i < text.length; i += 1) {\n    hash = (hash * 31 + text.charCodeAt(i)) | 0;\n  }\n  return Math.abs(hash).toString(36);\n}\n\nexport function TurnActions({\n  text,\n  turnId,\n}: {\n  text: string;\n  turnId?: string;\n}) {\n  const [copied, setCopied] = useState(false);\n  const [rating, setRating] = useState<ThumbValue | null>(null);\n  const { record } = useFeedbackSignal();\n\n  /**\n   * The subject id falls back to the answer's own text when the caller has no\n   * turn id, hashed down to something a 64-char column will take.\n   *\n   * Without a subject the server treats the signal as a one-per-account prompt\n   * and closes `potter.answer.thumb` after the first vote — every later answer\n   * would record nothing, silently. A stable-per-answer id is the difference\n   * between a working control and one that works once.\n   */\n  const subjectId = turnId ?? `text:${hashText(text)}`;\n\n  const vote = (next: ThumbValue | null) => {\n    setRating(next);\n    if (!next) return;\n    void record({\n      kind: 'thumb',\n      promptKey: 'potter.answer.thumb',\n      score: next === 'up' ? 1 : -1,\n      subjectType: 'potter-turn',\n      subjectId,\n    }).catch(() => {});\n    if (next === 'down') {\n      openFeedback({\n        category: 'question',\n        description: `Box answered: \"${text}\"\\n\\nWhat it should have said:`,\n      });\n    }\n  };\n\n  useEffect(() => {\n    if (!copied) return;\n    const t = setTimeout(() => setCopied(false), 1600);\n    return () => clearTimeout(t);\n  }, [copied]);\n\n  return (\n    /* The row ARRIVES, a beat after the sentence it belongs to. Landing with\n       the text would read as part of the answer; a short delay makes it read as\n       something offered about the answer, which is what it is. */\n    <motion.div\n      initial={{ opacity: 0, y: 4 }}\n      animate={{ opacity: 1, y: 0 }}\n      transition={{ ...springs.gentle, delay: 0.12 }}\n      className=\"flex items-center gap-0.5\"\n    >\n      {/* The pair is `ThumbVote` now rather than two local `TurnAction`s. The\n          treatment is identical — it was lifted from here — and the point of\n          moving it is that three more surfaces were about to re-draw it. Copy\n          stays local: it is an action that fires and forgets, not a verdict\n          being held, which is the same line `Button` and `OptionButton` sit on\n          either side of. */}\n      <ThumbVote\n        value={rating}\n        onVote={vote}\n        upLabel=\"Good answer\"\n        downLabel=\"Bad answer\"\n      />\n\n      <TurnAction\n        label={copied ? 'Copied' : 'Copy'}\n        onClick={() => {\n          void navigator.clipboard?.writeText(text).then(() => setCopied(true));\n        }}\n      >\n        {/* The tick REPLACES the sheets rather than cutting to them —\n            `mode=\"wait\"` so one is gone before the other starts, on a 24px\n            target where a crossfade would just look like a smudge. This is the\n            one place two elements are allowed to swap: they are different\n            symbols saying different things, not one control changing state. */}\n        <AnimatePresence mode=\"wait\" initial={false}>\n          <motion.span\n            key={copied ? 'done' : 'copy'}\n            initial={{ opacity: 0, scale: 0.6 }}\n            animate={{ opacity: 1, scale: 1 }}\n            exit={{ opacity: 0, scale: 0.6 }}\n            transition={springs.bouncy}\n            className=\"grid place-items-center\"\n          >\n            {copied ? (\n              <Check className=\"size-[13px]\" />\n            ) : (\n              <Copy className=\"size-[13px]\" />\n            )}\n          </motion.span>\n        </AnimatePresence>\n      </TurnAction>\n    </motion.div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/potter/use-potter-ask.d.ts

@@ -0,0 +1,59 @@
+import { type PotterReply } from './potter-answer';
+/**
+ * Asking, from either door.
+ *
+ * TWO BRANCHES NOW, AND THE ORDER MATTERS. A question is first offered to
+ * `matchDataIntent`, which claims only the handful of sentences the product
+ * itself offers and can answer out of the merchant's own rows. Everything it
+ * does not claim falls through to `routeQuestion` — the help corpus, the record
+ * search, the setup proposal — exactly as before.
+ *
+ * The data branch goes first because the alternative is what shipped: "which
+ * products are running low" matched `find` on the noun and came back with a
+ * name search for the whole sentence, and "how many appointments today" did the
+ * same on "appointments". A router that owns the widest net cannot be allowed
+ * to see a question a narrower one can actually answer.
+ *
+ * IT IS ASYNC NOW. Routing the corpus never touched the network; reading
+ * invoices does. The docblock this replaces predicted the change and said the
+ * shape would not have to: it returns a promise, voice mode awaits it, and the
+ * `thinking` state that loop already carried is now a state something happens
+ * during.
+ *
+ * The corpus is gated to what this business actually does, and the data tools
+ * are gated twice — by the same behaviours, and by `useMoneyVisibility` for the
+ * two that name a figure. A Front desk hire who cannot see the month's takings
+ * on the home must not be able to ask Box for them either.
+ */
+/** What a caller gets back. `spoken` is the sentence a voice should read. */
+export interface PotterAnswer {
+    spoken: string;
+    /** Present only when the answer came from the corpus rather than the rows. */
+    reply?: PotterReply;
+}
+export declare function usePotterAsk(): (question: string, opts?: {
+    signal?: AbortSignal;
+}) => Promise<PotterAnswer | null>;
+/**
+ * Whether THIS workspace can even be asked a given question.
+ *
+ * WHAT THIS FIXES, found by John on a Health & Wellness workspace that sells
+ * nothing: the bar offered *"Which items are running low?"*, he pressed it, and
+ * Box replied *"Nothing matched"*. Every part of that worked as written —
+ * `matchDataIntent` claimed the sentence, `intentAllowed` correctly refused it
+ * because `low_stock` needs the `purchasable` behaviour and a massage studio
+ * has no stock, and the refusal fell through to a record search that found no
+ * customer by that name. The bug was one step earlier: we OFFERED it.
+ *
+ * `ask-placeholders` says a placeholder is a promise, and its own guard admits
+ * the hole — *"it still does not know which topics a given tenant has enabled —
+ * it runs the full corpus, the most permissive case"*. That is fine for a build
+ * check and useless at runtime, where the tenant is sitting right there. This
+ * closes it: the same gate the answer uses now decides what gets suggested, so
+ * a question on screen is a question this business can have answered.
+ *
+ * Anything the data matcher does NOT claim stays askable — the help corpus and
+ * the record search are open to everyone, and this must never become a second
+ * router deciding what may be typed.
+ */
+export declare function useCanAsk(): (question: string) => boolean;

package/dist/potter/use-potter-ask.js

@@ -0,0 +1,231 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { useCurrentTemplate } from "@withpotter/lib/template-context";
+import { resolveEnabledBehaviors } from "@withpotter/lib/resolve-enabled-behaviors";
+import { resolveHelpTopics } from "@withpotter/lib/help-topics";
+import { useMoneyVisibility } from "@withpotter/lib/use-money-visibility";
+import { useEntityLabel } from "@withpotter/lib/intents/use-entity-label";
+import { formatCurrency } from "@withpotter/lib/utils";
+import {
+  replyLead,
+  replySpoken,
+  routeQuestion
+} from "./potter-answer";
+import { usePotter } from "./potter-context";
+import { matchDataIntent, intentAllowed } from "./potter-data";
+import { potterApi, askPotterStream } from "@withpotter/lib/api/potter";
+import {
+  bookingsToday,
+  lowStock,
+  moneyOwed,
+  salesCompare
+} from "./potter-tools";
+function usePotterAsk() {
+  const { tenant } = useAuth();
+  const { template } = useCurrentTemplate(tenant?.templateId);
+  const { say, resolve, openPotter, messages } = usePotter();
+  const messagesRef = useRef(messages);
+  useEffect(() => {
+    messagesRef.current = messages;
+  }, [messages]);
+  const money = useMoneyVisibility();
+  const bookingLabel = useEntityLabel("booking");
+  const itemLabel = useEntityLabel("item");
+  const behaviors = useMemo(
+    () => resolveEnabledBehaviors(
+      tenant?.settings,
+      template
+    ),
+    [tenant?.settings, template]
+  );
+  const topics = useMemo(() => resolveHelpTopics(behaviors), [behaviors]);
+  const behaviorSet = useMemo(() => new Set(behaviors), [behaviors]);
+  const slug = tenant?.slug;
+  const asMoney = useCallback((n) => formatCurrency(n), []);
+  const runOne = useCallback(
+    (intent, slugArg) => {
+      switch (intent.tool) {
+        case "bookings_today":
+          return bookingsToday(slugArg, bookingLabel);
+        case "low_stock":
+          return lowStock(slugArg, itemLabel);
+        case "money_owed":
+          return moneyOwed(slugArg, asMoney);
+        case "sales_compare":
+          return salesCompare(slugArg, asMoney, intent.windowDays);
+      }
+    },
+    [bookingLabel, itemLabel, asMoney]
+  );
+  const gate = useMemo(
+    () => ({
+      behaviors: behaviorSet,
+      canSeeAmounts: money.canSeeAmounts,
+      canSeeEarnings: money.canSeeEarnings
+    }),
+    [behaviorSet, money.canSeeAmounts, money.canSeeEarnings]
+  );
+  const runAttention = useCallback(
+    async (slugArg) => {
+      const wanted = [
+        { tool: "bookings_today" },
+        { tool: "money_owed" },
+        { tool: "low_stock" }
+      ].filter((i) => intentAllowed(i, gate));
+      if (wanted.length === 0) {
+        return {
+          reply: "Nothing I can check for you on this business yet.",
+          blocks: []
+        };
+      }
+      const results = await Promise.all(
+        wanted.map(async (i) => {
+          try {
+            return { intent: i, answer: await runOne(i, slugArg) };
+          } catch {
+            return null;
+          }
+        })
+      );
+      const got = results.filter(
+        (r) => r !== null
+      );
+      if (got.length === 0) {
+        return {
+          reply: "I could not reach any of that just now. Try again shortly.",
+          blocks: []
+        };
+      }
+      return {
+        reply: got.map((r) => r.answer.reply).join(" "),
+        blocks: got.flatMap((r) => r.answer.blocks),
+        tools: got.map((r) => r.intent.tool)
+      };
+    },
+    [gate, runOne]
+  );
+  return useCallback(
+    async (question, opts) => {
+      const q = question.trim();
+      if (!q) return null;
+      openPotter();
+      say({ role: "you", text: q });
+      const intent = matchDataIntent(q);
+      const allowed = intent !== null && (intent === "attention" || intentAllowed(intent, gate));
+      if (intent !== null && allowed && slug) {
+        const pendingId2 = say({ role: "potter", text: "", pending: true });
+        try {
+          const answer = intent === "attention" ? await runAttention(slug) : await runOne(intent, slug);
+          resolve(pendingId2, {
+            text: answer.reply,
+            blocks: answer.blocks,
+            // The fan-out reports its own; a single tool is the one we chose.
+            toolsUsed: answer.tools ?? (intent === "attention" ? [] : [intent.tool])
+          });
+          return { spoken: answer.reply };
+        } catch {
+          const failed = "I could not reach that just now. Try again in a moment.";
+          resolve(pendingId2, { text: failed, blocks: [] });
+          return { spoken: failed };
+        }
+      }
+      const pendingId = say({ role: "potter", text: "", pending: true });
+      const corpusAnswer = () => {
+        const reply = routeQuestion(q, topics);
+        resolve(pendingId, { text: replyLead(reply), reply });
+        return { spoken: replySpoken(reply), reply };
+      };
+      const history = messagesRef.current.filter((m) => !m.pending && m.text).slice(-10).map((m) => ({ role: m.role, text: m.text }));
+      let streamed = "";
+      const toolsSeen = [];
+      try {
+        const available = await askPotterStream(
+          q,
+          history,
+          (event) => {
+            if (event.type === "text") {
+              streamed += event.text;
+              resolve(pendingId, {
+                text: streamed,
+                toolsUsed: toolsSeen,
+                pending: true
+              });
+            } else if (event.type === "tool") {
+              toolsSeen.push(event.name);
+              resolve(pendingId, { toolsUsed: [...toolsSeen], pending: true });
+            } else if (event.type === "done") {
+              resolve(pendingId, {
+                text: streamed,
+                toolsUsed: event.toolsUsed
+              });
+            } else {
+              resolve(pendingId, { text: event.message, blocks: [] });
+            }
+          },
+          opts?.signal,
+          // Names the workspace. Without it the route has no tenant to check a
+          // permission against and answers 401, which is not a 503 and so does
+          // not fall back — it errors.
+          slug
+        );
+        if (available) return { spoken: streamed };
+        return corpusAnswer();
+      } catch (err) {
+        if (err?.name === "AbortError") {
+          resolve(pendingId, {
+            text: streamed || "Stopped.",
+            toolsUsed: toolsSeen
+          });
+          return { spoken: streamed };
+        }
+        try {
+          const answer = await potterApi.ask(q, history, slug);
+          if (answer && typeof answer.text === "string" && answer.text.trim()) {
+            resolve(pendingId, {
+              text: answer.text,
+              blocks: [],
+              toolsUsed: answer.toolsUsed
+            });
+            return { spoken: answer.text };
+          }
+        } catch {
+          const failed = "I could not reach that just now. Try again in a moment.";
+          resolve(pendingId, { text: failed, blocks: [] });
+          return { spoken: failed };
+        }
+      }
+      return corpusAnswer();
+    },
+    [openPotter, say, resolve, topics, gate, slug, runOne, runAttention]
+  );
+}
+function useCanAsk() {
+  const money = useMoneyVisibility();
+  const { tenant } = useAuth();
+  const { template } = useCurrentTemplate(tenant?.templateId);
+  const behaviors = useMemo(
+    () => resolveEnabledBehaviors(
+      tenant?.settings,
+      template
+    ),
+    [tenant?.settings, template]
+  );
+  return useCallback(
+    (question) => {
+      const intent = matchDataIntent(question);
+      if (!intent || intent === "attention") return true;
+      return intentAllowed(intent, {
+        behaviors: new Set(behaviors),
+        canSeeAmounts: money.canSeeAmounts,
+        canSeeEarnings: money.canSeeEarnings
+      });
+    },
+    [behaviors, money.canSeeAmounts, money.canSeeEarnings]
+  );
+}
+export {
+  useCanAsk,
+  usePotterAsk
+};
+//# sourceMappingURL=use-potter-ask.js.map