@ellipsis-dev/sdk 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3656,16 +3656,6 @@
3656
3656
  "title": "ErrorResponse",
3657
3657
  "type": "object"
3658
3658
  },
3659
- "ExecutionStatus": {
3660
- "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.",
3661
- "enum": [
3662
- "running",
3663
- "failed",
3664
- "done"
3665
- ],
3666
- "title": "ExecutionStatus",
3667
- "type": "string"
3668
- },
3669
3659
  "File": {
3670
3660
  "description": "A file's metadata \u2014 the file itself is fetched via a separate\ndownload URL.",
3671
3661
  "properties": {
@@ -5427,82 +5417,6 @@
5427
5417
  "title": "MemorySummary",
5428
5418
  "type": "object"
5429
5419
  },
5430
- "Model": {
5431
- "properties": {
5432
- "display_name": {
5433
- "title": "Display Name",
5434
- "type": "string"
5435
- },
5436
- "id": {
5437
- "title": "Id",
5438
- "type": "string"
5439
- },
5440
- "is_default_agent_model": {
5441
- "title": "Is Default Agent Model",
5442
- "type": "boolean"
5443
- },
5444
- "manufacturer": {
5445
- "$ref": "#/components/schemas/ModelManufacturer"
5446
- },
5447
- "rate_card": {
5448
- "$ref": "#/components/schemas/ModelRateCardApi"
5449
- }
5450
- },
5451
- "required": [
5452
- "id",
5453
- "display_name",
5454
- "manufacturer",
5455
- "is_default_agent_model",
5456
- "rate_card"
5457
- ],
5458
- "title": "Model",
5459
- "type": "object"
5460
- },
5461
- "ModelManufacturer": {
5462
- "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC even though OpenRouter is what actually serves them.\nLikewise the `gpt-5.6-*` rows are OPENAI (OpenAI's models, resold to us by\nOpenRouter), and GLM is ZAI (Z.ai's model, served by DeepInfra via\nOpenRouter).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
5463
- "enum": [
5464
- "anthropic",
5465
- "openai",
5466
- "zai",
5467
- "minimax",
5468
- "moonshot"
5469
- ],
5470
- "title": "ModelManufacturer",
5471
- "type": "string"
5472
- },
5473
- "ModelRateCardApi": {
5474
- "properties": {
5475
- "cache_read_millicents_per_1m_tokens": {
5476
- "title": "Cache Read Millicents Per 1M Tokens",
5477
- "type": "integer"
5478
- },
5479
- "cache_write_1h_millicents_per_1m_tokens": {
5480
- "title": "Cache Write 1H Millicents Per 1M Tokens",
5481
- "type": "integer"
5482
- },
5483
- "cache_write_5m_millicents_per_1m_tokens": {
5484
- "title": "Cache Write 5M Millicents Per 1M Tokens",
5485
- "type": "integer"
5486
- },
5487
- "input_millicents_per_1m_tokens": {
5488
- "title": "Input Millicents Per 1M Tokens",
5489
- "type": "integer"
5490
- },
5491
- "output_millicents_per_1m_tokens": {
5492
- "title": "Output Millicents Per 1M Tokens",
5493
- "type": "integer"
5494
- }
5495
- },
5496
- "required": [
5497
- "input_millicents_per_1m_tokens",
5498
- "cache_write_5m_millicents_per_1m_tokens",
5499
- "cache_write_1h_millicents_per_1m_tokens",
5500
- "cache_read_millicents_per_1m_tokens",
5501
- "output_millicents_per_1m_tokens"
5502
- ],
5503
- "title": "ModelRateCardApi",
5504
- "type": "object"
5505
- },
5506
5420
  "ModelUsageBreakdown": {
5507
5421
  "description": "Usage and cost for one model over the whole period, split into the four\nbilled categories.",
5508
5422
  "properties": {
@@ -5548,22 +5462,6 @@
5548
5462
  "title": "ModelUsageBreakdown",
5549
5463
  "type": "object"
5550
5464
  },
5551
- "ModelsListResponse": {
5552
- "properties": {
5553
- "models": {
5554
- "items": {
5555
- "$ref": "#/components/schemas/Model"
5556
- },
5557
- "title": "Models",
5558
- "type": "array"
5559
- }
5560
- },
5561
- "required": [
5562
- "models"
5563
- ],
5564
- "title": "ModelsListResponse",
5565
- "type": "object"
5566
- },
5567
5465
  "OrganizationRole": {
5568
5466
  "enum": [
5569
5467
  "admin",
@@ -6255,132 +6153,6 @@
6255
6153
  "title": "RecentPullRequest",
6256
6154
  "type": "object"
6257
6155
  },
6258
- "RecordHit": {
6259
- "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.",
6260
- "properties": {
6261
- "attribution_id": {
6262
- "anyOf": [
6263
- {
6264
- "type": "string"
6265
- },
6266
- {
6267
- "type": "null"
6268
- }
6269
- ],
6270
- "description": "The actor the session is attributed to; the key into the response's attributed_users map for github_user attributions.",
6271
- "title": "Attribution Id"
6272
- },
6273
- "attribution_type": {
6274
- "anyOf": [
6275
- {
6276
- "$ref": "#/components/schemas/AttributionType"
6277
- },
6278
- {
6279
- "type": "null"
6280
- }
6281
- ],
6282
- "description": "What kind of actor the session is attributed to. Only github_user attributions appear in the response's attributed_users map."
6283
- },
6284
- "config_id": {
6285
- "anyOf": [
6286
- {
6287
- "type": "string"
6288
- },
6289
- {
6290
- "type": "null"
6291
- }
6292
- ],
6293
- "description": "The agent config the session ran from, when it ran from a stored config.",
6294
- "title": "Config Id"
6295
- },
6296
- "created_at": {
6297
- "description": "When the record was written.",
6298
- "format": "date-time",
6299
- "title": "Created At",
6300
- "type": "string"
6301
- },
6302
- "execution_id": {
6303
- "anyOf": [
6304
- {
6305
- "type": "string"
6306
- },
6307
- {
6308
- "type": "null"
6309
- }
6310
- ],
6311
- "description": "The session execution that produced the record, or null for session-scoped lifecycle records.",
6312
- "title": "Execution Id"
6313
- },
6314
- "git": {
6315
- "anyOf": [
6316
- {
6317
- "$ref": "#/components/schemas/SessionGit"
6318
- },
6319
- {
6320
- "type": "null"
6321
- }
6322
- ],
6323
- "description": "What the session did to git, per repository, so a result row can show what it shipped without fetching the session."
6324
- },
6325
- "id": {
6326
- "description": "The matching record's unique identifier.",
6327
- "title": "Id",
6328
- "type": "string"
6329
- },
6330
- "record_type": {
6331
- "description": "The record's event type.",
6332
- "title": "Record Type",
6333
- "type": "string"
6334
- },
6335
- "session_id": {
6336
- "description": "The session the record belongs to.",
6337
- "title": "Session Id",
6338
- "type": "string"
6339
- },
6340
- "session_source": {
6341
- "anyOf": [
6342
- {
6343
- "$ref": "#/components/schemas/SessionSource"
6344
- },
6345
- {
6346
- "type": "null"
6347
- }
6348
- ],
6349
- "description": "Where the matching session came from."
6350
- },
6351
- "session_status": {
6352
- "anyOf": [
6353
- {
6354
- "$ref": "#/components/schemas/SessionStatus"
6355
- },
6356
- {
6357
- "type": "null"
6358
- }
6359
- ],
6360
- "description": "The matching session's status."
6361
- },
6362
- "snippet": {
6363
- "description": "A short window of the indexed text around the first match.",
6364
- "title": "Snippet",
6365
- "type": "string"
6366
- },
6367
- "stream_seq": {
6368
- "description": "The record's position within its execution's stream.",
6369
- "title": "Stream Seq",
6370
- "type": "integer"
6371
- }
6372
- },
6373
- "required": [
6374
- "id",
6375
- "session_id",
6376
- "stream_seq",
6377
- "record_type",
6378
- "created_at",
6379
- "snippet"
6380
- ],
6381
- "title": "RecordHit",
6382
- "type": "object"
6383
- },
6384
6156
  "RecordSource": {
6385
6157
  "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.",
6386
6158
  "enum": [
@@ -8850,15 +8622,8 @@
8850
8622
  "description": "The latest live summary of the session's progress while it runs, and when it was generated."
8851
8623
  },
8852
8624
  "surface": {
8853
- "anyOf": [
8854
- {
8855
- "$ref": "#/components/schemas/SessionSurface"
8856
- },
8857
- {
8858
- "type": "null"
8859
- }
8860
- ],
8861
- "description": "The public status projection; null on list/search responses, which do not derive it."
8625
+ "$ref": "#/components/schemas/SessionSurface",
8626
+ "description": "The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word."
8862
8627
  },
8863
8628
  "tokens": {
8864
8629
  "$ref": "#/components/schemas/SessionTokens",
@@ -8878,6 +8643,7 @@
8878
8643
  "harness",
8879
8644
  "source",
8880
8645
  "status",
8646
+ "surface",
8881
8647
  "prompting",
8882
8648
  "agent"
8883
8649
  ],
@@ -9054,129 +8820,6 @@
9054
8820
  "title": "SessionEnvironment",
9055
8821
  "type": "object"
9056
8822
  },
9057
- "SessionExecution": {
9058
- "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.",
9059
- "properties": {
9060
- "attempt_index": {
9061
- "description": "Infrastructure-retry counter within one wake.",
9062
- "title": "Attempt Index",
9063
- "type": "integer"
9064
- },
9065
- "created_at": {
9066
- "description": "When the execution was created.",
9067
- "format": "date-time",
9068
- "title": "Created At",
9069
- "type": "string"
9070
- },
9071
- "execution_index": {
9072
- "description": "Monotonic position of this execution within the session, across all starts, wakes, and retries.",
9073
- "title": "Execution Index",
9074
- "type": "integer"
9075
- },
9076
- "exit_status": {
9077
- "anyOf": [
9078
- {
9079
- "type": "string"
9080
- },
9081
- {
9082
- "type": "null"
9083
- }
9084
- ],
9085
- "description": "Finer terminal reason, mirroring the session's exit_status vocabulary; null until the execution is terminal.",
9086
- "title": "Exit Status"
9087
- },
9088
- "id": {
9089
- "description": "Unique identifier of the execution.",
9090
- "title": "Id",
9091
- "type": "string"
9092
- },
9093
- "model": {
9094
- "anyOf": [
9095
- {
9096
- "type": "string"
9097
- },
9098
- {
9099
- "type": "null"
9100
- }
9101
- ],
9102
- "description": "The model the harness was launched with, when a launch config exists.",
9103
- "title": "Model"
9104
- },
9105
- "query": {
9106
- "anyOf": [
9107
- {
9108
- "type": "string"
9109
- },
9110
- {
9111
- "type": "null"
9112
- }
9113
- ],
9114
- "description": "The initial query delivered to the harness, when the trigger carried one.",
9115
- "title": "Query"
9116
- },
9117
- "resumed": {
9118
- "description": "Whether this execution resumed a prior conversation (a cold wake with the previous state restored).",
9119
- "title": "Resumed",
9120
- "type": "boolean"
9121
- },
9122
- "session_id": {
9123
- "description": "Identifier of the session this execution belongs to.",
9124
- "title": "Session Id",
9125
- "type": "string"
9126
- },
9127
- "status": {
9128
- "$ref": "#/components/schemas/ExecutionStatus",
9129
- "description": "Execution status."
9130
- },
9131
- "system_prompt_append": {
9132
- "anyOf": [
9133
- {
9134
- "type": "string"
9135
- },
9136
- {
9137
- "type": "null"
9138
- }
9139
- ],
9140
- "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).",
9141
- "title": "System Prompt Append"
9142
- },
9143
- "wake_index": {
9144
- "description": "0 on the session's fresh start; increments once per cold wake of a durable conversation.",
9145
- "title": "Wake Index",
9146
- "type": "integer"
9147
- }
9148
- },
9149
- "required": [
9150
- "id",
9151
- "session_id",
9152
- "created_at",
9153
- "execution_index",
9154
- "wake_index",
9155
- "attempt_index",
9156
- "resumed",
9157
- "status"
9158
- ],
9159
- "title": "SessionExecution",
9160
- "type": "object"
9161
- },
9162
- "SessionExecutionsListResponse": {
9163
- "description": "A session's executions with the launch context each was given.",
9164
- "properties": {
9165
- "executions": {
9166
- "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.",
9167
- "items": {
9168
- "$ref": "#/components/schemas/SessionExecution"
9169
- },
9170
- "title": "Executions",
9171
- "type": "array"
9172
- }
9173
- },
9174
- "required": [
9175
- "executions"
9176
- ],
9177
- "title": "SessionExecutionsListResponse",
9178
- "type": "object"
9179
- },
9180
8823
  "SessionExitStatus": {
9181
8824
  "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.",
9182
8825
  "enum": [
@@ -9393,7 +9036,7 @@
9393
9036
  "description": "The durable conversation axis (backs the surfaced `session` field).",
9394
9037
  "enum": [
9395
9038
  "alive",
9396
- "sleeping",
9039
+ "idle",
9397
9040
  "closed"
9398
9041
  ],
9399
9042
  "title": "SessionLiveness",
@@ -9755,93 +9398,6 @@
9755
9398
  "title": "SessionResponse",
9756
9399
  "type": "object"
9757
9400
  },
9758
- "SessionSearchResponse": {
9759
- "description": "A page of session search results.",
9760
- "properties": {
9761
- "attributed_users": {
9762
- "additionalProperties": {
9763
- "$ref": "#/components/schemas/GithubAccountSnippet"
9764
- },
9765
- "description": "GitHub account snippets for the user attributions among the results, keyed by attribution_id, so callers can render author logins and avatars.",
9766
- "title": "Attributed Users",
9767
- "type": "object"
9768
- },
9769
- "results": {
9770
- "description": "The matching sessions, newest first.",
9771
- "items": {
9772
- "$ref": "#/components/schemas/SessionSearchResult"
9773
- },
9774
- "title": "Results",
9775
- "type": "array"
9776
- }
9777
- },
9778
- "required": [
9779
- "results",
9780
- "attributed_users"
9781
- ],
9782
- "title": "SessionSearchResponse",
9783
- "type": "object"
9784
- },
9785
- "SessionSearchResult": {
9786
- "description": "One search hit: a session plus how and where the query matched it.",
9787
- "properties": {
9788
- "matched": {
9789
- "description": "Which search arms matched this session: \"records\", \"recap\", \"pr\", and/or \"similar\".",
9790
- "items": {
9791
- "type": "string"
9792
- },
9793
- "title": "Matched",
9794
- "type": "array"
9795
- },
9796
- "recap_snippet": {
9797
- "anyOf": [
9798
- {
9799
- "type": "string"
9800
- },
9801
- {
9802
- "type": "null"
9803
- }
9804
- ],
9805
- "description": "A short window of the session's recap text around the first term match; null unless the recap arm matched.",
9806
- "title": "Recap Snippet"
9807
- },
9808
- "record_hit_count": {
9809
- "default": 0,
9810
- "description": "Total record hits found for this session within the search window; may exceed the number of record_hits returned.",
9811
- "title": "Record Hit Count",
9812
- "type": "integer"
9813
- },
9814
- "record_hits": {
9815
- "default": [],
9816
- "description": "Matching session-log entries, capped per session.",
9817
- "items": {
9818
- "$ref": "#/components/schemas/RecordHit"
9819
- },
9820
- "title": "Record Hits",
9821
- "type": "array"
9822
- },
9823
- "session": {
9824
- "$ref": "#/components/schemas/Session",
9825
- "description": "The matching session."
9826
- }
9827
- },
9828
- "required": [
9829
- "session",
9830
- "matched"
9831
- ],
9832
- "title": "SessionSearchResult",
9833
- "type": "object"
9834
- },
9835
- "SessionSearchScope": {
9836
- "description": "What text a search query is matched against: the session log's record\ntext, the session recaps (summaries), or both.",
9837
- "enum": [
9838
- "records",
9839
- "recaps",
9840
- "both"
9841
- ],
9842
- "title": "SessionSearchScope",
9843
- "type": "string"
9844
- },
9845
9401
  "SessionSource": {
9846
9402
  "enum": [
9847
9403
  "react",
@@ -13796,7 +13352,7 @@
13796
13352
  },
13797
13353
  "/v1/integrations/github/members": {
13798
13354
  "get": {
13799
- "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.",
13355
+ "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.",
13800
13356
  "operationId": "list_github_members",
13801
13357
  "parameters": [
13802
13358
  {
@@ -14871,82 +14427,6 @@
14871
14427
  "x-ellipsis-undocumented": true
14872
14428
  }
14873
14429
  },
14874
- "/v1/models": {
14875
- "get": {
14876
- "description": "List selectable agent models.\n\nMost expensive first, with the platform default flagged.\n\nReads the same registry as the dashboard's rate table, so a\nclient's model picker can never drift from what's offered.\nBehind auth but not account-scoped \u2014 the selectable set is\nglobal.",
14877
- "operationId": "list_supported_models",
14878
- "parameters": [
14879
- {
14880
- "in": "header",
14881
- "name": "user-agent",
14882
- "required": false,
14883
- "schema": {
14884
- "anyOf": [
14885
- {
14886
- "type": "string"
14887
- },
14888
- {
14889
- "type": "null"
14890
- }
14891
- ],
14892
- "title": "User-Agent"
14893
- }
14894
- }
14895
- ],
14896
- "responses": {
14897
- "200": {
14898
- "content": {
14899
- "application/json": {
14900
- "schema": {
14901
- "$ref": "#/components/schemas/ModelsListResponse"
14902
- }
14903
- }
14904
- },
14905
- "description": "Successful Response"
14906
- },
14907
- "401": {
14908
- "content": {
14909
- "application/json": {
14910
- "schema": {
14911
- "$ref": "#/components/schemas/ErrorResponse"
14912
- }
14913
- }
14914
- },
14915
- "description": "The bearer token is missing, invalid, or revoked."
14916
- },
14917
- "403": {
14918
- "content": {
14919
- "application/json": {
14920
- "schema": {
14921
- "$ref": "#/components/schemas/ErrorResponse"
14922
- }
14923
- }
14924
- },
14925
- "description": "The credential may not perform this action, or the account is blocked."
14926
- },
14927
- "422": {
14928
- "content": {
14929
- "application/json": {
14930
- "schema": {
14931
- "$ref": "#/components/schemas/HTTPValidationError"
14932
- }
14933
- }
14934
- },
14935
- "description": "Validation Error"
14936
- }
14937
- },
14938
- "security": [
14939
- {
14940
- "HTTPBearer": []
14941
- }
14942
- ],
14943
- "summary": "List Supported Models",
14944
- "tags": [
14945
- "v1"
14946
- ],
14947
- "x-ellipsis-sdk-method": "models.list"
14948
- }
14949
- },
14950
14430
  "/v1/reviews": {
14951
14431
  "get": {
14952
14432
  "description": "List code reviews, newest first.\n\n`findings` is omitted (counters only).\n\nWebhook-created reviews appear here too, so this answers \"show\nme every review on this PR\".",
@@ -15731,7 +15211,7 @@
15731
15211
  }
15732
15212
  },
15733
15213
  {
15734
- "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.",
15214
+ "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.",
15735
15215
  "in": "query",
15736
15216
  "name": "repo",
15737
15217
  "required": false,
@@ -15744,18 +15224,18 @@
15744
15224
  "type": "null"
15745
15225
  }
15746
15226
  ],
15747
- "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.",
15227
+ "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.",
15748
15228
  "title": "Repo"
15749
15229
  }
15750
15230
  },
15751
15231
  {
15752
- "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.",
15232
+ "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.",
15753
15233
  "in": "query",
15754
15234
  "name": "unfinished",
15755
15235
  "required": false,
15756
15236
  "schema": {
15757
15237
  "default": false,
15758
- "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.",
15238
+ "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.",
15759
15239
  "title": "Unfinished",
15760
15240
  "type": "boolean"
15761
15241
  }
@@ -15935,273 +15415,6 @@
15935
15415
  "x-ellipsis-sdk-method": "sessions.start"
15936
15416
  }
15937
15417
  },
15938
- "/v1/sessions/search": {
15939
- "get": {
15940
- "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).",
15941
- "operationId": "search_sessions",
15942
- "parameters": [
15943
- {
15944
- "in": "query",
15945
- "name": "q",
15946
- "required": true,
15947
- "schema": {
15948
- "title": "Q",
15949
- "type": "string"
15950
- }
15951
- },
15952
- {
15953
- "in": "query",
15954
- "name": "scope",
15955
- "required": false,
15956
- "schema": {
15957
- "$ref": "#/components/schemas/SessionSearchScope",
15958
- "default": "both"
15959
- }
15960
- },
15961
- {
15962
- "in": "query",
15963
- "name": "source",
15964
- "required": false,
15965
- "schema": {
15966
- "anyOf": [
15967
- {
15968
- "items": {
15969
- "$ref": "#/components/schemas/SessionSource"
15970
- },
15971
- "type": "array"
15972
- },
15973
- {
15974
- "type": "null"
15975
- }
15976
- ],
15977
- "title": "Source"
15978
- }
15979
- },
15980
- {
15981
- "description": "Attributed GitHub user account ids.",
15982
- "in": "query",
15983
- "name": "author_id",
15984
- "required": false,
15985
- "schema": {
15986
- "anyOf": [
15987
- {
15988
- "items": {
15989
- "type": "integer"
15990
- },
15991
- "type": "array"
15992
- },
15993
- {
15994
- "type": "null"
15995
- }
15996
- ],
15997
- "description": "Attributed GitHub user account ids.",
15998
- "title": "Author Id"
15999
- }
16000
- },
16001
- {
16002
- "description": "Saved agent config ids (ORed with author_id).",
16003
- "in": "query",
16004
- "name": "config_id",
16005
- "required": false,
16006
- "schema": {
16007
- "anyOf": [
16008
- {
16009
- "items": {
16010
- "type": "string"
16011
- },
16012
- "type": "array"
16013
- },
16014
- {
16015
- "type": "null"
16016
- }
16017
- ],
16018
- "description": "Saved agent config ids (ORed with author_id).",
16019
- "title": "Config Id"
16020
- }
16021
- },
16022
- {
16023
- "in": "query",
16024
- "name": "session_ids",
16025
- "required": false,
16026
- "schema": {
16027
- "anyOf": [
16028
- {
16029
- "items": {
16030
- "type": "string"
16031
- },
16032
- "type": "array"
16033
- },
16034
- {
16035
- "type": "null"
16036
- }
16037
- ],
16038
- "title": "Session Ids"
16039
- }
16040
- },
16041
- {
16042
- "description": "\"owner/name\" (exact) or a bare repo name.",
16043
- "in": "query",
16044
- "name": "repo",
16045
- "required": false,
16046
- "schema": {
16047
- "anyOf": [
16048
- {
16049
- "type": "string"
16050
- },
16051
- {
16052
- "type": "null"
16053
- }
16054
- ],
16055
- "description": "\"owner/name\" (exact) or a bare repo name.",
16056
- "title": "Repo"
16057
- }
16058
- },
16059
- {
16060
- "in": "query",
16061
- "name": "status",
16062
- "required": false,
16063
- "schema": {
16064
- "anyOf": [
16065
- {
16066
- "items": {
16067
- "$ref": "#/components/schemas/SessionStatus"
16068
- },
16069
- "type": "array"
16070
- },
16071
- {
16072
- "type": "null"
16073
- }
16074
- ],
16075
- "title": "Status"
16076
- }
16077
- },
16078
- {
16079
- "in": "query",
16080
- "name": "start",
16081
- "required": false,
16082
- "schema": {
16083
- "anyOf": [
16084
- {
16085
- "format": "date-time",
16086
- "type": "string"
16087
- },
16088
- {
16089
- "type": "null"
16090
- }
16091
- ],
16092
- "title": "Start"
16093
- }
16094
- },
16095
- {
16096
- "in": "query",
16097
- "name": "end",
16098
- "required": false,
16099
- "schema": {
16100
- "anyOf": [
16101
- {
16102
- "format": "date-time",
16103
- "type": "string"
16104
- },
16105
- {
16106
- "type": "null"
16107
- }
16108
- ],
16109
- "title": "End"
16110
- }
16111
- },
16112
- {
16113
- "in": "query",
16114
- "name": "limit",
16115
- "required": false,
16116
- "schema": {
16117
- "default": 20,
16118
- "maximum": 100,
16119
- "minimum": 1,
16120
- "title": "Limit",
16121
- "type": "integer"
16122
- }
16123
- },
16124
- {
16125
- "in": "header",
16126
- "name": "user-agent",
16127
- "required": false,
16128
- "schema": {
16129
- "anyOf": [
16130
- {
16131
- "type": "string"
16132
- },
16133
- {
16134
- "type": "null"
16135
- }
16136
- ],
16137
- "title": "User-Agent"
16138
- }
16139
- }
16140
- ],
16141
- "responses": {
16142
- "200": {
16143
- "content": {
16144
- "application/json": {
16145
- "schema": {
16146
- "$ref": "#/components/schemas/SessionSearchResponse"
16147
- }
16148
- }
16149
- },
16150
- "description": "Successful Response"
16151
- },
16152
- "400": {
16153
- "content": {
16154
- "application/json": {
16155
- "schema": {
16156
- "$ref": "#/components/schemas/ErrorResponse"
16157
- }
16158
- }
16159
- },
16160
- "description": "The search query is too short."
16161
- },
16162
- "401": {
16163
- "content": {
16164
- "application/json": {
16165
- "schema": {
16166
- "$ref": "#/components/schemas/ErrorResponse"
16167
- }
16168
- }
16169
- },
16170
- "description": "The bearer token is missing, invalid, or revoked."
16171
- },
16172
- "403": {
16173
- "content": {
16174
- "application/json": {
16175
- "schema": {
16176
- "$ref": "#/components/schemas/ErrorResponse"
16177
- }
16178
- }
16179
- },
16180
- "description": "The credential may not perform this action, or the account is blocked."
16181
- },
16182
- "422": {
16183
- "content": {
16184
- "application/json": {
16185
- "schema": {
16186
- "$ref": "#/components/schemas/HTTPValidationError"
16187
- }
16188
- }
16189
- },
16190
- "description": "Validation Error"
16191
- }
16192
- },
16193
- "security": [
16194
- {
16195
- "HTTPBearer": []
16196
- }
16197
- ],
16198
- "summary": "Search Agent Sessions",
16199
- "tags": [
16200
- "v1"
16201
- ],
16202
- "x-ellipsis-sdk-method": "sessions.search"
16203
- }
16204
- },
16205
15418
  "/v1/sessions/{session_id}": {
16206
15419
  "get": {
16207
15420
  "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.",
@@ -16297,101 +15510,6 @@
16297
15510
  "x-ellipsis-sdk-method": "sessions.get"
16298
15511
  }
16299
15512
  },
16300
- "/v1/sessions/{session_id}/executions": {
16301
- "get": {
16302
- "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).",
16303
- "operationId": "get_agent_session_executions",
16304
- "parameters": [
16305
- {
16306
- "in": "path",
16307
- "name": "session_id",
16308
- "required": true,
16309
- "schema": {
16310
- "title": "Session Id",
16311
- "type": "string"
16312
- }
16313
- },
16314
- {
16315
- "in": "header",
16316
- "name": "user-agent",
16317
- "required": false,
16318
- "schema": {
16319
- "anyOf": [
16320
- {
16321
- "type": "string"
16322
- },
16323
- {
16324
- "type": "null"
16325
- }
16326
- ],
16327
- "title": "User-Agent"
16328
- }
16329
- }
16330
- ],
16331
- "responses": {
16332
- "200": {
16333
- "content": {
16334
- "application/json": {
16335
- "schema": {
16336
- "$ref": "#/components/schemas/SessionExecutionsListResponse"
16337
- }
16338
- }
16339
- },
16340
- "description": "Successful Response"
16341
- },
16342
- "401": {
16343
- "content": {
16344
- "application/json": {
16345
- "schema": {
16346
- "$ref": "#/components/schemas/ErrorResponse"
16347
- }
16348
- }
16349
- },
16350
- "description": "The bearer token is missing, invalid, or revoked."
16351
- },
16352
- "403": {
16353
- "content": {
16354
- "application/json": {
16355
- "schema": {
16356
- "$ref": "#/components/schemas/ErrorResponse"
16357
- }
16358
- }
16359
- },
16360
- "description": "The credential may not perform this action, or the account is blocked."
16361
- },
16362
- "404": {
16363
- "content": {
16364
- "application/json": {
16365
- "schema": {
16366
- "$ref": "#/components/schemas/ErrorResponse"
16367
- }
16368
- }
16369
- },
16370
- "description": "No such session in your account."
16371
- },
16372
- "422": {
16373
- "content": {
16374
- "application/json": {
16375
- "schema": {
16376
- "$ref": "#/components/schemas/HTTPValidationError"
16377
- }
16378
- }
16379
- },
16380
- "description": "Validation Error"
16381
- }
16382
- },
16383
- "security": [
16384
- {
16385
- "HTTPBearer": []
16386
- }
16387
- ],
16388
- "summary": "Get Agent Session Executions",
16389
- "tags": [
16390
- "v1"
16391
- ],
16392
- "x-ellipsis-sdk-method": "sessions.executions"
16393
- }
16394
- },
16395
15513
  "/v1/sessions/{session_id}/export": {
16396
15514
  "get": {
16397
15515
  "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 +15827,7 @@
16709
15827
  },
16710
15828
  "/v1/sessions/{session_id}/records": {
16711
15829
  "get": {
16712
- "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.",
15830
+ "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.",
16713
15831
  "operationId": "get_agent_session_records",
16714
15832
  "parameters": [
16715
15833
  {