@sayknow-cli/coding-agent 0.3.12 → 0.3.15

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 (248) hide show
  1. package/dist/types/autoresearch/tools/init-experiment.d.ts +1 -1
  2. package/dist/types/autoresearch/tools/log-experiment.d.ts +2 -2
  3. package/dist/types/cli/classify-install-target.d.ts +0 -10
  4. package/dist/types/cli/daemon-cli.d.ts +2 -0
  5. package/dist/types/cli/initial-message.d.ts +1 -1
  6. package/dist/types/cli/malloc-env-guard.d.ts +65 -0
  7. package/dist/types/cli/malloc-env-guard.test.d.ts +1 -0
  8. package/dist/types/cli/notify-cli.d.ts +3 -1
  9. package/dist/types/cli/session-picker.d.ts +4 -3
  10. package/dist/types/cli/update-cli.d.ts +22 -3
  11. package/dist/types/cli.d.ts +5 -0
  12. package/dist/types/commands/daemon.d.ts +6 -2
  13. package/dist/types/commands/launch.d.ts +1 -0
  14. package/dist/types/commands/notify.d.ts +6 -0
  15. package/dist/types/commands/web-search.d.ts +1 -1
  16. package/dist/types/commit/agentic/tools/propose-changelog.d.ts +4 -4
  17. package/dist/types/commit/agentic/tools/propose-commit.d.ts +9 -9
  18. package/dist/types/commit/agentic/tools/schemas.d.ts +9 -9
  19. package/dist/types/commit/agentic/tools/split-commit.d.ts +9 -9
  20. package/dist/types/commit/analysis/conventional.d.ts +1 -1
  21. package/dist/types/commit/analysis/summary.d.ts +1 -1
  22. package/dist/types/commit/changelog/generate.d.ts +3 -3
  23. package/dist/types/commit/changelog/index.d.ts +2 -2
  24. package/dist/types/commit/map-reduce/map-phase.d.ts +1 -1
  25. package/dist/types/commit/map-reduce/reduce-phase.d.ts +1 -1
  26. package/dist/types/commit/shared-llm.d.ts +9 -9
  27. package/dist/types/config/keybindings.d.ts +134 -129
  28. package/dist/types/config/model-profile-activation.d.ts +1 -0
  29. package/dist/types/config/model-registry.d.ts +35 -35
  30. package/dist/types/config/models-config-schema.d.ts +111 -111
  31. package/dist/types/config/settings-schema.d.ts +56 -16
  32. package/dist/types/config/settings.d.ts +2 -0
  33. package/dist/types/coordinator/contract.d.ts +1 -1
  34. package/dist/types/coordinator-mcp/model-preset.d.ts +45 -0
  35. package/dist/types/coordinator-mcp/policy.d.ts +3 -0
  36. package/dist/types/coordinator-mcp/server.d.ts +79 -6
  37. package/dist/types/coordinator-mcp/session-reaper.d.ts +53 -0
  38. package/dist/types/daemon/control-types.d.ts +10 -0
  39. package/dist/types/daemon/operator-contract.d.ts +47 -0
  40. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/models/catalog.d.ts +4 -0
  41. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/errors.d.ts +12 -12
  42. package/dist/types/discovery/helpers.d.ts +1 -1
  43. package/dist/types/discovery/substitute-plugin-root.d.ts +0 -4
  44. package/dist/types/edit/modes/patch.d.ts +2 -2
  45. package/dist/types/extensibility/extensions/types.d.ts +3 -1
  46. package/dist/types/goals/tools/goal-tool.d.ts +6 -6
  47. package/dist/types/i18n/messages/en.d.ts +8 -8
  48. package/dist/types/internal-urls/local-protocol.d.ts +13 -9
  49. package/dist/types/lsp/index.d.ts +9 -9
  50. package/dist/types/lsp/types.d.ts +9 -9
  51. package/dist/types/main.d.ts +66 -2
  52. package/dist/types/modes/acp/acp-agent.d.ts +19 -2
  53. package/dist/types/modes/acp/acp-mode.d.ts +12 -0
  54. package/dist/types/modes/components/assistant-message.d.ts +1 -1
  55. package/dist/types/modes/components/custom-editor.d.ts +2 -0
  56. package/dist/types/modes/components/hook-selector.d.ts +5 -0
  57. package/dist/types/modes/components/irc-sidebar.d.ts +32 -0
  58. package/dist/types/modes/components/pet-selector.d.ts +11 -0
  59. package/dist/types/modes/components/sayknow-pet-widget.d.ts +59 -0
  60. package/dist/types/modes/components/session-selector.d.ts +22 -9
  61. package/dist/types/modes/components/settings-selector.d.ts +2 -0
  62. package/dist/types/modes/components/status-line/types.d.ts +1 -1
  63. package/dist/types/modes/components/status-line.d.ts +0 -10
  64. package/dist/types/modes/components/tool-execution.d.ts +1 -0
  65. package/dist/types/modes/components/user-message.d.ts +2 -1
  66. package/dist/types/modes/controllers/event-controller.d.ts +4 -0
  67. package/dist/types/modes/controllers/selector-controller.d.ts +1 -0
  68. package/dist/types/modes/interactive-mode.d.ts +24 -2
  69. package/dist/types/modes/irc-observation-ledger.d.ts +22 -0
  70. package/dist/types/modes/print-mode.d.ts +3 -4
  71. package/dist/types/modes/rpc/rpc-client.d.ts +7 -1
  72. package/dist/types/modes/rpc/rpc-mode.d.ts +2 -1
  73. package/dist/types/modes/rpc/rpc-types.d.ts +17 -1
  74. package/dist/types/modes/shared/agent-wire/deep-interview-gate.d.ts +8 -0
  75. package/dist/types/modes/shared/agent-wire/unattended-run-controller.d.ts +5 -0
  76. package/dist/types/modes/shared/agent-wire/unattended-session.d.ts +45 -0
  77. package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts +42 -2
  78. package/dist/types/modes/theme/defaults/index.d.ts +568 -568
  79. package/dist/types/modes/types.d.ts +28 -2
  80. package/dist/types/modes/utils/abort-message.d.ts +1 -1
  81. package/dist/types/modes/utils/context-usage.d.ts +4 -19
  82. package/dist/types/modes/utils/irc-message.d.ts +38 -0
  83. package/dist/types/modes/utils/ui-helpers.d.ts +13 -4
  84. package/dist/types/notifications/config.d.ts +34 -0
  85. package/dist/types/notifications/daemon-paths.d.ts +7 -0
  86. package/dist/types/notifications/index.d.ts +27 -0
  87. package/dist/types/notifications/lifecycle-control-runtime.d.ts +12 -4
  88. package/dist/types/notifications/notification-service.d.ts +144 -0
  89. package/dist/types/notifications/rate-limit-pool.d.ts +27 -9
  90. package/dist/types/notifications/telegram-daemon-control.d.ts +6 -0
  91. package/dist/types/notifications/telegram-daemon.d.ts +130 -3
  92. package/dist/types/notifications/telegram-reference.d.ts +19 -2
  93. package/dist/types/notifications/topic-registry.d.ts +24 -4
  94. package/dist/types/registry/agent-registry.d.ts +2 -0
  95. package/dist/types/rlm/index.d.ts +1 -1
  96. package/dist/types/sdk.d.ts +2 -0
  97. package/dist/types/secrets/obfuscator.d.ts +1 -1
  98. package/dist/types/session/agent-session.d.ts +40 -3
  99. package/dist/types/session/cache-economics.d.ts +79 -0
  100. package/dist/types/session/context-estimation.d.ts +31 -0
  101. package/dist/types/session/provider-safety-stop.d.ts +5 -0
  102. package/dist/types/session/session-manager.d.ts +124 -4
  103. package/dist/types/session/session-storage.d.ts +155 -13
  104. package/dist/types/setup/credential-auto-import.d.ts +2 -2
  105. package/dist/types/skc-runtime/session-state-sidecar.d.ts +34 -3
  106. package/dist/types/skc-runtime/state-schema.d.ts +19 -19
  107. package/dist/types/skc-runtime/tmux-common.d.ts +6 -0
  108. package/dist/types/skc-runtime/tmux-owner-isolation-cli.d.ts +5 -0
  109. package/dist/types/skc-runtime/tmux-owner-isolation.d.ts +309 -0
  110. package/dist/types/skc-runtime/tmux-sessions.d.ts +49 -17
  111. package/dist/types/task/agents.d.ts +2 -2
  112. package/dist/types/task/executor.d.ts +3 -0
  113. package/dist/types/task/receipt.d.ts +3 -1
  114. package/dist/types/task/types.d.ts +35 -27
  115. package/dist/types/tools/ask-answer-registry.d.ts +5 -0
  116. package/dist/types/tools/bash.d.ts +1 -1
  117. package/dist/types/tools/browser/tab-supervisor.d.ts +6 -0
  118. package/dist/types/tools/browser.d.ts +28 -28
  119. package/dist/types/tools/computer.d.ts +20 -20
  120. package/dist/types/tools/cron.d.ts +2 -2
  121. package/dist/types/tools/debug.d.ts +40 -40
  122. package/dist/types/tools/gh.d.ts +10 -10
  123. package/dist/types/tools/image-gen.d.ts +2 -2
  124. package/dist/types/tools/index.d.ts +58 -6
  125. package/dist/types/tools/monitor.d.ts +6 -6
  126. package/dist/types/tools/skill-discovery.d.ts +4 -4
  127. package/dist/types/tools/subagent.d.ts +12 -12
  128. package/dist/types/tools/telegram-send.d.ts +7 -0
  129. package/dist/types/tools/todo-write.d.ts +8 -8
  130. package/dist/types/utils/external-editor.d.ts +2 -0
  131. package/dist/types/web/insane/bridge.d.ts +9 -9
  132. package/dist/types/web/search/index.d.ts +4 -4
  133. package/package.json +8 -8
  134. package/scripts/g004-tmux-smoke.ts +196 -36
  135. package/src/cli/daemon-cli.ts +19 -29
  136. package/src/cli/malloc-env-guard.test.ts +104 -0
  137. package/src/cli/malloc-env-guard.ts +149 -0
  138. package/src/cli/notify-cli.ts +78 -14
  139. package/src/cli/session-picker.ts +23 -40
  140. package/src/cli/update-cli.ts +56 -37
  141. package/src/cli.ts +51 -10
  142. package/src/commands/daemon.ts +19 -5
  143. package/src/commands/harness.ts +515 -47
  144. package/src/commands/launch.ts +11 -3
  145. package/src/commands/notify.ts +5 -1
  146. package/src/commands/session.ts +6 -1
  147. package/src/config/keybindings.ts +5 -0
  148. package/src/config/model-profile-activation.ts +1 -1
  149. package/src/config/model-profiles.ts +14 -14
  150. package/src/config/settings-schema.ts +41 -1
  151. package/src/config/settings.ts +96 -45
  152. package/src/coordinator/contract.ts +1 -0
  153. package/src/coordinator-mcp/model-preset.ts +100 -0
  154. package/src/coordinator-mcp/policy.ts +30 -0
  155. package/src/coordinator-mcp/server.ts +2958 -430
  156. package/src/coordinator-mcp/session-reaper.ts +129 -0
  157. package/src/daemon/control-types.ts +11 -0
  158. package/src/daemon/operator-contract.ts +121 -0
  159. package/src/defaults/skc/extensions/grok-cli-vendor/src/models/catalog.ts +57 -17
  160. package/src/defaults/skc/extensions/grok-cli-vendor/src/payload/sanitize.ts +15 -2
  161. package/src/defaults/skc/extensions/grok-cli-vendor/src/provider/register.ts +5 -1
  162. package/src/extensibility/extensions/runner.ts +1 -1
  163. package/src/extensibility/extensions/types.ts +3 -1
  164. package/src/internal-urls/docs-index.generated.ts +10 -9
  165. package/src/internal-urls/local-protocol.ts +29 -10
  166. package/src/main.ts +301 -80
  167. package/src/modes/acp/acp-agent.ts +730 -100
  168. package/src/modes/acp/acp-mode.ts +29 -2
  169. package/src/modes/components/assistant-message.ts +32 -3
  170. package/src/modes/components/bash-execution.ts +43 -13
  171. package/src/modes/components/custom-editor.ts +5 -0
  172. package/src/modes/components/footer.ts +3 -3
  173. package/src/modes/components/hook-selector.ts +12 -0
  174. package/src/modes/components/irc-sidebar.ts +206 -0
  175. package/src/modes/components/pet-selector.ts +55 -0
  176. package/src/modes/components/sayknow-pet-widget.ts +360 -0
  177. package/src/modes/components/session-selector.ts +222 -221
  178. package/src/modes/components/settings-selector.ts +10 -0
  179. package/src/modes/components/status-line/segments.ts +14 -7
  180. package/src/modes/components/status-line/types.ts +1 -1
  181. package/src/modes/components/status-line.ts +4 -171
  182. package/src/modes/components/tool-execution.ts +47 -6
  183. package/src/modes/components/user-message.ts +26 -9
  184. package/src/modes/controllers/command-controller.ts +28 -2
  185. package/src/modes/controllers/event-controller.ts +159 -36
  186. package/src/modes/controllers/extension-ui-controller.ts +37 -18
  187. package/src/modes/controllers/input-controller.ts +8 -2
  188. package/src/modes/controllers/selector-controller.ts +62 -15
  189. package/src/modes/interactive-mode.ts +199 -7
  190. package/src/modes/irc-observation-ledger.ts +127 -0
  191. package/src/modes/print-mode.ts +228 -92
  192. package/src/modes/rpc/rpc-client.ts +58 -1
  193. package/src/modes/rpc/rpc-mode.ts +286 -85
  194. package/src/modes/rpc/rpc-types.ts +15 -1
  195. package/src/modes/shared/agent-wire/command-dispatch.ts +33 -1
  196. package/src/modes/shared/agent-wire/command-validation.ts +10 -0
  197. package/src/modes/shared/agent-wire/deep-interview-gate.ts +45 -2
  198. package/src/modes/shared/agent-wire/scopes.ts +1 -0
  199. package/src/modes/shared/agent-wire/unattended-session.ts +288 -1
  200. package/src/modes/shared/agent-wire/workflow-gate-broker.ts +130 -20
  201. package/src/modes/types.ts +34 -2
  202. package/src/modes/utils/context-usage.ts +56 -92
  203. package/src/modes/utils/hotkeys-markdown.ts +1 -0
  204. package/src/modes/utils/irc-message.ts +138 -0
  205. package/src/modes/utils/ui-helpers.ts +216 -50
  206. package/src/notifications/config.ts +44 -0
  207. package/src/notifications/daemon-paths.ts +8 -0
  208. package/src/notifications/index.ts +535 -75
  209. package/src/notifications/lifecycle-control-runtime.ts +930 -77
  210. package/src/notifications/notification-service.ts +710 -0
  211. package/src/notifications/rate-limit-pool.ts +46 -12
  212. package/src/notifications/telegram-daemon-control.ts +27 -2
  213. package/src/notifications/telegram-daemon.ts +635 -94
  214. package/src/notifications/telegram-reference.ts +73 -13
  215. package/src/notifications/topic-registry.ts +86 -9
  216. package/src/prompts/system/irc-peer-roster.md +1 -0
  217. package/src/prompts/system/subagent-system-prompt.md +1 -0
  218. package/src/prompts/system/system-prompt.md +1 -0
  219. package/src/prompts/tools/irc.md +1 -1
  220. package/src/registry/agent-registry.ts +3 -0
  221. package/src/sdk.ts +52 -1
  222. package/src/secrets/obfuscator.ts +4 -2
  223. package/src/session/agent-session.ts +670 -217
  224. package/src/session/cache-economics.ts +275 -0
  225. package/src/session/context-estimation.ts +91 -0
  226. package/src/session/provider-safety-stop.ts +9 -0
  227. package/src/session/session-dump-format.ts +6 -0
  228. package/src/session/session-manager.ts +809 -39
  229. package/src/session/session-storage.ts +582 -38
  230. package/src/skc-runtime/session-state-sidecar.ts +756 -135
  231. package/src/skc-runtime/tmux-common.ts +26 -7
  232. package/src/skc-runtime/tmux-gc.ts +52 -9
  233. package/src/skc-runtime/tmux-owner-isolation-cli.ts +185 -0
  234. package/src/skc-runtime/tmux-owner-isolation.ts +2060 -0
  235. package/src/skc-runtime/tmux-sessions.ts +871 -68
  236. package/src/slash-commands/builtin-registry.ts +153 -9
  237. package/src/slash-commands/helpers/context-report.ts +26 -4
  238. package/src/task/executor.ts +12 -3
  239. package/src/task/index.ts +8 -0
  240. package/src/task/receipt.ts +7 -2
  241. package/src/task/types.ts +26 -0
  242. package/src/tools/ask-answer-registry.ts +25 -0
  243. package/src/tools/browser/tab-supervisor.ts +63 -6
  244. package/src/tools/browser.ts +8 -3
  245. package/src/tools/index.ts +81 -6
  246. package/src/tools/sqlite-reader.ts +8 -4
  247. package/src/tui/output-block.ts +18 -6
  248. package/src/utils/external-editor.ts +6 -1
@@ -8,10 +8,10 @@ export { extractReadableFromHtml, type ReadableFormat, type ReadableResult } fro
8
8
  export type { Observation, ObservationEntry } from "./browser/tab-protocol";
9
9
  declare const browserSchema: z.ZodObject<{
10
10
  action: z.ZodEnum<{
11
- act: "act";
12
- close: "close";
13
11
  open: "open";
12
+ close: "close";
14
13
  run: "run";
14
+ act: "act";
15
15
  }>;
16
16
  name: z.ZodOptional<z.ZodString>;
17
17
  url: z.ZodOptional<z.ZodString>;
@@ -35,8 +35,8 @@ declare const browserSchema: z.ZodObject<{
35
35
  scale: z.ZodOptional<z.ZodNumber>;
36
36
  }, z.core.$strip>>;
37
37
  wait_until: z.ZodOptional<z.ZodEnum<{
38
- domcontentloaded: "domcontentloaded";
39
38
  load: "load";
39
+ domcontentloaded: "domcontentloaded";
40
40
  networkidle0: "networkidle0";
41
41
  networkidle2: "networkidle2";
42
42
  }>>;
@@ -47,18 +47,18 @@ declare const browserSchema: z.ZodObject<{
47
47
  code: z.ZodOptional<z.ZodString>;
48
48
  actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
49
49
  verb: z.ZodEnum<{
50
- back: "back";
51
- click: "click";
52
- extract: "extract";
50
+ type: "type";
53
51
  fill: "fill";
52
+ wait: "wait";
54
53
  navigate: "navigate";
55
- observe: "observe";
54
+ click: "click";
55
+ select: "select";
56
56
  press: "press";
57
- screenshot: "screenshot";
58
57
  scroll: "scroll";
59
- select: "select";
60
- type: "type";
61
- wait: "wait";
58
+ back: "back";
59
+ observe: "observe";
60
+ extract: "extract";
61
+ screenshot: "screenshot";
62
62
  }>;
63
63
  id: z.ZodOptional<z.ZodNumber>;
64
64
  selector: z.ZodOptional<z.ZodString>;
@@ -71,13 +71,13 @@ declare const browserSchema: z.ZodObject<{
71
71
  dy: z.ZodOptional<z.ZodNumber>;
72
72
  ms: z.ZodOptional<z.ZodNumber>;
73
73
  format: z.ZodOptional<z.ZodEnum<{
74
- html: "html";
75
- markdown: "markdown";
76
74
  text: "text";
75
+ markdown: "markdown";
76
+ html: "html";
77
77
  }>>;
78
78
  wait_until: z.ZodOptional<z.ZodEnum<{
79
- domcontentloaded: "domcontentloaded";
80
79
  load: "load";
80
+ domcontentloaded: "domcontentloaded";
81
81
  networkidle0: "networkidle0";
82
82
  networkidle2: "networkidle2";
83
83
  }>>;
@@ -122,10 +122,10 @@ export declare class BrowserTool implements AgentTool<typeof browserSchema, Brow
122
122
  readonly summary = "Control a headless browser to navigate and interact with web pages";
123
123
  readonly parameters: z.ZodObject<{
124
124
  action: z.ZodEnum<{
125
- act: "act";
126
- close: "close";
127
125
  open: "open";
126
+ close: "close";
128
127
  run: "run";
128
+ act: "act";
129
129
  }>;
130
130
  name: z.ZodOptional<z.ZodString>;
131
131
  url: z.ZodOptional<z.ZodString>;
@@ -149,8 +149,8 @@ export declare class BrowserTool implements AgentTool<typeof browserSchema, Brow
149
149
  scale: z.ZodOptional<z.ZodNumber>;
150
150
  }, z.core.$strip>>;
151
151
  wait_until: z.ZodOptional<z.ZodEnum<{
152
- domcontentloaded: "domcontentloaded";
153
152
  load: "load";
153
+ domcontentloaded: "domcontentloaded";
154
154
  networkidle0: "networkidle0";
155
155
  networkidle2: "networkidle2";
156
156
  }>>;
@@ -161,18 +161,18 @@ export declare class BrowserTool implements AgentTool<typeof browserSchema, Brow
161
161
  code: z.ZodOptional<z.ZodString>;
162
162
  actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
163
163
  verb: z.ZodEnum<{
164
- back: "back";
165
- click: "click";
166
- extract: "extract";
164
+ type: "type";
167
165
  fill: "fill";
166
+ wait: "wait";
168
167
  navigate: "navigate";
169
- observe: "observe";
168
+ click: "click";
169
+ select: "select";
170
170
  press: "press";
171
- screenshot: "screenshot";
172
171
  scroll: "scroll";
173
- select: "select";
174
- type: "type";
175
- wait: "wait";
172
+ back: "back";
173
+ observe: "observe";
174
+ extract: "extract";
175
+ screenshot: "screenshot";
176
176
  }>;
177
177
  id: z.ZodOptional<z.ZodNumber>;
178
178
  selector: z.ZodOptional<z.ZodString>;
@@ -185,13 +185,13 @@ export declare class BrowserTool implements AgentTool<typeof browserSchema, Brow
185
185
  dy: z.ZodOptional<z.ZodNumber>;
186
186
  ms: z.ZodOptional<z.ZodNumber>;
187
187
  format: z.ZodOptional<z.ZodEnum<{
188
- html: "html";
189
- markdown: "markdown";
190
188
  text: "text";
189
+ markdown: "markdown";
190
+ html: "html";
191
191
  }>>;
192
192
  wait_until: z.ZodOptional<z.ZodEnum<{
193
- domcontentloaded: "domcontentloaded";
194
193
  load: "load";
194
+ domcontentloaded: "domcontentloaded";
195
195
  networkidle0: "networkidle0";
196
196
  networkidle2: "networkidle2";
197
197
  }>>;
@@ -14,8 +14,8 @@ export declare const singleComputerSchema: z.ZodDiscriminatedUnion<readonly [z.Z
14
14
  y: z.ZodNumber;
15
15
  button: z.ZodOptional<z.ZodEnum<{
16
16
  left: "left";
17
- middle: "middle";
18
17
  right: "right";
18
+ middle: "middle";
19
19
  }>>;
20
20
  }, z.core.$strict>, z.ZodObject<{
21
21
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -25,8 +25,8 @@ export declare const singleComputerSchema: z.ZodDiscriminatedUnion<readonly [z.Z
25
25
  y: z.ZodNumber;
26
26
  button: z.ZodOptional<z.ZodEnum<{
27
27
  left: "left";
28
- middle: "middle";
29
28
  right: "right";
29
+ middle: "middle";
30
30
  }>>;
31
31
  }, z.core.$strict>, z.ZodObject<{
32
32
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -36,8 +36,8 @@ export declare const singleComputerSchema: z.ZodDiscriminatedUnion<readonly [z.Z
36
36
  y: z.ZodNumber;
37
37
  button: z.ZodOptional<z.ZodEnum<{
38
38
  left: "left";
39
- middle: "middle";
40
39
  right: "right";
40
+ middle: "middle";
41
41
  }>>;
42
42
  }, z.core.$strict>, z.ZodObject<{
43
43
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -49,8 +49,8 @@ export declare const singleComputerSchema: z.ZodDiscriminatedUnion<readonly [z.Z
49
49
  to_y: z.ZodNumber;
50
50
  button: z.ZodOptional<z.ZodEnum<{
51
51
  left: "left";
52
- middle: "middle";
53
52
  right: "right";
53
+ middle: "middle";
54
54
  }>>;
55
55
  }, z.core.$strict>, z.ZodObject<{
56
56
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -88,8 +88,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
88
88
  y: z.ZodNumber;
89
89
  button: z.ZodOptional<z.ZodEnum<{
90
90
  left: "left";
91
- middle: "middle";
92
91
  right: "right";
92
+ middle: "middle";
93
93
  }>>;
94
94
  }, z.core.$strict>, z.ZodObject<{
95
95
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -99,8 +99,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
99
99
  y: z.ZodNumber;
100
100
  button: z.ZodOptional<z.ZodEnum<{
101
101
  left: "left";
102
- middle: "middle";
103
102
  right: "right";
103
+ middle: "middle";
104
104
  }>>;
105
105
  }, z.core.$strict>, z.ZodObject<{
106
106
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -110,8 +110,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
110
110
  y: z.ZodNumber;
111
111
  button: z.ZodOptional<z.ZodEnum<{
112
112
  left: "left";
113
- middle: "middle";
114
113
  right: "right";
114
+ middle: "middle";
115
115
  }>>;
116
116
  }, z.core.$strict>, z.ZodObject<{
117
117
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -123,8 +123,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
123
123
  to_y: z.ZodNumber;
124
124
  button: z.ZodOptional<z.ZodEnum<{
125
125
  left: "left";
126
- middle: "middle";
127
126
  right: "right";
127
+ middle: "middle";
128
128
  }>>;
129
129
  }, z.core.$strict>, z.ZodObject<{
130
130
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -165,8 +165,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
165
165
  y: z.ZodNumber;
166
166
  button: z.ZodOptional<z.ZodEnum<{
167
167
  left: "left";
168
- middle: "middle";
169
168
  right: "right";
169
+ middle: "middle";
170
170
  }>>;
171
171
  }, z.core.$strict>, z.ZodObject<{
172
172
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -176,8 +176,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
176
176
  y: z.ZodNumber;
177
177
  button: z.ZodOptional<z.ZodEnum<{
178
178
  left: "left";
179
- middle: "middle";
180
179
  right: "right";
180
+ middle: "middle";
181
181
  }>>;
182
182
  }, z.core.$strict>, z.ZodObject<{
183
183
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -187,8 +187,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
187
187
  y: z.ZodNumber;
188
188
  button: z.ZodOptional<z.ZodEnum<{
189
189
  left: "left";
190
- middle: "middle";
191
190
  right: "right";
191
+ middle: "middle";
192
192
  }>>;
193
193
  }, z.core.$strict>, z.ZodObject<{
194
194
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -200,8 +200,8 @@ export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
200
200
  to_y: z.ZodNumber;
201
201
  button: z.ZodOptional<z.ZodEnum<{
202
202
  left: "left";
203
- middle: "middle";
204
203
  right: "right";
204
+ middle: "middle";
205
205
  }>>;
206
206
  }, z.core.$strict>, z.ZodObject<{
207
207
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -316,8 +316,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
316
316
  y: z.ZodNumber;
317
317
  button: z.ZodOptional<z.ZodEnum<{
318
318
  left: "left";
319
- middle: "middle";
320
319
  right: "right";
320
+ middle: "middle";
321
321
  }>>;
322
322
  }, z.core.$strict>, z.ZodObject<{
323
323
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -327,8 +327,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
327
327
  y: z.ZodNumber;
328
328
  button: z.ZodOptional<z.ZodEnum<{
329
329
  left: "left";
330
- middle: "middle";
331
330
  right: "right";
331
+ middle: "middle";
332
332
  }>>;
333
333
  }, z.core.$strict>, z.ZodObject<{
334
334
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -338,8 +338,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
338
338
  y: z.ZodNumber;
339
339
  button: z.ZodOptional<z.ZodEnum<{
340
340
  left: "left";
341
- middle: "middle";
342
341
  right: "right";
342
+ middle: "middle";
343
343
  }>>;
344
344
  }, z.core.$strict>, z.ZodObject<{
345
345
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -351,8 +351,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
351
351
  to_y: z.ZodNumber;
352
352
  button: z.ZodOptional<z.ZodEnum<{
353
353
  left: "left";
354
- middle: "middle";
355
354
  right: "right";
355
+ middle: "middle";
356
356
  }>>;
357
357
  }, z.core.$strict>, z.ZodObject<{
358
358
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -393,8 +393,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
393
393
  y: z.ZodNumber;
394
394
  button: z.ZodOptional<z.ZodEnum<{
395
395
  left: "left";
396
- middle: "middle";
397
396
  right: "right";
397
+ middle: "middle";
398
398
  }>>;
399
399
  }, z.core.$strict>, z.ZodObject<{
400
400
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -404,8 +404,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
404
404
  y: z.ZodNumber;
405
405
  button: z.ZodOptional<z.ZodEnum<{
406
406
  left: "left";
407
- middle: "middle";
408
407
  right: "right";
408
+ middle: "middle";
409
409
  }>>;
410
410
  }, z.core.$strict>, z.ZodObject<{
411
411
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -415,8 +415,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
415
415
  y: z.ZodNumber;
416
416
  button: z.ZodOptional<z.ZodEnum<{
417
417
  left: "left";
418
- middle: "middle";
419
418
  right: "right";
419
+ middle: "middle";
420
420
  }>>;
421
421
  }, z.core.$strict>, z.ZodObject<{
422
422
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -428,8 +428,8 @@ export declare class ComputerTool implements AgentTool<typeof computerSchema, Co
428
428
  to_y: z.ZodNumber;
429
429
  button: z.ZodOptional<z.ZodEnum<{
430
430
  left: "left";
431
- middle: "middle";
432
431
  right: "right";
432
+ middle: "middle";
433
433
  }>>;
434
434
  }, z.core.$strict>, z.ZodObject<{
435
435
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -7,8 +7,8 @@ export declare const MAX_CRON_TASKS_PER_OWNER = 50;
7
7
  export declare const CRON_RECURRING_MAX_AGE_MS: number;
8
8
  declare const cronSchema: z.ZodObject<{
9
9
  op: z.ZodEnum<{
10
- create: "create";
11
10
  delete: "delete";
11
+ create: "create";
12
12
  list: "list";
13
13
  }>;
14
14
  cron_expression: z.ZodOptional<z.ZodString>;
@@ -73,8 +73,8 @@ export declare class CronTool implements AgentTool<typeof cronSchema, CronToolDe
73
73
  readonly description: string;
74
74
  readonly parameters: z.ZodObject<{
75
75
  op: z.ZodEnum<{
76
- create: "create";
77
76
  delete: "delete";
77
+ create: "create";
78
78
  list: "list";
79
79
  }>;
80
80
  cron_expression: z.ZodOptional<z.ZodString>;
@@ -7,34 +7,34 @@ import type { ToolSession } from ".";
7
7
  import type { OutputMeta } from "./output-meta";
8
8
  declare const debugSchema: z.ZodObject<{
9
9
  action: z.ZodEnum<{
10
- attach: "attach";
11
- continue: "continue";
12
- custom_request: "custom_request";
13
- data_breakpoint_info: "data_breakpoint_info";
14
- disassemble: "disassemble";
15
- evaluate: "evaluate";
16
- launch: "launch";
17
- loaded_sources: "loaded_sources";
18
- modules: "modules";
19
10
  output: "output";
20
11
  pause: "pause";
21
- read_memory: "read_memory";
22
- remove_breakpoint: "remove_breakpoint";
23
- remove_data_breakpoint: "remove_data_breakpoint";
24
- remove_instruction_breakpoint: "remove_instruction_breakpoint";
25
12
  scopes: "scopes";
26
- sessions: "sessions";
13
+ variables: "variables";
14
+ evaluate: "evaluate";
15
+ launch: "launch";
16
+ attach: "attach";
27
17
  set_breakpoint: "set_breakpoint";
28
- set_data_breakpoint: "set_data_breakpoint";
18
+ remove_breakpoint: "remove_breakpoint";
29
19
  set_instruction_breakpoint: "set_instruction_breakpoint";
30
- stack_trace: "stack_trace";
20
+ remove_instruction_breakpoint: "remove_instruction_breakpoint";
21
+ data_breakpoint_info: "data_breakpoint_info";
22
+ set_data_breakpoint: "set_data_breakpoint";
23
+ remove_data_breakpoint: "remove_data_breakpoint";
24
+ continue: "continue";
25
+ step_over: "step_over";
31
26
  step_in: "step_in";
32
27
  step_out: "step_out";
33
- step_over: "step_over";
34
- terminate: "terminate";
28
+ stack_trace: "stack_trace";
35
29
  threads: "threads";
36
- variables: "variables";
30
+ disassemble: "disassemble";
31
+ read_memory: "read_memory";
37
32
  write_memory: "write_memory";
33
+ modules: "modules";
34
+ loaded_sources: "loaded_sources";
35
+ custom_request: "custom_request";
36
+ terminate: "terminate";
37
+ sessions: "sessions";
38
38
  }>;
39
39
  program: z.ZodOptional<z.ZodString>;
40
40
  args: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -64,8 +64,8 @@ declare const debugSchema: z.ZodObject<{
64
64
  data_id: z.ZodOptional<z.ZodString>;
65
65
  access_type: z.ZodOptional<z.ZodEnum<{
66
66
  read: "read";
67
- readWrite: "readWrite";
68
67
  write: "write";
68
+ readWrite: "readWrite";
69
69
  }>>;
70
70
  command: z.ZodOptional<z.ZodString>;
71
71
  arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -130,34 +130,34 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
130
130
  readonly description: string;
131
131
  readonly parameters: z.ZodObject<{
132
132
  action: z.ZodEnum<{
133
- attach: "attach";
134
- continue: "continue";
135
- custom_request: "custom_request";
136
- data_breakpoint_info: "data_breakpoint_info";
137
- disassemble: "disassemble";
138
- evaluate: "evaluate";
139
- launch: "launch";
140
- loaded_sources: "loaded_sources";
141
- modules: "modules";
142
133
  output: "output";
143
134
  pause: "pause";
144
- read_memory: "read_memory";
145
- remove_breakpoint: "remove_breakpoint";
146
- remove_data_breakpoint: "remove_data_breakpoint";
147
- remove_instruction_breakpoint: "remove_instruction_breakpoint";
148
135
  scopes: "scopes";
149
- sessions: "sessions";
136
+ variables: "variables";
137
+ evaluate: "evaluate";
138
+ launch: "launch";
139
+ attach: "attach";
150
140
  set_breakpoint: "set_breakpoint";
151
- set_data_breakpoint: "set_data_breakpoint";
141
+ remove_breakpoint: "remove_breakpoint";
152
142
  set_instruction_breakpoint: "set_instruction_breakpoint";
153
- stack_trace: "stack_trace";
143
+ remove_instruction_breakpoint: "remove_instruction_breakpoint";
144
+ data_breakpoint_info: "data_breakpoint_info";
145
+ set_data_breakpoint: "set_data_breakpoint";
146
+ remove_data_breakpoint: "remove_data_breakpoint";
147
+ continue: "continue";
148
+ step_over: "step_over";
154
149
  step_in: "step_in";
155
150
  step_out: "step_out";
156
- step_over: "step_over";
157
- terminate: "terminate";
151
+ stack_trace: "stack_trace";
158
152
  threads: "threads";
159
- variables: "variables";
153
+ disassemble: "disassemble";
154
+ read_memory: "read_memory";
160
155
  write_memory: "write_memory";
156
+ modules: "modules";
157
+ loaded_sources: "loaded_sources";
158
+ custom_request: "custom_request";
159
+ terminate: "terminate";
160
+ sessions: "sessions";
161
161
  }>;
162
162
  program: z.ZodOptional<z.ZodString>;
163
163
  args: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -187,8 +187,8 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
187
187
  data_id: z.ZodOptional<z.ZodString>;
188
188
  access_type: z.ZodOptional<z.ZodEnum<{
189
189
  read: "read";
190
- readWrite: "readWrite";
191
190
  write: "write";
191
+ readWrite: "readWrite";
192
192
  }>>;
193
193
  command: z.ZodOptional<z.ZodString>;
194
194
  arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -6,16 +6,16 @@ import { type CacheStatus } from "./github-cache";
6
6
  import type { OutputMeta } from "./output-meta";
7
7
  declare const githubSchema: z.ZodObject<{
8
8
  op: z.ZodEnum<{
9
- pr_checkout: "pr_checkout";
9
+ repo_view: "repo_view";
10
10
  pr_create: "pr_create";
11
+ pr_checkout: "pr_checkout";
11
12
  pr_push: "pr_push";
12
- repo_view: "repo_view";
13
- run_watch: "run_watch";
14
- search_code: "search_code";
15
- search_commits: "search_commits";
16
13
  search_issues: "search_issues";
17
14
  search_prs: "search_prs";
15
+ search_code: "search_code";
16
+ search_commits: "search_commits";
18
17
  search_repos: "search_repos";
18
+ run_watch: "run_watch";
19
19
  }>;
20
20
  repo: z.ZodOptional<z.ZodString>;
21
21
  branch: z.ZodOptional<z.ZodString>;
@@ -236,16 +236,16 @@ export declare class GithubTool implements AgentTool<typeof githubSchema, GhTool
236
236
  readonly description: string;
237
237
  readonly parameters: z.ZodObject<{
238
238
  op: z.ZodEnum<{
239
- pr_checkout: "pr_checkout";
239
+ repo_view: "repo_view";
240
240
  pr_create: "pr_create";
241
+ pr_checkout: "pr_checkout";
241
242
  pr_push: "pr_push";
242
- repo_view: "repo_view";
243
- run_watch: "run_watch";
244
- search_code: "search_code";
245
- search_commits: "search_commits";
246
243
  search_issues: "search_issues";
247
244
  search_prs: "search_prs";
245
+ search_code: "search_code";
246
+ search_commits: "search_commits";
248
247
  search_repos: "search_repos";
248
+ run_watch: "run_watch";
249
249
  }>;
250
250
  repo: z.ZodOptional<z.ZodString>;
251
251
  branch: z.ZodOptional<z.ZodString>;
@@ -17,16 +17,16 @@ export declare const imageGenSchema: z.ZodObject<{
17
17
  text: z.ZodOptional<z.ZodString>;
18
18
  changes: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
19
  aspect_ratio: z.ZodOptional<z.ZodEnum<{
20
- "16:9": "16:9";
21
20
  "1:1": "1:1";
22
21
  "3:4": "3:4";
23
22
  "4:3": "4:3";
24
23
  "9:16": "9:16";
24
+ "16:9": "16:9";
25
25
  }>>;
26
26
  image_size: z.ZodOptional<z.ZodEnum<{
27
27
  "1024x1024": "1024x1024";
28
- "1024x1536": "1024x1536";
29
28
  "1536x1024": "1536x1024";
29
+ "1024x1536": "1024x1536";
30
30
  }>>;
31
31
  input: z.ZodOptional<z.ZodArray<z.ZodObject<{
32
32
  path: z.ZodOptional<z.ZodString>;
@@ -70,16 +70,68 @@ export type ContextFileEntry = {
70
70
  };
71
71
  export type { DiscoverableMCPTool } from "../runtime-mcp/discoverable-tool-metadata";
72
72
  export type { DiscoverableTool, DiscoverableToolSearchIndex, DiscoverableToolSearchResult, DiscoverableToolSource, } from "../tool-discovery/tool-index";
73
+ /** A typed remote action available to an ask answer source. */
74
+ export type AskRemoteControlId = "navigation_forward";
75
+ export interface AskRemoteControl {
76
+ id: AskRemoteControlId;
77
+ kind: "navigation";
78
+ label: "Next" | "Done";
79
+ enabled: boolean;
80
+ }
81
+ export interface AskAnswerRequest {
82
+ question: string;
83
+ options: string[];
84
+ interaction: "selector" | "custom_editor" | "clarification_editor";
85
+ controls: readonly AskRemoteControl[];
86
+ }
87
+ export type AskRemoteInteraction = {
88
+ kind: "value";
89
+ value: string;
90
+ } | {
91
+ kind: "control";
92
+ controlId: AskRemoteControlId;
93
+ };
94
+ export type AskSettlement = {
95
+ kind: "commit";
96
+ } | {
97
+ kind: "resolve_without_commit";
98
+ reason: "toggle" | "other_transition" | "clarification_transition" | "clarification_submitted" | "empty_navigation" | "back_navigation" | "cancelled" | "aborted" | "timed_out" | "exception" | "shutdown";
99
+ } | {
100
+ kind: "invalid";
101
+ reason: "invalid_option" | "invalid_control" | "invalid_structured_answer" | "empty_custom" | "empty_clarification";
102
+ };
103
+ export type AskSelectedAckOutcome = {
104
+ status: "delivered";
105
+ messageId: number;
106
+ } | {
107
+ status: "failed";
108
+ reason: "unsupported" | "no_participant" | "ambiguous_participant" | "route_missing" | "expired" | "cancelled" | "telegram_rejected" | "session_closed";
109
+ } | {
110
+ status: "unknown";
111
+ reason: "transport_ambiguous" | "origin_disconnected" | "host_timeout" | "shutdown";
112
+ };
113
+ export type AskSettlementResult = {
114
+ kind: "committed";
115
+ ack: AskSelectedAckOutcome;
116
+ } | {
117
+ kind: "resolved_without_commit";
118
+ } | {
119
+ kind: "invalid_closed";
120
+ };
121
+ export interface AskRemoteReceipt {
122
+ source: "remote";
123
+ interaction: AskRemoteInteraction;
124
+ settle(value: AskSettlement): Promise<AskSettlementResult>;
125
+ }
126
+ export type AskAnswerSourceResult = AskRemoteReceipt | string | undefined;
73
127
  /**
74
- * Source of remote answers for interactive asks (e.g. a Telegram reply routed
75
- * through the notifications SDK). Lets a pending ask resolve without RPC mode.
128
+ * Source of remote answers. `awaitAnswer` remains the legacy wire for existing
129
+ * integrations; typed sources opt into `awaitAnswerRequest`. This keeps an old
130
+ * string-only source from accidentally acquiring acknowledgement authority.
76
131
  */
77
132
  export interface AskAnswerSource {
78
- /**
79
- * Race a remote answer against the local UI for one question. Resolves with the
80
- * chosen option label or free-text answer, or `undefined` to defer to local UI.
81
- */
82
133
  awaitAnswer(question: string, options: string[], signal?: AbortSignal): Promise<string | undefined>;
134
+ awaitAnswerRequest?(request: AskAnswerRequest, signal?: AbortSignal): Promise<AskAnswerSourceResult>;
83
135
  }
84
136
  /** Session context for tool factories */
85
137
  export interface ToolSession {
@@ -2,18 +2,18 @@ import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallb
2
2
  import * as z from "zod/v4";
3
3
  import type { ToolSession } from "./index";
4
4
  declare const monitorKindEnum: z.ZodEnum<{
5
+ watch: "watch";
6
+ poll: "poll";
5
7
  log: "log";
6
8
  other: "other";
7
- poll: "poll";
8
- watch: "watch";
9
9
  }>;
10
10
  declare const monitorSchema: z.ZodObject<{
11
11
  command: z.ZodString;
12
12
  kind: z.ZodEnum<{
13
+ watch: "watch";
14
+ poll: "poll";
13
15
  log: "log";
14
16
  other: "other";
15
- poll: "poll";
16
- watch: "watch";
17
17
  }>;
18
18
  description: z.ZodString;
19
19
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -36,10 +36,10 @@ export declare class MonitorTool implements AgentTool<typeof monitorSchema, Moni
36
36
  readonly parameters: z.ZodObject<{
37
37
  command: z.ZodString;
38
38
  kind: z.ZodEnum<{
39
+ watch: "watch";
40
+ poll: "poll";
39
41
  log: "log";
40
42
  other: "other";
41
- poll: "poll";
42
- watch: "watch";
43
43
  }>;
44
44
  description: z.ZodString;
45
45
  timeout: z.ZodOptional<z.ZodNumber>;
@@ -5,9 +5,9 @@ import type { ToolSession } from ".";
5
5
  declare const skillDiscoverySchema: z.ZodObject<{
6
6
  query: z.ZodOptional<z.ZodString>;
7
7
  source: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
8
- all: "all";
9
- project: "project";
10
8
  user: "user";
9
+ project: "project";
10
+ all: "all";
11
11
  }>>>;
12
12
  limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
13
13
  }, z.core.$strict>;
@@ -26,9 +26,9 @@ export declare class SkillDiscoveryTool implements AgentTool<typeof skillDiscove
26
26
  readonly parameters: z.ZodObject<{
27
27
  query: z.ZodOptional<z.ZodString>;
28
28
  source: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
29
- all: "all";
30
- project: "project";
31
29
  user: "user";
30
+ project: "project";
31
+ all: "all";
32
32
  }>>>;
33
33
  limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
34
34
  }, z.core.$strict>;