@standardagents/builder 0.12.9 → 0.13.0-next.c55f029

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { AgentPluginOptions, agentbuilder } from './plugin.js';
-import { T as ThreadEnv, a as ThreadMetadata, F as FileRecord, b as FlowState, M as Message, c as FileStats, G as GrepResult, A as AttachmentRef, d as MessageContent } from './index-DkbUJ4MM.js';
-export { j as Agent, i as BuilderThreadEndpointHandler, B as Controller, g as ControllerContext, E as Env, n as FlowResult, q as ImageContentPart, I as ImageMetadata, L as LLMResponse, r as MultimodalContent, R as RequestContext, S as StorageBackend, o as TelemetryEvent, p as TextContentPart, h as ThreadEndpointContext, k as ThreadInstance, l as ToolCall, m as ToolResult, f as createThreadEndpointHandler, e as defineController } from './index-DkbUJ4MM.js';
-import { ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, SubpromptConfig as SubpromptConfig$1, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart, NamespaceContext, DefinitionLoader } from '@standardagents/spec';
+import { T as ThreadEnv, a as ThreadMetadata, F as FileRecord, b as FlowState, M as Message, c as FileStats, G as GrepResult, A as AttachmentRef, d as MessageContent, E as Env, e as ThreadInstance } from './index-T0gR5l-G.js';
+export { k as Agent, j as BuilderThreadEndpointHandler, B as Controller, h as ControllerContext, n as FlowResult, q as ImageContentPart, I as ImageMetadata, L as LLMResponse, r as MultimodalContent, R as RequestContext, S as StorageBackend, o as TelemetryEvent, p as TextContentPart, i as ThreadEndpointContext, l as ToolCall, m as ToolResult, g as createThreadEndpointHandler, f as defineController } from './index-T0gR5l-G.js';
+import { SubagentRegistryEntry, QueueMessageInput, ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, PromptEnvPart, VariableDefinition, SubpromptConfig as SubpromptConfig$1, PromptToolConfig as PromptToolConfig$1, SubagentToolConfig as SubagentToolConfig$1, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart, NamespaceContext, DefinitionLoader } from '@standardagents/spec';
 export { AgentType, DefinitionLoader, GlobalNamespaceContext, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, NamespaceContext, PackageSignature, PackedExports, PackedMeta, PackedMetadata, PackedNamespaceContext, PromptInput, PromptTextPart, ProviderAssistantMessage, ProviderError, ProviderErrorCode, ProviderFactory, ProviderFactoryConfig, ProviderFinishReason, ProviderGeneratedImage, ProviderMessage, ProviderMessageContent, ModelCapabilities as ProviderModelCapabilities, ProviderReasoningDetail, ProviderRequest, ProviderResponse, ProviderStreamChunk, ProviderSystemMessage, ProviderTool, ProviderToolCallPart, ProviderToolMessage, ProviderToolResultContent, ProviderUsage, ProviderUserMessage, ReasoningConfig, StructuredPrompt, TextContent, Tool, ToolArgs, ToolArgsNode, ToolArgsRawShape, ToolContent, belongsToPackage, defineAgent, defineHook, defineModel, definePrompt, defineTool, isPacked, isVisibleInNamespace, mapReasoningLevel } from '@standardagents/spec';
 import { DurableObject } from 'cloudflare:workers';
-import { N as NamespacedRegistry } from './types-pLkJx8vg.js';
-export { C as ConstituentItem, D as DiscoveredPackage, P as PackingAnalysis, a as PackingOptions, b as PackingResult, U as UnpackOptions, c as UnpackResult } from './types-pLkJx8vg.js';
-export { D as DiscoveryConfig, P as PackageDiscoveryService, d as discoverPackages } from './discovery-CpMs68Yx.js';
+import { N as NamespacedRegistry } from './types-DH3Egc5l.js';
+export { C as ConstituentItem, D as DiscoveredPackage, P as PackingAnalysis, a as PackingOptions, b as PackingResult, U as UnpackOptions, c as UnpackResult } from './types-DH3Egc5l.js';
+export { D as DiscoveryConfig, P as PackageDiscoveryService, d as discoverPackages } from './discovery-DVviz3By.js';
 import 'vite';
 import '@cloudflare/workers-types';
 import 'zod';
@@ -268,6 +268,33 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * @param agentName - Name of the agent to run
      */
     runAgent(threadId: string, agentName: string): Promise<void>;
+    /**
+     * Get the persisted resumable-subagent registry for this thread.
+     */
+    getChildrenRegistry(_threadId: string): Promise<SubagentRegistryEntry[]>;
+    private setChildrenRegistry;
+    upsertChildRegistry(_threadId: string, entry: SubagentRegistryEntry): Promise<void>;
+    updateChildRegistryStatus(_threadId: string, reference: string, status: string): Promise<void>;
+    removeChildRegistry(_threadId: string, reference: string): Promise<void>;
+    private asOptionalString;
+    private asOptionalBoolean;
+    private getThreadNameFromTags;
+    private toSubagentProjection;
+    private resolveSubagentMessageProjections;
+    /**
+     * Queue a message for deferred delivery.
+     */
+    queueMessage(threadId: string, message: QueueMessageInput): Promise<void>;
+    private hasPendingTurnAlarm;
+    private ensureQueuedMessageExecution;
+    private ensureRootMessageId;
+    /**
+     * Soft-terminate this thread.
+     */
+    terminateThread(threadId: string): Promise<{
+        success: boolean;
+        terminated: number;
+    }>;
     /**
      * Schedule an effect for future execution.
      *
@@ -278,6 +305,10 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * @returns UUID of the scheduled effect
      */
     scheduleEffect(threadId: string, effectName: string, effectArgs: Record<string, unknown>, delayMs?: number): Promise<string>;
+    /**
+     * Check whether an effect loader exists in either global or packed registries.
+     */
+    private effectExists;
     /**
      * Get scheduled effects for this thread.
      *
@@ -328,6 +359,16 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * Enqueues the execution to be processed by the alarm handler
      */
     execute(threadId: string, agentId: string, initial_messages?: any[], data?: any): Promise<Response>;
+    /**
+     * Execute a flow synchronously and return the final top-level message content.
+     * Used by blocking subagent tool calls.
+     */
+    executeBlocking(threadId: string, agentId: string, initial_messages?: any[], data?: any): Promise<{
+        status: "success" | "error";
+        result?: string;
+        error?: string;
+        attachments?: unknown[];
+    }>;
     /**
      * Send a new message to the thread (RPC method)
      * Enqueues the message processing to be handled by the alarm handler
@@ -338,6 +379,28 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * Reads from SQLite for persistence across hibernation
      */
     shouldStop(): Promise<boolean>;
+    /**
+     * Returns the termination timestamp (microseconds) or null when active.
+     */
+    getTerminated(_threadId: string): Promise<number | null>;
+    private assertNotTerminated;
+    private getLatestTopLevelMessage;
+    private getTerminalSessionToolNames;
+    private parseAttachmentRefsJson;
+    private inferMimeTypeFromPath;
+    private extensionForMimeType;
+    private sanitizeFilename;
+    private splitFilename;
+    private resolveAttachmentMimeType;
+    private buildAttachmentTargetPath;
+    private copyAttachmentRefsToThread;
+    private readAttachmentDataFromSource;
+    private arrayBufferToBase64;
+    private formatSubagentAttachmentPathSummary;
+    private persistParentHandoffStatusMessage;
+    private buildMissingTerminalSessionFailure;
+    private deliverCompletionToParentIfNeeded;
+    private getParentCommunicationModeForChild;
     /**
      * Stop the currently executing thread (RPC method)
      * Simple "off" switch - stops turns, only cleared by user messages
@@ -389,6 +452,8 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
             reasoning_content: string | null;
             reasoning_details: string | null;
             attachments: any;
+            metadata: Record<string, unknown> | undefined;
+            subagent_id: string | null;
         }[];
         total: number;
         hasMore: boolean;
@@ -538,6 +603,8 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
             agent_id: any;
             user_id: any;
             tags: any;
+            parent: any;
+            terminated: any;
             created_at: any;
         };
         agent: {
@@ -562,6 +629,8 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
         agent_name?: string;
         user_id?: string | null;
         tags?: string[] | null;
+        env?: Record<string, string> | null;
+        tenvs?: Record<string, unknown> | null;
     }): Promise<{
         success: boolean;
         thread: {
@@ -604,6 +673,7 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * Filters silent messages based on each socket's includeSilent preference
      */
     private broadcastMessage;
+    private broadcastMessageWithSubagentProjection;
     /**
      * Broadcast a content chunk for real-time streaming
      * Does NOT update database - only broadcasts to connected clients
@@ -663,6 +733,7 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * This allows resuming FlowEngine execution from where it stopped.
      */
     private doContinueExecution;
+    private getLatestQueuedMessageSide;
     /**
      * TEST METHOD: Queue a test operation
      * Used for testing alarm queue ordering and timing
@@ -984,8 +1055,42 @@ interface ThreadRegistryEntry {
     agent_name: string;
     user_id: string | null;
     tags: string[] | null;
+    env: Record<string, string> | null;
+    /** @deprecated Use env */
     tenvs: Record<string, unknown> | null;
     properties: Record<string, unknown> | null;
+    parent: string | null;
+    terminated: number | null;
+    created_at: number;
+}
+interface PendingSubagentAttachmentRef {
+    path: string;
+    name?: string;
+    mimeType?: string;
+    size?: number;
+    width?: number;
+    height?: number;
+}
+interface PendingSubagentEnvRequestPayload {
+    blocking: boolean;
+    resumable: boolean;
+    receives_messages: 'side_a' | 'side_b';
+    parent_communication: 'implicit' | 'explicit';
+    initial_message_content: string;
+    initial_message_attachments: PendingSubagentAttachmentRef[];
+    initial_agent_name?: string | null;
+    agent_title?: string | null;
+    agent_description?: string | null;
+    spawn_group_id?: string | null;
+}
+interface PendingSubagentEnvRequest {
+    request_id: string;
+    parent_thread_id: string;
+    agent_name: string;
+    registry_agent_name: string;
+    required: string[];
+    missing: string[];
+    payload: PendingSubagentEnvRequestPayload;
     created_at: number;
 }
 /**
@@ -995,6 +1100,11 @@ interface UpdateThreadParams {
     agent_name?: string;
     user_id?: string | null;
     tags?: string[] | null;
+    env?: Record<string, string> | null;
+    /** @deprecated Use env */
+    tenvs?: Record<string, unknown> | null;
+    parent?: string | null;
+    terminated?: number | null;
 }
 /**
  * User record.
@@ -1019,6 +1129,27 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
     private migratedToVersion;
     private eventSockets;
     constructor(ctx: DurableObjectState, env: Env);
+    private normalizeEnvRecord;
+    private resolveRegistryKey;
+    private extractScopedVariables;
+    private filterScopedInheritedEnv;
+    private collectScopedVariablesForAgent;
+    private getScopedVariableNamesForAgent;
+    private getRequiredScopedVariableNamesForAgent;
+    private normalizeScopedVariableList;
+    private normalizePendingAttachments;
+    private sanitizeFilename;
+    private inferMimeTypeFromPath;
+    private extensionForMimeType;
+    private buildAttachmentTargetPath;
+    private formatSubagentAttachmentPathSummary;
+    private formatSubagentTerminalMessage;
+    private copyPendingAttachmentsBetweenThreads;
+    private buildThreadNameTag;
+    private encryptEnvRecord;
+    private decryptEnvRecord;
+    private listActiveDescendantThreadIds;
+    private propagateThreadEnvToDescendants;
     /**
      * Returns the tools registry for lazy-loading tool definitions.
      * Must be overridden in a subclass.
@@ -1059,8 +1190,11 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
         agent_name: string;
         user_id?: string;
         tags?: string[];
+        env?: Record<string, string>;
+        /** @deprecated Use env */
         tenvs?: Record<string, unknown>;
         properties?: Record<string, unknown>;
+        parent?: string;
     }): Promise<ThreadRegistryEntry>;
     /**
      * Get a thread by ID.
@@ -1087,6 +1221,13 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
      * Delete a thread from the registry.
      */
     deleteThread(id: string): Promise<boolean>;
+    /**
+     * Get a thread tree (root + all descendants) in child-first order.
+     *
+     * Child-first ordering allows callers to perform destructive operations
+     * (like deletes) without leaving child rows referencing a deleted parent.
+     */
+    getThreadTreeIds(rootThreadId: string): Promise<string[]>;
     /**
      * Update a thread's agent_name (used during agent handoff).
      */
@@ -1095,6 +1236,45 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
      * Update a thread's metadata.
      */
     updateThread(id: string, params: UpdateThreadParams): Promise<ThreadRegistryEntry | null>;
+    private getEncryptionKey;
+    private encryptEnvValue;
+    private decryptEnvValue;
+    private listScopedEnv;
+    private replaceScopedEnv;
+    getInstanceEnv(): Promise<Record<string, string>>;
+    setInstanceEnv(env: Record<string, string>): Promise<void>;
+    getUserEnv(userId: string): Promise<Record<string, string>>;
+    setUserEnv(userId: string, env: Record<string, string>): Promise<void>;
+    getMissingRequiredScopedSubagentEnv(params: {
+        parent_thread_id: string;
+        agent_name: string;
+        provided_env?: Record<string, string> | null;
+    }): Promise<string[]>;
+    createPendingSubagentEnvRequest(params: {
+        parent_thread_id: string;
+        agent_name: string;
+        registry_agent_name: string;
+        required_variables: string[];
+        missing_variables: string[];
+        payload: PendingSubagentEnvRequestPayload;
+    }): Promise<PendingSubagentEnvRequest>;
+    getPendingSubagentEnvRequest(parentThreadId: string, requestId: string): Promise<PendingSubagentEnvRequest | null>;
+    private clearPendingSubagentEnvRequest;
+    completePendingSubagentEnvRequest(params: {
+        parent_thread_id: string;
+        request_id: string;
+        env: Record<string, string>;
+    }): Promise<{
+        request_id: string;
+        child_thread_id: string;
+        status: 'success';
+    }>;
+    resolveThreadEnv(params: {
+        threadId: string;
+        property: string;
+        promptName?: string;
+    }): Promise<string | null>;
+    private toThreadEventPayload;
     /**
      * Load a model definition by name.
      */
@@ -1356,7 +1536,7 @@ interface PromptIncludePart {
 /**
  * A single part of a structured prompt.
  */
-type PromptPart = PromptTextPart | PromptIncludePart;
+type PromptPart = PromptTextPart | PromptIncludePart | PromptEnvPart;
 /**
  * Prompt content can be a string or structured array with type-safe includes.
  */
@@ -1368,6 +1548,24 @@ interface SubpromptConfig<T extends string = AgentBuilder.Callables> extends Omi
     /** Name of the sub-prompt (type-safe with autocomplete) */
     name: T;
 }
+/**
+ * Prompt tool configuration with static tenvs/options.
+ */
+interface PromptToolConfig<T extends string = AgentBuilder.Callables> extends Omit<PromptToolConfig$1, 'name'> {
+    /** Name of the callable tool/agent (type-safe with autocomplete). */
+    name: T;
+    /** Environment values scoped to this tool invocation. */
+    env?: Record<string, string>;
+    /** @deprecated Use env */
+    tenvs?: Record<string, unknown>;
+}
+/**
+ * Subagent tool configuration with type-safe name references.
+ */
+interface SubagentToolConfig<T extends string = AgentBuilder.Callables> extends Omit<SubagentToolConfig$1<T>, 'name'> {
+    /** Name of the callable dual_ai agent (type-safe with autocomplete). */
+    name: T;
+}
 /**
  * @deprecated Use SubpromptConfig instead
  */
@@ -1405,8 +1603,14 @@ interface PromptDefinition<N extends string = string, S extends ToolArgs = ToolA
     toolChoice?: 'auto' | 'none' | 'required';
     /** Zod schema for validating inputs when called as a tool. */
     requiredSchema?: S;
+    /** Variable declarations for this prompt. */
+    variables?: VariableDefinition[];
     /** Tools available to this prompt (type-safe with autocomplete). To enable handoffs, include ai_human agent names. */
-    tools?: (AgentBuilder.Callables | SubpromptConfig)[];
+    tools?: (AgentBuilder.Callables | SubpromptConfig | PromptToolConfig | SubagentToolConfig)[];
+    /** Prompt-level environment values. */
+    env?: Record<string, string>;
+    /** @deprecated Use env */
+    tenvs?: Record<string, unknown>;
     /** Reasoning configuration for extended thinking models. */
     reasoning?: ReasoningConfig;
     /** Number of recent messages to keep actual images for. @default 10 */
@@ -1428,7 +1632,25 @@ interface PromptDefinition<N extends string = string, S extends ToolArgs = ToolA
  * Side configuration with type-safe autocomplete.
  * Uses AgentBuilder.Prompts and AgentBuilder.Callables for type-safe references.
  */
-interface SideConfig extends Omit<SideConfig$1, 'prompt' | 'stopTool' | 'endSessionTool'> {
+interface SessionToolConfig {
+    /**
+     * Tool name for this lifecycle binding.
+     */
+    name: AgentBuilder.Callables;
+    /**
+     * Optional tool-argument property used as message text.
+     */
+    messageProperty?: string;
+    /**
+     * Optional tool-argument property containing attachment path(s).
+     */
+    attachmentsProperty?: string;
+}
+/**
+ * Session lifecycle binding (string shorthand or explicit object form).
+ */
+type SessionToolBinding = AgentBuilder.Callables | SessionToolConfig;
+interface SideConfig extends Omit<SideConfig$1, 'prompt' | 'stopTool' | 'sessionStop' | 'sessionFail' | 'sessionStatus' | 'endSessionTool' | 'statusTool' | 'failSessionTool'> {
     /**
      * The prompt to use for this side (type-safe with autocomplete).
      * Must reference a prompt defined in agents/prompts/.
@@ -1441,11 +1663,32 @@ interface SideConfig extends Omit<SideConfig$1, 'prompt' | 'stopTool' | 'endSess
      */
     stopTool?: AgentBuilder.Callables;
     /**
-     * Tool that ends the entire session when called (type-safe with autocomplete).
-     * Different from stopTool - this ends the session for both sides,
-     * not just this side's turn.
+     * Tool that ends the entire session when called.
+     * Supports shorthand string or explicit message/attachment mapping object.
+     */
+    sessionStop?: SessionToolBinding;
+    /**
+     * Tool that fails the entire session when called.
+     * Supports shorthand string or explicit message/attachment mapping object.
+     */
+    sessionFail?: SessionToolBinding;
+    /**
+     * Tool that publishes status updates to the parent thread when used as a subagent.
+     * Supports shorthand string or explicit message/attachment mapping object.
+     */
+    sessionStatus?: SessionToolBinding;
+    /**
+     * @deprecated Use sessionStop instead.
      */
     endSessionTool?: AgentBuilder.Callables;
+    /**
+     * @deprecated Use sessionFail instead.
+     */
+    failSessionTool?: AgentBuilder.Callables;
+    /**
+     * @deprecated Use sessionStatus instead.
+     */
+    statusTool?: AgentBuilder.Callables;
     /**
      * Enable manual stop condition handling via hooks.
      * Builder-specific feature for custom stop logic.
@@ -1509,9 +1752,11 @@ interface AgentDefinition<N extends string = string> {
     /** Description shown when agent is used as a tool. */
     toolDescription?: string;
     /**
-     * Thread environment variables for this agent.
-     * Merged into thread tenvs at creation time.
-     * Later values (thread) override earlier ones (prompt -> agent).
+     * Environment values provided by this agent.
+     */
+    env?: Record<string, string>;
+    /**
+     * @deprecated Use env
      */
     tenvs?: Record<string, unknown>;
     /** Brief description of what this agent does. */
@@ -1595,6 +1840,21 @@ interface ToolConfigInput {
     include_errors?: boolean;
     init_user_message_property?: string | null;
     init_attachments_property?: string | null;
+    init_agent_name_property?: string | null;
+    blocking?: boolean;
+    optional?: string | null;
+    immediate?: boolean | {
+        name_env?: string | null;
+        description_env?: string | null;
+        scoped_env?: string[];
+    };
+    resumable?: false | {
+        receives_messages: 'side_a' | 'side_b';
+        max_instances?: number | null;
+        parent_communication?: 'implicit' | 'explicit' | null;
+    };
+    env?: Record<string, string>;
+    /** @deprecated Use env */
     tenvs?: Record<string, unknown>;
 }
 /**
@@ -1602,14 +1862,21 @@ interface ToolConfigInput {
  * Supports both new format (type: 'text'/'include') and legacy format (type: 'string'/'prompt')
  */
 interface PromptPartInput {
-    type: 'text' | 'include' | 'string' | 'prompt' | 'variable';
+    type: 'text' | 'include' | 'env' | 'string' | 'prompt' | 'variable';
     content?: string;
     prompt?: string;
+    property?: string;
     value?: string;
     id?: string;
     label?: string;
     schema?: any;
 }
+interface VariableDeclarationInput {
+    name: string;
+    type: 'text' | 'secret';
+    required: boolean;
+    description: string;
+}
 /**
  * Input data for generating a prompt file.
  * This can include JSON Schema for requiredSchema which will be converted to Zod.
@@ -1630,6 +1897,10 @@ interface PromptFileData {
     parallelToolCalls?: boolean;
     toolChoice?: 'auto' | 'none' | 'required';
     tools?: (string | ToolConfigInput)[];
+    variables?: VariableDeclarationInput[];
+    env?: Record<string, string>;
+    /** @deprecated Use env */
+    tenvs?: Record<string, unknown>;
     reasoning?: {
         effort?: 'low' | 'medium' | 'high';
         maxTokens?: number;
@@ -2733,6 +3004,56 @@ type ProviderImagePart = ImagePart;
 /** @public Alias for FilePart */
 type ProviderFilePart = FilePart;
 
+/**
+ * Function that can intercept provider creation.
+ * Returns a provider to override the default, or null to fall through.
+ */
+type ProviderOverrideFn = (modelName: string, modelDef: ModelDefinition$1<string>, env: Env) => LLMProviderInterface | null;
+/**
+ * Provider registry implementation
+ *
+ * Models must use ProviderFactory functions imported from provider packages
+ * (e.g., @standardagents/openai, @standardagents/openrouter).
+ *
+ * Loads model configs from TypeScript virtual modules and
+ * provider API keys from environment variables.
+ */
+declare class ProviderRegistryImpl {
+    private providerCache;
+    private providerOverrideFn;
+    setProviderOverride(fn: ProviderOverrideFn | null): void;
+    /**
+     * Get provider for a model.
+     *
+     * Models must use ProviderFactory functions (imported from provider packages).
+     *
+     * @param modelName - The model name (from TypeScript config)
+     * @param env - Environment bindings
+     * @param thread - Thread instance for loading model from virtual modules
+     * @returns Provider and model definition
+     */
+    getProvider(modelName: string, env: Env, thread?: ThreadInstance): Promise<{
+        provider: LLMProviderInterface;
+        modelName: string;
+        modelDef: ModelDefinition$1<string>;
+    }>;
+    private buildResult;
+    private cacheAndReturn;
+    /**
+     * Get API key for a provider from environment variables.
+     */
+    private getApiKeyForProvider;
+    /**
+     * Clear the provider cache
+     * Useful for testing or when configurations change
+     */
+    clearCache(): void;
+}
+/**
+ * Singleton instance
+ */
+declare const ProviderRegistry: ProviderRegistryImpl;
+
 /**
  * Namespace-scoped resolution for the packing system.
  *
@@ -2877,4 +3198,4 @@ declare function createNamespaceContext(agentDef: {
  */
 declare function isQualifiedName(name: string): boolean;
 
-export { type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, DurableAgentBuilder, DurableThread, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, GrepResult, type ImageContextConfig, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, Message, MessageContent, type ModelDefinition, NamespaceResolutionError, NamespacedRegistry, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, type ProviderTextPart, type SideConfig, type SubpromptConfig, ThreadEnv, ThreadMetadata, type ThreadRegistryEntry, type ToolConfig, type UpdateThreadParams, type User, authenticate, buildImageDescription, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateAgentFile, generateImageDescription, generateModelFile, generatePromptFile, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+export { type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, DurableAgentBuilder, DurableThread, Env, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, GrepResult, type ImageContextConfig, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, Message, MessageContent, type ModelDefinition, NamespaceResolutionError, NamespacedRegistry, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type PromptToolConfig, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, ProviderRegistry, type ProviderTextPart, type SessionToolBinding, type SessionToolConfig, type SideConfig, type SubagentToolConfig, type SubpromptConfig, ThreadEnv, ThreadInstance, ThreadMetadata, type ThreadRegistryEntry, type ToolConfig, type UpdateThreadParams, type User, authenticate, buildImageDescription, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateAgentFile, generateImageDescription, generateModelFile, generatePromptFile, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };