@standardagents/builder 0.12.8 → 0.13.0-next.c55f029

package/dist/{discovery-CpMs68Yx.d.ts → discovery-DVviz3By.d.ts}

@@ -1,4 +1,4 @@
-import { D as DiscoveredPackage } from './types-pLkJx8vg.js';
+import { D as DiscoveredPackage } from './types-DH3Egc5l.js';
 import { PackageSignature } from '@standardagents/spec';
 
 /**
@@ -76,6 +76,8 @@ declare class PackageDiscoveryService {
      */
     static validateStandardAgentField(field: unknown): field is {
         entryAgents: string[];
+        effects?: string[];
+        threadEndpoints?: string[];
     };
     /**
      * Get a package by ID.

package/dist/{index-DkbUJ4MM.d.ts → index-T0gR5l-G.d.ts}

@@ -1,7 +1,7 @@
 import { DurableObjectStorage } from '@cloudflare/workers-types';
 import { ZodObject, ZodRawShape } from 'zod';
-import { N as NamespacedRegistry } from './types-pLkJx8vg.js';
-import { ToolResult as ToolResult$1, HookName, HookSignatures, ThreadState, HookMessage, HookToolCall, HookToolResult, AgentDefinition, ControllerContext, Controller, ThreadEndpointHandler } from '@standardagents/spec';
+import { N as NamespacedRegistry } from './types-DH3Egc5l.js';
+import { ToolResult as ToolResult$1, VariableDefinition, HookName, HookSignatures, ThreadState, HookMessage, HookToolCall, HookToolResult, QueueMessageInput, SubagentRegistryEntry, AgentDefinition, ControllerContext, Controller, ThreadEndpointHandler } from '@standardagents/spec';
 
 /**
  * Callback function to execute before stream closes
@@ -92,6 +92,14 @@ interface Agent {
     side_a_stop_tool_response_property: string | null;
     side_a_max_steps: number | null;
     side_a_end_session_tool: string | null;
+    side_a_end_session_message_property: string | null;
+    side_a_end_session_attachments_property: string | null;
+    side_a_fail_session_tool: string | null;
+    side_a_fail_session_message_property: string | null;
+    side_a_fail_session_attachments_property: string | null;
+    side_a_status_tool: string | null;
+    side_a_status_message_property: string | null;
+    side_a_status_attachments_property: string | null;
     side_b_label: string | null;
     side_b_agent_prompt: string | null;
     side_b_stop_on_response: boolean;
@@ -99,6 +107,14 @@ interface Agent {
     side_b_stop_tool_response_property: string | null;
     side_b_max_steps: number | null;
     side_b_end_session_tool: string | null;
+    side_b_end_session_message_property: string | null;
+    side_b_end_session_attachments_property: string | null;
+    side_b_fail_session_tool: string | null;
+    side_b_fail_session_message_property: string | null;
+    side_b_fail_session_attachments_property: string | null;
+    side_b_status_tool: string | null;
+    side_b_status_message_property: string | null;
+    side_b_status_attachments_property: string | null;
     hooks?: string[];
 }
 /**
@@ -123,6 +139,16 @@ interface Message {
     parent_id?: string | null;
     depth?: number;
     attachments?: string | null;
+    metadata?: Record<string, unknown>;
+    subagent_id?: string | null;
+    subagent_name?: string | null;
+    subagent_title?: string | null;
+    subagent_description?: string | null;
+    subagent_status?: string | null;
+    subagent_resumable?: boolean | null;
+    subagent_blocking?: boolean | null;
+    subagent_thread_name?: string | null;
+    subagent_spawn_group_id?: string | null;
 }
 /**
  * Tool call from OpenAI format
@@ -145,8 +171,12 @@ interface ThreadMetadata {
     id: string;
     agent_id: string;
     user_id: 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;
 }
 /**
@@ -187,6 +217,8 @@ interface NativeToolModule {
     args: ZodObject<ZodRawShape> | null;
     /** The tool implementation function. */
     execute: ((state: any, args: Record<string, unknown>) => Promise<ToolResult$1>) | ((state: any) => Promise<ToolResult$1>);
+    /** Declared variables for this tool. */
+    variables?: VariableDefinition[] | null;
     /** Zod schema for thread environment variables, or null if none. */
     tenvs?: ZodObject<ZodRawShape> | null;
     /**
@@ -226,6 +258,7 @@ interface ThreadInstance {
     loadTool(name: string): Promise<any>;
     getPromptNames(): string[];
     getAgentNames(): string[];
+    getModelNames?(): 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<{
@@ -248,6 +281,16 @@ interface ThreadInstance {
         error?: string;
     }>;
     runAgent(threadId: string, agentName: string): Promise<void>;
+    queueMessage?(threadId: string, message: QueueMessageInput): Promise<void>;
+    getChildrenRegistry?(threadId: string): Promise<SubagentRegistryEntry[]>;
+    upsertChildRegistry?(threadId: string, entry: SubagentRegistryEntry): Promise<void>;
+    updateChildRegistryStatus?(threadId: string, reference: string, status: string): Promise<void>;
+    removeChildRegistry?(threadId: string, reference: string): Promise<void>;
+    getTerminated?(threadId: string): Promise<number | null>;
+    terminateThread?(threadId: string): Promise<{
+        success: boolean;
+        terminated: number;
+    }>;
     scheduleEffect(threadId: string, effectName: string, effectArgs: Record<string, unknown>, delayMs?: number): Promise<string>;
     getScheduledEffects(name?: string): Promise<Array<{
         id: string;
@@ -300,6 +343,37 @@ interface SubpromptConfig {
     includeToolCalls?: boolean;
     includeErrors?: boolean;
 }
+/**
+ * Prompt tool configuration with static tenvs/options.
+ */
+interface PromptToolConfig {
+    name: string;
+    env?: Record<string, string>;
+    /** @deprecated Use env */
+    tenvs?: Record<string, unknown>;
+    options?: Record<string, unknown>;
+}
+/**
+ * Subagent tool configuration for dual_ai agent invocation.
+ */
+interface SubagentToolConfig {
+    name: string;
+    blocking?: boolean;
+    initUserMessageProperty?: string;
+    initAttachmentsProperty?: string;
+    initAgentNameProperty?: string;
+    immediate?: boolean | {
+        nameEnv?: string;
+        descriptionEnv?: string;
+        scopedEnv?: string[];
+    };
+    optional?: string;
+    resumable?: false | {
+        receives_messages: "side_a" | "side_b";
+        maxInstances?: number;
+        parentCommunication?: "implicit" | "explicit";
+    };
+}
 /**
  * Prompt configuration - now loaded from TypeScript virtual modules
  */
@@ -325,7 +399,9 @@ interface PromptData {
     reasoning_exclude: boolean;
     include_reasoning: boolean;
     recentImageThreshold: number | null;
-    _tools?: (string | SubpromptConfig)[];
+    _tools?: (string | SubpromptConfig | PromptToolConfig | SubagentToolConfig)[];
+    _variables?: VariableDefinition[];
+    _env?: Record<string, string>;
     _requiredSchema?: unknown;
     _hooks?: string[];
 }
@@ -351,6 +427,8 @@ interface FlowState {
     sideBStepCount: number;
     stopped: boolean;
     stoppedBy?: "a" | "b";
+    stopReason?: string;
+    stopReasonCode?: string;
     forcedNextSide?: "side_a" | "side_b";
     pendingForceTurn?: "side_a" | "side_b";
     abortController?: AbortController;
@@ -414,6 +492,18 @@ interface FlowState {
      * Undefined means no restriction (global context or tool without uses).
      */
     currentToolUses?: string[];
+    /**
+     * Cached parent thread ID for this execution context.
+     */
+    parentThreadId?: string | null;
+    /**
+     * Prompt keys that have already executed immediate tools for this run.
+     */
+    immediatePromptRuns?: Set<string>;
+    /**
+     * Forces immediate tools on the next step after a handoff.
+     */
+    pendingImmediateAfterHandoff?: boolean;
 }
 /**
  * Text content part for multimodal messages
@@ -571,6 +661,8 @@ interface ToolResult {
      */
     result?: string;
     error?: string;
+    error_code?: string;
+    error_data?: Record<string, unknown>;
     stack?: string;
     /**
      * File attachments returned by the tool.
@@ -582,6 +674,11 @@ interface ToolResult {
      * New attachments are stored under /attachments/ directory.
      */
     attachments?: Array<ToolAttachment | AttachmentRef>;
+    /**
+     * Subagent reference to associate with the stored tool-result message.
+     * Used for subagent stream grouping.
+     */
+    subagent_id?: string;
 }
 /**
  * Flow execution result
@@ -590,6 +687,8 @@ interface FlowResult {
     messages: Message[];
     stopped: boolean;
     stoppedBy?: "a" | "b";
+    stopReason?: string;
+    stopReasonCode?: string;
     stepCount: number;
     stream: ReadableStream<Uint8Array>;
 }
@@ -884,6 +983,22 @@ interface LogDetails {
  */
 interface DurableThreadRpc {
     stop(): Promise<Response>;
+    executeBlocking?(threadId: string, agentId: string, initial_messages?: unknown[], data?: unknown): Promise<{
+        status: "success" | "error";
+        result?: string;
+        error?: string;
+        attachments?: unknown[];
+    }>;
+    terminateThread?(threadId: string): Promise<{
+        success: boolean;
+        terminated: number;
+    }>;
+    getTerminated?(threadId: string): Promise<number | null>;
+    queueMessage?(threadId: string, message: QueueMessageInput): Promise<void>;
+    getChildrenRegistry?(threadId: string): Promise<SubagentRegistryEntry[]>;
+    upsertChildRegistry?(threadId: string, entry: SubagentRegistryEntry): Promise<void>;
+    updateChildRegistryStatus?(threadId: string, reference: string, status: string): Promise<void>;
+    removeChildRegistry?(threadId: string, reference: string): Promise<void>;
     getMessages(limit?: number, offset?: number, order?: "ASC" | "DESC", includeSilent?: boolean, maxDepth?: number): Promise<{
         messages: unknown[];
         total: number;
@@ -919,6 +1034,12 @@ 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;
 }
 /**
@@ -929,10 +1050,112 @@ interface DurableAgentBuilderRpc {
         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>;
     getThread(threadId: string): Promise<ThreadRegistryEntry | null>;
+    resolveThreadEnv?(params: {
+        threadId: string;
+        property: string;
+        promptName?: string;
+    }): Promise<string | null>;
+    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: {
+            blocking: boolean;
+            resumable: boolean;
+            receives_messages: "side_a" | "side_b";
+            initial_message_content: string;
+            initial_message_attachments: Array<{
+                path: string;
+                name?: string;
+                mimeType?: string;
+                size?: number;
+                width?: number;
+                height?: number;
+            }>;
+            initial_agent_name?: string | null;
+            agent_title?: string | null;
+            agent_description?: string | null;
+            spawn_group_id?: string | null;
+        };
+    }): Promise<{
+        request_id: string;
+        parent_thread_id: string;
+        agent_name: string;
+        registry_agent_name: string;
+        required: string[];
+        missing: string[];
+        payload: {
+            blocking: boolean;
+            resumable: boolean;
+            receives_messages: "side_a" | "side_b";
+            initial_message_content: string;
+            initial_message_attachments: Array<{
+                path: string;
+                name?: string;
+                mimeType?: string;
+                size?: number;
+                width?: number;
+                height?: number;
+            }>;
+            initial_agent_name?: string | null;
+            agent_title?: string | null;
+            agent_description?: string | null;
+            spawn_group_id?: string | null;
+        };
+        created_at: number;
+    }>;
+    getPendingSubagentEnvRequest?(parentThreadId: string, requestId: string): Promise<{
+        request_id: string;
+        parent_thread_id: string;
+        agent_name: string;
+        registry_agent_name: string;
+        required: string[];
+        missing: string[];
+        payload: {
+            blocking: boolean;
+            resumable: boolean;
+            receives_messages: "side_a" | "side_b";
+            initial_message_content: string;
+            initial_message_attachments: Array<{
+                path: string;
+                name?: string;
+                mimeType?: string;
+                size?: number;
+                width?: number;
+                height?: number;
+            }>;
+            initial_agent_name?: string | null;
+            agent_title?: string | null;
+            agent_description?: string | null;
+            spawn_group_id?: string | null;
+        };
+        created_at: number;
+    } | null>;
+    completePendingSubagentEnvRequest?(params: {
+        parent_thread_id: string;
+        request_id: string;
+        env: Record<string, string>;
+    }): Promise<{
+        request_id: string;
+        child_thread_id: string;
+        status: "success";
+    }>;
+    getInstanceEnv?(): Promise<Record<string, string>>;
+    getUserEnv?(userId: string): Promise<Record<string, string>>;
     listThreads(params?: {
         agent_name?: string;
         user_id?: string;
@@ -945,6 +1168,7 @@ interface DurableAgentBuilderRpc {
         threads: ThreadRegistryEntry[];
         total: number;
     }>;
+    getThreadTreeIds?(threadId: string): Promise<string[]>;
     deleteThread(threadId: string): Promise<void>;
     getUserByUsername(username: string): Promise<unknown>;
     createSession(session: {
@@ -1040,4 +1264,4 @@ declare function defineController<Env extends ThreadEnv = ThreadEnv>(controller:
  */
 declare function createThreadEndpointHandler<Env extends ThreadEnv = ThreadEnv>(handler: ThreadEndpointHandler): BuilderController<Env>;
 
-export { type AttachmentRef as A, type BuilderController as B, type Env as E, type FileRecord as F, type GrepResult as G, type ImageMetadata as I, type LLMResponse as L, type Message as M, type RequestContext as R, type StorageBackend as S, type ThreadEnv as T, type ThreadMetadata as a, type FlowState as b, type FileStats as c, type MessageContent as d, defineController as e, createThreadEndpointHandler as f, type BuilderControllerContext as g, type ThreadEndpointContext as h, type BuilderThreadEndpointHandler as i, type Agent as j, type ThreadInstance as k, type ToolCall as l, type ToolResult as m, type FlowResult as n, type TelemetryEvent as o, type TextContentPart as p, type ImageContentPart as q, type MultimodalContent as r };
+export { type AttachmentRef as A, type BuilderController as B, type Env as E, type FileRecord as F, type GrepResult as G, type ImageMetadata as I, type LLMResponse as L, type Message as M, type RequestContext as R, type StorageBackend as S, type ThreadEnv as T, type ThreadMetadata as a, type FlowState as b, type FileStats as c, type MessageContent as d, type ThreadInstance as e, defineController as f, createThreadEndpointHandler as g, type BuilderControllerContext as h, type ThreadEndpointContext as i, type BuilderThreadEndpointHandler as j, type Agent as k, type ToolCall as l, type ToolResult as m, type FlowResult as n, type TelemetryEvent as o, type TextContentPart as p, type ImageContentPart as q, type MultimodalContent as r };