@standardagents/builder 0.27.2 → 0.27.3

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]);
         }
       }
       // ─────────────────────────────────────────────────────────────────────────
@@ -22230,7 +22247,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 +28360,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",