qlogicagent 2.24.1 → 2.24.2

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 (297) hide show
  1. package/README.md +52 -324
  2. package/dist/agent.js +38 -43
  3. package/dist/cli.js +7 -7
  4. package/dist/default-project-knowledge/INSTRUCTIONS.md +7 -7
  5. package/dist/default-project-knowledge/rules/project-workflow.md +6 -6
  6. package/dist/index.js +265 -1018
  7. package/dist/orchestration.js +10 -10
  8. package/dist/types/agent/runtime-vars.d.ts +1 -16
  9. package/dist/types/agent/tool-loop/compression-pipeline.d.ts +0 -2
  10. package/dist/types/agent/tool-loop.d.ts +0 -6
  11. package/dist/types/agent/types.d.ts +3 -22
  12. package/dist/types/cli/acp-commands.d.ts +4 -5
  13. package/dist/types/cli/acp-message-router.d.ts +1 -2
  14. package/dist/types/cli/acp-session-handlers.d.ts +6 -12
  15. package/dist/types/cli/acp-session-host.d.ts +5 -48
  16. package/dist/types/cli/adapter-launch-config.d.ts +14 -0
  17. package/dist/types/cli/agent-runtime-bootstrap.d.ts +2 -23
  18. package/dist/types/cli/agent-runtime-session-state.d.ts +1 -6
  19. package/dist/types/cli/base-tool-bootstrap.d.ts +0 -2
  20. package/dist/types/cli/cli-acp-request-handler.d.ts +3 -5
  21. package/dist/types/cli/core-tool-coordinator.d.ts +0 -4
  22. package/dist/types/cli/core-tools/agent-tool-service.d.ts +0 -3
  23. package/dist/types/cli/core-tools/fork-system-prompt.d.ts +1 -5
  24. package/dist/types/cli/handlers/files-handler.d.ts +0 -6
  25. package/dist/types/cli/handlers/turn-handler.d.ts +7 -83
  26. package/dist/types/cli/main.d.ts +2 -4
  27. package/dist/types/cli/permission-approval-bridge.d.ts +2 -6
  28. package/dist/types/cli/permission-bootstrap.d.ts +2 -12
  29. package/dist/types/cli/plugin-bootstrap.d.ts +2 -4
  30. package/dist/types/cli/runtime-hook-bootstrap.d.ts +0 -21
  31. package/dist/types/cli/session-context.d.ts +4 -14
  32. package/dist/types/cli/session-coordinator.d.ts +1 -9
  33. package/dist/types/cli/stdio-acp-protocol-coordinator.d.ts +2 -9
  34. package/dist/types/cli/stdio-acp-request-host.d.ts +3 -15
  35. package/dist/types/cli/stdio-agent-session-bootstrap.d.ts +3 -23
  36. package/dist/types/cli/stdio-runtime-bootstrap.d.ts +0 -8
  37. package/dist/types/cli/stdio-runtime-services.d.ts +2 -13
  38. package/dist/types/cli/stdio-server.d.ts +6 -128
  39. package/dist/types/cli/tool-bootstrap.d.ts +4 -8
  40. package/dist/types/cli/tool-catalog.d.ts +2 -2
  41. package/dist/types/cli/tool-invoker-factory.d.ts +0 -2
  42. package/dist/types/cli/tool-registry-adapter.d.ts +3 -7
  43. package/dist/types/cli/tool-result-processor.d.ts +0 -1
  44. package/dist/types/cli/turn-core.d.ts +6 -10
  45. package/dist/types/cli/turn-event-forwarder.d.ts +6 -3
  46. package/dist/types/cli/turn-lifecycle.d.ts +0 -3
  47. package/dist/types/cli/turn-project-router.d.ts +0 -7
  48. package/dist/types/contracts/hooks.d.ts +1 -20
  49. package/dist/types/contracts/tool-execution-evidence.d.ts +20 -1
  50. package/dist/types/contracts/turn-event.d.ts +2 -2
  51. package/dist/types/orchestration/index.d.ts +1 -1
  52. package/dist/types/protocol/notifications.d.ts +2 -9
  53. package/dist/types/protocol/wire/acp-protocol.d.ts +12 -186
  54. package/dist/types/protocol/wire/capability-transport.d.ts +0 -2
  55. package/dist/types/protocol/wire/index.d.ts +2 -10
  56. package/dist/types/protocol/wire/notification-payloads.d.ts +4 -989
  57. package/dist/types/protocol/wire/thread-protocol.d.ts +24 -3
  58. package/dist/types/runtime/config/tunable-defaults.d.ts +3 -75
  59. package/dist/types/runtime/execution/forked-agent.d.ts +2 -5
  60. package/dist/types/runtime/execution/streaming-tool-executor.d.ts +0 -2
  61. package/dist/types/runtime/execution/tool-result-storage.d.ts +13 -4
  62. package/dist/types/runtime/infra/agent-paths.d.ts +4 -54
  63. package/dist/types/runtime/infra/agent-project-projection.d.ts +20 -0
  64. package/dist/types/runtime/infra/background-tasks.d.ts +3 -3
  65. package/dist/types/runtime/infra/default-path-service.d.ts +0 -7
  66. package/dist/types/runtime/infra/llmrouter-catalog.d.ts +1 -1
  67. package/dist/types/runtime/infra/model-registry.d.ts +6 -9
  68. package/dist/types/runtime/infra/project-store.d.ts +3 -3
  69. package/dist/types/runtime/infra/subagent-turn-snapshot.d.ts +54 -7
  70. package/dist/types/runtime/infra/task-runtime.d.ts +1 -1
  71. package/dist/types/runtime/ports/agent-runtime-ports.d.ts +1 -3
  72. package/dist/types/runtime/ports/index.d.ts +0 -4
  73. package/dist/types/runtime/ports/path-service.d.ts +1 -9
  74. package/dist/types/runtime/ports/tool-contracts.d.ts +0 -1
  75. package/dist/types/runtime/session/agent-session-projection.d.ts +37 -0
  76. package/dist/types/runtime/tasks/task-types.d.ts +2 -25
  77. package/dist/types/skills/mcp/mcp-manager.d.ts +2 -2
  78. package/dist/types/skills/plugins/plugin-loader.d.ts +1 -1
  79. package/dist/types/skills/skill-system/skill-category.d.ts +4 -2
  80. package/dist/types/skills/tools.d.ts +1 -18
  81. package/dist/types/test-support/project-store-fixture.d.ts +4 -4
  82. package/dist/types/transport/acp-event-emitter.d.ts +1 -20
  83. package/dist/types/transport/acp-server.d.ts +8 -88
  84. package/package.json +4 -96
  85. package/dist/agent-contract.js +0 -1
  86. package/dist/host-contract.js +0 -1
  87. package/dist/host-session-collection-contract.js +0 -1
  88. package/dist/memory-category-contract.js +0 -1
  89. package/dist/permissions.js +0 -1
  90. package/dist/plugin-marketplace-compute.js +0 -1
  91. package/dist/project-memory-host.js +0 -38
  92. package/dist/protocol.js +0 -1
  93. package/dist/skill-category-contract.js +0 -1
  94. package/dist/tunables.js +0 -1
  95. package/dist/types/agent/memory-recall-context.d.ts +0 -22
  96. package/dist/types/agent/memory-recall-injection.d.ts +0 -32
  97. package/dist/types/cli/acp-extended-handlers.d.ts +0 -110
  98. package/dist/types/cli/acp-extended-host-adapter.d.ts +0 -20
  99. package/dist/types/cli/community-resource-installer.d.ts +0 -39
  100. package/dist/types/cli/community-skill-installer.d.ts +0 -18
  101. package/dist/types/cli/community-workflow-installer.d.ts +0 -29
  102. package/dist/types/cli/default-project-bootstrap.d.ts +0 -12
  103. package/dist/types/cli/dream-host-adapter.d.ts +0 -24
  104. package/dist/types/cli/gateway-rpc-connection.d.ts +0 -50
  105. package/dist/types/cli/handlers/community-handler.d.ts +0 -14
  106. package/dist/types/cli/handlers/config-handler.d.ts +0 -19
  107. package/dist/types/cli/handlers/control-handler.d.ts +0 -29
  108. package/dist/types/cli/handlers/dream-handler.d.ts +0 -41
  109. package/dist/types/cli/handlers/goal-handler.d.ts +0 -66
  110. package/dist/types/cli/handlers/memory-handler.d.ts +0 -23
  111. package/dist/types/cli/handlers/product-handler.d.ts +0 -35
  112. package/dist/types/cli/handlers/session-handler.d.ts +0 -29
  113. package/dist/types/cli/handlers/skill-curator-handler.d.ts +0 -8
  114. package/dist/types/cli/handlers/solo-handler.d.ts +0 -25
  115. package/dist/types/cli/handlers/turn-baseline-handler.d.ts +0 -8
  116. package/dist/types/cli/handlers/workflow-compute-handler.d.ts +0 -8
  117. package/dist/types/cli/handlers/working-materials-handler.d.ts +0 -9
  118. package/dist/types/cli/idle-dream-coordinator.d.ts +0 -57
  119. package/dist/types/cli/memory-background-coordinator.d.ts +0 -26
  120. package/dist/types/cli/memory-candidate-service.d.ts +0 -75
  121. package/dist/types/cli/memory-coordinator.d.ts +0 -40
  122. package/dist/types/cli/multi-agent-handler-host.d.ts +0 -16
  123. package/dist/types/cli/multi-agent-state-coordinator.d.ts +0 -8
  124. package/dist/types/cli/orchestration-memory-context.d.ts +0 -23
  125. package/dist/types/cli/product-acp-params.d.ts +0 -30
  126. package/dist/types/cli/product-coordinator.d.ts +0 -21
  127. package/dist/types/cli/project-memory-store-factory.d.ts +0 -12
  128. package/dist/types/cli/project-template-seeder.d.ts +0 -5
  129. package/dist/types/cli/rpc-registry.d.ts +0 -56
  130. package/dist/types/cli/session-history-coordinator.d.ts +0 -8
  131. package/dist/types/cli/session-query-service.d.ts +0 -27
  132. package/dist/types/cli/stdio-rpc-handler-hosts.d.ts +0 -56
  133. package/dist/types/cli/stdio-session-runtime-coordinator.d.ts +0 -17
  134. package/dist/types/cli/task-distillation-coordinator.d.ts +0 -146
  135. package/dist/types/cli/turn-ask-user-setup.d.ts +0 -24
  136. package/dist/types/cli/turn-suggestion-generator.d.ts +0 -15
  137. package/dist/types/contracts/memory-recall-packet.d.ts +0 -31
  138. package/dist/types/contracts/memory-response-contract.d.ts +0 -2
  139. package/dist/types/host-contract/fts-segment.d.ts +0 -20
  140. package/dist/types/host-contract/index.d.ts +0 -1819
  141. package/dist/types/host-contract/memory-category.d.ts +0 -8
  142. package/dist/types/host-contract/skill-category.d.ts +0 -5
  143. package/dist/types/host-session-collection-contract.d.ts +0 -65
  144. package/dist/types/orchestration/agent-instance.d.ts +0 -215
  145. package/dist/types/orchestration/agent-roster.d.ts +0 -32
  146. package/dist/types/orchestration/dag-scheduler.d.ts +0 -219
  147. package/dist/types/orchestration/delegate-approval-policy.d.ts +0 -8
  148. package/dist/types/orchestration/delegate-bridge.d.ts +0 -8
  149. package/dist/types/orchestration/goal-acceptance.d.ts +0 -17
  150. package/dist/types/orchestration/goal-context-envelope.d.ts +0 -7
  151. package/dist/types/orchestration/goal-loop-coordinator.d.ts +0 -151
  152. package/dist/types/orchestration/goal-mode-adapters.d.ts +0 -152
  153. package/dist/types/orchestration/goal-run-persistence.d.ts +0 -21
  154. package/dist/types/orchestration/goal-run-types.d.ts +0 -225
  155. package/dist/types/orchestration/planner-memory-brief.d.ts +0 -39
  156. package/dist/types/orchestration/product-budget.d.ts +0 -94
  157. package/dist/types/orchestration/product-checkpoint.d.ts +0 -50
  158. package/dist/types/orchestration/product-dag-mutation-applier.d.ts +0 -10
  159. package/dist/types/orchestration/product-persistence.d.ts +0 -90
  160. package/dist/types/orchestration/product-planner.d.ts +0 -332
  161. package/dist/types/orchestration/product-run-coordinator.d.ts +0 -49
  162. package/dist/types/orchestration/product-worktree.d.ts +0 -19
  163. package/dist/types/orchestration/run-state-host-authority.d.ts +0 -7
  164. package/dist/types/orchestration/solo-evaluator.d.ts +0 -179
  165. package/dist/types/orchestration/solo-persistence.d.ts +0 -47
  166. package/dist/types/orchestration/solo-spec-builder.d.ts +0 -58
  167. package/dist/types/orchestration/testing/delegate-test-bridge.d.ts +0 -23
  168. package/dist/types/orchestration/testing/host-agent-provider-directory-fixture.d.ts +0 -7
  169. package/dist/types/orchestration/testing/run-state-client-double.d.ts +0 -13
  170. package/dist/types/orchestration/workflow/budget-permission-gate.d.ts +0 -94
  171. package/dist/types/orchestration/workflow/builtin-capabilities.d.ts +0 -3
  172. package/dist/types/orchestration/workflow/builtin-executors.d.ts +0 -18
  173. package/dist/types/orchestration/workflow/capability-catalog.d.ts +0 -72
  174. package/dist/types/orchestration/workflow/cron-schedule.d.ts +0 -36
  175. package/dist/types/orchestration/workflow/data-item.d.ts +0 -39
  176. package/dist/types/orchestration/workflow/expression.d.ts +0 -60
  177. package/dist/types/orchestration/workflow/host-executors.d.ts +0 -15
  178. package/dist/types/orchestration/workflow/n8n-expression.d.ts +0 -48
  179. package/dist/types/orchestration/workflow/n8n-import.d.ts +0 -64
  180. package/dist/types/orchestration/workflow/n8n-template-compat.d.ts +0 -5
  181. package/dist/types/orchestration/workflow/node-registry.d.ts +0 -32
  182. package/dist/types/orchestration/workflow/node-schema.d.ts +0 -249
  183. package/dist/types/orchestration/workflow/params-schema.d.ts +0 -69
  184. package/dist/types/orchestration/workflow/qla-executor-host.d.ts +0 -63
  185. package/dist/types/orchestration/workflow/run-checkpoint-store.d.ts +0 -53
  186. package/dist/types/orchestration/workflow/run-history-store.d.ts +0 -103
  187. package/dist/types/orchestration/workflow/semantic-acceptance.d.ts +0 -65
  188. package/dist/types/orchestration/workflow/trigger-validation.d.ts +0 -22
  189. package/dist/types/orchestration/workflow/workflow-audit-store.d.ts +0 -31
  190. package/dist/types/orchestration/workflow/workflow-authoring.d.ts +0 -74
  191. package/dist/types/orchestration/workflow/workflow-bundle.d.ts +0 -51
  192. package/dist/types/orchestration/workflow/workflow-controller.d.ts +0 -237
  193. package/dist/types/orchestration/workflow/workflow-edit-context.d.ts +0 -46
  194. package/dist/types/orchestration/workflow/workflow-error.d.ts +0 -28
  195. package/dist/types/orchestration/workflow/workflow-intent-contract.d.ts +0 -56
  196. package/dist/types/orchestration/workflow/workflow-patch.d.ts +0 -122
  197. package/dist/types/orchestration/workflow/workflow-render.d.ts +0 -40
  198. package/dist/types/orchestration/workflow/workflow-runtime.d.ts +0 -184
  199. package/dist/types/orchestration/workflow/workflow-scheduler.d.ts +0 -122
  200. package/dist/types/orchestration/workflow/workflow-store.d.ts +0 -85
  201. package/dist/types/orchestration/workflow/workflow-template-setup.d.ts +0 -65
  202. package/dist/types/orchestration/workflow/workflow-trigger.d.ts +0 -43
  203. package/dist/types/orchestration/workflow-chat-builder.d.ts +0 -152
  204. package/dist/types/orchestration/worktree-task-prompt.d.ts +0 -1
  205. package/dist/types/permissions.d.ts +0 -4
  206. package/dist/types/project-memory-host.d.ts +0 -4
  207. package/dist/types/protocol/agent-contract.d.ts +0 -93
  208. package/dist/types/protocol/methods.d.ts +0 -645
  209. package/dist/types/protocol/wire/acp-agent-management.d.ts +0 -533
  210. package/dist/types/protocol/wire/agent-events.d.ts +0 -1
  211. package/dist/types/protocol/wire/agent-methods.d.ts +0 -500
  212. package/dist/types/protocol/wire/agent-rpc.d.ts +0 -100
  213. package/dist/types/protocol/wire/gateway-contract.d.ts +0 -61
  214. package/dist/types/protocol/wire/gateway-rpc.d.ts +0 -1177
  215. package/dist/types/protocol/wire/memory-provider-lifecycle.d.ts +0 -31
  216. package/dist/types/protocol/wire/turn.d.ts +0 -208
  217. package/dist/types/runtime/community/autonomy-budget.d.ts +0 -26
  218. package/dist/types/runtime/community/community-consent-client.d.ts +0 -55
  219. package/dist/types/runtime/community/package-materialize.d.ts +0 -19
  220. package/dist/types/runtime/community/ranged-download.d.ts +0 -21
  221. package/dist/types/runtime/community/registry-signature.d.ts +0 -48
  222. package/dist/types/runtime/execution/dream-agent.d.ts +0 -273
  223. package/dist/types/runtime/execution/dream-category-context.d.ts +0 -47
  224. package/dist/types/runtime/execution/memory-decay.d.ts +0 -73
  225. package/dist/types/runtime/execution/turn-progress-notifier.d.ts +0 -16
  226. package/dist/types/runtime/hooks/memory-hooks.d.ts +0 -111
  227. package/dist/types/runtime/infra/acp-host-handler.d.ts +0 -31
  228. package/dist/types/runtime/infra/acp-protocol-adapter.d.ts +0 -209
  229. package/dist/types/runtime/infra/acp-usage-tracker.d.ts +0 -46
  230. package/dist/types/runtime/infra/cloud-auth-host-authority.d.ts +0 -4
  231. package/dist/types/runtime/infra/feedback-distillation-worker.d.ts +0 -20
  232. package/dist/types/runtime/infra/feedback-distillation.d.ts +0 -32
  233. package/dist/types/runtime/infra/feedback-event-store.d.ts +0 -179
  234. package/dist/types/runtime/infra/feedback-host-authority.d.ts +0 -4
  235. package/dist/types/runtime/infra/feedback-outbox.d.ts +0 -26
  236. package/dist/types/runtime/infra/feedback-redaction.d.ts +0 -71
  237. package/dist/types/runtime/infra/feedback-upload-client.d.ts +0 -39
  238. package/dist/types/runtime/infra/feedback-upload-worker.d.ts +0 -11
  239. package/dist/types/runtime/infra/host-agent-provider-directory.d.ts +0 -17
  240. package/dist/types/runtime/infra/project-authority-facade.d.ts +0 -11
  241. package/dist/types/runtime/infra/project-data-paths.d.ts +0 -24
  242. package/dist/types/runtime/infra/project-host-authority.d.ts +0 -11
  243. package/dist/types/runtime/infra/project-instructions-store.d.ts +0 -30
  244. package/dist/types/runtime/infra/turn-baseline-store.d.ts +0 -102
  245. package/dist/types/runtime/infra/turn-telemetry-store.d.ts +0 -100
  246. package/dist/types/runtime/infra/working-materials-store.d.ts +0 -29
  247. package/dist/types/runtime/memory/find-relevant-memories.d.ts +0 -26
  248. package/dist/types/runtime/memory/implicit-extraction.d.ts +0 -69
  249. package/dist/types/runtime/memory/memory-recall-attribution.d.ts +0 -24
  250. package/dist/types/runtime/ports/memory-provider.d.ts +0 -219
  251. package/dist/types/runtime/ports/memory-recall-source.d.ts +0 -14
  252. package/dist/types/runtime/ports/memory-writer.d.ts +0 -70
  253. package/dist/types/runtime/ports/project-memory-store.d.ts +0 -49
  254. package/dist/types/runtime/prompt/host-skill-directory.d.ts +0 -16
  255. package/dist/types/runtime/session/group-session-split.d.ts +0 -38
  256. package/dist/types/runtime/session/inbound-upload-persistence.d.ts +0 -47
  257. package/dist/types/runtime/session/session-catalog.d.ts +0 -12
  258. package/dist/types/runtime/session/session-deletion-guard.d.ts +0 -4
  259. package/dist/types/runtime/session/session-locator.d.ts +0 -26
  260. package/dist/types/runtime/session/session-metadata-store.d.ts +0 -8
  261. package/dist/types/runtime/session/session-paths.d.ts +0 -8
  262. package/dist/types/runtime/session/session-permission-store.d.ts +0 -6
  263. package/dist/types/runtime/session/session-persistence.d.ts +0 -37
  264. package/dist/types/runtime/session/session-recovery.d.ts +0 -62
  265. package/dist/types/runtime/session/session-resource-key.d.ts +0 -28
  266. package/dist/types/runtime/session/session-resume.d.ts +0 -9
  267. package/dist/types/runtime/session/session-schema.d.ts +0 -10
  268. package/dist/types/runtime/session/session-summary.d.ts +0 -7
  269. package/dist/types/runtime/session/session-title.d.ts +0 -9
  270. package/dist/types/runtime/session/session-transcript-store.d.ts +0 -30
  271. package/dist/types/runtime/session/session-types.d.ts +0 -113
  272. package/dist/types/runtime/session/session-write-queue.d.ts +0 -3
  273. package/dist/types/skills/memory/host-memory-provider.d.ts +0 -235
  274. package/dist/types/skills/memory/memdir.d.ts +0 -111
  275. package/dist/types/skills/memory/memory-content-safety.d.ts +0 -1
  276. package/dist/types/skills/memory/memory-vector-utils.d.ts +0 -2
  277. package/dist/types/skills/memory/task-distillation.d.ts +0 -183
  278. package/dist/types/skills/plugins/plugin-marketplace.d.ts +0 -43
  279. package/dist/types/skills/skill-system/skill-bundles.d.ts +0 -8
  280. package/dist/types/skills/skill-system/skill-lifecycle.d.ts +0 -89
  281. package/dist/types/test-support/run-state-authority-setup.d.ts +0 -1
  282. package/dist/types/transport/delegate-client.d.ts +0 -82
  283. package/dist/types/transport/host-capability-client.d.ts +0 -21
  284. package/dist/types/transport/host-cloud-auth-client.d.ts +0 -10
  285. package/dist/types/transport/host-community-client.d.ts +0 -7
  286. package/dist/types/transport/host-feedback-client.d.ts +0 -25
  287. package/dist/types/transport/host-profile-client.d.ts +0 -19
  288. package/dist/types/transport/host-project-client.d.ts +0 -16
  289. package/dist/types/transport/host-request-client.d.ts +0 -42
  290. package/dist/types/transport/host-run-state-client.d.ts +0 -23
  291. package/dist/types/transport/host-session-client.d.ts +0 -30
  292. package/dist/types/tunables.d.ts +0 -2
  293. package/dist/types/workflow-host.d.ts +0 -38
  294. package/dist/workflow-host.js +0 -11
  295. /package/dist/types/{host-contract → protocol/wire}/acp-content.d.ts +0 -0
  296. /package/dist/types/{host-contract → runtime/infra}/project-id.d.ts +0 -0
  297. /package/dist/types/{host-contract → runtime/infra}/provider-profile.d.ts +0 -0
@@ -1,1177 +0,0 @@
1
- /**
2
- * Gateway-facing Agent RPC type contract.
3
- *
4
- * This file defines the typed `AgentCall` signature that Gateway consumers use
5
- * to invoke Agent RPC methods with full compile-time safety.
6
- *
7
- * Design: Gateway only needs the "shape" of params/result for the methods it
8
- * actually calls. Internal-only methods (agent internals) are not exposed here.
9
- *
10
- * Reference: CC uses Zod union in a single package; we use TypeScript interface map
11
- * in a shared package (same effect — single source, compile-time checked).
12
- */
13
- import type { NativeSessionRef, NativeTranscript } from "../../host-contract/index.js";
14
- export type ProjectType = "default" | "personal" | "group" | "solo" | "product" | "automation";
15
- export type ProjectStatus = "active" | "detached" | "archived";
16
- export type ProviderHostMethod = "provider.catalog" | "provider.list" | "provider.get" | "provider.install" | "provider.install.cancel" | "provider.update" | "provider.uninstall" | "provider.enable" | "provider.disable" | "provider.diagnose" | "provider.auth.status" | "provider.auth.setPreference" | "provider.auth.setUserKey" | "provider.auth.methods" | "provider.auth.start" | "provider.auth.attach" | "provider.auth.input" | "provider.auth.resize" | "provider.auth.cancel" | "provider.auth.logout" | "provider.models.list" | "provider.nativeSessions.list" | "provider.nativeSessions.load" | "provider.nativeSessions.resume";
17
- export type AgentProviderState = "installed" | "auth_required" | "ready" | "disabled" | "incompatible" | "unresponsive" | "failed";
18
- export interface AgentProviderDiagnosticWire {
19
- providerId: string;
20
- state: "ready" | "not_installed" | "disabled" | "incompatible" | "auth_required" | "unresponsive" | "failed";
21
- stage: "install" | "manifest" | "auth" | "launch" | "initialize" | "models" | "native_sessions" | "request";
22
- code: string;
23
- message: string;
24
- retryable: boolean;
25
- providerVersion?: string;
26
- payloadVersion?: string;
27
- }
28
- export interface AgentProviderErrorWire {
29
- providerId: string;
30
- stage: AgentProviderDiagnosticWire["stage"];
31
- code: string;
32
- message: string;
33
- retryable: boolean;
34
- data?: unknown;
35
- }
36
- export interface AgentProviderCatalogEntryWire {
37
- schemaVersion: 1;
38
- providerId: string;
39
- displayName: string;
40
- brandId: string;
41
- category: "coding" | "assistant" | "custom";
42
- order: number;
43
- featured: boolean;
44
- installPolicy: "builtin" | "managed-package" | "planned";
45
- distribution: {
46
- kind: "builtin";
47
- } | {
48
- kind: "npm";
49
- packageName: string;
50
- exactVersion: string;
51
- integrity: `sha512-${string}`;
52
- mirrorAllowed: boolean;
53
- } | {
54
- kind: "signed-bundle";
55
- artifactId: string;
56
- exactVersion: string;
57
- sha256: string;
58
- };
59
- expectedManifestDigest?: `sha256:${string}`;
60
- }
61
- export interface RegisteredAgentProviderWire {
62
- providerId: string;
63
- source: "builtin" | "installed";
64
- installationId: string;
65
- manifest: Readonly<Record<string, unknown>>;
66
- manifestDigest: `sha256:${string}`;
67
- state: AgentProviderState;
68
- diagnostic?: AgentProviderDiagnosticWire;
69
- }
70
- export interface ProviderAuthTerminalSessionWire {
71
- authSessionId: string;
72
- providerId: string;
73
- ownerId: string;
74
- authMethodId: string;
75
- state: "starting" | "interactive" | "verifying" | "succeeded" | "failed" | "cancelled";
76
- cols: number;
77
- rows: number;
78
- exitCode?: number;
79
- error?: AgentProviderErrorWire;
80
- createdAt: string;
81
- updatedAt: string;
82
- }
83
- export interface DelegationBindingKey {
84
- parentSessionId: string;
85
- providerId: string;
86
- generation: number;
87
- }
88
- export interface DelegationBinding extends DelegationBindingKey {
89
- bindingId: string;
90
- projectId: string;
91
- executionSessionId: string;
92
- nativeResumeId?: string;
93
- createdAt: string;
94
- updatedAt: string;
95
- revision: number;
96
- }
97
- export interface DelegationTurn {
98
- delegationId: string;
99
- bindingId: string;
100
- parentMessageId: string;
101
- requestId: string;
102
- sequence: number;
103
- state: "queued" | "running" | "completed" | "failed" | "cancelled";
104
- }
105
- export type DelegationErrorCode = "PROVIDER_NOT_INSTALLED" | "AUTH_REQUIRED" | "PROVIDER_UNAVAILABLE" | "SESSION_CREATE_FAILED" | "SESSION_RESUME_FAILED" | "TURN_FAILED" | "PROTOCOL_ERROR" | "CANCELLED";
106
- export interface DelegationError {
107
- code: DelegationErrorCode;
108
- message: string;
109
- stage: "validate" | "bind" | "spawn" | "resume" | "turn" | "cancel";
110
- retryable: boolean;
111
- providerId: string;
112
- bindingId?: string;
113
- delegationId?: string;
114
- diagnosticId?: string;
115
- }
116
- export interface LocalizedTextWire {
117
- key: string;
118
- fallback: string;
119
- values?: Record<string, string>;
120
- }
121
- export type CapabilityCategoryWire = "orchestration" | "filesystem" | "web" | "search" | "memory" | "media" | "developer" | "mcp" | "automation" | "system" | "other";
122
- export interface ProjectInfo {
123
- id: string;
124
- name: string;
125
- workspaceDir: string;
126
- type: ProjectType;
127
- status: ProjectStatus;
128
- groupId?: string;
129
- createdAt: string;
130
- updatedAt: string;
131
- planStatus?: "creating" | "running" | "completed" | "failed" | "cancelled";
132
- planAgents?: string[];
133
- planWinnerId?: string;
134
- leaderSessionId?: string;
135
- primaryWorkflowId?: string;
136
- }
137
- export interface MemoryAttachmentWire {
138
- type: "image" | "audio" | "video" | "file" | string;
139
- filename: string;
140
- mimeType?: string;
141
- size?: number;
142
- text?: string;
143
- url?: string;
144
- path?: string;
145
- }
146
- export interface MemoryCandidateWire {
147
- id?: string;
148
- text: string;
149
- category?: string;
150
- importance?: number;
151
- confidence?: number;
152
- source?: string;
153
- eventDate?: string;
154
- tags?: string[];
155
- relatedMemoryIds?: string[];
156
- evidence?: Array<Record<string, unknown>>;
157
- requiresConfirmation?: boolean;
158
- reason?: string;
159
- }
160
- export interface MemoryTextMutationParams {
161
- text?: string;
162
- category?: string;
163
- importance?: number;
164
- source?: string;
165
- tags?: string[];
166
- attachments?: MemoryAttachmentWire[];
167
- autoExtract?: boolean;
168
- }
169
- export interface MemoryConsolidationResult {
170
- ok: boolean;
171
- memoriesAdded: number;
172
- observationsAdded?: number;
173
- proposalsAdded?: number;
174
- claimsAdded?: number;
175
- conflictsAdded?: number;
176
- claimIds?: string[];
177
- conflictIds?: string[];
178
- }
179
- export interface GatewayRpcMethodMap {
180
- "agent.health": {
181
- params: {};
182
- result: {
183
- ok: boolean;
184
- status: "healthy" | "degraded" | "stopping";
185
- uptimeMs: number;
186
- protocolVersion: string;
187
- version: string;
188
- };
189
- };
190
- "agent.metrics": {
191
- params: {};
192
- result: {
193
- rpc: {
194
- activeRequests: number;
195
- completedRequests: number;
196
- cancelledRequests: number;
197
- deadlineExceededRequests: number;
198
- dedupedRequests: number;
199
- lateResponsesDropped: number;
200
- invalidRequests: number;
201
- };
202
- };
203
- };
204
- "agent.cancel": {
205
- params: {
206
- requestId: string;
207
- reason?: string;
208
- };
209
- result: {
210
- ok: boolean;
211
- cancelled: boolean;
212
- };
213
- };
214
- "provider.catalog": {
215
- params: Record<string, never>;
216
- result: {
217
- providers: AgentProviderCatalogEntryWire[];
218
- };
219
- };
220
- "provider.list": {
221
- params: Record<string, never>;
222
- result: {
223
- providers: RegisteredAgentProviderWire[];
224
- revision: number;
225
- };
226
- };
227
- "provider.get": {
228
- params: {
229
- providerId: string;
230
- };
231
- result: {
232
- provider: RegisteredAgentProviderWire | null;
233
- revision: number;
234
- };
235
- };
236
- "provider.install": {
237
- params: {
238
- providerId: string;
239
- mirror: "official" | "china";
240
- };
241
- result: {
242
- ok: true;
243
- providerId: string;
244
- };
245
- };
246
- "provider.install.cancel": {
247
- params: {
248
- providerId: string;
249
- };
250
- result: {
251
- ok: true;
252
- providerId: string;
253
- cancelled: boolean;
254
- };
255
- };
256
- "provider.update": {
257
- params: {
258
- providerId: string;
259
- mirror: "official" | "china";
260
- };
261
- result: {
262
- ok: true;
263
- providerId: string;
264
- };
265
- };
266
- "provider.uninstall": {
267
- params: {
268
- providerId: string;
269
- };
270
- result: {
271
- ok: true;
272
- providerId: string;
273
- nativeDataPreserved: true;
274
- };
275
- };
276
- "provider.enable": {
277
- params: {
278
- providerId: string;
279
- };
280
- result: {
281
- ok: true;
282
- };
283
- };
284
- "provider.disable": {
285
- params: {
286
- providerId: string;
287
- };
288
- result: {
289
- ok: true;
290
- };
291
- };
292
- "provider.diagnose": {
293
- params: {
294
- providerId: string;
295
- };
296
- result: AgentProviderDiagnosticWire;
297
- };
298
- "provider.auth.status": {
299
- params: {
300
- providerId: string;
301
- };
302
- result: {
303
- providerId: string;
304
- preference?: "account" | "userKey" | "managed";
305
- state: AgentProviderState;
306
- };
307
- };
308
- "provider.auth.setPreference": {
309
- params: {
310
- providerId: string;
311
- preference: "account" | "userKey" | "managed";
312
- };
313
- result: {
314
- ok: true;
315
- providerId: string;
316
- preference: "account" | "userKey" | "managed";
317
- };
318
- };
319
- "provider.auth.setUserKey": {
320
- params: {
321
- providerId: string;
322
- apiKey: string;
323
- };
324
- result: {
325
- ok: true;
326
- providerId: string;
327
- preference: "userKey";
328
- };
329
- };
330
- "provider.auth.methods": {
331
- params: {
332
- providerId: string;
333
- };
334
- result: {
335
- methods: Array<{
336
- id: string;
337
- label: string;
338
- kind: "protocol" | "terminal";
339
- }>;
340
- };
341
- };
342
- "provider.auth.start": {
343
- params: {
344
- providerId: string;
345
- authMethodId: string;
346
- cols: number;
347
- rows: number;
348
- };
349
- result: {
350
- session: ProviderAuthTerminalSessionWire;
351
- replay: string;
352
- };
353
- };
354
- "provider.auth.attach": {
355
- params: {
356
- authSessionId: string;
357
- };
358
- result: {
359
- session: ProviderAuthTerminalSessionWire;
360
- replay: string;
361
- };
362
- };
363
- "provider.auth.input": {
364
- params: {
365
- authSessionId: string;
366
- data: string;
367
- };
368
- result: {
369
- ok: true;
370
- };
371
- };
372
- "provider.auth.resize": {
373
- params: {
374
- authSessionId: string;
375
- cols: number;
376
- rows: number;
377
- };
378
- result: {
379
- ok: true;
380
- };
381
- };
382
- "provider.auth.cancel": {
383
- params: {
384
- authSessionId: string;
385
- };
386
- result: {
387
- ok: true;
388
- };
389
- };
390
- "provider.auth.logout": {
391
- params: {
392
- providerId: string;
393
- };
394
- result: {
395
- ok: true;
396
- };
397
- };
398
- "provider.models.list": {
399
- params: {
400
- providerId: string;
401
- };
402
- result: {
403
- models: Array<Record<string, unknown>>;
404
- };
405
- };
406
- "provider.nativeSessions.list": {
407
- params: {
408
- providerId: string;
409
- projectId: string;
410
- limit?: number;
411
- };
412
- result: {
413
- sessions: Array<Record<string, unknown>>;
414
- };
415
- };
416
- "provider.nativeSessions.load": {
417
- params: {
418
- providerId: string;
419
- nativeRef: NativeSessionRef;
420
- };
421
- result: NativeTranscript;
422
- };
423
- "provider.nativeSessions.resume": {
424
- params: {
425
- providerId: string;
426
- nativeRef: NativeSessionRef;
427
- parentSessionId: string;
428
- };
429
- result: {
430
- executionSessionId: string;
431
- nativeResumeId?: string;
432
- };
433
- };
434
- "delegation.cancel": {
435
- params: {
436
- parentSessionId: string;
437
- bindingId: string;
438
- delegationId: string;
439
- };
440
- result: {
441
- ok: true;
442
- state: "cancelled";
443
- };
444
- };
445
- "delegation.reset": {
446
- params: {
447
- parentSessionId: string;
448
- providerId: string;
449
- };
450
- result: {
451
- binding: DelegationBinding;
452
- };
453
- };
454
- "session.list": {
455
- params: {
456
- limit?: number;
457
- projectId?: string;
458
- archived?: boolean;
459
- agentId?: string;
460
- };
461
- result: {
462
- sessions: Array<{
463
- sessionId: string;
464
- title?: string;
465
- type?: string;
466
- groupKey?: string;
467
- groupPlatform?: string;
468
- lastActiveAt?: string;
469
- messageCount: number;
470
- pinnedAt?: string | null;
471
- archivedAt?: string | null;
472
- projectId: string;
473
- agentId?: string;
474
- source?: "native";
475
- nativeRef?: NativeSessionRef;
476
- sealedAt?: string | null;
477
- previousSessionId?: string | null;
478
- carryoverSummary?: string | null;
479
- }>;
480
- };
481
- };
482
- "session.get": {
483
- params: {
484
- sessionId: string;
485
- };
486
- result: {
487
- session: {
488
- sessionId: string;
489
- title?: string;
490
- type?: string;
491
- groupKey?: string;
492
- groupPlatform?: string;
493
- lastActiveAt?: string;
494
- messageCount?: number;
495
- pinnedAt?: string | null;
496
- archivedAt?: string | null;
497
- } | null;
498
- };
499
- };
500
- "session.create": {
501
- params: {
502
- sessionId?: string;
503
- title?: string;
504
- type?: string;
505
- ownerPlatform?: string;
506
- ownerId?: string;
507
- groupKey?: string;
508
- groupName?: string;
509
- groupPlatform?: string;
510
- projectId?: string;
511
- projectName?: string;
512
- };
513
- result: {
514
- ok: boolean;
515
- sessionId?: string;
516
- };
517
- };
518
- "session.update": {
519
- params: {
520
- sessionId: string;
521
- title?: string;
522
- pinnedAt?: string | null;
523
- archivedAt?: string | null;
524
- };
525
- result: {
526
- ok: boolean;
527
- };
528
- };
529
- "session.delete": {
530
- params: {
531
- sessionId: string;
532
- projectId: string;
533
- };
534
- result: {
535
- ok: boolean;
536
- };
537
- };
538
- "session.deleteAll": {
539
- params: {
540
- projectId: string;
541
- };
542
- result: {
543
- ok: boolean;
544
- deletedCount: number;
545
- };
546
- };
547
- "session.archive": {
548
- params: {
549
- sessionId: string;
550
- };
551
- result: {
552
- ok: boolean;
553
- };
554
- };
555
- "session.loadNativeTranscript": {
556
- params: {
557
- nativeRef: NativeSessionRef;
558
- };
559
- result: NativeTranscript;
560
- };
561
- "session.adoptNative": {
562
- params: {
563
- nativeRef: NativeSessionRef;
564
- };
565
- result: {
566
- canonicalSessionId: string;
567
- created: boolean;
568
- title?: string;
569
- };
570
- };
571
- "session.moveToProject": {
572
- params: {
573
- sessionId: string;
574
- fromProjectId: string;
575
- toProjectId: string;
576
- };
577
- result: {
578
- ok: boolean;
579
- };
580
- };
581
- "session.getState": {
582
- params: Record<string, never>;
583
- result: {
584
- sessionId: string;
585
- activeProject: ProjectInfo | null;
586
- projects: ProjectInfo[];
587
- };
588
- };
589
- "session.switchProject": {
590
- params: {
591
- projectId?: string;
592
- projectName?: string;
593
- workspaceDir?: string;
594
- };
595
- result: {
596
- ok: boolean;
597
- project: ProjectInfo;
598
- };
599
- };
600
- "session.getMessages": {
601
- params: {
602
- sessionId?: string;
603
- limit?: number;
604
- };
605
- result: {
606
- messages: unknown[];
607
- total: number;
608
- corruptLines?: number;
609
- };
610
- };
611
- "project.list": {
612
- params: Record<string, never>;
613
- result: {
614
- projects: ProjectInfo[];
615
- };
616
- };
617
- "project.create": {
618
- params: {
619
- name: string;
620
- workspaceDir?: string;
621
- type?: ProjectType;
622
- groupId?: string;
623
- };
624
- result: {
625
- ok: boolean;
626
- project?: ProjectInfo;
627
- error?: string;
628
- deduplicated?: boolean;
629
- };
630
- };
631
- "project.detach": {
632
- params: {
633
- projectId: string;
634
- };
635
- result: {
636
- ok: true;
637
- project: ProjectInfo & {
638
- status: "detached";
639
- };
640
- switchedTo?: ProjectInfo;
641
- };
642
- };
643
- "project.delete": {
644
- params: {
645
- projectId: string;
646
- };
647
- result: {
648
- ok: true;
649
- deleted: true;
650
- internalDataDeleted: true;
651
- workspacePreserved: true;
652
- providerNativeSessionsPreserved: true;
653
- };
654
- };
655
- "project.rename": {
656
- params: {
657
- projectId: string;
658
- newName: string;
659
- };
660
- result: {
661
- ok: boolean;
662
- project?: ProjectInfo;
663
- };
664
- };
665
- "project.archive": {
666
- params: {
667
- projectId: string;
668
- };
669
- result: {
670
- ok: boolean;
671
- };
672
- };
673
- "project.unarchive": {
674
- params: {
675
- projectId: string;
676
- };
677
- result: {
678
- ok: boolean;
679
- };
680
- };
681
- "project.update": {
682
- params: {
683
- projectId: string;
684
- planStatus?: "creating" | "running" | "completed" | "failed" | "cancelled";
685
- planAgents?: string[];
686
- planWinnerId?: string;
687
- leaderSessionId?: string;
688
- primaryWorkflowId?: string;
689
- };
690
- result: {
691
- ok: boolean;
692
- };
693
- };
694
- "instructions.list": {
695
- params: {
696
- projectId?: string;
697
- };
698
- result: {
699
- instructions: Array<{
700
- path: string;
701
- name: string;
702
- size: number;
703
- }>;
704
- };
705
- };
706
- "instructions.read": {
707
- params: {
708
- projectId?: string;
709
- path: string;
710
- };
711
- result: {
712
- content: string;
713
- path: string;
714
- };
715
- };
716
- "instructions.write": {
717
- params: {
718
- projectId?: string;
719
- path: string;
720
- content: string;
721
- };
722
- result: {
723
- ok: boolean;
724
- };
725
- };
726
- "instructions.delete": {
727
- params: {
728
- projectId?: string;
729
- path: string;
730
- };
731
- result: {
732
- ok: boolean;
733
- };
734
- };
735
- "files.list": {
736
- params: {
737
- projectId: string;
738
- path?: string;
739
- };
740
- result: {
741
- entries: Array<{
742
- name: string;
743
- path: string;
744
- type: "file" | "directory";
745
- size?: number;
746
- modifiedAt?: string;
747
- }>;
748
- };
749
- };
750
- "files.read": {
751
- params: {
752
- projectId: string;
753
- path: string;
754
- };
755
- result: {
756
- path: string;
757
- content: string;
758
- encoding?: string;
759
- };
760
- };
761
- "files.create": {
762
- params: {
763
- projectId: string;
764
- path: string;
765
- type?: "file" | "directory";
766
- content?: string;
767
- };
768
- result: {
769
- ok: boolean;
770
- path: string;
771
- };
772
- };
773
- "files.rename": {
774
- params: {
775
- projectId: string;
776
- oldPath: string;
777
- newName: string;
778
- };
779
- result: {
780
- ok: boolean;
781
- newPath?: string;
782
- };
783
- };
784
- "files.move": {
785
- params: {
786
- projectId: string;
787
- sourcePath: string;
788
- targetDir: string;
789
- conflictStrategy?: "error" | "keepBoth" | "replace" | "skip";
790
- };
791
- result: {
792
- ok: boolean;
793
- newPath?: string;
794
- operationId?: string;
795
- movedFrom?: string;
796
- movedTo?: string;
797
- skipped?: string[];
798
- };
799
- };
800
- "files.copy": {
801
- params: {
802
- projectId: string;
803
- sourcePath: string;
804
- targetDir: string;
805
- conflictStrategy?: "error" | "keepBoth" | "replace" | "skip";
806
- };
807
- result: {
808
- ok: boolean;
809
- newPath?: string;
810
- operationId?: string;
811
- createdPaths?: string[];
812
- skipped?: string[];
813
- };
814
- };
815
- "files.undoOperation": {
816
- params: {
817
- projectId: string;
818
- operationId: string;
819
- };
820
- result: {
821
- ok: boolean;
822
- };
823
- };
824
- "files.delete": {
825
- params: {
826
- projectId: string;
827
- path: string;
828
- mode?: "trash" | "permanent";
829
- };
830
- result: {
831
- ok: boolean;
832
- operationId?: string;
833
- trashed?: boolean;
834
- };
835
- };
836
- "files.search": {
837
- params: {
838
- projectId: string;
839
- query: string;
840
- limit?: number;
841
- };
842
- result: {
843
- matches: Array<{
844
- name: string;
845
- path: string;
846
- type: "file" | "directory";
847
- }>;
848
- truncated: boolean;
849
- };
850
- };
851
- "files.gitStatus": {
852
- params: {
853
- projectId: string;
854
- };
855
- result: {
856
- files: Array<{
857
- path: string;
858
- status: string;
859
- }>;
860
- };
861
- };
862
- "turnBaseline.getSummary": {
863
- params: {
864
- projectId: string;
865
- turnId: string;
866
- };
867
- result: {
868
- summary: unknown | null;
869
- };
870
- };
871
- "turnBaseline.getFileDiff": {
872
- params: {
873
- projectId: string;
874
- turnId: string;
875
- path: string;
876
- };
877
- result: {
878
- path: string;
879
- previousPath?: string;
880
- status: string;
881
- original: string;
882
- modified: string;
883
- language?: string;
884
- additions?: number;
885
- deletions?: number;
886
- };
887
- };
888
- "turnBaseline.listRecent": {
889
- params: {
890
- projectId: string;
891
- sessionId?: string;
892
- limit?: number;
893
- };
894
- result: {
895
- summaries: unknown[];
896
- };
897
- };
898
- "turnBaseline.getFileBaseline": {
899
- params: {
900
- projectId: string;
901
- turnId: string;
902
- path: string;
903
- };
904
- result: {
905
- path: string;
906
- content: string | null;
907
- snapshot: unknown | null;
908
- };
909
- };
910
- "workingMaterials.get": {
911
- params: {
912
- projectId: string;
913
- sessionId: string;
914
- };
915
- result: {
916
- items: unknown[];
917
- missing: unknown[];
918
- };
919
- };
920
- "workingMaterials.replace": {
921
- params: {
922
- projectId: string;
923
- sessionId: string;
924
- items: unknown[];
925
- };
926
- result: {
927
- ok: boolean;
928
- items: unknown[];
929
- };
930
- };
931
- "workingMaterials.upsert": {
932
- params: {
933
- projectId: string;
934
- sessionId: string;
935
- item: unknown;
936
- };
937
- result: {
938
- ok: boolean;
939
- items: unknown[];
940
- };
941
- };
942
- "workingMaterials.remove": {
943
- params: {
944
- projectId: string;
945
- sessionId: string;
946
- id: string;
947
- };
948
- result: {
949
- ok: boolean;
950
- items: unknown[];
951
- };
952
- };
953
- "workingMaterials.reorder": {
954
- params: {
955
- projectId: string;
956
- sessionId: string;
957
- ids: string[];
958
- };
959
- result: {
960
- ok: boolean;
961
- items: unknown[];
962
- };
963
- };
964
- "skills.list": {
965
- params: {
966
- projectId?: string;
967
- };
968
- result: {
969
- skills: Array<{
970
- id: string;
971
- name: string;
972
- path: string;
973
- active: boolean;
974
- /** Muted everywhere (the plugin card's off switch). */
975
- globallyDisabled: boolean;
976
- /** Muted in THIS project only (the per-project opt-out). */
977
- projectDisabled: boolean;
978
- category: CapabilityCategoryWire;
979
- displayName: LocalizedTextWire;
980
- displayDescription: LocalizedTextWire;
981
- fallbackName: string;
982
- fallbackDescription: string;
983
- systemGenerated: boolean;
984
- version?: string;
985
- registryVersion?: string;
986
- description?: string;
987
- }>;
988
- };
989
- };
990
- "memory.list-files": {
991
- params: {
992
- projectId?: string;
993
- };
994
- result: {
995
- files: Array<{
996
- name: string;
997
- path: string;
998
- size?: number;
999
- }>;
1000
- };
1001
- };
1002
- "memory.atlas": {
1003
- params: {
1004
- pageSize?: number;
1005
- windowStartAt?: number;
1006
- windowEndAt?: number;
1007
- windowCenterAt?: number;
1008
- bucketCount?: number;
1009
- clusterLimit?: number;
1010
- };
1011
- result: {
1012
- totalCount: number;
1013
- records: Array<{
1014
- id: string;
1015
- text: string;
1016
- category: string;
1017
- importance: number;
1018
- confidence: number;
1019
- source: string;
1020
- sessionId: string;
1021
- eventDate: string;
1022
- tags: string[];
1023
- createdAt: number;
1024
- updatedAt: number;
1025
- accessCount: number;
1026
- lastAccessedAt: number;
1027
- isArchived: boolean;
1028
- }>;
1029
- buckets: Array<{
1030
- id: string;
1031
- startAt: number;
1032
- endAt: number;
1033
- count: number;
1034
- avgImportance: number;
1035
- avgConfidence: number;
1036
- topCategory: string;
1037
- }>;
1038
- clusters: Array<{
1039
- id: string;
1040
- label: string;
1041
- kind: "source" | "category" | "tag";
1042
- count: number;
1043
- startAt: number;
1044
- endAt: number;
1045
- avgImportance: number;
1046
- avgConfidence: number;
1047
- topCategory: string;
1048
- }>;
1049
- windowCursor: {
1050
- startAt: number;
1051
- endAt: number;
1052
- centerAt: number;
1053
- pageSize: number;
1054
- hasBefore: boolean;
1055
- hasAfter: boolean;
1056
- } | null;
1057
- timeRange: {
1058
- startAt: number;
1059
- endAt: number;
1060
- } | null;
1061
- stats: {
1062
- formed: number;
1063
- insights: number;
1064
- preferences: number;
1065
- };
1066
- };
1067
- };
1068
- "memory.activity": {
1069
- params: {
1070
- days?: number;
1071
- };
1072
- result: {
1073
- dailyCounts: Array<{
1074
- date: string;
1075
- count: number;
1076
- }>;
1077
- highlights: Array<{
1078
- id: string;
1079
- text: string;
1080
- category: string;
1081
- importance: number;
1082
- date: string;
1083
- }>;
1084
- };
1085
- };
1086
- "memory.propose": {
1087
- params: MemoryTextMutationParams;
1088
- result: {
1089
- ok: boolean;
1090
- extractor?: "llm" | "deterministic";
1091
- candidates: MemoryCandidateWire[];
1092
- relatedMemories?: Array<{
1093
- id: string;
1094
- text: string;
1095
- score: number;
1096
- category?: string;
1097
- }>;
1098
- observationsAdded: number;
1099
- proposalsAdded: number;
1100
- observationIds: string[];
1101
- proposalIds: string[];
1102
- };
1103
- };
1104
- "memory.consolidate": {
1105
- params: MemoryTextMutationParams & {
1106
- candidates?: MemoryCandidateWire[];
1107
- };
1108
- result: MemoryConsolidationResult;
1109
- };
1110
- "memory.update": {
1111
- params: {
1112
- id: string;
1113
- text?: string;
1114
- category?: string;
1115
- importance?: number;
1116
- source?: string;
1117
- eventDate?: string;
1118
- tags?: string[];
1119
- };
1120
- result: {
1121
- ok: boolean;
1122
- updated: number;
1123
- };
1124
- };
1125
- "memory.attachment.adopt": {
1126
- params: {
1127
- tempUrl: string;
1128
- filename?: string;
1129
- mimeType?: string;
1130
- };
1131
- result: {
1132
- ok: boolean;
1133
- attachment?: {
1134
- id: string;
1135
- kind: string;
1136
- filename: string;
1137
- mimeType: string;
1138
- size: number;
1139
- url: string;
1140
- };
1141
- };
1142
- };
1143
- "memory.attachment.locate": {
1144
- params: {
1145
- id: string;
1146
- };
1147
- result: {
1148
- ok: boolean;
1149
- absPath?: string;
1150
- mimeType?: string;
1151
- filename?: string;
1152
- };
1153
- };
1154
- }
1155
- /**
1156
- * Type-safe Agent RPC caller.
1157
- * Gateway passes this around instead of `(string, Record<string, unknown>) => Promise<unknown>`.
1158
- */
1159
- export interface AgentCallOptions {
1160
- timeoutMs?: number;
1161
- requestId?: string;
1162
- idempotencyKey?: string;
1163
- traceId?: string;
1164
- }
1165
- /**
1166
- * Gateway → agent RPC. The gateway is a GENERIC proxy: alongside the strongly-typed methods in
1167
- * GatewayRpcMethodMap (first call signature — params/result inferred), it must forward arbitrary
1168
- * methods by name — dynamic dispatch, and methods not (yet) in the map — via the second signature
1169
- * (opaque params/result). The typed signature is listed first so known method literals resolve to
1170
- * it; a plain `string` method falls through to the proxy signature.
1171
- */
1172
- export type AgentCall = {
1173
- <M extends keyof GatewayRpcMethodMap>(method: M, params: GatewayRpcMethodMap[M]["params"], options?: AgentCallOptions): Promise<GatewayRpcMethodMap[M]["result"]>;
1174
- (method: string, params?: Record<string, unknown>, options?: AgentCallOptions): Promise<unknown>;
1175
- };
1176
- /** All gateway-facing RPC method names (runtime array). */
1177
- export declare const GATEWAY_RPC_METHODS: (keyof GatewayRpcMethodMap)[];