@standardagents/builder 0.28.0 → 0.29.0

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-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 { 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-Cp_Zcrhy.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-Cp_Zcrhy.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';
@@ -1120,6 +1120,7 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
         id?: string;
         error?: string;
         noClient?: boolean;
+        code?: 'unsupported' | 'unavailable' | 'refused' | 'timeout';
     }>;
     proxyStreamWrite(id: string, dataB64: string): Promise<void>;
     proxyStreamPull(id: string): Promise<{
@@ -3927,4 +3928,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, 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 };
+export { Agent, type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, ClientStreamRequest, ClientStreamResponse, ClientToolRequest, ClientToolResponse, 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 };

package/dist/runtime.js

@@ -29,6 +29,90 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/agents/client-forwarding.ts
+function asForwarding(state) {
+  return state;
+}
+function supportsClientForwarding(state) {
+  const s = asForwarding(state);
+  return typeof s.callClient === "function" && typeof s.callClientStream === "function";
+}
+function callClient(state, request) {
+  const s = asForwarding(state);
+  if (typeof s.callClient !== "function") {
+    return Promise.resolve({
+      ok: false,
+      error: "This thread runtime cannot forward tools to a client. Client forwarding requires the DurableThread bridge."
+    });
+  }
+  return s.callClient(request);
+}
+function callClientStream(state, request) {
+  if (state.runtimeStreams) {
+    return state.runtimeStreams.open({
+      capability: request.tool,
+      metadata: request.meta,
+      timeoutMs: request.timeoutMs
+    }).then(
+      (opened) => opened.ok ? {
+        ok: true,
+        duplex: {
+          readable: opened.stream.readable,
+          writable: opened.stream.writable,
+          close: (reason) => opened.stream.close(reason),
+          done: opened.stream.closed
+        }
+      } : {
+        ok: false,
+        error: opened.error,
+        data: opened.code ? {
+          code: opened.code,
+          noClient: opened.code === "unavailable" ? true : void 0
+        } : void 0
+      }
+    );
+  }
+  const s = asForwarding(state);
+  if (typeof s.callClientStream !== "function") {
+    return Promise.resolve({
+      ok: false,
+      error: "This thread runtime cannot open client streams. Client streaming requires the DurableThread bridge."
+    });
+  }
+  return s.callClientStream(request);
+}
+function createRuntimeStreams(openClientStream) {
+  return {
+    async open(request) {
+      const opened = await openClientStream({
+        tool: request.capability,
+        meta: request.metadata,
+        timeoutMs: request.timeoutMs
+      });
+      if (!opened.ok) {
+        const failureData = opened.data;
+        return {
+          ok: false,
+          error: opened.error,
+          code: failureData?.code
+        };
+      }
+      let closed = false;
+      return {
+        ok: true,
+        stream: {
+          readable: opened.duplex.readable,
+          writable: opened.duplex.writable,
+          closed: opened.duplex.done,
+          close: (reason) => {
+            if (closed) return;
+            closed = true;
+            opened.duplex.close(reason);
+          }
+        }
+      };
+    }
+  };
+}
 function encodeStreamChunk(bytes) {
   let binary = "";
   const step = 32768;
@@ -12903,6 +12987,14 @@ var init_ThreadStateImpl = __esm({
         }
         return this.getMetadataArguments();
       }
+      /**
+       * Optional spec byte streams backed by the execution owner's existing
+       * bridge. Streams are live resources: they proxy through ancestors when a
+       * subagent opens one, but they never park or outlive a bridge disconnect.
+       */
+      get runtimeStreams() {
+        return createRuntimeStreams((request) => this.callClientStream(request));
+      }
       getMetadataArguments() {
         const value = this._metadata.properties?.[SUBAGENT_INITIAL_ARGUMENTS_THREAD_PROPERTY];
         if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -13479,11 +13571,9 @@ var init_ThreadStateImpl = __esm({
         return local;
       }
       /**
-       * Open a bidirectional byte stream to the connected client (e.g. a raw TCP
-       * tunnel for Worker-side TLS termination). Streams require a LIVE bridge on
-       * this thread and never park — a stream is only meaningful while the client
-       * is attached. Subagents must not call this directly; they proxy whole
-       * requests up to the root thread instead (request-up / stream-down).
+       * Legacy bridge implementation used by `runtimeStreams`. Streams require a
+       * live execution owner and never park. A child thread proxies the complete
+       * request to the nearest bridge-holding ancestor (request-up/stream-down).
        */
       async callClientStream(request) {
         const instance = this._threadInstance;
@@ -13509,7 +13599,11 @@ var init_ThreadStateImpl = __esm({
                 return { ok: true, duplex: this.buildProxyDuplex(stub, opened.id) };
               }
               if (opened.error && !opened.noClient) {
-                return { ok: false, error: opened.error };
+                return {
+                  ok: false,
+                  error: opened.error,
+                  data: opened.code ? { code: opened.code } : void 0
+                };
               }
             }
           } catch {
@@ -13528,6 +13622,12 @@ var init_ThreadStateImpl = __esm({
         let settleDone;
         const done = new Promise((r) => settleDone = r);
         let closed = false;
+        let settled = false;
+        const settle = (result) => {
+          if (settled) return;
+          settled = true;
+          settleDone(result);
+        };
         const readable = new ReadableStream({
           async pull(controller) {
             while (!closed) {
@@ -13536,7 +13636,7 @@ var init_ThreadStateImpl = __esm({
                 res = await stub.proxyStreamPull(id);
               } catch (error) {
                 controller.error(error instanceof Error ? error : new Error(String(error)));
-                settleDone({ ok: false, error: "proxy stream pull failed" });
+                settle({ ok: false, error: "proxy stream pull failed" });
                 return;
               }
               for (const chunk of res.chunks) {
@@ -13544,7 +13644,7 @@ var init_ThreadStateImpl = __esm({
               }
               if (res.done) {
                 controller.close();
-                settleDone(res.error ? { ok: false, error: res.error } : { ok: true });
+                settle(res.error ? { ok: false, error: res.error } : { ok: true });
                 return;
               }
               if (res.chunks.length > 0) return;
@@ -13555,6 +13655,7 @@ var init_ThreadStateImpl = __esm({
             closed = true;
             void stub.proxyStreamAbort(id).catch(() => {
             });
+            settle({ ok: false, error: "proxy stream reader canceled" });
           }
         });
         const writable = new WritableStream({
@@ -13569,16 +13670,18 @@ var init_ThreadStateImpl = __esm({
             closed = true;
             void stub.proxyStreamAbort(id).catch(() => {
             });
+            settle({ ok: false, error: "proxy stream writer aborted" });
           }
         });
         return {
           readable,
           writable,
           close: (error) => {
+            if (closed) return;
             closed = true;
             void stub.proxyStreamAbort(id).catch(() => {
             });
-            settleDone(error ? { ok: false, error } : { ok: true });
+            settle(error ? { ok: false, error } : { ok: true });
           },
           done
         };
@@ -14456,6 +14559,9 @@ async function requireAdmin(request, env) {
   return result;
 }
 
+// src/runtime.ts
+init_client_forwarding();
+
 // src/durable-objects/migrations/001_initial.ts
 var migration = {
   version: 1,
@@ -20217,12 +20323,10 @@ ${resultContent}${attachmentSummary}`;
     }
     return { side };
   }
-  // ─── Client byte streams (Worker-side TLS tunnels) ─────────────────────────
-  // A stream is a bidirectional byte pipe over the bridge WebSocket: the
-  // client opens a raw TCP socket per the stream's `meta` and shuttles bytes
-  // both ways; the Worker terminates TLS over those bytes (node:tls over the
-  // duplex), so the client only ever relays ciphertext. Streams are bound to a
-  // live socket and never park.
+  // ─── Runtime byte streams ──────────────────────────────────────────────────
+  // The existing bridge frames carry opaque capability metadata and bytes
+  // between the runtime and its execution owner. Streams are live resources:
+  // they are bound to one bridge socket and never park.
   /** Default time to wait for the client to accept a stream open. */
   static CLIENT_STREAM_OPEN_TIMEOUT_MS = 3e4;
   /** Open a bidirectional byte stream to the connected owner client. */
@@ -20233,7 +20337,7 @@ ${resultContent}${attachmentSummary}`;
       return {
         ok: false,
         error: "The workspace is not available right now. Try again in a moment.",
-        data: { noClient: true }
+        data: { noClient: true, code: "unavailable" }
       };
     }
     const id = crypto.randomUUID();
@@ -20266,7 +20370,8 @@ ${resultContent}${attachmentSummary}`;
       state.openTimer = setTimeout(() => {
         resolve({
           ok: false,
-          error: `The client did not accept the ${request.tool} stream within ${Math.round(timeoutMs / 1e3)}s.`
+          error: `The client did not accept the ${request.tool} stream within ${Math.round(timeoutMs / 1e3)}s.`,
+          code: "timeout"
         });
       }, timeoutMs);
       try {
@@ -20281,7 +20386,8 @@ ${resultContent}${attachmentSummary}`;
       } catch (error) {
         resolve({
           ok: false,
-          error: `Failed to reach the client: ${error instanceof Error ? error.message : String(error)}`
+          error: `Failed to reach the client: ${error instanceof Error ? error.message : String(error)}`,
+          code: "unavailable"
         });
       }
     });
@@ -20294,7 +20400,11 @@ ${resultContent}${attachmentSummary}`;
       this.clientStreams.delete(id);
       state.settled = true;
       settleDone({ ok: false, error: openResult.error });
-      return { ok: false, error: openResult.error ?? "Stream open failed." };
+      return {
+        ok: false,
+        error: openResult.error ?? "Stream open failed.",
+        data: openResult.code ? { code: openResult.code } : void 0
+      };
     }
     const sendChunked = (bytes) => {
       for (let i = 0; i < bytes.length; i += CLIENT_STREAM_CHUNK_BYTES) {
@@ -20338,8 +20448,14 @@ ${resultContent}${attachmentSummary}`;
   async proxyStreamOpen(request) {
     const opened = await this.openClientStream(request);
     if (!opened.ok) {
-      const noClient = !!(opened.data && opened.data.noClient);
-      return { ok: false, error: opened.error, noClient };
+      const failureData = opened.data;
+      const noClient = failureData?.noClient === true;
+      return {
+        ok: false,
+        error: opened.error,
+        noClient,
+        code: failureData?.code
+      };
     }
     const id = crypto.randomUUID();
     const duplex = opened.duplex;
@@ -20410,12 +20526,12 @@ ${resultContent}${attachmentSummary}`;
     }
   }
   /** Settle and remove a client stream exactly once. */
-  settleClientStream(id, result) {
+  settleClientStream(id, result, openCode) {
     const state = this.clientStreams.get(id);
     if (!state) return;
     this.clientStreams.delete(id);
     if (state.openTimer) clearTimeout(state.openTimer);
-    if (state.opened) state.opened({ ok: false, error: result.error ?? "Stream closed." });
+    if (state.opened) state.opened({ ok: false, error: result.error ?? "Stream closed.", code: openCode });
     if (!state.settled) {
       state.settled = true;
       try {
@@ -20459,7 +20575,7 @@ ${resultContent}${attachmentSummary}`;
       }
       case "stream_error": {
         const error = typeof parsed.error === "string" ? parsed.error : "Client stream error.";
-        this.settleClientStream(id, { ok: false, error });
+        this.settleClientStream(id, { ok: false, error }, "refused");
         return;
       }
       case "stream_data": {
@@ -20486,7 +20602,7 @@ ${resultContent}${attachmentSummary}`;
   failClientStreamsForSocket(ws) {
     for (const [id, state] of Array.from(this.clientStreams.entries())) {
       if (state.socket === ws) {
-        this.settleClientStream(id, { ok: false, error: "The client connection was lost." });
+        this.settleClientStream(id, { ok: false, error: "The client connection was lost." }, "unavailable");
       }
     }
   }
@@ -26513,6 +26629,6 @@ init_context();
 init_ProviderRegistry();
 init_types2();
 
-export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, DurableUserHub, FlowStateSdk, NamespaceResolutionError, ProviderRegistry, ThreadWatchdog, authenticate, buildImageDescription, cat, createNamespaceContext, createThreadEndpointHandler, defineController2 as defineController, 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 { CLIENT_STREAM_CHUNK_BYTES, CodeExecutionBridge, DurableAgentBuilder, DurableThread, DurableUserHub, FlowStateSdk, NamespaceResolutionError, ProviderRegistry, ThreadWatchdog, authenticate, buildImageDescription, callClient, callClientStream, cat, createNamespaceContext, createThreadEndpointHandler, decodeStreamChunk, defineController2 as defineController, emitThreadEvent, encodeStreamChunk, 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, supportsClientForwarding, tail, unlink, updateThread, writeFile, writeImage };
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map