@ellipsis-dev/sdk 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire, C as CreateReviewRequest, R as Review, c as ListReviewsResponse } from './types-C63IVgov.js';
-export { d as AgentSessionExitStatus, e as AgentSessionPr, f as AgentSessionSource, g as AgentSessionStatus, h as AgentTurn, i as AgentTurnStatus, j as AttributionType, B as BudgetSource, D as DefaultResolution, k as DeltaFrame, l as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, m as GithubAccountType, H as Harness, n as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, o as PromptBlockedReason, p as RecordsAppendFrame, q as ResolvedReviewScope, r as ReviewCounters, s as ReviewScope, t as ReviewScopeKind, u as SendSessionMessageRequest, v as SessionExecutionWire, w as SessionFrame, x as SessionLiveness, y as SessionMessageStatus, z as SessionPrompting, I as SessionRecordWire, J as SessionState, K as SessionStreamFrame, N as SessionSurface, O as SnapshotFrame, Q as StreamFrame, T as TokensInfo, U as TurnTokensInfo, V as components, W as paths } from './types-C63IVgov.js';
+import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire, C as CreateReviewRequest, R as Review, c as ListReviewsResponse } from './types-BoKi5b8D.js';
+export { d as AgentSessionExitStatus, e as AgentSessionPr, f as AgentSessionSource, g as AgentSessionStatus, h as AgentTurn, i as AgentTurnStatus, j as AttributionType, B as BudgetSource, D as DefaultResolution, k as DeltaFrame, l as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, m as GithubAccountType, H as Harness, n as HeartbeatFrame, P as ParentKind, o as PromptBlockedReason, p as RecordsAppendFrame, q as ResolvedReviewScope, r as ReviewCounters, s as ReviewScope, t as ReviewScopeKind, u as SendSessionMessageRequest, v as SessionExecutionWire, w as SessionFrame, x as SessionLiveness, y as SessionMessageStatus, z as SessionPrompting, I as SessionRecordWire, J as SessionState, K as SessionStreamFrame, M as SessionSurface, N as SnapshotFrame, O as StreamFrame, T as TokensInfo, Q as components, U as paths } from './types-BoKi5b8D.js';
 
 type FetchJson = (path: string, init?: {
     method?: string;

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { I as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, Q as StreamFrame } from '../types-C63IVgov.js';
+import { I as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, O as StreamFrame } from '../types-BoKi5b8D.js';
 
 interface ChatToolNode {
     key: string;

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { Q as StreamFrame, A as AgentSessionWire } from '../types-C63IVgov.js';
+import { O as StreamFrame, A as AgentSessionWire } from '../types-BoKi5b8D.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;

package/dist/{types-C63IVgov.d.ts → types-BoKi5b8D.d.ts}

@@ -517,7 +517,7 @@ interface components {
          *     `value`, when set, is a literal injected as-is — use it for non-secret
          *     config (LOG_LEVEL, an API base URL). When `value` is omitted the value is
          *     resolved at run time from the customer's sandbox-variables store (dashboard
-         *     / `PUT /sandboxes/variables`) by `name`, so a secret can be injected without
+         *     / `PUT /v1/variables`) by `name`, so a secret can be injected without
          *     ever putting it in the config file. Either way the variable only reaches
          *     agents that name it.
          */
@@ -584,7 +584,7 @@ interface components {
          *     a deliberate cancellation. It is None until the run reaches a terminal state.
          * @enum {string}
          */
-        AgentSessionExitStatus: 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
+        AgentSessionExitStatus: 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
         /**
          * AgentSessionPr
          * @description A pull request this session created, denormalized at capture time so
@@ -1050,34 +1050,6 @@ interface components {
             /** Turns */
             turns: components['schemas']['AgentTurn'][];
         };
-        /** ModelTokensInfo */
-        ModelTokensInfo: {
-            /**
-             * Cache Creation Input Tokens
-             * @default 0
-             */
-            cache_creation_input_tokens: number;
-            /**
-             * Cache Read Input Tokens
-             * @default 0
-             */
-            cache_read_input_tokens: number;
-            /**
-             * Cost Usd
-             * @default 0
-             */
-            cost_usd: number;
-            /**
-             * Input Tokens
-             * @default 0
-             */
-            input_tokens: number;
-            /**
-             * Output Tokens
-             * @default 0
-             */
-            output_tokens: number;
-        };
         /**
          * ParentKind
          * @description How a session relates to its predecessor (parent_agent_session_id) —
@@ -1618,7 +1590,19 @@ interface components {
             /** Status */
             status: string | null;
         };
-        /** TokensInfo */
+        /**
+         * TokensInfo
+         * @description Token/cost usage, per record (one API call's counts, aggregate fields at
+         *     their zero defaults) or aggregated per execution/session
+         *     (compute_spend_from_records derives num_turns and cost_usd).
+         *
+         *     Strict on purpose: this is our own persisted schema, so an unknown key is a
+         *     writer bug (the num_turns=0 bug shipped because a Claude Code usage dict
+         *     validated leniently against this model, silently zeroing every
+         *     non-overlapping field). Legacy keys were dropped from persisted blobs by
+         *     the 2026-07-26 tokens_info migration; per-model usage lives on
+         *     `execution.model_usage` (CC's modelUsage, verbatim).
+         */
         TokensInfo: {
             /**
              * Cache Creation Input Tokens
@@ -1635,11 +1619,6 @@ interface components {
              * @default 0
              */
             cost_usd: number;
-            /**
-             * Initial System Prompt Tokens
-             * @default 0
-             */
-            initial_system_prompt_tokens: number;
             /**
              * Input Tokens
              * @default 0
@@ -1655,46 +1634,6 @@ interface components {
              * @default 0
              */
             output_tokens: number;
-            /**
-             * Per Model
-             * @default {}
-             */
-            per_model: {
-                [key: string]: components['schemas']['ModelTokensInfo'];
-            };
-            /**
-             * Per Turn
-             * @default []
-             */
-            per_turn: components['schemas']['TurnTokensInfo'][];
-            /**
-             * Thinking Tokens
-             * @default 0
-             */
-            thinking_tokens: number;
-        };
-        /** TurnTokensInfo */
-        TurnTokensInfo: {
-            /**
-             * Cache Creation Input Tokens
-             * @default 0
-             */
-            cache_creation_input_tokens: number;
-            /**
-             * Cache Read Input Tokens
-             * @default 0
-             */
-            cache_read_input_tokens: number;
-            /**
-             * Input Tokens
-             * @default 0
-             */
-            input_tokens: number;
-            /**
-             * Output Tokens
-             * @default 0
-             */
-            output_tokens: number;
         };
         /** ValidationError */
         ValidationError: {
@@ -2025,7 +1964,7 @@ type DefaultResolution = 'repo_default' | 'account_default' | 'none';
  * the UI and metrics can tell a budget cutoff apart from a crashed tool call or
  * a deliberate cancellation. It is None until the run reaches a terminal state.
  */
-type AgentSessionExitStatus = 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
+type AgentSessionExitStatus = 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
 type Harness = 'claude_code';
 /**
  * How a session relates to its predecessor (parent_agent_session_id) —
@@ -2240,32 +2179,25 @@ interface SessionRecordWire {
     tokens_info: TokensInfo | null;
     tools: string[] | null;
 }
+/**
+ * Token/cost usage, per record (one API call's counts, aggregate fields at
+ * their zero defaults) or aggregated per execution/session
+ * (compute_spend_from_records derives num_turns and cost_usd).
+ *
+ * Strict on purpose: this is our own persisted schema, so an unknown key is a
+ * writer bug (the num_turns=0 bug shipped because a Claude Code usage dict
+ * validated leniently against this model, silently zeroing every
+ * non-overlapping field). Legacy keys were dropped from persisted blobs by
+ * the 2026-07-26 tokens_info migration; per-model usage lives on
+ * `execution.model_usage` (CC's modelUsage, verbatim).
+ */
 interface TokensInfo {
     cache_creation_input_tokens: number;
     cache_read_input_tokens: number;
     cost_usd: number;
-    initial_system_prompt_tokens: number;
     input_tokens: number;
     num_turns: number;
     output_tokens: number;
-    per_model: {
-        [k: string]: ModelTokensInfo;
-    };
-    per_turn: TurnTokensInfo[];
-    thinking_tokens: number;
-}
-interface ModelTokensInfo {
-    cache_creation_input_tokens: number;
-    cache_read_input_tokens: number;
-    cost_usd: number;
-    input_tokens: number;
-    output_tokens: number;
-}
-interface TurnTokensInfo {
-    cache_creation_input_tokens: number;
-    cache_read_input_tokens: number;
-    input_tokens: number;
-    output_tokens: number;
 }
 /**
  * LWW snapshot of the enriched public session (§4.1) — the only way
@@ -2332,4 +2264,4 @@ type ResolvedReviewScope = components['schemas']['ResolvedReviewScope'];
 type ReviewCounters = components['schemas']['ReviewCounters'];
 type Finding = components['schemas']['Finding'];
 
-export type { AgentSessionWire as A, BudgetSource as B, CreateReviewRequest as C, DefaultResolution as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SessionRecordWire as I, SessionState as J, SessionStreamFrame as K, ListSessionRecordsResponse as L, ModelTokensInfo as M, SessionSurface as N, SnapshotFrame as O, ParentKind as P, StreamFrame as Q, Review as R, SessionMessageWire as S, TokensInfo as T, TurnTokensInfo as U, components as V, paths as W, ListSessionTurnsResponse as a, ListSessionExecutionsResponse as b, ListReviewsResponse as c, AgentSessionExitStatus as d, AgentSessionPr as e, AgentSessionSource as f, AgentSessionStatus as g, AgentTurn as h, AgentTurnStatus as i, AttributionType as j, DeltaFrame as k, DoneFrame as l, GithubAccountType as m, HeartbeatFrame as n, PromptBlockedReason as o, RecordsAppendFrame as p, ResolvedReviewScope as q, ReviewCounters as r, ReviewScope as s, ReviewScopeKind as t, SendSessionMessageRequest as u, SessionExecutionWire as v, SessionFrame as w, SessionLiveness as x, SessionMessageStatus as y, SessionPrompting as z };
+export type { AgentSessionWire as A, BudgetSource as B, CreateReviewRequest as C, DefaultResolution as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SessionRecordWire as I, SessionState as J, SessionStreamFrame as K, ListSessionRecordsResponse as L, SessionSurface as M, SnapshotFrame as N, StreamFrame as O, ParentKind as P, components as Q, Review as R, SessionMessageWire as S, TokensInfo as T, paths as U, ListSessionTurnsResponse as a, ListSessionExecutionsResponse as b, ListReviewsResponse as c, AgentSessionExitStatus as d, AgentSessionPr as e, AgentSessionSource as f, AgentSessionStatus as g, AgentTurn as h, AgentTurnStatus as i, AttributionType as j, DeltaFrame as k, DoneFrame as l, GithubAccountType as m, HeartbeatFrame as n, PromptBlockedReason as o, RecordsAppendFrame as p, ResolvedReviewScope as q, ReviewCounters as r, ReviewScope as s, ReviewScopeKind as t, SendSessionMessageRequest as u, SessionExecutionWire as v, SessionFrame as w, SessionLiveness as x, SessionMessageStatus as y, SessionPrompting as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "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

@@ -10,6 +10,7 @@
         "lifecycle_hook_failed",
         "missing_repo_access",
         "missing_token_permissions",
+        "missing_sandbox_variables",
         "cancelled",
         "interrupted",
         "error",
@@ -761,44 +762,6 @@
       "title": "HeartbeatFrame",
       "type": "object"
     },
-    "ModelTokensInfo": {
-      "properties": {
-        "cache_creation_input_tokens": {
-          "default": 0,
-          "title": "Cache Creation Input Tokens",
-          "type": "integer"
-        },
-        "cache_read_input_tokens": {
-          "default": 0,
-          "title": "Cache Read Input Tokens",
-          "type": "integer"
-        },
-        "cost_usd": {
-          "default": 0,
-          "title": "Cost Usd",
-          "type": "number"
-        },
-        "input_tokens": {
-          "default": 0,
-          "title": "Input Tokens",
-          "type": "integer"
-        },
-        "output_tokens": {
-          "default": 0,
-          "title": "Output Tokens",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "cache_creation_input_tokens",
-        "cache_read_input_tokens",
-        "cost_usd",
-        "input_tokens",
-        "output_tokens"
-      ],
-      "title": "ModelTokensInfo",
-      "type": "object"
-    },
     "ParentKind": {
       "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nHANDOFF \u2014 a session started to take over work from another surface (e.g.\nlaptop \u2192 cloud handoff; later phase).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
       "enum": [
@@ -1312,6 +1275,8 @@
       "type": "object"
     },
     "TokensInfo": {
+      "additionalProperties": false,
+      "description": "Token/cost usage, per record (one API call's counts, aggregate fields at\ntheir zero defaults) or aggregated per execution/session\n(compute_spend_from_records derives num_turns and cost_usd).\n\nStrict on purpose: this is our own persisted schema, so an unknown key is a\nwriter bug (the num_turns=0 bug shipped because a Claude Code usage dict\nvalidated leniently against this model, silently zeroing every\nnon-overlapping field). Legacy keys were dropped from persisted blobs by\nthe 2026-07-26 tokens_info migration; per-model usage lives on\n`execution.model_usage` (CC's modelUsage, verbatim).",
       "properties": {
         "cache_creation_input_tokens": {
           "default": 0,
@@ -1328,11 +1293,6 @@
           "title": "Cost Usd",
           "type": "number"
         },
-        "initial_system_prompt_tokens": {
-          "default": 0,
-          "title": "Initial System Prompt Tokens",
-          "type": "integer"
-        },
         "input_tokens": {
           "default": 0,
           "title": "Input Tokens",
@@ -1347,74 +1307,17 @@
           "default": 0,
           "title": "Output Tokens",
           "type": "integer"
-        },
-        "per_model": {
-          "additionalProperties": {
-            "$ref": "#/$defs/ModelTokensInfo"
-          },
-          "default": {},
-          "title": "Per Model",
-          "type": "object"
-        },
-        "per_turn": {
-          "default": [],
-          "items": {
-            "$ref": "#/$defs/TurnTokensInfo"
-          },
-          "title": "Per Turn",
-          "type": "array"
-        },
-        "thinking_tokens": {
-          "default": 0,
-          "title": "Thinking Tokens",
-          "type": "integer"
         }
       },
       "required": [
         "cache_creation_input_tokens",
         "cache_read_input_tokens",
         "cost_usd",
-        "initial_system_prompt_tokens",
         "input_tokens",
         "num_turns",
-        "output_tokens",
-        "per_model",
-        "per_turn",
-        "thinking_tokens"
-      ],
-      "title": "TokensInfo",
-      "type": "object"
-    },
-    "TurnTokensInfo": {
-      "properties": {
-        "cache_creation_input_tokens": {
-          "default": 0,
-          "title": "Cache Creation Input Tokens",
-          "type": "integer"
-        },
-        "cache_read_input_tokens": {
-          "default": 0,
-          "title": "Cache Read Input Tokens",
-          "type": "integer"
-        },
-        "input_tokens": {
-          "default": 0,
-          "title": "Input Tokens",
-          "type": "integer"
-        },
-        "output_tokens": {
-          "default": 0,
-          "title": "Output Tokens",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "cache_creation_input_tokens",
-        "cache_read_input_tokens",
-        "input_tokens",
         "output_tokens"
       ],
-      "title": "TurnTokensInfo",
+      "title": "TokensInfo",
       "type": "object"
     },
     "WebhookType": {

package/schema/openapi.v1.json

@@ -787,7 +787,7 @@
       },
       "AgentConfigSandboxVariable": {
         "additionalProperties": false,
-        "description": "One environment variable injected into the agent's sandbox.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the customer's sandbox-variables store (dashboard\n/ `PUT /sandboxes/variables`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
+        "description": "One environment variable injected into the agent's sandbox.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the customer's sandbox-variables store (dashboard\n/ `PUT /v1/variables`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
         "properties": {
           "name": {
             "title": "Name",
@@ -906,6 +906,7 @@
           "lifecycle_hook_failed",
           "missing_repo_access",
           "missing_token_permissions",
+          "missing_sandbox_variables",
           "cancelled",
           "interrupted",
           "error",
@@ -2083,37 +2084,6 @@
         "title": "ListSessionTurnsResponse",
         "type": "object"
       },
-      "ModelTokensInfo": {
-        "properties": {
-          "cache_creation_input_tokens": {
-            "default": 0,
-            "title": "Cache Creation Input Tokens",
-            "type": "integer"
-          },
-          "cache_read_input_tokens": {
-            "default": 0,
-            "title": "Cache Read Input Tokens",
-            "type": "integer"
-          },
-          "cost_usd": {
-            "default": 0,
-            "title": "Cost Usd",
-            "type": "number"
-          },
-          "input_tokens": {
-            "default": 0,
-            "title": "Input Tokens",
-            "type": "integer"
-          },
-          "output_tokens": {
-            "default": 0,
-            "title": "Output Tokens",
-            "type": "integer"
-          }
-        },
-        "title": "ModelTokensInfo",
-        "type": "object"
-      },
       "ParentKind": {
         "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nHANDOFF \u2014 a session started to take over work from another surface (e.g.\nlaptop \u2192 cloud handoff; later phase).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
         "enum": [
@@ -3392,6 +3362,8 @@
         "type": "object"
       },
       "TokensInfo": {
+        "additionalProperties": false,
+        "description": "Token/cost usage, per record (one API call's counts, aggregate fields at\ntheir zero defaults) or aggregated per execution/session\n(compute_spend_from_records derives num_turns and cost_usd).\n\nStrict on purpose: this is our own persisted schema, so an unknown key is a\nwriter bug (the num_turns=0 bug shipped because a Claude Code usage dict\nvalidated leniently against this model, silently zeroing every\nnon-overlapping field). Legacy keys were dropped from persisted blobs by\nthe 2026-07-26 tokens_info migration; per-model usage lives on\n`execution.model_usage` (CC's modelUsage, verbatim).",
         "properties": {
           "cache_creation_input_tokens": {
             "default": 0,
@@ -3408,11 +3380,6 @@
             "title": "Cost Usd",
             "type": "number"
           },
-          "initial_system_prompt_tokens": {
-            "default": 0,
-            "title": "Initial System Prompt Tokens",
-            "type": "integer"
-          },
           "input_tokens": {
             "default": 0,
             "title": "Input Tokens",
@@ -3427,58 +3394,11 @@
             "default": 0,
             "title": "Output Tokens",
             "type": "integer"
-          },
-          "per_model": {
-            "additionalProperties": {
-              "$ref": "#/components/schemas/ModelTokensInfo"
-            },
-            "default": {},
-            "title": "Per Model",
-            "type": "object"
-          },
-          "per_turn": {
-            "default": [],
-            "items": {
-              "$ref": "#/components/schemas/TurnTokensInfo"
-            },
-            "title": "Per Turn",
-            "type": "array"
-          },
-          "thinking_tokens": {
-            "default": 0,
-            "title": "Thinking Tokens",
-            "type": "integer"
           }
         },
         "title": "TokensInfo",
         "type": "object"
       },
-      "TurnTokensInfo": {
-        "properties": {
-          "cache_creation_input_tokens": {
-            "default": 0,
-            "title": "Cache Creation Input Tokens",
-            "type": "integer"
-          },
-          "cache_read_input_tokens": {
-            "default": 0,
-            "title": "Cache Read Input Tokens",
-            "type": "integer"
-          },
-          "input_tokens": {
-            "default": 0,
-            "title": "Input Tokens",
-            "type": "integer"
-          },
-          "output_tokens": {
-            "default": 0,
-            "title": "Output Tokens",
-            "type": "integer"
-          }
-        },
-        "title": "TurnTokensInfo",
-        "type": "object"
-      },
       "ValidationError": {
         "properties": {
           "ctx": {