@ellipsis-dev/sdk 0.8.1 → 0.9.0

package/package.json

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

@@ -1,101 +1,5 @@
 {
   "$defs": {
-    "AgentSessionExitStatus": {
-      "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (AgentSessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
-      "enum": [
-        "completed",
-        "budget_hit",
-        "payment_required",
-        "tool_call_failed",
-        "lifecycle_hook_failed",
-        "missing_repo_access",
-        "missing_token_permissions",
-        "missing_sandbox_variables",
-        "cancelled",
-        "interrupted",
-        "error",
-        "stopped"
-      ],
-      "title": "AgentSessionExitStatus",
-      "type": "string"
-    },
-    "AgentSessionPr": {
-      "description": "A pull request this session created, denormalized at capture time so\nsession surfaces render a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored here \u2014 read it from gh_prs where\na view needs it.",
-      "properties": {
-        "gh_pr_id": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Gh Pr Id"
-        },
-        "number": {
-          "title": "Number",
-          "type": "integer"
-        },
-        "repo_full_name": {
-          "title": "Repo Full Name",
-          "type": "string"
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Title"
-        },
-        "url": {
-          "title": "Url",
-          "type": "string"
-        }
-      },
-      "required": [
-        "gh_pr_id",
-        "number",
-        "repo_full_name",
-        "title",
-        "url"
-      ],
-      "title": "AgentSessionPr",
-      "type": "object"
-    },
-    "AgentSessionSource": {
-      "enum": [
-        "react",
-        "manual",
-        "api",
-        "cli",
-        "mention",
-        "cron",
-        "laptop"
-      ],
-      "title": "AgentSessionSource",
-      "type": "string"
-    },
-    "AgentSessionStatus": {
-      "enum": [
-        "scheduled",
-        "creating_sandbox",
-        "running",
-        "retrying",
-        "completed",
-        "error",
-        "cancelled",
-        "stopped"
-      ],
-      "title": "AgentSessionStatus",
-      "type": "string"
-    },
     "AttributionType": {
       "enum": [
         "github_user",
@@ -498,7 +402,7 @@
         "exit_status": {
           "anyOf": [
             {
-              "$ref": "#/$defs/AgentSessionExitStatus"
+              "$ref": "#/$defs/SessionExitStatus"
             },
             {
               "type": "null"
@@ -570,7 +474,7 @@
           "anyOf": [
             {
               "items": {
-                "$ref": "#/$defs/AgentSessionPr"
+                "$ref": "#/$defs/SessionPr"
               },
               "type": "array"
             },
@@ -685,11 +589,11 @@
           "description": "Lifecycle state of the durable conversation, or null for sessions without one."
         },
         "source": {
-          "$ref": "#/$defs/AgentSessionSource",
+          "$ref": "#/$defs/SessionSource",
           "description": "Where the session came from (e.g. react, manual, api, cli, mention, cron, laptop)."
         },
         "status": {
-          "$ref": "#/$defs/AgentSessionStatus",
+          "$ref": "#/$defs/SessionStatus",
           "description": "Execution status of the session."
         },
         "status_reason": {
@@ -875,6 +779,25 @@
       "title": "Session",
       "type": "object"
     },
+    "SessionExitStatus": {
+      "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
+      "enum": [
+        "completed",
+        "budget_hit",
+        "payment_required",
+        "tool_call_failed",
+        "lifecycle_hook_failed",
+        "missing_repo_access",
+        "missing_token_permissions",
+        "missing_sandbox_variables",
+        "cancelled",
+        "interrupted",
+        "error",
+        "stopped"
+      ],
+      "title": "SessionExitStatus",
+      "type": "string"
+    },
     "SessionFrame": {
       "description": "A last-writer-wins snapshot of the session \u2014 the only way status,\nstate, and cost updates arrive. Resent whole on any field change.",
       "properties": {
@@ -1037,6 +960,56 @@
       "title": "SessionMessageStatus",
       "type": "string"
     },
+    "SessionPr": {
+      "description": "A pull request this session created, denormalized at capture time so\nsession surfaces render a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored here \u2014 read it from gh_prs where\na view needs it.",
+      "properties": {
+        "gh_pr_id": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Gh Pr Id"
+        },
+        "number": {
+          "title": "Number",
+          "type": "integer"
+        },
+        "repo_full_name": {
+          "title": "Repo Full Name",
+          "type": "string"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Title"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "gh_pr_id",
+        "number",
+        "repo_full_name",
+        "title",
+        "url"
+      ],
+      "title": "SessionPr",
+      "type": "object"
+    },
     "SessionPrompting": {
       "description": "The prompt-affordance projection. `enabled` answers \"would a send work\",\nand when it wouldn't, `blocked_reason` + `detail` say why.\n\n`surface_name` is set only for MENTION_SURFACE, naming where to reply.",
       "properties": {
@@ -1253,8 +1226,21 @@
       "title": "SessionRecord",
       "type": "object"
     },
+    "SessionSource": {
+      "enum": [
+        "react",
+        "manual",
+        "api",
+        "cli",
+        "mention",
+        "cron",
+        "laptop"
+      ],
+      "title": "SessionSource",
+      "type": "string"
+    },
     "SessionState": {
-      "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from AgentSessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
+      "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from SessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
       "enum": [
         "idle",
         "running",
@@ -1263,6 +1249,20 @@
       "title": "SessionState",
       "type": "string"
     },
+    "SessionStatus": {
+      "enum": [
+        "scheduled",
+        "creating_sandbox",
+        "running",
+        "retrying",
+        "completed",
+        "error",
+        "cancelled",
+        "stopped"
+      ],
+      "title": "SessionStatus",
+      "type": "string"
+    },
     "SessionSurface": {
       "description": "The three fields we expose. All `None` for an un-keyed (laptop) session.\n\n`use_enum_values=True` (from CustomBaseModel) stores the members as their\nstring values, so this serializes to `{\"session\": \"alive\", \"run\": \"waiting\",\n\"status\": \"waiting\"}` \u2014 a plain object, not enum names.",
       "properties": {