@frankieai/core 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -45,8 +45,42 @@ declare const modelConfigSchema: z.ZodObject<{
     }>>;
     streamReasoning: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
+/** One selectable model in the (optional) end-user model picker. */
+declare const modelChoiceSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Optional, opt-in chat capabilities the SDK consumer turns on per workspace.
+ * Everything here is OFF by default: an embedded agent only gets a wider surface
+ * when the customer deliberately enables it.
+ */
+declare const featuresConfigSchema: 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>;
+}, z.core.$strip>>;
 declare const mcpServerSchema: z.ZodObject<{
     name: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     transport: z.ZodDefault<z.ZodEnum<{
         http: "http";
         sse: "sse";
@@ -62,6 +96,18 @@ declare const mcpServerSchema: z.ZodObject<{
  * This is the "no MCP server to write" path: point Frankie at a spec, name the
  * operations the agent may use, and it builds the tools at startup.
  */
+declare const apiCapabilitySchema: z.ZodObject<{
+    operationId: z.ZodString;
+    method: z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>;
+    path: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const apiSourceSchema: z.ZodObject<{
     name: z.ZodString;
     spec: z.ZodString;
@@ -75,6 +121,21 @@ declare const apiSourceSchema: z.ZodObject<{
         PATCH: "PATCH";
         DELETE: "DELETE";
     }>>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exposeAsMcp: z.ZodDefault<z.ZodBoolean>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodString;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        path: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     forwardUserTokenAs: z.ZodOptional<z.ZodString>;
     forwardUserClaims: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -188,6 +249,12 @@ declare const frankieConfigSchema: z.ZodObject<{
     }, z.core.$strip>;
     mcpServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         transport: z.ZodDefault<z.ZodEnum<{
             http: "http";
             sse: "sse";
@@ -210,6 +277,21 @@ declare const frankieConfigSchema: z.ZodObject<{
             PATCH: "PATCH";
             DELETE: "DELETE";
         }>>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exposeAsMcp: z.ZodDefault<z.ZodBoolean>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            operationId: z.ZodString;
+            method: z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                PATCH: "PATCH";
+                DELETE: "DELETE";
+            }>;
+            path: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
         forwardUserTokenAs: z.ZodOptional<z.ZodString>;
         forwardUserClaims: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -222,11 +304,31 @@ declare const frankieConfigSchema: z.ZodObject<{
         sessionsPerIpPerWindow: z.ZodDefault<z.ZodNumber>;
         turnTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, 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>;
+    }, 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 ModelConfig = z.infer<typeof modelConfigSchema>;
 type McpServerConfig = z.infer<typeof mcpServerSchema>;
+type ApiCapability = z.infer<typeof apiCapabilitySchema>;
 type ApiSourceConfig = z.infer<typeof apiSourceSchema>;
 type ToolPolicy = z.infer<typeof toolPolicySchema>;
 type AgentConfig = z.infer<typeof agentConfigSchema>;
@@ -296,6 +398,14 @@ type FrankieServerEvent = {
     type: "ping";
 };
 type FrankieErrorCode = "unauthorized" | "forbidden_origin" | "rate_limited" | "session_not_found" | "upstream_error" | "budget_exceeded" | "internal";
+/** A file the end user attached to a turn. `data` is base64 (no data-URL prefix). */
+interface ChatAttachment {
+    name: string;
+    /** MIME type, e.g. "image/png", "application/pdf", "text/csv". */
+    mimeType: string;
+    /** Base64-encoded file bytes. */
+    data: string;
+}
 /** Client -> server body for `POST /v1/chat`. */
 interface ChatRequestBody {
     /** Omit to start a new conversation; the server replies with a `session` event. */
@@ -307,6 +417,13 @@ interface ChatRequestBody {
      * as an instruction.
      */
     context?: Record<string, string | number | boolean | null>;
+    /**
+     * Model id to run this turn with. Honoured only when the workspace enables the
+     * model picker and the id is in its curated list; otherwise the default is used.
+     */
+    model?: string;
+    /** Files attached to this turn. Honoured only when attachments are enabled. */
+    attachments?: ChatAttachment[];
 }
 /** Client -> server body for `POST /v1/session`. */
 interface CreateSessionBody {
@@ -316,6 +433,8 @@ interface CreateSessionBody {
      */
     userToken?: string;
     context?: Record<string, string | number | boolean | null>;
+    /** Stable browser-generated id for a conversation that can resume on another device. */
+    conversationId?: string;
 }
 interface CreateSessionResponse {
     /** Short-lived bearer token scoped to this one chat session. */
@@ -344,6 +463,26 @@ interface PublicWidgetConfig {
     allowAnonymous: boolean;
     /** Show tool calls inline as they run. */
     showToolActivity: boolean;
+    /** Opt-in capabilities the widget should render (attachments, model picker). */
+    features: PublicFeatures;
+}
+/** The subset of `features` config the widget needs to render its controls. */
+interface PublicFeatures {
+    attachments: {
+        enabled: boolean;
+        /** Accepted MIME patterns for the file input, e.g. "image/*". */
+        accept: string[];
+        maxMb: number;
+        maxCount: number;
+    };
+    modelPicker: {
+        enabled: boolean;
+        /** Curated models the end user may choose from. */
+        models: {
+            id: string;
+            label: string;
+        }[];
+    };
 }
 interface WidgetTheme {
     /** CSS color for primary actions. Any valid CSS color string. */
@@ -374,4 +513,29 @@ declare function evaluateToolPolicy(toolName: string, policy: ToolPolicy): ToolD
 /** A short human label for a tool call, for the "Frankie is …" line in the UI. */
 declare function describeTool(toolName: string, input: unknown): string;
 
-export { type AgentConfig, type ApiSourceConfig, type AuthConfig, type BrandingConfig, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type LimitsConfig, type McpServerConfig, type ModelConfig, type PublicWidgetConfig, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, agentConfigSchema, apiSourceSchema, authConfigSchema, brandingConfigSchema, defineFrankieConfig, describeTool, evaluateToolPolicy, frankieConfigSchema, limitsConfigSchema, mcpServerSchema, modelConfigSchema, parseFrankieConfig, thinkingLevelSchema, toolPolicySchema, widgetThemeSchema };
+/** One installation plan for GitHub and the local CLI. Never includes credentials. */
+interface InstallProject {
+    files: Record<string, string>;
+    workspace: {
+        id: string;
+        name: string;
+        publishableKey: string;
+        allowAnonymous: boolean;
+    };
+    apiBaseUrl?: string;
+}
+interface InstallPlan {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    root: string;
+    chatPath: string;
+    specPath: string;
+    operationCount: number;
+    needsAuthSetup: boolean;
+    notes: string[];
+}
+declare function planHostedInstall(input: InstallProject): InstallPlan;
+
+export { type AgentConfig, type ApiCapability, type ApiSourceConfig, type AuthConfig, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type InstallPlan, type InstallProject, type LimitsConfig, type McpServerConfig, type ModelChoice, type ModelConfig, type PublicFeatures, type PublicWidgetConfig, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, agentConfigSchema, apiCapabilitySchema, apiSourceSchema, authConfigSchema, brandingConfigSchema, defineFrankieConfig, describeTool, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, limitsConfigSchema, mcpServerSchema, modelChoiceSchema, modelConfigSchema, parseFrankieConfig, planHostedInstall, thinkingLevelSchema, toolPolicySchema, widgetThemeSchema };

package/dist/index.d.ts

@@ -45,8 +45,42 @@ declare const modelConfigSchema: z.ZodObject<{
     }>>;
     streamReasoning: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
+/** One selectable model in the (optional) end-user model picker. */
+declare const modelChoiceSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Optional, opt-in chat capabilities the SDK consumer turns on per workspace.
+ * Everything here is OFF by default: an embedded agent only gets a wider surface
+ * when the customer deliberately enables it.
+ */
+declare const featuresConfigSchema: 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>;
+}, z.core.$strip>>;
 declare const mcpServerSchema: z.ZodObject<{
     name: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     transport: z.ZodDefault<z.ZodEnum<{
         http: "http";
         sse: "sse";
@@ -62,6 +96,18 @@ declare const mcpServerSchema: z.ZodObject<{
  * This is the "no MCP server to write" path: point Frankie at a spec, name the
  * operations the agent may use, and it builds the tools at startup.
  */
+declare const apiCapabilitySchema: z.ZodObject<{
+    operationId: z.ZodString;
+    method: z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>;
+    path: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const apiSourceSchema: z.ZodObject<{
     name: z.ZodString;
     spec: z.ZodString;
@@ -75,6 +121,21 @@ declare const apiSourceSchema: z.ZodObject<{
         PATCH: "PATCH";
         DELETE: "DELETE";
     }>>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exposeAsMcp: z.ZodDefault<z.ZodBoolean>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodString;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        path: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     forwardUserTokenAs: z.ZodOptional<z.ZodString>;
     forwardUserClaims: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -188,6 +249,12 @@ declare const frankieConfigSchema: z.ZodObject<{
     }, z.core.$strip>;
     mcpServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        discoveredTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         transport: z.ZodDefault<z.ZodEnum<{
             http: "http";
             sse: "sse";
@@ -210,6 +277,21 @@ declare const frankieConfigSchema: z.ZodObject<{
             PATCH: "PATCH";
             DELETE: "DELETE";
         }>>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        selectedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exposeAsMcp: z.ZodDefault<z.ZodBoolean>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            operationId: z.ZodString;
+            method: z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                PATCH: "PATCH";
+                DELETE: "DELETE";
+            }>;
+            path: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
         forwardUserTokenAs: z.ZodOptional<z.ZodString>;
         forwardUserClaims: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -222,11 +304,31 @@ declare const frankieConfigSchema: z.ZodObject<{
         sessionsPerIpPerWindow: z.ZodDefault<z.ZodNumber>;
         turnTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, 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>;
+    }, 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 ModelConfig = z.infer<typeof modelConfigSchema>;
 type McpServerConfig = z.infer<typeof mcpServerSchema>;
+type ApiCapability = z.infer<typeof apiCapabilitySchema>;
 type ApiSourceConfig = z.infer<typeof apiSourceSchema>;
 type ToolPolicy = z.infer<typeof toolPolicySchema>;
 type AgentConfig = z.infer<typeof agentConfigSchema>;
@@ -296,6 +398,14 @@ type FrankieServerEvent = {
     type: "ping";
 };
 type FrankieErrorCode = "unauthorized" | "forbidden_origin" | "rate_limited" | "session_not_found" | "upstream_error" | "budget_exceeded" | "internal";
+/** A file the end user attached to a turn. `data` is base64 (no data-URL prefix). */
+interface ChatAttachment {
+    name: string;
+    /** MIME type, e.g. "image/png", "application/pdf", "text/csv". */
+    mimeType: string;
+    /** Base64-encoded file bytes. */
+    data: string;
+}
 /** Client -> server body for `POST /v1/chat`. */
 interface ChatRequestBody {
     /** Omit to start a new conversation; the server replies with a `session` event. */
@@ -307,6 +417,13 @@ interface ChatRequestBody {
      * as an instruction.
      */
     context?: Record<string, string | number | boolean | null>;
+    /**
+     * Model id to run this turn with. Honoured only when the workspace enables the
+     * model picker and the id is in its curated list; otherwise the default is used.
+     */
+    model?: string;
+    /** Files attached to this turn. Honoured only when attachments are enabled. */
+    attachments?: ChatAttachment[];
 }
 /** Client -> server body for `POST /v1/session`. */
 interface CreateSessionBody {
@@ -316,6 +433,8 @@ interface CreateSessionBody {
      */
     userToken?: string;
     context?: Record<string, string | number | boolean | null>;
+    /** Stable browser-generated id for a conversation that can resume on another device. */
+    conversationId?: string;
 }
 interface CreateSessionResponse {
     /** Short-lived bearer token scoped to this one chat session. */
@@ -344,6 +463,26 @@ interface PublicWidgetConfig {
     allowAnonymous: boolean;
     /** Show tool calls inline as they run. */
     showToolActivity: boolean;
+    /** Opt-in capabilities the widget should render (attachments, model picker). */
+    features: PublicFeatures;
+}
+/** The subset of `features` config the widget needs to render its controls. */
+interface PublicFeatures {
+    attachments: {
+        enabled: boolean;
+        /** Accepted MIME patterns for the file input, e.g. "image/*". */
+        accept: string[];
+        maxMb: number;
+        maxCount: number;
+    };
+    modelPicker: {
+        enabled: boolean;
+        /** Curated models the end user may choose from. */
+        models: {
+            id: string;
+            label: string;
+        }[];
+    };
 }
 interface WidgetTheme {
     /** CSS color for primary actions. Any valid CSS color string. */
@@ -374,4 +513,29 @@ declare function evaluateToolPolicy(toolName: string, policy: ToolPolicy): ToolD
 /** A short human label for a tool call, for the "Frankie is …" line in the UI. */
 declare function describeTool(toolName: string, input: unknown): string;
 
-export { type AgentConfig, type ApiSourceConfig, type AuthConfig, type BrandingConfig, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type LimitsConfig, type McpServerConfig, type ModelConfig, type PublicWidgetConfig, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, agentConfigSchema, apiSourceSchema, authConfigSchema, brandingConfigSchema, defineFrankieConfig, describeTool, evaluateToolPolicy, frankieConfigSchema, limitsConfigSchema, mcpServerSchema, modelConfigSchema, parseFrankieConfig, thinkingLevelSchema, toolPolicySchema, widgetThemeSchema };
+/** One installation plan for GitHub and the local CLI. Never includes credentials. */
+interface InstallProject {
+    files: Record<string, string>;
+    workspace: {
+        id: string;
+        name: string;
+        publishableKey: string;
+        allowAnonymous: boolean;
+    };
+    apiBaseUrl?: string;
+}
+interface InstallPlan {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    root: string;
+    chatPath: string;
+    specPath: string;
+    operationCount: number;
+    needsAuthSetup: boolean;
+    notes: string[];
+}
+declare function planHostedInstall(input: InstallProject): InstallPlan;
+
+export { type AgentConfig, type ApiCapability, type ApiSourceConfig, type AuthConfig, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type InstallPlan, type InstallProject, type LimitsConfig, type McpServerConfig, type ModelChoice, type ModelConfig, type PublicFeatures, type PublicWidgetConfig, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, agentConfigSchema, apiCapabilitySchema, apiSourceSchema, authConfigSchema, brandingConfigSchema, defineFrankieConfig, describeTool, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, limitsConfigSchema, mcpServerSchema, modelChoiceSchema, modelConfigSchema, parseFrankieConfig, planHostedInstall, thinkingLevelSchema, toolPolicySchema, widgetThemeSchema };