sweagent 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -1,8 +1,5 @@
 import { z } from 'zod';
 import pino from 'pino';
-import * as ai from 'ai';
-import { LanguageModelUsage, ModelMessage, Tool, FinishReason } from 'ai';
-export { FinishReason, LanguageModelUsage, ModelMessage, Tool, ToolExecutionOptions, jsonSchema, tool } from 'ai';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 /**
@@ -74,9 +71,96 @@ declare function parseModelJsonResponse<T>(text: string, schema: z.ZodType<T>):
  */
 declare function safeJsonParse(jsonStr: string, label?: string): unknown;
 
+/**
+ * Provider-agnostic types for messages, tools, and usage.
+ * Replaces imports from the Vercel AI SDK.
+ */
+
+/** Token usage details (optional per-provider) */
+interface TokenUsageDetails {
+    noCacheTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    textTokens?: number;
+    reasoningTokens?: number;
+}
+/** Token usage returned by model invocations */
+interface LanguageModelUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    inputTokenDetails?: TokenUsageDetails;
+    outputTokenDetails?: TokenUsageDetails;
+}
+/** Why the model stopped generating */
+type FinishReason = 'stop' | 'length' | 'tool-calls' | 'content-filter' | 'error' | 'other' | string;
+/** Content part for multimodal messages */
+type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    image: string;
+    mimeType?: string;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+} | {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    output: {
+        type: 'text';
+        value: string;
+    } | {
+        type: 'error-text';
+        value: string;
+    };
+};
+/** Single message in a conversation */
+type ModelMessage = {
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: string | ContentPart[];
+} | {
+    role: 'assistant';
+    content: string | ContentPart[];
+} | {
+    role: 'tool';
+    content: ContentPart[];
+};
+/** Options passed to tool execute function */
+interface ToolExecutionOptions {
+    toolCallId?: string;
+    messages?: ModelMessage[];
+    abortSignal?: AbortSignal;
+}
+/** JSON Schema object for tool parameters */
+type JsonSchemaObject = Record<string, unknown>;
+/** Tool definition: description, schema, optional execute */
+interface Tool<TInput = unknown, TOutput = unknown> {
+    description: string;
+    /** Zod schema or JSON schema for input; adapters convert to provider format */
+    parameters?: JsonSchemaObject;
+    inputSchema?: z.ZodType<TInput>;
+    execute?: (args: TInput, options?: ToolExecutionOptions) => Promise<TOutput>;
+}
+/** Create a tool from config (used by defineTool); inputSchema is Zod */
+interface ToolConfigInput {
+    description: string;
+    inputSchema: z.ZodType;
+    execute?: (args: unknown, options?: ToolExecutionOptions) => Promise<unknown>;
+}
+
 /**
  * Common types shared across modules
- * Re-exports AI SDK message types; keeps sweagent-specific ImageInput and Logger
+ * Re-exports message types; keeps sweagent-specific ImageInput and Logger
  */
 
 /**
@@ -151,12 +235,11 @@ declare function sumTokenUsage(usages: (LanguageModelUsage | undefined)[]): Lang
 
 /**
  * Model-related types
- * Uses AI SDK types for messages, tools, usage, and result shape
+ * Uses in-repo 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;
 /**
@@ -261,10 +344,25 @@ interface Model {
 }
 
 /**
- * Tool-related types
- * Re-exports AI SDK Tool, tool, jsonSchema, ToolExecutionOptions; keeps ToolConfig and ToolContext for defineTool
+ * Tool-related types and helpers
+ * Exports Tool, tool(), jsonSchema, ToolExecutionOptions; keeps ToolConfig and ToolContext for defineTool
  */
 
+/**
+ * Create a tool from description, inputSchema (Zod), and optional execute.
+ * Used by defineTool; adapters use description + parameters (JSON Schema) for provider APIs.
+ */
+declare function tool<TInput = unknown, TOutput = unknown>(config: ToolConfigInput & {
+    inputSchema: z.ZodType<TInput>;
+}): Tool<TInput, TOutput>;
+/**
+ * Wrap a Zod schema for structured output (e.g. invokeObject).
+ * Returns an object adapters can use to request JSON matching the schema.
+ */
+declare function jsonSchema<T>(schema: z.ZodType<T>): {
+    schema: z.ZodType<T>;
+    jsonSchema: Record<string, unknown>;
+};
 /**
  * Configuration for defining a tool (input to defineTool)
  */
@@ -309,6 +407,57 @@ interface ToolExecutionResult<T = unknown> {
     error?: string;
 }
 
+/**
+ * Types for the handleSteps generator pattern.
+ * Adapted from redxpilot's AgentDefinition.handleSteps.
+ *
+ * A generator that yields tool calls (executed programmatically),
+ * 'STEP' (one LLM call), 'STEP_ALL' (LLM until done),
+ * or GENERATE_N (multiple LLM responses for best-of-N).
+ */
+
+/** Yield this to run the LLM for exactly one step. */
+type StepOnce = 'STEP';
+/** Yield this to run the LLM until it stops calling tools. */
+type StepAll = 'STEP_ALL';
+/** Yield this to request N parallel LLM responses (best-of-N). */
+interface GenerateN {
+    type: 'GENERATE_N';
+    n: number;
+}
+/** Yield a tool call for programmatic (non-LLM) execution. */
+interface ProgrammaticToolCall {
+    toolName: string;
+    input: unknown;
+}
+/** Everything a generator can yield. */
+type HandleStepsYield = ProgrammaticToolCall | StepOnce | StepAll | GenerateN;
+/** Data passed back into the generator after each yield. */
+interface HandleStepsResume {
+    /** Current messages in the conversation */
+    messages: ModelMessage[];
+    /** Result of the last tool call (if the yield was a tool call) */
+    toolResult?: unknown;
+    /** Whether the LLM indicated it's done (for STEP_ALL) */
+    stepsComplete: boolean;
+    /** Responses from GENERATE_N */
+    nResponses?: string[];
+    /** Steps taken so far */
+    steps: AgentStep[];
+}
+/** Context passed to the handleSteps generator function. */
+interface HandleStepsContext {
+    /** The user's input */
+    input: string;
+    /** Additional params passed to the agent */
+    params?: Record<string, unknown>;
+    logger?: Logger;
+}
+/** The generator type for handleSteps. */
+type HandleStepsGenerator = Generator<HandleStepsYield, void, HandleStepsResume>;
+/** The function signature for handleSteps. */
+type HandleStepsFn = (context: HandleStepsContext) => HandleStepsGenerator;
+
 /**
  * Agent-related types
  * Uses AI SDK types for messages, tool calls/results, and usage
@@ -333,9 +482,10 @@ interface AgentToolResult {
  * Multiple observers can be attached via AgentConfig.observers.
  */
 interface AgentObserver {
-    onStep?(step: AgentStep): void;
+    onStep?(step: AgentStep, cumulativeUsage?: LanguageModelUsage): void;
     onToolExecution?(toolName: string, result: unknown): void;
     onError?(error: Error): void;
+    onTokenBudgetWarning?(used: number, budget: number): void;
 }
 /**
  * Configuration for running an agent
@@ -357,6 +507,14 @@ interface AgentConfig {
     observers?: AgentObserver[];
     /** Optional logger for agent execution */
     logger?: Logger;
+    /** Max context window tokens; triggers pruning when exceeded (default 200k) */
+    maxContextTokens?: number;
+    /** Max total tokens (input+output) the agent may consume before stopping */
+    tokenBudget?: number;
+    /** Generator function for programmatic + LLM hybrid control flow */
+    handleSteps?: HandleStepsFn;
+    /** Prompt injected before each LLM step (e.g. reminders, constraints) */
+    stepPrompt?: string;
 }
 /**
  * A single step in the agent's execution
@@ -372,6 +530,8 @@ interface AgentStep {
     toolResults?: AgentToolResult[];
     /** Token usage for this step */
     usage?: LanguageModelUsage;
+    /** Cumulative token usage up to and including this step */
+    cumulativeUsage?: LanguageModelUsage;
 }
 /**
  * Result of running an agent
@@ -412,6 +572,22 @@ interface SubagentConfig {
     maxIterations?: number;
     /** Callback for each step */
     onStep?: (step: AgentStep) => void;
+    /** Observers forwarded to the agent loop */
+    observers?: AgentObserver[];
+    /** Prompt shown in the parent's tool description when this subagent is exposed as a tool */
+    spawnerPrompt?: string;
+    /** If true, prepend the parent's system prompt to the subagent's system prompt */
+    inheritParentSystemPrompt?: boolean;
+    /** Zod schema for validating the agent's final structured output */
+    outputSchema?: z.ZodType;
+    /** Prompt injected before each LLM step (reminders, constraints) */
+    stepPrompt?: string;
+    /** Generator for programmatic + LLM hybrid control */
+    handleSteps?: HandleStepsFn;
+    /** Max context window tokens; triggers pruning when exceeded */
+    maxContextTokens?: number;
+    /** Max total tokens the subagent may consume */
+    tokenBudget?: number;
 }
 /**
  * Validated subagent definition (returned by defineSubagent)
@@ -433,26 +609,140 @@ interface SubagentResult extends AgentResult {
  */
 
 /**
- * Run an agent with the given configuration.
+ * Run an agent loop: invoke model, execute tools, repeat until done.
+ * Supports context pruning (maxContextTokens) and token budgets.
+ */
+declare function runAgent(config: AgentConfig): Promise<AgentResult>;
+
+/**
+ * Agent loop with handleSteps generator support.
+ * Alternates between programmatic steps and LLM steps.
+ */
+
+/**
+ * Run an agent that uses handleSteps for hybrid programmatic+LLM control.
+ * The generator decides when to execute tools and when to hand off to the LLM.
+ */
+declare function runAgentWithSteps(config: AgentConfig): Promise<AgentResult>;
+
+/**
+ * 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;
+interface ExecuteToolOptions {
+    toolCallId?: string;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+}
+declare function executeTool<TInput, TOutput>(toolImpl: Tool<TInput, TOutput>, input: TInput, options?: ExecuteToolOptions & {
+    toolName?: string;
+}): Promise<ToolExecutionResult<TOutput>>;
+declare function executeToolByName(tools: ToolSet, name: string, input: unknown, options?: ExecuteToolOptions): Promise<ToolExecutionResult>;
+
+/**
+ * Propose-before-finalize tools: propose_output and finalize_output.
+ * Adapted from redxpilot's propose_str_replace / propose_write_file pattern.
  *
- * 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
+ * Agents produce a proposed artifact, review it, then finalize.
+ */
+
+/**
+ * Create the propose/finalize tool pair for a given run.
+ * Returns a record with `propose_output`, `finalize_output`, and `list_proposals`.
+ */
+declare function createProposalTools(runId: string): Record<string, Tool>;
+
+/**
+ * Programmatic step engine for the handleSteps generator pattern.
+ * Adapted from redxpilot's run-programmatic-step.ts.
  *
- * @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);
- * ```
+ * Executes yields from a HandleStepsGenerator:
+ * - Tool calls → execute programmatically, resume generator with result
+ * - 'STEP' → signal caller to run one LLM step
+ * - 'STEP_ALL' → signal caller to run LLM until it ends
+ * - GENERATE_N → signal caller to produce N responses
+ */
+
+type ProgrammaticAction = {
+    type: 'step';
+} | {
+    type: 'step_all';
+} | {
+    type: 'generate_n';
+    n: number;
+} | {
+    type: 'done';
+};
+interface RunProgrammaticStepOptions {
+    generator: HandleStepsGenerator;
+    tools: ToolSet;
+    messages: ModelMessage[];
+    steps: AgentStep[];
+    logger?: Logger;
+    lastToolResult?: unknown;
+    stepsComplete?: boolean;
+    nResponses?: string[];
+}
+/**
+ * Advance the generator until it yields a control signal (STEP/STEP_ALL/GENERATE_N)
+ * or completes. Tool call yields are executed inline.
+ */
+declare function runProgrammaticStep(opts: RunProgrammaticStepOptions): Promise<ProgrammaticAction>;
+
+/**
+ * Best-of-N generation: produce multiple LLM responses and select the best.
+ * Adapted from redxpilot's GENERATE_N pattern.
  */
-declare function runAgent(config: AgentConfig): Promise<AgentResult>;
+
+interface GenerateNOptions {
+    model: Model;
+    messages: ModelMessage[];
+    n: number;
+    invokeOptions?: InvokeOptions;
+    logger?: Logger;
+}
+interface GenerateNResult {
+    responses: ModelResponse[];
+    texts: string[];
+}
+/**
+ * Generate N independent responses from the model for the same message context.
+ * Returns all responses so a selector can choose the best one.
+ */
+declare function generateNResponses(options: GenerateNOptions): Promise<GenerateNResult>;
+
+/**
+ * Response selection strategies for best-of-N generation.
+ * Supports heuristic (length-based) and LLM-as-judge selection.
+ */
+
+interface SelectionResult {
+    selectedIndex: number;
+    selectedText: string;
+    reason?: string;
+}
+/**
+ * Select the longest response (simple heuristic: more detail = better).
+ */
+declare function selectByLength(responses: string[]): SelectionResult;
+interface JudgeOptions {
+    model: Model;
+    responses: string[];
+    criteria: string;
+    logger?: Logger;
+}
+/**
+ * Use an LLM as a judge to pick the best response based on criteria.
+ * The judge sees all candidates and returns the index of the best one.
+ */
+declare function selectByJudge(options: JudgeOptions): Promise<SelectionResult>;
 
 /**
  * Create a model instance based on provider
@@ -477,7 +767,7 @@ declare function runAgent(config: AgentConfig): Promise<AgentResult>;
 declare function createModel(config: ModelConfig): Model;
 
 /**
- * OpenAI model provider using AI SDK
+ * OpenAI model provider using the official openai package
  */
 
 /**
@@ -486,7 +776,7 @@ declare function createModel(config: ModelConfig): Model;
 declare function createOpenAIModel(config: ModelConfig): Model;
 
 /**
- * Anthropic model provider using AI SDK
+ * Anthropic model provider using the official @anthropic-ai/sdk package
  */
 
 /**
@@ -495,7 +785,7 @@ declare function createOpenAIModel(config: ModelConfig): Model;
 declare function createAnthropicModel(config: ModelConfig): Model;
 
 /**
- * Google (Gemini) model provider using AI SDK
+ * Google (Gemini) model provider using the official @google/genai package
  */
 
 /**
@@ -503,58 +793,31 @@ declare function createAnthropicModel(config: ModelConfig): Model;
  */
 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;
-interface ExecuteToolOptions {
-    toolCallId?: string;
-    abortSignal?: AbortSignal;
-    logger?: Logger;
-}
-declare function executeTool<TInput, TOutput>(toolImpl: Tool<TInput, TOutput>, input: TInput, options?: ExecuteToolOptions & {
-    toolName?: string;
-}): Promise<ToolExecutionResult<TOutput>>;
-declare function executeToolByName(tools: ToolSet, name: string, input: unknown, options?: ExecuteToolOptions): 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.
+ * Validates and creates a subagent definition.
  */
 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;
+    /** Parent's system prompt; used when inheritParentSystemPrompt is true */
+    parentSystemPrompt?: string;
 }
 /**
- * Executes the subagent in isolation: resolves tools and model, runs runAgent, returns SubagentResult.
+ * Run a subagent. Supports handleSteps, outputSchema validation,
+ * inherited system prompts, stepPrompt, and token budgets.
  */
 declare function runSubagent(definition: SubagentDefinition, input: string, options?: RunSubagentOptions): Promise<SubagentResult>;
 interface CreateSubagentToolOptions {
     parentTools?: Record<string, AgentTool>;
     parentModel?: Model;
+    parentSystemPrompt?: string;
 }
-/**
- * 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;
 
 /**
@@ -655,6 +918,124 @@ declare function scaffoldProject(config: ScaffoldConfig): Promise<ScaffoldResult
 /** Register common Handlebars helpers */
 declare function registerHelpers(): void;
 
+/**
+ * In-memory store for proposed outputs before finalization.
+ * Adapted from redxpilot's proposed-content-store.
+ *
+ * Keyed by runId + artifact name so multiple proposals can coexist.
+ * Consumers call propose() to store a draft, then finalize() to commit it.
+ */
+interface ProposedEntry<T = unknown> {
+    artifact: string;
+    data: T;
+    proposedAt: number;
+}
+/**
+ * Store a proposed artifact for later review/finalization.
+ */
+declare function propose<T>(runId: string, artifact: string, data: T): ProposedEntry<T>;
+/**
+ * Retrieve a proposed artifact (returns undefined if not found).
+ */
+declare function getProposed<T = unknown>(runId: string, artifact: string): ProposedEntry<T> | undefined;
+/**
+ * List all proposed artifacts for a run.
+ */
+declare function listProposed(runId: string): ProposedEntry[];
+/**
+ * Finalize: remove from proposed store and return the data.
+ * Returns undefined if not found.
+ */
+declare function finalize(runId: string, artifact: string): unknown | undefined;
+/**
+ * Discard a proposal without finalizing.
+ */
+declare function discard(runId: string, artifact: string): boolean;
+/**
+ * Clear all proposals for a run (cleanup after run completes).
+ */
+declare function clearRun(runId: string): void;
+
+/**
+ * Token estimation utilities.
+ * Adapted from redxpilot's context-pruner: approximate token count
+ * from JSON-serialized length (1 token ≈ 3 characters).
+ */
+/**
+ * Estimate the number of tokens in an arbitrary value by serializing to JSON.
+ * Useful for budget checks without calling a tokenizer.
+ */
+declare function estimateTokens(value: unknown): number;
+/**
+ * Estimate total tokens in a message array (the main context window).
+ */
+declare function estimateMessagesTokens(messages: unknown[]): number;
+
+/**
+ * Text truncation utilities.
+ * Adapted from redxpilot's context-pruner: 80/20 truncation preserves
+ * the beginning (most context) and end (most recent) of long text.
+ */
+/**
+ * Truncate text that exceeds `limit` characters.
+ * Keeps 80% from the start and 20% from the end, with a marker in between.
+ */
+declare function truncateText(text: string, limit: number): string;
+/**
+ * Truncate text to a target token count (approximate).
+ * Converts token limit to a character limit and delegates to truncateText.
+ */
+declare function truncateToTokens(text: string, maxTokens: number): string;
+
+/**
+ * Rule-based message summarization.
+ * Adapted from redxpilot's context-pruner: deterministic summarization
+ * per message role, keeping errors and key tool results.
+ */
+
+/**
+ * Summarize a single message based on its role.
+ * Returns a plain-text summary string.
+ */
+declare function summarizeMessage(message: ModelMessage): string;
+/**
+ * Summarize an array of messages into a single conversation summary string.
+ * Preserves the most recent `keepRecentCount` messages verbatim.
+ */
+declare function summarizeMessages(messages: ModelMessage[], keepRecentCount?: number): {
+    summary: string;
+    kept: ModelMessage[];
+};
+
+/**
+ * Context pruner: automatic context window management.
+ * Adapted from redxpilot's context-pruner. Deterministic (no LLM call).
+ *
+ * When estimated tokens exceed the budget, older messages are replaced
+ * with a compact summary, keeping recent messages and the system prompt intact.
+ */
+
+interface PruneOptions {
+    maxContextTokens?: number;
+    keepRecentCount?: number;
+    logger?: Logger;
+}
+interface PruneResult {
+    pruned: boolean;
+    beforeTokens: number;
+    afterTokens: number;
+}
+/**
+ * Prune a message array in-place when it exceeds the token budget.
+ *
+ * Strategy:
+ * 1. Estimate token count of all messages.
+ * 2. If under budget, return immediately (no-op).
+ * 3. Otherwise, summarize older messages into a compact summary.
+ * 4. Replace the messages array contents with [system, summary, ...recent].
+ */
+declare function pruneContext(messages: ModelMessage[], options?: PruneOptions): PruneResult;
+
 /**
  * MCP client types - transport, config, and response shapes
  * for the Model Context Protocol client infrastructure.
@@ -763,7 +1144,7 @@ declare function findTool(name: string): AgentToolEntry | undefined;
 /**
  * Hello World tool
  */
-declare const helloWorldTool: ai.Tool;
+declare const helloWorldTool: Tool<unknown, unknown>;
 
 /**
  * Hello World agent - runs an agent with the hello world tool
@@ -834,9 +1215,9 @@ declare const FormFieldSchema: z.ZodObject<{
     name: z.ZodString;
     type: z.ZodEnum<{
         number: "number";
-        date: "date";
         text: "text";
         image: "image";
+        date: "date";
         multiSelect: "multiSelect";
         email: "email";
         password: "password";
@@ -916,9 +1297,9 @@ declare const DrawerSchema: z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
-            date: "date";
             text: "text";
             image: "image";
+            date: "date";
             multiSelect: "multiSelect";
             email: "email";
             password: "password";
@@ -974,9 +1355,9 @@ declare const AuthPageSchema: z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
-            date: "date";
             text: "text";
             image: "image";
+            date: "date";
             multiSelect: "multiSelect";
             email: "email";
             password: "password";
@@ -1033,9 +1414,9 @@ declare const ListingPageSchema: z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<{
                 number: "number";
-                date: "date";
                 text: "text";
                 image: "image";
+                date: "date";
                 multiSelect: "multiSelect";
                 email: "email";
                 password: "password";
@@ -1065,9 +1446,9 @@ declare const ListingPageSchema: z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<{
                 number: "number";
-                date: "date";
                 text: "text";
                 image: "image";
+                date: "date";
                 multiSelect: "multiSelect";
                 email: "email";
                 password: "password";
@@ -1124,9 +1505,9 @@ declare const PageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
-            date: "date";
             text: "text";
             image: "image";
+            date: "date";
             multiSelect: "multiSelect";
             email: "email";
             password: "password";
@@ -1182,9 +1563,9 @@ declare const PageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<{
                 number: "number";
-                date: "date";
                 text: "text";
                 image: "image";
+                date: "date";
                 multiSelect: "multiSelect";
                 email: "email";
                 password: "password";
@@ -1214,9 +1595,9 @@ declare const PageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<{
                 number: "number";
-                date: "date";
                 text: "text";
                 image: "image";
+                date: "date";
                 multiSelect: "multiSelect";
                 email: "email";
                 password: "password";
@@ -1281,9 +1662,9 @@ declare const ModuleSchema: z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<{
                 number: "number";
-                date: "date";
                 text: "text";
                 image: "image";
+                date: "date";
                 multiSelect: "multiSelect";
                 email: "email";
                 password: "password";
@@ -1339,9 +1720,9 @@ declare const ModuleSchema: z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodEnum<{
                     number: "number";
-                    date: "date";
                     text: "text";
                     image: "image";
+                    date: "date";
                     multiSelect: "multiSelect";
                     email: "email";
                     password: "password";
@@ -1371,9 +1752,9 @@ declare const ModuleSchema: z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodEnum<{
                     number: "number";
-                    date: "date";
                     text: "text";
                     image: "image";
+                    date: "date";
                     multiSelect: "multiSelect";
                     email: "email";
                     password: "password";
@@ -1446,9 +1827,9 @@ declare const ApplicationSchema: z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodEnum<{
                     number: "number";
-                    date: "date";
                     text: "text";
                     image: "image";
+                    date: "date";
                     multiSelect: "multiSelect";
                     email: "email";
                     password: "password";
@@ -1504,9 +1885,9 @@ declare const ApplicationSchema: z.ZodObject<{
                     name: z.ZodString;
                     type: z.ZodEnum<{
                         number: "number";
-                        date: "date";
                         text: "text";
                         image: "image";
+                        date: "date";
                         multiSelect: "multiSelect";
                         email: "email";
                         password: "password";
@@ -1536,9 +1917,9 @@ declare const ApplicationSchema: z.ZodObject<{
                     name: z.ZodString;
                     type: z.ZodEnum<{
                         number: "number";
-                        date: "date";
                         text: "text";
                         image: "image";
+                        date: "date";
                         multiSelect: "multiSelect";
                         email: "email";
                         password: "password";
@@ -1671,6 +2052,8 @@ interface ReactBuilderAgentConfig {
     onStep?: (step: AgentStep) => void;
     /** Optional logger for execution logs */
     logger?: Logger;
+    /** When true, exclude scaffold tools that write files to disk (used in MCP mode) */
+    disableScaffold?: boolean;
 }
 
 /**
@@ -1699,9 +2082,9 @@ declare function buildFeedbackPrompt(userFeedback: string, schemaFile: string):
 /**
  * validate_frontend_config tool - validates JSON against ApplicationSchema (no AI)
  */
-declare const validateFrontendConfigTool: ai.Tool;
+declare const validateFrontendConfigTool: Tool<unknown, unknown>;
 
-declare function createGenerateFrontendTool(model: Model): ai.Tool;
+declare function createGenerateFrontendTool(model: Model): Tool<unknown, unknown>;
 
 interface FeatureBreakdownResult {
     summary: string;
@@ -1709,9 +2092,17 @@ interface FeatureBreakdownResult {
     operations: string[];
     suggestedPages?: string[];
 }
-declare function createGenerateFeatureBreakdownTool(model: Model): ai.Tool;
+declare function createGenerateFeatureBreakdownTool(model: Model): Tool<unknown, unknown>;
 
-declare function createReactBuilderTools(model: Model): ToolSet;
+/**
+ * react-builder tools
+ */
+
+interface ReactBuilderToolsOptions {
+    /** When true, exclude scaffold tools that write files to disk */
+    disableScaffold?: boolean;
+}
+declare function createReactBuilderTools(model: Model, options?: ReactBuilderToolsOptions): ToolSet;
 
 /**
  * graphql-analyzer subagent - analyzes GraphQL schemas (no tools)
@@ -3117,42 +3508,42 @@ declare function buildPromptVariables(input: MongoStructuredInput): Record<strin
 /**
  * validate_schema tool - validates JSON against dataModelDesignSchema (no AI)
  */
-declare const validateSchemaTool: ai.Tool;
+declare const validateSchemaTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_schema tool. Requires a model for generation.
  */
-declare function createDesignSchemaTool(model: Model): ai.Tool;
+declare function createDesignSchemaTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Creates the design_schema_pro tool for structured 5-phase data modeling.
  */
-declare function createDesignSchemaProTool(model: Model): ai.Tool;
+declare function createDesignSchemaProTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Creates the refine_schema tool for iterating on an existing data model.
  */
-declare function createRefineSchemaTools(model: Model): ai.Tool;
+declare function createRefineSchemaTools(model: Model): Tool<unknown, unknown>;
 
 /**
  * validate_schema tool - validates JSON against mongoProjectSchema (merged from db-designer)
  */
-declare const validateMongoSchemaTool: ai.Tool;
+declare const validateMongoSchemaTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_database tool for MongoDB schema generation.
  */
-declare function createDesignDatabaseTool(model: Model): ai.Tool;
+declare function createDesignDatabaseTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Creates the design_database_pro tool for structured 5-phase MongoDB analysis.
  */
-declare function createDesignDatabaseProTool(model: Model): ai.Tool;
+declare function createDesignDatabaseProTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Creates the redesign_database tool for iterating on MongoDB schemas.
  */
-declare function createRedesignDatabaseTool(model: Model): ai.Tool;
+declare function createRedesignDatabaseTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all generic data-modeler tools. Pass the model for AI-backed tools.
@@ -3252,7 +3643,7 @@ declare const graphqlOperationSchema: z.ZodObject<{
 declare const apiDesignSchema: z.ZodObject<{
     style: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"rest" | "graphql", unknown>>;
     baseUrl: z.ZodDefault<z.ZodString>;
-    endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    endpoints: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         resource: z.ZodString;
         method: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodEnum<{
@@ -3283,8 +3674,8 @@ declare const apiDesignSchema: z.ZodObject<{
         }, Record<string, unknown>>>;
         validation: z.ZodPipe<z.ZodDefault<z.ZodArray<z.ZodUnknown>>, z.ZodTransform<string[], unknown[]>>;
         errorResponses: z.ZodPipe<z.ZodDefault<z.ZodArray<z.ZodUnknown>>, z.ZodTransform<string[], unknown[]>>;
-    }, z.core.$strip>>>;
-    graphqlOperations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    }, z.core.$strip>>>>;
+    graphqlOperations: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             query: "query";
@@ -3300,7 +3691,7 @@ declare const apiDesignSchema: z.ZodObject<{
             required: z.ZodCoercedBoolean<unknown>;
         }, z.core.$strip>>;
         returnType: z.ZodString;
-    }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 type TApiDesign = z.infer<typeof apiDesignSchema>;
 
@@ -3364,17 +3755,17 @@ declare const API_DESIGNER_SYSTEM_PROMPT = "You are a senior API architect speci
 /**
  * validate_api tool - validates JSON against apiDesignSchema (no AI)
  */
-declare const validateApiTool: ai.Tool;
+declare const validateApiTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_api tool for plain text requirements.
  */
-declare function createDesignApiTool(model: Model): ai.Tool;
+declare function createDesignApiTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Creates the design_api_pro tool for structured API design.
  */
-declare function createDesignApiProTool(model: Model): ai.Tool;
+declare function createDesignApiProTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all api-designer tools. Pass the model for AI-backed tools.
@@ -3540,12 +3931,12 @@ declare function buildDesignAuthPrompt(requirement: string): string;
 /**
  * validate_auth tool - validates JSON against authDesignSchema (no AI)
  */
-declare const validateAuthTool: ai.Tool;
+declare const validateAuthTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_auth tool for auth flow generation.
  */
-declare function createDesignAuthTool(model: Model): ai.Tool;
+declare function createDesignAuthTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all auth-designer tools. Pass the model for AI-backed tools.
@@ -3716,12 +4107,12 @@ declare function buildDesignFrontendPrompt(requirement: string): string;
 /**
  * validate_frontend tool - validates JSON against frontendDesignSchema (no AI)
  */
-declare const validateFrontendTool: ai.Tool;
+declare const validateFrontendTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_frontend tool for frontend architecture generation.
  */
-declare function createDesignFrontendTool(model: Model): ai.Tool;
+declare function createDesignFrontendTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all frontend-architect tools. Pass the model for AI-backed tools.
@@ -3874,12 +4265,12 @@ declare function buildCreateExecutionPlanPrompt(context: string): string;
 /**
  * validate_execution_plan tool - validates JSON against executionPlanSchema (no AI)
  */
-declare const validateExecutionPlanTool: ai.Tool;
+declare const validateExecutionPlanTool: Tool<unknown, unknown>;
 
 /**
  * Creates the create_execution_plan tool for generating phased plans.
  */
-declare function createExecutionPlanTool(model: Model): ai.Tool;
+declare function createExecutionPlanTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all execution-planner tools. Pass the model for AI-backed tools.
@@ -4023,12 +4414,12 @@ declare function buildDesignBackendPrompt(requirement: string): string;
 /**
  * validate_backend tool - validates JSON against backendDesignSchema (no AI)
  */
-declare const validateBackendTool: ai.Tool;
+declare const validateBackendTool: Tool<unknown, unknown>;
 
 /**
  * Creates the design_backend tool for backend architecture generation.
  */
-declare function createDesignBackendTool(model: Model): ai.Tool;
+declare function createDesignBackendTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all backend-architect tools. Pass the model for AI-backed tools.
@@ -4244,6 +4635,8 @@ interface ApolloBuilderAgentConfig {
     onStep?: (step: AgentStep) => void;
     /** Optional logger for execution logs */
     logger?: Logger;
+    /** When true, exclude scaffold tools that write files to disk (used in MCP mode) */
+    disableScaffold?: boolean;
 }
 
 /**
@@ -4260,22 +4653,30 @@ declare function buildDesignSubgraphPrompt(requirement: string): string;
 /**
  * validate_subgraph tool - validates JSON against subgraphConfigSchema (no AI)
  */
-declare const validateSubgraphTool: ai.Tool;
+declare const validateSubgraphTool: Tool<unknown, unknown>;
 
 /**
  * Creates the generate_subgraph tool for Apollo subgraph config generation.
  */
-declare function createGenerateSubgraphTool(model: Model): ai.Tool;
+declare function createGenerateSubgraphTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * scaffold_subgraph tool - compiles .ref/templates/subgraph/ with config
  */
-declare const scaffoldSubgraphTool: ai.Tool;
+declare const scaffoldSubgraphTool: Tool<unknown, unknown>;
 
+/**
+ * apollo-builder tools
+ */
+
+interface ApolloBuilderToolsOptions {
+    /** When true, exclude scaffold tools that write files to disk */
+    disableScaffold?: boolean;
+}
 /**
  * Create all apollo-builder tools. Pass the model for AI-backed tools.
  */
-declare function createApolloBuilderTools(model: Model): ToolSet;
+declare function createApolloBuilderTools(model: Model, options?: ApolloBuilderToolsOptions): ToolSet;
 
 /**
  * schema-generator subagent - generates GraphQL type definitions from data model
@@ -4359,10 +4760,10 @@ declare const modelSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const middlewareConfigSchema: z.ZodObject<{
     name: z.ZodString;
-    type: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<"validation" | "custom" | "auth" | "errorHandler" | "cors" | "rateLimit" | "logging", string>>, z.ZodEnum<{
-        validation: "validation";
+    type: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<"custom" | "auth" | "validation" | "errorHandler" | "cors" | "rateLimit" | "logging", string>>, z.ZodEnum<{
         custom: "custom";
         auth: "auth";
+        validation: "validation";
         errorHandler: "errorHandler";
         cors: "cors";
         rateLimit: "rateLimit";
@@ -4410,10 +4811,10 @@ declare const expressConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     middleware: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
-        type: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<"validation" | "custom" | "auth" | "errorHandler" | "cors" | "rateLimit" | "logging", string>>, z.ZodEnum<{
-            validation: "validation";
+        type: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<"custom" | "auth" | "validation" | "errorHandler" | "cors" | "rateLimit" | "logging", string>>, z.ZodEnum<{
             custom: "custom";
             auth: "auth";
+            validation: "validation";
             errorHandler: "errorHandler";
             cors: "cors";
             rateLimit: "rateLimit";
@@ -4440,6 +4841,8 @@ interface ExpressBuilderAgentConfig {
     onStep?: (step: AgentStep) => void;
     /** Optional logger for execution logs */
     logger?: Logger;
+    /** When true, exclude scaffold tools that write files to disk (used in MCP mode) */
+    disableScaffold?: boolean;
 }
 
 /**
@@ -4456,22 +4859,30 @@ declare function buildDesignExpressPrompt(requirement: string): string;
 /**
  * validate_express tool - validates JSON against expressConfigSchema (no AI)
  */
-declare const validateExpressTool: ai.Tool;
+declare const validateExpressTool: Tool<unknown, unknown>;
 
 /**
  * Creates the generate_express tool for Express config generation.
  */
-declare function createGenerateExpressTool(model: Model): ai.Tool;
+declare function createGenerateExpressTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * scaffold_express tool - compiles .ref/templates/express/ with config
  */
-declare const scaffoldExpressTool: ai.Tool;
+declare const scaffoldExpressTool: Tool<unknown, unknown>;
+
+/**
+ * express-builder tools
+ */
 
+interface ExpressBuilderToolsOptions {
+    /** When true, exclude scaffold tools that write files to disk */
+    disableScaffold?: boolean;
+}
 /**
  * Create all express-builder tools. Pass the model for AI-backed tools.
  */
-declare function createExpressBuilderTools(model: Model): ToolSet;
+declare function createExpressBuilderTools(model: Model, options?: ExpressBuilderToolsOptions): ToolSet;
 
 /**
  * route-generator subagent - generates route files from API design
@@ -4621,12 +5032,12 @@ declare function buildDesignNextjsPrompt(requirement: string): string;
 /**
  * validate_nextjs tool - validates JSON against nextjsConfigSchema (no AI)
  */
-declare const validateNextjsTool: ai.Tool;
+declare const validateNextjsTool: Tool<unknown, unknown>;
 
 /**
  * Creates the generate_nextjs tool for Next.js config generation.
  */
-declare function createGenerateNextjsTool(model: Model): ai.Tool;
+declare function createGenerateNextjsTool(model: Model): Tool<unknown, unknown>;
 
 /**
  * Create all nextjs-builder tools. Pass the model for AI-backed tools.
@@ -4652,4 +5063,41 @@ declare const apiRouteGeneratorSubagent: SubagentDefinition;
  */
 declare function runNextjsBuilderAgent(config: NextjsBuilderAgentConfig): Promise<AgentResult>;
 
-export { API_DESIGNER_SYSTEM_PROMPT, APOLLO_BUILDER_SYSTEM_PROMPT, AUTH_DESIGNER_SYSTEM_PROMPT, type ActorResult, type ApiDesign as AdApiDesign, type GraphqlOperation as AdGraphqlOperation, type RestEndpoint as AdRestEndpoint, type AgentConfig, AgentError, type AgentObserver, type AgentResult, type AgentStep, type AgentTool, type AgentToolEntry, type AgentToolInput, type AgentToolResult, type ApiDesignerAgentConfig, ApiResponseTypeSchema, type ApiStyle, type ApolloBuilderAgentConfig, AppConfigSchema, type AppInfo, ApplicationSchema, type AuthDesign, type AuthDesignerAgentConfig, type AuthFlow, type AuthFlowStep, type AuthMiddleware, AuthPageApiSchema, AuthPageSchema, type AuthStrategy, BACKEND_ARCHITECT_SYSTEM_PROMPT, type BackendArchitectAgentConfig, BaseMcpClient, type BasicProjectInfo, BrandingSchema, CREATE_EXECUTION_PLAN_PROMPT, type ChatEntry$2 as ChatEntry, type ChatTurnResult, ColumnSchema, type ComponentDesign, type CreateSubagentToolOptions, CreateUserInputSchema, type CrudApi, DATA_MODELER_SYSTEM_PROMPT, MONGODB_SYSTEM_PROMPT as DB_DESIGN_SYSTEM_PROMPT, DESIGN_AUTH_PROMPT, DESIGN_BACKEND_PROMPT, DESIGN_DATABASE_SYSTEM_PROMPT, DESIGN_EXPRESS_PROMPT, DESIGN_FRONTEND_PROMPT, DESIGN_NEXTJS_PROMPT, DESIGN_SUBGRAPH_PROMPT, DISCOVERY_SYSTEM_FRAGMENT, DISCOVERY_USER_PROMPT, type DataEntity, type DataModelDesign, type DataModelerAgentConfig, type DatabaseDesign$1 as DatabaseDesign, type DatabaseEntity$1 as DatabaseEntity, type DatabaseType, type MongoDbDesignerAgentConfig as DbDesignerAgentConfig, type EntityField as DmEntityField, type EntityIndex as DmEntityIndex, type EntityRelation as DmEntityRelation, DrawerSchema, EXAMPLE_GRAPHQL_SCHEMA, EXAMPLE_JSON_OUTPUT, EXECUTION_PLANNER_SYSTEM_PROMPT, EXPRESS_BUILDER_SYSTEM_PROMPT, EXTRACT_ACTORS_PROMPT, EXTRACT_MODULES_PROMPT, type EdgeCase, type EditPlanConfig, type EntityField$2 as EntityField, type EntityIndex$2 as EntityIndex, type EntityRelation$2 as EntityRelation, type ExecutionPlan, type ExecutionPlannerAgentConfig, type ExpressBuilderAgentConfig, type ExtractedModule, FRONTEND_ARCHITECT_SYSTEM_PROMPT, type FeatureBreakdownResult, FieldOptionsSchema, type FinalRequirement, type FlowsResult, ForgotPasswordSchema, type FormField, FormFieldSchema, type FrontendArchitectAgentConfig, type FrontendDesign, GENERATE_FLOWS_PROMPT, GENERATE_STORIES_PROMPT, type HelloWorldAgentConfig, type HttpMethod, type ImageInput, type ImplementationPhase, type InvokeObjectOptions, type InvokeObjectResult, type InvokeOptions, LibraryError, ListingPageApiSchema, ListingPageSchema, type LogLevel, type Logger, type LoggerConfig, LoginInputSchema, MONGODB_SYSTEM_PROMPT, type McpClientConfig, type McpClientInfo, type McpResolveOptions, type McpToolContent, type McpTransport, type Model, type ModelConfig, ModelError, type ModelProvider, type ModelResponse, type ModelTool, type ModelToolCall, type Module, ModuleSchema, type ModulesResult, type MongoActor, type MongoDbDesignerAgentConfig, type MongoExtractedFlow, type MongoExtractedStory, type MongoStructuredInput, type MongoTechnicalRequirements, NEXTJS_BUILDER_SYSTEM_PROMPT, type NextjsBuilderAgentConfig, PLANNING_SYSTEM_PROMPT, type PageAccess, type PageDesign, PageSchema, type PhaseStep, type PlanChatTurnResult, type PlanFromRequirementsConfig, type PlanSections, type PlanStageResult, type PlanningAgentConfig, type PlanningChatConfig, type ChatEntry as PlanningChatEntry, type PlanningContext, PlanningContextBuilder, type Stage as PlanningStage, type ProjectBrief, type Question$1 as Question, REACT_BUILDER_INSTRUCTION, REACT_BUILDER_SYSTEM_PROMPT, REQUIREMENT_GATHERER_SYSTEM_PROMPT, type ReactBuilderAgentConfig, type RequirementChatConfig, type RequirementContext, RequirementContextBuilder, type RequirementGathererAgentConfig, type RequirementSummary$1 as RequirementSummary, ResetPasswordSchema, type RoleDefinition, type RunSubagentOptions, SYNTHESIS_SYSTEM_FRAGMENT, SYNTHESIS_USER_PROMPT, type ScaffoldConfig, type ScaffoldError, type ScaffoldResult, type SecurityPolicy, SpecializationSchema, type Stage$1 as Stage, type StageInput, type StoriesResult, type SubagentConfig, type SubagentDefinition, SubagentError, type SubagentResult, type TApiDesign, type TApiResponseTypeSchema, type TAppConfigSchema, type TApplicationSchema, type TAuthDesign, type TBackendDesign, type TMongoProjectSchema as TBackendProjectSchema, type TBrandingSchema, type TColumnSchema, type TCreateUserInputSchema, type TDataModelDesign, type TExecutionPlan, type TExpressConfig, type TForgotPasswordSchema, type TFormFieldSchema, type TFrontendDesign, type TLoginInputSchema, type TMongoFieldSchema, type TMongoModuleSchema, type TMongoProjectSchema, type TNextjsConfig, TOOL_REGISTRY, type TPageSchema, type TModuleSchema as TReactModuleSchema, type TResetPasswordSchema, type TSpecializationSchema, type TSubgraphConfig, type TUpdateUserInputSchema, type TUserSchema, type TemplateAuth, type TemplateBranding, type TemplateContext, type TemplateField, type TemplateModule, type TemplateOperation, type TestChecklistItem, type ToolConfig, type ToolContext, ToolError, type ToolExecutionResult, type ToolLogger, type ToolSet, UpdateUserInputSchema, UserSchema, ValidationError, ValidationSchema, type VisionOptions, actorSchema, actorsResultSchema, apiDesignSchema as adApiDesignSchema, graphqlOperationSchema as adGraphqlOperationSchema, restEndpointSchema as adRestEndpointSchema, addChatEntry, advanceStage, apiRouteGeneratorSubagent, assemblePlan, authDesignSchema, authFlowSchema, authFlowStepSchema, authMiddlewareSchema, backendDesignSchema, buildCreateExecutionPlanPrompt, buildDesignAuthPrompt, buildDesignBackendPrompt, buildDesignDatabasePrompt, buildDesignExpressPrompt, buildDesignFrontendPrompt, buildDesignNextjsPrompt, buildDesignSubgraphPrompt, buildDiscoveryPrompt, buildExampleShotPrompt, buildExtractActorsPrompt, buildExtractModulesPrompt, buildFeedbackPrompt, buildGenerateFlowsPrompt, buildGenerateStoriesPrompt, buildInstructionPrompt, buildPromptVariables, buildSynthesisPrompt, chatEntrySchema, compileTemplate, componentAnalyzerSubagent, componentDesignSchema, contractDesignerSubagent, convertRequirementToContext, createAnthropicModel, createApiDesignerTools, createApolloBuilderTools, createAuthDesignerTools, createBackendArchitectTools, createConfigValidatorSubagent, createDataModelerTools, createMongoDesignPrompt as createDbDesignPrompt, createDbDesignerTools, createDesignApiProTool, createDesignApiTool, createDesignAuthTool, createDesignBackendTool, createDesignDatabaseProTool, createDesignDatabaseTool, createDesignFrontendTool, createDesignSchemaProTool, createDesignSchemaTool, createExecutionPlanTool, createExecutionPlannerTools, createExpressBuilderTools, createFrontendArchitectTools, createGenerateExpressTool, createGenerateFeatureBreakdownTool, createGenerateFrontendTool, createGenerateNextjsTool, createGenerateSubgraphTool, createGoogleModel, createInitialContext, createLogger, createModel, createMongoDesignPrompt, createMongoProDesignPrompt, createMongoRedesignPrompt, createNextjsBuilderTools, createOpenAIModel, createPlanningContextBuilder, createMongoProDesignPrompt as createProDbDesignPrompt, createReactBuilderTools, createRedesignDatabaseTool, createMongoRedesignPrompt as createRedesignPrompt, createRefineSchemaTools, createRequirementContextBuilder, createSchemaRefinerSubagent, createSubagentTool, createSubagentToolSet, createSweagentServer, createToolSet, crudApiSchema, databaseDesignSchema, databaseEntitySchema, defineSubagent, defineTool, createSchemaRefinerSubagent as dmCreateSchemaRefinerSubagent, dataEntitySchema as dmDataEntitySchema, dataModelDesignSchema as dmDataModelDesignSchema, entityAnalyzerSubagent as dmEntityAnalyzerSubagent, validateSchemaTool as dmValidateSchemaTool, edgeCaseAnalyzerSubagent, edgeCaseSchema, editPlan, endpointAnalyzerSubagent, entityAnalyzerSubagent, entityFieldSchema, entityIndexSchema, entityRelationSchema, executeTool, executeToolByName, executionPlanSchema, expressConfigSchema, extractDataEntities, extractJson, extractRoles, extractedModuleSchema, mongoFieldSchema as fieldSchema, finalRequirementSchema, findTool, flowDesignerSubagent, flowSchema, flowsResultSchema, formFieldSchema, formatTechnicalRequirements, formatUserFlows, formatUserStories, formatUserTypes, frameworkSelectorSubagent, frontendDesignSchema, getTool, getTools, graphqlAnalyzerSubagent, graphqlFieldSchema, graphqlTypeSchema, helloWorldTool, implementationPhaseSchema, loggerConfigFromEnv, mergeStageResult, middlewareConfigSchema, middlewareConfiguratorSubagent, middlewareSchema, modelFieldSchema, modelSchema, mongoModuleSchema as moduleSchema, modulesResultSchema, mongoFieldSchema, mongoModuleSchema, mongoProjectSchema, nextjsApiRouteSchema, nextjsConfigSchema, nextjsLayoutSchema, nextjsPageSchema, pageDesignSchema, pagePlannerSubagent, parseModelJsonResponse, phaseStepSchema, processPlanningChat, processRequirementChat, projectBriefSchema, mongoProjectSchema as projectSchema, questionSchema, registerHelpers, relationshipMapperSubagent, requirementContextSchema, requirementSummarySchema, resolverOperationSchema, resolverPlannerSubagent, roleDefinitionSchema, routeGeneratorSubagent, routeGroupSchema, routePlannerSubagent, routerMethodSchema, routerSchema, runAgent, runApiDesignerAgent, runApolloBuilderAgent, runAuthDesignerAgent, runBackendArchitectAgent, runDataModelerAgent, runDbDesignerAgent, runExecutionPlannerAgent, runExpressBuilderAgent, runFrontendArchitectAgent, runHelloWorldAgent, runNextjsBuilderAgent, runPlanningAgent, runPlanningFromRequirements, runReactBuilderAgent, runRequirementGathererAgent, runSubagent, safeJsonParse, scaffoldExpressTool, scaffoldProject, scaffoldSubgraphTool, schemaGeneratorSubagent, securityAnalyzerSubagent, securityPolicySchema, serverActionSchema, servicePlannerSubagent, serviceSchema, storiesResultSchema, storySchema, subgraphConfigSchema, subgraphModuleSchema, sumTokenUsage, testChecklistItemSchema, testingStrategistSubagent, validateApiTool, validateAuthTool, validateBackendTool, validateExecutionPlanTool, validateExpressTool, validateFrontendConfigTool, validateFrontendTool, validateNextjsTool, validateMongoSchemaTool as validateSchemaTool, validateSubgraphTool, writePlanToFile };
+/**
+ * Full pipeline types - config and result shapes for the end-to-end pipeline.
+ */
+
+/** Configuration for running the full pipeline. */
+interface FullPipelineConfig {
+    /** Natural language description of the app to build. */
+    input: string;
+    /** Optional model override (defaults to openai/gpt-4o-mini). */
+    model?: ModelConfig;
+    /** Max iterations per agent step (defaults to 15). */
+    maxIterations?: number;
+    /** Callback invoked after each agent step. */
+    onStep?: (step: AgentStep) => void;
+    /** Optional logger for pipeline execution. */
+    logger?: Logger;
+}
+/** Result of a single pipeline step. */
+interface PipelineStepResult {
+    name: string;
+    key: string;
+    output: string;
+}
+
+/**
+ * runFullPipelineAgent - orchestrates the full 7-agent pipeline end-to-end.
+ *
+ * Runs: Requirements -> Data Model -> API -> Auth -> Backend -> Frontend -> Execution Plan.
+ * Each agent's output feeds as context into the next.
+ */
+
+/**
+ * Run the full pipeline: 7 domain agents chained sequentially.
+ * Returns a combined specification document.
+ */
+declare function runFullPipelineAgent(config: FullPipelineConfig): Promise<AgentResult>;
+
+export { API_DESIGNER_SYSTEM_PROMPT, APOLLO_BUILDER_SYSTEM_PROMPT, AUTH_DESIGNER_SYSTEM_PROMPT, type ActorResult, type ApiDesign as AdApiDesign, type GraphqlOperation as AdGraphqlOperation, type RestEndpoint as AdRestEndpoint, type AgentConfig, AgentError, type AgentObserver, type AgentResult, type AgentStep, type AgentTool, type AgentToolEntry, type AgentToolInput, type AgentToolResult, type ApiDesignerAgentConfig, ApiResponseTypeSchema, type ApiStyle, type ApolloBuilderAgentConfig, AppConfigSchema, type AppInfo, ApplicationSchema, type AuthDesign, type AuthDesignerAgentConfig, type AuthFlow, type AuthFlowStep, type AuthMiddleware, AuthPageApiSchema, AuthPageSchema, type AuthStrategy, BACKEND_ARCHITECT_SYSTEM_PROMPT, type BackendArchitectAgentConfig, BaseMcpClient, type BasicProjectInfo, BrandingSchema, CREATE_EXECUTION_PLAN_PROMPT, type ChatEntry$2 as ChatEntry, type ChatTurnResult, ColumnSchema, type ComponentDesign, type CreateSubagentToolOptions, CreateUserInputSchema, type CrudApi, DATA_MODELER_SYSTEM_PROMPT, MONGODB_SYSTEM_PROMPT as DB_DESIGN_SYSTEM_PROMPT, DESIGN_AUTH_PROMPT, DESIGN_BACKEND_PROMPT, DESIGN_DATABASE_SYSTEM_PROMPT, DESIGN_EXPRESS_PROMPT, DESIGN_FRONTEND_PROMPT, DESIGN_NEXTJS_PROMPT, DESIGN_SUBGRAPH_PROMPT, DISCOVERY_SYSTEM_FRAGMENT, DISCOVERY_USER_PROMPT, type DataEntity, type DataModelDesign, type DataModelerAgentConfig, type DatabaseDesign$1 as DatabaseDesign, type DatabaseEntity$1 as DatabaseEntity, type DatabaseType, type MongoDbDesignerAgentConfig as DbDesignerAgentConfig, type EntityField as DmEntityField, type EntityIndex as DmEntityIndex, type EntityRelation as DmEntityRelation, DrawerSchema, EXAMPLE_GRAPHQL_SCHEMA, EXAMPLE_JSON_OUTPUT, EXECUTION_PLANNER_SYSTEM_PROMPT, EXPRESS_BUILDER_SYSTEM_PROMPT, EXTRACT_ACTORS_PROMPT, EXTRACT_MODULES_PROMPT, type EdgeCase, type EditPlanConfig, type EntityField$2 as EntityField, type EntityIndex$2 as EntityIndex, type EntityRelation$2 as EntityRelation, type ExecutionPlan, type ExecutionPlannerAgentConfig, type ExpressBuilderAgentConfig, type ExtractedModule, FRONTEND_ARCHITECT_SYSTEM_PROMPT, type FeatureBreakdownResult, FieldOptionsSchema, type FinalRequirement, type FinishReason, type FlowsResult, ForgotPasswordSchema, type FormField, FormFieldSchema, type FrontendArchitectAgentConfig, type FrontendDesign, type FullPipelineConfig, GENERATE_FLOWS_PROMPT, GENERATE_STORIES_PROMPT, type GenerateN, type GenerateNOptions, type GenerateNResult, type HandleStepsContext, type HandleStepsFn, type HandleStepsGenerator, type HandleStepsResume, type HandleStepsYield, type HelloWorldAgentConfig, type HttpMethod, type ImageInput, type ImplementationPhase, type InvokeObjectOptions, type InvokeObjectResult, type InvokeOptions, type JudgeOptions, type LanguageModelUsage, LibraryError, ListingPageApiSchema, ListingPageSchema, type LogLevel, type Logger, type LoggerConfig, LoginInputSchema, MONGODB_SYSTEM_PROMPT, type McpClientConfig, type McpClientInfo, type McpResolveOptions, type McpToolContent, type McpTransport, type Model, type ModelConfig, ModelError, type ModelMessage, type ModelProvider, type ModelResponse, type ModelTool, type ModelToolCall, type Module, ModuleSchema, type ModulesResult, type MongoActor, type MongoDbDesignerAgentConfig, type MongoExtractedFlow, type MongoExtractedStory, type MongoStructuredInput, type MongoTechnicalRequirements, NEXTJS_BUILDER_SYSTEM_PROMPT, type NextjsBuilderAgentConfig, PLANNING_SYSTEM_PROMPT, type PageAccess, type PageDesign, PageSchema, type PhaseStep, type PipelineStepResult, type PlanChatTurnResult, type PlanFromRequirementsConfig, type PlanSections, type PlanStageResult, type PlanningAgentConfig, type PlanningChatConfig, type ChatEntry as PlanningChatEntry, type PlanningContext, PlanningContextBuilder, type Stage as PlanningStage, type ProgrammaticAction, type ProgrammaticToolCall, type ProjectBrief, type ProposedEntry, type PruneOptions, type PruneResult, type Question$1 as Question, REACT_BUILDER_INSTRUCTION, REACT_BUILDER_SYSTEM_PROMPT, REQUIREMENT_GATHERER_SYSTEM_PROMPT, type ReactBuilderAgentConfig, type RequirementChatConfig, type RequirementContext, RequirementContextBuilder, type RequirementGathererAgentConfig, type RequirementSummary$1 as RequirementSummary, ResetPasswordSchema, type RoleDefinition, type RunSubagentOptions, SYNTHESIS_SYSTEM_FRAGMENT, SYNTHESIS_USER_PROMPT, type ScaffoldConfig, type ScaffoldError, type ScaffoldResult, type SecurityPolicy, type SelectionResult, SpecializationSchema, type Stage$1 as Stage, type StageInput, type StepAll, type StepOnce, type StoriesResult, type SubagentConfig, type SubagentDefinition, SubagentError, type SubagentResult, type TApiDesign, type TApiResponseTypeSchema, type TAppConfigSchema, type TApplicationSchema, type TAuthDesign, type TBackendDesign, type TMongoProjectSchema as TBackendProjectSchema, type TBrandingSchema, type TColumnSchema, type TCreateUserInputSchema, type TDataModelDesign, type TExecutionPlan, type TExpressConfig, type TForgotPasswordSchema, type TFormFieldSchema, type TFrontendDesign, type TLoginInputSchema, type TMongoFieldSchema, type TMongoModuleSchema, type TMongoProjectSchema, type TNextjsConfig, TOOL_REGISTRY, type TPageSchema, type TModuleSchema as TReactModuleSchema, type TResetPasswordSchema, type TSpecializationSchema, type TSubgraphConfig, type TUpdateUserInputSchema, type TUserSchema, type TemplateAuth, type TemplateBranding, type TemplateContext, type TemplateField, type TemplateModule, type TemplateOperation, type TestChecklistItem, type Tool, type ToolConfig, type ToolContext, ToolError, type ToolExecutionOptions, type ToolExecutionResult, type ToolLogger, type ToolSet, UpdateUserInputSchema, UserSchema, ValidationError, ValidationSchema, type VisionOptions, actorSchema, actorsResultSchema, apiDesignSchema as adApiDesignSchema, graphqlOperationSchema as adGraphqlOperationSchema, restEndpointSchema as adRestEndpointSchema, addChatEntry, advanceStage, apiRouteGeneratorSubagent, assemblePlan, authDesignSchema, authFlowSchema, authFlowStepSchema, authMiddlewareSchema, backendDesignSchema, buildCreateExecutionPlanPrompt, buildDesignAuthPrompt, buildDesignBackendPrompt, buildDesignDatabasePrompt, buildDesignExpressPrompt, buildDesignFrontendPrompt, buildDesignNextjsPrompt, buildDesignSubgraphPrompt, buildDiscoveryPrompt, buildExampleShotPrompt, buildExtractActorsPrompt, buildExtractModulesPrompt, buildFeedbackPrompt, buildGenerateFlowsPrompt, buildGenerateStoriesPrompt, buildInstructionPrompt, buildPromptVariables, buildSynthesisPrompt, chatEntrySchema, clearRun, compileTemplate, componentAnalyzerSubagent, componentDesignSchema, contractDesignerSubagent, convertRequirementToContext, createAnthropicModel, createApiDesignerTools, createApolloBuilderTools, createAuthDesignerTools, createBackendArchitectTools, createConfigValidatorSubagent, createDataModelerTools, createMongoDesignPrompt as createDbDesignPrompt, createDbDesignerTools, createDesignApiProTool, createDesignApiTool, createDesignAuthTool, createDesignBackendTool, createDesignDatabaseProTool, createDesignDatabaseTool, createDesignFrontendTool, createDesignSchemaProTool, createDesignSchemaTool, createExecutionPlanTool, createExecutionPlannerTools, createExpressBuilderTools, createFrontendArchitectTools, createGenerateExpressTool, createGenerateFeatureBreakdownTool, createGenerateFrontendTool, createGenerateNextjsTool, createGenerateSubgraphTool, createGoogleModel, createInitialContext, createLogger, createModel, createMongoDesignPrompt, createMongoProDesignPrompt, createMongoRedesignPrompt, createNextjsBuilderTools, createOpenAIModel, createPlanningContextBuilder, createMongoProDesignPrompt as createProDbDesignPrompt, createProposalTools, createReactBuilderTools, createRedesignDatabaseTool, createMongoRedesignPrompt as createRedesignPrompt, createRefineSchemaTools, createRequirementContextBuilder, createSchemaRefinerSubagent, createSubagentTool, createSubagentToolSet, createSweagentServer, createToolSet, crudApiSchema, databaseDesignSchema, databaseEntitySchema, defineSubagent, defineTool, discard, createSchemaRefinerSubagent as dmCreateSchemaRefinerSubagent, dataEntitySchema as dmDataEntitySchema, dataModelDesignSchema as dmDataModelDesignSchema, entityAnalyzerSubagent as dmEntityAnalyzerSubagent, validateSchemaTool as dmValidateSchemaTool, edgeCaseAnalyzerSubagent, edgeCaseSchema, editPlan, endpointAnalyzerSubagent, entityAnalyzerSubagent, entityFieldSchema, entityIndexSchema, entityRelationSchema, estimateMessagesTokens, estimateTokens, executeTool, executeToolByName, executionPlanSchema, expressConfigSchema, extractDataEntities, extractJson, extractRoles, extractedModuleSchema, mongoFieldSchema as fieldSchema, finalRequirementSchema, finalize, findTool, flowDesignerSubagent, flowSchema, flowsResultSchema, formFieldSchema, formatTechnicalRequirements, formatUserFlows, formatUserStories, formatUserTypes, frameworkSelectorSubagent, frontendDesignSchema, generateNResponses, getProposed, getTool, getTools, graphqlAnalyzerSubagent, graphqlFieldSchema, graphqlTypeSchema, helloWorldTool, implementationPhaseSchema, jsonSchema, listProposed, loggerConfigFromEnv, mergeStageResult, middlewareConfigSchema, middlewareConfiguratorSubagent, middlewareSchema, modelFieldSchema, modelSchema, mongoModuleSchema as moduleSchema, modulesResultSchema, mongoFieldSchema, mongoModuleSchema, mongoProjectSchema, nextjsApiRouteSchema, nextjsConfigSchema, nextjsLayoutSchema, nextjsPageSchema, pageDesignSchema, pagePlannerSubagent, parseModelJsonResponse, phaseStepSchema, processPlanningChat, processRequirementChat, projectBriefSchema, mongoProjectSchema as projectSchema, propose, pruneContext, questionSchema, registerHelpers, relationshipMapperSubagent, requirementContextSchema, requirementSummarySchema, resolverOperationSchema, resolverPlannerSubagent, roleDefinitionSchema, routeGeneratorSubagent, routeGroupSchema, routePlannerSubagent, routerMethodSchema, routerSchema, runAgent, runAgentWithSteps, runApiDesignerAgent, runApolloBuilderAgent, runAuthDesignerAgent, runBackendArchitectAgent, runDataModelerAgent, runDbDesignerAgent, runExecutionPlannerAgent, runExpressBuilderAgent, runFrontendArchitectAgent, runFullPipelineAgent, runHelloWorldAgent, runNextjsBuilderAgent, runPlanningAgent, runPlanningFromRequirements, runProgrammaticStep, runReactBuilderAgent, runRequirementGathererAgent, runSubagent, safeJsonParse, scaffoldExpressTool, scaffoldProject, scaffoldSubgraphTool, schemaGeneratorSubagent, securityAnalyzerSubagent, securityPolicySchema, selectByJudge, selectByLength, serverActionSchema, servicePlannerSubagent, serviceSchema, storiesResultSchema, storySchema, subgraphConfigSchema, subgraphModuleSchema, sumTokenUsage, summarizeMessage, summarizeMessages, testChecklistItemSchema, testingStrategistSubagent, tool, truncateText, truncateToTokens, validateApiTool, validateAuthTool, validateBackendTool, validateExecutionPlanTool, validateExpressTool, validateFrontendConfigTool, validateFrontendTool, validateNextjsTool, validateMongoSchemaTool as validateSchemaTool, validateSubgraphTool, writePlanToFile };