@eigenpal/sdk 0.6.8 → 0.6.10

package/src/index.ts

@@ -34,12 +34,8 @@ export {
 
 export { toFile } from './lib/files';
 export type { FileDescriptor, FileInput, NodeReadableStream } from './lib/files';
-export type {
-  AgentExecutionFileKind,
-  ListAgentRunsOptions,
-  ListAgentsOptions,
-  RunAgentOptions,
-} from './resources/agents';
+export type { ListAgentsOptions, RunAgentOptions } from './resources/agents';
+export type { ListRunsOptions } from './resources/runs';
 export type { SourceRawOptions, SourceReleasesOptions } from './resources/source';
 export type {
   ListVersionsOptions,
@@ -51,16 +47,11 @@ export type {
 // SDK perspective you always upload a file; fileId is an internal wire id
 // the server creates after upload — not something users construct.
 
-export type { ListExecutionsOptions, RunAndWaitOptions } from './resources/executions';
+export type { RunAndWaitOptions } from './resources/executions';
 
 // Re-export the canonical generated types so users can type their own
 // callbacks and helpers without reaching into `./generated`.
 export type {
-  AgentExecutionExpectedArtifacts,
-  AgentExecutionFeedback,
-  AgentExecutionFeedbackDetail,
-  AgentExecutionSummary,
-  AgentRunResponse,
   AgentSummary,
   AgentsTriggersEmailCreateAliasData,
   AgentsTriggersEmailCreateAliasResponse,
@@ -74,20 +65,27 @@ export type {
   ApiErrorEnvelope,
   ApiErrorIssue,
   AutomationSyncResponse,
-  CancelAgentExecutionResponse,
-  CancelWorkflowExecutionResponse,
   ExecutionStatus,
-  ExecutionSummary,
   GetAgentResponse,
-  ListAgentRunsResponse,
   ListAgentsResponse,
   ListVersionsResponse,
-  ListWorkflowExecutionsResponse,
   ListWorkflowsResponse,
   RawSourceResponse,
   RunAgentResponse,
+  RunSummary,
   RunWorkflowBody,
   RunWorkflowResponse,
+  RunsCancelResponse,
+  RunsExpectedCreateResponse,
+  RunsExpectedFileDeleteResponse,
+  RunsExpectedFileUpdateResponse,
+  RunsExpectedGetResponse,
+  RunsFeedbackClearResponse,
+  RunsFeedbackUpdateResponse,
+  RunsGetResponse,
+  RunsListResponse,
+  RunsRerunResponse,
+  RunsResumeResponse,
   SourceLockfileResponse,
   SourceReleasesResponse,
   SourceRepositoryResponse,
@@ -96,7 +94,6 @@ export type {
   SourceSecretsEncryptBody,
   SourceSecretsEncryptResponse,
   WorkflowDetail,
-  WorkflowExecutionStatusResponse,
   WorkflowSummary,
   WorkflowVersion,
 } from './generated/types.gen';

package/src/resources/agents.ts

@@ -1,5 +1,4 @@
 import type { OperationResult } from '../client';
-import { EigenpalError } from '../errors';
 import type { Client } from '../generated/client';
 import {
   agentsCreate,
@@ -9,18 +8,6 @@ import {
   agentsGet,
   agentsList,
   agentsRun,
-  agentsRunsCancel,
-  agentsRunsExpectedCreate,
-  agentsRunsExpectedDelete,
-  agentsRunsExpectedDownload,
-  agentsRunsExpectedList,
-  agentsRunsExpectedRename,
-  agentsRunsFeedbackDelete,
-  agentsRunsFeedbackGet,
-  agentsRunsFeedbackUpdate,
-  agentsRunsGet,
-  agentsRunsList,
-  agentsRunsRerun,
   agentsTriggersEmailCreateAlias,
   agentsTriggersEmailDeleteAlias,
   agentsTriggersEmailGet,
@@ -31,9 +18,6 @@ import {
   agentsVersionsList,
 } from '../generated/sdk.gen';
 import type {
-  AgentExecutionExpectedArtifacts,
-  AgentExecutionFeedbackDetail,
-  AgentRunResponse,
   AgentsTriggersEmailCreateAliasData,
   AgentsTriggersEmailCreateAliasResponse,
   AgentsTriggersEmailDeleteAliasResponse,
@@ -43,20 +27,14 @@ import type {
   AgentsTriggersEmailUpdateAliasResponse,
   AgentsTriggersEmailUpdateData,
   AgentsTriggersEmailUpdateResponse,
-  CancelAgentExecutionResponse,
-  CopyAgentExecutionOutputToExpectedBody,
   CreateAgentBody,
   CreateAgentResponse,
   GetAgentResponse,
-  ListAgentRunsResponse,
   ListAgentVersionsResponse,
   ListAgentsResponse,
   PatchAgentBody,
   PatchAgentResponse,
-  RenameExpectedFileBody,
-  RerunAgentRunResponse,
   RunAgentResponse,
-  UpdateAgentExecutionFeedbackBody,
 } from '../generated/types.gen';
 import { buildAgentMultipart, hasFileInput } from '../lib/files';
 import type { WorkflowInput } from './workflows';
@@ -76,43 +54,6 @@ export interface RunAgentOptions {
   signal?: AbortSignal;
 }
 
-export interface ListAgentRunsOptions {
-  status?: string;
-  batchId?: string;
-  exampleId?: string;
-  exampleIdContains?: string;
-  createdAfter?: string;
-  createdBefore?: string;
-  completedAfter?: string;
-  completedBefore?: string;
-  feedbackStatus?: 'open' | 'resolved' | 'ignored';
-  feedbackRating?: 'pass' | 'fail' | 'partial' | 'none';
-  hasFeedback?: boolean;
-  noFeedback?: boolean;
-  hasExpected?: boolean;
-  hasExpectedJson?: boolean;
-  hasExpectedFiles?: boolean;
-  feedbackBodyContains?: string;
-  feedbackCreatedAfter?: string;
-  feedbackCreatedBefore?: string;
-  feedbackUpdatedAfter?: string;
-  feedbackUpdatedBefore?: string;
-  feedbackResolvedAfter?: string;
-  feedbackResolvedBefore?: string;
-  promotedToExample?: boolean;
-  promotedExampleName?: string;
-  sinceLastResolved?: boolean;
-  include?: string;
-  sort?: 'createdAt' | 'completedAt' | 'status' | 'exampleId';
-  order?: 'asc' | 'desc';
-  scanLimit?: number;
-  limit?: number;
-  offset?: number;
-  signal?: AbortSignal;
-}
-
-export type AgentExecutionFileKind = 'input' | 'output' | 'issues' | 'trace' | 'lockfile';
-
 export class AgentEmailTriggersResource {
   constructor(
     private readonly client: Client,
@@ -199,252 +140,13 @@ export class AgentEmailTriggersResource {
   }
 }
 
-export class AgentRunsResource {
-  constructor(
-    private readonly client: Client,
-    private readonly dispatch: Dispatch
-  ) {}
-
-  async list(agentId: string, options: ListAgentRunsOptions = {}): Promise<ListAgentRunsResponse> {
-    const { signal, ...query } = options;
-    return this.dispatch(() =>
-      agentsRunsList({ client: this.client, path: { agentId }, query, signal })
-    );
-  }
-
-  async get(
-    runId: string,
-    options: { include?: string; signal?: AbortSignal } = {}
-  ): Promise<AgentRunResponse> {
-    const { signal, include } = options;
-    return this.dispatch(() =>
-      agentsRunsGet({
-        client: this.client,
-        path: { runId },
-        query: include ? { include } : {},
-        signal,
-      })
-    );
-  }
-
-  async cancel(
-    runId: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<CancelAgentExecutionResponse> {
-    return this.dispatch(() =>
-      agentsRunsCancel({
-        client: this.client,
-        path: { runId },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async rerun(
-    runId: string,
-    options: { sourceRef?: string; signal?: AbortSignal } = {}
-  ): Promise<RerunAgentRunResponse> {
-    return this.dispatch(() =>
-      agentsRunsRerun({
-        client: this.client,
-        path: { runId },
-        body: {
-          ...(options.sourceRef !== undefined ? { sourceRef: options.sourceRef } : {}),
-        },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async getFeedback(
-    runId: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionFeedbackDetail> {
-    return this.dispatch(() =>
-      agentsRunsFeedbackGet({
-        client: this.client,
-        path: { runId },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async updateFeedback(
-    runId: string,
-    body: UpdateAgentExecutionFeedbackBody,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionFeedbackDetail> {
-    return this.dispatch(() =>
-      agentsRunsFeedbackUpdate({
-        client: this.client,
-        path: { runId },
-        body,
-        signal: options.signal,
-      })
-    );
-  }
-
-  async clearFeedback(
-    runId: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionFeedbackDetail> {
-    return this.dispatch(() =>
-      agentsRunsFeedbackDelete({
-        client: this.client,
-        path: { runId },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async listExpected(
-    runId: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<AgentExecutionExpectedArtifacts> {
-    return this.dispatch(() =>
-      agentsRunsExpectedList({
-        client: this.client,
-        path: { runId },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async copyOutputToExpected(
-    runId: string,
-    body: CopyAgentExecutionOutputToExpectedBody,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<{ name: string }> {
-    return this.dispatch(() =>
-      agentsRunsExpectedCreate({
-        client: this.client,
-        path: { runId },
-        body,
-        signal: options.signal,
-      })
-    );
-  }
-
-  async renameExpected(
-    runId: string,
-    filename: string,
-    body: RenameExpectedFileBody,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<{ name: string }> {
-    return this.dispatch(() =>
-      agentsRunsExpectedRename({
-        client: this.client,
-        path: { runId, filename },
-        body,
-        signal: options.signal,
-      })
-    );
-  }
-
-  async deleteExpected(
-    runId: string,
-    filename: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<void> {
-    await this.dispatch(() =>
-      agentsRunsExpectedDelete({
-        client: this.client,
-        path: { runId, filename },
-        signal: options.signal,
-      })
-    );
-  }
-
-  async uploadExpected(
-    runId: string,
-    file: Blob,
-    options: { name?: string; signal?: AbortSignal } = {}
-  ): Promise<{ name: string }> {
-    const formData = new FormData();
-    formData.set('file', file);
-    if (options.name) formData.set('name', options.name);
-    return this.dispatch(
-      () =>
-        this.client.post({
-          url: '/api/v1/agents/runs/{runId}/expected',
-          path: { runId },
-          body: formData,
-          bodySerializer: null,
-          headers: { 'Content-Type': null },
-          signal: options.signal,
-        }) as Promise<OperationResult<{ name: string }>>
-    );
-  }
-
-  async downloadExpected(
-    runId: string,
-    filename: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<Blob> {
-    return this.downloadBlob(
-      () =>
-        agentsRunsExpectedDownload({
-          client: this.client,
-          path: { runId, filename },
-          parseAs: 'blob',
-          signal: options.signal,
-        }) as Promise<OperationResult<Blob>>
-    );
-  }
-
-  async downloadFile(
-    runId: string,
-    artifactPathOrKind: string,
-    filenameOrOptions?: string | { signal?: AbortSignal },
-    options: { signal?: AbortSignal } = {}
-  ): Promise<Blob> {
-    const artifactPath =
-      typeof filenameOrOptions === 'string'
-        ? artifactPathForKind(artifactPathOrKind as AgentExecutionFileKind, filenameOrOptions)
-        : artifactPathOrKind;
-    const requestOptions =
-      typeof filenameOrOptions === 'string' ? options : (filenameOrOptions ?? {});
-    return this.downloadBlob(
-      () =>
-        this.client.get({
-          url: `/api/v1/agents/runs/${encodeURIComponent(runId)}/files/${encodeArtifactPath(
-            artifactPath
-          )}`,
-          parseAs: 'blob',
-          signal: requestOptions.signal,
-        }) as Promise<OperationResult<Blob>>
-    );
-  }
-
-  private async downloadBlob(call: () => Promise<OperationResult<Blob>>): Promise<Blob> {
-    const result = await call();
-    if (result.response?.ok && result.data instanceof Blob) {
-      return result.data;
-    }
-    throw new EigenpalError('Failed to download agent execution artifact.', {
-      status: result.response?.status ?? 0,
-    });
-  }
-}
-
-function artifactPathForKind(kind: AgentExecutionFileKind, filename: string): string {
-  if (kind === 'issues' || kind === 'trace' || kind === 'lockfile') return filename;
-  return `${kind}/${filename}`;
-}
-
-function encodeArtifactPath(artifactPath: string): string {
-  return artifactPath.split('/').map(encodeURIComponent).join('/');
-}
-
 export class AgentsResource {
-  public readonly runs: AgentRunsResource;
   public readonly emailTriggers: AgentEmailTriggersResource;
 
   constructor(
     private readonly client: Client,
     private readonly dispatch: Dispatch
   ) {
-    this.runs = new AgentRunsResource(client, dispatch);
     this.emailTriggers = new AgentEmailTriggersResource(client, dispatch);
   }
 

package/src/resources/executions.ts

@@ -1,34 +1,11 @@
 import type { OperationResult } from '../client';
 import { EigenpalTimeoutError } from '../errors';
 import type { Client } from '../generated/client';
-import {
-  workflowsExecutionsCancel,
-  workflowsExecutionsGet,
-  workflowsExecutionsList,
-  workflowsRun,
-} from '../generated/sdk.gen';
-import type {
-  CancelWorkflowExecutionResponse,
-  ExecutionStatus,
-  ListWorkflowExecutionsResponse,
-  RunWorkflowResponse,
-  WorkflowExecutionStatusResponse,
-} from '../generated/types.gen';
+import { runsGet, workflowsRun } from '../generated/sdk.gen';
+import type { ExecutionStatus, RunsGetResponse, RunWorkflowResponse } from '../generated/types.gen';
 import { buildMultipart, hasFileInput } from '../lib/files';
 import type { WorkflowInput } from './workflows';
 
-export interface ListExecutionsOptions {
-  /** Execution status, or an array of statuses. */
-  status?: string | string[];
-  /** ISO timestamp or relative expression like `"now()-7d"`. */
-  fromDate?: string;
-  toDate?: string;
-  exampleId?: string;
-  limit?: number;
-  offset?: number;
-  signal?: AbortSignal;
-}
-
 export interface RunAndWaitOptions {
   /** Workflow version. Default: `"latest"`. */
   version?: string;
@@ -58,9 +35,9 @@ const DEFAULT_RUN_AND_WAIT_TIMEOUT_MS = 5 * 60 * 1000;
 type Dispatch = <T>(call: () => Promise<OperationResult<T>>) => Promise<T>;
 
 /**
- * Workflow execution resource — read execution status, list executions, cancel
- * in-flight executions, and the convenience `runAndWait` helper that wraps a
- * workflow trigger + client-side poll loop. Reached via `client.workflows.executions`.
+ * Workflow execution helper namespace. Retrieval and mutation of existing runs
+ * lives on `client.runs`; this namespace only keeps `runAndWait` because it
+ * triggers a workflow before polling.
  */
 export class WorkflowExecutionsResource {
   constructor(
@@ -68,55 +45,6 @@ export class WorkflowExecutionsResource {
     private readonly dispatch: Dispatch
   ) {}
 
-  /** Get execution status. Pass `includeSteps` for the full per-step payload. */
-  async get(
-    executionId: string,
-    options: { includeSteps?: boolean; signal?: AbortSignal } = {}
-  ): Promise<WorkflowExecutionStatusResponse> {
-    return this.dispatch<WorkflowExecutionStatusResponse>(
-      () =>
-        workflowsExecutionsGet({
-          client: this.client,
-          path: { executionId },
-          query: options.includeSteps ? { includeSteps: 'true' } : {},
-          signal: options.signal,
-        }) as Promise<OperationResult<WorkflowExecutionStatusResponse>>
-    );
-  }
-
-  /** List executions, paginated. */
-  async list(
-    workflowId: string,
-    options: ListExecutionsOptions = {}
-  ): Promise<ListWorkflowExecutionsResponse> {
-    const { signal, status, ...rest } = options;
-    // Wire format takes comma-separated lists; idiomatic JS callers can
-    // pass a string[] and we serialize.
-    const query = {
-      ...rest,
-      ...(status !== undefined
-        ? { status: Array.isArray(status) ? status.join(',') : status }
-        : {}),
-    };
-    return this.dispatch(() =>
-      workflowsExecutionsList({ client: this.client, path: { id: workflowId }, query, signal })
-    );
-  }
-
-  /** Cancel an execution. Idempotent. */
-  async cancel(
-    executionId: string,
-    options: { signal?: AbortSignal } = {}
-  ): Promise<CancelWorkflowExecutionResponse> {
-    return this.dispatch(() =>
-      workflowsExecutionsCancel({
-        client: this.client,
-        path: { executionId },
-        signal: options.signal,
-      })
-    );
-  }
-
   /**
    * Trigger a workflow and poll for completion client-side.
    *
@@ -180,7 +108,20 @@ export class WorkflowExecutionsResource {
         );
       }
 
-      const status = await this.get(executionId, { signal: options.signal });
+      const response = await this.dispatch<RunsGetResponse>(
+        () =>
+          runsGet({
+            client: this.client,
+            path: { id: executionId },
+            query: { include: 'detail' },
+            signal: options.signal,
+          }) as Promise<OperationResult<RunsGetResponse>>
+      );
+      const status = response.run as {
+        status?: ExecutionStatus | null;
+        result?: unknown;
+        error?: string | null;
+      };
 
       if (status.status && TERMINAL_STATUSES.has(status.status)) {
         return {