@ellipsis-dev/sdk 0.30.0 → 0.31.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.
package/dist/index.js CHANGED
@@ -29,58 +29,67 @@ var Page = class {
29
29
  };
30
30
 
31
31
  // src/core/sessionHandle.ts
32
- var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
33
- "closed",
34
- "idle",
32
+ var FINAL_TURN_STATUSES = /* @__PURE__ */ new Set([
33
+ "completed",
35
34
  "failed",
36
- "cancelled",
37
- "stopped"
35
+ "stopped",
36
+ "cancelled"
38
37
  ]);
39
- var DEFAULT_POLL_INTERVAL_MS = 3e3;
40
- function isSettled(session) {
41
- return session.lifecycle.conversation === "closed" || TERMINAL_STATUSES.has(session.lifecycle.status);
38
+ function isTurnFinal(status) {
39
+ return FINAL_TURN_STATUSES.has(status);
42
40
  }
41
+ var DEFAULT_POLL_INTERVAL_MS = 3e3;
43
42
  var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
44
43
  var SessionHandle = class {
45
44
  constructor(sessions, session) {
46
45
  this.sessions = sessions;
47
46
  this.id = session.id;
48
47
  this.session = session;
48
+ this.turnId = session.turn?.id ?? null;
49
49
  }
50
50
  sessions;
51
51
  id;
52
52
  // The latest session snapshot this handle saw.
53
53
  session;
54
+ // The turn `wait()` waits on: the session's turn after `run()`, then the
55
+ // turn each `send()` creates. Null until the session has a message.
56
+ turnId;
54
57
  async refresh() {
55
58
  this.session = (await this.sessions.get(this.id)).session;
56
59
  return this.session;
57
60
  }
58
- // Poll until the session settles (terminal status, or a parked
59
- // conversation: state idle/closed).
61
+ // Poll until the awaited turn reaches a final status (completed, failed,
62
+ // stopped, cancelled) or the conversation closes, and return that turn.
63
+ // Returns null at once when the session has no turn to wait on.
60
64
  async wait(options = {}) {
61
65
  const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
62
66
  const deadline = options.timeoutMs == null ? null : Date.now() + options.timeoutMs;
63
67
  for (; ; ) {
64
68
  const session = await this.refresh();
65
- if (isSettled(session)) return session;
69
+ const turnId = this.turnId;
70
+ if (turnId == null) return null;
71
+ const turn = session.turn?.id === turnId ? session.turn : (await this.sessions.turns.get(this.id, turnId)).turn;
72
+ if (isTurnFinal(turn.status) || session.conversation.state === "closed")
73
+ return turn;
66
74
  if (deadline != null && Date.now() >= deadline) {
67
75
  throw new Error(
68
- `session ${this.id} not terminal after ${options.timeoutMs}ms`
76
+ `turn ${turnId} of session ${this.id} not final after ${options.timeoutMs}ms`
69
77
  );
70
78
  }
71
79
  await sleep(pollIntervalMs);
72
80
  }
73
81
  }
74
- // Post into the session's inbox (delivered at the next turn boundary;
75
- // wakes a parked session). `images` ride the message as content blocks the
76
- // model sees on that turn — a paste into Claude Code.
82
+ // Post a message into the session. The returned turn is the one that will
83
+ // answer it, and the one `wait()` waits on from now. `images` ride the
84
+ // message as content blocks the model sees on that turn.
77
85
  async send(message, options = {}) {
78
86
  const response = await this.sessions.sendMessage(this.id, {
79
87
  message,
80
88
  images: options.images,
81
89
  idempotency_key: options.idempotencyKey
82
90
  });
83
- return response.message;
91
+ this.turnId = response.turn.id;
92
+ return response;
84
93
  }
85
94
  async stop() {
86
95
  this.session = (await this.sessions.stop(this.id)).session;
@@ -259,7 +268,7 @@ var EllipsisAccountApiKeys = class {
259
268
  * Required permissions: write:tokens.
260
269
  * API key: Requires a CLI user token belonging to an account administrator.
261
270
  * CLI user token: Requires an account administrator.
262
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
271
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
263
272
  * Higher permission levels include lower levels: read < write < delete.
264
273
  */
265
274
  async create(options) {
@@ -273,7 +282,7 @@ var EllipsisAccountApiKeys = class {
273
282
  * Required permissions: read:tokens.
274
283
  * API key: Supported.
275
284
  * CLI user token: Supported.
276
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
285
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
277
286
  * Higher permission levels include lower levels: read < write < delete.
278
287
  */
279
288
  async list() {
@@ -288,7 +297,7 @@ var EllipsisAccountApiKeys = class {
288
297
  * Required permissions: delete:tokens.
289
298
  * API key: Requires a CLI user token belonging to an account administrator.
290
299
  * CLI user token: Requires an account administrator.
291
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
300
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
292
301
  * Higher permission levels include lower levels: read < write < delete.
293
302
  */
294
303
  async revoke(api_key_id) {
@@ -312,7 +321,7 @@ var EllipsisAccountBillingAutoRecharge = class {
312
321
  * Required permissions: read:account.
313
322
  * API key: Supported.
314
323
  * CLI user token: Supported.
315
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
324
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
316
325
  * Higher permission levels include lower levels: read < write < delete.
317
326
  */
318
327
  async get() {
@@ -324,7 +333,7 @@ var EllipsisAccountBillingAutoRecharge = class {
324
333
  *
325
334
  * Set your automatic credit recharge policy.
326
335
  *
327
- * Requires a human account administrator; API keys and sandbox tokens
336
+ * Requires a human account administrator; API keys and session tokens
328
337
  * cannot change this policy. Supply enabled explicitly. Saving amounts
329
338
  * with enabled=false keeps recharge off; enabling requires a saved card.
330
339
  * A recharge buys amount_cents of credit and charges the platform fee
@@ -333,7 +342,7 @@ var EllipsisAccountBillingAutoRecharge = class {
333
342
  * Required permissions: write:account.
334
343
  * API key: Requires a CLI user token belonging to an account administrator.
335
344
  * CLI user token: Requires an account administrator.
336
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
345
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
337
346
  * Higher permission levels include lower levels: read < write < delete.
338
347
  */
339
348
  async set(options) {
@@ -361,7 +370,7 @@ var EllipsisAccountBilling = class {
361
370
  * Required permissions: write:account.
362
371
  * API key: Requires a CLI user token belonging to an account administrator.
363
372
  * CLI user token: Requires an account administrator.
364
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
373
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
365
374
  * Higher permission levels include lower levels: read < write < delete.
366
375
  */
367
376
  async cardSetup() {
@@ -381,7 +390,7 @@ var EllipsisAccountBilling = class {
381
390
  * Required permissions: write:account.
382
391
  * API key: Requires a CLI user token belonging to an account administrator.
383
392
  * CLI user token: Requires an account administrator.
384
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
393
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
385
394
  * Higher permission levels include lower levels: read < write < delete.
386
395
  */
387
396
  async checkout(options) {
@@ -400,7 +409,7 @@ var EllipsisAccountBilling = class {
400
409
  * Required permissions: write:account.
401
410
  * API key: Supported.
402
411
  * CLI user token: Supported.
403
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
412
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
404
413
  * Higher permission levels include lower levels: read < write < delete.
405
414
  */
406
415
  async claimSignupCredit() {
@@ -415,7 +424,7 @@ var EllipsisAccountBilling = class {
415
424
  * Required permissions: read:account.
416
425
  * API key: Supported.
417
426
  * CLI user token: Supported.
418
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
427
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
419
428
  * Higher permission levels include lower levels: read < write < delete.
420
429
  */
421
430
  async feeSchedule() {
@@ -433,7 +442,7 @@ var EllipsisAccountBilling = class {
433
442
  * Required permissions: read:account.
434
443
  * API key: Supported.
435
444
  * CLI user token: Supported.
436
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
445
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
437
446
  * Higher permission levels include lower levels: read < write < delete.
438
447
  */
439
448
  async grants() {
@@ -451,7 +460,7 @@ var EllipsisAccountBilling = class {
451
460
  * Required permissions: read:account.
452
461
  * API key: Supported.
453
462
  * CLI user token: Supported.
454
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
463
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
455
464
  * Higher permission levels include lower levels: read < write < delete.
456
465
  */
457
466
  async purchase(checkout_id) {
@@ -469,7 +478,7 @@ var EllipsisAccountBilling = class {
469
478
  * Required permissions: read:account.
470
479
  * API key: Supported.
471
480
  * CLI user token: Supported.
472
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
481
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
473
482
  * Higher permission levels include lower levels: read < write < delete.
474
483
  */
475
484
  async purchaseOptions() {
@@ -488,7 +497,7 @@ var EllipsisAccountBilling = class {
488
497
  * Required permissions: read:account.
489
498
  * API key: Supported.
490
499
  * CLI user token: Supported.
491
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
500
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
492
501
  * Higher permission levels include lower levels: read < write < delete.
493
502
  */
494
503
  async status() {
@@ -518,7 +527,7 @@ var EllipsisAccountModels = class {
518
527
  * Required permissions: read:templates.
519
528
  * API key: Supported.
520
529
  * CLI user token: Supported.
521
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
530
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
522
531
  * Higher permission levels include lower levels: read < write < delete.
523
532
  */
524
533
  async list() {
@@ -541,7 +550,7 @@ var EllipsisAccountNotifications = class {
541
550
  * Required permissions: write:account.
542
551
  * API key: Supported.
543
552
  * CLI user token: Supported.
544
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
553
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
545
554
  * Higher permission levels include lower levels: read < write < delete.
546
555
  */
547
556
  async testEmail(options) {
@@ -563,7 +572,7 @@ var EllipsisAccountOnboarding = class {
563
572
  * Required permissions: read:account.
564
573
  * API key: Supported.
565
574
  * CLI user token: Supported.
566
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
575
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
567
576
  * Higher permission levels include lower levels: read < write < delete.
568
577
  */
569
578
  async get() {
@@ -579,14 +588,14 @@ var EllipsisAccountOnboarding = class {
579
588
  * Saving use cases requires a valid organization work email and at
580
589
  * least one choice. When Other is the only choice, describe it.
581
590
  * Personal accounts save a null work email. This does not change the
582
- * billing contact email. Sandbox credentials cannot update answers.
591
+ * billing contact email. Session tokens cannot update answers.
583
592
  * Supplying an organization work email requires a human user and sends
584
593
  * a Slack Connect invitation. Slack failures do not undo saved answers.
585
594
  *
586
595
  * Required permissions: write:account.
587
596
  * API key: Supported.
588
597
  * CLI user token: Supported.
589
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
598
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
590
599
  * Higher permission levels include lower levels: read < write < delete.
591
600
  */
592
601
  async update(options = {}) {
@@ -606,7 +615,7 @@ var EllipsisAccountProvidersAnthropic = class {
606
615
  * Required permissions: delete:account.
607
616
  * API key: Supported.
608
617
  * CLI user token: Supported.
609
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
618
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
610
619
  * Higher permission levels include lower levels: read < write < delete.
611
620
  */
612
621
  async delete() {
@@ -619,7 +628,7 @@ var EllipsisAccountProvidersAnthropic = class {
619
628
  * Required permissions: read:account.
620
629
  * API key: Supported.
621
630
  * CLI user token: Supported.
622
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
631
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
623
632
  * Higher permission levels include lower levels: read < write < delete.
624
633
  */
625
634
  async get() {
@@ -632,7 +641,7 @@ var EllipsisAccountProvidersAnthropic = class {
632
641
  * Required permissions: write:account.
633
642
  * API key: Supported.
634
643
  * CLI user token: Supported.
635
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
644
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
636
645
  * Higher permission levels include lower levels: read < write < delete.
637
646
  */
638
647
  async set(options) {
@@ -646,7 +655,7 @@ var EllipsisAccountProvidersAnthropic = class {
646
655
  * Required permissions: write:account.
647
656
  * API key: Supported.
648
657
  * CLI user token: Supported.
649
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
658
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
650
659
  * Higher permission levels include lower levels: read < write < delete.
651
660
  */
652
661
  async validate() {
@@ -654,74 +663,13 @@ var EllipsisAccountProvidersAnthropic = class {
654
663
  return await this.transport.request("POST", path);
655
664
  }
656
665
  };
657
- var EllipsisAccountProvidersBedrock = class {
658
- constructor(transport) {
659
- this.transport = transport;
660
- }
661
- transport;
662
- /**
663
- * Delete Bedrock Config
664
- *
665
- * Required permissions: delete:account.
666
- * API key: Supported.
667
- * CLI user token: Supported.
668
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
669
- * Higher permission levels include lower levels: read < write < delete.
670
- */
671
- async delete() {
672
- const path = "/v1/account/providers/bedrock";
673
- await this.transport.request("DELETE", path);
674
- }
675
- /**
676
- * Get Bedrock Config
677
- *
678
- * Required permissions: read:account.
679
- * API key: Supported.
680
- * CLI user token: Supported.
681
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
682
- * Higher permission levels include lower levels: read < write < delete.
683
- */
684
- async get() {
685
- const path = "/v1/account/providers/bedrock";
686
- return await this.transport.request("GET", path);
687
- }
688
- /**
689
- * Put Bedrock Config
690
- *
691
- * Required permissions: write:account.
692
- * API key: Supported.
693
- * CLI user token: Supported.
694
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
695
- * Higher permission levels include lower levels: read < write < delete.
696
- */
697
- async set(options) {
698
- const path = "/v1/account/providers/bedrock";
699
- const body = buildBody({ model_map: options.model_map, region: options.region, role_arn: options.role_arn });
700
- return await this.transport.request("PUT", path, { body });
701
- }
702
- /**
703
- * Validate Bedrock Config
704
- *
705
- * Required permissions: write:account.
706
- * API key: Supported.
707
- * CLI user token: Supported.
708
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
709
- * Higher permission levels include lower levels: read < write < delete.
710
- */
711
- async validate() {
712
- const path = "/v1/account/providers/bedrock/validate";
713
- return await this.transport.request("POST", path);
714
- }
715
- };
716
666
  var EllipsisAccountProviders = class {
717
667
  constructor(transport) {
718
668
  this.transport = transport;
719
669
  this.anthropic = new EllipsisAccountProvidersAnthropic(transport);
720
- this.bedrock = new EllipsisAccountProvidersBedrock(transport);
721
670
  }
722
671
  transport;
723
672
  anthropic;
724
- bedrock;
725
673
  };
726
674
  var EllipsisAccountSettings = class {
727
675
  constructor(transport) {
@@ -740,7 +688,7 @@ var EllipsisAccountSettings = class {
740
688
  * Required permissions: read:defaults.
741
689
  * API key: Supported.
742
690
  * CLI user token: Supported.
743
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
691
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
744
692
  * Higher permission levels include lower levels: read < write < delete.
745
693
  */
746
694
  async get() {
@@ -757,13 +705,13 @@ var EllipsisAccountSettings = class {
757
705
  * default a session's model resolves against);
758
706
  * `budget_ceiling.session` is in US dollars, at most the platform
759
707
  * ceiling, and null clears it.
760
- * Refused for sandbox tokens (potentially prompt-injected code must
708
+ * Refused for session tokens (potentially prompt-injected code must
761
709
  * not repoint the organization's defaults).
762
710
  *
763
711
  * Required permissions: write:defaults.
764
712
  * API key: Requires a CLI user token belonging to an account administrator.
765
713
  * CLI user token: Requires an account administrator.
766
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
714
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
767
715
  * Higher permission levels include lower levels: read < write < delete.
768
716
  */
769
717
  async set(options) {
@@ -781,7 +729,7 @@ var EllipsisAccountSettings = class {
781
729
  * Required permissions: write:defaults.
782
730
  * API key: Cannot set budget_ceiling, default_model to a non-null value; those changes require a CLI user token belonging to an account administrator.
783
731
  * CLI user token: Requires an account administrator when setting budget_ceiling, default_model to a non-null value.
784
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
732
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
785
733
  * Higher permission levels include lower levels: read < write < delete.
786
734
  */
787
735
  async update(options = {}) {
@@ -819,7 +767,7 @@ var EllipsisAccount = class {
819
767
  * Required permissions: read:account.
820
768
  * API key: Supported.
821
769
  * CLI user token: Supported.
822
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
770
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
823
771
  * Higher permission levels include lower levels: read < write < delete.
824
772
  */
825
773
  async activity() {
@@ -832,7 +780,7 @@ var EllipsisAccount = class {
832
780
  * Required permissions: read:account.
833
781
  * API key: Supported.
834
782
  * CLI user token: Supported.
835
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
783
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
836
784
  * Higher permission levels include lower levels: read < write < delete.
837
785
  */
838
786
  async auditLog() {
@@ -853,7 +801,7 @@ var EllipsisAccount = class {
853
801
  * Required permissions: read:account.
854
802
  * API key: Supported.
855
803
  * CLI user token: Supported.
856
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
804
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
857
805
  * Higher permission levels include lower levels: read < write < delete.
858
806
  */
859
807
  async budget() {
@@ -866,12 +814,12 @@ var EllipsisAccount = class {
866
814
  * Required permissions: write:account.
867
815
  * API key: Supported.
868
816
  * CLI user token: Supported.
869
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
817
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
870
818
  * Higher permission levels include lower levels: read < write < delete.
871
819
  */
872
820
  async update(options = {}) {
873
821
  const path = "/v1/account";
874
- const body = buildBody({ can_start_job_runs: options.can_start_job_runs, contact_email: options.contact_email });
822
+ const body = buildBody({ can_start_sessions: options.can_start_sessions, contact_email: options.contact_email });
875
823
  return await this.transport.request("PATCH", path, { body });
876
824
  }
877
825
  /**
@@ -883,14 +831,14 @@ var EllipsisAccount = class {
883
831
  * preserved. Set policy.developer_defaults to null to disable developer
884
832
  * limits. Null override windows inherit their default. API keys use
885
833
  * their stable ID, not their secret. Changes apply to the next paid
886
- * request, including sessions already running. API keys and sandbox
887
- * credentials cannot edit budgets. The session ceiling remains at
834
+ * request, including sessions already running. API keys and session
835
+ * tokens cannot edit budgets. The session ceiling remains at
888
836
  * /account/settings; purchasing credits is separate from budget policy.
889
837
  *
890
838
  * Required permissions: write:defaults.
891
839
  * API key: Requires a CLI user token belonging to an account administrator.
892
840
  * CLI user token: Requires an account administrator.
893
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
841
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
894
842
  * Higher permission levels include lower levels: read < write < delete.
895
843
  */
896
844
  async updateBudget(options = {}) {
@@ -905,14 +853,14 @@ var EllipsisAccount = class {
905
853
  *
906
854
  * Omit period_start for the current UTC month; select a period returned
907
855
  * in billing_periods to view history. Credit debits are distinct from
908
- * rated token usage through BYOK, customer Bedrock, or a developer's
909
- * Claude subscription. Rated usage estimates are not provider invoices.
856
+ * rated token usage through BYOK or a developer's Claude or Codex
857
+ * subscription. Rated usage estimates are not provider invoices.
910
858
  * Pending and unresolved requests identify missing measurements.
911
859
  *
912
860
  * Required permissions: read:account.
913
861
  * API key: Supported.
914
862
  * CLI user token: Supported.
915
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
863
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
916
864
  * Higher permission levels include lower levels: read < write < delete.
917
865
  */
918
866
  async usage(options = {}) {
@@ -938,7 +886,7 @@ var EllipsisAgents = class {
938
886
  * Required permissions: write:configs.
939
887
  * API key: Supported.
940
888
  * CLI user token: Supported.
941
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
889
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
942
890
  * Higher permission levels include lower levels: read < write < delete.
943
891
  * Grant match patterns can further restrict access to individual resources.
944
892
  */
@@ -959,7 +907,7 @@ var EllipsisAgents = class {
959
907
  * Required permissions: write:configs.
960
908
  * API key: Supported.
961
909
  * CLI user token: Supported.
962
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
910
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
963
911
  * Higher permission levels include lower levels: read < write < delete.
964
912
  * Grant match patterns can further restrict access to individual resources.
965
913
  */
@@ -975,7 +923,7 @@ var EllipsisAgents = class {
975
923
  * Required permissions: read:configs.
976
924
  * API key: Supported.
977
925
  * CLI user token: Supported.
978
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
926
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
979
927
  * Higher permission levels include lower levels: read < write < delete.
980
928
  * Grant match patterns can further restrict access to individual resources.
981
929
  */
@@ -996,7 +944,7 @@ var EllipsisAgents = class {
996
944
  * Required permissions: write:configs.
997
945
  * API key: Supported.
998
946
  * CLI user token: Supported.
999
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
947
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1000
948
  * Higher permission levels include lower levels: read < write < delete.
1001
949
  * Grant match patterns can further restrict access to individual resources.
1002
950
  */
@@ -1013,7 +961,7 @@ var EllipsisAgents = class {
1013
961
  * Required permissions: read:configs.
1014
962
  * API key: Supported.
1015
963
  * CLI user token: Supported.
1016
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
964
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1017
965
  * Higher permission levels include lower levels: read < write < delete.
1018
966
  * Grant match patterns can further restrict access to individual resources.
1019
967
  */
@@ -1035,7 +983,7 @@ var EllipsisAgents = class {
1035
983
  * Required permissions: read:configs.
1036
984
  * API key: Supported.
1037
985
  * CLI user token: Supported.
1038
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
986
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1039
987
  * Higher permission levels include lower levels: read < write < delete.
1040
988
  * Grant match patterns can further restrict access to individual resources.
1041
989
  */
@@ -1061,7 +1009,7 @@ var EllipsisAgents = class {
1061
1009
  * Required permissions: write:sessions.
1062
1010
  * API key: Supported.
1063
1011
  * CLI user token: Supported.
1064
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1012
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1065
1013
  * Higher permission levels include lower levels: read < write < delete.
1066
1014
  * Grant match patterns can further restrict access to individual resources.
1067
1015
  */
@@ -1076,7 +1024,7 @@ var EllipsisAgents = class {
1076
1024
  * Required permissions: read:configs.
1077
1025
  * API key: Supported.
1078
1026
  * CLI user token: Supported.
1079
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1027
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1080
1028
  * Higher permission levels include lower levels: read < write < delete.
1081
1029
  * Grant match patterns can further restrict access to individual resources.
1082
1030
  */
@@ -1096,7 +1044,7 @@ var EllipsisAgents = class {
1096
1044
  * Required permissions: write:configs.
1097
1045
  * API key: Supported.
1098
1046
  * CLI user token: Supported.
1099
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1047
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1100
1048
  * Higher permission levels include lower levels: read < write < delete.
1101
1049
  * Grant match patterns can further restrict access to individual resources.
1102
1050
  */
@@ -1117,7 +1065,7 @@ var EllipsisAgents = class {
1117
1065
  * Required permissions: write:configs.
1118
1066
  * API key: Supported.
1119
1067
  * CLI user token: Supported.
1120
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1068
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1121
1069
  * Higher permission levels include lower levels: read < write < delete.
1122
1070
  * Grant match patterns can further restrict access to individual resources.
1123
1071
  */
@@ -1142,7 +1090,7 @@ var EllipsisAlerts = class {
1142
1090
  * Required permissions: write:alerts.
1143
1091
  * API key: Supported.
1144
1092
  * CLI user token: Supported.
1145
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1093
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1146
1094
  * Higher permission levels include lower levels: read < write < delete.
1147
1095
  */
1148
1096
  async dismiss(alert_id) {
@@ -1159,7 +1107,7 @@ var EllipsisAlerts = class {
1159
1107
  * Required permissions: read:alerts.
1160
1108
  * API key: Supported.
1161
1109
  * CLI user token: Supported.
1162
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1110
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1163
1111
  * Higher permission levels include lower levels: read < write < delete.
1164
1112
  */
1165
1113
  async get(alert_id) {
@@ -1179,7 +1127,7 @@ var EllipsisAlerts = class {
1179
1127
  * Required permissions: read:alerts.
1180
1128
  * API key: Supported.
1181
1129
  * CLI user token: Supported.
1182
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1130
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1183
1131
  * Higher permission levels include lower levels: read < write < delete.
1184
1132
  */
1185
1133
  async list(options = {}) {
@@ -1214,7 +1162,7 @@ var EllipsisAnalytics = class {
1214
1162
  * Required permissions: read:account.
1215
1163
  * API key: Supported.
1216
1164
  * CLI user token: Supported.
1217
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1165
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1218
1166
  * Higher permission levels include lower levels: read < write < delete.
1219
1167
  */
1220
1168
  async metrics(options = {}) {
@@ -1233,7 +1181,7 @@ var EllipsisAnalytics = class {
1233
1181
  * Required permissions: read:account.
1234
1182
  * API key: Supported.
1235
1183
  * CLI user token: Supported.
1236
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1184
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1237
1185
  * Higher permission levels include lower levels: read < write < delete.
1238
1186
  */
1239
1187
  async pullRequests(options = {}) {
@@ -1254,7 +1202,7 @@ var EllipsisAnalytics = class {
1254
1202
  * Required permissions: read:account.
1255
1203
  * API key: Supported.
1256
1204
  * CLI user token: Supported.
1257
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1205
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1258
1206
  * Higher permission levels include lower levels: read < write < delete.
1259
1207
  */
1260
1208
  async reviews(options = {}) {
@@ -1323,7 +1271,7 @@ var EllipsisEnvironments = class {
1323
1271
  * Required permissions: write:environments.
1324
1272
  * API key: Supported.
1325
1273
  * CLI user token: Supported.
1326
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1274
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1327
1275
  * Higher permission levels include lower levels: read < write < delete.
1328
1276
  */
1329
1277
  async create(options) {
@@ -1345,7 +1293,7 @@ var EllipsisEnvironments = class {
1345
1293
  * Required permissions: delete:environments.
1346
1294
  * API key: Supported.
1347
1295
  * CLI user token: Supported.
1348
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1296
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1349
1297
  * Higher permission levels include lower levels: read < write < delete.
1350
1298
  */
1351
1299
  async delete(environment_id) {
@@ -1360,7 +1308,7 @@ var EllipsisEnvironments = class {
1360
1308
  * Required permissions: read:environments.
1361
1309
  * API key: Supported.
1362
1310
  * CLI user token: Supported.
1363
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1311
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1364
1312
  * Higher permission levels include lower levels: read < write < delete.
1365
1313
  */
1366
1314
  async get(environment_id) {
@@ -1375,7 +1323,7 @@ var EllipsisEnvironments = class {
1375
1323
  * Required permissions: read:environments.
1376
1324
  * API key: Supported.
1377
1325
  * CLI user token: Supported.
1378
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1326
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1379
1327
  * Higher permission levels include lower levels: read < write < delete.
1380
1328
  */
1381
1329
  async list() {
@@ -1395,7 +1343,7 @@ var EllipsisEnvironments = class {
1395
1343
  * Required permissions: write:environments.
1396
1344
  * API key: Supported.
1397
1345
  * CLI user token: Supported.
1398
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1346
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1399
1347
  * Higher permission levels include lower levels: read < write < delete.
1400
1348
  */
1401
1349
  async update(environment_id, options) {
@@ -1404,113 +1352,6 @@ var EllipsisEnvironments = class {
1404
1352
  return await this.transport.request("PUT", path, { body });
1405
1353
  }
1406
1354
  };
1407
- var EllipsisFiles = class {
1408
- constructor(transport) {
1409
- this.transport = transport;
1410
- }
1411
- transport;
1412
- /**
1413
- * Create File
1414
- *
1415
- * Upload a file that outlives the sandbox.
1416
- *
1417
- * v1: PNG images only, base64 in the JSON body, 10 MiB cap. The
1418
- * primary caller is the in-sandbox `agent file upload` CLI (an
1419
- * agent persisting a screenshot to link on a PR), but all
1420
- * credential types work. Returns the org-membership-gated
1421
- * dashboard URL so callers never hard-code URL shapes.
1422
- *
1423
- * Required permissions: write:files.
1424
- * API key: Supported.
1425
- * CLI user token: Supported.
1426
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1427
- * Higher permission levels include lower levels: read < write < delete.
1428
- * Grant match patterns can further restrict access to individual resources.
1429
- */
1430
- async create(options) {
1431
- const path = "/v1/files";
1432
- const body = buildBody({ content_type: options.content_type, data_b64: options.data_b64, filename: options.filename });
1433
- return await this.transport.request("POST", path, { body });
1434
- }
1435
- /**
1436
- * Delete File
1437
- *
1438
- * Delete a file.
1439
- *
1440
- * A foreign, missing, or already-deleted id is an
1441
- * indistinguishable 404, so ids can't be enumerated. Sandbox
1442
- * tokens get a 403 (a sandbox token sits next to
1443
- * potentially-untrusted code and must not be able to destroy the
1444
- * account's files — uploading is fine, destruction is not); API
1445
- * keys and user tokens may delete.
1446
- *
1447
- * Required permissions: delete:files.
1448
- * API key: Supported.
1449
- * CLI user token: Supported.
1450
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1451
- * Higher permission levels include lower levels: read < write < delete.
1452
- * Grant match patterns can further restrict access to individual resources.
1453
- */
1454
- async delete(file_id) {
1455
- const path = `/v1/files/${enc(file_id)}`;
1456
- await this.transport.request("DELETE", path);
1457
- }
1458
- /**
1459
- * Get File
1460
- *
1461
- * Return one file's metadata and download link.
1462
- *
1463
- * Includes the gated dashboard URL and a short-lived presigned
1464
- * `download_url`, plus the owning account's GitHub login.
1465
- *
1466
- * Signed-in dashboard users are checked against the file's owning
1467
- * account, regardless of their selected organization. API keys,
1468
- * CLI user tokens, and sandbox tokens remain restricted to their
1469
- * own account. Missing, deleted, and inaccessible files return 404.
1470
- *
1471
- * To fetch the bytes locally, call this and then GET download_url
1472
- * immediately — the JSON API never carries the file. The CLI's
1473
- * `agent file get` wraps exactly that two-step.
1474
- *
1475
- * Required permissions: read:files.
1476
- * API key: Supported.
1477
- * CLI user token: Supported.
1478
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1479
- * Higher permission levels include lower levels: read < write < delete.
1480
- * Grant match patterns can further restrict access to individual resources.
1481
- */
1482
- async get(file_id) {
1483
- const path = `/v1/files/${enc(file_id)}`;
1484
- return await this.transport.request("GET", path);
1485
- }
1486
- /**
1487
- * List Files
1488
- *
1489
- * List uploaded files, newest first.
1490
- *
1491
- * Metadata only by default. Set include_download_urls=true to get
1492
- * a download_urls map keyed by file id for thumbnails or batch
1493
- * downloads. URLs expire within about a minute. session_id scopes
1494
- * the list to one session's uploads.
1495
- *
1496
- * Required permissions: read:files.
1497
- * API key: Supported.
1498
- * CLI user token: Supported.
1499
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1500
- * Higher permission levels include lower levels: read < write < delete.
1501
- * Grant match patterns can further restrict access to individual resources.
1502
- */
1503
- async list(options = {}) {
1504
- const path = "/v1/files";
1505
- const query = buildQuery({ session_id: options.session_id, limit: options.limit, cursor: options.cursor, include_download_urls: options.include_download_urls });
1506
- const response = await this.transport.request("GET", path, { query });
1507
- return new Page(
1508
- response,
1509
- "files",
1510
- (cursor) => this.list({ ...options, cursor })
1511
- );
1512
- }
1513
- };
1514
1355
  var EllipsisHandlers = class {
1515
1356
  constructor(transport) {
1516
1357
  this.transport = transport;
@@ -1527,12 +1368,12 @@ var EllipsisHandlers = class {
1527
1368
  * state without fetching GitHub or triggering synchronization.
1528
1369
  *
1529
1370
  * Requires configs:read; scoped grants match handlers/{service}.
1530
- * Sandbox credentials with that grant may read handlers.
1371
+ * Session tokens with that grant may read handlers.
1531
1372
  *
1532
1373
  * Required permissions: read:configs.
1533
1374
  * API key: Supported.
1534
1375
  * CLI user token: Supported.
1535
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1376
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1536
1377
  * Higher permission levels include lower levels: read < write < delete.
1537
1378
  * Grant match patterns can further restrict access to individual resources.
1538
1379
  */
@@ -1546,8 +1387,8 @@ var EllipsisHandlers = class {
1546
1387
  * Return session counts and accumulated spend for a saved handler.
1547
1388
  *
1548
1389
  * Filters only by session creation time. Omitted bounds include all
1549
- * history. Counts use the current conversation outcome, so an idle
1550
- * session remains active. Spend includes the selected sessions' full
1390
+ * history. Counts use the current turn and conversation state, so an open
1391
+ * conversation awaiting another message remains active. Spend includes the selected sessions' full
1551
1392
  * accumulated cost, including activity after the creation-time window.
1552
1393
  * Only sessions carrying this exact saved handler id are counted;
1553
1394
  * legacy sessions without handler provenance are excluded.
@@ -1557,12 +1398,12 @@ var EllipsisHandlers = class {
1557
1398
  * Those windows use usage timestamps and are independent of start/end.
1558
1399
  *
1559
1400
  * Requires configs:read matching handlers/{service} and unrestricted
1560
- * sessions:read. Sandbox tokens with both grants may read metrics.
1401
+ * sessions:read. Session tokens with both grants may read metrics.
1561
1402
  *
1562
1403
  * Required permissions: read:sessions, read:configs.
1563
1404
  * API key: Supported.
1564
1405
  * CLI user token: Supported.
1565
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1406
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1566
1407
  * Higher permission levels include lower levels: read < write < delete.
1567
1408
  * Grant match patterns can further restrict access to individual resources.
1568
1409
  */
@@ -1591,7 +1432,7 @@ var EllipsisIntegrationsGithub = class {
1591
1432
  * Required permissions: read:integrations.
1592
1433
  * API key: Supported.
1593
1434
  * CLI user token: Supported.
1594
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1435
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1595
1436
  * Higher permission levels include lower levels: read < write < delete.
1596
1437
  */
1597
1438
  async members() {
@@ -1606,7 +1447,7 @@ var EllipsisIntegrationsGithub = class {
1606
1447
  * Required permissions: read:integrations.
1607
1448
  * API key: Supported.
1608
1449
  * CLI user token: Supported.
1609
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1450
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1610
1451
  * Higher permission levels include lower levels: read < write < delete.
1611
1452
  */
1612
1453
  async repos() {
@@ -1619,7 +1460,7 @@ var EllipsisIntegrationsGithub = class {
1619
1460
  * Required permissions: write:integrations.
1620
1461
  * API key: Supported.
1621
1462
  * CLI user token: Supported.
1622
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1463
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1623
1464
  * Higher permission levels include lower levels: read < write < delete.
1624
1465
  */
1625
1466
  async uninstall(options) {
@@ -1639,7 +1480,7 @@ var EllipsisIntegrationsLinear = class {
1639
1480
  * Required permissions: delete:integrations.
1640
1481
  * API key: Supported.
1641
1482
  * CLI user token: Supported.
1642
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1483
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1643
1484
  * Higher permission levels include lower levels: read < write < delete.
1644
1485
  */
1645
1486
  async delete() {
@@ -1654,7 +1495,7 @@ var EllipsisIntegrationsLinear = class {
1654
1495
  * Required permissions: read:integrations.
1655
1496
  * API key: Supported.
1656
1497
  * CLI user token: Supported.
1657
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1498
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1658
1499
  * Higher permission levels include lower levels: read < write < delete.
1659
1500
  */
1660
1501
  async teams() {
@@ -1667,7 +1508,7 @@ var EllipsisIntegrationsLinear = class {
1667
1508
  * Required permissions: write:integrations.
1668
1509
  * API key: Supported.
1669
1510
  * CLI user token: Supported.
1670
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1511
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1671
1512
  * Higher permission levels include lower levels: read < write < delete.
1672
1513
  */
1673
1514
  async updateSettings(options) {
@@ -1687,7 +1528,7 @@ var EllipsisIntegrationsSentry = class {
1687
1528
  * Required permissions: delete:integrations.
1688
1529
  * API key: Supported.
1689
1530
  * CLI user token: Supported.
1690
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1531
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1691
1532
  * Higher permission levels include lower levels: read < write < delete.
1692
1533
  */
1693
1534
  async delete(integration_id) {
@@ -1702,7 +1543,7 @@ var EllipsisIntegrationsSentry = class {
1702
1543
  * Required permissions: read:integrations.
1703
1544
  * API key: Supported.
1704
1545
  * CLI user token: Supported.
1705
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1546
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1706
1547
  * Higher permission levels include lower levels: read < write < delete.
1707
1548
  */
1708
1549
  async organizations() {
@@ -1724,7 +1565,7 @@ var EllipsisIntegrationsSlack = class {
1724
1565
  * Required permissions: read:integrations.
1725
1566
  * API key: Supported.
1726
1567
  * CLI user token: Supported.
1727
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1568
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1728
1569
  * Higher permission levels include lower levels: read < write < delete.
1729
1570
  */
1730
1571
  async channels() {
@@ -1737,7 +1578,7 @@ var EllipsisIntegrationsSlack = class {
1737
1578
  * Required permissions: write:integrations.
1738
1579
  * API key: Supported.
1739
1580
  * CLI user token: Supported.
1740
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1581
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1741
1582
  * Higher permission levels include lower levels: read < write < delete.
1742
1583
  */
1743
1584
  async createOperationsChannel() {
@@ -1750,7 +1591,7 @@ var EllipsisIntegrationsSlack = class {
1750
1591
  * Required permissions: delete:integrations.
1751
1592
  * API key: Supported.
1752
1593
  * CLI user token: Supported.
1753
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1594
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1754
1595
  * Higher permission levels include lower levels: read < write < delete.
1755
1596
  */
1756
1597
  async delete() {
@@ -1766,7 +1607,7 @@ var EllipsisIntegrationsSlack = class {
1766
1607
  * Required permissions: read:integrations.
1767
1608
  * API key: Supported.
1768
1609
  * CLI user token: Supported.
1769
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1610
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1770
1611
  * Higher permission levels include lower levels: read < write < delete.
1771
1612
  */
1772
1613
  async members() {
@@ -1779,7 +1620,7 @@ var EllipsisIntegrationsSlack = class {
1779
1620
  * Required permissions: write:integrations.
1780
1621
  * API key: Supported.
1781
1622
  * CLI user token: Supported.
1782
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1623
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
1783
1624
  * Higher permission levels include lower levels: read < write < delete.
1784
1625
  */
1785
1626
  async updateSettings(options) {
@@ -1810,13 +1651,13 @@ var EllipsisIntegrations = class {
1810
1651
  * config can learn which repositories, channels, teams, and
1811
1652
  * organizations it may name before POST /agents.
1812
1653
  *
1813
- * Available to all credential types including sandbox tokens: the
1654
+ * Available to all credential types including session tokens: the
1814
1655
  * responses never include OAuth tokens or any other secret.
1815
1656
  *
1816
1657
  * Required permissions: read:integrations.
1817
1658
  * API key: Supported.
1818
1659
  * CLI user token: Supported.
1819
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1660
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1820
1661
  * Higher permission levels include lower levels: read < write < delete.
1821
1662
  */
1822
1663
  async list() {
@@ -1845,7 +1686,7 @@ var EllipsisMemories = class {
1845
1686
  * Required permissions: write:memories.
1846
1687
  * API key: Supported.
1847
1688
  * CLI user token: Supported.
1848
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1689
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1849
1690
  * Higher permission levels include lower levels: read < write < delete.
1850
1691
  * Grant match patterns can further restrict access to individual resources.
1851
1692
  */
@@ -1866,7 +1707,7 @@ var EllipsisMemories = class {
1866
1707
  * Required permissions: delete:memories.
1867
1708
  * API key: Supported.
1868
1709
  * CLI user token: Supported.
1869
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1710
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1870
1711
  * Higher permission levels include lower levels: read < write < delete.
1871
1712
  * Grant match patterns can further restrict access to individual resources.
1872
1713
  */
@@ -1890,7 +1731,7 @@ var EllipsisMemories = class {
1890
1731
  * Required permissions: write:memories.
1891
1732
  * API key: Supported.
1892
1733
  * CLI user token: Supported.
1893
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1734
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1894
1735
  * Higher permission levels include lower levels: read < write < delete.
1895
1736
  * Grant match patterns can further restrict access to individual resources.
1896
1737
  */
@@ -1909,7 +1750,7 @@ var EllipsisMemories = class {
1909
1750
  * Required permissions: read:memories.
1910
1751
  * API key: Supported.
1911
1752
  * CLI user token: Supported.
1912
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1753
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1913
1754
  * Higher permission levels include lower levels: read < write < delete.
1914
1755
  * Grant match patterns can further restrict access to individual resources.
1915
1756
  */
@@ -1930,7 +1771,7 @@ var EllipsisMemories = class {
1930
1771
  * Required permissions: read:memories.
1931
1772
  * API key: Supported.
1932
1773
  * CLI user token: Supported.
1933
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1774
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1934
1775
  * Higher permission levels include lower levels: read < write < delete.
1935
1776
  * Grant match patterns can further restrict access to individual resources.
1936
1777
  */
@@ -1951,7 +1792,7 @@ var EllipsisReviews = class {
1951
1792
  * Required permissions: read:reviews.
1952
1793
  * API key: Supported.
1953
1794
  * CLI user token: Supported.
1954
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1795
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1955
1796
  * Higher permission levels include lower levels: read < write < delete.
1956
1797
  */
1957
1798
  async configs() {
@@ -1969,7 +1810,7 @@ var EllipsisReviews = class {
1969
1810
  * the automatic one.
1970
1811
  *
1971
1812
  * A review is one pipeline run over one commit range, with one
1972
- * agent session per stage: `review.id` is the run id, and
1813
+ * agent session per stage: `review.id` is the review id, and
1973
1814
  * `stages[].session_id` is where a client streams
1974
1815
  * (/sessions/{id}/stream on a stage session), since the review
1975
1816
  * itself is a pipeline rather than one process.
@@ -1977,7 +1818,7 @@ var EllipsisReviews = class {
1977
1818
  * Required permissions: write:reviews.
1978
1819
  * API key: Supported.
1979
1820
  * CLI user token: Supported.
1980
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1821
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1981
1822
  * Higher permission levels include lower levels: read < write < delete.
1982
1823
  */
1983
1824
  async create(options) {
@@ -2000,7 +1841,7 @@ var EllipsisReviews = class {
2000
1841
  * Required permissions: read:reviews.
2001
1842
  * API key: Supported.
2002
1843
  * CLI user token: Supported.
2003
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1844
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2004
1845
  * Higher permission levels include lower levels: read < write < delete.
2005
1846
  */
2006
1847
  async get(review_id) {
@@ -2023,7 +1864,7 @@ var EllipsisReviews = class {
2023
1864
  * Required permissions: read:reviews.
2024
1865
  * API key: Supported.
2025
1866
  * CLI user token: Supported.
2026
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1867
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2027
1868
  * Higher permission levels include lower levels: read < write < delete.
2028
1869
  */
2029
1870
  async list(options = {}) {
@@ -2047,13 +1888,13 @@ var EllipsisSecrets = class {
2047
1888
  *
2048
1889
  * Delete a secret by name.
2049
1890
  *
2050
- * Refused for sandbox tokens; mutations require an API key or
1891
+ * Refused for session tokens; mutations require an API key or
2051
1892
  * user token.
2052
1893
  *
2053
1894
  * Required permissions: delete:secrets.
2054
1895
  * API key: Supported.
2055
1896
  * CLI user token: Supported.
2056
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1897
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2057
1898
  * Higher permission levels include lower levels: read < write < delete.
2058
1899
  * Grant match patterns can further restrict access to individual resources.
2059
1900
  */
@@ -2072,7 +1913,7 @@ var EllipsisSecrets = class {
2072
1913
  * Required permissions: read:secrets.
2073
1914
  * API key: Supported.
2074
1915
  * CLI user token: Supported.
2075
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1916
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2076
1917
  * Higher permission levels include lower levels: read < write < delete.
2077
1918
  * Grant match patterns can further restrict access to individual resources.
2078
1919
  */
@@ -2086,14 +1927,14 @@ var EllipsisSecrets = class {
2086
1927
  * Upsert secrets.
2087
1928
  *
2088
1929
  * Returns only the secrets this call wrote, names and timestamps
2089
- * only — values are write-only. Refused for sandbox tokens (held by
2090
- * potentially-untrusted in-sandbox code); mutations require an
2091
- * API key or user token.
1930
+ * only — values are write-only. Refused for session tokens (held by
1931
+ * potentially-untrusted code running inside a session); mutations
1932
+ * require an API key or user token.
2092
1933
  *
2093
1934
  * Required permissions: write:secrets.
2094
1935
  * API key: Supported.
2095
1936
  * CLI user token: Supported.
2096
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
1937
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2097
1938
  * Higher permission levels include lower levels: read < write < delete.
2098
1939
  * Grant match patterns can further restrict access to individual resources.
2099
1940
  */
@@ -2103,11 +1944,58 @@ var EllipsisSecrets = class {
2103
1944
  return await this.transport.request("PUT", path, { body });
2104
1945
  }
2105
1946
  };
1947
+ var EllipsisSessionsTurns = class {
1948
+ constructor(transport) {
1949
+ this.transport = transport;
1950
+ }
1951
+ transport;
1952
+ /**
1953
+ * Get Session Turn
1954
+ *
1955
+ * Return one turn.
1956
+ *
1957
+ * Poll this after sending a message: the message is answered when
1958
+ * the turn's status is completed, failed, stopped, or cancelled.
1959
+ *
1960
+ * Required permissions: read:sessions.
1961
+ * API key: Supported.
1962
+ * CLI user token: Supported.
1963
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1964
+ * Higher permission levels include lower levels: read < write < delete.
1965
+ * Grant match patterns can further restrict access to individual resources.
1966
+ */
1967
+ async get(session_id, turn_id) {
1968
+ const path = `/v1/sessions/${enc(session_id)}/turns/${enc(turn_id)}`;
1969
+ return await this.transport.request("GET", path);
1970
+ }
1971
+ /**
1972
+ * Get Session Turns
1973
+ *
1974
+ * Return the session's turns and messages, oldest first.
1975
+ *
1976
+ * One turn per message: pending until the agent starts on it,
1977
+ * running while it works, then completed, failed, stopped, or
1978
+ * cancelled.
1979
+ *
1980
+ * Required permissions: read:sessions.
1981
+ * API key: Supported.
1982
+ * CLI user token: Supported.
1983
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
1984
+ * Higher permission levels include lower levels: read < write < delete.
1985
+ * Grant match patterns can further restrict access to individual resources.
1986
+ */
1987
+ async list(session_id) {
1988
+ const path = `/v1/sessions/${enc(session_id)}/turns`;
1989
+ return await this.transport.request("GET", path);
1990
+ }
1991
+ };
2106
1992
  var EllipsisSessions = class {
2107
1993
  constructor(transport) {
2108
1994
  this.transport = transport;
1995
+ this.turns = new EllipsisSessionsTurns(transport);
2109
1996
  }
2110
1997
  transport;
1998
+ turns;
2111
1999
  /**
2112
2000
  * Get Session Analytics
2113
2001
  *
@@ -2115,16 +2003,16 @@ var EllipsisSessions = class {
2115
2003
  *
2116
2004
  * Token lanes use the request's saved rates. Content attribution
2117
2005
  * apportions input/cache spend by text size, counting carried context
2118
- * on every request. It is an estimate, not a tool execution fee.
2006
+ * on every request. It is an estimate, not a tool call fee.
2119
2007
  * Only the latest 200 retained request bodies are inspected; missing
2120
2008
  * or unsupported context remains explicitly unattributed. No raw
2121
- * prompts or tool results are returned. Sandbox tokens may read only
2009
+ * prompts or tool results are returned. Session tokens may read only
2122
2010
  * their own session's analytics.
2123
2011
  *
2124
2012
  * Required permissions: read:sessions.
2125
2013
  * API key: Supported.
2126
2014
  * CLI user token: Supported.
2127
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2015
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2128
2016
  * Higher permission levels include lower levels: read < write < delete.
2129
2017
  * Grant match patterns can further restrict access to individual resources.
2130
2018
  */
@@ -2138,15 +2026,15 @@ var EllipsisSessions = class {
2138
2026
  * Return the session's uncommitted changes as a patch.
2139
2027
  *
2140
2028
  * One unified-diff section per changed file, captured from the
2141
- * sandbox's working tree when the session ended. The per-file
2029
+ * environment's working tree when the session ended. The per-file
2142
2030
  * counts ride on the session itself (`git.repos[].files`); this
2143
2031
  * is the text behind them. Empty when the tree was clean. A
2144
- * sandbox token may read only its own session's diff.
2032
+ * session token may read only its own session's diff.
2145
2033
  *
2146
2034
  * Required permissions: read:sessions.
2147
2035
  * API key: Supported.
2148
2036
  * CLI user token: Supported.
2149
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2037
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2150
2038
  * Higher permission levels include lower levels: read < write < delete.
2151
2039
  * Grant match patterns can further restrict access to individual resources.
2152
2040
  */
@@ -2160,7 +2048,7 @@ var EllipsisSessions = class {
2160
2048
  * Download the complete session history.
2161
2049
  *
2162
2050
  * The complete, ordered history of the session (agent output, tool calls, thinking,
2163
- * lifecycle events, sandbox output, message events) as an ordered
2051
+ * lifecycle events, environment output, message events) as an ordered
2164
2052
  * manifest of presigned segment URLs.
2165
2053
  *
2166
2054
  * Segments are gzip members: download in order and concatenate
@@ -2171,7 +2059,7 @@ var EllipsisSessions = class {
2171
2059
  * Required permissions: read:sessions.
2172
2060
  * API key: Supported.
2173
2061
  * CLI user token: Supported.
2174
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2062
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2175
2063
  * Higher permission levels include lower levels: read < write < delete.
2176
2064
  * Grant match patterns can further restrict access to individual resources.
2177
2065
  */
@@ -2179,35 +2067,14 @@ var EllipsisSessions = class {
2179
2067
  const path = `/v1/sessions/${enc(session_id)}/download`;
2180
2068
  return await this.transport.request("GET", path);
2181
2069
  }
2182
- /**
2183
- * List Session Executions
2184
- *
2185
- * Return the session's execution attempts, oldest first.
2186
- *
2187
- * Includes the selected harness, model, resolved instructions, initial
2188
- * query, and common result summary. Complete native outputs remain in
2189
- * the session's records. Internal launch options and checkpoint storage
2190
- * references are excluded.
2191
- *
2192
- * Required permissions: read:sessions.
2193
- * API key: Supported.
2194
- * CLI user token: Supported.
2195
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2196
- * Higher permission levels include lower levels: read < write < delete.
2197
- * Grant match patterns can further restrict access to individual resources.
2198
- */
2199
- async executions(session_id) {
2200
- const path = `/v1/sessions/${enc(session_id)}/executions`;
2201
- return await this.transport.request("GET", path);
2202
- }
2203
2070
  /**
2204
2071
  * Get Session
2205
2072
  *
2206
2073
  * Return one session.
2207
2074
  *
2208
- * The public wire shape — the same shape the stream's session
2209
- * frames carry, with attribution, stop, and archive actors resolved
2210
- * at read time.
2075
+ * The public wire shape, the same shape the stream's session frames
2076
+ * carry, with attribution, stop, and archive actors resolved at read
2077
+ * time. `turn` is the turn in progress or the latest one.
2211
2078
  *
2212
2079
  * The heavy near-static blobs (config snapshot, input/output)
2213
2080
  * live on the detail endpoints, not here.
@@ -2215,7 +2082,7 @@ var EllipsisSessions = class {
2215
2082
  * Required permissions: read:sessions.
2216
2083
  * API key: Supported.
2217
2084
  * CLI user token: Supported.
2218
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2085
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2219
2086
  * Higher permission levels include lower levels: read < write < delete.
2220
2087
  * Grant match patterns can further restrict access to individual resources.
2221
2088
  */
@@ -2234,7 +2101,7 @@ var EllipsisSessions = class {
2234
2101
  * Required permissions: read:sessions.
2235
2102
  * API key: Supported.
2236
2103
  * CLI user token: Supported.
2237
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2104
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2238
2105
  * Higher permission levels include lower levels: read < write < delete.
2239
2106
  * Grant match patterns can further restrict access to individual resources.
2240
2107
  */
@@ -2247,15 +2114,16 @@ var EllipsisSessions = class {
2247
2114
  *
2248
2115
  * Append transcript lines to a session's record.
2249
2116
  *
2250
- * The in-sandbox tailer for interactive sessions.
2117
+ * The transcript tailer running inside the session's environment, for
2118
+ * interactive sessions.
2251
2119
  *
2252
- * A sandbox token may only push its own session's transcript.
2253
- * Idempotent by transcript line uuid; tolerant of malformed lines.
2120
+ * A session token may only push its own session's transcript.
2121
+ * Idempotent by transcript line uuid; tolerant of malformed lines.
2254
2122
  *
2255
2123
  * Required permissions: write:sessions.
2256
2124
  * API key: Supported.
2257
2125
  * CLI user token: Supported.
2258
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2126
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
2259
2127
  * Higher permission levels include lower levels: read < write < delete.
2260
2128
  * Grant match patterns can further restrict access to individual resources.
2261
2129
  */
@@ -2276,7 +2144,7 @@ var EllipsisSessions = class {
2276
2144
  * Required permissions: read:sessions.
2277
2145
  * API key: Supported.
2278
2146
  * CLI user token: Supported.
2279
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2147
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2280
2148
  * Higher permission levels include lower levels: read < write < delete.
2281
2149
  * Grant match patterns can further restrict access to individual resources.
2282
2150
  */
@@ -2298,13 +2166,13 @@ var EllipsisSessions = class {
2298
2166
  * The payload the agent submitted through its config-declared
2299
2167
  * output.json_schema, as the raw JSON body with no envelope. 404
2300
2168
  * while the session is still running (poll GET /v1/sessions/{id}),
2301
- * when the agent declares no output block, or when no execution
2169
+ * when the agent declares no output block, or when no turn
2302
2170
  * produced output.
2303
2171
  *
2304
2172
  * Required permissions: read:sessions.
2305
2173
  * API key: Supported.
2306
2174
  * CLI user token: Supported.
2307
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2175
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2308
2176
  * Higher permission levels include lower levels: read < write < delete.
2309
2177
  * Grant match patterns can further restrict access to individual resources.
2310
2178
  */
@@ -2318,7 +2186,7 @@ var EllipsisSessions = class {
2318
2186
  * Return the session's stored transcript records, oldest first.
2319
2187
  *
2320
2188
  * Pagination is opt-in (cursor/limit); a bare call returns the
2321
- * full retained transcript. Available to sandbox tokens too: an
2189
+ * full retained transcript. Available to session tokens too: an
2322
2190
  * agent answering "did X look into Y?" needs to read the sessions
2323
2191
  * it finds, and any org member sees the same transcript in the
2324
2192
  * dashboard.
@@ -2326,7 +2194,7 @@ var EllipsisSessions = class {
2326
2194
  * Required permissions: read:sessions.
2327
2195
  * API key: Supported.
2328
2196
  * CLI user token: Supported.
2329
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2197
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2330
2198
  * Higher permission levels include lower levels: read < write < delete.
2331
2199
  * Grant match patterns can further restrict access to individual resources.
2332
2200
  */
@@ -2346,7 +2214,7 @@ var EllipsisSessions = class {
2346
2214
  * Required permissions: read:sessions.
2347
2215
  * API key: Supported.
2348
2216
  * CLI user token: Supported.
2349
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2217
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2350
2218
  * Higher permission levels include lower levels: read < write < delete.
2351
2219
  * Grant match patterns can further restrict access to individual resources.
2352
2220
  */
@@ -2360,15 +2228,14 @@ var EllipsisSessions = class {
2360
2228
  *
2361
2229
  * Send a message to a session.
2362
2230
  *
2363
- * 409 for react/cron, non-interactive, and closed sessions.
2364
- * Returns the created message so the caller can track it by id; a
2365
- * retried send with the same idempotency_key returns the original
2366
- * message.
2231
+ * 409 for react/cron, non-interactive, closed, and out-of-budget
2232
+ * sessions. Returns the created message and its turn; a retried send
2233
+ * with the same idempotency_key returns the original ones.
2367
2234
  *
2368
2235
  * Required permissions: write:sessions.
2369
2236
  * API key: Supported.
2370
2237
  * CLI user token: Supported.
2371
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2238
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2372
2239
  * Higher permission levels include lower levels: read < write < delete.
2373
2240
  * Grant match patterns can further restrict access to individual resources.
2374
2241
  */
@@ -2383,7 +2250,7 @@ var EllipsisSessions = class {
2383
2250
  * Required permissions: read:sessions.
2384
2251
  * API key: Supported.
2385
2252
  * CLI user token: Supported.
2386
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2253
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2387
2254
  * Higher permission levels include lower levels: read < write < delete.
2388
2255
  * Grant match patterns can further restrict access to individual resources.
2389
2256
  */
@@ -2397,41 +2264,43 @@ var EllipsisSessions = class {
2397
2264
  * Start a cloud agent session.
2398
2265
  *
2399
2266
  * The daily driver: a prompt, optionally where to run it
2400
- * (`environment`) and the run's own settings, in the AgentConfig
2267
+ * (`environment`) and the session's own settings, in the AgentConfig
2401
2268
  * vocabulary. What you send is what runs: omit `environment` and the
2402
- * session runs in the built-in basic sandbox. A missing model or
2269
+ * session runs in the built-in basic environment. A missing model or
2403
2270
  * budget comes from the organization's settings, so
2404
2271
  * `{"claude_code": {"prompt": "..."}}` is a complete request.
2405
2272
  * Set exactly one of `claude_code` or `codex`. Its `prompt` is the
2406
- * first message; omit the prompt and the session starts idle, waiting for
2407
- * one. 400 when `lifecycle.interactive` is false and there is no prompt, or
2408
- * when `budget` exceeds the organization's per-session ceiling. To
2409
- * run a saved agent, use POST /v1/agents/{agent_id}/sessions.
2273
+ * first message; omit the prompt and the session starts with no
2274
+ * turn, waiting for one. 400 when `conversation.interactive` is false
2275
+ * and there is no prompt, or when `budget` exceeds the organization's
2276
+ * per-session ceiling. To run a saved agent, use
2277
+ * POST /v1/agents/{agent_id}/sessions.
2410
2278
  *
2411
2279
  * Required permissions: write:sessions.
2412
2280
  * API key: Supported.
2413
2281
  * CLI user token: Supported.
2414
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2282
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2415
2283
  * Higher permission levels include lower levels: read < write < delete.
2416
2284
  * Grant match patterns can further restrict access to individual resources.
2417
2285
  */
2418
2286
  async start(options = {}) {
2419
2287
  const path = "/v1/sessions";
2420
- const body = buildBody({ budget: options.budget, claude_code: options.claude_code, codex: options.codex, environment: options.environment, force_rebuild: options.force_rebuild, images: options.images, lifecycle: options.lifecycle, metadata: options.metadata, output: options.output, permissions: options.permissions, repositories: options.repositories, skills: options.skills });
2288
+ const body = buildBody({ budget: options.budget, claude_code: options.claude_code, codex: options.codex, conversation: options.conversation, environment: options.environment, force_rebuild: options.force_rebuild, images: options.images, metadata: options.metadata, output: options.output, permissions: options.permissions, repositories: options.repositories, skills: options.skills });
2421
2289
  return await this.transport.request("POST", path, { body });
2422
2290
  }
2423
2291
  /**
2424
2292
  * Stop Session
2425
2293
  *
2426
- * Stop an in-flight session and return it.
2294
+ * Stop the turn in progress and return the session.
2427
2295
  *
2428
- * stopped_by is recorded only when the caller's credential maps
2429
- * to a GitHub account.
2296
+ * The turn ends `stopped`; the conversation stays open. 409 when no
2297
+ * turn is pending or running. The stopping user is recorded only
2298
+ * when the caller's credential maps to a GitHub account.
2430
2299
  *
2431
2300
  * Required permissions: write:sessions.
2432
2301
  * API key: Supported.
2433
2302
  * CLI user token: Supported.
2434
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2303
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2435
2304
  * Higher permission levels include lower levels: read < write < delete.
2436
2305
  * Grant match patterns can further restrict access to individual resources.
2437
2306
  */
@@ -2445,7 +2314,7 @@ var EllipsisSessions = class {
2445
2314
  * Required permissions: read:sessions.
2446
2315
  * API key: Supported.
2447
2316
  * CLI user token: Supported.
2448
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2317
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2449
2318
  * Higher permission levels include lower levels: read < write < delete.
2450
2319
  * Grant match patterns can further restrict access to individual resources.
2451
2320
  */
@@ -2469,7 +2338,7 @@ var EllipsisSessions = class {
2469
2338
  * Required permissions: write:sessions.
2470
2339
  * API key: Supported.
2471
2340
  * CLI user token: Supported.
2472
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2341
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2473
2342
  * Higher permission levels include lower levels: read < write < delete.
2474
2343
  * Grant match patterns can further restrict access to individual resources.
2475
2344
  */
@@ -2501,7 +2370,7 @@ var EllipsisSupportSlack = class {
2501
2370
  * Required permissions: write:account.
2502
2371
  * API key: Requires a CLI user token.
2503
2372
  * CLI user token: Supported.
2504
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2373
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2505
2374
  * Higher permission levels include lower levels: read < write < delete.
2506
2375
  */
2507
2376
  async create(options) {
@@ -2515,7 +2384,7 @@ var EllipsisSupportSlack = class {
2515
2384
  * Required permissions: read:account.
2516
2385
  * API key: Supported.
2517
2386
  * CLI user token: Supported.
2518
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2387
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2519
2388
  * Higher permission levels include lower levels: read < write < delete.
2520
2389
  */
2521
2390
  async get() {
@@ -2528,7 +2397,7 @@ var EllipsisSupportSlack = class {
2528
2397
  * Required permissions: write:account.
2529
2398
  * API key: Requires a CLI user token.
2530
2399
  * CLI user token: Supported.
2531
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2400
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2532
2401
  * Higher permission levels include lower levels: read < write < delete.
2533
2402
  */
2534
2403
  async invite(options) {
@@ -2558,7 +2427,7 @@ var EllipsisTemplates = class {
2558
2427
  * Required permissions: read:templates.
2559
2428
  * API key: Supported.
2560
2429
  * CLI user token: Supported.
2561
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2430
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2562
2431
  * Higher permission levels include lower levels: read < write < delete.
2563
2432
  */
2564
2433
  async get(template_id) {
@@ -2576,7 +2445,7 @@ var EllipsisTemplates = class {
2576
2445
  * Required permissions: read:templates.
2577
2446
  * API key: Supported.
2578
2447
  * CLI user token: Supported.
2579
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2448
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2580
2449
  * Higher permission levels include lower levels: read < write < delete.
2581
2450
  */
2582
2451
  async list() {
@@ -2600,7 +2469,7 @@ var EllipsisUserSubscriptionTokens = class {
2600
2469
  * Required permissions: delete:user.
2601
2470
  * API key: Requires a CLI user token.
2602
2471
  * CLI user token: Supported.
2603
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2472
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2604
2473
  * Higher permission levels include lower levels: read < write < delete.
2605
2474
  */
2606
2475
  async delete(provider) {
@@ -2618,7 +2487,7 @@ var EllipsisUserSubscriptionTokens = class {
2618
2487
  * Required permissions: read:user.
2619
2488
  * API key: Requires a CLI user token.
2620
2489
  * CLI user token: Supported.
2621
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2490
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2622
2491
  * Higher permission levels include lower levels: read < write < delete.
2623
2492
  */
2624
2493
  async get(provider) {
@@ -2637,7 +2506,7 @@ var EllipsisUserSubscriptionTokens = class {
2637
2506
  * Required permissions: read:user.
2638
2507
  * API key: Requires a CLI user token.
2639
2508
  * CLI user token: Supported.
2640
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2509
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2641
2510
  * Higher permission levels include lower levels: read < write < delete.
2642
2511
  */
2643
2512
  async list() {
@@ -2658,7 +2527,7 @@ var EllipsisUserSubscriptionTokens = class {
2658
2527
  * Required permissions: write:user.
2659
2528
  * API key: Requires a CLI user token.
2660
2529
  * CLI user token: Supported.
2661
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2530
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2662
2531
  * Higher permission levels include lower levels: read < write < delete.
2663
2532
  */
2664
2533
  async set(provider, options) {
@@ -2680,7 +2549,7 @@ var EllipsisUserSubscriptionTokens = class {
2680
2549
  * Required permissions: read:user.
2681
2550
  * API key: Requires a CLI user token.
2682
2551
  * CLI user token: Supported.
2683
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2552
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2684
2553
  * Higher permission levels include lower levels: read < write < delete.
2685
2554
  */
2686
2555
  async usage(provider) {
@@ -2702,7 +2571,7 @@ var EllipsisUserSubscriptionTokens = class {
2702
2571
  * Required permissions: write:user.
2703
2572
  * API key: Requires a CLI user token.
2704
2573
  * CLI user token: Supported.
2705
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2574
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2706
2575
  * Higher permission levels include lower levels: read < write < delete.
2707
2576
  */
2708
2577
  async verify(provider) {
@@ -2721,7 +2590,7 @@ var EllipsisUserTokens = class {
2721
2590
  * Required permissions: read:user.
2722
2591
  * API key: Requires a CLI user token.
2723
2592
  * CLI user token: Supported.
2724
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2593
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2725
2594
  * Higher permission levels include lower levels: read < write < delete.
2726
2595
  */
2727
2596
  async list() {
@@ -2734,7 +2603,7 @@ var EllipsisUserTokens = class {
2734
2603
  * Required permissions: delete:user.
2735
2604
  * API key: Requires a CLI user token.
2736
2605
  * CLI user token: Supported.
2737
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2606
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2738
2607
  * Higher permission levels include lower levels: read < write < delete.
2739
2608
  */
2740
2609
  async revoke(token_id) {
@@ -2763,7 +2632,7 @@ var EllipsisVmExecutions = class {
2763
2632
  * Required permissions: read:environments.
2764
2633
  * API key: Supported.
2765
2634
  * CLI user token: Supported.
2766
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2635
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2767
2636
  * Higher permission levels include lower levels: read < write < delete.
2768
2637
  */
2769
2638
  async get(vm_execution_id) {
@@ -2776,7 +2645,7 @@ var EllipsisVmExecutions = class {
2776
2645
  * Required permissions: read:environments.
2777
2646
  * API key: Supported.
2778
2647
  * CLI user token: Supported.
2779
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2648
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2780
2649
  * Higher permission levels include lower levels: read < write < delete.
2781
2650
  */
2782
2651
  async list() {
@@ -2789,7 +2658,7 @@ var EllipsisVmExecutions = class {
2789
2658
  * Required permissions: read:environments.
2790
2659
  * API key: Supported.
2791
2660
  * CLI user token: Supported.
2792
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2661
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
2793
2662
  * Higher permission levels include lower levels: read < write < delete.
2794
2663
  */
2795
2664
  async streamTicket(vm_execution_id) {
@@ -2810,7 +2679,7 @@ var EllipsisVmImages = class {
2810
2679
  * Required permissions: read:environments.
2811
2680
  * API key: Supported.
2812
2681
  * CLI user token: Supported.
2813
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2682
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2814
2683
  * Higher permission levels include lower levels: read < write < delete.
2815
2684
  */
2816
2685
  async get(image_id) {
@@ -2827,7 +2696,7 @@ var EllipsisVmImages = class {
2827
2696
  * Required permissions: read:environments.
2828
2697
  * API key: Supported.
2829
2698
  * CLI user token: Supported.
2830
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2699
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2831
2700
  * Higher permission levels include lower levels: read < write < delete.
2832
2701
  */
2833
2702
  async list(options = {}) {
@@ -2849,7 +2718,7 @@ var EllipsisVms = class {
2849
2718
  * Required permissions: read:environments.
2850
2719
  * API key: Supported.
2851
2720
  * CLI user token: Supported.
2852
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
2721
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
2853
2722
  * Higher permission levels include lower levels: read < write < delete.
2854
2723
  */
2855
2724
  async get(vm_id) {
@@ -2866,7 +2735,7 @@ var EllipsisVms = class {
2866
2735
  * Required permissions: read:environments.
2867
2736
  * API key: Supported.
2868
2737
  * CLI user token: Supported.
2869
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
2738
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
2870
2739
  * Higher permission levels include lower levels: read < write < delete.
2871
2740
  */
2872
2741
  async list(options = {}) {
@@ -2891,7 +2760,7 @@ var EllipsisWebhooksDeliveries = class {
2891
2760
  * Required permissions: read:webhooks.
2892
2761
  * API key: Supported.
2893
2762
  * CLI user token: Supported.
2894
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2763
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2895
2764
  * Higher permission levels include lower levels: read < write < delete.
2896
2765
  */
2897
2766
  async get(delivery_id) {
@@ -2909,7 +2778,7 @@ var EllipsisWebhooksDeliveries = class {
2909
2778
  * Required permissions: read:webhooks.
2910
2779
  * API key: Supported.
2911
2780
  * CLI user token: Supported.
2912
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2781
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2913
2782
  * Higher permission levels include lower levels: read < write < delete.
2914
2783
  */
2915
2784
  async list(options = {}) {
@@ -2943,7 +2812,7 @@ var EllipsisWebhooks = class {
2943
2812
  * Required permissions: write:webhooks.
2944
2813
  * API key: Supported.
2945
2814
  * CLI user token: Supported.
2946
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2815
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2947
2816
  * Higher permission levels include lower levels: read < write < delete.
2948
2817
  */
2949
2818
  async create(options) {
@@ -2962,7 +2831,7 @@ var EllipsisWebhooks = class {
2962
2831
  * Required permissions: delete:webhooks.
2963
2832
  * API key: Supported.
2964
2833
  * CLI user token: Supported.
2965
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2834
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2966
2835
  * Higher permission levels include lower levels: read < write < delete.
2967
2836
  */
2968
2837
  async delete(webhook_id) {
@@ -2977,7 +2846,7 @@ var EllipsisWebhooks = class {
2977
2846
  * Required permissions: read:webhooks.
2978
2847
  * API key: Supported.
2979
2848
  * CLI user token: Supported.
2980
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2849
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2981
2850
  * Higher permission levels include lower levels: read < write < delete.
2982
2851
  */
2983
2852
  async get(webhook_id) {
@@ -2992,7 +2861,7 @@ var EllipsisWebhooks = class {
2992
2861
  * Required permissions: read:webhooks.
2993
2862
  * API key: Supported.
2994
2863
  * CLI user token: Supported.
2995
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2864
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
2996
2865
  * Higher permission levels include lower levels: read < write < delete.
2997
2866
  */
2998
2867
  async list() {
@@ -3012,7 +2881,7 @@ var EllipsisWebhooks = class {
3012
2881
  * Required permissions: write:webhooks.
3013
2882
  * API key: Supported.
3014
2883
  * CLI user token: Supported.
3015
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2884
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
3016
2885
  * Higher permission levels include lower levels: read < write < delete.
3017
2886
  */
3018
2887
  async ping(webhook_id) {
@@ -3031,7 +2900,7 @@ var EllipsisWebhooks = class {
3031
2900
  * Required permissions: write:webhooks.
3032
2901
  * API key: Supported.
3033
2902
  * CLI user token: Supported.
3034
- * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
2903
+ * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
3035
2904
  * Higher permission levels include lower levels: read < write < delete.
3036
2905
  */
3037
2906
  async update(webhook_id, options) {
@@ -3048,7 +2917,6 @@ var Ellipsis = class {
3048
2917
  analytics;
3049
2918
  auth;
3050
2919
  environments;
3051
- files;
3052
2920
  handlers;
3053
2921
  integrations;
3054
2922
  memories;
@@ -3070,7 +2938,6 @@ var Ellipsis = class {
3070
2938
  this.analytics = new EllipsisAnalytics(this.transport);
3071
2939
  this.auth = new EllipsisAuth(this.transport);
3072
2940
  this.environments = new EllipsisEnvironments(this.transport);
3073
- this.files = new EllipsisFiles(this.transport);
3074
2941
  this.handlers = new EllipsisHandlers(this.transport);
3075
2942
  this.integrations = new EllipsisIntegrations(this.transport);
3076
2943
  this.memories = new EllipsisMemories(this.transport);
@@ -3093,7 +2960,7 @@ var Ellipsis = class {
3093
2960
  * Required permissions: read:account.
3094
2961
  * API key: Supported.
3095
2962
  * CLI user token: Supported.
3096
- * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
2963
+ * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
3097
2964
  * Higher permission levels include lower levels: read < write < delete.
3098
2965
  */
3099
2966
  async identity() {
@@ -3114,9 +2981,8 @@ export {
3114
2981
  RateLimitError,
3115
2982
  ServerError,
3116
2983
  SessionHandle,
3117
- TERMINAL_STATUSES,
3118
2984
  Transport,
3119
2985
  TransportError,
3120
2986
  UnprocessableError,
3121
- isSettled
2987
+ isTurnFinal
3122
2988
  };