@ellipsis-dev/sdk 0.1.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.
Files changed (12) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +40 -0
  3. package/dist/index.d.ts +22 -0
  4. package/dist/index.js +53 -0
  5. package/dist/store/index.d.ts +145 -0
  6. package/dist/store/index.js +643 -0
  7. package/dist/stream/index.d.ts +64 -0
  8. package/dist/stream/index.js +207 -0
  9. package/dist/types-BRE4NMnS.d.ts +1192 -0
  10. package/package.json +29 -0
  11. package/schema/frames.schema.json +1427 -0
  12. package/schema/openapi.v1.json +1857 -0
package/schema/openapi.v1.json ADDED
@@ -0,0 +1,1857 @@
1
+ {
2
+ "components": {
3
+ "schemas": {
4
+ "AgentSessionExitStatus": {
5
+ "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (AgentSessionStatus) 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.",
6
+ "enum": [
7
+ "completed",
8
+ "budget_hit",
9
+ "payment_required",
10
+ "tool_call_failed",
11
+ "lifecycle_hook_failed",
12
+ "missing_repo_access",
13
+ "missing_token_permissions",
14
+ "cancelled",
15
+ "interrupted",
16
+ "error",
17
+ "stopped"
18
+ ],
19
+ "title": "AgentSessionExitStatus",
20
+ "type": "string"
21
+ },
22
+ "AgentSessionPr": {
23
+ "description": "A pull request this session created, denormalized at capture time so\nsession surfaces render a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored here \u2014 read it from gh_prs where\na view needs it.",
24
+ "properties": {
25
+ "gh_pr_id": {
26
+ "anyOf": [
27
+ {
28
+ "type": "integer"
29
+ },
30
+ {
31
+ "type": "null"
32
+ }
33
+ ],
34
+ "title": "Gh Pr Id"
35
+ },
36
+ "number": {
37
+ "title": "Number",
38
+ "type": "integer"
39
+ },
40
+ "repo_full_name": {
41
+ "title": "Repo Full Name",
42
+ "type": "string"
43
+ },
44
+ "title": {
45
+ "anyOf": [
46
+ {
47
+ "type": "string"
48
+ },
49
+ {
50
+ "type": "null"
51
+ }
52
+ ],
53
+ "title": "Title"
54
+ },
55
+ "url": {
56
+ "title": "Url",
57
+ "type": "string"
58
+ }
59
+ },
60
+ "required": [
61
+ "repo_full_name",
62
+ "number",
63
+ "url"
64
+ ],
65
+ "title": "AgentSessionPr",
66
+ "type": "object"
67
+ },
68
+ "AgentSessionSource": {
69
+ "enum": [
70
+ "react",
71
+ "manual",
72
+ "api",
73
+ "cli",
74
+ "mention",
75
+ "cron",
76
+ "laptop"
77
+ ],
78
+ "title": "AgentSessionSource",
79
+ "type": "string"
80
+ },
81
+ "AgentSessionStatus": {
82
+ "enum": [
83
+ "scheduled",
84
+ "creating_sandbox",
85
+ "running",
86
+ "retrying",
87
+ "completed",
88
+ "error",
89
+ "cancelled",
90
+ "stopped"
91
+ ],
92
+ "title": "AgentSessionStatus",
93
+ "type": "string"
94
+ },
95
+ "AgentSessionWire": {
96
+ "properties": {
97
+ "agent_config_id": {
98
+ "anyOf": [
99
+ {
100
+ "type": "string"
101
+ },
102
+ {
103
+ "type": "null"
104
+ }
105
+ ],
106
+ "title": "Agent Config Id"
107
+ },
108
+ "attributed_user": {
109
+ "anyOf": [
110
+ {
111
+ "$ref": "#/components/schemas/GithubAccountSnippet"
112
+ },
113
+ {
114
+ "type": "null"
115
+ }
116
+ ]
117
+ },
118
+ "attribution_id": {
119
+ "anyOf": [
120
+ {
121
+ "type": "string"
122
+ },
123
+ {
124
+ "type": "null"
125
+ }
126
+ ],
127
+ "title": "Attribution Id"
128
+ },
129
+ "attribution_type": {
130
+ "anyOf": [
131
+ {
132
+ "$ref": "#/components/schemas/AttributionType"
133
+ },
134
+ {
135
+ "type": "null"
136
+ }
137
+ ]
138
+ },
139
+ "client_version": {
140
+ "anyOf": [
141
+ {
142
+ "type": "string"
143
+ },
144
+ {
145
+ "type": "null"
146
+ }
147
+ ],
148
+ "title": "Client Version"
149
+ },
150
+ "config_override": {
151
+ "anyOf": [
152
+ {
153
+ "additionalProperties": true,
154
+ "type": "object"
155
+ },
156
+ {
157
+ "type": "null"
158
+ }
159
+ ],
160
+ "title": "Config Override"
161
+ },
162
+ "context_repository": {
163
+ "anyOf": [
164
+ {
165
+ "type": "string"
166
+ },
167
+ {
168
+ "type": "null"
169
+ }
170
+ ],
171
+ "title": "Context Repository"
172
+ },
173
+ "cost_fee": {
174
+ "default": 0,
175
+ "title": "Cost Fee",
176
+ "type": "integer"
177
+ },
178
+ "cost_sandbox_cpu": {
179
+ "default": 0,
180
+ "title": "Cost Sandbox Cpu",
181
+ "type": "integer"
182
+ },
183
+ "cost_sandbox_memory": {
184
+ "default": 0,
185
+ "title": "Cost Sandbox Memory",
186
+ "type": "integer"
187
+ },
188
+ "cost_tokens": {
189
+ "title": "Cost Tokens",
190
+ "type": "integer"
191
+ },
192
+ "created_at": {
193
+ "format": "date-time",
194
+ "title": "Created At",
195
+ "type": "string"
196
+ },
197
+ "customer_id": {
198
+ "title": "Customer Id",
199
+ "type": "string"
200
+ },
201
+ "default_resolution": {
202
+ "anyOf": [
203
+ {
204
+ "$ref": "#/components/schemas/DefaultResolution"
205
+ },
206
+ {
207
+ "type": "null"
208
+ }
209
+ ]
210
+ },
211
+ "exit_status": {
212
+ "anyOf": [
213
+ {
214
+ "$ref": "#/components/schemas/AgentSessionExitStatus"
215
+ },
216
+ {
217
+ "type": "null"
218
+ }
219
+ ]
220
+ },
221
+ "harness": {
222
+ "$ref": "#/components/schemas/Harness"
223
+ },
224
+ "id": {
225
+ "title": "Id",
226
+ "type": "string"
227
+ },
228
+ "last_activity_at": {
229
+ "anyOf": [
230
+ {
231
+ "format": "date-time",
232
+ "type": "string"
233
+ },
234
+ {
235
+ "type": "null"
236
+ }
237
+ ],
238
+ "title": "Last Activity At"
239
+ },
240
+ "last_message_at": {
241
+ "anyOf": [
242
+ {
243
+ "format": "date-time",
244
+ "type": "string"
245
+ },
246
+ {
247
+ "type": "null"
248
+ }
249
+ ],
250
+ "title": "Last Message At"
251
+ },
252
+ "live_summary": {
253
+ "anyOf": [
254
+ {
255
+ "type": "string"
256
+ },
257
+ {
258
+ "type": "null"
259
+ }
260
+ ],
261
+ "title": "Live Summary"
262
+ },
263
+ "metadata": {
264
+ "additionalProperties": {
265
+ "type": "string"
266
+ },
267
+ "default": {},
268
+ "title": "Metadata",
269
+ "type": "object"
270
+ },
271
+ "output_prs": {
272
+ "anyOf": [
273
+ {
274
+ "items": {
275
+ "$ref": "#/components/schemas/AgentSessionPr"
276
+ },
277
+ "type": "array"
278
+ },
279
+ {
280
+ "type": "null"
281
+ }
282
+ ],
283
+ "title": "Output Prs"
284
+ },
285
+ "parent_agent_session_id": {
286
+ "anyOf": [
287
+ {
288
+ "type": "string"
289
+ },
290
+ {
291
+ "type": "null"
292
+ }
293
+ ],
294
+ "title": "Parent Agent Session Id"
295
+ },
296
+ "parent_kind": {
297
+ "anyOf": [
298
+ {
299
+ "$ref": "#/components/schemas/ParentKind"
300
+ },
301
+ {
302
+ "type": "null"
303
+ }
304
+ ]
305
+ },
306
+ "prompt": {
307
+ "anyOf": [
308
+ {
309
+ "type": "string"
310
+ },
311
+ {
312
+ "type": "null"
313
+ }
314
+ ],
315
+ "title": "Prompt"
316
+ },
317
+ "replayed_from_session_id": {
318
+ "anyOf": [
319
+ {
320
+ "type": "string"
321
+ },
322
+ {
323
+ "type": "null"
324
+ }
325
+ ],
326
+ "title": "Replayed From Session Id"
327
+ },
328
+ "resolved_budget_cents": {
329
+ "title": "Resolved Budget Cents",
330
+ "type": "integer"
331
+ },
332
+ "resolved_budget_source": {
333
+ "$ref": "#/components/schemas/BudgetSource"
334
+ },
335
+ "sandbox_id": {
336
+ "anyOf": [
337
+ {
338
+ "type": "string"
339
+ },
340
+ {
341
+ "type": "null"
342
+ }
343
+ ],
344
+ "title": "Sandbox Id"
345
+ },
346
+ "session_key": {
347
+ "anyOf": [
348
+ {
349
+ "type": "string"
350
+ },
351
+ {
352
+ "type": "null"
353
+ }
354
+ ],
355
+ "title": "Session Key"
356
+ },
357
+ "session_state": {
358
+ "anyOf": [
359
+ {
360
+ "$ref": "#/components/schemas/SessionState"
361
+ },
362
+ {
363
+ "type": "null"
364
+ }
365
+ ]
366
+ },
367
+ "source": {
368
+ "$ref": "#/components/schemas/AgentSessionSource"
369
+ },
370
+ "status": {
371
+ "$ref": "#/components/schemas/AgentSessionStatus"
372
+ },
373
+ "status_reason": {
374
+ "anyOf": [
375
+ {
376
+ "type": "string"
377
+ },
378
+ {
379
+ "type": "null"
380
+ }
381
+ ],
382
+ "title": "Status Reason"
383
+ },
384
+ "stopped_at": {
385
+ "anyOf": [
386
+ {
387
+ "format": "date-time",
388
+ "type": "string"
389
+ },
390
+ {
391
+ "type": "null"
392
+ }
393
+ ],
394
+ "title": "Stopped At"
395
+ },
396
+ "stopped_by": {
397
+ "anyOf": [
398
+ {
399
+ "type": "integer"
400
+ },
401
+ {
402
+ "type": "null"
403
+ }
404
+ ],
405
+ "title": "Stopped By"
406
+ },
407
+ "stopped_by_user": {
408
+ "anyOf": [
409
+ {
410
+ "$ref": "#/components/schemas/GithubAccountSnippet"
411
+ },
412
+ {
413
+ "type": "null"
414
+ }
415
+ ]
416
+ },
417
+ "surface": {
418
+ "anyOf": [
419
+ {
420
+ "$ref": "#/components/schemas/SessionSurface"
421
+ },
422
+ {
423
+ "type": "null"
424
+ }
425
+ ]
426
+ },
427
+ "tokens_cache_creation": {
428
+ "default": 0,
429
+ "title": "Tokens Cache Creation",
430
+ "type": "integer"
431
+ },
432
+ "tokens_cache_read": {
433
+ "default": 0,
434
+ "title": "Tokens Cache Read",
435
+ "type": "integer"
436
+ },
437
+ "tokens_input": {
438
+ "default": 0,
439
+ "title": "Tokens Input",
440
+ "type": "integer"
441
+ },
442
+ "tokens_model": {
443
+ "title": "Tokens Model",
444
+ "type": "string"
445
+ },
446
+ "tokens_output": {
447
+ "default": 0,
448
+ "title": "Tokens Output",
449
+ "type": "integer"
450
+ },
451
+ "tokens_total": {
452
+ "default": 0,
453
+ "title": "Tokens Total",
454
+ "type": "integer"
455
+ },
456
+ "updated_at": {
457
+ "format": "date-time",
458
+ "title": "Updated At",
459
+ "type": "string"
460
+ },
461
+ "webhook_id": {
462
+ "anyOf": [
463
+ {
464
+ "type": "string"
465
+ },
466
+ {
467
+ "type": "null"
468
+ }
469
+ ],
470
+ "title": "Webhook Id"
471
+ },
472
+ "webhook_type": {
473
+ "anyOf": [
474
+ {
475
+ "$ref": "#/components/schemas/WebhookType"
476
+ },
477
+ {
478
+ "type": "null"
479
+ }
480
+ ]
481
+ }
482
+ },
483
+ "required": [
484
+ "id",
485
+ "customer_id",
486
+ "created_at",
487
+ "updated_at",
488
+ "harness",
489
+ "source",
490
+ "cost_tokens",
491
+ "tokens_model",
492
+ "resolved_budget_cents",
493
+ "resolved_budget_source",
494
+ "status"
495
+ ],
496
+ "title": "AgentSessionWire",
497
+ "type": "object"
498
+ },
499
+ "AgentTurn": {
500
+ "description": "One exchange within a session: a single Claude Code execution driven by the\nsession's inbox. Over subsequent slices this absorbs the per-execution fields\n(status, cost, tokens, exit_status) that currently live on agent_sessions.",
501
+ "properties": {
502
+ "agent_session_id": {
503
+ "title": "Agent Session Id",
504
+ "type": "string"
505
+ },
506
+ "completed_at": {
507
+ "anyOf": [
508
+ {
509
+ "format": "date-time",
510
+ "type": "string"
511
+ },
512
+ {
513
+ "type": "null"
514
+ }
515
+ ],
516
+ "title": "Completed At"
517
+ },
518
+ "cost_fee": {
519
+ "default": 0,
520
+ "title": "Cost Fee",
521
+ "type": "integer"
522
+ },
523
+ "cost_sandbox_cpu": {
524
+ "default": 0,
525
+ "title": "Cost Sandbox Cpu",
526
+ "type": "integer"
527
+ },
528
+ "cost_sandbox_memory": {
529
+ "default": 0,
530
+ "title": "Cost Sandbox Memory",
531
+ "type": "integer"
532
+ },
533
+ "cost_tokens": {
534
+ "default": 0,
535
+ "title": "Cost Tokens",
536
+ "type": "integer"
537
+ },
538
+ "created_at": {
539
+ "format": "date-time",
540
+ "title": "Created At",
541
+ "type": "string"
542
+ },
543
+ "exit_status": {
544
+ "anyOf": [
545
+ {
546
+ "$ref": "#/components/schemas/AgentSessionExitStatus"
547
+ },
548
+ {
549
+ "type": "null"
550
+ }
551
+ ]
552
+ },
553
+ "id": {
554
+ "title": "Id",
555
+ "type": "string"
556
+ },
557
+ "react_action": {
558
+ "anyOf": [
559
+ {
560
+ "type": "string"
561
+ },
562
+ {
563
+ "type": "null"
564
+ }
565
+ ],
566
+ "title": "React Action"
567
+ },
568
+ "sandbox_id": {
569
+ "anyOf": [
570
+ {
571
+ "type": "string"
572
+ },
573
+ {
574
+ "type": "null"
575
+ }
576
+ ],
577
+ "title": "Sandbox Id"
578
+ },
579
+ "session_execution_id": {
580
+ "anyOf": [
581
+ {
582
+ "type": "string"
583
+ },
584
+ {
585
+ "type": "null"
586
+ }
587
+ ],
588
+ "title": "Session Execution Id"
589
+ },
590
+ "started_at": {
591
+ "anyOf": [
592
+ {
593
+ "format": "date-time",
594
+ "type": "string"
595
+ },
596
+ {
597
+ "type": "null"
598
+ }
599
+ ],
600
+ "title": "Started At"
601
+ },
602
+ "status": {
603
+ "$ref": "#/components/schemas/AgentTurnStatus"
604
+ },
605
+ "status_reason": {
606
+ "anyOf": [
607
+ {
608
+ "type": "string"
609
+ },
610
+ {
611
+ "type": "null"
612
+ }
613
+ ],
614
+ "title": "Status Reason"
615
+ },
616
+ "tokens_cache_creation": {
617
+ "default": 0,
618
+ "title": "Tokens Cache Creation",
619
+ "type": "integer"
620
+ },
621
+ "tokens_cache_read": {
622
+ "default": 0,
623
+ "title": "Tokens Cache Read",
624
+ "type": "integer"
625
+ },
626
+ "tokens_input": {
627
+ "default": 0,
628
+ "title": "Tokens Input",
629
+ "type": "integer"
630
+ },
631
+ "tokens_model": {
632
+ "anyOf": [
633
+ {
634
+ "type": "string"
635
+ },
636
+ {
637
+ "type": "null"
638
+ }
639
+ ],
640
+ "title": "Tokens Model"
641
+ },
642
+ "tokens_output": {
643
+ "default": 0,
644
+ "title": "Tokens Output",
645
+ "type": "integer"
646
+ },
647
+ "tokens_total": {
648
+ "default": 0,
649
+ "title": "Tokens Total",
650
+ "type": "integer"
651
+ },
652
+ "turn_index": {
653
+ "title": "Turn Index",
654
+ "type": "integer"
655
+ },
656
+ "updated_at": {
657
+ "format": "date-time",
658
+ "title": "Updated At",
659
+ "type": "string"
660
+ },
661
+ "webhook_id": {
662
+ "anyOf": [
663
+ {
664
+ "type": "string"
665
+ },
666
+ {
667
+ "type": "null"
668
+ }
669
+ ],
670
+ "title": "Webhook Id"
671
+ },
672
+ "webhook_type": {
673
+ "anyOf": [
674
+ {
675
+ "$ref": "#/components/schemas/WebhookType"
676
+ },
677
+ {
678
+ "type": "null"
679
+ }
680
+ ]
681
+ }
682
+ },
683
+ "required": [
684
+ "id",
685
+ "agent_session_id",
686
+ "turn_index",
687
+ "created_at",
688
+ "updated_at",
689
+ "status"
690
+ ],
691
+ "title": "AgentTurn",
692
+ "type": "object"
693
+ },
694
+ "AgentTurnStatus": {
695
+ "enum": [
696
+ "scheduled",
697
+ "running",
698
+ "completed",
699
+ "error",
700
+ "cancelled"
701
+ ],
702
+ "title": "AgentTurnStatus",
703
+ "type": "string"
704
+ },
705
+ "AttributionType": {
706
+ "enum": [
707
+ "github_user",
708
+ "linear_user",
709
+ "slack_user",
710
+ "api_key"
711
+ ],
712
+ "title": "AttributionType",
713
+ "type": "string"
714
+ },
715
+ "BudgetSource": {
716
+ "description": "Which layer actually determined the enforced budget.\n\nNot derivable from the run row alone (the run does not store the config\ncents or the customer default), so we persist it for the UI / audit.",
717
+ "enum": [
718
+ "system",
719
+ "account",
720
+ "config",
721
+ "run"
722
+ ],
723
+ "title": "BudgetSource",
724
+ "type": "string"
725
+ },
726
+ "DefaultResolution": {
727
+ "description": "How a session that arrived with no explicit config source resolved its\nconfig (documents/eng/DEFAULT_CONFIGS.md \u00a74). Persisted on the session so\naudit and clients can say \"ran under X (repo default)\". A session started\nwith an explicit config/config_id/template_id never enters resolution and\nstores None.",
728
+ "enum": [
729
+ "repo_default",
730
+ "account_default",
731
+ "none"
732
+ ],
733
+ "title": "DefaultResolution",
734
+ "type": "string"
735
+ },
736
+ "GithubAccountSnippet": {
737
+ "description": "Sometimes the GitHub API returns a user of github (can include bots)\nusing this snippet instead of the full GithubAccount model. One example,\nis when the API returns a pull request.\n\nThis is the least amount of info we need to represent a GitHub account.",
738
+ "properties": {
739
+ "avatar_url": {
740
+ "title": "Avatar Url",
741
+ "type": "string"
742
+ },
743
+ "id": {
744
+ "title": "Id",
745
+ "type": "integer"
746
+ },
747
+ "login": {
748
+ "title": "Login",
749
+ "type": "string"
750
+ },
751
+ "type": {
752
+ "$ref": "#/components/schemas/GithubAccountType"
753
+ }
754
+ },
755
+ "required": [
756
+ "id",
757
+ "login",
758
+ "type",
759
+ "avatar_url"
760
+ ],
761
+ "title": "GithubAccountSnippet",
762
+ "type": "object"
763
+ },
764
+ "GithubAccountType": {
765
+ "enum": [
766
+ "User",
767
+ "Organization",
768
+ "Bot",
769
+ "Mannequin"
770
+ ],
771
+ "title": "GithubAccountType",
772
+ "type": "string"
773
+ },
774
+ "HTTPValidationError": {
775
+ "properties": {
776
+ "detail": {
777
+ "items": {
778
+ "$ref": "#/components/schemas/ValidationError"
779
+ },
780
+ "title": "Detail",
781
+ "type": "array"
782
+ }
783
+ },
784
+ "title": "HTTPValidationError",
785
+ "type": "object"
786
+ },
787
+ "Harness": {
788
+ "enum": [
789
+ "claude_code"
790
+ ],
791
+ "title": "Harness",
792
+ "type": "string"
793
+ },
794
+ "ListSessionRecordsResponse": {
795
+ "properties": {
796
+ "earliest_feed_seq": {
797
+ "anyOf": [
798
+ {
799
+ "type": "integer"
800
+ },
801
+ {
802
+ "type": "null"
803
+ }
804
+ ],
805
+ "title": "Earliest Feed Seq"
806
+ },
807
+ "has_more": {
808
+ "default": false,
809
+ "title": "Has More",
810
+ "type": "boolean"
811
+ },
812
+ "messages": {
813
+ "default": [],
814
+ "items": {
815
+ "$ref": "#/components/schemas/SessionMessageWire"
816
+ },
817
+ "title": "Messages",
818
+ "type": "array"
819
+ },
820
+ "records": {
821
+ "items": {
822
+ "$ref": "#/components/schemas/SessionRecordWire"
823
+ },
824
+ "title": "Records",
825
+ "type": "array"
826
+ }
827
+ },
828
+ "required": [
829
+ "records"
830
+ ],
831
+ "title": "ListSessionRecordsResponse",
832
+ "type": "object"
833
+ },
834
+ "ListSessionTurnsResponse": {
835
+ "properties": {
836
+ "messages": {
837
+ "items": {
838
+ "$ref": "#/components/schemas/SessionMessage"
839
+ },
840
+ "title": "Messages",
841
+ "type": "array"
842
+ },
843
+ "turns": {
844
+ "items": {
845
+ "$ref": "#/components/schemas/AgentTurn"
846
+ },
847
+ "title": "Turns",
848
+ "type": "array"
849
+ }
850
+ },
851
+ "required": [
852
+ "turns",
853
+ "messages"
854
+ ],
855
+ "title": "ListSessionTurnsResponse",
856
+ "type": "object"
857
+ },
858
+ "ModelTokensInfo": {
859
+ "properties": {
860
+ "cache_creation_input_tokens": {
861
+ "default": 0,
862
+ "title": "Cache Creation Input Tokens",
863
+ "type": "integer"
864
+ },
865
+ "cache_read_input_tokens": {
866
+ "default": 0,
867
+ "title": "Cache Read Input Tokens",
868
+ "type": "integer"
869
+ },
870
+ "cost_usd": {
871
+ "default": 0,
872
+ "title": "Cost Usd",
873
+ "type": "number"
874
+ },
875
+ "input_tokens": {
876
+ "default": 0,
877
+ "title": "Input Tokens",
878
+ "type": "integer"
879
+ },
880
+ "output_tokens": {
881
+ "default": 0,
882
+ "title": "Output Tokens",
883
+ "type": "integer"
884
+ }
885
+ },
886
+ "title": "ModelTokensInfo",
887
+ "type": "object"
888
+ },
889
+ "ParentKind": {
890
+ "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nHANDOFF \u2014 a session started to take over work from another surface (e.g.\nlaptop \u2192 cloud handoff; later phase).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
891
+ "enum": [
892
+ "continuation",
893
+ "handoff",
894
+ "resume"
895
+ ],
896
+ "title": "ParentKind",
897
+ "type": "string"
898
+ },
899
+ "RecordSource": {
900
+ "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.",
901
+ "enum": [
902
+ "lifecycle",
903
+ "claude_code"
904
+ ],
905
+ "title": "RecordSource",
906
+ "type": "string"
907
+ },
908
+ "RunStatus": {
909
+ "description": "What the current (or most recent) execution is doing (backs `run`).",
910
+ "enum": [
911
+ "scheduled",
912
+ "starting",
913
+ "working",
914
+ "waiting",
915
+ "done",
916
+ "failed",
917
+ "stopped",
918
+ "cancelled",
919
+ "retrying"
920
+ ],
921
+ "title": "RunStatus",
922
+ "type": "string"
923
+ },
924
+ "SendSessionMessageRequest": {
925
+ "description": "A human message posted into a durable (keyed) session's conversation\n(documents/eng/SESSION_IDE.md). Delivered to the live Claude Code process\nat the next turn boundary, or wakes the session when idle. This is what\nthe `agent` CLI's connect composer calls \u2014 including from inside the\nsession's own sandbox, where the sandbox token inherits the session's\nattribution.",
926
+ "properties": {
927
+ "idempotency_key": {
928
+ "anyOf": [
929
+ {
930
+ "maxLength": 128,
931
+ "type": "string"
932
+ },
933
+ {
934
+ "type": "null"
935
+ }
936
+ ],
937
+ "title": "Idempotency Key"
938
+ },
939
+ "message": {
940
+ "title": "Message",
941
+ "type": "string"
942
+ }
943
+ },
944
+ "required": [
945
+ "message"
946
+ ],
947
+ "title": "SendSessionMessageRequest",
948
+ "type": "object"
949
+ },
950
+ "SessionLiveness": {
951
+ "description": "The durable conversation axis (backs the surfaced `session` field).",
952
+ "enum": [
953
+ "alive",
954
+ "sleeping",
955
+ "closed"
956
+ ],
957
+ "title": "SessionLiveness",
958
+ "type": "string"
959
+ },
960
+ "SessionMessage": {
961
+ "description": "One entry in a session's inbox: an event, rendered into a user message,\nwaiting to be consumed by a turn. body is the RENDERED text (pointers to\ncode/events, never embedded diffs), so a turn's initial query is built from\nthe pending messages without re-fetching the trigger.",
962
+ "properties": {
963
+ "agent_session_id": {
964
+ "title": "Agent Session Id",
965
+ "type": "string"
966
+ },
967
+ "author": {
968
+ "anyOf": [
969
+ {
970
+ "type": "string"
971
+ },
972
+ {
973
+ "type": "null"
974
+ }
975
+ ],
976
+ "title": "Author"
977
+ },
978
+ "body": {
979
+ "title": "Body",
980
+ "type": "string"
981
+ },
982
+ "closes_session": {
983
+ "default": false,
984
+ "title": "Closes Session",
985
+ "type": "boolean"
986
+ },
987
+ "created_at": {
988
+ "format": "date-time",
989
+ "title": "Created At",
990
+ "type": "string"
991
+ },
992
+ "delivered_at": {
993
+ "anyOf": [
994
+ {
995
+ "format": "date-time",
996
+ "type": "string"
997
+ },
998
+ {
999
+ "type": "null"
1000
+ }
1001
+ ],
1002
+ "title": "Delivered At"
1003
+ },
1004
+ "delivered_turn_id": {
1005
+ "anyOf": [
1006
+ {
1007
+ "type": "string"
1008
+ },
1009
+ {
1010
+ "type": "null"
1011
+ }
1012
+ ],
1013
+ "title": "Delivered Turn Id"
1014
+ },
1015
+ "feed_seq": {
1016
+ "anyOf": [
1017
+ {
1018
+ "type": "integer"
1019
+ },
1020
+ {
1021
+ "type": "null"
1022
+ }
1023
+ ],
1024
+ "title": "Feed Seq"
1025
+ },
1026
+ "id": {
1027
+ "title": "Id",
1028
+ "type": "string"
1029
+ },
1030
+ "idempotency_key": {
1031
+ "anyOf": [
1032
+ {
1033
+ "type": "string"
1034
+ },
1035
+ {
1036
+ "type": "null"
1037
+ }
1038
+ ],
1039
+ "title": "Idempotency Key"
1040
+ },
1041
+ "platform_ts": {
1042
+ "anyOf": [
1043
+ {
1044
+ "type": "string"
1045
+ },
1046
+ {
1047
+ "type": "null"
1048
+ }
1049
+ ],
1050
+ "title": "Platform Ts"
1051
+ },
1052
+ "sender_attribution_id": {
1053
+ "anyOf": [
1054
+ {
1055
+ "type": "string"
1056
+ },
1057
+ {
1058
+ "type": "null"
1059
+ }
1060
+ ],
1061
+ "title": "Sender Attribution Id"
1062
+ },
1063
+ "sender_attribution_type": {
1064
+ "anyOf": [
1065
+ {
1066
+ "$ref": "#/components/schemas/AttributionType"
1067
+ },
1068
+ {
1069
+ "type": "null"
1070
+ }
1071
+ ]
1072
+ },
1073
+ "status": {
1074
+ "$ref": "#/components/schemas/SessionMessageStatus"
1075
+ },
1076
+ "webhook_id": {
1077
+ "anyOf": [
1078
+ {
1079
+ "type": "string"
1080
+ },
1081
+ {
1082
+ "type": "null"
1083
+ }
1084
+ ],
1085
+ "title": "Webhook Id"
1086
+ },
1087
+ "webhook_type": {
1088
+ "anyOf": [
1089
+ {
1090
+ "$ref": "#/components/schemas/WebhookType"
1091
+ },
1092
+ {
1093
+ "type": "null"
1094
+ }
1095
+ ]
1096
+ }
1097
+ },
1098
+ "required": [
1099
+ "id",
1100
+ "agent_session_id",
1101
+ "body",
1102
+ "status",
1103
+ "created_at"
1104
+ ],
1105
+ "title": "SessionMessage",
1106
+ "type": "object"
1107
+ },
1108
+ "SessionMessageStatus": {
1109
+ "enum": [
1110
+ "pending",
1111
+ "delivered"
1112
+ ],
1113
+ "title": "SessionMessageStatus",
1114
+ "type": "string"
1115
+ },
1116
+ "SessionMessageWire": {
1117
+ "description": "The wire shape of one inbox message (\u00a73.3): what a queued chip renders\nand retires on. `author` is the message's attribution string; the webhook\nprovenance internals stay off the wire.",
1118
+ "properties": {
1119
+ "agent_session_id": {
1120
+ "title": "Agent Session Id",
1121
+ "type": "string"
1122
+ },
1123
+ "author": {
1124
+ "anyOf": [
1125
+ {
1126
+ "type": "string"
1127
+ },
1128
+ {
1129
+ "type": "null"
1130
+ }
1131
+ ],
1132
+ "title": "Author"
1133
+ },
1134
+ "body": {
1135
+ "title": "Body",
1136
+ "type": "string"
1137
+ },
1138
+ "created_at": {
1139
+ "format": "date-time",
1140
+ "title": "Created At",
1141
+ "type": "string"
1142
+ },
1143
+ "delivered_at": {
1144
+ "anyOf": [
1145
+ {
1146
+ "format": "date-time",
1147
+ "type": "string"
1148
+ },
1149
+ {
1150
+ "type": "null"
1151
+ }
1152
+ ],
1153
+ "title": "Delivered At"
1154
+ },
1155
+ "delivered_turn_id": {
1156
+ "anyOf": [
1157
+ {
1158
+ "type": "string"
1159
+ },
1160
+ {
1161
+ "type": "null"
1162
+ }
1163
+ ],
1164
+ "title": "Delivered Turn Id"
1165
+ },
1166
+ "feed_seq": {
1167
+ "anyOf": [
1168
+ {
1169
+ "type": "integer"
1170
+ },
1171
+ {
1172
+ "type": "null"
1173
+ }
1174
+ ],
1175
+ "title": "Feed Seq"
1176
+ },
1177
+ "id": {
1178
+ "title": "Id",
1179
+ "type": "string"
1180
+ },
1181
+ "sender_attribution_id": {
1182
+ "anyOf": [
1183
+ {
1184
+ "type": "string"
1185
+ },
1186
+ {
1187
+ "type": "null"
1188
+ }
1189
+ ],
1190
+ "title": "Sender Attribution Id"
1191
+ },
1192
+ "sender_attribution_type": {
1193
+ "anyOf": [
1194
+ {
1195
+ "$ref": "#/components/schemas/AttributionType"
1196
+ },
1197
+ {
1198
+ "type": "null"
1199
+ }
1200
+ ]
1201
+ },
1202
+ "status": {
1203
+ "$ref": "#/components/schemas/SessionMessageStatus"
1204
+ }
1205
+ },
1206
+ "required": [
1207
+ "id",
1208
+ "agent_session_id",
1209
+ "status",
1210
+ "body",
1211
+ "created_at"
1212
+ ],
1213
+ "title": "SessionMessageWire",
1214
+ "type": "object"
1215
+ },
1216
+ "SessionRecordWire": {
1217
+ "description": "The wire shape of one session record (\u00a73.3): the \u00a73.6 stable envelope +\nthe native `payload`, by explicit allowlist. Internal-only columns\n(`search_text`, `clis`, ingest bookkeeping, attribution denormalizations)\nare deliberately absent so internal model evolution stays free.",
1218
+ "properties": {
1219
+ "agent_session_id": {
1220
+ "title": "Agent Session Id",
1221
+ "type": "string"
1222
+ },
1223
+ "agent_turn_id": {
1224
+ "anyOf": [
1225
+ {
1226
+ "type": "string"
1227
+ },
1228
+ {
1229
+ "type": "null"
1230
+ }
1231
+ ],
1232
+ "title": "Agent Turn Id"
1233
+ },
1234
+ "cost": {
1235
+ "anyOf": [
1236
+ {
1237
+ "type": "integer"
1238
+ },
1239
+ {
1240
+ "type": "null"
1241
+ }
1242
+ ],
1243
+ "title": "Cost"
1244
+ },
1245
+ "created_at": {
1246
+ "format": "date-time",
1247
+ "title": "Created At",
1248
+ "type": "string"
1249
+ },
1250
+ "duration": {
1251
+ "anyOf": [
1252
+ {
1253
+ "type": "integer"
1254
+ },
1255
+ {
1256
+ "type": "null"
1257
+ }
1258
+ ],
1259
+ "title": "Duration"
1260
+ },
1261
+ "feed_seq": {
1262
+ "title": "Feed Seq",
1263
+ "type": "integer"
1264
+ },
1265
+ "id": {
1266
+ "title": "Id",
1267
+ "type": "string"
1268
+ },
1269
+ "model": {
1270
+ "anyOf": [
1271
+ {
1272
+ "type": "string"
1273
+ },
1274
+ {
1275
+ "type": "null"
1276
+ }
1277
+ ],
1278
+ "title": "Model"
1279
+ },
1280
+ "payload": {
1281
+ "additionalProperties": true,
1282
+ "title": "Payload",
1283
+ "type": "object"
1284
+ },
1285
+ "record_format": {
1286
+ "title": "Record Format",
1287
+ "type": "string"
1288
+ },
1289
+ "record_type": {
1290
+ "title": "Record Type",
1291
+ "type": "string"
1292
+ },
1293
+ "session_message_id": {
1294
+ "anyOf": [
1295
+ {
1296
+ "type": "string"
1297
+ },
1298
+ {
1299
+ "type": "null"
1300
+ }
1301
+ ],
1302
+ "title": "Session Message Id"
1303
+ },
1304
+ "source": {
1305
+ "$ref": "#/components/schemas/RecordSource"
1306
+ },
1307
+ "stream_seq": {
1308
+ "title": "Stream Seq",
1309
+ "type": "integer"
1310
+ },
1311
+ "tokens_info": {
1312
+ "anyOf": [
1313
+ {
1314
+ "$ref": "#/components/schemas/TokensInfo"
1315
+ },
1316
+ {
1317
+ "type": "null"
1318
+ }
1319
+ ]
1320
+ },
1321
+ "tools": {
1322
+ "anyOf": [
1323
+ {
1324
+ "items": {
1325
+ "type": "string"
1326
+ },
1327
+ "type": "array"
1328
+ },
1329
+ {
1330
+ "type": "null"
1331
+ }
1332
+ ],
1333
+ "title": "Tools"
1334
+ }
1335
+ },
1336
+ "required": [
1337
+ "id",
1338
+ "agent_session_id",
1339
+ "feed_seq",
1340
+ "stream_seq",
1341
+ "source",
1342
+ "record_type",
1343
+ "record_format",
1344
+ "payload",
1345
+ "created_at"
1346
+ ],
1347
+ "title": "SessionRecordWire",
1348
+ "type": "object"
1349
+ },
1350
+ "SessionState": {
1351
+ "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from AgentSessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
1352
+ "enum": [
1353
+ "idle",
1354
+ "running",
1355
+ "closed"
1356
+ ],
1357
+ "title": "SessionState",
1358
+ "type": "string"
1359
+ },
1360
+ "SessionSurface": {
1361
+ "description": "The three fields we expose. All `None` for an un-keyed (laptop) session.\n\n`use_enum_values=True` (from CustomBaseModel) stores the members as their\nstring values, so this serializes to `{\"session\": \"alive\", \"run\": \"waiting\",\n\"status\": \"waiting\"}` \u2014 a plain object, not enum names.",
1362
+ "properties": {
1363
+ "run": {
1364
+ "anyOf": [
1365
+ {
1366
+ "$ref": "#/components/schemas/RunStatus"
1367
+ },
1368
+ {
1369
+ "type": "null"
1370
+ }
1371
+ ]
1372
+ },
1373
+ "session": {
1374
+ "anyOf": [
1375
+ {
1376
+ "$ref": "#/components/schemas/SessionLiveness"
1377
+ },
1378
+ {
1379
+ "type": "null"
1380
+ }
1381
+ ]
1382
+ },
1383
+ "status": {
1384
+ "anyOf": [
1385
+ {
1386
+ "type": "string"
1387
+ },
1388
+ {
1389
+ "type": "null"
1390
+ }
1391
+ ],
1392
+ "title": "Status"
1393
+ }
1394
+ },
1395
+ "required": [
1396
+ "session",
1397
+ "run",
1398
+ "status"
1399
+ ],
1400
+ "title": "SessionSurface",
1401
+ "type": "object"
1402
+ },
1403
+ "TokensInfo": {
1404
+ "properties": {
1405
+ "cache_creation_input_tokens": {
1406
+ "default": 0,
1407
+ "title": "Cache Creation Input Tokens",
1408
+ "type": "integer"
1409
+ },
1410
+ "cache_read_input_tokens": {
1411
+ "default": 0,
1412
+ "title": "Cache Read Input Tokens",
1413
+ "type": "integer"
1414
+ },
1415
+ "cost_usd": {
1416
+ "default": 0,
1417
+ "title": "Cost Usd",
1418
+ "type": "number"
1419
+ },
1420
+ "initial_system_prompt_tokens": {
1421
+ "default": 0,
1422
+ "title": "Initial System Prompt Tokens",
1423
+ "type": "integer"
1424
+ },
1425
+ "input_tokens": {
1426
+ "default": 0,
1427
+ "title": "Input Tokens",
1428
+ "type": "integer"
1429
+ },
1430
+ "num_turns": {
1431
+ "default": 0,
1432
+ "title": "Num Turns",
1433
+ "type": "integer"
1434
+ },
1435
+ "output_tokens": {
1436
+ "default": 0,
1437
+ "title": "Output Tokens",
1438
+ "type": "integer"
1439
+ },
1440
+ "per_model": {
1441
+ "additionalProperties": {
1442
+ "$ref": "#/components/schemas/ModelTokensInfo"
1443
+ },
1444
+ "default": {},
1445
+ "title": "Per Model",
1446
+ "type": "object"
1447
+ },
1448
+ "per_turn": {
1449
+ "default": [],
1450
+ "items": {
1451
+ "$ref": "#/components/schemas/TurnTokensInfo"
1452
+ },
1453
+ "title": "Per Turn",
1454
+ "type": "array"
1455
+ },
1456
+ "thinking_tokens": {
1457
+ "default": 0,
1458
+ "title": "Thinking Tokens",
1459
+ "type": "integer"
1460
+ }
1461
+ },
1462
+ "title": "TokensInfo",
1463
+ "type": "object"
1464
+ },
1465
+ "TurnTokensInfo": {
1466
+ "properties": {
1467
+ "cache_creation_input_tokens": {
1468
+ "default": 0,
1469
+ "title": "Cache Creation Input Tokens",
1470
+ "type": "integer"
1471
+ },
1472
+ "cache_read_input_tokens": {
1473
+ "default": 0,
1474
+ "title": "Cache Read Input Tokens",
1475
+ "type": "integer"
1476
+ },
1477
+ "input_tokens": {
1478
+ "default": 0,
1479
+ "title": "Input Tokens",
1480
+ "type": "integer"
1481
+ },
1482
+ "output_tokens": {
1483
+ "default": 0,
1484
+ "title": "Output Tokens",
1485
+ "type": "integer"
1486
+ }
1487
+ },
1488
+ "title": "TurnTokensInfo",
1489
+ "type": "object"
1490
+ },
1491
+ "ValidationError": {
1492
+ "properties": {
1493
+ "ctx": {
1494
+ "title": "Context",
1495
+ "type": "object"
1496
+ },
1497
+ "input": {
1498
+ "title": "Input"
1499
+ },
1500
+ "loc": {
1501
+ "items": {
1502
+ "anyOf": [
1503
+ {
1504
+ "type": "string"
1505
+ },
1506
+ {
1507
+ "type": "integer"
1508
+ }
1509
+ ]
1510
+ },
1511
+ "title": "Location",
1512
+ "type": "array"
1513
+ },
1514
+ "msg": {
1515
+ "title": "Message",
1516
+ "type": "string"
1517
+ },
1518
+ "type": {
1519
+ "title": "Error Type",
1520
+ "type": "string"
1521
+ }
1522
+ },
1523
+ "required": [
1524
+ "loc",
1525
+ "msg",
1526
+ "type"
1527
+ ],
1528
+ "title": "ValidationError",
1529
+ "type": "object"
1530
+ },
1531
+ "WebhookType": {
1532
+ "enum": [
1533
+ "github.issue",
1534
+ "github.issue_comment",
1535
+ "github.push",
1536
+ "github.pull_request",
1537
+ "github.pull_request_comment",
1538
+ "github.pull_request_review",
1539
+ "github.pull_request_review_comment",
1540
+ "slack.app_mention",
1541
+ "slack.message",
1542
+ "slack.channel_created",
1543
+ "linear.issue",
1544
+ "linear.issue_comment",
1545
+ "sentry.event_alert",
1546
+ "sentry.metric_alert",
1547
+ "user.message"
1548
+ ],
1549
+ "title": "WebhookType",
1550
+ "type": "string"
1551
+ }
1552
+ },
1553
+ "securitySchemes": {
1554
+ "HTTPBearer": {
1555
+ "scheme": "bearer",
1556
+ "type": "http"
1557
+ }
1558
+ }
1559
+ },
1560
+ "info": {
1561
+ "title": "Ellipsis: REST API",
1562
+ "version": "2.0.0"
1563
+ },
1564
+ "openapi": "3.1.0",
1565
+ "paths": {
1566
+ "/v1/sessions/{session_id}": {
1567
+ "get": {
1568
+ "operationId": "get_agent_session_v1_sessions__session_id__get",
1569
+ "parameters": [
1570
+ {
1571
+ "in": "path",
1572
+ "name": "session_id",
1573
+ "required": true,
1574
+ "schema": {
1575
+ "title": "Session Id",
1576
+ "type": "string"
1577
+ }
1578
+ },
1579
+ {
1580
+ "in": "header",
1581
+ "name": "user-agent",
1582
+ "required": false,
1583
+ "schema": {
1584
+ "anyOf": [
1585
+ {
1586
+ "type": "string"
1587
+ },
1588
+ {
1589
+ "type": "null"
1590
+ }
1591
+ ],
1592
+ "title": "User-Agent"
1593
+ }
1594
+ }
1595
+ ],
1596
+ "responses": {
1597
+ "200": {
1598
+ "content": {
1599
+ "application/json": {
1600
+ "schema": {
1601
+ "$ref": "#/components/schemas/AgentSessionWire"
1602
+ }
1603
+ }
1604
+ },
1605
+ "description": "Successful Response"
1606
+ },
1607
+ "422": {
1608
+ "content": {
1609
+ "application/json": {
1610
+ "schema": {
1611
+ "$ref": "#/components/schemas/HTTPValidationError"
1612
+ }
1613
+ }
1614
+ },
1615
+ "description": "Validation Error"
1616
+ }
1617
+ },
1618
+ "security": [
1619
+ {
1620
+ "HTTPBearer": []
1621
+ }
1622
+ ],
1623
+ "summary": "Get Agent Session",
1624
+ "tags": [
1625
+ "v1"
1626
+ ]
1627
+ }
1628
+ },
1629
+ "/v1/sessions/{session_id}/messages": {
1630
+ "post": {
1631
+ "operationId": "send_agent_session_message_v1_sessions__session_id__messages_post",
1632
+ "parameters": [
1633
+ {
1634
+ "in": "path",
1635
+ "name": "session_id",
1636
+ "required": true,
1637
+ "schema": {
1638
+ "title": "Session Id",
1639
+ "type": "string"
1640
+ }
1641
+ },
1642
+ {
1643
+ "in": "header",
1644
+ "name": "user-agent",
1645
+ "required": false,
1646
+ "schema": {
1647
+ "anyOf": [
1648
+ {
1649
+ "type": "string"
1650
+ },
1651
+ {
1652
+ "type": "null"
1653
+ }
1654
+ ],
1655
+ "title": "User-Agent"
1656
+ }
1657
+ }
1658
+ ],
1659
+ "requestBody": {
1660
+ "content": {
1661
+ "application/json": {
1662
+ "schema": {
1663
+ "$ref": "#/components/schemas/SendSessionMessageRequest"
1664
+ }
1665
+ }
1666
+ },
1667
+ "required": true
1668
+ },
1669
+ "responses": {
1670
+ "200": {
1671
+ "content": {
1672
+ "application/json": {
1673
+ "schema": {
1674
+ "$ref": "#/components/schemas/SessionMessageWire"
1675
+ }
1676
+ }
1677
+ },
1678
+ "description": "Successful Response"
1679
+ },
1680
+ "422": {
1681
+ "content": {
1682
+ "application/json": {
1683
+ "schema": {
1684
+ "$ref": "#/components/schemas/HTTPValidationError"
1685
+ }
1686
+ }
1687
+ },
1688
+ "description": "Validation Error"
1689
+ }
1690
+ },
1691
+ "security": [
1692
+ {
1693
+ "HTTPBearer": []
1694
+ }
1695
+ ],
1696
+ "summary": "Send Agent Session Message",
1697
+ "tags": [
1698
+ "v1"
1699
+ ]
1700
+ }
1701
+ },
1702
+ "/v1/sessions/{session_id}/records": {
1703
+ "get": {
1704
+ "operationId": "get_agent_session_records_v1_sessions__session_id__records_get",
1705
+ "parameters": [
1706
+ {
1707
+ "in": "path",
1708
+ "name": "session_id",
1709
+ "required": true,
1710
+ "schema": {
1711
+ "title": "Session Id",
1712
+ "type": "string"
1713
+ }
1714
+ },
1715
+ {
1716
+ "in": "query",
1717
+ "name": "after_seq",
1718
+ "required": false,
1719
+ "schema": {
1720
+ "default": 0,
1721
+ "title": "After Seq",
1722
+ "type": "integer"
1723
+ }
1724
+ },
1725
+ {
1726
+ "in": "query",
1727
+ "name": "limit",
1728
+ "required": false,
1729
+ "schema": {
1730
+ "anyOf": [
1731
+ {
1732
+ "maximum": 1000,
1733
+ "minimum": 1,
1734
+ "type": "integer"
1735
+ },
1736
+ {
1737
+ "type": "null"
1738
+ }
1739
+ ],
1740
+ "title": "Limit"
1741
+ }
1742
+ },
1743
+ {
1744
+ "in": "header",
1745
+ "name": "user-agent",
1746
+ "required": false,
1747
+ "schema": {
1748
+ "anyOf": [
1749
+ {
1750
+ "type": "string"
1751
+ },
1752
+ {
1753
+ "type": "null"
1754
+ }
1755
+ ],
1756
+ "title": "User-Agent"
1757
+ }
1758
+ }
1759
+ ],
1760
+ "responses": {
1761
+ "200": {
1762
+ "content": {
1763
+ "application/json": {
1764
+ "schema": {
1765
+ "$ref": "#/components/schemas/ListSessionRecordsResponse"
1766
+ }
1767
+ }
1768
+ },
1769
+ "description": "Successful Response"
1770
+ },
1771
+ "422": {
1772
+ "content": {
1773
+ "application/json": {
1774
+ "schema": {
1775
+ "$ref": "#/components/schemas/HTTPValidationError"
1776
+ }
1777
+ }
1778
+ },
1779
+ "description": "Validation Error"
1780
+ }
1781
+ },
1782
+ "security": [
1783
+ {
1784
+ "HTTPBearer": []
1785
+ }
1786
+ ],
1787
+ "summary": "Get Agent Session Records",
1788
+ "tags": [
1789
+ "v1"
1790
+ ]
1791
+ }
1792
+ },
1793
+ "/v1/sessions/{session_id}/turns": {
1794
+ "get": {
1795
+ "operationId": "get_agent_session_turns_v1_sessions__session_id__turns_get",
1796
+ "parameters": [
1797
+ {
1798
+ "in": "path",
1799
+ "name": "session_id",
1800
+ "required": true,
1801
+ "schema": {
1802
+ "title": "Session Id",
1803
+ "type": "string"
1804
+ }
1805
+ },
1806
+ {
1807
+ "in": "header",
1808
+ "name": "user-agent",
1809
+ "required": false,
1810
+ "schema": {
1811
+ "anyOf": [
1812
+ {
1813
+ "type": "string"
1814
+ },
1815
+ {
1816
+ "type": "null"
1817
+ }
1818
+ ],
1819
+ "title": "User-Agent"
1820
+ }
1821
+ }
1822
+ ],
1823
+ "responses": {
1824
+ "200": {
1825
+ "content": {
1826
+ "application/json": {
1827
+ "schema": {
1828
+ "$ref": "#/components/schemas/ListSessionTurnsResponse"
1829
+ }
1830
+ }
1831
+ },
1832
+ "description": "Successful Response"
1833
+ },
1834
+ "422": {
1835
+ "content": {
1836
+ "application/json": {
1837
+ "schema": {
1838
+ "$ref": "#/components/schemas/HTTPValidationError"
1839
+ }
1840
+ }
1841
+ },
1842
+ "description": "Validation Error"
1843
+ }
1844
+ },
1845
+ "security": [
1846
+ {
1847
+ "HTTPBearer": []
1848
+ }
1849
+ ],
1850
+ "summary": "Get Agent Session Turns",
1851
+ "tags": [
1852
+ "v1"
1853
+ ]
1854
+ }
1855
+ }
1856
+ }
1857
+ }