@ellipsis-dev/sdk 0.38.0 → 0.44.0

package/package.json

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

@@ -599,7 +599,7 @@
     },
     "ComputeConfig": {
       "additionalProperties": false,
-      "description": "Environment compute sizing. Every field is optional; an omitted field\ninherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value\noutside the platform bounds fails validation loudly (a sync error on the\nconfig) rather than being clamped silently.\n\n`memory` and `timeout` each accept a shorthand string (\"8GB\", \"30m\") or an\nexplicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /\n`timeout_seconds` properties resolve either form to the canonical integer\nthe environment is sized with.\n\n`timeout` is the max wall-clock the agent may run in one environment before\nit is stopped, capped at 1h (equal to the default, so today the knob only\nshortens a session; the cap matches the 1-hour validity of the session's\nGitHub token).\n\nCompute currently uses a temporary flat one-cent amount each time an\nenvironment is started for a session, subject to the account's existing\nfree-compute exemptions.",
+      "description": "The size and lifetime of the environment. Every field is optional. An\nomitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,\n10m idle). A value outside the platform bounds fails validation.\n\n`memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.\n`timeout` and `idle` accept a duration string such as `30m`, `8h`, or\n`1h30m`.\n\n`timeout` is the longest one message's work may run before it is stopped,\n1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.\n\n`idle` is how long the environment stays awake after the agent finishes\nwith no message waiting, 10s to 1h, default 10m. Then it pauses, and the\nnext message resumes it. Only an interactive session pauses. A session\nthat runs once ends when its message ends.",
       "properties": {
         "cpu": {
           "anyOf": [
@@ -615,6 +615,18 @@
           "default": null,
           "title": "Cpu"
         },
+        "idle": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Idle"
+        },
         "memory": {
           "anyOf": [
             {
@@ -635,9 +647,6 @@
             {
               "type": "string"
             },
-            {
-              "$ref": "#/$defs/Duration"
-            },
             {
               "type": "null"
             }
@@ -648,6 +657,7 @@
       },
       "required": [
         "cpu",
+        "idle",
         "memory",
         "timeout"
       ],
@@ -767,58 +777,6 @@
       "title": "CronTrigger",
       "type": "object"
     },
-    "Duration": {
-      "additionalProperties": false,
-      "description": "A duration as explicit units, summed. Set any of `hours`/`minutes`/\n`seconds` (at least one). The alternative to the `30m`-style shorthand\nstring wherever a duration is accepted.",
-      "properties": {
-        "hours": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Hours"
-        },
-        "minutes": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Minutes"
-        },
-        "seconds": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Seconds"
-        }
-      },
-      "required": [
-        "hours",
-        "minutes",
-        "seconds"
-      ],
-      "title": "Duration",
-      "type": "object"
-    },
     "EffortLevel": {
       "enum": [
         "low",
@@ -933,6 +891,7 @@
           "$ref": "#/$defs/ComputeConfig",
           "default": {
             "cpu": null,
+            "idle": null,
             "memory": null,
             "timeout": null
           }
@@ -1178,7 +1137,8 @@
         "unsupported_configuration",
         "execution_disabled",
         "interrupted",
-        "stopped"
+        "stopped",
+        "timeout"
       ],
       "title": "ErrorReason",
       "type": "string"
@@ -4370,6 +4330,7 @@
           "default": {
             "compute": {
               "cpu": null,
+              "idle": null,
               "memory": null,
               "timeout": null
             },
@@ -4504,6 +4465,7 @@
           "$ref": "#/$defs/ComputeConfig",
           "default": {
             "cpu": null,
+            "idle": null,
             "memory": null,
             "timeout": null
           }

package/schema/frames.schema.json

@@ -3799,7 +3799,7 @@
     },
     "ComputeConfig": {
       "additionalProperties": false,
-      "description": "Environment compute sizing. Every field is optional; an omitted field\ninherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value\noutside the platform bounds fails validation loudly (a sync error on the\nconfig) rather than being clamped silently.\n\n`memory` and `timeout` each accept a shorthand string (\"8GB\", \"30m\") or an\nexplicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /\n`timeout_seconds` properties resolve either form to the canonical integer\nthe environment is sized with.\n\n`timeout` is the max wall-clock the agent may run in one environment before\nit is stopped, capped at 1h (equal to the default, so today the knob only\nshortens a session; the cap matches the 1-hour validity of the session's\nGitHub token).\n\nCompute currently uses a temporary flat one-cent amount each time an\nenvironment is started for a session, subject to the account's existing\nfree-compute exemptions.",
+      "description": "The size and lifetime of the environment. Every field is optional. An\nomitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,\n10m idle). A value outside the platform bounds fails validation.\n\n`memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.\n`timeout` and `idle` accept a duration string such as `30m`, `8h`, or\n`1h30m`.\n\n`timeout` is the longest one message's work may run before it is stopped,\n1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.\n\n`idle` is how long the environment stays awake after the agent finishes\nwith no message waiting, 10s to 1h, default 10m. Then it pauses, and the\nnext message resumes it. Only an interactive session pauses. A session\nthat runs once ends when its message ends.",
       "properties": {
         "cpu": {
           "anyOf": [
@@ -3815,6 +3815,18 @@
           "default": null,
           "title": "Cpu"
         },
+        "idle": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Idle"
+        },
         "memory": {
           "anyOf": [
             {
@@ -3835,9 +3847,6 @@
             {
               "type": "string"
             },
-            {
-              "$ref": "#/$defs/Duration"
-            },
             {
               "type": "null"
             }
@@ -3848,6 +3857,7 @@
       },
       "required": [
         "cpu",
+        "idle",
         "memory",
         "timeout"
       ],
@@ -4021,58 +4031,6 @@
       "title": "DeltaFrame",
       "type": "object"
     },
-    "Duration": {
-      "additionalProperties": false,
-      "description": "A duration as explicit units, summed. Set any of `hours`/`minutes`/\n`seconds` (at least one). The alternative to the `30m`-style shorthand\nstring wherever a duration is accepted.",
-      "properties": {
-        "hours": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Hours"
-        },
-        "minutes": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Minutes"
-        },
-        "seconds": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Seconds"
-        }
-      },
-      "required": [
-        "hours",
-        "minutes",
-        "seconds"
-      ],
-      "title": "Duration",
-      "type": "object"
-    },
     "EffortLevel": {
       "enum": [
         "low",
@@ -4187,6 +4145,7 @@
           "$ref": "#/$defs/ComputeConfig",
           "default": {
             "cpu": null,
+            "idle": null,
             "memory": null,
             "timeout": null
           }
@@ -5024,7 +4983,8 @@
         "unsupported_configuration",
         "execution_disabled",
         "interrupted",
-        "stopped"
+        "stopped",
+        "timeout"
       ],
       "title": "ErrorReason",
       "type": "string"
@@ -10397,6 +10357,7 @@
           "default": {
             "compute": {
               "cpu": null,
+              "idle": null,
               "memory": null,
               "timeout": null
             },
@@ -10531,6 +10492,7 @@
           "$ref": "#/$defs/ComputeConfig",
           "default": {
             "cpu": null,
+            "idle": null,
             "memory": null,
             "timeout": null
           }
@@ -11019,6 +10981,19 @@
     "SessionMessageImage": {
       "description": "One image on a message, metadata only. `index` is the N in the\n`[Image #N]` placeholder in the message body.",
       "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The image's ID. `GET /v1/sessions/{session_id}/images/{id}` returns its bytes. Null when the image can't be fetched.",
+          "title": "Id"
+        },
         "index": {
           "description": "1-based position: the N in `[Image #N]`.",
           "title": "Index",

package/schema/lifecycle.schema.json

@@ -192,7 +192,8 @@
         "unsupported_configuration",
         "execution_disabled",
         "interrupted",
-        "stopped"
+        "stopped",
+        "timeout"
       ],
       "title": "ErrorReason",
       "type": "string"
@@ -533,6 +534,19 @@
     "SessionMessageImage": {
       "description": "One image on a message, metadata only. `index` is the N in the\n`[Image #N]` placeholder in the message body.",
       "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The image's ID. `GET /v1/sessions/{session_id}/images/{id}` returns its bytes. Null when the image can't be fetched.",
+          "title": "Id"
+        },
         "index": {
           "description": "1-based position: the N in `[Image #N]`.",
           "title": "Index",