@senpi-ai/runtime 3.0.13 → 3.0.30

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 (40) hide show
  1. package/dist/approvals/approval-store.d.ts +35 -0
  2. package/dist/approvals/approval-store.d.ts.map +1 -0
  3. package/dist/approvals/approval-store.js +87 -0
  4. package/dist/approvals/approval-store.js.map +1 -0
  5. package/dist/approvals/manifest.d.ts +47 -0
  6. package/dist/approvals/manifest.d.ts.map +1 -0
  7. package/dist/approvals/manifest.js +90 -0
  8. package/dist/approvals/manifest.js.map +1 -0
  9. package/dist/approvals/telemetry.d.ts +41 -0
  10. package/dist/approvals/telemetry.d.ts.map +1 -0
  11. package/dist/approvals/telemetry.js +35 -0
  12. package/dist/approvals/telemetry.js.map +1 -0
  13. package/dist/approvals/tool-approval-gate.d.ts +96 -0
  14. package/dist/approvals/tool-approval-gate.d.ts.map +1 -0
  15. package/dist/approvals/tool-approval-gate.js +233 -0
  16. package/dist/approvals/tool-approval-gate.js.map +1 -0
  17. package/dist/approvals/tool-approvals-manifest.json +27 -0
  18. package/dist/index.d.ts +15 -0
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +54 -19
  21. package/dist/index.js.map +1 -1
  22. package/dist/runtime/auto-update/coordinator.d.ts +37 -12
  23. package/dist/runtime/auto-update/coordinator.d.ts.map +1 -1
  24. package/dist/runtime/auto-update/coordinator.js +136 -17
  25. package/dist/runtime/auto-update/coordinator.js.map +1 -1
  26. package/dist/runtime/auto-update/gateway-restart.d.ts +4 -4
  27. package/dist/runtime/auto-update/gateway-restart.js +4 -4
  28. package/dist/runtime/auto-update/types.d.ts +1 -0
  29. package/dist/runtime/auto-update/types.d.ts.map +1 -1
  30. package/dist/runtime/auto-update/types.js.map +1 -1
  31. package/dist/telemetry/metrics.d.ts +11 -0
  32. package/dist/telemetry/metrics.d.ts.map +1 -1
  33. package/dist/telemetry/metrics.js +22 -0
  34. package/dist/telemetry/metrics.js.map +1 -1
  35. package/dist/utils/event-catalog.d.ts +103 -2
  36. package/dist/utils/event-catalog.d.ts.map +1 -1
  37. package/dist/utils/event-catalog.js +28 -0
  38. package/dist/utils/event-catalog.js.map +1 -1
  39. package/openclaw.plugin.json +10 -1
  40. package/package.json +3 -2
@@ -0,0 +1,233 @@
1
+ import { ToolApprovalStore } from "./approval-store.js";
2
+ import { loadToolApprovalsManifest, } from "./manifest.js";
3
+ import { defaultGateTelemetry } from "./telemetry.js";
4
+ /** Env var that overrides the `toolApprovals` plugin config and the manifest default. */
5
+ export const TOOL_APPROVALS_ENV_VAR = "SENPI_TOOL_APPROVALS";
6
+ // Gateway schema hard limits (plugin.approval.request rejects, not truncates,
7
+ // beyond these — openclaw PLUGIN_APPROVAL_TITLE_MAX_LENGTH / _DESCRIPTION_).
8
+ const TITLE_MAX_LENGTH = 80;
9
+ const DESCRIPTION_MAX_LENGTH = 256;
10
+ /**
11
+ * Match a tool-registry name against the senpi MCP server and return the bare
12
+ * tool name. Covers the embedded-MCP shape (`senpi__create_position`), the
13
+ * CLI-runner backend shape (`mcp__senpi__create_position`), and openclaw's
14
+ * server-name dedupe suffix (`senpi-2__…`).
15
+ */
16
+ export function matchSenpiTool(toolName) {
17
+ if (typeof toolName !== "string") {
18
+ return null;
19
+ }
20
+ const match = /^(?:mcp__)?senpi(?:-\d+)?__(.+)$/.exec(toolName);
21
+ return match ? match[1] : null;
22
+ }
23
+ export function isToolApprovalsMode(value) {
24
+ return value === "off" || value === "trades" || value === "all";
25
+ }
26
+ /**
27
+ * Resolve the gate mode: env {@link TOOL_APPROVALS_ENV_VAR} > plugin config
28
+ * `toolApprovals` > manifest `defaults.mode`. Unrecognized values warn and
29
+ * fall through to the manifest default rather than silently disabling the gate.
30
+ */
31
+ export function resolveToolApprovalsMode(params) {
32
+ const manifestDefault = (params.manifest ?? loadToolApprovalsManifest()).defaults.mode;
33
+ const candidates = [
34
+ { source: `env ${TOOL_APPROVALS_ENV_VAR}`, value: params.env?.[TOOL_APPROVALS_ENV_VAR] },
35
+ { source: 'plugin config "toolApprovals"', value: params.pluginConfig?.toolApprovals },
36
+ ];
37
+ for (const candidate of candidates) {
38
+ if (candidate.value === undefined || candidate.value === null || candidate.value === "") {
39
+ continue;
40
+ }
41
+ const normalized = typeof candidate.value === "string" ? candidate.value.trim().toLowerCase() : candidate.value;
42
+ if (isToolApprovalsMode(normalized)) {
43
+ return normalized;
44
+ }
45
+ params.logger?.warn(`[senpi-tool-approvals] unrecognized ${candidate.source} value ${JSON.stringify(candidate.value)}; using manifest default "${manifestDefault}" (expected off|trades|all)`);
46
+ return manifestDefault;
47
+ }
48
+ return manifestDefault;
49
+ }
50
+ function truncate(value, maxLength) {
51
+ return value.length <= maxLength ? value : `${value.slice(0, maxLength - 1)}…`;
52
+ }
53
+ function str(value) {
54
+ if (typeof value === "string" && value.trim())
55
+ return value.trim();
56
+ if (typeof value === "number" && Number.isFinite(value))
57
+ return String(value);
58
+ return undefined;
59
+ }
60
+ /**
61
+ * Human sentence for a senpi trade tool call, mirroring senpi-web's own
62
+ * per-tool phrasing (its `getDescription` registry).
63
+ *
64
+ * Why the plugin builds this rather than leaving it to the UI: senpi-web keys
65
+ * that registry by the **bare** tool name and feeds it the call `args`, but for
66
+ * plugin approvals openclaw sends the prefixed registry name
67
+ * (`senpi__create_position`) and has **no `args` field at all` in
68
+ * `PluginApprovalRequestParamsSchema` (additionalProperties: false). So the UI
69
+ * takes its fallback branch and renders `description` verbatim, with no args
70
+ * block — meaning this string is the *only* place the user sees what they are
71
+ * approving. It must therefore carry the numbers, not just the intent.
72
+ */
73
+ export function describeSenpiToolCall(tool, params) {
74
+ const p = (params ?? {});
75
+ const asset = str(p.asset) ?? str(p.coin) ?? str(p.symbol);
76
+ const strategyId = str(p.strategyId) ?? str(p.strategy_id);
77
+ const amount = str(p.amount) ?? str(p.usdAmount) ?? str(p.margin);
78
+ const leverage = str(p.leverage);
79
+ const direction = str(p.direction) ?? str(p.side);
80
+ const parts = [];
81
+ switch (tool) {
82
+ case "create_position": {
83
+ parts.push(`Open a ${direction ?? ""} position on ${asset ?? "?"}`.replace(/\s+/g, " "));
84
+ if (amount)
85
+ parts.push(`margin $${amount}`);
86
+ if (leverage)
87
+ parts.push(`${leverage}x`);
88
+ break;
89
+ }
90
+ case "close_position":
91
+ parts.push(`Close position ${str(p.positionId) ?? asset ?? ""}`.trim());
92
+ break;
93
+ case "edit_position":
94
+ parts.push(`Edit position ${str(p.positionId) ?? asset ?? ""}`.trim());
95
+ break;
96
+ case "cancel_order":
97
+ parts.push(`Cancel order ${str(p.orderId) ?? ""}`.trim());
98
+ break;
99
+ case "strategy_create":
100
+ case "strategy_create_custom_strategy":
101
+ parts.push(`Create strategy ${str(p.name) ?? asset ?? ""}`.trim());
102
+ break;
103
+ case "strategy_close":
104
+ case "strategy_close_positions":
105
+ parts.push(`Close strategy ${strategyId ?? ""}`.trim());
106
+ break;
107
+ case "strategy_update":
108
+ parts.push(`Update strategy ${strategyId ?? ""}`.trim());
109
+ break;
110
+ case "strategy_pause":
111
+ parts.push(`Pause strategy ${strategyId ?? ""}`.trim());
112
+ break;
113
+ case "strategy_top_up":
114
+ parts.push(`Add ${amount ? `$${amount} ` : ""}funds to strategy ${strategyId ?? ""}`.trim());
115
+ break;
116
+ case "strategy_withdraw_funds":
117
+ parts.push(`Withdraw ${amount ? `$${amount} ` : ""}from strategy ${strategyId ?? ""}`.trim());
118
+ break;
119
+ case "strategy_bridge_funds_from_hyperliquid_to_evm":
120
+ parts.push(`Bridge ${amount ? `$${amount} ` : ""}from Hyperliquid to EVM`.trim());
121
+ break;
122
+ case "transfer_spot_to_perps":
123
+ parts.push(`Transfer ${amount ? `$${amount} ` : ""}from spot to perps`.trim());
124
+ break;
125
+ case "send_usdc":
126
+ parts.push(`Send ${amount ? `$${amount} ` : ""}USDC to ${str(p.to) ?? "?"}`.trim());
127
+ break;
128
+ default:
129
+ return undefined;
130
+ }
131
+ return parts.filter(Boolean).join(" · ");
132
+ }
133
+ /**
134
+ * Prompt body: the human sentence when we know the tool, plus the compact raw
135
+ * args so the exact numbers are always visible (senpi-web renders no args block
136
+ * for plugin approvals — see {@link describeSenpiToolCall}). Capped to the
137
+ * gateway's description limit, which rejects (not truncates) anything longer.
138
+ */
139
+ export function buildApprovalDescription(tool, params) {
140
+ let args = "";
141
+ try {
142
+ args = params === undefined ? "" : JSON.stringify(params);
143
+ }
144
+ catch {
145
+ args = "[unserializable params]";
146
+ }
147
+ const hasArgs = Boolean(args) && args !== "{}";
148
+ const sentence = describeSenpiToolCall(tool, params);
149
+ const head = sentence ?? tool;
150
+ const base = hasArgs ? `${head} — ${args}` : head;
151
+ return truncate(base, DESCRIPTION_MAX_LENGTH);
152
+ }
153
+ /**
154
+ * Register the `before_tool_call` approval gate. No-op in `off` mode.
155
+ * Returns the store (for tests/introspection) when registered.
156
+ */
157
+ export function registerToolApprovalGate(options) {
158
+ const { api, mode, stateDir, logger } = options;
159
+ if (mode === "off") {
160
+ logger?.info("[senpi-tool-approvals] disabled (mode=off)");
161
+ return undefined;
162
+ }
163
+ const manifest = options.manifest ?? loadToolApprovalsManifest();
164
+ const telemetry = options.telemetry ?? defaultGateTelemetry;
165
+ const tradeTools = new Set(manifest.tradeTools);
166
+ const timeoutMs = manifest.defaults.timeoutMs;
167
+ const store = new ToolApprovalStore(stateDir, logger);
168
+ logger?.info(`[senpi-tool-approvals] enabled | mode=${mode} tradeTools=${tradeTools.size} allowAlways=${store.size} timeoutMs=${timeoutMs}`);
169
+ api.on("before_tool_call", (event) => {
170
+ // The registry name openclaw uses on the wire (e.g. `senpi__create_position`).
171
+ // Telemetry keys on it for consistency with the span/tool.called stream,
172
+ // which use the prefixed name too. Set inside the try so a hostile event
173
+ // shape can't escape the fail-open catch.
174
+ let wireName;
175
+ try {
176
+ const ev = event;
177
+ wireName = typeof ev?.toolName === "string" ? ev.toolName : undefined;
178
+ const tool = matchSenpiTool(ev?.toolName);
179
+ if (!tool) {
180
+ return undefined;
181
+ }
182
+ const isTrade = tradeTools.has(tool);
183
+ if (mode === "trades" && !isTrade) {
184
+ return undefined;
185
+ }
186
+ if (store.isAllowedAlways(tool)) {
187
+ return undefined;
188
+ }
189
+ return {
190
+ requireApproval: {
191
+ title: truncate(`Senpi trade approval: ${tool}`, TITLE_MAX_LENGTH),
192
+ description: buildApprovalDescription(tool, ev?.params),
193
+ severity: isTrade ? "critical" : "warning",
194
+ timeoutMs,
195
+ timeoutBehavior: "deny",
196
+ onResolution: (decision) => {
197
+ const name = wireName ?? `senpi__${tool}`;
198
+ if (decision === "allow-always") {
199
+ store.rememberAllowAlways(tool);
200
+ logger?.info(`[senpi-tool-approvals] allow-always persisted | tool=${tool}`);
201
+ }
202
+ else if (decision === "deny") {
203
+ telemetry.denied(name, "user_denied");
204
+ }
205
+ else if (decision === "timeout") {
206
+ // The user missed the prompt: a state-changing tool the gateway
207
+ // fails closed. A real product signal, and otherwise invisible.
208
+ telemetry.denied(name, "approval_timeout");
209
+ }
210
+ // Audit every terminal decision — the only record of the approve
211
+ // path (allow-once vs allow-always). `cancelled` (run aborted) is
212
+ // not a user decision, so it's excluded.
213
+ if (decision === "allow-once" ||
214
+ decision === "allow-always" ||
215
+ decision === "deny" ||
216
+ decision === "timeout") {
217
+ telemetry.resolved(name, decision, isTrade);
218
+ }
219
+ },
220
+ },
221
+ };
222
+ }
223
+ catch (err) {
224
+ // Never break the tool pipeline on a gate bug — fail OPEN, but make it
225
+ // loud: this is the one place a money-safety gate stops protecting.
226
+ logger?.warn(`[senpi-tool-approvals] gate handler failed; tool proceeds ungated | err=${err instanceof Error ? err.message : String(err)}`);
227
+ telemetry.gateError(err, wireName);
228
+ return undefined;
229
+ }
230
+ });
231
+ return store;
232
+ }
233
+ //# sourceMappingURL=tool-approval-gate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-approval-gate.js","sourceRoot":"","sources":["../../src/approvals/tool-approval-gate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "defaults": {
4
+ "mode": "trades",
5
+ "timeoutMs": 600000
6
+ },
7
+ "tradeTools": [
8
+ "create_position",
9
+ "close_position",
10
+ "edit_position",
11
+ "cancel_order",
12
+ "strategy_create",
13
+ "strategy_create_custom_strategy",
14
+ "strategy_close",
15
+ "strategy_close_positions",
16
+ "strategy_update",
17
+ "strategy_pause",
18
+ "strategy_top_up",
19
+ "strategy_withdraw_funds",
20
+ "strategy_bridge_funds_from_hyperliquid_to_evm",
21
+ "transfer_spot_to_perps",
22
+ "send_usdc",
23
+ "ratchet_stop_add",
24
+ "ratchet_stop_edit",
25
+ "ratchet_stop_delete"
26
+ ]
27
+ }
package/dist/index.d.ts CHANGED
@@ -12,6 +12,7 @@
12
12
  * the loader's relative-import path entirely.
13
13
  */
14
14
  import type { SenpiEventBus } from "./dsl/events/index.js";
15
+ import { type ToolApprovalsMode } from "./approvals/tool-approval-gate.js";
15
16
  /** Initialize all core features (DSL, risk, health) on the given event bus. */
16
17
  export declare function initCore(bus: SenpiEventBus): void;
17
18
  export { initDsl, DslPlugin, dslLogger, setDslLogLevel, parseDslPluginConfig, DslConfigValidationError, dslValidationIssue, EVENTS as DslEvents, DSL_EVENTS, } from "./dsl/index.js";
@@ -46,6 +47,15 @@ export interface SenpiRuntimePluginConfig {
46
47
  stateDir?: string;
47
48
  apiKey?: string;
48
49
  logLevel?: string;
50
+ /**
51
+ * MCP tool approval gate mode override (see src/approvals/tool-approval-gate.ts):
52
+ * "trades" requires interactive approval for state-changing senpi MCP tools,
53
+ * "all" gates every senpi MCP tool, "off" disables the gate. The gated tool
54
+ * set and the default mode ship in the checked-in
55
+ * src/approvals/tool-approvals-manifest.json. Precedence:
56
+ * env SENPI_TOOL_APPROVALS > this setting > manifest default.
57
+ */
58
+ toolApprovals?: ToolApprovalsMode;
49
59
  autoUpdate?: Record<string, unknown>;
50
60
  skillsManager?: {
51
61
  enabled?: boolean;
@@ -135,6 +145,11 @@ interface PluginApi {
135
145
  }) => void | Promise<void>, opts?: {
136
146
  scope?: OperatorScope;
137
147
  }): void;
148
+ registerReload?: (registration: {
149
+ restartPrefixes?: string[];
150
+ hotPrefixes?: string[];
151
+ noopPrefixes?: string[];
152
+ }) => void;
138
153
  on(hookName: string, handler: (...args: unknown[]) => void | Promise<void>, opts?: {
139
154
  priority?: number;
140
155
  }): void;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -39,6 +39,7 @@ import { initOtelSdk, shutdownOtelSdk } from "./telemetry/otel-sdk.js";
39
39
  import { getLogLevel, getLogLevelSource, parseLogLevel, setErrorNotifier, setLogLevel, } from "./utils/logger.js";
40
40
  import { ExternalScannerIngestError, } from "./scanners/external-scanner-receiver.js";
41
41
  import { createLogger } from "./utils/logger.js";
42
+ import { registerToolApprovalGate, resolveToolApprovalsMode, } from "./approvals/tool-approval-gate.js";
42
43
  import { EVENT_NAME, eventAttrs } from "./utils/event-catalog.js";
43
44
  import { emitEvent } from "./actions/event-derivation.js";
44
45
  import { buildRuntimeCreatedEvent, buildRuntimeDeletedEvent } from "./runtime/lifecycle-events.js";
@@ -293,6 +294,28 @@ const senpiRuntimePlugin = {
293
294
  err: err instanceof Error ? err.message : String(err),
294
295
  });
295
296
  }
297
+ // MCP tool approval gate — state-changing senpi MCP tools require an
298
+ // interactive user approval before executing. Prompts reach senpi-web via
299
+ // the bridge's operator.approvals-scoped gateway connection; allow-always
300
+ // decisions persist in <stateDir>/tool-approvals.json.
301
+ // See docs/mcp-tool-approvals-design.md.
302
+ try {
303
+ registerToolApprovalGate({
304
+ api,
305
+ mode: resolveToolApprovalsMode({
306
+ pluginConfig: config,
307
+ env: process.env,
308
+ logger: pluginLogger,
309
+ }),
310
+ stateDir: baseStateDir,
311
+ logger: pluginLogger,
312
+ });
313
+ }
314
+ catch (err) {
315
+ pluginLogger.warn("[senpi-runtime] failed to register tool approval gate", {
316
+ err: err instanceof Error ? err.message : String(err),
317
+ });
318
+ }
296
319
  const runtimeHandles = new Map();
297
320
  let apiHandle;
298
321
  // Supervised scanner state — module-scoped so stop() can reach them.
@@ -379,6 +402,19 @@ const senpiRuntimePlugin = {
379
402
  stateDir: join(baseStateDir, "skills-manager"),
380
403
  logger: pluginLogger,
381
404
  });
405
+ // AutoUpdateCoordinator's LoggerLike requires `event()` (first-class `auto_update.*`
406
+ // telemetry) alongside info/warn/error. `pluginLogger` mirrors the gateway's own
407
+ // info/warn/error sink but has no `event()` (PluginLogger/api.logger predates the event
408
+ // catalog) — so info/warn/error keep routing through pluginLogger unchanged, and `event()`
409
+ // is delegated to a dedicated OTel-backed logger, matching the `apiLogger.event(...)`
410
+ // pattern already used for `runtime.scanners_unwired` above.
411
+ const autoUpdateEventLogger = createLogger("[senpi-core][auto-update]");
412
+ const autoUpdateLogger = {
413
+ info: (...args) => pluginLogger.info(...args),
414
+ warn: (...args) => pluginLogger.warn(...args),
415
+ error: (message, meta) => pluginLogger.error(message, meta),
416
+ event: autoUpdateEventLogger.event,
417
+ };
382
418
  const autoUpdateConfig = resolveAutoUpdateConfig(config?.autoUpdate);
383
419
  const autoUpdateCoordinator = new AutoUpdateCoordinator({
384
420
  enabled: true,
@@ -386,22 +422,10 @@ const senpiRuntimePlugin = {
386
422
  packageName: PLUGIN_PACKAGE_NAME,
387
423
  currentVersion: VERSION,
388
424
  stateDir: join(baseStateDir, "auto-update"),
389
- logger: pluginLogger,
425
+ logger: autoUpdateLogger,
390
426
  notify: lifecycleNotifications
391
427
  ? (msg) => lifecycleNotifications.notify(msg)
392
428
  : async () => { },
393
- stopRuntimesForUpdate: async () => {
394
- // Stop supervised scanner children BEFORE stopping runtime handles so
395
- // scaffold processes do not POST to a handle that is already torn down.
396
- // Mirrors the service stop() teardown order.
397
- if (launchers.size > 0) {
398
- await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
399
- launchers.clear();
400
- }
401
- for (const [, handle] of runtimeHandles) {
402
- await handle.stop();
403
- }
404
- },
405
429
  // Use the resolved npm package name (not a hardcoded plugin id) so
406
430
  // the update follows the same npm channel as the version check —
407
431
  // see runtime/auto-update/run-update-command.ts.
@@ -432,6 +456,19 @@ const senpiRuntimePlugin = {
432
456
  await skillsCoordinator.runTickOnce();
433
457
  },
434
458
  });
459
+ // Tell the gateway's config-reload planner that a write to this leaf
460
+ // requires a full restart, not just a plugin hot-reload. Without this,
461
+ // the write in gateway-restart.ts falls through to the generic
462
+ // `plugins` hot-reload rule and the auto-update coordinator's restart
463
+ // request is silently downgraded to a no-op hot reload.
464
+ // Scoped to the exact leaf (not the whole plugins.entries.<id> subtree)
465
+ // so unrelated config edits (e.g. logLevel) keep hot-reloading instead
466
+ // of forcing a gateway restart.
467
+ if (typeof api.registerReload === "function") {
468
+ api.registerReload({
469
+ restartPrefixes: [`plugins.entries.${api.id}.config.autoUpdate.lastRestartTrigger`],
470
+ });
471
+ }
435
472
  api.registerService({
436
473
  id: "senpi-runtime",
437
474
  async start() {
@@ -611,9 +648,8 @@ const senpiRuntimePlugin = {
611
648
  catch (err) {
612
649
  pluginLogger.error("[senpi-runtime] HTTP API failed to start; rolling back lifecycle", { err });
613
650
  // Mirror the lifecycle-stop teardown order: stop the coordinator
614
- // first so it cannot schedule a tick or call stopRuntimesForUpdate
615
- // mid-rollback, then stop every runtime handle that was hydrated
616
- // above.
651
+ // first so it cannot schedule a tick mid-rollback, then stop every
652
+ // runtime handle that was hydrated above.
617
653
  await autoUpdateCoordinator.stop().catch(() => { });
618
654
  // Stop any launchers so spawned scaffolds are not leaked.
619
655
  await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
@@ -670,9 +706,8 @@ const senpiRuntimePlugin = {
670
706
  await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
671
707
  launchers.clear();
672
708
  }
673
- // Stop the coordinator next so it cannot schedule a new tick or call
674
- // stopRuntimesForUpdate() (auto-restart path after an update) while
675
- // we are tearing down the handles below.
709
+ // Stop the coordinator next so it cannot schedule a new tick while we
710
+ // are tearing down the handles below.
676
711
  await autoUpdateCoordinator.stop();
677
712
  await skillsCoordinator.stop();
678
713
  const ids = Array.from(runtimeHandles.keys());