@ellipsis-dev/sdk 0.15.1 → 0.16.0

package/schema/frames.schema.json

@@ -4036,6 +4036,18 @@
           "default": null,
           "description": "How the session ended; null until it is terminal."
         },
+        "git": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionGit"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured."
+        },
         "harness": {
           "$ref": "#/$defs/Harness",
           "description": "The coding-agent harness the session runs on."
@@ -4082,34 +4094,6 @@
           "title": "Metadata",
           "type": "object"
         },
-        "output_diff": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/SessionDiff"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Per-file line counts for the uncommitted changes in the session's workspace. Work the session committed is not included here \u2014 see output_prs. Null if no diff was ever captured."
-        },
-        "output_prs": {
-          "anyOf": [
-            {
-              "items": {
-                "$ref": "#/$defs/SessionPr"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Pull requests the session created or updated.",
-          "title": "Output Prs"
-        },
         "parent": {
           "$ref": "#/$defs/SessionParent",
           "description": "What preceded this session, if anything."
@@ -4211,13 +4195,12 @@
         "cost",
         "created_at",
         "exit_status",
+        "git",
         "harness",
         "id",
         "last_activity_at",
         "last_message_at",
         "metadata",
-        "output_diff",
-        "output_prs",
         "parent",
         "prompt",
         "prompting",
@@ -4397,25 +4380,68 @@
       "title": "SessionCost",
       "type": "object"
     },
-    "SessionDiff": {
-      "description": "The counts half of a session's working-tree diff, small enough to ride on\nagent_sessions and be returned by every session read. The patch text lives\nin `agent_session_diffs` and is fetched on demand.\n\nScope is UNCOMMITTED work only (`git diff HEAD`), so this answers \"is there\nunlanded work in this sandbox?\" \u2014 a session that committed and pushed shows\nno files here and its created PR instead.",
+    "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",
+        "blocked",
+        "contact_email_required",
+        "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": {
+        "session": {
+          "$ref": "#/$defs/Session",
+          "description": "The session's current state."
+        },
+        "type": {
+          "const": "session",
+          "default": "session",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "session",
+        "type"
+      ],
+      "title": "SessionFrame",
+      "type": "object"
+    },
+    "SessionGit": {
+      "description": "Every repo the session touched. Small enough to ride on `agent_sessions`\nand be returned by every session read.",
       "properties": {
-        "files": {
+        "repos": {
+          "default": [],
           "items": {
-            "$ref": "#/$defs/SessionDiffFile"
+            "$ref": "#/$defs/SessionGitRepo"
           },
-          "title": "Files",
+          "title": "Repos",
           "type": "array"
         }
       },
       "required": [
-        "files"
+        "repos"
       ],
-      "title": "SessionDiff",
+      "title": "SessionGit",
       "type": "object"
     },
-    "SessionDiffFile": {
-      "description": "One file's uncommitted change in a session's sandbox, as `git diff HEAD`\n--numstat reports it (with intent-to-add so new files count).",
+    "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": {
         "additions": {
           "title": "Additions",
@@ -4429,10 +4455,6 @@
           "title": "Path",
           "type": "string"
         },
-        "repo": {
-          "title": "Repo",
-          "type": "string"
-        },
         "status": {
           "title": "Status",
           "type": "string"
@@ -4442,52 +4464,125 @@
         "additions",
         "deletions",
         "path",
-        "repo",
         "status"
       ],
-      "title": "SessionDiffFile",
+      "title": "SessionGitFile",
       "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",
-        "blocked",
-        "contact_email_required",
-        "cancelled",
-        "interrupted",
-        "error",
-        "stopped"
+    "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.",
+      "properties": {
+        "gh_pr_id": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Gh Pr Id"
+        },
+        "number": {
+          "title": "Number",
+          "type": "integer"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Title"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "gh_pr_id",
+        "number",
+        "title",
+        "url"
       ],
-      "title": "SessionExitStatus",
-      "type": "string"
+      "title": "SessionGitPr",
+      "type": "object"
     },
-    "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.",
+    "SessionGitRepo": {
+      "description": "One checkout in the session's sandbox and everything the session did to\nit, split by whether it survived the sandbox.",
       "properties": {
-        "session": {
-          "$ref": "#/$defs/Session",
-          "description": "The session's current state."
-        },
-        "type": {
-          "const": "session",
-          "default": "session",
-          "title": "Type",
+        "full_name": {
+          "title": "Full Name",
           "type": "string"
+        },
+        "local_commit": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Local Commit"
+        },
+        "local_uncommitted_files": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/SessionGitFile"
+          },
+          "title": "Local Uncommitted Files",
+          "type": "array"
+        },
+        "prs": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/SessionGitPr"
+          },
+          "title": "Prs",
+          "type": "array"
+        },
+        "remote_branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Remote Branch"
+        },
+        "remote_commit": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Remote Commit"
         }
       },
       "required": [
-        "session",
-        "type"
+        "full_name",
+        "local_commit",
+        "local_uncommitted_files",
+        "prs",
+        "remote_branch",
+        "remote_commit"
       ],
-      "title": "SessionFrame",
+      "title": "SessionGitRepo",
       "type": "object"
     },
     "SessionLiveness": {
@@ -4681,56 +4776,6 @@
       "title": "SessionParent",
       "type": "object"
     },
-    "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": {