@runtypelabs/sdk 6.2.0 → 6.3.0

package/dist/index.mjs

@@ -1,14 +1,17 @@
 // src/unified-stream-adapter.ts
 var UNIFIED_EVENTS_QUERY = "events=unified";
 function withUnifiedEvents(path) {
-  return path.includes("?") ? `${path}&${UNIFIED_EVENTS_QUERY}` : `${path}?${UNIFIED_EVENTS_QUERY}`;
+  return path;
 }
-var UNIFIED_ONLY_EVENT_TYPES = /* @__PURE__ */ new Set([
+var UNIFIED_EVENT_TYPES = /* @__PURE__ */ new Set([
   "execution_start",
   "execution_complete",
   "execution_error",
   "turn_start",
   "turn_complete",
+  "step_start",
+  "step_complete",
+  "step_skip",
   "text_start",
   "text_delta",
   "text_complete",
@@ -18,11 +21,25 @@ var UNIFIED_ONLY_EVENT_TYPES = /* @__PURE__ */ new Set([
   "media_start",
   "media_delta",
   "media_complete",
+  "artifact_start",
+  "artifact_delta",
+  "artifact_update",
+  "artifact_complete",
+  "source",
+  "tool_start",
+  "tool_input_delta",
+  "tool_input_complete",
   "tool_output_delta",
-  "await"
+  "tool_complete",
+  "approval_start",
+  "approval_complete",
+  "await",
+  "error",
+  "ping",
+  "custom"
 ]);
 function isUnifiedEventType(type) {
-  return typeof type === "string" && UNIFIED_ONLY_EVENT_TYPES.has(type);
+  return typeof type === "string" && UNIFIED_EVENT_TYPES.has(type);
 }
 function str(value) {
   return typeof value === "string" ? value : void 0;
@@ -37,14 +54,6 @@ function compact(event) {
   }
   return out;
 }
-var LEGACY_FLOW_PASSTHROUGH = /* @__PURE__ */ new Set([
-  "flow_start",
-  "flow_complete",
-  "flow_error",
-  "flow_await",
-  "step_await",
-  "step_delta"
-]);
 function createFlowEventTranslator() {
   let currentStepId;
   let currentStepName;
@@ -55,7 +64,6 @@ function createFlowEventTranslator() {
     if (!type) return [];
     const executionId = str(data.executionId);
     const seq = num(data.seq);
-    if (LEGACY_FLOW_PASSTHROUGH.has(type)) return [data];
     switch (type) {
       case "execution_start":
         if (data.kind !== "flow") return [];
@@ -72,8 +80,8 @@ function createFlowEventTranslator() {
           })
         ];
       case "step_start": {
-        const id = str(data.id) ?? str(data.stepId);
-        const name = str(data.name) ?? str(data.stepName);
+        const id = str(data.id);
+        const name = str(data.name);
         currentStepId = id;
         currentStepName = name;
         return [
@@ -106,8 +114,8 @@ function createFlowEventTranslator() {
           })
         ];
       case "step_complete": {
-        const id = str(data.id) ?? str(data.stepId);
-        const name = str(data.name) ?? str(data.stepName);
+        const id = str(data.id);
+        const name = str(data.name);
         const out = compact({
           type: "step_complete",
           executionId,
@@ -118,7 +126,7 @@ function createFlowEventTranslator() {
           stepType: data.stepType,
           result: data.result,
           success: data.success,
-          executionTime: num(data.durationMs) ?? num(data.executionTime),
+          executionTime: num(data.durationMs),
           stopReason: data.stopReason,
           completedAt: data.completedAt,
           unresolvedVariables: data.unresolvedVariables,
@@ -171,7 +179,7 @@ function createFlowEventTranslator() {
           })
         ];
       // Channels/markers/tool-family/approval/skip/source/custom/ping the flow
-      // consumer never read → no legacy event. (A non-terminal `error` is only
+      // consumer never read → no callback event. (A non-terminal `error` is only
       // produced on agent streams; dropping it here avoids a false flow_error.)
       default:
         return [];
@@ -192,7 +200,6 @@ function createAgentEventTranslator() {
     const executionId = str(data.executionId);
     const seq = num(data.seq);
     const iter = num(data.iteration) ?? iteration;
-    if (type.startsWith("agent_")) return [data];
     switch (type) {
       case "execution_start":
         if (data.kind !== "agent") return [];
@@ -399,7 +406,8 @@ function createAgentEventTranslator() {
             reason: data.reason,
             parameters: data.parameters,
             timeout: data.timeout,
-            startedAt: data.startedAt
+            startedAt: data.startedAt,
+            externalAgent: data.externalAgent
           })
         ];
       case "approval_complete":
@@ -443,7 +451,8 @@ function createAgentEventTranslator() {
             totalCost: data.totalCost,
             totalTokens: data.totalTokens,
             finalOutput: data.finalOutput,
-            duration: data.durationMs
+            duration: data.durationMs,
+            externalAgent: data.externalAgent
           })
         ];
       case "execution_error":
@@ -474,7 +483,7 @@ function createAgentEventTranslator() {
         return [compact({ type: "agent_ping", executionId, seq, timestamp: data.timestamp })];
       // turn/text/reasoning open+close markers, step_*, artifact_*, source,
       // custom (fallback beat / routing), and the skill-fold result envelope
-      // the SDK never consumed → no legacy event.
+      // the SDK never consumed → no callback event.
       default:
         return [];
     }
@@ -536,7 +545,7 @@ function parseFinalBuffer(buffer) {
   }
   return null;
 }
-async function processStream(response, callbacks = {}, options = {}) {
+async function processStream(response, callbacks = {}, _options = {}) {
   if (!response.ok) {
     const error = new Error(`HTTP ${response.status}: ${response.statusText}`);
     callbacks.onError?.(error);
@@ -560,18 +569,10 @@ async function processStream(response, callbacks = {}, options = {}) {
     executionTime: 0,
     success: true
   };
-  let translate = options.unified === true ? createFlowEventTranslator() : null;
-  const autoDetect = options.unified === void 0;
+  const translate = createFlowEventTranslator();
   const dispatch = (parsed) => {
-    if (autoDetect && !translate && isUnifiedEventType(parsed?.type)) {
-      translate = createFlowEventTranslator();
-    }
-    if (translate) {
-      for (const ev of translate(parsed)) {
-        handleEvent(ev, callbacks, results, flowSummary);
-      }
-    } else {
-      handleEvent(parsed, callbacks, results, flowSummary);
+    for (const ev of translate(parsed)) {
+      handleEvent(ev, callbacks, results, flowSummary);
     }
   };
   const contentType = response.headers.get("content-type");
@@ -709,17 +710,11 @@ function handleEvent(event, callbacks, results, summary) {
       break;
   }
 }
-async function* streamEvents(response, options = {}) {
+async function* streamEvents(response, _options = {}) {
   if (!response.ok) {
     throw new Error(`HTTP ${response.status}: ${response.statusText}`);
   }
-  let translate = options.unified === true ? createFlowEventTranslator() : null;
-  const autoDetect = options.unified === void 0;
-  const maybeDetect = (parsed) => {
-    if (autoDetect && !translate && isUnifiedEventType(parsed?.type)) {
-      translate = createFlowEventTranslator();
-    }
-  };
+  const translate = createFlowEventTranslator();
   const contentType = response.headers.get("content-type");
   if (contentType?.includes("application/json")) {
     try {
@@ -755,12 +750,7 @@ async function* streamEvents(response, options = {}) {
         } catch {
           continue;
         }
-        maybeDetect(parsed);
-        if (translate) {
-          for (const ev of translate(parsed)) yield ev;
-        } else {
-          yield parsed;
-        }
+        for (const ev of translate(parsed)) yield ev;
       }
     }
     const finalEvent = parseFinalBuffer(buffer);
@@ -772,12 +762,7 @@ async function* streamEvents(response, options = {}) {
         parsed = void 0;
       }
       if (parsed !== void 0) {
-        maybeDetect(parsed);
-        if (translate) {
-          for (const ev of translate(parsed)) yield ev;
-        } else {
-          yield parsed;
-        }
+        for (const ev of translate(parsed)) yield ev;
       }
     }
   } finally {
@@ -788,15 +773,13 @@ async function* streamEvents(response, options = {}) {
 // src/flow-result.ts
 var FlowResult = class {
   /**
-   * @param options.unified - The response is a unified-vocabulary SSE stream
-   *   (`/dispatch` since the unified-SSE cutover). Set by dispatch call sites;
-   *   left unset by the still-legacy eval stream producer.
+   * @param _options Deprecated stream-format options retained for source
+   *   compatibility. The API wire is always unified.
    */
-  constructor(response, summary, options = {}) {
+  constructor(response, summary, _options = {}) {
     this.consumed = false;
     this.cachedSummary = null;
     this.response = response;
-    this.streamOptions = options;
     if (summary) {
       this.cachedSummary = summary;
       this.consumed = true;
@@ -849,7 +832,7 @@ var FlowResult = class {
     }
     this.ensureNotConsumed();
     this.consumed = true;
-    this.cachedSummary = await processStream(this.response, callbacks, this.streamOptions);
+    this.cachedSummary = await processStream(this.response, callbacks);
     return this.cachedSummary;
   }
   /**
@@ -1702,9 +1685,9 @@ var FlowBuilder = class {
     }
     const response = await client.dispatch(config);
     if (callbacks) {
-      return processStream(response, callbacks, { unified: true });
+      return processStream(response, callbacks);
     }
-    return new FlowResult(response, void 0, { unified: true });
+    return new FlowResult(response);
   }
   /**
    * Set a run condition (when predicate) on the last added step.
@@ -1836,9 +1819,9 @@ var ClientFlowBuilder = class extends FlowBuilder {
     }
     const response = await dispatchClient.dispatch(config);
     if (runCallbacks) {
-      return processStream(response, runCallbacks, { unified: true });
+      return processStream(response, runCallbacks);
     }
-    return new FlowResult(response, void 0, { unified: true });
+    return new FlowResult(response);
   }
 };
 function isStreamCallbacks(obj) {
@@ -1863,7 +1846,9 @@ function createExternalTool(config) {
 // src/local-tool-pause.ts
 var PENDING_NAMELESS_KEY = "";
 function collectLocalToolAwait(pausedTools, event) {
-  if (event.type !== "flow_await" && event.type !== "step_await") return;
+  if (event.type !== "await" && event.type !== "flow_await" && event.type !== "step_await") {
+    return;
+  }
   const name = typeof event.toolName === "string" && event.toolName ? event.toolName : "";
   const executionId = typeof event.executionId === "string" && event.executionId ? event.executionId : void 0;
   if (name) {
@@ -2195,6 +2180,29 @@ function normalizeCaseInput(input, where) {
       return { role: m.role, content: m.content };
     });
   }
+  if (input.toolMocks !== void 0) {
+    if (!Array.isArray(input.toolMocks)) {
+      throw new Error(`defineEval: ${where} "input.toolMocks" must be an array`);
+    }
+    out.toolMocks = input.toolMocks.map((m, i) => {
+      if (!isPlainObject(m) || typeof m.toolName !== "string" || m.toolName.length === 0) {
+        throw new Error(
+          `defineEval: ${where} "input.toolMocks[${i}]" must be an object with a non-empty "toolName"`
+        );
+      }
+      if (!("output" in m)) {
+        throw new Error(
+          `defineEval: ${where} "input.toolMocks[${i}]" must include "output" (the value the mock returns; use null for none)`
+        );
+      }
+      const mock = { toolName: m.toolName, output: m.output };
+      if (m.input !== void 0) mock.input = m.input;
+      if (typeof m.isError === "boolean") mock.isError = m.isError;
+      if (typeof m.sourceToolExecutionId === "string") mock.sourceToolExecutionId = m.sourceToolExecutionId;
+      if (typeof m.truncated === "boolean") mock.truncated = m.truncated;
+      return mock;
+    });
+  }
   return out;
 }
 function defineEval(input) {
@@ -3358,7 +3366,7 @@ var RuntypeFlowBuilder = class {
     config.options = { ...config.options, streamResponse: true };
     const client = this.getClient();
     const response = await this.dispatchWithPersistedFlow(client, config);
-    const result = new FlowResult(response, void 0, { unified: true });
+    const result = new FlowResult(response);
     if (callbacks) {
       await result.stream(callbacks);
     }
@@ -3387,7 +3395,7 @@ var RuntypeFlowBuilder = class {
     config.options = { ...config.options, streamResponse: true };
     const client = this.getClient();
     const response = await this.dispatchWithPersistedFlow(client, config);
-    const result = new FlowResult(response, void 0, { unified: true });
+    const result = new FlowResult(response);
     await result.getSummary();
     return result;
   }
@@ -3422,7 +3430,7 @@ var RuntypeFlowBuilder = class {
           onError: (error) => callbacks?.onError?.(error)
         };
         try {
-          for await (const event of streamEvents(response, { unified: true })) {
+          for await (const event of streamEvents(response)) {
             collectLocalToolAwait(pausedTools, event);
             switch (event.type) {
               case "flow_start":
@@ -3470,7 +3478,7 @@ var RuntypeFlowBuilder = class {
           if (pausedTools.size === 0 && typeof data.pausedReason === "object" && data.pausedReason !== null && data.pausedReason.type === "local_action") {
             collectLocalToolAwait(pausedTools, {
               ...data.pausedReason,
-              type: "flow_await"
+              type: "await"
             });
           }
           return {
@@ -3530,7 +3538,7 @@ var RuntypeFlowBuilder = class {
             streamResponse: isStreaming
           };
           if (isStreaming) {
-            currentResponse = await client.requestStream(withUnifiedEvents("/dispatch/resume"), {
+            currentResponse = await client.requestStream("/dispatch/resume", {
               method: "POST",
               body: JSON.stringify(resumeData)
             });
@@ -5796,7 +5804,7 @@ var RuntypeClient = class {
    * Dispatch flow execution (streaming)
    */
   async dispatch(config) {
-    return this.requestStream(withUnifiedEvents("/dispatch"), {
+    return this.requestStream("/dispatch", {
       method: "POST",
       body: JSON.stringify(transformRequest(config))
     });
@@ -6167,7 +6175,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "6.2.0".length > 0 ? "6.2.0" : FALLBACK_VERSION;
+var SDK_VERSION = "6.3.0".length > 0 ? "6.3.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -8718,7 +8726,7 @@ var DispatchEndpoint = class {
    * Dispatch with streaming response
    */
   async executeStream(data) {
-    return this.client.requestStream(withUnifiedEvents("/dispatch"), {
+    return this.client.requestStream("/dispatch", {
       method: "POST",
       body: JSON.stringify(data)
     });
@@ -8734,7 +8742,7 @@ var DispatchEndpoint = class {
    */
   async resume(data) {
     if (data.streamResponse) {
-      return this.client.requestStream(withUnifiedEvents("/dispatch/resume"), {
+      return this.client.requestStream("/dispatch/resume", {
         method: "POST",
         body: JSON.stringify(data)
       });
@@ -9257,17 +9265,10 @@ async function processAgentStream(body, callbacks) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
-  let translate = null;
+  const translate = createAgentEventTranslator();
   const dispatch = (event) => {
-    if (!translate && isUnifiedEventType(event.data?.type ?? event.eventType)) {
-      translate = createAgentEventTranslator();
-    }
-    if (translate) {
-      for (const legacy of translate(event.data)) {
-        dispatchAgentEvent({ eventType: legacy.type, data: legacy }, callbacks);
-      }
-    } else {
-      dispatchAgentEvent(event, callbacks);
+    for (const callbackEvent of translate(event.data)) {
+      dispatchAgentEvent({ eventType: callbackEvent.type, data: callbackEvent }, callbacks);
     }
   };
   try {
@@ -9474,7 +9475,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
    * ```
    */
   async executeStream(id, data, init) {
-    return this.client.requestStream(withUnifiedEvents(`/agents/${id}/execute`), {
+    return this.client.requestStream(`/agents/${id}/execute`, {
       method: "POST",
       body: JSON.stringify({
         ...data,
@@ -9826,19 +9827,16 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         }
         let resumeResponse;
         try {
-          resumeResponse = await this.client.requestStream(
-            withUnifiedEvents(`/agents/${id}/resume`),
-            {
-              method: "POST",
-              body: JSON.stringify({
-                executionId,
-                toolOutputs: { [toolName]: toolResult },
-                streamResponse: true,
-                debugMode: data.debugMode
-              }),
-              ...abortSignal ? { signal: abortSignal } : {}
-            }
-          );
+          resumeResponse = await this.client.requestStream(`/agents/${id}/resume`, {
+            method: "POST",
+            body: JSON.stringify({
+              executionId,
+              toolOutputs: { [toolName]: toolResult },
+              streamResponse: true,
+              debugMode: data.debugMode
+            }),
+            ...abortSignal ? { signal: abortSignal } : {}
+          });
         } catch (error) {
           if (abortSignal?.aborted) return finishAborted(executionId);
           throw error;
@@ -12737,7 +12735,7 @@ var RuntypeClient2 = class {
           success: true
         };
         try {
-          for await (const event of streamEvents(response, { unified: true })) {
+          for await (const event of streamEvents(response)) {
             collectLocalToolAwait(pausedTools, event);
             switch (event.type) {
               case "flow_start":
@@ -12785,7 +12783,7 @@ var RuntypeClient2 = class {
           if (pausedTools.size === 0 && isObjectRecord(data.pausedReason) && data.pausedReason.type === "local_action") {
             collectLocalToolAwait(pausedTools, {
               ...data.pausedReason,
-              type: "flow_await"
+              type: "await"
             });
           }
           return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "6.2.0",
+  "version": "6.3.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",