@fayz-ai/admin 0.12.0 → 0.15.0

package/dist/lib/agent-staff.d.ts

@@ -0,0 +1,117 @@
+import type { AgentRole, AgentStaffDef } from '@fayz-ai/core';
+import { type ChatMessage } from '../stores/chat.store';
+/**
+ * The app's staff, resolved — who is on the payroll, who is active, and who a
+ * given role belongs to.
+ *
+ * The app casts the roles (`chat.staff`); everything downstream reads from
+ * here. Two consequences worth keeping in mind:
+ *
+ * - The ACTIVE agent scopes the toolset. Only its role's tools (plus the
+ *   shared primitives) are advertised, which is what makes two agents behave
+ *   differently rather than merely sound different.
+ * - An agent nobody hired is not degraded, it is absent: its tools never enter
+ *   the catalogue, so it cannot promise work it has no way to do. The colleague
+ *   pitch is what the user sees instead.
+ *
+ * An app with no cast keeps exactly the behaviour it had before: `roster()`
+ * comes back empty and every consumer falls through to the single assistant.
+ */
+/** The feature id that hires a role, when the cast doesn't name its own. */
+export declare function agentFeatureId(role: AgentRole): string;
+interface StaffState {
+    /** The cast, in the order the app declared it. */
+    roster: AgentStaffDef[];
+    /** Role of the agent currently answering. Null before a cast is registered. */
+    activeRole: AgentRole | null;
+    /** The team picker is open. Shared because the control and the thing it
+     *  opens live on opposite sides of the shell: the chevron is on the rail's
+     *  tab, the list is inside the panel. */
+    pickerOpen: boolean;
+    setRoster: (roster: AgentStaffDef[]) => void;
+    setActiveRole: (role: AgentRole | null) => void;
+    setPickerOpen: (open: boolean) => void;
+}
+export declare const useAgentStaffStore: import("zustand").UseBoundStore<import("zustand").StoreApi<StaffState>>;
+/** Who receives what belongs to nobody. Falls back to `setup`, then the first
+ *  member — an app that forgets to flag a host still has someone answering. */
+export declare function hostOf(roster: AgentStaffDef[]): AgentStaffDef | undefined;
+export declare function getRoster(): AgentStaffDef[];
+export declare function getHost(): AgentStaffDef | undefined;
+export declare function agentForRole(role: AgentRole): AgentStaffDef | undefined;
+/** The agent answering right now, or the host before anyone has been picked. */
+export declare function getActiveAgent(): AgentStaffDef | undefined;
+/**
+ * Is this agent on the payroll?
+ *
+ * Deliberately NOT `useAccess().entitled()`. The plan engine treats an
+ * undeclared feature as open (only an explicit `false` denies), which is right
+ * for a module the app forgot to gate and exactly wrong for something sold per
+ * seat: every paid agent would ship free. So hiring is opt-in — the plan has to
+ * say `true`.
+ */
+export declare function isAgentHired(member: AgentStaffDef): boolean;
+/** The cast this tenant can actually talk to. */
+export declare function hiredRoster(): AgentStaffDef[];
+/**
+ * Put `role` on duty: their thread comes forward, everyone else's is parked.
+ *
+ * The two moves are one action because they are one thing to the user — asking
+ * a different colleague is a different conversation. `notice` is what the
+ * transcript shows for the change, so a hand-off is never a silent swap of who
+ * is talking.
+ */
+export declare function switchToAgent(role: AgentRole, notice?: ChatMessage['notice']): void;
+/**
+ * Raise the panel with `role` on duty, and say whether the caller may proceed.
+ *
+ * This is what turns a button on a page into a colleague picking up: pressing
+ * "gravar o atendimento" on a client record does not start a recording behind a
+ * generic assistant, it opens the Auxiliar's thread and starts it there — same
+ * identity, same tools, same transcript afterwards.
+ *
+ * Returns `false` for exactly one case: the role IS cast and nobody hired them.
+ * The pitch is up, and the caller must not do the work — starting anyway would
+ * hand out the paid job while the panel is still selling it. An app that never
+ * cast the role gets `true` and the plain assistant, unchanged.
+ */
+export declare function openAssistantAs(role: AgentRole): boolean;
+/**
+ * The colleague being introduced right now.
+ *
+ * A store rather than a prop because the request comes from two places that do
+ * not share a parent: the team picker in the header, and the card the agent
+ * itself renders mid-conversation when it hits work it has no tools for. Both
+ * mean the same thing, so both land here and the panel answers once.
+ */
+interface MeetState {
+    meeting: AgentStaffDef | null;
+    meet: (member: AgentStaffDef) => void;
+    dismissMeeting: () => void;
+}
+export declare const useMeetAgentStore: import("zustand").UseBoundStore<import("zustand").StoreApi<MeetState>>;
+/**
+ * Who the model is this turn, and who it works with.
+ *
+ * The colleagues matter as much as the persona: without them the agent either
+ * refuses what isn't its job or improvises past its toolset. Un-hired ones are
+ * listed too, deliberately — recognising "that's Nina's work" and offering her
+ * is the only honest thing to say when the tools to do it are absent.
+ *
+ * Empty string when the app cast nobody, so the guidance is unchanged.
+ */
+export declare function buildPersonaGuidance(): string;
+/** Publishes the app's cast into the store for the lifetime of the shell. */
+export declare function useRegisterStaff(staff: AgentStaffDef[] | undefined): void;
+export declare function useRoster(): AgentStaffDef[];
+/** Reactive counterpart of {@link getActiveAgent}. */
+export declare function useActiveAgent(): AgentStaffDef | undefined;
+/** Reactive counterpart of {@link isAgentHired}. */
+export declare function useAgentHired(member: AgentStaffDef | undefined): boolean;
+/** The cast split by payroll, so the switcher can show both in one pass. */
+export declare function useStaffRoster(): {
+    hired: AgentStaffDef[];
+    open: AgentStaffDef[];
+};
+export {};
+//# sourceMappingURL=agent-staff.d.ts.map

package/dist/lib/agent-staff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-staff.d.ts","sourceRoot":"","sources":["../../src/lib/agent-staff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAQ,MAAM,eAAe,CAAA;AAInE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAErE;;;;;;;;;;;;;;;;GAgBG;AAEH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,UAAU,UAAU;IAClB,kDAAkD;IAClD,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,+EAA+E;IAC/E,UAAU,EAAE,SAAS,GAAG,IAAI,CAAA;IAC5B;;6CAEyC;IACzC,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IAC5C,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/C,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CACvC;AAED,eAAO,MAAM,kBAAkB,yEAc5B,CAAA;AAEH;+EAC+E;AAC/E,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,SAAS,CAEzE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,wBAAgB,OAAO,IAAI,aAAa,GAAG,SAAS,CAEnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAEvE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,aAAa,GAAG,SAAS,CAG1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAK3D;AAED,iDAAiD;AACjD,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,CAenF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAUxD;AAED;;;;;;;GAOG;AACH,UAAU,SAAS;IACjB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IACrC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED,eAAO,MAAM,iBAAiB,wEAI3B,CAAA;AAEH;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAyB7C;AAMD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,IAAI,CAUzE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,aAAa,GAAG,SAAS,CAO1D;AAaD,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAMxE;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,EAAE,aAAa,EAAE,CAAA;CAAE,CAalF"}

package/dist/lib/agent-surface.d.ts

@@ -1,3 +1,4 @@
+import type { AgentRole } from '@fayz-ai/core';
 import type { PluginAITool } from '../types/plugins';
 /**
  * Agent Surface Contract — how the screen the user is looking at RIGHT NOW
@@ -44,6 +45,9 @@ export interface AgentSurfaceContribution {
     id: string;
     /** Plugin that owns the surface, used for tool ranking. */
     pluginId?: string;
+    /** Colleague this surface's tools belong to, inherited by any tool that does
+     *  not name its own. Omit to leave them shared by everyone. */
+    role?: AgentRole;
     /** Snapshot of what's on screen. Called fresh at send time — never cached. */
     describe?: () => AgentSurfaceSnapshot;
     /** Guidance appended to the request ONLY while this surface is mounted. */

package/dist/lib/agent-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-surface.d.ts","sourceRoot":"","sources":["../../src/lib/agent-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAC3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,IAAI,EAAE,YAAY,CAAA;IAClB,iFAAiF;IACjF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,oBAAoB,CAAA;IACrC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED;yDACyD;AACzD,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,wBAAwB,CAAA;CACpC;AAWD,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGzD;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;iDACiD;AACjD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAG5D;AAED;sDACsD;AACtD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,YAAY,EAAE,CAEhD;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,IAAI;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAeA"}
+{"version":3,"file":"agent-surface.d.ts","sourceRoot":"","sources":["../../src/lib/agent-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAC3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,IAAI,EAAE,YAAY,CAAA;IAClB,iFAAiF;IACjF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;mEAC+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,oBAAoB,CAAA;IACrC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED;yDACyD;AACzD,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,wBAAwB,CAAA;CACpC;AAWD,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGzD;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;iDACiD;AACjD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAG5D;AAED;sDACsD;AACtD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,YAAY,EAAE,CAMhD;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,IAAI;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAeA"}

package/dist/lib/agent-threads.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Which colleague a past conversation belongs to.
+ *
+ * The broker stores one agent per project, so a conversation it hands back
+ * carries no idea of who was speaking. Until it does, the surface remembers:
+ * every thread the user starts is tagged here as it gets its server id, and the
+ * history drawer reads the tag to show one colleague's conversations at a time.
+ *
+ * Local by design and deliberately lossy — a thread from another browser, or
+ * from before the cast existed, has no tag and belongs to nobody. The drawer
+ * shows those to the host rather than hiding them.
+ */
+export declare function tagConversation(conversationId: string, role: string): void;
+export declare function roleOfConversation(conversationId: string): string | null;
+//# sourceMappingURL=agent-threads.d.ts.map

package/dist/lib/agent-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-threads.d.ts","sourceRoot":"","sources":["../../src/lib/agent-threads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2BH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE"}

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":"AAgFA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAC7E,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,YAAY,EAEZ,iBAAiB,EACjB,UAAU,EACX,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AAEH,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC;;;;;OAKG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrD;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACX,aAAa,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,UAAU,CAAC,KAChD,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAC/B,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAC/B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;KAC/D,GAAG,IAAI,CAAA;CACT;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,sBAAsB,KAC5B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAI/B;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAqDD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;CAChB;AAoND,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAmBhC;AAyBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC5C,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAA;IACpH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAClE,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC9E,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAyC9B;AAyvBD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,EAAE,SAAS,EAAE,cAAc,EAAE,QAA6B,EAAE,EAAE,mBAAmB,GAChF,SAAS,EAAE,CAoBb;AA4aD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAehC"}
+{"version":3,"file":"ai-tool-handlers.d.ts","sourceRoot":"","sources":["../../src/lib/ai-tool-handlers.ts"],"names":[],"mappings":"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"}

package/dist/lib/assistant-activity.d.ts

@@ -1,3 +1,4 @@
+import type { AgentRole } from '@fayz-ai/core';
 /**
  * Assistant Activity Contract — what the app is DOING right now (a recording
  * running, a task in flight), and how to end it from wherever the user is.
@@ -10,8 +11,15 @@
  *
  * Sibling of `lib/agent-surface.ts`: that one carries what the screen KNOWS.
  */
-export type AssistantActivityState = 'running' | 'paused' | 'done';
-export type AssistantActionIntent = 'pause' | 'resume' | 'stop' | 'open' | 'discard' | 'generate';
+/**
+ * `pending` is the activity BEFORE its first byte: announced, described, and
+ * waiting on the one decision that has to happen before it starts. It exists so
+ * that gate stops being a modal — the panel that will carry the session is also
+ * where the session is agreed to, instead of a dialog over the page plus a
+ * panel behind it, two surfaces for one act.
+ */
+export type AssistantActivityState = 'pending' | 'running' | 'paused' | 'done';
+export type AssistantActionIntent = 'start' | 'cancel' | 'pause' | 'resume' | 'stop' | 'open' | 'discard' | 'generate';
 export interface AssistantActivityAction {
     intent: AssistantActionIntent;
     label: string;
@@ -34,6 +42,22 @@ export interface AssistantActivity {
      */
     elapsedMs?: number;
     actions?: AssistantActivityAction[];
+    /**
+     * What must be read and agreed to before a `pending` activity may start. The
+     * shell renders the sentence and the checkbox and withholds the `start`
+     * action until it is ticked; the OWNER decides what it says and what starting
+     * does. Recording consent is the first caller, but the shape is the same for
+     * a cost warning or any other "are you sure" that precedes work.
+     *
+     * Data only, like the actions: a component here would put @fayz-ai/admin
+     * downstream of whichever plugin drew it.
+     */
+    confirm?: {
+        /** The claim the operator is making by ticking it. */
+        acknowledge: string;
+        /** The quieter line under it — what happens to what is captured. */
+        note?: string;
+    };
     /**
      * The live audio, for the composer's level meter. Lent by the owner rather
      * than captured again: a second `getUserMedia` on the same mic is another
@@ -43,8 +67,16 @@ export interface AssistantActivity {
      */
     stream?: () => MediaStream | null;
 }
-/** Idle-state offer, so the panel is where a session begins as well as where
- *  it is watched. */
+/**
+ * Something this app can START from the panel — offered by the colleague whose
+ * job it is, in their own thread.
+ *
+ * The offer used to sit on everyone's greeting screen and was taken back out,
+ * rightly: a feature most sessions never touch does not belong at the top of
+ * the one screen whose job is to get a sentence typed. With a cast it has an
+ * owner, and on the Auxiliar's thread "gravar o atendimento" is not clutter —
+ * it is the thing she is for.
+ */
 export interface AssistantLauncher {
     id: string;
     label: string;
@@ -53,6 +85,15 @@ export interface AssistantLauncher {
     disabled?: boolean;
     /** Why it is unavailable — surfaced as the button's title. */
     disabledReason?: string;
+    /**
+     * Whose offer this is. Shown only while that colleague is answering.
+     *
+     * Deliberately STRICTER than the same field on a tool: an unplayed role
+     * leaves a tool open to everyone (losing a module would cost capability),
+     * but a launcher is a button on the greeting, and the cost of showing it to
+     * nobody in particular is the clutter that got it removed the first time.
+     */
+    role?: AgentRole;
 }
 export declare function publishAssistantActivity(activity: AssistantActivity): void;
 export declare function withdrawAssistantActivity(id: string): void;
@@ -69,6 +110,8 @@ export declare function __readAssistantRegistry(): {
     current: AssistantActivity | null;
 };
 export declare function useAssistantLaunchers(): AssistantLauncher[];
+/** What the colleague on duty can start. See {@link AssistantLauncher.role}. */
+export declare function useLaunchersForRole(role: AgentRole | null | undefined): AssistantLauncher[];
 /** Publish while mounted, withdraw on unmount. `null` when nothing is live. */
 export declare function usePublishAssistantActivity(activity: AssistantActivity | null): void;
 /** Register from a mounted component; withdrawn on unmount. */

package/dist/lib/assistant-activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-activity.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-activity.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAElE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjG,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,qBAAqB,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAA;IACV,wEAAwE;IACxE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;IAC1B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,sBAAsB,CAAA;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAClC;AAED;qBACqB;AACrB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;IAC1B,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAYD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAG1E;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK1D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAG3E;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK5D;AAgBD;;qCAEqC;AACrC,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAG/D;AAWD,+DAA+D;AAC/D,wBAAgB,uBAAuB,IAAI;IACzC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAC9B,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAClC,CAEA;AAED,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAG3D;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAmBpF;AAED,+DAA+D;AAC/D,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAerF;AAED;mDACmD;AACnD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOxD"}
+{"version":3,"file":"assistant-activity.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-activity.ts"],"names":[],"mappings":"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"}

package/dist/lib/assistant-invite.d.ts

@@ -1,3 +1,4 @@
+import type { AgentRole } from '@fayz-ai/core';
 /**
  * Assistant Invite — how a screen ASKS to be helped.
  *
@@ -12,6 +13,14 @@
  *
  * One invite is active at a time: it belongs to the screen the user is on.
  */
+/**
+ * The id a screen's handoff borrows the invite under ("Criar com IA").
+ *
+ * Lives here, not in the button: whoever asks "is the assistant in the middle
+ * of a delegated task?" is asking about the INVITE. The rail reads it to fall
+ * quiet — see RightRail.
+ */
+export declare const ASK_AI_HANDOFF_ID = "ask-ai.handoff";
 export interface AssistantInviteSuggestion {
     label: string;
     /** Sent instead of `label` when the chip is picked. */
@@ -20,7 +29,17 @@ export interface AssistantInviteSuggestion {
 export interface AssistantInviteDef {
     /** Stable id — also the session key that remembers a dismissal. */
     id: string;
-    /** Names the assistant for this screen ("Growth Analyst"), heading the rail. */
+    /**
+     * Which colleague this screen's help belongs to. With a cast, opening the
+     * assistant here puts them on duty — the deterministic half of the routing,
+     * for the cases the model should never have to guess.
+     */
+    role?: AgentRole;
+    /**
+     * What the help IS, in the user's words ("Montador de formulários"). Names
+     * the assistant on an app with no cast; with one, the colleague supplies the
+     * name and this stays as the subject beside it.
+     */
     persona?: string;
     /** Hero headline. `{{name}}` resolves to the signed-in user's first name. */
     headline: string;

package/dist/lib/assistant-invite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-invite.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-invite.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAA;IACV,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACzC,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AA4B5B,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACjC,KAAK,EAAE,KAAK,CAAA;IACZ;;2CAEuC;IACvC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB;kFAC8E;IAC9E,OAAO,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5D,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnE,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IACzC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,eAAO,MAAM,uBAAuB,mFAsCjC,CAAA"}
+{"version":3,"file":"assistant-invite.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-invite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C;;;;;;;;;;;;;GAaG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,mBAAmB,CAAA;AAEjD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACzC,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AA4B5B,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACjC,KAAK,EAAE,KAAK,CAAA;IACZ;;2CAEuC;IACvC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB;kFAC8E;IAC9E,OAAO,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5D,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnE,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IACzC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,eAAO,MAAM,uBAAuB,mFA8CjC,CAAA"}

package/dist/lib/assistant-text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Strip tool-call artifacts from assistant text.
+ *
+ * Runs on every delta, so it must be cheap and must never mangle a partial
+ * token: an unclosed `{requestMenuPhotos` matches nothing and simply survives
+ * until the closing brace arrives.
+ */
+export declare function sanitizeAssistantText(text: string): string;
+//# sourceMappingURL=assistant-text.d.ts.map

package/dist/lib/assistant-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-text.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-text.ts"],"names":[],"mappings":"AA4BA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc1D"}

package/dist/lib/chat-upload.d.ts

@@ -0,0 +1,12 @@
+import { type UploadRequest } from '../stores/chat.store';
+/**
+ * Ask the user for a file, through the assistant.
+ *
+ * A tool calls this and the composer grows one big button ("Subir foto do
+ * cardápio"). The bytes go straight to `onFiles` — they never enter the turn,
+ * because a turn carries a DIGEST of a file and, for an image, that digest is
+ * empty. This is what makes "manda a foto" a thing the agent can actually
+ * follow through on today.
+ */
+export declare function requestChatUpload(request: Omit<UploadRequest, 'id' | 'status' | 'files'>): string;
+//# sourceMappingURL=chat-upload.d.ts.map

package/dist/lib/chat-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-upload.d.ts","sourceRoot":"","sources":["../../src/lib/chat-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEvE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG,MAAM,CAEjG"}

package/dist/lib/core-ai-tools.d.ts

@@ -46,4 +46,21 @@ export declare const PROFILE_ACTIONS: readonly ["read", "create", "edit", "delet
  */
 export declare function buildPermissionTools(features: FeatureDeclaration[], profiles?: PermissionProfile[]): PluginAITool[];
 export declare function generateEntityTools(entities?: RegisteredEntity[]): PluginAITool[];
+/**
+ * `callColleague` — the one way an agent reaches another.
+ *
+ * Built per turn rather than declared statically because its whole value is the
+ * enum: naming the colleagues by role lets the model pick one instead of
+ * inventing a name, and an app with nobody else on staff never sees the tool at
+ * all. Un-hired colleagues are listed too — offering them is the honest answer
+ * when the tools for that job are absent, and the executor renders the offer
+ * rather than the hand-off.
+ */
+export declare function buildColleagueTool(colleagues: Array<{
+    role: string;
+    name: string;
+    title: string;
+    goal: string;
+    hired: boolean;
+}>): PluginAITool[];
 //# sourceMappingURL=core-ai-tools.d.ts.map

package/dist/lib/core-ai-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-ai-tools.d.ts","sourceRoot":"","sources":["../../src/lib/core-ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACrF,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrE;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,EA+FrC,CAAA;AA0BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,YAAY,EAAE,CAoBvG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAO9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAmDD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC5C,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC9E,GAAG,YAAY,EAAE,CA8MjB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,+CAAgD,CAAA;AAK5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,GAAE,iBAAiB,EAAO,GACjC,YAAY,EAAE,CAoFhB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,gBAAgB,EAAqB,GAAG,YAAY,EAAE,CAoBnG"}
+{"version":3,"file":"core-ai-tools.d.ts","sourceRoot":"","sources":["../../src/lib/core-ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACrF,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrE;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,EA+FrC,CAAA;AA0BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,YAAY,EAAE,CAoBvG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAO9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAmDD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC5C,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC9E,GAAG,YAAY,EAAE,CA8MjB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,+CAAgD,CAAA;AAK5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,GAAE,iBAAiB,EAAO,GACjC,YAAY,EAAE,CAoFhB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,gBAAgB,EAAqB,GAAG,YAAY,EAAE,CAoBnG;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GAC7F,YAAY,EAAE,CAqChB"}

package/dist/lib/fayz-agent.d.ts

@@ -18,6 +18,15 @@ export interface ResolvedFayzAgentConnection {
     apiBaseUrl: string;
     publishableKey: string;
 }
+/**
+ * Just the platform address, for the endpoints that need no credential.
+ *
+ * Separate from `resolveFayzAgentConnection` because that one requires all three
+ * variables: an app without an agent key still has a platform to talk to, and
+ * gating the anonymous endpoints on the agent key would silently switch them off
+ * for most of the fleet.
+ */
+export declare function resolveFayzApiBaseUrl(override?: string): string | undefined;
 export declare function resolveFayzAgentConnection(override?: FayzAgentConnectionConfig | false): ResolvedFayzAgentConnection | null;
 export declare function getFayzAgentClient(connection: ResolvedFayzAgentConnection): FayzAgentClient;
 //# sourceMappingURL=fayz-agent.d.ts.map

package/dist/lib/fayz-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fayz-agent.d.ts","sourceRoot":"","sources":["../../src/lib/fayz-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEhF;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;CACvB;AAOD,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,KAAK,GAC3C,2BAA2B,GAAG,IAAI,CASpC;AAID,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,2BAA2B,GAAG,eAAe,CAW3F"}
+{"version":3,"file":"fayz-agent.d.ts","sourceRoot":"","sources":["../../src/lib/fayz-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEhF;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;CACvB;AAOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3E;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,KAAK,GAC3C,2BAA2B,GAAG,IAAI,CASpC;AAID,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,2BAA2B,GAAG,eAAe,CAW3F"}

package/dist/lib/staff-cards.d.ts

@@ -0,0 +1,11 @@
+import type { ChatStaffCard } from '../stores/chat.store';
+/**
+ * Turn a `callColleague` result into the colleague card under the reply.
+ *
+ * Same contract as {@link extractConnectorCards}: the chat reads the tool's own
+ * output instead of the executor reaching into the store, so a resumed thread
+ * replays the card it rendered live. Nothing is inferred — only a payload that
+ * says it is a staff pitch produces one.
+ */
+export declare function extractStaffCards(content: string): ChatStaffCard[];
+//# sourceMappingURL=staff-cards.d.ts.map

package/dist/lib/staff-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-cards.d.ts","sourceRoot":"","sources":["../../src/lib/staff-cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA8BlE"}

package/dist/lib/unit-ai-handlers.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unit-ai-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unit-ai-handlers.d.ts","sourceRoot":"","sources":["../../src/lib/unit-ai-handlers.ts"],"names":[],"mappings":""}

package/dist/lib/unit-ai-tools.d.ts

@@ -0,0 +1,3 @@
+import type { PluginAITool } from '@fayz-ai/core';
+export declare const unitAITools: PluginAITool[];
+//# sourceMappingURL=unit-ai-tools.d.ts.map

package/dist/lib/unit-ai-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-ai-tools.d.ts","sourceRoot":"","sources":["../../src/lib/unit-ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAkBjD,eAAO,MAAM,WAAW,EAAE,YAAY,EAoErC,CAAA"}

package/dist/onboarding/GettingStartedWidget.d.ts

@@ -0,0 +1,13 @@
+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.
+ *
+ * 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.
+ */
+export declare function GettingStartedWidget(): React.JSX.Element | null;
+//# sourceMappingURL=GettingStartedWidget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GettingStartedWidget.d.ts","sourceRoot":"","sources":["../../src/onboarding/GettingStartedWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,6BAoCnC"}

package/dist/onboarding/WorkspaceSetupFlow.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { type WizardMedia } from '@fayz-ai/ui';
+import type { SetupSource } from './types';
+export interface WorkspaceSetupFlowProps {
+    source: SetupSource;
+    /** Fixed by the app. Absent means the flow asks which vertical this is. */
+    verticalId?: string;
+    timezone?: string;
+    currency?: string;
+    locale?: string;
+    logo?: React.ReactNode;
+    /** Per-step artwork, keyed by step id — where an app plugs its own images in. */
+    media?: Record<string, WizardMedia>;
+    /** Omitted on the first workspace: there is no app behind the flow to go back to. */
+    onExit?: () => void;
+    onCreated?: (orgId: string) => void;
+    className?: string;
+}
+/**
+ * The workspace setup flow — one wizard serving both the first workspace after
+ * signup and every extra one from the switcher.
+ */
+export declare function WorkspaceSetupFlow({ source, verticalId, timezone, currency, locale, logo, media, onExit, onCreated, className, }: WorkspaceSetupFlowProps): React.JSX.Element;
+//# sourceMappingURL=WorkspaceSetupFlow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSetupFlow.d.ts","sourceRoot":"","sources":["../../src/onboarding/WorkspaceSetupFlow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAU,KAAK,WAAW,EAAyC,MAAM,aAAa,CAAA;AAU7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAA;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnC,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAC1F,EAAE,uBAAuB,qBAgGzB"}

package/dist/onboarding/WorkspaceSetupGate.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+import type { WizardMedia } from '@fayz-ai/ui';
+import type { SetupMode } from './resolve';
+export interface WorkspaceSetupGateProps {
+    mode: SetupMode;
+    verticalId?: string;
+    timezone?: string;
+    currency?: string;
+    locale?: string;
+    logo?: React.ReactNode;
+    media?: Record<string, WizardMedia>;
+    /** Held on screen while we do not yet know if this account has a workspace. */
+    fallback?: React.ReactNode;
+    children: React.ReactNode;
+}
+/**
+ * Puts the setup flow in front of the shell when it applies, and gets out of the
+ * way when it does not.
+ *
+ * Mounted inside the AuthGate but outside the chrome, for the same reason the
+ * consent screen is: a sidebar around "name your business" invites someone to
+ * wander off before they have a business to wander around in.
+ */
+export declare function WorkspaceSetupGate({ mode, verticalId, timezone, currency, locale, logo, media, fallback, children, }: WorkspaceSetupGateProps): React.JSX.Element;
+//# sourceMappingURL=WorkspaceSetupGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSetupGate.d.ts","sourceRoot":"","sources":["../../src/onboarding/WorkspaceSetupGate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAC9E,EAAE,uBAAuB,qBA4BzB"}

package/dist/onboarding/analyze-site.d.ts

@@ -0,0 +1,23 @@
+import type { WizardStepDef, WizardValues } from '@fayz-ai/ui';
+export interface SiteAnalyzerOptions {
+    /** `VITE_FAYZ_API_BASE_URL`, in either of its two spellings. */
+    apiBaseUrl?: string;
+    /**
+     * The whole flow, so the questions go out and the answers come back typed.
+     *
+     * A getter rather than the array, because the field that triggers this lives
+     * inside the steps it needs — taking them lazily is what keeps the flow to a
+     * single build instead of one pass to read the questions and another to attach
+     * the handler.
+     */
+    steps: () => ReadonlyArray<WizardStepDef>;
+    locale?: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * Returns null — never throws — when there is nothing to offer. Every caller is
+ * a user mid-form who has no use for the difference between a dead site and a
+ * dead network.
+ */
+export declare function createSiteAnalyzer({ apiBaseUrl, steps, locale, fetcher, }: SiteAnalyzerOptions): (url: string) => Promise<WizardValues | null>;
+//# sourceMappingURL=analyze-site.d.ts.map

package/dist/onboarding/analyze-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-site.d.ts","sourceRoot":"","sources":["../../src/onboarding/analyze-site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAsB9D,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,aAAa,CAAC,aAAa,CAAC,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmCrE"}

package/dist/onboarding/backend.d.ts

@@ -0,0 +1,44 @@
+import { type SetupSource } from './types';
+import type { WizardValues } from '@fayz-ai/ui';
+/**
+ * Upload the workspace logo BEFORE the tenant exists.
+ *
+ * Every other logo path in the shell keys storage by tenant id, which is not an
+ * option here — the tenant is created at the end of the flow. Keyed by user
+ * instead, in the same bucket the branding screen already writes to, so the file
+ * ends up where the rest of the app looks for it.
+ */
+export declare function createLogoUploader(userId: string): (file: File) => Promise<string>;
+/**
+ * Re-host a logo we read off someone else's site.
+ *
+ * The site import hands back whatever URL the page served its logo from — a CDN
+ * we do not control, or an inline `data:` URI. Storing either on the tenant row
+ * means the workspace's logo breaks the day they redesign, so it is copied into
+ * our own bucket before it is saved.
+ *
+ * Returns null on any failure, and the caller keeps the original URL: a logo
+ * that might break later still beats no logo at all.
+ */
+export declare function importLogoFromUrl(userId: string, url: string): Promise<string | null>;
+/**
+ * Is this handle free? Falls back to "yes" whenever we cannot ask — the unique
+ * constraint on `tenants.slug` is the real guard, and a failed probe must not
+ * stop someone from continuing.
+ */
+export declare function checkSlugAvailable(slug: string): Promise<boolean>;
+export interface RecordResponseInput {
+    tenantId: string;
+    userId: string;
+    verticalId?: string;
+    source: SetupSource;
+    heardFrom?: string;
+    values: WizardValues;
+}
+/**
+ * Persist what they told us. Deliberately swallows its own failures: the caller
+ * has just created a workspace, and losing a questionnaire row is not a reason
+ * to tell someone their business was not created.
+ */
+export declare function recordOnboardingResponse(input: RecordResponseInput): Promise<boolean>;
+//# sourceMappingURL=backend.d.ts.map

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

@@ -0,0 +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"}