vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-21 04:44:47 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(wake): expose typed sessionKey on wake protocol + system event CLI

Browse Source 
Adds an optional sessionKey to the WakeParamsSchema and threads it through
the gateway wake handler, CronService.wake(), and the underlying timer.wake()
ops so callers can target a specific session for async-task completion
relays instead of always hitting the agent's main session.

Also adds --session-key to `openclaw system event`.

The schema rejects empty/non-string sessionKey at the gateway boundary;
mismatched session keys (a key that does not belong to the resolving agent)
fall back to the agent's main session inside resolveCronSessionKey, which
is the existing safety path.

Refs #52305 (companion to PR #50818, which closes the related cron-run
remap slice at internal enqueue sites). Doesn't depend on #50818.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kaspre
2026-05-06 20:49:07 -04:00
committed by Peter Steinberger
parent 13bc7037b1
commit 4ddd942f5f
13 changed files with 231 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
src/cli/system-cli.ts
View File

@@ -8,7 +8,12 @@ import { formatCliCommand } from "./command-format.js";
import type { GatewayRpcOpts } from "./gateway-rpc.js";
import { addGatewayClientOptions, callGatewayFromCli } from "./gateway-rpc.js";
type SystemEventOpts = GatewayRpcOpts & { text?: string; mode?: string; json?: boolean };
type SystemEventOpts = GatewayRpcOpts & {
text?: string;
mode?: string;
sessionKey?: string;
json?: boolean;
};
type SystemGatewayOpts = GatewayRpcOpts & { json?: boolean };
const normalizeWakeMode = (raw: unknown) => {
@@ -56,6 +61,10 @@ export function registerSystemCli(program: Command) {
.description("Enqueue a system event and optionally trigger a heartbeat")
.requiredOption("--text <text>", "System event text")
.option("--mode <mode>", "Wake mode (now|next-heartbeat)", "next-heartbeat")
.option(
"--session-key <sessionKey>",
"Target a specific session for the event (defaults to the agent's main session)",
)
.option("--json", "Output JSON", false),
).action(async (opts: SystemEventOpts) => {
await runSystemGatewayCommand(
@@ -68,7 +77,13 @@ export function registerSystemCli(program: Command) {
);
}
const mode = normalizeWakeMode(opts.mode);
return await callGatewayFromCli("wake", opts, { mode, text }, { expectFinal: false });
const sessionKey = normalizeOptionalString(opts.sessionKey);
return await callGatewayFromCli(
"wake",
opts,
sessionKey ? { mode, text, sessionKey } : { mode, text },
{ expectFinal: false },
);
},
"ok",
);