@withpotter/lib 0.13.0-next.101

package/dist/commerce-build/setup-session.d.ts

@@ -0,0 +1,26 @@
+export interface CommerceSetupSessionState {
+    tenantSlug: string;
+    buildId?: string;
+    previewReady?: boolean;
+}
+export declare function resolveCommerceSetupBuildId(input: {
+    routeBuildId?: string;
+    tenantSlug: string;
+    currentBuildId?: string;
+    savedSession?: CommerceSetupSessionState | null;
+}): string | undefined;
+export declare function buildCommerceSetupHref(buildId?: string): string;
+export declare function resolvePostAuthDestination(input: {
+    explicitRedirect?: string;
+    setupState?: CommerceSetupSessionState | null;
+    featureEnabled?: boolean;
+}): string;
+export declare function readCommerceSetupSession(): CommerceSetupSessionState | null;
+export declare function writeCommerceSetupSession(state: CommerceSetupSessionState): void;
+export declare function clearCommerceSetupSession(): void;
+export declare function syncCommerceSetupSession(input: {
+    tenantSlug: string;
+    buildId?: string;
+    previewReady?: boolean;
+}): void;
+export declare function resolveStoredCommerceSetupDestination(explicitRedirect?: string): string;

package/dist/commerce-build/setup-session.js

@@ -0,0 +1,70 @@
+import { isCommerceBuildEnabled } from "@withpotter/lib/editor-agent/flag";
+const COMMERCE_SETUP_SESSION_KEY = "pb_commerce_setup";
+function resolveCommerceSetupBuildId(input) {
+  if (input.routeBuildId) return input.routeBuildId;
+  if (input.currentBuildId) return input.currentBuildId;
+  if (input.savedSession?.tenantSlug === input.tenantSlug && !input.savedSession.previewReady) {
+    return input.savedSession.buildId;
+  }
+  return void 0;
+}
+function buildCommerceSetupHref(buildId) {
+  return buildId ? `/setup?buildId=${encodeURIComponent(buildId)}` : "/setup";
+}
+function resolvePostAuthDestination(input) {
+  if (input.explicitRedirect) {
+    return input.explicitRedirect;
+  }
+  if (input.featureEnabled && input.setupState && !input.setupState.previewReady) {
+    return buildCommerceSetupHref(input.setupState.buildId);
+  }
+  return "/dashboard";
+}
+function canUseStorage() {
+  return typeof window !== "undefined" && typeof localStorage !== "undefined";
+}
+function readCommerceSetupSession() {
+  if (!canUseStorage()) return null;
+  const raw = localStorage.getItem(COMMERCE_SETUP_SESSION_KEY);
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    return parsed.tenantSlug ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeCommerceSetupSession(state) {
+  if (!canUseStorage()) return;
+  localStorage.setItem(COMMERCE_SETUP_SESSION_KEY, JSON.stringify(state));
+}
+function clearCommerceSetupSession() {
+  if (!canUseStorage()) return;
+  localStorage.removeItem(COMMERCE_SETUP_SESSION_KEY);
+}
+function syncCommerceSetupSession(input) {
+  const current = readCommerceSetupSession();
+  writeCommerceSetupSession({
+    tenantSlug: input.tenantSlug,
+    buildId: input.buildId ?? current?.buildId,
+    previewReady: input.previewReady ?? current?.previewReady ?? false
+  });
+}
+function resolveStoredCommerceSetupDestination(explicitRedirect) {
+  return resolvePostAuthDestination({
+    explicitRedirect,
+    setupState: readCommerceSetupSession(),
+    featureEnabled: isCommerceBuildEnabled()
+  });
+}
+export {
+  buildCommerceSetupHref,
+  clearCommerceSetupSession,
+  readCommerceSetupSession,
+  resolveCommerceSetupBuildId,
+  resolvePostAuthDestination,
+  resolveStoredCommerceSetupDestination,
+  syncCommerceSetupSession,
+  writeCommerceSetupSession
+};
+//# sourceMappingURL=setup-session.js.map

package/dist/commerce-build/setup-session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/setup-session.ts"],"sourcesContent":["import { isCommerceBuildEnabled } from '@withpotter/lib/editor-agent/flag';\n\nconst COMMERCE_SETUP_SESSION_KEY = 'pb_commerce_setup';\n\nexport interface CommerceSetupSessionState {\n  tenantSlug: string;\n  buildId?: string;\n  previewReady?: boolean;\n}\n\nexport function resolveCommerceSetupBuildId(input: {\n  routeBuildId?: string;\n  tenantSlug: string;\n  currentBuildId?: string;\n  savedSession?: CommerceSetupSessionState | null;\n}): string | undefined {\n  if (input.routeBuildId) return input.routeBuildId;\n  if (input.currentBuildId) return input.currentBuildId;\n  if (\n    input.savedSession?.tenantSlug === input.tenantSlug &&\n    !input.savedSession.previewReady\n  ) {\n    return input.savedSession.buildId;\n  }\n  return undefined;\n}\n\nexport function buildCommerceSetupHref(buildId?: string): string {\n  return buildId ? `/setup?buildId=${encodeURIComponent(buildId)}` : '/setup';\n}\n\nexport function resolvePostAuthDestination(input: {\n  explicitRedirect?: string;\n  setupState?: CommerceSetupSessionState | null;\n  featureEnabled?: boolean;\n}): string {\n  if (input.explicitRedirect) {\n    return input.explicitRedirect;\n  }\n\n  if (\n    input.featureEnabled &&\n    input.setupState &&\n    !input.setupState.previewReady\n  ) {\n    return buildCommerceSetupHref(input.setupState.buildId);\n  }\n\n  return '/dashboard';\n}\n\nfunction canUseStorage() {\n  return typeof window !== 'undefined' && typeof localStorage !== 'undefined';\n}\n\nexport function readCommerceSetupSession(): CommerceSetupSessionState | null {\n  if (!canUseStorage()) return null;\n\n  const raw = localStorage.getItem(COMMERCE_SETUP_SESSION_KEY);\n  if (!raw) return null;\n\n  try {\n    const parsed = JSON.parse(raw) as CommerceSetupSessionState;\n    return parsed.tenantSlug ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeCommerceSetupSession(state: CommerceSetupSessionState) {\n  if (!canUseStorage()) return;\n  localStorage.setItem(COMMERCE_SETUP_SESSION_KEY, JSON.stringify(state));\n}\n\nexport function clearCommerceSetupSession() {\n  if (!canUseStorage()) return;\n  localStorage.removeItem(COMMERCE_SETUP_SESSION_KEY);\n}\n\nexport function syncCommerceSetupSession(input: {\n  tenantSlug: string;\n  buildId?: string;\n  previewReady?: boolean;\n}) {\n  const current = readCommerceSetupSession();\n  writeCommerceSetupSession({\n    tenantSlug: input.tenantSlug,\n    buildId: input.buildId ?? current?.buildId,\n    previewReady: input.previewReady ?? current?.previewReady ?? false,\n  });\n}\n\nexport function resolveStoredCommerceSetupDestination(\n  explicitRedirect?: string,\n) {\n  return resolvePostAuthDestination({\n    explicitRedirect,\n    setupState: readCommerceSetupSession(),\n    featureEnabled: isCommerceBuildEnabled(),\n  });\n}\n"],"mappings":"AAAA,SAAS,8BAA8B;AAEvC,MAAM,6BAA6B;AAQ5B,SAAS,4BAA4B,OAKrB;AACrB,MAAI,MAAM,aAAc,QAAO,MAAM;AACrC,MAAI,MAAM,eAAgB,QAAO,MAAM;AACvC,MACE,MAAM,cAAc,eAAe,MAAM,cACzC,CAAC,MAAM,aAAa,cACpB;AACA,WAAO,MAAM,aAAa;AAAA,EAC5B;AACA,SAAO;AACT;AAEO,SAAS,uBAAuB,SAA0B;AAC/D,SAAO,UAAU,kBAAkB,mBAAmB,OAAO,CAAC,KAAK;AACrE;AAEO,SAAS,2BAA2B,OAIhC;AACT,MAAI,MAAM,kBAAkB;AAC1B,WAAO,MAAM;AAAA,EACf;AAEA,MACE,MAAM,kBACN,MAAM,cACN,CAAC,MAAM,WAAW,cAClB;AACA,WAAO,uBAAuB,MAAM,WAAW,OAAO;AAAA,EACxD;AAEA,SAAO;AACT;AAEA,SAAS,gBAAgB;AACvB,SAAO,OAAO,WAAW,eAAe,OAAO,iBAAiB;AAClE;AAEO,SAAS,2BAA6D;AAC3E,MAAI,CAAC,cAAc,EAAG,QAAO;AAE7B,QAAM,MAAM,aAAa,QAAQ,0BAA0B;AAC3D,MAAI,CAAC,IAAK,QAAO;AAEjB,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,WAAO,OAAO,aAAa,SAAS;AAAA,EACtC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,0BAA0B,OAAkC;AAC1E,MAAI,CAAC,cAAc,EAAG;AACtB,eAAa,QAAQ,4BAA4B,KAAK,UAAU,KAAK,CAAC;AACxE;AAEO,SAAS,4BAA4B;AAC1C,MAAI,CAAC,cAAc,EAAG;AACtB,eAAa,WAAW,0BAA0B;AACpD;AAEO,SAAS,yBAAyB,OAItC;AACD,QAAM,UAAU,yBAAyB;AACzC,4BAA0B;AAAA,IACxB,YAAY,MAAM;AAAA,IAClB,SAAS,MAAM,WAAW,SAAS;AAAA,IACnC,cAAc,MAAM,gBAAgB,SAAS,gBAAgB;AAAA,EAC/D,CAAC;AACH;AAEO,SAAS,sCACd,kBACA;AACA,SAAO,2BAA2B;AAAA,IAChC;AAAA,IACA,YAAY,yBAAyB;AAAA,IACrC,gBAAgB,uBAAuB;AAAA,EACzC,CAAC;AACH;","names":[]}

package/dist/commerce-build/turn-streaming.d.ts

@@ -0,0 +1,21 @@
+import type { BusinessProfileRevisionView, CommerceBuildTurnEvent, CommerceBuildTurnRequest, SourceEvidence } from './contracts';
+export interface CommerceBuildTurnResult {
+    sessionId?: string;
+    narration: string;
+    sources: SourceEvidence[];
+    profile?: BusinessProfileRevisionView;
+    clarification?: CommerceBuildTurnEvent['data'];
+}
+export declare class CommerceBuildRequestError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+export declare function parseCommerceBuildSseFrame(frame: string): CommerceBuildTurnEvent | null;
+export declare function streamCommerceBuildTurn({ tenantSlug, buildId, request, signal, onEvent, }: {
+    tenantSlug: string;
+    buildId: string;
+    request: CommerceBuildTurnRequest;
+    signal: AbortSignal;
+    onEvent?: (event: CommerceBuildTurnEvent) => void;
+}): Promise<CommerceBuildTurnResult>;

package/dist/commerce-build/turn-streaming.js

@@ -0,0 +1,113 @@
+import { getCsrfToken } from "@withpotter/lib/api";
+class CommerceBuildRequestError extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "CommerceBuildRequestError";
+  }
+  status;
+  code;
+}
+function parseCommerceBuildSseFrame(frame) {
+  let event = "";
+  const dataLines = [];
+  for (const rawLine of frame.replaceAll("\r\n", "\n").split("\n")) {
+    const line = rawLine.trimEnd();
+    if (line.startsWith("event:")) event = line.slice(6).trim();
+    if (line.startsWith("data:")) dataLines.push(line.slice(5).trimStart());
+  }
+  if (!event || dataLines.length === 0) return null;
+  return {
+    event,
+    data: JSON.parse(dataLines.join("\n"))
+  };
+}
+async function streamCommerceBuildTurn({
+  tenantSlug,
+  buildId,
+  request,
+  signal,
+  onEvent
+}) {
+  const csrfToken = getCsrfToken();
+  const response = await fetch(`/api/proxy/commerce-builds/${buildId}/turn`, {
+    method: "POST",
+    headers: {
+      accept: "text/event-stream",
+      "content-type": "application/json",
+      "x-tenant-slug": tenantSlug,
+      ...csrfToken ? { "x-csrf-token": csrfToken } : {}
+    },
+    body: JSON.stringify(request),
+    signal,
+    credentials: "include"
+  });
+  if (!response.ok || !response.body) {
+    const detail = await response.json().catch(() => null);
+    throw new CommerceBuildRequestError(
+      detail?.message ?? detail?.error ?? `Request failed (${response.status}).`,
+      response.status,
+      detail?.error
+    );
+  }
+  const result = { narration: "", sources: [] };
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  const consume = (frame) => {
+    const parsed = parseCommerceBuildSseFrame(frame);
+    if (!parsed) return;
+    onEvent?.(parsed);
+    switch (parsed.event) {
+      case "session":
+        result.sessionId = parsed.data.sessionId;
+        break;
+      case "narration":
+        result.narration += parsed.data.delta;
+        break;
+      case "source":
+        result.sources.push(parsed.data.evidence);
+        break;
+      case "clarify":
+        result.clarification = parsed.data;
+        break;
+      case "profile":
+        result.profile = {
+          revision: parsed.data.profileRevision,
+          profile: parsed.data.profile
+        };
+        break;
+      case "error":
+        throw new CommerceBuildRequestError(
+          parsed.data.message,
+          400,
+          parsed.data.code
+        );
+    }
+  };
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      buffer += decoder.decode(value, { stream: !done }).replaceAll("\r\n", "\n");
+      let boundary = buffer.indexOf("\n\n");
+      while (boundary !== -1) {
+        consume(buffer.slice(0, boundary));
+        buffer = buffer.slice(boundary + 2);
+        boundary = buffer.indexOf("\n\n");
+      }
+      if (done) break;
+    }
+    if (buffer.trim()) consume(buffer);
+  } catch (error) {
+    await reader.cancel().catch(() => void 0);
+    throw error;
+  }
+  return result;
+}
+export {
+  CommerceBuildRequestError,
+  parseCommerceBuildSseFrame,
+  streamCommerceBuildTurn
+};
+//# sourceMappingURL=turn-streaming.js.map

package/dist/commerce-build/turn-streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/turn-streaming.ts"],"sourcesContent":["import type {\n  BusinessProfileRevisionView,\n  CommerceBuildTurnEvent,\n  CommerceBuildTurnRequest,\n  SourceEvidence,\n} from './contracts';\nimport { getCsrfToken } from '@withpotter/lib/api';\n\nexport interface CommerceBuildTurnResult {\n  sessionId?: string;\n  narration: string;\n  sources: SourceEvidence[];\n  profile?: BusinessProfileRevisionView;\n  clarification?: CommerceBuildTurnEvent['data'];\n}\n\nexport class CommerceBuildRequestError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly code?: string,\n  ) {\n    super(message);\n    this.name = 'CommerceBuildRequestError';\n  }\n}\n\nexport function parseCommerceBuildSseFrame(\n  frame: string,\n): CommerceBuildTurnEvent | null {\n  let event = '';\n  const dataLines: string[] = [];\n  for (const rawLine of frame.replaceAll('\\r\\n', '\\n').split('\\n')) {\n    const line = rawLine.trimEnd();\n    if (line.startsWith('event:')) event = line.slice(6).trim();\n    if (line.startsWith('data:')) dataLines.push(line.slice(5).trimStart());\n  }\n  if (!event || dataLines.length === 0) return null;\n  return {\n    event,\n    data: JSON.parse(dataLines.join('\\n')),\n  } as CommerceBuildTurnEvent;\n}\n\nexport async function streamCommerceBuildTurn({\n  tenantSlug,\n  buildId,\n  request,\n  signal,\n  onEvent,\n}: {\n  tenantSlug: string;\n  buildId: string;\n  request: CommerceBuildTurnRequest;\n  signal: AbortSignal;\n  onEvent?: (event: CommerceBuildTurnEvent) => void;\n}): Promise<CommerceBuildTurnResult> {\n  const csrfToken = getCsrfToken();\n  const response = await fetch(`/api/proxy/commerce-builds/${buildId}/turn`, {\n    method: 'POST',\n    headers: {\n      accept: 'text/event-stream',\n      'content-type': 'application/json',\n      'x-tenant-slug': tenantSlug,\n      ...(csrfToken ? { 'x-csrf-token': csrfToken } : {}),\n    },\n    body: JSON.stringify(request),\n    signal,\n    credentials: 'include',\n  });\n  if (!response.ok || !response.body) {\n    const detail = (await response.json().catch(() => null)) as {\n      error?: string;\n      message?: string;\n    } | null;\n    throw new CommerceBuildRequestError(\n      detail?.message ??\n        detail?.error ??\n        `Request failed (${response.status}).`,\n      response.status,\n      detail?.error,\n    );\n  }\n\n  const result: CommerceBuildTurnResult = { narration: '', sources: [] };\n  const reader = response.body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n  const consume = (frame: string) => {\n    const parsed = parseCommerceBuildSseFrame(frame);\n    if (!parsed) return;\n    onEvent?.(parsed);\n    switch (parsed.event) {\n      case 'session':\n        result.sessionId = parsed.data.sessionId;\n        break;\n      case 'narration':\n        result.narration += parsed.data.delta;\n        break;\n      case 'source':\n        result.sources.push(parsed.data.evidence);\n        break;\n      case 'clarify':\n        result.clarification = parsed.data;\n        break;\n      case 'profile':\n        result.profile = {\n          revision: parsed.data.profileRevision,\n          profile: parsed.data.profile,\n        };\n        break;\n      case 'error':\n        throw new CommerceBuildRequestError(\n          parsed.data.message,\n          400,\n          parsed.data.code,\n        );\n    }\n  };\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      buffer += decoder\n        .decode(value, { stream: !done })\n        .replaceAll('\\r\\n', '\\n');\n      let boundary = buffer.indexOf('\\n\\n');\n      while (boundary !== -1) {\n        consume(buffer.slice(0, boundary));\n        buffer = buffer.slice(boundary + 2);\n        boundary = buffer.indexOf('\\n\\n');\n      }\n      if (done) break;\n    }\n    if (buffer.trim()) consume(buffer);\n  } catch (error) {\n    await reader.cancel().catch(() => undefined);\n    throw error;\n  }\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/commerce-build/workspace-components.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from 'react';
+import type { LucideIcon } from 'lucide-react';
+import type { ClarificationNeed } from './contracts';
+export declare function WorkspaceSection({ title, eyebrow, children, action, }: {
+    title: string;
+    eyebrow?: string;
+    action?: ReactNode;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function SourceCountCard({ icon: Icon, label, value, helper, }: {
+    icon: LucideIcon;
+    label: string;
+    value: number;
+    helper: string;
+}): import("react").JSX.Element;
+export declare function EvidenceChip({ id }: {
+    id: string;
+}): import("react").JSX.Element;
+export declare function ClarificationCard({ clarification, disabled, onOption, }: {
+    clarification: ClarificationNeed;
+    disabled: boolean;
+    onOption: (option: string) => void;
+}): import("react").JSX.Element;

package/dist/commerce-build/workspace-components.js

@@ -0,0 +1,66 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+function WorkspaceSection({
+  title,
+  eyebrow,
+  children,
+  action
+}) {
+  return /* @__PURE__ */ jsxs("section", { className: "rounded-[1px] border border-[var(--border-default)] bg-[var(--bg-base)]", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3 border-b border-[var(--border-subtle)] px-4 py-4", children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        eyebrow ? /* @__PURE__ */ jsx("p", { className: "text-[11px] font-semibold uppercase tracking-[0.18em] text-[var(--text-muted)]", children: eyebrow }) : null,
+        /* @__PURE__ */ jsx("h2", { className: "mt-1 text-base font-semibold text-[var(--text-primary)]", children: title })
+      ] }),
+      action
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "p-4", children })
+  ] });
+}
+function SourceCountCard({
+  icon: Icon,
+  label,
+  value,
+  helper
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-[1px] border border-[var(--border-subtle)] bg-[var(--bg-elevated)] p-4", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+      /* @__PURE__ */ jsx("div", { className: "flex h-10 w-10 items-center justify-center rounded-[1px] bg-[var(--accent-secondary)] text-[var(--accent-primary)]", children: /* @__PURE__ */ jsx(Icon, { className: "h-5 w-5" }) }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-[var(--text-primary)]", children: label }),
+        /* @__PURE__ */ jsx("p", { className: "text-xs text-[var(--text-tertiary)]", children: helper })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("p", { className: "mt-4 text-2xl font-semibold text-[var(--text-primary)]", children: value })
+  ] });
+}
+function EvidenceChip({ id }) {
+  return /* @__PURE__ */ jsx("span", { className: "rounded-full border border-[var(--border-subtle)] px-2 py-1 text-[11px] font-medium text-[var(--text-tertiary)]", children: id });
+}
+function ClarificationCard({
+  clarification,
+  disabled,
+  onOption
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-[1px] border border-[var(--border-subtle)] bg-[var(--bg-base)] p-3", children: [
+    /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-[var(--text-primary)]", children: clarification.question }),
+    /* @__PURE__ */ jsx("p", { className: "mt-1 text-xs leading-5 text-[var(--text-tertiary)]", children: clarification.reason }),
+    clarification.options?.length ? /* @__PURE__ */ jsx("div", { className: "mt-3 flex flex-wrap gap-2", children: clarification.options.map((option) => /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        disabled,
+        onClick: () => onOption(option),
+        className: "rounded-full border border-[var(--border-subtle)] px-3 py-2 text-xs font-medium text-[var(--text-secondary)] transition-colors hover:border-[var(--accent-primary)] hover:text-[var(--accent-primary)] disabled:cursor-not-allowed disabled:opacity-50",
+        children: option
+      },
+      option
+    )) }) : null
+  ] });
+}
+export {
+  ClarificationCard,
+  EvidenceChip,
+  SourceCountCard,
+  WorkspaceSection
+};
+//# sourceMappingURL=workspace-components.js.map

package/dist/commerce-build/workspace-components.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/workspace-components.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { LucideIcon } from 'lucide-react';\nimport type { ClarificationNeed } from './contracts';\n\nexport function WorkspaceSection({\n  title,\n  eyebrow,\n  children,\n  action,\n}: {\n  title: string;\n  eyebrow?: string;\n  action?: ReactNode;\n  children: ReactNode;\n}) {\n  return (\n    <section className=\"rounded-[1px] border border-[var(--border-default)] bg-[var(--bg-base)]\">\n      <div className=\"flex flex-wrap items-start justify-between gap-3 border-b border-[var(--border-subtle)] px-4 py-4\">\n        <div>\n          {eyebrow ? (\n            <p className=\"text-[11px] font-semibold uppercase tracking-[0.18em] text-[var(--text-muted)]\">\n              {eyebrow}\n            </p>\n          ) : null}\n          <h2 className=\"mt-1 text-base font-semibold text-[var(--text-primary)]\">\n            {title}\n          </h2>\n        </div>\n        {action}\n      </div>\n      <div className=\"p-4\">{children}</div>\n    </section>\n  );\n}\n\nexport function SourceCountCard({\n  icon: Icon,\n  label,\n  value,\n  helper,\n}: {\n  icon: LucideIcon;\n  label: string;\n  value: number;\n  helper: string;\n}) {\n  return (\n    <div className=\"rounded-[1px] border border-[var(--border-subtle)] bg-[var(--bg-elevated)] p-4\">\n      <div className=\"flex items-center gap-3\">\n        <div className=\"flex h-10 w-10 items-center justify-center rounded-[1px] bg-[var(--accent-secondary)] text-[var(--accent-primary)]\">\n          <Icon className=\"h-5 w-5\" />\n        </div>\n        <div>\n          <p className=\"text-sm font-medium text-[var(--text-primary)]\">\n            {label}\n          </p>\n          <p className=\"text-xs text-[var(--text-tertiary)]\">{helper}</p>\n        </div>\n      </div>\n      <p className=\"mt-4 text-2xl font-semibold text-[var(--text-primary)]\">\n        {value}\n      </p>\n    </div>\n  );\n}\n\nexport function EvidenceChip({ id }: { id: string }) {\n  return (\n    <span className=\"rounded-full border border-[var(--border-subtle)] px-2 py-1 text-[11px] font-medium text-[var(--text-tertiary)]\">\n      {id}\n    </span>\n  );\n}\n\nexport function ClarificationCard({\n  clarification,\n  disabled,\n  onOption,\n}: {\n  clarification: ClarificationNeed;\n  disabled: boolean;\n  onOption: (option: string) => void;\n}) {\n  return (\n    <div className=\"rounded-[1px] border border-[var(--border-subtle)] bg-[var(--bg-base)] p-3\">\n      <p className=\"text-sm font-medium text-[var(--text-primary)]\">\n        {clarification.question}\n      </p>\n      <p className=\"mt-1 text-xs leading-5 text-[var(--text-tertiary)]\">\n        {clarification.reason}\n      </p>\n      {clarification.options?.length ? (\n        <div className=\"mt-3 flex flex-wrap gap-2\">\n          {clarification.options.map((option) => (\n            <button\n              key={option}\n              type=\"button\"\n              disabled={disabled}\n              onClick={() => onOption(option)}\n              className=\"rounded-full border border-[var(--border-subtle)] px-3 py-2 text-xs font-medium text-[var(--text-secondary)] transition-colors hover:border-[var(--accent-primary)] hover:text-[var(--accent-primary)] disabled:cursor-not-allowed disabled:opacity-50\"\n            >\n              {option}\n            </button>\n          ))}\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"],"mappings":"AAkBQ,SAEI,KAFJ;AAdD,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACD,SACE,qBAAC,aAAQ,WAAU,2EACjB;AAAA,yBAAC,SAAI,WAAU,qGACb;AAAA,2BAAC,SACE;AAAA,kBACC,oBAAC,OAAE,WAAU,kFACV,mBACH,IACE;AAAA,QACJ,oBAAC,QAAG,WAAU,2DACX,iBACH;AAAA,SACF;AAAA,MACC;AAAA,OACH;AAAA,IACA,oBAAC,SAAI,WAAU,OAAO,UAAS;AAAA,KACjC;AAEJ;AAEO,SAAS,gBAAgB;AAAA,EAC9B,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACD,SACE,qBAAC,SAAI,WAAU,kFACb;AAAA,yBAAC,SAAI,WAAU,2BACb;AAAA,0BAAC,SAAI,WAAU,sHACb,8BAAC,QAAK,WAAU,WAAU,GAC5B;AAAA,MACA,qBAAC,SACC;AAAA,4BAAC,OAAE,WAAU,kDACV,iBACH;AAAA,QACA,oBAAC,OAAE,WAAU,uCAAuC,kBAAO;AAAA,SAC7D;AAAA,OACF;AAAA,IACA,oBAAC,OAAE,WAAU,0DACV,iBACH;AAAA,KACF;AAEJ;AAEO,SAAS,aAAa,EAAE,GAAG,GAAmB;AACnD,SACE,oBAAC,UAAK,WAAU,mHACb,cACH;AAEJ;AAEO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,SACE,qBAAC,SAAI,WAAU,8EACb;AAAA,wBAAC,OAAE,WAAU,kDACV,wBAAc,UACjB;AAAA,IACA,oBAAC,OAAE,WAAU,sDACV,wBAAc,QACjB;AAAA,IACC,cAAc,SAAS,SACtB,oBAAC,SAAI,WAAU,6BACZ,wBAAc,QAAQ,IAAI,CAAC,WAC1B;AAAA,MAAC;AAAA;AAAA,QAEC,MAAK;AAAA,QACL;AAAA,QACA,SAAS,MAAM,SAAS,MAAM;AAAA,QAC9B,WAAU;AAAA,QAET;AAAA;AAAA,MANI;AAAA,IAOP,CACD,GACH,IACE;AAAA,KACN;AAEJ;","names":[]}

package/dist/commerce-build/workspace-config.d.ts

@@ -0,0 +1,7 @@
+import type { CommerceBuildStatus } from './contracts';
+export declare const ACTIVE_POLL_STATUSES: CommerceBuildStatus[];
+export declare const STATUS_COPY: Record<CommerceBuildStatus, {
+    label: string;
+    tone: string;
+    description: string;
+}>;

package/dist/commerce-build/workspace-config.js

@@ -0,0 +1,74 @@
+const ACTIVE_POLL_STATUSES = [
+  "collecting",
+  "profile-ready",
+  "previewing",
+  "verifying",
+  "blocked"
+];
+const STATUS_COPY = {
+  collecting: {
+    label: "Collecting",
+    tone: "bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20",
+    description: "Gathering sources and grounding the first profile draft."
+  },
+  "profile-ready": {
+    label: "Review profile",
+    tone: "bg-[var(--warning-bg)] text-[var(--warning)] border-[var(--warning)]/20",
+    description: "Review the draft, inspect evidence, and accept when ready."
+  },
+  "profile-accepted": {
+    label: "Profile accepted",
+    tone: "bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20",
+    description: "The grounded business profile is locked for the next step."
+  },
+  compiled: {
+    label: "Compiled",
+    tone: "bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20",
+    description: "A commerce configuration has been compiled."
+  },
+  previewing: {
+    label: "Previewing",
+    tone: "bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20",
+    description: "Provisioning a preview from the accepted configuration."
+  },
+  "preview-ready": {
+    label: "Preview ready",
+    tone: "bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20",
+    description: "A draft preview is available for verification."
+  },
+  verifying: {
+    label: "Verifying",
+    tone: "bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20",
+    description: "Checking commerce journeys against the preview."
+  },
+  ready: {
+    label: "Ready",
+    tone: "bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20",
+    description: "All required checks passed for the build."
+  },
+  blocked: {
+    label: "Needs clarification",
+    tone: "bg-[var(--error-bg)] text-[var(--error)] border-[var(--error)]/20",
+    description: "A launch-blocking answer is needed before the build can continue."
+  },
+  "launch-proposed": {
+    label: "Launch proposed",
+    tone: "bg-[var(--warning-bg)] text-[var(--warning)] border-[var(--warning)]/20",
+    description: "Launch changes have been staged for approval."
+  },
+  launched: {
+    label: "Launched",
+    tone: "bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20",
+    description: "The verified build has been published."
+  },
+  expired: {
+    label: "Expired",
+    tone: "bg-[var(--bg-muted)] text-[var(--text-secondary)] border-transparent",
+    description: "This workspace expired and needs a fresh start."
+  }
+};
+export {
+  ACTIVE_POLL_STATUSES,
+  STATUS_COPY
+};
+//# sourceMappingURL=workspace-config.js.map

package/dist/commerce-build/workspace-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/workspace-config.ts"],"sourcesContent":["import type { CommerceBuildStatus } from './contracts';\n\nexport const ACTIVE_POLL_STATUSES: CommerceBuildStatus[] = [\n  'collecting',\n  'profile-ready',\n  'previewing',\n  'verifying',\n  'blocked',\n];\n\nexport const STATUS_COPY: Record<\n  CommerceBuildStatus,\n  { label: string; tone: string; description: string }\n> = {\n  collecting: {\n    label: 'Collecting',\n    tone: 'bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20',\n    description: 'Gathering sources and grounding the first profile draft.',\n  },\n  'profile-ready': {\n    label: 'Review profile',\n    tone: 'bg-[var(--warning-bg)] text-[var(--warning)] border-[var(--warning)]/20',\n    description: 'Review the draft, inspect evidence, and accept when ready.',\n  },\n  'profile-accepted': {\n    label: 'Profile accepted',\n    tone: 'bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20',\n    description: 'The grounded business profile is locked for the next step.',\n  },\n  compiled: {\n    label: 'Compiled',\n    tone: 'bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20',\n    description: 'A commerce configuration has been compiled.',\n  },\n  previewing: {\n    label: 'Previewing',\n    tone: 'bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20',\n    description: 'Provisioning a preview from the accepted configuration.',\n  },\n  'preview-ready': {\n    label: 'Preview ready',\n    tone: 'bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20',\n    description: 'A draft preview is available for verification.',\n  },\n  verifying: {\n    label: 'Verifying',\n    tone: 'bg-[var(--info-bg)] text-[var(--info)] border-[var(--accent-primary)]/20',\n    description: 'Checking commerce journeys against the preview.',\n  },\n  ready: {\n    label: 'Ready',\n    tone: 'bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20',\n    description: 'All required checks passed for the build.',\n  },\n  blocked: {\n    label: 'Needs clarification',\n    tone: 'bg-[var(--error-bg)] text-[var(--error)] border-[var(--error)]/20',\n    description:\n      'A launch-blocking answer is needed before the build can continue.',\n  },\n  'launch-proposed': {\n    label: 'Launch proposed',\n    tone: 'bg-[var(--warning-bg)] text-[var(--warning)] border-[var(--warning)]/20',\n    description: 'Launch changes have been staged for approval.',\n  },\n  launched: {\n    label: 'Launched',\n    tone: 'bg-[var(--success-bg)] text-[var(--success)] border-[var(--success)]/20',\n    description: 'The verified build has been published.',\n  },\n  expired: {\n    label: 'Expired',\n    tone: 'bg-[var(--bg-muted)] text-[var(--text-secondary)] border-transparent',\n    description: 'This workspace expired and needs a fresh start.',\n  },\n};\n"],"mappings":"AAEO,MAAM,uBAA8C;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,cAGT;AAAA,EACF,YAAY;AAAA,IACV,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,iBAAiB;AAAA,IACf,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,oBAAoB;AAAA,IAClB,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,UAAU;AAAA,IACR,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,YAAY;AAAA,IACV,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,iBAAiB;AAAA,IACf,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,OAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,SAAS;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,mBAAmB;AAAA,IACjB,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,UAAU;AAAA,IACR,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,SAAS;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;","names":[]}

package/dist/companion/config.d.ts

@@ -0,0 +1,31 @@
+import type { ProposalStatus } from '@withpotter/lib/proposals-api';
+export declare const COMPANION: {
+    /** Default persona name — merchants can override this per store. */
+    readonly name: "Sage";
+    /** Sidebar label + product-surface title (positioning, not the name). */
+    readonly label: "Business Companion";
+    /** One-line positioning shown under the title. */
+    readonly description: "Your business store manager";
+    /** Route the companion surfaces live on. */
+    readonly href: "/dashboard/companion";
+};
+/** Tenant-settings key that stores the merchant's custom companion name. */
+export declare const COMPANION_NAME_SETTING = "companionName";
+/** Guardrail for a merchant-chosen name. */
+export declare const MAX_COMPANION_NAME_LENGTH = 24;
+/**
+ * Resolve the persona name for a tenant: the merchant's custom name if set,
+ * otherwise the default ("Sage").
+ */
+export declare function resolveCompanionName(settings: Record<string, unknown> | null | undefined): string;
+/** Statuses that are waiting on the merchant to decide. */
+export declare const AWAITING_STATUSES: readonly ProposalStatus[];
+type StatusTone = 'success' | 'warning' | 'error' | 'info' | 'secondary';
+/** Badge tone per status — independent of the persona name. */
+export declare const STATUS_TONE: Record<ProposalStatus, StatusTone>;
+/**
+ * Human-facing status label in the companion's voice. Some labels use the
+ * persona name, so pass the resolved name for consistency.
+ */
+export declare function statusLabel(status: ProposalStatus, name?: string): string;
+export {};

package/dist/companion/config.js

@@ -0,0 +1,59 @@
+const COMPANION = {
+  /** Default persona name — merchants can override this per store. */
+  name: "Sage",
+  /** Sidebar label + product-surface title (positioning, not the name). */
+  label: "Business Companion",
+  /** One-line positioning shown under the title. */
+  description: "Your business store manager",
+  /** Route the companion surfaces live on. */
+  href: "/dashboard/companion"
+};
+const COMPANION_NAME_SETTING = "companionName";
+const MAX_COMPANION_NAME_LENGTH = 24;
+function resolveCompanionName(settings) {
+  const custom = settings?.[COMPANION_NAME_SETTING];
+  if (typeof custom === "string" && custom.trim()) {
+    return custom.trim().slice(0, MAX_COMPANION_NAME_LENGTH);
+  }
+  return COMPANION.name;
+}
+const AWAITING_STATUSES = ["proposed"];
+const STATUS_TONE = {
+  draft: "secondary",
+  proposed: "info",
+  approved: "info",
+  applied: "success",
+  reverted: "secondary",
+  rejected: "error",
+  expired: "secondary"
+};
+function statusLabel(status, name = COMPANION.name) {
+  switch (status) {
+    case "draft":
+      return `${name} is drafting\u2026`;
+    case "proposed":
+      return "Waiting for you";
+    case "approved":
+      return "Staged in draft";
+    case "applied":
+      return "Done \xB7 Live";
+    case "reverted":
+      return "Reverted";
+    case "rejected":
+      return "Dismissed";
+    case "expired":
+      return "Expired";
+    default:
+      return status;
+  }
+}
+export {
+  AWAITING_STATUSES,
+  COMPANION,
+  COMPANION_NAME_SETTING,
+  MAX_COMPANION_NAME_LENGTH,
+  STATUS_TONE,
+  resolveCompanionName,
+  statusLabel
+};
+//# sourceMappingURL=config.js.map

package/dist/companion/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/companion/config.ts"],"sourcesContent":["// Sage — the store-manager companion.\n//\n// Single source of truth for the companion's identity and human-facing\n// vocabulary. The governed spine underneath still speaks in \"proposals\";\n// nothing the merchant sees should. The persona's *name* is a per-tenant\n// setting (merchants can rename their companion) — everything else lives here.\n\nimport type { ProposalStatus } from '@withpotter/lib/proposals-api';\n\nexport const COMPANION = {\n  /** Default persona name — merchants can override this per store. */\n  name: 'Sage',\n  /** Sidebar label + product-surface title (positioning, not the name). */\n  label: 'Business Companion',\n  /** One-line positioning shown under the title. */\n  description: 'Your business store manager',\n  /** Route the companion surfaces live on. */\n  href: '/dashboard/companion',\n} as const;\n\n/** Tenant-settings key that stores the merchant's custom companion name. */\nexport const COMPANION_NAME_SETTING = 'companionName';\n\n/** Guardrail for a merchant-chosen name. */\nexport const MAX_COMPANION_NAME_LENGTH = 24;\n\n/**\n * Resolve the persona name for a tenant: the merchant's custom name if set,\n * otherwise the default (\"Sage\").\n */\nexport function resolveCompanionName(\n  settings: Record<string, unknown> | null | undefined,\n): string {\n  const custom = settings?.[COMPANION_NAME_SETTING];\n  if (typeof custom === 'string' && custom.trim()) {\n    return custom.trim().slice(0, MAX_COMPANION_NAME_LENGTH);\n  }\n  return COMPANION.name;\n}\n\n/** Statuses that are waiting on the merchant to decide. */\nexport const AWAITING_STATUSES: readonly ProposalStatus[] = ['proposed'];\n\ntype StatusTone = 'success' | 'warning' | 'error' | 'info' | 'secondary';\n\n/** Badge tone per status — independent of the persona name. */\nexport const STATUS_TONE: Record<ProposalStatus, StatusTone> = {\n  draft: 'secondary',\n  proposed: 'info',\n  approved: 'info',\n  applied: 'success',\n  reverted: 'secondary',\n  rejected: 'error',\n  expired: 'secondary',\n};\n\n/**\n * Human-facing status label in the companion's voice. Some labels use the\n * persona name, so pass the resolved name for consistency.\n */\nexport function statusLabel(\n  status: ProposalStatus,\n  name: string = COMPANION.name,\n): string {\n  switch (status) {\n    case 'draft':\n      return `${name} is drafting…`;\n    case 'proposed':\n      return 'Waiting for you';\n    case 'approved':\n      return 'Staged in draft';\n    case 'applied':\n      return 'Done · Live';\n    case 'reverted':\n      return 'Reverted';\n    case 'rejected':\n      return 'Dismissed';\n    case 'expired':\n      return 'Expired';\n    default:\n      return status;\n  }\n}\n"],"mappings":"AASO,MAAM,YAAY;AAAA;AAAA,EAEvB,MAAM;AAAA;AAAA,EAEN,OAAO;AAAA;AAAA,EAEP,aAAa;AAAA;AAAA,EAEb,MAAM;AACR;AAGO,MAAM,yBAAyB;AAG/B,MAAM,4BAA4B;AAMlC,SAAS,qBACd,UACQ;AACR,QAAM,SAAS,WAAW,sBAAsB;AAChD,MAAI,OAAO,WAAW,YAAY,OAAO,KAAK,GAAG;AAC/C,WAAO,OAAO,KAAK,EAAE,MAAM,GAAG,yBAAyB;AAAA,EACzD;AACA,SAAO,UAAU;AACnB;AAGO,MAAM,oBAA+C,CAAC,UAAU;AAKhE,MAAM,cAAkD;AAAA,EAC7D,OAAO;AAAA,EACP,UAAU;AAAA,EACV,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,SAAS;AACX;AAMO,SAAS,YACd,QACA,OAAe,UAAU,MACjB;AACR,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,GAAG,IAAI;AAAA,IAChB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/connect/catalog.d.ts

@@ -0,0 +1,32 @@
+import type { ConnectProduct } from './types';
+/**
+ * What Box Connect actually offers, at the rung each thing has reached.
+ *
+ * ELEVEN ENTRIES, NOT SEVENTY. The rule the Connections page in Settings
+ * settled on holds here and holds harder: a catalogue of logos a merchant
+ * cannot use is a wall of adverts, and this one would be worse because Connect
+ * is a paid managed service. Every provider Box could one day support is
+ * NOT in this list. The eleven below are the ones with code, a named owner and
+ * a place in the rollout; everything else is a request, which is a real record
+ * with a person on the end of it rather than a card that says "coming soon".
+ *
+ * The availability values are read off the repository, not off ambition
+ * (connect/docs, current position 2026-08-24): email and WhatsApp have
+ * fixture-backed adapters, the integration spine is implemented against tests,
+ * and the first three connectors are specified and not yet built. Nothing is
+ * generally available, no production route is enabled, and this file must say
+ * so. When a rung moves, it moves here in the same change as the evidence.
+ *
+ * The three social sources added 2026-08-31 sit at `fixture_certified` on the
+ * same rule: potter-api holds three adapters, an injected transport, and a
+ * conformance suite that drives the whole request-to-parse cycle against
+ * recorded responses. They have met no provider's sandbox. This count is stated rather than left to
+ * be counted, so adding an entry means saying so — the word "seven" survived
+ * unchanged here while entries were added, which is how a comment starts
+ * describing a file that no longer exists.
+ */
+export declare const CONNECT_PRODUCTS: readonly ConnectProduct[];
+/** The families a merchant can ask for by name when nothing above fits. */
+export declare const REQUESTABLE_FAMILIES: readonly string[];
+export declare function productById(id: string): ConnectProduct | undefined;
+export declare function byReadiness(a: ConnectProduct, b: ConnectProduct): number;