@desplega.ai/agent-swarm 2.7.9 → 2.7.10

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 (212) hide show
  1. package/dist/{acp-adapter-dn4gdsgr.js → acp-adapter-srfhs1s9.js} +5 -5
  2. package/dist/{actions-g563mbn2.js → actions-b8aqhrsg.js} +19 -18
  3. package/dist/{amp-adapter-q61w05eb.js → amp-adapter-4c165vgn.js} +1 -1
  4. package/dist/app-m9khefrh.js +20 -0
  5. package/dist/{assistant-p477rjwj.js → assistant-rh4v3ntz.js} +21 -20
  6. package/dist/{boot-args-schema-h4qj462e.js → boot-args-schema-hwkc8bzv.js} +1 -1
  7. package/dist/{boot-reembed-n1ehfbsw.js → boot-reembed-5y6yw9sj.js} +1 -1
  8. package/dist/{boot-reembed-qw4mc0pt.js → boot-reembed-fdyk55h4.js} +1 -1
  9. package/dist/{boot-scrub-sweep-9w9jp4sm.js → boot-scrub-sweep-r5r8kqsn.js} +3 -3
  10. package/dist/{boot-seeds-qdaf3sdy.js → boot-seeds-8f9zt5cm.js} +5 -5
  11. package/dist/{claude-adapter-348p5hx9.js → claude-adapter-s5df247c.js} +5 -5
  12. package/dist/{claude-managed-setup-7787fxtp.js → claude-managed-setup-9gsmwzyx.js} +1 -1
  13. package/dist/{claude-sdk-session-hbszbt8a.js → claude-sdk-session-dq1j4nz9.js} +5 -5
  14. package/dist/{cli-btf6fw39.js → cli-0m7rtm11.js} +1 -1
  15. package/dist/{cli-cseh6f8w.js → cli-16phend6.js} +1 -1
  16. package/dist/{cli-ms5m5r1y.js → cli-18qt3few.js} +1 -1
  17. package/dist/{cli-sgs5k6yd.js → cli-2tsfpc70.js} +1 -1
  18. package/dist/{cli-rwymrnaz.js → cli-36wdfzgn.js} +8 -8
  19. package/dist/{cli-qzt90yze.js → cli-38yww4e9.js} +8 -8
  20. package/dist/{cli-2a8py3sx.js → cli-3xddv0rk.js} +4 -4
  21. package/dist/{cli-p0m0p34z.js → cli-4vwxp550.js} +2 -2
  22. package/dist/{cli-bc779n4v.js → cli-55bkx8hh.js} +1 -1
  23. package/dist/{cli-21159vea.js → cli-5wfz00be.js} +2 -2
  24. package/dist/{cli-9aezs55w.js → cli-5xcb8gxq.js} +4 -4
  25. package/dist/{cli-12xyjhws.js → cli-6m6b4bep.js} +2 -2
  26. package/dist/{cli-fayav105.js → cli-7wz05bx3.js} +292 -83
  27. package/dist/{cli-y8nbefpb.js → cli-8ewkreqd.js} +9 -5
  28. package/dist/{cli-0whpms1z.js → cli-an1knn2k.js} +4 -4
  29. package/dist/{cli-qmd3mse0.js → cli-bxz823sz.js} +1 -1
  30. package/dist/{cli-a0657jmf.js → cli-bzvs88tv.js} +1 -1
  31. package/dist/{cli-agyaeef4.js → cli-cr14kftt.js} +2 -2
  32. package/dist/{cli-715t1gx6.js → cli-eb2azq8n.js} +3 -3
  33. package/dist/{cli-530hkwdy.js → cli-ed6yqpf1.js} +2 -2
  34. package/dist/{cli-k70e3x9e.js → cli-eqk5p56g.js} +3 -3
  35. package/dist/{cli-4t0fmf3z.js → cli-g1px1g2e.js} +1 -1
  36. package/dist/{cli-09kmfkmq.js → cli-h49ejvmc.js} +1 -1
  37. package/dist/{cli-cvs2r2vq.js → cli-hfkwwy1h.js} +39 -5
  38. package/dist/{cli-neyag5p6.js → cli-j7d73g1y.js} +371 -116
  39. package/dist/{cli-p17970qv.js → cli-jg24scat.js} +2 -2
  40. package/dist/{cli-varqt4d1.js → cli-kx4c8j05.js} +16 -13
  41. package/dist/{cli-jfx48xrj.js → cli-mp9aa8g5.js} +1 -1
  42. package/dist/{cli-605nn699.js → cli-mr97t7cc.js} +644 -225
  43. package/dist/{cli-v3cf1ts9.js → cli-n07eecjs.js} +3 -3
  44. package/dist/{cli-y5rbvxhc.js → cli-n515ex5z.js} +14 -14
  45. package/dist/{cli-3tqcamp6.js → cli-n9abj89w.js} +13 -12
  46. package/dist/{cli-ypff1qwp.js → cli-n9ftpys4.js} +7 -7
  47. package/dist/{cli-xk879m3k.js → cli-nj3x45rw.js} +27 -27
  48. package/dist/{cli-9r5gtwjr.js → cli-pyrxt9gw.js} +196 -1
  49. package/dist/{cli-mnrkgg60.js → cli-q581b386.js} +2 -2
  50. package/dist/{cli-hwprv9e4.js → cli-rjyghzg4.js} +2 -2
  51. package/dist/{cli-650zv9q9.js → cli-rt0ag4x1.js} +3 -3
  52. package/dist/{cli-vxh6acp7.js → cli-td33w98c.js} +2 -2
  53. package/dist/{cli-tqq0hspb.js → cli-tmft5dz2.js} +1 -1
  54. package/dist/{cli-q26b9wre.js → cli-tph5wt3y.js} +4 -4
  55. package/dist/{cli-qkdmz8c8.js → cli-ttbqe3q4.js} +1 -1
  56. package/dist/{cli-zgv8gxgs.js → cli-v2fwbnsk.js} +6 -6
  57. package/dist/{cli-b932gexn.js → cli-w3bk0dgv.js} +1 -1
  58. package/dist/{cli-serm8zrx.js → cli-x9exydey.js} +1 -1
  59. package/dist/{cli-hae9j8sv.js → cli-xbtq4d6s.js} +3 -3
  60. package/dist/{cli-587857ys.js → cli-xd5ebp64.js} +3 -3
  61. package/dist/{cli-ejkvvqbe.js → cli-xncjscpm.js} +10 -10
  62. package/dist/{cli-gce09r66.js → cli-xvymtmv4.js} +2 -2
  63. package/dist/{cli-btc9cb4c.js → cli-yz7v0sh4.js} +2 -2
  64. package/dist/{cli-sya22y84.js → cli-z9cs5m0w.js} +3 -3
  65. package/dist/{cli-2ccpqyyf.js → cli-zjphdj1a.js} +71 -10
  66. package/dist/cli.js +15 -15
  67. package/dist/{codex-adapter-ysq6bzha.js → codex-adapter-yr60sme6.js} +3 -3
  68. package/dist/{codex-session-runner-qakzfx93.js → codex-session-runner-pch8x584.js} +3 -3
  69. package/dist/{commands-rs7hkv9r.js → commands-phjfbkv0.js} +3 -3
  70. package/dist/{controller-r5x9bg6e.js → controller-jkx994pz.js} +2 -2
  71. package/dist/{controllers-connect-498hrxvk.js → controllers-connect-c4448kwa.js} +20 -19
  72. package/dist/{cursor-adapter-d46qszer.js → cursor-adapter-ndebqnm8.js} +1 -1
  73. package/dist/{db-pm96nhdb.js → db-ef32tbfc.js} +4 -2
  74. package/dist/{db-s13dqhr6.js → db-ez6egt6v.js} +3 -3
  75. package/dist/{dispatcher-j3h81t7m.js → dispatcher-g3tt9hs9.js} +18 -17
  76. package/dist/{dsh-adapter-rw0d5rc4.js → dsh-adapter-tcyn3099.js} +1 -1
  77. package/dist/{easter-egg-3d-qtgfxgze.js → easter-egg-3d-e36hk5td.js} +1 -1
  78. package/dist/{embedding-space-xh8p4q4x.js → embedding-space-4kyh5qqj.js} +6 -6
  79. package/dist/{embeddings-wp745m91.js → embeddings-6a8v4a6t.js} +1 -1
  80. package/dist/{execute-2fzb9z74.js → execute-3cbg0twf.js} +1 -1
  81. package/dist/{external-channel-ys21h3sy.js → external-channel-se646snz.js} +2 -2
  82. package/dist/{fx-adapter-vz0b9z3g.js → fx-adapter-yw795hqq.js} +6 -6
  83. package/dist/{google-generative-ai-ytpgncx9.js → google-generative-ai-h7s3e9kk.js} +1 -1
  84. package/dist/{google-vertex-tqhze5j7.js → google-vertex-fhxaafzw.js} +1 -1
  85. package/dist/{grok-adapter-spea7zkj.js → grok-adapter-ttmcss2j.js} +6 -6
  86. package/dist/handlers-17wha3ze.js +33 -0
  87. package/dist/{heartbeat-8phn1kdq.js → heartbeat-gwewgdms.js} +21 -20
  88. package/dist/{hook-amcj4s10.js → hook-g3nhexsy.js} +5 -5
  89. package/dist/{hook-bc6n49qn.js → hook-hq93y5ej.js} +4 -4
  90. package/dist/{http-7374brv5.js → http-5a9p4h6y.js} +210 -69
  91. package/dist/{index-pxn30mse.js → index-0eny15vj.js} +8 -8
  92. package/dist/{index-5a9jtqde.js → index-0rvk3vd4.js} +46 -46
  93. package/dist/{index-fvzke5kx.js → index-1qw6f2dc.js} +10 -10
  94. package/dist/{index-p4hjwbvw.js → index-3c5pxbge.js} +1 -1
  95. package/dist/{index-q5cmtbz5.js → index-6haqt3v5.js} +12296 -11042
  96. package/dist/index-8arwq8mw.js +34 -0
  97. package/dist/{index-h7f61sy9.js → index-e5pfbsys.js} +3 -3
  98. package/dist/{index-c9y31ytf.js → index-hgn3c961.js} +12 -11
  99. package/dist/{index-hsad2t3r.js → index-m5gx1xd6.js} +38 -38
  100. package/dist/{index-5fx3b3kw.js → index-rvccek1w.js} +9 -9
  101. package/dist/{index-w4m9z29z.js → index-s72rqgsx.js} +1 -1
  102. package/dist/index-tpw054az.js +38 -0
  103. package/dist/{index-514d9pf6.js → index-w7em4ktq.js} +8 -8
  104. package/dist/index-waq75j2j.js +31 -0
  105. package/dist/{keepalive-wy29kbrg.js → keepalive-1j4n4dmk.js} +3 -3
  106. package/dist/lead-re73kdgc.js +72 -0
  107. package/dist/{maintenance-h2ds9w6c.js → maintenance-dmghacy5.js} +1 -1
  108. package/dist/{oauth-refresh-sweep-q7mtbyp3.js → oauth-refresh-sweep-yy06c03c.js} +2 -2
  109. package/dist/{onboard-vw8r2fdw.js → onboard-52f9t5dm.js} +3 -3
  110. package/dist/{opencode-adapter-mtb0953j.js → opencode-adapter-krnh9jkn.js} +4 -4
  111. package/dist/{otel-impl-j42czw3r.js → otel-impl-xjqz6wjj.js} +1 -1
  112. package/dist/{pi-mono-adapter-zk8pg9jr.js → pi-mono-adapter-dbxyp0qv.js} +6 -6
  113. package/dist/{pricing-refresh-x7nhv23d.js → pricing-refresh-ctdr74pd.js} +3 -3
  114. package/dist/{rbac-roles-bzvee6cf.js → rbac-roles-ehv8s10n.js} +3 -3
  115. package/dist/{rbac-roles-9044425x.js → rbac-roles-q0gr8eyj.js} +2 -2
  116. package/dist/{render-v2-t7bn4skz.js → render-v2-5b6chvcq.js} +9 -4
  117. package/dist/{resume-x94gemep.js → resume-5a5d2845.js} +6 -6
  118. package/dist/{runtime-breq6fmv.js → runtime-khxszyfp.js} +1 -1
  119. package/dist/{session-access-q7dmqjvt.js → session-access-gj0bjhqg.js} +4 -4
  120. package/dist/{session-source-backfill-440ysamr.js → session-source-backfill-2sy0krfk.js} +2 -2
  121. package/dist/{setup-07n4727s.js → setup-7ssfakk1.js} +1 -1
  122. package/dist/{virtual-modules-z5h6mcyf.js → virtual-modules-pjj0knwf.js} +3 -3
  123. package/dist/{work-objects-pnq5y534.js → work-objects-bf3syvhq.js} +22 -21
  124. package/dist/{worker-follow-up-7z1gfkr8.js → worker-follow-up-38xevga6.js} +18 -17
  125. package/dist/worker-r8mz7a65.js +72 -0
  126. package/openapi.json +1 -1
  127. package/package.json +3 -3
  128. package/src/apps/catalog.generated.json +55 -0
  129. package/src/apps/page-validator.ts +19 -0
  130. package/src/assets/key.ts +77 -4
  131. package/src/be/db/session-labels.ts +57 -0
  132. package/src/be/db/session-tree.ts +51 -7
  133. package/src/be/db/slack-trees.ts +146 -0
  134. package/src/be/db/tasks/read.ts +102 -7
  135. package/src/be/db-client.ts +8 -2
  136. package/src/be/db.ts +95 -84
  137. package/src/be/event-loop-lag.ts +146 -0
  138. package/src/be/mcp-overflow-sweep.ts +2 -1
  139. package/src/be/memory/providers/sqlite-store.ts +39 -8
  140. package/src/be/migrations/278_slack_render_v2_reconcile.sql +108 -0
  141. package/src/be/swarm-config-guard.ts +2 -0
  142. package/src/commands/context-preamble.ts +258 -0
  143. package/src/commands/onboard/agent-fs-version.ts +1 -1
  144. package/src/extensions/catalog.generated.json +3 -3
  145. package/src/heartbeat/heartbeat.ts +5 -4
  146. package/src/http/core.ts +9 -3
  147. package/src/http/index.ts +10 -6
  148. package/src/http/memory.ts +9 -4
  149. package/src/http/sessions.ts +16 -3
  150. package/src/http/utils.ts +18 -0
  151. package/src/http/webhooks.ts +48 -0
  152. package/src/integrations/chat-sdk/commands.ts +167 -31
  153. package/src/integrations/chat-sdk/inbound.ts +10 -8
  154. package/src/integrations/chat-sdk/message-text.ts +117 -0
  155. package/src/providers/amp-adapter.ts +1 -1
  156. package/src/providers/cursor-adapter.ts +1 -1
  157. package/src/providers/dsh-adapter.ts +1 -1
  158. package/src/scheduler/scheduler.ts +4 -1
  159. package/src/scripts-runtime/executors/quickjs-runner.ts +2 -0
  160. package/src/scripts-runtime/executors/quickjs-structured-clone.ts +180 -0
  161. package/src/scripts-runtime/quickjs-compat.ts +0 -1
  162. package/src/slack/app.ts +332 -10
  163. package/src/slack/handlers.ts +9 -2
  164. package/src/slack/index.ts +7 -1
  165. package/src/slack/lifecycle-lock.ts +29 -0
  166. package/src/slack/render-v2.ts +424 -212
  167. package/src/slack/socket-fence.ts +64 -0
  168. package/src/slack/watcher.ts +42 -8
  169. package/src/tests/apps-schema-form.test.ts +151 -0
  170. package/src/tests/chat-sdk-commands.test.ts +359 -2
  171. package/src/tests/chat-sdk-inbound.test.ts +20 -0
  172. package/src/tests/chat-sdk-slack.test.ts +189 -1
  173. package/src/tests/db-client-busy-retry.test.ts +69 -18
  174. package/src/tests/db-client.test.ts +26 -1
  175. package/src/tests/db-task-read-contract.test.ts +2 -0
  176. package/src/tests/db-task-write-contract.test.ts +1 -0
  177. package/src/tests/dsh-adapter.test.ts +1 -1
  178. package/src/tests/event-loop-lag.test.ts +184 -0
  179. package/src/tests/extensions-example-comms-adherence-gate.test.ts +115 -0
  180. package/src/tests/github-webhook-early-ack.test.ts +144 -0
  181. package/src/tests/http-api-integration.test.ts +2 -0
  182. package/src/tests/http-log-scrubbing.test.ts +68 -2
  183. package/src/tests/kv-storage.test.ts +92 -1
  184. package/src/tests/memory-key-paths.test.ts +57 -0
  185. package/src/tests/memory-retrieval-purge.test.ts +19 -0
  186. package/src/tests/quickjs-compat.test.ts +1 -1
  187. package/src/tests/runner-context-preamble.test.ts +552 -0
  188. package/src/tests/script-connections.test.ts +3 -0
  189. package/src/tests/script-executor-conformance.test.ts +188 -0
  190. package/src/tests/sessions-tree.test.ts +133 -2
  191. package/src/tests/slack-app-icon.test.ts +4 -0
  192. package/src/tests/slack-dm-implicit-mention.test.ts +236 -0
  193. package/src/tests/slack-file-tools-attachments.test.ts +1 -0
  194. package/src/tests/slack-read-boundaries.test.ts +4 -3
  195. package/src/tests/slack-render-v2-query-plans.test.ts +262 -3
  196. package/src/tests/slack-render-v2-reconcile.test.ts +201 -0
  197. package/src/tests/slack-socket-watchdog.test.ts +748 -0
  198. package/src/tests/vcs-identity-inheritance.test.ts +85 -0
  199. package/src/tools/utils.ts +16 -7
  200. package/templates/extensions/comms-adherence-gate/README.md +25 -0
  201. package/templates/extensions/comms-adherence-gate/hooks.ts +100 -11
  202. package/templates/extensions/comms-adherence-gate/manifest.json +1 -1
  203. package/templates/skills/apps/SKILL.md +7 -0
  204. package/templates/skills/apps/content.md +7 -0
  205. package/dist/app-a66ssc4k.js +0 -17
  206. package/dist/handlers-crckt5dq.js +0 -32
  207. package/dist/index-4x08sjtk.js +0 -30
  208. package/dist/index-8ybffts4.js +0 -37
  209. package/dist/index-nfy4kkg5.js +0 -33
  210. package/dist/lead-zdqxsvjn.js +0 -71
  211. package/dist/worker-y62rvvq3.js +0 -71
  212. package/dist/{cli-gxy8y1dt.js → cli-8bpgbr8k.js} +3 -3
@@ -0,0 +1,64 @@
1
+ import type { SocketModeClient } from "@slack/socket-mode";
2
+
3
+ /** Thrown inside a retired client when it tries to open a socket. Never escapes the client. */
4
+ export class SlackSocketClientRetiredError extends Error {
5
+ constructor() {
6
+ super("Slack socket-mode client was retired; it opens no new socket");
7
+ this.name = "SlackSocketClientRetiredError";
8
+ }
9
+ }
10
+
11
+ export interface SlackSocketFence {
12
+ /** After this call, the client opens no new socket. Call it before the client is torn down. */
13
+ retire: () => void;
14
+ isRetired: () => boolean;
15
+ }
16
+
17
+ /**
18
+ * Fence a socket-mode client so a reconnect still in flight at teardown can
19
+ * never open a socket next to the replacement.
20
+ *
21
+ * `start()` awaits `apps.connections.open` (with up to 100 web-client retries)
22
+ * before it builds the websocket, and it resets `shuttingDown` when it begins.
23
+ * So `disconnect()` cannot stop a start that is already waiting for its URL.
24
+ * The fence checks the retired flag before and after each URL request (also
25
+ * when the request fails), and `start()` then fails before it builds a
26
+ * websocket. A start that fails that
27
+ * way resolves quietly: the library calls it from a reconnect with no catch.
28
+ */
29
+ export function fenceSocketModeClient(client: SocketModeClient): SlackSocketFence {
30
+ let retired = false;
31
+ // retrieveWSSURL is private in the library's types, so reach it by name.
32
+ const retrieveWSSURL: unknown = Reflect.get(client, "retrieveWSSURL");
33
+ if (typeof retrieveWSSURL !== "function") {
34
+ throw new Error("@slack/socket-mode changed: SocketModeClient.retrieveWSSURL is missing");
35
+ }
36
+ const start = client.start;
37
+
38
+ Reflect.set(client, "retrieveWSSURL", async function (this: SocketModeClient) {
39
+ if (retired) throw new SlackSocketClientRetiredError();
40
+ let url: unknown;
41
+ try {
42
+ url = await retrieveWSSURL.call(this);
43
+ } catch (error) {
44
+ // A retired client's failure is no longer news, and its reconnect caller has no catch.
45
+ if (retired) throw new SlackSocketClientRetiredError();
46
+ throw error;
47
+ }
48
+ if (retired) throw new SlackSocketClientRetiredError();
49
+ return url;
50
+ });
51
+ Reflect.set(client, "start", function (this: SocketModeClient) {
52
+ return start.call(this).catch((error: unknown) => {
53
+ if (error instanceof SlackSocketClientRetiredError) return undefined;
54
+ throw error;
55
+ });
56
+ });
57
+
58
+ return {
59
+ retire: () => {
60
+ retired = true;
61
+ },
62
+ isRetired: () => retired,
63
+ };
64
+ }
@@ -10,12 +10,18 @@ import {
10
10
  markSlackRelayDelivered,
11
11
  setSlackMessageTracking,
12
12
  } from "../be/db";
13
+ import { bindLoopPath } from "../be/event-loop-lag";
13
14
  import type { AgentTask } from "../types";
14
15
  import { finalizeTerminalSlackReactions } from "./ack";
15
16
  import { getSlackApp } from "./app";
16
17
  import type { TreeNode } from "./blocks";
17
18
  import { buildTreeBlocks, formatDuration } from "./blocks";
18
- import { isSlackRenderV2Enabled, processSlackRenderV2 } from "./render-v2";
19
+ import {
20
+ isSlackRenderV2Enabled,
21
+ processSlackRenderV2,
22
+ startSlackRenderV2Events,
23
+ stopSlackRenderV2Events,
24
+ } from "./render-v2";
19
25
  import {
20
26
  getAgentDisplayName,
21
27
  getAgentSlackIcon,
@@ -32,6 +38,10 @@ import { slackTaskOutput } from "./task-output";
32
38
 
33
39
  let watcherInterval: ReturnType<typeof setInterval> | null = null;
34
40
  let isProcessing = false;
41
+ // Bumped by stopTaskWatcher(). A start that sees a new epoch after its
42
+ // hydration awaits was abandoned (watchdog restart timeout or shutdown) and
43
+ // must not install a timer.
44
+ let watcherEpoch = 0;
35
45
 
36
46
  // Track notified completion tasks (taskId -> timestamp)
37
47
  const notifiedCompletions = new Map<string, number>();
@@ -231,6 +241,9 @@ export function _getLastRenderedTree(): Map<string, string> {
231
241
  export function _getTreeLastUpdateTime(): Map<string, number> {
232
242
  return treeLastUpdateTime;
233
243
  }
244
+ export function _isTaskWatcherRunning(): boolean {
245
+ return watcherInterval !== null;
246
+ }
234
247
 
235
248
  // Expose DM helpers for testing
236
249
  export const _isDMChannel = isDMChannel;
@@ -616,22 +629,37 @@ export async function processPendingSlackRelays(now = Date.now()): Promise<void>
616
629
  }
617
630
  }
618
631
 
632
+ export const DEFAULT_SLACK_TASK_WATCHER_INTERVAL_MS = 10_000;
633
+
634
+ /**
635
+ * Watcher tick from SLACK_TASK_WATCHER_INTERVAL_MS (milliseconds), else 10 s.
636
+ * Under render v2 each tick is the full reconcile; task events render their
637
+ * own thread in between, so the tick is the safety net, not the cadence.
638
+ */
639
+ export function slackTaskWatcherIntervalMs(): number {
640
+ const raw = process.env.SLACK_TASK_WATCHER_INTERVAL_MS?.trim();
641
+ const parsed = raw ? Number(raw) : Number.NaN;
642
+ return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_SLACK_TASK_WATCHER_INTERVAL_MS;
643
+ }
644
+
619
645
  /**
620
646
  * Start watching for Slack task updates and sending responses.
621
647
  */
622
- export async function startTaskWatcher(intervalMs = 3000): Promise<void> {
648
+ export async function startTaskWatcher(intervalMs = slackTaskWatcherIntervalMs()): Promise<void> {
623
649
  if (watcherInterval) {
624
650
  console.log("[Slack] Task watcher already running");
625
651
  return;
626
652
  }
627
653
 
654
+ const epoch = watcherEpoch;
628
655
  let hydratedTrees = 0;
629
656
  let hydratedFlat = 0;
630
657
  const hydrationTasks = new Map<string, AgentTask>();
631
- for (const task of [
632
- ...(await getInProgressSlackTasks()),
633
- ...(await getPendingSlackRelayTasks()),
634
- ]) {
658
+ const inProgress = await getInProgressSlackTasks();
659
+ const pendingRelays = await getPendingSlackRelayTasks();
660
+ // Abandoned while it hydrated (stopped, or overtaken by another start).
661
+ if (epoch !== watcherEpoch || watcherInterval) return;
662
+ for (const task of [...inProgress, ...pendingRelays]) {
635
663
  hydrationTasks.set(task.id, task);
636
664
  }
637
665
  for (const task of hydrationTasks.values()) {
@@ -676,7 +704,8 @@ export async function startTaskWatcher(intervalMs = 3000): Promise<void> {
676
704
  );
677
705
  }
678
706
 
679
- watcherInterval = setInterval(async () => {
707
+ startSlackRenderV2Events();
708
+ const watcherTick = async () => {
680
709
  // Prevent overlapping processing cycles
681
710
  if (isProcessing || !getSlackApp()) return;
682
711
  isProcessing = true;
@@ -848,16 +877,21 @@ export async function startTaskWatcher(intervalMs = 3000): Promise<void> {
848
877
  } finally {
849
878
  isProcessing = false;
850
879
  }
851
- }, intervalMs);
880
+ };
881
+ // Name the entry point for the event-loop stall line.
882
+ watcherInterval = setInterval(bindLoopPath("slack.watcher.tick", watcherTick), intervalMs);
852
883
 
853
884
  console.log(`[Slack] Task watcher started (interval: ${intervalMs}ms)`);
854
885
  }
855
886
 
856
887
  export function stopTaskWatcher(): void {
888
+ // Fence any start still hydrating, even when no timer is installed yet.
889
+ watcherEpoch += 1;
857
890
  if (watcherInterval) {
858
891
  clearInterval(watcherInterval);
859
892
  watcherInterval = null;
860
893
  isProcessing = false;
894
+ stopSlackRenderV2Events();
861
895
  console.log("[Slack] Task watcher stopped");
862
896
  }
863
897
  }
@@ -0,0 +1,151 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { parseAppDefinition } from "../apps/definition";
3
+
4
+ /**
5
+ * Validator coverage for the `SchemaForm` component: its `onChange` action
6
+ * chain and the `$state` `rowId` binding a nested-document editor persists
7
+ * with. Pure `parseAppDefinition` calls — no DB, no HTTP — mirroring
8
+ * `apps-tree.test.ts`.
9
+ */
10
+
11
+ async function expectParseIssue(definition: unknown, message: string): Promise<void> {
12
+ const parsed = await parseAppDefinition(definition);
13
+ expect(parsed.success).toBe(false);
14
+ if (parsed.success) return;
15
+ expect(parsed.issues.some((entry) => entry.message.includes(message))).toBe(true);
16
+ }
17
+
18
+ /**
19
+ * A definition with a `screen` model and a `SchemaForm` whose `onChange` chain
20
+ * runs an `app.mutate` against the named model.
21
+ */
22
+ function schemaFormDefinition(model = "screen", id = "props") {
23
+ return {
24
+ models: {
25
+ screen: { columns: { doc: { kind: "json" } } },
26
+ },
27
+ queries: {},
28
+ pages: {
29
+ main: {
30
+ root: "root",
31
+ elements: {
32
+ root: { type: "Stack", props: {}, children: ["props"] },
33
+ props: {
34
+ type: "SchemaForm",
35
+ props: {
36
+ id,
37
+ schema: { type: "object", properties: { title: { type: "string" } } },
38
+ onChange: [
39
+ {
40
+ action: "app.mutate",
41
+ params: { model, op: "update", rowId: "r1", values: { doc: { $form: "" } } },
42
+ },
43
+ ],
44
+ },
45
+ },
46
+ },
47
+ },
48
+ },
49
+ defaultPage: "main",
50
+ };
51
+ }
52
+
53
+ describe("SchemaForm validation", () => {
54
+ test("accepts a SchemaForm onChange app.mutate chain against a declared model", async () => {
55
+ const parsed = await parseAppDefinition(schemaFormDefinition());
56
+ expect(parsed.success).toBe(true);
57
+ });
58
+
59
+ test("rejects a SchemaForm onChange app.mutate chain against an undeclared model", async () => {
60
+ await expectParseIssue(schemaFormDefinition("ghost"), 'unknown model "ghost"');
61
+ });
62
+ });
63
+
64
+ describe("SchemaForm id", () => {
65
+ test.each([
66
+ "a/b",
67
+ "a b",
68
+ "..",
69
+ "",
70
+ "__proto__",
71
+ "constructor",
72
+ "prototype",
73
+ "a.b",
74
+ ])("rejects the id %p", async (id) => {
75
+ await expectParseIssue(schemaFormDefinition("screen", id), "SchemaForm id must match");
76
+ });
77
+
78
+ test("accepts letters, digits, underscore and hyphen", async () => {
79
+ const parsed = await parseAppDefinition(schemaFormDefinition("screen", "Props_1-a"));
80
+ expect(parsed.success).toBe(true);
81
+ });
82
+ });
83
+
84
+ /**
85
+ * A document-editing page: a Tree selects an element of a row's `doc`, and a
86
+ * SchemaForm merges edits into it (`baseDoc` + `nodeKey`) and persists the
87
+ * whole doc with an `app.mutate` keyed by the route param.
88
+ */
89
+ function documentEditorDefinition(rowId: unknown) {
90
+ return {
91
+ models: { screen: { columns: { doc: { kind: "json" }, name: { kind: "string" } } } },
92
+ queries: { screenById: { model: "screen", filter: { id: { $param: "screenId" } }, limit: 1 } },
93
+ pages: {
94
+ editor: {
95
+ params: { screenId: { kind: "string", required: true } },
96
+ root: "root",
97
+ elements: {
98
+ root: { type: "Stack", props: {}, children: ["tree", "props"] },
99
+ tree: {
100
+ type: "Tree",
101
+ props: { id: "tree", nodes: { $state: "/queries/screenById/data/0/doc" } },
102
+ },
103
+ props: {
104
+ type: "SchemaForm",
105
+ props: {
106
+ id: "props",
107
+ schema: { $state: "/ui/props/schema" },
108
+ baseDoc: { $state: "/queries/screenById/data/0/doc" },
109
+ nodeKey: { $state: "/ui/tree/value" },
110
+ onChange: [
111
+ {
112
+ action: "app.mutate",
113
+ params: {
114
+ model: "screen",
115
+ op: "update",
116
+ rowId,
117
+ values: { doc: { $state: "/ui/props/value" } },
118
+ },
119
+ },
120
+ ],
121
+ },
122
+ },
123
+ },
124
+ },
125
+ },
126
+ defaultPage: "editor",
127
+ };
128
+ }
129
+
130
+ describe("app.mutate rowId binding", () => {
131
+ test("accepts a $state rowId bound to a route param (editor persists by screenId)", async () => {
132
+ const parsed = await parseAppDefinition(
133
+ documentEditorDefinition({ $state: "/route/params/screenId" }),
134
+ );
135
+ expect(parsed.success).toBe(true);
136
+ });
137
+
138
+ test("a $state rowId still validates its target — an unknown route param fails", async () => {
139
+ await expectParseIssue(
140
+ documentEditorDefinition({ $state: "/route/params/ghost" }),
141
+ 'unknown route param "ghost"',
142
+ );
143
+ });
144
+
145
+ test("rejects a rowId that is neither a string, $row, nor $state binding", async () => {
146
+ await expectParseIssue(
147
+ documentEditorDefinition({ nope: true }),
148
+ "must be a string, $row, or $state binding",
149
+ );
150
+ });
151
+ });