@standardagents/builder 0.27.13 → 0.28.0

package/dist/runtime.d.ts

@@ -1,6 +1,6 @@
-import { e as ThreadEnv, A as Agent, h as ThreadMetadata, i as ToolResult, M as Message, l as FileRecord, F as FlowState, n as FileStats, G as GrepResult, m as AttachmentRef, r as MessageContent, E as Env, g as ThreadInstance } from './index-DReIS8eP.js';
-export { f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, j as FlowResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, T as ToolCall, c as createThreadEndpointHandler, d as defineController } from './index-DReIS8eP.js';
-import { CodeExecutionOptions, CodeExecutionResult, SubagentRegistryEntry, InjectMessageInput, QueueMessageInput, ClientToolRequest, ClientToolResponse, SkillMetadata, SkillFileInput, 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';
+import { e as ThreadEnv, A as Agent, r as ThreadMetadata, t as ToolResult, M as Message, k as ClientToolRequest, l as ClientToolResponse, m as ClientStreamRequest, n as ClientStreamResponse, w as FileRecord, F as FlowState, y as FileStats, G as GrepResult, x as AttachmentRef, J as MessageContent, E as Env, q as ThreadInstance } from './index-BzXyIJPA.js';
+export { f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, u as FlowResult, D as ImageContentPart, I as ImageMetadata, L as LLMResponse, H as MultimodalContent, R as RequestContext, S as StorageBackend, v as TelemetryEvent, z as TextContentPart, b as ThreadEndpointContext, T as ToolCall, c as createThreadEndpointHandler, d as defineController } from './index-BzXyIJPA.js';
+import { CodeExecutionOptions, CodeExecutionResult, SubagentRegistryEntry, InjectMessageInput, QueueMessageInput, SkillMetadata, SkillFileInput, 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, ThreadState, 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, WorkerEntrypoint } from 'cloudflare:workers';
 import { N as NamespacedRegistry } from './types-Bpe7IANZ.js';
@@ -207,6 +207,7 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
     private bridgeClientInfo;
     private executionOwnerCache;
     private pendingClientCalls;
+    private clientStreams;
     private alarmQueue;
     private alarmQueueRearmed;
     private currentAbortController;
@@ -605,6 +606,22 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * Stop the currently executing thread (RPC method)
      * Simple "off" switch - stops turns, only cleared by user messages
      */
+    /**
+     * Flip every still-`pending` message to `failed` and broadcast the change to
+     * all connected heads. This is THE settle path for any terminal condition
+     * that leaves a turn half-open — user stop, lost execution, terminal
+     * execution failure, and expired parked forwarded calls — so no head is
+     * left rendering a stuck "Working" state. Returns the failure timestamp.
+     */
+    failPendingMessagesAndBroadcast(): Promise<number>;
+    /**
+     * A terminal failure ended a turn without a normal assistant reply: settle
+     * every pending message and persist a durable `failed` assistant message so
+     * all connected heads land on a real, visible end state — never a stuck
+     * "Working" spinner. Used by the FlowEngine's terminal catch and the parked
+     * forwarded-call TTL.
+     */
+    settleTerminalFailure(errorMessage: string): Promise<void>;
     stop(): Promise<Response>;
     /**
      * Continue execution from where it stopped (RPC method)
@@ -1093,6 +1110,50 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
     deliverClientToolResult(toolCallId: string, ok: boolean, result?: string, error?: string, deliveredByClientId?: string, deliveredGeneration?: number): Promise<{
         side: "a" | "b";
     } | null>;
+    /** Default time to wait for the client to accept a stream open. */
+    private static readonly CLIENT_STREAM_OPEN_TIMEOUT_MS;
+    /** Open a bidirectional byte stream to the connected owner client. */
+    openClientStream(request: ClientStreamRequest): Promise<ClientStreamResponse>;
+    private proxyStreams;
+    proxyStreamOpen(request: ClientStreamRequest): Promise<{
+        ok: boolean;
+        id?: string;
+        error?: string;
+        noClient?: boolean;
+    }>;
+    proxyStreamWrite(id: string, dataB64: string): Promise<void>;
+    proxyStreamPull(id: string): Promise<{
+        chunks: string[];
+        done: boolean;
+        error?: string;
+    }>;
+    proxyStreamEnd(id: string): Promise<void>;
+    proxyStreamAbort(id: string): Promise<void>;
+    /** Settle and remove a client stream exactly once. */
+    private settleClientStream;
+    /** Abort a stream from the Worker side, telling the client to tear down. */
+    private abortClientStream;
+    /** Handle an incoming stream_* frame from a bridge client. */
+    private handleClientStreamFrame;
+    /** Fail every stream bound to a socket that closed or died. */
+    private failClientStreamsForSocket;
+    /** How long a parked forwarded call waits for a client before failing visibly. */
+    private static readonly CLIENT_PARK_TTL_MS;
+    /**
+     * A forwarded call parked with NO client attached: ask the user's hub to
+     * summon the owning machine's daemon to this thread, and arm the bounded
+     * park TTL that turns an unreachable host into a visible durable failure
+     * instead of a silent hang.
+     */
+    notifyClientWaiting(toolCallId: string, threadId: string, userId: string | null): Promise<void>;
+    /**
+     * Park TTL expired: if the call is still pending, settle it as a durable,
+     * VISIBLE failure — rewrite the waiting placeholder, mark the pending row
+     * failed, fail any still-pending assistant messages, and persist a durable
+     * failed assistant message so every connected head settles instead of
+     * showing "Working" forever.
+     */
+    private failParkedClientCall;
     /**
      * Broadcast a log record to all connected WebSocket clients
      */
@@ -1590,6 +1651,59 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
     }>;
 }
 
+interface DurableUserHubEnv {
+    [key: string]: unknown;
+}
+interface HubClientInfo {
+    clientId: string | null;
+    clientName: string | null;
+    clientKind: string | null;
+}
+declare class DurableUserHub extends DurableObject<DurableUserHubEnv> {
+    /** Persistent client (daemon) sockets, restored across hibernation. */
+    private clientSockets;
+    private clientInfo;
+    private migrated;
+    constructor(ctx: DurableObjectState, env: DurableUserHubEnv);
+    private ensureMigrated;
+    /**
+     * Accept the user's persistent client (daemon) WebSocket. The daemon holds
+     * this ONE socket for its whole lifetime; per-thread bridge sockets are
+     * opened separately and only while a thread is active.
+     */
+    fetch(request: Request): Promise<Response>;
+    webSocketMessage(ws: WebSocket, _message: string | ArrayBuffer): Promise<void>;
+    webSocketClose(ws: WebSocket): Promise<void>;
+    webSocketError(ws: WebSocket): Promise<void>;
+    /** Whether a persistent client (daemon) is connected right now. */
+    hasClient(): Promise<boolean>;
+    /**
+     * Signal the connected daemon to attach a bridge to `threadId`. Called by a
+     * cold thread DO that parked a forwarded call with no client attached. The
+     * daemon reacts by opening a per-thread bridge socket, which triggers the
+     * thread's drain-on-attach. Returns whether a daemon was reachable.
+     */
+    requestWake(threadId: string): Promise<{
+        delivered: boolean;
+    }>;
+    getUserValue(userId: string, key: string): Promise<unknown | null>;
+    setUserValue(userId: string, key: string, value: unknown): Promise<void>;
+    listUserValues(userId: string, options?: {
+        prefix?: string | null;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        entries: Array<{
+            key: string;
+            value: unknown;
+            updated_at: number;
+        }>;
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+}
+
 type EnvValueType = 'text' | 'secret';
 /**
  * Environment type for DurableAgentBuilder.
@@ -1598,6 +1712,7 @@ type EnvValueType = 'text' | 'secret';
 interface AgentBuilderEnv {
     AGENT_BUILDER: DurableObjectNamespace<DurableAgentBuilder>;
     AGENT_BUILDER_THREAD: DurableObjectNamespace;
+    AGENT_BUILDER_USER_HUB?: DurableObjectNamespace<DurableUserHub>;
     ENCRYPTION_KEY?: string;
 }
 /**
@@ -1898,6 +2013,13 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
     }): Promise<void>;
     private assertValidUserValueKey;
     private assertValidUserValueUserId;
+    /**
+     * The per-user hub is the sharded home for account-wide KV. When the binding
+     * exists, the singleton delegates so the global object is no longer a
+     * per-user bottleneck; without it (pre-hub deploys, unit tests) it keeps the
+     * local `user_values` table.
+     */
+    private userHub;
     /** Read one JSON value from a user's account-wide key-value store. */
     getUserValue(userId: string, key: string): Promise<unknown | null>;
     /** Write one JSON value to a user's account-wide store; null/undefined deletes. */
@@ -3642,7 +3764,7 @@ declare class ProviderRegistryImpl {
      * @param thread - Thread instance for loading model from virtual modules
      * @returns Provider and model definition
      */
-    getProvider(modelName: string, env: Env, thread?: ThreadInstance): Promise<ProviderLookupResult>;
+    getProvider(modelName: string, env: Env, thread?: ThreadInstance, getState?: () => Promise<ThreadState>): Promise<ProviderLookupResult>;
     private buildResult;
     private cacheAndReturn;
     private getProviderFingerprint;
@@ -3805,4 +3927,4 @@ declare function createNamespaceContext(agentDef: {
  */
 declare function isQualifiedName(name: string): boolean;
 
-export { Agent, type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, Env, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, 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, ThreadWatchdog, type ThreadWatchdogState, type ToolConfig, ToolResult, type UpdateThreadParams, type User, type WatchdogCheckin, type WatchdogProbeResult, authenticate, buildImageDescription, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateImageDescription, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, move, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, rename, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+export { Agent, type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, DurableUserHub, Env, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, GrepResult, type HubClientInfo, 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, ThreadWatchdog, type ThreadWatchdogState, type ToolConfig, ToolResult, type UpdateThreadParams, type User, type WatchdogCheckin, type WatchdogProbeResult, authenticate, buildImageDescription, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateImageDescription, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, move, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, rename, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };