@ellipsis-dev/sdk 0.43.0 → 0.44.0

package/schema/openapi.v1.json

@@ -5623,7 +5623,7 @@
       },
       "ComputeConfig-Input": {
         "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": [
@@ -5638,6 +5638,17 @@
             ],
             "title": "Cpu"
           },
+          "idle": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Idle"
+          },
           "memory": {
             "anyOf": [
               {
@@ -5657,9 +5668,6 @@
               {
                 "type": "string"
               },
-              {
-                "$ref": "#/components/schemas/Duration-Input"
-              },
               {
                 "type": "null"
               }
@@ -5672,7 +5680,7 @@
       },
       "ComputeConfig-Output": {
         "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": [
@@ -5687,6 +5695,17 @@
             ],
             "title": "Cpu"
           },
+          "idle": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Idle"
+          },
           "memory": {
             "anyOf": [
               {
@@ -5706,9 +5725,6 @@
               {
                 "type": "string"
               },
-              {
-                "$ref": "#/components/schemas/Duration-Output"
-              },
               {
                 "type": "null"
               }
@@ -5718,6 +5734,7 @@
         },
         "required": [
           "cpu",
+          "idle",
           "memory",
           "timeout"
         ],
@@ -6165,7 +6182,9 @@
           "github_installation_unsuspended",
           "credit_granted",
           "refund_issued",
-          "auto_recharge_updated"
+          "auto_recharge_updated",
+          "platform_fee_updated",
+          "github_proxy_updated"
         ],
         "title": "CustomerAuditLogEventType",
         "type": "string"
@@ -6543,99 +6562,6 @@
         "title": "DeveloperUsage",
         "type": "object"
       },
-      "Duration-Input": {
-        "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.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Hours"
-          },
-          "minutes": {
-            "anyOf": [
-              {
-                "minimum": 0.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Minutes"
-          },
-          "seconds": {
-            "anyOf": [
-              {
-                "minimum": 0.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Seconds"
-          }
-        },
-        "title": "Duration",
-        "type": "object"
-      },
-      "Duration-Output": {
-        "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.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Hours"
-          },
-          "minutes": {
-            "anyOf": [
-              {
-                "minimum": 0.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Minutes"
-          },
-          "seconds": {
-            "anyOf": [
-              {
-                "minimum": 0.0,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Seconds"
-          }
-        },
-        "required": [
-          "hours",
-          "minutes",
-          "seconds"
-        ],
-        "title": "Duration",
-        "type": "object"
-      },
       "EffortLevel": {
         "enum": [
           "low",
@@ -8145,7 +8071,8 @@
           "unsupported_configuration",
           "execution_disabled",
           "interrupted",
-          "stopped"
+          "stopped",
+          "timeout"
         ],
         "title": "ErrorReason",
         "type": "string"
@@ -14186,6 +14113,135 @@
         "title": "PromptBlockedReason",
         "type": "string"
       },
+      "ProxyRequest": {
+        "description": "One request an environment sent through Ellipsis to GitHub, as the\nproxy recorded it.",
+        "properties": {
+          "connection": {
+            "description": "Where it went. `github` today.",
+            "title": "Connection",
+            "type": "string"
+          },
+          "created_at": {
+            "description": "When the request ended.",
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "customer_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The account.",
+            "title": "Customer Id"
+          },
+          "duration_ms": {
+            "description": "Milliseconds from arrival to the end.",
+            "title": "Duration Ms",
+            "type": "integer"
+          },
+          "id": {
+            "title": "Id",
+            "type": "string"
+          },
+          "method": {
+            "description": "The HTTP method as the environment sent it.",
+            "title": "Method",
+            "type": "string"
+          },
+          "path": {
+            "description": "The path as the environment sent it.",
+            "title": "Path",
+            "type": "string"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Why Ellipsis answered itself or the transfer ended early, null when GitHub answered in full.",
+            "title": "Reason"
+          },
+          "request_bytes": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Body bytes sent, null when none was read.",
+            "title": "Request Bytes"
+          },
+          "response_bytes": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Body bytes received, null when nothing was forwarded.",
+            "title": "Response Bytes"
+          },
+          "sandbox_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The environment that sent it, the id `GET /v1/vms/{id}` reads.",
+            "title": "Sandbox Id"
+          },
+          "status_code": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The status the environment received.",
+            "title": "Status Code"
+          },
+          "upstream_host": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The host Ellipsis forwarded it to, null when Ellipsis answered itself.",
+            "title": "Upstream Host"
+          }
+        },
+        "required": [
+          "id",
+          "connection",
+          "method",
+          "path",
+          "duration_ms",
+          "created_at"
+        ],
+        "title": "ProxyRequest",
+        "type": "object"
+      },
       "PublicFeeSchedule": {
         "description": "Rates in millicents. purchase_fee_fraction is a fraction, for example 0.10.",
         "properties": {
@@ -19592,6 +19648,40 @@
         "title": "SessionPrompting",
         "type": "object"
       },
+      "SessionProxyResponse": {
+        "properties": {
+          "has_more": {
+            "default": false,
+            "description": "Whether more results exist past this page.",
+            "title": "Has More",
+            "type": "boolean"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Pass as `cursor` to fetch the next page. Null on the last page. Opaque \u2014 echo it back rather than parsing it.",
+            "title": "Next Cursor"
+          },
+          "proxy_requests": {
+            "items": {
+              "$ref": "#/components/schemas/ProxyRequest"
+            },
+            "title": "Proxy Requests",
+            "type": "array"
+          }
+        },
+        "required": [
+          "proxy_requests"
+        ],
+        "title": "SessionProxyResponse",
+        "type": "object"
+      },
       "SessionPullRequestReview": {
         "properties": {
           "body": {
@@ -32574,6 +32664,164 @@
         "x-ellipsis-undocumented": true
       }
     },
+    "/v1/sessions/{id}/proxy": {
+      "get": {
+        "description": "The requests the session's environment sent to GitHub through\nEllipsis, newest first. Each is one `proxy_requests` row as stored.",
+        "operationId": "get_session_proxy",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "title": "Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "default": 50,
+              "maximum": 200,
+              "minimum": 1,
+              "title": "Limit",
+              "type": "integer"
+            }
+          },
+          {
+            "description": "The `next_cursor` of the previous page.",
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The `next_cursor` of the previous page.",
+              "title": "Cursor"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SessionProxyResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Session Proxy",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-permissions": {
+          "constraints": [
+            {
+              "account_admin_fields": [],
+              "identity": null,
+              "sandbox_scope": "own_session"
+            }
+          ],
+          "description": "Required permissions: read:sessions.\nAPI key: Supported.\nCLI user token: Supported.\nSession token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.\nHigher permission levels include lower levels: read < write < delete.\nGrant match patterns can further restrict access to individual resources.",
+          "notes": [
+            "Higher permission levels include lower levels: read < write < delete.",
+            "Grant match patterns can further restrict access to individual resources."
+          ],
+          "required": [
+            {
+              "level": "read",
+              "resource": "sessions"
+            }
+          ],
+          "tokens": [
+            {
+              "available": true,
+              "conditions": [],
+              "kind": "api_key",
+              "label": "API key"
+            },
+            {
+              "available": true,
+              "conditions": [],
+              "kind": "user_token",
+              "label": "CLI user token"
+            },
+            {
+              "available": true,
+              "conditions": [
+                "Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.",
+                "Only the token's own session."
+              ],
+              "kind": "sandbox_token",
+              "label": "Session token"
+            }
+          ]
+        },
+        "x-ellipsis-sdk-method": "sessions.proxy"
+      }
+    },
     "/v1/sessions/{id}/records": {
       "get": {
         "description": "Return the session's stored transcript records, oldest first.\n\nPagination is opt-in (cursor/limit); a bare call returns the\nfull retained transcript. Available to session tokens too: an\nagent answering \"did X look into Y?\" needs to read the sessions\nit finds, and any org member sees the same transcript in the\ndashboard.",