@frankieai/core 0.2.4 → 0.2.6

package/dist/index.d.cts

@@ -95,6 +95,10 @@ declare const featuresConfigSchema: z.ZodPrefault<z.ZodObject<{
     }, z.core.$strip>>;
     workspaceAdmin: z.ZodDefault<z.ZodBoolean>;
     configurationAssistant: z.ZodDefault<z.ZodBoolean>;
+    escalation: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        webhookUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>>;
 declare const mcpServerSchema: z.ZodObject<{
     name: z.ZodString;
@@ -104,6 +108,7 @@ declare const mcpServerSchema: z.ZodObject<{
     discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     transport: z.ZodDefault<z.ZodEnum<{
         http: "http";
@@ -131,6 +136,7 @@ declare const apiCapabilitySchema: z.ZodObject<{
     }>;
     path: z.ZodString;
     summary: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodString>;
     authGap: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const apiSourceSchema: z.ZodObject<{
@@ -165,6 +171,7 @@ declare const apiSourceSchema: z.ZodObject<{
         }>;
         path: z.ZodString;
         summary: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodString>;
         authGap: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -180,14 +187,35 @@ declare const toolPolicySchema: z.ZodObject<{
     denyByDefault: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 /**
- * A starter card shown on the empty chat screen: a title and short description
- * the reader sees, and the message that is sent as if they typed it when they
- * click the card. Configured per workspace in the dashboard's Appearance tab.
+ * The icons a starter card may use, shared by the dashboard picker and the SDK
+ * so the choices stay in step. Each maps to a concrete icon in the widget.
+ */
+declare const STARTER_PROMPT_ICONS: readonly ["sparkles", "wand", "book", "chat", "chart", "bolt", "music", "mic", "image", "compass", "lightbulb", "file"];
+type StarterPromptIcon = (typeof STARTER_PROMPT_ICONS)[number];
+/**
+ * A starter card shown on the empty chat screen: an icon, a title and short
+ * description the reader sees, and the message that is sent as if they typed it
+ * when they click the card. Configured per workspace in the dashboard's
+ * Appearance tab.
  */
 declare const starterPromptSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     message: z.ZodString;
+    icon: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        sparkles: "sparkles";
+        wand: "wand";
+        book: "book";
+        chat: "chat";
+        chart: "chart";
+        bolt: "bolt";
+        music: "music";
+        mic: "mic";
+        image: "image";
+        compass: "compass";
+        lightbulb: "lightbulb";
+    }>>;
 }, z.core.$strip>;
 declare const agentConfigSchema: z.ZodObject<{
     systemPrompt: z.ZodDefault<z.ZodString>;
@@ -197,6 +225,20 @@ declare const agentConfigSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         message: z.ZodString;
+        icon: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            sparkles: "sparkles";
+            wand: "wand";
+            book: "book";
+            chat: "chat";
+            chart: "chart";
+            bolt: "bolt";
+            music: "music";
+            mic: "mic";
+            image: "image";
+            compass: "compass";
+            lightbulb: "lightbulb";
+        }>>;
     }, z.core.$strip>>>;
     maxTurns: z.ZodDefault<z.ZodNumber>;
     maxBudgetUsd: z.ZodOptional<z.ZodNumber>;
@@ -234,6 +276,107 @@ declare const brandingConfigSchema: z.ZodObject<{
     avatarUrl: z.ZodOptional<z.ZodString>;
     launcherLabel: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Knowledge base: documentation the agent answers from. Each source is an entry
+ * URL Frankie crawls (same-origin, bounded) to build a semantic index; the
+ * chunks + embeddings live in the knowledge store, not in this config. Enabling
+ * it gives the agent a `frankie__docs__search` tool and grounds its answers.
+ */
+declare const knowledgeSourceSchema: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+declare const knowledgeBaseSchema: z.ZodPrefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    maxPages: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * An additional embedded agent on the same workspace. Frankie is one-agent-per
+ * publishable-key: a persona carries its OWN key, so the data plane still
+ * resolves one key to one agent (see `resolvePersonaConfig`). A persona overrides
+ * the distinct slice of a config — its branding, agent copy, capabilities and
+ * knowledge base — while sharing the workspace's auth, model, origins and tools.
+ * `pagePatterns` says which routes the persona shows on (e.g. support on "/",
+ * docs on "/docs/**"). It is served in `/v1/config` as `pages`, and the
+ * generated `FrankieAgents` mount reads it at runtime, so changing it never
+ * needs a new install PR.
+ */
+declare const personaProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    publishableKey: z.ZodString;
+    pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+    branding: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        launcherLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodPrefault<z.ZodObject<{
+        systemPrompt: z.ZodDefault<z.ZodString>;
+        greeting: z.ZodDefault<z.ZodString>;
+        suggestedPrompts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        starterPrompts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            icon: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                sparkles: "sparkles";
+                wand: "wand";
+                book: "book";
+                chat: "chat";
+                chart: "chart";
+                bolt: "bolt";
+                music: "music";
+                mic: "mic";
+                image: "image";
+                compass: "compass";
+                lightbulb: "lightbulb";
+            }>>;
+        }, z.core.$strip>>>;
+        maxTurns: z.ZodDefault<z.ZodNumber>;
+        maxBudgetUsd: z.ZodOptional<z.ZodNumber>;
+        tools: z.ZodPrefault<z.ZodObject<{
+            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            denyByDefault: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        showToolActivity: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    features: z.ZodPrefault<z.ZodObject<{
+        attachments: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accept: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            maxMb: z.ZodDefault<z.ZodNumber>;
+            maxCount: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        modelPicker: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            models: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        workspaceAdmin: z.ZodDefault<z.ZodBoolean>;
+        configurationAssistant: z.ZodDefault<z.ZodBoolean>;
+        escalation: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            webhookUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    knowledgeBase: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strip>>>;
+        maxPages: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 declare const frankieConfigSchema: z.ZodObject<{
     tenantId: z.ZodString;
     branding: z.ZodPrefault<z.ZodObject<{
@@ -286,6 +429,20 @@ declare const frankieConfigSchema: z.ZodObject<{
             title: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             message: z.ZodString;
+            icon: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                sparkles: "sparkles";
+                wand: "wand";
+                book: "book";
+                chat: "chat";
+                chart: "chart";
+                bolt: "bolt";
+                music: "music";
+                mic: "mic";
+                image: "image";
+                compass: "compass";
+                lightbulb: "lightbulb";
+            }>>;
         }, z.core.$strip>>>;
         maxTurns: z.ZodDefault<z.ZodNumber>;
         maxBudgetUsd: z.ZodOptional<z.ZodNumber>;
@@ -319,6 +476,7 @@ declare const frankieConfigSchema: z.ZodObject<{
         discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            inputs: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         transport: z.ZodDefault<z.ZodEnum<{
             http: "http";
@@ -361,6 +519,7 @@ declare const frankieConfigSchema: z.ZodObject<{
             }>;
             path: z.ZodString;
             summary: z.ZodOptional<z.ZodString>;
+            inputs: z.ZodOptional<z.ZodString>;
             authGap: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
         headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -405,12 +564,99 @@ declare const frankieConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         workspaceAdmin: z.ZodDefault<z.ZodBoolean>;
         configurationAssistant: z.ZodDefault<z.ZodBoolean>;
+        escalation: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            webhookUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
+    knowledgeBase: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strip>>>;
+        maxPages: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    personas: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        publishableKey: z.ZodString;
+        pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+        branding: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            tagline: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+            launcherLabel: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        agent: z.ZodPrefault<z.ZodObject<{
+            systemPrompt: z.ZodDefault<z.ZodString>;
+            greeting: z.ZodDefault<z.ZodString>;
+            suggestedPrompts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            starterPrompts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                message: z.ZodString;
+                icon: z.ZodOptional<z.ZodEnum<{
+                    file: "file";
+                    sparkles: "sparkles";
+                    wand: "wand";
+                    book: "book";
+                    chat: "chat";
+                    chart: "chart";
+                    bolt: "bolt";
+                    music: "music";
+                    mic: "mic";
+                    image: "image";
+                    compass: "compass";
+                    lightbulb: "lightbulb";
+                }>>;
+            }, z.core.$strip>>>;
+            maxTurns: z.ZodDefault<z.ZodNumber>;
+            maxBudgetUsd: z.ZodOptional<z.ZodNumber>;
+            tools: z.ZodPrefault<z.ZodObject<{
+                allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                denyByDefault: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            showToolActivity: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        features: z.ZodPrefault<z.ZodObject<{
+            attachments: z.ZodPrefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                accept: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                maxMb: z.ZodDefault<z.ZodNumber>;
+                maxCount: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>;
+            modelPicker: z.ZodPrefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                models: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            workspaceAdmin: z.ZodDefault<z.ZodBoolean>;
+            configurationAssistant: z.ZodDefault<z.ZodBoolean>;
+            escalation: z.ZodPrefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                webhookUrl: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        knowledgeBase: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+            }, z.core.$strip>>>;
+            maxPages: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type ThinkingLevel = z.infer<typeof thinkingLevelSchema>;
 type WidgetThemeConfig = z.infer<typeof widgetThemeSchema>;
 type ModelChoice = z.infer<typeof modelChoiceSchema>;
 type FeaturesConfig = z.infer<typeof featuresConfigSchema>;
+type KnowledgeBaseConfig = z.infer<typeof knowledgeBaseSchema>;
 type ModelConfig = z.infer<typeof modelConfigSchema>;
 type McpServerConfig = z.infer<typeof mcpServerSchema>;
 type ApiCapability = z.infer<typeof apiCapabilitySchema>;
@@ -420,11 +666,30 @@ type AgentConfig = z.infer<typeof agentConfigSchema>;
 type AuthConfig = z.infer<typeof authConfigSchema>;
 type LimitsConfig = z.infer<typeof limitsConfigSchema>;
 type BrandingConfig = z.infer<typeof brandingConfigSchema>;
+type PersonaProfile = z.infer<typeof personaProfileSchema>;
 type FrankieConfig = z.infer<typeof frankieConfigSchema>;
 type FrankieConfigInput = z.input<typeof frankieConfigSchema>;
 declare function parseFrankieConfig(input: unknown): FrankieConfig;
 /** Helper for `frankie.config.ts` files — gives editors full completion. */
 declare function defineFrankieConfig(config: FrankieConfigInput): FrankieConfigInput;
+/**
+ * Flatten a stored config to the single-agent config that a publishable key
+ * selects. The base key returns the config unchanged (the primary persona). A
+ * persona key returns a config carrying that persona's branding/agent/features/
+ * knowledgeBase, its key, and no further personas — so every *resolved* config is
+ * still exactly one agent, preserving the one-key-one-agent invariant. An unknown
+ * key returns null.
+ */
+declare function resolvePersonaConfig(config: FrankieConfig, publishableKey: string): FrankieConfig | null;
+/**
+ * Whether a Next.js `usePathname()` value matches an App-Router path glob:
+ * `**` matches any depth (including `/`), `*` matches within one segment, and a
+ * trailing `/**` also matches the base path itself (`/docs/**` matches `/docs`).
+ * Everything else is literal and case-sensitive.
+ */
+declare function matchesPagePattern(pathname: string, pattern: string): boolean;
+/** True when `pathname` matches any pattern, or when there are none (host decides). */
+declare function matchesAnyPagePattern(pathname: string, patterns: readonly string[]): boolean;
 
 /**
  * The wire protocol between the embedded widget and the Frankie server.
@@ -614,6 +879,8 @@ interface StarterPrompt {
     title: string;
     description?: string;
     message: string;
+    /** One of STARTER_PROMPT_ICONS; the widget maps it to a concrete icon. */
+    icon?: string;
 }
 /** The subset of tenant config the widget is allowed to see. */
 interface PublicWidgetConfig {
@@ -635,6 +902,8 @@ interface PublicWidgetConfig {
     showToolActivity: boolean;
     /** Opt-in capabilities the widget should render (attachments, model picker). */
     features: PublicFeatures;
+    /** App-Router path globs this agent shows on; empty = every page no other agent claims. Optional so older servers stay compatible. */
+    pages?: string[];
 }
 /** The subset of `features` config the widget needs to render its controls. */
 interface PublicFeatures {
@@ -686,9 +955,48 @@ interface ToolDecision {
  * also allows every tool on the `acme` server.
  */
 declare function evaluateToolPolicy(toolName: string, policy: ToolPolicy): ToolDecision;
+/**
+ * The agent-harness tool a skill-following agent calls to announce which
+ * reviewed workspace skill it is about to apply. It grants no permissions and
+ * does nothing on its own — it exists so a skill shows up in the transcript like
+ * any other tool call, instead of being followed invisibly.
+ */
+declare const SKILL_TOOL_NAME = "frankie__use_skill";
 /** A short human label for a tool call, for the "Frankie is …" line in the UI. */
 declare function describeTool(toolName: string, input: unknown): string;
 
+/** The public env var a persona's publishable key lives in. */
+declare function personaEnvKey(personaId: string): string;
+/**
+ * The agents every generated mount lists, ahead of the workspace's own custom
+ * ones. Listing them even before they exist means turning one on later is an
+ * environment variable, not another pull request.
+ */
+declare const STANDARD_AGENT_IDS: readonly ["support", "docs"];
+/** The persona ids a generated mount lists, in priority order: the standard ones, then custom ones alphabetically. */
+declare function installAgentIds(personaIds?: string[]): string[];
+/**
+ * The install branch for a workspace, or one of its personas. One commit,
+ * `<sha8>`-suffixed so a re-run on a new base opens a fresh PR. A persona is
+ * joined with `--` so workspace `acme` + persona `support` never shares a
+ * branch with workspace `acme-support`.
+ */
+declare function installBranch(workspaceId: string, baseSha: string, personaId?: string): string;
+/**
+ * A workspace-supplied name (workspace, agent label, page pattern) made safe
+ * to drop into a PR body or committed Markdown: one line, no markup that
+ * could add links, images, code or headings under the installer's name.
+ */
+declare function plainText(value: string, max?: number): string;
+/** The install PR title: plain for the primary agent, suffixed with the persona's label otherwise. */
+declare function installTitle(personaLabel?: string): string;
+/**
+ * Whether an open PR's head ref is the install branch for this
+ * workspace/persona — used to adopt a PR a prior run opened. The anchored
+ * 8-hex suffix keeps a persona branch from matching the primary and vice
+ * versa; a persona also matches the older single-dash form.
+ */
+declare function matchesInstallBranch(ref: string, workspaceId: string, personaId?: string): boolean;
 /** One installation plan for GitHub and the local CLI. Never includes credentials. */
 interface InstallProject {
     files: Record<string, string>;
@@ -699,12 +1007,31 @@ interface InstallProject {
         allowAnonymous: boolean;
     };
     apiBaseUrl?: string;
+    /**
+     * The agent this PR is for, when it is a persona (Support, Docs, a custom
+     * one) rather than the product agent. It only changes what else the PR
+     * carries: every PR writes the same `FrankieAgents` mount, so a persona PR
+     * and a product PR opened together never conflict. The key stays in the
+     * environment, never here.
+     */
+    persona?: {
+        id: string;
+        label: string;
+        publishableKey?: string;
+        pagePatterns?: string[];
+        envKey?: string;
+    };
+    /** Every persona id on the workspace, so the mount lists the custom ones too. */
+    agents?: string[];
 }
 interface InstallPlan {
+    /** Files to write. Files whose content would not change are left out. */
     files: Array<{
         path: string;
         content: string;
     }>;
+    /** Frankie's own superseded files to remove. */
+    deletions: string[];
     root: string;
     chatPath: string;
     specPath: string;
@@ -718,9 +1045,52 @@ declare function assertNoCommittedFrankieKeys(files: Array<{
     path: string;
     content: string;
 }>): void;
+/**
+ * Plan the files for an install PR.
+ *
+ * Every agent (product, support, docs, custom) mounts from one generated
+ * client component, `<app>/frankie/FrankieAgents.tsx`, rendered once in the
+ * root layout. It lists each agent by its own env var, turns an agent on only
+ * when that key is set, and reads each agent's pages from `/v1/config` at
+ * runtime. Its content depends only on the repository and the workspace — not
+ * on which agent the PR is for — so the shared files (mount, layout edit,
+ * package.json, .env.example, health route) are byte-identical in every PR,
+ * and any two install PRs merge cleanly in either order.
+ */
 declare function planHostedInstall(input: InstallProject): InstallPlan;
 /** Where the generated token endpoint gets the signed-in user from. */
 type AuthStrategy = "firebase" | "nextauth" | "supabase" | "custom" | "existing" | "anonymous" | "unconfigured";
+/**
+ * Where a new import may go in a module: after the directive prologue, any
+ * leading comments and the existing imports (multi-line ones included), and
+ * never above a `"use client"`. A directive is only a directive while it is the
+ * first statement — an import placed ahead of it turns it into a no-op string,
+ * and the layout silently stops being a client component.
+ */
+declare function insertImport(source: string, importLine: string): string;
+/**
+ * Adds `<FrankieWidgetMount />` (or another component) just inside the layout's `</body>` (else
+ * `</main>`, else after `{children}`), indented like the line it joins so the
+ * change is one clean line in the PR and a formatter check does not fail on it.
+ */
+declare function mountWidget(layout: string, component?: string): string | undefined;
+/**
+ * The manifest's dependencies with Frankie's added — keeping an entry the
+ * project already pins, and keeping alphabetical order when the project keeps
+ * it (as npm and pnpm write it), so the PR's diff is the added lines only.
+ */
+declare function withDependencies(current: Record<string, string> | undefined, added: Record<string, string>): Record<string, string>;
+/** JSON written the way the file already was: its indentation (tabs or spaces) and its final newline. */
+declare function renderJson(value: unknown, original: string | undefined): string;
+/**
+ * How a generated file imports a module under the app's source root
+ * (`lib/frankie-auth`, `auth`, …). The repo's own `tsconfig.json` decides:
+ * whichever `paths` alias maps onto the source root is used (`@/`, `~/`,
+ * `@src/`…); with a tsconfig that declares no such alias the import is
+ * relative, which resolves everywhere. Without a tsconfig to read, `@/` stands —
+ * Next.js's own default — rather than a guess at a relative layout.
+ */
+declare function moduleImporter(files: Record<string, string>, root: string, sourceRoot: string): (fromFile: string, module: string) => string;
 
 declare const skillSchema: z.ZodObject<{
     id: z.ZodString;
@@ -751,6 +1121,7 @@ declare function approvedSkillTools(config: FrankieConfig): string[];
 declare function toolDescriptions(config: FrankieConfig, toolIds: string[]): Array<{
     id: string;
     description: string;
+    inputs?: string;
 }>;
 /**
  * Starter suggestion prompts derived from the workspace's own published,
@@ -768,7 +1139,7 @@ declare function suggestedPromptsFromSkills(config: FrankieConfig): string[];
 /**
  * Deterministic starter for the manual editor — not a claim that anything
  * was executed, and not model-generated. Follows the same structure asked of
- * AI-generated instructions (trigger recap, required inputs, numbered steps,
+ * AI-generated instructions (trigger recap, required inputs, quality bar, numbered steps,
  * reporting, error handling) so a hand-written skill starts from a useful
  * shape instead of a blank textarea. `label` is each tool's own description
  * when the caller has one (e.g. from the dashboard's approved-tools list);
@@ -807,4 +1178,38 @@ declare function compareApiDocuments(before: ApiDocument, after: ApiDocument): {
     unchangedIds: string[];
 };
 
-export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InstallPlan, type InstallProject, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PublicFeatures, type PublicWidgetConfig, type StarterPrompt, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, limitsConfigSchema, matchPath, mcpServerSchema, modelChoiceSchema, modelConfigSchema, operationId, parseFrankieConfig, planHostedInstall, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema };
+/**
+ * Suggest a widget theme from a repository's own styling, at install time.
+ *
+ * Reads what a Next.js app already declares — CSS custom properties on `:root`
+ * (shadcn/ui, Tailwind v4 `@theme`), the Tailwind config's colors, the
+ * `themeColor` metadata and the web app manifest — and normalizes the colors it
+ * can read to `#rrggbb`. Like the rest of the installer it is regex over source:
+ * nothing is executed, and anything it can't read with confidence is left out
+ * rather than guessed. The result is a *suggestion* the dashboard asks the user
+ * to accept; it never replaces a theme someone chose.
+ */
+interface InferredTheme {
+    /** Always carries a brand color: without one there is nothing to suggest. */
+    theme: {
+        primary: string;
+        background?: string;
+        foreground?: string;
+        radius?: string;
+    };
+    /** Where each value came from, for the "suggested from your repo" explanation. */
+    sources: Array<{
+        field: "primary" | "background" | "foreground" | "radius";
+        path: string;
+    }>;
+}
+/** Normalize a CSS color to `#rrggbb`, or undefined when it isn't one we can read confidently. */
+declare function normalizeColor(raw: string): string | undefined;
+/**
+ * Infer a theme from repository files (path → content). `root` scopes the search
+ * to one app in a monorepo ("" for the repository root). Returns undefined when
+ * no brand color can be read — a background alone is not a theme.
+ */
+declare function inferTheme(files: Record<string, string>, root?: string): InferredTheme | undefined;
+
+export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InferredTheme, type InstallPlan, type InstallProject, type KnowledgeBaseConfig, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PersonaProfile, type PublicFeatures, type PublicWidgetConfig, SKILL_TOOL_NAME, STANDARD_AGENT_IDS, STARTER_PROMPT_ICONS, type StarterPrompt, type StarterPromptIcon, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, inferTheme, insertImport, installAgentIds, installBranch, installTitle, knowledgeBaseSchema, knowledgeSourceSchema, limitsConfigSchema, matchPath, matchesAnyPagePattern, matchesInstallBranch, matchesPagePattern, mcpServerSchema, modelChoiceSchema, modelConfigSchema, moduleImporter, mountWidget, normalizeColor, operationId, parseFrankieConfig, personaEnvKey, personaProfileSchema, plainText, planHostedInstall, renderJson, resolvePersonaConfig, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema, withDependencies };