@standardagents/builder 0.9.13 → 0.9.15

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 export { AgentPluginOptions, agentbuilder } from './plugin.js';
 import { DurableObjectStorage } from '@cloudflare/workers-types';
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { z, ZodString, ZodNumber, ZodBoolean, ZodNull, ZodLiteral, ZodEnum, ZodOptional, ZodNullable, ZodDefault, ZodArray, ZodObject, ZodRecord, ZodUnion } from 'zod';
 import { DurableObject } from 'cloudflare:workers';
 import 'vite';
@@ -145,6 +144,19 @@ declare class StreamManager {
     forceClose(): void;
 }
 
+/**
+ * Content item types that can be returned by tools
+ */
+interface TextContent {
+    type: "text";
+    text: string;
+}
+interface ImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+type ToolContent = TextContent | ImageContent;
 /** Decrement helper to stop recursion at depth 0 */
 type Dec<N extends number> = N extends 10 ? 9 : N extends 9 ? 8 : N extends 8 ? 7 : N extends 7 ? 6 : N extends 6 ? 5 : N extends 5 ? 4 : N extends 4 ? 3 : N extends 3 ? 2 : N extends 2 ? 1 : N extends 1 ? 0 : 0;
 /**
@@ -168,7 +180,7 @@ type StructuredToolReturn = ToolArgs;
 /**
  * Defines a tool function. Tools accept the current flow state as well as the arguments being passed to them.
  */
-type Tool<Args extends ToolArgs | null = null> = Args extends ToolArgs ? (flow: FlowState, args: z.infer<Args>) => Promise<CallToolResult> : (flow: FlowState) => Promise<CallToolResult>;
+type Tool<Args extends ToolArgs | null = null> = Args extends ToolArgs ? (flow: FlowState, args: z.infer<Args>) => Promise<ToolResult> : (flow: FlowState) => Promise<ToolResult>;
 /**
  * @param toolDescription - Description of what the tool does.
  * @param args - The arguments for the tool.
@@ -338,6 +350,11 @@ interface ThreadInstance {
     shouldStop(): Promise<boolean>;
     tools(): Record<string, () => Promise<ReturnType<typeof defineTool>>>;
     hooks(): HookRegistry;
+    loadModel(name: string): Promise<any>;
+    loadPrompt(name: string): Promise<any>;
+    loadAgent(name: string): Promise<any>;
+    getPromptNames(): string[];
+    getAgentNames(): string[];
 }
 /**
  * Tool call for internal flow management
@@ -659,12 +676,31 @@ interface LogData {
 interface ThreadEnv {
     AGENT_BUILDER_THREAD: DurableObjectNamespace<Rpc.DurableObjectBranded>;
     AGENT_BUILDER: DurableObjectNamespace<Rpc.DurableObjectBranded>;
+    [key: string]: unknown;
 }
+/**
+ * Virtual module registry types (injected at runtime by plugin)
+ */
+type VirtualModuleLoader<T> = () => Promise<T>;
+type VirtualModuleRegistry<T> = Record<string, VirtualModuleLoader<T>>;
+/**
+ * Controller context passed to route handlers.
+ * Includes optional virtual module registries that are injected at runtime.
+ */
 interface ControllerContext<Env = any> {
     req: Request;
     params: Record<string, string>;
     env: Env;
     url: URL;
+    agents?: VirtualModuleRegistry<unknown>;
+    agentNames?: string[];
+    prompts?: VirtualModuleRegistry<unknown>;
+    promptNames?: string[];
+    models?: VirtualModuleRegistry<unknown>;
+    modelNames?: string[];
+    tools?: VirtualModuleRegistry<unknown>;
+    hooks?: VirtualModuleRegistry<unknown>;
+    config?: Record<string, unknown>;
 }
 type Controller<Env = any> = (context: ControllerContext<Env>) => string | Promise<string> | Response | Promise<Response> | ReadableStream | Promise<ReadableStream> | null | Promise<null> | void | Promise<void> | Promise<object> | object;
 interface ThreadEndpointContext {
@@ -1518,8 +1554,9 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
  * - `openrouter` → `OPENROUTER_API_KEY`
  * - `anthropic` → `ANTHROPIC_API_KEY`
  * - `google` → `GOOGLE_API_KEY`
+ * - `test` → No API key required (for testing with scripted responses)
  */
-type ModelProvider = 'openai' | 'openrouter' | 'anthropic' | 'google';
+type ModelProvider = 'openai' | 'openrouter' | 'anthropic' | 'google' | 'test';
 /**
  * Model definition configuration.
  *
@@ -2985,4 +3022,4 @@ declare class GitHubApiError extends Error {
     constructor(message: string, status: number, details?: unknown);
 }
 
-export { type Agent, type AgentBuilderEnv, type AgentDefinition, type AgentType, type AuthContext, type AuthUser, type BroadcastOptions, type Controller, type ControllerContext, DurableAgentBuilder, DurableThread, type FlowResult, type FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, type HookSignatures, type InjectMessageOptions$1 as InjectMessageOptions, type LLMResponse, type Message, type ModelDefinition, type ModelProvider, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptInput, type PromptPart, type PromptTextPart, type Provider, type ReasoningConfig, type RequestContext, type SideConfig, type StructuredPrompt, type StructuredToolReturn, type TelemetryEvent, type ThreadEndpointContext, type ThreadEnv, type ThreadInstance, type ThreadMetadata, type ThreadRegistryEntry, type Tool, type ToolArgs, type ToolArgsNode, type ToolArgsRawShape, type ToolCall, type ToolConfig, type ToolResult, type UpdateThreadParams, type User, authenticate, defineAgent, defineController, defineHook, defineModel, definePrompt, defineThreadEndpoint, defineTool, emitThreadEvent, enhanceFlowState, forceTurn, generateAgentFile, generateModelFile, generatePromptFile, getMessages, injectMessage, queueTool, reloadHistory, requireAdmin, requireAuth, updateThread };
+export { type Agent, type AgentBuilderEnv, type AgentDefinition, type AgentType, type AuthContext, type AuthUser, type BroadcastOptions, type Controller, type ControllerContext, DurableAgentBuilder, DurableThread, type FlowResult, type FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, type HookSignatures, type ImageContent, type InjectMessageOptions$1 as InjectMessageOptions, type LLMResponse, type Message, type ModelDefinition, type ModelProvider, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptInput, type PromptPart, type PromptTextPart, type Provider, type ReasoningConfig, type RequestContext, type SideConfig, type StructuredPrompt, type StructuredToolReturn, type TelemetryEvent, type TextContent, type ThreadEndpointContext, type ThreadEnv, type ThreadInstance, type ThreadMetadata, type ThreadRegistryEntry, type Tool, type ToolArgs, type ToolArgsNode, type ToolArgsRawShape, type ToolCall, type ToolConfig, type ToolContent, type ToolResult, type UpdateThreadParams, type User, authenticate, defineAgent, defineController, defineHook, defineModel, definePrompt, defineThreadEndpoint, defineTool, emitThreadEvent, enhanceFlowState, forceTurn, generateAgentFile, generateModelFile, generatePromptFile, getMessages, injectMessage, queueTool, reloadHistory, requireAdmin, requireAuth, updateThread };