@ellipsis-dev/sdk 0.25.0 → 0.27.0

package/schema/openapi.v1.json

@@ -2431,7 +2431,7 @@
         "properties": {
           "automation": {
             "$ref": "#/components/schemas/AutomationConfig",
-            "description": "The automation's definition, in the same schema as a YAML file under agents/."
+            "description": "The automation's definition, in the same schema as a YAML file under .ellipsis/."
           }
         },
         "required": [
@@ -4450,6 +4450,33 @@
         "title": "Harness",
         "type": "string"
       },
+      "ImageAttachment": {
+        "description": "One image on a request body, base64 inline (the Claude Code paste\nshape). Shared by `POST /v1/sessions` and `POST /v1/sessions/{id}/messages`.",
+        "properties": {
+          "data": {
+            "description": "The raw image bytes, base64-encoded. 5 MiB cap.",
+            "title": "Data",
+            "type": "string"
+          },
+          "media_type": {
+            "description": "The image's MIME type: image/png, image/jpeg, image/gif, or image/webp. The bytes must match.",
+            "enum": [
+              "image/png",
+              "image/jpeg",
+              "image/gif",
+              "image/webp"
+            ],
+            "title": "Media Type",
+            "type": "string"
+          }
+        },
+        "required": [
+          "media_type",
+          "data"
+        ],
+        "title": "ImageAttachment",
+        "type": "object"
+      },
       "IngestTranscriptRequest": {
         "description": "A batch of raw transcript lines pushed from inside a session's\nsandbox.",
         "properties": {
@@ -4795,7 +4822,7 @@
                 "type": "null"
               }
             ],
-            "description": "File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).",
+            "description": "File path within the repo. Omit for the default .ellipsis/automations/<slug>.yaml; if set it must be a location the sync scans (a .yaml/.yml file under .ellipsis/ at any depth; in the repository named .ellipsis the repo root is that directory).",
             "title": "Path"
           },
           "repository": {
@@ -5340,18 +5367,6 @@
             "$ref": "#/components/schemas/BudgetCeiling",
             "description": "The organization's spend ceilings."
           },
-          "default_environment": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The saved environment sessions run in when neither their request nor their automation names one: an `env_...` id or the environment's name on write, always the id on read. Null means the built-in basic sandbox.",
-            "title": "Default Environment"
-          },
           "default_model": {
             "anyOf": [
               {
@@ -8472,8 +8487,16 @@
             "description": "Optional retry-safety key, unique per (session, key): a retry with the same key returns the original message \u2014 no duplicate message, no double turn, no double spend. The SDK auto-generates one per send.",
             "title": "Idempotency Key"
           },
+          "images": {
+            "description": "Images attached to the message, base64 inline \u2014 what a paste into Claude Code sends. Each becomes an `[Image #N]` placeholder in the stored body and an image block the model sees on the turn this message opens. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP. Claude harness only.",
+            "items": {
+              "$ref": "#/components/schemas/ImageAttachment"
+            },
+            "title": "Images",
+            "type": "array"
+          },
           "message": {
-            "description": "The message text.",
+            "description": "The message text. May be empty when `images` is not.",
             "title": "Message",
             "type": "string"
           }
@@ -8682,7 +8705,7 @@
           },
           "source": {
             "$ref": "#/components/schemas/SessionSource",
-            "description": "Where the session came from (e.g. react, manual, api, cli, mention, cron)."
+            "description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
           },
           "status": {
             "$ref": "#/components/schemas/SessionStatus",
@@ -8989,7 +9012,7 @@
                 "type": "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."
+            "description": "How the environment was chosen (request, agent_config, platform_default; repo_default and account_default on sessions from before those ladders were removed). Null when the config carried its own inline environment."
           }
         },
         "title": "SessionEnvironment",
@@ -9302,7 +9325,7 @@
             "title": "Author"
           },
           "body": {
-            "description": "The message text.",
+            "description": "The message text, with one `[Image #N]` placeholder per attached image.",
             "title": "Body",
             "type": "string"
           },
@@ -9354,6 +9377,14 @@
             "title": "Id",
             "type": "string"
           },
+          "images": {
+            "description": "Images attached to the message, metadata only: index, media type, size. The bytes go to the model, never over the stream.",
+            "items": {
+              "$ref": "#/components/schemas/SessionMessageImage"
+            },
+            "title": "Images",
+            "type": "array"
+          },
           "sender_attribution_id": {
             "anyOf": [
               {
@@ -9397,6 +9428,33 @@
         "title": "SessionMessage",
         "type": "object"
       },
+      "SessionMessageImage": {
+        "description": "One image on a message, metadata only. `index` is the N in the\n`[Image #N]` placeholder in the message body.",
+        "properties": {
+          "index": {
+            "description": "1-based position: the N in `[Image #N]`.",
+            "title": "Index",
+            "type": "integer"
+          },
+          "media_type": {
+            "description": "The image's MIME type.",
+            "title": "Media Type",
+            "type": "string"
+          },
+          "size_bytes": {
+            "description": "Size of the decoded image, in bytes.",
+            "title": "Size Bytes",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "index",
+          "media_type",
+          "size_bytes"
+        ],
+        "title": "SessionMessageImage",
+        "type": "object"
+      },
       "SessionMessageResponse": {
         "description": "One inbox message.",
         "properties": {
@@ -9598,9 +9656,10 @@
         "type": "object"
       },
       "SessionSource": {
+        "description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron). Never\ntaken from a request body.",
         "enum": [
           "react",
-          "manual",
+          "web",
           "api",
           "cli",
           "mention",
@@ -10145,7 +10204,7 @@
                 "type": "null"
               }
             ],
-            "description": "Where the session runs. A STRING is a saved environment's name or `env_...` id, substituted wholesale. An OBJECT is the whole environment for this session \u2014 `{}` is the bare sandbox; nothing from the organization's default merges in. Omitted, the session runs in the organization's default environment, else the built-in basic sandbox.",
+            "description": "Where the session runs. A STRING is a saved environment's name or `env_...` id, substituted wholesale. An OBJECT is the whole environment for this session \u2014 `{}` is the bare sandbox. Omitted, the session runs in the built-in basic sandbox \u2014 nothing outside the request picks the environment.",
             "title": "Environment"
           },
           "force_rebuild": {
@@ -10154,6 +10213,14 @@
             "title": "Force Rebuild",
             "type": "boolean"
           },
+          "images": {
+            "description": "Images attached to the first message, base64 inline \u2014 what a paste into Claude Code sends. Each becomes an `[Image #N]` placeholder in the prompt and an image block the model sees on turn 0. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP. Claude harness only.",
+            "items": {
+              "$ref": "#/components/schemas/ImageAttachment"
+            },
+            "title": "Images",
+            "type": "array"
+          },
           "interactive": {
             "default": true,
             "description": "Whether the session stays open for messages after its first turn. Set false for a one-shot run that does its job and closes without holding a warm sandbox; a one-shot run must carry a prompt, since nothing can ever be sent to it later. Sessions on the Codex harness are one-shot regardless.",
@@ -14888,7 +14955,7 @@
     },
     "/v1/reviews": {
       "get": {
-        "description": "List code reviews, newest first.\n\n`findings` and `configuration` are omitted (counters only). Each\nfilter is a set: repeat `repository`, `pull_request_number`, or\n`status` to match any of several values.\n\nWebhook-created reviews appear here too, so this answers \"show\nme every review on this PR\".",
+        "description": "List code reviews, newest first.\n\n`findings` and `configuration` are omitted (counters only). Each\nfilter is a set: repeat `repository`, `pull_request_number`, or\n`status` to match any of several values. `start` and `end` bound\nthe review's creation time.\n\nWebhook-created reviews appear here too, so this answers \"show\nme every review on this PR\".",
         "operationId": "list_reviews",
         "parameters": [
           {
@@ -14936,6 +15003,44 @@
               "type": "array"
             }
           },
+          {
+            "description": "Only reviews created at or after this time.",
+            "in": "query",
+            "name": "start",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Only reviews created at or after this time.",
+              "title": "Start"
+            }
+          },
+          {
+            "description": "Only reviews created at or before this time.",
+            "in": "query",
+            "name": "end",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Only reviews created at or before this time.",
+              "title": "End"
+            }
+          },
           {
             "in": "query",
             "name": "limit",
@@ -15751,7 +15856,7 @@
         "x-ellipsis-sdk-method": "sessions.list"
       },
       "post": {
-        "description": "Start a cloud agent session.\n\nThe daily driver: a prompt, optionally where to run it\n(`environment`) and the run's own settings, in the AutomationConfig\nvocabulary. Anything omitted comes from the organization's\nsettings \u2014 default model, default environment, budget \u2014 so\n`{\"prompt\": \"...\"}` alone is a complete request. `prompt` is the\nfirst message; omit it and the session starts idle, waiting for\none. 400 when `interactive` is false and there is no prompt, or\nwhen `budget` exceeds the organization's per-session ceiling. To\nrun a saved automation, use POST /v1/automations/{automation_id}/sessions.",
+        "description": "Start a cloud agent session.\n\nThe daily driver: a prompt, optionally where to run it\n(`environment`) and the run's own settings, in the AutomationConfig\nvocabulary. What you send is what runs: omit `environment` and the\nsession runs in the built-in basic sandbox. A missing model or\nbudget comes from the organization's settings, so\n`{\"prompt\": \"...\"}` alone is a complete request. `prompt` is the\nfirst message; omit it and the session starts idle, waiting for\none. 400 when `interactive` is false and there is no prompt, or\nwhen `budget` exceeds the organization's per-session ceiling. To\nrun a saved automation, use POST /v1/automations/{automation_id}/sessions.",
         "operationId": "start_agent_session",
         "parameters": [
           {
@@ -15800,7 +15905,7 @@
                 }
               }
             },
-            "description": "The request is incompatible with itself (a one-shot run with no prompt, or both `claude` and `codex`), its keys produce an invalid config, or `budget` exceeds the organization's per-session ceiling."
+            "description": "The request is incompatible with itself (a one-shot run with no prompt, both `claude` and `codex`, or images on the Codex harness), an image is invalid or over the limit, its keys produce an invalid config, or `budget` exceeds the organization's per-session ceiling."
           },
           "401": {
             "content": {
@@ -16200,7 +16305,7 @@
                 }
               }
             },
-            "description": "The message is empty."
+            "description": "The message is empty (no text and no images), an image is invalid or over the limit, or the session runs on the Codex harness (images are Claude-only)."
           },
           "401": {
             "content": {
@@ -16712,7 +16817,7 @@
     },
     "/v1/settings/organization": {
       "get": {
-        "description": "Get the organization settings.\n\nThe default model and default environment every session falls\nback to when neither its request nor its automation names one,\nand the per-session budget ceiling no session may exceed.",
+        "description": "Get the organization settings.\n\nThe default model every session falls back to when neither its\nrequest nor its automation names one, and the per-session budget\nceiling no session may exceed.",
         "operationId": "get_organization_settings",
         "parameters": [
           {
@@ -16786,7 +16891,7 @@
         "x-ellipsis-sdk-method": "settings.organization.get"
       },
       "put": {
-        "description": "Set the organization settings.\n\nReplaces all three: `default_model` accepts an alias or canonical\nid and is stored canonical; `default_environment` accepts a name\nor `env_` id and is stored as the id; `budget_ceiling.session` is\nin US dollars, at most the platform ceiling. Null clears each.\nRefused for sandbox tokens (potentially prompt-injected code must\nnot repoint the organization's defaults).",
+        "description": "Set the organization settings.\n\nReplaces both: `default_model` accepts an alias or canonical id\nand is stored canonical; `budget_ceiling.session` is in US\ndollars, at most the platform ceiling. Null clears each.\nRefused for sandbox tokens (potentially prompt-injected code must\nnot repoint the organization's defaults).",
         "operationId": "put_organization_settings",
         "parameters": [
           {
@@ -16857,16 +16962,6 @@
             },
             "description": "The credential may not perform this action, or the account is blocked."
           },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The default environment does not exist in your account."
-          },
           "422": {
             "content": {
               "application/json": {