@ellipsis-dev/sdk 0.1.0 → 0.2.1

package/dist/{types-BRE4NMnS.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;
@@ -876,9 +968,9 @@ interface operations {
 }
 
 /**
- * One server-to-client frame of the Ellipsis session stream protocol v2 (WS /v1/sessions/{id}/stream?protocol=2). Clients MUST ignore frames with unknown `type` values — additive frames are not a protocol break.
+ * One server-to-client frame of the Ellipsis session stream protocol v3 (WS /v1/sessions/{id}/stream?protocol=3). Clients MUST ignore frames with unknown `type` values — additive frames are not a protocol break.
  */
-type SessionStreamFrame = SnapshotFrame | RecordsAppendFrame | MessagesFrame | SessionFrame | DeltaFrame | HeartbeatFrame | DoneFrame | ErrorFrame;
+type SessionStreamFrame = SnapshotFrame | RecordsAppendFrame | SessionFrame | DeltaFrame | HeartbeatFrame | DoneFrame | ErrorFrame;
 type AttributionType = 'github_user' | 'linear_user' | 'slack_user' | 'api_key';
 type SessionMessageStatus = 'pending' | 'delivered';
 type GithubAccountType = 'User' | 'Organization' | 'Bot' | 'Mannequin';
@@ -1123,17 +1215,6 @@ interface TurnTokensInfo {
     input_tokens: number;
     output_tokens: number;
 }
-/**
- * LWW snapshot of the OPEN inbox slice: all PENDING rows plus rows that
- * flipped (delivered, re-pended) within this connection since the last frame.
- * Deliberately not the full message history — delivered rows render through
- * their transcript user-echo records; structural history stays on REST
- * /turns (§3.3).
- */
-interface MessagesFrame {
-    messages: SessionMessageWire[];
-    type: 'messages';
-}
 /**
  * LWW snapshot of the enriched public session (§4.1) — the only way
  * status/state/cost arrive. Resent whole on any field change.
@@ -1188,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, MessagesFrame 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, ModelTokensInfo as m, SendSessionMessageRequest as n, SessionFrame as o, SessionLiveness as p, SessionMessageStatus as q, SessionRecordWire as r, SessionState as s, SessionStreamFrame as t, SessionSurface as u, SnapshotFrame as v, StreamFrame as w, TurnTokensInfo as x, components as y, paths as z };
+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.1.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/frames.schema.json

@@ -757,30 +757,6 @@
       "title": "HeartbeatFrame",
       "type": "object"
     },
-    "MessagesFrame": {
-      "description": "LWW snapshot of the OPEN inbox slice: all PENDING rows plus rows that\nflipped (delivered, re-pended) within this connection since the last frame.\nDeliberately not the full message history \u2014 delivered rows render through\ntheir transcript user-echo records; structural history stays on REST\n/turns (\u00a73.3).",
-      "properties": {
-        "messages": {
-          "items": {
-            "$ref": "#/$defs/SessionMessageWire"
-          },
-          "title": "Messages",
-          "type": "array"
-        },
-        "type": {
-          "const": "messages",
-          "default": "messages",
-          "title": "Type",
-          "type": "string"
-        }
-      },
-      "required": [
-        "messages",
-        "type"
-      ],
-      "title": "MessagesFrame",
-      "type": "object"
-    },
     "ModelTokensInfo": {
       "properties": {
         "cache_creation_input_tokens": {
@@ -1243,7 +1219,7 @@
           "type": "array"
         },
         "protocol": {
-          "default": 2,
+          "default": 3,
           "title": "Protocol",
           "type": "integer"
         },
@@ -1396,7 +1372,7 @@
     }
   },
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "One server-to-client frame of the Ellipsis session stream protocol v2 (WS /v1/sessions/{id}/stream?protocol=2). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
+  "description": "One server-to-client frame of the Ellipsis session stream protocol v3 (WS /v1/sessions/{id}/stream?protocol=3). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
   "oneOf": [
     {
       "$ref": "#/$defs/SnapshotFrame"
@@ -1404,9 +1380,6 @@
     {
       "$ref": "#/$defs/RecordsAppendFrame"
     },
-    {
-      "$ref": "#/$defs/MessagesFrame"
-    },
     {
       "$ref": "#/$defs/SessionFrame"
     },