@runtypelabs/sdk 1.24.2 → 2.0.0

package/dist/index.cjs

@@ -3737,7 +3737,10 @@ var RecordsEndpoint = class {
     return this.client.delete(`/records/${id}/results`, { resultId });
   }
   /**
-   * Upload CSV file to create multiple records
+   * Upload CSV file to create multiple records.
+   * Provide either `typeColumn` (read each row's type from a column) or
+   * `typeValue` (assign the same constant type to every row). `typeValue`
+   * takes precedence when both are supplied.
    */
   async uploadCsv(file, params) {
     const formData = new FormData();
@@ -3748,6 +3751,9 @@ var RecordsEndpoint = class {
     if (params?.nameColumn) {
       formData.append("nameColumn", params.nameColumn);
     }
+    if (params?.typeValue) {
+      formData.append("typeValue", params.typeValue);
+    }
     return this.client.postFormData("/records/upload-csv", formData);
   }
   /**
@@ -4315,7 +4321,12 @@ var EvalEndpoint = class {
   }
   /**
    * Run virtual eval with streaming response
-   * Executes multiple eval configs simultaneously and streams results via multiplexed SSE
+   * Executes multiple eval configs simultaneously and streams results via multiplexed SSE.
+   *
+   * Targets are mutually exclusive — provide exactly one of `flowId`,
+   * `flowDefinition`, or `agentId`. The `agentId` form targets a
+   * `claude_managed` agent; combine with per-config `claudeManagedOverride`
+   * to vary model / system prompt / tool permissions across configs.
    */
   async runVirtualEval(data) {
     return this.client.requestStream("/eval/stream", {

package/dist/index.d.cts

@@ -1142,7 +1142,6 @@ interface Flow {
     id: string;
     name: string;
     description?: string | null;
-    status: 'draft' | 'active' | 'paused' | 'failed';
     config?: JsonObject;
     userId: string;
     organizationId: string | null;
@@ -1262,6 +1261,12 @@ interface CreateFlowRequest {
     name: string;
     description?: string;
     flowSteps?: Array<{
+        /**
+         * Stable step identifier. When provided, the server preserves it across
+         * saves so references in `flow_step_results` and dashboard state remain
+         * valid. When omitted, the server mints one on first save.
+         */
+        id?: string;
         type: 'prompt' | 'context' | 'condition' | 'output' | 'email';
         name: string;
         order?: number;
@@ -1378,6 +1383,8 @@ interface DispatchRequest {
         id?: number | string;
         name?: string;
         type?: string;
+        /** First-class owner; stored as `metadata.ownerId` (overrides any value in `metadata`). */
+        ownerId?: string;
         metadata?: Metadata;
     };
     flow: {
@@ -3280,11 +3287,15 @@ declare class RecordsEndpoint {
      */
     deleteResult(id: string, resultId: string): Promise<void>;
     /**
-     * Upload CSV file to create multiple records
+     * Upload CSV file to create multiple records.
+     * Provide either `typeColumn` (read each row's type from a column) or
+     * `typeValue` (assign the same constant type to every row). `typeValue`
+     * takes precedence when both are supplied.
      */
     uploadCsv(file: File, params?: {
         typeColumn?: string;
         nameColumn?: string;
+        typeValue?: string;
     }): Promise<any>;
     /**
      * Get record types (distinct values)
@@ -3716,7 +3727,12 @@ declare class EvalEndpoint {
     constructor(client: ApiClient);
     /**
      * Run virtual eval with streaming response
-     * Executes multiple eval configs simultaneously and streams results via multiplexed SSE
+     * Executes multiple eval configs simultaneously and streams results via multiplexed SSE.
+     *
+     * Targets are mutually exclusive — provide exactly one of `flowId`,
+     * `flowDefinition`, or `agentId`. The `agentId` form targets a
+     * `claude_managed` agent; combine with per-config `claudeManagedOverride`
+     * to vary model / system prompt / tool permissions across configs.
      */
     runVirtualEval(data: {
         record?: {
@@ -3730,10 +3746,36 @@ declare class EvalEndpoint {
         }>;
         flowId?: string;
         flowDefinition?: any;
+        /**
+         * Target a `claude_managed` agent rather than a flow. Mutually exclusive
+         * with `flowId` and `flowDefinition`.
+         */
+        agentId?: string;
         evalConfigs: Array<{
             evalConfigId?: string;
             evalName?: string;
             stepOverrides?: Record<string, any>;
+            /**
+             * Per-config override applied when the eval target is a
+             * `claude_managed` agent. Mirrors `ClaudeManagedEvalOverride` from
+             * `@runtypelabs/shared` — defined inline here to keep the SDK
+             * dependency-free.
+             */
+            claudeManagedOverride?: {
+                targetType?: 'claude_managed';
+                model?: string;
+                systemPrompt?: string;
+                toolPermissions?: {
+                    bash?: boolean;
+                    read?: boolean;
+                    write?: boolean;
+                    edit?: boolean;
+                    glob?: boolean;
+                    grep?: boolean;
+                    webFetch?: boolean;
+                    webSearch?: boolean;
+                };
+            };
         }>;
         evalGroupId?: string;
     }): Promise<Response>;
@@ -3960,7 +4002,7 @@ interface AgentMediaEvent extends BaseAgentEvent {
  * Local SDK copy of `ExternalAgentContext` from `@runtypelabs/shared`'s
  * `sse-parser.ts`. The SDK has zero production dependencies and
  * re-derives wire types by design (Phase 9 — see
- * `docs/features/planning/2026-02-25-user-cloud-deployment.md`). Keep
+ * `docs/features/shipped/2026-02-25-user-cloud-deployment.md`). Keep
  * the shape identical to `@runtypelabs/shared`'s `ExternalAgentContext`.
  */
 interface ExternalAgentContext {

package/dist/index.d.ts

@@ -1142,7 +1142,6 @@ interface Flow {
     id: string;
     name: string;
     description?: string | null;
-    status: 'draft' | 'active' | 'paused' | 'failed';
     config?: JsonObject;
     userId: string;
     organizationId: string | null;
@@ -1262,6 +1261,12 @@ interface CreateFlowRequest {
     name: string;
     description?: string;
     flowSteps?: Array<{
+        /**
+         * Stable step identifier. When provided, the server preserves it across
+         * saves so references in `flow_step_results` and dashboard state remain
+         * valid. When omitted, the server mints one on first save.
+         */
+        id?: string;
         type: 'prompt' | 'context' | 'condition' | 'output' | 'email';
         name: string;
         order?: number;
@@ -1378,6 +1383,8 @@ interface DispatchRequest {
         id?: number | string;
         name?: string;
         type?: string;
+        /** First-class owner; stored as `metadata.ownerId` (overrides any value in `metadata`). */
+        ownerId?: string;
         metadata?: Metadata;
     };
     flow: {
@@ -3280,11 +3287,15 @@ declare class RecordsEndpoint {
      */
     deleteResult(id: string, resultId: string): Promise<void>;
     /**
-     * Upload CSV file to create multiple records
+     * Upload CSV file to create multiple records.
+     * Provide either `typeColumn` (read each row's type from a column) or
+     * `typeValue` (assign the same constant type to every row). `typeValue`
+     * takes precedence when both are supplied.
      */
     uploadCsv(file: File, params?: {
         typeColumn?: string;
         nameColumn?: string;
+        typeValue?: string;
     }): Promise<any>;
     /**
      * Get record types (distinct values)
@@ -3716,7 +3727,12 @@ declare class EvalEndpoint {
     constructor(client: ApiClient);
     /**
      * Run virtual eval with streaming response
-     * Executes multiple eval configs simultaneously and streams results via multiplexed SSE
+     * Executes multiple eval configs simultaneously and streams results via multiplexed SSE.
+     *
+     * Targets are mutually exclusive — provide exactly one of `flowId`,
+     * `flowDefinition`, or `agentId`. The `agentId` form targets a
+     * `claude_managed` agent; combine with per-config `claudeManagedOverride`
+     * to vary model / system prompt / tool permissions across configs.
      */
     runVirtualEval(data: {
         record?: {
@@ -3730,10 +3746,36 @@ declare class EvalEndpoint {
         }>;
         flowId?: string;
         flowDefinition?: any;
+        /**
+         * Target a `claude_managed` agent rather than a flow. Mutually exclusive
+         * with `flowId` and `flowDefinition`.
+         */
+        agentId?: string;
         evalConfigs: Array<{
             evalConfigId?: string;
             evalName?: string;
             stepOverrides?: Record<string, any>;
+            /**
+             * Per-config override applied when the eval target is a
+             * `claude_managed` agent. Mirrors `ClaudeManagedEvalOverride` from
+             * `@runtypelabs/shared` — defined inline here to keep the SDK
+             * dependency-free.
+             */
+            claudeManagedOverride?: {
+                targetType?: 'claude_managed';
+                model?: string;
+                systemPrompt?: string;
+                toolPermissions?: {
+                    bash?: boolean;
+                    read?: boolean;
+                    write?: boolean;
+                    edit?: boolean;
+                    glob?: boolean;
+                    grep?: boolean;
+                    webFetch?: boolean;
+                    webSearch?: boolean;
+                };
+            };
         }>;
         evalGroupId?: string;
     }): Promise<Response>;
@@ -3960,7 +4002,7 @@ interface AgentMediaEvent extends BaseAgentEvent {
  * Local SDK copy of `ExternalAgentContext` from `@runtypelabs/shared`'s
  * `sse-parser.ts`. The SDK has zero production dependencies and
  * re-derives wire types by design (Phase 9 — see
- * `docs/features/planning/2026-02-25-user-cloud-deployment.md`). Keep
+ * `docs/features/shipped/2026-02-25-user-cloud-deployment.md`). Keep
  * the shape identical to `@runtypelabs/shared`'s `ExternalAgentContext`.
  */
 interface ExternalAgentContext {

package/dist/index.mjs

@@ -3665,7 +3665,10 @@ var RecordsEndpoint = class {
     return this.client.delete(`/records/${id}/results`, { resultId });
   }
   /**
-   * Upload CSV file to create multiple records
+   * Upload CSV file to create multiple records.
+   * Provide either `typeColumn` (read each row's type from a column) or
+   * `typeValue` (assign the same constant type to every row). `typeValue`
+   * takes precedence when both are supplied.
    */
   async uploadCsv(file, params) {
     const formData = new FormData();
@@ -3676,6 +3679,9 @@ var RecordsEndpoint = class {
     if (params?.nameColumn) {
       formData.append("nameColumn", params.nameColumn);
     }
+    if (params?.typeValue) {
+      formData.append("typeValue", params.typeValue);
+    }
     return this.client.postFormData("/records/upload-csv", formData);
   }
   /**
@@ -4243,7 +4249,12 @@ var EvalEndpoint = class {
   }
   /**
    * Run virtual eval with streaming response
-   * Executes multiple eval configs simultaneously and streams results via multiplexed SSE
+   * Executes multiple eval configs simultaneously and streams results via multiplexed SSE.
+   *
+   * Targets are mutually exclusive — provide exactly one of `flowId`,
+   * `flowDefinition`, or `agentId`. The `agentId` form targets a
+   * `claude_managed` agent; combine with per-config `claudeManagedOverride`
+   * to vary model / system prompt / tool permissions across configs.
    */
   async runVirtualEval(data) {
     return this.client.requestStream("/eval/stream", {

package/package.json

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