@standardagents/builder 0.38.1 → 0.39.0

package/dist/{index-CF-lgN47.d.ts → index-yIcqf7DC.d.ts}

@@ -533,7 +533,13 @@ interface PromptToolConfig {
  * Subagent tool configuration for dual_ai agent invocation.
  */
 interface SubagentToolConfig {
+    /** Exposed tool name — the name the model invokes this subagent by. */
     name: string;
+    /**
+     * The `dual_ai` agent this tool invokes when exposed under a different
+     * name. Defaults to `name`. Mirrors spec `SubagentToolConfig.agent`.
+     */
+    agent?: string;
     blocking?: boolean;
     initUserMessageProperty?: string;
     initAttachmentsProperty?: string;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ModelDefinition, AgentDefinition } from './runtime.js';
 export { AgentBuilderEnv, AgentBuilderEvent, BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, DurableUserHub, FlowStateSdk, FlowStateWithSdk, HubClientInfo, ImageContextConfig, InjectMessageOptions, LLMProviderInterface, NamespaceResolutionError, PromptContent, PromptDefinition, PromptIncludePart, PromptPart, PromptToolConfig, Provider, ProviderContentPart, ProviderFilePart, ProviderImagePart, ProviderRegistry, ProviderTextPart, SessionToolBinding, SessionToolConfig, SideConfig, SubagentToolConfig, SubpromptConfig, ThreadEventPayload, ThreadRegistryEntry, ThreadWatchdog, ThreadWatchdogState, ToolConfig, UpdateThreadParams, User, WatchdogCheckin, WatchdogProbeResult, applyRuntimeCors, buildImageDescription, canAccessThread, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateImageDescription, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isAdminOnlyApiRoute, isHostedInstance, isPublicApiRoute, isQualifiedName, isSameOriginBrowserRequest, isTrustedLocalDevelopmentRequest, linkFile, mkdir, move, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, rename, replaceImagesWithDescriptions, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, runtimeCorsHeaders, runtimePreflightResponse, stat, tail, unlink, updateThread, writeFile, writeImage } from './runtime.js';
 export { AgentPluginOptions, agentbuilder, builder } from './plugin.js';
-export { w as Agent, J as AttachmentRef, j as AuthContext, A as AuthUser, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, u as ClientDuplex, v as ClientForwarding, q as ClientStreamRequest, t as ClientStreamResponse, o as ClientToolRequest, p as ClientToolResponse, B as Controller, a as ControllerContext, G as Env, H as FileRecord, N as FileStats, D as FlowResult, F as FlowState, K as GrepResult, P as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, U as MessageContent, Q as MultimodalContent, R as RequestContext, S as StorageBackend, E as TelemetryEvent, O as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, x as ThreadInstance, y as ThreadMetadata, T as ToolCall, z as ToolResult, g as authenticate, k as callClient, l as callClientStream, c as createThreadEndpointHandler, n as decodeStreamChunk, d as defineController, m as encodeStreamChunk, i as endpointCallerFromAuth, h as requireAdmin, r as requireAuth, s as supportsClientForwarding } from './index-CF-lgN47.js';
+export { w as Agent, J as AttachmentRef, j as AuthContext, A as AuthUser, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, u as ClientDuplex, v as ClientForwarding, q as ClientStreamRequest, t as ClientStreamResponse, o as ClientToolRequest, p as ClientToolResponse, B as Controller, a as ControllerContext, G as Env, H as FileRecord, N as FileStats, D as FlowResult, F as FlowState, K as GrepResult, P as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, U as MessageContent, Q as MultimodalContent, R as RequestContext, S as StorageBackend, E as TelemetryEvent, O as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, x as ThreadInstance, y as ThreadMetadata, T as ToolCall, z as ToolResult, g as authenticate, k as callClient, l as callClientStream, c as createThreadEndpointHandler, n as decodeStreamChunk, d as defineController, m as encodeStreamChunk, i as endpointCallerFromAuth, h as requireAdmin, r as requireAuth, s as supportsClientForwarding } from './index-yIcqf7DC.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

@@ -4283,6 +4283,24 @@ var init_ToolExecutor = __esm({
           }
         } catch {
         }
+        const aliasTarget = this.subagentAliasTarget(state, toolName);
+        if (aliasTarget) {
+          if (packageId) {
+            try {
+              const qualified = aliasTarget.includes("/") ? aliasTarget : `${packageId}/${aliasTarget}`;
+              if (await state.thread.instance.loadAgent(qualified)) {
+                return "agent";
+              }
+            } catch {
+            }
+          }
+          try {
+            if (await state.thread.instance.loadAgent(aliasTarget)) {
+              return "agent";
+            }
+          } catch {
+          }
+        }
         const isInToolsArray = (agentName) => {
           const tools2 = state.prompt._tools || [];
           return tools2.some((t) => typeof t === "string" ? t === agentName : t.name === agentName);
@@ -4798,15 +4816,20 @@ Message one with subagent_message(referenceId, message).`
           const builtinCreateAttachmentValue = createArgs?.attachments;
           const builtinCreateInitialArguments = createArgs?.initialArguments ?? {};
           const registryAgentName = targetAgentForCreate || call.function.name;
+          const aliasConfig = this.resolveSubagentToolConfig(state, registryAgentName);
+          const implementingAgentName = typeof aliasConfig.agent === "string" && aliasConfig.agent.trim().length > 0 ? aliasConfig.agent.trim() : registryAgentName;
           const packageId = getPackageId(state);
           let agentDef = null;
-          let agentName = registryAgentName;
+          let agentName = implementingAgentName;
           if (builtinSubagentAction === "create" && targetAgentForCreate) {
             const availableSubagents = await this.getPromptSubagentNames(state);
             if (!availableSubagents.includes(targetAgentForCreate)) {
+              const configuredDirect = (state.prompt._tools || []).some(
+                (t) => typeof t === "string" ? t === targetAgentForCreate : t?.name === targetAgentForCreate
+              );
               return {
                 status: "error",
-                error: `Subagent "${targetAgentForCreate}" is not available for this prompt. Use one of: ${availableSubagents.join(", ") || "(none)"}.`
+                error: configuredDirect ? `"${targetAgentForCreate}" is not a resumable subagent \u2014 call the ${targetAgentForCreate} tool directly; it runs to completion and returns its result in the tool response. subagent_create manages resumable subagents only: ${availableSubagents.join(", ") || "(none)"}.` : `Subagent "${targetAgentForCreate}" is not available for this prompt. Use one of: ${availableSubagents.join(", ") || "(none)"}.`
               };
             }
           }
@@ -4847,7 +4870,7 @@ Message one with subagent_message(referenceId, message).`
           if (agentType === "ai_human") {
             const parentToolConfigs = state.prompt._tools || [];
             const toolConfig = parentToolConfigs.find(
-              (t) => typeof t === "string" ? t === agentName : t.name === agentName
+              (t) => typeof t === "string" ? t === registryAgentName || t === agentName : t.name === registryAgentName || t.name === agentName
             );
             const subpromptToolConfig = this.getSubpromptToolConfig(toolConfig);
             const targetState = state.rootState || state;
@@ -5425,6 +5448,27 @@ Message one with subagent_message(referenceId, message).`
         }
         return null;
       }
+      /**
+       * The implementing agent behind an aliased subagent tool name, or null when
+       * the name carries no alias (`agent` absent, empty, or equal to the name).
+       */
+      static subagentAliasTarget(state, toolName) {
+        for (const tool of state.prompt._tools || []) {
+          if (!tool || typeof tool !== "object" || tool.name !== toolName) {
+            continue;
+          }
+          const target = tool.agent;
+          if (typeof target === "string" && target.trim().length > 0 && target.trim() !== toolName) {
+            return target.trim();
+          }
+        }
+        return null;
+      }
+      /**
+       * Resolve the prompt's subagent tool config for an EXPOSED tool name.
+       * Config entries are keyed by `name` (the model-facing tool name), which
+       * may alias a differently-named implementing agent via `agent`.
+       */
       static resolveSubagentToolConfig(state, agentName) {
         const config = (state.prompt._tools || []).find(
           (tool) => typeof tool === "string" ? tool === agentName : tool.name === agentName
@@ -8971,7 +9015,8 @@ ${msg.content}` : `${imageDescriptions}${nonImageList}`;
                   }
                   if (foundToolNames.has(toolName)) continue;
                   try {
-                    const agentDef = await state.thread.instance.loadAgent(toolName);
+                    const implementingAgent = subagentConfig && typeof subagentConfig.agent === "string" && subagentConfig.agent.trim().length > 0 ? subagentConfig.agent.trim() : toolName;
+                    const agentDef = await state.thread.instance.loadAgent(implementingAgent);
                     if (agentDef && (agentDef.type === "ai_human" || agentDef.type === "dual_ai")) {
                       let parameters;
                       const sideAPromptName = agentDef.sideA?.prompt;
@@ -9185,12 +9230,14 @@ ${msg.content}` : `${imageDescriptions}${nonImageList}`;
           if (!toolName || toolName.startsWith("provider:") || seen.has(toolName)) {
             continue;
           }
-          const agentDef = await this.tryLoadPromptToolAgent(state, toolName, packageId);
+          const subagentConfigForLoad = this.isSubagentToolConfig(configEntry) ? configEntry : void 0;
+          const implementingAgent = subagentConfigForLoad && typeof subagentConfigForLoad.agent === "string" && subagentConfigForLoad.agent.trim().length > 0 ? subagentConfigForLoad.agent.trim() : toolName;
+          const agentDef = await this.tryLoadPromptToolAgent(state, implementingAgent, packageId);
           if (!agentDef || agentDef.type !== "dual_ai") {
             continue;
           }
           seen.add(toolName);
-          const subagentConfig = this.isSubagentToolConfig(configEntry) ? configEntry : void 0;
+          const subagentConfig = subagentConfigForLoad;
           const blocking = subagentConfig?.blocking ?? true;
           const resumable = !!subagentConfig?.resumable && typeof subagentConfig.resumable === "object";
           const receivesMessages = subagentConfig?.resumable && typeof subagentConfig.resumable === "object" ? subagentConfig.resumable.receives_messages : "side_a";
@@ -22694,7 +22741,10 @@ ${packedThreadRouteCode}
     // across requests.
     let threadAccess = null;
 
-    // Require authentication for all API routes except public ones
+    // Require authentication for all API routes except public ones.
+    // WebSocket tickets are single-use and are consumed here. Controllers
+    // must reuse context.auth (resolveRequestAuth) rather than calling
+    // requireAuth again, or a ticket-only upgrade will 401.
     if (isApiRoute && !publicRoute) {
       const authResult = await requireAuth(request, env);