@maudecode/talaria-web-contracts 1.18.0 → 1.19.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 (82) hide show
  1. package/dist/gateway-session.d.ts +229 -0
  2. package/dist/gateway-session.js +46 -0
  3. package/dist/gateway-session.js.map +1 -0
  4. package/dist/index.d.ts +3 -0
  5. package/dist/index.js +3 -0
  6. package/dist/index.js.map +1 -1
  7. package/dist/openapi.js +4 -0
  8. package/dist/openapi.js.map +1 -1
  9. package/dist/router.d.ts +4265 -220
  10. package/dist/routes/automation.d.ts +104 -24
  11. package/dist/routes/automation.js +6 -3
  12. package/dist/routes/automation.js.map +1 -1
  13. package/dist/routes/chat.d.ts +1338 -43
  14. package/dist/routes/chat.js +5 -1
  15. package/dist/routes/chat.js.map +1 -1
  16. package/dist/routes/core.d.ts +17 -6
  17. package/dist/routes/core.js +2 -2
  18. package/dist/routes/core.js.map +1 -1
  19. package/dist/routes/raw.js +1 -1
  20. package/dist/routes/raw.js.map +1 -1
  21. package/dist/routes/sessions.d.ts +2367 -156
  22. package/dist/routes/sessions.js +18 -7
  23. package/dist/routes/sessions.js.map +1 -1
  24. package/dist/routes/settings.d.ts +427 -9
  25. package/dist/routes/settings.js +2 -2
  26. package/dist/routes/settings.js.map +1 -1
  27. package/dist/routes/tools.d.ts +645 -18
  28. package/dist/routes/tools.js +65 -8
  29. package/dist/routes/tools.js.map +1 -1
  30. package/dist/run-status.d.ts +39 -0
  31. package/dist/run-status.js +13 -0
  32. package/dist/run-status.js.map +1 -0
  33. package/dist/sidecar/methods.d.ts +1074 -17
  34. package/dist/sidecar/methods.js +9 -2
  35. package/dist/sidecar/methods.js.map +1 -1
  36. package/dist/sidecar/namespaces.d.ts +1469 -33
  37. package/dist/sidecar/namespaces.js +298 -31
  38. package/dist/sidecar/namespaces.js.map +1 -1
  39. package/dist/sidecar/runtime.d.ts +61 -0
  40. package/dist/sidecar/runtime.js +20 -0
  41. package/dist/sidecar/runtime.js.map +1 -1
  42. package/dist/sidecar/version.d.ts +1 -1
  43. package/dist/sidecar/version.js +1 -1
  44. package/dist/speed.d.ts +14 -0
  45. package/dist/speed.js +6 -0
  46. package/dist/speed.js.map +1 -0
  47. package/dist/sse.d.ts +797 -5
  48. package/dist/sse.js +24 -7
  49. package/dist/sse.js.map +1 -1
  50. package/dist/transcribe-stream.d.ts +34 -0
  51. package/dist/transcribe-stream.js +23 -0
  52. package/dist/transcribe-stream.js.map +1 -0
  53. package/dist/views.d.ts +2097 -127
  54. package/dist/views.js +273 -47
  55. package/dist/views.js.map +1 -1
  56. package/fixtures/sidecar/aux.json +134 -0
  57. package/fixtures/sidecar/chat.json +14 -0
  58. package/fixtures/sidecar/checkpoints.json +6 -6
  59. package/fixtures/sidecar/commands.json +216 -108
  60. package/fixtures/sidecar/config.json +15 -0
  61. package/fixtures/sidecar/connectors.json +218 -0
  62. package/fixtures/sidecar/cron.json +1001 -31
  63. package/fixtures/sidecar/gateway.json +39 -0
  64. package/fixtures/sidecar/goals.json +5 -3
  65. package/fixtures/sidecar/kanban.json +139 -49
  66. package/fixtures/sidecar/memory.json +50 -0
  67. package/fixtures/sidecar/models.json +122 -0
  68. package/fixtures/sidecar/personalities.json +92 -0
  69. package/fixtures/sidecar/plugins.json +116 -27
  70. package/fixtures/sidecar/process.json +31 -0
  71. package/fixtures/sidecar/profiles.json +2 -0
  72. package/fixtures/sidecar/providers.json +14 -1
  73. package/fixtures/sidecar/rpc.json +35 -1
  74. package/fixtures/sidecar/runtime.json +130 -14
  75. package/fixtures/sidecar/skills.json +256 -13
  76. package/fixtures/sidecar/state_db.json +19 -2
  77. package/fixtures/sidecar/stt.json +62 -1
  78. package/fixtures/sidecar/text.json +20 -2
  79. package/fixtures/sidecar/toolsets.json +468 -0
  80. package/fixtures/sidecar/usage.json +22 -2
  81. package/fixtures/sidecar/write_approval.json +98 -0
  82. package/package.json +1 -1
@@ -1,4 +1,12 @@
1
1
  import { z } from 'zod';
2
+ /** Warnings and wording come from the Agent's selection guard registry, including future guard kinds. */
3
+ export declare const ModelSelectionWarningSchema: z.ZodObject<{
4
+ kind: z.ZodString;
5
+ title: z.ZodString;
6
+ model: z.ZodString;
7
+ provider: z.ZodString;
8
+ message: z.ZodString;
9
+ }, z.core.$strip>;
2
10
  /** Shared param shapes. */
3
11
  export declare const ProfileHomeParams: z.ZodObject<{
4
12
  profile_home: z.ZodString;
@@ -6,6 +14,43 @@ export declare const ProfileHomeParams: z.ZodObject<{
6
14
  export declare const BaseHomeParams: z.ZodObject<{
7
15
  base_home: z.ZodString;
8
16
  }, z.core.$strip>;
17
+ /** Profile-scoped toolset choices; clients render policy and selection without deriving them. */
18
+ export declare const ToolsetsCatalogSchema: z.ZodObject<{
19
+ toolsets: z.ZodArray<z.ZodObject<{
20
+ name: z.ZodString;
21
+ description: z.ZodString;
22
+ available: z.ZodBoolean;
23
+ selected: z.ZodBoolean;
24
+ unavailable_reason: z.ZodNullable<z.ZodEnum<{
25
+ unavailable: "unavailable";
26
+ disabled: "disabled";
27
+ }>>;
28
+ }, z.core.$strip>>;
29
+ selected_toolsets: z.ZodArray<z.ZodString>;
30
+ using_defaults: z.ZodBoolean;
31
+ }, z.core.$strip>;
32
+ export declare const TOOLSETS_METHODS: {
33
+ readonly 'toolsets.catalog': {
34
+ readonly params: z.ZodObject<{
35
+ profile_home: z.ZodString;
36
+ enabled_toolsets: z.ZodNullable<z.ZodArray<z.ZodString>>;
37
+ }, z.core.$strip>;
38
+ readonly result: z.ZodObject<{
39
+ toolsets: z.ZodArray<z.ZodObject<{
40
+ name: z.ZodString;
41
+ description: z.ZodString;
42
+ available: z.ZodBoolean;
43
+ selected: z.ZodBoolean;
44
+ unavailable_reason: z.ZodNullable<z.ZodEnum<{
45
+ unavailable: "unavailable";
46
+ disabled: "disabled";
47
+ }>>;
48
+ }, z.core.$strip>>;
49
+ selected_toolsets: z.ZodArray<z.ZodString>;
50
+ using_defaults: z.ZodBoolean;
51
+ }, z.core.$strip>;
52
+ };
53
+ };
9
54
  export declare const GoalStateSchema: z.ZodObject<{
10
55
  goal: z.ZodString;
11
56
  status: z.ZodString;
@@ -15,6 +60,11 @@ export declare const GoalStateSchema: z.ZodObject<{
15
60
  last_reason: z.ZodNullable<z.ZodString>;
16
61
  paused_reason: z.ZodNullable<z.ZodString>;
17
62
  }, z.core.$strip>;
63
+ /** TAL-808: `parked` is an active goal's live wait barrier: its reason and, for a timed wait, the Unix-seconds deadline. */
64
+ export declare const GoalParkedSchema: z.ZodObject<{
65
+ reason: z.ZodNullable<z.ZodString>;
66
+ until: z.ZodNullable<z.ZodNumber>;
67
+ }, z.core.$strip>;
18
68
  export declare const GoalStatusSchema: z.ZodObject<{
19
69
  goal: z.ZodNullable<z.ZodObject<{
20
70
  goal: z.ZodString;
@@ -26,6 +76,10 @@ export declare const GoalStatusSchema: z.ZodObject<{
26
76
  paused_reason: z.ZodNullable<z.ZodString>;
27
77
  }, z.core.$strip>>;
28
78
  active: z.ZodBoolean;
79
+ parked: z.ZodNullable<z.ZodObject<{
80
+ reason: z.ZodNullable<z.ZodString>;
81
+ until: z.ZodNullable<z.ZodNumber>;
82
+ }, z.core.$strip>>;
29
83
  message: z.ZodString;
30
84
  message_key: z.ZodOptional<z.ZodString>;
31
85
  message_args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
@@ -76,6 +130,10 @@ export declare const GOALS_METHODS: {
76
130
  paused_reason: z.ZodNullable<z.ZodString>;
77
131
  }, z.core.$strip>>;
78
132
  active: z.ZodBoolean;
133
+ parked: z.ZodNullable<z.ZodObject<{
134
+ reason: z.ZodNullable<z.ZodString>;
135
+ until: z.ZodNullable<z.ZodNumber>;
136
+ }, z.core.$strip>>;
79
137
  message: z.ZodString;
80
138
  message_key: z.ZodOptional<z.ZodString>;
81
139
  message_args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
@@ -88,6 +146,7 @@ export declare const GOALS_METHODS: {
88
146
  default_max_turns: z.ZodOptional<z.ZodNumber>;
89
147
  args: z.ZodString;
90
148
  stream_running: z.ZodOptional<z.ZodBoolean>;
149
+ workspace: z.ZodOptional<z.ZodString>;
91
150
  }, z.core.$strip>;
92
151
  readonly result: z.ZodObject<{
93
152
  ok: z.ZodBoolean;
@@ -153,6 +212,7 @@ export declare const GOALS_METHODS: {
153
212
  default_max_turns: z.ZodOptional<z.ZodNumber>;
154
213
  last_response: z.ZodString;
155
214
  user_initiated: z.ZodOptional<z.ZodBoolean>;
215
+ workspace: z.ZodOptional<z.ZodString>;
156
216
  }, z.core.$strip>;
157
217
  readonly result: z.ZodObject<{
158
218
  status: z.ZodNullable<z.ZodString>;
@@ -176,22 +236,50 @@ export declare const CommandSchema: z.ZodObject<{
176
236
  cli_only: z.ZodBoolean;
177
237
  gateway_only: z.ZodBoolean;
178
238
  exec: z.ZodBoolean;
239
+ prompt: z.ZodNullable<z.ZodEnum<{
240
+ expand: "expand";
241
+ unsupported: "unsupported";
242
+ }>>;
179
243
  }, z.core.$strip>;
180
244
  /**
181
245
  * A model-provider plugin installed and enabled in the profile (TAL-288); bundled providers are built-ins. `setup` is the Agent's
182
246
  * own verdict without spawning the plugin's CLI: `not_loaded` means the installed plugin could not be loaded (import failure, or its
183
247
  * provider id or directory name is taken by another profile's plugin in this process-wide registry).
184
248
  */
249
+ /**
250
+ * TAL-806: one field of a plugin manifest's `config_schema` (Agent `plugin_settings_fields`) with its current value from
251
+ * `plugins.entries.<key>.settings`, else `default`. A `secret` field carries its `.env` name and `has_value`, never a value.
252
+ */
253
+ export declare const PluginSettingFieldSchema: z.ZodObject<{
254
+ key: z.ZodString;
255
+ type: z.ZodEnum<{
256
+ string: "string";
257
+ number: "number";
258
+ boolean: "boolean";
259
+ enum: "enum";
260
+ json: "json";
261
+ secret: "secret";
262
+ }>;
263
+ label: z.ZodString;
264
+ description: z.ZodString;
265
+ required: z.ZodBoolean;
266
+ choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
267
+ default: z.ZodOptional<z.ZodUnknown>;
268
+ value: z.ZodOptional<z.ZodUnknown>;
269
+ env: z.ZodOptional<z.ZodString>;
270
+ has_value: z.ZodOptional<z.ZodBoolean>;
271
+ }, z.core.$strip>;
272
+ export type PluginSettingField = z.infer<typeof PluginSettingFieldSchema>;
185
273
  export declare const PluginProviderSchema: z.ZodObject<{
186
274
  name: z.ZodString;
187
275
  display_name: z.ZodString;
188
276
  auth_type: z.ZodString;
189
277
  setup: z.ZodEnum<{
278
+ unavailable: "unavailable";
190
279
  ready: "ready";
191
280
  missing_cli: "missing_cli";
192
281
  needs_setup: "needs_setup";
193
282
  not_loaded: "not_loaded";
194
- unavailable: "unavailable";
195
283
  }>;
196
284
  }, z.core.$strip>;
197
285
  /** A skill bundle: `/<name>` loads its `skill_count` skills in one message (TAL-265). */
@@ -225,13 +313,20 @@ export declare const COMMANDS_METHODS: {
225
313
  cli_only: z.ZodBoolean;
226
314
  gateway_only: z.ZodBoolean;
227
315
  exec: z.ZodBoolean;
316
+ prompt: z.ZodNullable<z.ZodEnum<{
317
+ expand: "expand";
318
+ unsupported: "unsupported";
319
+ }>>;
228
320
  }, z.core.$strip>>;
229
321
  }, z.core.$strip>;
230
322
  };
323
+ /** With `session_id`, a plugin command runs under that chat's session binding and `workspace` (TAL-904). */
231
324
  readonly 'commands.exec': {
232
325
  readonly params: z.ZodObject<{
233
326
  profile_home: z.ZodString;
234
327
  command: z.ZodString;
328
+ session_id: z.ZodOptional<z.ZodString>;
329
+ workspace: z.ZodOptional<z.ZodString>;
235
330
  }, z.core.$strip>;
236
331
  readonly result: z.ZodObject<{
237
332
  output: z.ZodString;
@@ -241,6 +336,23 @@ export declare const COMMANDS_METHODS: {
241
336
  }>;
242
337
  }, z.core.$strip>;
243
338
  };
339
+ /**
340
+ * `/<prompt built-in> [args]` as the turn text (`message`) the Agent's builder writes for the session's profile, workspace and toolsets.
341
+ * `name` is the built-in's canonical name, null when the command is not one; `message` is null when this Agent has no builder for it.
342
+ * A failing builder errors `prompt_expand_failed`.
343
+ */
344
+ readonly 'commands.expand_prompt': {
345
+ readonly params: z.ZodObject<{
346
+ profile_home: z.ZodString;
347
+ command: z.ZodString;
348
+ workspace: z.ZodString;
349
+ enabled_toolsets: z.ZodNullable<z.ZodArray<z.ZodString>>;
350
+ }, z.core.$strip>;
351
+ readonly result: z.ZodObject<{
352
+ name: z.ZodNullable<z.ZodString>;
353
+ message: z.ZodNullable<z.ZodString>;
354
+ }, z.core.$strip>;
355
+ };
244
356
  readonly 'commands.bundles': {
245
357
  readonly params: z.ZodObject<{
246
358
  profile_home: z.ZodString;
@@ -286,11 +398,11 @@ export declare const COMMANDS_METHODS: {
286
398
  display_name: z.ZodString;
287
399
  auth_type: z.ZodString;
288
400
  setup: z.ZodEnum<{
401
+ unavailable: "unavailable";
289
402
  ready: "ready";
290
403
  missing_cli: "missing_cli";
291
404
  needs_setup: "needs_setup";
292
405
  not_loaded: "not_loaded";
293
- unavailable: "unavailable";
294
406
  }>;
295
407
  }, z.core.$strip>>;
296
408
  }, z.core.$strip>;
@@ -315,8 +427,93 @@ export declare const COMMANDS_METHODS: {
315
427
  supported_hooks: z.ZodArray<z.ZodString>;
316
428
  }, z.core.$strip>;
317
429
  };
430
+ /** TAL-820: each profile's `plugins.isolation` and installed third-party plugin count, read without loading a plugin. */
431
+ readonly 'plugins.isolation': {
432
+ readonly params: z.ZodObject<{
433
+ base_home: z.ZodString;
434
+ }, z.core.$strip>;
435
+ readonly result: z.ZodObject<{
436
+ profiles: z.ZodArray<z.ZodObject<{
437
+ name: z.ZodString;
438
+ isolation: z.ZodEnum<{
439
+ in_process: "in_process";
440
+ host: "host";
441
+ }>;
442
+ third_party_plugins: z.ZodNumber;
443
+ }, z.core.$strip>>;
444
+ }, z.core.$strip>;
445
+ };
446
+ /** TAL-806: plugins whose manifest declares settings; `supported` is false on an Agent without `hermes_cli.plugins_settings`. */
447
+ readonly 'plugins.settings': {
448
+ readonly params: z.ZodObject<{
449
+ profile_home: z.ZodString;
450
+ }, z.core.$strip>;
451
+ readonly result: z.ZodObject<{
452
+ supported: z.ZodBoolean;
453
+ plugins: z.ZodArray<z.ZodObject<{
454
+ key: z.ZodString;
455
+ fields: z.ZodArray<z.ZodObject<{
456
+ key: z.ZodString;
457
+ type: z.ZodEnum<{
458
+ string: "string";
459
+ number: "number";
460
+ boolean: "boolean";
461
+ enum: "enum";
462
+ json: "json";
463
+ secret: "secret";
464
+ }>;
465
+ label: z.ZodString;
466
+ description: z.ZodString;
467
+ required: z.ZodBoolean;
468
+ choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
469
+ default: z.ZodOptional<z.ZodUnknown>;
470
+ value: z.ZodOptional<z.ZodUnknown>;
471
+ env: z.ZodOptional<z.ZodString>;
472
+ has_value: z.ZodOptional<z.ZodBoolean>;
473
+ }, z.core.$strip>>;
474
+ }, z.core.$strip>>;
475
+ }, z.core.$strip>;
476
+ };
477
+ /**
478
+ * TAL-806: write non-secret `values` through the Agent's locked plugin-state writer and return the refreshed fields.
479
+ * An undeclared key, a secret or a type mismatch is invalid params; a managed install or key errors `plugin_settings_managed`.
480
+ * `secret_envs` (secret key → `.env` name the caller wrote) is checked against the current manifest before anything is
481
+ * written; a key that is no longer a secret stored under that name errors `plugin_settings_changed`.
482
+ */
483
+ readonly 'plugins.settings_save': {
484
+ readonly params: z.ZodObject<{
485
+ profile_home: z.ZodString;
486
+ key: z.ZodString;
487
+ values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
488
+ secret_envs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
489
+ }, z.core.$strip>;
490
+ readonly result: z.ZodObject<{
491
+ key: z.ZodString;
492
+ written: z.ZodArray<z.ZodString>;
493
+ fields: z.ZodArray<z.ZodObject<{
494
+ key: z.ZodString;
495
+ type: z.ZodEnum<{
496
+ string: "string";
497
+ number: "number";
498
+ boolean: "boolean";
499
+ enum: "enum";
500
+ json: "json";
501
+ secret: "secret";
502
+ }>;
503
+ label: z.ZodString;
504
+ description: z.ZodString;
505
+ required: z.ZodBoolean;
506
+ choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
507
+ default: z.ZodOptional<z.ZodUnknown>;
508
+ value: z.ZodOptional<z.ZodUnknown>;
509
+ env: z.ZodOptional<z.ZodString>;
510
+ has_value: z.ZodOptional<z.ZodBoolean>;
511
+ }, z.core.$strip>>;
512
+ }, z.core.$strip>;
513
+ };
318
514
  };
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). */
515
+ /** `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).
516
+ * `agent_move_targets`: the Agent workflow's manual moves from the task's status, `null` before Agent 0.21.6 (TAL-796). */
320
517
  export declare const KanbanTaskSchema: z.ZodObject<{
321
518
  id: z.ZodString;
322
519
  title: z.ZodString;
@@ -324,7 +521,23 @@ export declare const KanbanTaskSchema: z.ZodObject<{
324
521
  priority: z.ZodNumber;
325
522
  claim_live: z.ZodBoolean;
326
523
  has_completion_evidence: z.ZodBoolean;
524
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
327
525
  }, z.core.$catchall<z.ZodUnknown>>;
526
+ /** Task detail's links (TAL-809): `link_tasks` names each linked task that still exists; `current_run_started_at` is the active run's start, `null` without one (`started_at` is the first-ever start). */
527
+ export declare const KanbanTaskLinksShape: {
528
+ links: z.ZodObject<{
529
+ parents: z.ZodArray<z.ZodString>;
530
+ children: z.ZodArray<z.ZodString>;
531
+ }, z.core.$strip>;
532
+ link_tasks: z.ZodArray<z.ZodObject<{
533
+ id: z.ZodString;
534
+ title: z.ZodString;
535
+ status: z.ZodString;
536
+ }, z.core.$strip>>;
537
+ };
538
+ export declare const KanbanRunStartShape: {
539
+ current_run_started_at: z.ZodNullable<z.ZodNumber>;
540
+ };
328
541
  export declare const KanbanBoardSchema: z.ZodUnion<readonly [z.ZodObject<{
329
542
  changed: z.ZodLiteral<false>;
330
543
  latest_event_id: z.ZodNumber;
@@ -333,6 +546,7 @@ export declare const KanbanBoardSchema: z.ZodUnion<readonly [z.ZodObject<{
333
546
  changed: z.ZodLiteral<true>;
334
547
  columns: z.ZodArray<z.ZodObject<{
335
548
  name: z.ZodString;
549
+ label: z.ZodString;
336
550
  tasks: z.ZodArray<z.ZodObject<{
337
551
  id: z.ZodString;
338
552
  title: z.ZodString;
@@ -340,6 +554,7 @@ export declare const KanbanBoardSchema: z.ZodUnion<readonly [z.ZodObject<{
340
554
  priority: z.ZodNumber;
341
555
  claim_live: z.ZodBoolean;
342
556
  has_completion_evidence: z.ZodBoolean;
557
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
343
558
  }, z.core.$catchall<z.ZodUnknown>>>;
344
559
  }, z.core.$strip>>;
345
560
  tenants: z.ZodArray<z.ZodString>;
@@ -392,6 +607,7 @@ export declare const KANBAN_METHODS: {
392
607
  changed: z.ZodLiteral<true>;
393
608
  columns: z.ZodArray<z.ZodObject<{
394
609
  name: z.ZodString;
610
+ label: z.ZodString;
395
611
  tasks: z.ZodArray<z.ZodObject<{
396
612
  id: z.ZodString;
397
613
  title: z.ZodString;
@@ -399,6 +615,7 @@ export declare const KANBAN_METHODS: {
399
615
  priority: z.ZodNumber;
400
616
  claim_live: z.ZodBoolean;
401
617
  has_completion_evidence: z.ZodBoolean;
618
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
402
619
  }, z.core.$catchall<z.ZodUnknown>>>;
403
620
  }, z.core.$strip>>;
404
621
  tenants: z.ZodArray<z.ZodString>;
@@ -491,6 +708,17 @@ export declare const KANBAN_METHODS: {
491
708
  task_id: z.ZodString;
492
709
  }, z.core.$strip>;
493
710
  readonly result: z.ZodObject<{
711
+ runs: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
712
+ read_only: z.ZodBoolean;
713
+ links: z.ZodObject<{
714
+ parents: z.ZodArray<z.ZodString>;
715
+ children: z.ZodArray<z.ZodString>;
716
+ }, z.core.$strip>;
717
+ link_tasks: z.ZodArray<z.ZodObject<{
718
+ id: z.ZodString;
719
+ title: z.ZodString;
720
+ status: z.ZodString;
721
+ }, z.core.$strip>>;
494
722
  task: z.ZodObject<{
495
723
  id: z.ZodString;
496
724
  title: z.ZodString;
@@ -498,15 +726,11 @@ export declare const KANBAN_METHODS: {
498
726
  priority: z.ZodNumber;
499
727
  claim_live: z.ZodBoolean;
500
728
  has_completion_evidence: z.ZodBoolean;
729
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
730
+ current_run_started_at: z.ZodNullable<z.ZodNumber>;
501
731
  }, z.core.$catchall<z.ZodUnknown>>;
502
732
  comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
503
733
  events: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
504
- links: z.ZodObject<{
505
- parents: z.ZodArray<z.ZodString>;
506
- children: z.ZodArray<z.ZodString>;
507
- }, z.core.$strip>;
508
- runs: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
509
- read_only: z.ZodBoolean;
510
734
  }, z.core.$strip>;
511
735
  };
512
736
  readonly 'kanban.create_task': {
@@ -523,6 +747,7 @@ export declare const KANBAN_METHODS: {
523
747
  priority: z.ZodNumber;
524
748
  claim_live: z.ZodBoolean;
525
749
  has_completion_evidence: z.ZodBoolean;
750
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
526
751
  }, z.core.$catchall<z.ZodUnknown>>;
527
752
  read_only: z.ZodBoolean;
528
753
  }, z.core.$strip>;
@@ -542,6 +767,7 @@ export declare const KANBAN_METHODS: {
542
767
  priority: z.ZodNumber;
543
768
  claim_live: z.ZodBoolean;
544
769
  has_completion_evidence: z.ZodBoolean;
770
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
545
771
  }, z.core.$catchall<z.ZodUnknown>>;
546
772
  read_only: z.ZodBoolean;
547
773
  }, z.core.$strip>;
@@ -566,6 +792,7 @@ export declare const KANBAN_METHODS: {
566
792
  priority: z.ZodNumber;
567
793
  claim_live: z.ZodBoolean;
568
794
  has_completion_evidence: z.ZodBoolean;
795
+ agent_move_targets: z.ZodNullable<z.ZodArray<z.ZodString>>;
569
796
  }, z.core.$catchall<z.ZodUnknown>>;
570
797
  read_only: z.ZodBoolean;
571
798
  }, z.core.$strip>;
@@ -662,12 +889,15 @@ export declare const KANBAN_METHODS: {
662
889
  read_only: z.ZodBoolean;
663
890
  }, z.core.$strip>;
664
891
  };
892
+ /** `column_order`: the Agent workflow's column keys in board order (TAL-796). */
665
893
  readonly 'kanban.stats': {
666
894
  readonly params: z.ZodObject<{
667
895
  profile_home: z.ZodString;
668
896
  board: z.ZodOptional<z.ZodNullable<z.ZodString>>;
669
897
  }, z.core.$strip>;
670
- readonly result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
898
+ readonly result: z.ZodObject<{
899
+ column_order: z.ZodArray<z.ZodString>;
900
+ }, z.core.$catchall<z.ZodUnknown>>;
671
901
  };
672
902
  readonly 'kanban.assignees': {
673
903
  readonly params: z.ZodObject<{
@@ -723,6 +953,12 @@ export declare const KANBAN_METHODS: {
723
953
  readonly result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
724
954
  };
725
955
  };
956
+ /** Busy Agent work, or retained canonical history that this Agent cannot safely retire. */
957
+ export declare const SessionDeleteRefusedSchema: z.ZodEnum<{
958
+ active_turn: "active_turn";
959
+ runtime_history_unsupported: "runtime_history_unsupported";
960
+ }>;
961
+ export type SessionDeleteRefused = z.infer<typeof SessionDeleteRefusedSchema>;
726
962
  export declare const STATE_DB_METHODS: {
727
963
  readonly 'state_db.sync_start': {
728
964
  readonly params: z.ZodObject<{
@@ -764,13 +1000,25 @@ export declare const STATE_DB_METHODS: {
764
1000
  ok: z.ZodBoolean;
765
1001
  }, z.core.$strip>;
766
1002
  };
1003
+ /**
1004
+ * TAL-792: `include_compression_lineage` also removes the session's compression continuations, resolved and removed in the
1005
+ * same transaction (tip first). `refused` when another Agent process holds a live turn lease or compression lock on any
1006
+ * row the delete would remove, or the Agent lacks retirement APIs for retained canonical history; nothing is removed. `deleted_ids` is the transaction's committed target set,
1007
+ * including continuations/delegates; it remains present when only post-commit artifact cleanup failed.
1008
+ */
767
1009
  readonly 'state_db.delete_cli_session': {
768
1010
  readonly params: z.ZodObject<{
769
1011
  profile_home: z.ZodString;
770
1012
  session_id: z.ZodString;
1013
+ include_compression_lineage: z.ZodOptional<z.ZodBoolean>;
771
1014
  }, z.core.$strip>;
772
1015
  readonly result: z.ZodObject<{
773
1016
  ok: z.ZodBoolean;
1017
+ refused: z.ZodOptional<z.ZodEnum<{
1018
+ active_turn: "active_turn";
1019
+ runtime_history_unsupported: "runtime_history_unsupported";
1020
+ }>>;
1021
+ deleted_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
774
1022
  }, z.core.$strip>;
775
1023
  };
776
1024
  /** TAL-258: append one row through the Agent's `SessionDB.append_message` (bumps `message_count`); `ok` is false without a state.db. */
@@ -793,6 +1041,20 @@ export declare const CanonicalBotChatSchema: z.ZodObject<{
793
1041
  session_id: z.ZodString;
794
1042
  tip_session_id: z.ZodString;
795
1043
  }, z.core.$strip>;
1044
+ /**
1045
+ * TAL-805: a profile's gateway under the host multiplexer. `own` runs its own gateway process, `served` is served by the
1046
+ * live host gateway, `parked` was stopped through the host (`hermes -p X gateway stop`) and nothing runs, `standalone` opted out of the host
1047
+ * and is not running, `stopped` is none of these. Only `own` and `served` are running; Agents without the multiplexer
1048
+ * helpers report `own` or `stopped`.
1049
+ */
1050
+ export declare const GatewayModeSchema: z.ZodEnum<{
1051
+ stopped: "stopped";
1052
+ parked: "parked";
1053
+ own: "own";
1054
+ served: "served";
1055
+ standalone: "standalone";
1056
+ }>;
1057
+ export type GatewayMode = z.infer<typeof GatewayModeSchema>;
796
1058
  export declare const ProfileRowSchema: z.ZodObject<{
797
1059
  name: z.ZodString;
798
1060
  path: z.ZodString;
@@ -805,6 +1067,13 @@ export declare const ProfileRowSchema: z.ZodObject<{
805
1067
  skill_count: z.ZodNumber;
806
1068
  enabled_skills: z.ZodNumber;
807
1069
  total_skills: z.ZodNumber;
1070
+ gateway_mode: z.ZodDefault<z.ZodEnum<{
1071
+ stopped: "stopped";
1072
+ parked: "parked";
1073
+ own: "own";
1074
+ served: "served";
1075
+ standalone: "standalone";
1076
+ }>>;
808
1077
  display_name: z.ZodDefault<z.ZodString>;
809
1078
  description: z.ZodDefault<z.ZodString>;
810
1079
  has_avatar: z.ZodDefault<z.ZodBoolean>;
@@ -831,6 +1100,13 @@ export declare const PROFILES_METHODS: {
831
1100
  skill_count: z.ZodNumber;
832
1101
  enabled_skills: z.ZodNumber;
833
1102
  total_skills: z.ZodNumber;
1103
+ gateway_mode: z.ZodDefault<z.ZodEnum<{
1104
+ stopped: "stopped";
1105
+ parked: "parked";
1106
+ own: "own";
1107
+ served: "served";
1108
+ standalone: "standalone";
1109
+ }>>;
834
1110
  display_name: z.ZodDefault<z.ZodString>;
835
1111
  description: z.ZodDefault<z.ZodString>;
836
1112
  has_avatar: z.ZodDefault<z.ZodBoolean>;
@@ -861,6 +1137,13 @@ export declare const PROFILES_METHODS: {
861
1137
  skill_count: z.ZodNumber;
862
1138
  enabled_skills: z.ZodNumber;
863
1139
  total_skills: z.ZodNumber;
1140
+ gateway_mode: z.ZodDefault<z.ZodEnum<{
1141
+ stopped: "stopped";
1142
+ parked: "parked";
1143
+ own: "own";
1144
+ served: "served";
1145
+ standalone: "standalone";
1146
+ }>>;
864
1147
  display_name: z.ZodDefault<z.ZodString>;
865
1148
  description: z.ZodDefault<z.ZodString>;
866
1149
  has_avatar: z.ZodDefault<z.ZodBoolean>;
@@ -899,7 +1182,25 @@ export declare const PROFILES_METHODS: {
899
1182
  }, z.core.$strip>;
900
1183
  };
901
1184
  };
1185
+ export declare const SkillCatalogIdentitySchema: z.ZodObject<{
1186
+ load_name: z.ZodOptional<z.ZodString>;
1187
+ declared_name: z.ZodOptional<z.ZodString>;
1188
+ status: z.ZodOptional<z.ZodEnum<{
1189
+ unique: "unique";
1190
+ ambiguous: "ambiguous";
1191
+ shadowed: "shadowed";
1192
+ }>>;
1193
+ tier: z.ZodOptional<z.ZodNumber>;
1194
+ }, z.core.$strip>;
902
1195
  export declare const SkillRowSchema: z.ZodObject<{
1196
+ load_name: z.ZodOptional<z.ZodString>;
1197
+ declared_name: z.ZodOptional<z.ZodString>;
1198
+ status: z.ZodOptional<z.ZodEnum<{
1199
+ unique: "unique";
1200
+ ambiguous: "ambiguous";
1201
+ shadowed: "shadowed";
1202
+ }>>;
1203
+ tier: z.ZodOptional<z.ZodNumber>;
903
1204
  name: z.ZodString;
904
1205
  description: z.ZodString;
905
1206
  category: z.ZodNullable<z.ZodString>;
@@ -915,6 +1216,7 @@ export declare const SkillViewSchema: z.ZodUnion<readonly [z.ZodObject<{
915
1216
  path: z.ZodString;
916
1217
  skill_dir: z.ZodNullable<z.ZodString>;
917
1218
  linked_files: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
1219
+ editable: z.ZodOptional<z.ZodBoolean>;
918
1220
  }, z.core.$strip>, z.ZodObject<{
919
1221
  success: z.ZodLiteral<false>;
920
1222
  error: z.ZodString;
@@ -932,6 +1234,14 @@ export declare const SKILLS_METHODS: {
932
1234
  readonly result: z.ZodObject<{
933
1235
  success: z.ZodOptional<z.ZodBoolean>;
934
1236
  skills: z.ZodArray<z.ZodObject<{
1237
+ load_name: z.ZodOptional<z.ZodString>;
1238
+ declared_name: z.ZodOptional<z.ZodString>;
1239
+ status: z.ZodOptional<z.ZodEnum<{
1240
+ unique: "unique";
1241
+ ambiguous: "ambiguous";
1242
+ shadowed: "shadowed";
1243
+ }>>;
1244
+ tier: z.ZodOptional<z.ZodNumber>;
935
1245
  name: z.ZodString;
936
1246
  description: z.ZodString;
937
1247
  category: z.ZodNullable<z.ZodString>;
@@ -957,6 +1267,7 @@ export declare const SKILLS_METHODS: {
957
1267
  path: z.ZodString;
958
1268
  skill_dir: z.ZodNullable<z.ZodString>;
959
1269
  linked_files: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
1270
+ editable: z.ZodOptional<z.ZodBoolean>;
960
1271
  }, z.core.$strip>, z.ZodObject<{
961
1272
  success: z.ZodLiteral<false>;
962
1273
  error: z.ZodString;
@@ -975,6 +1286,9 @@ export declare const SKILLS_METHODS: {
975
1286
  found: z.ZodBoolean;
976
1287
  skill_dir: z.ZodNullable<z.ZodString>;
977
1288
  skill_md: z.ZodNullable<z.ZodString>;
1289
+ load_name: z.ZodOptional<z.ZodString>;
1290
+ declared_name: z.ZodOptional<z.ZodString>;
1291
+ sibling_load_names: z.ZodOptional<z.ZodArray<z.ZodString>>;
978
1292
  }, z.core.$strip>;
979
1293
  };
980
1294
  };
@@ -1010,7 +1324,342 @@ export declare const MCP_METHODS: {
1010
1324
  }, z.core.$strip>;
1011
1325
  };
1012
1326
  };
1327
+ /** One portal policy layer's rules (the Agent's `PolicyBody`): `allow` names the apps that stay on, `deny` the ones off; `tools` turns single tools off. */
1328
+ export declare const ConnectorPolicyBodySchema: z.ZodObject<{
1329
+ mode: z.ZodEnum<{
1330
+ deny: "deny";
1331
+ unrestricted: "unrestricted";
1332
+ "deny-all": "deny-all";
1333
+ allow: "allow";
1334
+ }>;
1335
+ connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1336
+ disabled_connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1337
+ tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1338
+ disable: z.ZodArray<z.ZodString>;
1339
+ }, z.core.$strip>>>;
1340
+ tags: z.ZodOptional<z.ZodObject<{
1341
+ enable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1342
+ disable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1343
+ }, z.core.$strip>>;
1344
+ }, z.core.$strip>;
1345
+ /** A connection operation's target (`tools/connectors/operation.py`): a hosted app account, or an MCP server the card approves. */
1346
+ export declare const ConnectorOperationTargetSchema: z.ZodObject<{
1347
+ name: z.ZodString;
1348
+ kind: z.ZodString;
1349
+ state: z.ZodEnum<{
1350
+ pending: "pending";
1351
+ skipped: "skipped";
1352
+ initiated: "initiated";
1353
+ connected: "connected";
1354
+ failed: "failed";
1355
+ expired: "expired";
1356
+ not_connected: "not_connected";
1357
+ }>;
1358
+ detail: z.ZodString;
1359
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1360
+ required_env: z.ZodArray<z.ZodObject<{
1361
+ name: z.ZodString;
1362
+ prompt: z.ZodString;
1363
+ required: z.ZodBoolean;
1364
+ secret: z.ZodBoolean;
1365
+ }, z.core.$strip>>;
1366
+ }, z.core.$strip>;
1367
+ /** `owner`: `account` for the Connectors page's connect, `session` for a chat card, which `tool_call_id` opened. */
1368
+ export declare const ConnectorOperationSnapshotSchema: z.ZodObject<{
1369
+ op_id: z.ZodString;
1370
+ settled: z.ZodBoolean;
1371
+ owner: z.ZodEnum<{
1372
+ session: "session";
1373
+ account: "account";
1374
+ }>;
1375
+ tool_call_id: z.ZodNullable<z.ZodString>;
1376
+ targets: z.ZodArray<z.ZodObject<{
1377
+ name: z.ZodString;
1378
+ kind: z.ZodString;
1379
+ state: z.ZodEnum<{
1380
+ pending: "pending";
1381
+ skipped: "skipped";
1382
+ initiated: "initiated";
1383
+ connected: "connected";
1384
+ failed: "failed";
1385
+ expired: "expired";
1386
+ not_connected: "not_connected";
1387
+ }>;
1388
+ detail: z.ZodString;
1389
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1390
+ required_env: z.ZodArray<z.ZodObject<{
1391
+ name: z.ZodString;
1392
+ prompt: z.ZodString;
1393
+ required: z.ZodBoolean;
1394
+ secret: z.ZodBoolean;
1395
+ }, z.core.$strip>>;
1396
+ }, z.core.$strip>>;
1397
+ }, z.core.$strip>;
1398
+ /**
1399
+ * Failures carry `data.condition`: `connectors_unavailable`, `connectors_sign_in`, `connectors_forbidden`, `connectors_org_required`,
1400
+ * `connector_not_found`, `connection_not_found`, `policy_conflict` (the member rules changed since `expected_revision`), `policy_invalid`,
1401
+ * `operation_not_found`, `operation_settled`, `operation_refused`, `connectors_failed`.
1402
+ */
1403
+ export declare const CONNECTORS_METHODS: {
1404
+ /** The Agent's `connectors_available()`; never creates an identity. */
1405
+ readonly 'connectors.available': {
1406
+ readonly params: z.ZodObject<{
1407
+ profile_home: z.ZodString;
1408
+ }, z.core.$strip>;
1409
+ readonly result: z.ZodObject<{
1410
+ available: z.ZodBoolean;
1411
+ }, z.core.$strip>;
1412
+ };
1413
+ readonly 'connectors.catalog': {
1414
+ readonly params: z.ZodObject<{
1415
+ profile_home: z.ZodString;
1416
+ }, z.core.$strip>;
1417
+ readonly result: z.ZodObject<{
1418
+ connectors: z.ZodArray<z.ZodObject<{
1419
+ slug: z.ZodString;
1420
+ name: z.ZodString;
1421
+ description: z.ZodString;
1422
+ category: z.ZodString;
1423
+ logo_url: z.ZodNullable<z.ZodString>;
1424
+ }, z.core.$strip>>;
1425
+ }, z.core.$strip>;
1426
+ };
1427
+ readonly 'connectors.accounts': {
1428
+ readonly params: z.ZodObject<{
1429
+ profile_home: z.ZodString;
1430
+ }, z.core.$strip>;
1431
+ readonly result: z.ZodObject<{
1432
+ accounts: z.ZodArray<z.ZodObject<{
1433
+ connection_id: z.ZodString;
1434
+ connector: z.ZodString;
1435
+ status: z.ZodString;
1436
+ status_reason: z.ZodNullable<z.ZodString>;
1437
+ label: z.ZodString;
1438
+ alias: z.ZodNullable<z.ZodString>;
1439
+ active: z.ZodBoolean;
1440
+ disabled: z.ZodBoolean;
1441
+ created_at: z.ZodString;
1442
+ }, z.core.$strip>>;
1443
+ }, z.core.$strip>;
1444
+ };
1445
+ readonly 'connectors.remove': {
1446
+ readonly params: z.ZodObject<{
1447
+ profile_home: z.ZodString;
1448
+ connection_id: z.ZodString;
1449
+ }, z.core.$strip>;
1450
+ readonly result: z.ZodObject<{
1451
+ connection_id: z.ZodString;
1452
+ connector: z.ZodString;
1453
+ status: z.ZodLiteral<"removed">;
1454
+ }, z.core.$strip>;
1455
+ };
1456
+ readonly 'connectors.tools': {
1457
+ readonly params: z.ZodObject<{
1458
+ profile_home: z.ZodString;
1459
+ connector: z.ZodString;
1460
+ refresh: z.ZodOptional<z.ZodBoolean>;
1461
+ }, z.core.$strip>;
1462
+ readonly result: z.ZodObject<{
1463
+ connector: z.ZodString;
1464
+ tools: z.ZodArray<z.ZodObject<{
1465
+ slug: z.ZodString;
1466
+ name: z.ZodString;
1467
+ description: z.ZodString;
1468
+ facet: z.ZodString;
1469
+ hints: z.ZodArray<z.ZodString>;
1470
+ categories: z.ZodArray<z.ZodString>;
1471
+ deprecated: z.ZodBoolean;
1472
+ }, z.core.$strip>>;
1473
+ }, z.core.$strip>;
1474
+ };
1475
+ readonly 'connectors.policy.get': {
1476
+ readonly params: z.ZodObject<{
1477
+ profile_home: z.ZodString;
1478
+ }, z.core.$strip>;
1479
+ readonly result: z.ZodObject<{
1480
+ layers: z.ZodArray<z.ZodObject<{
1481
+ kind: z.ZodEnum<{
1482
+ role: "role";
1483
+ org: "org";
1484
+ member: "member";
1485
+ }>;
1486
+ revision: z.ZodString;
1487
+ body: z.ZodObject<{
1488
+ mode: z.ZodEnum<{
1489
+ deny: "deny";
1490
+ unrestricted: "unrestricted";
1491
+ "deny-all": "deny-all";
1492
+ allow: "allow";
1493
+ }>;
1494
+ connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1495
+ disabled_connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1496
+ tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1497
+ disable: z.ZodArray<z.ZodString>;
1498
+ }, z.core.$strip>>>;
1499
+ tags: z.ZodOptional<z.ZodObject<{
1500
+ enable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1501
+ disable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1502
+ }, z.core.$strip>>;
1503
+ }, z.core.$strip>;
1504
+ }, z.core.$strip>>;
1505
+ effective: z.ZodObject<{
1506
+ mode: z.ZodEnum<{
1507
+ deny: "deny";
1508
+ unrestricted: "unrestricted";
1509
+ "deny-all": "deny-all";
1510
+ allow: "allow";
1511
+ }>;
1512
+ connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1513
+ disabled_connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
1514
+ tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1515
+ disable: z.ZodArray<z.ZodString>;
1516
+ }, z.core.$strip>>>;
1517
+ tags: z.ZodOptional<z.ZodObject<{
1518
+ enable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1519
+ disable: z.ZodOptional<z.ZodArray<z.ZodString>>;
1520
+ }, z.core.$strip>>;
1521
+ revision: z.ZodString;
1522
+ }, z.core.$strip>;
1523
+ }, z.core.$strip>;
1524
+ };
1525
+ /** One member-rule change: `enabled` turns the app on or off; `tool` with `tool_enabled` turns one of its tools on or off. */
1526
+ readonly 'connectors.policy.set': {
1527
+ readonly params: z.ZodObject<{
1528
+ profile_home: z.ZodString;
1529
+ connector: z.ZodString;
1530
+ expected_revision: z.ZodString;
1531
+ enabled: z.ZodOptional<z.ZodBoolean>;
1532
+ tool: z.ZodOptional<z.ZodString>;
1533
+ tool_enabled: z.ZodOptional<z.ZodBoolean>;
1534
+ }, z.core.$strip>;
1535
+ readonly result: z.ZodObject<{
1536
+ revision: z.ZodString;
1537
+ }, z.core.$strip>;
1538
+ };
1539
+ /** Starts (or rejoins) the account-owned connect and waits for its authorization link. */
1540
+ readonly 'connectors.connect': {
1541
+ readonly params: z.ZodObject<{
1542
+ profile_home: z.ZodString;
1543
+ connector: z.ZodString;
1544
+ }, z.core.$strip>;
1545
+ readonly result: z.ZodObject<{
1546
+ op_id: z.ZodString;
1547
+ settled: z.ZodBoolean;
1548
+ owner: z.ZodEnum<{
1549
+ session: "session";
1550
+ account: "account";
1551
+ }>;
1552
+ tool_call_id: z.ZodNullable<z.ZodString>;
1553
+ targets: z.ZodArray<z.ZodObject<{
1554
+ name: z.ZodString;
1555
+ kind: z.ZodString;
1556
+ state: z.ZodEnum<{
1557
+ pending: "pending";
1558
+ skipped: "skipped";
1559
+ initiated: "initiated";
1560
+ connected: "connected";
1561
+ failed: "failed";
1562
+ expired: "expired";
1563
+ not_connected: "not_connected";
1564
+ }>;
1565
+ detail: z.ZodString;
1566
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1567
+ required_env: z.ZodArray<z.ZodObject<{
1568
+ name: z.ZodString;
1569
+ prompt: z.ZodString;
1570
+ required: z.ZodBoolean;
1571
+ secret: z.ZodBoolean;
1572
+ }, z.core.$strip>>;
1573
+ }, z.core.$strip>>;
1574
+ }, z.core.$strip>;
1575
+ };
1576
+ readonly 'connectors.operation': {
1577
+ readonly params: z.ZodObject<{
1578
+ profile_home: z.ZodString;
1579
+ op_id: z.ZodString;
1580
+ }, z.core.$strip>;
1581
+ readonly result: z.ZodObject<{
1582
+ op_id: z.ZodString;
1583
+ settled: z.ZodBoolean;
1584
+ owner: z.ZodEnum<{
1585
+ session: "session";
1586
+ account: "account";
1587
+ }>;
1588
+ tool_call_id: z.ZodNullable<z.ZodString>;
1589
+ targets: z.ZodArray<z.ZodObject<{
1590
+ name: z.ZodString;
1591
+ kind: z.ZodString;
1592
+ state: z.ZodEnum<{
1593
+ pending: "pending";
1594
+ skipped: "skipped";
1595
+ initiated: "initiated";
1596
+ connected: "connected";
1597
+ failed: "failed";
1598
+ expired: "expired";
1599
+ not_connected: "not_connected";
1600
+ }>;
1601
+ detail: z.ZodString;
1602
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1603
+ required_env: z.ZodArray<z.ZodObject<{
1604
+ name: z.ZodString;
1605
+ prompt: z.ZodString;
1606
+ required: z.ZodBoolean;
1607
+ secret: z.ZodBoolean;
1608
+ }, z.core.$strip>>;
1609
+ }, z.core.$strip>>;
1610
+ }, z.core.$strip>;
1611
+ };
1612
+ readonly 'connectors.respond': {
1613
+ readonly params: z.ZodObject<{
1614
+ profile_home: z.ZodString;
1615
+ op_id: z.ZodString;
1616
+ action: z.ZodEnum<{
1617
+ retry: "retry";
1618
+ skip: "skip";
1619
+ approve: "approve";
1620
+ continue: "continue";
1621
+ }>;
1622
+ target: z.ZodOptional<z.ZodString>;
1623
+ env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1624
+ }, z.core.$strip>;
1625
+ readonly result: z.ZodObject<{
1626
+ op_id: z.ZodString;
1627
+ settled: z.ZodBoolean;
1628
+ owner: z.ZodEnum<{
1629
+ session: "session";
1630
+ account: "account";
1631
+ }>;
1632
+ tool_call_id: z.ZodNullable<z.ZodString>;
1633
+ targets: z.ZodArray<z.ZodObject<{
1634
+ name: z.ZodString;
1635
+ kind: z.ZodString;
1636
+ state: z.ZodEnum<{
1637
+ pending: "pending";
1638
+ skipped: "skipped";
1639
+ initiated: "initiated";
1640
+ connected: "connected";
1641
+ failed: "failed";
1642
+ expired: "expired";
1643
+ not_connected: "not_connected";
1644
+ }>;
1645
+ detail: z.ZodString;
1646
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1647
+ required_env: z.ZodArray<z.ZodObject<{
1648
+ name: z.ZodString;
1649
+ prompt: z.ZodString;
1650
+ required: z.ZodBoolean;
1651
+ secret: z.ZodBoolean;
1652
+ }, z.core.$strip>>;
1653
+ }, z.core.$strip>>;
1654
+ }, z.core.$strip>;
1655
+ };
1656
+ };
1013
1657
  export declare const STT_METHODS: {
1658
+ /**
1659
+ * `streaming` (TAL-802): `stt.streaming` is on and the provider has a live wire with credentials, so `stt.stream` would open.
1660
+ * `warm_supported` (TAL-916): the available provider is the local engine and the Agent can pre-load it (`tools.stt_lease`),
1661
+ * so `stt.warm` does real work.
1662
+ */
1014
1663
  readonly 'stt.capability': {
1015
1664
  readonly params: z.ZodObject<{
1016
1665
  profile_home: z.ZodString;
@@ -1018,6 +1667,24 @@ export declare const STT_METHODS: {
1018
1667
  readonly result: z.ZodObject<{
1019
1668
  available: z.ZodBoolean;
1020
1669
  provider: z.ZodString;
1670
+ streaming: z.ZodBoolean;
1671
+ warm_supported: z.ZodBoolean;
1672
+ }, z.core.$strip>;
1673
+ };
1674
+ /**
1675
+ * TAL-916: pre-load the profile's local engine (first-use download and model load) so the next `stt.transcribe` starts
1676
+ * hot. Blocks until loaded; a no-op (`warmed: false`) for remote providers, and `action: 'unsupported'` on an Agent
1677
+ * without the warmer.
1678
+ */
1679
+ readonly 'stt.warm': {
1680
+ readonly params: z.ZodObject<{
1681
+ profile_home: z.ZodString;
1682
+ }, z.core.$strip>;
1683
+ readonly result: z.ZodObject<{
1684
+ provider: z.ZodString;
1685
+ warmed: z.ZodBoolean;
1686
+ action: z.ZodString;
1687
+ error: z.ZodOptional<z.ZodString>;
1021
1688
  }, z.core.$strip>;
1022
1689
  };
1023
1690
  readonly 'stt.transcribe': {
@@ -1028,9 +1695,49 @@ export declare const STT_METHODS: {
1028
1695
  }, z.core.$strip>;
1029
1696
  readonly result: z.ZodObject<{
1030
1697
  transcript: z.ZodString;
1698
+ filtered: z.ZodBoolean;
1699
+ }, z.core.$strip>;
1700
+ };
1701
+ /**
1702
+ * TAL-802: one live dictation. Opens the profile's streaming session for s16le mono PCM at `sample_rate` (the sidecar
1703
+ * resamples), emits `ready` with the `stream_id` that `stt.stream_audio` feeds, then `partial` text as the provider
1704
+ * recognizes it, and returns the session's final transcript once audio ends. Cancelling the call cancels the session.
1705
+ */
1706
+ readonly 'stt.stream': {
1707
+ readonly params: z.ZodObject<{
1708
+ profile_home: z.ZodString;
1709
+ sample_rate: z.ZodNumber;
1710
+ }, z.core.$strip>;
1711
+ readonly result: z.ZodObject<{
1712
+ transcript: z.ZodString;
1713
+ filtered: z.ZodBoolean;
1714
+ provider: z.ZodString;
1715
+ }, z.core.$strip>;
1716
+ readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
1717
+ event: z.ZodLiteral<"ready">;
1718
+ data: z.ZodObject<{
1719
+ stream_id: z.ZodString;
1720
+ }, z.core.$strip>;
1721
+ }, z.core.$strip>, z.ZodObject<{
1722
+ event: z.ZodLiteral<"partial">;
1723
+ data: z.ZodObject<{
1724
+ text: z.ZodString;
1725
+ }, z.core.$strip>;
1726
+ }, z.core.$strip>], "event">;
1727
+ };
1728
+ /** TAL-802: feed one PCM chunk to an open `stt.stream`, in order; `end` marks the end of speech. */
1729
+ readonly 'stt.stream_audio': {
1730
+ readonly params: z.ZodObject<{
1731
+ stream_id: z.ZodString;
1732
+ audio_b64: z.ZodOptional<z.ZodString>;
1733
+ end: z.ZodOptional<z.ZodBoolean>;
1734
+ }, z.core.$strip>;
1735
+ readonly result: z.ZodObject<{
1736
+ ok: z.ZodLiteral<true>;
1031
1737
  }, z.core.$strip>;
1032
1738
  };
1033
1739
  };
1740
+ /** `running_elsewhere`: a live execution owner. `recovery_only`: a retained snapshot, not a source for new task context. */
1034
1741
  export declare const CronJobSchema: z.ZodObject<{
1035
1742
  id: z.ZodString;
1036
1743
  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1038,6 +1745,8 @@ export declare const CronJobSchema: z.ZodObject<{
1038
1745
  toast_notifications: z.ZodBoolean;
1039
1746
  monitor: z.ZodString;
1040
1747
  continuity: z.ZodBoolean;
1748
+ running_elsewhere: z.ZodOptional<z.ZodBoolean>;
1749
+ recovery_only: z.ZodOptional<z.ZodBoolean>;
1041
1750
  }, z.core.$catchall<z.ZodUnknown>>;
1042
1751
  export declare const CronUsageSchema: z.ZodObject<{
1043
1752
  model: z.ZodOptional<z.ZodString>;
@@ -1048,10 +1757,105 @@ export declare const CronUsageSchema: z.ZodObject<{
1048
1757
  output_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1049
1758
  total_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1050
1759
  }, z.core.$strip>;
1760
+ export declare const CronBlueprintSlotSchema: z.ZodObject<{
1761
+ name: z.ZodString;
1762
+ type: z.ZodString;
1763
+ label: z.ZodString;
1764
+ default: z.ZodNullable<z.ZodString>;
1765
+ options: z.ZodArray<z.ZodString>;
1766
+ optional: z.ZodBoolean;
1767
+ strict: z.ZodBoolean;
1768
+ help: z.ZodString;
1769
+ }, z.core.$strip>;
1770
+ export declare const CronBlueprintsSchema: z.ZodObject<{
1771
+ blueprints: z.ZodArray<z.ZodObject<{
1772
+ key: z.ZodString;
1773
+ title: z.ZodString;
1774
+ description: z.ZodString;
1775
+ category: z.ZodString;
1776
+ source: z.ZodEnum<{
1777
+ plugin: "plugin";
1778
+ builtin: "builtin";
1779
+ }>;
1780
+ plugin: z.ZodNullable<z.ZodString>;
1781
+ schedule_label: z.ZodString;
1782
+ slots: z.ZodArray<z.ZodObject<{
1783
+ name: z.ZodString;
1784
+ type: z.ZodString;
1785
+ label: z.ZodString;
1786
+ default: z.ZodNullable<z.ZodString>;
1787
+ options: z.ZodArray<z.ZodString>;
1788
+ optional: z.ZodBoolean;
1789
+ strict: z.ZodBoolean;
1790
+ help: z.ZodString;
1791
+ }, z.core.$strip>>;
1792
+ }, z.core.$strip>>;
1793
+ }, z.core.$strip>;
1794
+ export declare const CronBlueprintFillInputSchema: z.ZodObject<{
1795
+ key: z.ZodString;
1796
+ values: z.ZodRecord<z.ZodString, z.ZodString>;
1797
+ }, z.core.$strip>;
1798
+ export declare const CronBlueprintFillSchema: z.ZodObject<{
1799
+ draft: z.ZodObject<{
1800
+ name: z.ZodString;
1801
+ prompt: z.ZodString;
1802
+ schedule: z.ZodString;
1803
+ deliver: z.ZodString;
1804
+ skills: z.ZodArray<z.ZodString>;
1805
+ }, z.core.$strip>;
1806
+ }, z.core.$strip>;
1807
+ export type CronBlueprint = z.infer<typeof CronBlueprintsSchema>['blueprints'][number];
1051
1808
  export declare const CRON_METHODS: {
1809
+ readonly 'cron.blueprints': {
1810
+ readonly params: z.ZodObject<{
1811
+ profile_home: z.ZodString;
1812
+ }, z.core.$strip>;
1813
+ readonly result: z.ZodObject<{
1814
+ blueprints: z.ZodArray<z.ZodObject<{
1815
+ key: z.ZodString;
1816
+ title: z.ZodString;
1817
+ description: z.ZodString;
1818
+ category: z.ZodString;
1819
+ source: z.ZodEnum<{
1820
+ plugin: "plugin";
1821
+ builtin: "builtin";
1822
+ }>;
1823
+ plugin: z.ZodNullable<z.ZodString>;
1824
+ schedule_label: z.ZodString;
1825
+ slots: z.ZodArray<z.ZodObject<{
1826
+ name: z.ZodString;
1827
+ type: z.ZodString;
1828
+ label: z.ZodString;
1829
+ default: z.ZodNullable<z.ZodString>;
1830
+ options: z.ZodArray<z.ZodString>;
1831
+ optional: z.ZodBoolean;
1832
+ strict: z.ZodBoolean;
1833
+ help: z.ZodString;
1834
+ }, z.core.$strip>>;
1835
+ }, z.core.$strip>>;
1836
+ }, z.core.$strip>;
1837
+ };
1838
+ readonly 'cron.blueprint_fill': {
1839
+ readonly params: z.ZodObject<{
1840
+ key: z.ZodString;
1841
+ values: z.ZodRecord<z.ZodString, z.ZodString>;
1842
+ profile_home: z.ZodOptional<z.ZodString>;
1843
+ }, z.core.$strip>;
1844
+ readonly result: z.ZodObject<{
1845
+ draft: z.ZodObject<{
1846
+ name: z.ZodString;
1847
+ prompt: z.ZodString;
1848
+ schedule: z.ZodString;
1849
+ deliver: z.ZodString;
1850
+ skills: z.ZodArray<z.ZodString>;
1851
+ }, z.core.$strip>;
1852
+ }, z.core.$strip>;
1853
+ };
1854
+ /** `probe_store` adds the store's write probe (TAL-810): null when writes land or the Agent predates the probe. */
1052
1855
  readonly 'cron.list': {
1053
1856
  readonly params: z.ZodObject<{
1054
1857
  profile_home: z.ZodString;
1858
+ probe_store: z.ZodOptional<z.ZodBoolean>;
1055
1859
  }, z.core.$strip>;
1056
1860
  readonly result: z.ZodObject<{
1057
1861
  jobs: z.ZodArray<z.ZodObject<{
@@ -1061,7 +1865,15 @@ export declare const CRON_METHODS: {
1061
1865
  toast_notifications: z.ZodBoolean;
1062
1866
  monitor: z.ZodString;
1063
1867
  continuity: z.ZodBoolean;
1868
+ running_elsewhere: z.ZodOptional<z.ZodBoolean>;
1869
+ recovery_only: z.ZodOptional<z.ZodBoolean>;
1064
1870
  }, z.core.$catchall<z.ZodUnknown>>>;
1871
+ store_health: z.ZodOptional<z.ZodNullable<z.ZodObject<{
1872
+ store: z.ZodString;
1873
+ error: z.ZodString;
1874
+ since: z.ZodString;
1875
+ fix: z.ZodString;
1876
+ }, z.core.$strip>>>;
1065
1877
  }, z.core.$strip>;
1066
1878
  };
1067
1879
  readonly 'cron.get': {
@@ -1077,6 +1889,8 @@ export declare const CRON_METHODS: {
1077
1889
  toast_notifications: z.ZodBoolean;
1078
1890
  monitor: z.ZodString;
1079
1891
  continuity: z.ZodBoolean;
1892
+ running_elsewhere: z.ZodOptional<z.ZodBoolean>;
1893
+ recovery_only: z.ZodOptional<z.ZodBoolean>;
1080
1894
  }, z.core.$catchall<z.ZodUnknown>>>;
1081
1895
  }, z.core.$strip>;
1082
1896
  };
@@ -1094,6 +1908,8 @@ export declare const CRON_METHODS: {
1094
1908
  toast_notifications: z.ZodBoolean;
1095
1909
  monitor: z.ZodString;
1096
1910
  continuity: z.ZodBoolean;
1911
+ running_elsewhere: z.ZodOptional<z.ZodBoolean>;
1912
+ recovery_only: z.ZodOptional<z.ZodBoolean>;
1097
1913
  }, z.core.$catchall<z.ZodUnknown>>;
1098
1914
  }, z.core.$strip>;
1099
1915
  };
@@ -1111,6 +1927,8 @@ export declare const CRON_METHODS: {
1111
1927
  toast_notifications: z.ZodBoolean;
1112
1928
  monitor: z.ZodString;
1113
1929
  continuity: z.ZodBoolean;
1930
+ running_elsewhere: z.ZodOptional<z.ZodBoolean>;
1931
+ recovery_only: z.ZodOptional<z.ZodBoolean>;
1114
1932
  }, z.core.$catchall<z.ZodUnknown>>;
1115
1933
  }, z.core.$strip>;
1116
1934
  };
@@ -1160,8 +1978,8 @@ export declare const CRON_METHODS: {
1160
1978
  }, z.core.$strip>, z.ZodObject<{
1161
1979
  job_id: z.ZodString;
1162
1980
  status: z.ZodEnum<{
1163
- completed: "completed";
1164
1981
  failed: "failed";
1982
+ completed: "completed";
1165
1983
  }>;
1166
1984
  success: z.ZodBoolean;
1167
1985
  error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1259,6 +2077,11 @@ export declare const CRON_METHODS: {
1259
2077
  }, z.core.$strip>;
1260
2078
  };
1261
2079
  };
2080
+ /**
2081
+ * `providers.model_ids` `fallback` (TAL-799): the Agent served its curated list because the live catalog was unreachable.
2082
+ * `providers.local_models` (TAL-798): the GGUFs staged for the Agent's managed llama.cpp provider `provider_id`, and the
2083
+ * running server's base URL (`current_endpoint`, null while it is off).
2084
+ */
1262
2085
  export declare const PROVIDERS_METHODS: {
1263
2086
  readonly 'providers.registry': {
1264
2087
  readonly params: z.ZodObject<{
@@ -1292,6 +2115,17 @@ export declare const PROVIDERS_METHODS: {
1292
2115
  readonly result: z.ZodObject<{
1293
2116
  provider: z.ZodString;
1294
2117
  model_ids: z.ZodArray<z.ZodString>;
2118
+ fallback: z.ZodDefault<z.ZodBoolean>;
2119
+ }, z.core.$strip>;
2120
+ };
2121
+ readonly 'providers.local_models': {
2122
+ readonly params: z.ZodObject<{
2123
+ profile_home: z.ZodString;
2124
+ }, z.core.$strip>;
2125
+ readonly result: z.ZodObject<{
2126
+ provider_id: z.ZodString;
2127
+ models: z.ZodArray<z.ZodString>;
2128
+ current_endpoint: z.ZodNullable<z.ZodString>;
1295
2129
  }, z.core.$strip>;
1296
2130
  };
1297
2131
  readonly 'providers.resolve_runtime': {
@@ -1317,6 +2151,55 @@ export declare const PROVIDERS_METHODS: {
1317
2151
  entries: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1318
2152
  }, z.core.$strip>;
1319
2153
  };
2154
+ readonly 'models.selection_warnings': {
2155
+ readonly params: z.ZodObject<{
2156
+ profile_home: z.ZodString;
2157
+ session_id: z.ZodString;
2158
+ model: z.ZodString;
2159
+ provider: z.ZodNullable<z.ZodString>;
2160
+ current_model: z.ZodNullable<z.ZodString>;
2161
+ current_provider: z.ZodNullable<z.ZodString>;
2162
+ context_tokens: z.ZodNullable<z.ZodNumber>;
2163
+ messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2164
+ }, z.core.$strip>;
2165
+ readonly result: z.ZodObject<{
2166
+ warnings: z.ZodArray<z.ZodObject<{
2167
+ kind: z.ZodString;
2168
+ title: z.ZodString;
2169
+ model: z.ZodString;
2170
+ provider: z.ZodString;
2171
+ message: z.ZodString;
2172
+ }, z.core.$strip>>;
2173
+ context_tokens: z.ZodNullable<z.ZodNumber>;
2174
+ provider: z.ZodString;
2175
+ base_url: z.ZodString;
2176
+ }, z.core.$strip>;
2177
+ };
2178
+ readonly 'models.speed_tiers': {
2179
+ readonly params: z.ZodObject<{
2180
+ profile_home: z.ZodString;
2181
+ routes: z.ZodArray<z.ZodObject<{
2182
+ model: z.ZodString;
2183
+ provider: z.ZodString;
2184
+ base_url: z.ZodOptional<z.ZodString>;
2185
+ }, z.core.$strip>>;
2186
+ }, z.core.$strip>;
2187
+ readonly result: z.ZodObject<{
2188
+ tiers: z.ZodArray<z.ZodArray<z.ZodObject<{
2189
+ id: z.ZodEnum<{
2190
+ standard: "standard";
2191
+ priority: "priority";
2192
+ ultrafast: "ultrafast";
2193
+ fast: "fast";
2194
+ }>;
2195
+ service_tier: z.ZodEnum<{
2196
+ default: "default";
2197
+ priority: "priority";
2198
+ ultrafast: "ultrafast";
2199
+ }>;
2200
+ }, z.core.$strip>>>;
2201
+ }, z.core.$strip>;
2202
+ };
1320
2203
  readonly 'models.context_length': {
1321
2204
  readonly params: z.ZodObject<{
1322
2205
  profile_home: z.ZodString;
@@ -1358,11 +2241,11 @@ export declare const PROVIDERS_METHODS: {
1358
2241
  */
1359
2242
  export declare const OAuthFlowStatusSchema: z.ZodEnum<{
1360
2243
  error: "error";
1361
- cancelled: "cancelled";
1362
2244
  pending: "pending";
2245
+ cancelled: "cancelled";
2246
+ expired: "expired";
1363
2247
  approved: "approved";
1364
2248
  denied: "denied";
1365
- expired: "expired";
1366
2249
  }>;
1367
2250
  export declare const OAUTH_METHODS: {
1368
2251
  readonly 'oauth.start': {
@@ -1390,11 +2273,11 @@ export declare const OAUTH_METHODS: {
1390
2273
  provider: z.ZodString;
1391
2274
  status: z.ZodEnum<{
1392
2275
  error: "error";
1393
- cancelled: "cancelled";
1394
2276
  pending: "pending";
2277
+ cancelled: "cancelled";
2278
+ expired: "expired";
1395
2279
  approved: "approved";
1396
2280
  denied: "denied";
1397
- expired: "expired";
1398
2281
  }>;
1399
2282
  error: z.ZodNullable<z.ZodString>;
1400
2283
  }, z.core.$strip>;
@@ -1409,11 +2292,11 @@ export declare const OAUTH_METHODS: {
1409
2292
  provider: z.ZodString;
1410
2293
  status: z.ZodEnum<{
1411
2294
  error: "error";
1412
- cancelled: "cancelled";
1413
2295
  pending: "pending";
2296
+ cancelled: "cancelled";
2297
+ expired: "expired";
1414
2298
  approved: "approved";
1415
2299
  denied: "denied";
1416
- expired: "expired";
1417
2300
  }>;
1418
2301
  error: z.ZodNullable<z.ZodString>;
1419
2302
  }, z.core.$strip>;
@@ -1458,6 +2341,31 @@ export declare const AUX_METHODS: {
1458
2341
  }, z.core.$strip>;
1459
2342
  }, z.core.$strip>], "event">;
1460
2343
  };
2344
+ /**
2345
+ * TAL-800: the profile's auxiliary slots in Agent order (built-ins, then the profile's plugin tasks). `reasoning_effort`
2346
+ * is the slot's resolved effort (`''` = provider default); `effective` is the route an `inherit_from` task resolves to now.
2347
+ * `reserved`: the Agent's other `auxiliary.*` keys (settings and unlisted routes); a reset never touches them.
2348
+ */
2349
+ readonly 'aux.tasks': {
2350
+ readonly params: z.ZodObject<{
2351
+ profile_home: z.ZodString;
2352
+ }, z.core.$strip>;
2353
+ readonly result: z.ZodObject<{
2354
+ tasks: z.ZodArray<z.ZodObject<{
2355
+ key: z.ZodString;
2356
+ label: z.ZodString;
2357
+ description: z.ZodString;
2358
+ inherit_from: z.ZodNullable<z.ZodString>;
2359
+ reasoning_effort: z.ZodString;
2360
+ effective: z.ZodNullable<z.ZodObject<{
2361
+ provider: z.ZodString;
2362
+ model: z.ZodString;
2363
+ base_url: z.ZodString;
2364
+ }, z.core.$strip>>;
2365
+ }, z.core.$strip>>;
2366
+ reserved: z.ZodArray<z.ZodString>;
2367
+ }, z.core.$strip>;
2368
+ };
1461
2369
  readonly 'aux.resolve': {
1462
2370
  readonly params: z.ZodObject<{
1463
2371
  profile_home: z.ZodString;
@@ -1499,6 +2407,154 @@ export declare const TEXT_METHODS: {
1499
2407
  tags: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
1500
2408
  }, z.core.$strip>;
1501
2409
  };
2410
+ /** TAL-906: the Agent's read-aloud script (`prepare_spoken_text`); `text` as written on an Agent without it. */
2411
+ readonly 'text.spoken': {
2412
+ readonly params: z.ZodObject<{
2413
+ text: z.ZodString;
2414
+ }, z.core.$strip>;
2415
+ readonly result: z.ZodObject<{
2416
+ spoken_text: z.ZodString;
2417
+ }, z.core.$strip>;
2418
+ };
2419
+ };
2420
+ /**
2421
+ * TAL-886: the Agent's `MemoryStore` reading of a MEMORY.md / USER.md body: its char count and the profile's limit for that store.
2422
+ * TAL-784: `memory.write` replaces a memory page file with `content` only while its bytes still hash (SHA-256 hex) to `base`,
2423
+ * holding the Agent's per-file lock (`<file>.lock`); `written: false` means the file changed and is untouched.
2424
+ */
2425
+ export declare const MEMORY_METHODS: {
2426
+ readonly 'memory.check': {
2427
+ readonly params: z.ZodObject<{
2428
+ profile_home: z.ZodString;
2429
+ target: z.ZodEnum<{
2430
+ memory: "memory";
2431
+ user: "user";
2432
+ }>;
2433
+ content: z.ZodString;
2434
+ }, z.core.$strip>;
2435
+ readonly result: z.ZodObject<{
2436
+ count: z.ZodNumber;
2437
+ limit: z.ZodNumber;
2438
+ }, z.core.$strip>;
2439
+ };
2440
+ readonly 'memory.write': {
2441
+ readonly params: z.ZodObject<{
2442
+ profile_home: z.ZodString;
2443
+ section: z.ZodEnum<{
2444
+ memory: "memory";
2445
+ user: "user";
2446
+ soul: "soul";
2447
+ }>;
2448
+ base: z.ZodString;
2449
+ content: z.ZodString;
2450
+ }, z.core.$strip>;
2451
+ readonly result: z.ZodObject<{
2452
+ written: z.ZodBoolean;
2453
+ }, z.core.$strip>;
2454
+ };
2455
+ };
2456
+ /**
2457
+ * TAL-819: one write the Agent staged for approval (`skills.write_approval` / `memory.write_approval`). `target` is the skill
2458
+ * name(s), or `memory` / `user` for the memory store; `op` the staged action; `diff` the unified diff an approval would apply
2459
+ * (a skill create shows the new file, a write that would fail says why); `revision` is the SHA-256 of that diff, which an approval
2460
+ * must send back. `approvable` is false when no diff could be built or the Agent would refuse the write (`diff` says why;
2461
+ * `revision` is empty); such a write can only be rejected.
2462
+ */
2463
+ export declare const PendingWriteSchema: z.ZodObject<{
2464
+ id: z.ZodString;
2465
+ kind: z.ZodEnum<{
2466
+ skills: "skills";
2467
+ memory: "memory";
2468
+ }>;
2469
+ target: z.ZodString;
2470
+ op: z.ZodString;
2471
+ summary: z.ZodString;
2472
+ origin: z.ZodString;
2473
+ created_at: z.ZodNumber;
2474
+ diff: z.ZodString;
2475
+ approvable: z.ZodBoolean;
2476
+ revision: z.ZodString;
2477
+ }, z.core.$strip>;
2478
+ export type PendingWrite = z.infer<typeof PendingWriteSchema>;
2479
+ export declare const PendingWriteRefSchema: z.ZodObject<{
2480
+ id: z.ZodString;
2481
+ revision: z.ZodString;
2482
+ }, z.core.$strip>;
2483
+ /**
2484
+ * TAL-819: the profile's staged writes of `kind`, oldest first, and whether its gate is on; `supported` is false on an Agent
2485
+ * without the review handlers. `approve` / `reject` run the Agent's `/skills` or `/memory` handler per write; `done` is true
2486
+ * once the record is gone (applied or dropped) and `message` is the handler's text. An approval whose diff no longer has the
2487
+ * reviewed `revision` is refused (`done: false`) without applying.
2488
+ */
2489
+ export declare const WRITE_APPROVAL_METHODS: {
2490
+ readonly 'write_approval.pending': {
2491
+ readonly params: z.ZodObject<{
2492
+ profile_home: z.ZodString;
2493
+ kind: z.ZodEnum<{
2494
+ skills: "skills";
2495
+ memory: "memory";
2496
+ }>;
2497
+ }, z.core.$strip>;
2498
+ readonly result: z.ZodObject<{
2499
+ supported: z.ZodBoolean;
2500
+ enabled: z.ZodBoolean;
2501
+ items: z.ZodArray<z.ZodObject<{
2502
+ id: z.ZodString;
2503
+ kind: z.ZodEnum<{
2504
+ skills: "skills";
2505
+ memory: "memory";
2506
+ }>;
2507
+ target: z.ZodString;
2508
+ op: z.ZodString;
2509
+ summary: z.ZodString;
2510
+ origin: z.ZodString;
2511
+ created_at: z.ZodNumber;
2512
+ diff: z.ZodString;
2513
+ approvable: z.ZodBoolean;
2514
+ revision: z.ZodString;
2515
+ }, z.core.$strip>>;
2516
+ }, z.core.$strip>;
2517
+ };
2518
+ readonly 'write_approval.approve': {
2519
+ readonly params: z.ZodObject<{
2520
+ profile_home: z.ZodString;
2521
+ kind: z.ZodEnum<{
2522
+ skills: "skills";
2523
+ memory: "memory";
2524
+ }>;
2525
+ writes: z.ZodArray<z.ZodObject<{
2526
+ id: z.ZodString;
2527
+ revision: z.ZodString;
2528
+ }, z.core.$strip>>;
2529
+ }, z.core.$strip>;
2530
+ readonly result: z.ZodObject<{
2531
+ results: z.ZodArray<z.ZodObject<{
2532
+ id: z.ZodString;
2533
+ done: z.ZodBoolean;
2534
+ message: z.ZodString;
2535
+ }, z.core.$strip>>;
2536
+ }, z.core.$strip>;
2537
+ };
2538
+ readonly 'write_approval.reject': {
2539
+ readonly params: z.ZodObject<{
2540
+ profile_home: z.ZodString;
2541
+ kind: z.ZodEnum<{
2542
+ skills: "skills";
2543
+ memory: "memory";
2544
+ }>;
2545
+ writes: z.ZodArray<z.ZodObject<{
2546
+ id: z.ZodString;
2547
+ revision: z.ZodString;
2548
+ }, z.core.$strip>>;
2549
+ }, z.core.$strip>;
2550
+ readonly result: z.ZodObject<{
2551
+ results: z.ZodArray<z.ZodObject<{
2552
+ id: z.ZodString;
2553
+ done: z.ZodBoolean;
2554
+ message: z.ZodString;
2555
+ }, z.core.$strip>>;
2556
+ }, z.core.$strip>;
2557
+ };
1502
2558
  };
1503
2559
  export declare const ProcessEventSchema: z.ZodObject<{
1504
2560
  process_id: z.ZodString;
@@ -1506,6 +2562,8 @@ export declare const ProcessEventSchema: z.ZodObject<{
1506
2562
  type: z.ZodOptional<z.ZodString>;
1507
2563
  session_key: z.ZodOptional<z.ZodString>;
1508
2564
  origin_ui_session_id: z.ZodOptional<z.ZodString>;
2565
+ child_process: z.ZodOptional<z.ZodBoolean>;
2566
+ reconciliation_profile_home: z.ZodOptional<z.ZodString>;
1509
2567
  }, z.core.$catchall<z.ZodUnknown>>;
1510
2568
  export declare const PROCESS_METHODS: {
1511
2569
  readonly 'process.drain': {
@@ -1520,6 +2578,8 @@ export declare const PROCESS_METHODS: {
1520
2578
  type: z.ZodOptional<z.ZodString>;
1521
2579
  session_key: z.ZodOptional<z.ZodString>;
1522
2580
  origin_ui_session_id: z.ZodOptional<z.ZodString>;
2581
+ child_process: z.ZodOptional<z.ZodBoolean>;
2582
+ reconciliation_profile_home: z.ZodOptional<z.ZodString>;
1523
2583
  }, z.core.$catchall<z.ZodUnknown>>>;
1524
2584
  }, z.core.$strip>;
1525
2585
  };
@@ -1566,6 +2626,7 @@ export declare const PROCESS_METHODS: {
1566
2626
  }, z.core.$strip>;
1567
2627
  readonly result: z.ZodObject<{
1568
2628
  claim_id: z.ZodNullable<z.ZodString>;
2629
+ retryable: z.ZodOptional<z.ZodBoolean>;
1569
2630
  }, z.core.$strip>;
1570
2631
  };
1571
2632
  readonly 'process.complete_delivery': {
@@ -1671,7 +2732,7 @@ export declare const AccountUsageSnapshotSchema: z.ZodObject<{
1671
2732
  }, z.core.$catchall<z.ZodUnknown>>;
1672
2733
  /**
1673
2734
  * 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`.
2735
+ * `matches_api_key`: the entry's key is the configured key, passed as `api_key` or resolved from `env_vars` in the profile's secret scope.
1675
2736
  */
1676
2737
  export declare const PoolEntrySchema: z.ZodObject<{
1677
2738
  credential_id: z.ZodString;
@@ -1686,14 +2747,14 @@ export declare const PoolEntrySchema: z.ZodObject<{
1686
2747
  matches_api_key: z.ZodBoolean;
1687
2748
  }, z.core.$strip>;
1688
2749
  /**
1689
- * TAL-548: one key-based balance read. The key is the pool entry's (`credential_id`) or the server-resolved `api_key`.
2750
+ * TAL-548: one key-based balance read. The key is the pool entry's (`credential_id`), a raw `api_key`, or resolved from `env_vars` in the profile's secret scope.
1690
2751
  * `ok` carries the provider's sanitised fields: OpenRouter `quota`/`label`, DeepSeek `balances`/`is_available`, OpenCode Go
1691
2752
  * `windows`; `http_error` carries the status code.
1692
2753
  */
1693
2754
  export declare const BalanceResultSchema: z.ZodObject<{
1694
2755
  status: z.ZodEnum<{
1695
- ok: "ok";
1696
2756
  unavailable: "unavailable";
2757
+ ok: "ok";
1697
2758
  no_key: "no_key";
1698
2759
  http_error: "http_error";
1699
2760
  }>;
@@ -1725,6 +2786,14 @@ export declare const BalanceResultSchema: z.ZodObject<{
1725
2786
  rate_limited: z.ZodBoolean;
1726
2787
  }, z.core.$strip>>;
1727
2788
  }, z.core.$strip>;
2789
+ /** TAL-807: the Agent's `CredentialPool.limit_state`: every live account benched until `resets_at`, else the given models no usable account serves until their ISO reset. */
2790
+ export declare const PoolLimitSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2791
+ scope: z.ZodLiteral<"account">;
2792
+ resets_at: z.ZodString;
2793
+ }, z.core.$strip>, z.ZodObject<{
2794
+ scope: z.ZodLiteral<"models">;
2795
+ models: z.ZodRecord<z.ZodString, z.ZodString>;
2796
+ }, z.core.$strip>], "scope">;
1728
2797
  export declare const USAGE_METHODS: {
1729
2798
  readonly 'usage.account': {
1730
2799
  readonly params: z.ZodObject<{
@@ -1749,6 +2818,7 @@ export declare const USAGE_METHODS: {
1749
2818
  profile_home: z.ZodString;
1750
2819
  provider: z.ZodString;
1751
2820
  api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2821
+ env_vars: z.ZodOptional<z.ZodArray<z.ZodString>>;
1752
2822
  }, z.core.$strip>;
1753
2823
  readonly result: z.ZodObject<{
1754
2824
  entries: z.ZodArray<z.ZodObject<{
@@ -1763,15 +2833,40 @@ export declare const USAGE_METHODS: {
1763
2833
  retry_after: z.ZodNullable<z.ZodString>;
1764
2834
  matches_api_key: z.ZodBoolean;
1765
2835
  }, z.core.$strip>>;
2836
+ has_api_key: z.ZodOptional<z.ZodBoolean>;
1766
2837
  }, z.core.$strip>;
1767
2838
  };
1768
2839
  /** TAL-548: the providers whose persisted credential pool holds an account the user added, keyed or not. */
1769
2840
  readonly 'usage.pool_providers': {
1770
2841
  readonly params: z.ZodObject<{
1771
2842
  profile_home: z.ZodString;
2843
+ key_envs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
1772
2844
  }, z.core.$strip>;
1773
2845
  readonly result: z.ZodObject<{
1774
2846
  providers: z.ZodArray<z.ZodString>;
2847
+ keys: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
2848
+ present: z.ZodBoolean;
2849
+ revision: z.ZodNullable<z.ZodString>;
2850
+ }, z.core.$strip>>>;
2851
+ }, z.core.$strip>;
2852
+ };
2853
+ /** TAL-807: pool rate limits by provider slug, only for pooled providers that are limited; `models` are bare ids. */
2854
+ readonly 'usage.limits': {
2855
+ readonly params: z.ZodObject<{
2856
+ profile_home: z.ZodString;
2857
+ providers: z.ZodArray<z.ZodObject<{
2858
+ slug: z.ZodString;
2859
+ models: z.ZodArray<z.ZodString>;
2860
+ }, z.core.$strip>>;
2861
+ }, z.core.$strip>;
2862
+ readonly result: z.ZodObject<{
2863
+ limits: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
2864
+ scope: z.ZodLiteral<"account">;
2865
+ resets_at: z.ZodString;
2866
+ }, z.core.$strip>, z.ZodObject<{
2867
+ scope: z.ZodLiteral<"models">;
2868
+ models: z.ZodRecord<z.ZodString, z.ZodString>;
2869
+ }, z.core.$strip>], "scope">>;
1775
2870
  }, z.core.$strip>;
1776
2871
  };
1777
2872
  readonly 'usage.balance': {
@@ -1784,11 +2879,12 @@ export declare const USAGE_METHODS: {
1784
2879
  }>;
1785
2880
  credential_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1786
2881
  api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2882
+ env_vars: z.ZodOptional<z.ZodArray<z.ZodString>>;
1787
2883
  }, z.core.$strip>;
1788
2884
  readonly result: z.ZodObject<{
1789
2885
  status: z.ZodEnum<{
1790
- ok: "ok";
1791
2886
  unavailable: "unavailable";
2887
+ ok: "ok";
1792
2888
  no_key: "no_key";
1793
2889
  http_error: "http_error";
1794
2890
  }>;
@@ -1845,6 +2941,17 @@ export declare const CONFIG_METHODS: {
1845
2941
  path: z.ZodString;
1846
2942
  }, z.core.$strip>;
1847
2943
  };
2944
+ /** TAL-797: `.env` edits through the Agent's locked writer; `null` removes a key, an empty value is skipped; line breaks, spaces, quotes, `#` and non-ASCII are refused. */
2945
+ readonly 'config.env_write': {
2946
+ readonly params: z.ZodObject<{
2947
+ profile_home: z.ZodString;
2948
+ updates: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
2949
+ }, z.core.$strip>;
2950
+ readonly result: z.ZodObject<{
2951
+ ok: z.ZodLiteral<true>;
2952
+ path: z.ZodString;
2953
+ }, z.core.$strip>;
2954
+ };
1848
2955
  readonly 'models.reasoning_efforts': {
1849
2956
  readonly params: z.ZodObject<{
1850
2957
  profile_home: z.ZodString;
@@ -1856,6 +2963,22 @@ export declare const CONFIG_METHODS: {
1856
2963
  supports_reasoning: z.ZodNullable<z.ZodBoolean>;
1857
2964
  }, z.core.$strip>;
1858
2965
  };
2966
+ /**
2967
+ * TAL-901: the Agent's personalities for `config` (its built-ins, then the top-level `personalities:` block, then
2968
+ * `agent.personalities`), by case-folded name in the Agent's order; `prompt` is the rendered overlay text.
2969
+ */
2970
+ readonly 'personalities.list': {
2971
+ readonly params: z.ZodObject<{
2972
+ config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2973
+ }, z.core.$strip>;
2974
+ readonly result: z.ZodObject<{
2975
+ personalities: z.ZodArray<z.ZodObject<{
2976
+ name: z.ZodString;
2977
+ description: z.ZodString;
2978
+ prompt: z.ZodString;
2979
+ }, z.core.$strip>>;
2980
+ }, z.core.$strip>;
2981
+ };
1859
2982
  };
1860
2983
  export declare const WORKTREE_METHODS: {
1861
2984
  readonly 'worktree.create': {
@@ -1930,13 +3053,6 @@ export declare const ChatUsageSchema: z.ZodObject<{
1930
3053
  cache_write_tokens: z.ZodNumber;
1931
3054
  estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
1932
3055
  }, z.core.$strip>;
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
- */
1940
3056
  export declare const ChatStartResultSchema: z.ZodObject<{
1941
3057
  status: z.ZodEnum<{
1942
3058
  error: "error";
@@ -1960,7 +3076,9 @@ export declare const ChatStartResultSchema: z.ZodObject<{
1960
3076
  cache_write_tokens: z.ZodNumber;
1961
3077
  estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
1962
3078
  }, z.core.$strip>;
1963
- context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3079
+ context: z.ZodObject<{
3080
+ next_turn_threshold_tokens: z.ZodOptional<z.ZodNumber>;
3081
+ }, z.core.$loose>;
1964
3082
  model: z.ZodString;
1965
3083
  provider: z.ZodString;
1966
3084
  compressed: z.ZodBoolean;
@@ -2027,6 +3145,38 @@ export declare const ChatStreamSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2027
3145
  }, z.core.$strip>, z.ZodObject<{
2028
3146
  event: z.ZodLiteral<"clarify_resolved">;
2029
3147
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3148
+ }, z.core.$strip>, z.ZodObject<{
3149
+ event: z.ZodLiteral<"connection">;
3150
+ data: z.ZodObject<{
3151
+ op_id: z.ZodString;
3152
+ settled: z.ZodBoolean;
3153
+ owner: z.ZodEnum<{
3154
+ session: "session";
3155
+ account: "account";
3156
+ }>;
3157
+ tool_call_id: z.ZodNullable<z.ZodString>;
3158
+ targets: z.ZodArray<z.ZodObject<{
3159
+ name: z.ZodString;
3160
+ kind: z.ZodString;
3161
+ state: z.ZodEnum<{
3162
+ pending: "pending";
3163
+ skipped: "skipped";
3164
+ initiated: "initiated";
3165
+ connected: "connected";
3166
+ failed: "failed";
3167
+ expired: "expired";
3168
+ not_connected: "not_connected";
3169
+ }>;
3170
+ detail: z.ZodString;
3171
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3172
+ required_env: z.ZodArray<z.ZodObject<{
3173
+ name: z.ZodString;
3174
+ prompt: z.ZodString;
3175
+ required: z.ZodBoolean;
3176
+ secret: z.ZodBoolean;
3177
+ }, z.core.$strip>>;
3178
+ }, z.core.$strip>>;
3179
+ }, z.core.$strip>;
2030
3180
  }, z.core.$strip>, z.ZodObject<{
2031
3181
  event: z.ZodLiteral<"approval_resolved">;
2032
3182
  data: z.ZodObject<{
@@ -2037,12 +3187,52 @@ export declare const ChatStreamSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2037
3187
  }, z.core.$strip>, z.ZodObject<{
2038
3188
  event: z.ZodLiteral<"compressing">;
2039
3189
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3190
+ }, z.core.$strip>, z.ZodObject<{
3191
+ event: z.ZodLiteral<"compression_finished">;
3192
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2040
3193
  }, z.core.$strip>, z.ZodObject<{
2041
3194
  event: z.ZodLiteral<"warning">;
2042
3195
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2043
3196
  }, z.core.$strip>, z.ZodObject<{
2044
3197
  event: z.ZodLiteral<"status">;
2045
3198
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3199
+ }, z.core.$strip>, z.ZodObject<{
3200
+ event: z.ZodLiteral<"notice">;
3201
+ data: z.ZodObject<{
3202
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3203
+ key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3204
+ level: z.ZodString;
3205
+ kind: z.ZodString;
3206
+ ttl_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
3207
+ text: z.ZodString;
3208
+ lapses_with_agent: z.ZodOptional<z.ZodBoolean>;
3209
+ }, z.core.$loose>;
3210
+ }, z.core.$strip>, z.ZodObject<{
3211
+ event: z.ZodLiteral<"notice_clear">;
3212
+ data: z.ZodObject<{
3213
+ key: z.ZodString;
3214
+ }, z.core.$loose>;
3215
+ }, z.core.$strip>, z.ZodObject<{
3216
+ event: z.ZodLiteral<"notices_reset">;
3217
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3218
+ }, z.core.$strip>, z.ZodObject<{
3219
+ event: z.ZodLiteral<"provider_phase">;
3220
+ data: z.ZodObject<{
3221
+ phase: z.ZodNullable<z.ZodObject<{
3222
+ phase: z.ZodLiteral<"prompt_reading">;
3223
+ progress_percent: z.ZodNullable<z.ZodNumber>;
3224
+ }, z.core.$strip>>;
3225
+ }, z.core.$strip>;
3226
+ }, z.core.$strip>, z.ZodObject<{
3227
+ event: z.ZodLiteral<"rate_limit_wait">;
3228
+ data: z.ZodObject<{
3229
+ provider: z.ZodNullable<z.ZodString>;
3230
+ until: z.ZodNullable<z.ZodNumber>;
3231
+ until_kind: z.ZodOptional<z.ZodEnum<{
3232
+ reset: "reset";
3233
+ retry: "retry";
3234
+ }>>;
3235
+ }, z.core.$loose>;
2046
3236
  }, z.core.$strip>], "event">;
2047
3237
  export declare const CHAT_METHODS: {
2048
3238
  readonly 'chat.start': {
@@ -2067,6 +3257,10 @@ export declare const CHAT_METHODS: {
2067
3257
  ephemeral_system_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2068
3258
  persist_user_message: z.ZodOptional<z.ZodString>;
2069
3259
  ephemeral: z.ZodOptional<z.ZodBoolean>;
3260
+ voice_turn: z.ZodOptional<z.ZodBoolean>;
3261
+ connect_card: z.ZodOptional<z.ZodBoolean>;
3262
+ skill_secret: z.ZodOptional<z.ZodBoolean>;
3263
+ workspace_local: z.ZodOptional<z.ZodBoolean>;
2070
3264
  }, z.core.$strip>;
2071
3265
  readonly result: z.ZodObject<{
2072
3266
  status: z.ZodEnum<{
@@ -2091,7 +3285,9 @@ export declare const CHAT_METHODS: {
2091
3285
  cache_write_tokens: z.ZodNumber;
2092
3286
  estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
2093
3287
  }, z.core.$strip>;
2094
- context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3288
+ context: z.ZodObject<{
3289
+ next_turn_threshold_tokens: z.ZodOptional<z.ZodNumber>;
3290
+ }, z.core.$loose>;
2095
3291
  model: z.ZodString;
2096
3292
  provider: z.ZodString;
2097
3293
  compressed: z.ZodBoolean;
@@ -2158,6 +3354,38 @@ export declare const CHAT_METHODS: {
2158
3354
  }, z.core.$strip>, z.ZodObject<{
2159
3355
  event: z.ZodLiteral<"clarify_resolved">;
2160
3356
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3357
+ }, z.core.$strip>, z.ZodObject<{
3358
+ event: z.ZodLiteral<"connection">;
3359
+ data: z.ZodObject<{
3360
+ op_id: z.ZodString;
3361
+ settled: z.ZodBoolean;
3362
+ owner: z.ZodEnum<{
3363
+ session: "session";
3364
+ account: "account";
3365
+ }>;
3366
+ tool_call_id: z.ZodNullable<z.ZodString>;
3367
+ targets: z.ZodArray<z.ZodObject<{
3368
+ name: z.ZodString;
3369
+ kind: z.ZodString;
3370
+ state: z.ZodEnum<{
3371
+ pending: "pending";
3372
+ skipped: "skipped";
3373
+ initiated: "initiated";
3374
+ connected: "connected";
3375
+ failed: "failed";
3376
+ expired: "expired";
3377
+ not_connected: "not_connected";
3378
+ }>;
3379
+ detail: z.ZodString;
3380
+ connect_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3381
+ required_env: z.ZodArray<z.ZodObject<{
3382
+ name: z.ZodString;
3383
+ prompt: z.ZodString;
3384
+ required: z.ZodBoolean;
3385
+ secret: z.ZodBoolean;
3386
+ }, z.core.$strip>>;
3387
+ }, z.core.$strip>>;
3388
+ }, z.core.$strip>;
2161
3389
  }, z.core.$strip>, z.ZodObject<{
2162
3390
  event: z.ZodLiteral<"approval_resolved">;
2163
3391
  data: z.ZodObject<{
@@ -2168,12 +3396,52 @@ export declare const CHAT_METHODS: {
2168
3396
  }, z.core.$strip>, z.ZodObject<{
2169
3397
  event: z.ZodLiteral<"compressing">;
2170
3398
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3399
+ }, z.core.$strip>, z.ZodObject<{
3400
+ event: z.ZodLiteral<"compression_finished">;
3401
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2171
3402
  }, z.core.$strip>, z.ZodObject<{
2172
3403
  event: z.ZodLiteral<"warning">;
2173
3404
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2174
3405
  }, z.core.$strip>, z.ZodObject<{
2175
3406
  event: z.ZodLiteral<"status">;
2176
3407
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3408
+ }, z.core.$strip>, z.ZodObject<{
3409
+ event: z.ZodLiteral<"notice">;
3410
+ data: z.ZodObject<{
3411
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3412
+ key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3413
+ level: z.ZodString;
3414
+ kind: z.ZodString;
3415
+ ttl_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
3416
+ text: z.ZodString;
3417
+ lapses_with_agent: z.ZodOptional<z.ZodBoolean>;
3418
+ }, z.core.$loose>;
3419
+ }, z.core.$strip>, z.ZodObject<{
3420
+ event: z.ZodLiteral<"notice_clear">;
3421
+ data: z.ZodObject<{
3422
+ key: z.ZodString;
3423
+ }, z.core.$loose>;
3424
+ }, z.core.$strip>, z.ZodObject<{
3425
+ event: z.ZodLiteral<"notices_reset">;
3426
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3427
+ }, z.core.$strip>, z.ZodObject<{
3428
+ event: z.ZodLiteral<"provider_phase">;
3429
+ data: z.ZodObject<{
3430
+ phase: z.ZodNullable<z.ZodObject<{
3431
+ phase: z.ZodLiteral<"prompt_reading">;
3432
+ progress_percent: z.ZodNullable<z.ZodNumber>;
3433
+ }, z.core.$strip>>;
3434
+ }, z.core.$strip>;
3435
+ }, z.core.$strip>, z.ZodObject<{
3436
+ event: z.ZodLiteral<"rate_limit_wait">;
3437
+ data: z.ZodObject<{
3438
+ provider: z.ZodNullable<z.ZodString>;
3439
+ until: z.ZodNullable<z.ZodNumber>;
3440
+ until_kind: z.ZodOptional<z.ZodEnum<{
3441
+ reset: "reset";
3442
+ retry: "retry";
3443
+ }>>;
3444
+ }, z.core.$loose>;
2177
3445
  }, z.core.$strip>], "event">;
2178
3446
  };
2179
3447
  readonly 'chat.interrupt': {
@@ -2220,7 +3488,7 @@ export declare const CHAT_METHODS: {
2220
3488
  /**
2221
3489
  * TAL-424: deliver `pending[index]` now with the Agent's `redirect`: `delivery: redirect` restarts the model request with
2222
3490
  * it, `delivery: steer` puts it last on the slot while tools yield. Not redirected: it stays pending, `requeued` in its
2223
- * place (`kept`) or last (`last`); `withdrawn: false` when the Agent already took it.
3491
+ * place (`kept`) or last (`last`); `withdrawn: false` when the Agent already took it, or `reason: not_running` when the run or Agent is absent.
2224
3492
  */
2225
3493
  readonly 'chat.steer_now': {
2226
3494
  readonly params: z.ZodObject<{
@@ -2240,6 +3508,9 @@ export declare const CHAT_METHODS: {
2240
3508
  kept: "kept";
2241
3509
  last: "last";
2242
3510
  }>>;
3511
+ reason: z.ZodOptional<z.ZodEnum<{
3512
+ not_running: "not_running";
3513
+ }>>;
2243
3514
  }, z.core.$strip>;
2244
3515
  };
2245
3516
  /**
@@ -2287,6 +3558,19 @@ export declare const CHAT_METHODS: {
2287
3558
  finalized: z.ZodBoolean;
2288
3559
  }, z.core.$strip>;
2289
3560
  };
3561
+ readonly 'chat.finalize_session': {
3562
+ readonly params: z.ZodObject<{
3563
+ profile_home: z.ZodString;
3564
+ session_id: z.ZodString;
3565
+ reason: z.ZodEnum<{
3566
+ delete: "delete";
3567
+ clear: "clear";
3568
+ }>;
3569
+ }, z.core.$strip>;
3570
+ readonly result: z.ZodObject<{
3571
+ messages: z.ZodArray<z.ZodString>;
3572
+ }, z.core.$strip>;
3573
+ };
2290
3574
  readonly 'chat.evict_agent': {
2291
3575
  readonly params: z.ZodObject<{
2292
3576
  session_id: z.ZodString;
@@ -2305,6 +3589,33 @@ export declare const CHAT_METHODS: {
2305
3589
  committed: z.ZodBoolean;
2306
3590
  }, z.core.$strip>;
2307
3591
  };
3592
+ /**
3593
+ * TAL-902: `/refine [focus]`, the Agent's on-demand memory/skill review of `messages` (the session's model context) on the
3594
+ * session's cached agent, else one built from the turn parameters and cached like a turn's. `output` is the Agent's
3595
+ * wording: the review started, or why not (a turn is running, the conversation is empty).
3596
+ */
3597
+ readonly 'chat.refine': {
3598
+ readonly params: z.ZodObject<{
3599
+ profile_home: z.ZodString;
3600
+ session_id: z.ZodString;
3601
+ messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3602
+ focus: z.ZodString;
3603
+ model: z.ZodString;
3604
+ model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3605
+ enabled_toolsets: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
3606
+ max_iterations: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
3607
+ max_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
3608
+ reasoning_config: z.ZodOptional<z.ZodNullable<z.ZodObject<{
3609
+ enabled: z.ZodBoolean;
3610
+ effort: z.ZodOptional<z.ZodString>;
3611
+ }, z.core.$strip>>>;
3612
+ workspace: z.ZodOptional<z.ZodString>;
3613
+ workspace_local: z.ZodOptional<z.ZodBoolean>;
3614
+ }, z.core.$strip>;
3615
+ readonly result: z.ZodObject<{
3616
+ output: z.ZodString;
3617
+ }, z.core.$strip>;
3618
+ };
2308
3619
  readonly 'approval.respond': {
2309
3620
  readonly params: z.ZodObject<{
2310
3621
  profile_home: z.ZodString;
@@ -2356,6 +3667,112 @@ export declare const CHAT_METHODS: {
2356
3667
  };
2357
3668
  export declare const GATEWAY_ACTIONS: readonly ["start", "stop", "restart"];
2358
3669
  export declare const GATEWAY_METHODS: {
3670
+ readonly 'gateway.session': {
3671
+ readonly params: z.ZodObject<{
3672
+ profile_home: z.ZodString;
3673
+ session_id: z.ZodString;
3674
+ action: z.ZodEnum<{
3675
+ snapshot: "snapshot";
3676
+ receipt: "receipt";
3677
+ watch: "watch";
3678
+ submit: "submit";
3679
+ cancel: "cancel";
3680
+ interrupt: "interrupt";
3681
+ approval: "approval";
3682
+ clarify: "clarify";
3683
+ discard: "discard";
3684
+ mutate: "mutate";
3685
+ }>;
3686
+ request_id: z.ZodOptional<z.ZodString>;
3687
+ text: z.ZodOptional<z.ZodString>;
3688
+ admission_id: z.ZodOptional<z.ZodString>;
3689
+ execution_generation: z.ZodOptional<z.ZodNumber>;
3690
+ prompt_id: z.ZodOptional<z.ZodString>;
3691
+ choice: z.ZodOptional<z.ZodEnum<{
3692
+ once: "once";
3693
+ session: "session";
3694
+ always: "always";
3695
+ deny: "deny";
3696
+ }>>;
3697
+ expected_revision: z.ZodOptional<z.ZodNumber>;
3698
+ operation: z.ZodOptional<z.ZodEnum<{
3699
+ rename: "rename";
3700
+ archive: "archive";
3701
+ sidebar: "sidebar";
3702
+ branch: "branch";
3703
+ delete: "delete";
3704
+ rewind: "rewind";
3705
+ reset: "reset";
3706
+ model: "model";
3707
+ workspace: "workspace";
3708
+ compress: "compress";
3709
+ }>>;
3710
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3711
+ }, z.core.$strip>;
3712
+ readonly result: z.ZodObject<{
3713
+ state: z.ZodEnum<{
3714
+ attached: "attached";
3715
+ stopped: "stopped";
3716
+ unavailable: "unavailable";
3717
+ incompatible: "incompatible";
3718
+ refused: "refused";
3719
+ }>;
3720
+ reason: z.ZodNullable<z.ZodString>;
3721
+ replay_gap: z.ZodOptional<z.ZodBoolean>;
3722
+ snapshot: z.ZodNullable<z.ZodObject<{
3723
+ session_id: z.ZodString;
3724
+ stored_session_id: z.ZodString;
3725
+ messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3726
+ message_count: z.ZodNumber;
3727
+ running: z.ZodBoolean;
3728
+ authority_epoch: z.ZodNumber;
3729
+ replay_epoch: z.ZodString;
3730
+ last_sequence: z.ZodNumber;
3731
+ subscription_id: z.ZodString;
3732
+ revision: z.ZodNumber;
3733
+ execution_generation: z.ZodNumber;
3734
+ pending: z.ZodArray<z.ZodObject<{
3735
+ admission_id: z.ZodString;
3736
+ sequence: z.ZodNumber;
3737
+ status: z.ZodEnum<{
3738
+ unknown: "unknown";
3739
+ queued: "queued";
3740
+ started: "started";
3741
+ terminal: "terminal";
3742
+ }>;
3743
+ outcome: z.ZodNullable<z.ZodString>;
3744
+ authority_epoch: z.ZodNumber;
3745
+ execution_generation: z.ZodNullable<z.ZodNumber>;
3746
+ text: z.ZodOptional<z.ZodString>;
3747
+ input_id: z.ZodOptional<z.ZodString>;
3748
+ }, z.core.$strip>>;
3749
+ prompts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3750
+ info: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3751
+ }, z.core.$strip>>;
3752
+ receipt: z.ZodNullable<z.ZodObject<{
3753
+ admission_id: z.ZodString;
3754
+ sequence: z.ZodNumber;
3755
+ status: z.ZodEnum<{
3756
+ unknown: "unknown";
3757
+ queued: "queued";
3758
+ started: "started";
3759
+ terminal: "terminal";
3760
+ }>;
3761
+ outcome: z.ZodNullable<z.ZodString>;
3762
+ authority_epoch: z.ZodNumber;
3763
+ execution_generation: z.ZodNullable<z.ZodNumber>;
3764
+ text: z.ZodOptional<z.ZodString>;
3765
+ input_id: z.ZodOptional<z.ZodString>;
3766
+ }, z.core.$strip>>;
3767
+ }, z.core.$strip>;
3768
+ readonly stream: z.ZodObject<{
3769
+ event: z.ZodEnum<{
3770
+ snapshot: "snapshot";
3771
+ event: "event";
3772
+ }>;
3773
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3774
+ }, z.core.$strip>;
3775
+ };
2359
3776
  readonly 'gateway.control': {
2360
3777
  readonly params: z.ZodObject<{
2361
3778
  profile_home: z.ZodString;
@@ -2370,13 +3787,14 @@ export declare const GATEWAY_METHODS: {
2370
3787
  }, z.core.$strip>;
2371
3788
  readonly result: z.ZodObject<{
2372
3789
  status: z.ZodEnum<{
2373
- completed: "completed";
2374
3790
  failed: "failed";
3791
+ completed: "completed";
2375
3792
  busy: "busy";
2376
3793
  }>;
2377
3794
  message: z.ZodString;
2378
3795
  detail: z.ZodOptional<z.ZodString>;
2379
3796
  returncode: z.ZodOptional<z.ZodNumber>;
3797
+ reason: z.ZodOptional<z.ZodString>;
2380
3798
  timed_out: z.ZodOptional<z.ZodBoolean>;
2381
3799
  }, z.core.$strip>;
2382
3800
  readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2398,13 +3816,14 @@ export declare const GATEWAY_METHODS: {
2398
3816
  }, z.core.$strip>;
2399
3817
  readonly result: z.ZodObject<{
2400
3818
  status: z.ZodEnum<{
2401
- completed: "completed";
2402
3819
  failed: "failed";
3820
+ completed: "completed";
2403
3821
  busy: "busy";
2404
3822
  }>;
2405
3823
  message: z.ZodString;
2406
3824
  detail: z.ZodOptional<z.ZodString>;
2407
3825
  returncode: z.ZodOptional<z.ZodNumber>;
3826
+ reason: z.ZodOptional<z.ZodString>;
2408
3827
  timed_out: z.ZodOptional<z.ZodBoolean>;
2409
3828
  }, z.core.$strip>;
2410
3829
  readonly stream: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2417,4 +3836,21 @@ export declare const GATEWAY_METHODS: {
2417
3836
  }, z.core.$strip>;
2418
3837
  }, z.core.$strip>], "event">;
2419
3838
  };
3839
+ /** TAL-805: the gateway mode of the profile `name` at `profile_home`; the root profile (`is_default`) is the host itself. */
3840
+ readonly 'gateway.mode': {
3841
+ readonly params: z.ZodObject<{
3842
+ profile_home: z.ZodString;
3843
+ name: z.ZodString;
3844
+ is_default: z.ZodBoolean;
3845
+ }, z.core.$strip>;
3846
+ readonly result: z.ZodObject<{
3847
+ gateway_mode: z.ZodEnum<{
3848
+ stopped: "stopped";
3849
+ parked: "parked";
3850
+ own: "own";
3851
+ served: "served";
3852
+ standalone: "standalone";
3853
+ }>;
3854
+ }, z.core.$strip>;
3855
+ };
2420
3856
  };