@fayz-ai/admin 0.16.0 → 0.17.0

package/dist/lib/ai-tool-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tool-handlers.d.ts","sourceRoot":"","sources":["../../src/lib/ai-tool-handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-tool-handlers.d.ts","sourceRoot":"","sources":["../../src/lib/ai-tool-handlers.ts"],"names":[],"mappings":"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"}

package/dist/onboarding/ActivationAgentSurface.d.ts

@@ -0,0 +1,6 @@
+import { type ResolvedOnboardingProgram } from '@fayz-ai/core';
+export interface ActivationAgentSurfaceProps {
+    programs: ResolvedOnboardingProgram[];
+}
+export declare function ActivationAgentSurface({ programs }: ActivationAgentSurfaceProps): null;
+//# sourceMappingURL=ActivationAgentSurface.d.ts.map

package/dist/onboarding/ActivationAgentSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivationAgentSurface.d.ts","sourceRoot":"","sources":["../../src/onboarding/ActivationAgentSurface.tsx"],"names":[],"mappings":"AACA,OAAO,EAAM,KAAK,yBAAyB,EAAgB,MAAM,eAAe,CAAA;AA4IhF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,yBAAyB,EAAE,CAAA;CACtC;AAaD,wBAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAAE,EAAE,2BAA2B,QAuI/E"}

package/dist/onboarding/ActivationChecklistCard.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+export interface ActivationChecklistCardProps {
+    title?: string;
+    subtitle?: string;
+    className?: string;
+}
+/**
+ * The activation checklist as a dashboard card.
+ *
+ * Exists because apps were writing their own. marketplace-saas had five steps
+ * in `config/first-steps.ts` rendered in two places, next to the shell's own
+ * checklist in the rail — two lists both titled "Primeiros passos", both about
+ * the same store, disagreeing about what was left to do. There is no way for a
+ * reader to know which one counts, and there was never a version of this where
+ * both stayed in step.
+ *
+ * So the same rows the rail shows, the Tasks panel lists and the assistant
+ * ticks are also what the dashboard draws. An app that had its own list moves
+ * those steps into the owning plugin's program (see `OnboardingProgramDef`) and
+ * renders this instead.
+ */
+export declare function ActivationChecklistCard({ title, subtitle, className }: ActivationChecklistCardProps): React.JSX.Element | null;
+//# sourceMappingURL=ActivationChecklistCard.d.ts.map

package/dist/onboarding/ActivationChecklistCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivationChecklistCard.d.ts","sourceRoot":"","sources":["../../src/onboarding/ActivationChecklistCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,4BAA4B,4BAoCnG"}

package/dist/onboarding/ActivationProvider.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+/**
+ * Everything the activation journey needs mounted once, inside the shell.
+ *
+ * Three jobs, and they belong together because they all key off the same pair
+ * (tenant, active plugins):
+ *
+ *  1. Build the catalog — base steps plus every active module's program.
+ *  2. Reconcile it with what is in the database. The wizard seeds at signup,
+ *     but a module enabled in month two never went through the wizard, so the
+ *     rows are topped up here. The upsert is idempotent, so this is a no-op on
+ *     every boot after the first.
+ *  3. Put the agent and the spotlight in the room: the surface publishes the
+ *     checklist to the assistant, and the overlay is what "show me" looks like.
+ */
+export declare function ActivationProvider(): React.JSX.Element;
+//# sourceMappingURL=ActivationProvider.d.ts.map

package/dist/onboarding/ActivationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivationProvider.d.ts","sourceRoot":"","sources":["../../src/onboarding/ActivationProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,sBA0HjC"}

package/dist/onboarding/GettingStartedWidget.d.ts

@@ -2,12 +2,12 @@ import * as React from 'react';
 /**
  * The getting-started checklist in the rail's foot.
  *
- * `SidebarOnboarding` lives in @fayz-ai/ui, which cannot reach a store or a
- * database, so the loading half is here — the same split as `SeuSiteWidget`:
- * self-loading, tenant-keyed, self-hiding.
+ * Reads the shared activation store rather than loading its own rows: the
+ * assistant ticks steps as it closes them, and two independent loads meant the
+ * rail kept showing yesterday's count while the agent said otherwise.
  *
- * Same rows the assistant's Tasks tab shows. Ticking a step there and reloading
- * moves the count here, because there is only one place either of them reads.
+ * A step that carries a tour starts it instead of just navigating — the same
+ * "show me" the agent gives, available without asking for it.
  */
 export declare function GettingStartedWidget(): React.JSX.Element | null;
 //# sourceMappingURL=GettingStartedWidget.d.ts.map

package/dist/onboarding/activation.store.d.ts

@@ -0,0 +1,53 @@
+import type { OnboardingStepInput } from '@fayz-ai/ui';
+import type { Task } from '../tasks/types';
+import type { ActivationStep } from './programs';
+/**
+ * The activation checklist, once, for everybody who touches it.
+ *
+ * It used to load inside the sidebar widget, which was fine while the sidebar
+ * was the only reader. It is not: the assistant now ticks steps as it finishes
+ * them, and a checklist that only refetches on mount would keep showing "2 de 6"
+ * for the rest of the session while the agent insisted it had done three. One
+ * store, one set of rows, and the tick lands everywhere at once.
+ *
+ * Writes are optimistic and one-way — a step goes closed and stays closed. The
+ * database call is fire-and-forget for the same reason the seeding is: a lost
+ * checklist write is not worth an error dialog on top of somebody's first hour.
+ */
+export interface ActivationState {
+    tenantId?: string;
+    /**
+     * The assistant is walking somebody through the checklist right now.
+     *
+     * Session state, not a stored fact: it starts when a workspace is created (or
+     * when somebody asks for help from the checklist) and ends when the list is
+     * done or they close it. It is what turns a completed step from a silent tick
+     * into "boa — agora vamos para o próximo": outside guided mode the same tick
+     * must NOT ping the assistant, or every product a store creates six months
+     * from now interrupts whatever conversation is open.
+     */
+    guided: boolean;
+    /** null = never loaded for this tenant (render nothing, not "0 de 0"). */
+    rows: Task[] | null;
+    catalog: ActivationStep[];
+    loading: boolean;
+    setCatalog: (catalog: ActivationStep[]) => void;
+    setGuided: (guided: boolean) => void;
+    load: (tenantId: string) => Promise<void>;
+    /**
+     * Tick a step. Safe to call for a key that is already closed or unknown.
+     *
+     * `by` says who noticed: 'sensor' is the data itself saying the work landed,
+     * which is what the guided run congratulates on. A tick nobody watched
+     * (a re-seed, a manual close) passes through quietly.
+     */
+    complete: (key: string, by?: 'user' | 'agent' | 'sensor') => Promise<void>;
+    /** Set by the provider — how a finished step reaches the assistant. */
+    onStepCompleted?: (step: ActivationStep, by: 'user' | 'agent' | 'sensor') => void;
+}
+export declare const useActivationStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ActivationState>>;
+/** Steps as the checklist UI wants them, sensors and all. */
+export declare function selectSteps(state: ActivationState): OnboardingStepInput[];
+/** `source_key`s of every step still open — what the agent is here to close. */
+export declare function openStepKeys(state: ActivationState): Set<string>;
+//# sourceMappingURL=activation.store.d.ts.map

package/dist/onboarding/activation.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.store.d.ts","sourceRoot":"","sources":["../../src/onboarding/activation.store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;OASG;IACH,MAAM,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAA;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IACpC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,uEAAuE;IACvE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAA;CAClF;AAED,eAAO,MAAM,kBAAkB,8EAkC5B,CAAA;AAEH,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,EAAE,CAKzE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,CAKhE"}

package/dist/onboarding/backend.d.ts

@@ -41,4 +41,18 @@ export interface RecordResponseInput {
  * to tell someone their business was not created.
  */
 export declare function recordOnboardingResponse(input: RecordResponseInput): Promise<boolean>;
+/**
+ * The wizard's answers, as they were stored.
+ *
+ * The handbook's first page renders these as prose, which is what a person
+ * wants. The assistant sometimes wants the other thing: the raw values, with
+ * the option ids intact — "retail.segments: ['cosmetics','pet']" is a list it
+ * can reason over, where "Cosméticos, Pet" is a sentence it has to parse back.
+ * Both come from one write; this is the second reader.
+ */
+export declare function readSetupAnswers(tenantId: string): Promise<{
+    verticalId: string | null;
+    source: string | null;
+    answers: Record<string, unknown>;
+} | null>;
 //# sourceMappingURL=backend.d.ts.map

package/dist/onboarding/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/onboarding/backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM/C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAgBlF;AAKD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwB3F;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMvE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB3F"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/onboarding/backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM/C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAgBlF;AAKD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwB3F;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMvE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBxG"}

package/dist/onboarding/checklist.d.ts

@@ -1,3 +1,4 @@
+import { type OnboardingMove, type TourDef } from '@fayz-ai/core';
 import type { OnboardingStepInput } from '@fayz-ai/ui';
 import type { Task, TaskPriority } from '../tasks/types';
 /**
@@ -19,8 +20,30 @@ export interface OnboardingTaskSeed {
     icon?: string;
     /** Where the step's action goes. Never stored. */
     route?: string;
+    /** A guided pass over the screen for this step. Never stored. */
+    tour?: TourDef;
+    /** The walkthrough as data — see {@link OnboardingMove}. Never stored. */
+    script?: OnboardingMove[];
+    /** One line when the step closes. Never stored. */
+    celebrate?: string;
     priority?: TaskPriority;
+    /**
+     * Deadline, in days from the seeding.
+     *
+     * NOT set by the base list, and that is the decision rather than an
+     * oversight: a checklist is an invitation, and a due date stamped on somebody
+     * the day they signed up turns "cadastre um produto" into an overdue task by
+     * Thursday — the app nagging about work it invented. Priority already says
+     * what matters first. A program is free to set one where a real date exists
+     * (a fiscal deadline, a migration window).
+     */
     dueInDays?: number;
+    /**
+     * How it is done in this system, in a person's words. Seeded onto the task
+     * row (so the Tasks panel carries the instructions) and read by the agent
+     * before it walks anybody through the step. See `OnboardingStepDef.howTo`.
+     */
+    howTo?: string;
     /**
      * Optional sensor: "is this already true of the data?". Must be cheap — it
      * runs once per open step per shell mount. Absent means the only way to

package/dist/onboarding/checklist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checklist.d.ts","sourceRoot":"","sources":["../../src/onboarding/checklist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/B;AAmED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAI7E;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,OAAa,GAAG,MAAM,GAAG,IAAI,CAKrF;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,IAAI,EAAE,IAAI,EAAE,EACZ,GAAG,GAAE,YAAiB,GACrB,mBAAmB,EAAE,CA4BvB"}
+{"version":3,"file":"checklist.d.ts","sourceRoot":"","sources":["../../src/onboarding/checklist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGtD,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/B;AAwGD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAI7E;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,OAAa,GAAG,MAAM,GAAG,IAAI,CAKrF;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,IAAI,EAAE,IAAI,EAAE,EACZ,GAAG,GAAE,YAAiB,GACrB,mBAAmB,EAAE,CA4BvB"}

package/dist/onboarding/guided-runner.d.ts

@@ -0,0 +1,87 @@
+import type { OnboardingMove, TourDef } from '@fayz-ai/core';
+import { type ChatCard } from '../stores/chat.store';
+import type { ActivationStep } from './programs';
+/**
+ * Plays a step's script — the walkthrough with no model in the loop.
+ *
+ * The expensive version of this was: one turn to say "abra Produtos", another
+ * to say "clique em Adicionar", another to say "agora digite o nome". Three
+ * round trips for choreography that never varies, and a different wording every
+ * time. The script is data, so the runtime performs it: navigate, spotlight,
+ * speak, wait. The model is handed the turn only where the script says `ask` —
+ * or the moment the person types something of their own, which was always the
+ * part worth paying for.
+ *
+ * Split in two on purpose. `planScript` is pure: moves in, a plan out, and it
+ * is where the interesting decisions live (consecutive points become ONE tour,
+ * a handover ends the run). `playScript` is the side effects, in order.
+ */
+export interface ScriptedTour {
+    kind: 'tour';
+    tour: TourDef;
+}
+export type ScriptAct = {
+    kind: 'goto';
+    route: string;
+} | {
+    kind: 'say';
+    text: string;
+} | ScriptedTour | {
+    kind: 'await';
+    text?: string;
+} | {
+    kind: 'ask';
+    text: string;
+} | {
+    kind: 'choose';
+    id: string;
+    question: string;
+    options: Array<{
+        id: string;
+        label: string;
+        meta?: string;
+    }>;
+};
+export interface ScriptPlan {
+    acts: ScriptAct[];
+    /**
+     * The run stops here and waits for the sensor. True when the script ends in
+     * `await`, or in a tour whose last stop is a handover — both mean "the person
+     * is doing it now", and anything printed after that talks over them.
+     */
+    waits: boolean;
+}
+/**
+ * Moves → acts. Consecutive `point`s collapse into one tour because they are
+ * one gesture: three separate overlays for three controls on the same screen is
+ * three dismissals for one explanation.
+ */
+export declare function planScript(moves: OnboardingMove[], tourId: string): ScriptPlan;
+/** Claim the floor for `key`, superseding whatever was playing. */
+export declare function beginRun(key: string): number;
+/** Still the current run? False means somebody else took the floor. */
+export declare function isRunAlive(token: number): boolean;
+/**
+ * The step being walked through right now — including one that has already
+ * spoken and is waiting on the person. Kept after the script ends on purpose:
+ * "which step are we on" outlives the playing of it.
+ */
+export declare function currentRunKey(): string | null;
+/** Nothing is being walked through. */
+export declare function clearRun(): void;
+/** A line from the assistant, straight into the thread. No turn, no bill. */
+export declare function say(text: string, cards?: ChatCard[]): void;
+export interface PlayOptions {
+    /** Overridden in tests; the real one is `setTimeout`. */
+    wait?: (ms: number) => Promise<void>;
+    /** From {@link beginRun}. The play stops the moment it is not current. */
+    token?: number;
+}
+/**
+ * Perform the plan. Returns when the script is done or when it hands over to
+ * somebody else — the person (a handover/await) or the model (`ask`).
+ */
+export declare function playScript(plan: ScriptPlan, options?: PlayOptions): Promise<void>;
+/** Play a step's script when it has one. `false` means "no script — improvise". */
+export declare function runStepScript(step: ActivationStep, options?: PlayOptions): Promise<boolean>;
+//# sourceMappingURL=guided-runner.d.ts.map

package/dist/onboarding/guided-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided-runner.d.ts","sourceRoot":"","sources":["../../src/onboarding/guided-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAe,MAAM,eAAe,CAAA;AAGzE,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B,YAAY,GACZ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7D,CAAA;AAEL,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAiD9E;AAoBD,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,6EAA6E;AAC7E,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAY1D;AAuBD,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC3F;AAED,mFAAmF;AACnF,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAKjG"}

package/dist/onboarding/guided.d.ts

@@ -0,0 +1,27 @@
+import type { ActivationStep } from './programs';
+/**
+ * Start the guided run — the assistant walking somebody through the checklist.
+ *
+ * It starts by itself once, right after a workspace is created. This is the
+ * OTHER way in, and it has to exist: the automatic one fires a single time per
+ * tenant, so anybody who closed the panel that day, or who inherited a
+ * workspace somebody else set up, had no way back to it. A mode with no button
+ * is a mode most people never see.
+ *
+ * Three things happen together, and the order matters: the mode goes on (so a
+ * finished step reports back instead of ticking silently), the screen moves to
+ * the step, and only then the assistant is asked to take over — arriving at a
+ * page that is already open reads as company, arriving before it reads as a
+ * chatbot describing a menu.
+ */
+export declare function startGuidedRun(stepKey?: string): void;
+/**
+ * One step of the run: play its script, or hand the model the job when it has
+ * none. Everything that advances the run — the button, the auto-start, a step
+ * closing — goes through here, so a scripted step and an improvised one behave
+ * the same from the outside.
+ */
+export declare function runStep(step: ActivationStep | undefined): Promise<void>;
+/** Said when a step closes, before the next one starts. Local; no model call. */
+export declare function celebrate(step: ActivationStep, remaining: number): void;
+//# sourceMappingURL=guided.d.ts.map

package/dist/onboarding/guided.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided.d.ts","sourceRoot":"","sources":["../../src/onboarding/guided.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7E;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOvE"}

package/dist/onboarding/handbook-seed.d.ts

@@ -0,0 +1,70 @@
+import type { WizardStepDef, WizardValues } from '@fayz-ai/ui';
+import type { WriteHandbookInput } from '../handbook/types';
+/**
+ * The wizard's answers, as the handbook's first page.
+ *
+ * The flow already asks the eight questions a new business is most often asked
+ * again later — what it sells, where it sells, how it gets paid, how it
+ * delivers. Those answers went into `plg_onboarding_responses`, which is an
+ * analytics table nobody reads back, and then the assistant asked them a second
+ * time in the first conversation.
+ *
+ * So the setup writes page one before anybody types anything, and the manual is
+ * never empty. It is also the shape every later page copies: a heading per
+ * question, in the words the wizard used.
+ *
+ * Rendered from the STEP DEFINITIONS rather than a hand-kept map of field ids:
+ * the labels and option names already exist there, so rewording a question or
+ * adding one to a pack updates this page for free. A per-vertical mapping here
+ * would be a second copy of the questionnaire, and it would go stale.
+ */
+export declare const SETUP_PAGE_PATH = "negocio/visao-geral";
+/**
+ * The starter manual: page one, plus a few short drafts to write over.
+ *
+ * WHY DRAFTS AND NOT AN EMPTY MANUAL. "Nada anotado ainda" with a + button is a
+ * blank page, and a blank page is where documentation goes to not happen. Three
+ * half-written pages with the headings already there turn writing into
+ * finishing, which people do.
+ *
+ * WHY THEY ARE THIN. Every line we invent is a line somebody has to read and
+ * decide about. A page that arrives already written gets skimmed and believed;
+ * one that arrives with **blanks in it** gets filled in. So the seed brings the
+ * QUESTIONS this business will be asked later, the answers it already gave the
+ * wizard, and nothing else.
+ */
+export interface SopSection {
+    heading: string;
+    /** Answers from the wizard that belong under this heading, when they exist. */
+    from?: string[];
+    /** What is still missing, in the owner's words. Rendered as **blanks**. */
+    blanks: string[];
+}
+export interface SopSeed {
+    path: string;
+    title: string;
+    summary: string;
+    sections: SopSection[];
+}
+export interface SetupHandbookInput {
+    steps: ReadonlyArray<WizardStepDef>;
+    values: WizardValues;
+    businessName: string;
+}
+/**
+ * `null` when the answers carry nothing worth a page — a wizard somebody
+ * clicked through leaves no document rather than an empty one.
+ */
+export declare function setupHandbookPage({ steps, values, businessName }: SetupHandbookInput): WriteHandbookInput | null;
+/**
+ * All the starter pages: the overview, then the drafts.
+ *
+ * The suggestions are pulled from the SAME wizard definitions the overview
+ * uses, by field id. A field id that no longer exists simply produces no
+ * suggestion — the heading stays, the blank stays, and the page is still worth
+ * having. That is the only failure mode this map is allowed to have.
+ */
+export declare function setupHandbookPages(input: SetupHandbookInput & {
+    verticalId?: string;
+}): WriteHandbookInput[];
+//# sourceMappingURL=handbook-seed.d.ts.map

package/dist/onboarding/handbook-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-seed.d.ts","sourceRoot":"","sources":["../../src/onboarding/handbook-seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,eAAe,wBAAwB,CAAA;AAiCpD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,UAAU,EAAE,CAAA;CACvB;AAoHD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACnC,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAmChH;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,EAAE,CAwC5G"}

package/dist/onboarding/index.d.ts

@@ -8,12 +8,21 @@ export { buildWorkspaceSetupSteps, slugify } from './steps';
 export { inferVerticalId } from './infer-vertical';
 export { brandMark, connectorOptions, connectorRows, OTHER_CONNECTOR, type ConnectorOptionsFilter } from './connector-options';
 export { getQuestionPack, resolveVerticalId, QUESTION_PACKS, beautyPack, foodPack, retailPack } from './packs';
-export { submitWorkspaceSetup, type SubmitWorkspaceSetupInput } from './submit';
-export { checkSlugAvailable, createLogoUploader, importLogoFromUrl, recordOnboardingResponse } from './backend';
+export { setupHandbookPage, setupHandbookPages, SETUP_PAGE_PATH } from './handbook-seed';
+export { submitWorkspaceSetup, GREETING_FLAG, type SubmitWorkspaceSetupInput } from './submit';
+export { checkSlugAvailable, createLogoUploader, importLogoFromUrl, recordOnboardingResponse, readSetupAnswers } from './backend';
 export { createSiteAnalyzer, type SiteAnalyzerOptions } from './analyze-site';
 export { GettingStartedWidget } from './GettingStartedWidget';
+export { ActivationProvider } from './ActivationProvider';
+export { ActivationChecklistCard, type ActivationChecklistCardProps } from './ActivationChecklistCard';
+export { useActivationWatch } from './useActivationWatch';
+export { startGuidedRun, runStep, celebrate } from './guided';
+export { planScript, playScript, runStepScript, say, type ScriptAct, type ScriptPlan, type PlayOptions, } from './guided-runner';
+export { ActivationAgentSurface } from './ActivationAgentSurface';
+export { useActivationStore, selectSteps, openStepKeys, type ActivationState, } from './activation.store';
+export { buildActivationCatalog, programInstructions, supersededKeys, type ActivationStep, type BuildCatalogInput, } from './programs';
 export { onboardingChecklist, mergeOnboardingSteps, dueDateFor, type OnboardingTaskSeed, type MergeContext, } from './checklist';
-export { seedOnboardingTasks, listOnboardingTasks, completeOnboardingTask } from './tasks';
+export { seedOnboardingTasks, listOnboardingTasks, completeOnboardingTask, cancelOnboardingTask } from './tasks';
 export { toQuestionSpecs, coerceAnswers, type QuestionSpec, type QuestionType } from './questions';
 export { WORKSPACE_SETUP_FLOW_ID, WORKSPACE_SETUP_FLOW_VERSION, type QuestionPack, type SetupAnswers, type SetupContext, type SetupSource, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC9H,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAC/G,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,mBAAmB,EAAE,oBAAoB,EAAE,UAAU,EACrD,KAAK,kBAAkB,EAAE,KAAK,YAAY,GAC3C,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAC1F,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAClG,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC9H,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC9G,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACxF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAC9F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjI,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,uBAAuB,EAAE,KAAK,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EACL,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAC1C,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,GAClD,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EACL,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,eAAe,GACpE,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,GACzG,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EAAE,oBAAoB,EAAE,UAAU,EACrD,KAAK,kBAAkB,EAAE,KAAK,YAAY,GAC3C,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAChH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAClG,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAA"}

package/dist/onboarding/programs.d.ts

@@ -0,0 +1,78 @@
+import type { OnboardingMove, ResolvedOnboardingProgram, TourDef } from '@fayz-ai/core';
+import type { AgentRole } from '@fayz-ai/core';
+import { type OnboardingTaskSeed } from './checklist';
+/**
+ * The activation catalog — every step a tenant has to finish, from every source.
+ *
+ * Two sources, deliberately unequal:
+ *
+ *  • The WORKSPACE steps (brand, team, payments, publish, first record) come
+ *    from `checklist.ts` and are true of any business on the platform.
+ *  • The MODULE steps come from each active plugin's `onboarding` program.
+ *    A shop is not live until it has a catalog, a payment method and a
+ *    published storefront; a clinic could not care less about any of that.
+ *
+ * Module keys are namespaced by their program (`shop.catalog`) and workspace
+ * keys are not, because the workspace ones were seeded before programs existed
+ * and their rows are already in production. Namespacing them now would seed a
+ * second copy of every one.
+ */
+export interface ActivationStep extends OnboardingTaskSeed {
+    /** 'workspace' for the base list, the plugin id for a module program. */
+    programId: string;
+    programTitle: string;
+    /** Guidance the agent follows on this step. */
+    agentHint?: string;
+    /** How it is done in this system — seeded onto the task, read by the agent. */
+    howTo?: string;
+    /** The walkthrough as data. Played by the runtime; see guided-runner.ts. */
+    script?: OnboardingMove[];
+    /** One line when it closes. Said locally, no model call. */
+    celebrate?: string;
+    /** Colleague who owns this step, when the program named one. */
+    role?: AgentRole;
+    tour?: TourDef;
+}
+export interface BuildCatalogInput {
+    verticalId?: string;
+    programs?: ResolvedOnboardingProgram[];
+    /**
+     * "Does this app have that screen?"
+     *
+     * A step's route comes from whoever wrote the step, and an app is free not to
+     * install the module behind it — the base list points at `/settings/appearance`
+     * for branding, and an app with the branding tab turned off has no such
+     * screen. Sending somebody (or the agent) there paints an empty page, so a
+     * route this app cannot serve is dropped and the step stays as a plain line.
+     * Absent means "trust every route", which is what the tests and the pure
+     * callers want.
+     */
+    hasRoute?: (route: string) => boolean;
+}
+/**
+ * Base list first, modules after, each program in its declared order.
+ *
+ * Order is the whole information design of the checklist: the rail offers an
+ * action on the FIRST open step only, and the agent works the list top-down. So
+ * "name your business" has to come before "import your catalog", and a module's
+ * own steps have to stay in the order the module wrote them.
+ */
+export declare function buildActivationCatalog({ verticalId, programs, hasRoute, }: BuildCatalogInput): ActivationStep[];
+/**
+ * Base keys the active programs supersede.
+ *
+ * Also read by the shell to CLOSE rows the wizard seeded before the module's
+ * program was known: the base "cadastre seu primeiro produto" row is written at
+ * signup, and the shop's own catalog step arrives one mount later. Leaving both
+ * would put a step in the Tasks panel that no checklist can ever tick.
+ */
+export declare function supersededKeys(programs: ResolvedOnboardingProgram[], verticalId: string | undefined): Set<string>;
+/**
+ * The instructions block handed to the agent — every active program's own words,
+ * in catalog order, with the steps still open under each one.
+ *
+ * This is what makes the guidance the MODULE's rather than the shell's: the shop
+ * plugin says how a shop gets launched, and the shell only decides when to say it.
+ */
+export declare function programInstructions(programs: ResolvedOnboardingProgram[], openKeys: ReadonlySet<string>): string[];
+//# sourceMappingURL=programs.d.ts.map

package/dist/onboarding/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../src/onboarding/programs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,yBAAyB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE1E;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CACtC;AA2CD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EAAE,QAAa,EAAE,QAAQ,GACpC,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAgCtC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,yBAAyB,EAAE,EACrC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,GAAG,CAAC,MAAM,CAAC,CASb;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,yBAAyB,EAAE,EACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,MAAM,EAAE,CAIV"}

package/dist/onboarding/submit.d.ts

@@ -1,12 +1,17 @@
 import type { Organization, OrgAdapter } from '@fayz-ai/core';
-import type { WizardValues } from '@fayz-ai/ui';
+import type { WizardStepDef, WizardValues } from '@fayz-ai/ui';
 import type { SetupSource } from './types';
+/** Set when a workspace is created; consumed once by the shell (see ActivationProvider). */
+export declare const GREETING_FLAG = "fayz:onboarding-greeting";
 export interface SubmitWorkspaceSetupInput {
     adapter: OrgAdapter;
     userId: string;
     /** Display name of the person running the flow — the checklist's assignee. */
     userName?: string;
     values: WizardValues;
+    /** The questionnaire as it was actually shown — the labels the handbook page
+     *  is written from. Absent skips the page rather than inventing labels. */
+    steps?: ReadonlyArray<WizardStepDef>;
     source: SetupSource;
     /** Fixed by the app; when absent the flow asked for it. */
     verticalId?: string;
@@ -21,5 +26,5 @@ export interface SubmitWorkspaceSetupInput {
  * a tenant that must exist. The logo is a second call (`create_tenant_with_owner`
  * takes no logo), and the questionnaire row is a third that is allowed to fail.
  */
-export declare function submitWorkspaceSetup({ adapter, userId, userName, values, source, verticalId, timezone, currency, locale, }: SubmitWorkspaceSetupInput): Promise<Organization>;
+export declare function submitWorkspaceSetup({ adapter, userId, userName, values, steps, source, verticalId, timezone, currency, locale, }: SubmitWorkspaceSetupInput): Promise<Organization>;
 //# sourceMappingURL=submit.d.ts.map

package/dist/onboarding/submit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/onboarding/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;IACnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAyDD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAClF,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoEnD"}
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/onboarding/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAU9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,4FAA4F;AAC5F,eAAO,MAAM,aAAa,6BAA6B,CAAA;AAEvD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB;+EAC2E;IAC3E,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,EAAE,WAAW,CAAA;IACnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAyDD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GACzF,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsFnD"}

package/dist/onboarding/tasks.d.ts

@@ -23,6 +23,13 @@ export interface SeedOnboardingTasksInput {
 export declare function seedOnboardingTasks(input: SeedOnboardingTasksInput): Promise<boolean>;
 /** `[]` when Supabase is absent, when nothing was seeded, or on any error. */
 export declare function listOnboardingTasks(tenantId: string): Promise<Task[]>;
+/**
+ * Close a seeded step a module has taken over (see `supersededKeys`).
+ *
+ * `cancelled`, not `done`: nobody did it, and the checklist that would have
+ * ticked it no longer exists. Both read as closed everywhere downstream.
+ */
+export declare function cancelOnboardingTask(tenantId: string, sourceKey: string): Promise<void>;
 /** The latch. Fire-and-forget; never throws. */
 export declare function completeOnboardingTask(tenantId: string, sourceKey: string): Promise<void>;
 //# sourceMappingURL=tasks.d.ts.map

package/dist/onboarding/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/onboarding/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAMjE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAC5B;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC3F;AAUD,8EAA8E;AAC9E,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAsB3E;AAED,gDAAgD;AAChD,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/F"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/onboarding/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAMjE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAC5B;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC3F;AAUD,8EAA8E;AAC9E,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAsB3E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7F;AAED,gDAAgD;AAChD,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/F"}

package/dist/onboarding/useActivationWatch.d.ts

@@ -0,0 +1,2 @@
+export declare function useActivationWatch(): void;
+//# sourceMappingURL=useActivationWatch.d.ts.map

package/dist/onboarding/useActivationWatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivationWatch.d.ts","sourceRoot":"","sources":["../../src/onboarding/useActivationWatch.ts"],"names":[],"mappings":"AA8BA,wBAAgB,kBAAkB,IAAI,IAAI,CA2EzC"}