@standardagents/builder 0.27.2 → 0.27.4

package/dist/{index-DJ7B8CTp.d.ts → index-DReIS8eP.d.ts}

@@ -262,6 +262,7 @@ interface ThreadInstance {
     hooks(): HookRegistry;
     getValue<T = unknown>(key: string): Promise<T | null>;
     setValue(key: string, value: unknown): Promise<void>;
+    emitThreadEvent?(threadId: string, event: string, data: unknown): void | Promise<void>;
     callClientTool?(request: ClientToolRequest): Promise<ClientToolResponse>;
     registerCodeExecutionBridge?(runId: string, bridge: {
         call(functionId: string, encodedArgs: unknown[]): Promise<unknown>;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ModelDefinition, AgentDefinition } from './runtime.js';
 export { AgentBuilderEnv, AuthContext, AuthUser, BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, FlowStateSdk, FlowStateWithSdk, ImageContextConfig, InjectMessageOptions, LLMProviderInterface, NamespaceResolutionError, PromptContent, PromptDefinition, PromptIncludePart, PromptPart, PromptToolConfig, Provider, ProviderContentPart, ProviderFilePart, ProviderImagePart, ProviderRegistry, ProviderTextPart, SessionToolBinding, SessionToolConfig, SideConfig, SubagentToolConfig, SubpromptConfig, ThreadRegistryEntry, ThreadWatchdog, ThreadWatchdogState, ToolConfig, UpdateThreadParams, User, WatchdogCheckin, 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 } from './runtime.js';
 export { AgentPluginOptions, agentbuilder, builder } from './plugin.js';
-export { A as Agent, m as AttachmentRef, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, E as Env, l as FileRecord, n as FileStats, j as FlowResult, F as FlowState, G as GrepResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, r as MessageContent, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, g as ThreadInstance, h as ThreadMetadata, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-DJ7B8CTp.js';
+export { A as Agent, m as AttachmentRef, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, E as Env, l as FileRecord, n as FileStats, j as FlowResult, F as FlowState, G as GrepResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, r as MessageContent, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, g as ThreadInstance, h as ThreadMetadata, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-DReIS8eP.js';
 export { AgentType, DefinitionLoader, GlobalNamespaceContext, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, NamespaceContext, PackageSignature, PackedExports, PackedMeta, PackedMetadata, PackedNamespaceContext, PromptInput, PromptTextPart, ProviderAssistantMessage, ProviderConfigSlot, ProviderConfigSlots, ProviderConfigValueSource, ProviderDefinition, ProviderError, ProviderErrorCode, ProviderFactory, ProviderFactoryConfig, ProviderFinishReason, ProviderGeneratedImage, ProviderMessage, ProviderMessageContent, ProviderMethodOverrides, ModelCapabilities as ProviderModelCapabilities, ProviderOverride, ProviderOverrideContext, ProviderReasoningDetail, ProviderRequest, ProviderResponse, ProviderStreamChunk, ProviderSyncOverride, ProviderSystemMessage, ProviderTool, ProviderToolCallPart, ProviderToolMessage, ProviderToolResultContent, ProviderUsage, ProviderUserMessage, ReasoningConfig, StructuredPrompt, TextContent, Tool, ToolArgs, ToolArgsNode, ToolArgsRawShape, ToolContent, belongsToPackage, defineAgent, defineHook, defineModel, definePrompt, defineProvider, defineTool, isPacked, isVisibleInNamespace, mapReasoningLevel, providerConst, providerEnv, providerValue } from '@standardagents/spec';
 export { C as ConstituentItem, D as DiscoveredPackage, N as NamespacedRegistry, P as PackingAnalysis, a as PackingOptions, b as PackingResult, c as UnpackOptions, d as UnpackResult } from './types-Bpe7IANZ.js';
 export { D as DiscoveryConfig, P as PackageDiscoveryService, d as discoverPackages } from './discovery-DiMJWisl.js';

package/dist/index.js

@@ -12703,6 +12703,7 @@ var init_ThreadStateImpl = __esm({
       _executionState = null;
       _childrenCache = [];
       _terminatedCache = null;
+      _pendingEventDeliveries = /* @__PURE__ */ new Set();
       constructor(flowState, threadInstance, metadata, runtimeContext = {}) {
         this._flowState = flowState;
         this._threadInstance = threadInstance;
@@ -13154,6 +13155,22 @@ var init_ThreadStateImpl = __esm({
       emit(event, data) {
         if (this._flowState?.emitEvent) {
           this._flowState.emitEvent(event, data);
+          return;
+        }
+        if (this._threadInstance.emitThreadEvent) {
+          const delivery = this._threadInstance.emitThreadEvent(this.threadId, event, data);
+          if (delivery && typeof delivery.then === "function") {
+            const pending = Promise.resolve(delivery).catch((error) => {
+              console.error(`[ThreadState] Custom event "${event}" delivery failed:`, error);
+            }).finally(() => this._pendingEventDeliveries.delete(pending));
+            this._pendingEventDeliveries.add(pending);
+          }
+        }
+      }
+      /** Runtime-only drain used by thread endpoint wrappers before responding. */
+      async flushPendingEventDeliveries() {
+        while (this._pendingEventDeliveries.size > 0) {
+          await Promise.all([...this._pendingEventDeliveries]);
         }
       }
       // ─────────────────────────────────────────────────────────────────────────
@@ -21399,7 +21416,11 @@ ${packedThreadRouteCode}
       authContext = authResult;
 
       if (routePath.startsWith('/api/threads/')) {
-        const threadId = routeMatch.params?.id || routeMatch.params?.threadId;
+        // Packed and user thread endpoints reserve threadId for the owning
+        // thread while nested endpoint parameters may also be named id.
+        // Prefer the explicit thread parameter so /pending/:id and similar
+        // routes authorize against the thread instead of the nested resource.
+        const threadId = routeMatch.params?.threadId || routeMatch.params?.id;
         if (threadId) {
           const agentBuilderId = env.AGENT_BUILDER.idFromName('singleton');
           const agentBuilder = env.AGENT_BUILDER.get(agentBuilderId);
@@ -22230,7 +22251,9 @@ function createThreadEndpointHandler(handler) {
         }
         endpointParams[key === "_" ? "*" : key] = value;
       }
-      return await handler(req, threadState, endpointParams);
+      const response = await handler(req, threadState, endpointParams);
+      await threadState.flushPendingEventDeliveries();
+      return response;
     } catch (error) {
       console.error(`Error in thread endpoint for ${threadId}:`, error);
       return Response.json(
@@ -28341,6 +28364,9 @@ ${resultContent}${attachmentSummary}`;
    * Broadcast a custom event to all connected message WebSocket clients
    * Used by tools via emitThreadEvent() to send user-defined events
    */
+  emitThreadEvent(_threadId, type, data) {
+    this.broadcastEvent(type, data);
+  }
   broadcastEvent(type, data) {
     const payload = JSON.stringify({
       type: "event",