@ellipsis-dev/sdk 0.15.1 → 0.17.0

package/package.json

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

@@ -39,7 +39,6 @@
           "default": {
             "description": null,
             "enabled": true,
-            "interactive": true,
             "metadata": {
               "annotations": {},
               "labels": []
@@ -49,7 +48,14 @@
           }
         },
         "environment": {
-          "$ref": "#/$defs/AgentConfigEnvironment",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/$defs/AgentConfigEnvironment"
+            }
+          ],
           "default": {
             "compute": {
               "cpu": null,
@@ -64,9 +70,11 @@
               "dockerfile_append": null,
               "setup": null
             },
+            "mcp_servers": [],
             "repositories": [],
             "variables": []
-          }
+          },
+          "title": "Environment"
         },
         "input": {
           "anyOf": [
@@ -79,21 +87,6 @@
           ],
           "default": null
         },
-        "mcp_servers": {
-          "default": [],
-          "items": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "$ref": "#/$defs/AgentConfigMcpServer"
-              }
-            ]
-          },
-          "title": "Mcp Servers",
-          "type": "array"
-        },
         "output": {
           "anyOf": [
             {
@@ -161,7 +154,6 @@
         "ellipsis",
         "environment",
         "input",
-        "mcp_servers",
         "output",
         "permissions",
         "skills",
@@ -497,7 +489,7 @@
     },
     "AgentConfigEllipsis": {
       "additionalProperties": false,
-      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, whether the agent is `enabled`, and the\nhuman-access flag `interactive`. The presence of a top-level `ellipsis:`\nmapping is what marks a YAML file as an Ellipsis agent config (vs arbitrary\nYAML that merely lives under a config directory) \u2014 see\n`yaml_is_ellipsis_config`.\n\n`enabled`/`interactive` are agent behavior, not freeform metadata, so they\nstay inside the config `sha` (only `metadata` is sha-excluded).\n`interactive` lets a human `agent session connect` to a live session (CLI\nrelay). It does not decide whether a session is ephemeral or durable \u2014 that\nis the trigger's job.",
+      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent config (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded). Whether a session\naccepts messages is a per-run choice (POST /v1/sessions `interactive`),\nnot a config one.",
       "properties": {
         "description": {
           "anyOf": [
@@ -516,11 +508,6 @@
           "title": "Enabled",
           "type": "boolean"
         },
-        "interactive": {
-          "default": true,
-          "title": "Interactive",
-          "type": "boolean"
-        },
         "metadata": {
           "$ref": "#/$defs/AgentConfigMetadata",
           "default": {
@@ -549,7 +536,6 @@
       "required": [
         "description",
         "enabled",
-        "interactive",
         "metadata",
         "name",
         "version"
@@ -614,6 +600,27 @@
             "setup": null
           }
         },
+        "mcp_servers": {
+          "default": [],
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/$defs/AgentConfigMcpServer"
+              },
+              {
+                "$ref": "#/$defs/AgentConfigMcpStdioServer"
+              },
+              {
+                "$ref": "#/$defs/AgentConfigMcpRemoteServer"
+              }
+            ]
+          },
+          "title": "Mcp Servers",
+          "type": "array"
+        },
         "repositories": {
           "default": [],
           "items": {
@@ -635,6 +642,7 @@
         "compute",
         "hooks",
         "image",
+        "mcp_servers",
         "repositories",
         "variables"
       ],
@@ -824,9 +832,38 @@
       "title": "AgentConfigInput",
       "type": "object"
     },
+    "AgentConfigMcpRemoteServer": {
+      "additionalProperties": false,
+      "description": "A bring-your-own remote MCP server: the harness talks HTTP to `url`.\nNothing runs in the sandbox image. `headers` carry static auth (e.g.\n`Authorization: Bearer ${TOKEN}`); values may embed `${NAME}` secret\nreferences, resolved at run time from the account's secrets store.",
+      "properties": {
+        "headers": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "title": "Headers",
+          "type": "object"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "headers",
+        "name",
+        "url"
+      ],
+      "title": "AgentConfigMcpRemoteServer",
+      "type": "object"
+    },
     "AgentConfigMcpServer": {
       "additionalProperties": false,
-      "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nThis is a name reference over the connected built-in set, NOT a custom-server\ndefinition \u2014 there is no command/url/headers shape (that was the old,\nremoved field, and Ellipsis does not support bring-your-own MCP servers).\nIt only matters when the named integration is set to `opt_in` inclusion; an\nintegration in the default `all_sessions` mode is added regardless.",
+      "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. It only matters when the named\nintegration is set to `opt_in` inclusion; an integration in the default\n`all_sessions` mode is added regardless. For a server the platform does not\nprovide, define it instead (`AgentConfigMcpStdioServer` /\n`AgentConfigMcpRemoteServer`).",
       "properties": {
         "name": {
           "title": "Name",
@@ -839,6 +876,44 @@
       "title": "AgentConfigMcpServer",
       "type": "object"
     },
+    "AgentConfigMcpStdioServer": {
+      "additionalProperties": false,
+      "description": "A bring-your-own stdio MCP server: the harness spawns `command` inside\nthe sandbox and speaks JSON-RPC over its stdin/stdout. The command must be\nrunnable in the sandbox image \u2014 install its runtime via `image.setup` /\n`image.dockerfile_append` if the base image lacks it.\n\n`env` values may embed `${NAME}` references, resolved at run time from the\naccount's secrets store (see `mcp_secret_refs`); everything else is passed\nliterally.",
+      "properties": {
+        "args": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Args",
+          "type": "array"
+        },
+        "command": {
+          "title": "Command",
+          "type": "string"
+        },
+        "env": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "title": "Env",
+          "type": "object"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        }
+      },
+      "required": [
+        "args",
+        "command",
+        "env",
+        "name"
+      ],
+      "title": "AgentConfigMcpStdioServer",
+      "type": "object"
+    },
     "AgentConfigMemorySize": {
       "additionalProperties": false,
       "description": "A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).\nSet any of `gb`/`mb` (at least one). The alternative to the `8GB`-style\nshorthand string.",
@@ -2526,6 +2601,18 @@
       "title": "EllipsisGrant",
       "type": "object"
     },
+    "EnvironmentSource": {
+      "description": "How a session's environment was chosen. None (the field is nullable)\nwhen the config carried an inline environment block and no resolution ran \u2014\nan inline environment is not a reference, so there is nothing to record.\n\nNot derivable from the row: `environment_id` says WHICH environment, not\nhow it was chosen, and is null for the built-in basic sandbox.",
+      "enum": [
+        "request",
+        "agent_config",
+        "repo_default",
+        "account_default",
+        "platform_default"
+      ],
+      "title": "EnvironmentSource",
+      "type": "string"
+    },
     "ErrorFrame": {
       "description": "Terminal error marker, sent before the server closes with code 1011.",
       "properties": {
@@ -3191,6 +3278,7 @@
         "reviews",
         "configs",
         "defaults",
+        "environments",
         "secrets",
         "templates",
         "integrations",
@@ -4024,6 +4112,10 @@
           "title": "Created At",
           "type": "string"
         },
+        "environment": {
+          "$ref": "#/$defs/SessionEnvironment",
+          "description": "The environment the session resolved: the saved environment's id and how it was chosen. The environment's frozen body is inside agent.config.environment."
+        },
         "exit_status": {
           "anyOf": [
             {
@@ -4036,6 +4128,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 +4186,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."
@@ -4210,14 +4286,14 @@
         "context_repository",
         "cost",
         "created_at",
+        "environment",
         "exit_status",
+        "git",
         "harness",
         "id",
         "last_activity_at",
         "last_message_at",
         "metadata",
-        "output_diff",
-        "output_prs",
         "parent",
         "prompt",
         "prompting",
@@ -4397,55 +4473,40 @@
       "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.",
+    "SessionEnvironment": {
+      "description": "The environment this session resolved: which saved environment (as it\nexists now) and how it was chosen. The environment's frozen BODY rides\ninside `agent.config.environment` \u2014 substitution happens before the config\nsnapshot freezes \u2014 so this object is provenance, not payload.",
       "properties": {
-        "files": {
-          "items": {
-            "$ref": "#/$defs/SessionDiffFile"
-          },
-          "title": "Files",
-          "type": "array"
-        }
-      },
-      "required": [
-        "files"
-      ],
-      "title": "SessionDiff",
-      "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).",
-      "properties": {
-        "additions": {
-          "title": "Additions",
-          "type": "integer"
-        },
-        "deletions": {
-          "title": "Deletions",
-          "type": "integer"
-        },
-        "path": {
-          "title": "Path",
-          "type": "string"
-        },
-        "repo": {
-          "title": "Repo",
-          "type": "string"
+        "environment_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Identifier of the saved environment the session's config resolved. Null for an inline environment block or the built-in basic sandbox.",
+          "title": "Environment Id"
         },
-        "status": {
-          "title": "Status",
-          "type": "string"
+        "source": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/EnvironmentSource"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "How the environment was chosen (request, agent_config, repo_default, account_default, platform_default). Null when the config carried its own inline environment."
         }
       },
       "required": [
-        "additions",
-        "deletions",
-        "path",
-        "repo",
-        "status"
+        "environment_id",
+        "source"
       ],
-      "title": "SessionDiffFile",
+      "title": "SessionEnvironment",
       "type": "object"
     },
     "SessionExitStatus": {
@@ -4490,6 +4551,169 @@
       "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": {
+        "repos": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/SessionGitRepo"
+          },
+          "title": "Repos",
+          "type": "array"
+        }
+      },
+      "required": [
+        "repos"
+      ],
+      "title": "SessionGit",
+      "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": {
+        "additions": {
+          "title": "Additions",
+          "type": "integer"
+        },
+        "deletions": {
+          "title": "Deletions",
+          "type": "integer"
+        },
+        "path": {
+          "title": "Path",
+          "type": "string"
+        },
+        "status": {
+          "title": "Status",
+          "type": "string"
+        }
+      },
+      "required": [
+        "additions",
+        "deletions",
+        "path",
+        "status"
+      ],
+      "title": "SessionGitFile",
+      "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.",
+      "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": "SessionGitPr",
+      "type": "object"
+    },
+    "SessionGitRepo": {
+      "description": "One checkout in the session's sandbox and everything the session did to\nit, split by whether it survived the sandbox.",
+      "properties": {
+        "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": [
+        "full_name",
+        "local_commit",
+        "local_uncommitted_files",
+        "prs",
+        "remote_branch",
+        "remote_commit"
+      ],
+      "title": "SessionGitRepo",
+      "type": "object"
+    },
     "SessionLiveness": {
       "description": "The durable conversation axis (backs the surfaced `session` field).",
       "enum": [
@@ -4681,56 +4905,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": {