@ellipsis-dev/sdk 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, S as SessionMessageWire } from './types-F94JllmC.js';
-export { b as AgentSessionExitStatus, c as AgentSessionPr, d as AgentSessionSource, e as AgentSessionStatus, f as AgentTurn, g as AgentTurnStatus, h as AttributionType, B as BudgetSource, D as DefaultResolution, i as DeltaFrame, j as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, k as GithubAccountType, H as Harness, l as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, R as RecordsAppendFrame, m as SendSessionMessageRequest, n as SessionFrame, o as SessionLiveness, p as SessionMessageStatus, q as SessionRecordWire, r as SessionState, s as SessionStreamFrame, t as SessionSurface, u as SnapshotFrame, v as StreamFrame, T as TokensInfo, w as TurnTokensInfo, x as components, y as paths } from './types-F94JllmC.js';
+import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire } from './types-CtvSTnzA.js';
+export { c as AgentSessionExitStatus, d as AgentSessionPr, e as AgentSessionSource, f as AgentSessionStatus, g as AgentTurn, h as AgentTurnStatus, i as AttributionType, B as BudgetSource, D as DefaultResolution, j as DeltaFrame, k as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, l as GithubAccountType, H as Harness, m as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, R as RecordsAppendFrame, n as SendSessionMessageRequest, o as SessionExecutionWire, p as SessionFrame, q as SessionLiveness, r as SessionMessageStatus, s as SessionRecordWire, t as SessionState, u as SessionStreamFrame, v as SessionSurface, w as SnapshotFrame, x as StreamFrame, T as TokensInfo, y as TurnTokensInfo, z as components, C as paths } from './types-CtvSTnzA.js';
 
 type FetchJson = (path: string, init?: {
     method?: string;
@@ -14,9 +14,10 @@ declare class EllipsisClient {
         limit?: number;
     }): Promise<ListSessionRecordsResponse>;
     getSessionTurns(sessionId: string): Promise<ListSessionTurnsResponse>;
+    getSessionExecutions(sessionId: string): Promise<ListSessionExecutionsResponse>;
     sendSessionMessage(sessionId: string, message: string, options?: {
         idempotencyKey?: string;
     }): Promise<SessionMessageWire>;
 }
 
-export { AgentSessionWire, EllipsisClient, type FetchJson, ListSessionRecordsResponse, ListSessionTurnsResponse, SessionMessageWire };
+export { AgentSessionWire, EllipsisClient, type FetchJson, ListSessionExecutionsResponse, ListSessionRecordsResponse, ListSessionTurnsResponse, SessionMessageWire };

package/dist/index.js

@@ -30,6 +30,16 @@ var EllipsisClient = class {
       `/v1/sessions/${encodeURIComponent(sessionId)}/turns`
     );
   }
+  // The session's executions (initial start, cold wakes, infra retries) with
+  // their launch context: `system_prompt_append` is the text Ellipsis appends
+  // to Claude Code's default system prompt, alongside the initial query and
+  // model. Per execution because each cold wake persists its own launch
+  // config.
+  async getSessionExecutions(sessionId) {
+    return await this.fetchJson(
+      `/v1/sessions/${encodeURIComponent(sessionId)}/executions`
+    );
+  }
   // Send a message into the session's inbox (§4.2). Returns the created (or,
   // on an idempotent retry, the original) inbox row — clients key optimistic
   // echo chips on its id. `idempotencyKey` makes retries safe per

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { q as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, v as StreamFrame } from '../types-F94JllmC.js';
+import { s as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, x as StreamFrame } from '../types-CtvSTnzA.js';
 
 interface ChatToolNode {
     key: string;

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { v as StreamFrame, A as AgentSessionWire } from '../types-F94JllmC.js';
+import { x as StreamFrame, A as AgentSessionWire } from '../types-CtvSTnzA.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;

package/dist/{types-F94JllmC.d.ts → types-CtvSTnzA.d.ts}

@@ -16,6 +16,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/sessions/{session_id}/executions': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Agent Session Executions */
+        get: operations['get_agent_session_executions_v1_sessions__session_id__executions_get'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/sessions/{session_id}/messages': {
         parameters: {
             query?: never;
@@ -348,6 +365,14 @@ interface components {
          * @enum {string}
          */
         DefaultResolution: 'repo_default' | 'account_default' | 'none';
+        /**
+         * ExecutionStatus
+         * @description Per-execution status ladder (was AgentProcessStatus). Distinct from the
+         *     session's durable `session_state` and from `agent_sessions.status`, which
+         *     remains the atomic claim/dispatch guard.
+         * @enum {string}
+         */
+        ExecutionStatus: 'running' | 'failed' | 'done';
         /**
          * GithubAccountSnippet
          * @description Sometimes the GitHub API returns a user of github (can include bots)
@@ -380,6 +405,11 @@ interface components {
          * @enum {string}
          */
         Harness: 'claude_code';
+        /** ListSessionExecutionsResponse */
+        ListSessionExecutionsResponse: {
+            /** Executions */
+            executions: components['schemas']['SessionExecutionWire'][];
+        };
         /** ListSessionRecordsResponse */
         ListSessionRecordsResponse: {
             /** Earliest Feed Seq */
@@ -476,6 +506,35 @@ interface components {
             /** Message */
             message: string;
         };
+        /** SessionExecutionWire */
+        SessionExecutionWire: {
+            /** Agent Session Id */
+            agent_session_id: string;
+            /** Attempt Index */
+            attempt_index: number;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Execution Index */
+            execution_index: number;
+            /** Exit Status */
+            exit_status?: string | null;
+            /** Id */
+            id: string;
+            /** Model */
+            model?: string | null;
+            /** Query */
+            query?: string | null;
+            /** Resumed */
+            resumed: boolean;
+            status: components['schemas']['ExecutionStatus'];
+            /** System Prompt Append */
+            system_prompt_append?: string | null;
+            /** Wake Index */
+            wake_index: number;
+        };
         /**
          * SessionLiveness
          * @description The durable conversation axis (backs the surfaced `session` field).
@@ -767,6 +826,39 @@ interface operations {
             };
         };
     };
+    get_agent_session_executions_v1_sessions__session_id__executions_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ListSessionExecutionsResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     send_agent_session_message_v1_sessions__session_id__messages_post: {
         parameters: {
             query?: never;
@@ -1177,5 +1269,7 @@ type ListSessionRecordsResponse = components['schemas']['ListSessionRecordsRespo
 type ListSessionTurnsResponse = components['schemas']['ListSessionTurnsResponse'];
 type AgentTurn = components['schemas']['AgentTurn'];
 type AgentTurnStatus = components['schemas']['AgentTurnStatus'];
+type ListSessionExecutionsResponse = components['schemas']['ListSessionExecutionsResponse'];
+type SessionExecutionWire = components['schemas']['SessionExecutionWire'];
 
-export type { AgentSessionWire as A, BudgetSource as B, DefaultResolution as D, ErrorFrame as E, GithubAccountSnippet as G, Harness as H, ListSessionRecordsResponse as L, ModelTokensInfo as M, ParentKind as P, RecordsAppendFrame as R, SessionMessageWire as S, TokensInfo as T, ListSessionTurnsResponse as a, AgentSessionExitStatus as b, AgentSessionPr as c, AgentSessionSource as d, AgentSessionStatus as e, AgentTurn as f, AgentTurnStatus as g, AttributionType as h, DeltaFrame as i, DoneFrame as j, GithubAccountType as k, HeartbeatFrame as l, SendSessionMessageRequest as m, SessionFrame as n, SessionLiveness as o, SessionMessageStatus as p, SessionRecordWire as q, SessionState as r, SessionStreamFrame as s, SessionSurface as t, SnapshotFrame as u, StreamFrame as v, TurnTokensInfo as w, components as x, paths as y };
+export type { AgentSessionWire as A, BudgetSource as B, paths as C, DefaultResolution as D, ErrorFrame as E, GithubAccountSnippet as G, Harness as H, ListSessionRecordsResponse as L, ModelTokensInfo as M, ParentKind as P, RecordsAppendFrame as R, SessionMessageWire as S, TokensInfo as T, ListSessionTurnsResponse as a, ListSessionExecutionsResponse as b, AgentSessionExitStatus as c, AgentSessionPr as d, AgentSessionSource as e, AgentSessionStatus as f, AgentTurn as g, AgentTurnStatus as h, AttributionType as i, DeltaFrame as j, DoneFrame as k, GithubAccountType as l, HeartbeatFrame as m, SendSessionMessageRequest as n, SessionExecutionWire as o, SessionFrame as p, SessionLiveness as q, SessionMessageStatus as r, SessionRecordWire as s, SessionState as t, SessionStreamFrame as u, SessionSurface as v, SnapshotFrame as w, StreamFrame as x, TurnTokensInfo as y, components as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "TypeScript SDK for the Ellipsis agents platform: /v1 REST types + client, the session stream WebSocket client, and the session transcript store.",
   "license": "MIT",
   "type": "module",

package/schema/openapi.v1.json

@@ -733,6 +733,16 @@
         "title": "DefaultResolution",
         "type": "string"
       },
+      "ExecutionStatus": {
+        "description": "Per-execution status ladder (was AgentProcessStatus). Distinct from the\nsession's durable `session_state` and from `agent_sessions.status`, which\nremains the atomic claim/dispatch guard.",
+        "enum": [
+          "running",
+          "failed",
+          "done"
+        ],
+        "title": "ExecutionStatus",
+        "type": "string"
+      },
       "GithubAccountSnippet": {
         "description": "Sometimes the GitHub API returns a user of github (can include bots)\nusing this snippet instead of the full GithubAccount model. One example,\nis when the API returns a pull request.\n\nThis is the least amount of info we need to represent a GitHub account.",
         "properties": {
@@ -791,6 +801,22 @@
         "title": "Harness",
         "type": "string"
       },
+      "ListSessionExecutionsResponse": {
+        "properties": {
+          "executions": {
+            "items": {
+              "$ref": "#/components/schemas/SessionExecutionWire"
+            },
+            "title": "Executions",
+            "type": "array"
+          }
+        },
+        "required": [
+          "executions"
+        ],
+        "title": "ListSessionExecutionsResponse",
+        "type": "object"
+      },
       "ListSessionRecordsResponse": {
         "properties": {
           "earliest_feed_seq": {
@@ -947,6 +973,98 @@
         "title": "SendSessionMessageRequest",
         "type": "object"
       },
+      "SessionExecutionWire": {
+        "properties": {
+          "agent_session_id": {
+            "title": "Agent Session Id",
+            "type": "string"
+          },
+          "attempt_index": {
+            "title": "Attempt Index",
+            "type": "integer"
+          },
+          "created_at": {
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "execution_index": {
+            "title": "Execution Index",
+            "type": "integer"
+          },
+          "exit_status": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Exit Status"
+          },
+          "id": {
+            "title": "Id",
+            "type": "string"
+          },
+          "model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Model"
+          },
+          "query": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Query"
+          },
+          "resumed": {
+            "title": "Resumed",
+            "type": "boolean"
+          },
+          "status": {
+            "$ref": "#/components/schemas/ExecutionStatus"
+          },
+          "system_prompt_append": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "System Prompt Append"
+          },
+          "wake_index": {
+            "title": "Wake Index",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "agent_session_id",
+          "created_at",
+          "execution_index",
+          "wake_index",
+          "attempt_index",
+          "resumed",
+          "status"
+        ],
+        "title": "SessionExecutionWire",
+        "type": "object"
+      },
       "SessionLiveness": {
         "description": "The durable conversation axis (backs the surfaced `session` field).",
         "enum": [
@@ -1626,6 +1744,69 @@
         ]
       }
     },
+    "/v1/sessions/{session_id}/executions": {
+      "get": {
+        "operationId": "get_agent_session_executions_v1_sessions__session_id__executions_get",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "session_id",
+            "required": true,
+            "schema": {
+              "title": "Session Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListSessionExecutionsResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Agent Session Executions",
+        "tags": [
+          "v1"
+        ]
+      }
+    },
     "/v1/sessions/{session_id}/messages": {
       "post": {
         "operationId": "send_agent_session_message_v1_sessions__session_id__messages_post",