@eigenpal/sdk 0.6.8 → 0.6.9

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/sdk
 
+## 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/package.json

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

package/src/generated/index.ts

@@ -199,6 +199,7 @@ export type {
   CopyAgentExecutionOutputToExpectedBody,
   CreateAgentBody,
   CreateAgentResponse,
+  ExecutionObservability,
   ExecutionStatus,
   ExecutionSummary,
   GetAgentResponse,

package/src/generated/types.gen.ts

@@ -266,9 +266,59 @@ export type AgentExecutionSummary = {
   expectedFiles?: Array<{
     name: string;
   }>;
+  observability?: ExecutionObservability;
   [key: string]: unknown;
 };
 
+export type ExecutionObservability = {
+  phases: Array<{
+    executionId: string;
+    phase:
+      | 'queued'
+      | 'starting'
+      | 'preparing_inputs'
+      | 'preparing_environment'
+      | 'installing_dependencies'
+      | 'running'
+      | 'collecting_outputs'
+      | 'finalizing';
+    phaseOrder: number;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled';
+    startedAt?: string | null;
+    completedAt?: string | null;
+    message?: string | null;
+    failureCode?: string | null;
+    durationMs?: number | null;
+  }>;
+  currentPhase?:
+    | 'queued'
+    | 'starting'
+    | 'preparing_inputs'
+    | 'preparing_environment'
+    | 'installing_dependencies'
+    | 'running'
+    | 'collecting_outputs'
+    | 'finalizing';
+  failure?: {
+    phase:
+      | 'queued'
+      | 'starting'
+      | 'preparing_inputs'
+      | 'preparing_environment'
+      | 'installing_dependencies'
+      | 'running'
+      | 'collecting_outputs'
+      | 'finalizing';
+    code: string;
+    category: 'input' | 'source' | 'environment' | 'runtime' | 'output' | 'finalization' | 'system';
+    provider?: string;
+    retryable: boolean;
+    userMessage: string;
+    occurredAt: string;
+  };
+  derived: boolean;
+};
+
 export type ListAgentVersionsResponse = {
   agentId: string;
   slug: string;
@@ -280,6 +330,12 @@ export type ListAgentVersionsResponse = {
     commit: string;
     notes: string | null;
     createdAt: string | null;
+    createdByUser: {
+      id: string;
+      email: string;
+      name: string | null;
+      image: string | null;
+    } | null;
     latest: boolean;
   }>;
 };
@@ -460,6 +516,7 @@ export type ExecutionSummary = {
     id: string;
     name: string;
   } | null;
+  observability?: ExecutionObservability;
 };
 
 export type WorkflowDetail = {
@@ -561,6 +618,7 @@ export type WorkflowExecutionStatusResponse = {
    * Error message (status=failed)
    */
   error?: string | null;
+  observability?: ExecutionObservability;
 };
 
 export type ListWorkflowsResponse = {

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