@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.
- package/dist/approvals/approval-store.d.ts +35 -0
- package/dist/approvals/approval-store.d.ts.map +1 -0
- package/dist/approvals/approval-store.js +87 -0
- package/dist/approvals/approval-store.js.map +1 -0
- package/dist/approvals/manifest.d.ts +47 -0
- package/dist/approvals/manifest.d.ts.map +1 -0
- package/dist/approvals/manifest.js +90 -0
- package/dist/approvals/manifest.js.map +1 -0
- package/dist/approvals/telemetry.d.ts +41 -0
- package/dist/approvals/telemetry.d.ts.map +1 -0
- package/dist/approvals/telemetry.js +35 -0
- package/dist/approvals/telemetry.js.map +1 -0
- package/dist/approvals/tool-approval-gate.d.ts +96 -0
- package/dist/approvals/tool-approval-gate.d.ts.map +1 -0
- package/dist/approvals/tool-approval-gate.js +233 -0
- package/dist/approvals/tool-approval-gate.js.map +1 -0
- package/dist/approvals/tool-approvals-manifest.json +27 -0
- package/dist/index.d.ts +15 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +54 -19
- package/dist/index.js.map +1 -1
- package/dist/runtime/auto-update/coordinator.d.ts +37 -12
- package/dist/runtime/auto-update/coordinator.d.ts.map +1 -1
- package/dist/runtime/auto-update/coordinator.js +136 -17
- package/dist/runtime/auto-update/coordinator.js.map +1 -1
- package/dist/runtime/auto-update/gateway-restart.d.ts +4 -4
- package/dist/runtime/auto-update/gateway-restart.js +4 -4
- package/dist/runtime/auto-update/types.d.ts +1 -0
- package/dist/runtime/auto-update/types.d.ts.map +1 -1
- package/dist/runtime/auto-update/types.js.map +1 -1
- package/dist/telemetry/metrics.d.ts +11 -0
- package/dist/telemetry/metrics.d.ts.map +1 -1
- package/dist/telemetry/metrics.js +22 -0
- package/dist/telemetry/metrics.js.map +1 -1
- package/dist/utils/event-catalog.d.ts +103 -2
- package/dist/utils/event-catalog.d.ts.map +1 -1
- package/dist/utils/event-catalog.js +28 -0
- package/dist/utils/event-catalog.js.map +1 -1
- package/openclaw.plugin.json +10 -1
- 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;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmCH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;
|
|
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:
|
|
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
|
|
615
|
-
//
|
|
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
|
|
674
|
-
//
|
|
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());
|