@standardagents/builder 0.11.2 → 0.11.4

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { AgentPluginOptions, agentbuilder } from './plugin.js';
 import { DurableObjectStorage } from '@cloudflare/workers-types';
 import { ZodObject, ZodRawShape } from 'zod';
-import { ToolResult as ToolResult$1, HookSignatures, AgentDefinition as AgentDefinition$1, ControllerContext, Controller, ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, SubpromptConfig as SubpromptConfig$2, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart } from '@standardagents/spec';
+import { ToolResult as ToolResult$1, HookSignatures, AgentDefinition as AgentDefinition$1, ControllerContext, Controller, ThreadEndpointHandler, ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, SubpromptConfig as SubpromptConfig$2, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart } from '@standardagents/spec';
 export { AgentType, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, 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, defineAgent, defineHook, defineModel, definePrompt, defineTool, mapReasoningLevel } from '@standardagents/spec';
 import { DurableObject } from 'cloudflare:workers';
 import 'vite';
@@ -1006,6 +1006,7 @@ interface BuilderControllerContext<Env extends ThreadEnv = ThreadEnv> extends Om
 type BuilderController<Env extends ThreadEnv = ThreadEnv> = (context: BuilderControllerContext<Env>) => ReturnType<Controller>;
 /**
  * Thread endpoint context with access to thread instance and metadata.
+ * @deprecated Use ThreadState instead
  */
 interface ThreadEndpointContext {
     req: Request;
@@ -1017,46 +1018,14 @@ interface ThreadEndpointContext {
 /**
  * Handler function for builder thread endpoints.
  *
- * Unlike the spec's ThreadEndpointHandler which receives ThreadState,
- * the builder's handler receives direct access to the Durable Object
- * instance and thread metadata. This allows for lower-level operations
- * like calling RPC methods directly on the instance.
- */
-type BuilderThreadEndpointHandler = (req: Request, context: {
-    instance: ThreadInstance;
-    metadata: ThreadMetadata;
-}) => Response | Promise<Response>;
-/**
- * Define a thread-specific endpoint with access to the Durable Object instance.
- *
- * This is the builder's version of defineThreadEndpoint. It provides direct
- * access to the thread's Durable Object instance and metadata, allowing
- * for lower-level operations like calling RPC methods directly.
+ * Receives the request and a ThreadState object per the Standard Agents spec.
+ * The ThreadState provides access to thread identity, messages, logs,
+ * resource loading, tool invocation, and more.
  *
- * @param handler - Function that receives the request and thread context
- * @returns A Controller that can be used with the router
- *
- * @example
- * ```typescript
- * import { defineThreadEndpoint } from '@standardagents/builder';
- *
- * export default defineThreadEndpoint(async (req, { instance, metadata }) => {
- *   // Access thread metadata
- *   console.log('Thread ID:', metadata.id);
- *   console.log('Agent ID:', metadata.agent_id);
- *
- *   // Call RPC methods on the Durable Object instance
- *   const messagesResult = await instance.getMessages();
- *   const logs = await instance.getLogs();
- *
- *   return Response.json({
- *     messageCount: messagesResult.messages.length,
- *     logCount: logs.length,
- *   });
- * });
- * ```
+ * Note: `state.execution` is always null in endpoints since the thread
+ * is not actively executing.
  */
-declare function defineThreadEndpoint(handler: BuilderThreadEndpointHandler): BuilderController;
+type BuilderThreadEndpointHandler = ThreadEndpointHandler;
 
 /**
  * Define a controller with typed Cloudflare environment bindings.
@@ -1075,6 +1044,25 @@ declare function defineThreadEndpoint(handler: BuilderThreadEndpointHandler): Bu
  * ```
  */
 declare function defineController<Env extends ThreadEnv = ThreadEnv>(controller: BuilderController<Env>): BuilderController<Env>;
+/**
+ * Runtime implementation for defineThreadEndpoint.
+ *
+ * This wraps the spec's defineThreadEndpoint to provide the actual
+ * thread lookup and ThreadState creation at runtime.
+ *
+ * @param handler - Function that receives the request and ThreadState
+ * @returns A Controller that can be used with the router
+ *
+ * @example
+ * // agentbuilder/api/threads/[id]/status.get.ts
+ * import { defineThreadEndpoint } from '@standardagents/spec';
+ *
+ * export default defineThreadEndpoint(async (req, state) => {
+ *   const { messages } = await state.getMessages({ limit: 1 });
+ *   return Response.json({ status: "ok", messageCount: messages.length });
+ * });
+ */
+declare function createThreadEndpointHandler<Env extends ThreadEnv = ThreadEnv>(handler: ThreadEndpointHandler): BuilderController<Env>;
 
 /**
  * Authentication middleware for protecting API routes
@@ -3654,4 +3642,4 @@ type ProviderImagePart = ImagePart;
 /** @public Alias for FilePart */
 type ProviderFilePart = FilePart;
 
-export { type Agent, type AgentBuilderEnv, type AgentDefinition, type AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, type BuilderThreadEndpointHandler, type BuilderController as Controller, type BuilderControllerContext as ControllerContext, DurableAgentBuilder, DurableThread, type Env, type FileRecord, type FileStats, type FlowResult, type FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, type GrepResult, type ImageContentPart, type ImageContextConfig, type ImageMetadata, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, type LLMResponse, type Message, type MessageContent, type ModelDefinition, type MultimodalContent, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, type ProviderTextPart, type RequestContext, type SideConfig, type StorageBackend, type SubpromptConfig, type TelemetryEvent, type TextContentPart, type ThreadEndpointContext, type ThreadEnv, type ThreadInstance, type ThreadMetadata, type ThreadRegistryEntry, type ToolCall, type ToolConfig, type ToolResult, type UpdateThreadParams, type User, authenticate, buildImageDescription, cat, defineController, defineThreadEndpoint, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateAgentFile, generateImageDescription, generateModelFile, generatePromptFile, getFileStats, getMessages, getMessagesToSummarize, getThumbnail, getUnsummarizedImageAttachments, grep, hasImageAttachments, head, injectMessage, linkFile, mkdir, optimizeImageContext, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+export { type Agent, type AgentBuilderEnv, type AgentDefinition, type AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, type BuilderThreadEndpointHandler, type BuilderController as Controller, type BuilderControllerContext as ControllerContext, DurableAgentBuilder, DurableThread, type Env, type FileRecord, type FileStats, type FlowResult, type FlowState, FlowStateSdk, type FlowStateWithSdk, GitHubApiError, GitHubClient, type GitHubCommitResult, type GitHubConfig, type GitHubFileChange, type GrepResult, type ImageContentPart, type ImageContextConfig, type ImageMetadata, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, type LLMResponse, type Message, type MessageContent, type ModelDefinition, type MultimodalContent, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, type ProviderTextPart, type RequestContext, type SideConfig, type StorageBackend, type SubpromptConfig, type TelemetryEvent, type TextContentPart, type ThreadEndpointContext, type ThreadEnv, type ThreadInstance, type ThreadMetadata, type ThreadRegistryEntry, type ToolCall, type ToolConfig, type ToolResult, type UpdateThreadParams, type User, authenticate, buildImageDescription, cat, createThreadEndpointHandler, defineController, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateAgentFile, generateImageDescription, generateModelFile, generatePromptFile, getFileStats, getMessages, getMessagesToSummarize, getThumbnail, getUnsummarizedImageAttachments, grep, hasImageAttachments, head, injectMessage, linkFile, mkdir, optimizeImageContext, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };