@ellipsis-dev/sdk 0.34.1 → 0.36.0

package/schema/frames.schema.json

@@ -1503,12 +1503,14 @@
       "discriminator": {
         "mapping": {
           "agentMessage": "#/$defs/CodexAgentMessage",
+          "collabAgentToolCall": "#/$defs/CodexCollabAgentToolCall",
           "commandExecution": "#/$defs/CodexCommandExecution",
           "contextCompaction": "#/$defs/CodexContextCompaction",
           "fileChange": "#/$defs/CodexFileChange",
           "mcpToolCall": "#/$defs/CodexMcpToolCall",
           "plan": "#/$defs/CodexPlan",
           "reasoning": "#/$defs/CodexReasoning",
+          "subAgentActivity": "#/$defs/CodexSubAgentActivity",
           "userMessage": "#/$defs/CodexUserMessage",
           "webSearch": "#/$defs/CodexWebSearch"
         },
@@ -1541,6 +1543,12 @@
         },
         {
           "$ref": "#/$defs/CodexContextCompaction"
+        },
+        {
+          "$ref": "#/$defs/CodexSubAgentActivity"
+        },
+        {
+          "$ref": "#/$defs/CodexCollabAgentToolCall"
         }
       ]
     },
@@ -1740,6 +1748,67 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
+    "CodexCollabAgentToolCall": {
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Prompt"
+        },
+        "receiverThreadIds": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Receiverthreadids",
+          "type": "array"
+        },
+        "senderThreadId": {
+          "title": "Senderthreadid",
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "inProgress",
+            "completed",
+            "failed"
+          ],
+          "title": "Status",
+          "type": "string"
+        },
+        "tool": {
+          "title": "Tool",
+          "type": "string"
+        },
+        "type": {
+          "const": "collabAgentToolCall",
+          "default": "collabAgentToolCall",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "receiverThreadIds",
+        "senderThreadId",
+        "status",
+        "tool",
+        "type"
+      ],
+      "title": "CodexCollabAgentToolCall",
+      "type": "object"
+    },
     "CodexCommandExecution": {
       "additionalProperties": true,
       "properties": {
@@ -3070,6 +3139,50 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
+    "CodexSubAgentActivity": {
+      "additionalProperties": true,
+      "description": "A subagent's spawn or completion, recorded on the spawning thread.",
+      "properties": {
+        "agentPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Agentpath"
+        },
+        "agentThreadId": {
+          "title": "Agentthreadid",
+          "type": "string"
+        },
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "title": "Kind",
+          "type": "string"
+        },
+        "type": {
+          "const": "subAgentActivity",
+          "default": "subAgentActivity",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "agentThreadId",
+        "id",
+        "kind",
+        "type"
+      ],
+      "title": "CodexSubAgentActivity",
+      "type": "object"
+    },
     "CodexTextInput": {
       "additionalProperties": true,
       "properties": {
@@ -3829,7 +3942,7 @@
       "properties": {
         "charged": {
           "default": 0,
-          "description": "What Ellipsis charged to credit, in millicents. It is everything except subscription tokens, and it is what the budget caps.",
+          "description": "What Ellipsis charged to credit, in millicents. It is everything except subscription tokens.",
           "title": "Charged",
           "type": "integer"
         },
@@ -3857,7 +3970,7 @@
         },
         "total": {
           "default": 0,
-          "description": "Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee.",
+          "description": "Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee, and it is what the budget caps.",
           "title": "Total",
           "type": "integer"
         }
@@ -4157,7 +4270,8 @@
             "before_start": null,
             "build_base": null,
             "post_clone": null,
-            "post_start": null
+            "post_start": null,
+            "validate": null
           }
         },
         "mcp_servers": {
@@ -4210,7 +4324,7 @@
     },
     "EnvironmentHooks": {
       "additionalProperties": false,
-      "description": "Environment lifecycle scripts, in order: build_base, after_checkout,\nbefore_start. The first two produce reusable snapshots; before_start runs\nbefore an agent starts or resumes its session. Scripts run as the environment's\nuser in the workspace directory `/sandbox`. A nonzero exit fails the session.\n\nLegacy post_start/post_clone scripts remain supported for existing configs;\nboth run after workspace preparation, before the agent starts or resumes.\nThey cannot be combined with the new lifecycle fields.",
+      "description": "Environment lifecycle scripts, in order: build_base, after_checkout,\nbefore_start, validate. The first two produce reusable snapshots;\nbefore_start runs before an agent starts or resumes its session, and\nvalidate runs last to check that the environment has what the agent needs.\nScripts run as the environment's user in the workspace directory\n`/sandbox`. A nonzero exit fails the session.\n\nLegacy post_start/post_clone scripts remain supported for existing configs;\nboth run after workspace preparation, before the agent starts or resumes.\nThey cannot be combined with the new lifecycle fields.",
       "properties": {
         "after_checkout": {
           "anyOf": [
@@ -4285,6 +4399,22 @@
           "default": null,
           "description": "Legacy session startup script. Use before_start in new configurations.",
           "title": "Post Start"
+        },
+        "validate": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/EnvironmentScript"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Check that the environment works, for example that required tools are on PATH. Runs last, after before_start, each time a session starts or resumes and each time the environment is built after a change. A nonzero exit fails the session or the build. Not cached.",
+          "title": "Validate"
         }
       },
       "required": [
@@ -4292,7 +4422,8 @@
         "before_start",
         "build_base",
         "post_clone",
-        "post_start"
+        "post_start",
+        "validate"
       ],
       "title": "EnvironmentHooks",
       "type": "object"
@@ -4726,30 +4857,500 @@
         "duration_ms": {
           "anyOf": [
             {
-              "type": "integer"
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Duration Ms"
+        },
+        "repositories": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Repositories",
+          "type": "array"
+        }
+      },
+      "required": [
+        "repositories"
+      ],
+      "title": "EnvironmentReadyPayload",
+      "type": "object"
+    },
+    "EnvironmentReadyRecord": {
+      "properties": {
+        "cost": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Cost"
+        },
+        "created_at": {
+          "format": "date-time",
+          "title": "Created At",
+          "type": "string"
+        },
+        "duration": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Duration"
+        },
+        "feed_seq": {
+          "description": "Position in the session feed and the stream's resume cursor.",
+          "title": "Feed Seq",
+          "type": "integer"
+        },
+        "id": {
+          "description": "Unique identifier of the record.",
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "const": "platform",
+          "default": "platform",
+          "title": "Kind",
+          "type": "string"
+        },
+        "model": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Model"
+        },
+        "payload": {
+          "$ref": "#/$defs/EnvironmentReadyPayload"
+        },
+        "record_format": {
+          "const": "ellipsis_lifecycle@1",
+          "default": "ellipsis_lifecycle@1",
+          "title": "Record Format",
+          "type": "string"
+        },
+        "record_type": {
+          "const": "environment_ready",
+          "default": "environment_ready",
+          "title": "Record Type",
+          "type": "string"
+        },
+        "session_id": {
+          "description": "Session containing this record.",
+          "title": "Session Id",
+          "type": "string"
+        },
+        "session_message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Message this record receives, delivers, requeues, or echoes.",
+          "title": "Session Message Id"
+        },
+        "source": {
+          "const": "lifecycle",
+          "default": "lifecycle",
+          "title": "Source",
+          "type": "string"
+        },
+        "tokens_info": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/TokensInfo"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "tools": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
+        }
+      },
+      "required": [
+        "cost",
+        "created_at",
+        "duration",
+        "feed_seq",
+        "id",
+        "kind",
+        "model",
+        "payload",
+        "record_format",
+        "record_type",
+        "session_id",
+        "session_message_id",
+        "source",
+        "tokens_info",
+        "tools",
+        "turn_id"
+      ],
+      "title": "EnvironmentReadyRecord",
+      "type": "object",
+      "x-ellipsis-preserve-payload": true
+    },
+    "EnvironmentScript": {
+      "additionalProperties": false,
+      "description": "An inline shell script run as the environment's user, with the workspace\ndirectory `/sandbox` as cwd.",
+      "properties": {
+        "run": {
+          "description": "Shell script to run in the workspace directory `/sandbox`.",
+          "minLength": 1,
+          "title": "Run",
+          "type": "string"
+        }
+      },
+      "required": [
+        "run"
+      ],
+      "title": "EnvironmentScript",
+      "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 environment.",
+      "enum": [
+        "request",
+        "agent",
+        "repo_default",
+        "account_default",
+        "platform_default"
+      ],
+      "title": "EnvironmentSource",
+      "type": "string"
+    },
+    "EnvironmentVariable": {
+      "additionalProperties": false,
+      "description": "One environment variable injected into the session's environment.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the account's secrets store (dashboard\n/ `PUT /v1/secrets`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
+      "properties": {
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Value"
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ],
+      "title": "EnvironmentVariable",
+      "type": "object"
+    },
+    "ErrorFrame": {
+      "description": "Terminal error marker, sent before the server closes with code 1011.",
+      "properties": {
+        "message": {
+          "description": "A human-readable error message.",
+          "title": "Message",
+          "type": "string"
+        },
+        "type": {
+          "const": "error",
+          "default": "error",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "message",
+        "type"
+      ],
+      "title": "ErrorFrame",
+      "type": "object"
+    },
+    "GeminiConfig": {
+      "additionalProperties": false,
+      "description": "Native options supported by the current Gemini CLI adapter.",
+      "properties": {
+        "model": {
+          "description": "The model the session runs on: a Gemini id from the models table. Required.",
+          "title": "Model",
+          "type": "string"
+        },
+        "prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.",
+          "title": "Prompt"
+        }
+      },
+      "required": [
+        "model",
+        "prompt"
+      ],
+      "title": "GeminiConfig",
+      "type": "object"
+    },
+    "GeminiErrorEvent": {
+      "additionalProperties": true,
+      "properties": {
+        "message": {
+          "title": "Message",
+          "type": "string"
+        },
+        "severity": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Severity"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "type": {
+          "const": "error",
+          "default": "error",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "message",
+        "timestamp",
+        "type"
+      ],
+      "title": "GeminiErrorEvent",
+      "type": "object"
+    },
+    "GeminiInitEvent": {
+      "additionalProperties": true,
+      "properties": {
+        "model": {
+          "title": "Model",
+          "type": "string"
+        },
+        "session_id": {
+          "title": "Session Id",
+          "type": "string"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "type": {
+          "const": "init",
+          "default": "init",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "model",
+        "session_id",
+        "timestamp",
+        "type"
+      ],
+      "title": "GeminiInitEvent",
+      "type": "object"
+    },
+    "GeminiMessageEvent": {
+      "additionalProperties": true,
+      "properties": {
+        "content": {
+          "title": "Content",
+          "type": "string"
+        },
+        "delta": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Delta"
+        },
+        "role": {
+          "enum": [
+            "user",
+            "assistant"
+          ],
+          "title": "Role",
+          "type": "string"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "type": {
+          "const": "message",
+          "default": "message",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "content",
+        "role",
+        "timestamp",
+        "type"
+      ],
+      "title": "GeminiMessageEvent",
+      "type": "object"
+    },
+    "GeminiModelStats": {
+      "additionalProperties": true,
+      "properties": {
+        "cached": {
+          "default": 0,
+          "title": "Cached",
+          "type": "integer"
+        },
+        "input": {
+          "default": 0,
+          "title": "Input",
+          "type": "integer"
+        },
+        "input_tokens": {
+          "default": 0,
+          "title": "Input Tokens",
+          "type": "integer"
+        },
+        "output_tokens": {
+          "default": 0,
+          "title": "Output Tokens",
+          "type": "integer"
+        },
+        "total_tokens": {
+          "default": 0,
+          "title": "Total Tokens",
+          "type": "integer"
+        }
+      },
+      "required": [],
+      "title": "GeminiModelStats",
+      "type": "object"
+    },
+    "GeminiResultEvent": {
+      "additionalProperties": true,
+      "properties": {
+        "error": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/GeminiToolError"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "stats": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/GeminiStreamStats"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Duration Ms"
+          "default": null
         },
-        "repositories": {
-          "items": {
-            "type": "string"
-          },
-          "title": "Repositories",
-          "type": "array"
+        "status": {
+          "enum": [
+            "success",
+            "error"
+          ],
+          "title": "Status",
+          "type": "string"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "type": {
+          "const": "result",
+          "default": "result",
+          "title": "Type",
+          "type": "string"
         }
       },
       "required": [
-        "repositories"
+        "status",
+        "timestamp",
+        "type"
       ],
-      "title": "EnvironmentReadyPayload",
+      "title": "GeminiResultEvent",
       "type": "object"
     },
-    "EnvironmentReadyRecord": {
+    "GeminiSessionRecord": {
       "properties": {
         "cost": {
           "anyOf": [
@@ -4791,8 +5392,8 @@
           "type": "string"
         },
         "kind": {
-          "const": "platform",
-          "default": "platform",
+          "const": "gemini",
+          "default": "gemini",
           "title": "Kind",
           "type": "string"
         },
@@ -4809,17 +5410,16 @@
           "title": "Model"
         },
         "payload": {
-          "$ref": "#/$defs/EnvironmentReadyPayload"
+          "$ref": "#/$defs/GeminiStreamEvent"
         },
         "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
+          "const": "gemini_stream_json@1",
+          "default": "gemini_stream_json@1",
           "title": "Record Format",
           "type": "string"
         },
         "record_type": {
-          "const": "environment_ready",
-          "default": "environment_ready",
+          "description": "Original record type within its format.",
           "title": "Record Type",
           "type": "string"
         },
@@ -4842,8 +5442,8 @@
           "title": "Session Message Id"
         },
         "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
+          "const": "gemini",
+          "default": "gemini",
           "title": "Source",
           "type": "string"
         },
@@ -4905,48 +5505,128 @@
         "tools",
         "turn_id"
       ],
-      "title": "EnvironmentReadyRecord",
+      "title": "GeminiSessionRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "EnvironmentScript": {
-      "additionalProperties": false,
-      "description": "An inline shell script run as the environment's user, with the workspace\ndirectory `/sandbox` as cwd.",
+    "GeminiStreamEvent": {
+      "discriminator": {
+        "mapping": {
+          "error": "#/$defs/GeminiErrorEvent",
+          "init": "#/$defs/GeminiInitEvent",
+          "message": "#/$defs/GeminiMessageEvent",
+          "result": "#/$defs/GeminiResultEvent",
+          "tool_result": "#/$defs/GeminiToolResultEvent",
+          "tool_use": "#/$defs/GeminiToolUseEvent"
+        },
+        "propertyName": "type"
+      },
+      "oneOf": [
+        {
+          "$ref": "#/$defs/GeminiInitEvent"
+        },
+        {
+          "$ref": "#/$defs/GeminiMessageEvent"
+        },
+        {
+          "$ref": "#/$defs/GeminiToolUseEvent"
+        },
+        {
+          "$ref": "#/$defs/GeminiToolResultEvent"
+        },
+        {
+          "$ref": "#/$defs/GeminiErrorEvent"
+        },
+        {
+          "$ref": "#/$defs/GeminiResultEvent"
+        }
+      ]
+    },
+    "GeminiStreamStats": {
+      "additionalProperties": true,
       "properties": {
-        "run": {
-          "description": "Shell script to run in the workspace directory `/sandbox`.",
-          "minLength": 1,
-          "title": "Run",
+        "cached": {
+          "default": 0,
+          "title": "Cached",
+          "type": "integer"
+        },
+        "duration_ms": {
+          "default": 0,
+          "title": "Duration Ms",
+          "type": "integer"
+        },
+        "input": {
+          "default": 0,
+          "title": "Input",
+          "type": "integer"
+        },
+        "input_tokens": {
+          "default": 0,
+          "title": "Input Tokens",
+          "type": "integer"
+        },
+        "models": {
+          "additionalProperties": {
+            "$ref": "#/$defs/GeminiModelStats"
+          },
+          "default": {},
+          "title": "Models",
+          "type": "object"
+        },
+        "output_tokens": {
+          "default": 0,
+          "title": "Output Tokens",
+          "type": "integer"
+        },
+        "tool_calls": {
+          "default": 0,
+          "title": "Tool Calls",
+          "type": "integer"
+        },
+        "total_tokens": {
+          "default": 0,
+          "title": "Total Tokens",
+          "type": "integer"
+        }
+      },
+      "required": [],
+      "title": "GeminiStreamStats",
+      "type": "object"
+    },
+    "GeminiToolError": {
+      "additionalProperties": true,
+      "properties": {
+        "message": {
+          "title": "Message",
+          "type": "string"
+        },
+        "type": {
+          "title": "Type",
           "type": "string"
         }
       },
       "required": [
-        "run"
+        "message",
+        "type"
       ],
-      "title": "EnvironmentScript",
+      "title": "GeminiToolError",
       "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 environment.",
-      "enum": [
-        "request",
-        "agent",
-        "repo_default",
-        "account_default",
-        "platform_default"
-      ],
-      "title": "EnvironmentSource",
-      "type": "string"
-    },
-    "EnvironmentVariable": {
-      "additionalProperties": false,
-      "description": "One environment variable injected into the session's environment.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the account's secrets store (dashboard\n/ `PUT /v1/secrets`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
+    "GeminiToolResultEvent": {
+      "additionalProperties": true,
       "properties": {
-        "name": {
-          "title": "Name",
-          "type": "string"
+        "error": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/GeminiToolError"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
         },
-        "value": {
+        "output": {
           "anyOf": [
             {
               "type": "string"
@@ -4956,36 +5636,75 @@
             }
           ],
           "default": null,
-          "title": "Value"
+          "title": "Output"
+        },
+        "status": {
+          "enum": [
+            "success",
+            "error"
+          ],
+          "title": "Status",
+          "type": "string"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "tool_id": {
+          "title": "Tool Id",
+          "type": "string"
+        },
+        "type": {
+          "const": "tool_result",
+          "default": "tool_result",
+          "title": "Type",
+          "type": "string"
         }
       },
       "required": [
-        "name",
-        "value"
+        "status",
+        "timestamp",
+        "tool_id",
+        "type"
       ],
-      "title": "EnvironmentVariable",
+      "title": "GeminiToolResultEvent",
       "type": "object"
     },
-    "ErrorFrame": {
-      "description": "Terminal error marker, sent before the server closes with code 1011.",
+    "GeminiToolUseEvent": {
+      "additionalProperties": true,
       "properties": {
-        "message": {
-          "description": "A human-readable error message.",
-          "title": "Message",
+        "parameters": {
+          "additionalProperties": true,
+          "default": {},
+          "title": "Parameters",
+          "type": "object"
+        },
+        "timestamp": {
+          "title": "Timestamp",
+          "type": "string"
+        },
+        "tool_id": {
+          "title": "Tool Id",
+          "type": "string"
+        },
+        "tool_name": {
+          "title": "Tool Name",
           "type": "string"
         },
         "type": {
-          "const": "error",
-          "default": "error",
+          "const": "tool_use",
+          "default": "tool_use",
           "title": "Type",
           "type": "string"
         }
       },
       "required": [
-        "message",
+        "timestamp",
+        "tool_id",
+        "tool_name",
         "type"
       ],
-      "title": "ErrorFrame",
+      "title": "GeminiToolUseEvent",
       "type": "object"
     },
     "GithubAccountFilter": {
@@ -7987,7 +8706,6 @@
         "defaults",
         "environments",
         "secrets",
-        "templates",
         "integrations",
         "reviews",
         "tokens",
@@ -8519,11 +9237,34 @@
                 },
                 "codex": {
                   "type": "null"
+                },
+                "gemini": {
+                  "type": "null"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex",
+                "gemini"
+              ]
+            },
+            {
+              "properties": {
+                "claude_code": {
+                  "type": "null"
+                },
+                "codex": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "gemini": {
+                  "type": "null"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             },
             {
@@ -8532,13 +9273,17 @@
                   "type": "null"
                 },
                 "codex": {
+                  "type": "null"
+                },
+                "gemini": {
                   "additionalProperties": true,
                   "type": "object"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             }
           ]
@@ -8590,7 +9335,7 @@
             }
           ],
           "default": null,
-          "description": "Claude Code input and native options. Set exactly one of claude_code or codex."
+          "description": "Claude Code input and native options. Set exactly one of claude_code, codex, or gemini."
         },
         "codex": {
           "anyOf": [
@@ -8602,7 +9347,7 @@
             }
           ],
           "default": null,
-          "description": "Codex input and native options. Set exactly one of claude_code or codex."
+          "description": "Codex input and native options. Set exactly one of claude_code, codex, or gemini."
         },
         "conversation": {
           "$ref": "#/$defs/SessionConversation",
@@ -8689,6 +9434,18 @@
           "description": "The typed external event that started the session; null for direct and scheduled starts.",
           "title": "Event"
         },
+        "gemini": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/GeminiConfig"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini."
+        },
         "git": {
           "anyOf": [
             {
@@ -8814,6 +9571,7 @@
         "created_at",
         "environment",
         "event",
+        "gemini",
         "git",
         "handler",
         "id",
@@ -9117,11 +9875,34 @@
                 },
                 "codex": {
                   "type": "null"
+                },
+                "gemini": {
+                  "type": "null"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex",
+                "gemini"
+              ]
+            },
+            {
+              "properties": {
+                "claude_code": {
+                  "type": "null"
+                },
+                "codex": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "gemini": {
+                  "type": "null"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             },
             {
@@ -9130,13 +9911,17 @@
                   "type": "null"
                 },
                 "codex": {
+                  "type": "null"
+                },
+                "gemini": {
                   "additionalProperties": true,
                   "type": "object"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             }
           ]
@@ -9163,7 +9948,7 @@
             }
           ],
           "default": null,
-          "description": "Claude Code input and native options. Set exactly one of claude_code or codex."
+          "description": "Claude Code input and native options. Set exactly one of claude_code, codex, or gemini."
         },
         "codex": {
           "anyOf": [
@@ -9175,7 +9960,7 @@
             }
           ],
           "default": null,
-          "description": "Codex input and native options. Set exactly one of claude_code or codex."
+          "description": "Codex input and native options. Set exactly one of claude_code, codex, or gemini."
         },
         "conversation": {
           "$ref": "#/$defs/SessionConversationConfig",
@@ -9203,7 +9988,8 @@
               "before_start": null,
               "build_base": null,
               "post_clone": null,
-              "post_start": null
+              "post_start": null,
+              "validate": null
             },
             "mcp_servers": [],
             "repositories": [],
@@ -9211,6 +9997,18 @@
           },
           "title": "Environment"
         },
+        "gemini": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/GeminiConfig"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini."
+        },
         "metadata": {
           "additionalProperties": {
             "type": "string"
@@ -9256,6 +10054,7 @@
         "codex",
         "conversation",
         "environment",
+        "gemini",
         "metadata",
         "output",
         "permissions",
@@ -9331,7 +10130,8 @@
             "before_start": null,
             "build_base": null,
             "post_clone": null,
-            "post_start": null
+            "post_start": null,
+            "validate": null
           }
         },
         "id": {
@@ -10000,6 +10800,9 @@
         {
           "$ref": "#/$defs/CodexAppServerSessionRecord"
         },
+        {
+          "$ref": "#/$defs/GeminiSessionRecord"
+        },
         {
           "$ref": "#/$defs/PlatformSessionRecord"
         },
@@ -10407,12 +11210,6 @@
           "title": "Messages",
           "type": "array"
         },
-        "protocol": {
-          "default": 7,
-          "description": "Echoes the protocol version the server is serving.",
-          "title": "Protocol",
-          "type": "integer"
-        },
         "session": {
           "$ref": "#/$defs/Session",
           "description": "The session's current state."
@@ -10427,7 +11224,6 @@
       "required": [
         "earliest_feed_seq",
         "messages",
-        "protocol",
         "session",
         "type"
       ],
@@ -11356,7 +12152,7 @@
     }
   },
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "One server-to-client frame of the Ellipsis session stream protocol v7 (WS /v1/sessions/{id}/stream?protocol=7). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
+  "description": "One server-to-client frame of the Ellipsis session stream (WS /v1/sessions/{id}/stream). Clients ignore frames with unknown `type` values.",
   "oneOf": [
     {
       "$ref": "#/$defs/SnapshotFrame"