@ellipsis-dev/sdk 0.25.0 → 0.27.0

package/dist/{types-DJzmFABi.d.ts → types-ClEF_IA9.d.ts}

@@ -808,7 +808,8 @@ interface paths {
          *
          *     `findings` and `configuration` are omitted (counters only). Each
          *     filter is a set: repeat `repository`, `pull_request_number`, or
-         *     `status` to match any of several values.
+         *     `status` to match any of several values. `start` and `end` bound
+         *     the review's creation time.
          *
          *     Webhook-created reviews appear here too, so this answers "show
          *     me every review on this PR".
@@ -942,8 +943,9 @@ interface paths {
          *
          *     The daily driver: a prompt, optionally where to run it
          *     (`environment`) and the run's own settings, in the AutomationConfig
-         *     vocabulary. Anything omitted comes from the organization's
-         *     settings — default model, default environment, budget — so
+         *     vocabulary. What you send is what runs: omit `environment` and the
+         *     session runs in the built-in basic sandbox. A missing model or
+         *     budget comes from the organization's settings, so
          *     `{"prompt": "..."}` alone is a complete request. `prompt` is the
          *     first message; omit it and the session starts idle, waiting for
          *     one. 400 when `interactive` is false and there is no prompt, or
@@ -1175,19 +1177,18 @@ interface paths {
          * Get Organization Settings
          * @description Get the organization settings.
          *
-         *     The default model and default environment every session falls
-         *     back to when neither its request nor its automation names one,
-         *     and the per-session budget ceiling no session may exceed.
+         *     The default model every session falls back to when neither its
+         *     request nor its automation names one, and the per-session budget
+         *     ceiling no session may exceed.
          */
         get: operations['get_organization_settings'];
         /**
          * Set Organization Settings
          * @description Set the organization settings.
          *
-         *     Replaces all three: `default_model` accepts an alias or canonical
-         *     id and is stored canonical; `default_environment` accepts a name
-         *     or `env_` id and is stored as the id; `budget_ceiling.session` is
-         *     in US dollars, at most the platform ceiling. Null clears each.
+         *     Replaces both: `default_model` accepts an alias or canonical id
+         *     and is stored canonical; `budget_ceiling.session` is in US
+         *     dollars, at most the platform ceiling. Null clears each.
          *     Refused for sandbox tokens (potentially prompt-injected code must
          *     not repoint the organization's defaults).
          */
@@ -2613,7 +2614,7 @@ interface components {
          * @description Parameters for creating an automation.
          */
         CreateAutomationRequest: {
-            /** @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/. */
             automation: components['schemas']['AutomationConfig'];
         };
         /**
@@ -3698,6 +3699,24 @@ interface components {
          * @enum {string}
          */
         Harness: 'claude_code' | 'codex';
+        /**
+         * ImageAttachment
+         * @description One image on a request body, base64 inline (the Claude Code paste
+         *     shape). Shared by `POST /v1/sessions` and `POST /v1/sessions/{id}/messages`.
+         */
+        ImageAttachment: {
+            /**
+             * Data
+             * @description The raw image bytes, base64-encoded. 5 MiB cap.
+             */
+            data: string;
+            /**
+             * Media Type
+             * @description The image's MIME type: image/png, image/jpeg, image/gif, or image/webp. The bytes must match.
+             * @enum {string}
+             */
+            media_type: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+        };
         /**
          * IngestTranscriptRequest
          * @description A batch of raw transcript lines pushed from inside a session's
@@ -3918,7 +3937,7 @@ interface components {
         LinkAutomationRequest: {
             /**
              * Path
-             * @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).
              */
             path?: string | null;
             /**
@@ -4287,11 +4306,6 @@ interface components {
         OrganizationSettings: {
             /** @description The organization's spend ceilings. */
             budget_ceiling?: components['schemas']['BudgetCeiling'];
-            /**
-             * Default Environment
-             * @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.
-             */
-            default_environment?: string | null;
             /**
              * Default Model
              * @description Canonical model id every session falls back to when neither its request nor its automation names one, or null when unset (sessions then run the platform default).
@@ -6041,9 +6055,14 @@ interface components {
              * @description Optional retry-safety key, unique per (session, key): a retry with the same key returns the original message — no duplicate message, no double turn, no double spend. The SDK auto-generates one per send.
              */
             idempotency_key?: string | null;
+            /**
+             * Images
+             * @description Images attached to the message, base64 inline — 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.
+             */
+            images?: components['schemas']['ImageAttachment'][];
             /**
              * Message
-             * @description The message text.
+             * @description The message text. May be empty when `images` is not.
              */
             message: string;
         };
@@ -6150,7 +6169,7 @@ interface components {
             prompting: components['schemas']['SessionPrompting'];
             /** @description Lifecycle state of the durable conversation, or null for sessions without one. */
             session_state?: components['schemas']['SessionState'] | null;
-            /** @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). */
             source: components['schemas']['SessionSource'];
             /** @description Execution status of the session. */
             status: components['schemas']['SessionStatus'];
@@ -6343,7 +6362,7 @@ interface components {
              * @description Identifier of the saved environment the session's config resolved. Null for an inline environment block or the built-in basic sandbox.
              */
             environment_id?: string | 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. */
             source?: components['schemas']['EnvironmentSource'] | null;
         };
         /**
@@ -6536,7 +6555,7 @@ interface components {
             author?: string | null;
             /**
              * Body
-             * @description The message text.
+             * @description The message text, with one `[Image #N]` placeholder per attached image.
              */
             body: string;
             /**
@@ -6565,6 +6584,11 @@ interface components {
              * @description Unique identifier of the message.
              */
             id: string;
+            /**
+             * Images
+             * @description Images attached to the message, metadata only: index, media type, size. The bytes go to the model, never over the stream.
+             */
+            images?: components['schemas']['SessionMessageImage'][];
             /**
              * Sender Attribution Id
              * @description Identifier of the principal that sent the message, if attributed.
@@ -6580,6 +6604,28 @@ interface components {
             /** @description Delivery status of the message. */
             status: components['schemas']['SessionMessageStatus'];
         };
+        /**
+         * SessionMessageImage
+         * @description One image on a message, metadata only. `index` is the N in the
+         *     `[Image #N]` placeholder in the message body.
+         */
+        SessionMessageImage: {
+            /**
+             * Index
+             * @description 1-based position: the N in `[Image #N]`.
+             */
+            index: number;
+            /**
+             * Media Type
+             * @description The image's MIME type.
+             */
+            media_type: string;
+            /**
+             * Size Bytes
+             * @description Size of the decoded image, in bytes.
+             */
+            size_bytes: number;
+        };
         /**
          * SessionMessageResponse
          * @description One inbox message.
@@ -6673,9 +6719,12 @@ interface components {
         };
         /**
          * SessionSource
+         * @description Where a session came from: the credential that started it (web app,
+         *     API key, CLI) or the trigger that fired (react, mention, cron). Never
+         *     taken from a request body.
          * @enum {string}
          */
-        SessionSource: 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron';
+        SessionSource: 'react' | 'web' | 'api' | 'cli' | 'mention' | 'cron';
         /**
          * SessionState
          * @description Lifecycle of a keyed (multi-turn) session — the durable conversation.
@@ -6988,7 +7037,7 @@ interface components {
             codex?: components['schemas']['CodexConfig'] | null;
             /**
              * Environment
-             * @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 — `{}` 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 — `{}` is the bare sandbox. Omitted, the session runs in the built-in basic sandbox — nothing outside the request picks the environment.
              */
             environment?: string | components['schemas']['EnvironmentConfig'] | null;
             /**
@@ -6997,6 +7046,11 @@ interface components {
              * @default false
              */
             force_rebuild: boolean;
+            /**
+             * Images
+             * @description Images attached to the first message, base64 inline — 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.
+             */
+            images?: components['schemas']['ImageAttachment'][];
             /**
              * Interactive
              * @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.
@@ -9810,6 +9864,10 @@ interface operations {
                 pull_request_number?: number[];
                 /** @description Only reviews in these statuses. Repeat the parameter for several. */
                 status?: components['schemas']['CodeReviewRunStatus'][];
+                /** @description Only reviews created at or after this time. */
+                start?: string | null;
+                /** @description Only reviews created at or before this time. */
+                end?: string | null;
                 limit?: number;
                 cursor?: string | null;
             };
@@ -10265,7 +10323,7 @@ interface operations {
                     'application/json': components['schemas']['SessionResponse'];
                 };
             };
-            /** @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. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10518,7 +10576,7 @@ interface operations {
                     'application/json': components['schemas']['SessionMessageResponse'];
                 };
             };
-            /** @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). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10939,15 +10997,6 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description The default environment does not exist in your account. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -11198,9 +11247,9 @@ type PromptBlockedReason = 'mention_surface' | 'ephemeral_trigger' | 'non_intera
  */
 type SessionState = 'idle' | 'running' | 'closed';
 /**
- * Where the session came from (e.g. react, manual, api, cli, mention, cron).
+ * Where the session came from (e.g. react, web, api, cli, mention, cron).
  */
-type SessionSource = 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron';
+type SessionSource = 'react' | 'web' | 'api' | 'cli' | 'mention' | 'cron';
 /**
  * Execution status of the session.
  */
@@ -11243,7 +11292,7 @@ interface SessionMessage {
      */
     author: string | null;
     /**
-     * The message text.
+     * The message text, with one `[Image #N]` placeholder per attached image.
      */
     body: string;
     /**
@@ -11266,6 +11315,10 @@ interface SessionMessage {
      * Unique identifier of the message.
      */
     id: string;
+    /**
+     * Images attached to the message, metadata only: index, media type, size. The bytes go to the model, never over the stream.
+     */
+    images: SessionMessageImage[];
     /**
      * Identifier of the principal that sent the message, if attributed.
      */
@@ -11280,6 +11333,24 @@ interface SessionMessage {
     session_id: string;
     status: SessionMessageStatus;
 }
+/**
+ * One image on a message, metadata only. `index` is the N in the
+ * `[Image #N]` placeholder in the message body.
+ */
+interface SessionMessageImage {
+    /**
+     * 1-based position: the N in `[Image #N]`.
+     */
+    index: number;
+    /**
+     * The image's MIME type.
+     */
+    media_type: string;
+    /**
+     * Size of the decoded image, in bytes.
+     */
+    size_bytes: number;
+}
 /**
  * The session's current state.
  */
@@ -11891,7 +11962,7 @@ interface SessionEnvironment {
      */
     environment_id: string | null;
     /**
-     * How the environment was chosen (request, agent_config, repo_default, account_default, platform_default). Null when the config carried its own inline environment.
+     * 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.
      */
     source: EnvironmentSource | null;
 }

package/package.json

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

@@ -4059,7 +4059,7 @@
         },
         "source": {
           "$ref": "#/$defs/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": "#/$defs/SessionStatus",
@@ -4416,7 +4416,7 @@
             }
           ],
           "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."
+          "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."
         }
       },
       "required": [
@@ -4703,7 +4703,7 @@
           "title": "Author"
         },
         "body": {
-          "description": "The message text.",
+          "description": "The message text, with one `[Image #N]` placeholder per attached image.",
           "title": "Body",
           "type": "string"
         },
@@ -4758,6 +4758,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": "#/$defs/SessionMessageImage"
+          },
+          "title": "Images",
+          "type": "array"
+        },
         "sender_attribution_id": {
           "anyOf": [
             {
@@ -4801,6 +4809,7 @@
         "delivered_turn_id",
         "feed_seq",
         "id",
+        "images",
         "sender_attribution_id",
         "sender_attribution_type",
         "session_id",
@@ -4809,6 +4818,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"
+    },
     "SessionMessageStatus": {
       "enum": [
         "pending",
@@ -4920,9 +4956,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",