@eigenpal/sdk 0.6.8 → 0.6.10

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @eigenpal/sdk
 
+## 0.6.10
+
+### Patch Changes
+
+- 99ca1b4: Unify agent and workflow run commands and SDK helpers on the shared `/api/v1/runs` API, including the public `client.runs` facade and regenerated SDK reference docs.
+
+## 0.6.9
+
+### Minor Changes
+
+- 5e7c051: Add `observability` (phase timeline + structured failure) to workflow execution and agent run status API responses.
+
 ## 0.6.4
 
 ### Patch Changes

package/README.md

@@ -106,18 +106,32 @@ await client.workflows.run('extract-invoice', {
 ## Execution polling
 
 ```ts
-const status = await client.workflows.executions.get(executionId);
+const runs = await client.runs.list({
+  type: 'workflow',
+  source: 'extract-invoice',
+  status: 'failed,cancelled',
+});
+
+const run = await client.runs.get(executionId, { include: 'detail' });
+await client.runs.cancel(executionId);
+
+const status = await client.runs.get(executionId);
 //   { executionId, status, result?, error?, createdAt, completedAt? }
 
-const list = await client.workflows.executions.list('extract-invoice', {
+const list = await client.runs.list({
+  type: 'workflow',
+  source: 'extract-invoice',
   status: ['failed', 'cancelled'],
-  fromDate: 'now()-7d',
+  from: 'now()-7d',
   limit: 50,
 });
 
-await client.workflows.executions.cancel(executionId);
+await client.runs.cancel(executionId);
 ```
 
+`/api/v1/runs` is the shared run API for workflow, agent, and eval runs. Use `type=workflow|agent`
+and `source=<workflowId-or-agentId>` to scope list calls.
+
 ## Workflows
 
 ```ts
@@ -136,10 +150,13 @@ const { executionId } = await client.agents.run('invoice-agent', {
   invoice: file,
 });
 
-await client.agents.runs.get(runId);
-await client.agents.runs.cancel(runId);
+await client.runs.get(executionId);
+await client.runs.cancel(executionId);
 ```
 
+Agent run listing uses the same shared runs API with `type: 'agent'` and the agent id or slug as
+`source`.
+
 ## Errors
 
 Every non-2xx response throws a typed subclass of `EigenpalError`:

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@eigenpal/sdk",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "description": "Official TypeScript SDK for the EigenPal API",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./generated": "./src/generated/index.ts"
   },
   "files": [
     "src",

package/src/client.ts

@@ -3,6 +3,7 @@ import { createClient, createConfig, type Client, type Config } from './generate
 import type { ApiErrorEnvelope } from './generated/types.gen';
 import { AgentsResource } from './resources/agents';
 import { AutomationsResource } from './resources/automations';
+import { RunsResource } from './resources/runs';
 import { SourceResource } from './resources/source';
 import { WorkflowsResource } from './resources/workflows';
 import { buildTelemetryHeaders } from './telemetry';
@@ -80,6 +81,8 @@ export class EigenpalClient {
   public readonly source: SourceResource;
   /** Automation operations: sync public automation metadata from source. */
   public readonly automations: AutomationsResource;
+  /** Tenant-wide run operations across workflow, agent, manual, and eval runs. */
+  public readonly runs: RunsResource;
 
   /** Underlying hey-api client. Use `getRawClient()` for advanced cases. */
   private readonly client: Client;
@@ -124,6 +127,7 @@ export class EigenpalClient {
     this.agents = new AgentsResource(this.client, this._request.bind(this));
     this.source = new SourceResource(this.client, this._request.bind(this));
     this.automations = new AutomationsResource(this.client, this._request.bind(this));
+    this.runs = new RunsResource(this.client, this._request.bind(this));
   }
 
   /** Expose the underlying hey-api client for advanced use (custom interceptors, etc.). */

package/src/generated/index.ts

@@ -8,19 +8,6 @@ export {
   agentsGet,
   agentsList,
   agentsRun,
-  agentsRunsCancel,
-  agentsRunsExpectedCreate,
-  agentsRunsExpectedDelete,
-  agentsRunsExpectedDownload,
-  agentsRunsExpectedList,
-  agentsRunsExpectedRename,
-  agentsRunsFeedbackDelete,
-  agentsRunsFeedbackGet,
-  agentsRunsFeedbackUpdate,
-  agentsRunsFilesDownload,
-  agentsRunsGet,
-  agentsRunsList,
-  agentsRunsRerun,
   agentsTriggersEmailCreateAlias,
   agentsTriggersEmailDeleteAlias,
   agentsTriggersEmailGet,
@@ -30,15 +17,33 @@ export {
   agentsUpdate,
   agentsVersionsList,
   automationsSync,
+  runsArtifactGet,
+  runsCancel,
+  runsComparisonGet,
+  runsConnect,
+  runsExpectedCreate,
+  runsExpectedFileDelete,
+  runsExpectedFileGet,
+  runsExpectedFileUpdate,
+  runsExpectedGet,
+  runsFeedbackClear,
+  runsFeedbackGet,
+  runsFeedbackUpdate,
+  runsFilesDelete,
+  runsFilesList,
+  runsFilesUpload,
+  runsFilesZipGet,
+  runsGet,
+  runsList,
+  runsRerun,
+  runsResume,
+  runsTraceGet,
   sourceLockfilePreview,
   sourceRaw,
   sourceReleases,
   sourceRepository,
   sourceSecretsDecrypt,
   sourceSecretsEncrypt,
-  workflowsExecutionsCancel,
-  workflowsExecutionsGet,
-  workflowsExecutionsList,
   workflowsGet,
   workflowsList,
   workflowsRun,
@@ -46,11 +51,6 @@ export {
   type Options,
 } from './sdk.gen';
 export type {
-  AgentExecutionExpectedArtifacts,
-  AgentExecutionFeedback,
-  AgentExecutionFeedbackDetail,
-  AgentExecutionSummary,
-  AgentRunResponse,
   AgentSummary,
   AgentsCreateData,
   AgentsCreateError,
@@ -82,69 +82,6 @@ export type {
   AgentsRunErrors,
   AgentsRunResponse,
   AgentsRunResponses,
-  AgentsRunsCancelData,
-  AgentsRunsCancelError,
-  AgentsRunsCancelErrors,
-  AgentsRunsCancelResponse,
-  AgentsRunsCancelResponses,
-  AgentsRunsExpectedCreateData,
-  AgentsRunsExpectedCreateError,
-  AgentsRunsExpectedCreateErrors,
-  AgentsRunsExpectedCreateResponse,
-  AgentsRunsExpectedCreateResponses,
-  AgentsRunsExpectedDeleteData,
-  AgentsRunsExpectedDeleteError,
-  AgentsRunsExpectedDeleteErrors,
-  AgentsRunsExpectedDeleteResponse,
-  AgentsRunsExpectedDeleteResponses,
-  AgentsRunsExpectedDownloadData,
-  AgentsRunsExpectedDownloadError,
-  AgentsRunsExpectedDownloadErrors,
-  AgentsRunsExpectedDownloadResponses,
-  AgentsRunsExpectedListData,
-  AgentsRunsExpectedListError,
-  AgentsRunsExpectedListErrors,
-  AgentsRunsExpectedListResponse,
-  AgentsRunsExpectedListResponses,
-  AgentsRunsExpectedRenameData,
-  AgentsRunsExpectedRenameError,
-  AgentsRunsExpectedRenameErrors,
-  AgentsRunsExpectedRenameResponse,
-  AgentsRunsExpectedRenameResponses,
-  AgentsRunsFeedbackDeleteData,
-  AgentsRunsFeedbackDeleteError,
-  AgentsRunsFeedbackDeleteErrors,
-  AgentsRunsFeedbackDeleteResponse,
-  AgentsRunsFeedbackDeleteResponses,
-  AgentsRunsFeedbackGetData,
-  AgentsRunsFeedbackGetError,
-  AgentsRunsFeedbackGetErrors,
-  AgentsRunsFeedbackGetResponse,
-  AgentsRunsFeedbackGetResponses,
-  AgentsRunsFeedbackUpdateData,
-  AgentsRunsFeedbackUpdateError,
-  AgentsRunsFeedbackUpdateErrors,
-  AgentsRunsFeedbackUpdateResponse,
-  AgentsRunsFeedbackUpdateResponses,
-  AgentsRunsFilesDownloadData,
-  AgentsRunsFilesDownloadError,
-  AgentsRunsFilesDownloadErrors,
-  AgentsRunsFilesDownloadResponses,
-  AgentsRunsGetData,
-  AgentsRunsGetError,
-  AgentsRunsGetErrors,
-  AgentsRunsGetResponse,
-  AgentsRunsGetResponses,
-  AgentsRunsListData,
-  AgentsRunsListError,
-  AgentsRunsListErrors,
-  AgentsRunsListResponse,
-  AgentsRunsListResponses,
-  AgentsRunsRerunData,
-  AgentsRunsRerunError,
-  AgentsRunsRerunErrors,
-  AgentsRunsRerunResponse,
-  AgentsRunsRerunResponses,
   AgentsTriggersEmailCreateAliasData,
   AgentsTriggersEmailCreateAliasError,
   AgentsTriggersEmailCreateAliasErrors,
@@ -193,32 +130,133 @@ export type {
   AutomationsSyncErrors,
   AutomationsSyncResponse,
   AutomationsSyncResponses,
-  CancelAgentExecutionResponse,
-  CancelWorkflowExecutionResponse,
   ClientOptions,
-  CopyAgentExecutionOutputToExpectedBody,
   CreateAgentBody,
   CreateAgentResponse,
   ExecutionStatus,
-  ExecutionSummary,
   GetAgentResponse,
-  ListAgentRunsResponse,
   ListAgentVersionsResponse,
   ListAgentsResponse,
   ListVersionsResponse,
-  ListWorkflowExecutionsResponse,
   ListWorkflowsResponse,
   PatchAgentBody,
   PatchAgentResponse,
   RawSourceResponse,
-  RenameExpectedFileBody,
-  RenameExpectedFileResponse,
-  RerunAgentRunBody,
-  RerunAgentRunResponse,
   RunAgentBody,
   RunAgentResponse,
+  RunEnvelope,
+  RunFeedbackRequest,
+  RunFilesResponse,
+  RunRerunRequest,
+  RunRerunResponse,
+  RunResumeResponse,
+  RunSummary,
   RunWorkflowBody,
   RunWorkflowResponse,
+  RunsArtifactGetData,
+  RunsArtifactGetError,
+  RunsArtifactGetErrors,
+  RunsArtifactGetResponses,
+  RunsCancelData,
+  RunsCancelError,
+  RunsCancelErrors,
+  RunsCancelResponse,
+  RunsCancelResponses,
+  RunsComparisonGetData,
+  RunsComparisonGetError,
+  RunsComparisonGetErrors,
+  RunsComparisonGetResponse,
+  RunsComparisonGetResponses,
+  RunsConnectData,
+  RunsConnectError,
+  RunsConnectErrors,
+  RunsConnectResponse,
+  RunsConnectResponses,
+  RunsExpectedCreateData,
+  RunsExpectedCreateError,
+  RunsExpectedCreateErrors,
+  RunsExpectedCreateResponse,
+  RunsExpectedCreateResponses,
+  RunsExpectedFileDeleteData,
+  RunsExpectedFileDeleteError,
+  RunsExpectedFileDeleteErrors,
+  RunsExpectedFileDeleteResponse,
+  RunsExpectedFileDeleteResponses,
+  RunsExpectedFileGetData,
+  RunsExpectedFileGetError,
+  RunsExpectedFileGetErrors,
+  RunsExpectedFileGetResponses,
+  RunsExpectedFileUpdateData,
+  RunsExpectedFileUpdateError,
+  RunsExpectedFileUpdateErrors,
+  RunsExpectedFileUpdateResponse,
+  RunsExpectedFileUpdateResponses,
+  RunsExpectedGetData,
+  RunsExpectedGetError,
+  RunsExpectedGetErrors,
+  RunsExpectedGetResponse,
+  RunsExpectedGetResponses,
+  RunsFeedbackClearData,
+  RunsFeedbackClearError,
+  RunsFeedbackClearErrors,
+  RunsFeedbackClearResponse,
+  RunsFeedbackClearResponses,
+  RunsFeedbackGetData,
+  RunsFeedbackGetError,
+  RunsFeedbackGetErrors,
+  RunsFeedbackGetResponse,
+  RunsFeedbackGetResponses,
+  RunsFeedbackUpdateData,
+  RunsFeedbackUpdateError,
+  RunsFeedbackUpdateErrors,
+  RunsFeedbackUpdateResponse,
+  RunsFeedbackUpdateResponses,
+  RunsFilesDeleteData,
+  RunsFilesDeleteError,
+  RunsFilesDeleteErrors,
+  RunsFilesDeleteResponse,
+  RunsFilesDeleteResponses,
+  RunsFilesListData,
+  RunsFilesListError,
+  RunsFilesListErrors,
+  RunsFilesListResponse,
+  RunsFilesListResponses,
+  RunsFilesUploadBody,
+  RunsFilesUploadData,
+  RunsFilesUploadError,
+  RunsFilesUploadErrors,
+  RunsFilesUploadResponse,
+  RunsFilesUploadResponses,
+  RunsFilesZipGetData,
+  RunsFilesZipGetError,
+  RunsFilesZipGetErrors,
+  RunsFilesZipGetResponses,
+  RunsGetData,
+  RunsGetError,
+  RunsGetErrors,
+  RunsGetResponse,
+  RunsGetResponses,
+  RunsListData,
+  RunsListError,
+  RunsListErrors,
+  RunsListResponse,
+  RunsListResponse2,
+  RunsListResponses,
+  RunsRerunData,
+  RunsRerunError,
+  RunsRerunErrors,
+  RunsRerunResponse,
+  RunsRerunResponses,
+  RunsResumeData,
+  RunsResumeError,
+  RunsResumeErrors,
+  RunsResumeResponse,
+  RunsResumeResponses,
+  RunsTraceGetData,
+  RunsTraceGetError,
+  RunsTraceGetErrors,
+  RunsTraceGetResponse,
+  RunsTraceGetResponses,
   Schema0,
   SourceLockfilePreviewData,
   SourceLockfilePreviewError,
@@ -257,26 +295,9 @@ export type {
   SourceSecretsEncryptResponse,
   SourceSecretsEncryptResponse2,
   SourceSecretsEncryptResponses,
-  UpdateAgentExecutionFeedbackBody,
   WorkflowDetail,
-  WorkflowExecutionStatusResponse,
   WorkflowSummary,
   WorkflowVersion,
-  WorkflowsExecutionsCancelData,
-  WorkflowsExecutionsCancelError,
-  WorkflowsExecutionsCancelErrors,
-  WorkflowsExecutionsCancelResponse,
-  WorkflowsExecutionsCancelResponses,
-  WorkflowsExecutionsGetData,
-  WorkflowsExecutionsGetError,
-  WorkflowsExecutionsGetErrors,
-  WorkflowsExecutionsGetResponse,
-  WorkflowsExecutionsGetResponses,
-  WorkflowsExecutionsListData,
-  WorkflowsExecutionsListError,
-  WorkflowsExecutionsListErrors,
-  WorkflowsExecutionsListResponse,
-  WorkflowsExecutionsListResponses,
   WorkflowsGetData,
   WorkflowsGetError,
   WorkflowsGetErrors,