@eigenpal/sdk 0.10.3 → 0.10.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/sdk
 
+## 0.10.5
+
+### Minor Changes
+
+- d3a8b79: Run start types now model file inputs explicitly. SDK users can pass reusable file handles with `$fileId` or inline file bytes with `$inline`, matching the public API behavior for file-backed workflow runs.
+
 ## 0.10.3
 
 ### Patch Changes

package/README.md

@@ -80,14 +80,14 @@ Use `client.files` for reusable upload-first blobs. When referenced by a run inp
 const uploaded = await client.files.upload(file);
 
 const started = await client.run('workflows.extract-invoice', {
-  contract_document: { fileId: uploaded.id },
+  contract_document: { $fileId: uploaded.id },
 });
 
 const artifacts = await client.runs.artifacts.list(started.id);
 const pdf = await client.runs.artifacts.download(started.id, artifacts.artifacts[0].path);
 ```
 
-You can also pass a `File`, `Blob`, or `{ content, filename, mimeType }` directly to `client.run`; the SDK sends multipart form data automatically.
+You can also pass a `File`, `Blob`, or `{ content, filename, mimeType }` directly to `client.run`; the SDK sends multipart form data automatically. Durable run inputs and dataset examples store scoped `{ "$file": "input/..." }` artifact refs after ingestion.
 
 ## Errors
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/sdk",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "Official TypeScript SDK for the EigenPal API",
   "type": "module",
   "main": "./src/index.ts",

package/src/generated/types.gen.ts

@@ -173,19 +173,49 @@ export type RunStartBody = {
         [key: string]: unknown;
     };
     /**
-     * File inputs as references (`{ fileId, filename?, mimeType? }`). Upload bytes via multipart `files.<fieldName>` parts instead.
+     * File inputs as ingress references (`{ "$fileId": "file_..." }` or `{ "$inline": { filename, mimeType, base64 } }`). Upload bytes via multipart `files.<fieldName>` parts instead.
      */
     files?: {
         [key: string]: {
-            fileId: string;
-            filename?: string;
-            mimeType?: string;
-            [key: string]: unknown;
+            /**
+             * Reusable file-pool id to materialize
+             */
+            $fileId: string;
+        } | {
+            $inline: {
+                /**
+                 * Original filename for the materialized artifact
+                 */
+                filename: string;
+                /**
+                 * MIME type for the materialized artifact
+                 */
+                mimeType: string;
+                /**
+                 * Base64-encoded file bytes
+                 */
+                base64: string;
+            };
         } | Array<{
-            fileId: string;
-            filename?: string;
-            mimeType?: string;
-            [key: string]: unknown;
+            /**
+             * Reusable file-pool id to materialize
+             */
+            $fileId: string;
+        } | {
+            $inline: {
+                /**
+                 * Original filename for the materialized artifact
+                 */
+                filename: string;
+                /**
+                 * MIME type for the materialized artifact
+                 */
+                mimeType: string;
+                /**
+                 * Base64-encoded file bytes
+                 */
+                base64: string;
+            };
         }>;
     };
     /**

package/src/telemetry.ts

@@ -19,7 +19,7 @@
 export const SDK_LANGUAGE = 'typescript';
 // Rewritten at publish time by scripts/render-sdk-versions.sh.
 // Keep this string literal exactly stable — sed matches on it.
-export const SDK_VERSION = '0.10.3';
+export const SDK_VERSION = '0.10.5';
 
 function detectRuntime(): string {
   const g = globalThis as unknown as {