@standardagents/builder 0.38.1 → 0.39.0

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-import { j as AuthContext, e as ThreadEnv, w as Agent, y as ThreadMetadata, z as ToolResult, M as Message, o as ClientToolRequest, p as ClientToolResponse, q as ClientStreamRequest, t as ClientStreamResponse, H as FileRecord, V as SkillStorageScope, F as FlowState, N as FileStats, K as GrepResult, J as AttachmentRef, U as MessageContent, G as Env, x as ThreadInstance } from './index-CF-lgN47.js';
-export { A as AuthUser, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, u as ClientDuplex, v as ClientForwarding, B as Controller, a as ControllerContext, D as FlowResult, P as ImageContentPart, I as ImageMetadata, L as LLMResponse, Q as MultimodalContent, R as RequestContext, S as StorageBackend, E as TelemetryEvent, O as TextContentPart, b as ThreadEndpointContext, T as ToolCall, 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';
+import { j as AuthContext, e as ThreadEnv, w as Agent, y as ThreadMetadata, z as ToolResult, M as Message, o as ClientToolRequest, p as ClientToolResponse, q as ClientStreamRequest, t as ClientStreamResponse, H as FileRecord, V as SkillStorageScope, F as FlowState, N as FileStats, K as GrepResult, J as AttachmentRef, U as MessageContent, G as Env, x as ThreadInstance } from './index-yIcqf7DC.js';
+export { A as AuthUser, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, u as ClientDuplex, v as ClientForwarding, B as Controller, a as ControllerContext, D as FlowResult, P as ImageContentPart, I as ImageMetadata, L as LLMResponse, Q as MultimodalContent, R as RequestContext, S as StorageBackend, E as TelemetryEvent, O as TextContentPart, b as ThreadEndpointContext, T as ToolCall, 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';
 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';

package/dist/runtime.js

@@ -4274,6 +4274,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);
@@ -4789,15 +4807,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)"}.`
               };
             }
           }
@@ -4838,7 +4861,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;
@@ -5416,6 +5439,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
@@ -8962,7 +9006,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;
@@ -9176,12 +9221,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";