@standardagents/builder 0.29.1 → 0.30.0

package/dist/runtime.d.ts

@@ -1,6 +1,6 @@
-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-BNLDsLsL.js';
-export { f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, 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, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-BNLDsLsL.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';
+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-CcnGEkPh.js';
+export { f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, 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, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-CcnGEkPh.js';
+import { CodeExecutionOptions, CodeExecutionResult, SubagentRegistryEntry, InjectMessageInput, QueueMessageInput, CredentialGrant, 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';
@@ -1043,7 +1043,10 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * always produce a normal tool error (no client connected, timeout, or user
      * denial) for the model to reason about.
      */
-    callClientTool(request: ClientToolRequest): Promise<ClientToolResponse>;
+    callClientTool(request: ClientToolRequest, durability?: {
+        toolCallId: string;
+        side: "a" | "b";
+    }): Promise<ClientToolResponse>;
     /** Settle a pending forwarded call exactly once, clearing its timers. */
     private settleClientCall;
     /** Close and forget a bridge socket we've deemed dead, failing remaining calls. */
@@ -1682,14 +1685,66 @@ declare class DurableUserHub extends DurableObject<DurableUserHubEnv> {
     private migrated;
     constructor(ctx: DurableObjectState, env: DurableUserHubEnv);
     private ensureMigrated;
+    /**
+     * Returns the user endpoints registry for lazy-loading `users/` files.
+     * Keys are endpoint file paths relative to `users/` with the extension
+     * stripped except the method suffix (e.g. `standardcode/lease_acquire.post`).
+     * Implemented when DurableUserHub is imported from
+     * 'virtual:@standardagents/builder'.
+     */
+    userEndpoints(): Record<string, () => Promise<unknown>>;
+    /**
+     * Returns the hooks registry (same registry the thread runtime uses). The
+     * hub filters it to user-scope hook types at dispatch time. Implemented
+     * when DurableUserHub is imported from 'virtual:@standardagents/builder'.
+     */
+    userHooks(): Record<string, () => Promise<unknown>>;
     /**
      * 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>;
+    /** Idle sockets answer heartbeats at the edge without waking the object.
+     *  Registered at accept time rather than in the constructor so a hub that
+     *  never accepts a socket stays fully evictable (this also keeps
+     *  vitest-pool-workers' isolated storage able to pop the DO's frame). */
+    private ensureHeartbeatAutoResponse;
+    /** Sockets attached to the user event stream, restored after hibernation. */
+    private streamSockets;
+    private acceptUserStream;
+    /**
+     * Deliver an event frame to every socket attached to this user's stream.
+     * At-most-once, live-only (spec: Users §4) — no history, no acks.
+     */
+    broadcastUserEvent(userId: string, event: string, data?: unknown): void;
+    /** Per-user execution chain (spec: Users §2.1) — see users/serialize.ts. */
+    private executionChain;
+    private scopeHost;
+    private runUserEndpoint;
+    /**
+     * Fire every definition of a user hook type. Observational and best-effort:
+     * failures are swallowed and dispatch never blocks the triggering
+     * operation. Nested dispatch is suppressed so a `user_value_changed` hook
+     * writing values cannot recurse.
+     */
+    private inUserHookDispatch;
+    private dispatchUserHooks;
     webSocketClose(ws: WebSocket): Promise<void>;
+    /**
+     * Store or replace a grant. `secret` is write-only from this point on.
+     * Policy (`CredentialGrant` minus the secret) is kept as JSON config.
+     */
+    setGrant(userId: string, grant: CredentialGrant, secret: string): Promise<void>;
+    deleteGrant(userId: string, name: string): Promise<void>;
+    /** Metadata-only listing — never returns secret material. */
+    listGrants(userId: string): Promise<Array<Omit<CredentialGrant, "name"> & {
+        name: string;
+    }>>;
+    /** Perform a privileged fetch with the grant's credential injected. */
+    private grantFetch;
+    private handleGrantFetch;
+    webSocketMessage(ws: WebSocket, _message: string | ArrayBuffer): Promise<void>;
     webSocketError(ws: WebSocket): Promise<void>;
     /** Whether a persistent client (daemon) is connected right now. */
     hasClient(): Promise<boolean>;