@fayz-ai/admin 0.10.0

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

@@ -0,0 +1,27 @@
+export interface AutoApprovalRule {
+    /** `toolName` or `toolName:scope` — what the decision is remembered against. */
+    key: string;
+    toolName: string;
+    /** Entity the rule is limited to, so "always create clients" never becomes
+     *  "always create anything". */
+    scope?: string;
+    /** Human label for the revoke list ("Criar Cliente"). */
+    label: string;
+    createdAt: string;
+}
+export declare function isDestructiveTool(toolName: string): boolean;
+export declare function approvalKey(toolName: string, scope?: string): string;
+/** Re-render the revoke list when a grant is added or removed. */
+export declare function subscribeAutoApprovals(listener: () => void): () => void;
+export declare function listAutoApprovals(): AutoApprovalRule[];
+export declare function isAutoApproved(toolName: string, scope?: string): boolean;
+export declare function grantAutoApproval(input: {
+    toolName: string;
+    scope?: string;
+    label: string;
+    /** Force session-only. Destructive tools are session-only regardless. */
+    session?: boolean;
+}): void;
+export declare function revokeAutoApproval(key: string): void;
+export declare function revokeAllAutoApprovals(): void;
+//# sourceMappingURL=agent-approvals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-approvals.d.ts","sourceRoot":"","sources":["../../src/lib/agent-approvals.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB;oCACgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAKD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AA0CD,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGvE;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAEtD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAiBP;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C"}

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

@@ -0,0 +1,78 @@
+import type { PluginAITool } from '../types/plugins';
+/**
+ * Agent Surface Contract — how the screen the user is looking at RIGHT NOW
+ * contributes to the assistant.
+ *
+ * The FAB's base capabilities (data primitives, navigation) are global. But a
+ * live, interactive surface — the form builder, a calendar, a reconciliation
+ * ledger — has TWO things the global catalog can't express:
+ *
+ *  1. State that only exists on screen (an unsaved form draft), which the model
+ *     must SEE to help with, and
+ *  2. Tools that act on that live state (add a field to the draft the user is
+ *     watching), which only make sense while the surface is mounted.
+ *
+ * A surface publishes both by calling `useAgentSurface(...)` on mount and
+ * withdrawing them on unmount. This module is the registry the shell reads:
+ * `useAITools` merges the tools, `useChat` folds the snapshot + instructions
+ * into the request, and the executors ride the normal client-plane handler map.
+ *
+ * This is the scalable seam: forms is the first consumer; agenda, financial and
+ * marketing adopt the same contract without touching the shell again.
+ */
+export interface AgentSurfaceSnapshot {
+    /** One line naming what's on screen, e.g. 'Form builder — "Anamnese"'. */
+    title?: string;
+    /** Structured state the model should reason over (the form draft, filters…). */
+    state?: Record<string, unknown>;
+    /** The record this surface is centered on, when it is a detail page. */
+    record?: {
+        entity: string;
+        id: string;
+        label?: string;
+        summary?: Record<string, unknown>;
+    };
+}
+export interface AgentSurfaceTool {
+    /** Declared tool shape (name, description, params) — same as a plugin aiTool. */
+    tool: PluginAITool;
+    /** Client-plane executor that mutates the live surface. Read fresh each call. */
+    execute: (args: Record<string, unknown>) => unknown | Promise<unknown>;
+}
+export interface AgentSurfaceContribution {
+    /** Stable id for this surface instance, e.g. 'custom_forms.builder'. */
+    id: string;
+    /** Plugin that owns the surface, used for tool ranking. */
+    pluginId?: string;
+    /** 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. */
+    instructions?: string;
+    /** Tools available only while this surface is mounted. */
+    tools?: AgentSurfaceTool[];
+}
+/** Registry entry keeps a getter, not the value, so closures stay fresh across
+ *  re-renders without re-registering on every render. */
+interface SurfaceEntry {
+    id: string;
+    get: () => AgentSurfaceContribution;
+}
+/** Add or replace a surface (by id). Called on mount. */
+export declare function registerSurface(entry: SurfaceEntry): void;
+/** Remove a surface. Called on unmount. */
+export declare function unregisterSurface(id: string): void;
+/** useSyncExternalStore subscription — fires only on mount/unmount, not on the
+ *  per-render state changes inside a surface. */
+export declare function subscribeSurfaces(cb: () => void): () => void;
+/** Version counter for useSyncExternalStore; bumps when the set of surfaces
+ *  changes so `useAITools` recomputes its catalog. */
+export declare function getSurfaceVersion(): number;
+/** Flat list of tool declarations across every mounted surface (for the catalog). */
+export declare function getSurfaceTools(): PluginAITool[];
+/** Snapshot + instructions from every mounted surface, read at send time. */
+export declare function getActiveSurfaceContext(): {
+    snapshot: AgentSurfaceSnapshot[];
+    instructions: string[];
+};
+export {};
+//# sourceMappingURL=agent-surface.d.ts.map

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

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

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

@@ -0,0 +1,154 @@
+import type { EntityDef, OrgMember, Organization, PermissionProfile, TeamPerson } from '@fayz-ai/core';
+import type { PluginAITool, PluginRegistryDef } from '../types/plugins';
+/**
+ * Client-plane execution for the AI tool catalog.
+ *
+ * `useAITools()` declares *what* the surface can do — it is the catalog the
+ * model reasons over. This module is *how*: the browser runs the call against
+ * the session that is already open (org store, data providers, router) and
+ * hands a serialized result back to the agent.
+ *
+ * The split matters because Fayz never holds the surface's data credentials.
+ * The agent broker forwards the catalog, decides which tool to call, and
+ * returns the call for the surface to execute — the same contract a
+ * server-side channel (WhatsApp, email) satisfies with a server-side executor.
+ *
+ * **A capability is only advertised if it can run.** A declared tool with no
+ * executor is a promise to the model the surface cannot keep: it burns
+ * reasoning rounds retrying, then apologises. `buildAgentToolset` is the gate —
+ * everything it returns has a resolvable executor.
+ */
+/** An entity the executor can read through its own data provider. */
+export interface DataToolTarget {
+    label: string;
+    entity: EntityDef;
+    mockData?: Array<{
+        id: string;
+    }>;
+    /** Read-model (view/ledger): searchable/queryable but never writable. */
+    readOnly?: boolean;
+}
+export interface AIToolExecutionContext {
+    currentOrg: Organization | null;
+    members: OrgMember[];
+    /**
+     * Person-first team resolver — the same source the Team screen renders
+     * (people of the configured `team.personKinds`, each with an OPTIONAL access
+     * overlay). Absent when the app runs in legacy membership-only mode, in
+     * which case `members` is the whole team.
+     */
+    loadTeam?: () => Promise<TeamPerson[]>;
+    currentPath: string;
+    /** Pages the surface exposes, used to resolve navigation requests. */
+    routes: Array<{
+        path: string;
+        label?: string;
+    }>;
+    navigate: (path: string) => void;
+    /**
+     * Data-backed tools, keyed by the LLM-facing tool name. These execute
+     * generically through the entity's own data provider, so every registry and
+     * every CRUD entity the app declares is readable without a hand-written
+     * handler — which is what lets a new vertical work on day one.
+     */
+    dataTools: Map<string, DataToolTarget>;
+    /**
+     * The WRITE tools the agent can actually run this turn — what a refusal is
+     * allowed to point at, with the action each performs. Read tools and
+     * declared-but-unexecutable ones are excluded on purpose ("use listLeads" for
+     * an update is worse advice than none), and the action matters just as much:
+     * pointed at `updateLead` for a CREATE, the model called it with
+     * `lead_id: "N/A"`.
+     */
+    writeTools?: Array<{
+        name: string;
+        action?: string;
+    }>;
+    /**
+     * Org-management writes the agent can perform — today only access profiles.
+     * Narrowed to what is actually called: handing the executor the whole adapter
+     * would let a future tool remove members from a chat turn.
+     */
+    orgAdapter?: {
+        createProfile: (orgId: string, profile: Omit<PermissionProfile, 'id' | 'isSystem'>) => Promise<PermissionProfile>;
+        updateProfile?: (orgId: string, profileId: string, data: Partial<PermissionProfile>) => Promise<PermissionProfile>;
+        listProfiles?: (orgId: string) => Promise<PermissionProfile[]>;
+    } | null;
+}
+export type AIToolHandler = (args: Record<string, unknown>, context: AIToolExecutionContext) => unknown | Promise<unknown>;
+/**
+ * Register an executor for a tool, keyed by the tool's `name` (the identifier
+ * the model calls, e.g. `getTeamMembers`). Plugins and apps call this to make
+ * their declared `aiTools` actually runnable.
+ */
+export declare function registerAIToolHandler(name: string, handler: AIToolHandler): void;
+export declare function registerAIToolHandlers(map: Record<string, AIToolHandler>): void;
+/**
+ * Remove an executor. Surface-scoped tools (a form builder's field ops) live
+ * only while their screen is mounted; unregistering on unmount stops the model
+ * from calling a tool whose live target no longer exists.
+ */
+export declare function unregisterAIToolHandler(name: string): void;
+export declare function hasAIToolHandler(name: string): boolean;
+export interface AIToolExecutionResult {
+    ok: boolean;
+    /** JSON-serialized payload handed back to the agent. */
+    content: string;
+}
+export declare function executeAITool(name: string, args: Record<string, unknown>, context: AIToolExecutionContext): Promise<AIToolExecutionResult>;
+/**
+ * Index everything readable by the tool name its generator mints, so the
+ * executor can find the entity behind a call. Covers plugin registries and the
+ * app's own CRUD entities.
+ */
+export declare function buildDataToolIndex(input: {
+    registries: Map<string, PluginRegistryDef[]>;
+    entities: Array<{
+        entityKey: string;
+        labelPlural: string;
+        entityDef?: EntityDef;
+        mockData?: Array<{
+            id: string;
+        }>;
+    }>;
+    registryToolName: (pluginId: string, registryId: string) => string;
+    entityToolName: (entityKey: string) => string;
+    queryEntities?: Array<{
+        key: string;
+        entity: EntityDef;
+        writable?: boolean;
+    }>;
+}): Map<string, DataToolTarget>;
+export interface AgentTool {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+}
+export interface BuildToolsetOptions {
+    dataTools: Map<string, DataToolTarget>;
+    /** Plugin owning the current route; its tools rank ahead of the rest. */
+    activePluginId?: string | null;
+    maxTools?: number;
+}
+/**
+ * Shape the declared catalog into the toolset sent to the agent.
+ *
+ * Two filters, both load-bearing:
+ *
+ * 1. *Executable only.* An advertised tool with no executor is worse than a
+ *    missing one — the model spends rounds on it and then apologises.
+ * 2. *Contextual.* A mature app declares ~40 tools; sending all of them every
+ *    turn costs input tokens on every request and degrades which tool the model
+ *    picks. Tools owned by the plugin the user is currently looking at come
+ *    first, then the rest, capped.
+ */
+export declare function buildAgentToolset(tools: PluginAITool[], { dataTools, activePluginId, maxTools }: BuildToolsetOptions): AgentTool[];
+/**
+ * Client-plane execution of an RPC-bound tool (`execution: {kind:'rpc'}`):
+ * calls the pool function as the signed-in user. The actor is the SESSION
+ * user — spine 016 makes the RPC reject any other p_actor for JWT callers, so
+ * this path cannot borrow someone else's role. Structured denials pass through
+ * to the model (conversational paywall); S4 moves this server-side untouched.
+ */
+export declare function executeRpcTool(rpcName: string, args: Record<string, unknown>, userId: string | undefined): Promise<AIToolExecutionResult>;
+//# sourceMappingURL=ai-tool-handlers.d.ts.map

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

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

package/dist/lib/apply-field-rules.d.ts

@@ -0,0 +1,4 @@
+import type { FieldDef, EntityFieldRules } from '../types/crud';
+/** Merge tenant field-rule overrides into static FieldDef[]. Pure & testable. */
+export declare function applyFieldRules(fields: FieldDef[], rules: EntityFieldRules | undefined): FieldDef[];
+//# sourceMappingURL=apply-field-rules.d.ts.map

package/dist/lib/apply-field-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-field-rules.d.ts","sourceRoot":"","sources":["../../src/lib/apply-field-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAE/D,iFAAiF;AACjF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,QAAQ,EAAE,EAClB,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,QAAQ,EAAE,CAOZ"}

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

@@ -0,0 +1,5 @@
+/** The agentic hand-off: queue a prompt that auto-sends (the click IS the send
+ *  intent) and flip the rail to the Chat tab. Shared by the Notes tab and any
+ *  plugin surface (e.g. a task's "Conversar com IA"). */
+export declare function useDelegateToAssistant(): (prompt: string) => void;
+//# sourceMappingURL=assistant-delegation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-delegation.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-delegation.ts"],"names":[],"mappings":"AAIA;;yDAEyD;AACzD,wBAAgB,sBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAUjE"}

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

@@ -0,0 +1,8 @@
+/**
+ * Entitlement key for the AI assistant.
+ *
+ * A plan gates it with `entitlements.features.assistant = false`; absent means
+ * open, so apps that never declare it keep the assistant.
+ */
+export declare const ASSISTANT_FEATURE = "assistant";
+//# sourceMappingURL=assistant-feature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-feature.d.ts","sourceRoot":"","sources":["../../src/lib/assistant-feature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAA"}

package/dist/lib/attachments.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Attachments for the assistant, parsed in the browser.
+ *
+ * The bytes NEVER leave this module. A spreadsheet of clients or patients is
+ * personal data (LGPD) — shipping it to a model provider to "have a look" is
+ * not a technical shortcut, it is a disclosure. So the file stays in the tab
+ * and only a DIGEST travels: the shape (sheets, headers, row count, inferred
+ * column types) plus a handful of sample rows. The model sees the FORM, never
+ * the data set.
+ *
+ * Everything here is therefore bounded on purpose: a 50k-row file and a 50-row
+ * file produce digests of roughly the same size.
+ */
+export type AttachmentKind = 'spreadsheet' | 'csv' | 'text' | 'image' | 'pdf' | 'binary';
+export type AttachmentColumnType = 'text' | 'number' | 'date' | 'boolean' | 'email' | 'phone';
+export interface AttachmentColumn {
+    name: string;
+    type: AttachmentColumnType;
+    /** Detected literal shape ('dd/mm/yyyy', 'yyyy-mm-dd', '1.234,56'), when known. */
+    format?: string;
+    /** Why this column is not the type it looks like — ambiguity, mixed values. */
+    note?: string;
+}
+export interface AttachmentSheet {
+    name: string;
+    headers: string[];
+    /** Data rows, header excluded. Absent when only the head of the file was read. */
+    rowCount?: number;
+    sample: string[][];
+    columnTypes: AttachmentColumn[];
+}
+export interface AttachmentDigest {
+    id: string;
+    name: string;
+    mime: string;
+    size: number;
+    kind: AttachmentKind;
+    /** Spreadsheets with more than one tab. Single-tab files use the flat fields. */
+    sheets?: AttachmentSheet[];
+    headers?: string[];
+    rowCount?: number;
+    sample?: string[][];
+    columnTypes?: AttachmentColumn[];
+    /** Head of a text/markdown file. */
+    preview?: string;
+    /** Everything the reader had to guess at, truncate or give up on. */
+    warnings?: string[];
+    /** Set when the file could not be opened at all — the chip says what to do
+     *  instead of pretending a shapeless digest is a reading. */
+    unreadable?: 'spreadsheet';
+}
+/** Park a file and get the handle everything else refers to it by. */
+export declare function registerAttachment(file: File): string;
+export declare function getAttachmentFile(id: string): File | undefined;
+export declare function getAttachmentDigest(id: string): AttachmentDigest | undefined;
+/** Drop the bytes. Called on chip removal and whenever the thread is cleared. */
+export declare function releaseAttachment(id: string): void;
+export declare function clearAttachmentRegistry(): void;
+/**
+ * The file a tool call is about, resolved the way the MODEL can name it.
+ *
+ * The prompt shows attachments by filename, never by handle, so a tool that
+ * demanded the registry id would be asking for something the model was never
+ * told. Name match first, then the most recent readable file — a turn almost
+ * always has exactly one.
+ */
+export declare function resolveAttachmentDigest(name?: string): AttachmentDigest | undefined;
+/**
+ * Every row of an attached delimited file, as objects keyed by header.
+ *
+ * The digest carries five sample rows — enough to map, useless to import. This
+ * re-reads the bytes still parked in the registry, so the full set never had to
+ * travel anywhere: it goes browser -> database, and the model never sees a row.
+ */
+export declare function readAllRows(digest: AttachmentDigest): Promise<Array<Record<string, string>>>;
+/** Every readable file currently in play, for an error that can name them. */
+export declare function listAttachmentNames(): string[];
+export declare function detectKind(file: File): AttachmentKind;
+/**
+ * Read a file into its digest. Registers the bytes when no id is supplied, so
+ * a caller that wants to show a "parsing" chip first can register up front and
+ * pass the id back in.
+ */
+export declare function parseAttachment(file: File, id?: string): Promise<AttachmentDigest>;
+/**
+ * Records are counted to the end of the text but only the first `SCAN_ROWS`
+ * are kept — the count is the fact worth reporting, the rows are not.
+ */
+export declare function parseDelimited(text: string, delimiter: string): {
+    rows: string[][];
+    count: number;
+};
+export declare function inferColumn(name: string, values: string[], sheetName?: string, warnings?: string[]): AttachmentColumn;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/lib/attachments.d.ts.map

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

package/dist/lib/auth-context.d.ts

@@ -0,0 +1,5 @@
+import type { AuthAdapter } from '../types/auth-adapter';
+export declare const AuthAdapterProvider: import("react").Provider<AuthAdapter | null>;
+export declare function useAuthAdapter(): AuthAdapter;
+export declare function useAuthAdapterOptional(): AuthAdapter | null;
+//# sourceMappingURL=auth-context.d.ts.map

package/dist/lib/auth-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../src/lib/auth-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,eAAO,MAAM,mBAAmB,8CAA8B,CAAA;AAE9D,wBAAgB,cAAc,IAAI,WAAW,CAM5C;AAED,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,IAAI,CAE3D"}

package/dist/lib/cache.d.ts

@@ -0,0 +1,18 @@
+export interface CacheStore {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, data: T, ttl?: number): void;
+    /** Clear all entries whose key starts with `prefix` */
+    invalidate(prefix: string): void;
+    clear(): void;
+    size(): number;
+}
+export interface CacheConfig {
+    /** Default time-to-live in ms (default: 60 000 — 1 minute) */
+    defaultTTL?: number;
+    /** Maximum cached entries before LRU eviction (default: 500) */
+    maxEntries?: number;
+}
+export declare function stableKey(...parts: unknown[]): string;
+export declare function createCacheStore(config?: CacheConfig): CacheStore;
+export declare const globalCache: CacheStore;
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;IAClC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChD,uDAAuD;IACvD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAgBD,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAErD;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAyDjE;AAMD,eAAO,MAAM,WAAW,YAAqB,CAAA"}

package/dist/lib/cn.d.ts

@@ -0,0 +1,2 @@
+export { cn } from '@fayz-ai/ui';
+//# sourceMappingURL=cn.d.ts.map

package/dist/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,49 @@
+import type { PluginAITool, PluginRegistryDef } from '../types/plugins';
+import type { EntityDef, FeatureDeclaration, PermissionProfile } from '@fayz-ai/core';
+import { type RegisteredEntity } from '@fayz-ai/core';
+/**
+ * Core SaaS-level AI tools — always available, no plugin required.
+ */
+export declare const coreAITools: PluginAITool[];
+export declare function registryToolName(pluginId: string, registryId: string): string;
+/**
+ * Auto-generates read tools from plugin registry definitions.
+ * Each registry gets a basic "list" tool so plugins get AI capabilities for free.
+ */
+export declare function generateRegistryTools(pluginId: string, registries: PluginRegistryDef[]): PluginAITool[];
+/**
+ * Formats a tool as a function signature: e.g. "getRevenue(period?)"
+ */
+export declare function formatToolSignature(tool: PluginAITool): string;
+export declare function entityToolName(entityKey: string): string;
+export declare function buildDataPrimitiveTools(input: {
+    entities: RegisteredEntity[];
+    registries: Map<string, PluginRegistryDef[]>;
+    queryEntities?: Array<{
+        key: string;
+        entity: EntityDef;
+        writable?: boolean;
+    }>;
+}): PluginAITool[];
+/**
+ * The action vocabulary a profile can grant. Same four the permission matrix
+ * renders — a role built in chat and a role built on the screen must be the
+ * same kind of object, or the matrix would show a grant it cannot express.
+ */
+export declare const PROFILE_ACTIONS: readonly ["read", "create", "edit", "delete"];
+/**
+ * The access-profile tool, built from the features the app actually declares.
+ *
+ * Written as ONE tool that takes the whole grant map rather than a
+ * create-then-add-permission sequence: asked to describe access in prose,
+ * gpt-4o-mini writes a plausible-sounding paragraph and stops — the schema is
+ * what makes it commit to real feature ids, and what lets the executor reject
+ * the ones it invented.
+ *
+ * What it CANNOT do is deliberate: the four actions here never include
+ * `manage_roles`, the grant that confers `manage_permissions`. A profile minted
+ * from chat can therefore never hand out permissions itself.
+ */
+export declare function buildPermissionTools(features: FeatureDeclaration[], profiles?: PermissionProfile[]): PluginAITool[];
+export declare function generateEntityTools(entities?: RegisteredEntity[]): PluginAITool[];
+//# sourceMappingURL=core-ai-tools.d.ts.map

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

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

package/dist/lib/create-client-orders-provider.d.ts

@@ -0,0 +1,3 @@
+import type { ClientOrdersProvider } from '../types/client-orders';
+export declare function createClientOrdersProvider(): ClientOrdersProvider;
+//# sourceMappingURL=create-client-orders-provider.d.ts.map

package/dist/lib/create-client-orders-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client-orders-provider.d.ts","sourceRoot":"","sources":["../../src/lib/create-client-orders-provider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAA0D,MAAM,wBAAwB,CAAA;AAiD1H,wBAAgB,0BAA0B,IAAI,oBAAoB,CAqEjE"}

package/dist/lib/csv.d.ts

@@ -0,0 +1,14 @@
+/** Column descriptor for generic CSV export */
+export interface CSVColumn {
+    key: string;
+    label: string;
+    format?: (value: any, row: Record<string, any>) => string;
+}
+export declare function escapeCSVField(value: unknown): string;
+/** Build a CSV string from columns + rows. Each cell runs through `column.format` if provided, then escaping. */
+export declare function buildCSV(columns: CSVColumn[], rows: Record<string, any>[]): string;
+/** Trigger a CSV file download in the browser. */
+export declare function downloadCSV(csv: string, filename: string): void;
+/** Convenience: build + download in one call. */
+export declare function exportCSV(columns: CSVColumn[], rows: Record<string, any>[], filename: string): void;
+//# sourceMappingURL=csv.d.ts.map

package/dist/lib/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAA;CAC1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOrD;AAED,iHAAiH;AACjH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAC1B,MAAM,CAYR;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC3B,QAAQ,EAAE,MAAM,GACf,IAAI,CAEN"}

package/dist/lib/currency.d.ts

@@ -0,0 +1,7 @@
+export interface CurrencyConfig {
+    code: string;
+    locale: string;
+    symbol: string;
+}
+export declare function formatCurrency(value: number, currency?: CurrencyConfig): string;
+//# sourceMappingURL=currency.d.ts.map

package/dist/lib/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../src/lib/currency.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAO/E"}

package/dist/lib/dedup.d.ts

@@ -0,0 +1,2 @@
+export declare function dedup<T>(key: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/lib/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/lib/dedup.ts"],"names":[],"mappings":"AAMA,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUtE"}

package/dist/lib/entity-registry.d.ts

@@ -0,0 +1,19 @@
+import type { FieldDef, EntityDef } from '../types/crud';
+import type { EntityArchetype } from '../types/entities';
+export interface RegisteredEntity {
+    entityKey: string;
+    label: string;
+    labelPlural: string;
+    icon: string;
+    fields: FieldDef[];
+    source: 'page' | 'plugin';
+    archetype?: EntityArchetype;
+    pluginId?: string;
+    pluginName?: string;
+    pluginIcon?: string;
+}
+export declare function deriveEntityKey(entityDef: EntityDef): string;
+export declare function registerEntity(entity: RegisteredEntity): void;
+export declare function getRegisteredEntities(): RegisteredEntity[];
+export declare function getEntityByKey(key: string): RegisteredEntity | undefined;
+//# sourceMappingURL=entity-registry.d.ts.map

package/dist/lib/entity-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-registry.d.ts","sourceRoot":"","sources":["../../src/lib/entity-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;IACzB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAQ5D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAExE"}

package/dist/lib/entity-routes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Global entity route registry.
+ *
+ * Populated once during buildNavigation() with mappings from
+ * "archetype:kind" (e.g. "person:staff") to the registered route path
+ * (e.g. "/registry/staff"). Used by PersonLink, command palette, and
+ * any component that needs to resolve an entity detail URL.
+ *
+ * An entry records whether the route can take an id: a CRUD page owns
+ * `/path/:id`, a hand-built page (the agenda) only has its list.
+ */
+export interface EntityRouteEntry {
+    path: string;
+    /** The route renders `${path}/${id}` as a detail view. */
+    detail: boolean;
+}
+/** Replace the entity route map (called once at app init by buildNavigation).
+ *  Accepts the legacy `Map<string, string>` shape (all detail-capable). */
+export declare function setEntityRouteMap(map: Map<string, EntityRouteEntry | string>): void;
+/**
+ * Resolve the route path for an entity given its archetype and kind.
+ * Returns the registered path (e.g. "/registry/staff") or null if not found.
+ *
+ * Tries "archetype:kind", then "archetype", then the entity key.
+ */
+export declare function resolveEntityRoute(archetype?: string, kind?: string, entityKey?: string): string | null;
+/** Whether the resolved route can show a single record, or only its list. */
+export declare function entityRouteHasDetail(archetype?: string, kind?: string, entityKey?: string): boolean;
+/**
+ * Build a full URL path for an entity detail page.
+ * Returns e.g. "/registry/staff/uuid" or "/registry/staff/uuid/schedule".
+ * Falls back to "/kind/uuid" if no route registered.
+ *
+ * A list-only route (a plugin page that shows these records but has no detail
+ * view) returns the bare path — appending an id there is a dead end.
+ */
+export declare function resolveEntityHref(id: string, archetype?: string, kind?: string, tab?: string, entityKey?: string): string;
+/** The href form — hash-prefixed, because the admin is a hash router. Use this
+ *  for links, `openEntity` for clicks. */
+export declare function resolveEntityAnchor(id: string, archetype?: string, kind?: string, tab?: string, entityKey?: string): string;
+/**
+ * Resolve a record's URL and go there — the only way a surface should open one.
+ * `resolveEntityHref` returns a plain admin path, and handing that to a generic
+ * router adapter assigns `location.href`: a full page load to a URL the app does
+ * not serve. The palette and the chat chips both got that wrong independently.
+ */
+export declare function openEntity(id: string, archetype?: string, kind?: string, tab?: string, entityKey?: string): void;
+//# sourceMappingURL=entity-routes.d.ts.map