@runtypelabs/sdk 4.0.0 → 4.0.2

package/dist/index.d.cts

@@ -62,12 +62,23 @@ interface FlowFallback extends BaseFallback {
 /**
  * A single fallback trigger - the condition that activates the fallback chain.
  * `error` (the default) fires fallbacks when the step errors; `empty-output`
- * fires them when the step finished successfully but produced no visible text.
+ * fires them when the step finished successfully but produced no visible text;
+ * `slow` fires them when the model streams continuously but exceeds a total
+ * wall-clock duration cap (`afterMs`, in ms) — a slow-but-not-stalled call.
  */
-type FallbackTriggerType = 'error' | 'empty-output';
-interface FallbackTrigger {
-    type: FallbackTriggerType;
-}
+type FallbackTriggerType = 'error' | 'empty-output' | 'slow';
+/**
+ * Discriminated by `type`: the `error` / `empty-output` variants are
+ * parameter-less; `slow` carries the total-duration cap (`afterMs`).
+ */
+type FallbackTrigger = {
+    type: 'error';
+} | {
+    type: 'empty-output';
+} | {
+    type: 'slow';
+    afterMs: number;
+};
 /**
  * Union of all prompt fallback types
  */
@@ -85,7 +96,9 @@ interface PromptErrorHandling {
     /**
      * Conditions that activate the fallback chain. Defaults to `[{ type: 'error' }]`
      * when omitted. Add `{ type: 'empty-output' }` to also run the chain when the
-     * model finishes successfully but returns no visible text.
+     * model finishes successfully but returns no visible text, or
+     * `{ type: 'slow', afterMs }` to run it when the model exceeds a total
+     * wall-clock duration cap while still streaming.
      */
     triggers?: FallbackTrigger[];
 }
@@ -33707,11 +33720,13 @@ interface paths {
                         "application/json": {
                             data: {
                                 agentExecutionId: string | null;
+                                agentId: string | null;
                                 batchExecutionId: string | null;
                                 completedAt: string | null;
                                 createdAt: string;
                                 error: string | null;
                                 failedRecords: number | null;
+                                flowId: string | null;
                                 id: string;
                                 processedRecords: number | null;
                                 scheduleId: string;
@@ -41594,12 +41609,13 @@ declare class ClientFlowBuilder extends FlowBuilder {
  * Create an external runtime tool definition.
  *
  * External tools make HTTP requests to external APIs with support for
- * variable substitution in URLs and headers.
+ * variable substitution in URLs and headers. Reference tool parameters and
+ * flow/execution context variables (e.g. `{{_flow}}`, `{{_user}}`,
+ * `{{_execution}}`, `{{_record}}`) directly in the URL, headers, and body.
  *
- * Special internal variables are available for auth:
- * - `{{_internal.auth_token}}` - Bearer token for Runtype API auth
- * - `{{_internal.user_id}}` - Current user ID
- * - `{{_internal.org_id}}` - Current organization ID
+ * Note: `{{_internal.*}}` variables (such as `_internal.auth_token`) are NOT
+ * populated at runtime and are reserved/blocked by the execution engine.
+ * Pass credentials via secret references (`{{secret:NAME}}`) instead.
  *
  * @example
  * ```typescript
@@ -41614,7 +41630,7 @@ declare class ClientFlowBuilder extends FlowBuilder {
  *   },
  *   url: 'https://api.runtype.com/v1/flows',
  *   method: 'GET',
- *   headers: { Authorization: '{{_internal.auth_token}}' }
+ *   headers: { Authorization: 'Bearer {{secret:RUNTYPE_API_KEY}}' }
  * })
  * ```
  */

package/dist/index.d.ts

@@ -62,12 +62,23 @@ interface FlowFallback extends BaseFallback {
 /**
  * A single fallback trigger - the condition that activates the fallback chain.
  * `error` (the default) fires fallbacks when the step errors; `empty-output`
- * fires them when the step finished successfully but produced no visible text.
+ * fires them when the step finished successfully but produced no visible text;
+ * `slow` fires them when the model streams continuously but exceeds a total
+ * wall-clock duration cap (`afterMs`, in ms) — a slow-but-not-stalled call.
  */
-type FallbackTriggerType = 'error' | 'empty-output';
-interface FallbackTrigger {
-    type: FallbackTriggerType;
-}
+type FallbackTriggerType = 'error' | 'empty-output' | 'slow';
+/**
+ * Discriminated by `type`: the `error` / `empty-output` variants are
+ * parameter-less; `slow` carries the total-duration cap (`afterMs`).
+ */
+type FallbackTrigger = {
+    type: 'error';
+} | {
+    type: 'empty-output';
+} | {
+    type: 'slow';
+    afterMs: number;
+};
 /**
  * Union of all prompt fallback types
  */
@@ -85,7 +96,9 @@ interface PromptErrorHandling {
     /**
      * Conditions that activate the fallback chain. Defaults to `[{ type: 'error' }]`
      * when omitted. Add `{ type: 'empty-output' }` to also run the chain when the
-     * model finishes successfully but returns no visible text.
+     * model finishes successfully but returns no visible text, or
+     * `{ type: 'slow', afterMs }` to run it when the model exceeds a total
+     * wall-clock duration cap while still streaming.
      */
     triggers?: FallbackTrigger[];
 }
@@ -33707,11 +33720,13 @@ interface paths {
                         "application/json": {
                             data: {
                                 agentExecutionId: string | null;
+                                agentId: string | null;
                                 batchExecutionId: string | null;
                                 completedAt: string | null;
                                 createdAt: string;
                                 error: string | null;
                                 failedRecords: number | null;
+                                flowId: string | null;
                                 id: string;
                                 processedRecords: number | null;
                                 scheduleId: string;
@@ -41594,12 +41609,13 @@ declare class ClientFlowBuilder extends FlowBuilder {
  * Create an external runtime tool definition.
  *
  * External tools make HTTP requests to external APIs with support for
- * variable substitution in URLs and headers.
+ * variable substitution in URLs and headers. Reference tool parameters and
+ * flow/execution context variables (e.g. `{{_flow}}`, `{{_user}}`,
+ * `{{_execution}}`, `{{_record}}`) directly in the URL, headers, and body.
  *
- * Special internal variables are available for auth:
- * - `{{_internal.auth_token}}` - Bearer token for Runtype API auth
- * - `{{_internal.user_id}}` - Current user ID
- * - `{{_internal.org_id}}` - Current organization ID
+ * Note: `{{_internal.*}}` variables (such as `_internal.auth_token`) are NOT
+ * populated at runtime and are reserved/blocked by the execution engine.
+ * Pass credentials via secret references (`{{secret:NAME}}`) instead.
  *
  * @example
  * ```typescript
@@ -41614,7 +41630,7 @@ declare class ClientFlowBuilder extends FlowBuilder {
  *   },
  *   url: 'https://api.runtype.com/v1/flows',
  *   method: 'GET',
- *   headers: { Authorization: '{{_internal.auth_token}}' }
+ *   headers: { Authorization: 'Bearer {{secret:RUNTYPE_API_KEY}}' }
  * })
  * ```
  */

package/package.json

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