@withpotter/components 0.13.0-next.101

package/dist/potter/potter-surface.js

@@ -0,0 +1,110 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AnimatePresence, motion, useReducedMotion } from "motion/react";
+import { durations, eases } from "@withpotter/lib/motion";
+import { usePotter } from "./potter-context";
+import { usePotterAsk } from "./use-potter-ask";
+import { PotterBoot } from "./potter-boot";
+import { PotterIntro } from "./potter-intro";
+import { PotterThread } from "./potter-thread";
+function PotterSurface({
+  compact = false,
+  /**
+   * What pressing one of the intro's suggested questions does.
+   *
+   * Defaults to asking it right here, which is correct in the launcher's panel
+   * and was WRONG on the home the day send started opening `/dashboard/ask`:
+   * typing a question went to the screen and pressing one of the four
+   * suggestions underneath it answered in place, so the same act had two
+   * different destinations depending on whether you typed it or clicked it.
+   * The home passes its own handler; nothing else needs to.
+   */
+  onAsk,
+  /**
+   * What stands in for the intro while the thread is empty.
+   *
+   * The ask screen passes a title. John, looking at the intro line and the
+   * three suggestions on it: *"also remove this … replace with a title text"* —
+   * on a screen whose only object is the composer, a sentence of voice and a
+   * list of examples are two more things to read before typing.
+   *
+   * It replaces the BOOT as well. The mark assembly is how this surface says it
+   * is starting from nothing, and a title on a centred composer says the same
+   * thing in one line and without the second of animation.
+   *
+   * Given rather than hardcoded because the launcher's panel still wants the
+   * intro: there the suggestions ARE the affordance, in a 380px box with no
+   * room to explain itself any other way.
+   */
+  emptyState,
+  /**
+   * Whether THIS surface is the one that asks a handed-over question.
+   *
+   * The launcher's panel is: it has no other machinery, so consuming the seed
+   * on its next effect is the whole handoff. The ask screen is NOT — files can
+   * ride along with a seed now, and only `usePotterTurn` knows how to read one
+   * and put it in a turn. Two consumers would ask the same question twice, so
+   * the screen turns this off and takes the job itself.
+   */
+  consumeSeed = true
+}) {
+  const { messages, seed, clearSeed } = usePotter();
+  const ask = usePotterAsk();
+  const reduce = useReducedMotion();
+  const [booting, setBooting] = useState(() => !seed);
+  const done = useCallback(() => setBooting(false), []);
+  const asked = useRef(false);
+  useEffect(() => {
+    if (!consumeSeed) return;
+    if (!seed) {
+      asked.current = false;
+      return;
+    }
+    if (asked.current) return;
+    asked.current = true;
+    clearSeed();
+    ask(seed);
+  }, [consumeSeed, seed, clearSeed, ask]);
+  const stage = messages.length ? "thread" : emptyState ? "blank" : booting && !reduce && !compact ? "boot" : "intro";
+  return (
+    /**
+     * `mode="wait"` so the boot is GONE before the intro starts, never
+     * crossfading through it — two marks and four questions occupying the same
+     * pixels for 150ms is the visual equivalent of talking over yourself.
+     *
+     * The panel around this is `layout`, so the height it changes to is sprung
+     * rather than snapped. That pairing is the whole trick: without the wait
+     * the height would animate to a size measured mid-crossfade, and without
+     * the layout the intro would appear correctly inside a box that jumped.
+     *
+     * NEVER `initial={false}` HERE. It looks like it only suppresses this
+     * wrapper's own entrance on first mount; it does not. AnimatePresence
+     * publishes it on PresenceContext, every descendant motion component reads
+     * that context and mounts at its `animate` state instead of its `initial`
+     * — so the boot's two halves appeared already interlocked and the lamp
+     * already spent. It killed the arrival animation outright while leaving
+     * every line of that component untouched and looking correct, which is
+     * exactly the kind of bug that survives a code read.
+     */
+    /* @__PURE__ */ jsx(AnimatePresence, { mode: "wait", children: /* @__PURE__ */ jsx(
+      motion.div,
+      {
+        initial: { opacity: 0, y: 6 },
+        animate: { opacity: 1, y: 0 },
+        exit: {
+          opacity: 0,
+          y: -4,
+          transition: { duration: durations.fast, ease: eases.out }
+        },
+        transition: { duration: durations.normal, ease: eases.out },
+        children: stage === "thread" ? /* @__PURE__ */ jsx(PotterThread, { messages }) : stage === "blank" ? emptyState : stage === "boot" ? /* @__PURE__ */ jsx(PotterBoot, { onDone: done }) : /* @__PURE__ */ jsx(PotterIntro, { onAsk: onAsk ?? ask, compact })
+      },
+      stage
+    ) })
+  );
+}
+export {
+  PotterSurface
+};
+//# sourceMappingURL=potter-surface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/potter/potter-surface.tsx"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport { AnimatePresence, motion, useReducedMotion } from 'motion/react';\nimport { durations, eases } from '@withpotter/lib/motion';\nimport { usePotter } from './potter-context';\nimport { usePotterAsk } from './use-potter-ask';\nimport { PotterBoot } from './potter-boot';\nimport { PotterIntro } from './potter-intro';\nimport { PotterThread } from './potter-thread';\n\n/**\n * Boot, then intro, then the thread. Nothing else.\n *\n * Deliberately owns no chrome, no width and no position — the home renders it\n * in the page under its ask bar, the launcher renders it inside an anchored\n * panel, and the two must not be able to drift into different assistants. This\n * is the merge, in one component: whatever the door looks like, this is what is\n * behind it.\n *\n * THE BOOT PLAYS ON AN EMPTY THREAD, not once per session. Square shows its\n * intro every time you open onto a fresh conversation, and that is the right\n * rule: the animation is not a first-run tutorial to be got past, it is how\n * this surface says it is starting from nothing. Say something and it is gone\n * for the rest of the conversation; clear the thread and it is how you come\n * back to the beginning.\n *\n * A seeded open SKIPS IT. Typing a question and pressing Enter is not an\n * arrival, it is an answer being waited for, and a second of mark assembly in\n * front of it would be a loader for work that has already finished.\n *\n * COMPACT SKIPS THE BOOT TOO. Inline under the home's ask bar, this surface\n * appears the moment the field takes focus — and a one-second mark assembly\n * every time someone clicks a search box is an animation punishing you for\n * using the thing. The bar has its own arrival there: six glow rings that bloom\n * and rotate on focus. Box does not need to stage a second one on top.\n *\n * REDUCED MOTION IS GATED HERE rather than inside the boot, and that is not a\n * style preference. A component that decides it should not exist has to say so\n * by calling back into its parent, which means a setState in an effect on the\n * first frame — a cascading render, and the lint rule that bans it is right.\n * The parent already owns the branch; it can simply not render the thing.\n */\nexport function PotterSurface({\n  compact = false,\n  /**\n   * What pressing one of the intro's suggested questions does.\n   *\n   * Defaults to asking it right here, which is correct in the launcher's panel\n   * and was WRONG on the home the day send started opening `/dashboard/ask`:\n   * typing a question went to the screen and pressing one of the four\n   * suggestions underneath it answered in place, so the same act had two\n   * different destinations depending on whether you typed it or clicked it.\n   * The home passes its own handler; nothing else needs to.\n   */\n  onAsk,\n  /**\n   * What stands in for the intro while the thread is empty.\n   *\n   * The ask screen passes a title. John, looking at the intro line and the\n   * three suggestions on it: *\"also remove this … replace with a title text\"* —\n   * on a screen whose only object is the composer, a sentence of voice and a\n   * list of examples are two more things to read before typing.\n   *\n   * It replaces the BOOT as well. The mark assembly is how this surface says it\n   * is starting from nothing, and a title on a centred composer says the same\n   * thing in one line and without the second of animation.\n   *\n   * Given rather than hardcoded because the launcher's panel still wants the\n   * intro: there the suggestions ARE the affordance, in a 380px box with no\n   * room to explain itself any other way.\n   */\n  emptyState,\n  /**\n   * Whether THIS surface is the one that asks a handed-over question.\n   *\n   * The launcher's panel is: it has no other machinery, so consuming the seed\n   * on its next effect is the whole handoff. The ask screen is NOT — files can\n   * ride along with a seed now, and only `usePotterTurn` knows how to read one\n   * and put it in a turn. Two consumers would ask the same question twice, so\n   * the screen turns this off and takes the job itself.\n   */\n  consumeSeed = true,\n}: {\n  compact?: boolean;\n  onAsk?: (question: string) => void;\n  emptyState?: ReactNode;\n  consumeSeed?: boolean;\n}) {\n  const { messages, seed, clearSeed } = usePotter();\n  const ask = usePotterAsk();\n  const reduce = useReducedMotion();\n  const [booting, setBooting] = useState(() => !seed);\n  const done = useCallback(() => setBooting(false), []);\n\n  /**\n   * The door handed over a question. Ask it ONCE.\n   *\n   * `clearSeed()` alone is not enough and the ask screen proved it: send from\n   * the home, land here, and the conversation opened with the question asked\n   * twice and answered twice. `clearSeed` is a setState — it takes effect on a\n   * later render, so every run of this effect that happens before that render\n   * still sees the old `seed` and asks again. Two ways in:\n   *\n   *   - StrictMode mounts, runs effects, tears them down and runs them again\n   *     with the same props. Guaranteed double in development.\n   *   - `ask` is a `useCallback` over the tenant and the entity labels. If any\n   *     of those resolve a beat after mount — which is exactly what happens on\n   *     a cold navigation — its identity changes, this effect re-runs, and the\n   *     seed is still sitting there. That one bites in production too.\n   *\n   * The ref is the fix because it updates synchronously, in the same tick,\n   * where the state cannot. It resets when the seed actually clears, so a\n   * merchant who asks the same question twice still gets it asked twice.\n   */\n  const asked = useRef(false);\n  useEffect(() => {\n    if (!consumeSeed) return;\n    if (!seed) {\n      asked.current = false;\n      return;\n    }\n    if (asked.current) return;\n    asked.current = true;\n    clearSeed();\n    // No `setBooting(false)` here: `booting` was seeded from `!seed`, so a\n    // seeded open never started booting, and an unseeded panel that is later\n    // handed a question is past the boot the moment `ask` pushes a turn.\n    ask(seed);\n  }, [consumeSeed, seed, clearSeed, ask]);\n\n  const stage = messages.length\n    ? 'thread'\n    : emptyState\n      ? 'blank'\n      : booting && !reduce && !compact\n        ? 'boot'\n        : 'intro';\n\n  return (\n    /**\n     * `mode=\"wait\"` so the boot is GONE before the intro starts, never\n     * crossfading through it — two marks and four questions occupying the same\n     * pixels for 150ms is the visual equivalent of talking over yourself.\n     *\n     * The panel around this is `layout`, so the height it changes to is sprung\n     * rather than snapped. That pairing is the whole trick: without the wait\n     * the height would animate to a size measured mid-crossfade, and without\n     * the layout the intro would appear correctly inside a box that jumped.\n     *\n     * NEVER `initial={false}` HERE. It looks like it only suppresses this\n     * wrapper's own entrance on first mount; it does not. AnimatePresence\n     * publishes it on PresenceContext, every descendant motion component reads\n     * that context and mounts at its `animate` state instead of its `initial`\n     * — so the boot's two halves appeared already interlocked and the lamp\n     * already spent. It killed the arrival animation outright while leaving\n     * every line of that component untouched and looking correct, which is\n     * exactly the kind of bug that survives a code read.\n     */\n    <AnimatePresence mode=\"wait\">\n      <motion.div\n        key={stage}\n        initial={{ opacity: 0, y: 6 }}\n        animate={{ opacity: 1, y: 0 }}\n        // The exit carries its own timing rather than a key inside\n        // `transition` — that shape is not part of Transition here, and the\n        // quicker half matters: `mode=\"wait\"` holds the enter until this\n        // finishes, so a slow exit reads as a gap between two screens.\n        exit={{\n          opacity: 0,\n          y: -4,\n          transition: { duration: durations.fast, ease: eases.out },\n        }}\n        // Curves, not springs: this is opacity and four pixels. A spring on\n        // something that does not travel is a spring nobody can see.\n        transition={{ duration: durations.normal, ease: eases.out }}\n      >\n        {stage === 'thread' ? (\n          <PotterThread messages={messages} />\n        ) : stage === 'blank' ? (\n          emptyState\n        ) : stage === 'boot' ? (\n          <PotterBoot onDone={done} />\n        ) : (\n          <PotterIntro onAsk={onAsk ?? ask} compact={compact} />\n        )}\n      </motion.div>\n    </AnimatePresence>\n  );\n}\n"],"mappings":";AAmLU;AAjLV,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AAEzD,SAAS,iBAAiB,QAAQ,wBAAwB;AAC1D,SAAS,WAAW,aAAa;AACjC,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAkCtB,SAAS,cAAc;AAAA,EAC5B,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cAAc;AAChB,GAKG;AACD,QAAM,EAAE,UAAU,MAAM,UAAU,IAAI,UAAU;AAChD,QAAM,MAAM,aAAa;AACzB,QAAM,SAAS,iBAAiB;AAChC,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,MAAM,CAAC,IAAI;AAClD,QAAM,OAAO,YAAY,MAAM,WAAW,KAAK,GAAG,CAAC,CAAC;AAsBpD,QAAM,QAAQ,OAAO,KAAK;AAC1B,YAAU,MAAM;AACd,QAAI,CAAC,YAAa;AAClB,QAAI,CAAC,MAAM;AACT,YAAM,UAAU;AAChB;AAAA,IACF;AACA,QAAI,MAAM,QAAS;AACnB,UAAM,UAAU;AAChB,cAAU;AAIV,QAAI,IAAI;AAAA,EACV,GAAG,CAAC,aAAa,MAAM,WAAW,GAAG,CAAC;AAEtC,QAAM,QAAQ,SAAS,SACnB,WACA,aACE,UACA,WAAW,CAAC,UAAU,CAAC,UACrB,SACA;AAER;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAoBE,oBAAC,mBAAgB,MAAK,QACpB;AAAA,MAAC,OAAO;AAAA,MAAP;AAAA,QAEC,SAAS,EAAE,SAAS,GAAG,GAAG,EAAE;AAAA,QAC5B,SAAS,EAAE,SAAS,GAAG,GAAG,EAAE;AAAA,QAK5B,MAAM;AAAA,UACJ,SAAS;AAAA,UACT,GAAG;AAAA,UACH,YAAY,EAAE,UAAU,UAAU,MAAM,MAAM,MAAM,IAAI;AAAA,QAC1D;AAAA,QAGA,YAAY,EAAE,UAAU,UAAU,QAAQ,MAAM,MAAM,IAAI;AAAA,QAEzD,oBAAU,WACT,oBAAC,gBAAa,UAAoB,IAChC,UAAU,UACZ,aACE,UAAU,SACZ,oBAAC,cAAW,QAAQ,MAAM,IAE1B,oBAAC,eAAY,OAAO,SAAS,KAAK,SAAkB;AAAA;AAAA,MAvBjD;AAAA,IAyBP,GACF;AAAA;AAEJ;","names":[]}

package/dist/potter/potter-thread.d.ts

@@ -0,0 +1,27 @@
+import type { PotterMessage } from './potter-context';
+/**
+ * The conversation.
+ *
+ * WHAT MAKES THIS NOT A CHAT MOCKUP: every Box turn ends in a control that
+ * goes somewhere real. A help match renders the answer and the route that does
+ * it; a lookup hands the words to the command palette rather than reprinting
+ * them; a setup sentence POSTs to the proposal engine that /dashboard/agency
+ * already drives. Nothing here renders a paragraph and stops.
+ *
+ * ONE SIDE GETS A BUBBLE, NOT BOTH. The merchant's turn is a short sentence
+ * and sits in a filled block on the right, the way it does in every product
+ * they already use; Box's is plain text on the left behind its mark,
+ * because Box's turn is not a sentence — it is a sentence plus help
+ * answers, plus record results, plus buttons, and none of that survives being
+ * squeezed into a balloon at 80% width.
+ *
+ * The previous rule here was "no bubbles on either side", argued from height
+ * in a small panel. It cost more than it saved: with a thin left rule as the
+ * only difference between speakers, the merchant's own question read as a
+ * caption on the answer. John, twice, on two different rounds of this
+ * surface — *"where is the chat ui, like the back and forth"*, then *"theur no
+ * chat ui or what not like how claude does it or chatgpt or grok"*.
+ */
+export declare function PotterThread({ messages }: {
+    messages: PotterMessage[];
+}): import("react").JSX.Element;

package/dist/potter/potter-thread.js

@@ -0,0 +1,247 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { useRouter } from "next/navigation";
+import { AnimatePresence, motion } from "motion/react";
+import { ArrowRight, Loader2 } from "lucide-react";
+import { useMutation } from "@tanstack/react-query";
+import { BoxMark } from "@withpotter/ui-kit/box-mark";
+import { Button } from "@withpotter/ui-kit/button";
+import { ChatMessage } from "@withpotter/ui-kit/chat-message";
+import { ThinkingIndicator } from "@withpotter/ui-kit/thinking-indicator";
+import { PotterSteps } from "./potter-steps";
+import { PhotoKeep } from "./potter-photo-keep";
+import { openFeedback } from "@withpotter/components/feedback-widget";
+import { AskResults } from "@withpotter/components/dashboard/home/ask-results";
+import { onboardingApi } from "@withpotter/lib/api/onboarding";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { useEntityLabel } from "@withpotter/lib/intents/use-entity-label";
+import { useIntentConfig } from "@withpotter/lib/intents/use-intent-config";
+import {
+  homeAddItemIntent,
+  homeAddItemLinks
+} from "@withpotter/components/dashboard/home/home-add-item-links";
+import { durations, eases } from "@withpotter/lib/motion";
+import { usePotter } from "./potter-context";
+import { dayStamp } from "./potter-history";
+import { TurnActions } from "./potter-turn-actions";
+import { usePotterAsk } from "./use-potter-ask";
+import { AskTheTeam } from "./potter-block-door";
+import { PotterBlocks } from "./potter-blocks";
+function PotterThread({ messages }) {
+  const endRef = useRef(null);
+  const turnRef = useRef(null);
+  useEffect(() => {
+    const anchor = turnRef.current ?? endRef.current;
+    if (!anchor) return;
+    let box = anchor.parentElement;
+    while (box) {
+      const overflow = getComputedStyle(box).overflowY;
+      if (overflow === "auto" || overflow === "scroll") break;
+      box = box.parentElement;
+    }
+    if (!box) return;
+    box.scrollTo({
+      top: anchor.offsetTop - box.offsetTop,
+      behavior: "smooth"
+    });
+  }, [messages.length]);
+  const lastAsk = [...messages].reverse().find((m) => m.role === "you")?.id;
+  const startedAt = messages[0]?.at;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+    startedAt ? /* @__PURE__ */ jsx("div", { className: "py-2 text-center text-xs font-medium text-[var(--text-muted)]", children: /* @__PURE__ */ jsx("time", { dateTime: new Date(startedAt).toISOString(), children: dayStamp(startedAt) }) }) : null,
+    /* @__PURE__ */ jsx(AnimatePresence, { initial: false, children: messages.map(
+      (m) => m.role === "you" ? /* @__PURE__ */ jsx(
+        motion.div,
+        {
+          ref: m.id === lastAsk ? turnRef : void 0,
+          initial: { opacity: 0, y: 6 },
+          animate: { opacity: 1, y: 0 },
+          transition: { duration: durations.normal, ease: eases.out },
+          className: "flex justify-end",
+          children: /* @__PURE__ */ jsxs("div", { className: "flex max-w-[80%] flex-col items-end gap-2", children: [
+            m.attachments?.length ? /* @__PURE__ */ jsx("div", { className: "flex flex-wrap justify-end gap-2", children: m.attachments.map((url) => (
+              // eslint-disable-next-line @next/next/no-img-element
+              /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: url,
+                  alt: "",
+                  className: "size-14 rounded-[var(--radius-card)] object-cover"
+                },
+                url
+              )
+            )) }) : null,
+            m.text ? /* @__PURE__ */ jsx(ChatMessage, { role: "user", children: m.text }) : null
+          ] })
+        },
+        m.id
+      ) : /* @__PURE__ */ jsxs(
+        motion.div,
+        {
+          initial: { opacity: 0, y: 8 },
+          animate: { opacity: 1, y: 0 },
+          transition: { duration: durations.slow, ease: eases.settle },
+          className: "group/turn flex gap-3",
+          children: [
+            /* @__PURE__ */ jsx(
+              BoxMark,
+              {
+                glyph: "mark",
+                height: 13,
+                className: "mt-[4px] shrink-0 text-[var(--text-primary)]"
+              }
+            ),
+            /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1 space-y-3", children: [
+              m.pending ? (
+                /* A real wait, so a real waiting state.
+                   Deliberately three dots and not a token-by-token reveal:
+                   the corpus answers instantly and faking a stream over it
+                   would be theatre. This appears only while a tool is
+                   actually reading the merchant's rows. */
+                /* @__PURE__ */ jsx(Thinking, {})
+              ) : /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsx("p", { className: "min-w-0 text-md text-[var(--text-primary)]", children: m.text }),
+                m.toolsUsed?.length ? /* @__PURE__ */ jsx(PotterSteps, { tools: m.toolsUsed }) : null,
+                /* @__PURE__ */ jsx(TurnActions, { text: m.text })
+              ] }),
+              m.blocks?.length ? /* @__PURE__ */ jsx(PotterBlocks, { blocks: m.blocks }) : null,
+              m.reply && /* @__PURE__ */ jsx(ReplyBody, { reply: m.reply })
+            ] })
+          ]
+        },
+        m.id
+      )
+    ) }),
+    /* @__PURE__ */ jsx("div", { ref: endRef })
+  ] });
+}
+function ReplyBody({ reply }) {
+  switch (reply.kind) {
+    case "help":
+      return /* @__PURE__ */ jsx(HelpAnswers, { reply });
+    case "find":
+      return /* @__PURE__ */ jsx(FindResults, { query: reply.query });
+    case "setup":
+      return /* @__PURE__ */ jsx(SetupProposal, { intent: reply.intent });
+    case "sheet":
+      return /* @__PURE__ */ jsx(SheetImport, { reply });
+    case "photo":
+      return /* @__PURE__ */ jsx(PhotoKeep, { reply });
+    case "unsure":
+      return /* @__PURE__ */ jsx(AskTheTeam, {});
+  }
+}
+function SheetImport({
+  reply
+}) {
+  const router = useRouter();
+  const itemLabel = useEntityLabel("item");
+  const intentConfig = useIntentConfig();
+  const { importSheet } = homeAddItemLinks(
+    homeAddItemIntent(intentConfig, itemLabel)
+  );
+  if (!reply.usable) return null;
+  return /* @__PURE__ */ jsx(Button, { onClick: () => router.push(importSheet), children: `Import ${reply.rows} ${itemLabel.plural.toLowerCase()}` });
+}
+function HelpAnswers({
+  reply
+}) {
+  const router = useRouter();
+  const { closePotter } = usePotter();
+  const ask = usePotterAsk();
+  const [top, ...rest] = reply.topics;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+    top?.steps?.length ? /* @__PURE__ */ jsx("ol", { className: "list-inside list-decimal space-y-0.5 text-sm text-[var(--text-tertiary)]", children: top.steps.slice(0, 3).map((step) => /* @__PURE__ */ jsx("li", { children: step }, step)) }) : null,
+    top?.action && /* @__PURE__ */ jsxs(
+      Button,
+      {
+        variant: "secondary",
+        size: "sm",
+        onClick: () => {
+          closePotter();
+          router.push(top.action.href);
+        },
+        children: [
+          top.action.label,
+          /* @__PURE__ */ jsx(ArrowRight, {})
+        ]
+      }
+    ),
+    rest.length > 0 && /* No eyebrow over these. "ALSO ON THIS" in caps is the exact label
+       shape the house copy rules ban, and the chips do not need one —
+       a row of questions under an answer reads as more questions. */
+    /* @__PURE__ */ jsx("div", { className: "pt-1", children: /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2", children: rest.slice(0, 3).map((t) => /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: () => ask(t.question),
+        className: "surface-inset rounded-lg px-2 py-1 text-left text-sm text-[var(--text-secondary)] hover:text-[var(--text-primary)]",
+        children: t.question
+      },
+      t.id
+    )) }) }),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: () => openFeedback({
+          category: "question",
+          description: reply.topics[0]?.question ?? ""
+        }),
+        className: "text-2xs text-[var(--text-muted)] hover:text-[var(--text-secondary)]",
+        children: "Didn\u2019t answer it?"
+      }
+    )
+  ] });
+}
+function FindResults({ query }) {
+  const { closePotter } = usePotter();
+  return /* @__PURE__ */ jsx(AskResults, { query, onNavigate: closePotter });
+}
+function SetupProposal({ intent }) {
+  const { tenant } = useAuth();
+  const router = useRouter();
+  const { closePotter } = usePotter();
+  const [sent, setSent] = useState(false);
+  const propose = useMutation({
+    mutationFn: () => onboardingApi.proposeAgencySetup(tenant.id, { rawIntent: intent }),
+    onSuccess: () => setSent(true)
+  });
+  if (sent) {
+    return /* @__PURE__ */ jsxs(
+      Button,
+      {
+        onClick: () => {
+          closePotter();
+          router.push("/dashboard/agency");
+        },
+        children: [
+          "Review the plan",
+          /* @__PURE__ */ jsx(ArrowRight, {})
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+    /* @__PURE__ */ jsxs(
+      Button,
+      {
+        onClick: () => propose.mutate(),
+        disabled: propose.isPending || !tenant?.id,
+        children: [
+          propose.isPending && /* @__PURE__ */ jsx(Loader2, { className: "animate-spin" }),
+          propose.isPending ? "Drafting" : "Draft the plan"
+        ]
+      }
+    ),
+    propose.isError && /* @__PURE__ */ jsx("p", { className: "text-sm text-[var(--error)]", children: "That didn\u2019t go through. Try again, or tell the team." })
+  ] });
+}
+function Thinking() {
+  return /* @__PURE__ */ jsx(ThinkingIndicator, { className: "py-1" });
+}
+export {
+  PotterThread
+};
+//# sourceMappingURL=potter-thread.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/potter/potter-thread.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef, useState } from 'react';\nimport { useRouter } from 'next/navigation';\nimport { AnimatePresence, motion } from 'motion/react';\nimport { ArrowRight, Loader2 } from 'lucide-react';\nimport { useMutation } from '@tanstack/react-query';\nimport { BoxMark } from '@withpotter/ui-kit/box-mark';\nimport { Button } from '@withpotter/ui-kit/button';\nimport { ChatMessage } from '@withpotter/ui-kit/chat-message';\nimport { ThinkingIndicator } from '@withpotter/ui-kit/thinking-indicator';\nimport { PotterSteps } from './potter-steps';\nimport { PhotoKeep } from './potter-photo-keep';\nimport { openFeedback } from '@withpotter/components/feedback-widget';\nimport { AskResults } from '@withpotter/components/dashboard/home/ask-results';\nimport { onboardingApi } from '@withpotter/lib/api/onboarding';\nimport { useAuth } from '@withpotter/lib/auth-context';\nimport { useEntityLabel } from '@withpotter/lib/intents/use-entity-label';\nimport { useIntentConfig } from '@withpotter/lib/intents/use-intent-config';\nimport {\n  homeAddItemIntent,\n  homeAddItemLinks,\n} from '@withpotter/components/dashboard/home/home-add-item-links';\nimport { durations, eases } from '@withpotter/lib/motion';\nimport type { PotterMessage } from './potter-context';\nimport { usePotter } from './potter-context';\nimport { dayStamp } from './potter-history';\nimport { TurnActions } from './potter-turn-actions';\nimport { usePotterAsk } from './use-potter-ask';\nimport { AskTheTeam } from './potter-block-door';\nimport { PotterBlocks } from './potter-blocks';\nimport type { PotterReply } from './potter-answer';\n\n/**\n * The conversation.\n *\n * WHAT MAKES THIS NOT A CHAT MOCKUP: every Box turn ends in a control that\n * goes somewhere real. A help match renders the answer and the route that does\n * it; a lookup hands the words to the command palette rather than reprinting\n * them; a setup sentence POSTs to the proposal engine that /dashboard/agency\n * already drives. Nothing here renders a paragraph and stops.\n *\n * ONE SIDE GETS A BUBBLE, NOT BOTH. The merchant's turn is a short sentence\n * and sits in a filled block on the right, the way it does in every product\n * they already use; Box's is plain text on the left behind its mark,\n * because Box's turn is not a sentence — it is a sentence plus help\n * answers, plus record results, plus buttons, and none of that survives being\n * squeezed into a balloon at 80% width.\n *\n * The previous rule here was \"no bubbles on either side\", argued from height\n * in a small panel. It cost more than it saved: with a thin left rule as the\n * only difference between speakers, the merchant's own question read as a\n * caption on the answer. John, twice, on two different rounds of this\n * surface — *\"where is the chat ui, like the back and forth\"*, then *\"theur no\n * chat ui or what not like how claude does it or chatgpt or grok\"*.\n */\n\nexport function PotterThread({ messages }: { messages: PotterMessage[] }) {\n  const endRef = useRef<HTMLDivElement>(null);\n  const turnRef = useRef<HTMLParagraphElement>(null);\n\n  /**\n   * THE NEWEST TURN GOES TO THE TOP, NOT THE BOTTOM, and getting this backwards\n   * hid the entire conversation.\n   *\n   * Scrolling the END into view is the right move in a tall chat window where\n   * the newest message is one short line. Here the newest \"message\" is a help\n   * answer with three topics and three buttons, and the box on the home is\n   * capped at 52vh — so pinning its bottom edge scrolled the merchant's own\n   * question, Box's mark and the lead sentence all out of the top. What was\n   * left on screen was a wall of unattributed help text under a search field.\n   * John, looking at it: *\"where is the chat ui, like the back and forth\"*. It\n   * was there. It was above the scroll.\n   *\n   * Anchoring the newest QUESTION to the top instead means an exchange always\n   * reads from its beginning: what you asked, then the reply under it.\n   */\n  useEffect(() => {\n    const anchor = turnRef.current ?? endRef.current;\n    if (!anchor) return;\n\n    /**\n     * Scroll the TRANSCRIPT, never the page.\n     *\n     * `scrollIntoView` walks every scrollable ancestor including the document,\n     * which was harmless while this hung loose under the home's ask bar and\n     * wrong the moment it went inside a panel: bringing the newest turn to the\n     * top of the box also drove the box itself off the top of the window, so\n     * the header — Box's name, history, new, close — scrolled away and the\n     * conversation appeared to start mid-air.\n     */\n    let box: HTMLElement | null = anchor.parentElement;\n    while (box) {\n      const overflow = getComputedStyle(box).overflowY;\n      if (overflow === 'auto' || overflow === 'scroll') break;\n      box = box.parentElement;\n    }\n    if (!box) return;\n    box.scrollTo({\n      top: anchor.offsetTop - box.offsetTop,\n      behavior: 'smooth',\n    });\n  }, [messages.length]);\n\n  /**\n   * The composer now sits under this, so the transcript scrolls INSIDE a box\n   * whose bottom edge is fixed. Anchoring the newest question to the top of\n   * that box is still right — an exchange should read from its beginning —\n   * and the reason it was wrong before is unchanged: pinning the bottom\n   * scrolled the question, the mark and the lead sentence out of the top.\n   */\n\n  /** The last thing the merchant said — the top of the newest exchange. */\n  const lastAsk = [...messages].reverse().find((m) => m.role === 'you')?.id;\n\n  /**\n   * WHEN THE CONVERSATION STARTED, once, above it — `Today 08:01`.\n   *\n   * Ported from Linear's thread, where it is 12px at weight 500 in the faintest\n   * ink on the page, centred, with no rule through it. It earns its line by\n   * answering the one question a returning merchant actually has about a thread\n   * they are looking at: is this the one from this morning, or the one from\n   * last week? A per-turn timestamp would answer it too and would cost a line\n   * of chrome per exchange to do it.\n   *\n   * Guarded on `at` because conversations archived before that field existed\n   * read back without one. No stamp is better than a wrong one.\n   */\n  const startedAt = messages[0]?.at;\n\n  return (\n    <div className=\"space-y-4\">\n      {startedAt ? (\n        <div className=\"py-2 text-center text-xs font-medium text-[var(--text-muted)]\">\n          <time dateTime={new Date(startedAt).toISOString()}>\n            {dayStamp(startedAt)}\n          </time>\n        </div>\n      ) : null}\n      <AnimatePresence initial={false}>\n        {messages.map((m) =>\n          m.role === 'you' ? (\n            <motion.div\n              key={m.id}\n              ref={m.id === lastAsk ? turnRef : undefined}\n              initial={{ opacity: 0, y: 6 }}\n              animate={{ opacity: 1, y: 0 }}\n              transition={{ duration: durations.normal, ease: eases.out }}\n              className=\"flex justify-end\"\n            >\n              {/* `surface-inset`, not a brand fill. A merchant's own question\n                  is not an alert and colouring it would make the quietest\n                  thing in the thread the loudest. `max-w-[80%]` so a long\n                  question still reads as a turn rather than as a paragraph\n                  that happens to be indented. */}\n              <div className=\"flex max-w-[80%] flex-col items-end gap-2\">\n                {/* WHAT WENT WITH IT, shown rather than named. The same\n                    squares the composer was holding, at the same size, so\n                    pressing send moves them rather than replacing them with a\n                    list of filenames nobody can read. */}\n                {m.attachments?.length ? (\n                  <div className=\"flex flex-wrap justify-end gap-2\">\n                    {m.attachments.map((url) => (\n                      // eslint-disable-next-line @next/next/no-img-element\n                      <img\n                        key={url}\n                        src={url}\n                        alt=\"\"\n                        className=\"size-14 rounded-[var(--radius-card)] object-cover\"\n                      />\n                    ))}\n                  </div>\n                ) : null}\n                {m.text ? (\n                  <ChatMessage role=\"user\">{m.text}</ChatMessage>\n                ) : null}\n              </div>\n            </motion.div>\n          ) : (\n            <motion.div\n              key={m.id}\n              initial={{ opacity: 0, y: 8 }}\n              animate={{ opacity: 1, y: 0 }}\n              transition={{ duration: durations.slow, ease: eases.settle }}\n              className=\"group/turn flex gap-3\"\n            >\n              <BoxMark\n                glyph=\"mark\"\n                height={13}\n                className=\"mt-[4px] shrink-0 text-[var(--text-primary)]\"\n              />\n              <div className=\"min-w-0 flex-1 space-y-3\">\n                {m.pending ? (\n                  /* A real wait, so a real waiting state.\n                     Deliberately three dots and not a token-by-token reveal:\n                     the corpus answers instantly and faking a stream over it\n                     would be theatre. This appears only while a tool is\n                     actually reading the merchant's rows. */\n                  <Thinking />\n                ) : (\n                  <>\n                    <p className=\"min-w-0 text-md text-[var(--text-primary)]\">\n                      {m.text}\n                    </p>\n                    {/* UNDER the sentence, not beside it, and always there.\n\n                        It used to be a lone copy button floating at the right\n                        edge of the answer, revealed on hover. Two things were\n                        wrong with that and Linear's thread shows both: a\n                        control that only exists on hover does not exist on a\n                        touch screen at all, and an action about the answer,\n                        parked at the far right of it, reads as belonging to the\n                        column rather than to the turn. Theirs is a row of three\n                        directly beneath the text, in the faintest ink, visible\n                        from the moment the answer lands. */}\n                    {/* The working, under the answer and above the controls:\n                        you read the sentence, then ask where it came from, then\n                        decide what to do about it. `m.toolsUsed` is empty for a\n                        help answer, which read nothing — and `PotterSteps`\n                        draws nothing rather than an empty trail. */}\n                    {m.toolsUsed?.length ? (\n                      <PotterSteps tools={m.toolsUsed} />\n                    ) : null}\n                    <TurnActions text={m.text} />\n                  </>\n                )}\n                {m.blocks?.length ? <PotterBlocks blocks={m.blocks} /> : null}\n                {m.reply && <ReplyBody reply={m.reply} />}\n              </div>\n            </motion.div>\n          ),\n        )}\n      </AnimatePresence>\n      <div ref={endRef} />\n    </div>\n  );\n}\n\n/** The affordances under Box's sentence, one shape per branch. */\nfunction ReplyBody({ reply }: { reply: PotterReply }) {\n  switch (reply.kind) {\n    case 'help':\n      return <HelpAnswers reply={reply} />;\n    case 'find':\n      return <FindResults query={reply.query} />;\n    case 'setup':\n      return <SetupProposal intent={reply.intent} />;\n    case 'sheet':\n      return <SheetImport reply={reply} />;\n    case 'photo':\n      return <PhotoKeep reply={reply} />;\n    case 'unsure':\n      return <AskTheTeam />;\n  }\n}\n\n/**\n * The one control under a spreadsheet Box has read.\n *\n * It navigates rather than importing here, and that is the whole point: the\n * catalogue's importer already maps columns, spots duplicates, shows what will\n * change and runs the batch. Rebuilding any of that inside a chat turn would be\n * a second importer to keep in step with the first. Box's job was to read\n * the file and say what is in it; this hands it over.\n *\n * The file itself travels on the context (`pendingSheet`), so the importer\n * opens with it already loaded — the merchant picks it once, not twice.\n */\nfunction SheetImport({\n  reply,\n}: {\n  reply: Extract<PotterReply, { kind: 'sheet' }>;\n}) {\n  const router = useRouter();\n  const itemLabel = useEntityLabel('item');\n  const intentConfig = useIntentConfig();\n  // Named, as Home's own Import is, so the rows land on Inventory.\n  const { importSheet } = homeAddItemLinks(\n    homeAddItemIntent(intentConfig, itemLabel),\n  );\n\n  // Nothing to offer when the file cannot be used — the sentence above already\n  // said why, and a button that opens an importer for an unusable file is an\n  // invitation to a dead end.\n  if (!reply.usable) return null;\n\n  return (\n    <Button onClick={() => router.push(importSheet)}>\n      {`Import ${reply.rows} ${itemLabel.plural.toLowerCase()}`}\n    </Button>\n  );\n}\n\nfunction HelpAnswers({\n  reply,\n}: {\n  reply: Extract<PotterReply, { kind: 'help' }>;\n}) {\n  const router = useRouter();\n  const { closePotter } = usePotter();\n  const ask = usePotterAsk();\n  const [top, ...rest] = reply.topics;\n\n  return (\n    <div className=\"space-y-3\">\n      {/* The top topic's ANSWER is not here — it is the turn's own sentence\n          above, because that is the answer. What is left of it is the part\n          that does not fit in a sentence: the steps, and the door. */}\n      {top?.steps?.length ? (\n        <ol className=\"list-inside list-decimal space-y-0.5 text-sm text-[var(--text-tertiary)]\">\n          {top.steps.slice(0, 3).map((step) => (\n            <li key={step}>{step}</li>\n          ))}\n        </ol>\n      ) : null}\n\n      {top?.action && (\n        <Button\n          variant=\"secondary\"\n          size=\"sm\"\n          onClick={() => {\n            closePotter();\n            router.push(top.action!.href);\n          }}\n        >\n          {top.action.label}\n          <ArrowRight />\n        </Button>\n      )}\n\n      {/* The other matches, as questions rather than as more answer.\n          They used to be printed in full underneath — a second heading, a\n          second paragraph, a second list — which is how one question produced\n          a page. Asked instead of shown, they are both the citation for what\n          else matched and the follow-up chips every chat surface offers. */}\n      {rest.length > 0 && (\n        /* No eyebrow over these. \"ALSO ON THIS\" in caps is the exact label\n           shape the house copy rules ban, and the chips do not need one —\n           a row of questions under an answer reads as more questions. */\n        <div className=\"pt-1\">\n          <div className=\"flex flex-wrap gap-2\">\n            {rest.slice(0, 3).map((t) => (\n              <button\n                key={t.id}\n                type=\"button\"\n                onClick={() => ask(t.question)}\n                className=\"surface-inset rounded-lg px-2 py-1 text-left text-sm text-[var(--text-secondary)] hover:text-[var(--text-primary)]\"\n              >\n                {t.question}\n              </button>\n            ))}\n          </div>\n        </div>\n      )}\n\n      {/* The way out of a wrong answer, and it goes somewhere real.\n          A thumbs-up/down pair with no endpoint behind it collects nothing and\n          tells the merchant their opinion was recorded when it was not. This\n          opens the feedback the team actually reads, with the question they\n          asked already in it. */}\n      <button\n        type=\"button\"\n        onClick={() =>\n          openFeedback({\n            category: 'question',\n            description: reply.topics[0]?.question ?? '',\n          })\n        }\n        className=\"text-2xs text-[var(--text-muted)] hover:text-[var(--text-secondary)]\"\n      >\n        Didn’t answer it?\n      </button>\n    </div>\n  );\n}\n\n/**\n * A lookup renders the RESULTS, not a button that promises them.\n *\n * This was a \"Search for …\" button handing the words to the command palette,\n * on the reasoning that the palette already resolves orders, invoices,\n * customers and products and a second result list would be a second search\n * experience. The reasoning was right and the conclusion was one step short:\n * the answer to \"don't build a second one\" is to render the FIRST one here,\n * not to bounce the merchant into a modal and close yourself.\n *\n * `AskResults` is that first one. It was built for the home's ask bar in\n * parallel with this panel — records, destinations with real template\n * thumbnails, and help answered inline — and it is a better lookup surface than\n * anything this file was going to grow. So Box decides a sentence is a\n * lookup and then hands the whole block to it. One implementation, two doors,\n * which is the same argument the rest of this merge is making.\n */\nfunction FindResults({ query }: { query: string }) {\n  const { closePotter } = usePotter();\n  return <AskResults query={query} onNavigate={closePotter} />;\n}\n\n/**\n * The one branch that hits a model. `proposeAgencySetup` is the real onboarding\n * engine behind /dashboard/agency, and its answer is a PROPOSAL — a plan the\n * merchant reviews before a single record changes. That review screen is not\n * rebuilt in here; Box drafts and hands over.\n */\nfunction SetupProposal({ intent }: { intent: string }) {\n  const { tenant } = useAuth();\n  const router = useRouter();\n  const { closePotter } = usePotter();\n  const [sent, setSent] = useState(false);\n\n  const propose = useMutation({\n    mutationFn: () =>\n      onboardingApi.proposeAgencySetup(tenant!.id, { rawIntent: intent }),\n    onSuccess: () => setSent(true),\n  });\n\n  if (sent) {\n    return (\n      <Button\n        onClick={() => {\n          closePotter();\n          router.push('/dashboard/agency');\n        }}\n      >\n        Review the plan\n        <ArrowRight />\n      </Button>\n    );\n  }\n\n  return (\n    <div className=\"space-y-2\">\n      <Button\n        onClick={() => propose.mutate()}\n        disabled={propose.isPending || !tenant?.id}\n      >\n        {propose.isPending && <Loader2 className=\"animate-spin\" />}\n        {propose.isPending ? 'Drafting' : 'Draft the plan'}\n      </Button>\n      {/* Said out loud rather than swallowed. A draft that failed silently\n          leaves the merchant waiting on a plan that was never coming. */}\n      {propose.isError && (\n        <p className=\"text-sm text-[var(--error)]\">\n          That didn’t go through. Try again, or tell the team.\n        </p>\n      )}\n    </div>\n  );\n}\n\n/**\n * Box is reading something.\n *\n * Only ever shown while a tool is in flight. The help corpus is a regex and\n * returns in the same tick, so a spinner over it would be a loader for work\n * that has already finished — which is the tell that makes software feel fake.\n */\nfunction Thinking() {\n  /**\n   * WHAT THIS REPLACED: three dots pulsing at staggered opacity — the loader\n   * every product uses, which says only \"something is happening\". A dot cannot\n   * tell a request in flight from a page that has hung, and a merchant four\n   * seconds in is asking exactly that.\n   *\n   * The words are the ones this surface can honestly claim: Box reads rows,\n   * so it checks and reads. Nothing here says \"planning\".\n   */\n  return <ThinkingIndicator className=\"py-1\" />;\n}\n"],"mappings":"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","names":[]}

package/dist/potter/potter-tools.d.ts

@@ -0,0 +1,71 @@
+import type { PotterBlock } from './potter-blocks';
+/**
+ * What Box can actually look up.
+ *
+ * THE POINT OF THIS FILE. Until now nothing Box said had read a single row
+ * of the merchant's data — `potter-answer.ts` is a keyword router over a help
+ * corpus and says so in capitals at the top of itself. These are the reads that
+ * make the four questions the intro OFFERS true, which is the whole of the
+ * promise `ask-placeholders.ts` is written to keep.
+ *
+ * EACH ONE WRAPS A CLIENT METHOD THAT ALREADY EXISTS. No new endpoint, no new
+ * query, no second way to count an invoice — `docs/POTTER_BRAIN_SPEC.md` chose
+ * this deliberately and the reason is the Agent Lee failure quoted in it: an
+ * assistant that gets its own data path gets its own permissions, and then its
+ * own bugs about whose data it is. These run through `apiFetch`, which means
+ * the proxy, which means the merchant's own session and the tenant scoping we
+ * already have. Box never holds a credential.
+ *
+ * THEY RETURN BLOCKS, NOT PROSE. A tool hands back a sentence and a closed
+ * union of renderable things (`PotterBlock`), so an answer that cannot be built
+ * out of real rows cannot be produced at all. That is the honesty rule from the
+ * spec, enforced by the type rather than by a system prompt.
+ *
+ * NO MODEL IS INVOLVED YET. `potter-data.ts` picks the tool by pattern, which
+ * is exact for the handful of questions the product actually offers and refuses
+ * everything else. When the answering endpoint lands, the model picks the tool
+ * instead and these do not change.
+ */
+export interface ToolAnswer {
+    /** The sentence Box says. It must contain the answer, not describe it. */
+    reply: string;
+    blocks: PotterBlock[];
+    /**
+     * Which lookups ran. Set by the caller that chose them rather than by the
+     * tools themselves — a tool knows what it read, not what it was called as
+     * part of, and the fan-out needs to report the ones that actually returned.
+     */
+    tools?: string[];
+}
+/**
+ * What is on the book today.
+ *
+ * Answers "how many appointments today", which is the question John used to
+ * show that Box answered none of them: it matched `find` on the word
+ * "appointments" and returned a name search for the whole sentence.
+ */
+export declare function bookingsToday(slug: string, labels: {
+    singular: string;
+    plural: string;
+}): Promise<ToolAnswer>;
+/**
+ * What is running out.
+ *
+ * `stockStatus: 'lowStock'` is the server's own filter, so this cannot disagree
+ * with the Catalogue's own count the way the home's low-stock blocker did — it
+ * had its own arithmetic, ignored `trackInventory`, and told every business
+ * that keeps no stock that all of it was running out.
+ */
+export declare function lowStock(slug: string, labels: {
+    singular: string;
+    plural: string;
+}): Promise<ToolAnswer>;
+/**
+ * Who has not paid.
+ *
+ * Overdue AND sent, because "owes me" is not "is late" — a bill that went out
+ * yesterday is owed and is not yet overdue, and answering with only the late
+ * ones would understate the number every time.
+ */
+export declare function moneyOwed(slug: string, formatMoney: (n: number) => string): Promise<ToolAnswer>;
+export declare function salesCompare(slug: string, formatMoney: (n: number) => string, windowDays?: number): Promise<ToolAnswer>;