@eigenpal/sdk 0.20.19 → 0.20.21

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/sdk
 
+## 0.20.21
+
+### Minor Changes
+
+- 7e2ebe0: Pass execution tags when starting workflow or agent runs with the TypeScript and Python SDKs, including runs with file inputs. Filter run history by tag using the runs client.
+
 ## 0.20.9
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/sdk",
-  "version": "0.20.19",
+  "version": "0.20.21",
   "description": "Official TypeScript SDK for the EigenPal API",
   "type": "module",
   "main": "./src/index.ts",
@@ -19,7 +19,6 @@
     "codegen": "openapi-ts -f openapi-ts.config.ts && bun run scripts/postprocess-generated.ts",
     "codegen:check": "bun run codegen && git diff --exit-code src/generated/",
     "build": "tsc",
-    "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "test": "bun test"
   },

package/src/client.ts

@@ -98,6 +98,7 @@ export type RunInput = Record<string, unknown>;
 
 /** Third argument to `client.run()` — transport knobs, not workflow/agent input. */
 export interface RunCallOptions {
+  tags?: string | string[];
   waitForCompletion?: number;
   overrides?: { steps?: Record<string, Record<string, unknown>> };
   metadata?: Record<string, unknown>;
@@ -254,6 +255,7 @@ export class EigenpalClient {
         input: preparedInput,
         overrides: options.overrides,
         metadata: options.metadata,
+        tags: options.tags,
       });
       return this._request<RunStartResponse>(
         () =>
@@ -268,7 +270,10 @@ export class EigenpalClient {
       );
     }
 
-    const body = buildRunJsonBody(pathTarget, preparedInput, options.overrides, options.metadata);
+    const body = {
+      ...buildRunJsonBody(pathTarget, preparedInput, options.overrides, options.metadata),
+      ...(options.tags !== undefined ? { tags: options.tags } : {}),
+    };
     return this._request<RunStartResponse>(
       () =>
         this.client.post({

package/src/generated/types.gen.ts

@@ -393,6 +393,7 @@ export type UpdateFolderRequest = {
  * Run envelope. Declare provenance with the `X-Eigenpal-Trigger` header (`api` or `cli`). Legacy 0.5.12 body shapes remain accepted.
  */
 export type RunStartBody = {
+    tags?: string | Array<string>;
     /**
      * Automation target without a version suffix, e.g. workflows.invoice or agents.support.
      */
@@ -468,6 +469,10 @@ export type RunStartBody = {
 };
 
 export type RunStartMultipartRequest = {
+    /**
+     * JSON string or string array of exact execution tags
+     */
+    tags?: string;
     /**
      * Automation target, e.g. `workflows.invoice`.
      */
@@ -1760,6 +1765,7 @@ export type RunsListResponse = {
 };
 
 export type RunListItem = {
+    tags: Array<string>;
     id: string;
     type: 'workflow' | 'agent';
     /**
@@ -1942,6 +1948,7 @@ export type RunHumanReviewSummary = {
 };
 
 export type Run = {
+    tags: Array<string>;
     id: string;
     type: 'workflow' | 'agent';
     /**
@@ -7239,6 +7246,10 @@ export type RunsListData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Exact, case-sensitive execution tag
+         */
+        tag?: string;
         type?: string;
         source?: string;
         status?: string;

package/src/lib/files.ts

@@ -369,12 +369,14 @@ export function buildRunJsonBody(
  */
 export async function buildRunMultipart(args: {
   target: string;
+  tags?: string | string[];
   input?: Record<string, unknown>;
   overrides?: { steps?: Record<string, Record<string, unknown>> };
   metadata?: Record<string, unknown>;
 }): Promise<MultipartParts> {
   const fd = new FormData();
   fd.append('target', args.target);
+  if (args.tags !== undefined) fd.append('tags', JSON.stringify(args.tags));
   const { scalars, fileCount } = await appendFiles(fd, args.input);
   fd.append('input', JSON.stringify(scalars));
   if (args.overrides) {

package/src/telemetry.ts

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