@maudecode/talaria-web-contracts 1.16.1 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/dist/index.d.ts +1 -0
  2. package/dist/index.js +1 -0
  3. package/dist/index.js.map +1 -1
  4. package/dist/openapi.js +5 -1
  5. package/dist/openapi.js.map +1 -1
  6. package/dist/router.d.ts +4169 -1107
  7. package/dist/routes/automation.d.ts +173 -10
  8. package/dist/routes/automation.js +17 -9
  9. package/dist/routes/automation.js.map +1 -1
  10. package/dist/routes/chat.d.ts +1215 -16
  11. package/dist/routes/chat.js +5 -3
  12. package/dist/routes/chat.js.map +1 -1
  13. package/dist/routes/core.d.ts +11 -0
  14. package/dist/routes/core.js +3 -0
  15. package/dist/routes/core.js.map +1 -1
  16. package/dist/routes/git.d.ts +98 -2
  17. package/dist/routes/git.js +20 -6
  18. package/dist/routes/git.js.map +1 -1
  19. package/dist/routes/raw.d.ts +3 -1
  20. package/dist/routes/raw.js +31 -7
  21. package/dist/routes/raw.js.map +1 -1
  22. package/dist/routes/sessions.d.ts +3080 -539
  23. package/dist/routes/sessions.js +68 -1
  24. package/dist/routes/sessions.js.map +1 -1
  25. package/dist/routes/settings.d.ts +132 -2
  26. package/dist/routes/settings.js +4 -4
  27. package/dist/routes/settings.js.map +1 -1
  28. package/dist/routes/tools.d.ts +425 -19
  29. package/dist/routes/tools.js +23 -4
  30. package/dist/routes/tools.js.map +1 -1
  31. package/dist/routes/workspaces.d.ts +96 -0
  32. package/dist/routes/workspaces.js +18 -1
  33. package/dist/routes/workspaces.js.map +1 -1
  34. package/dist/sidecar/methods.d.ts +253 -0
  35. package/dist/sidecar/methods.js +2 -1
  36. package/dist/sidecar/methods.js.map +1 -1
  37. package/dist/sidecar/namespaces.d.ts +381 -1
  38. package/dist/sidecar/namespaces.js +89 -10
  39. package/dist/sidecar/namespaces.js.map +1 -1
  40. package/dist/sidecar/version.d.ts +1 -1
  41. package/dist/sidecar/version.js +1 -1
  42. package/dist/sidecar/version.js.map +1 -1
  43. package/dist/sse.d.ts +79 -14
  44. package/dist/sse.js +13 -6
  45. package/dist/sse.js.map +1 -1
  46. package/dist/theme.d.ts +10 -0
  47. package/dist/theme.js +10 -0
  48. package/dist/theme.js.map +1 -0
  49. package/dist/views.d.ts +1419 -39
  50. package/dist/views.js +215 -25
  51. package/dist/views.js.map +1 -1
  52. package/fixtures/sidecar/checkpoints.json +50 -0
  53. package/fixtures/sidecar/commands.json +250 -96
  54. package/fixtures/sidecar/cron.json +38 -55
  55. package/fixtures/sidecar/goals.json +6 -6
  56. package/fixtures/sidecar/kanban.json +84 -67
  57. package/fixtures/sidecar/plugins.json +171 -172
  58. package/fixtures/sidecar/process.json +25 -0
  59. package/fixtures/sidecar/profiles.json +10 -2
  60. package/fixtures/sidecar/providers.json +25 -12
  61. package/fixtures/sidecar/rpc.json +17 -0
  62. package/fixtures/sidecar/runtime.json +22 -29
  63. package/fixtures/sidecar/state_db.json +15 -0
  64. package/fixtures/sidecar/text.json +2 -2
  65. package/fixtures/sidecar/usage.json +38 -0
  66. package/package.json +1 -1
@@ -175,6 +175,7 @@ export declare const CommandSchema: z.ZodObject<{
175
175
  subcommands: z.ZodArray<z.ZodString>;
176
176
  cli_only: z.ZodBoolean;
177
177
  gateway_only: z.ZodBoolean;
178
+ exec: z.ZodBoolean;
178
179
  }, z.core.$strip>;
179
180
  /**
180
181
  * A model-provider plugin installed and enabled in the profile (TAL-288); bundled providers are built-ins. `setup` is the Agent's
@@ -193,6 +194,21 @@ export declare const PluginProviderSchema: z.ZodObject<{
193
194
  unavailable: "unavailable";
194
195
  }>;
195
196
  }, z.core.$strip>;
197
+ /** A skill bundle: `/<name>` loads its `skill_count` skills in one message (TAL-265). */
198
+ export declare const CommandBundleSchema: z.ZodObject<{
199
+ name: z.ZodString;
200
+ description: z.ZodString;
201
+ skill_count: z.ZodNumber;
202
+ source: z.ZodLiteral<"bundle">;
203
+ }, z.core.$strip>;
204
+ /** `message` is the user message that loads the bundle's skills; members not installed or disabled are in `missing_skills` or left out. */
205
+ export declare const CommandBundleInvocationSchema: z.ZodObject<{
206
+ name: z.ZodString;
207
+ source: z.ZodLiteral<"bundle">;
208
+ message: z.ZodString;
209
+ loaded_skills: z.ZodArray<z.ZodString>;
210
+ missing_skills: z.ZodArray<z.ZodString>;
211
+ }, z.core.$strip>;
196
212
  export declare const COMMANDS_METHODS: {
197
213
  readonly 'commands.registry': {
198
214
  readonly params: z.ZodObject<{
@@ -208,6 +224,7 @@ export declare const COMMANDS_METHODS: {
208
224
  subcommands: z.ZodArray<z.ZodString>;
209
225
  cli_only: z.ZodBoolean;
210
226
  gateway_only: z.ZodBoolean;
227
+ exec: z.ZodBoolean;
211
228
  }, z.core.$strip>>;
212
229
  }, z.core.$strip>;
213
230
  };
@@ -224,6 +241,32 @@ export declare const COMMANDS_METHODS: {
224
241
  }>;
225
242
  }, z.core.$strip>;
226
243
  };
244
+ readonly 'commands.bundles': {
245
+ readonly params: z.ZodObject<{
246
+ profile_home: z.ZodString;
247
+ }, z.core.$strip>;
248
+ readonly result: z.ZodObject<{
249
+ bundles: z.ZodArray<z.ZodObject<{
250
+ name: z.ZodString;
251
+ description: z.ZodString;
252
+ skill_count: z.ZodNumber;
253
+ source: z.ZodLiteral<"bundle">;
254
+ }, z.core.$strip>>;
255
+ }, z.core.$strip>;
256
+ };
257
+ readonly 'commands.bundle_resolve': {
258
+ readonly params: z.ZodObject<{
259
+ profile_home: z.ZodString;
260
+ command: z.ZodString;
261
+ }, z.core.$strip>;
262
+ readonly result: z.ZodObject<{
263
+ name: z.ZodString;
264
+ source: z.ZodLiteral<"bundle">;
265
+ message: z.ZodString;
266
+ loaded_skills: z.ZodArray<z.ZodString>;
267
+ missing_skills: z.ZodArray<z.ZodString>;
268
+ }, z.core.$strip>;
269
+ };
227
270
  readonly 'commands.moa_preset': {
228
271
  readonly params: z.ZodObject<{
229
272
  profile_home: z.ZodString;
@@ -273,11 +316,14 @@ export declare const COMMANDS_METHODS: {
273
316
  }, z.core.$strip>;
274
317
  };
275
318
  };
319
+ /** `claim_live`: a running task's worker still holds its claim. `has_completion_evidence`: the task stores a result, which the Agent requires to complete it (TAL-557). */
276
320
  export declare const KanbanTaskSchema: z.ZodObject<{
277
321
  id: z.ZodString;
278
322
  title: z.ZodString;
279
323
  status: z.ZodString;
280
324
  priority: z.ZodNumber;
325
+ claim_live: z.ZodBoolean;
326
+ has_completion_evidence: z.ZodBoolean;
281
327
  }, z.core.$catchall<z.ZodUnknown>>;
282
328
  export declare const KanbanBoardSchema: z.ZodUnion<readonly [z.ZodObject<{
283
329
  changed: z.ZodLiteral<false>;
@@ -292,6 +338,8 @@ export declare const KanbanBoardSchema: z.ZodUnion<readonly [z.ZodObject<{
292
338
  title: z.ZodString;
293
339
  status: z.ZodString;
294
340
  priority: z.ZodNumber;
341
+ claim_live: z.ZodBoolean;
342
+ has_completion_evidence: z.ZodBoolean;
295
343
  }, z.core.$catchall<z.ZodUnknown>>>;
296
344
  }, z.core.$strip>>;
297
345
  tenants: z.ZodArray<z.ZodString>;
@@ -349,6 +397,8 @@ export declare const KANBAN_METHODS: {
349
397
  title: z.ZodString;
350
398
  status: z.ZodString;
351
399
  priority: z.ZodNumber;
400
+ claim_live: z.ZodBoolean;
401
+ has_completion_evidence: z.ZodBoolean;
352
402
  }, z.core.$catchall<z.ZodUnknown>>>;
353
403
  }, z.core.$strip>>;
354
404
  tenants: z.ZodArray<z.ZodString>;
@@ -446,6 +496,8 @@ export declare const KANBAN_METHODS: {
446
496
  title: z.ZodString;
447
497
  status: z.ZodString;
448
498
  priority: z.ZodNumber;
499
+ claim_live: z.ZodBoolean;
500
+ has_completion_evidence: z.ZodBoolean;
449
501
  }, z.core.$catchall<z.ZodUnknown>>;
450
502
  comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
451
503
  events: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -469,6 +521,8 @@ export declare const KANBAN_METHODS: {
469
521
  title: z.ZodString;
470
522
  status: z.ZodString;
471
523
  priority: z.ZodNumber;
524
+ claim_live: z.ZodBoolean;
525
+ has_completion_evidence: z.ZodBoolean;
472
526
  }, z.core.$catchall<z.ZodUnknown>>;
473
527
  read_only: z.ZodBoolean;
474
528
  }, z.core.$strip>;
@@ -486,6 +540,8 @@ export declare const KANBAN_METHODS: {
486
540
  title: z.ZodString;
487
541
  status: z.ZodString;
488
542
  priority: z.ZodNumber;
543
+ claim_live: z.ZodBoolean;
544
+ has_completion_evidence: z.ZodBoolean;
489
545
  }, z.core.$catchall<z.ZodUnknown>>;
490
546
  read_only: z.ZodBoolean;
491
547
  }, z.core.$strip>;
@@ -500,6 +556,7 @@ export declare const KANBAN_METHODS: {
500
556
  unblock: "unblock";
501
557
  }>;
502
558
  reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
559
+ confirm_running_exit: z.ZodOptional<z.ZodBoolean>;
503
560
  }, z.core.$strip>;
504
561
  readonly result: z.ZodObject<{
505
562
  task: z.ZodObject<{
@@ -507,6 +564,8 @@ export declare const KANBAN_METHODS: {
507
564
  title: z.ZodString;
508
565
  status: z.ZodString;
509
566
  priority: z.ZodNumber;
567
+ claim_live: z.ZodBoolean;
568
+ has_completion_evidence: z.ZodBoolean;
510
569
  }, z.core.$catchall<z.ZodUnknown>>;
511
570
  read_only: z.ZodBoolean;
512
571
  }, z.core.$strip>;
@@ -693,11 +752,13 @@ export declare const STATE_DB_METHODS: {
693
752
  ok: z.ZodBoolean;
694
753
  }, z.core.$strip>;
695
754
  };
755
+ /** TAL-574: `manual` writes a user-requested title (rename or regenerate) with `user` provenance; otherwise it is an `llm` auto title. */
696
756
  readonly 'state_db.sync_title': {
697
757
  readonly params: z.ZodObject<{
698
758
  profile_home: z.ZodString;
699
759
  session_id: z.ZodString;
700
760
  title: z.ZodString;
761
+ manual: z.ZodOptional<z.ZodBoolean>;
701
762
  }, z.core.$strip>;
702
763
  readonly result: z.ZodObject<{
703
764
  ok: z.ZodBoolean;
@@ -712,7 +773,26 @@ export declare const STATE_DB_METHODS: {
712
773
  ok: z.ZodBoolean;
713
774
  }, z.core.$strip>;
714
775
  };
776
+ /** TAL-258: append one row through the Agent's `SessionDB.append_message` (bumps `message_count`); `ok` is false without a state.db. */
777
+ readonly 'state_db.append_message': {
778
+ readonly params: z.ZodObject<{
779
+ profile_home: z.ZodString;
780
+ session_id: z.ZodString;
781
+ role: z.ZodString;
782
+ content: z.ZodString;
783
+ tool_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
784
+ timestamp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
785
+ }, z.core.$strip>;
786
+ readonly result: z.ZodObject<{
787
+ ok: z.ZodBoolean;
788
+ }, z.core.$strip>;
789
+ };
715
790
  };
791
+ /** TAL-213: the profile's canonical Bot Chat (its session titled exactly "Bot Chat") and that chat's live compression tip. */
792
+ export declare const CanonicalBotChatSchema: z.ZodObject<{
793
+ session_id: z.ZodString;
794
+ tip_session_id: z.ZodString;
795
+ }, z.core.$strip>;
716
796
  export declare const ProfileRowSchema: z.ZodObject<{
717
797
  name: z.ZodString;
718
798
  path: z.ZodString;
@@ -725,6 +805,13 @@ export declare const ProfileRowSchema: z.ZodObject<{
725
805
  skill_count: z.ZodNumber;
726
806
  enabled_skills: z.ZodNumber;
727
807
  total_skills: z.ZodNumber;
808
+ display_name: z.ZodDefault<z.ZodString>;
809
+ description: z.ZodDefault<z.ZodString>;
810
+ has_avatar: z.ZodDefault<z.ZodBoolean>;
811
+ canonical_session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
812
+ session_id: z.ZodString;
813
+ tip_session_id: z.ZodString;
814
+ }, z.core.$strip>>>;
728
815
  }, z.core.$strip>;
729
816
  export declare const PROFILES_METHODS: {
730
817
  readonly 'profiles.list': {
@@ -744,6 +831,13 @@ export declare const PROFILES_METHODS: {
744
831
  skill_count: z.ZodNumber;
745
832
  enabled_skills: z.ZodNumber;
746
833
  total_skills: z.ZodNumber;
834
+ display_name: z.ZodDefault<z.ZodString>;
835
+ description: z.ZodDefault<z.ZodString>;
836
+ has_avatar: z.ZodDefault<z.ZodBoolean>;
837
+ canonical_session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
838
+ session_id: z.ZodString;
839
+ tip_session_id: z.ZodString;
840
+ }, z.core.$strip>>>;
747
841
  }, z.core.$strip>>;
748
842
  }, z.core.$strip>;
749
843
  };
@@ -767,6 +861,13 @@ export declare const PROFILES_METHODS: {
767
861
  skill_count: z.ZodNumber;
768
862
  enabled_skills: z.ZodNumber;
769
863
  total_skills: z.ZodNumber;
864
+ display_name: z.ZodDefault<z.ZodString>;
865
+ description: z.ZodDefault<z.ZodString>;
866
+ has_avatar: z.ZodDefault<z.ZodBoolean>;
867
+ canonical_session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
868
+ session_id: z.ZodString;
869
+ tip_session_id: z.ZodString;
870
+ }, z.core.$strip>>>;
770
871
  }, z.core.$strip>;
771
872
  }, z.core.$strip>;
772
873
  };
@@ -1324,6 +1425,10 @@ export declare const AuxUsageSchema: z.ZodObject<{
1324
1425
  total_tokens: z.ZodOptional<z.ZodNumber>;
1325
1426
  }, z.core.$strip>;
1326
1427
  export declare const AUX_METHODS: {
1428
+ /**
1429
+ * One auxiliary completion. TAL-258: `model` (with `provider`) asks that model itself, reasoning off and no tools, instead
1430
+ * of the task's auxiliary route; `credential_missing` means it has no credential. `finish_reason` is the provider's, when known.
1431
+ */
1327
1432
  readonly 'aux.complete': {
1328
1433
  readonly params: z.ZodObject<{
1329
1434
  profile_home: z.ZodString;
@@ -1333,6 +1438,8 @@ export declare const AUX_METHODS: {
1333
1438
  main_fallback: z.ZodOptional<z.ZodBoolean>;
1334
1439
  max_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1335
1440
  temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1441
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1442
+ provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1336
1443
  }, z.core.$strip>;
1337
1444
  readonly result: z.ZodObject<{
1338
1445
  model: z.ZodString;
@@ -1342,6 +1449,7 @@ export declare const AUX_METHODS: {
1342
1449
  completion_tokens: z.ZodOptional<z.ZodNumber>;
1343
1450
  total_tokens: z.ZodOptional<z.ZodNumber>;
1344
1451
  }, z.core.$strip>>;
1452
+ finish_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
1345
1453
  }, z.core.$strip>;
1346
1454
  readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
1347
1455
  event: z.ZodLiteral<"token">;
@@ -1415,6 +1523,15 @@ export declare const PROCESS_METHODS: {
1415
1523
  }, z.core.$catchall<z.ZodUnknown>>>;
1416
1524
  }, z.core.$strip>;
1417
1525
  };
1526
+ /** TAL-533: re-adopt the base home's and every named profile's checkpointed background processes in a fresh sidecar. */
1527
+ readonly 'process.recover': {
1528
+ readonly params: z.ZodObject<{
1529
+ base_home: z.ZodString;
1530
+ }, z.core.$strip>;
1531
+ readonly result: z.ZodObject<{
1532
+ homes: z.ZodNumber;
1533
+ }, z.core.$strip>;
1534
+ };
1418
1535
  readonly 'process.requeue': {
1419
1536
  readonly params: z.ZodObject<{
1420
1537
  events: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1431,6 +1548,15 @@ export declare const PROCESS_METHODS: {
1431
1548
  ok: z.ZodBoolean;
1432
1549
  }, z.core.$strip>;
1433
1550
  };
1551
+ /** TAL-532: the subset the agent already holds from its own turn (consumed via wait/log, or poll-observed). */
1552
+ readonly 'process.consumed': {
1553
+ readonly params: z.ZodObject<{
1554
+ process_ids: z.ZodArray<z.ZodString>;
1555
+ }, z.core.$strip>;
1556
+ readonly result: z.ZodObject<{
1557
+ consumed: z.ZodArray<z.ZodString>;
1558
+ }, z.core.$strip>;
1559
+ };
1434
1560
  /** TAL-459: the Agent's durable delivery ledger. A null claim means another consumer delivered (or holds) it; "" means nothing durable to acknowledge. */
1435
1561
  readonly 'process.claim_delivery': {
1436
1562
  readonly params: z.ZodObject<{
@@ -1543,6 +1669,62 @@ export declare const AccountUsageSnapshotSchema: z.ZodObject<{
1543
1669
  windows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1544
1670
  details: z.ZodArray<z.ZodUnknown>;
1545
1671
  }, z.core.$catchall<z.ZodUnknown>>;
1672
+ /**
1673
+ * TAL-548: one credential-pool entry's local state (no network, no secrets); the server derives a quota source per entry.
1674
+ * `matches_api_key`: the entry's key is the server-resolved `api_key` passed to `usage.pool`.
1675
+ */
1676
+ export declare const PoolEntrySchema: z.ZodObject<{
1677
+ credential_id: z.ZodString;
1678
+ label: z.ZodString;
1679
+ status: z.ZodEnum<{
1680
+ available: "available";
1681
+ exhausted: "exhausted";
1682
+ dead: "dead";
1683
+ }>;
1684
+ unavailable_reason: z.ZodNullable<z.ZodString>;
1685
+ retry_after: z.ZodNullable<z.ZodString>;
1686
+ matches_api_key: z.ZodBoolean;
1687
+ }, z.core.$strip>;
1688
+ /**
1689
+ * TAL-548: one key-based balance read. The key is the pool entry's (`credential_id`) or the server-resolved `api_key`.
1690
+ * `ok` carries the provider's sanitised fields: OpenRouter `quota`/`label`, DeepSeek `balances`/`is_available`, OpenCode Go
1691
+ * `windows`; `http_error` carries the status code.
1692
+ */
1693
+ export declare const BalanceResultSchema: z.ZodObject<{
1694
+ status: z.ZodEnum<{
1695
+ ok: "ok";
1696
+ unavailable: "unavailable";
1697
+ no_key: "no_key";
1698
+ http_error: "http_error";
1699
+ }>;
1700
+ http_status: z.ZodNullable<z.ZodNumber>;
1701
+ quota: z.ZodNullable<z.ZodObject<{
1702
+ limit_remaining: z.ZodNullable<z.ZodNumber>;
1703
+ usage: z.ZodNullable<z.ZodNumber>;
1704
+ limit: z.ZodNullable<z.ZodNumber>;
1705
+ }, z.core.$strip>>;
1706
+ label: z.ZodNullable<z.ZodString>;
1707
+ is_available: z.ZodNullable<z.ZodBoolean>;
1708
+ balances: z.ZodArray<z.ZodObject<{
1709
+ currency: z.ZodEnum<{
1710
+ CNY: "CNY";
1711
+ USD: "USD";
1712
+ }>;
1713
+ total: z.ZodNumber;
1714
+ granted: z.ZodNullable<z.ZodNumber>;
1715
+ topped_up: z.ZodNullable<z.ZodNumber>;
1716
+ }, z.core.$strip>>;
1717
+ windows: z.ZodArray<z.ZodObject<{
1718
+ key: z.ZodEnum<{
1719
+ rolling: "rolling";
1720
+ weekly: "weekly";
1721
+ monthly: "monthly";
1722
+ }>;
1723
+ used_percent: z.ZodNumber;
1724
+ reset_at: z.ZodString;
1725
+ rate_limited: z.ZodBoolean;
1726
+ }, z.core.$strip>>;
1727
+ }, z.core.$strip>;
1546
1728
  export declare const USAGE_METHODS: {
1547
1729
  readonly 'usage.account': {
1548
1730
  readonly params: z.ZodObject<{
@@ -1550,6 +1732,7 @@ export declare const USAGE_METHODS: {
1550
1732
  provider: z.ZodString;
1551
1733
  base_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1552
1734
  api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1735
+ credential_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1553
1736
  }, z.core.$strip>;
1554
1737
  readonly result: z.ZodObject<{
1555
1738
  snapshot: z.ZodNullable<z.ZodObject<{
@@ -1561,6 +1744,83 @@ export declare const USAGE_METHODS: {
1561
1744
  }, z.core.$catchall<z.ZodUnknown>>>;
1562
1745
  }, z.core.$strip>;
1563
1746
  };
1747
+ readonly 'usage.pool': {
1748
+ readonly params: z.ZodObject<{
1749
+ profile_home: z.ZodString;
1750
+ provider: z.ZodString;
1751
+ api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1752
+ }, z.core.$strip>;
1753
+ readonly result: z.ZodObject<{
1754
+ entries: z.ZodArray<z.ZodObject<{
1755
+ credential_id: z.ZodString;
1756
+ label: z.ZodString;
1757
+ status: z.ZodEnum<{
1758
+ available: "available";
1759
+ exhausted: "exhausted";
1760
+ dead: "dead";
1761
+ }>;
1762
+ unavailable_reason: z.ZodNullable<z.ZodString>;
1763
+ retry_after: z.ZodNullable<z.ZodString>;
1764
+ matches_api_key: z.ZodBoolean;
1765
+ }, z.core.$strip>>;
1766
+ }, z.core.$strip>;
1767
+ };
1768
+ /** TAL-548: the providers whose persisted credential pool holds an account the user added, keyed or not. */
1769
+ readonly 'usage.pool_providers': {
1770
+ readonly params: z.ZodObject<{
1771
+ profile_home: z.ZodString;
1772
+ }, z.core.$strip>;
1773
+ readonly result: z.ZodObject<{
1774
+ providers: z.ZodArray<z.ZodString>;
1775
+ }, z.core.$strip>;
1776
+ };
1777
+ readonly 'usage.balance': {
1778
+ readonly params: z.ZodObject<{
1779
+ profile_home: z.ZodString;
1780
+ provider: z.ZodEnum<{
1781
+ openrouter: "openrouter";
1782
+ deepseek: "deepseek";
1783
+ "opencode-go": "opencode-go";
1784
+ }>;
1785
+ credential_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1786
+ api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1787
+ }, z.core.$strip>;
1788
+ readonly result: z.ZodObject<{
1789
+ status: z.ZodEnum<{
1790
+ ok: "ok";
1791
+ unavailable: "unavailable";
1792
+ no_key: "no_key";
1793
+ http_error: "http_error";
1794
+ }>;
1795
+ http_status: z.ZodNullable<z.ZodNumber>;
1796
+ quota: z.ZodNullable<z.ZodObject<{
1797
+ limit_remaining: z.ZodNullable<z.ZodNumber>;
1798
+ usage: z.ZodNullable<z.ZodNumber>;
1799
+ limit: z.ZodNullable<z.ZodNumber>;
1800
+ }, z.core.$strip>>;
1801
+ label: z.ZodNullable<z.ZodString>;
1802
+ is_available: z.ZodNullable<z.ZodBoolean>;
1803
+ balances: z.ZodArray<z.ZodObject<{
1804
+ currency: z.ZodEnum<{
1805
+ CNY: "CNY";
1806
+ USD: "USD";
1807
+ }>;
1808
+ total: z.ZodNumber;
1809
+ granted: z.ZodNullable<z.ZodNumber>;
1810
+ topped_up: z.ZodNullable<z.ZodNumber>;
1811
+ }, z.core.$strip>>;
1812
+ windows: z.ZodArray<z.ZodObject<{
1813
+ key: z.ZodEnum<{
1814
+ rolling: "rolling";
1815
+ weekly: "weekly";
1816
+ monthly: "monthly";
1817
+ }>;
1818
+ used_percent: z.ZodNumber;
1819
+ reset_at: z.ZodString;
1820
+ rate_limited: z.ZodBoolean;
1821
+ }, z.core.$strip>>;
1822
+ }, z.core.$strip>;
1823
+ };
1564
1824
  };
1565
1825
  export declare const CONFIG_METHODS: {
1566
1826
  readonly 'config.get': {
@@ -1611,6 +1871,58 @@ export declare const WORKTREE_METHODS: {
1611
1871
  }, z.core.$strip>;
1612
1872
  };
1613
1873
  };
1874
+ export declare const AgentCheckpointSchema: z.ZodObject<{
1875
+ hash: z.ZodString;
1876
+ short_hash: z.ZodString;
1877
+ timestamp: z.ZodString;
1878
+ reason: z.ZodString;
1879
+ files_changed: z.ZodNumber;
1880
+ insertions: z.ZodNumber;
1881
+ deletions: z.ZodNumber;
1882
+ }, z.core.$strip>;
1883
+ export declare const CHECKPOINTS_METHODS: {
1884
+ readonly 'checkpoints.list': {
1885
+ readonly params: z.ZodObject<{
1886
+ profile_home: z.ZodString;
1887
+ workspace: z.ZodString;
1888
+ }, z.core.$strip>;
1889
+ readonly result: z.ZodObject<{
1890
+ checkpoints: z.ZodArray<z.ZodObject<{
1891
+ hash: z.ZodString;
1892
+ short_hash: z.ZodString;
1893
+ timestamp: z.ZodString;
1894
+ reason: z.ZodString;
1895
+ files_changed: z.ZodNumber;
1896
+ insertions: z.ZodNumber;
1897
+ deletions: z.ZodNumber;
1898
+ }, z.core.$strip>>;
1899
+ store: z.ZodString;
1900
+ }, z.core.$strip>;
1901
+ };
1902
+ /** `diff` is `git diff <checkpoint> --cached` over the workspace: `a/` is the checkpoint, `b/` the files now. */
1903
+ readonly 'checkpoints.diff': {
1904
+ readonly params: z.ZodObject<{
1905
+ profile_home: z.ZodString;
1906
+ workspace: z.ZodString;
1907
+ checkpoint: z.ZodString;
1908
+ }, z.core.$strip>;
1909
+ readonly result: z.ZodObject<{
1910
+ stat: z.ZodString;
1911
+ diff: z.ZodString;
1912
+ }, z.core.$strip>;
1913
+ };
1914
+ readonly 'checkpoints.restore': {
1915
+ readonly params: z.ZodObject<{
1916
+ profile_home: z.ZodString;
1917
+ workspace: z.ZodString;
1918
+ checkpoint: z.ZodString;
1919
+ }, z.core.$strip>;
1920
+ readonly result: z.ZodObject<{
1921
+ restored_to: z.ZodString;
1922
+ reason: z.ZodString;
1923
+ }, z.core.$strip>;
1924
+ };
1925
+ };
1614
1926
  export declare const ChatUsageSchema: z.ZodObject<{
1615
1927
  prompt_tokens: z.ZodNumber;
1616
1928
  completion_tokens: z.ZodNumber;
@@ -1618,7 +1930,13 @@ export declare const ChatUsageSchema: z.ZodObject<{
1618
1930
  cache_write_tokens: z.ZodNumber;
1619
1931
  estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
1620
1932
  }, z.core.$strip>;
1621
- /** `failed`, `partial`, and `compression_exhausted` are the Agent's own turn-result flags, forwarded as sent; `failed` also sets `status: 'error'`. */
1933
+ /**
1934
+ * `failed`, `partial`, and `compression_exhausted` are the Agent's own turn-result flags, forwarded as sent; `failed` also sets `status: 'error'`.
1935
+ * `max_iterations_summary_request` is the Agent's text for the user row it appends to ask for a summary once its tool budget runs out
1936
+ * (`tool_limit_reached`); the server drops that trailing row of an exhausted turn from the transcript and the model context (TAL-537).
1937
+ * A completed `compressed` turn also carries `context_messages`, its `messages` with tool output pruned and capped for the model (row for row),
1938
+ * and `post_compression_context_tokens_estimate`, the next request's estimated size (TAL-539); both are null otherwise.
1939
+ */
1622
1940
  export declare const ChatStartResultSchema: z.ZodObject<{
1623
1941
  status: z.ZodEnum<{
1624
1942
  error: "error";
@@ -1626,12 +1944,15 @@ export declare const ChatStartResultSchema: z.ZodObject<{
1626
1944
  completed: "completed";
1627
1945
  }>;
1628
1946
  messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1947
+ context_messages: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
1948
+ post_compression_context_tokens_estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1629
1949
  final_response: z.ZodString;
1630
1950
  error: z.ZodNullable<z.ZodString>;
1631
1951
  failed: z.ZodBoolean;
1632
1952
  partial: z.ZodBoolean;
1633
1953
  compression_exhausted: z.ZodBoolean;
1634
1954
  tool_limit_reached: z.ZodBoolean;
1955
+ max_iterations_summary_request: z.ZodString;
1635
1956
  usage: z.ZodObject<{
1636
1957
  prompt_tokens: z.ZodNumber;
1637
1958
  completion_tokens: z.ZodNumber;
@@ -1668,6 +1989,15 @@ export declare const ChatStreamSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1668
1989
  data: z.ZodObject<{
1669
1990
  text: z.ZodString;
1670
1991
  }, z.core.$catchall<z.ZodUnknown>>;
1992
+ }, z.core.$strip>, z.ZodObject<{
1993
+ event: z.ZodLiteral<"usage">;
1994
+ data: z.ZodObject<{
1995
+ prompt_tokens: z.ZodNumber;
1996
+ completion_tokens: z.ZodNumber;
1997
+ cache_read_tokens: z.ZodNumber;
1998
+ cache_write_tokens: z.ZodNumber;
1999
+ estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
2000
+ }, z.core.$strip>;
1671
2001
  }, z.core.$strip>, z.ZodObject<{
1672
2002
  event: z.ZodLiteral<"tool">;
1673
2003
  data: z.ZodObject<{
@@ -1735,6 +2065,8 @@ export declare const CHAT_METHODS: {
1735
2065
  effort: z.ZodOptional<z.ZodString>;
1736
2066
  }, z.core.$strip>>>;
1737
2067
  ephemeral_system_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2068
+ persist_user_message: z.ZodOptional<z.ZodString>;
2069
+ ephemeral: z.ZodOptional<z.ZodBoolean>;
1738
2070
  }, z.core.$strip>;
1739
2071
  readonly result: z.ZodObject<{
1740
2072
  status: z.ZodEnum<{
@@ -1743,12 +2075,15 @@ export declare const CHAT_METHODS: {
1743
2075
  completed: "completed";
1744
2076
  }>;
1745
2077
  messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2078
+ context_messages: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
2079
+ post_compression_context_tokens_estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1746
2080
  final_response: z.ZodString;
1747
2081
  error: z.ZodNullable<z.ZodString>;
1748
2082
  failed: z.ZodBoolean;
1749
2083
  partial: z.ZodBoolean;
1750
2084
  compression_exhausted: z.ZodBoolean;
1751
2085
  tool_limit_reached: z.ZodBoolean;
2086
+ max_iterations_summary_request: z.ZodString;
1752
2087
  usage: z.ZodObject<{
1753
2088
  prompt_tokens: z.ZodNumber;
1754
2089
  completion_tokens: z.ZodNumber;
@@ -1785,6 +2120,15 @@ export declare const CHAT_METHODS: {
1785
2120
  data: z.ZodObject<{
1786
2121
  text: z.ZodString;
1787
2122
  }, z.core.$catchall<z.ZodUnknown>>;
2123
+ }, z.core.$strip>, z.ZodObject<{
2124
+ event: z.ZodLiteral<"usage">;
2125
+ data: z.ZodObject<{
2126
+ prompt_tokens: z.ZodNumber;
2127
+ completion_tokens: z.ZodNumber;
2128
+ cache_read_tokens: z.ZodNumber;
2129
+ cache_write_tokens: z.ZodNumber;
2130
+ estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
2131
+ }, z.core.$strip>;
1788
2132
  }, z.core.$strip>, z.ZodObject<{
1789
2133
  event: z.ZodLiteral<"tool">;
1790
2134
  data: z.ZodObject<{
@@ -1954,6 +2298,7 @@ export declare const CHAT_METHODS: {
1954
2298
  };
1955
2299
  readonly 'chat.commit_memory': {
1956
2300
  readonly params: z.ZodObject<{
2301
+ profile_home: z.ZodString;
1957
2302
  session_id: z.ZodString;
1958
2303
  }, z.core.$strip>;
1959
2304
  readonly result: z.ZodObject<{
@@ -2009,7 +2354,41 @@ export declare const CHAT_METHODS: {
2009
2354
  }, z.core.$strip>;
2010
2355
  };
2011
2356
  };
2357
+ export declare const GATEWAY_ACTIONS: readonly ["start", "stop", "restart"];
2012
2358
  export declare const GATEWAY_METHODS: {
2359
+ readonly 'gateway.control': {
2360
+ readonly params: z.ZodObject<{
2361
+ profile_home: z.ZodString;
2362
+ cli_profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2363
+ quick_timeout_seconds: z.ZodOptional<z.ZodNumber>;
2364
+ background_wait_seconds: z.ZodOptional<z.ZodNumber>;
2365
+ action: z.ZodEnum<{
2366
+ start: "start";
2367
+ stop: "stop";
2368
+ restart: "restart";
2369
+ }>;
2370
+ }, z.core.$strip>;
2371
+ readonly result: z.ZodObject<{
2372
+ status: z.ZodEnum<{
2373
+ completed: "completed";
2374
+ failed: "failed";
2375
+ busy: "busy";
2376
+ }>;
2377
+ message: z.ZodString;
2378
+ detail: z.ZodOptional<z.ZodString>;
2379
+ returncode: z.ZodOptional<z.ZodNumber>;
2380
+ timed_out: z.ZodOptional<z.ZodBoolean>;
2381
+ }, z.core.$strip>;
2382
+ readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
2383
+ event: z.ZodLiteral<"progress">;
2384
+ data: z.ZodObject<{
2385
+ phase: z.ZodEnum<{
2386
+ started: "started";
2387
+ draining: "draining";
2388
+ }>;
2389
+ }, z.core.$strip>;
2390
+ }, z.core.$strip>], "event">;
2391
+ };
2013
2392
  readonly 'gateway.restart': {
2014
2393
  readonly params: z.ZodObject<{
2015
2394
  profile_home: z.ZodString;
@@ -2026,6 +2405,7 @@ export declare const GATEWAY_METHODS: {
2026
2405
  message: z.ZodString;
2027
2406
  detail: z.ZodOptional<z.ZodString>;
2028
2407
  returncode: z.ZodOptional<z.ZodNumber>;
2408
+ timed_out: z.ZodOptional<z.ZodBoolean>;
2029
2409
  }, z.core.$strip>;
2030
2410
  readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
2031
2411
  event: z.ZodLiteral<"progress">;