@runtypelabs/sdk 1.17.0 → 1.18.0

package/README.md

@@ -98,7 +98,7 @@ const summary = await runtype
     { streamResponse: true },
     {
       onStepStart: (event) => console.log('Starting:', event.name),
-      onStepChunk: (chunk) => process.stdout.write(chunk),
+      onStepDelta: (text) => process.stdout.write(text),
       onStepComplete: (result, event) => console.log('Done:', event.name),
       onFlowComplete: (event) => console.log('Complete!'),
     }
@@ -184,7 +184,7 @@ const allResults = await flowResult.getAllResults()
 interface StreamCallbacks {
   onFlowStart?: (event: FlowStartEvent) => void
   onStepStart?: (event: StepStartEvent) => void
-  onStepChunk?: (chunk: string, event: StepChunkEvent) => void
+  onStepDelta?: (text: string, event: StepDeltaEvent) => void
   onStepComplete?: (result: any, event: StepCompleteEvent) => void
   onFlowComplete?: (event: FlowCompleteEvent) => void
   onError?: (error: Error) => void

package/dist/index.cjs

@@ -189,13 +189,9 @@ function handleEvent(event, callbacks, results, summary) {
     case "step_start":
       callbacks.onStepStart?.(event);
       break;
-    case "step_delta": {
-      const chunkText = event.chunk || event.text || "";
-      const deltaEvent = event;
-      callbacks.onStepDelta?.(chunkText, deltaEvent);
-      callbacks.onStepChunk?.(chunkText, deltaEvent);
+    case "step_delta":
+      callbacks.onStepDelta?.(event.text, event);
       break;
-    }
     case "step_complete":
       results.set(event.name, event.result);
       callbacks.onStepComplete?.(event.result, event);
@@ -253,10 +249,6 @@ async function* streamEvents(response) {
       for (const eventStr of events) {
         try {
           const event = JSON.parse(eventStr);
-          if (event.type === "step_delta" && "text" in event && !("chunk" in event)) {
-            ;
-            event.chunk = event.text;
-          }
           yield event;
         } catch {
         }
@@ -266,10 +258,6 @@ async function* streamEvents(response) {
     if (finalEvent) {
       try {
         const event = JSON.parse(finalEvent);
-        if (event.type === "step_delta" && "text" in event && !("chunk" in event)) {
-          ;
-          event.chunk = event.text;
-        }
         yield event;
       } catch {
       }
@@ -379,7 +367,7 @@ var FlowResult = class {
    * ```typescript
    * const summary = await result.stream({
    *   onStepStart: (event) => console.log('Starting:', event.name),
-   *   onStepChunk: (chunk) => process.stdout.write(chunk),
+   *   onStepDelta: (text) => process.stdout.write(text),
    *   onStepComplete: (result, event) => console.log('Done:', event.name),
    *   onFlowComplete: (event) => console.log('Flow complete!'),
    * })
@@ -983,7 +971,7 @@ var RuntypeFlowBuilder = class {
           ...callbacks,
           onFlowStart: (event) => callbacks?.onFlowStart?.(event),
           onStepStart: (event) => callbacks?.onStepStart?.(event),
-          onStepChunk: (chunk, event) => callbacks?.onStepChunk?.(chunk, event),
+          onStepDelta: (text, event) => callbacks?.onStepDelta?.(text, event),
           onStepComplete: (result, event) => callbacks?.onStepComplete?.(result, event),
           onFlowComplete: (event) => callbacks?.onFlowComplete?.(event),
           onError: (error) => callbacks?.onError?.(error)
@@ -1013,11 +1001,9 @@ var RuntypeFlowBuilder = class {
               case "step_start":
                 wrappedCallbacks.onStepStart?.(event);
                 break;
-              case "step_delta": {
-                const chunkText = awaitEvent.chunk || awaitEvent.text || "";
-                wrappedCallbacks.onStepChunk?.(chunkText, event);
+              case "step_delta":
+                wrappedCallbacks.onStepDelta?.(event.text, event);
                 break;
-              }
               case "step_complete": {
                 accumulatedSummary.results?.set(event.name, event.result);
                 wrappedCallbacks.onStepComplete?.(event.result, event);
@@ -1467,7 +1453,7 @@ var PromptRunner = class {
    *
    * // Process with callbacks
    * await result.stream({
-   *   onStepChunk: (chunk) => process.stdout.write(chunk),
+   *   onStepDelta: (text) => process.stdout.write(text),
    *   onFlowComplete: () => console.log('Done!'),
    * })
    * ```
@@ -4376,6 +4362,15 @@ function dispatchAgentEvent(event, callbacks) {
     case "agent_tool_complete":
       callbacks.onToolComplete?.(typedData);
       break;
+    case "agent_media":
+      callbacks.onMedia?.(typedData);
+      break;
+    case "agent_approval_start":
+      callbacks.onApprovalStart?.(typedData);
+      break;
+    case "agent_approval_complete":
+      callbacks.onApprovalComplete?.(typedData);
+      break;
     case "agent_iteration_complete":
       callbacks.onIterationComplete?.(typedData);
       break;
@@ -7671,7 +7666,7 @@ var ClientFlowBuilder = class extends FlowBuilder {
 };
 function isStreamCallbacks(obj) {
   if (!obj || typeof obj !== "object") return false;
-  return "onFlowStart" in obj || "onStepStart" in obj || "onStepDelta" in obj || "onStepChunk" in obj || "onStepComplete" in obj || "onFlowComplete" in obj || "onError" in obj;
+  return "onFlowStart" in obj || "onStepStart" in obj || "onStepDelta" in obj || "onStepComplete" in obj || "onFlowComplete" in obj || "onError" in obj;
 }
 function createExternalTool(config) {
   return {
@@ -7786,7 +7781,7 @@ var RuntypeClient2 = class {
           ...callbacks,
           onFlowStart: (event) => callbacks?.onFlowStart?.(event),
           onStepStart: (event) => callbacks?.onStepStart?.(event),
-          onStepChunk: (chunk, event) => callbacks?.onStepChunk?.(chunk, event),
+          onStepDelta: (text, event) => callbacks?.onStepDelta?.(text, event),
           onStepComplete: (result, event) => callbacks?.onStepComplete?.(result, event),
           onFlowComplete: (event) => callbacks?.onFlowComplete?.(event),
           onError: (error) => callbacks?.onError?.(error)
@@ -7821,12 +7816,9 @@ var RuntypeClient2 = class {
               case "step_start":
                 wrappedCallbacks.onStepStart?.(event);
                 break;
-              case "step_delta": {
-                const deltaEvent = event;
-                const chunkText = deltaEvent.chunk || deltaEvent.text || "";
-                wrappedCallbacks.onStepChunk?.(chunkText, deltaEvent);
+              case "step_delta":
+                wrappedCallbacks.onStepDelta?.(event.text, event);
                 break;
-              }
               case "step_complete": {
                 summary.results?.set(event.name, event.result);
                 wrappedCallbacks.onStepComplete?.(event.result, event);

package/dist/index.d.cts

@@ -428,7 +428,7 @@ interface BuiltInTool {
     id: string;
     name: string;
     description: string;
-    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce';
+    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce' | 'browser';
     providers: string[];
     parametersSchema: JSONSchema;
     defaultConfig?: JsonObject;
@@ -1278,11 +1278,10 @@ interface StepStartEvent {
 interface StepDeltaEvent {
     type: 'step_delta';
     id: string;
-    chunk: string;
     index: number;
+    /** Streaming text fragment. */
+    text: string;
 }
-/** @deprecated Use StepDeltaEvent instead */
-type StepChunkEvent = StepDeltaEvent;
 interface StepCompleteEvent {
     type: 'step_complete';
     id: string;
@@ -1329,13 +1328,8 @@ interface StreamCallbacks {
     onFlowStart?: (event: FlowStartEvent) => void;
     /** Called when a step starts executing */
     onStepStart?: (event: StepStartEvent) => void;
-    /** Called for each chunk of streaming output from a step */
-    onStepDelta?: (chunk: string, event: StepDeltaEvent) => void;
-    /**
-     * @deprecated Use onStepDelta instead
-     * Called for each chunk of streaming output from a step
-     */
-    onStepChunk?: (chunk: string, event: StepDeltaEvent) => void;
+    /** Called for each text fragment of streaming output from a step */
+    onStepDelta?: (text: string, event: StepDeltaEvent) => void;
     /** Called when a step completes */
     onStepComplete?: (result: any, event: StepCompleteEvent) => void;
     /** Called when the entire flow completes */
@@ -1735,7 +1729,7 @@ declare function createExternalTool(config: {
  *
  * // Option 1: Process with callbacks
  * const summary = await result.stream({
- *   onStepChunk: (chunk) => process.stdout.write(chunk),
+ *   onStepDelta: (text) => process.stdout.write(text),
  * })
  *
  * // Option 2: Just get a specific step's result
@@ -1771,7 +1765,7 @@ declare class FlowResult {
      * ```typescript
      * const summary = await result.stream({
      *   onStepStart: (event) => console.log('Starting:', event.name),
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onStepComplete: (result, event) => console.log('Done:', event.name),
      *   onFlowComplete: (event) => console.log('Flow complete!'),
      * })
@@ -2232,7 +2226,7 @@ declare class RuntypeFlowBuilder {
      *
      * // Process with callbacks
      * await result.stream({
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onFlowComplete: () => console.log('Done!'),
      * })
      *
@@ -2769,7 +2763,7 @@ declare class PromptRunner {
      *
      * // Process with callbacks
      * await result.stream({
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onFlowComplete: () => console.log('Done!'),
      * })
      * ```
@@ -4116,7 +4110,7 @@ declare class ClientTokensEndpoint {
 /**
  * Agent event types for streaming
  */
-type AgentEventType = 'agent_start' | 'agent_iteration_start' | 'agent_turn_start' | 'agent_turn_delta' | 'agent_turn_complete' | 'agent_tool_start' | 'agent_tool_delta' | 'agent_tool_input_delta' | 'agent_tool_input_complete' | 'agent_tool_complete' | 'agent_iteration_complete' | 'agent_reflection' | 'agent_complete' | 'agent_error' | 'agent_ping' | 'agent_await';
+type AgentEventType = 'agent_start' | 'agent_iteration_start' | 'agent_turn_start' | 'agent_turn_delta' | 'agent_turn_complete' | 'agent_tool_start' | 'agent_tool_delta' | 'agent_tool_input_delta' | 'agent_tool_input_complete' | 'agent_tool_complete' | 'agent_media' | 'agent_approval_start' | 'agent_approval_complete' | 'agent_iteration_complete' | 'agent_reflection' | 'agent_complete' | 'agent_error' | 'agent_ping' | 'agent_await';
 /**
  * Base agent event with common fields
  */
@@ -4184,6 +4178,16 @@ interface AgentTurnCompleteEvent extends BaseAgentEvent {
         output: number;
     };
     cost?: number;
+    /**
+     * Per-model-invocation stop reason for this turn. `'max_tool_calls'`
+     * indicates a capped-mid-loop tool call (model cut off before producing
+     * follow-up text); `content` may be empty in that case. Omitted when
+     * the server didn't report one — treat absence as "not reported"
+     * (distinct from an explicit `'unknown'`).
+     *
+     * Mirrors `AgentTurnCompleteEvent.stopReason` in `@runtypelabs/shared`.
+     */
+    stopReason?: 'end_turn' | 'max_tool_calls' | 'length' | 'content_filter' | 'error' | 'unknown';
 }
 /**
  * Agent tool start event
@@ -4237,6 +4241,59 @@ interface AgentToolCompleteEvent extends BaseAgentEvent {
     result?: unknown;
     executionTime?: number;
 }
+interface AgentMediaEvent extends BaseAgentEvent {
+    type: 'agent_media';
+    iteration: number;
+    toolCallId: string;
+    toolName: string;
+    media: Array<{
+        type: 'media';
+        data: string;
+        mediaType: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    } | {
+        type: 'image-url';
+        url: string;
+        mediaType?: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    } | {
+        type: 'file-url';
+        url: string;
+        mediaType: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    }>;
+}
+/**
+ * Agent approval start event — execution paused waiting for user approval.
+ */
+interface AgentApprovalStartEvent extends BaseAgentEvent {
+    type: 'agent_approval_start';
+    approvalId: string;
+    iteration?: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    timeout: number;
+    startedAt: string;
+}
+/**
+ * Agent approval complete event — user or system resolved the approval.
+ */
+interface AgentApprovalCompleteEvent extends BaseAgentEvent {
+    type: 'agent_approval_complete';
+    approvalId: string;
+    decision: 'approved' | 'denied' | 'timeout';
+    completedAt: string;
+    resolvedBy: 'user' | 'system';
+}
 /**
  * Agent iteration complete event
  */
@@ -4302,7 +4359,7 @@ interface AgentPingEvent extends BaseAgentEvent {
     timestamp: string;
 }
 /**
- * Agent await event (execution awaiting local tool result from client).
+ * API-emitted agent await event for local tools that must execute on the client.
  */
 interface AgentPausedEvent extends BaseAgentEvent {
     type: 'agent_await';
@@ -4339,7 +4396,7 @@ interface LocalToolExecutionCompleteEvent {
 /**
  * Union of all agent event types
  */
-type AgentEvent = AgentStartEvent | AgentIterationStartEvent | AgentTurnStartEvent | AgentTurnDeltaEvent | AgentTurnCompleteEvent | AgentToolStartEvent | AgentToolDeltaEvent | AgentToolInputDeltaEvent | AgentToolInputCompleteEvent | AgentToolCompleteEvent | AgentIterationCompleteEvent | AgentReflectionEvent | AgentCompleteEvent | AgentErrorEvent | AgentPingEvent | AgentPausedEvent;
+type AgentEvent = AgentStartEvent | AgentIterationStartEvent | AgentTurnStartEvent | AgentTurnDeltaEvent | AgentTurnCompleteEvent | AgentToolStartEvent | AgentToolDeltaEvent | AgentToolInputDeltaEvent | AgentToolInputCompleteEvent | AgentToolCompleteEvent | AgentMediaEvent | AgentApprovalStartEvent | AgentApprovalCompleteEvent | AgentIterationCompleteEvent | AgentReflectionEvent | AgentCompleteEvent | AgentErrorEvent | AgentPingEvent | AgentPausedEvent;
 /**
  * Parsed SSE event with event type and data
  */
@@ -4361,6 +4418,9 @@ interface AgentStreamCallbacks {
     onToolInputDelta?: (event: AgentToolInputDeltaEvent) => void;
     onToolInputComplete?: (event: AgentToolInputCompleteEvent) => void;
     onToolComplete?: (event: AgentToolCompleteEvent) => void;
+    onMedia?: (event: AgentMediaEvent) => void;
+    onApprovalStart?: (event: AgentApprovalStartEvent) => void;
+    onApprovalComplete?: (event: AgentApprovalCompleteEvent) => void;
     onIterationComplete?: (event: AgentIterationCompleteEvent) => void;
     onReflection?: (event: AgentReflectionEvent) => void;
     onAgentComplete?: (event: AgentCompleteEvent) => void;
@@ -5646,4 +5706,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepChunkEvent, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };

package/dist/index.d.ts

@@ -428,7 +428,7 @@ interface BuiltInTool {
     id: string;
     name: string;
     description: string;
-    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce';
+    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce' | 'browser';
     providers: string[];
     parametersSchema: JSONSchema;
     defaultConfig?: JsonObject;
@@ -1278,11 +1278,10 @@ interface StepStartEvent {
 interface StepDeltaEvent {
     type: 'step_delta';
     id: string;
-    chunk: string;
     index: number;
+    /** Streaming text fragment. */
+    text: string;
 }
-/** @deprecated Use StepDeltaEvent instead */
-type StepChunkEvent = StepDeltaEvent;
 interface StepCompleteEvent {
     type: 'step_complete';
     id: string;
@@ -1329,13 +1328,8 @@ interface StreamCallbacks {
     onFlowStart?: (event: FlowStartEvent) => void;
     /** Called when a step starts executing */
     onStepStart?: (event: StepStartEvent) => void;
-    /** Called for each chunk of streaming output from a step */
-    onStepDelta?: (chunk: string, event: StepDeltaEvent) => void;
-    /**
-     * @deprecated Use onStepDelta instead
-     * Called for each chunk of streaming output from a step
-     */
-    onStepChunk?: (chunk: string, event: StepDeltaEvent) => void;
+    /** Called for each text fragment of streaming output from a step */
+    onStepDelta?: (text: string, event: StepDeltaEvent) => void;
     /** Called when a step completes */
     onStepComplete?: (result: any, event: StepCompleteEvent) => void;
     /** Called when the entire flow completes */
@@ -1735,7 +1729,7 @@ declare function createExternalTool(config: {
  *
  * // Option 1: Process with callbacks
  * const summary = await result.stream({
- *   onStepChunk: (chunk) => process.stdout.write(chunk),
+ *   onStepDelta: (text) => process.stdout.write(text),
  * })
  *
  * // Option 2: Just get a specific step's result
@@ -1771,7 +1765,7 @@ declare class FlowResult {
      * ```typescript
      * const summary = await result.stream({
      *   onStepStart: (event) => console.log('Starting:', event.name),
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onStepComplete: (result, event) => console.log('Done:', event.name),
      *   onFlowComplete: (event) => console.log('Flow complete!'),
      * })
@@ -2232,7 +2226,7 @@ declare class RuntypeFlowBuilder {
      *
      * // Process with callbacks
      * await result.stream({
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onFlowComplete: () => console.log('Done!'),
      * })
      *
@@ -2769,7 +2763,7 @@ declare class PromptRunner {
      *
      * // Process with callbacks
      * await result.stream({
-     *   onStepChunk: (chunk) => process.stdout.write(chunk),
+     *   onStepDelta: (text) => process.stdout.write(text),
      *   onFlowComplete: () => console.log('Done!'),
      * })
      * ```
@@ -4116,7 +4110,7 @@ declare class ClientTokensEndpoint {
 /**
  * Agent event types for streaming
  */
-type AgentEventType = 'agent_start' | 'agent_iteration_start' | 'agent_turn_start' | 'agent_turn_delta' | 'agent_turn_complete' | 'agent_tool_start' | 'agent_tool_delta' | 'agent_tool_input_delta' | 'agent_tool_input_complete' | 'agent_tool_complete' | 'agent_iteration_complete' | 'agent_reflection' | 'agent_complete' | 'agent_error' | 'agent_ping' | 'agent_await';
+type AgentEventType = 'agent_start' | 'agent_iteration_start' | 'agent_turn_start' | 'agent_turn_delta' | 'agent_turn_complete' | 'agent_tool_start' | 'agent_tool_delta' | 'agent_tool_input_delta' | 'agent_tool_input_complete' | 'agent_tool_complete' | 'agent_media' | 'agent_approval_start' | 'agent_approval_complete' | 'agent_iteration_complete' | 'agent_reflection' | 'agent_complete' | 'agent_error' | 'agent_ping' | 'agent_await';
 /**
  * Base agent event with common fields
  */
@@ -4184,6 +4178,16 @@ interface AgentTurnCompleteEvent extends BaseAgentEvent {
         output: number;
     };
     cost?: number;
+    /**
+     * Per-model-invocation stop reason for this turn. `'max_tool_calls'`
+     * indicates a capped-mid-loop tool call (model cut off before producing
+     * follow-up text); `content` may be empty in that case. Omitted when
+     * the server didn't report one — treat absence as "not reported"
+     * (distinct from an explicit `'unknown'`).
+     *
+     * Mirrors `AgentTurnCompleteEvent.stopReason` in `@runtypelabs/shared`.
+     */
+    stopReason?: 'end_turn' | 'max_tool_calls' | 'length' | 'content_filter' | 'error' | 'unknown';
 }
 /**
  * Agent tool start event
@@ -4237,6 +4241,59 @@ interface AgentToolCompleteEvent extends BaseAgentEvent {
     result?: unknown;
     executionTime?: number;
 }
+interface AgentMediaEvent extends BaseAgentEvent {
+    type: 'agent_media';
+    iteration: number;
+    toolCallId: string;
+    toolName: string;
+    media: Array<{
+        type: 'media';
+        data: string;
+        mediaType: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    } | {
+        type: 'image-url';
+        url: string;
+        mediaType?: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    } | {
+        type: 'file-url';
+        url: string;
+        mediaType: string;
+        annotations?: {
+            audience?: ('user' | 'assistant')[];
+        };
+    }>;
+}
+/**
+ * Agent approval start event — execution paused waiting for user approval.
+ */
+interface AgentApprovalStartEvent extends BaseAgentEvent {
+    type: 'agent_approval_start';
+    approvalId: string;
+    iteration?: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    timeout: number;
+    startedAt: string;
+}
+/**
+ * Agent approval complete event — user or system resolved the approval.
+ */
+interface AgentApprovalCompleteEvent extends BaseAgentEvent {
+    type: 'agent_approval_complete';
+    approvalId: string;
+    decision: 'approved' | 'denied' | 'timeout';
+    completedAt: string;
+    resolvedBy: 'user' | 'system';
+}
 /**
  * Agent iteration complete event
  */
@@ -4302,7 +4359,7 @@ interface AgentPingEvent extends BaseAgentEvent {
     timestamp: string;
 }
 /**
- * Agent await event (execution awaiting local tool result from client).
+ * API-emitted agent await event for local tools that must execute on the client.
  */
 interface AgentPausedEvent extends BaseAgentEvent {
     type: 'agent_await';
@@ -4339,7 +4396,7 @@ interface LocalToolExecutionCompleteEvent {
 /**
  * Union of all agent event types
  */
-type AgentEvent = AgentStartEvent | AgentIterationStartEvent | AgentTurnStartEvent | AgentTurnDeltaEvent | AgentTurnCompleteEvent | AgentToolStartEvent | AgentToolDeltaEvent | AgentToolInputDeltaEvent | AgentToolInputCompleteEvent | AgentToolCompleteEvent | AgentIterationCompleteEvent | AgentReflectionEvent | AgentCompleteEvent | AgentErrorEvent | AgentPingEvent | AgentPausedEvent;
+type AgentEvent = AgentStartEvent | AgentIterationStartEvent | AgentTurnStartEvent | AgentTurnDeltaEvent | AgentTurnCompleteEvent | AgentToolStartEvent | AgentToolDeltaEvent | AgentToolInputDeltaEvent | AgentToolInputCompleteEvent | AgentToolCompleteEvent | AgentMediaEvent | AgentApprovalStartEvent | AgentApprovalCompleteEvent | AgentIterationCompleteEvent | AgentReflectionEvent | AgentCompleteEvent | AgentErrorEvent | AgentPingEvent | AgentPausedEvent;
 /**
  * Parsed SSE event with event type and data
  */
@@ -4361,6 +4418,9 @@ interface AgentStreamCallbacks {
     onToolInputDelta?: (event: AgentToolInputDeltaEvent) => void;
     onToolInputComplete?: (event: AgentToolInputCompleteEvent) => void;
     onToolComplete?: (event: AgentToolCompleteEvent) => void;
+    onMedia?: (event: AgentMediaEvent) => void;
+    onApprovalStart?: (event: AgentApprovalStartEvent) => void;
+    onApprovalComplete?: (event: AgentApprovalCompleteEvent) => void;
     onIterationComplete?: (event: AgentIterationCompleteEvent) => void;
     onReflection?: (event: AgentReflectionEvent) => void;
     onAgentComplete?: (event: AgentCompleteEvent) => void;
@@ -5646,4 +5706,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepChunkEvent, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };

package/dist/index.mjs

@@ -177,13 +177,9 @@ function handleEvent(event, callbacks, results, summary) {
     case "step_start":
       callbacks.onStepStart?.(event);
       break;
-    case "step_delta": {
-      const chunkText = event.chunk || event.text || "";
-      const deltaEvent = event;
-      callbacks.onStepDelta?.(chunkText, deltaEvent);
-      callbacks.onStepChunk?.(chunkText, deltaEvent);
+    case "step_delta":
+      callbacks.onStepDelta?.(event.text, event);
       break;
-    }
     case "step_complete":
       results.set(event.name, event.result);
       callbacks.onStepComplete?.(event.result, event);
@@ -241,10 +237,6 @@ async function* streamEvents(response) {
       for (const eventStr of events) {
         try {
           const event = JSON.parse(eventStr);
-          if (event.type === "step_delta" && "text" in event && !("chunk" in event)) {
-            ;
-            event.chunk = event.text;
-          }
           yield event;
         } catch {
         }
@@ -254,10 +246,6 @@ async function* streamEvents(response) {
     if (finalEvent) {
       try {
         const event = JSON.parse(finalEvent);
-        if (event.type === "step_delta" && "text" in event && !("chunk" in event)) {
-          ;
-          event.chunk = event.text;
-        }
         yield event;
       } catch {
       }
@@ -309,7 +297,7 @@ var FlowResult = class {
    * ```typescript
    * const summary = await result.stream({
    *   onStepStart: (event) => console.log('Starting:', event.name),
-   *   onStepChunk: (chunk) => process.stdout.write(chunk),
+   *   onStepDelta: (text) => process.stdout.write(text),
    *   onStepComplete: (result, event) => console.log('Done:', event.name),
    *   onFlowComplete: (event) => console.log('Flow complete!'),
    * })
@@ -913,7 +901,7 @@ var RuntypeFlowBuilder = class {
           ...callbacks,
           onFlowStart: (event) => callbacks?.onFlowStart?.(event),
           onStepStart: (event) => callbacks?.onStepStart?.(event),
-          onStepChunk: (chunk, event) => callbacks?.onStepChunk?.(chunk, event),
+          onStepDelta: (text, event) => callbacks?.onStepDelta?.(text, event),
           onStepComplete: (result, event) => callbacks?.onStepComplete?.(result, event),
           onFlowComplete: (event) => callbacks?.onFlowComplete?.(event),
           onError: (error) => callbacks?.onError?.(error)
@@ -943,11 +931,9 @@ var RuntypeFlowBuilder = class {
               case "step_start":
                 wrappedCallbacks.onStepStart?.(event);
                 break;
-              case "step_delta": {
-                const chunkText = awaitEvent.chunk || awaitEvent.text || "";
-                wrappedCallbacks.onStepChunk?.(chunkText, event);
+              case "step_delta":
+                wrappedCallbacks.onStepDelta?.(event.text, event);
                 break;
-              }
               case "step_complete": {
                 accumulatedSummary.results?.set(event.name, event.result);
                 wrappedCallbacks.onStepComplete?.(event.result, event);
@@ -1397,7 +1383,7 @@ var PromptRunner = class {
    *
    * // Process with callbacks
    * await result.stream({
-   *   onStepChunk: (chunk) => process.stdout.write(chunk),
+   *   onStepDelta: (text) => process.stdout.write(text),
    *   onFlowComplete: () => console.log('Done!'),
    * })
    * ```
@@ -4306,6 +4292,15 @@ function dispatchAgentEvent(event, callbacks) {
     case "agent_tool_complete":
       callbacks.onToolComplete?.(typedData);
       break;
+    case "agent_media":
+      callbacks.onMedia?.(typedData);
+      break;
+    case "agent_approval_start":
+      callbacks.onApprovalStart?.(typedData);
+      break;
+    case "agent_approval_complete":
+      callbacks.onApprovalComplete?.(typedData);
+      break;
     case "agent_iteration_complete":
       callbacks.onIterationComplete?.(typedData);
       break;
@@ -7601,7 +7596,7 @@ var ClientFlowBuilder = class extends FlowBuilder {
 };
 function isStreamCallbacks(obj) {
   if (!obj || typeof obj !== "object") return false;
-  return "onFlowStart" in obj || "onStepStart" in obj || "onStepDelta" in obj || "onStepChunk" in obj || "onStepComplete" in obj || "onFlowComplete" in obj || "onError" in obj;
+  return "onFlowStart" in obj || "onStepStart" in obj || "onStepDelta" in obj || "onStepComplete" in obj || "onFlowComplete" in obj || "onError" in obj;
 }
 function createExternalTool(config) {
   return {
@@ -7716,7 +7711,7 @@ var RuntypeClient2 = class {
           ...callbacks,
           onFlowStart: (event) => callbacks?.onFlowStart?.(event),
           onStepStart: (event) => callbacks?.onStepStart?.(event),
-          onStepChunk: (chunk, event) => callbacks?.onStepChunk?.(chunk, event),
+          onStepDelta: (text, event) => callbacks?.onStepDelta?.(text, event),
           onStepComplete: (result, event) => callbacks?.onStepComplete?.(result, event),
           onFlowComplete: (event) => callbacks?.onFlowComplete?.(event),
           onError: (error) => callbacks?.onError?.(error)
@@ -7751,12 +7746,9 @@ var RuntypeClient2 = class {
               case "step_start":
                 wrappedCallbacks.onStepStart?.(event);
                 break;
-              case "step_delta": {
-                const deltaEvent = event;
-                const chunkText = deltaEvent.chunk || deltaEvent.text || "";
-                wrappedCallbacks.onStepChunk?.(chunkText, deltaEvent);
+              case "step_delta":
+                wrappedCallbacks.onStepDelta?.(event.text, event);
                 break;
-              }
               case "step_complete": {
                 summary.results?.set(event.name, event.result);
                 wrappedCallbacks.onStepComplete?.(event.result, event);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",