@ellipsis-dev/sdk 0.20.0 → 0.22.0

package/schema/openapi.v1.json

@@ -3656,16 +3656,6 @@
         "title": "ErrorResponse",
         "type": "object"
       },
-      "ExecutionStatus": {
-        "description": "Per-execution status ladder (was AgentProcessStatus). Distinct from the\nsession's durable `session_state` and from `agent_sessions.status`, which\nremains the atomic claim/dispatch guard.",
-        "enum": [
-          "running",
-          "failed",
-          "done"
-        ],
-        "title": "ExecutionStatus",
-        "type": "string"
-      },
       "File": {
         "description": "A file's metadata \u2014 the file itself is fetched via a separate\ndownload URL.",
         "properties": {
@@ -6255,132 +6245,6 @@
         "title": "RecentPullRequest",
         "type": "object"
       },
-      "RecordHit": {
-        "description": "One session-log record matching a search query, denormalized with just\nenough session context to render a result row and deep-link to the\nsession.",
-        "properties": {
-          "attribution_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The actor the session is attributed to; the key into the response's attributed_users map for github_user attributions.",
-            "title": "Attribution Id"
-          },
-          "attribution_type": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/AttributionType"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "What kind of actor the session is attributed to. Only github_user attributions appear in the response's attributed_users map."
-          },
-          "config_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The agent config the session ran from, when it ran from a stored config.",
-            "title": "Config Id"
-          },
-          "created_at": {
-            "description": "When the record was written.",
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "execution_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The session execution that produced the record, or null for session-scoped lifecycle records.",
-            "title": "Execution Id"
-          },
-          "git": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionGit"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "What the session did to git, per repository, so a result row can show what it shipped without fetching the session."
-          },
-          "id": {
-            "description": "The matching record's unique identifier.",
-            "title": "Id",
-            "type": "string"
-          },
-          "record_type": {
-            "description": "The record's event type.",
-            "title": "Record Type",
-            "type": "string"
-          },
-          "session_id": {
-            "description": "The session the record belongs to.",
-            "title": "Session Id",
-            "type": "string"
-          },
-          "session_source": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionSource"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Where the matching session came from."
-          },
-          "session_status": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionStatus"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The matching session's status."
-          },
-          "snippet": {
-            "description": "A short window of the indexed text around the first match.",
-            "title": "Snippet",
-            "type": "string"
-          },
-          "stream_seq": {
-            "description": "The record's position within its execution's stream.",
-            "title": "Stream Seq",
-            "type": "integer"
-          }
-        },
-        "required": [
-          "id",
-          "session_id",
-          "stream_seq",
-          "record_type",
-          "created_at",
-          "snippet"
-        ],
-        "title": "RecordHit",
-        "type": "object"
-      },
       "RecordSource": {
         "description": "`session_records.source` \u2014 the client render switch. `lifecycle` rows are\ncontroller-emitted platform notifications; a harness value means a native\ntranscript record from that harness.",
         "enum": [
@@ -8850,15 +8714,8 @@
             "description": "The latest live summary of the session's progress while it runs, and when it was generated."
           },
           "surface": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionSurface"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The public status projection; null on list/search responses, which do not derive it."
+            "$ref": "#/components/schemas/SessionSurface",
+            "description": "The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word."
           },
           "tokens": {
             "$ref": "#/components/schemas/SessionTokens",
@@ -8878,6 +8735,7 @@
           "harness",
           "source",
           "status",
+          "surface",
           "prompting",
           "agent"
         ],
@@ -9054,129 +8912,6 @@
         "title": "SessionEnvironment",
         "type": "object"
       },
-      "SessionExecution": {
-        "description": "One runtime attempt of a session \u2014 the initial start, a cold wake of a\ndurable conversation, or an infrastructure retry \u2014 including the launch\ncontext the model was actually given.",
-        "properties": {
-          "attempt_index": {
-            "description": "Infrastructure-retry counter within one wake.",
-            "title": "Attempt Index",
-            "type": "integer"
-          },
-          "created_at": {
-            "description": "When the execution was created.",
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "execution_index": {
-            "description": "Monotonic position of this execution within the session, across all starts, wakes, and retries.",
-            "title": "Execution Index",
-            "type": "integer"
-          },
-          "exit_status": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Finer terminal reason, mirroring the session's exit_status vocabulary; null until the execution is terminal.",
-            "title": "Exit Status"
-          },
-          "id": {
-            "description": "Unique identifier of the execution.",
-            "title": "Id",
-            "type": "string"
-          },
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The model the harness was launched with, when a launch config exists.",
-            "title": "Model"
-          },
-          "query": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The initial query delivered to the harness, when the trigger carried one.",
-            "title": "Query"
-          },
-          "resumed": {
-            "description": "Whether this execution resumed a prior conversation (a cold wake with the previous state restored).",
-            "title": "Resumed",
-            "type": "boolean"
-          },
-          "session_id": {
-            "description": "Identifier of the session this execution belongs to.",
-            "title": "Session Id",
-            "type": "string"
-          },
-          "status": {
-            "$ref": "#/components/schemas/ExecutionStatus",
-            "description": "Execution status."
-          },
-          "system_prompt_append": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The system-prompt text Ellipsis appends to the harness's default system prompt (the platform section, run-type instructions, and the config's own instructions) \u2014 the platform-added portion, not the complete prompt the model saw. Null when no launch config was persisted (the execution failed before provisioning finished).",
-            "title": "System Prompt Append"
-          },
-          "wake_index": {
-            "description": "0 on the session's fresh start; increments once per cold wake of a durable conversation.",
-            "title": "Wake Index",
-            "type": "integer"
-          }
-        },
-        "required": [
-          "id",
-          "session_id",
-          "created_at",
-          "execution_index",
-          "wake_index",
-          "attempt_index",
-          "resumed",
-          "status"
-        ],
-        "title": "SessionExecution",
-        "type": "object"
-      },
-      "SessionExecutionsListResponse": {
-        "description": "A session's executions with the launch context each was given.",
-        "properties": {
-          "executions": {
-            "description": "The session's executions (initial start, cold wakes, infra retries), ordered by execution_index. Each carries the launch context the harness was given: system_prompt_append (the text appended to Claude Code's default system prompt), the initial query, and the model.",
-            "items": {
-              "$ref": "#/components/schemas/SessionExecution"
-            },
-            "title": "Executions",
-            "type": "array"
-          }
-        },
-        "required": [
-          "executions"
-        ],
-        "title": "SessionExecutionsListResponse",
-        "type": "object"
-      },
       "SessionExitStatus": {
         "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
         "enum": [
@@ -9393,7 +9128,7 @@
         "description": "The durable conversation axis (backs the surfaced `session` field).",
         "enum": [
           "alive",
-          "sleeping",
+          "idle",
           "closed"
         ],
         "title": "SessionLiveness",
@@ -9755,93 +9490,6 @@
         "title": "SessionResponse",
         "type": "object"
       },
-      "SessionSearchResponse": {
-        "description": "A page of session search results.",
-        "properties": {
-          "attributed_users": {
-            "additionalProperties": {
-              "$ref": "#/components/schemas/GithubAccountSnippet"
-            },
-            "description": "GitHub account snippets for the user attributions among the results, keyed by attribution_id, so callers can render author logins and avatars.",
-            "title": "Attributed Users",
-            "type": "object"
-          },
-          "results": {
-            "description": "The matching sessions, newest first.",
-            "items": {
-              "$ref": "#/components/schemas/SessionSearchResult"
-            },
-            "title": "Results",
-            "type": "array"
-          }
-        },
-        "required": [
-          "results",
-          "attributed_users"
-        ],
-        "title": "SessionSearchResponse",
-        "type": "object"
-      },
-      "SessionSearchResult": {
-        "description": "One search hit: a session plus how and where the query matched it.",
-        "properties": {
-          "matched": {
-            "description": "Which search arms matched this session: \"records\", \"recap\", \"pr\", and/or \"similar\".",
-            "items": {
-              "type": "string"
-            },
-            "title": "Matched",
-            "type": "array"
-          },
-          "recap_snippet": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "A short window of the session's recap text around the first term match; null unless the recap arm matched.",
-            "title": "Recap Snippet"
-          },
-          "record_hit_count": {
-            "default": 0,
-            "description": "Total record hits found for this session within the search window; may exceed the number of record_hits returned.",
-            "title": "Record Hit Count",
-            "type": "integer"
-          },
-          "record_hits": {
-            "default": [],
-            "description": "Matching session-log entries, capped per session.",
-            "items": {
-              "$ref": "#/components/schemas/RecordHit"
-            },
-            "title": "Record Hits",
-            "type": "array"
-          },
-          "session": {
-            "$ref": "#/components/schemas/Session",
-            "description": "The matching session."
-          }
-        },
-        "required": [
-          "session",
-          "matched"
-        ],
-        "title": "SessionSearchResult",
-        "type": "object"
-      },
-      "SessionSearchScope": {
-        "description": "What text a search query is matched against: the session log's record\ntext, the session recaps (summaries), or both.",
-        "enum": [
-          "records",
-          "recaps",
-          "both"
-        ],
-        "title": "SessionSearchScope",
-        "type": "string"
-      },
       "SessionSource": {
         "enum": [
           "react",
@@ -13796,7 +13444,7 @@
     },
     "/v1/integrations/github/members": {
       "get": {
-        "description": "List the GitHub organization roster.\n\n(Or the account itself for a personal workspace) \u2014 the universe of author_id values for\n/sessions and /sessions/search.\n\nMembers carry their linked Slack identity when a Slack-GitHub\nlink exists, and /slack/members carries the reverse link.",
+        "description": "List the GitHub organization roster.\n\n(Or the account itself for a personal workspace) \u2014 the universe of author_id values for\n/sessions.\n\nMembers carry their linked Slack identity when a Slack-GitHub\nlink exists, and /slack/members carries the reverse link.",
         "operationId": "list_github_members",
         "parameters": [
           {
@@ -15731,7 +15379,7 @@
             }
           },
           {
-            "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
+            "description": "\"owner/name\" (exact) or a bare repo name. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
             "in": "query",
             "name": "repo",
             "required": false,
@@ -15744,18 +15392,18 @@
                   "type": "null"
                 }
               ],
-              "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
+              "description": "\"owner/name\" (exact) or a bare repo name. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
               "title": "Repo"
             }
           },
           {
-            "description": "Keep only sessions whose conversation is still going \u2014 live or sleeping \u2014 dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished.",
+            "description": "Keep only sessions whose conversation is still going \u2014 live or idle \u2014 dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished.",
             "in": "query",
             "name": "unfinished",
             "required": false,
             "schema": {
               "default": false,
-              "description": "Keep only sessions whose conversation is still going \u2014 live or sleeping \u2014 dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished.",
+              "description": "Keep only sessions whose conversation is still going \u2014 live or idle \u2014 dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished.",
               "title": "Unfinished",
               "type": "boolean"
             }
@@ -15935,284 +15583,17 @@
         "x-ellipsis-sdk-method": "sessions.start"
       }
     },
-    "/v1/sessions/search": {
+    "/v1/sessions/{session_id}": {
       "get": {
-        "description": "Search sessions over steps, recaps, and pull requests.\n\nGrouped by session, over everything a session left behind: step text, recap text, created\nPRs, and recap-embedding similarity.\n\nThis is how an agent answers \"did Tony look into X?\": resolve\nthe author via /github/members, search, then read the winning\nsession via /sessions/{id} (recap) and /sessions/{id}/records\n(transcript).",
-        "operationId": "search_sessions",
+        "description": "Return one session.\n\nThe public wire shape \u2014 the same shape the stream's session\nframes carry, with attributed_user and stopped_by_user resolved\nat read time.\n\nThe heavy near-static blobs (config snapshot, input/output)\nlive on the detail endpoints, not here.",
+        "operationId": "get_agent_session",
         "parameters": [
           {
-            "in": "query",
-            "name": "q",
+            "in": "path",
+            "name": "session_id",
             "required": true,
             "schema": {
-              "title": "Q",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "scope",
-            "required": false,
-            "schema": {
-              "$ref": "#/components/schemas/SessionSearchScope",
-              "default": "both"
-            }
-          },
-          {
-            "in": "query",
-            "name": "source",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "$ref": "#/components/schemas/SessionSource"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Source"
-            }
-          },
-          {
-            "description": "Attributed GitHub user account ids.",
-            "in": "query",
-            "name": "author_id",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "integer"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Attributed GitHub user account ids.",
-              "title": "Author Id"
-            }
-          },
-          {
-            "description": "Saved agent config ids (ORed with author_id).",
-            "in": "query",
-            "name": "config_id",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Saved agent config ids (ORed with author_id).",
-              "title": "Config Id"
-            }
-          },
-          {
-            "in": "query",
-            "name": "session_ids",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Session Ids"
-            }
-          },
-          {
-            "description": "\"owner/name\" (exact) or a bare repo name.",
-            "in": "query",
-            "name": "repo",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "\"owner/name\" (exact) or a bare repo name.",
-              "title": "Repo"
-            }
-          },
-          {
-            "in": "query",
-            "name": "status",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "$ref": "#/components/schemas/SessionStatus"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Status"
-            }
-          },
-          {
-            "in": "query",
-            "name": "start",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Start"
-            }
-          },
-          {
-            "in": "query",
-            "name": "end",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "End"
-            }
-          },
-          {
-            "in": "query",
-            "name": "limit",
-            "required": false,
-            "schema": {
-              "default": 20,
-              "maximum": 100,
-              "minimum": 1,
-              "title": "Limit",
-              "type": "integer"
-            }
-          },
-          {
-            "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/SessionSearchResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The search query is too short."
-          },
-          "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": "Search Agent Sessions",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "sessions.search"
-      }
-    },
-    "/v1/sessions/{session_id}": {
-      "get": {
-        "description": "Return one session.\n\nThe public wire shape \u2014 the same shape the stream's session\nframes carry, with attributed_user and stopped_by_user resolved\nat read time.\n\nThe heavy near-static blobs (config snapshot, input/output)\nlive on the detail endpoints, not here.",
-        "operationId": "get_agent_session",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "session_id",
-            "required": true,
-            "schema": {
-              "title": "Session Id",
+              "title": "Session Id",
               "type": "string"
             }
           },
@@ -16297,101 +15678,6 @@
         "x-ellipsis-sdk-method": "sessions.get"
       }
     },
-    "/v1/sessions/{session_id}/executions": {
-      "get": {
-        "description": "Return the session's executions and launch context.\n\nMost notably system_prompt_append, the text Ellipsis appends to\nClaude Code's default system prompt (platform section + response\ninstructions + the config's own instructions).\n\nPer execution because each cold wake persists its own launch\nconfig (a config edit between wakes changes it).",
-        "operationId": "get_agent_session_executions",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "session_id",
-            "required": true,
-            "schema": {
-              "title": "Session Id",
-              "type": "string"
-            }
-          },
-          {
-            "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/SessionExecutionsListResponse"
-                }
-              }
-            },
-            "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."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "No such session in your account."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Agent Session Executions",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "sessions.executions"
-      }
-    },
     "/v1/sessions/{session_id}/export": {
       "get": {
         "description": "Export the complete session history.\n\nThe complete, ordered history of the session (agent output, tool calls, thinking,\nlifecycle events, sandbox output, message events) as an ordered\nmanifest of presigned segment URLs.\n\nSegments are gzip members: download in order and concatenate\nfor one file. The JSON API never carries the bytes (same\ntwo-step as files). /records is the paged live view of the\nsame data.",
@@ -16709,7 +15995,7 @@
     },
     "/v1/sessions/{session_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 sandbox tokens too: an\nagent answering \"did X look into Y?\" needs to read the session\nit found via /sessions/search, and any org member sees the same\ntranscript in the dashboard.",
+        "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 sandbox 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.",
         "operationId": "get_agent_session_records",
         "parameters": [
           {