sweagent 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1816 @@
+import * as ai from 'ai';
+import { LanguageModelUsage, ModelMessage, Tool, FinishReason } from 'ai';
+export { FinishReason, LanguageModelUsage, ModelMessage, Tool, ToolExecutionOptions, jsonSchema, tool } from 'ai';
+import { z } from 'zod';
+
+/**
+ * Custom error classes for the library
+ */
+/**
+ * Base error class for all library errors
+ */
+declare class LibraryError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when model operations fail
+ */
+declare class ModelError extends LibraryError {
+    readonly provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined, cause?: Error);
+}
+/**
+ * Error thrown when tool execution fails
+ */
+declare class ToolError extends LibraryError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined, cause?: Error);
+}
+/**
+ * Error thrown when tool input validation fails
+ */
+declare class ValidationError extends LibraryError {
+    readonly errors?: unknown[] | undefined;
+    constructor(message: string, errors?: unknown[] | undefined);
+}
+/**
+ * Error thrown when agent execution fails
+ */
+declare class AgentError extends LibraryError {
+    readonly iteration?: number | undefined;
+    constructor(message: string, iteration?: number | undefined, cause?: Error);
+}
+/**
+ * Error thrown when subagent execution fails
+ */
+declare class SubagentError extends LibraryError {
+    readonly subagentName?: string | undefined;
+    constructor(message: string, subagentName?: string | undefined, cause?: Error);
+}
+
+/**
+ * Common types shared across modules
+ * Re-exports AI SDK message types; keeps sweagent-specific ImageInput and Logger
+ */
+
+/**
+ * Image input for vision models
+ */
+interface ImageInput {
+    /** Base64-encoded image data */
+    base64: string;
+    /** MIME type of the image */
+    mimeType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+    /** Optional path to the source file */
+    path?: string;
+}
+/**
+ * Logger interface for pluggable logging
+ */
+interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, error?: Error | Record<string, unknown>): void;
+}
+
+/**
+ * Simple logger with optional prefix and progress support
+ */
+
+/**
+ * Log levels
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger configuration
+ */
+interface LoggerConfig {
+    /** Prefix for all log messages */
+    prefix?: string;
+    /** Minimum log level to output */
+    level?: LogLevel;
+    /** Whether to output timestamps */
+    timestamps?: boolean;
+}
+/**
+ * Create a logger with the given configuration
+ */
+declare function createLogger(config?: LoggerConfig): Logger;
+
+/**
+ * Utility functions
+ */
+
+/**
+ * Sum token usage from multiple steps (AI SDK LanguageModelUsage)
+ */
+declare function sumTokenUsage(usages: (LanguageModelUsage | undefined)[]): LanguageModelUsage;
+
+/**
+ * Model-related types
+ * Uses AI SDK types for messages, tools, usage, and result shape
+ */
+
+/**
+ * Tool type for model invocation
+ * Uses the default Tool type which accepts any input/output schema
+ */
+type ModelTool = Tool;
+/**
+ * Supported model providers
+ */
+type ModelProvider = 'openai' | 'anthropic' | 'google';
+/**
+ * Configuration for creating a model
+ */
+interface ModelConfig {
+    /** The provider to use */
+    provider: ModelProvider;
+    /** The model name/ID */
+    model: string;
+    /** API key (optional, uses environment variable by default) */
+    apiKey?: string;
+    /** Temperature for generation (0-1) */
+    temperature?: number;
+    /** Maximum output tokens to generate */
+    maxOutputTokens?: number;
+    /** Base URL for the API (optional) */
+    baseUrl?: string;
+}
+/**
+ * Tool call shape returned by the model (AI SDK compatible)
+ */
+interface ModelToolCall {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+/**
+ * Options for model invocation
+ */
+interface InvokeOptions {
+    /** Tools the model can call */
+    tools?: Record<string, ModelTool>;
+    /** Maximum output tokens to generate */
+    maxOutputTokens?: number;
+    /** Temperature for generation */
+    temperature?: number;
+    /** Stop sequences */
+    stop?: string[];
+}
+/**
+ * Options for vision generation
+ */
+interface VisionOptions extends InvokeOptions {
+    /** System prompt */
+    systemPrompt?: string;
+    /** Detail level for image analysis */
+    detail?: 'low' | 'high' | 'auto';
+}
+/**
+ * Response from a model invocation (AI SDK GenerateTextResult subset)
+ */
+interface ModelResponse {
+    /** The generated text */
+    text: string;
+    /** Tool calls if any were made */
+    toolCalls: ModelToolCall[];
+    /** Token usage */
+    usage: LanguageModelUsage;
+    /** The finish reason */
+    finishReason: FinishReason;
+}
+/**
+ * A model instance that can generate responses
+ */
+interface Model {
+    /** The provider of this model */
+    provider: ModelProvider;
+    /** The model name */
+    modelName: string;
+    /**
+     * Invoke the model with messages (AI SDK ModelMessage[])
+     */
+    invoke(messages: ModelMessage[], options?: InvokeOptions): Promise<ModelResponse>;
+    /**
+     * Generate a response with vision (images)
+     */
+    generateVision(prompt: string, images: ImageInput[], options?: VisionOptions): Promise<ModelResponse>;
+}
+
+/**
+ * Tool-related types
+ * Re-exports AI SDK Tool, tool, jsonSchema, ToolExecutionOptions; keeps ToolConfig and ToolContext for defineTool
+ */
+
+/**
+ * Configuration for defining a tool (input to defineTool)
+ */
+interface ToolConfig<TInput extends z.ZodType = z.ZodType, TOutput = unknown> {
+    /** Unique name for the tool */
+    name: string;
+    /** Description of what the tool does */
+    description: string;
+    /** Zod schema for input validation */
+    input: TInput;
+    /** The handler function that executes the tool */
+    handler: (input: z.infer<TInput>, context?: ToolContext) => Promise<TOutput>;
+}
+/**
+ * Logger interface for tool context
+ */
+interface ToolLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, error?: Error | Record<string, unknown>): void;
+}
+/**
+ * Context passed to tool handlers
+ */
+interface ToolContext {
+    /** Optional model for tools that need AI capabilities */
+    model?: {
+        invoke: (...args: unknown[]) => Promise<unknown>;
+    };
+    /** Optional logger */
+    logger?: ToolLogger;
+    /** Additional custom context */
+    [key: string]: unknown;
+}
+/**
+ * Result of tool execution (for executeTool / executeToolByName)
+ */
+interface ToolExecutionResult<T = unknown> {
+    success: boolean;
+    output?: T;
+    error?: string;
+}
+
+/**
+ * Agent-related types
+ * Uses AI SDK types for messages, tool calls/results, and usage
+ */
+
+/**
+ * Tool type for agent context
+ * Uses the default Tool type which accepts any input/output schema
+ */
+type AgentTool = Tool;
+/**
+ * Tool result shape (AI SDK compatible)
+ */
+interface AgentToolResult {
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    isError?: boolean;
+}
+/**
+ * Configuration for running an agent
+ */
+interface AgentConfig {
+    /** The model to use for generation */
+    model: Model;
+    /** Tools available to the agent */
+    tools: Record<string, AgentTool>;
+    /** System prompt for the agent */
+    systemPrompt: string;
+    /** The user's input/query */
+    input: string;
+    /** Maximum number of iterations (tool call rounds) */
+    maxIterations?: number;
+    /** Callback for each step */
+    onStep?: (step: AgentStep) => void;
+}
+/**
+ * A single step in the agent's execution
+ */
+interface AgentStep {
+    /** The iteration number (0-indexed) */
+    iteration: number;
+    /** The model's response text (if any) */
+    content?: string;
+    /** Tool calls made in this step (AI SDK shape) */
+    toolCalls?: ModelToolCall[];
+    /** Results from tool executions (AI SDK shape) */
+    toolResults?: AgentToolResult[];
+    /** Token usage for this step */
+    usage?: LanguageModelUsage;
+}
+/**
+ * Result of running an agent
+ */
+interface AgentResult {
+    /** The final output from the agent */
+    output: string;
+    /** All steps taken during execution */
+    steps: AgentStep[];
+    /** Total token usage across all steps */
+    totalUsage?: LanguageModelUsage;
+    /** The full message history (ModelMessage[]) */
+    messages: ModelMessage[];
+}
+
+/**
+ * Subagent-related types
+ * Specialized agents with custom prompts, tool restrictions, and isolated context
+ */
+
+/**
+ * Configuration for defining a subagent (input to defineSubagent)
+ */
+interface SubagentConfig {
+    /** Unique identifier (kebab-case) */
+    name: string;
+    /** When the parent agent should delegate to this subagent */
+    description: string;
+    /** The subagent's system prompt */
+    systemPrompt: string;
+    /** Allowed tools; if omitted, subagent inherits parent's tools (minus disallowedTools) */
+    tools?: Record<string, AgentTool>;
+    /** Tools to deny from inherited set */
+    disallowedTools?: string[];
+    /** Model override; if omitted, subagent uses parent's model */
+    model?: ModelConfig;
+    /** Maximum iterations; defaults to 10 */
+    maxIterations?: number;
+    /** Callback for each step */
+    onStep?: (step: AgentStep) => void;
+}
+/**
+ * Validated subagent definition (returned by defineSubagent)
+ */
+interface SubagentDefinition extends SubagentConfig {
+    /** Same as name; present for convenience */
+    name: string;
+}
+/**
+ * Result of running a subagent (extends AgentResult)
+ */
+interface SubagentResult extends AgentResult {
+    /** Which subagent produced this result */
+    subagentName: string;
+}
+
+/**
+ * Agent loop: model + tools, AI SDK message shapes
+ */
+
+/**
+ * Run an agent with the given configuration.
+ *
+ * 1. Calls the model with ModelMessage[] and tools
+ * 2. If no tool calls, returns the response
+ * 3. If tool calls, executes them and appends assistant + tool messages (AI SDK shape)
+ * 4. Repeats until done or max iterations reached
+ *
+ * @example
+ * ```typescript
+ * const result = await runAgent({
+ *   model: createModel({ provider: 'openai', model: 'gpt-4o' }),
+ *   tools: createToolSet({ search: searchTool, calculator: calculatorTool }),
+ *   systemPrompt: 'You are a helpful assistant.',
+ *   input: 'What is 2 + 2?',
+ *   maxIterations: 10
+ * });
+ * console.log(result.output);
+ * ```
+ */
+declare function runAgent(config: AgentConfig): Promise<AgentResult>;
+
+/**
+ * Create a model instance based on provider
+ */
+
+/**
+ * Create a model instance for the given provider
+ *
+ * @example
+ * ```typescript
+ * const model = createModel({
+ *   provider: 'openai',
+ *   model: 'gpt-4o',
+ *   temperature: 0.7
+ * });
+ *
+ * const response = await model.invoke([
+ *   { role: 'user', content: 'Hello!' }
+ * ]);
+ * ```
+ */
+declare function createModel(config: ModelConfig): Model;
+
+/**
+ * OpenAI model provider using AI SDK
+ */
+
+/**
+ * Create an OpenAI model instance
+ */
+declare function createOpenAIModel(config: ModelConfig): Model;
+
+/**
+ * Anthropic model provider using AI SDK
+ */
+
+/**
+ * Create an Anthropic model instance
+ */
+declare function createAnthropicModel(config: ModelConfig): Model;
+
+/**
+ * Google (Gemini) model provider using AI SDK
+ */
+
+/**
+ * Create a Google (Gemini) model instance
+ */
+declare function createGoogleModel(config: ModelConfig): Model;
+
+/**
+ * Tools: defineTool, createToolSet, execute, zodToJsonSchema
+ */
+
+/** Tool has description (and optional title) in config; name is the key in createToolSet. */
+declare function defineTool<TInput extends z.ZodType, TOutput>(config: ToolConfig<TInput, TOutput>): Tool;
+type ToolSet = Record<string, Tool>;
+/** Pass a record: key = tool name (same as in defineTool config). */
+declare function createToolSet(tools: ToolSet): ToolSet;
+declare function getTools(toolSet: ToolSet): Tool[];
+declare function getTool(toolSet: ToolSet, name: string): Tool | undefined;
+declare function executeTool<TInput, TOutput>(toolImpl: Tool<TInput, TOutput>, input: TInput, options?: {
+    toolCallId?: string;
+    abortSignal?: AbortSignal;
+}): Promise<ToolExecutionResult<TOutput>>;
+declare function executeToolByName(tools: ToolSet, name: string, input: unknown, options?: {
+    toolCallId?: string;
+    abortSignal?: AbortSignal;
+}): Promise<ToolExecutionResult>;
+
+/**
+ * Subagents: define, run, and expose as tools to a parent agent
+ */
+
+/**
+ * Validates and creates a subagent definition (analogous to defineTool).
+ * Name must be kebab-case.
+ */
+declare function defineSubagent(config: SubagentConfig): SubagentDefinition;
+interface RunSubagentOptions {
+    /** Parent's tools; used when definition does not specify tools (filtered by disallowedTools) */
+    parentTools?: Record<string, AgentTool>;
+    /** Parent's model; used when definition does not specify model */
+    parentModel?: Model;
+}
+/**
+ * Executes the subagent in isolation: resolves tools and model, runs runAgent, returns SubagentResult.
+ */
+declare function runSubagent(definition: SubagentDefinition, input: string, options?: RunSubagentOptions): Promise<SubagentResult>;
+interface CreateSubagentToolOptions {
+    parentTools?: Record<string, AgentTool>;
+    parentModel?: Model;
+}
+/**
+ * Wraps a subagent as an AI SDK Tool so a parent agent can delegate via a tool call.
+ * Input: { prompt: string }. Returns the subagent's final output string.
+ */
+declare function createSubagentTool(definition: SubagentDefinition, options?: CreateSubagentToolOptions): AgentTool;
+/**
+ * Creates a Record<string, Tool> from multiple subagent definitions, keyed by subagent_<name>.
+ */
+declare function createSubagentToolSet(definitions: SubagentDefinition[], options?: CreateSubagentToolOptions): ToolSet;
+
+/**
+ * MCP client types - transport, config, and response shapes
+ * for the Model Context Protocol client infrastructure.
+ */
+/** Minimal transport interface matching the MCP SDK's transport contract. */
+interface McpTransport {
+    start(): Promise<void>;
+    close(): Promise<void>;
+    send(message: unknown): Promise<void>;
+}
+/** How to connect to an MCP server. Exactly one of (url) or (command) must be set. */
+interface McpClientConfig {
+    /** Streamable HTTP endpoint for the MCP server. */
+    url?: string;
+    /** Custom headers to send with HTTP requests (e.g. auth headers). */
+    headers?: Record<string, string>;
+    /** For stdio transport: command to spawn (e.g. "npx"). */
+    command?: string;
+    /** For stdio transport: arguments for the command. */
+    args?: string[];
+}
+/** Identity advertised to the MCP server during the handshake. */
+interface McpClientInfo {
+    name: string;
+    version: string;
+}
+/** A single content block returned by an MCP tool call. */
+interface McpToolContent {
+    type: string;
+    text?: string;
+}
+/**
+ * Options for `resolveConfig` that describe which env-var prefix to read
+ * and what error message to show when no config is found.
+ */
+interface McpResolveOptions {
+    /**
+     * Env-var prefix. Given "STITCH_MCP" the helper reads:
+     *   STITCH_MCP_URL, STITCH_MCP_API_KEY, STITCH_MCP_COMMAND, STITCH_MCP_ARGS
+     */
+    envPrefix: string;
+    /** Human-readable server name used in error messages (e.g. "Stitch"). */
+    serverLabel?: string;
+    /**
+     * Header name for the API key read from env (<PREFIX>_API_KEY).
+     * Defaults to "Authorization" (value sent as "Bearer <key>").
+     */
+    apiKeyHeader?: string;
+}
+
+/**
+ * BaseMcpClient - reusable MCP client with lazy connection and typed tool invocation.
+ * Extend and add domain methods that call this.callTool(name, args).
+ */
+
+declare class BaseMcpClient {
+    private readonly info;
+    private readonly config;
+    private client;
+    private transport;
+    private connectPromise;
+    constructor(info: McpClientInfo, config: McpClientConfig);
+    /** Build config from options + env (<PREFIX>_URL, _API_KEY, _COMMAND, _ARGS). */
+    static resolveConfig(options?: McpClientConfig, resolveOpts?: McpResolveOptions): McpClientConfig;
+    private ensureConnected;
+    private doConnect;
+    /** Call MCP tool and parse result. Subclasses use this for typed domain methods. */
+    protected callTool<T>(name: string, args?: Record<string, unknown>): Promise<T>;
+    close(): Promise<void>;
+}
+
+/**
+ * Hello World tool
+ */
+declare const helloWorldTool: ai.Tool;
+
+/**
+ * Hello World agent - runs an agent with the hello world tool
+ */
+
+interface HelloWorldAgentConfig {
+    /** User input (e.g. "Say hello to Alice") */
+    input: string;
+    /** Model config; defaults to OpenAI gpt-4o-mini */
+    model?: ModelConfig;
+    /** System prompt override */
+    systemPrompt?: string;
+    /** Max iterations; default 3 */
+    maxIterations?: number;
+    /** Callback for each step */
+    onStep?: (step: AgentStep) => void;
+}
+declare function runHelloWorldAgent(config: HelloWorldAgentConfig): Promise<AgentResult>;
+
+/**
+ * Field-level schema for MongoDB collection fields
+ */
+
+declare const fieldSchema: z.ZodObject<{
+    fieldName: z.ZodString;
+    fieldType: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        enum: "enum";
+        Date: "Date";
+        "Types.ObjectId": "Types.ObjectId";
+        email: "email";
+        password: "password";
+    }>;
+    isArray: z.ZodBoolean;
+    isRequired: z.ZodBoolean;
+    isUnique: z.ZodBoolean;
+    values: z.ZodArray<z.ZodString>;
+    defaultVal: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodNull]>>;
+    relationTo: z.ZodOptional<z.ZodString>;
+    relationType: z.ZodOptional<z.ZodEnum<{
+        "": "";
+        "one-to-one": "one-to-one";
+        "many-to-one": "many-to-one";
+    }>>;
+    isPrivate: z.ZodBoolean;
+}, z.core.$strip>;
+type TFieldSchema = z.infer<typeof fieldSchema>;
+
+/**
+ * Module (collection) level schema for MongoDB
+ */
+
+declare const moduleSchema: z.ZodObject<{
+    moduleName: z.ZodString;
+    isUserModule: z.ZodBoolean;
+    authMethod: z.ZodOptional<z.ZodEnum<{
+        "": "";
+        EMAIL_AND_PASSWORD: "EMAIL_AND_PASSWORD";
+        PHONE_AND_OTP: "PHONE_AND_OTP";
+    }>>;
+    emailField: z.ZodOptional<z.ZodString>;
+    passwordField: z.ZodOptional<z.ZodString>;
+    phoneField: z.ZodOptional<z.ZodString>;
+    roleField: z.ZodOptional<z.ZodString>;
+    permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodEnum<{
+        CREATE: "CREATE";
+        READ: "READ";
+        UPDATE: "UPDATE";
+        DELETE: "DELETE";
+    }>>>>;
+    fields: z.ZodArray<z.ZodObject<{
+        fieldName: z.ZodString;
+        fieldType: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            enum: "enum";
+            Date: "Date";
+            "Types.ObjectId": "Types.ObjectId";
+            email: "email";
+            password: "password";
+        }>;
+        isArray: z.ZodBoolean;
+        isRequired: z.ZodBoolean;
+        isUnique: z.ZodBoolean;
+        values: z.ZodArray<z.ZodString>;
+        defaultVal: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodNull]>>;
+        relationTo: z.ZodOptional<z.ZodString>;
+        relationType: z.ZodOptional<z.ZodEnum<{
+            "": "";
+            "one-to-one": "one-to-one";
+            "many-to-one": "many-to-one";
+        }>>;
+        isPrivate: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type TModuleSchema$1 = z.infer<typeof moduleSchema>;
+
+/**
+ * Root project schema for MongoDB database design
+ */
+
+declare const projectSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    projectDescription: z.ZodString;
+    modules: z.ZodArray<z.ZodObject<{
+        moduleName: z.ZodString;
+        isUserModule: z.ZodBoolean;
+        authMethod: z.ZodOptional<z.ZodEnum<{
+            "": "";
+            EMAIL_AND_PASSWORD: "EMAIL_AND_PASSWORD";
+            PHONE_AND_OTP: "PHONE_AND_OTP";
+        }>>;
+        emailField: z.ZodOptional<z.ZodString>;
+        passwordField: z.ZodOptional<z.ZodString>;
+        phoneField: z.ZodOptional<z.ZodString>;
+        roleField: z.ZodOptional<z.ZodString>;
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodEnum<{
+            CREATE: "CREATE";
+            READ: "READ";
+            UPDATE: "UPDATE";
+            DELETE: "DELETE";
+        }>>>>;
+        fields: z.ZodArray<z.ZodObject<{
+            fieldName: z.ZodString;
+            fieldType: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                enum: "enum";
+                Date: "Date";
+                "Types.ObjectId": "Types.ObjectId";
+                email: "email";
+                password: "password";
+            }>;
+            isArray: z.ZodBoolean;
+            isRequired: z.ZodBoolean;
+            isUnique: z.ZodBoolean;
+            values: z.ZodArray<z.ZodString>;
+            defaultVal: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodNull]>>;
+            relationTo: z.ZodOptional<z.ZodString>;
+            relationType: z.ZodOptional<z.ZodEnum<{
+                "": "";
+                "one-to-one": "one-to-one";
+                "many-to-one": "many-to-one";
+            }>>;
+            isPrivate: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    author: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type TBackendProjectSchema = z.infer<typeof projectSchema>;
+
+/**
+ * db-designer module types - structured requirements and agent config
+ */
+
+interface Actor {
+    id: string;
+    name: string;
+    description: string;
+    goals: string[];
+}
+interface ExtractedFlow {
+    id: string;
+    actorId: string;
+    name: string;
+    description: string;
+    trigger: string;
+    outcome: string;
+}
+interface ExtractedStory {
+    id: string;
+    flowId: string;
+    actor: string;
+    action: string;
+    benefit: string;
+    preconditions: string[];
+    postconditions: string[];
+    dataInvolved: string[];
+}
+interface TechnicalRequirements {
+    authentication: 'none' | 'email' | 'oauth' | 'phone' | 'email_and_phone';
+    authorization: boolean;
+    roles?: string[];
+    integrations?: string[];
+    realtime?: boolean;
+    fileUpload?: boolean;
+    search?: boolean;
+}
+interface StructuredRequirementsInput {
+    projectName: string;
+    projectGoal: string;
+    projectDescription?: string;
+    actors: Actor[];
+    flows: ExtractedFlow[];
+    stories: ExtractedStory[];
+    technicalRequirements?: TechnicalRequirements;
+}
+interface DbDesignerAgentConfig {
+    /** User input: natural language requirement or instruction */
+    input: string;
+    /** Model config; optional, caller can pass via runAgent */
+    model?: ModelConfig;
+    /** Max iterations; default 15 */
+    maxIterations?: number;
+    /** Callback for each step */
+    onStep?: (step: AgentStep) => void;
+}
+
+/**
+ * System prompt for database design - 5-phase analysis framework
+ */
+declare const DB_DESIGN_SYSTEM_PROMPT = "You are an expert MongoDB database architect with deep expertise in schema design, performance optimization, scalability, and domain-driven design. You analyze requirements systematically using a multi-phase approach to create production-ready database schemas.\n\n## ANALYSIS FRAMEWORK\n\nYou MUST follow this 5-phase analysis process before generating the schema:\n\n### PHASE 1: Entity Discovery\nSystematically extract all entities from the provided requirements:\n\n1. **From dataInvolved fields**: Every item in user stories' dataInvolved[] array indicates a potential entity or field\n   - Pattern: \"User Profile\" \u2192 user collection with profile fields\n   - Pattern: \"Order Items\" \u2192 order collection + item collection with relationship\n   - Pattern: \"Product Inventory\" \u2192 product collection with inventory fields\n\n2. **From User Types (Actors)**: Each actor type may indicate a User variant or role\n   - Pattern: \"Admin\", \"Customer\", \"Vendor\" \u2192 User collection with role enum\n   - Pattern: \"Guest\" \u2192 May not need persistence, or limited session data\n\n3. **From User Flow Actions**: Action verbs reveal implicit entities\n   - \"creates order\" \u2192 Order collection\n   - \"submits payment\" \u2192 Payment collection\n   - \"uploads document\" \u2192 Document collection\n   - \"sends message\" \u2192 Message collection\n\n4. **From Flow States**: Transitions reveal status enums\n   - Flow: pending \u2192 approved \u2192 completed \u2192 Order.status enum\n   - Flow: draft \u2192 published \u2192 archived \u2192 Content.status enum\n\n### PHASE 2: Relationship Mapping\nFor each entity pair, determine relationships based on:\n\n1. **Ownership Patterns** (from actor actions):\n   - \"Customer places Order\" \u2192 Order.customer (many-to-one to User)\n   - \"Admin approves Request\" \u2192 Request.approvedBy (many-to-one to User)\n   - \"User creates Post\" \u2192 Post.author (many-to-one to User)\n\n2. **Cardinality from Flow Context**:\n   - \"User has one profile\" \u2192 one-to-one\n   - \"User places multiple orders\" \u2192 many-to-one (Order \u2192 User)\n   - \"Order contains items\" \u2192 many-to-one (OrderItem \u2192 Order)\n\n3. **Shared Entities** (referenced across flows):\n   - Entity referenced by multiple actors \u2192 likely needs relationships to User\n   - Entity in multiple flows \u2192 likely a core/central entity\n\n4. **Bidirectional References** (for one-to-one):\n   - Include reference field in BOTH collections for one-to-one relationships\n\n### PHASE 3: Permission Derivation\nMap actors to RBAC permissions:\n\n1. **Role Extraction**: Each actor type becomes a role value\n   - actors: [Admin, Customer, Vendor] \u2192 role enum: ['admin', 'customer', 'vendor']\n\n2. **Permission Mining from User Stories**:\n   - \"As Admin, I can delete users\" \u2192 admin: ['CREATE', 'READ', 'UPDATE', 'DELETE'] on user\n   - \"As Customer, I can view my orders\" \u2192 customer: ['READ'] on order (own records)\n   - \"As Vendor, I can update products\" \u2192 vendor: ['CREATE', 'READ', 'UPDATE'] on product\n\n3. **Data Visibility Rules**:\n   - \"view own\" \u2192 READ permission with ownership filter\n   - \"view all\" \u2192 READ permission without filter\n   - \"manage\" \u2192 full CRUD permissions\n\n### PHASE 4: Query Pattern Inference\nAnalyze flows to predict database access patterns:\n\n1. **Read Patterns** (suggest indexes):\n   - \"list orders by date\" \u2192 index on order.createdAt\n   - \"search products by category\" \u2192 index on product.category\n   - \"find user by email\" \u2192 unique index on user.email\n   - \"filter by status\" \u2192 index on status field\n\n2. **Write Patterns** (affect schema design):\n   - High-frequency writes \u2192 consider denormalization\n   - Audit requirements \u2192 add createdBy, updatedBy fields\n\n3. **Aggregation Needs** (from reporting flows):\n   - \"view sales dashboard\" \u2192 may need summary collections\n   - \"generate reports\" \u2192 ensure proper indexing for date ranges\n\n### PHASE 5: Schema Construction\nSynthesize all analyses into the final schema:\n\n1. **Module Definition**:\n   - One module per core entity\n   - camelCase module names (never 'auth' or 'authentication')\n   - Mark user modules with isUserModule: true\n\n2. **Field Completeness**:\n   - All fields from dataInvolved\n   - Relationship fields (Types.ObjectId with relationTo)\n   - Status/lifecycle fields (enum type with values from flow states)\n   - Audit fields: createdAt, updatedAt (Date, required)\n   - createdBy, updatedBy when flows mention \"who did what\"\n\n3. **Validation Constraints**:\n   - isRequired: true for fields mentioned in preconditions\n   - isUnique: true for identifier fields (email, slug, code)\n   - enum values from flow states and categorical data\n\n4. **Security Fields**:\n   - password fields: fieldType: 'password', isPrivate: true\n   - email fields: fieldType: 'email', isUnique: true\n\n## CORE CONSTRAINTS (MUST FOLLOW)\n\n1. **Primary Key**: _id with Types.ObjectId (auto-generated, do not include in fields)\n\n2. **Relationships**:\n   - One-to-One: Reference field in BOTH collections\n   - Many-to-One: Reference in the \"many\" side only\n   - Many-to-Many: ONLY when necessary, use intermediate collection\n   - One-to-Many: FORBIDDEN - invert to many-to-one from child\n\n3. **Data Types**:\n   - NO arrays of ObjectIds for relationships\n   - Timestamps: createdAt, updatedAt (Date) in EVERY collection\n   - Enums: Use fieldType: 'enum' with values array\n\n4. **Security**:\n   - NO separate \"Auth\" or \"Authentication\" collection\n   - NO token storage in database\n   - Password fields: isPrivate: true\n\n5. **Authorization (RBAC)**:\n   - Define permissions per role on user modules\n   - Format: {{ \"roleName\": [\"CREATE\", \"READ\", \"UPDATE\", \"DELETE\"] }}";
+
+/**
+ * Design prompts - legacy and pro-level, plus structured requirement formatters
+ */
+
+/**
+ * Legacy: build design prompt from plain requirement string
+ */
+declare function createDbDesignPrompt(requirement: string): string;
+/**
+ * Format actors/user types into prompt-friendly string
+ */
+declare function formatUserTypes(actors: Actor[]): string;
+/**
+ * Format user flows into prompt-friendly string
+ */
+declare function formatUserFlows(flows: ExtractedFlow[], actors: Actor[]): string;
+/**
+ * Format user stories with dataInvolved into prompt-friendly string
+ */
+declare function formatUserStories(stories: ExtractedStory[], flows: ExtractedFlow[]): string;
+/**
+ * Format technical requirements into prompt-friendly string
+ */
+declare function formatTechnicalRequirements(tech?: TechnicalRequirements): string;
+/**
+ * Extract all unique dataInvolved items from stories for entity hints
+ */
+declare function extractDataEntities(stories: ExtractedStory[]): string[];
+/**
+ * Extract roles from actors for RBAC configuration
+ */
+declare function extractRoles(actors: Actor[]): string[];
+/**
+ * Build complete prompt variables from structured requirements
+ */
+declare function buildPromptVariables(input: StructuredRequirementsInput): Record<string, string>;
+/**
+ * Pro-level DB design prompt from structured requirements
+ */
+declare function createProDbDesignPrompt(input: StructuredRequirementsInput): string;
+
+/**
+ * Redesign prompt - update existing schema based on user feedback
+ */
+declare function createRedesignPrompt(existingSchema: string, userFeedback: string): string;
+
+/**
+ * validate_schema tool - validates JSON against projectSchema (no AI)
+ */
+declare const validateSchemaTool: ai.Tool;
+
+/**
+ * Creates the design_database tool. Requires a model to invoke for schema generation.
+ */
+declare function createDesignDatabaseTool(model: Model): ai.Tool;
+
+/**
+ * Creates the design_database_pro tool. Requires a model for schema generation.
+ */
+declare function createDesignDatabaseProTool(model: Model): ai.Tool;
+
+/**
+ * Creates the redesign_database tool. Requires a model for schema update.
+ */
+declare function createRedesignDatabaseTool(model: Model): ai.Tool;
+
+/**
+ * Create all db-designer tools for the agent. Pass the model for AI-backed tools.
+ */
+declare function createDbDesignerTools(model: Model): ToolSet;
+
+/**
+ * entity-analyzer subagent - extracts entities, relationships, and roles from requirements (no tools)
+ */
+declare const entityAnalyzerSubagent: SubagentDefinition;
+
+/**
+ * schema-refiner subagent - validates schema and suggests refinements (has validate_schema tool)
+ */
+declare function createSchemaRefinerSubagent(): SubagentDefinition;
+
+/**
+ * runDbDesignerAgent - orchestrator for the full DB design workflow
+ */
+
+/**
+ * Run the db-designer orchestrator agent with all tools and subagents.
+ */
+declare function runDbDesignerAgent(config: DbDesignerAgentConfig): Promise<AgentResult>;
+
+/**
+ * Branding schema for frontend app config
+ */
+
+declare const BrandingSchema: z.ZodObject<{
+    brandName: z.ZodString;
+    primaryColor: z.ZodString;
+    secondaryColor: z.ZodString;
+    logo: z.ZodURL;
+}, z.core.$strip>;
+type TBrandingSchema = z.infer<typeof BrandingSchema>;
+
+/**
+ * App configuration schema
+ */
+
+declare const AppConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodDefault<z.ZodString>;
+    branding: z.ZodObject<{
+        brandName: z.ZodString;
+        primaryColor: z.ZodString;
+        secondaryColor: z.ZodString;
+        logo: z.ZodURL;
+    }, z.core.$strip>;
+    apiEndpoint: z.ZodURL;
+}, z.core.$strip>;
+type TAppConfigSchema = z.infer<typeof AppConfigSchema>;
+
+/**
+ * Form field, validation, options, and column schemas
+ */
+
+declare const ValidationSchema: z.ZodObject<{
+    minLength: z.ZodOptional<z.ZodNumber>;
+    zodString: z.ZodString;
+}, z.core.$strip>;
+declare const FieldOptionsSchema: z.ZodObject<{
+    hookName: z.ZodOptional<z.ZodString>;
+    queryString: z.ZodOptional<z.ZodString>;
+    labelKey: z.ZodOptional<z.ZodString>;
+    valueKey: z.ZodOptional<z.ZodString>;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const FormFieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        number: "number";
+        text: "text";
+        image: "image";
+        date: "date";
+        email: "email";
+        password: "password";
+        multiSelect: "multiSelect";
+        textarea: "textarea";
+        hidden: "hidden";
+        select: "select";
+    }>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    validation: z.ZodOptional<z.ZodObject<{
+        minLength: z.ZodOptional<z.ZodNumber>;
+        zodString: z.ZodString;
+    }, z.core.$strip>>;
+    defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    options: z.ZodOptional<z.ZodObject<{
+        hookName: z.ZodOptional<z.ZodString>;
+        queryString: z.ZodOptional<z.ZodString>;
+        labelKey: z.ZodOptional<z.ZodString>;
+        valueKey: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ColumnSchema: z.ZodObject<{
+    field: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+type TFormFieldSchema = z.infer<typeof FormFieldSchema>;
+type TColumnSchema = z.infer<typeof ColumnSchema>;
+
+/**
+ * API, drawer, auth page, listing page, and page union schemas
+ */
+
+declare const ApiResponseTypeSchema: z.ZodOptional<z.ZodObject<{
+    type: z.ZodString;
+    properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+type TApiResponseTypeSchema = z.infer<typeof ApiResponseTypeSchema>;
+declare const ListingPageApiSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        list: "list";
+        create: "create";
+        update: "update";
+        delete: "delete";
+        getById: "getById";
+    }>;
+    graphqlHook: z.ZodString;
+    queryString: z.ZodString;
+    responseType: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const AuthPageApiSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        login: "login";
+        currentUser: "currentUser";
+        forgotPassword: "forgotPassword";
+        resetPassword: "resetPassword";
+    }>;
+    graphqlHook: z.ZodString;
+    queryString: z.ZodString;
+    responseType: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const DrawerSchema: z.ZodObject<{
+    title: z.ZodString;
+    graphqlHook: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            text: "text";
+            image: "image";
+            date: "date";
+            email: "email";
+            password: "password";
+            multiSelect: "multiSelect";
+            textarea: "textarea";
+            hidden: "hidden";
+            select: "select";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        validation: z.ZodOptional<z.ZodObject<{
+            minLength: z.ZodOptional<z.ZodNumber>;
+            zodString: z.ZodString;
+        }, z.core.$strip>>;
+        defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        options: z.ZodOptional<z.ZodObject<{
+            hookName: z.ZodOptional<z.ZodString>;
+            queryString: z.ZodOptional<z.ZodString>;
+            labelKey: z.ZodOptional<z.ZodString>;
+            valueKey: z.ZodOptional<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const AuthPageSchema: z.ZodObject<{
+    name: z.ZodEnum<{
+        LoginPage: "LoginPage";
+        ForgotPasswordPage: "ForgotPasswordPage";
+        ResetPasswordPage: "ResetPasswordPage";
+    }>;
+    type: z.ZodEnum<{
+        EmailPassword: "EmailPassword";
+        ForgotPassword: "ForgotPassword";
+        ResetPassword: "ResetPassword";
+    }>;
+    route: z.ZodString;
+    isPrivate: z.ZodBoolean;
+    api: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            login: "login";
+            currentUser: "currentUser";
+            forgotPassword: "forgotPassword";
+            resetPassword: "resetPassword";
+        }>;
+        graphqlHook: z.ZodString;
+        queryString: z.ZodString;
+        responseType: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            text: "text";
+            image: "image";
+            date: "date";
+            email: "email";
+            password: "password";
+            multiSelect: "multiSelect";
+            textarea: "textarea";
+            hidden: "hidden";
+            select: "select";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        validation: z.ZodOptional<z.ZodObject<{
+            minLength: z.ZodOptional<z.ZodNumber>;
+            zodString: z.ZodString;
+        }, z.core.$strip>>;
+        defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        options: z.ZodOptional<z.ZodObject<{
+            hookName: z.ZodOptional<z.ZodString>;
+            queryString: z.ZodOptional<z.ZodString>;
+            labelKey: z.ZodOptional<z.ZodString>;
+            valueKey: z.ZodOptional<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const ListingPageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"Listing">;
+    name: z.ZodString;
+    route: z.ZodString;
+    isPrivate: z.ZodBoolean;
+    api: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            list: "list";
+            create: "create";
+            update: "update";
+            delete: "delete";
+            getById: "getById";
+        }>;
+        graphqlHook: z.ZodString;
+        queryString: z.ZodString;
+        responseType: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    columns: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    actions: z.ZodArray<z.ZodString>;
+    drawerCreate: z.ZodObject<{
+        title: z.ZodString;
+        graphqlHook: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                text: "text";
+                image: "image";
+                date: "date";
+                email: "email";
+                password: "password";
+                multiSelect: "multiSelect";
+                textarea: "textarea";
+                hidden: "hidden";
+                select: "select";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            validation: z.ZodOptional<z.ZodObject<{
+                minLength: z.ZodOptional<z.ZodNumber>;
+                zodString: z.ZodString;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodObject<{
+                hookName: z.ZodOptional<z.ZodString>;
+                queryString: z.ZodOptional<z.ZodString>;
+                labelKey: z.ZodOptional<z.ZodString>;
+                valueKey: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    drawerUpdate: z.ZodObject<{
+        title: z.ZodString;
+        graphqlHook: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                text: "text";
+                image: "image";
+                date: "date";
+                email: "email";
+                password: "password";
+                multiSelect: "multiSelect";
+                textarea: "textarea";
+                hidden: "hidden";
+                select: "select";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            validation: z.ZodOptional<z.ZodObject<{
+                minLength: z.ZodOptional<z.ZodNumber>;
+                zodString: z.ZodString;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodObject<{
+                hookName: z.ZodOptional<z.ZodString>;
+                queryString: z.ZodOptional<z.ZodString>;
+                labelKey: z.ZodOptional<z.ZodString>;
+                valueKey: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const PageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodEnum<{
+        LoginPage: "LoginPage";
+        ForgotPasswordPage: "ForgotPasswordPage";
+        ResetPasswordPage: "ResetPasswordPage";
+    }>;
+    type: z.ZodEnum<{
+        EmailPassword: "EmailPassword";
+        ForgotPassword: "ForgotPassword";
+        ResetPassword: "ResetPassword";
+    }>;
+    route: z.ZodString;
+    isPrivate: z.ZodBoolean;
+    api: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            login: "login";
+            currentUser: "currentUser";
+            forgotPassword: "forgotPassword";
+            resetPassword: "resetPassword";
+        }>;
+        graphqlHook: z.ZodString;
+        queryString: z.ZodString;
+        responseType: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            text: "text";
+            image: "image";
+            date: "date";
+            email: "email";
+            password: "password";
+            multiSelect: "multiSelect";
+            textarea: "textarea";
+            hidden: "hidden";
+            select: "select";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        validation: z.ZodOptional<z.ZodObject<{
+            minLength: z.ZodOptional<z.ZodNumber>;
+            zodString: z.ZodString;
+        }, z.core.$strip>>;
+        defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        options: z.ZodOptional<z.ZodObject<{
+            hookName: z.ZodOptional<z.ZodString>;
+            queryString: z.ZodOptional<z.ZodString>;
+            labelKey: z.ZodOptional<z.ZodString>;
+            valueKey: z.ZodOptional<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"Listing">;
+    name: z.ZodString;
+    route: z.ZodString;
+    isPrivate: z.ZodBoolean;
+    api: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            list: "list";
+            create: "create";
+            update: "update";
+            delete: "delete";
+            getById: "getById";
+        }>;
+        graphqlHook: z.ZodString;
+        queryString: z.ZodString;
+        responseType: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    columns: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    actions: z.ZodArray<z.ZodString>;
+    drawerCreate: z.ZodObject<{
+        title: z.ZodString;
+        graphqlHook: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                text: "text";
+                image: "image";
+                date: "date";
+                email: "email";
+                password: "password";
+                multiSelect: "multiSelect";
+                textarea: "textarea";
+                hidden: "hidden";
+                select: "select";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            validation: z.ZodOptional<z.ZodObject<{
+                minLength: z.ZodOptional<z.ZodNumber>;
+                zodString: z.ZodString;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodObject<{
+                hookName: z.ZodOptional<z.ZodString>;
+                queryString: z.ZodOptional<z.ZodString>;
+                labelKey: z.ZodOptional<z.ZodString>;
+                valueKey: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    drawerUpdate: z.ZodObject<{
+        title: z.ZodString;
+        graphqlHook: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                text: "text";
+                image: "image";
+                date: "date";
+                email: "email";
+                password: "password";
+                multiSelect: "multiSelect";
+                textarea: "textarea";
+                hidden: "hidden";
+                select: "select";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            validation: z.ZodOptional<z.ZodObject<{
+                minLength: z.ZodOptional<z.ZodNumber>;
+                zodString: z.ZodString;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodObject<{
+                hookName: z.ZodOptional<z.ZodString>;
+                queryString: z.ZodOptional<z.ZodString>;
+                labelKey: z.ZodOptional<z.ZodString>;
+                valueKey: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+type TPageSchema = z.infer<typeof PageSchema>;
+
+/**
+ * Module and root application schema
+ */
+
+declare const ModuleSchema: z.ZodObject<{
+    name: z.ZodString;
+    pages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        name: z.ZodEnum<{
+            LoginPage: "LoginPage";
+            ForgotPasswordPage: "ForgotPasswordPage";
+            ResetPasswordPage: "ResetPasswordPage";
+        }>;
+        type: z.ZodEnum<{
+            EmailPassword: "EmailPassword";
+            ForgotPassword: "ForgotPassword";
+            ResetPassword: "ResetPassword";
+        }>;
+        route: z.ZodString;
+        isPrivate: z.ZodBoolean;
+        api: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                login: "login";
+                currentUser: "currentUser";
+                forgotPassword: "forgotPassword";
+                resetPassword: "resetPassword";
+            }>;
+            graphqlHook: z.ZodString;
+            queryString: z.ZodString;
+            responseType: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    type: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                text: "text";
+                image: "image";
+                date: "date";
+                email: "email";
+                password: "password";
+                multiSelect: "multiSelect";
+                textarea: "textarea";
+                hidden: "hidden";
+                select: "select";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            validation: z.ZodOptional<z.ZodObject<{
+                minLength: z.ZodOptional<z.ZodNumber>;
+                zodString: z.ZodString;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodObject<{
+                hookName: z.ZodOptional<z.ZodString>;
+                queryString: z.ZodOptional<z.ZodString>;
+                labelKey: z.ZodOptional<z.ZodString>;
+                valueKey: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"Listing">;
+        name: z.ZodString;
+        route: z.ZodString;
+        isPrivate: z.ZodBoolean;
+        api: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                list: "list";
+                create: "create";
+                update: "update";
+                delete: "delete";
+                getById: "getById";
+            }>;
+            graphqlHook: z.ZodString;
+            queryString: z.ZodString;
+            responseType: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    type: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        columns: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        actions: z.ZodArray<z.ZodString>;
+        drawerCreate: z.ZodObject<{
+            title: z.ZodString;
+            graphqlHook: z.ZodString;
+            fields: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    number: "number";
+                    text: "text";
+                    image: "image";
+                    date: "date";
+                    email: "email";
+                    password: "password";
+                    multiSelect: "multiSelect";
+                    textarea: "textarea";
+                    hidden: "hidden";
+                    select: "select";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                validation: z.ZodOptional<z.ZodObject<{
+                    minLength: z.ZodOptional<z.ZodNumber>;
+                    zodString: z.ZodString;
+                }, z.core.$strip>>;
+                defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                options: z.ZodOptional<z.ZodObject<{
+                    hookName: z.ZodOptional<z.ZodString>;
+                    queryString: z.ZodOptional<z.ZodString>;
+                    labelKey: z.ZodOptional<z.ZodString>;
+                    valueKey: z.ZodOptional<z.ZodString>;
+                    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        drawerUpdate: z.ZodObject<{
+            title: z.ZodString;
+            graphqlHook: z.ZodString;
+            fields: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    number: "number";
+                    text: "text";
+                    image: "image";
+                    date: "date";
+                    email: "email";
+                    password: "password";
+                    multiSelect: "multiSelect";
+                    textarea: "textarea";
+                    hidden: "hidden";
+                    select: "select";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                validation: z.ZodOptional<z.ZodObject<{
+                    minLength: z.ZodOptional<z.ZodNumber>;
+                    zodString: z.ZodString;
+                }, z.core.$strip>>;
+                defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                options: z.ZodOptional<z.ZodObject<{
+                    hookName: z.ZodOptional<z.ZodString>;
+                    queryString: z.ZodOptional<z.ZodString>;
+                    labelKey: z.ZodOptional<z.ZodString>;
+                    valueKey: z.ZodOptional<z.ZodString>;
+                    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+declare const ApplicationSchema: z.ZodObject<{
+    app: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        author: z.ZodDefault<z.ZodString>;
+        branding: z.ZodObject<{
+            brandName: z.ZodString;
+            primaryColor: z.ZodString;
+            secondaryColor: z.ZodString;
+            logo: z.ZodURL;
+        }, z.core.$strip>;
+        apiEndpoint: z.ZodURL;
+    }, z.core.$strip>;
+    modules: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            name: z.ZodEnum<{
+                LoginPage: "LoginPage";
+                ForgotPasswordPage: "ForgotPasswordPage";
+                ResetPasswordPage: "ResetPasswordPage";
+            }>;
+            type: z.ZodEnum<{
+                EmailPassword: "EmailPassword";
+                ForgotPassword: "ForgotPassword";
+                ResetPassword: "ResetPassword";
+            }>;
+            route: z.ZodString;
+            isPrivate: z.ZodBoolean;
+            api: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    login: "login";
+                    currentUser: "currentUser";
+                    forgotPassword: "forgotPassword";
+                    resetPassword: "resetPassword";
+                }>;
+                graphqlHook: z.ZodString;
+                queryString: z.ZodString;
+                responseType: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                        type: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    number: "number";
+                    text: "text";
+                    image: "image";
+                    date: "date";
+                    email: "email";
+                    password: "password";
+                    multiSelect: "multiSelect";
+                    textarea: "textarea";
+                    hidden: "hidden";
+                    select: "select";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                validation: z.ZodOptional<z.ZodObject<{
+                    minLength: z.ZodOptional<z.ZodNumber>;
+                    zodString: z.ZodString;
+                }, z.core.$strip>>;
+                defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                options: z.ZodOptional<z.ZodObject<{
+                    hookName: z.ZodOptional<z.ZodString>;
+                    queryString: z.ZodOptional<z.ZodString>;
+                    labelKey: z.ZodOptional<z.ZodString>;
+                    valueKey: z.ZodOptional<z.ZodString>;
+                    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"Listing">;
+            name: z.ZodString;
+            route: z.ZodString;
+            isPrivate: z.ZodBoolean;
+            api: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    list: "list";
+                    create: "create";
+                    update: "update";
+                    delete: "delete";
+                    getById: "getById";
+                }>;
+                graphqlHook: z.ZodString;
+                queryString: z.ZodString;
+                responseType: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+                        type: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            columns: z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+            actions: z.ZodArray<z.ZodString>;
+            drawerCreate: z.ZodObject<{
+                title: z.ZodString;
+                graphqlHook: z.ZodString;
+                fields: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        number: "number";
+                        text: "text";
+                        image: "image";
+                        date: "date";
+                        email: "email";
+                        password: "password";
+                        multiSelect: "multiSelect";
+                        textarea: "textarea";
+                        hidden: "hidden";
+                        select: "select";
+                    }>;
+                    required: z.ZodOptional<z.ZodBoolean>;
+                    validation: z.ZodOptional<z.ZodObject<{
+                        minLength: z.ZodOptional<z.ZodNumber>;
+                        zodString: z.ZodString;
+                    }, z.core.$strip>>;
+                    defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    options: z.ZodOptional<z.ZodObject<{
+                        hookName: z.ZodOptional<z.ZodString>;
+                        queryString: z.ZodOptional<z.ZodString>;
+                        labelKey: z.ZodOptional<z.ZodString>;
+                        valueKey: z.ZodOptional<z.ZodString>;
+                        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            drawerUpdate: z.ZodObject<{
+                title: z.ZodString;
+                graphqlHook: z.ZodString;
+                fields: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        number: "number";
+                        text: "text";
+                        image: "image";
+                        date: "date";
+                        email: "email";
+                        password: "password";
+                        multiSelect: "multiSelect";
+                        textarea: "textarea";
+                        hidden: "hidden";
+                        select: "select";
+                    }>;
+                    required: z.ZodOptional<z.ZodBoolean>;
+                    validation: z.ZodOptional<z.ZodObject<{
+                        minLength: z.ZodOptional<z.ZodNumber>;
+                        zodString: z.ZodString;
+                    }, z.core.$strip>>;
+                    defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    options: z.ZodOptional<z.ZodObject<{
+                        hookName: z.ZodOptional<z.ZodString>;
+                        queryString: z.ZodOptional<z.ZodString>;
+                        labelKey: z.ZodOptional<z.ZodString>;
+                        valueKey: z.ZodOptional<z.ZodString>;
+                        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type TApplicationSchema = z.infer<typeof ApplicationSchema>;
+type TModuleSchema = z.infer<typeof ModuleSchema>;
+
+/**
+ * User-related schemas - same as .ref/core/react/zodTypes.ts
+ */
+
+declare const LoginInputSchema: z.ZodObject<{
+    email: z.ZodEmail;
+    password: z.ZodString;
+}, z.core.$strip>;
+declare const SpecializationSchema: z.ZodObject<{
+    _id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+declare const UserSchema: z.ZodObject<{
+    _id: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    email: z.ZodEmail;
+    phoneNumber: z.ZodString;
+    profileImage: z.ZodOptional<z.ZodString>;
+    role: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        TRAINER: "TRAINER";
+        CLIENT: "CLIENT";
+    }>;
+    rate: z.ZodOptional<z.ZodNumber>;
+    specializations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        _id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    about: z.ZodOptional<z.ZodString>;
+    gender: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    averageRating: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const CreateUserInputSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    email: z.ZodEmail;
+    phoneNumber: z.ZodString;
+    password: z.ZodString;
+    role: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        TRAINER: "TRAINER";
+        CLIENT: "CLIENT";
+    }>;
+    rate: z.ZodOptional<z.ZodNumber>;
+    specializationIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    about: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const UpdateUserInputSchema: z.ZodObject<{
+    _id: z.ZodString;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEmail>;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    rate: z.ZodOptional<z.ZodNumber>;
+    specializationIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    about: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ForgotPasswordSchema: z.ZodObject<{
+    email: z.ZodEmail;
+}, z.core.$strip>;
+declare const ResetPasswordSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+    }>;
+    resetTicket: z.ZodString;
+    newPassword: z.ZodString;
+}, z.core.$strip>;
+type TLoginInputSchema = z.infer<typeof LoginInputSchema>;
+type TUserSchema = z.infer<typeof UserSchema>;
+type TSpecializationSchema = z.infer<typeof SpecializationSchema>;
+type TCreateUserInputSchema = z.infer<typeof CreateUserInputSchema>;
+type TUpdateUserInputSchema = z.infer<typeof UpdateUserInputSchema>;
+type TForgotPasswordSchema = z.infer<typeof ForgotPasswordSchema>;
+type TResetPasswordSchema = z.infer<typeof ResetPasswordSchema>;
+
+/**
+ * react-builder module types
+ */
+
+interface AppInfo {
+    projectName?: string;
+    projectDescription?: string;
+    modules?: string;
+    apiEndpoint?: string;
+}
+interface ReactBuilderAgentConfig {
+    /** User input: GraphQL schema string or instruction */
+    input: string;
+    /** Optional app info (project name, description, modules list) for context */
+    appInfo?: AppInfo;
+    /** Model config; optional */
+    model?: ModelConfig;
+    /** Max iterations; default 15 */
+    maxIterations?: number;
+    /** Callback for each step */
+    onStep?: (step: AgentStep) => void;
+}
+
+/**
+ * System prompt for GraphQL-to-frontend configuration conversion
+ */
+declare const REACT_BUILDER_SYSTEM_PROMPT = "You are an expert GraphQL-to-frontend configuration converter. Transform the provided GraphQL schema into a structured JSON configuration for rapid app development.\n\n**Your output must be valid JSON only.** No markdown code fences, no explanations. Return the raw JSON object matching the application schema (app with name, description, author, branding, apiEndpoint; modules array with name and pages; each page has type, name, route, isPrivate, api, and for listing pages: columns, actions, drawerCreate, drawerUpdate; for auth pages: fields when needed).\n\nStrict guidelines:\n- Use every available CRUD GraphQL query and mutation from the project schema.\n- Map GraphQL types to frontend modules and pages.\n- EmailAddress \u2192 \"type\": \"email\" with validation; DateTime \u2192 \"type\": \"date\"; enums \u2192 select with options.values.\n- Relationships \u2192 multiSelect with query-based options where appropriate.\n- Add isPrivate: true for authenticated operations.\n- Maintain camelCase. Ensure valid JSON syntax.";
+
+/**
+ * Instruction template for GraphQL-to-frontend conversion
+ */
+declare const REACT_BUILDER_INSTRUCTION: string;
+declare function buildInstructionPrompt(): string;
+
+/**
+ * Few-shot examples: example GraphQL schema and expected JSON output (abbreviated)
+ */
+declare const EXAMPLE_GRAPHQL_SCHEMA: string;
+declare const EXAMPLE_JSON_OUTPUT = "{\n  \"app\": {\n    \"name\": \"my-app\",\n    \"description\": \"App description\",\n    \"author\": \"Author\",\n    \"branding\": {\n      \"brandName\": \"MyBrand\",\n      \"primaryColor\": \"#333\",\n      \"secondaryColor\": \"#fff\",\n      \"logo\": \"https://example.com/logo.png\"\n    },\n    \"apiEndpoint\": \"http://localhost:4000/graphql\"\n  },\n  \"modules\": [\n    {\n      \"name\": \"auth\",\n      \"pages\": [\n        {\n          \"name\": \"LoginPage\",\n          \"type\": \"EmailPassword\",\n          \"route\": \"/login\",\n          \"isPrivate\": false,\n          \"api\": [\n            { \"type\": \"login\", \"graphqlHook\": \"useLoginMutation\", \"queryString\": \"mutation Login($data: LoginInput!) { login(data: $data) { accessToken } }\" }\n          ]\n        }\n      ]\n    },\n    {\n      \"name\": \"user\",\n      \"pages\": [\n        {\n          \"type\": \"Listing\",\n          \"name\": \"UserListPage\",\n          \"route\": \"/users\",\n          \"isPrivate\": true,\n          \"api\": [\n            { \"type\": \"list\", \"graphqlHook\": \"useGetAllUserQuery\", \"queryString\": \"query GetAllUser { getAllUser { _id firstName email } }\" },\n            { \"type\": \"create\", \"graphqlHook\": \"useCreateUserMutation\", \"queryString\": \"mutation CreateUser($data: CreateUserInput!) { createUser(data: $data) { _id } }\" }\n          ],\n          \"columns\": [{ \"field\": \"firstName\", \"label\": \"First Name\" }, { \"field\": \"email\", \"label\": \"Email\" }],\n          \"actions\": [\"create\", \"edit\", \"delete\"],\n          \"drawerCreate\": { \"title\": \"Create User\", \"graphqlHook\": \"useCreateUserMutation\", \"fields\": [{ \"name\": \"firstName\", \"type\": \"text\", \"required\": true }, { \"name\": \"email\", \"type\": \"email\", \"required\": true }] },\n          \"drawerUpdate\": { \"title\": \"Edit User\", \"graphqlHook\": \"useUpdateUserMutation\", \"fields\": [{ \"name\": \"firstName\", \"type\": \"text\" }, { \"name\": \"email\", \"type\": \"email\" }] }\n        }\n      ]\n    }\n  ]\n}";
+declare function buildExampleShotPrompt(): string;
+
+/**
+ * Feedback prompt - re-generate frontend config incorporating user feedback
+ */
+declare function buildFeedbackPrompt(userFeedback: string, schemaFile: string): string;
+
+/**
+ * validate_frontend_config tool - validates JSON against ApplicationSchema (no AI)
+ */
+declare const validateFrontendConfigTool: ai.Tool;
+
+declare function createGenerateFrontendTool(model: Model): ai.Tool;
+
+interface FeatureBreakdownResult {
+    summary: string;
+    modules: string[];
+    operations: string[];
+    suggestedPages?: string[];
+}
+declare function createGenerateFeatureBreakdownTool(model: Model): ai.Tool;
+
+declare function createReactBuilderTools(model: Model): ToolSet;
+
+/**
+ * graphql-analyzer subagent - analyzes GraphQL schemas (no tools)
+ */
+declare const graphqlAnalyzerSubagent: SubagentDefinition;
+
+/**
+ * config-validator subagent - validates frontend config (has validate_frontend_config tool)
+ */
+declare function createConfigValidatorSubagent(): SubagentDefinition;
+
+/**
+ * runReactBuilderAgent - orchestrator for frontend config generation with retry and subagents
+ */
+
+/**
+ * Run the react-builder orchestrator agent with all tools and subagents.
+ * Use generate_frontend tool for config generation; the tool may throw on parse failure (caller can retry with new input).
+ */
+declare function runReactBuilderAgent(config: ReactBuilderAgentConfig): Promise<AgentResult>;
+
+export { type Actor, type AgentConfig, AgentError, type AgentResult, type AgentStep, type AgentTool, type AgentToolResult, ApiResponseTypeSchema, AppConfigSchema, type AppInfo, ApplicationSchema, AuthPageApiSchema, AuthPageSchema, BaseMcpClient, BrandingSchema, ColumnSchema, type CreateSubagentToolOptions, CreateUserInputSchema, DB_DESIGN_SYSTEM_PROMPT, type DbDesignerAgentConfig, DrawerSchema, EXAMPLE_GRAPHQL_SCHEMA, EXAMPLE_JSON_OUTPUT, type ExtractedFlow, type ExtractedStory, type FeatureBreakdownResult, FieldOptionsSchema, ForgotPasswordSchema, FormFieldSchema, type HelloWorldAgentConfig, type ImageInput, type InvokeOptions, LibraryError, ListingPageApiSchema, ListingPageSchema, type LogLevel, type Logger, type LoggerConfig, LoginInputSchema, type McpClientConfig, type McpClientInfo, type McpResolveOptions, type McpToolContent, type McpTransport, type Model, type ModelConfig, ModelError, type ModelProvider, type ModelResponse, type ModelTool, type ModelToolCall, ModuleSchema, PageSchema, REACT_BUILDER_INSTRUCTION, REACT_BUILDER_SYSTEM_PROMPT, type ReactBuilderAgentConfig, ResetPasswordSchema, type RunSubagentOptions, SpecializationSchema, type StructuredRequirementsInput, type SubagentConfig, type SubagentDefinition, SubagentError, type SubagentResult, type TApiResponseTypeSchema, type TAppConfigSchema, type TApplicationSchema, type TBackendProjectSchema, type TBrandingSchema, type TColumnSchema, type TCreateUserInputSchema, type TFieldSchema, type TForgotPasswordSchema, type TFormFieldSchema, type TLoginInputSchema, type TModuleSchema$1 as TModuleSchema, type TPageSchema, type TModuleSchema as TReactModuleSchema, type TResetPasswordSchema, type TSpecializationSchema, type TUpdateUserInputSchema, type TUserSchema, type TechnicalRequirements, type ToolConfig, type ToolContext, ToolError, type ToolExecutionResult, type ToolLogger, type ToolSet, UpdateUserInputSchema, UserSchema, ValidationError, ValidationSchema, type VisionOptions, buildExampleShotPrompt, buildFeedbackPrompt, buildInstructionPrompt, buildPromptVariables, createAnthropicModel, createConfigValidatorSubagent, createDbDesignPrompt, createDbDesignerTools, createDesignDatabaseProTool, createDesignDatabaseTool, createGenerateFeatureBreakdownTool, createGenerateFrontendTool, createGoogleModel, createLogger, createModel, createOpenAIModel, createProDbDesignPrompt, createReactBuilderTools, createRedesignDatabaseTool, createRedesignPrompt, createSchemaRefinerSubagent, createSubagentTool, createSubagentToolSet, createToolSet, defineSubagent, defineTool, entityAnalyzerSubagent, executeTool, executeToolByName, extractDataEntities, extractRoles, fieldSchema, formatTechnicalRequirements, formatUserFlows, formatUserStories, formatUserTypes, getTool, getTools, graphqlAnalyzerSubagent, helloWorldTool, moduleSchema, projectSchema, runAgent, runDbDesignerAgent, runHelloWorldAgent, runReactBuilderAgent, runSubagent, sumTokenUsage, validateFrontendConfigTool, validateSchemaTool };