@ellipsis-dev/sdk 0.2.3 → 0.4.0

package/package.json

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

@@ -761,44 +761,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 +1274,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 +1292,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 +1306,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/lifecycle.schema.json

@@ -98,6 +98,46 @@
       "title": "MessageRequeuedPayload",
       "type": "object"
     },
+    "OutboxCollectedPayload": {
+      "description": "outbox_collected \u2014 the platform read a code_review session's\n/ellipsis/outbox/* at finalize (CODE_REVIEW_v3.md \u00a73). Carries both raw\nand parsed so the feed alone tells the whole delivery story; the\ncode_review_outbox table is the queryable projection of this record.",
+      "properties": {
+        "findings": {
+          "default": [],
+          "items": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "title": "Findings",
+          "type": "array"
+        },
+        "parse_errors": {
+          "default": [],
+          "items": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "title": "Parse Errors",
+          "type": "array"
+        },
+        "parser_version": {
+          "title": "Parser Version",
+          "type": "string"
+        },
+        "raw": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "title": "Raw",
+          "type": "object"
+        }
+      },
+      "required": [
+        "parser_version"
+      ],
+      "title": "OutboxCollectedPayload",
+      "type": "object"
+    },
     "SandboxOutputPayload": {
       "description": "sandbox_output \u2014 one chunk of provisioning/lifecycle-script output.\nMany fire per execution; `chunk` rides the idempotency key. These records\nARE the durable copy (archived into the session log's S3 segments), under\na high per-session cap + truncation marker.",
       "properties": {
@@ -450,6 +490,9 @@
     "message_requeued": {
       "$ref": "#/$defs/MessageRequeuedPayload"
     },
+    "outbox_collected": {
+      "$ref": "#/$defs/OutboxCollectedPayload"
+    },
     "sandbox_output": {
       "$ref": "#/$defs/SandboxOutputPayload"
     },
@@ -497,6 +540,7 @@
     "message_delivered",
     "message_received",
     "message_requeued",
+    "outbox_collected",
     "sandbox_output",
     "sandbox_phase",
     "sandbox_ready",