@namzu/sdk 61.3.0 → 62.0.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 (307) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/dist/agents/QueryAgent.d.ts.map +1 -1
  3. package/dist/agents/QueryAgent.js +2 -0
  4. package/dist/agents/QueryAgent.js.map +1 -1
  5. package/dist/bridge/acp/permission.d.ts +8 -0
  6. package/dist/bridge/acp/permission.d.ts.map +1 -1
  7. package/dist/bridge/acp/permission.js.map +1 -1
  8. package/dist/bridge/acp/server.d.ts.map +1 -1
  9. package/dist/bridge/acp/server.js +8 -1
  10. package/dist/bridge/acp/server.js.map +1 -1
  11. package/dist/constants/tools/index.d.ts +2 -0
  12. package/dist/constants/tools/index.d.ts.map +1 -1
  13. package/dist/constants/tools/index.js +23 -0
  14. package/dist/constants/tools/index.js.map +1 -1
  15. package/dist/eval/harness-protection.js +1 -1
  16. package/dist/eval/harness-protection.js.map +1 -1
  17. package/dist/learning/cycle.d.ts +5 -3
  18. package/dist/learning/cycle.d.ts.map +1 -1
  19. package/dist/learning/cycle.js +11 -13
  20. package/dist/learning/cycle.js.map +1 -1
  21. package/dist/learning/guidance.d.ts +74 -0
  22. package/dist/learning/guidance.d.ts.map +1 -0
  23. package/dist/learning/guidance.js +259 -0
  24. package/dist/learning/guidance.js.map +1 -0
  25. package/dist/learning/skill.d.ts +2 -2
  26. package/dist/learning/skill.d.ts.map +1 -1
  27. package/dist/learning/skill.js +6 -6
  28. package/dist/learning/skill.js.map +1 -1
  29. package/dist/learning/store.d.ts.map +1 -1
  30. package/dist/learning/store.js +6 -6
  31. package/dist/learning/store.js.map +1 -1
  32. package/dist/pals/communication/ingress-schema.d.ts +8 -8
  33. package/dist/pals/communication/schema.d.ts +2 -2
  34. package/dist/peers/client.d.ts +2 -3
  35. package/dist/peers/client.d.ts.map +1 -1
  36. package/dist/peers/client.js +2 -3
  37. package/dist/peers/client.js.map +1 -1
  38. package/dist/peers/endpoint.d.ts +1 -2
  39. package/dist/peers/endpoint.d.ts.map +1 -1
  40. package/dist/peers/endpoint.js +1 -2
  41. package/dist/peers/endpoint.js.map +1 -1
  42. package/dist/peers/protocol.d.ts.map +1 -1
  43. package/dist/peers/protocol.js +1 -0
  44. package/dist/peers/protocol.js.map +1 -1
  45. package/dist/prompt/coding-agent-doctrine.d.ts +4 -4
  46. package/dist/prompt/coding-agent-doctrine.d.ts.map +1 -1
  47. package/dist/prompt/coding-agent-doctrine.js +5 -3
  48. package/dist/prompt/coding-agent-doctrine.js.map +1 -1
  49. package/dist/prompt/index.d.ts +0 -4
  50. package/dist/prompt/index.d.ts.map +1 -1
  51. package/dist/prompt/index.js +0 -2
  52. package/dist/prompt/index.js.map +1 -1
  53. package/dist/provider/fallback.d.ts.map +1 -1
  54. package/dist/provider/fallback.js +3 -0
  55. package/dist/provider/fallback.js.map +1 -1
  56. package/dist/provider/idle-timeout.d.ts.map +1 -1
  57. package/dist/provider/idle-timeout.js +5 -0
  58. package/dist/provider/idle-timeout.js.map +1 -1
  59. package/dist/provider/model-window-suffix.d.ts.map +1 -1
  60. package/dist/provider/model-window-suffix.js +1 -0
  61. package/dist/provider/model-window-suffix.js.map +1 -1
  62. package/dist/provider/retry.d.ts.map +1 -1
  63. package/dist/provider/retry.js +5 -0
  64. package/dist/provider/retry.js.map +1 -1
  65. package/dist/provider/step-stopped.d.ts +19 -0
  66. package/dist/provider/step-stopped.d.ts.map +1 -0
  67. package/dist/provider/step-stopped.js +25 -0
  68. package/dist/provider/step-stopped.js.map +1 -0
  69. package/dist/provider/token-budget.d.ts.map +1 -1
  70. package/dist/provider/token-budget.js +6 -1
  71. package/dist/provider/token-budget.js.map +1 -1
  72. package/dist/public-runtime.d.ts +4 -15
  73. package/dist/public-runtime.d.ts.map +1 -1
  74. package/dist/public-runtime.js +3 -14
  75. package/dist/public-runtime.js.map +1 -1
  76. package/dist/public-tools.d.ts +0 -2
  77. package/dist/public-tools.d.ts.map +1 -1
  78. package/dist/public-tools.js +0 -2
  79. package/dist/public-tools.js.map +1 -1
  80. package/dist/public-types.d.ts +3 -21
  81. package/dist/public-types.d.ts.map +1 -1
  82. package/dist/runtime/query/iteration/index.d.ts +17 -0
  83. package/dist/runtime/query/iteration/index.d.ts.map +1 -1
  84. package/dist/runtime/query/iteration/index.js +168 -5
  85. package/dist/runtime/query/iteration/index.js.map +1 -1
  86. package/dist/runtime/query/iteration/phases/per-call-review.d.ts.map +1 -1
  87. package/dist/runtime/query/iteration/phases/per-call-review.js +4 -5
  88. package/dist/runtime/query/iteration/phases/per-call-review.js.map +1 -1
  89. package/dist/runtime/query/iteration/phases/tool-review.d.ts.map +1 -1
  90. package/dist/runtime/query/iteration/phases/tool-review.js +6 -3
  91. package/dist/runtime/query/iteration/phases/tool-review.js.map +1 -1
  92. package/dist/runtime/query/iteration/stream-turn.d.ts +9 -1
  93. package/dist/runtime/query/iteration/stream-turn.d.ts.map +1 -1
  94. package/dist/runtime/query/iteration/stream-turn.js +48 -2
  95. package/dist/runtime/query/iteration/stream-turn.js.map +1 -1
  96. package/dist/runtime/query/resume-pending.d.ts.map +1 -1
  97. package/dist/runtime/query/resume-pending.js +7 -4
  98. package/dist/runtime/query/resume-pending.js.map +1 -1
  99. package/dist/runtime/query/review-policy.d.ts +40 -8
  100. package/dist/runtime/query/review-policy.d.ts.map +1 -1
  101. package/dist/runtime/query/review-policy.js +139 -24
  102. package/dist/runtime/query/review-policy.js.map +1 -1
  103. package/dist/runtime/query/turn/completion-audit.d.ts +32 -0
  104. package/dist/runtime/query/turn/completion-audit.d.ts.map +1 -0
  105. package/dist/runtime/query/turn/completion-audit.js +56 -0
  106. package/dist/runtime/query/turn/completion-audit.js.map +1 -0
  107. package/dist/runtime/query/turn/stall-monitor.d.ts +78 -0
  108. package/dist/runtime/query/turn/stall-monitor.d.ts.map +1 -0
  109. package/dist/runtime/query/turn/stall-monitor.js +101 -0
  110. package/dist/runtime/query/turn/stall-monitor.js.map +1 -0
  111. package/dist/session/paths.d.ts +1 -2
  112. package/dist/session/paths.d.ts.map +1 -1
  113. package/dist/session/paths.js +1 -4
  114. package/dist/session/paths.js.map +1 -1
  115. package/dist/tools/builtins/bash.d.ts +2 -1
  116. package/dist/tools/builtins/bash.d.ts.map +1 -1
  117. package/dist/tools/builtins/bash.js +5 -2
  118. package/dist/tools/builtins/bash.js.map +1 -1
  119. package/dist/tools/builtins/computer-use.d.ts +80 -0
  120. package/dist/tools/builtins/computer-use.d.ts.map +1 -1
  121. package/dist/tools/builtins/computer-use.js +172 -9
  122. package/dist/tools/builtins/computer-use.js.map +1 -1
  123. package/dist/tools/builtins/content-fingerprint.d.ts +13 -0
  124. package/dist/tools/builtins/content-fingerprint.d.ts.map +1 -1
  125. package/dist/tools/builtins/content-fingerprint.js +25 -0
  126. package/dist/tools/builtins/content-fingerprint.js.map +1 -1
  127. package/dist/tools/builtins/edit.d.ts.map +1 -1
  128. package/dist/tools/builtins/edit.js +7 -2
  129. package/dist/tools/builtins/edit.js.map +1 -1
  130. package/dist/tools/builtins/shell-read-credit.d.ts +15 -0
  131. package/dist/tools/builtins/shell-read-credit.d.ts.map +1 -0
  132. package/dist/tools/builtins/shell-read-credit.js +161 -0
  133. package/dist/tools/builtins/shell-read-credit.js.map +1 -0
  134. package/dist/tools/paths.d.ts +15 -2
  135. package/dist/tools/paths.d.ts.map +1 -1
  136. package/dist/tools/paths.js +17 -2
  137. package/dist/tools/paths.js.map +1 -1
  138. package/dist/turn/evidence-recall.d.ts +1 -1
  139. package/dist/turn/evidence-recall.d.ts.map +1 -1
  140. package/dist/turn/evidence-recall.js +5 -14
  141. package/dist/turn/evidence-recall.js.map +1 -1
  142. package/dist/types/acp/index.d.ts +6 -0
  143. package/dist/types/acp/index.d.ts.map +1 -1
  144. package/dist/types/agent/base.d.ts +4 -0
  145. package/dist/types/agent/base.d.ts.map +1 -1
  146. package/dist/types/hitl/index.d.ts +8 -0
  147. package/dist/types/hitl/index.d.ts.map +1 -1
  148. package/dist/types/hitl/index.js.map +1 -1
  149. package/dist/types/ids/index.d.ts +1 -1
  150. package/dist/types/message/index.d.ts +1 -1
  151. package/dist/types/message/index.d.ts.map +1 -1
  152. package/dist/types/message/index.js +1 -0
  153. package/dist/types/message/index.js.map +1 -1
  154. package/dist/types/provider/interface.d.ts +12 -0
  155. package/dist/types/provider/interface.d.ts.map +1 -1
  156. package/dist/types/session/config.d.ts +25 -0
  157. package/dist/types/session/config.d.ts.map +1 -1
  158. package/dist/types/session/records.d.ts.map +1 -1
  159. package/dist/types/session/records.js +2 -0
  160. package/dist/types/session/records.js.map +1 -1
  161. package/dist/types/session/turn.d.ts +1 -1
  162. package/dist/types/session/turn.d.ts.map +1 -1
  163. package/dist/types/session/turn.js.map +1 -1
  164. package/package.json +1 -1
  165. package/src/agents/QueryAgent.ts +2 -0
  166. package/src/bridge/acp/permission.ts +8 -0
  167. package/src/bridge/acp/server.ts +7 -1
  168. package/src/constants/tools/index.ts +27 -0
  169. package/src/eval/harness-protection.ts +1 -1
  170. package/src/learning/cycle.ts +15 -16
  171. package/src/learning/guidance.ts +339 -0
  172. package/src/learning/skill.ts +7 -7
  173. package/src/learning/store.ts +5 -6
  174. package/src/peers/client.ts +2 -3
  175. package/src/peers/endpoint.ts +1 -2
  176. package/src/peers/protocol.ts +1 -0
  177. package/src/prompt/coding-agent-doctrine.ts +5 -3
  178. package/src/prompt/index.ts +0 -4
  179. package/src/provider/fallback.ts +7 -0
  180. package/src/provider/idle-timeout.ts +8 -0
  181. package/src/provider/model-window-suffix.ts +1 -0
  182. package/src/provider/retry.ts +8 -0
  183. package/src/provider/step-stopped.ts +27 -0
  184. package/src/provider/token-budget.ts +6 -1
  185. package/src/public-runtime.ts +10 -28
  186. package/src/public-tools.ts +0 -3
  187. package/src/public-types.ts +5 -137
  188. package/src/runtime/query/iteration/index.ts +207 -5
  189. package/src/runtime/query/iteration/phases/per-call-review.ts +7 -5
  190. package/src/runtime/query/iteration/phases/tool-review.ts +5 -3
  191. package/src/runtime/query/iteration/stream-turn.ts +51 -1
  192. package/src/runtime/query/resume-pending.ts +11 -4
  193. package/src/runtime/query/review-policy.ts +157 -24
  194. package/src/runtime/query/turn/completion-audit.ts +71 -0
  195. package/src/runtime/query/turn/stall-monitor.ts +158 -0
  196. package/src/session/paths.ts +2 -6
  197. package/src/tools/builtins/bash.ts +6 -2
  198. package/src/tools/builtins/computer-use.ts +245 -7
  199. package/src/tools/builtins/content-fingerprint.ts +25 -0
  200. package/src/tools/builtins/edit.ts +11 -2
  201. package/src/tools/builtins/shell-read-credit.ts +159 -0
  202. package/src/tools/paths.ts +18 -2
  203. package/src/turn/evidence-recall.ts +7 -15
  204. package/src/types/acp/index.ts +6 -0
  205. package/src/types/agent/base.ts +4 -0
  206. package/src/types/hitl/index.ts +8 -0
  207. package/src/types/ids/index.ts +1 -1
  208. package/src/types/message/index.ts +1 -0
  209. package/src/types/provider/interface.ts +13 -0
  210. package/src/types/session/config.ts +27 -0
  211. package/src/types/session/records.ts +2 -0
  212. package/src/types/session/turn.ts +2 -1
  213. package/dist/learning/deprecated.d.ts +0 -86
  214. package/dist/learning/deprecated.d.ts.map +0 -1
  215. package/dist/learning/deprecated.js +0 -22
  216. package/dist/learning/deprecated.js.map +0 -1
  217. package/dist/manager/resident/activity.d.ts +0 -74
  218. package/dist/manager/resident/activity.d.ts.map +0 -1
  219. package/dist/manager/resident/activity.js +0 -125
  220. package/dist/manager/resident/activity.js.map +0 -1
  221. package/dist/manager/resident/agenda.d.ts +0 -167
  222. package/dist/manager/resident/agenda.d.ts.map +0 -1
  223. package/dist/manager/resident/agenda.js +0 -588
  224. package/dist/manager/resident/agenda.js.map +0 -1
  225. package/dist/manager/resident/consumption.d.ts +0 -98
  226. package/dist/manager/resident/consumption.d.ts.map +0 -1
  227. package/dist/manager/resident/consumption.js +0 -237
  228. package/dist/manager/resident/consumption.js.map +0 -1
  229. package/dist/manager/resident/delivery-window.d.ts +0 -28
  230. package/dist/manager/resident/delivery-window.d.ts.map +0 -1
  231. package/dist/manager/resident/delivery-window.js +0 -80
  232. package/dist/manager/resident/delivery-window.js.map +0 -1
  233. package/dist/manager/resident/evidence-recall.d.ts +0 -30
  234. package/dist/manager/resident/evidence-recall.d.ts.map +0 -1
  235. package/dist/manager/resident/evidence-recall.js +0 -297
  236. package/dist/manager/resident/evidence-recall.js.map +0 -1
  237. package/dist/manager/resident/history-disk.d.ts +0 -10
  238. package/dist/manager/resident/history-disk.d.ts.map +0 -1
  239. package/dist/manager/resident/history-disk.js +0 -50
  240. package/dist/manager/resident/history-disk.js.map +0 -1
  241. package/dist/manager/resident/history.d.ts +0 -115
  242. package/dist/manager/resident/history.d.ts.map +0 -1
  243. package/dist/manager/resident/history.js +0 -203
  244. package/dist/manager/resident/history.js.map +0 -1
  245. package/dist/manager/resident/host.d.ts +0 -112
  246. package/dist/manager/resident/host.d.ts.map +0 -1
  247. package/dist/manager/resident/host.js +0 -254
  248. package/dist/manager/resident/host.js.map +0 -1
  249. package/dist/manager/resident/initiative.d.ts +0 -86
  250. package/dist/manager/resident/initiative.d.ts.map +0 -1
  251. package/dist/manager/resident/initiative.js +0 -131
  252. package/dist/manager/resident/initiative.js.map +0 -1
  253. package/dist/manager/resident/loop.d.ts +0 -49
  254. package/dist/manager/resident/loop.d.ts.map +0 -1
  255. package/dist/manager/resident/loop.js +0 -75
  256. package/dist/manager/resident/loop.js.map +0 -1
  257. package/dist/manager/resident/outbox.d.ts +0 -124
  258. package/dist/manager/resident/outbox.d.ts.map +0 -1
  259. package/dist/manager/resident/outbox.js +0 -216
  260. package/dist/manager/resident/outbox.js.map +0 -1
  261. package/dist/manager/resident/proposal.d.ts +0 -65
  262. package/dist/manager/resident/proposal.d.ts.map +0 -1
  263. package/dist/manager/resident/proposal.js +0 -77
  264. package/dist/manager/resident/proposal.js.map +0 -1
  265. package/dist/manager/resident/store.d.ts +0 -108
  266. package/dist/manager/resident/store.d.ts.map +0 -1
  267. package/dist/manager/resident/store.js +0 -205
  268. package/dist/manager/resident/store.js.map +0 -1
  269. package/dist/manager/resident/tool-evidence.d.ts +0 -112
  270. package/dist/manager/resident/tool-evidence.d.ts.map +0 -1
  271. package/dist/manager/resident/tool-evidence.js +0 -289
  272. package/dist/manager/resident/tool-evidence.js.map +0 -1
  273. package/dist/prompt/resident-learning.d.ts +0 -29
  274. package/dist/prompt/resident-learning.d.ts.map +0 -1
  275. package/dist/prompt/resident-learning.js +0 -126
  276. package/dist/prompt/resident-learning.js.map +0 -1
  277. package/dist/prompt/resident-step.d.ts +0 -42
  278. package/dist/prompt/resident-step.d.ts.map +0 -1
  279. package/dist/prompt/resident-step.js +0 -137
  280. package/dist/prompt/resident-step.js.map +0 -1
  281. package/dist/tools/resident-history.d.ts +0 -12
  282. package/dist/tools/resident-history.d.ts.map +0 -1
  283. package/dist/tools/resident-history.js +0 -82
  284. package/dist/tools/resident-history.js.map +0 -1
  285. package/dist/tools/resident-tool-evidence.d.ts +0 -9
  286. package/dist/tools/resident-tool-evidence.d.ts.map +0 -1
  287. package/dist/tools/resident-tool-evidence.js +0 -61
  288. package/dist/tools/resident-tool-evidence.js.map +0 -1
  289. package/src/learning/deprecated.ts +0 -124
  290. package/src/manager/resident/activity.ts +0 -211
  291. package/src/manager/resident/agenda.ts +0 -937
  292. package/src/manager/resident/consumption.ts +0 -335
  293. package/src/manager/resident/delivery-window.ts +0 -99
  294. package/src/manager/resident/evidence-recall.ts +0 -369
  295. package/src/manager/resident/history-disk.ts +0 -63
  296. package/src/manager/resident/history.ts +0 -348
  297. package/src/manager/resident/host.ts +0 -390
  298. package/src/manager/resident/initiative.ts +0 -231
  299. package/src/manager/resident/loop.ts +0 -119
  300. package/src/manager/resident/outbox.ts +0 -341
  301. package/src/manager/resident/proposal.ts +0 -119
  302. package/src/manager/resident/store.ts +0 -279
  303. package/src/manager/resident/tool-evidence.ts +0 -455
  304. package/src/prompt/resident-learning.ts +0 -152
  305. package/src/prompt/resident-step.ts +0 -182
  306. package/src/tools/resident-history.ts +0 -88
  307. package/src/tools/resident-tool-evidence.ts +0 -72
@@ -1,86 +0,0 @@
1
- import { z } from 'zod';
2
- import type { ResidentAgendaState } from './agenda.js';
3
- export declare const residentObservationSchema: z.ZodObject<{
4
- evidenceKey: z.ZodString;
5
- source: z.ZodString;
6
- progress: z.ZodNumber;
7
- costUnits: z.ZodNullable<z.ZodNumber>;
8
- }, z.core.$strip>;
9
- /**
10
- * @experimental Host-validated outcome and measured resource use, never model self-confidence.
11
- *
12
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
13
- */
14
- export type ResidentObservation = Readonly<z.infer<typeof residentObservationSchema>>;
15
- export declare const residentFeedbackSchema: z.ZodObject<{
16
- bestProgress: z.ZodNumber;
17
- hasUnobservedSteps: z.ZodDefault<z.ZodBoolean>;
18
- stagnantSteps: z.ZodNumber;
19
- observations: z.ZodArray<z.ZodObject<{
20
- evidenceKey: z.ZodString;
21
- source: z.ZodString;
22
- progress: z.ZodNumber;
23
- costUnits: z.ZodNullable<z.ZodNumber>;
24
- gain: z.ZodNumber;
25
- step: z.ZodNumber;
26
- }, z.core.$strip>>;
27
- }, z.core.$strip>;
28
- /**
29
- * @experimental Last eight observations; best progress and stagnation survive eviction.
30
- *
31
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
32
- */
33
- export type ResidentFeedback = Readonly<Omit<z.infer<typeof residentFeedbackSchema>, 'observations'>> & {
34
- readonly observations: readonly Readonly<z.infer<typeof residentFeedbackSchema>['observations'][number]>[];
35
- };
36
- export declare function observeResidentStep(previous: ResidentFeedback | undefined, input: ResidentObservation, step: number): ResidentFeedback;
37
- export declare function freezeResidentFeedback(value: ResidentFeedback): ResidentFeedback;
38
- /**
39
- * @experimental Policy units are chosen by the host; scores are heuristics, not probabilities.
40
- *
41
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
42
- */
43
- export interface ResidentSelectionConfig {
44
- readonly progressValue: number;
45
- readonly initialExpectedProgress: number;
46
- readonly initialExpectedCost: number;
47
- readonly maxStagnantSteps?: number;
48
- }
49
- /**
50
- * @experimental Explainable inputs for a single selection; unknown cost is not zero.
51
- *
52
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
53
- */
54
- export interface ResidentCandidate {
55
- readonly pursuitId: string;
56
- readonly reason: 'eligible' | 'not-due' | 'missing-observation' | 'stalled' | 'unknown-cost' | 'nonpositive-value';
57
- readonly expectedGain: number | null;
58
- readonly expectedCost: number | null;
59
- readonly score: number | null;
60
- }
61
- /**
62
- * @experimental Choice is bound to the whole agenda revision used to compute it.
63
- *
64
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
65
- */
66
- export interface ResidentSelection {
67
- readonly agendaRevision: number;
68
- readonly pursuitId: string | null;
69
- readonly reason: 'selected' | 'paused' | 'unresolved' | 'no-useful-work';
70
- readonly candidates: readonly ResidentCandidate[];
71
- }
72
- /**
73
- * @experimental Pure local selection; perform inference inside budgeted steps, not here.
74
- *
75
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
76
- */
77
- export type ResidentSelector = (agenda: ResidentAgendaState, now: number) => ResidentSelection;
78
- /**
79
- * @experimental Cost-aware continuation with an explicit abstention choice.
80
- * This is a measured-progress heuristic, not Bayesian value of computation.
81
- * A finite bootstrap allowance permits delayed payoffs but may stop too early.
82
- *
83
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
84
- */
85
- export declare function createResidentSelector(config: ResidentSelectionConfig): ResidentSelector;
86
- //# sourceMappingURL=initiative.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"initiative.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/initiative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAItD,eAAO,MAAM,yBAAyB;;;;;iBAMpC,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAA;AAErF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAajC,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CACtC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAAE,cAAc,CAAC,CAC5D,GAAG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,QAAQ,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAC9D,EAAE,CAAA;CACH,CAAA;AAED,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,MAAM,GACV,gBAAgB,CAkBlB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAKhF;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EACZ,UAAU,GACV,SAAS,GACT,qBAAqB,GACrB,SAAS,GACT,cAAc,GACd,mBAAmB,CAAA;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAA;IACxE,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACjD;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,KAAK,iBAAiB,CAAA;AAc9F;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAkFxF"}
@@ -1,131 +0,0 @@
1
- import { z } from 'zod';
2
- const boundedText = z.string().trim().min(1).max(256);
3
- const cost = z.number().finite().nonnegative();
4
- export const residentObservationSchema = z.object({
5
- evidenceKey: boundedText,
6
- source: boundedText,
7
- progress: z.number().finite().min(0).max(1),
8
- /** All observations and policy costs use the same host-defined resource unit. */
9
- costUnits: cost.nullable(),
10
- });
11
- export const residentFeedbackSchema = z.object({
12
- bestProgress: z.number().finite().min(0).max(1),
13
- hasUnobservedSteps: z.boolean().default(false),
14
- stagnantSteps: z.number().int().nonnegative().safe(),
15
- observations: z
16
- .array(residentObservationSchema.extend({
17
- gain: z.number().finite().min(0).max(1),
18
- step: z.number().int().positive().safe(),
19
- }))
20
- .min(1)
21
- .max(8),
22
- });
23
- export function observeResidentStep(previous, input, step) {
24
- const observation = residentObservationSchema.parse(input);
25
- const best = previous?.bestProgress ?? 0;
26
- const duplicate = previous?.observations.some((item) => item.evidenceKey === observation.evidenceKey);
27
- // Rewording evidence, regression and recovery to an old best earn no credit.
28
- const gain = duplicate ? 0 : Math.max(0, observation.progress - best);
29
- return freezeResidentFeedback(residentFeedbackSchema.parse({
30
- bestProgress: best + gain,
31
- hasUnobservedSteps: (previous?.hasUnobservedSteps ?? false) ||
32
- step !== (previous?.observations.at(-1)?.step ?? 0) + 1,
33
- stagnantSteps: gain > 0 ? 0 : (previous?.stagnantSteps ?? 0) + 1,
34
- observations: [...(previous?.observations ?? []), { ...observation, gain, step }].slice(-8),
35
- }));
36
- }
37
- export function freezeResidentFeedback(value) {
38
- return Object.freeze({
39
- ...value,
40
- observations: Object.freeze(value.observations.map((item) => Object.freeze({ ...item }))),
41
- });
42
- }
43
- function meanObservedCost(observations) {
44
- // Null costs are rejected before this function. Scale by the largest finite
45
- // observation: the intermediate sum is at most eight, even near MAX_VALUE.
46
- const scale = Math.max(...observations.map((item) => item.costUnits ?? 0));
47
- if (scale === 0)
48
- return 0;
49
- return ((observations.reduce((total, item) => total + (item.costUnits ?? 0) / scale, 0) /
50
- observations.length) *
51
- scale);
52
- }
53
- /**
54
- * @experimental Cost-aware continuation with an explicit abstention choice.
55
- * This is a measured-progress heuristic, not Bayesian value of computation.
56
- * A finite bootstrap allowance permits delayed payoffs but may stop too early.
57
- *
58
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
59
- */
60
- export function createResidentSelector(config) {
61
- const policy = z
62
- .object({
63
- progressValue: z.number().finite().positive(),
64
- initialExpectedProgress: z.number().finite().positive().max(1),
65
- initialExpectedCost: cost,
66
- maxStagnantSteps: z.number().int().min(1).max(32).default(2),
67
- })
68
- .parse(config);
69
- return (agenda, now) => {
70
- z.number().int().nonnegative().safe().parse(now);
71
- const finish = (pursuitId, reason, candidates) => Object.freeze({
72
- agendaRevision: agenda.revision,
73
- pursuitId,
74
- reason,
75
- candidates: Object.freeze(candidates.map((candidate) => Object.freeze(candidate))),
76
- });
77
- if (agenda.paused)
78
- return finish(null, 'paused', []);
79
- if (agenda.pursuits.some((p) => p.state.phase === 'running'))
80
- return finish(null, 'unresolved', []);
81
- const candidates = agenda.pursuits.map((p) => {
82
- const reject = (reason) => ({
83
- pursuitId: p.id,
84
- reason,
85
- expectedGain: null,
86
- expectedCost: null,
87
- score: null,
88
- });
89
- if (p.state.phase !== 'waiting' || p.state.wakeAt === null || p.state.wakeAt > now)
90
- return reject('not-due');
91
- if (p.state.stepsAdmitted > 0 &&
92
- (!p.feedback ||
93
- p.feedback.hasUnobservedSteps ||
94
- p.feedback.observations.at(-1)?.step !== p.state.stepsAdmitted))
95
- return reject('missing-observation');
96
- const feedback = p.feedback;
97
- if (feedback && feedback.stagnantSteps >= policy.maxStagnantSteps)
98
- return reject('stalled');
99
- if (feedback?.observations.some((item) => item.costUnits === null))
100
- return reject('unknown-cost');
101
- const recent = feedback?.observations ?? [];
102
- const totalGain = recent.reduce((total, item) => total + item.gain, 0);
103
- const bootstrap = p.state.stepsAdmitted < policy.maxStagnantSteps && totalGain === 0;
104
- const expectedGain = recent.length === 0 || bootstrap
105
- ? policy.initialExpectedProgress
106
- : (totalGain + policy.initialExpectedProgress) / (recent.length + 1);
107
- const expectedCost = recent.length === 0 ? policy.initialExpectedCost : meanObservedCost(recent);
108
- const score = policy.progressValue * expectedGain - expectedCost;
109
- return {
110
- pursuitId: p.id,
111
- reason: score > 0 ? 'eligible' : 'nonpositive-value',
112
- expectedGain,
113
- expectedCost,
114
- score,
115
- };
116
- });
117
- const eligible = candidates.filter((candidate) => candidate.reason === 'eligible');
118
- eligible.sort((a, b) => {
119
- const left = agenda.pursuits.find((p) => p.id === a.pursuitId);
120
- const right = agenda.pursuits.find((p) => p.id === b.pursuitId);
121
- if (!left || !right)
122
- throw new Error('Resident candidate is missing.');
123
- return ((b.score ?? 0) - (a.score ?? 0) ||
124
- left.state.stepsAdmitted - right.state.stepsAdmitted ||
125
- (left.state.wakeAt ?? 0) - (right.state.wakeAt ?? 0) ||
126
- a.pursuitId.localeCompare(b.pursuitId));
127
- });
128
- return finish(eligible[0]?.pursuitId ?? null, eligible.length ? 'selected' : 'no-useful-work', candidates);
129
- };
130
- }
131
- //# sourceMappingURL=initiative.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"initiative.js","sourceRoot":"","sources":["../../../src/manager/resident/initiative.ts"],"names":[],"mappings":"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"}
@@ -1,49 +0,0 @@
1
- import { type ResidentDecision, type ResidentExecutionStore, type ResidentState } from './store.js';
2
- /**
3
- * @experimental Developer-owned step; bind providers, tools and budgets in the host.
4
- *
5
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
6
- */
7
- export type ResidentStep = (state: ResidentState, signal: AbortSignal) => Promise<ResidentDecision>;
8
- /**
9
- * @experimental No model is invoked for an idle, terminal or unresolved resident.
10
- *
11
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
12
- */
13
- export type ResidentStepResult = {
14
- status: 'settled';
15
- state: ResidentState;
16
- } | {
17
- status: 'idle';
18
- reason: 'not-due' | 'terminal' | 'unresolved' | 'contended';
19
- state: ResidentState;
20
- };
21
- /**
22
- * @experimental A failed/aborted callback leaves its durable claim unresolved.
23
- *
24
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
25
- */
26
- export declare function stepResident(store: ResidentExecutionStore, step: ResidentStep, signal: AbortSignal, now?: () => number): Promise<ResidentStepResult>;
27
- /**
28
- * @experimental Bounded local driver; not a daemon, process recovery service or notification transport.
29
- *
30
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
31
- */
32
- export interface ResidentLoopOptions {
33
- readonly store: ResidentExecutionStore;
34
- readonly step: ResidentStep;
35
- readonly signal: AbortSignal;
36
- /** Required finite admission cap for this invocation, independent of provider token limits. */
37
- readonly maxSteps: number;
38
- /** Maximum single idle wait, default 60 seconds. Longer waits return control to the host. */
39
- readonly maxIdleMs?: number;
40
- }
41
- /**
42
- * @experimental Continue a pursuit without a new user message. Null wake times
43
- * and terminal states stop immediately; cancellation also interrupts idle waits.
44
- * An abort cannot undo callback effects or forcibly stop a callback ignoring its signal.
45
- *
46
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
47
- */
48
- export declare function runResident(options: ResidentLoopOptions): Promise<ResidentStepResult>;
49
- //# sourceMappingURL=loop.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/loop.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAEnG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3C;IACA,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAA;IAC3D,KAAK,EAAE,aAAa,CAAA;CACnB,CAAA;AAEJ;;;;GAIG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,sBAAsB,EAC7B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,MAAM,MAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6B3F"}
@@ -1,75 +0,0 @@
1
- import { setTimeout as sleep } from 'node:timers/promises';
2
- import { ResidentConflictError, } from './store.js';
3
- /**
4
- * @experimental A failed/aborted callback leaves its durable claim unresolved.
5
- *
6
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
7
- */
8
- export async function stepResident(store, step, signal, now = Date.now) {
9
- signal.throwIfAborted();
10
- const state = await store.read();
11
- signal.throwIfAborted();
12
- if (!state)
13
- throw new Error('Create the resident before running it.');
14
- if (state.phase === 'running')
15
- return { status: 'idle', reason: 'unresolved', state };
16
- if (state.phase !== 'waiting')
17
- return { status: 'idle', reason: 'terminal', state };
18
- if (state.wakeAt === null || state.wakeAt > now())
19
- return { status: 'idle', reason: 'not-due', state };
20
- let claim;
21
- try {
22
- claim = await store.claim(state, now());
23
- }
24
- catch (error) {
25
- if (!(error instanceof ResidentConflictError))
26
- throw error;
27
- return {
28
- status: 'idle',
29
- reason: 'contended',
30
- state: (await store.read()) ?? state,
31
- };
32
- }
33
- signal.throwIfAborted();
34
- const decision = await step(claim, signal);
35
- signal.throwIfAborted();
36
- return {
37
- status: 'settled',
38
- state: await store.settle(claim, decision, now()),
39
- };
40
- }
41
- /**
42
- * @experimental Continue a pursuit without a new user message. Null wake times
43
- * and terminal states stop immediately; cancellation also interrupts idle waits.
44
- * An abort cannot undo callback effects or forcibly stop a callback ignoring its signal.
45
- *
46
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
47
- */
48
- export async function runResident(options) {
49
- const maxIdleMs = options.maxIdleMs ?? 60_000;
50
- if (!Number.isSafeInteger(options.maxSteps) ||
51
- options.maxSteps < 1 ||
52
- !Number.isSafeInteger(maxIdleMs) ||
53
- maxIdleMs < 0 ||
54
- maxIdleMs > 2_147_483_647) {
55
- throw new TypeError('Resident loop requires positive finite maxSteps and bounded nonnegative maxIdleMs.');
56
- }
57
- let admitted = 0;
58
- while (true) {
59
- const result = await stepResident(options.store, options.step, options.signal);
60
- if (result.status === 'settled')
61
- admitted++;
62
- if (admitted >= options.maxSteps)
63
- return result;
64
- const { state } = result;
65
- if (state.phase !== 'waiting' ||
66
- state.wakeAt === null ||
67
- (result.status === 'idle' && result.reason !== 'not-due'))
68
- return result;
69
- const delay = Math.max(0, state.wakeAt - Date.now());
70
- if (delay > maxIdleMs)
71
- return result;
72
- await sleep(Math.max(1, delay), undefined, { signal: options.signal });
73
- }
74
- }
75
- //# sourceMappingURL=loop.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/manager/resident/loop.ts"],"names":[],"mappings":"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"}
@@ -1,124 +0,0 @@
1
- import { z } from 'zod';
2
- import type { ResidentAgendaState } from './agenda.js';
3
- export declare const residentMessageInputSchema: z.ZodObject<{
4
- id: z.ZodString;
5
- pursuitId: z.ZodString;
6
- destination: z.ZodString;
7
- body: z.ZodString;
8
- notBefore: z.ZodNumber;
9
- }, z.core.$strip>;
10
- /**
11
- * @experimental Host-approved content and an opaque destination route, never credentials.
12
- *
13
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
14
- */
15
- export type ResidentMessageInput = Readonly<z.infer<typeof residentMessageInputSchema>>;
16
- export declare const residentOutboxMessageSchema: z.ZodObject<{
17
- id: z.ZodString;
18
- pursuitId: z.ZodString;
19
- destination: z.ZodString;
20
- body: z.ZodString;
21
- notBefore: z.ZodNumber;
22
- tenantId: z.ZodString;
23
- agentKey: z.ZodString;
24
- sourceClaimId: z.ZodNullable<z.ZodString>;
25
- revision: z.ZodNumber;
26
- attempts: z.ZodNumber;
27
- phase: z.ZodEnum<{
28
- cancelled: "cancelled";
29
- pending: "pending";
30
- acknowledged: "acknowledged";
31
- sending: "sending";
32
- }>;
33
- claimId: z.ZodNullable<z.ZodString>;
34
- nextAttemptAt: z.ZodNullable<z.ZodNumber>;
35
- receiptId: z.ZodNullable<z.ZodString>;
36
- acknowledgedAt: z.ZodNullable<z.ZodNumber>;
37
- lastReason: z.ZodNullable<z.ZodString>;
38
- }, z.core.$strip>;
39
- /**
40
- * @experimental Acknowledgment proves transport acceptance, not human reading.
41
- *
42
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
43
- */
44
- export type ResidentOutboxMessage = Readonly<z.infer<typeof residentOutboxMessageSchema>>;
45
- export declare const residentDeliveryOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
46
- kind: z.ZodLiteral<"acknowledged">;
47
- receiptId: z.ZodString;
48
- }, z.core.$strip>, z.ZodObject<{
49
- kind: z.ZodLiteral<"not-accepted">;
50
- retryAt: z.ZodNullable<z.ZodNumber>;
51
- reason: z.ZodString;
52
- }, z.core.$strip>], "kind">;
53
- /**
54
- * @experimental Retry only with evidence of non-acceptance; null retryAt ends delivery.
55
- *
56
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
57
- */
58
- export type ResidentDeliveryOutcome = Readonly<z.infer<typeof residentDeliveryOutcomeSchema>>;
59
- /**
60
- * @experimental Atomic admission and exact-claim settlement, without automatic claim expiry.
61
- *
62
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
63
- */
64
- export interface ResidentOutboxStore {
65
- read(): Promise<ResidentAgendaState | null>;
66
- claimMessage(expected: ResidentAgendaState, id: string, now: number): Promise<ResidentOutboxMessage>;
67
- settleMessage(expected: ResidentOutboxMessage, outcome: ResidentDeliveryOutcome, now: number): Promise<ResidentOutboxMessage>;
68
- }
69
- /**
70
- * @experimental A synchronous host policy, evaluated before claiming and again before sending.
71
- *
72
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
73
- */
74
- export type ResidentDeliveryGate = (message: ResidentOutboxMessage, now: number) => {
75
- readonly allow: true;
76
- } | {
77
- readonly allow: false;
78
- readonly nextCheckAt: number | null;
79
- readonly reason: string;
80
- };
81
- /**
82
- * @experimental Bind an authorized route; forward message.id as the stable idempotency key.
83
- *
84
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
85
- */
86
- export type ResidentMessageTransport = (message: ResidentOutboxMessage, signal: AbortSignal) => Promise<ResidentDeliveryOutcome>;
87
- /**
88
- * @experimental One dispatch admission, with no model invocation, polling or implicit retries.
89
- *
90
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
91
- */
92
- export interface ResidentDeliveryOptions {
93
- readonly signal: AbortSignal;
94
- readonly gate: ResidentDeliveryGate;
95
- readonly now?: () => number;
96
- }
97
- /**
98
- * @experimental An idle result never asserts a message reached its destination.
99
- *
100
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
101
- */
102
- export type ResidentDeliveryResult = {
103
- readonly status: 'settled';
104
- readonly message: ResidentOutboxMessage;
105
- } | {
106
- readonly status: 'idle';
107
- readonly reason: 'paused' | 'unresolved' | 'empty' | 'not-due' | 'window' | 'contended';
108
- readonly nextCheckAt: number | null;
109
- };
110
- /** Internal pure enqueue used in the same revision transaction as pursuit settlement. */
111
- export declare function appendResidentMessage(state: ResidentAgendaState, input: ResidentMessageInput, sourceClaimId?: string | null): readonly ResidentOutboxMessage[];
112
- /** Internal exact-message transition; agenda storage owns exclusive admission. */
113
- export declare function claimResidentOutboxMessage(message: ResidentOutboxMessage, now: number): ResidentOutboxMessage;
114
- /** Internal settlement; unknown failures deliberately have no transition. */
115
- export declare function settleResidentOutboxMessage(message: ResidentOutboxMessage, outcome: ResidentDeliveryOutcome, now: number): ResidentOutboxMessage;
116
- /**
117
- * @experimental Persist one send claim before calling a host-owned transport.
118
- * Throws, malformed outcomes and cancellation keep the claim unresolved. Stop
119
- * old executors and inspect effects before explicit settleMessage reconciliation.
120
- *
121
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
122
- */
123
- export declare function deliverResidentMessage(store: ResidentOutboxStore, transport: ResidentMessageTransport, options: ResidentDeliveryOptions): Promise<ResidentDeliveryResult>;
124
- //# sourceMappingURL=outbox.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/outbox.ts"],"names":[],"mappings":"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"}