@evalops/maestro 0.10.51 → 0.10.53

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG","sourcesContent":["/**\n * @fileoverview Core Type Definitions for Maestro Agent\n *\n * This module defines the fundamental types used throughout the Maestro AI system,\n * including message formats, tool definitions, model configurations, and agent state.\n *\n * ## Type Categories\n *\n * ### Message Types\n * - {@link UserMessage} - Messages from the human user\n * - {@link AssistantMessage} - Responses from the AI assistant\n * - {@link ToolResultMessage} - Results from tool executions\n * - {@link Message} - Union of all message types\n *\n * ### Content Types\n * - {@link TextContent} - Plain text content blocks\n * - {@link ImageContent} - Base64-encoded images\n * - {@link ThinkingContent} - Extended reasoning traces\n * - {@link ToolCall} - Tool invocation requests\n *\n * ### Tool Types\n * - {@link Tool} - Tool definition schema (for API)\n * - {@link AgentTool} - Tool with execute function (for runtime)\n * - {@link AgentToolResult} - Return value from tool execution\n *\n * ### Configuration Types\n * - {@link Model} - LLM model configuration\n * - {@link AgentState} - Current state of an agent\n * - {@link AgentRunConfig} - Runtime configuration\n *\n * @module agent/types\n */\n\nimport type { GuardedFilesPolicySettings } from \"@evalops/contracts\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport type { PromptProjectDocManifest } from \"../config/index.js\";\nimport type { UnifiedContextManifest } from \"../context/manifest-types.js\";\nimport type { PromptMetadata } from \"../prompts/types.js\";\nimport type { SkillArtifactMetadata } from \"../skills/artifact-metadata.js\";\nimport type { CheckpointProfiler } from \"../utils/checkpoint-profiler.js\";\nimport type {\n\tActionApprovalDecision,\n\tActionApprovalRequest,\n} from \"./action-approval.js\";\nimport type { ToolCapabilityMetadata } from \"./tool-capability-types.js\";\nimport type { ToolRetryDecision, ToolRetryRequest } from \"./tool-retry.js\";\n\n/**\n * API format identifier for different LLM provider APIs.\n *\n * Each provider may support different API formats:\n * - `openai-completions` - OpenAI Chat Completions API\n * - `openai-responses` - OpenAI Responses API (newer format)\n * - `openai-codex-responses` - ChatGPT Codex Responses backend\n * - `openai-codex-app-server` - Local Codex app-server with ChatGPT sign-in\n * - `anthropic-messages` - Anthropic Messages API\n * - `google-generative-ai` - Google Generative AI (Gemini)\n * - `google-gemini-cli` - Google Cloud Code Assist (Gemini CLI)\n * - `bedrock-converse` - AWS Bedrock Converse API\n * - `scripted-replay` - Deterministic local scenario replay provider\n */\nexport type Api =\n\t| \"openai-completions\"\n\t| \"openai-responses\"\n\t| \"openai-codex-responses\"\n\t| \"openai-codex-app-server\"\n\t| \"anthropic-messages\"\n\t| \"google-generative-ai\"\n\t| \"google-gemini-cli\"\n\t| \"bedrock-converse\"\n\t| \"vertex-ai\"\n\t| \"scripted-replay\";\n\nexport interface OpenAICompatOverrides {\n\tsupportsStore?: boolean;\n\tsupportsDeveloperRole?: boolean;\n\tsupportsReasoningEffort?: boolean;\n\tsupportsResponsesApi?: boolean;\n\t/** Supports Anthropic-style cache_control (OpenRouter with Claude models) */\n\tsupportsCacheControl?: boolean;\n\tmaxTokensField?: \"max_tokens\" | \"max_completion_tokens\";\n\trequiresToolResultName?: boolean;\n\trequiresAssistantAfterToolResult?: boolean;\n\trequiresThinkingAsText?: boolean;\n\trequiresMistralToolIds?: boolean;\n}\n\n/**\n * Well-known LLM provider identifiers.\n *\n * These are the officially supported providers with built-in configurations:\n * - `anthropic` - Anthropic (Claude models)\n * - `bedrock` - AWS Bedrock\n * - `google` - Google AI (Gemini models)\n * - `openai` - OpenAI (GPT models)\n * - `azure-openai` - Azure OpenAI\n * - `writer` - Writer.com\n * - `xai` - xAI (Grok models)\n * - `groq` - Groq\n * - `cerebras` - Cerebras\n * - `openrouter` - OpenRouter (aggregator)\n * - `zai` - Z.ai (Zhipu GLM)\n * - `deepseek` - DeepSeek\n * - `moonshot` - Moonshot AI (Kimi)\n * - `dashscope` - Alibaba Qwen (DashScope)\n * - `minimax` - MiniMax\n */\nexport type KnownProvider =\n\t| \"anthropic\"\n\t| \"bedrock\"\n\t| \"google\"\n\t| \"openai\"\n\t| \"openai-codex\"\n\t| \"azure-openai\"\n\t| \"writer\"\n\t| \"xai\"\n\t| \"groq\"\n\t| \"cerebras\"\n\t| \"openrouter\"\n\t| \"zai\"\n\t| \"deepseek\"\n\t| \"moonshot\"\n\t| \"dashscope\"\n\t| \"minimax\";\n\n/**\n * Provider identifier - either a known provider or a custom string.\n * Custom providers can be used with OpenAI-compatible APIs.\n */\nexport type Provider = KnownProvider | string;\n\n/**\n * Reasoning effort level for models that support extended thinking.\n *\n * Higher levels produce more detailed reasoning at increased latency:\n * - `minimal` - Brief chain-of-thought hints\n * - `low` - Short reasoning steps\n * - `medium` - Moderate reasoning depth (recommended default)\n * - `high` - Thorough step-by-step reasoning\n * - `ultra` - Maximum reasoning depth (for complex problems)\n *\n * Note: Claude Code uses keywords \"think\", \"think hard\", \"think harder\", \"ultrathink\"\n * which map to low, medium, high, ultra respectively.\n */\nexport type ReasoningEffort = \"minimal\" | \"low\" | \"medium\" | \"high\" | \"ultra\";\n\n/**\n * Plain text content block within a message.\n *\n * @example\n * ```typescript\n * const content: TextContent = {\n *   type: \"text\",\n *   text: \"Hello, how can I help you today?\"\n * };\n * ```\n */\nexport interface TextContent {\n\t/** Discriminator for content block type */\n\ttype: \"text\";\n\t/** The text content */\n\ttext: string;\n\t/** Optional signature for content verification */\n\ttextSignature?: string;\n}\n\n/**\n * Extended thinking/reasoning content block.\n *\n * Contains the model's internal reasoning process when extended\n * thinking is enabled. This is typically hidden from end users\n * but useful for debugging and understanding model behavior.\n */\nexport interface ThinkingContent {\n\t/** Discriminator for content block type */\n\ttype: \"thinking\";\n\t/** The thinking/reasoning trace */\n\tthinking: string;\n\t/** Optional signature for content verification */\n\tthinkingSignature?: string;\n}\n\n/**\n * Base64-encoded image content block.\n *\n * Used for including images in user messages (vision input)\n * or tool results (screenshots, generated images).\n *\n * @example\n * ```typescript\n * const image: ImageContent = {\n *   type: \"image\",\n *   data: \"iVBORw0KGgo...\", // base64 encoded\n *   mimeType: \"image/png\"\n * };\n * ```\n */\nexport interface ImageContent {\n\t/** Discriminator for content block type */\n\ttype: \"image\";\n\t/** Base64-encoded image data */\n\tdata: string;\n\t/** MIME type (e.g., \"image/png\", \"image/jpeg\") */\n\tmimeType: string;\n}\n\n/**\n * Tool invocation request within an assistant message.\n *\n * When the model decides to use a tool, it emits a ToolCall\n * content block specifying which tool to call and with what arguments.\n *\n * @example\n * ```typescript\n * const toolCall: ToolCall = {\n *   type: \"toolCall\",\n *   id: \"call_abc123\",\n *   name: \"read\",\n *   arguments: { file_path: \"/src/index.ts\" }\n * };\n * ```\n */\nexport interface ToolCall {\n\t/** Discriminator for content block type */\n\ttype: \"toolCall\";\n\t/** Unique identifier for this tool call (used to match results) */\n\tid: string;\n\t/** Name of the tool to invoke */\n\tname: string;\n\t/** Arguments to pass to the tool */\n\targuments: Record<string, unknown>;\n\t/**\n\t * Provider-specific signature used by some APIs (notably Gemini 3) to\n\t * associate tool calls with preceding thoughts. If present, it must be\n\t * preserved across turns when replaying the message history back to the provider.\n\t */\n\tthoughtSignature?: string;\n}\n\nexport type ToolSchedulingDecisionKind =\n\t| \"scheduled\"\n\t| \"parallelized\"\n\t| \"delayed\"\n\t| \"serialized\"\n\t| \"cached\"\n\t| \"skipped\";\n\nexport interface ToolSchedulingDecision {\n\t/** Tool call identifier; duplicated here for standalone telemetry use. */\n\tcallId: string;\n\t/** Tool name, never arguments. */\n\ttoolName: string;\n\t/** Zero-based order from the model-emitted tool-call list. */\n\temittedIndex: number;\n\t/** Scheduler wave number when the call entered an execution wave. */\n\twaveIndex?: number;\n\t/** Scheduler outcome for this call. */\n\tdecision: ToolSchedulingDecisionKind;\n\t/** Stable reason code; intentionally avoids raw paths and arguments. */\n\treason: string;\n\t/** Time spent waiting inside the scheduler after model emission. */\n\tschedulerWaitMs?: number;\n\t/** True when an MCP server opt-in made the call parallel-safe. */\n\tmcpOptIn?: boolean;\n\t/** True when execution was served from reusable tool-result state. */\n\tcacheHit?: boolean;\n\t/** True when an in-flight mutation forced a wait or serialization. */\n\tblockedByMutation?: boolean;\n}\n\nexport type ToolPhaseDecisionOutcome =\n\t| \"parallelized\"\n\t| \"serialized\"\n\t| \"delayed\"\n\t| \"cached\"\n\t| \"skipped\";\n\nexport interface ToolPhaseDecision {\n\ttoolCallId: string;\n\ttoolName: string;\n\temittedIndex: number;\n\toutcome: ToolPhaseDecisionOutcome;\n\tdecision: ToolPhaseDecisionOutcome;\n\treason: string;\n\twaveIndex?: number;\n\twaitMs: number;\n\tschedulerWaitMs: number;\n\tmcpOptIn?: boolean;\n\tcacheHit?: boolean;\n\tblockedByMutation?: boolean;\n}\n\nexport interface ParallelismScopeMetadata {\n\tpathScope?: string[];\n\tpathScopeSource?: \"annotation\" | \"known_tool\";\n\tpathArgumentKeys?: string[];\n}\n\nexport interface ParallelismGatedEvent extends ParallelismScopeMetadata {\n\ttype: \"parallelism_gated\";\n\ttoolCallId: string;\n\ttoolName: string;\n\treason: \"mutation_scope_overlap\" | \"mutation_unknown_write_set\";\n\tqueueDepth: number;\n\tpendingMutations: number;\n\tpendingToolCallIds: string[];\n\tpendingToolNames: string[];\n}\n\nexport interface ParallelConflictDetectedEvent\n\textends ParallelismScopeMetadata {\n\ttype: \"parallel_conflict_detected\";\n\ttoolCallId: string;\n\ttoolName: string;\n\tconflictingToolCallId: string;\n\tconflictingToolName: string;\n\tconflictingPathScope?: string[];\n\tconflictingPathScopeSource?: \"annotation\" | \"known_tool\";\n}\n\nexport interface ToolPhaseBatchShapingFeedback {\n\tavoidableSingleton: boolean;\n\treason: string;\n\thint: string;\n}\n\nexport interface ToolPhaseSummary {\n\ttype: \"tool_phase_summary\";\n\tmodelToolCallCount: number;\n\tmodelEmittedToolCallCount: number;\n\tschedulableWaveCount: number;\n\tparallelizedCallCount: number;\n\tactuallyParallelizedCallCount: number;\n\tserializedCallCount: number;\n\tdelayedCallCount: number;\n\tblockedByMutationCount: number;\n\tmcpOptInCallCount: number;\n\tmcpOptInUseCount: number;\n\tcacheHitCount: number;\n\ttotalToolWaitMs: number;\n\ttoolWaitTimeMs: number;\n\tserializationReasons: Record<string, number>;\n\tdecisions: ToolPhaseDecision[];\n\tbatchShapingFeedback?: ToolPhaseBatchShapingFeedback;\n}\n\n/**\n * Token usage and cost information for a message or request.\n *\n * Tracks input/output tokens and cache utilization for cost monitoring\n * and context window management.\n */\nexport interface Usage {\n\t/** Number of input tokens consumed */\n\tinput: number;\n\t/** Number of output tokens generated */\n\toutput: number;\n\t/** Tokens served from prompt cache (reduces cost) */\n\tcacheRead: number;\n\t/** Tokens written to prompt cache */\n\tcacheWrite: number;\n\t/** Calculated cost breakdown in USD */\n\tcost: {\n\t\t/** Cost for input tokens */\n\t\tinput: number;\n\t\t/** Cost for output tokens */\n\t\toutput: number;\n\t\t/** Cost savings from cache reads */\n\t\tcacheRead: number;\n\t\t/** Cost for cache writes */\n\t\tcacheWrite: number;\n\t\t/** Total cost for this message/request */\n\t\ttotal: number;\n\t};\n}\n\n/**\n * Reason why the model stopped generating.\n *\n * - `stop` - Natural completion (end of response)\n * - `length` - Hit max_tokens limit\n * - `toolUse` - Model wants to use a tool (generation paused)\n * - `error` - An error occurred during generation\n * - `aborted` - Request was cancelled by the user\n */\nexport type StopReason = \"stop\" | \"length\" | \"toolUse\" | \"error\" | \"aborted\";\n\n/**\n * Message from the human user.\n *\n * User messages can contain plain text or an array of content blocks\n * (for multi-modal input with images).\n *\n * @example\n * ```typescript\n * // Simple text message\n * const msg: UserMessage = {\n *   role: \"user\",\n *   content: \"What is this code doing?\",\n *   timestamp: Date.now()\n * };\n *\n * // Message with image\n * const multiModal: UserMessage = {\n *   role: \"user\",\n *   content: [\n *     { type: \"text\", text: \"What's in this screenshot?\" },\n *     { type: \"image\", data: base64Data, mimeType: \"image/png\" }\n *   ],\n *   timestamp: Date.now()\n * };\n * ```\n */\nexport interface UserMessage {\n\t/** Message role discriminator */\n\trole: \"user\";\n\t/** Message content - string or array of content blocks */\n\tcontent: string | (TextContent | ImageContent)[];\n\t/** Optional non-LLM metadata for runtime bookkeeping */\n\tmetadata?: Record<string, unknown>;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n}\n\n/**\n * Response message from the AI assistant.\n *\n * Contains the model's response along with metadata about the generation\n * including token usage, stop reason, and provider information.\n *\n * The content array may contain:\n * - {@link TextContent} - The actual response text\n * - {@link ThinkingContent} - Extended reasoning (if enabled)\n * - {@link ToolCall} - Tool invocation requests\n */\nexport interface AssistantMessage {\n\t/** Message role discriminator */\n\trole: \"assistant\";\n\t/** Array of content blocks (text, thinking, tool calls) */\n\tcontent: (TextContent | ThinkingContent | ToolCall)[];\n\t/** API format used for this response */\n\tapi: Api;\n\t/** Provider that generated this response */\n\tprovider: Provider;\n\t/** Model ID that generated this response */\n\tmodel: string;\n\t/** Token usage and cost information */\n\tusage: Usage;\n\t/** Reason why generation stopped */\n\tstopReason: StopReason;\n\t/** Error message if stopReason is \"error\" */\n\terrorMessage?: string;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n}\n\n/**\n * Result message from a tool execution.\n *\n * After a tool is executed, the result is sent back to the model\n * as a ToolResultMessage so it can incorporate the information\n * into its response.\n *\n * @typeParam TDetails - Type of additional details attached to the result\n *\n * @example\n * ```typescript\n * const result: ToolResultMessage = {\n *   role: \"toolResult\",\n *   toolCallId: \"call_abc123\",\n *   toolName: \"read\",\n *   content: [{ type: \"text\", text: \"file contents...\" }],\n *   isError: false,\n *   timestamp: Date.now()\n * };\n * ```\n */\nexport interface ToolResultMessage<TDetails = unknown> {\n\t/** Message role discriminator */\n\trole: \"toolResult\";\n\t/** ID of the tool call this result corresponds to */\n\ttoolCallId: string;\n\t/** Name of the tool that was executed */\n\ttoolName: string;\n\t/** Result content (text or images) */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Optional additional details about the execution */\n\tdetails?: TDetails;\n\t/** Whether the tool execution resulted in an error */\n\tisError: boolean;\n\t/** Unix timestamp in milliseconds when result was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for hook-injected messages.\n *\n * Hooks can inject these into the conversation. They are converted to user\n * messages for LLM context and can optionally be hidden from the UI.\n */\nexport interface HookMessage<T = unknown> {\n\t/** Message role discriminator */\n\trole: \"hookMessage\";\n\t/** Hook-defined message category */\n\tcustomType: string;\n\t/** Message content - string or array of content blocks */\n\tcontent: string | (TextContent | ImageContent)[];\n\t/** Whether to render this message in the UI */\n\tdisplay: boolean;\n\t/** Optional hook-specific metadata (not sent to the LLM) */\n\tdetails?: T;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for branch summaries when navigating session trees.\n */\nexport interface BranchSummaryMessage {\n\t/** Message role discriminator */\n\trole: \"branchSummary\";\n\t/** Summary text */\n\tsummary: string;\n\t/** ID of the branch point this summary came from */\n\tfromId: string;\n\t/** Unix timestamp in milliseconds when summary was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for compaction summaries.\n */\nexport interface CompactionSummaryMessage {\n\t/** Message role discriminator */\n\trole: \"compactionSummary\";\n\t/** Summary text */\n\tsummary: string;\n\t/** Token count before compaction (for diagnostics) */\n\ttokensBefore: number;\n\t/** Unix timestamp in milliseconds when summary was created */\n\ttimestamp: number;\n}\n\n/**\n * Union type representing LLM-native messages that can be sent to the model.\n *\n * A conversation with the LLM consists of user input, assistant responses,\n * and tool results.\n */\nexport type Message = UserMessage | AssistantMessage | ToolResultMessage;\n\n/**\n * Empty interface for declaration merging to add custom message types.\n *\n * Consumers can extend this interface to add their own message types:\n *\n * @example\n * ```typescript\n * declare module \"@evalops/maestro\" {\n *   interface CustomAgentMessages {\n *     notification: { role: \"notification\"; text: string; timestamp: number };\n *   }\n * }\n * ```\n */\n// biome-ignore lint/suspicious/noEmptyInterface: Required for declaration merging\nexport interface CustomAgentMessages {}\n\n/**\n * Union type representing all messages in the agent conversation history.\n *\n * Includes both LLM-native messages (user, assistant, toolResult) and\n * custom message types (hookMessage, branchSummary, compactionSummary,\n * plus any types added via declaration merging).\n *\n * Custom messages are preserved in session history but filtered out\n * before being sent to the LLM via {@link convertToLlm}.\n */\nexport type AgentMessage =\n\t| Message\n\t| HookMessage\n\t| BranchSummaryMessage\n\t| CompactionSummaryMessage\n\t| CustomAgentMessages[keyof CustomAgentMessages];\n\n/**\n * Tool definition schema for API serialization.\n *\n * This interface defines a tool's metadata and parameter schema\n * for transmission to the LLM. The actual execution logic is in\n * {@link AgentTool}.\n *\n * @typeParam TParameters - TypeBox schema for the tool's parameters\n *\n * @example\n * ```typescript\n * import { Type } from \"@sinclair/typebox\";\n *\n * const readTool: Tool = {\n *   name: \"read\",\n *   description: \"Read a file from the filesystem\",\n *   parameters: Type.Object({\n *     file_path: Type.String({ description: \"Path to the file\" })\n *   })\n * };\n * ```\n */\nexport interface Tool<TParameters extends TSchema = TSchema> {\n\t/** Unique tool identifier */\n\tname: string;\n\t/** Human-readable description of what the tool does */\n\tdescription: string;\n\t/** TypeBox schema defining the tool's parameters */\n\tparameters: TParameters;\n\t/** Optional categorization (e.g., \"file\", \"shell\", \"web\") */\n\ttoolType?: string;\n\t/** Example inputs for documentation/few-shot prompting */\n\tinputExamples?: unknown[];\n\t/** List of caller identifiers allowed to use this tool */\n\tallowedCallers?: string[];\n\t/** If true, don't send tool definition to API (used for internal tools) */\n\tdeferApiDefinition?: boolean;\n}\n\n/**\n * Behavioral hints for tools (from MCP annotations).\n *\n * These hints help the model and UI understand the tool's behavior\n * for better decision-making and user feedback.\n */\nexport interface ToolAnnotations {\n\t/** If true, the tool does not modify its environment (safe to retry) */\n\treadOnlyHint?: boolean;\n\t/** If true, the tool may perform destructive/irreversible updates */\n\tdestructiveHint?: boolean;\n\t/** If true, mutating calls are scoped to explicit path arguments */\n\tpathScopedMutationHint?: boolean;\n\t/** If true, calling repeatedly with same args has no additional effect */\n\tidempotentHint?: boolean;\n\t/** If true, the tool interacts with external systems (network, APIs) */\n\topenWorldHint?: boolean;\n}\n\nexport interface McpToolSourceMetadata {\n\ttype: \"mcp\";\n\tserver: string;\n\ttool: string;\n\tcapability?: ToolCapabilityMetadata;\n\tsupportsParallelToolCalls?: boolean;\n\tparallelSafetyProvenance?: \"static_config\" | \"server_capability\" | \"none\";\n\tparallelMaxConcurrency?: number;\n}\n\nexport type ToolSourceMetadata = McpToolSourceMetadata;\n\n/**\n * Complete tool definition with execute function.\n *\n * This is the runtime representation of a tool, including both\n * the schema (for the LLM) and the execute function (for the runtime).\n *\n * @typeParam TParameters - TypeBox schema for the tool's parameters\n * @typeParam TDetails - Type of additional details returned with results\n *\n * @example\n * ```typescript\n * import { Type } from \"@sinclair/typebox\";\n *\n * const readTool: AgentTool = {\n *   name: \"read\",\n *   description: \"Read a file from the filesystem\",\n *   parameters: Type.Object({\n *     file_path: Type.String()\n *   }),\n *   execute: async (toolCallId, params) => {\n *     const content = await fs.readFile(params.file_path, \"utf-8\");\n *     return { content: [{ type: \"text\", text: content }] };\n *   }\n * };\n * ```\n */\nexport interface AgentTool<\n\tTParameters extends TSchema = TSchema,\n\tTDetails = unknown,\n> {\n\t/** Unique tool identifier */\n\tname: string;\n\t/** Display label for UI (defaults to name) */\n\tlabel?: string;\n\t/** Human-readable description of what the tool does */\n\tdescription: string;\n\t/** TypeBox schema defining the tool's parameters */\n\tparameters: TParameters;\n\t/** Tool behavior hints from MCP annotations */\n\tannotations?: ToolAnnotations;\n\t/** Exact runtime provenance for bridged or remote tool sources */\n\tsource?: ToolSourceMetadata;\n\t/** Optional categorization (e.g., \"file\", \"shell\", \"web\") */\n\ttoolType?: string;\n\t/**\n\t * Where the tool should be executed.\n\t * - `\"server\"`: (default) Executed by the backend agent\n\t * - `\"client\"`: Executed by the client (VS Code, browser) via callback\n\t */\n\texecutionLocation?: \"server\" | \"client\";\n\t/** Example inputs for documentation/few-shot prompting */\n\tinputExamples?: unknown[];\n\t/** List of caller identifiers allowed to use this tool */\n\tallowedCallers?: string[];\n\t/** If true, don't send tool definition to API */\n\tdeferApiDefinition?: boolean;\n\t/** Optional max retries configured by the tool itself */\n\tmaxRetries?: number;\n\t/** Optional retry delay configured by the tool itself */\n\tretryDelayMs?: number;\n\t/** Optional tool-level retry predicate */\n\tshouldRetry?: (error: unknown) => boolean;\n\t/** Optional compact summary used after a tool finishes. */\n\tgetToolUseSummary?: (params: Record<string, unknown>) => string | null;\n\t/** Optional human-facing label used for live tool UI. */\n\tgetDisplayName?: (params: Record<string, unknown>) => string | null;\n\t/** Optional present-tense activity label used while a tool is running. */\n\tgetActivityDescription?: (params: Record<string, unknown>) => string | null;\n\t/**\n\t * Execute the tool with the given parameters.\n\t *\n\t * @param toolCallId - Unique identifier for this tool call\n\t * @param params - Parameters matching the tool's schema\n\t * @param signal - Optional AbortSignal for cancellation\n\t * @param context - Optional execution context (sandbox, etc.)\n\t * @param onUpdate - Optional callback for partial tool output streaming\n\t * @returns Tool result with content and optional details\n\t */\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Record<string, unknown>,\n\t\tsignal?: AbortSignal,\n\t\tcontext?: { sandbox?: import(\"../sandbox/types.js\").Sandbox },\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => AgentToolResult<TDetails> | Promise<AgentToolResult<TDetails>>;\n}\n\nexport type AgentToolUpdateCallback<TDetails = unknown> = (\n\tpartial: AgentToolResult<TDetails>,\n) => void;\n\n/**\n * Result returned from tool execution.\n *\n * @typeParam TDetails - Type of additional details attached to the result\n */\nexport interface AgentToolResult<TDetails = unknown> {\n\t/** Result content (text or images) */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Optional additional details about the execution */\n\tdetails?: TDetails;\n\t/** Whether the execution resulted in an error */\n\tisError?: boolean;\n\t/** Optional Platform ToolExecution identifier used for audit joins */\n\ttoolExecutionId?: string;\n\t/** Optional Platform approval request identifier correlated to ToolExecution */\n\tapprovalRequestId?: string;\n}\n\n/**\n * Conversation context for LLM requests.\n *\n * Contains the system prompt, conversation history, and available tools\n * for a single LLM request.\n */\nexport interface Context {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt?: string;\n\t/** Conversation history */\n\tmessages: Message[];\n\t/** Tools available for the model to use */\n\ttools?: Tool[];\n}\n\n/**\n * Streaming events during assistant message construction.\n *\n * These events are emitted as the LLM generates its response, enabling\n * real-time UI updates and progress tracking.\n *\n * ## Event Types\n *\n * | Type | Description |\n * |------|-------------|\n * | `start` | Message generation started |\n * | `text_start` | New text content block started |\n * | `text_delta` | Incremental text content |\n * | `text_end` | Text content block completed |\n * | `thinking_start` | Extended thinking block started |\n * | `thinking_delta` | Incremental thinking content |\n * | `thinking_end` | Thinking block completed |\n * | `toolcall_start` | Tool call started |\n * | `toolcall_delta` | Incremental tool call args |\n * | `toolcall_end` | Tool call completed |\n * | `done` | Generation completed successfully |\n * | `error` | Generation failed or was aborted |\n */\nexport type AssistantMessageEvent =\n\t| {\n\t\t\t/** Message generation started */\n\t\t\ttype: \"start\";\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** New text content block started */\n\t\t\ttype: \"text_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental text content received */\n\t\t\ttype: \"text_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New text to append */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Text content block completed */\n\t\t\ttype: \"text_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Final text content */\n\t\t\tcontent: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Extended thinking block started */\n\t\t\ttype: \"thinking_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental thinking content received */\n\t\t\ttype: \"thinking_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New thinking text to append */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Thinking content block completed */\n\t\t\ttype: \"thinking_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Final thinking content */\n\t\t\tcontent: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Tool call started */\n\t\t\ttype: \"toolcall_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental tool call arguments received */\n\t\t\ttype: \"toolcall_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New JSON fragment to append to arguments */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Tool call completed */\n\t\t\ttype: \"toolcall_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Completed tool call */\n\t\t\ttoolCall: ToolCall;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution started outside Maestro's local executor */\n\t\t\ttype: \"provider_tool_execution_start\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool arguments */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution produced an incremental update */\n\t\t\ttype: \"provider_tool_execution_update\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool arguments */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Partial provider result */\n\t\t\tpartialResult: AgentToolResult;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution completed outside Maestro's local executor */\n\t\t\ttype: \"provider_tool_execution_end\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool result */\n\t\t\tresult: ToolResultMessage;\n\t\t\t/** Whether the provider tool returned an error */\n\t\t\tisError: boolean;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Optional Platform approval request identifier correlated to ToolExecution */\n\t\t\tapprovalRequestId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Generation completed successfully */\n\t\t\ttype: \"done\";\n\t\t\t/** Reason for completion */\n\t\t\treason: Extract<StopReason, \"stop\" | \"length\" | \"toolUse\">;\n\t\t\t/** Final assistant message */\n\t\t\tmessage: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Generation failed or was aborted */\n\t\t\ttype: \"error\";\n\t\t\t/** Reason for failure */\n\t\t\treason: Extract<StopReason, \"aborted\" | \"error\">;\n\t\t\t/** Error message details */\n\t\t\terror: AssistantMessage;\n\t  };\n\n/**\n * LLM model configuration.\n *\n * Contains all the information needed to use a model, including\n * API endpoints, capabilities, and pricing.\n *\n * @typeParam TApi - The API format this model uses\n *\n * @example\n * ```typescript\n * const claude: Model<\"anthropic-messages\"> = {\n *   id: \"claude-sonnet-4-5-20250929\",\n *   name: \"Claude Sonnet 4.5\",\n *   api: \"anthropic-messages\",\n *   provider: \"anthropic\",\n *   baseUrl: \"https://api.anthropic.com/v1\",\n *   reasoning: true,\n *   input: [\"text\", \"image\"],\n *   cost: { input: 3.00, output: 15.00, cacheRead: 0.30, cacheWrite: 3.75 },\n *   contextWindow: 200000,\n *   maxTokens: 8192\n * };\n * ```\n */\nexport interface Model<TApi extends Api> {\n\t/** Unique model identifier (e.g., \"claude-sonnet-4-5-20250929\") */\n\tid: string;\n\t/** Human-readable model name (e.g., \"Claude Sonnet 4.5\") */\n\tname: string;\n\t/** API format used for requests */\n\tapi: TApi;\n\t/** Provider serving this model */\n\tprovider: Provider;\n\t/** Base URL for API requests */\n\tbaseUrl: string;\n\t/** Optional custom headers to include in API requests */\n\theaders?: Record<string, string>;\n\t/** Optional OpenAI-compatibility overrides for vendor quirks */\n\tcompat?: OpenAICompatOverrides;\n\t/** Whether the model supports extended thinking */\n\treasoning: boolean;\n\t/** Whether the model supports tool use */\n\ttoolUse?: boolean;\n\t/** Supported input modalities */\n\tinput: (\"text\" | \"image\")[];\n\t/** Cost per million tokens in USD */\n\tcost: {\n\t\t/** Input token cost */\n\t\tinput: number;\n\t\t/** Output token cost */\n\t\toutput: number;\n\t\t/** Cache read cost (typically discounted) */\n\t\tcacheRead: number;\n\t\t/** Cache write cost */\n\t\tcacheWrite: number;\n\t};\n\t/** Maximum context window in tokens */\n\tcontextWindow: number;\n\t/** Maximum output tokens per response */\n\tmaxTokens: number;\n}\n\n/**\n * File attachment for messages.\n *\n * Represents an uploaded file (image or document) that can be\n * included in a user message.\n */\nexport interface Attachment {\n\t/** Unique identifier for this attachment */\n\tid: string;\n\t/** Type of attachment */\n\ttype: \"image\" | \"document\";\n\t/** Original filename */\n\tfileName: string;\n\t/** MIME type of the file */\n\tmimeType: string;\n\t/** File size in bytes */\n\tsize: number;\n\t/** Base64-encoded file content */\n\tcontent: string;\n\t/** Extracted text content (for documents) */\n\textractedText?: string;\n\t/** Preview image (for documents) */\n\tpreview?: string;\n}\n\n/**\n * User-configurable thinking level for extended reasoning.\n *\n * Controls how much computational effort the model spends on\n * reasoning before generating a response.\n *\n * - `off` - No extended thinking\n * - `minimal` - Brief reasoning hints\n * - `low` - Short reasoning steps\n * - `medium` - Moderate reasoning (default)\n * - `high` - Thorough step-by-step reasoning\n * - `max` - Maximum reasoning depth\n */\nexport type ThinkingLevel =\n\t| \"off\"\n\t| \"minimal\"\n\t| \"low\"\n\t| \"medium\"\n\t| \"high\"\n\t| \"ultra\"\n\t| \"max\";\n\n/**\n * User message with optional file attachments.\n *\n * Extends the base UserMessage to support file attachments\n * for rich multi-modal interactions.\n */\nexport type UserMessageWithAttachments = UserMessage & {\n\t/** Optional file attachments */\n\tattachments?: Attachment[];\n};\n\n/**\n * Placeholder for custom message types.\n * Can be extended to add application-specific message types.\n */\nexport interface CustomMessages {\n\thookMessage: HookMessage;\n\tbranchSummary: BranchSummaryMessage;\n\tcompactionSummary: CompactionSummaryMessage;\n}\n\n/**\n * Application-level message type.\n *\n * Union of all message types that can appear in the UI,\n * including user messages with attachments.\n */\nexport type AppMessage =\n\t| AssistantMessage\n\t| UserMessageWithAttachments\n\t| Message\n\t| CustomMessages[keyof CustomMessages];\n\n/**\n * Information about a tool call currently being executed.\n */\nexport interface PendingToolCall {\n\t/** Name of the tool being executed */\n\ttoolName: string;\n\t/** Original arguments passed to the tool */\n\targs?: Record<string, unknown>;\n\t/** Tool metadata captured when execution started */\n\ttool?: Pick<\n\t\tAgentTool,\n\t\t\"label\" | \"getDisplayName\" | \"getToolUseSummary\" | \"getActivityDescription\"\n\t>;\n\t/** Stable display name for live UI */\n\tdisplayName?: string;\n\t/** Stable compact summary for live UI */\n\tsummaryLabel?: string;\n}\n\n/**\n * Current state of an agent instance.\n *\n * This is the central state object managed by the Agent class,\n * containing all information about the current conversation,\n * configuration, and execution status.\n */\nexport interface AgentState {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt: string;\n\t/** Version/hash metadata for the base system prompt instructions */\n\tpromptMetadata?: PromptMetadata;\n\t/** Exact prompt source files layered into the current system prompt */\n\tsystemPromptSourcePaths?: string[];\n\t/** Manifest of project instruction files layered into the current system prompt */\n\tpromptContextManifest?: PromptProjectDocManifest;\n\t/** Full filesystem and MCP context provenance captured for this run */\n\tunifiedContextManifest?: UnifiedContextManifest;\n\t/** Current model configuration */\n\tmodel: Model<Api>;\n\t/** Current thinking level for extended reasoning */\n\tthinkingLevel: ThinkingLevel;\n\t/** Optional reasoning summary preference for Responses API */\n\treasoningSummary?: \"auto\" | \"detailed\" | \"concise\" | null;\n\t/** Available tools for this agent */\n\ttools: AgentTool[];\n\t/**\n\t * Controls how queued steering messages are sent between turns.\n\t * - `\"all\"` - Send all queued messages at once\n\t * - `\"one\"` - Send one message at a time\n\t */\n\tsteeringMode: \"all\" | \"one\";\n\t/**\n\t * Controls how queued follow-up messages are sent between turns.\n\t * - `\"all\"` - Send all queued messages at once\n\t * - `\"one\"` - Send one message at a time\n\t */\n\tfollowUpMode: \"all\" | \"one\";\n\t/**\n\t * @deprecated Use steeringMode/followUpMode instead.\n\t */\n\tqueueMode: \"all\" | \"one\";\n\t/** Conversation history */\n\tmessages: AppMessage[];\n\t/** Whether the agent is currently streaming a response */\n\tisStreaming: boolean;\n\t/** Current streaming message (partial response) */\n\tstreamMessage: Message | null;\n\t/** Tool calls currently being executed */\n\tpendingToolCalls: Map<string, PendingToolCall>;\n\t/** Current error message, if any */\n\terror?: string;\n\t/** Optional sandbox for isolated tool execution */\n\tsandbox?: import(\"../sandbox/types.js\").Sandbox;\n\t/** Current sandbox mode (e.g., \"docker\", \"local\") */\n\tsandboxMode?: string | null;\n\t/** Whether sandboxing is enabled */\n\tsandboxEnabled?: boolean;\n\t/** User identification for tracking */\n\tuser?: {\n\t\t/** User UUID */\n\t\tid: string;\n\t\t/** Organization UUID */\n\t\torgId: string;\n\t};\n\t/** Session information for persistence */\n\tsession?: {\n\t\t/** Session UUID */\n\t\tid: string;\n\t\t/** When the session started */\n\t\tstartedAt: Date;\n\t};\n\t/** Sampling temperature override (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Top-p sampling override (0.0-1.0) */\n\ttopP?: number;\n}\n\n/**\n * Events emitted during agent execution.\n *\n * These events provide real-time updates about agent activity,\n * enabling UI updates, logging, and progress tracking.\n *\n * ## Lifecycle Events\n * - `agent_start` - Agent execution started\n * - `agent_end` - Agent execution completed\n * - `turn_start` - New conversation turn started\n * - `turn_end` - Conversation turn completed\n *\n * ## Message Events\n * - `message_start` - New message being constructed\n * - `message_update` - Incremental message update\n * - `message_end` - Message completed\n *\n * ## Tool Events\n * - `tool_execution_start` - Tool execution started\n * - `tool_execution_update` - Tool execution produced partial output\n * - `tool_execution_end` - Tool execution completed\n * - `parallelism_gated` - Scheduler delayed a tool because in-flight mutations made parallel execution unsafe\n * - `parallel_conflict_detected` - Scheduler detected overlapping write scopes while evaluating parallel execution\n * - `tool_batch_summary` - Tool batch completed with a transient summary label\n * - `client_tool_request` - Client-side tool invocation needed\n *\n * ## Approval Events\n * - `action_approval_required` - User approval needed\n * - `action_approval_resolved` - User made approval decision\n *\n * ## Tool Retry Events\n * - `tool_retry_required` - Tool failed and retry decision needed\n * - `tool_retry_resolved` - Tool retry decision resolved\n *\n * ## Status Events\n * - `status` - Status update\n * - `error` - Error occurred\n * - `compaction` - Context was compacted\n */\nexport interface ToolSchedulingMetadata {\n\tclassification:\n\t\t| \"read_only\"\n\t\t| \"path_scoped_mutation\"\n\t\t| \"parallel_safe_mutation\"\n\t\t| \"serialized_mutation\"\n\t\t| \"workflow_serialized\"\n\t\t| \"cache_reuse\"\n\t\t| \"unknown\";\n\treason:\n\t\t| \"read_only_tool\"\n\t\t| \"mcp_parallel_opt_in\"\n\t\t| \"path_scope_available\"\n\t\t| \"path_scope_disjoint\"\n\t\t| \"path_scope_overlap\"\n\t\t| \"pending_mutation\"\n\t\t| \"mutating_tool\"\n\t\t| \"workflow_state_tracker\"\n\t\t| \"cache_hit\"\n\t\t| \"cache_pending\"\n\t\t| \"unknown_tool\";\n\tconcurrencyLimit?: number;\n\tqueueDepth?: number;\n\tpendingMutations?: number;\n\tpathScope?: string[];\n\tpathScopeSource?: \"annotation\" | \"known_tool\";\n\tpathArgumentKeys?: string[];\n\tcache?: \"disabled\" | \"miss\" | \"candidate\" | \"pending_hit\" | \"hit\";\n}\n\nexport type AgentEvent =\n\t| {\n\t\t\t/** Agent execution started */\n\t\t\ttype: \"agent_start\";\n\t\t\t/** Whether this execution is an automatic continuation of the current turn */\n\t\t\tcontinuation?: boolean;\n\t  }\n\t| {\n\t\t\t/** Agent execution completed */\n\t\t\ttype: \"agent_end\";\n\t\t\t/** Final messages from this execution */\n\t\t\tmessages: AppMessage[];\n\t\t\t/** Whether execution was aborted */\n\t\t\taborted?: boolean;\n\t\t\t/** If aborted with partial acceptance, contains the saved partial message */\n\t\t\tpartialAccepted?: AppMessage;\n\t\t\t/** Final stop reason from the LLM - \"length\" indicates output hit the max token limit */\n\t\t\tstopReason?: StopReason;\n\t  }\n\t| {\n\t\t\t/** Status update during execution */\n\t\t\ttype: \"status\";\n\t\t\t/** Status message */\n\t\t\tstatus: string;\n\t\t\t/** Additional details */\n\t\t\tdetails: Record<string, unknown>;\n\t  }\n\t| {\n\t\t\t/** Error occurred during execution */\n\t\t\ttype: \"error\";\n\t\t\t/** Error message */\n\t\t\tmessage: string;\n\t  }\n\t| {\n\t\t\t/** New conversation turn started */\n\t\t\ttype: \"turn_start\";\n\t  }\n\t| {\n\t\t\t/** Conversation turn completed */\n\t\t\ttype: \"turn_end\";\n\t\t\t/** Assistant message from this turn */\n\t\t\tmessage: AppMessage;\n\t\t\t/** Tool results from this turn */\n\t\t\ttoolResults: AppMessage[];\n\t  }\n\t| {\n\t\t\t/** New message being constructed */\n\t\t\ttype: \"message_start\";\n\t\t\t/** The message being built */\n\t\t\tmessage: AppMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental update to current message */\n\t\t\ttype: \"message_update\";\n\t\t\t/** Updated message state */\n\t\t\tmessage: AppMessage;\n\t\t\t/** The streaming event that triggered this update */\n\t\t\tassistantMessageEvent: AssistantMessageEvent;\n\t  }\n\t| {\n\t\t\t/** Message completed */\n\t\t\ttype: \"message_end\";\n\t\t\t/** Final message */\n\t\t\tmessage: AppMessage;\n\t  }\n\t| {\n\t\t\t/** Tool execution started */\n\t\t\ttype: \"tool_execution_start\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Arguments passed to the tool */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Scheduler classification and serialization reason for this call */\n\t\t\tscheduling?: ToolSchedulingMetadata;\n\t  }\n\t| {\n\t\t\t/** Tool execution completed */\n\t\t\ttype: \"tool_execution_end\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Optional approval request identifier correlated to Platform ToolExecution */\n\t\t\tapprovalRequestId?: string;\n\t\t\t/** Optional stable error or outcome code for telemetry and clients */\n\t\t\terrorCode?: string;\n\t\t\t/** Optional governed outcome classification surfaced by the tool result */\n\t\t\tgovernedOutcome?:\n\t\t\t\t| \"approval_required\"\n\t\t\t\t| \"approval_pending\"\n\t\t\t\t| \"authentication_required\"\n\t\t\t\t| \"denied\"\n\t\t\t\t| \"rate_limited\";\n\t\t\t/** Optional selected skill artifact metadata surfaced by the tool result */\n\t\t\tskillMetadata?: SkillArtifactMetadata;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Result from the tool */\n\t\t\tresult: ToolResultMessage;\n\t\t\t/** Whether the tool returned an error */\n\t\t\tisError: boolean;\n\t\t\t/** Scheduler classification and final reuse/serialization reason */\n\t\t\tscheduling?: ToolSchedulingMetadata;\n\t  }\n\t| ParallelismGatedEvent\n\t| ParallelConflictDetectedEvent\n\t| {\n\t\t\t/** LSP diagnostic delta produced by an edit/write tool call */\n\t\t\ttype: \"diagnostic_delta\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** File affected by the diagnostic delta */\n\t\t\tfile: string;\n\t\t\t/** User-facing file path from the tool call */\n\t\t\tdisplayPath: string;\n\t\t\t/** Whether a pre-edit baseline was available */\n\t\t\tusedDelta: boolean;\n\t\t\t/** Newly introduced diagnostic count */\n\t\t\tintroducedCount: number;\n\t\t\t/** Diagnostics repaired by the tool call */\n\t\t\trepairedCount: number;\n\t\t\t/** Remaining diagnostics for the affected file */\n\t\t\tremainingCount: number;\n\t\t\t/** Stable fingerprint for introduced diagnostics */\n\t\t\tfingerprint: string;\n\t\t\t/** Repair attempt number for this fingerprint */\n\t\t\trepairAttempt?: number;\n\t\t\t/** Maximum automatic repair attempts for this fingerprint */\n\t\t\tmaxRepairAttempts?: number;\n\t\t\t/** Whether Agent queued a follow-up repair turn */\n\t\t\twillAutoFollowUp: boolean;\n\t\t\t/** Why a repair follow-up was or was not queued */\n\t\t\treason: string;\n\t  }\n\t| {\n\t\t\t/** Summary emitted after the final tool in a batch completes */\n\t\t\ttype: \"tool_batch_summary\";\n\t\t\t/** Stable one-line summary of what the completed tool batch did */\n\t\t\tsummary: string;\n\t\t\t/** Underlying per-tool summary labels used to build the summary */\n\t\t\tsummaryLabels: string[];\n\t\t\t/** Tool call identifiers included in this batch */\n\t\t\ttoolCallIds: string[];\n\t\t\t/** Tool names included in this batch */\n\t\t\ttoolNames: string[];\n\t\t\t/** Successful tool calls in the batch */\n\t\t\tcallsSucceeded: number;\n\t\t\t/** Failed tool calls in the batch */\n\t\t\tcallsFailed: number;\n\t  }\n\t| ToolPhaseSummary\n\t| {\n\t\t\t/** Tool execution produced partial output */\n\t\t\ttype: \"tool_execution_update\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Arguments passed to the tool */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Partial tool result */\n\t\t\tpartialResult: AgentToolResult;\n\t  }\n\t| {\n\t\t\t/** User approval required for an action */\n\t\t\ttype: \"action_approval_required\";\n\t\t\t/** Details of the approval request */\n\t\t\trequest: ActionApprovalRequest;\n\t  }\n\t| {\n\t\t\t/** User made approval decision */\n\t\t\ttype: \"action_approval_resolved\";\n\t\t\t/** The original request */\n\t\t\trequest: ActionApprovalRequest;\n\t\t\t/** User's decision */\n\t\t\tdecision: ActionApprovalDecision;\n\t  }\n\t| {\n\t\t\t/** Tool failed and requires a retry decision */\n\t\t\ttype: \"tool_retry_required\";\n\t\t\t/** Details of the retry request */\n\t\t\trequest: ToolRetryRequest;\n\t  }\n\t| {\n\t\t\t/** Tool retry decision resolved */\n\t\t\ttype: \"tool_retry_resolved\";\n\t\t\t/** The original request */\n\t\t\trequest: ToolRetryRequest;\n\t\t\t/** User or policy decision */\n\t\t\tdecision: ToolRetryDecision;\n\t  }\n\t| {\n\t\t\t/** Client-side tool invocation needed */\n\t\t\ttype: \"client_tool_request\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Arguments for the tool */\n\t\t\targs: unknown;\n\t  }\n\t| {\n\t\t\t/** Context was compacted (older messages summarized) */\n\t\t\ttype: \"compaction\";\n\t\t\t/** Generated summary of compacted messages */\n\t\t\tsummary: string;\n\t\t\t/** Index of first entry to keep (entries before were summarized) */\n\t\t\tfirstKeptEntryIndex: number;\n\t\t\t/** Token count before compaction */\n\t\t\ttokensBefore: number;\n\t\t\t/** Whether this was auto-triggered vs manual /compact */\n\t\t\tauto?: boolean;\n\t\t\t/** Custom instructions used for summarization */\n\t\t\tcustomInstructions?: string;\n\t\t\t/** Timestamp of compaction */\n\t\t\ttimestamp: string;\n\t  }\n\t| {\n\t\t\t/** Auto-retry started for transient error (rate limit, overload, 5xx) */\n\t\t\ttype: \"auto_retry_start\";\n\t\t\t/** Current retry attempt (1-based) */\n\t\t\tattempt: number;\n\t\t\t/** Maximum number of retry attempts */\n\t\t\tmaxAttempts: number;\n\t\t\t/** Delay in milliseconds before retry */\n\t\t\tdelayMs: number;\n\t\t\t/** The error message that triggered the retry */\n\t\t\terrorMessage: string;\n\t  }\n\t| {\n\t\t\t/** Auto-retry completed (success or final failure) */\n\t\t\ttype: \"auto_retry_end\";\n\t\t\t/** Whether the retry eventually succeeded */\n\t\t\tsuccess: boolean;\n\t\t\t/** Final attempt number */\n\t\t\tattempt: number;\n\t\t\t/** If failed, the final error message */\n\t\t\tfinalError?: string;\n\t  };\n\n/**\n * Events emitted over streaming transports (SSE/WebSocket).\n *\n * Includes core agent events plus transport-level signals.\n */\nexport type AgentStreamEvent =\n\t| AgentEvent\n\t| { type: \"session_update\"; sessionId: string }\n\t| { type: \"heartbeat\" }\n\t| { type: \"aborted\" }\n\t| { type: \"done\" };\n\n/**\n * Message queued for sending to the LLM.\n *\n * Wraps the original message with an optional LLM-formatted version,\n * allowing for message transformation before sending.\n *\n * @typeParam TOriginal - Type of the original message\n */\nexport interface QueuedMessage<TOriginal = AppMessage> {\n\t/** Stable identifier for queue operations */\n\tid: number;\n\t/** When the message was queued */\n\tcreatedAt: number;\n\t/** Original message as received */\n\toriginal: TOriginal;\n\t/** Optional LLM-formatted version of the message */\n\tllm?: Message;\n}\n\n/**\n * Runtime configuration for agent execution.\n *\n * Passed to the transport layer when starting a new agent run,\n * containing all the configuration needed to execute a conversation turn.\n */\nexport interface AgentRunConfig {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt: string;\n\t/** Tools available for this run */\n\ttools: AgentTool[];\n\t/** Model to use for generation */\n\tmodel: Model<Api>;\n\t/** Optional reasoning effort level */\n\treasoning?: ReasoningEffort;\n\t/** Optional reasoning summary preference for Responses API */\n\treasoningSummary?: \"auto\" | \"detailed\" | \"concise\" | null;\n\t/** Emit message_end for the initial user message (defaults to true). */\n\temitUserMessageEnd?: boolean;\n\t/** Function to retrieve steering messages for batch sending */\n\tgetSteeringMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/** Function to retrieve follow-up messages for batch sending */\n\tgetFollowUpMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/** Function to retrieve prompt-only messages for the next turn. */\n\tgetPromptOnlyMessages?: () => Promise<Message[]>;\n\t/** @deprecated Use getSteeringMessages/getFollowUpMessages instead */\n\tgetQueuedMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/**\n\t * Optional message preprocessor applied immediately before calling the LLM provider.\n\t *\n\t * Use this to implement provider-specific compatibility transforms (e.g., image limits,\n\t * signature preservation, prompt caching markers) without polluting the core tools.\n\t *\n\t * Note: This is a pure preprocessing hook. It should not execute tools or perform I/O.\n\t */\n\tpreprocessMessages?: (\n\t\tmessages: Message[],\n\t\tcontext: {\n\t\t\tsystemPrompt: string;\n\t\t\ttools: AgentTool[];\n\t\t\tmodel: Model<Api>;\n\t\t\tuserMessage?: Message;\n\t\t},\n\t\tsignal?: AbortSignal,\n\t) => Message[] | Promise<Message[]>;\n\t/** User identification for tracking */\n\tuser?: {\n\t\t/** User UUID */\n\t\tid: string;\n\t\t/** Organization UUID */\n\t\torgId: string;\n\t};\n\t/** Session information for persistence */\n\tsession?: {\n\t\t/** Session UUID */\n\t\tid: string;\n\t\t/** When the session started */\n\t\tstartedAt: Date;\n\t};\n\t/** User/org guarded-files override policy for this run */\n\tguardedFiles?: GuardedFilesPolicySettings;\n\t/** Optional helper function for running LLM queries (e.g., for summarization) */\n\trunLLM?: (systemPrompt: string, userPrompt: string) => Promise<string>;\n\t/** Optional debug checkpoint profiler for local query latency diagnostics. */\n\tqueryProfiler?: CheckpointProfiler;\n\t/** Optional sandbox for isolated tool execution */\n\tsandbox?: import(\"../sandbox/types.js\").Sandbox;\n\t/** Sampling temperature override (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Top-p sampling override (0.0-1.0) */\n\ttopP?: number;\n\t/** Optional Anthropic API-side task budget for the current turn */\n\ttaskBudget?: {\n\t\ttotal: number;\n\t\tremaining?: number;\n\t};\n}\n\n/**\n * Transport interface for LLM communication.\n *\n * Implementors of this interface handle the actual communication\n * with the LLM provider, including streaming and tool execution.\n */\nexport interface AgentTransport {\n\t/**\n\t * Execute a conversation turn with a new user message.\n\t *\n\t * @param messages - Conversation history\n\t * @param userMessage - New user message\n\t * @param config - Runtime configuration\n\t * @param signal - Optional abort signal for cancellation\n\t * @returns Async iterable of agent events\n\t */\n\trun(\n\t\tmessages: Message[],\n\t\tuserMessage: Message,\n\t\tconfig: AgentRunConfig,\n\t\tsignal?: AbortSignal,\n\t): AsyncIterable<AgentEvent>;\n\n\t/**\n\t * Continue from current context without a new user message.\n\t *\n\t * Used for:\n\t * - Retrying after transient errors (rate limits, overload)\n\t * - Continuing after context compaction\n\t * - Resuming interrupted tool execution\n\t *\n\t * @param messages - Current conversation history\n\t * @param config - Runtime configuration\n\t * @param signal - Optional abort signal for cancellation\n\t * @returns Async iterable of agent events\n\t */\n\tcontinue(\n\t\tmessages: Message[],\n\t\tconfig: AgentRunConfig,\n\t\tsignal?: AbortSignal,\n\t): AsyncIterable<AgentEvent>;\n\n\t/**\n\t * Optional lightweight connectivity probe for UI health checks.\n\t */\n\tping?: () => Promise<void>;\n}\n\n/**\n * Options for streaming LLM requests.\n *\n * These options are passed to the transport layer when making\n * streaming requests to the LLM provider.\n */\nexport interface StreamOptions {\n\t/** Sampling temperature (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Maximum tokens to generate */\n\tmaxTokens?: number;\n\t/** Abort signal for cancellation */\n\tsignal?: AbortSignal;\n\t/** API key for authentication */\n\tapiKey?: string;\n\t/** Additional headers to include in requests */\n\theaders?: Record<string, string>;\n\t/** Additional request body fields for provider-specific extensions */\n\trequestBody?: Record<string, unknown>;\n\t/** Stable session id for provider-side request grouping/cache keys */\n\tsessionId?: string;\n\t/** Current working directory for local provider runtimes. */\n\tcwd?: string;\n\t/** Authentication type for the request */\n\tauthType?: \"api-key\" | \"bearer-token\";\n\t/** Optional Anthropic API-side task budget for the current turn */\n\ttaskBudget?: {\n\t\ttotal: number;\n\t\tremaining?: number;\n\t};\n\t/** Optional governed executor for provider-native dynamic tool callbacks. */\n\texecuteDynamicTool?: (toolCall: ToolCall) => Promise<AgentToolResult>;\n}\n\n/**\n * Cache control hint for prompt caching.\n *\n * Used to mark content that should be cached for faster\n * subsequent requests.\n */\nexport interface PromptCacheControl {\n\t/** Cache type - currently only \"ephemeral\" is supported */\n\ttype: \"ephemeral\";\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG","sourcesContent":["/**\n * @fileoverview Core Type Definitions for Maestro Agent\n *\n * This module defines the fundamental types used throughout the Maestro AI system,\n * including message formats, tool definitions, model configurations, and agent state.\n *\n * ## Type Categories\n *\n * ### Message Types\n * - {@link UserMessage} - Messages from the human user\n * - {@link AssistantMessage} - Responses from the AI assistant\n * - {@link ToolResultMessage} - Results from tool executions\n * - {@link Message} - Union of all message types\n *\n * ### Content Types\n * - {@link TextContent} - Plain text content blocks\n * - {@link ImageContent} - Base64-encoded images\n * - {@link ThinkingContent} - Extended reasoning traces\n * - {@link ToolCall} - Tool invocation requests\n *\n * ### Tool Types\n * - {@link Tool} - Tool definition schema (for API)\n * - {@link AgentTool} - Tool with execute function (for runtime)\n * - {@link AgentToolResult} - Return value from tool execution\n *\n * ### Configuration Types\n * - {@link Model} - LLM model configuration\n * - {@link AgentState} - Current state of an agent\n * - {@link AgentRunConfig} - Runtime configuration\n *\n * @module agent/types\n */\n\nimport type {\n\tGuardedFilesPolicySettings,\n\tRoutingReceipt,\n} from \"@evalops/contracts\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport type { PromptProjectDocManifest } from \"../config/index.js\";\nimport type { UnifiedContextManifest } from \"../context/manifest-types.js\";\nimport type { PromptMetadata } from \"../prompts/types.js\";\nimport type { CheckpointProfiler } from \"../utils/checkpoint-profiler.js\";\nimport type {\n\tActionApprovalDecision,\n\tActionApprovalRequest,\n} from \"./action-approval.js\";\nimport type { SkillArtifactMetadata } from \"./skill-artifact-metadata.js\";\nimport type { ToolCapabilityMetadata } from \"./tool-capability-types.js\";\nimport type { ToolRetryDecision, ToolRetryRequest } from \"./tool-retry.js\";\n\n/**\n * API format identifier for different LLM provider APIs.\n *\n * Each provider may support different API formats:\n * - `openai-completions` - OpenAI Chat Completions API\n * - `openai-responses` - OpenAI Responses API (newer format)\n * - `openai-codex-responses` - ChatGPT Codex Responses backend\n * - `openai-codex-app-server` - Local Codex app-server with ChatGPT sign-in\n * - `anthropic-messages` - Anthropic Messages API\n * - `google-generative-ai` - Google Generative AI (Gemini)\n * - `google-gemini-cli` - Google Cloud Code Assist (Gemini CLI)\n * - `bedrock-converse` - AWS Bedrock Converse API\n * - `scripted-replay` - Deterministic local scenario replay provider\n */\nexport type Api =\n\t| \"openai-completions\"\n\t| \"openai-responses\"\n\t| \"openai-codex-responses\"\n\t| \"openai-codex-app-server\"\n\t| \"anthropic-messages\"\n\t| \"google-generative-ai\"\n\t| \"google-gemini-cli\"\n\t| \"bedrock-converse\"\n\t| \"vertex-ai\"\n\t| \"scripted-replay\";\n\nexport interface OpenAICompatOverrides {\n\tsupportsStore?: boolean;\n\tsupportsDeveloperRole?: boolean;\n\tsupportsReasoningEffort?: boolean;\n\tsupportsResponsesApi?: boolean;\n\t/** Supports Anthropic-style cache_control (OpenRouter with Claude models) */\n\tsupportsCacheControl?: boolean;\n\tmaxTokensField?: \"max_tokens\" | \"max_completion_tokens\";\n\trequiresToolResultName?: boolean;\n\trequiresAssistantAfterToolResult?: boolean;\n\trequiresThinkingAsText?: boolean;\n\trequiresMistralToolIds?: boolean;\n}\n\n/**\n * Well-known LLM provider identifiers.\n *\n * These are the officially supported providers with built-in configurations:\n * - `anthropic` - Anthropic (Claude models)\n * - `bedrock` - AWS Bedrock\n * - `google` - Google AI (Gemini models)\n * - `openai` - OpenAI (GPT models)\n * - `azure-openai` - Azure OpenAI\n * - `writer` - Writer.com\n * - `xai` - xAI (Grok models)\n * - `groq` - Groq\n * - `cerebras` - Cerebras\n * - `openrouter` - OpenRouter (aggregator)\n * - `zai` - Z.ai (Zhipu GLM)\n * - `deepseek` - DeepSeek\n * - `moonshot` - Moonshot AI (Kimi)\n * - `dashscope` - Alibaba Qwen (DashScope)\n * - `minimax` - MiniMax\n */\nexport type KnownProvider =\n\t| \"anthropic\"\n\t| \"bedrock\"\n\t| \"google\"\n\t| \"openai\"\n\t| \"openai-codex\"\n\t| \"azure-openai\"\n\t| \"writer\"\n\t| \"xai\"\n\t| \"groq\"\n\t| \"cerebras\"\n\t| \"openrouter\"\n\t| \"zai\"\n\t| \"deepseek\"\n\t| \"moonshot\"\n\t| \"dashscope\"\n\t| \"minimax\";\n\n/**\n * Provider identifier - either a known provider or a custom string.\n * Custom providers can be used with OpenAI-compatible APIs.\n */\nexport type Provider = KnownProvider | string;\n\n/**\n * Reasoning effort level for models that support extended thinking.\n *\n * Higher levels produce more detailed reasoning at increased latency:\n * - `minimal` - Brief chain-of-thought hints\n * - `low` - Short reasoning steps\n * - `medium` - Moderate reasoning depth (recommended default)\n * - `high` - Thorough step-by-step reasoning\n * - `ultra` - Maximum reasoning depth (for complex problems)\n *\n * Note: Claude Code uses keywords \"think\", \"think hard\", \"think harder\", \"ultrathink\"\n * which map to low, medium, high, ultra respectively.\n */\nexport type ReasoningEffort = \"minimal\" | \"low\" | \"medium\" | \"high\" | \"ultra\";\n\n/**\n * Plain text content block within a message.\n *\n * @example\n * ```typescript\n * const content: TextContent = {\n *   type: \"text\",\n *   text: \"Hello, how can I help you today?\"\n * };\n * ```\n */\nexport interface TextContent {\n\t/** Discriminator for content block type */\n\ttype: \"text\";\n\t/** The text content */\n\ttext: string;\n\t/** Optional signature for content verification */\n\ttextSignature?: string;\n}\n\n/**\n * Extended thinking/reasoning content block.\n *\n * Contains the model's internal reasoning process when extended\n * thinking is enabled. This is typically hidden from end users\n * but useful for debugging and understanding model behavior.\n */\nexport interface ThinkingContent {\n\t/** Discriminator for content block type */\n\ttype: \"thinking\";\n\t/** The thinking/reasoning trace */\n\tthinking: string;\n\t/** Optional signature for content verification */\n\tthinkingSignature?: string;\n}\n\n/**\n * Base64-encoded image content block.\n *\n * Used for including images in user messages (vision input)\n * or tool results (screenshots, generated images).\n *\n * @example\n * ```typescript\n * const image: ImageContent = {\n *   type: \"image\",\n *   data: \"iVBORw0KGgo...\", // base64 encoded\n *   mimeType: \"image/png\"\n * };\n * ```\n */\nexport interface ImageContent {\n\t/** Discriminator for content block type */\n\ttype: \"image\";\n\t/** Base64-encoded image data */\n\tdata: string;\n\t/** MIME type (e.g., \"image/png\", \"image/jpeg\") */\n\tmimeType: string;\n}\n\n/**\n * Tool invocation request within an assistant message.\n *\n * When the model decides to use a tool, it emits a ToolCall\n * content block specifying which tool to call and with what arguments.\n *\n * @example\n * ```typescript\n * const toolCall: ToolCall = {\n *   type: \"toolCall\",\n *   id: \"call_abc123\",\n *   name: \"read\",\n *   arguments: { file_path: \"/src/index.ts\" }\n * };\n * ```\n */\nexport interface ToolCall {\n\t/** Discriminator for content block type */\n\ttype: \"toolCall\";\n\t/** Unique identifier for this tool call (used to match results) */\n\tid: string;\n\t/** Name of the tool to invoke */\n\tname: string;\n\t/** Arguments to pass to the tool */\n\targuments: Record<string, unknown>;\n\t/**\n\t * Provider-specific signature used by some APIs (notably Gemini 3) to\n\t * associate tool calls with preceding thoughts. If present, it must be\n\t * preserved across turns when replaying the message history back to the provider.\n\t */\n\tthoughtSignature?: string;\n}\n\nexport type ToolSchedulingDecisionKind =\n\t| \"scheduled\"\n\t| \"parallelized\"\n\t| \"delayed\"\n\t| \"serialized\"\n\t| \"cached\"\n\t| \"skipped\";\n\nexport interface ToolSchedulingDecision {\n\t/** Tool call identifier; duplicated here for standalone telemetry use. */\n\tcallId: string;\n\t/** Tool name, never arguments. */\n\ttoolName: string;\n\t/** Zero-based order from the model-emitted tool-call list. */\n\temittedIndex: number;\n\t/** Scheduler wave number when the call entered an execution wave. */\n\twaveIndex?: number;\n\t/** Scheduler outcome for this call. */\n\tdecision: ToolSchedulingDecisionKind;\n\t/** Stable reason code; intentionally avoids raw paths and arguments. */\n\treason: string;\n\t/** Time spent waiting inside the scheduler after model emission. */\n\tschedulerWaitMs?: number;\n\t/** True when an MCP server opt-in made the call parallel-safe. */\n\tmcpOptIn?: boolean;\n\t/** True when execution was served from reusable tool-result state. */\n\tcacheHit?: boolean;\n\t/** True when an in-flight mutation forced a wait or serialization. */\n\tblockedByMutation?: boolean;\n}\n\nexport type ToolPhaseDecisionOutcome =\n\t| \"parallelized\"\n\t| \"serialized\"\n\t| \"delayed\"\n\t| \"cached\"\n\t| \"skipped\";\n\nexport interface ToolPhaseDecision {\n\ttoolCallId: string;\n\ttoolName: string;\n\temittedIndex: number;\n\toutcome: ToolPhaseDecisionOutcome;\n\tdecision: ToolPhaseDecisionOutcome;\n\treason: string;\n\twaveIndex?: number;\n\twaitMs: number;\n\tschedulerWaitMs: number;\n\tmcpOptIn?: boolean;\n\tcacheHit?: boolean;\n\tblockedByMutation?: boolean;\n}\n\nexport interface ParallelismScopeMetadata {\n\tpathScope?: string[];\n\tpathScopeSource?: \"annotation\" | \"known_tool\";\n\tpathArgumentKeys?: string[];\n}\n\nexport interface ParallelismGatedEvent extends ParallelismScopeMetadata {\n\ttype: \"parallelism_gated\";\n\ttoolCallId: string;\n\ttoolName: string;\n\treason: \"mutation_scope_overlap\" | \"mutation_unknown_write_set\";\n\tqueueDepth: number;\n\tpendingMutations: number;\n\tpendingToolCallIds: string[];\n\tpendingToolNames: string[];\n}\n\nexport interface ParallelConflictDetectedEvent\n\textends ParallelismScopeMetadata {\n\ttype: \"parallel_conflict_detected\";\n\ttoolCallId: string;\n\ttoolName: string;\n\tconflictingToolCallId: string;\n\tconflictingToolName: string;\n\tconflictingPathScope?: string[];\n\tconflictingPathScopeSource?: \"annotation\" | \"known_tool\";\n}\n\nexport interface ToolPhaseBatchShapingFeedback {\n\tavoidableSingleton: boolean;\n\treason: string;\n\thint: string;\n}\n\nexport interface ToolPhaseSummary {\n\ttype: \"tool_phase_summary\";\n\tmodelToolCallCount: number;\n\tmodelEmittedToolCallCount: number;\n\tschedulableWaveCount: number;\n\tparallelizedCallCount: number;\n\tactuallyParallelizedCallCount: number;\n\tserializedCallCount: number;\n\tdelayedCallCount: number;\n\tblockedByMutationCount: number;\n\tmcpOptInCallCount: number;\n\tmcpOptInUseCount: number;\n\tcacheHitCount: number;\n\ttotalToolWaitMs: number;\n\ttoolWaitTimeMs: number;\n\tserializationReasons: Record<string, number>;\n\tdecisions: ToolPhaseDecision[];\n\tbatchShapingFeedback?: ToolPhaseBatchShapingFeedback;\n}\n\n/**\n * Token usage and cost information for a message or request.\n *\n * Tracks input/output tokens and cache utilization for cost monitoring\n * and context window management.\n */\nexport interface Usage {\n\t/** Number of input tokens consumed */\n\tinput: number;\n\t/** Number of output tokens generated */\n\toutput: number;\n\t/** Tokens served from prompt cache (reduces cost) */\n\tcacheRead: number;\n\t/** Tokens written to prompt cache */\n\tcacheWrite: number;\n\t/** Calculated cost breakdown in USD */\n\tcost: {\n\t\t/** Cost for input tokens */\n\t\tinput: number;\n\t\t/** Cost for output tokens */\n\t\toutput: number;\n\t\t/** Cost savings from cache reads */\n\t\tcacheRead: number;\n\t\t/** Cost for cache writes */\n\t\tcacheWrite: number;\n\t\t/** Total cost for this message/request */\n\t\ttotal: number;\n\t};\n}\n\n/**\n * Reason why the model stopped generating.\n *\n * - `stop` - Natural completion (end of response)\n * - `length` - Hit max_tokens limit\n * - `toolUse` - Model wants to use a tool (generation paused)\n * - `error` - An error occurred during generation\n * - `aborted` - Request was cancelled by the user\n */\nexport type StopReason = \"stop\" | \"length\" | \"toolUse\" | \"error\" | \"aborted\";\n\n/**\n * Message from the human user.\n *\n * User messages can contain plain text or an array of content blocks\n * (for multi-modal input with images).\n *\n * @example\n * ```typescript\n * // Simple text message\n * const msg: UserMessage = {\n *   role: \"user\",\n *   content: \"What is this code doing?\",\n *   timestamp: Date.now()\n * };\n *\n * // Message with image\n * const multiModal: UserMessage = {\n *   role: \"user\",\n *   content: [\n *     { type: \"text\", text: \"What's in this screenshot?\" },\n *     { type: \"image\", data: base64Data, mimeType: \"image/png\" }\n *   ],\n *   timestamp: Date.now()\n * };\n * ```\n */\nexport interface UserMessage {\n\t/** Message role discriminator */\n\trole: \"user\";\n\t/** Message content - string or array of content blocks */\n\tcontent: string | (TextContent | ImageContent)[];\n\t/** Optional non-LLM metadata for runtime bookkeeping */\n\tmetadata?: Record<string, unknown>;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n}\n\n/**\n * Response message from the AI assistant.\n *\n * Contains the model's response along with metadata about the generation\n * including token usage, stop reason, and provider information.\n *\n * The content array may contain:\n * - {@link TextContent} - The actual response text\n * - {@link ThinkingContent} - Extended reasoning (if enabled)\n * - {@link ToolCall} - Tool invocation requests\n */\nexport interface AssistantMessage {\n\t/** Message role discriminator */\n\trole: \"assistant\";\n\t/** Array of content blocks (text, thinking, tool calls) */\n\tcontent: (TextContent | ThinkingContent | ToolCall)[];\n\t/** API format used for this response */\n\tapi: Api;\n\t/** Provider that generated this response */\n\tprovider: Provider;\n\t/** Model ID that generated this response */\n\tmodel: string;\n\t/** Token usage and cost information */\n\tusage: Usage;\n\t/** Reason why generation stopped */\n\tstopReason: StopReason;\n\t/** Error message if stopReason is \"error\" */\n\terrorMessage?: string;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n\t/** Immutable model/profile routing decision for this turn. */\n\troutingReceipt?: RoutingReceipt;\n}\n\n/**\n * Result message from a tool execution.\n *\n * After a tool is executed, the result is sent back to the model\n * as a ToolResultMessage so it can incorporate the information\n * into its response.\n *\n * @typeParam TDetails - Type of additional details attached to the result\n *\n * @example\n * ```typescript\n * const result: ToolResultMessage = {\n *   role: \"toolResult\",\n *   toolCallId: \"call_abc123\",\n *   toolName: \"read\",\n *   content: [{ type: \"text\", text: \"file contents...\" }],\n *   isError: false,\n *   timestamp: Date.now()\n * };\n * ```\n */\nexport interface ToolResultMessage<TDetails = unknown> {\n\t/** Message role discriminator */\n\trole: \"toolResult\";\n\t/** ID of the tool call this result corresponds to */\n\ttoolCallId: string;\n\t/** Name of the tool that was executed */\n\ttoolName: string;\n\t/** Result content (text or images) */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Optional additional details about the execution */\n\tdetails?: TDetails;\n\t/** Whether the tool execution resulted in an error */\n\tisError: boolean;\n\t/** Unix timestamp in milliseconds when result was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for hook-injected messages.\n *\n * Hooks can inject these into the conversation. They are converted to user\n * messages for LLM context and can optionally be hidden from the UI.\n */\nexport interface HookMessage<T = unknown> {\n\t/** Message role discriminator */\n\trole: \"hookMessage\";\n\t/** Hook-defined message category */\n\tcustomType: string;\n\t/** Message content - string or array of content blocks */\n\tcontent: string | (TextContent | ImageContent)[];\n\t/** Whether to render this message in the UI */\n\tdisplay: boolean;\n\t/** Optional hook-specific metadata (not sent to the LLM) */\n\tdetails?: T;\n\t/** Unix timestamp in milliseconds when message was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for branch summaries when navigating session trees.\n */\nexport interface BranchSummaryMessage {\n\t/** Message role discriminator */\n\trole: \"branchSummary\";\n\t/** Summary text */\n\tsummary: string;\n\t/** ID of the branch point this summary came from */\n\tfromId: string;\n\t/** Unix timestamp in milliseconds when summary was created */\n\ttimestamp: number;\n}\n\n/**\n * Message type for compaction summaries.\n */\nexport interface CompactionSummaryMessage {\n\t/** Message role discriminator */\n\trole: \"compactionSummary\";\n\t/** Summary text */\n\tsummary: string;\n\t/** Token count before compaction (for diagnostics) */\n\ttokensBefore: number;\n\t/** Unix timestamp in milliseconds when summary was created */\n\ttimestamp: number;\n}\n\n/**\n * Union type representing LLM-native messages that can be sent to the model.\n *\n * A conversation with the LLM consists of user input, assistant responses,\n * and tool results.\n */\nexport type Message = UserMessage | AssistantMessage | ToolResultMessage;\n\n/**\n * Empty interface for declaration merging to add custom message types.\n *\n * Consumers can extend this interface to add their own message types:\n *\n * @example\n * ```typescript\n * declare module \"@evalops/maestro\" {\n *   interface CustomAgentMessages {\n *     notification: { role: \"notification\"; text: string; timestamp: number };\n *   }\n * }\n * ```\n */\n// biome-ignore lint/suspicious/noEmptyInterface: Required for declaration merging\nexport interface CustomAgentMessages {}\n\n/**\n * Union type representing all messages in the agent conversation history.\n *\n * Includes both LLM-native messages (user, assistant, toolResult) and\n * custom message types (hookMessage, branchSummary, compactionSummary,\n * plus any types added via declaration merging).\n *\n * Custom messages are preserved in session history but filtered out\n * before being sent to the LLM via {@link convertToLlm}.\n */\nexport type AgentMessage =\n\t| Message\n\t| HookMessage\n\t| BranchSummaryMessage\n\t| CompactionSummaryMessage\n\t| CustomAgentMessages[keyof CustomAgentMessages];\n\n/**\n * Tool definition schema for API serialization.\n *\n * This interface defines a tool's metadata and parameter schema\n * for transmission to the LLM. The actual execution logic is in\n * {@link AgentTool}.\n *\n * @typeParam TParameters - TypeBox schema for the tool's parameters\n *\n * @example\n * ```typescript\n * import { Type } from \"@sinclair/typebox\";\n *\n * const readTool: Tool = {\n *   name: \"read\",\n *   description: \"Read a file from the filesystem\",\n *   parameters: Type.Object({\n *     file_path: Type.String({ description: \"Path to the file\" })\n *   })\n * };\n * ```\n */\nexport interface Tool<TParameters extends TSchema = TSchema> {\n\t/** Unique tool identifier */\n\tname: string;\n\t/** Human-readable description of what the tool does */\n\tdescription: string;\n\t/** TypeBox schema defining the tool's parameters */\n\tparameters: TParameters;\n\t/** Optional categorization (e.g., \"file\", \"shell\", \"web\") */\n\ttoolType?: string;\n\t/** Example inputs for documentation/few-shot prompting */\n\tinputExamples?: unknown[];\n\t/** List of caller identifiers allowed to use this tool */\n\tallowedCallers?: string[];\n\t/** If true, don't send tool definition to API (used for internal tools) */\n\tdeferApiDefinition?: boolean;\n}\n\n/**\n * Behavioral hints for tools (from MCP annotations).\n *\n * These hints help the model and UI understand the tool's behavior\n * for better decision-making and user feedback.\n */\nexport interface ToolAnnotations {\n\t/** If true, the tool does not modify its environment (safe to retry) */\n\treadOnlyHint?: boolean;\n\t/** If true, the tool may perform destructive/irreversible updates */\n\tdestructiveHint?: boolean;\n\t/** If true, mutating calls are scoped to explicit path arguments */\n\tpathScopedMutationHint?: boolean;\n\t/** If true, calling repeatedly with same args has no additional effect */\n\tidempotentHint?: boolean;\n\t/** If true, the tool interacts with external systems (network, APIs) */\n\topenWorldHint?: boolean;\n}\n\nexport interface McpToolSourceMetadata {\n\ttype: \"mcp\";\n\tserver: string;\n\ttool: string;\n\tcapability?: ToolCapabilityMetadata;\n\tsupportsParallelToolCalls?: boolean;\n\tparallelSafetyProvenance?: \"static_config\" | \"server_capability\" | \"none\";\n\tparallelMaxConcurrency?: number;\n}\n\nexport type ToolSourceMetadata = McpToolSourceMetadata;\n\n/**\n * Complete tool definition with execute function.\n *\n * This is the runtime representation of a tool, including both\n * the schema (for the LLM) and the execute function (for the runtime).\n *\n * @typeParam TParameters - TypeBox schema for the tool's parameters\n * @typeParam TDetails - Type of additional details returned with results\n *\n * @example\n * ```typescript\n * import { Type } from \"@sinclair/typebox\";\n *\n * const readTool: AgentTool = {\n *   name: \"read\",\n *   description: \"Read a file from the filesystem\",\n *   parameters: Type.Object({\n *     file_path: Type.String()\n *   }),\n *   execute: async (toolCallId, params) => {\n *     const content = await fs.readFile(params.file_path, \"utf-8\");\n *     return { content: [{ type: \"text\", text: content }] };\n *   }\n * };\n * ```\n */\nexport interface AgentTool<\n\tTParameters extends TSchema = TSchema,\n\tTDetails = unknown,\n> {\n\t/** Unique tool identifier */\n\tname: string;\n\t/** Display label for UI (defaults to name) */\n\tlabel?: string;\n\t/** Human-readable description of what the tool does */\n\tdescription: string;\n\t/** TypeBox schema defining the tool's parameters */\n\tparameters: TParameters;\n\t/** Tool behavior hints from MCP annotations */\n\tannotations?: ToolAnnotations;\n\t/** Exact runtime provenance for bridged or remote tool sources */\n\tsource?: ToolSourceMetadata;\n\t/** Optional categorization (e.g., \"file\", \"shell\", \"web\") */\n\ttoolType?: string;\n\t/**\n\t * Where the tool should be executed.\n\t * - `\"server\"`: (default) Executed by the backend agent\n\t * - `\"client\"`: Executed by the client (VS Code, browser) via callback\n\t */\n\texecutionLocation?: \"server\" | \"client\";\n\t/** Example inputs for documentation/few-shot prompting */\n\tinputExamples?: unknown[];\n\t/** List of caller identifiers allowed to use this tool */\n\tallowedCallers?: string[];\n\t/** If true, don't send tool definition to API */\n\tdeferApiDefinition?: boolean;\n\t/** Optional max retries configured by the tool itself */\n\tmaxRetries?: number;\n\t/** Optional retry delay configured by the tool itself */\n\tretryDelayMs?: number;\n\t/** Optional tool-level retry predicate */\n\tshouldRetry?: (error: unknown) => boolean;\n\t/** Optional compact summary used after a tool finishes. */\n\tgetToolUseSummary?: (params: Record<string, unknown>) => string | null;\n\t/** Optional human-facing label used for live tool UI. */\n\tgetDisplayName?: (params: Record<string, unknown>) => string | null;\n\t/** Optional present-tense activity label used while a tool is running. */\n\tgetActivityDescription?: (params: Record<string, unknown>) => string | null;\n\t/**\n\t * Execute the tool with the given parameters.\n\t *\n\t * @param toolCallId - Unique identifier for this tool call\n\t * @param params - Parameters matching the tool's schema\n\t * @param signal - Optional AbortSignal for cancellation\n\t * @param context - Optional execution context (sandbox, etc.)\n\t * @param onUpdate - Optional callback for partial tool output streaming\n\t * @returns Tool result with content and optional details\n\t */\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Record<string, unknown>,\n\t\tsignal?: AbortSignal,\n\t\tcontext?: { sandbox?: import(\"../sandbox/types.js\").Sandbox },\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => AgentToolResult<TDetails> | Promise<AgentToolResult<TDetails>>;\n}\n\nexport type AgentToolUpdateCallback<TDetails = unknown> = (\n\tpartial: AgentToolResult<TDetails>,\n) => void;\n\n/**\n * Result returned from tool execution.\n *\n * @typeParam TDetails - Type of additional details attached to the result\n */\nexport interface AgentToolResult<TDetails = unknown> {\n\t/** Result content (text or images) */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Optional additional details about the execution */\n\tdetails?: TDetails;\n\t/** Whether the execution resulted in an error */\n\tisError?: boolean;\n\t/** Optional Platform ToolExecution identifier used for audit joins */\n\ttoolExecutionId?: string;\n\t/** Optional Platform approval request identifier correlated to ToolExecution */\n\tapprovalRequestId?: string;\n}\n\n/**\n * Conversation context for LLM requests.\n *\n * Contains the system prompt, conversation history, and available tools\n * for a single LLM request.\n */\nexport interface Context {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt?: string;\n\t/** Conversation history */\n\tmessages: Message[];\n\t/** Tools available for the model to use */\n\ttools?: Tool[];\n}\n\n/**\n * Streaming events during assistant message construction.\n *\n * These events are emitted as the LLM generates its response, enabling\n * real-time UI updates and progress tracking.\n *\n * ## Event Types\n *\n * | Type | Description |\n * |------|-------------|\n * | `start` | Message generation started |\n * | `text_start` | New text content block started |\n * | `text_delta` | Incremental text content |\n * | `text_end` | Text content block completed |\n * | `thinking_start` | Extended thinking block started |\n * | `thinking_delta` | Incremental thinking content |\n * | `thinking_end` | Thinking block completed |\n * | `toolcall_start` | Tool call started |\n * | `toolcall_delta` | Incremental tool call args |\n * | `toolcall_end` | Tool call completed |\n * | `done` | Generation completed successfully |\n * | `error` | Generation failed or was aborted |\n */\nexport type AssistantMessageEvent =\n\t| {\n\t\t\t/** Message generation started */\n\t\t\ttype: \"start\";\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** New text content block started */\n\t\t\ttype: \"text_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental text content received */\n\t\t\ttype: \"text_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New text to append */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Text content block completed */\n\t\t\ttype: \"text_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Final text content */\n\t\t\tcontent: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Extended thinking block started */\n\t\t\ttype: \"thinking_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental thinking content received */\n\t\t\ttype: \"thinking_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New thinking text to append */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Thinking content block completed */\n\t\t\ttype: \"thinking_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Final thinking content */\n\t\t\tcontent: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Tool call started */\n\t\t\ttype: \"toolcall_start\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental tool call arguments received */\n\t\t\ttype: \"toolcall_delta\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** New JSON fragment to append to arguments */\n\t\t\tdelta: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Tool call completed */\n\t\t\ttype: \"toolcall_end\";\n\t\t\t/** Index of the content block */\n\t\t\tcontentIndex: number;\n\t\t\t/** Completed tool call */\n\t\t\ttoolCall: ToolCall;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution started outside Maestro's local executor */\n\t\t\ttype: \"provider_tool_execution_start\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool arguments */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution produced an incremental update */\n\t\t\ttype: \"provider_tool_execution_update\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool arguments */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Partial provider result */\n\t\t\tpartialResult: AgentToolResult;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Provider-owned tool execution completed outside Maestro's local executor */\n\t\t\ttype: \"provider_tool_execution_end\";\n\t\t\t/** Provider tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Provider tool name */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Provider tool result */\n\t\t\tresult: ToolResultMessage;\n\t\t\t/** Whether the provider tool returned an error */\n\t\t\tisError: boolean;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Optional Platform approval request identifier correlated to ToolExecution */\n\t\t\tapprovalRequestId?: string;\n\t\t\t/** Partial message state */\n\t\t\tpartial: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Generation completed successfully */\n\t\t\ttype: \"done\";\n\t\t\t/** Reason for completion */\n\t\t\treason: Extract<StopReason, \"stop\" | \"length\" | \"toolUse\">;\n\t\t\t/** Final assistant message */\n\t\t\tmessage: AssistantMessage;\n\t  }\n\t| {\n\t\t\t/** Generation failed or was aborted */\n\t\t\ttype: \"error\";\n\t\t\t/** Reason for failure */\n\t\t\treason: Extract<StopReason, \"aborted\" | \"error\">;\n\t\t\t/** Error message details */\n\t\t\terror: AssistantMessage;\n\t  };\n\n/**\n * LLM model configuration.\n *\n * Contains all the information needed to use a model, including\n * API endpoints, capabilities, and pricing.\n *\n * @typeParam TApi - The API format this model uses\n *\n * @example\n * ```typescript\n * const claude: Model<\"anthropic-messages\"> = {\n *   id: \"claude-sonnet-4-5-20250929\",\n *   name: \"Claude Sonnet 4.5\",\n *   api: \"anthropic-messages\",\n *   provider: \"anthropic\",\n *   baseUrl: \"https://api.anthropic.com/v1\",\n *   reasoning: true,\n *   input: [\"text\", \"image\"],\n *   cost: { input: 3.00, output: 15.00, cacheRead: 0.30, cacheWrite: 3.75 },\n *   contextWindow: 200000,\n *   maxTokens: 8192\n * };\n * ```\n */\nexport interface Model<TApi extends Api> {\n\t/** Unique model identifier (e.g., \"claude-sonnet-4-5-20250929\") */\n\tid: string;\n\t/** Human-readable model name (e.g., \"Claude Sonnet 4.5\") */\n\tname: string;\n\t/** API format used for requests */\n\tapi: TApi;\n\t/** Provider serving this model */\n\tprovider: Provider;\n\t/** Base URL for API requests */\n\tbaseUrl: string;\n\t/** Optional custom headers to include in API requests */\n\theaders?: Record<string, string>;\n\t/** Optional OpenAI-compatibility overrides for vendor quirks */\n\tcompat?: OpenAICompatOverrides;\n\t/** Whether the model supports extended thinking */\n\treasoning: boolean;\n\t/** Whether the model supports tool use */\n\ttoolUse?: boolean;\n\t/** Supported input modalities */\n\tinput: (\"text\" | \"image\")[];\n\t/** Cost per million tokens in USD */\n\tcost: {\n\t\t/** Input token cost */\n\t\tinput: number;\n\t\t/** Output token cost */\n\t\toutput: number;\n\t\t/** Cache read cost (typically discounted) */\n\t\tcacheRead: number;\n\t\t/** Cache write cost */\n\t\tcacheWrite: number;\n\t};\n\t/** Maximum context window in tokens */\n\tcontextWindow: number;\n\t/** Maximum output tokens per response */\n\tmaxTokens: number;\n}\n\n/**\n * File attachment for messages.\n *\n * Represents an uploaded file (image or document) that can be\n * included in a user message.\n */\nexport interface Attachment {\n\t/** Unique identifier for this attachment */\n\tid: string;\n\t/** Type of attachment */\n\ttype: \"image\" | \"document\";\n\t/** Original filename */\n\tfileName: string;\n\t/** MIME type of the file */\n\tmimeType: string;\n\t/** File size in bytes */\n\tsize: number;\n\t/** Base64-encoded file content */\n\tcontent: string;\n\t/** Extracted text content (for documents) */\n\textractedText?: string;\n\t/** Preview image (for documents) */\n\tpreview?: string;\n}\n\n/**\n * User-configurable thinking level for extended reasoning.\n *\n * Controls how much computational effort the model spends on\n * reasoning before generating a response.\n *\n * - `off` - No extended thinking\n * - `minimal` - Brief reasoning hints\n * - `low` - Short reasoning steps\n * - `medium` - Moderate reasoning (default)\n * - `high` - Thorough step-by-step reasoning\n * - `max` - Maximum reasoning depth\n */\nexport type ThinkingLevel =\n\t| \"off\"\n\t| \"minimal\"\n\t| \"low\"\n\t| \"medium\"\n\t| \"high\"\n\t| \"ultra\"\n\t| \"max\";\n\n/**\n * User message with optional file attachments.\n *\n * Extends the base UserMessage to support file attachments\n * for rich multi-modal interactions.\n */\nexport type UserMessageWithAttachments = UserMessage & {\n\t/** Optional file attachments */\n\tattachments?: Attachment[];\n};\n\n/**\n * Placeholder for custom message types.\n * Can be extended to add application-specific message types.\n */\nexport interface CustomMessages {\n\thookMessage: HookMessage;\n\tbranchSummary: BranchSummaryMessage;\n\tcompactionSummary: CompactionSummaryMessage;\n}\n\n/**\n * Application-level message type.\n *\n * Union of all message types that can appear in the UI,\n * including user messages with attachments.\n */\nexport type AppMessage =\n\t| AssistantMessage\n\t| UserMessageWithAttachments\n\t| Message\n\t| CustomMessages[keyof CustomMessages];\n\n/**\n * Information about a tool call currently being executed.\n */\nexport interface PendingToolCall {\n\t/** Name of the tool being executed */\n\ttoolName: string;\n\t/** Original arguments passed to the tool */\n\targs?: Record<string, unknown>;\n\t/** Tool metadata captured when execution started */\n\ttool?: Pick<\n\t\tAgentTool,\n\t\t\"label\" | \"getDisplayName\" | \"getToolUseSummary\" | \"getActivityDescription\"\n\t>;\n\t/** Stable display name for live UI */\n\tdisplayName?: string;\n\t/** Stable compact summary for live UI */\n\tsummaryLabel?: string;\n}\n\n/**\n * Current state of an agent instance.\n *\n * This is the central state object managed by the Agent class,\n * containing all information about the current conversation,\n * configuration, and execution status.\n */\nexport interface AgentState {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt: string;\n\t/** Version/hash metadata for the base system prompt instructions */\n\tpromptMetadata?: PromptMetadata;\n\t/** Exact prompt source files layered into the current system prompt */\n\tsystemPromptSourcePaths?: string[];\n\t/** Manifest of project instruction files layered into the current system prompt */\n\tpromptContextManifest?: PromptProjectDocManifest;\n\t/** Full filesystem and MCP context provenance captured for this run */\n\tunifiedContextManifest?: UnifiedContextManifest;\n\t/** Current model configuration */\n\tmodel: Model<Api>;\n\t/** Current thinking level for extended reasoning */\n\tthinkingLevel: ThinkingLevel;\n\t/** Optional reasoning summary preference for Responses API */\n\treasoningSummary?: \"auto\" | \"detailed\" | \"concise\" | null;\n\t/** Available tools for this agent */\n\ttools: AgentTool[];\n\t/**\n\t * Controls how queued steering messages are sent between turns.\n\t * - `\"all\"` - Send all queued messages at once\n\t * - `\"one\"` - Send one message at a time\n\t */\n\tsteeringMode: \"all\" | \"one\";\n\t/**\n\t * Controls how queued follow-up messages are sent between turns.\n\t * - `\"all\"` - Send all queued messages at once\n\t * - `\"one\"` - Send one message at a time\n\t */\n\tfollowUpMode: \"all\" | \"one\";\n\t/**\n\t * @deprecated Use steeringMode/followUpMode instead.\n\t */\n\tqueueMode: \"all\" | \"one\";\n\t/** Conversation history */\n\tmessages: AppMessage[];\n\t/** Whether the agent is currently streaming a response */\n\tisStreaming: boolean;\n\t/** Current streaming message (partial response) */\n\tstreamMessage: Message | null;\n\t/** Tool calls currently being executed */\n\tpendingToolCalls: Map<string, PendingToolCall>;\n\t/** Current error message, if any */\n\terror?: string;\n\t/** Optional sandbox for isolated tool execution */\n\tsandbox?: import(\"../sandbox/types.js\").Sandbox;\n\t/** Current sandbox mode (e.g., \"docker\", \"local\") */\n\tsandboxMode?: string | null;\n\t/** Whether sandboxing is enabled */\n\tsandboxEnabled?: boolean;\n\t/** User identification for tracking */\n\tuser?: {\n\t\t/** User UUID */\n\t\tid: string;\n\t\t/** Organization UUID */\n\t\torgId: string;\n\t};\n\t/** Session information for persistence */\n\tsession?: {\n\t\t/** Session UUID */\n\t\tid: string;\n\t\t/** When the session started */\n\t\tstartedAt: Date;\n\t};\n\t/** Sampling temperature override (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Top-p sampling override (0.0-1.0) */\n\ttopP?: number;\n}\n\n/**\n * Events emitted during agent execution.\n *\n * These events provide real-time updates about agent activity,\n * enabling UI updates, logging, and progress tracking.\n *\n * ## Lifecycle Events\n * - `agent_start` - Agent execution started\n * - `agent_end` - Agent execution completed\n * - `turn_start` - New conversation turn started\n * - `turn_end` - Conversation turn completed\n *\n * ## Message Events\n * - `message_start` - New message being constructed\n * - `message_update` - Incremental message update\n * - `message_end` - Message completed\n *\n * ## Tool Events\n * - `tool_execution_start` - Tool execution started\n * - `tool_execution_update` - Tool execution produced partial output\n * - `tool_execution_end` - Tool execution completed\n * - `parallelism_gated` - Scheduler delayed a tool because in-flight mutations made parallel execution unsafe\n * - `parallel_conflict_detected` - Scheduler detected overlapping write scopes while evaluating parallel execution\n * - `tool_batch_summary` - Tool batch completed with a transient summary label\n * - `client_tool_request` - Client-side tool invocation needed\n *\n * ## Approval Events\n * - `action_approval_required` - User approval needed\n * - `action_approval_resolved` - User made approval decision\n *\n * ## Tool Retry Events\n * - `tool_retry_required` - Tool failed and retry decision needed\n * - `tool_retry_resolved` - Tool retry decision resolved\n *\n * ## Status Events\n * - `status` - Status update\n * - `error` - Error occurred\n * - `compaction` - Context was compacted\n */\nexport interface ToolSchedulingMetadata {\n\tclassification:\n\t\t| \"read_only\"\n\t\t| \"path_scoped_mutation\"\n\t\t| \"parallel_safe_mutation\"\n\t\t| \"serialized_mutation\"\n\t\t| \"workflow_serialized\"\n\t\t| \"cache_reuse\"\n\t\t| \"unknown\";\n\treason:\n\t\t| \"read_only_tool\"\n\t\t| \"mcp_parallel_opt_in\"\n\t\t| \"path_scope_available\"\n\t\t| \"path_scope_disjoint\"\n\t\t| \"path_scope_overlap\"\n\t\t| \"pending_mutation\"\n\t\t| \"mutating_tool\"\n\t\t| \"workflow_state_tracker\"\n\t\t| \"cache_hit\"\n\t\t| \"cache_pending\"\n\t\t| \"unknown_tool\";\n\tconcurrencyLimit?: number;\n\tqueueDepth?: number;\n\tpendingMutations?: number;\n\tpathScope?: string[];\n\tpathScopeSource?: \"annotation\" | \"known_tool\";\n\tpathArgumentKeys?: string[];\n\tcache?: \"disabled\" | \"miss\" | \"candidate\" | \"pending_hit\" | \"hit\";\n}\n\nexport type AgentEvent =\n\t| {\n\t\t\t/** Agent execution started */\n\t\t\ttype: \"agent_start\";\n\t\t\t/** Whether this execution is an automatic continuation of the current turn */\n\t\t\tcontinuation?: boolean;\n\t  }\n\t| {\n\t\t\t/** Agent execution completed */\n\t\t\ttype: \"agent_end\";\n\t\t\t/** Final messages from this execution */\n\t\t\tmessages: AppMessage[];\n\t\t\t/** Whether execution was aborted */\n\t\t\taborted?: boolean;\n\t\t\t/** If aborted with partial acceptance, contains the saved partial message */\n\t\t\tpartialAccepted?: AppMessage;\n\t\t\t/** Final stop reason from the LLM - \"length\" indicates output hit the max token limit */\n\t\t\tstopReason?: StopReason;\n\t  }\n\t| {\n\t\t\t/** Status update during execution */\n\t\t\ttype: \"status\";\n\t\t\t/** Status message */\n\t\t\tstatus: string;\n\t\t\t/** Additional details */\n\t\t\tdetails: Record<string, unknown>;\n\t  }\n\t| {\n\t\t\t/** Error occurred during execution */\n\t\t\ttype: \"error\";\n\t\t\t/** Error message */\n\t\t\tmessage: string;\n\t  }\n\t| {\n\t\t\t/** New conversation turn started */\n\t\t\ttype: \"turn_start\";\n\t  }\n\t| {\n\t\t\t/** Conversation turn completed */\n\t\t\ttype: \"turn_end\";\n\t\t\t/** Assistant message from this turn */\n\t\t\tmessage: AppMessage;\n\t\t\t/** Tool results from this turn */\n\t\t\ttoolResults: AppMessage[];\n\t  }\n\t| {\n\t\t\t/** New message being constructed */\n\t\t\ttype: \"message_start\";\n\t\t\t/** The message being built */\n\t\t\tmessage: AppMessage;\n\t  }\n\t| {\n\t\t\t/** Incremental update to current message */\n\t\t\ttype: \"message_update\";\n\t\t\t/** Updated message state */\n\t\t\tmessage: AppMessage;\n\t\t\t/** The streaming event that triggered this update */\n\t\t\tassistantMessageEvent: AssistantMessageEvent;\n\t  }\n\t| {\n\t\t\t/** Message completed */\n\t\t\ttype: \"message_end\";\n\t\t\t/** Final message */\n\t\t\tmessage: AppMessage;\n\t  }\n\t| {\n\t\t\t/** Tool execution started */\n\t\t\ttype: \"tool_execution_start\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Arguments passed to the tool */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Scheduler classification and serialization reason for this call */\n\t\t\tscheduling?: ToolSchedulingMetadata;\n\t  }\n\t| {\n\t\t\t/** Tool execution completed */\n\t\t\ttype: \"tool_execution_end\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Optional approval request identifier correlated to Platform ToolExecution */\n\t\t\tapprovalRequestId?: string;\n\t\t\t/** Optional stable error or outcome code for telemetry and clients */\n\t\t\terrorCode?: string;\n\t\t\t/** Optional governed outcome classification surfaced by the tool result */\n\t\t\tgovernedOutcome?:\n\t\t\t\t| \"approval_required\"\n\t\t\t\t| \"approval_pending\"\n\t\t\t\t| \"authentication_required\"\n\t\t\t\t| \"denied\"\n\t\t\t\t| \"rate_limited\";\n\t\t\t/** Optional selected skill artifact metadata surfaced by the tool result */\n\t\t\tskillMetadata?: SkillArtifactMetadata;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Result from the tool */\n\t\t\tresult: ToolResultMessage;\n\t\t\t/** Whether the tool returned an error */\n\t\t\tisError: boolean;\n\t\t\t/** Scheduler classification and final reuse/serialization reason */\n\t\t\tscheduling?: ToolSchedulingMetadata;\n\t  }\n\t| ParallelismGatedEvent\n\t| ParallelConflictDetectedEvent\n\t| {\n\t\t\t/** LSP diagnostic delta produced by an edit/write tool call */\n\t\t\ttype: \"diagnostic_delta\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** File affected by the diagnostic delta */\n\t\t\tfile: string;\n\t\t\t/** User-facing file path from the tool call */\n\t\t\tdisplayPath: string;\n\t\t\t/** Whether a pre-edit baseline was available */\n\t\t\tusedDelta: boolean;\n\t\t\t/** Newly introduced diagnostic count */\n\t\t\tintroducedCount: number;\n\t\t\t/** Diagnostics repaired by the tool call */\n\t\t\trepairedCount: number;\n\t\t\t/** Remaining diagnostics for the affected file */\n\t\t\tremainingCount: number;\n\t\t\t/** Stable fingerprint for introduced diagnostics */\n\t\t\tfingerprint: string;\n\t\t\t/** Repair attempt number for this fingerprint */\n\t\t\trepairAttempt?: number;\n\t\t\t/** Maximum automatic repair attempts for this fingerprint */\n\t\t\tmaxRepairAttempts?: number;\n\t\t\t/** Whether Agent queued a follow-up repair turn */\n\t\t\twillAutoFollowUp: boolean;\n\t\t\t/** Why a repair follow-up was or was not queued */\n\t\t\treason: string;\n\t  }\n\t| {\n\t\t\t/** Summary emitted after the final tool in a batch completes */\n\t\t\ttype: \"tool_batch_summary\";\n\t\t\t/** Stable one-line summary of what the completed tool batch did */\n\t\t\tsummary: string;\n\t\t\t/** Underlying per-tool summary labels used to build the summary */\n\t\t\tsummaryLabels: string[];\n\t\t\t/** Tool call identifiers included in this batch */\n\t\t\ttoolCallIds: string[];\n\t\t\t/** Tool names included in this batch */\n\t\t\ttoolNames: string[];\n\t\t\t/** Successful tool calls in the batch */\n\t\t\tcallsSucceeded: number;\n\t\t\t/** Failed tool calls in the batch */\n\t\t\tcallsFailed: number;\n\t  }\n\t| ToolPhaseSummary\n\t| {\n\t\t\t/** Tool execution produced partial output */\n\t\t\ttype: \"tool_execution_update\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Optional Platform ToolExecution identifier */\n\t\t\ttoolExecutionId?: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Optional human-facing label for live UI */\n\t\t\tdisplayName?: string;\n\t\t\t/** Optional compact summary for live UI */\n\t\t\tsummaryLabel?: string;\n\t\t\t/** Arguments passed to the tool */\n\t\t\targs: Record<string, unknown>;\n\t\t\t/** Partial tool result */\n\t\t\tpartialResult: AgentToolResult;\n\t  }\n\t| {\n\t\t\t/** User approval required for an action */\n\t\t\ttype: \"action_approval_required\";\n\t\t\t/** Details of the approval request */\n\t\t\trequest: ActionApprovalRequest;\n\t  }\n\t| {\n\t\t\t/** User made approval decision */\n\t\t\ttype: \"action_approval_resolved\";\n\t\t\t/** The original request */\n\t\t\trequest: ActionApprovalRequest;\n\t\t\t/** User's decision */\n\t\t\tdecision: ActionApprovalDecision;\n\t  }\n\t| {\n\t\t\t/** Tool failed and requires a retry decision */\n\t\t\ttype: \"tool_retry_required\";\n\t\t\t/** Details of the retry request */\n\t\t\trequest: ToolRetryRequest;\n\t  }\n\t| {\n\t\t\t/** Tool retry decision resolved */\n\t\t\ttype: \"tool_retry_resolved\";\n\t\t\t/** The original request */\n\t\t\trequest: ToolRetryRequest;\n\t\t\t/** User or policy decision */\n\t\t\tdecision: ToolRetryDecision;\n\t  }\n\t| {\n\t\t\t/** Client-side tool invocation needed */\n\t\t\ttype: \"client_tool_request\";\n\t\t\t/** Tool call identifier */\n\t\t\ttoolCallId: string;\n\t\t\t/** Name of the tool */\n\t\t\ttoolName: string;\n\t\t\t/** Arguments for the tool */\n\t\t\targs: unknown;\n\t  }\n\t| {\n\t\t\t/** Context was compacted (older messages summarized) */\n\t\t\ttype: \"compaction\";\n\t\t\t/** Generated summary of compacted messages */\n\t\t\tsummary: string;\n\t\t\t/** Index of first entry to keep (entries before were summarized) */\n\t\t\tfirstKeptEntryIndex: number;\n\t\t\t/** Token count before compaction */\n\t\t\ttokensBefore: number;\n\t\t\t/** Whether this was auto-triggered vs manual /compact */\n\t\t\tauto?: boolean;\n\t\t\t/** Custom instructions used for summarization */\n\t\t\tcustomInstructions?: string;\n\t\t\t/** Timestamp of compaction */\n\t\t\ttimestamp: string;\n\t  }\n\t| {\n\t\t\t/** Auto-retry started for transient error (rate limit, overload, 5xx) */\n\t\t\ttype: \"auto_retry_start\";\n\t\t\t/** Current retry attempt (1-based) */\n\t\t\tattempt: number;\n\t\t\t/** Maximum number of retry attempts */\n\t\t\tmaxAttempts: number;\n\t\t\t/** Delay in milliseconds before retry */\n\t\t\tdelayMs: number;\n\t\t\t/** The error message that triggered the retry */\n\t\t\terrorMessage: string;\n\t  }\n\t| {\n\t\t\t/** Auto-retry completed (success or final failure) */\n\t\t\ttype: \"auto_retry_end\";\n\t\t\t/** Whether the retry eventually succeeded */\n\t\t\tsuccess: boolean;\n\t\t\t/** Final attempt number */\n\t\t\tattempt: number;\n\t\t\t/** If failed, the final error message */\n\t\t\tfinalError?: string;\n\t  };\n\n/**\n * Events emitted over streaming transports (SSE/WebSocket).\n *\n * Includes core agent events plus transport-level signals.\n */\nexport type AgentStreamEvent =\n\t| AgentEvent\n\t| { type: \"session_update\"; sessionId: string }\n\t| { type: \"heartbeat\" }\n\t| { type: \"aborted\" }\n\t| { type: \"done\" };\n\n/**\n * Message queued for sending to the LLM.\n *\n * Wraps the original message with an optional LLM-formatted version,\n * allowing for message transformation before sending.\n *\n * @typeParam TOriginal - Type of the original message\n */\nexport interface QueuedMessage<TOriginal = AppMessage> {\n\t/** Stable identifier for queue operations */\n\tid: number;\n\t/** When the message was queued */\n\tcreatedAt: number;\n\t/** Original message as received */\n\toriginal: TOriginal;\n\t/** Optional LLM-formatted version of the message */\n\tllm?: Message;\n}\n\n/**\n * Runtime configuration for agent execution.\n *\n * Passed to the transport layer when starting a new agent run,\n * containing all the configuration needed to execute a conversation turn.\n */\nexport interface AgentRunConfig {\n\t/** System prompt providing instructions and context */\n\tsystemPrompt: string;\n\t/** Tools available for this run */\n\ttools: AgentTool[];\n\t/** Model to use for generation */\n\tmodel: Model<Api>;\n\t/** Optional reasoning effort level */\n\treasoning?: ReasoningEffort;\n\t/** Optional reasoning summary preference for Responses API */\n\treasoningSummary?: \"auto\" | \"detailed\" | \"concise\" | null;\n\t/** Emit message_end for the initial user message (defaults to true). */\n\temitUserMessageEnd?: boolean;\n\t/** Function to retrieve steering messages for batch sending */\n\tgetSteeringMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/** Function to retrieve follow-up messages for batch sending */\n\tgetFollowUpMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/** Function to retrieve prompt-only messages for the next turn. */\n\tgetPromptOnlyMessages?: () => Promise<Message[]>;\n\t/** @deprecated Use getSteeringMessages/getFollowUpMessages instead */\n\tgetQueuedMessages?: <T>() => Promise<QueuedMessage<T>[]>;\n\t/**\n\t * Optional message preprocessor applied immediately before calling the LLM provider.\n\t *\n\t * Use this to implement provider-specific compatibility transforms (e.g., image limits,\n\t * signature preservation, prompt caching markers) without polluting the core tools.\n\t *\n\t * Note: This is a pure preprocessing hook. It should not execute tools or perform I/O.\n\t */\n\tpreprocessMessages?: (\n\t\tmessages: Message[],\n\t\tcontext: {\n\t\t\tsystemPrompt: string;\n\t\t\ttools: AgentTool[];\n\t\t\tmodel: Model<Api>;\n\t\t\tuserMessage?: Message;\n\t\t},\n\t\tsignal?: AbortSignal,\n\t) => Message[] | Promise<Message[]>;\n\t/** User identification for tracking */\n\tuser?: {\n\t\t/** User UUID */\n\t\tid: string;\n\t\t/** Organization UUID */\n\t\torgId: string;\n\t};\n\t/** Session information for persistence */\n\tsession?: {\n\t\t/** Session UUID */\n\t\tid: string;\n\t\t/** When the session started */\n\t\tstartedAt: Date;\n\t};\n\t/** User/org guarded-files override policy for this run */\n\tguardedFiles?: GuardedFilesPolicySettings;\n\t/** Optional helper function for running LLM queries (e.g., for summarization) */\n\trunLLM?: (systemPrompt: string, userPrompt: string) => Promise<string>;\n\t/** Optional debug checkpoint profiler for local query latency diagnostics. */\n\tqueryProfiler?: CheckpointProfiler;\n\t/** Optional sandbox for isolated tool execution */\n\tsandbox?: import(\"../sandbox/types.js\").Sandbox;\n\t/** Sampling temperature override (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Top-p sampling override (0.0-1.0) */\n\ttopP?: number;\n\t/** Optional Anthropic API-side task budget for the current turn */\n\ttaskBudget?: {\n\t\ttotal: number;\n\t\tremaining?: number;\n\t};\n}\n\n/**\n * Transport interface for LLM communication.\n *\n * Implementors of this interface handle the actual communication\n * with the LLM provider, including streaming and tool execution.\n */\nexport interface AgentTransport {\n\t/**\n\t * Execute a conversation turn with a new user message.\n\t *\n\t * @param messages - Conversation history\n\t * @param userMessage - New user message\n\t * @param config - Runtime configuration\n\t * @param signal - Optional abort signal for cancellation\n\t * @returns Async iterable of agent events\n\t */\n\trun(\n\t\tmessages: Message[],\n\t\tuserMessage: Message,\n\t\tconfig: AgentRunConfig,\n\t\tsignal?: AbortSignal,\n\t): AsyncIterable<AgentEvent>;\n\n\t/**\n\t * Continue from current context without a new user message.\n\t *\n\t * Used for:\n\t * - Retrying after transient errors (rate limits, overload)\n\t * - Continuing after context compaction\n\t * - Resuming interrupted tool execution\n\t *\n\t * @param messages - Current conversation history\n\t * @param config - Runtime configuration\n\t * @param signal - Optional abort signal for cancellation\n\t * @returns Async iterable of agent events\n\t */\n\tcontinue(\n\t\tmessages: Message[],\n\t\tconfig: AgentRunConfig,\n\t\tsignal?: AbortSignal,\n\t): AsyncIterable<AgentEvent>;\n\n\t/**\n\t * Optional lightweight connectivity probe for UI health checks.\n\t */\n\tping?: () => Promise<void>;\n}\n\n/**\n * Options for streaming LLM requests.\n *\n * These options are passed to the transport layer when making\n * streaming requests to the LLM provider.\n */\nexport interface StreamOptions {\n\t/** Sampling temperature (0.0-2.0, lower = more deterministic) */\n\ttemperature?: number;\n\t/** Maximum tokens to generate */\n\tmaxTokens?: number;\n\t/** Abort signal for cancellation */\n\tsignal?: AbortSignal;\n\t/** API key for authentication */\n\tapiKey?: string;\n\t/** Additional headers to include in requests */\n\theaders?: Record<string, string>;\n\t/** Additional request body fields for provider-specific extensions */\n\trequestBody?: Record<string, unknown>;\n\t/** Stable session id for provider-side request grouping/cache keys */\n\tsessionId?: string;\n\t/** Current working directory for local provider runtimes. */\n\tcwd?: string;\n\t/** Authentication type for the request */\n\tauthType?: \"api-key\" | \"bearer-token\";\n\t/** Optional Anthropic API-side task budget for the current turn */\n\ttaskBudget?: {\n\t\ttotal: number;\n\t\tremaining?: number;\n\t};\n\t/** Optional governed executor for provider-native dynamic tool callbacks. */\n\texecuteDynamicTool?: (toolCall: ToolCall) => Promise<AgentToolResult>;\n}\n\n/**\n * Cache control hint for prompt caching.\n *\n * Used to mark content that should be cached for faster\n * subsequent requests.\n */\nexport interface PromptCacheControl {\n\t/** Cache type - currently only \"ephemeral\" is supported */\n\ttype: \"ephemeral\";\n}\n"]}

package/dist/app-server/plugin-bundle-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-bundle-api.d.ts","sourceRoot":"","sources":["../../src/app-server/plugin-bundle-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,sCAAsC,EACtC,0CAA0C,EAE1C,MAAM,oBAAoB,CAAC;AAiB5B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,qBAAa,iCAAkC,SAAQ,KAAK;IAE1D,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKhB;AAED,MAAM,WAAW,+BAA+B;IAC/C,WAAW,CACV,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACnD,aAAa,CACZ,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,0CAA0C,CAAC,CAAC;IACvD,YAAY,CACX,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,0CAA0C,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,sCAAsC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AA+KD,wBAAgB,qCAAqC,CACpD,OAAO,GAAE,sCAA2C,GAClD,+BAA+B,CAuGjC"}
+{"version":3,"file":"plugin-bundle-api.d.ts","sourceRoot":"","sources":["../../src/app-server/plugin-bundle-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,sCAAsC,EACtC,0CAA0C,EAE1C,MAAM,oBAAoB,CAAC;AAiB5B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,qBAAa,iCAAkC,SAAQ,KAAK;IAE1D,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKhB;AAED,MAAM,WAAW,+BAA+B;IAC/C,WAAW,CACV,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACnD,aAAa,CACZ,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,0CAA0C,CAAC,CAAC;IACvD,YAAY,CACX,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,0CAA0C,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,sCAAsC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AA+KD,wBAAgB,qCAAqC,CACpD,OAAO,GAAE,sCAA2C,GAClD,+BAA+B,CAwGjC"}

package/dist/app-server/plugin-bundle-api.js

@@ -131,6 +131,7 @@ export function createMaestroAppServerPluginBundleApi(options = {}) {
                     configPath: entry.configPath,
                 })),
                 resources: {
+                    agents: resources.agents,
                     extensions: resources.extensions,
                     skills: resources.skills,
                     prompts: resources.prompts,

package/dist/app-server/plugin-bundle-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-bundle-api.js","sourceRoot":"","sources":["../../src/app-server/plugin-bundle-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { dirname, resolve } from \"node:path\";\nimport type {\n\tMaestroAppServerPluginBundleListResult,\n\tMaestroAppServerPluginBundleMutationResult,\n\tMaestroAppServerPluginBundleScope,\n} from \"@evalops/contracts\";\nimport {\n\ttype WritablePackageScope,\n\taddConfiguredPackageSpecToConfig,\n\tgetWritablePackageConfigPath,\n\tloadConfiguredPackageSpecs,\n\tremoveConfiguredPackageSpecFromConfig,\n} from \"../config/toml-config.js\";\nimport { parsePackageSpec } from \"../packages/loader.js\";\nimport { loadConfiguredPackageResources } from \"../packages/runtime.js\";\nimport {\n\tformatPackageSource,\n\tparsePackageSource,\n} from \"../packages/sources.js\";\nimport type { PackageSpec } from \"../packages/types.js\";\nimport { isRecord } from \"../utils/json.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport class MaestroAppServerPluginBundleError extends Error {\n\tconstructor(\n\t\treadonly code: number,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MaestroAppServerPluginBundleError\";\n\t}\n}\n\nexport interface MaestroAppServerPluginBundleApi {\n\tlistBundles(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleListResult>;\n\tinstallBundle(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleMutationResult>;\n\tremoveBundle(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleMutationResult>;\n}\n\nexport interface MaestroAppServerPluginBundleApiOptions {\n\tprojectRoot?: string;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction booleanValue(value: unknown, fallback: boolean): boolean {\n\treturn typeof value === \"boolean\" ? value : fallback;\n}\n\nfunction paramsRecord(params: unknown): UnknownRecord {\n\tif (params === undefined) {\n\t\treturn {};\n\t}\n\tif (isRecord(params)) {\n\t\treturn params;\n\t}\n\tthrow new MaestroAppServerPluginBundleError(-32602, \"Invalid params\");\n}\n\nfunction projectRootFromParams(\n\toptions: MaestroAppServerPluginBundleApiOptions,\n\tparams: UnknownRecord,\n): string {\n\tconst projectRoot = resolve(options.projectRoot ?? process.cwd());\n\tconst requestedProjectRoot = stringValue(params.projectRoot);\n\tif (requestedProjectRoot && resolve(requestedProjectRoot) !== projectRoot) {\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t\"Plugin bundle projectRoot is not available for this server\",\n\t\t);\n\t}\n\treturn projectRoot;\n}\n\nfunction scopeFromParams(params: UnknownRecord): WritablePackageScope {\n\tconst scope = stringValue(params.scope);\n\tif (scope === \"project\" || scope === \"local\" || scope === \"user\") {\n\t\treturn scope;\n\t}\n\tif (scope !== undefined) {\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t\"Invalid plugin bundle scope\",\n\t\t);\n\t}\n\treturn \"local\";\n}\n\nfunction packageSpecFromParams(params: UnknownRecord): PackageSpec {\n\tconst spec = params.spec ?? params.source;\n\tif (typeof spec === \"string\" && spec.trim()) {\n\t\treturn spec.trim();\n\t}\n\tif (isRecord(spec) && typeof spec.source === \"string\" && spec.source.trim()) {\n\t\treturn spec as unknown as PackageSpec;\n\t}\n\tthrow new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\t\"Plugin bundle requires source or spec\",\n\t);\n}\n\nfunction sourceString(spec: PackageSpec): string {\n\treturn typeof spec === \"string\" ? spec : spec.source;\n}\n\nfunction resolvePackageSpecIdentity(spec: PackageSpec, cwd: string): string {\n\tconst [sourceSpec] = parsePackageSpec(spec, cwd);\n\treturn formatPackageSource(parsePackageSource(sourceSpec, cwd));\n}\n\nfunction tryResolvePackageSourceIdentity(\n\tsourceSpec: string,\n\tcwd: string,\n): string | null {\n\ttry {\n\t\treturn formatPackageSource(parsePackageSource(sourceSpec, cwd));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction configuredPackageMatches(\n\tentry: ReturnType<typeof loadConfiguredPackageSpecs>[number],\n\trequestedSpec: string,\n\trequestedCwd: string,\n): boolean {\n\tconst [rawSourceSpec] = parsePackageSpec(entry.spec, entry.cwd);\n\tif (rawSourceSpec === requestedSpec) {\n\t\treturn true;\n\t}\n\tconst requestedIdentity = tryResolvePackageSourceIdentity(\n\t\trequestedSpec,\n\t\trequestedCwd,\n\t);\n\tif (!requestedIdentity) {\n\t\treturn false;\n\t}\n\treturn (\n\t\tresolvePackageSpecIdentity(entry.spec, entry.cwd) === requestedIdentity\n\t);\n}\n\nfunction validateBundleInstall(\n\tprojectRoot: string,\n\tscope: WritablePackageScope,\n\tspec: PackageSpec,\n): { configPath: string } {\n\tconst configPath = getWritablePackageConfigPath(scope, projectRoot);\n\tconst configDir = dirname(configPath);\n\tconst requestedIdentity = resolvePackageSpecIdentity(spec, projectRoot);\n\tconst duplicate = loadConfiguredPackageSpecs(projectRoot).find(\n\t\t(entry) =>\n\t\t\tentry.configPath === configPath &&\n\t\t\tresolvePackageSpecIdentity(entry.spec, configDir) === requestedIdentity,\n\t);\n\tif (duplicate) {\n\t\tconst [sourceSpec] = parsePackageSpec(duplicate.spec, configDir);\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t`Package \"${sourceSpec}\" already exists in ${configPath}.`,\n\t\t);\n\t}\n\treturn { configPath };\n}\n\nfunction resolveBundleRemoval(\n\tprojectRoot: string,\n\tspec: PackageSpec,\n\tscope?: WritablePackageScope,\n): { configPath: string; scope: WritablePackageScope } {\n\tconst requestedSpec = sourceString(spec);\n\tconst matches = loadConfiguredPackageSpecs(projectRoot).filter(\n\t\t(entry) =>\n\t\t\t(scope === undefined || entry.scope === scope) &&\n\t\t\tconfiguredPackageMatches(entry, requestedSpec, projectRoot),\n\t);\n\tconst orderedScopes: WritablePackageScope[] =\n\t\tscope === undefined ? [\"local\", \"project\", \"user\"] : [scope];\n\tfor (const candidateScope of orderedScopes) {\n\t\tconst match = matches.find((entry) => entry.scope === candidateScope);\n\t\tif (match) {\n\t\t\treturn { configPath: match.configPath, scope: match.scope };\n\t\t}\n\t}\n\tconst scopeMessage = scope === undefined ? \"\" : ` in ${scope} config`;\n\tthrow new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\t`Configured package \"${requestedSpec}\" was not found${scopeMessage}.`,\n\t);\n}\n\nfunction toBundleScope(\n\tscope: WritablePackageScope,\n): MaestroAppServerPluginBundleScope {\n\treturn scope;\n}\n\nfunction pluginBundleErrorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction toPluginBundleInvalidParams(\n\terror: unknown,\n): MaestroAppServerPluginBundleError {\n\tif (error instanceof MaestroAppServerPluginBundleError) {\n\t\treturn error;\n\t}\n\treturn new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\tpluginBundleErrorMessage(error),\n\t);\n}\n\nexport function createMaestroAppServerPluginBundleApi(\n\toptions: MaestroAppServerPluginBundleApiOptions = {},\n): MaestroAppServerPluginBundleApi {\n\treturn {\n\t\tasync listBundles(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst resources = loadConfiguredPackageResources(projectRoot);\n\t\t\treturn {\n\t\t\t\tbundles: loadConfiguredPackageSpecs(projectRoot).map((entry) => ({\n\t\t\t\t\tsource: sourceString(entry.spec),\n\t\t\t\t\tscope: toBundleScope(entry.scope),\n\t\t\t\t\tconfigPath: entry.configPath,\n\t\t\t\t})),\n\t\t\t\tresources: {\n\t\t\t\t\textensions: resources.extensions,\n\t\t\t\t\tskills: resources.skills,\n\t\t\t\t\tprompts: resources.prompts,\n\t\t\t\t\tthemes: resources.themes,\n\t\t\t\t},\n\t\t\t\terrors: resources.errors,\n\t\t\t};\n\t\t},\n\n\t\tasync installBundle(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst spec = packageSpecFromParams(normalizedParams);\n\t\t\tconst source = sourceString(spec);\n\t\t\tconst scope = scopeFromParams(normalizedParams);\n\t\t\tlet validation: ReturnType<typeof validateBundleInstall>;\n\t\t\ttry {\n\t\t\t\tvalidation = validateBundleInstall(projectRoot, scope, spec);\n\t\t\t} catch (error) {\n\t\t\t\tthrow toPluginBundleInvalidParams(error);\n\t\t\t}\n\t\t\tconst { configPath } = validation;\n\t\t\tif (booleanValue(normalizedParams.dryRun, false)) {\n\t\t\t\treturn {\n\t\t\t\t\tsource,\n\t\t\t\t\tscope,\n\t\t\t\t\tconfigPath,\n\t\t\t\t\tchanged: false,\n\t\t\t\t\tmessage: \"Plugin bundle install planned\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tlet result: ReturnType<typeof addConfiguredPackageSpecToConfig>;\n\t\t\ttry {\n\t\t\t\tresult = addConfiguredPackageSpecToConfig({\n\t\t\t\t\tworkspaceDir: projectRoot,\n\t\t\t\t\tscope,\n\t\t\t\t\tspec,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow toPluginBundleInvalidParams(error);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tsource,\n\t\t\t\tscope: result.scope,\n\t\t\t\tconfigPath: result.path,\n\t\t\t\tchanged: true,\n\t\t\t\tmessage: \"Plugin bundle installed\",\n\t\t\t};\n\t\t},\n\n\t\tasync removeBundle(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst spec = packageSpecFromParams(normalizedParams);\n\t\t\tconst scope =\n\t\t\t\tnormalizedParams.scope === undefined\n\t\t\t\t\t? undefined\n\t\t\t\t\t: scopeFromParams(normalizedParams);\n\t\t\tconst removal = resolveBundleRemoval(projectRoot, spec, scope);\n\t\t\tif (booleanValue(normalizedParams.dryRun, false)) {\n\t\t\t\treturn {\n\t\t\t\t\tsource: sourceString(spec),\n\t\t\t\t\tscope: removal.scope,\n\t\t\t\t\tconfigPath: removal.configPath,\n\t\t\t\t\tchanged: false,\n\t\t\t\t\tmessage: \"Plugin bundle removal planned\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tlet result: ReturnType<typeof removeConfiguredPackageSpecFromConfig>;\n\t\t\ttry {\n\t\t\t\tresult = removeConfiguredPackageSpecFromConfig({\n\t\t\t\t\tworkspaceDir: projectRoot,\n\t\t\t\t\tscope,\n\t\t\t\t\tspec: sourceString(spec),\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t\t\t-32602,\n\t\t\t\t\tpluginBundleErrorMessage(error),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tsource: sourceString(spec),\n\t\t\t\tscope: result.scope,\n\t\t\t\tconfigPath: result.path,\n\t\t\t\tchanged: result.removedCount > 0,\n\t\t\t\tmessage: `Removed ${result.removedCount} plugin bundle(s)`,\n\t\t\t};\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"plugin-bundle-api.js","sourceRoot":"","sources":["../../src/app-server/plugin-bundle-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { dirname, resolve } from \"node:path\";\nimport type {\n\tMaestroAppServerPluginBundleListResult,\n\tMaestroAppServerPluginBundleMutationResult,\n\tMaestroAppServerPluginBundleScope,\n} from \"@evalops/contracts\";\nimport {\n\ttype WritablePackageScope,\n\taddConfiguredPackageSpecToConfig,\n\tgetWritablePackageConfigPath,\n\tloadConfiguredPackageSpecs,\n\tremoveConfiguredPackageSpecFromConfig,\n} from \"../config/toml-config.js\";\nimport { parsePackageSpec } from \"../packages/loader.js\";\nimport { loadConfiguredPackageResources } from \"../packages/runtime.js\";\nimport {\n\tformatPackageSource,\n\tparsePackageSource,\n} from \"../packages/sources.js\";\nimport type { PackageSpec } from \"../packages/types.js\";\nimport { isRecord } from \"../utils/json.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport class MaestroAppServerPluginBundleError extends Error {\n\tconstructor(\n\t\treadonly code: number,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MaestroAppServerPluginBundleError\";\n\t}\n}\n\nexport interface MaestroAppServerPluginBundleApi {\n\tlistBundles(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleListResult>;\n\tinstallBundle(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleMutationResult>;\n\tremoveBundle(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerPluginBundleMutationResult>;\n}\n\nexport interface MaestroAppServerPluginBundleApiOptions {\n\tprojectRoot?: string;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction booleanValue(value: unknown, fallback: boolean): boolean {\n\treturn typeof value === \"boolean\" ? value : fallback;\n}\n\nfunction paramsRecord(params: unknown): UnknownRecord {\n\tif (params === undefined) {\n\t\treturn {};\n\t}\n\tif (isRecord(params)) {\n\t\treturn params;\n\t}\n\tthrow new MaestroAppServerPluginBundleError(-32602, \"Invalid params\");\n}\n\nfunction projectRootFromParams(\n\toptions: MaestroAppServerPluginBundleApiOptions,\n\tparams: UnknownRecord,\n): string {\n\tconst projectRoot = resolve(options.projectRoot ?? process.cwd());\n\tconst requestedProjectRoot = stringValue(params.projectRoot);\n\tif (requestedProjectRoot && resolve(requestedProjectRoot) !== projectRoot) {\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t\"Plugin bundle projectRoot is not available for this server\",\n\t\t);\n\t}\n\treturn projectRoot;\n}\n\nfunction scopeFromParams(params: UnknownRecord): WritablePackageScope {\n\tconst scope = stringValue(params.scope);\n\tif (scope === \"project\" || scope === \"local\" || scope === \"user\") {\n\t\treturn scope;\n\t}\n\tif (scope !== undefined) {\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t\"Invalid plugin bundle scope\",\n\t\t);\n\t}\n\treturn \"local\";\n}\n\nfunction packageSpecFromParams(params: UnknownRecord): PackageSpec {\n\tconst spec = params.spec ?? params.source;\n\tif (typeof spec === \"string\" && spec.trim()) {\n\t\treturn spec.trim();\n\t}\n\tif (isRecord(spec) && typeof spec.source === \"string\" && spec.source.trim()) {\n\t\treturn spec as unknown as PackageSpec;\n\t}\n\tthrow new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\t\"Plugin bundle requires source or spec\",\n\t);\n}\n\nfunction sourceString(spec: PackageSpec): string {\n\treturn typeof spec === \"string\" ? spec : spec.source;\n}\n\nfunction resolvePackageSpecIdentity(spec: PackageSpec, cwd: string): string {\n\tconst [sourceSpec] = parsePackageSpec(spec, cwd);\n\treturn formatPackageSource(parsePackageSource(sourceSpec, cwd));\n}\n\nfunction tryResolvePackageSourceIdentity(\n\tsourceSpec: string,\n\tcwd: string,\n): string | null {\n\ttry {\n\t\treturn formatPackageSource(parsePackageSource(sourceSpec, cwd));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction configuredPackageMatches(\n\tentry: ReturnType<typeof loadConfiguredPackageSpecs>[number],\n\trequestedSpec: string,\n\trequestedCwd: string,\n): boolean {\n\tconst [rawSourceSpec] = parsePackageSpec(entry.spec, entry.cwd);\n\tif (rawSourceSpec === requestedSpec) {\n\t\treturn true;\n\t}\n\tconst requestedIdentity = tryResolvePackageSourceIdentity(\n\t\trequestedSpec,\n\t\trequestedCwd,\n\t);\n\tif (!requestedIdentity) {\n\t\treturn false;\n\t}\n\treturn (\n\t\tresolvePackageSpecIdentity(entry.spec, entry.cwd) === requestedIdentity\n\t);\n}\n\nfunction validateBundleInstall(\n\tprojectRoot: string,\n\tscope: WritablePackageScope,\n\tspec: PackageSpec,\n): { configPath: string } {\n\tconst configPath = getWritablePackageConfigPath(scope, projectRoot);\n\tconst configDir = dirname(configPath);\n\tconst requestedIdentity = resolvePackageSpecIdentity(spec, projectRoot);\n\tconst duplicate = loadConfiguredPackageSpecs(projectRoot).find(\n\t\t(entry) =>\n\t\t\tentry.configPath === configPath &&\n\t\t\tresolvePackageSpecIdentity(entry.spec, configDir) === requestedIdentity,\n\t);\n\tif (duplicate) {\n\t\tconst [sourceSpec] = parsePackageSpec(duplicate.spec, configDir);\n\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t-32602,\n\t\t\t`Package \"${sourceSpec}\" already exists in ${configPath}.`,\n\t\t);\n\t}\n\treturn { configPath };\n}\n\nfunction resolveBundleRemoval(\n\tprojectRoot: string,\n\tspec: PackageSpec,\n\tscope?: WritablePackageScope,\n): { configPath: string; scope: WritablePackageScope } {\n\tconst requestedSpec = sourceString(spec);\n\tconst matches = loadConfiguredPackageSpecs(projectRoot).filter(\n\t\t(entry) =>\n\t\t\t(scope === undefined || entry.scope === scope) &&\n\t\t\tconfiguredPackageMatches(entry, requestedSpec, projectRoot),\n\t);\n\tconst orderedScopes: WritablePackageScope[] =\n\t\tscope === undefined ? [\"local\", \"project\", \"user\"] : [scope];\n\tfor (const candidateScope of orderedScopes) {\n\t\tconst match = matches.find((entry) => entry.scope === candidateScope);\n\t\tif (match) {\n\t\t\treturn { configPath: match.configPath, scope: match.scope };\n\t\t}\n\t}\n\tconst scopeMessage = scope === undefined ? \"\" : ` in ${scope} config`;\n\tthrow new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\t`Configured package \"${requestedSpec}\" was not found${scopeMessage}.`,\n\t);\n}\n\nfunction toBundleScope(\n\tscope: WritablePackageScope,\n): MaestroAppServerPluginBundleScope {\n\treturn scope;\n}\n\nfunction pluginBundleErrorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction toPluginBundleInvalidParams(\n\terror: unknown,\n): MaestroAppServerPluginBundleError {\n\tif (error instanceof MaestroAppServerPluginBundleError) {\n\t\treturn error;\n\t}\n\treturn new MaestroAppServerPluginBundleError(\n\t\t-32602,\n\t\tpluginBundleErrorMessage(error),\n\t);\n}\n\nexport function createMaestroAppServerPluginBundleApi(\n\toptions: MaestroAppServerPluginBundleApiOptions = {},\n): MaestroAppServerPluginBundleApi {\n\treturn {\n\t\tasync listBundles(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst resources = loadConfiguredPackageResources(projectRoot);\n\t\t\treturn {\n\t\t\t\tbundles: loadConfiguredPackageSpecs(projectRoot).map((entry) => ({\n\t\t\t\t\tsource: sourceString(entry.spec),\n\t\t\t\t\tscope: toBundleScope(entry.scope),\n\t\t\t\t\tconfigPath: entry.configPath,\n\t\t\t\t})),\n\t\t\t\tresources: {\n\t\t\t\t\tagents: resources.agents,\n\t\t\t\t\textensions: resources.extensions,\n\t\t\t\t\tskills: resources.skills,\n\t\t\t\t\tprompts: resources.prompts,\n\t\t\t\t\tthemes: resources.themes,\n\t\t\t\t},\n\t\t\t\terrors: resources.errors,\n\t\t\t};\n\t\t},\n\n\t\tasync installBundle(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst spec = packageSpecFromParams(normalizedParams);\n\t\t\tconst source = sourceString(spec);\n\t\t\tconst scope = scopeFromParams(normalizedParams);\n\t\t\tlet validation: ReturnType<typeof validateBundleInstall>;\n\t\t\ttry {\n\t\t\t\tvalidation = validateBundleInstall(projectRoot, scope, spec);\n\t\t\t} catch (error) {\n\t\t\t\tthrow toPluginBundleInvalidParams(error);\n\t\t\t}\n\t\t\tconst { configPath } = validation;\n\t\t\tif (booleanValue(normalizedParams.dryRun, false)) {\n\t\t\t\treturn {\n\t\t\t\t\tsource,\n\t\t\t\t\tscope,\n\t\t\t\t\tconfigPath,\n\t\t\t\t\tchanged: false,\n\t\t\t\t\tmessage: \"Plugin bundle install planned\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tlet result: ReturnType<typeof addConfiguredPackageSpecToConfig>;\n\t\t\ttry {\n\t\t\t\tresult = addConfiguredPackageSpecToConfig({\n\t\t\t\t\tworkspaceDir: projectRoot,\n\t\t\t\t\tscope,\n\t\t\t\t\tspec,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow toPluginBundleInvalidParams(error);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tsource,\n\t\t\t\tscope: result.scope,\n\t\t\t\tconfigPath: result.path,\n\t\t\t\tchanged: true,\n\t\t\t\tmessage: \"Plugin bundle installed\",\n\t\t\t};\n\t\t},\n\n\t\tasync removeBundle(params = {}) {\n\t\t\tconst normalizedParams = paramsRecord(params);\n\t\t\tconst projectRoot = projectRootFromParams(options, normalizedParams);\n\t\t\tconst spec = packageSpecFromParams(normalizedParams);\n\t\t\tconst scope =\n\t\t\t\tnormalizedParams.scope === undefined\n\t\t\t\t\t? undefined\n\t\t\t\t\t: scopeFromParams(normalizedParams);\n\t\t\tconst removal = resolveBundleRemoval(projectRoot, spec, scope);\n\t\t\tif (booleanValue(normalizedParams.dryRun, false)) {\n\t\t\t\treturn {\n\t\t\t\t\tsource: sourceString(spec),\n\t\t\t\t\tscope: removal.scope,\n\t\t\t\t\tconfigPath: removal.configPath,\n\t\t\t\t\tchanged: false,\n\t\t\t\t\tmessage: \"Plugin bundle removal planned\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tlet result: ReturnType<typeof removeConfiguredPackageSpecFromConfig>;\n\t\t\ttry {\n\t\t\t\tresult = removeConfiguredPackageSpecFromConfig({\n\t\t\t\t\tworkspaceDir: projectRoot,\n\t\t\t\t\tscope,\n\t\t\t\t\tspec: sourceString(spec),\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow new MaestroAppServerPluginBundleError(\n\t\t\t\t\t-32602,\n\t\t\t\t\tpluginBundleErrorMessage(error),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tsource: sourceString(spec),\n\t\t\t\tscope: result.scope,\n\t\t\t\tconfigPath: result.path,\n\t\t\t\tchanged: result.removedCount > 0,\n\t\t\t\tmessage: `Removed ${result.removedCount} plugin bundle(s)`,\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/app-server/session-api.d.ts.map

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

package/dist/app-server/session-api.js

@@ -185,10 +185,17 @@ function turnsFromProjection(projection) {
     }));
 }
 function graphFromProjection(projection) {
+    const agentLineage = projection.agentLineage.edges.length > 0
+        ? projection.agentLineage
+        : undefined;
     return {
         branchId: projection.branchId,
         leafEntryId: projection.leafEntryId,
         activeEntryIds: projection.activeEntryIds,
+        authoritativeEntryIds: projection.authoritativeEntryIds,
+        supersededEntryIds: projection.supersededEntryIds,
+        revisionGroups: projection.revisionGroups,
+        agentLineage,
         compactionSpans: projection.compactionSpans,
     };
 }
@@ -809,6 +816,7 @@ export function createMaestroAppServerSessionApi(store, options = {}) {
         async readThread(params = {}) {
             const threadId = requireThreadId(params);
             const includeTurns = params.includeTurns === true;
+            const includeHistory = params.includeHistory === true;
             const messagesView = parseMessagesView(params.messagesView);
             const loaded = await store.loadSession(threadId, { messagesView });
             if (!loaded) {
@@ -822,9 +830,14 @@ export function createMaestroAppServerSessionApi(store, options = {}) {
             if (sessionFile && !sessionFile.startsWith("db:")) {
                 thread.path = sessionFile;
             }
-            if (includeTurns) {
+            if (includeTurns || includeHistory) {
                 const projection = await loadProjectionForThread(store, threadId);
-                thread.turns = turnsFromProjection(projection);
+                if (includeTurns) {
+                    thread.turns = turnsFromProjection(projection);
+                }
+                if (includeHistory) {
+                    thread.history = projection.historyEntries.map(treeEntryToItem);
+                }
                 thread.graph = graphFromProjection(projection);
             }
             return thread;