@eigenpal/sdk 0.5.11 → 0.6.0

package/src/index.ts

@@ -34,11 +34,8 @@ export {
 
 export { toFile } from './lib/files';
 export type { FileDescriptor, FileInput, NodeReadableStream } from './lib/files';
-export type {
-  ListAgentExecutionsOptions,
-  ListAgentsOptions,
-  RunAgentOptions,
-} from './resources/agents';
+export type { ListAgentRunsOptions, ListAgentsOptions, RunAgentOptions } from './resources/agents';
+export type { SourceRawOptions, SourceReleasesOptions } from './resources/source';
 export type {
   ListVersionsOptions,
   ListWorkflowsOptions,
@@ -57,24 +54,32 @@ export type {
   AgentExecutionExpectedArtifacts,
   AgentExecutionFeedback,
   AgentExecutionFeedbackDetail,
-  AgentExecutionResponse,
   AgentExecutionSummary,
+  AgentRunResponse,
   AgentSummary,
   ApiErrorEnvelope,
   ApiErrorIssue,
+  AutomationSyncResponse,
   CancelAgentExecutionResponse,
   CancelWorkflowExecutionResponse,
   ExecutionStatus,
   ExecutionSummary,
   GetAgentResponse,
-  ListAgentExecutionsResponse,
+  ListAgentRunsResponse,
   ListAgentsResponse,
   ListVersionsResponse,
   ListWorkflowExecutionsResponse,
   ListWorkflowsResponse,
+  RawSourceResponse,
   RunAgentResponse,
   RunWorkflowBody,
   RunWorkflowResponse,
+  SourceLockfileResponse,
+  SourceReleasesResponse,
+  SourceRepositoryResponse,
+  SourceSecretsDecryptBody,
+  SourceSecretsDecryptResponse,
+  WorkflowDetail,
   WorkflowExecutionStatusResponse,
   WorkflowSummary,
   WorkflowVersion,

package/src/resources/agents.ts

@@ -3,43 +3,42 @@ import { EigenpalError } from '../errors';
 import type { Client } from '../generated/client';
 import {
   agentsCreate,
-  agentsExecutionsCancel,
-  agentsExecutionsExpectedCreate,
-  agentsExecutionsExpectedDelete,
-  agentsExecutionsExpectedDownload,
-  agentsExecutionsExpectedList,
-  agentsExecutionsExpectedRename,
-  agentsExecutionsFeedbackDelete,
-  agentsExecutionsFeedbackGet,
-  agentsExecutionsFeedbackUpdate,
-  agentsExecutionsFilesDownload,
-  agentsExecutionsGet,
-  agentsExecutionsList,
-  agentsExecutionsRerun,
   agentsFilesListOrGet,
   agentsFilesPut,
   agentsFilesUploadBatch,
   agentsGet,
   agentsList,
   agentsRun,
+  agentsRunsCancel,
+  agentsRunsExpectedCreate,
+  agentsRunsExpectedDelete,
+  agentsRunsExpectedDownload,
+  agentsRunsExpectedList,
+  agentsRunsExpectedRename,
+  agentsRunsFeedbackDelete,
+  agentsRunsFeedbackGet,
+  agentsRunsFeedbackUpdate,
+  agentsRunsFilesDownload,
+  agentsRunsGet,
+  agentsRunsList,
+  agentsRunsRerun,
   agentsUpdate,
 } from '../generated/sdk.gen';
 import type {
   AgentExecutionExpectedArtifacts,
   AgentExecutionFeedbackDetail,
-  AgentExecutionResponse,
-  AgentFileBody,
-  AgentFilesBody,
+  AgentRunResponse,
+  CancelAgentExecutionResponse,
   CopyAgentExecutionOutputToExpectedBody,
   CreateAgentBody,
   CreateAgentResponse,
   GetAgentResponse,
-  ListAgentExecutionsResponse,
+  ListAgentRunsResponse,
   ListAgentsResponse,
   PatchAgentBody,
   PatchAgentResponse,
   RenameExpectedFileBody,
-  RerunAgentExecutionResponse,
+  RerunAgentRunResponse,
   RunAgentResponse,
   UpdateAgentExecutionFeedbackBody,
 } from '../generated/types.gen';
@@ -57,14 +56,15 @@ export interface ListAgentsOptions {
 
 export interface RunAgentOptions {
   waitForCompletion?: number;
+  sourceRef?: string;
   signal?: AbortSignal;
 }
 
-export interface ListAgentExecutionsOptions {
+export interface ListAgentRunsOptions {
   status?: string;
   batchId?: string;
-  exampleName?: string;
-  exampleNameContains?: string;
+  exampleId?: string;
+  exampleIdContains?: string;
   createdAfter?: string;
   createdBefore?: string;
   completedAfter?: string;
@@ -87,7 +87,7 @@ export interface ListAgentExecutionsOptions {
   promotedExampleName?: string;
   sinceLastResolved?: boolean;
   include?: string;
-  sort?: 'createdAt' | 'completedAt' | 'status' | 'exampleName';
+  sort?: 'createdAt' | 'completedAt' | 'status' | 'exampleId';
   order?: 'asc' | 'desc';
   scanLimit?: number;
   limit?: number;
@@ -97,31 +97,28 @@ export interface ListAgentExecutionsOptions {
 
 export type AgentExecutionFileKind = 'input' | 'output' | 'issues' | 'trace';
 
-export class AgentExecutionsResource {
+export class AgentRunsResource {
   constructor(
     private readonly client: Client,
     private readonly dispatch: Dispatch
   ) {}
 
-  async list(
-    agentId: string,
-    options: ListAgentExecutionsOptions = {}
-  ): Promise<ListAgentExecutionsResponse> {
+  async list(agentId: string, options: ListAgentRunsOptions = {}): Promise<ListAgentRunsResponse> {
     const { signal, ...query } = options;
     return this.dispatch(() =>
-      agentsExecutionsList({ client: this.client, path: { agentId }, query, signal })
+      agentsRunsList({ client: this.client, path: { agentId }, query, signal })
     );
   }
 
   async get(
-    executionId: string,
+    runId: string,
     options: { include?: string; signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionResponse> {
+  ): Promise<AgentRunResponse> {
     const { signal, include } = options;
     return this.dispatch(() =>
-      agentsExecutionsGet({
+      agentsRunsGet({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         query: include ? { include } : {},
         signal,
       })
@@ -129,53 +126,53 @@ export class AgentExecutionsResource {
   }
 
   async cancel(
-    executionId: string,
+    runId: string,
     options: { signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionResponse> {
+  ): Promise<CancelAgentExecutionResponse> {
     return this.dispatch(() =>
-      agentsExecutionsCancel({
+      agentsRunsCancel({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         signal: options.signal,
       })
     );
   }
 
   async rerun(
-    executionId: string,
+    runId: string,
     options: { signal?: AbortSignal } = {}
-  ): Promise<RerunAgentExecutionResponse> {
+  ): Promise<RerunAgentRunResponse> {
     return this.dispatch(() =>
-      agentsExecutionsRerun({
+      agentsRunsRerun({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         signal: options.signal,
       })
     );
   }
 
   async getFeedback(
-    executionId: string,
+    runId: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<AgentExecutionFeedbackDetail> {
     return this.dispatch(() =>
-      agentsExecutionsFeedbackGet({
+      agentsRunsFeedbackGet({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         signal: options.signal,
       })
     );
   }
 
   async updateFeedback(
-    executionId: string,
+    runId: string,
     body: UpdateAgentExecutionFeedbackBody,
     options: { signal?: AbortSignal } = {}
   ): Promise<AgentExecutionFeedbackDetail> {
     return this.dispatch(() =>
-      agentsExecutionsFeedbackUpdate({
+      agentsRunsFeedbackUpdate({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         body,
         signal: options.signal,
       })
@@ -183,40 +180,40 @@ export class AgentExecutionsResource {
   }
 
   async clearFeedback(
-    executionId: string,
+    runId: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<AgentExecutionFeedbackDetail> {
     return this.dispatch(() =>
-      agentsExecutionsFeedbackDelete({
+      agentsRunsFeedbackDelete({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         signal: options.signal,
       })
     );
   }
 
   async listExpected(
-    executionId: string,
+    runId: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<AgentExecutionExpectedArtifacts> {
     return this.dispatch(() =>
-      agentsExecutionsExpectedList({
+      agentsRunsExpectedList({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         signal: options.signal,
       })
     );
   }
 
   async copyOutputToExpected(
-    executionId: string,
+    runId: string,
     body: CopyAgentExecutionOutputToExpectedBody,
     options: { signal?: AbortSignal } = {}
   ): Promise<{ name: string }> {
     return this.dispatch(() =>
-      agentsExecutionsExpectedCreate({
+      agentsRunsExpectedCreate({
         client: this.client,
-        path: { executionId },
+        path: { runId },
         body,
         signal: options.signal,
       })
@@ -224,15 +221,15 @@ export class AgentExecutionsResource {
   }
 
   async renameExpected(
-    executionId: string,
+    runId: string,
     filename: string,
     body: RenameExpectedFileBody,
     options: { signal?: AbortSignal } = {}
   ): Promise<{ name: string }> {
     return this.dispatch(() =>
-      agentsExecutionsExpectedRename({
+      agentsRunsExpectedRename({
         client: this.client,
-        path: { executionId, filename },
+        path: { runId, filename },
         body,
         signal: options.signal,
       })
@@ -240,21 +237,21 @@ export class AgentExecutionsResource {
   }
 
   async deleteExpected(
-    executionId: string,
+    runId: string,
     filename: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<void> {
     await this.dispatch(() =>
-      agentsExecutionsExpectedDelete({
+      agentsRunsExpectedDelete({
         client: this.client,
-        path: { executionId, filename },
+        path: { runId, filename },
         signal: options.signal,
       })
     );
   }
 
   async uploadExpected(
-    executionId: string,
+    runId: string,
     file: Blob,
     options: { name?: string; signal?: AbortSignal } = {}
   ): Promise<{ name: string }> {
@@ -264,8 +261,8 @@ export class AgentExecutionsResource {
     return this.dispatch(
       () =>
         this.client.post({
-          url: '/api/v1/agents/executions/{executionId}/expected',
-          path: { executionId },
+          url: '/api/v1/agents/runs/{runId}/expected',
+          path: { runId },
           body: formData,
           bodySerializer: null,
           headers: { 'Content-Type': null },
@@ -275,15 +272,15 @@ export class AgentExecutionsResource {
   }
 
   async downloadExpected(
-    executionId: string,
+    runId: string,
     filename: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<Blob> {
     return this.downloadBlob(
       () =>
-        agentsExecutionsExpectedDownload({
+        agentsRunsExpectedDownload({
           client: this.client,
-          path: { executionId, filename },
+          path: { runId, filename },
           parseAs: 'blob',
           signal: options.signal,
         }) as Promise<OperationResult<Blob>>
@@ -291,16 +288,16 @@ export class AgentExecutionsResource {
   }
 
   async downloadFile(
-    executionId: string,
+    runId: string,
     kind: AgentExecutionFileKind,
     filename: string,
     options: { signal?: AbortSignal } = {}
   ): Promise<Blob> {
     return this.downloadBlob(
       () =>
-        agentsExecutionsFilesDownload({
+        agentsRunsFilesDownload({
           client: this.client,
-          path: { executionId, kind, filename },
+          path: { runId, kind, filename },
           parseAs: 'blob',
           signal: options.signal,
         }) as Promise<OperationResult<Blob>>
@@ -319,13 +316,13 @@ export class AgentExecutionsResource {
 }
 
 export class AgentsResource {
-  public readonly executions: AgentExecutionsResource;
+  public readonly runs: AgentRunsResource;
 
   constructor(
     private readonly client: Client,
     private readonly dispatch: Dispatch
   ) {
-    this.executions = new AgentExecutionsResource(client, dispatch);
+    this.runs = new AgentRunsResource(client, dispatch);
   }
 
   async list(options: ListAgentsOptions = {}): Promise<ListAgentsResponse> {
@@ -352,9 +349,9 @@ export class AgentsResource {
   async putFile(
     agentId: string,
     path: string,
-    body: AgentFileBody,
+    body: Record<string, unknown>,
     options: { signal?: AbortSignal } = {}
-  ): Promise<{ ok: boolean; path: string }> {
+  ): Promise<unknown> {
     return this.dispatch(() =>
       agentsFilesPut({
         client: this.client,
@@ -368,9 +365,9 @@ export class AgentsResource {
 
   async uploadFiles(
     agentId: string,
-    body: AgentFilesBody,
+    body: Record<string, unknown>,
     options: { signal?: AbortSignal } = {}
-  ): Promise<{ ok: boolean; files: string[] }> {
+  ): Promise<unknown> {
     return this.dispatch(() =>
       agentsFilesUploadBatch({
         client: this.client,
@@ -403,10 +400,12 @@ export class AgentsResource {
     input?: WorkflowInput,
     options: RunAgentOptions = {}
   ): Promise<RunAgentResponse> {
-    const query =
-      options.waitForCompletion !== undefined
+    const query = {
+      ...(options.waitForCompletion !== undefined
         ? { wait_for_completion: options.waitForCompletion }
-        : {};
+        : {}),
+      ...(options.sourceRef !== undefined ? { sourceRef: options.sourceRef } : {}),
+    };
 
     if (hasFileInput(input)) {
       const { formData } = await buildAgentMultipart(input);
@@ -429,7 +428,10 @@ export class AgentsResource {
         client: this.client,
         path: { agentId },
         query,
-        body: { ...(input !== undefined ? { input } : {}) },
+        body: {
+          ...(input !== undefined ? { input } : {}),
+          ...(options.sourceRef !== undefined ? { sourceRef: options.sourceRef } : {}),
+        },
         signal: options.signal,
       })
     );

package/src/resources/automations.ts

@@ -0,0 +1,22 @@
+import type { OperationResult } from '../client';
+import type { Client } from '../generated/client';
+import { automationsSync } from '../generated/sdk.gen';
+import type { AutomationSyncResponse } from '../generated/types.gen';
+
+type Dispatch = <T>(call: () => Promise<OperationResult<T>>) => Promise<T>;
+
+export class AutomationsResource {
+  constructor(
+    private readonly client: Client,
+    private readonly dispatch: Dispatch
+  ) {}
+
+  async sync(
+    automation: string,
+    options: { signal?: AbortSignal } = {}
+  ): Promise<AutomationSyncResponse> {
+    return this.dispatch(() =>
+      automationsSync({ client: this.client, path: { automation }, signal: options.signal })
+    );
+  }
+}

package/src/resources/source.ts

@@ -0,0 +1,85 @@
+import type { OperationResult } from '../client';
+import type { Client } from '../generated/client';
+import {
+  sourceLockfilePreview,
+  sourceRaw,
+  sourceReleases,
+  sourceRepository,
+  sourceSecretsDecrypt,
+} from '../generated/sdk.gen';
+import type {
+  RawSourceResponse,
+  SourceLockfileResponse,
+  SourceReleasesResponse,
+  SourceRepositoryResponse,
+  SourceSecretsDecryptBody,
+  SourceSecretsDecryptResponse,
+} from '../generated/types.gen';
+
+type Dispatch = <T>(call: () => Promise<OperationResult<T>>) => Promise<T>;
+
+export interface SourceRawOptions {
+  ref?: string;
+  signal?: AbortSignal;
+}
+
+export interface SourceReleasesOptions {
+  version?: string;
+  signal?: AbortSignal;
+}
+
+export class SourceResource {
+  constructor(
+    private readonly client: Client,
+    private readonly dispatch: Dispatch
+  ) {}
+
+  async repository(options: { signal?: AbortSignal } = {}): Promise<SourceRepositoryResponse> {
+    return this.dispatch(() => sourceRepository({ client: this.client, signal: options.signal }));
+  }
+
+  async raw(path: string, options: SourceRawOptions = {}): Promise<RawSourceResponse> {
+    const { signal, ref = 'main' } = options;
+    return this.dispatch(() => sourceRaw({ client: this.client, query: { path, ref }, signal }));
+  }
+
+  async releases(
+    packagePath: string,
+    options: SourceReleasesOptions = {}
+  ): Promise<SourceReleasesResponse> {
+    const { signal, version } = options;
+    return this.dispatch(() =>
+      sourceReleases({
+        client: this.client,
+        query: { packagePath, ...(version !== undefined ? { version } : {}) },
+        signal,
+      })
+    );
+  }
+
+  async lockfile(
+    packageRef: string,
+    options: { signal?: AbortSignal } = {}
+  ): Promise<SourceLockfileResponse> {
+    return this.dispatch(() =>
+      sourceLockfilePreview({
+        client: this.client,
+        query: { packageRef },
+        signal: options.signal,
+      })
+    );
+  }
+
+  async decryptSecrets(
+    body: SourceSecretsDecryptBody,
+    options: { signal?: AbortSignal } = {}
+  ): Promise<SourceSecretsDecryptResponse> {
+    return this.dispatch(() =>
+      sourceSecretsDecrypt({
+        client: this.client,
+        body,
+        signal: options.signal,
+      })
+    );
+  }
+}

package/src/resources/workflows.ts

@@ -10,7 +10,7 @@ import type {
   ListVersionsResponse,
   ListWorkflowsResponse,
   RunWorkflowResponse,
-  WorkflowSummary,
+  WorkflowDetail,
 } from '../generated/types.gen';
 import { buildMultipart, hasFileInput } from '../lib/files';
 import { WorkflowExecutionsResource } from './executions';
@@ -135,8 +135,8 @@ export class WorkflowsResource {
     return this.dispatch(() => workflowsList({ client: this.client, query, signal }));
   }
 
-  /** Get a single workflow by id. */
-  async get(workflowId: string, options: { signal?: AbortSignal } = {}): Promise<WorkflowSummary> {
+  /** Get a single workflow by id. Includes the current version's YAML. */
+  async get(workflowId: string, options: { signal?: AbortSignal } = {}): Promise<WorkflowDetail> {
     return this.dispatch(() =>
       workflowsGet({ client: this.client, path: { id: workflowId }, signal: options.signal })
     );

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.5.11';
+export const SDK_VERSION = '0.6.0';
 
 function detectRuntime(): string {
   const g = globalThis as unknown as {