@ellipsis-dev/sdk 0.34.0 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.34.0",
+  "version": "0.35.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/collection_frames.schema.json

@@ -113,6 +113,20 @@
           "description": "The agent's account-unique addressable name (a slug of its display name); usable anywhere an agent is referenced, interchangeably with the id.",
           "title": "Name"
         },
+        "next_run_at": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "When the agent's cron trigger next starts a session. Null when the agent has no cron trigger, its trigger is paused, or the agent is disabled.",
+          "title": "Next Run At"
+        },
         "pending_pull_request_url": {
           "anyOf": [
             {
@@ -167,6 +181,7 @@
         "last_synced_commit_sha",
         "managed_by",
         "name",
+        "next_run_at",
         "pending_pull_request_url",
         "raw_yaml",
         "sha",
@@ -680,7 +695,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"
         },
@@ -708,7 +723,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"
         }
@@ -929,7 +944,8 @@
             "before_start": null,
             "build_base": null,
             "post_clone": null,
-            "post_start": null
+            "post_start": null,
+            "validate": null
           }
         },
         "mcp_servers": {
@@ -982,7 +998,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": [
@@ -1057,6 +1073,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": [
@@ -1064,7 +1096,8 @@
         "before_start",
         "build_base",
         "post_clone",
-        "post_start"
+        "post_start",
+        "validate"
       ],
       "title": "EnvironmentHooks",
       "type": "object"
@@ -1126,6 +1159,36 @@
       "title": "EnvironmentVariable",
       "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"
+    },
     "GithubAccountFilter": {
       "anyOf": [
         {
@@ -3100,7 +3163,6 @@
         "defaults",
         "environments",
         "secrets",
-        "templates",
         "integrations",
         "reviews",
         "tokens",
@@ -3398,11 +3460,15 @@
                 },
                 "codex": {
                   "type": "null"
+                },
+                "gemini": {
+                  "type": "null"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             },
             {
@@ -3413,11 +3479,34 @@
                 "codex": {
                   "additionalProperties": true,
                   "type": "object"
+                },
+                "gemini": {
+                  "type": "null"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
+              ]
+            },
+            {
+              "properties": {
+                "claude_code": {
+                  "type": "null"
+                },
+                "codex": {
+                  "type": "null"
+                },
+                "gemini": {
+                  "additionalProperties": true,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex",
+                "gemini"
               ]
             }
           ]
@@ -3469,7 +3558,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": [
@@ -3481,7 +3570,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",
@@ -3568,6 +3657,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": [
             {
@@ -3693,6 +3794,7 @@
         "created_at",
         "environment",
         "event",
+        "gemini",
         "git",
         "handler",
         "id",
@@ -3829,11 +3931,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"
               ]
             },
             {
@@ -3842,13 +3967,17 @@
                   "type": "null"
                 },
                 "codex": {
+                  "type": "null"
+                },
+                "gemini": {
                   "additionalProperties": true,
                   "type": "object"
                 }
               },
               "required": [
                 "claude_code",
-                "codex"
+                "codex",
+                "gemini"
               ]
             }
           ]
@@ -3875,7 +4004,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": [
@@ -3887,7 +4016,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",
@@ -3915,7 +4044,8 @@
               "before_start": null,
               "build_base": null,
               "post_clone": null,
-              "post_start": null
+              "post_start": null,
+              "validate": null
             },
             "mcp_servers": [],
             "repositories": [],
@@ -3923,6 +4053,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"
@@ -3968,6 +4110,7 @@
         "codex",
         "conversation",
         "environment",
+        "gemini",
         "metadata",
         "output",
         "permissions",
@@ -4043,7 +4186,8 @@
             "before_start": null,
             "build_base": null,
             "post_clone": null,
-            "post_start": null
+            "post_start": null,
+            "validate": null
           }
         },
         "id": {
@@ -5077,7 +5221,8 @@
             "before_start": null,
             "build_base": null,
             "post_clone": null,
-            "post_start": null
+            "post_start": null,
+            "validate": null
           }
         },
         "id": {