@ellipsis-dev/sdk 0.18.0 → 0.19.0

package/package.json

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

@@ -4317,13 +4317,9 @@
       "type": "object"
     },
     "SessionAgent": {
-      "description": "The agent this session ran: the config it actually executed, where that\nconfig came from, and the diff that was merged in \u2014 the same\neffective-value-plus-provenance shape `SessionBudget` uses.\n\n`config` is the snapshot frozen when the session was created; `config_id`\npoints at the saved config as it exists NOW. They diverge legitimately: a\nYAML edit after the session started, or any `override`, leaves the pointer\ndescribing something the session never ran.",
+      "description": "The agent this session ran: the definition it actually executed, where\nthat definition came from, and the diff that was merged in \u2014 the same\neffective-value-plus-provenance shape `SessionBudget` uses.\n\n`config` is the snapshot frozen when the session was created;\n`automation_id` points at the automation as it exists NOW. They diverge\nlegitimately: a YAML edit after the session started, or any `override`,\nleaves the pointer describing something the session never ran.",
       "properties": {
-        "config": {
-          "$ref": "#/$defs/AgentConfig",
-          "description": "The agent config the session actually ran, frozen when the session was created."
-        },
-        "config_id": {
+        "automation_id": {
           "anyOf": [
             {
               "type": "string"
@@ -4333,8 +4329,12 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the saved config this session's snapshot was taken from. Null for inline, platform-default, and built-in configs. Points at the config as it exists now, which may have changed since.",
-          "title": "Config Id"
+          "description": "Identifier of the automation this session's snapshot was taken from. Null for raw sessions (nothing saved behind them), templates, and built-in agents. Points at the automation as it exists now, which may have changed since.",
+          "title": "Automation Id"
+        },
+        "config": {
+          "$ref": "#/$defs/AgentConfig",
+          "description": "The agent definition the session actually ran, frozen when the session was created."
         },
         "override": {
           "anyOf": [
@@ -4356,8 +4356,8 @@
         }
       },
       "required": [
+        "automation_id",
         "config",
-        "config_id",
         "override",
         "source"
       ],
@@ -4575,6 +4575,36 @@
       "title": "SessionGit",
       "type": "object"
     },
+    "SessionGitCommit": {
+      "description": "One commit the session created in this repo (everything past the\nprovisioning checkout's sha), captured from the sandbox rather than the\ntranscript so it stays correct through amends, rebases, and commits made by\nscripts. The repo is the parent object, so it is not repeated here.",
+      "properties": {
+        "committed_at": {
+          "format": "date-time",
+          "title": "Committed At",
+          "type": "string"
+        },
+        "pushed": {
+          "title": "Pushed",
+          "type": "boolean"
+        },
+        "sha": {
+          "title": "Sha",
+          "type": "string"
+        },
+        "subject": {
+          "title": "Subject",
+          "type": "string"
+        }
+      },
+      "required": [
+        "committed_at",
+        "pushed",
+        "sha",
+        "subject"
+      ],
+      "title": "SessionGitCommit",
+      "type": "object"
+    },
     "SessionGitFile": {
       "description": "One file's uncommitted change, as `git diff HEAD --numstat` reports it\n(with intent-to-add, so a brand-new file still counts).",
       "properties": {
@@ -4605,7 +4635,7 @@
       "type": "object"
     },
     "SessionGitPr": {
-      "description": "A pull request the session opened in this repo, denormalized at capture\ntime so a surface renders a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored \u2014 read gh_prs where a view needs\nit. The repo is the parent object, so it is not repeated here.",
+      "description": "A pull request the session opened in this repo, written the moment the\ncreating tool call's result lands (see extract_session_prs.PrCreateWatcher).\nLive PR state (open/merged/closed) is not stored \u2014 it lives on gh_prs,\njoined via `gh_pr_id` (GET /frontend/agents/sessions/{id}/git). The repo is\nthe parent object, so it is not repeated here.",
       "properties": {
         "gh_pr_id": {
           "anyOf": [
@@ -4652,6 +4682,19 @@
     "SessionGitRepo": {
       "description": "One checkout in the session's sandbox and everything the session did to\nit, split by whether it survived the sandbox.",
       "properties": {
+        "commits": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/SessionGitCommit"
+          },
+          "title": "Commits",
+          "type": "array"
+        },
+        "commits_total": {
+          "default": 0,
+          "title": "Commits Total",
+          "type": "integer"
+        },
         "full_name": {
           "title": "Full Name",
           "type": "string"
@@ -4710,6 +4753,8 @@
         }
       },
       "required": [
+        "commits",
+        "commits_total",
         "full_name",
         "local_commit",
         "local_uncommitted_files",