@standardagents/builder 0.11.12 → 0.12.1

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 export { AgentPluginOptions, agentbuilder } from './plugin.js';
-import { DurableObjectStorage } from '@cloudflare/workers-types';
-import { ZodObject, ZodRawShape } from 'zod';
-import { ToolResult as ToolResult$1, HookSignatures, AgentDefinition as AgentDefinition$1, ControllerContext, Controller, ThreadEndpointHandler, ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, SubpromptConfig as SubpromptConfig$2, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart } from '@standardagents/spec';
-export { AgentType, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, 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, defineAgent, defineHook, defineModel, definePrompt, defineTool, mapReasoningLevel } 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 } 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';
+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 'vite';
+import '@cloudflare/workers-types';
+import 'zod';
 
 /**
  * Global namespace for AgentBuilder types.
@@ -81,999 +86,6 @@ declare global {
     }
 }
 
-/**
- * Callback function to execute before stream closes
- */
-type BeforeClose = () => Promise<void> | void;
-/**
- * Manages HTTP streaming of content chunks.
- * WebSocket telemetry is handled separately by DurableThread.
- * Inspired by bod.coach MultiplexedStream pattern.
- */
-declare class StreamManager {
-    /**
-     * HTTP ReadableStream controller for content
-     */
-    private httpController?;
-    /**
-     * HTTP ReadableStream for content chunks
-     */
-    httpStream: ReadableStream<Uint8Array>;
-    /**
-     * Active channels
-     */
-    activeChannels: number;
-    /**
-     * Before close hooks
-     */
-    private beforeCloseHooks;
-    /**
-     * Prevent automatic close
-     */
-    preventClose: boolean;
-    /**
-     * Text encoder for streams
-     */
-    private encoder;
-    /**
-     * Promise that resolves when stream is completely finished
-     */
-    then: Promise<void>;
-    /**
-     * Resolver for the then promise
-     */
-    private resolver;
-    /**
-     * Whether the stream has been closed
-     */
-    private closed;
-    constructor(beforeClose?: BeforeClose | BeforeClose[]);
-    /**
-     * Send content chunk to HTTP stream
-     */
-    sendContent(chunk: string): void;
-    /**
-     * Add a before close hook
-     */
-    addBeforeClose(hook: BeforeClose | BeforeClose[]): void;
-    /**
-     * Wait for a callback to complete before allowing stream to close
-     */
-    waitFor(callback: () => Promise<void> | void): Promise<void>;
-    /**
-     * Close a channel (decrement active channel count)
-     */
-    closeChannel(): void;
-    /**
-     * Close all streams and connections
-     */
-    close(): Promise<void>;
-    /**
-     * Force close the stream immediately
-     */
-    forceClose(): void;
-}
-
-/**
- * Agent configuration from D1 agents table
- */
-interface Agent {
-    id: string;
-    title: string;
-    type: "dual_ai" | "ai_human";
-    created_at: number;
-    max_session_turns: number | null;
-    side_a_label: string | null;
-    side_a_agent_prompt: string | null;
-    side_a_stop_on_response: boolean;
-    side_a_stop_tool: string | null;
-    side_a_stop_tool_response_property: string | null;
-    side_a_max_steps: number | null;
-    side_a_end_session_tool: string | null;
-    side_b_label: string | null;
-    side_b_agent_prompt: string | null;
-    side_b_stop_on_response: boolean;
-    side_b_stop_tool: string | null;
-    side_b_stop_tool_response_property: string | null;
-    side_b_max_steps: number | null;
-    side_b_end_session_tool: string | null;
-}
-/**
- * Message in OpenAI chat completion format
- */
-interface Message {
-    id: string;
-    role: "system" | "user" | "assistant" | "tool";
-    content: string | null;
-    name?: string | null;
-    tool_calls?: string | null;
-    tool_call_id?: string | null;
-    log_id?: string | null;
-    created_at: number;
-    request_sent_at?: number | null;
-    response_completed_at?: number | null;
-    status?: "pending" | "completed" | "failed";
-    silent?: boolean;
-    tool_status?: "success" | "error" | null;
-    reasoning_content?: string | null;
-    reasoning_details?: string | null;
-    parent_id?: string | null;
-    depth?: number;
-    attachments?: string | null;
-}
-/**
- * Tool call from OpenAI format
- */
-interface ToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-    forceAllow?: boolean;
-    queued_at?: number;
-}
-/**
- * Thread metadata from DurableAgentBuilder
- * Note: agent_id is now the agent name (not UUID) since agents are in TypeScript
- */
-interface ThreadMetadata {
-    id: string;
-    agent_id: string;
-    user_id: string | null;
-    tenvs: Record<string, unknown> | null;
-    properties: Record<string, unknown> | null;
-    created_at: number;
-}
-/**
- * Hook registry type - transforms HookSignatures into lazy-loaded optional hooks
- */
-type HookRegistry = {
-    [K in keyof HookSignatures]?: () => Promise<HookSignatures[K]>;
-};
-/**
- * Native tool module type - represents a loaded tool definition.
- * Tools can have args (with validation schema) or no args.
- * Uses local Zod types for compatibility with z.toJSONSchema().
- */
-interface NativeToolModule {
-    /** Description of what the tool does (shown to the LLM). */
-    description: string;
-    /** Zod schema for validating tool arguments, or null for no args. */
-    args: ZodObject<ZodRawShape> | null;
-    /** The tool implementation function. */
-    execute: ((state: any, args: Record<string, unknown>) => Promise<ToolResult$1>) | ((state: any) => Promise<ToolResult$1>);
-    /** Zod schema for thread environment variables, or null if none. */
-    tenvs?: ZodObject<ZodRawShape> | null;
-    /**
-     * Where this tool is executed:
-     * - 'local': Execute locally by the execution engine (default)
-     * - 'provider': Executed by the LLM provider, results come in response
-     */
-    executionMode?: 'local' | 'provider';
-    /**
-     * Which provider executes this tool (when executionMode='provider').
-     */
-    executionProvider?: string;
-}
-/**
- * Thread instance (forward reference to avoid circular dependency)
- */
-interface ThreadInstance {
-    ctx: DurableObjectState;
-    env: ThreadEnv;
-    getMessages(limit?: number, offset?: number, order?: "asc" | "desc", includeSilent?: boolean, maxDepth?: number): Promise<{
-        messages: Message[];
-        total: number;
-        hasMore: boolean;
-    }>;
-    getLogs(limit?: number, offset?: number, order?: "asc" | "desc"): Promise<LogData[]>;
-    getThreadMeta(threadId: string): Promise<ThreadMetadata | null>;
-    deleteMessage(messageId: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    shouldStop(): Promise<boolean>;
-    tools(): Record<string, () => Promise<NativeToolModule>>;
-    hooks(): HookRegistry;
-    loadModel(name: string): Promise<any>;
-    loadPrompt(name: string): Promise<any>;
-    loadAgent(name: string): Promise<any>;
-    getPromptNames(): string[];
-    getAgentNames(): string[];
-    writeFile(path: string, data: string, mimeType: string, options?: Record<string, unknown>): Promise<any>;
-    writeTextFile(path: string, content: string, mimeType: string, options?: Record<string, unknown>): Promise<any>;
-    readFile(path: string): Promise<{
-        success: boolean;
-        data?: string;
-        error?: string;
-    }>;
-    statFile(path: string): Promise<any>;
-    readdirFile(path: string): Promise<any[]>;
-    unlinkFile(path: string): Promise<void>;
-    mkdirFile(path: string): Promise<any>;
-    rmdirFile(path: string): Promise<void>;
-    getFileStats(): Promise<any>;
-    grepFiles(pattern: string): Promise<any[]>;
-    findFiles(pattern: string): Promise<any>;
-    getFileThumbnail(path: string): Promise<ArrayBuffer | null>;
-    readFileChunk(path: string, chunkIndex: number): Promise<{
-        success: boolean;
-        data?: string;
-        error?: string;
-    }>;
-    runAgent(threadId: string, agentName: string): Promise<void>;
-    scheduleEffect(threadId: string, effectName: string, effectArgs: Record<string, unknown>, delayMs?: number): Promise<string>;
-    getScheduledEffects(name?: string): Promise<Array<{
-        id: string;
-        name: string;
-        args: Record<string, unknown>;
-        scheduledAt: number;
-        createdAt: number;
-    }>>;
-    removeScheduledEffect(id: string): Promise<boolean>;
-    insertOrphanedToolCall(params: {
-        content?: string;
-        toolCallId: string;
-        toolName: string;
-        toolArgs: string;
-    }): Promise<Response>;
-}
-/**
- * Tool call for internal flow management
- */
-type FlowToolCall = {
-    tool: string;
-    args: Record<string, unknown>;
-};
-/**
- * Prompt call for internal flow management
- */
-type FlowPromptCall = {
-    prompt: string;
-    args: Record<string, unknown>;
-};
-/**
- * Flow call (tool or prompt)
- */
-type FlowCall = FlowToolCall | FlowPromptCall;
-/**
- * Flow call with retry tracking
- */
-type FlowCallWithRetries = FlowCall & {
-    retries: number;
-    reasons: string[];
-};
-/**
- * Sub-prompt configuration - defines options for when a sub-prompt is called as a tool
- */
-interface SubpromptConfig$1 {
-    name: string;
-    initUserMessageProperty?: string;
-    initAttachmentsProperty?: string;
-    includeTextResponse?: boolean;
-    includeToolCalls?: boolean;
-    includeErrors?: boolean;
-}
-/**
- * Prompt configuration - now loaded from TypeScript virtual modules
- */
-interface PromptData {
-    id: string;
-    name: string;
-    prompt: string | any[];
-    system_prompt?: string;
-    model: string;
-    model_id?: string;
-    tool_description: string;
-    required_schema: string;
-    include_chat: boolean;
-    include_past_tools: boolean;
-    prompts: string;
-    created_at: number;
-    /** @deprecated All prompts are now automatically exposed as tools */
-    expose_as_tool?: boolean;
-    parallel_tool_calls: boolean;
-    tool_choice: "auto" | "none" | "required" | "function";
-    reasoning_effort: "low" | "medium" | "high" | null;
-    reasoning_max_tokens: number | null;
-    reasoning_exclude: boolean;
-    include_reasoning: boolean;
-    recentImageThreshold: number | null;
-    _tools?: (string | SubpromptConfig$1)[];
-    _requiredSchema?: any;
-}
-/**
- * Central state object that flows through execution
- */
-interface FlowState {
-    threadId: string;
-    flowId: string;
-    thread: {
-        instance: ThreadInstance;
-        metadata: ThreadMetadata;
-    };
-    agentConfig: Agent;
-    currentSide: "a" | "b";
-    prompts: {
-        sideA: PromptData;
-        sideB: PromptData | null;
-    };
-    prompt: PromptData;
-    stepCount: number;
-    sideAStepCount: number;
-    sideBStepCount: number;
-    stopped: boolean;
-    stoppedBy?: "a" | "b";
-    forcedNextSide?: "side_a" | "side_b";
-    pendingForceTurn?: "side_a" | "side_b";
-    abortController?: AbortController;
-    messageHistory: Message[];
-    /**
-     * Appends these messages
-     */
-    extraMessages: Message[];
-    sequence: {
-        queue: ToolCall[];
-        queuedTools: ToolCall[];
-        isHandling: boolean;
-    };
-    active: FlowCallWithRetries;
-    queue: FlowCall[];
-    pendingHandoff?: {
-        agentId: string;
-        args?: Record<string, unknown>;
-        toolConfig?: {
-            initUserMessageProperty?: string;
-            initAttachmentsProperty?: string;
-        };
-    };
-    stream: StreamManager;
-    context: Record<string, unknown>;
-    retryCount: number;
-    retryReason?: string;
-    storage: DurableObjectStorage;
-    env: ThreadEnv;
-    emitLog?: (log: unknown) => void;
-    emitMessage?: (message: unknown) => void;
-    emitMessageChunk?: (messageId: string, chunk: string, depth?: number) => void;
-    emitTelemetry?: (event: TelemetryEvent) => void;
-    emitEvent?: (type: string, data: unknown) => void;
-    rootState: FlowState;
-    rootMessageId?: string | null;
-    parentLogId?: string | null;
-    currentLogId?: string | null;
-    parentMessageId?: string;
-    depth: number;
-    /** Path from root prompt to current prompt (e.g., ['basic_prompt', 'generate_image']) */
-    promptPath: string[];
-    pendingMessageId?: string;
-    allowedTools?: ToolDefinition[];
-    pendingMetadataPromises?: Promise<void>[];
-}
-/**
- * Text content part for multimodal messages
- */
-interface TextContentPart {
-    type: "text";
-    text: string;
-}
-/**
- * Image URL content part for multimodal messages (OpenAI/OpenRouter format)
- */
-interface ImageContentPart {
-    type: "image_url";
-    image_url: {
-        url: string;
-        detail?: "auto" | "low" | "high";
-    };
-}
-/**
- * Multimodal content - array of text and image parts
- */
-type MultimodalContent = Array<TextContentPart | ImageContentPart>;
-/**
- * Message content - can be string (text only) or array (multimodal)
- */
-type MessageContent = string | MultimodalContent;
-/**
- * Request context for LLM calls
- */
-interface RequestContext {
-    messages: Array<{
-        role: "system" | "user" | "assistant" | "tool";
-        content?: MessageContent;
-        tool_calls?: ToolCall[];
-        tool_call_id?: string;
-        name?: string;
-        reasoning_content?: string;
-        reasoning_details?: any[];
-        attachments?: any[];
-        toolName?: string;
-    }>;
-    model: string;
-    tools?: ToolDefinition[];
-    stream?: boolean;
-    promptName?: string;
-    systemPrompt?: string;
-    parentLogId?: string | null;
-    parallel_tool_calls?: boolean;
-    tool_choice?: "auto" | "none" | "required" | {
-        type: "function";
-        function: {
-            name: string;
-        };
-    };
-    reasoning?: {
-        effort?: "low" | "medium" | "high";
-        max_tokens?: number;
-        exclude?: boolean;
-    };
-    imagePathMap?: Map<string, string>;
-}
-/**
- * Tool definition for LLM requests
- */
-interface ToolDefinition {
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters?: Record<string, any>;
-    };
-    /**
-     * Where this tool is executed:
-     * - 'local': Execute locally by the execution engine (default)
-     * - 'provider': Executed by the LLM provider, results come in response
-     */
-    executionMode?: 'local' | 'provider';
-    /**
-     * Which provider executes this tool (when executionMode='provider')
-     * e.g., 'openai', 'anthropic'
-     */
-    executionProvider?: string;
-}
-/**
- * Image returned by an LLM response (e.g., from image generation models)
- * Format follows OpenAI/OpenRouter chat completions API
- */
-interface LLMResponseImage {
-    type: "image_url";
-    /** Unique ID for this generated image (used to link to tool call) */
-    id?: string;
-    /** Name of the tool that generated this image (e.g., 'image_generation') */
-    toolName?: string;
-    /** The revised/actual prompt used to generate the image (from OpenAI's image_generation) */
-    revisedPrompt?: string;
-    image_url: {
-        url: string;
-    };
-}
-/**
- * LLM response
- */
-interface LLMResponse {
-    id: string;
-    model: string;
-    content: string | null;
-    reasoning_content?: string | null;
-    reasoning_details?: any[];
-    tool_calls?: ToolCall[];
-    images?: LLMResponseImage[];
-    finish_reason: string;
-    usage: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-        prompt_tokens_details?: {
-            cached_tokens?: number;
-        };
-        completion_tokens_details?: {
-            reasoning_tokens?: number;
-        };
-        cost?: number;
-        provider?: string;
-    };
-    /** @internal Provider instance reference for async metadata fetching */
-    _provider?: unknown;
-    /** @internal Provider response ID for async metadata fetching */
-    _providerResponseId?: string;
-    /** @internal Aggregate response for logging */
-    _aggregate_response?: unknown;
-}
-/**
- * Attachment returned by a tool (e.g., generated images)
- * Stored in thread filesystem and linked to the tool message
- */
-interface ToolAttachment {
-    name: string;
-    mimeType: string;
-    data: string;
-    width?: number;
-    height?: number;
-}
-/**
- * Tool result
- */
-interface ToolResult {
-    status: "success" | "error";
-    /**
-     * Flattened text representation of the tool output.
-     *
-     * For tools that return structured MCP-style content (an array of
-     * content parts), this will be derived by concatenating all text
-     * parts. For legacy tools that returned a plain string `result`,
-     * that value is used directly.
-     */
-    result?: string;
-    error?: string;
-    stack?: string;
-    /**
-     * File attachments returned by the tool.
-     *
-     * Can contain either:
-     * - ToolAttachment: New files with base64 data to be stored
-     * - AttachmentRef: References to existing files in the thread filesystem
-     *
-     * New attachments are stored under /attachments/ directory.
-     */
-    attachments?: Array<ToolAttachment | AttachmentRef>;
-}
-/**
- * Flow execution result
- */
-interface FlowResult {
-    messages: Message[];
-    stopped: boolean;
-    stoppedBy?: "a" | "b";
-    stepCount: number;
-    stream: ReadableStream<Uint8Array>;
-}
-/**
- * Telemetry event types
- */
-type TelemetryEvent = {
-    type: "step_started";
-    step: number;
-    side: "a" | "b";
-    timestamp: number;
-} | {
-    type: "step_completed";
-    step: number;
-    stopped: boolean;
-    timestamp: number;
-} | {
-    type: "llm_request";
-    model: string;
-    attempt: number;
-    timestamp: number;
-} | {
-    type: "llm_response";
-    tokens: number;
-    latency: number;
-    timestamp: number;
-} | {
-    type: "validation_failed";
-    error: string;
-    timestamp: number;
-} | {
-    type: "fallback_triggered";
-    from: string;
-    to: string;
-    timestamp: number;
-} | {
-    type: "tool_started";
-    tool: string;
-    timestamp: number;
-} | {
-    type: "tool_completed";
-    tool: string;
-    status: string;
-    timestamp: number;
-} | {
-    type: "stopped";
-    reason: string;
-    side: "a" | "b";
-    timestamp: number;
-} | {
-    type: "stopped_by_user";
-    timestamp: number;
-};
-/**
- * Log data for telemetry table
- */
-interface LogData {
-    id: string;
-    message_id: string;
-    provider: string;
-    model: string;
-    model_name?: string;
-    endpoint?: string;
-    request_body?: string;
-    request_headers?: string;
-    response_body?: string;
-    response_headers?: string;
-    status_code?: number;
-    reasoning_content?: string | null;
-    input_tokens?: number;
-    cached_tokens?: number;
-    output_tokens?: number;
-    reasoning_tokens?: number;
-    total_tokens?: number;
-    latency_ms?: number;
-    time_to_first_token_ms?: number;
-    finish_reason?: string;
-    error?: string;
-    error_type?: string;
-    cost_input?: number;
-    cost_output?: number;
-    cost_total?: number;
-    message_history_length?: number;
-    tools_available?: number;
-    prompt_name?: string;
-    tools_called?: string;
-    queued_tools?: string;
-    actual_provider?: string | null;
-    parent_log_id?: string | null;
-    tools_schema?: string | null;
-    message_history?: string | null;
-    system_prompt?: string | null;
-    is_complete?: boolean;
-    errors?: string | null;
-    retry_of_log_id?: string | null;
-    created_at: number;
-}
-/**
- * Base environment interface for StandardAgents.
- * Extends ThreadEnv with optional provider API keys.
- *
- * User's Env interface should extend this or include these bindings.
- */
-interface Env extends ThreadEnv {
-    OPENAI_API_KEY?: string;
-    ANTHROPIC_API_KEY?: string;
-    OPENROUTER_API_KEY?: string;
-    GOOGLE_API_KEY?: string;
-    UI_DEV_SERVER?: string;
-    ASSETS?: {
-        fetch(request: Request | string): Promise<Response>;
-    };
-    GITHUB_TOKEN?: string;
-    GITHUB_REPO?: string;
-    GITHUB_BRANCH?: string;
-    SUPER_ADMIN_PASSWORD?: string;
-    ENCRYPTION_KEY?: string;
-    [key: string]: unknown;
-}
-/**
- * Storage backend types for files
- */
-type StorageBackend = "local" | "url" | "s3" | "r2";
-/**
- * File record stored in the files table
- */
-interface FileRecord {
-    path: string;
-    name: string;
-    mimeType: string;
-    storage: StorageBackend;
-    location?: string | null;
-    size: number;
-    metadata?: Record<string, unknown> | null;
-    isDirectory: boolean;
-    createdAt: number;
-    width?: number | null;
-    height?: number | null;
-    isChunked?: boolean;
-    chunkCount?: number;
-}
-/**
- * Image-specific metadata stored in FileRecord.metadata
- */
-interface ImageMetadata {
-    width: number;
-    height: number;
-}
-/**
- * Attachment reference stored in messages.attachments (JSON array)
- */
-interface AttachmentRef {
-    id: string;
-    type: "file";
-    path: string;
-    name: string;
-    mimeType: string;
-    width?: number;
-    height?: number;
-    description?: string;
-}
-/**
- * Grep search result
- */
-interface GrepResult {
-    path: string;
-    name: string;
-    matches: string[];
-    lineNumbers?: number[];
-}
-/**
- * File stats for storage tracking
- */
-interface FileStats {
-    totalSize: number;
-    fileCount: number;
-}
-
-/**
- * Router and endpoint definition module for AgentBuilder.
- *
- * This module re-exports endpoint types from @standardagents/spec and provides
- * the runtime router implementation for handling HTTP requests.
- *
- * @module
- */
-
-/**
- * Durable Object namespace interface.
- * This is Cloudflare-specific and used by the builder runtime.
- */
-interface DurableObjectNamespace$1<T = unknown> {
-    idFromName(name: string): DurableObjectId;
-    idFromString(id: string): DurableObjectId;
-    newUniqueId(): DurableObjectId;
-    get(id: DurableObjectId): DurableObjectStub$1<T>;
-}
-/**
- * Durable Object ID interface.
- */
-interface DurableObjectId {
-    toString(): string;
-    equals(other: DurableObjectId): boolean;
-}
-/**
- * Durable Object stub interface.
- * The generic type T represents the RPC methods available on the stub.
- */
-type DurableObjectStub$1<T = unknown> = {
-    id: DurableObjectId;
-    name?: string;
-    fetch(request: Request | string, requestInitr?: RequestInit): Promise<Response>;
-} & T;
-/**
- * Log entry from DurableThread.getLogs()
- */
-interface LogEntry {
-    id: string;
-    message_id: string;
-    provider: string;
-    model: string;
-    model_name: string | null;
-    prompt_name: string | null;
-    tools_called: string | null;
-    parent_log_id: string | null;
-    retry_of_log_id: string | null;
-    error: string | null;
-    cost_total: number | null;
-    is_complete: number;
-    created_at: number;
-    request_body: string | null;
-}
-/**
- * Response from getThreadMeta()
- */
-interface ThreadMetaResponse {
-    thread: ThreadRegistryEntry$1;
-    agent: AgentDefinition$1 | null;
-    stats: {
-        messageCount: number;
-        logCount: number;
-        lastActivity: number | null;
-    };
-}
-/**
- * Log details returned by getLogDetails
- */
-interface LogDetails {
-    id: string;
-    message_id: string;
-    provider: string;
-    actual_provider: string | null;
-    model: string;
-    model_name: string | null;
-    endpoint: string | null;
-    request_body: string | null;
-    request_headers: string | null;
-    response_body: string | null;
-    response_headers: string | null;
-    status_code: number | null;
-    reasoning_content: string | null;
-    input_tokens: number | null;
-    cached_tokens: number | null;
-    output_tokens: number | null;
-    reasoning_tokens: number | null;
-    total_tokens: number | null;
-    latency_ms: number | null;
-    time_to_first_token_ms: number | null;
-    finish_reason: string | null;
-    error: string | null;
-    error_type: string | null;
-    cost_input: number | null;
-    cost_output: number | null;
-    cost_total: number | null;
-    message_history_length: number | null;
-    tools_available: number | null;
-    prompt_name: string | null;
-    tools_called: string | null;
-    provider_tools: string | null;
-    parent_log_id: string | null;
-    tools_schema: string | null;
-    system_prompt: string | null;
-    errors: string | null;
-    retry_of_log_id: string | null;
-    tool_results: string | null;
-    is_complete: number;
-    created_at: number;
-}
-/**
- * RPC methods exposed by DurableThread for external callers.
- */
-interface DurableThreadRpc {
-    stop(): Promise<Response>;
-    getMessages(limit?: number, offset?: number, order?: "ASC" | "DESC", includeSilent?: boolean, maxDepth?: number): Promise<{
-        messages: unknown[];
-        total: number;
-        hasMore: boolean;
-    }>;
-    deleteMessage(messageId: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    updateMessageContent(messageId: string, content: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    getLogs(limit?: number, offset?: number, order?: "ASC" | "DESC"): Promise<{
-        logs: LogEntry[];
-        total: number;
-        hasMore: boolean;
-    }>;
-    getLogDetails(logId: string): Promise<LogDetails | null>;
-    getThreadMeta(threadId: string): Promise<ThreadMetaResponse | null>;
-    deleteThread(): Promise<void>;
-    readFile(path: string): Promise<{
-        success: boolean;
-        data?: string;
-        error?: string;
-    }>;
-}
-/**
- * Thread registry entry from DurableAgentBuilder.
- */
-interface ThreadRegistryEntry$1 {
-    id: string;
-    agent_name: string;
-    user_id: string | null;
-    tags: string[] | null;
-    created_at: number;
-}
-/**
- * RPC methods exposed by DurableAgentBuilder for external callers.
- */
-interface DurableAgentBuilderRpc {
-    createThread(params: {
-        agent_name: string;
-        user_id?: string;
-        tags?: string[];
-        tenvs?: Record<string, unknown>;
-        properties?: Record<string, unknown>;
-    }): Promise<ThreadRegistryEntry$1>;
-    getThread(threadId: string): Promise<ThreadRegistryEntry$1 | null>;
-    listThreads(params?: {
-        agent_name?: string;
-        user_id?: string;
-        search?: string;
-        startDate?: number;
-        endDate?: number;
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        threads: ThreadRegistryEntry$1[];
-        total: number;
-    }>;
-    deleteThread(threadId: string): Promise<void>;
-    getUserByUsername(username: string): Promise<unknown>;
-    createSession(session: {
-        user_id: string;
-        token_hash: string;
-        expires_at: number;
-    }): Promise<void>;
-    loadAgent(name: string): Promise<AgentDefinition$1>;
-}
-/**
- * Minimum required environment bindings for thread endpoints.
- * User's Env interface should extend this.
- *
- * This is Cloudflare-specific and used by the builder runtime.
- */
-interface ThreadEnv {
-    AGENT_BUILDER_THREAD: DurableObjectNamespace$1<DurableThreadRpc>;
-    AGENT_BUILDER: DurableObjectNamespace$1<DurableAgentBuilderRpc>;
-    [key: string]: unknown;
-}
-/**
- * Builder-specific controller context with typed env.
- *
- * This extends the spec's ControllerContext with proper typing for
- * Cloudflare environment bindings.
- */
-interface BuilderControllerContext<Env extends ThreadEnv = ThreadEnv> extends Omit<ControllerContext, 'env'> {
-    env: Env;
-}
-/**
- * Builder-specific controller type with typed env.
- */
-type BuilderController<Env extends ThreadEnv = ThreadEnv> = (context: BuilderControllerContext<Env>) => ReturnType<Controller>;
-/**
- * Thread endpoint context with access to thread instance and metadata.
- * @deprecated Use ThreadState instead
- */
-interface ThreadEndpointContext {
-    req: Request;
-    thread: {
-        instance: ThreadInstance;
-        metadata: ThreadMetadata;
-    };
-}
-/**
- * Handler function for builder thread endpoints.
- *
- * Receives the request and a ThreadState object per the Standard Agents spec.
- * The ThreadState provides access to thread identity, messages, logs,
- * resource loading, tool invocation, and more.
- *
- * Note: `state.execution` is always null in endpoints since the thread
- * is not actively executing.
- */
-type BuilderThreadEndpointHandler = ThreadEndpointHandler;
-
-/**
- * Define a controller with typed Cloudflare environment bindings.
- *
- * This is the builder's version of defineController that provides
- * proper typing for AGENT_BUILDER_THREAD and other CF bindings.
- *
- * @example
- * ```typescript
- * import { defineController } from '../router/index.js';
- *
- * export default defineController(async ({ req, env }) => {
- *   const stub = env.AGENT_BUILDER.get(env.AGENT_BUILDER.idFromName('singleton'));
- *   // ...
- * });
- * ```
- */
-declare function defineController<Env extends ThreadEnv = ThreadEnv>(controller: BuilderController<Env>): BuilderController<Env>;
-/**
- * Runtime implementation for defineThreadEndpoint.
- *
- * This wraps the spec's defineThreadEndpoint to provide the actual
- * thread lookup and ThreadState creation at runtime.
- *
- * @param handler - Function that receives the request and ThreadState
- * @returns A Controller that can be used with the router
- *
- * @example
- * // agentbuilder/api/threads/[id]/status.get.ts
- * import { defineThreadEndpoint } from '@standardagents/spec';
- *
- * export default defineThreadEndpoint(async (req, state) => {
- *   const { messages } = await state.getMessages({ limit: 1 });
- *   return Response.json({ status: "ok", messageCount: messages.length });
- * });
- */
-declare function createThreadEndpointHandler<Env extends ThreadEnv = ThreadEnv>(handler: ThreadEndpointHandler): BuilderController<Env>;
-
 /**
  * Authentication middleware for protecting API routes
  *
@@ -1179,8 +191,19 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * @returns Record of effect name to effect loader function
      */
     effects(): Record<string, () => Promise<any>>;
+    /**
+     * Returns the namespaced registry for packed agent support.
+     * This method is implemented when you import DurableThread from 'virtual:@standardagents/builder'.
+     *
+     * @throws Error if not implemented in a subclass
+     * @returns The namespaced registry with global and packages namespaces
+     */
+    registry(): any;
     /**
      * Load a model definition by name.
+     * Supports both global models and packed models (e.g., "packageId/modelName").
+     * For scoped packages, use "@scope/pkg/modelName".
+     * For packed context, tries package first then falls back to global.
      */
     loadModel(name: string): Promise<any>;
     /**
@@ -1189,6 +212,7 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
     getModelNames(): string[];
     /**
      * Load a prompt definition by name.
+     * Supports both global prompts (e.g., "my-prompt") and packed prompts (e.g., "packageId/promptName").
      */
     loadPrompt(name: string): Promise<any>;
     /**
@@ -1197,6 +221,8 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
     getPromptNames(): string[];
     /**
      * Load an agent definition by name.
+     * Supports both global agents (e.g., "my-agent") and packed agents (e.g., "packageId/agentName").
+     * For scoped packages, use "@scope/pkg/agentName".
      */
     loadAgent(name: string): Promise<any>;
     /**
@@ -1211,6 +237,11 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * List available effect names.
      */
     getEffectNames(): string[];
+    /**
+     * Load a tool definition by name.
+     * Supports both global tools (e.g., "my_tool") and packed tools (e.g., "packageId/toolName").
+     */
+    loadTool(name: string): Promise<any>;
     /**
      * Get thread metadata from DurableAgentBuilder.
      * Used for creating ThreadState outside of flow execution.
@@ -2002,6 +1033,11 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
      * Must be overridden in a subclass.
      */
     agents(): Record<string, () => Promise<any>>;
+    /**
+     * Returns the namespaced registry for packed agent support.
+     * Must be overridden in a subclass.
+     */
+    registry(): any;
     private ensureMigrated;
     private getCurrentVersion;
     private runMigrations;
@@ -2066,6 +1102,8 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
     getPromptNames(): string[];
     /**
      * Load an agent definition by name.
+     * Supports both global agents (e.g., "my-agent") and packed agents (e.g., "packageId/agentName").
+     * For scoped packages, use "@scope/pkg/agentName".
      */
     loadAgent(name: string): Promise<any>;
     /**
@@ -2315,7 +1353,7 @@ type PromptContent = string | PromptPart[];
 /**
  * Sub-prompt configuration with type-safe name references.
  */
-interface SubpromptConfig<T extends string = AgentBuilder.Callables> extends Omit<SubpromptConfig$2<T>, 'name'> {
+interface SubpromptConfig<T extends string = AgentBuilder.Callables> extends Omit<SubpromptConfig$1<T>, 'name'> {
     /** Name of the sub-prompt (type-safe with autocomplete) */
     name: T;
 }
@@ -2467,6 +1505,26 @@ interface AgentDefinition<N extends string = string> {
     description?: string;
     /** Icon URL or absolute path for the agent. */
     icon?: string;
+    /**
+     * npm package name for this agent when packed.
+     * Preserved through unpack → edit → pack cycles.
+     */
+    packageName?: string;
+    /**
+     * Package version (semver format).
+     * Preserved through unpack → edit → pack cycles.
+     */
+    version?: string;
+    /**
+     * Package author/copyright holder.
+     * Preserved through unpack → edit → pack cycles.
+     */
+    author?: string;
+    /**
+     * License identifier (SPDX format).
+     * Preserved through unpack → edit → pack cycles.
+     */
+    license?: string;
 }
 
 /**
@@ -2613,9 +1671,13 @@ interface InjectMessageOptions$1 {
  * This adds a tool call to the execution queue without immediately executing it.
  * The tool will be executed as part of the normal flow processing.
  *
+ * If the current tool has a `uses` list defined, the toolName must be in that list.
+ * This enforces namespace isolation for packed agents.
+ *
  * @param flow - The current FlowState
  * @param toolName - The name of the tool to call
  * @param args - The arguments to pass to the tool
+ * @throws Error if toolName is not in the current tool's uses list (when defined)
  *
  * @example
  * ```typescript
@@ -3654,4 +2716,148 @@ type ProviderImagePart = ImagePart;
 /** @public Alias for FilePart */
 type ProviderFilePart = FilePart;
 
-export { type Agent, type AgentBuilderEnv, type AgentDefinition, type AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, type BuilderThreadEndpointHandler, type BuilderController as Controller, type BuilderControllerContext as ControllerContext, DurableAgentBuilder, DurableThread, type Env, type FileRecord, type FileStats, type FlowResult, type FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, type GrepResult, type ImageContentPart, type ImageContextConfig, type ImageMetadata, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, type LLMResponse, type Message, type MessageContent, type ModelDefinition, type MultimodalContent, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, type ProviderTextPart, type RequestContext, type SideConfig, type StorageBackend, type SubpromptConfig, type TelemetryEvent, type TextContentPart, type ThreadEndpointContext, type ThreadEnv, type ThreadInstance, type ThreadMetadata, type ThreadRegistryEntry, type ToolCall, type ToolConfig, type ToolResult, type UpdateThreadParams, type User, authenticate, buildImageDescription, cat, createThreadEndpointHandler, defineController, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateAgentFile, generateImageDescription, generateModelFile, generatePromptFile, getFileStats, getMessages, getMessagesToSummarize, getThumbnail, getUnsummarizedImageAttachments, grep, hasImageAttachments, head, injectMessage, linkFile, mkdir, optimizeImageContext, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+/**
+ * Namespace-scoped resolution for the packing system.
+ *
+ * This module provides functions to resolve items (tools, prompts, models, agents)
+ * within the correct namespace context, enforcing isolation between packed and
+ * unpacked code.
+ *
+ * @module
+ */
+
+/**
+ * Error thrown when an item cannot be resolved in the current namespace.
+ */
+declare class NamespaceResolutionError extends Error {
+    readonly itemType: 'tool' | 'prompt' | 'model' | 'agent' | 'hook';
+    readonly itemName: string;
+    readonly namespace: NamespaceContext;
+    constructor(itemType: 'tool' | 'prompt' | 'model' | 'agent' | 'hook', itemName: string, namespace: NamespaceContext, message: string);
+}
+/**
+ * Parse a potentially qualified name into package ID and short name.
+ *
+ * For scoped npm packages (starting with @), the format is @scope/pkg-name/item-name
+ * where @scope/pkg-name is the package and item-name is the short name.
+ *
+ * For non-scoped packages, the format is pkg-name/item-name.
+ *
+ * @param name - The name to parse (e.g., 'tool', 'pkg/tool', or '@scope/pkg/tool')
+ * @returns Tuple of [packageId, shortName] where packageId is null for unqualified names
+ */
+declare function parseQualifiedName(name: string): [string | null, string];
+/**
+ * Create a qualified name from package ID and short name.
+ */
+declare function qualifyName(packageId: string, shortName: string): string;
+/**
+ * Get the short name (strip any package qualification).
+ */
+declare function getShortName(name: string): string;
+/**
+ * Resolve a tool by name within a namespace context.
+ *
+ * Resolution rules:
+ * - Qualified names (pkg:tool) → resolve cross-package entry point
+ * - Unqualified names in packed context → resolve from own package
+ * - Unqualified names in global context → resolve from global namespace
+ *
+ * @param registry - The namespaced registry
+ * @param name - Tool name (can be qualified with packageId:toolName)
+ * @param namespace - Current namespace context
+ * @returns Loader function for the tool definition
+ * @throws NamespaceResolutionError if tool cannot be found or accessed
+ */
+declare function resolveTool(registry: NamespacedRegistry, name: string, namespace: NamespaceContext): DefinitionLoader<unknown>;
+/**
+ * Resolve a prompt by name within a namespace context.
+ *
+ * @param registry - The namespaced registry
+ * @param name - Prompt name (can be qualified)
+ * @param namespace - Current namespace context
+ * @returns Loader function for the prompt definition
+ */
+declare function resolvePrompt(registry: NamespacedRegistry, name: string, namespace: NamespaceContext): DefinitionLoader<unknown>;
+/**
+ * Resolve a model by name within a namespace context.
+ *
+ * Models are special: packed agents include their model definitions,
+ * but the host must provide API keys.
+ *
+ * @param registry - The namespaced registry
+ * @param name - Model name
+ * @param namespace - Current namespace context
+ * @returns Loader function for the model definition
+ */
+declare function resolveModel(registry: NamespacedRegistry, name: string, namespace: NamespaceContext): DefinitionLoader<unknown>;
+/**
+ * Resolve an agent by name within a namespace context.
+ *
+ * Resolution rules:
+ * - Qualified names (pkg:agent) → resolve cross-package entry point
+ * - Unqualified in packed → resolve from own package
+ * - Unqualified in global → resolve from global + entry points
+ *
+ * @param registry - The namespaced registry
+ * @param name - Agent name (can be qualified)
+ * @param namespace - Current namespace context
+ * @returns Loader function for the agent definition
+ */
+declare function resolveAgent(registry: NamespacedRegistry, name: string, namespace: NamespaceContext): DefinitionLoader<unknown>;
+/**
+ * Resolve a hook by name within a namespace context.
+ *
+ * Hooks follow similar rules to tools but are keyed by hook type.
+ *
+ * @param registry - The namespaced registry
+ * @param name - Hook name (file name, e.g., 'filter_messages')
+ * @param namespace - Current namespace context
+ * @returns Loader function for the hook implementation
+ */
+declare function resolveHook(registry: NamespacedRegistry, name: string, namespace: NamespaceContext): DefinitionLoader<unknown> | null;
+/**
+ * Get all tool names visible in a namespace context.
+ *
+ * @param registry - The namespaced registry
+ * @param namespace - Current namespace context
+ * @returns Array of visible tool names (short names)
+ */
+declare function getVisibleToolNames(registry: NamespacedRegistry, namespace: NamespaceContext): string[];
+/**
+ * Get all agent names visible in a namespace context.
+ *
+ * @param registry - The namespaced registry
+ * @param namespace - Current namespace context
+ * @returns Array of visible agent names (may include qualified names for cross-package)
+ */
+declare function getVisibleAgentNames(registry: NamespacedRegistry, namespace: NamespaceContext): string[];
+/**
+ * Get all prompt names visible in a namespace context.
+ */
+declare function getVisiblePromptNames(registry: NamespacedRegistry, namespace: NamespaceContext): string[];
+/**
+ * Get all model names visible in a namespace context.
+ */
+declare function getVisibleModelNames(registry: NamespacedRegistry, namespace: NamespaceContext): string[];
+/**
+ * Create a namespace context for an agent definition.
+ *
+ * @param agentDef - Agent definition (may have __package field)
+ * @returns Appropriate namespace context
+ */
+declare function createNamespaceContext(agentDef: {
+    __package?: {
+        packageId: string;
+    };
+} | undefined): NamespaceContext;
+/**
+ * Check if a name is qualified (contains package prefix).
+ *
+ * For scoped packages (@scope/name), there must be at least two slashes
+ * to be considered qualified (e.g., @scope/pkg/item).
+ * For non-scoped packages, a single slash qualifies it (e.g., pkg/item).
+ */
+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 };