import { abortEmbeddedPiRun } from "../../agents/pi-embedded.js"; import type { SessionEntry } from "../../config/sessions.js"; import { updateSessionStore } from "../../config/sessions.js"; import { logVerbose } from "../../globals.js"; import { createInternalHookEvent, triggerInternalHook } from "../../hooks/internal-hooks.js"; import { scheduleGatewaySigusr1Restart, triggerClawdbotRestart } from "../../infra/restart.js"; import { parseActivationCommand } from "../group-activation.js"; import { parseSendPolicyCommand } from "../send-policy.js"; import { normalizeUsageDisplay, resolveResponseUsageMode } from "../thinking.js"; import { formatAbortReplyText, isAbortTrigger, setAbortMemory, stopSubagentsForRequester, } from "./abort.js"; import type { CommandHandler } from "./commands-types.js"; import { clearSessionQueues } from "./queue.js"; function resolveSessionEntryForKey( store: Record | undefined, sessionKey: string | undefined, ) { if (!store || !sessionKey) return {}; const direct = store[sessionKey]; if (direct) return { entry: direct, key: sessionKey }; return {}; } function resolveAbortTarget(params: { ctx: { CommandTargetSessionKey?: string | null }; sessionKey?: string; sessionEntry?: SessionEntry; sessionStore?: Record; }) { const targetSessionKey = params.ctx.CommandTargetSessionKey?.trim() || params.sessionKey; const { entry, key } = resolveSessionEntryForKey(params.sessionStore, targetSessionKey); if (entry && key) return { entry, key, sessionId: entry.sessionId }; if (params.sessionEntry && params.sessionKey) { return { entry: params.sessionEntry, key: params.sessionKey, sessionId: params.sessionEntry.sessionId, }; } return { entry: undefined, key: targetSessionKey, sessionId: undefined }; } export const handleActivationCommand: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; const activationCommand = parseActivationCommand(params.command.commandBodyNormalized); if (!activationCommand.hasCommand) return null; if (!params.isGroup) { return { shouldContinue: false, reply: { text: "⚙️ Group activation only applies to group chats." }, }; } if (!params.command.isAuthorizedSender) { logVerbose( `Ignoring /activation from unauthorized sender in group: ${params.command.senderId || ""}`, ); return { shouldContinue: false }; } if (!activationCommand.mode) { return { shouldContinue: false, reply: { text: "⚙️ Usage: /activation mention|always" }, }; } if (params.sessionEntry && params.sessionStore && params.sessionKey) { params.sessionEntry.groupActivation = activationCommand.mode; params.sessionEntry.groupActivationNeedsSystemIntro = true; params.sessionEntry.updatedAt = Date.now(); params.sessionStore[params.sessionKey] = params.sessionEntry; if (params.storePath) { await updateSessionStore(params.storePath, (store) => { store[params.sessionKey] = params.sessionEntry as SessionEntry; }); } } return { shouldContinue: false, reply: { text: `⚙️ Group activation set to ${activationCommand.mode}.`, }, }; }; export const handleSendPolicyCommand: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; const sendPolicyCommand = parseSendPolicyCommand(params.command.commandBodyNormalized); if (!sendPolicyCommand.hasCommand) return null; if (!params.command.isAuthorizedSender) { logVerbose( `Ignoring /send from unauthorized sender: ${params.command.senderId || ""}`, ); return { shouldContinue: false }; } if (!sendPolicyCommand.mode) { return { shouldContinue: false, reply: { text: "⚙️ Usage: /send on|off|inherit" }, }; } if (params.sessionEntry && params.sessionStore && params.sessionKey) { if (sendPolicyCommand.mode === "inherit") { delete params.sessionEntry.sendPolicy; } else { params.sessionEntry.sendPolicy = sendPolicyCommand.mode; } params.sessionEntry.updatedAt = Date.now(); params.sessionStore[params.sessionKey] = params.sessionEntry; if (params.storePath) { await updateSessionStore(params.storePath, (store) => { store[params.sessionKey] = params.sessionEntry as SessionEntry; }); } } const label = sendPolicyCommand.mode === "inherit" ? "inherit" : sendPolicyCommand.mode === "allow" ? "on" : "off"; return { shouldContinue: false, reply: { text: `⚙️ Send policy set to ${label}.` }, }; }; export const handleUsageCommand: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; const normalized = params.command.commandBodyNormalized; if (normalized !== "/usage" && !normalized.startsWith("/usage ")) return null; if (!params.command.isAuthorizedSender) { logVerbose( `Ignoring /usage from unauthorized sender: ${params.command.senderId || ""}`, ); return { shouldContinue: false }; } const rawArgs = normalized === "/usage" ? "" : normalized.slice("/usage".length).trim(); const requested = rawArgs ? normalizeUsageDisplay(rawArgs) : undefined; if (rawArgs && !requested) { return { shouldContinue: false, reply: { text: "⚙️ Usage: /usage off|tokens|full" }, }; } const currentRaw = params.sessionEntry?.responseUsage ?? (params.sessionKey ? params.sessionStore?.[params.sessionKey]?.responseUsage : undefined); const current = resolveResponseUsageMode(currentRaw); const next = requested ?? (current === "off" ? "tokens" : current === "tokens" ? "full" : "off"); if (params.sessionEntry && params.sessionStore && params.sessionKey) { if (next === "off") delete params.sessionEntry.responseUsage; else params.sessionEntry.responseUsage = next; params.sessionEntry.updatedAt = Date.now(); params.sessionStore[params.sessionKey] = params.sessionEntry; if (params.storePath) { await updateSessionStore(params.storePath, (store) => { store[params.sessionKey] = params.sessionEntry as SessionEntry; }); } } return { shouldContinue: false, reply: { text: `⚙️ Usage footer: ${next}.`, }, }; }; export const handleRestartCommand: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; if (params.command.commandBodyNormalized !== "/restart") return null; if (!params.command.isAuthorizedSender) { logVerbose( `Ignoring /restart from unauthorized sender: ${params.command.senderId || ""}`, ); return { shouldContinue: false }; } if (params.cfg.commands?.restart !== true) { return { shouldContinue: false, reply: { text: "⚠️ /restart is disabled. Set commands.restart=true to enable.", }, }; } const hasSigusr1Listener = process.listenerCount("SIGUSR1") > 0; if (hasSigusr1Listener) { scheduleGatewaySigusr1Restart({ reason: "/restart" }); return { shouldContinue: false, reply: { text: "⚙️ Restarting clawdbot in-process (SIGUSR1); back in a few seconds.", }, }; } const restartMethod = triggerClawdbotRestart(); if (!restartMethod.ok) { const detail = restartMethod.detail ? ` Details: ${restartMethod.detail}` : ""; return { shouldContinue: false, reply: { text: `⚠️ Restart failed (${restartMethod.method}).${detail}`, }, }; } return { shouldContinue: false, reply: { text: `⚙️ Restarting clawdbot via ${restartMethod.method}; give me a few seconds to come back online.`, }, }; }; export const handleStopCommand: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; if (params.command.commandBodyNormalized !== "/stop") return null; if (!params.command.isAuthorizedSender) { logVerbose( `Ignoring /stop from unauthorized sender: ${params.command.senderId || ""}`, ); return { shouldContinue: false }; } const abortTarget = resolveAbortTarget({ ctx: params.ctx, sessionKey: params.sessionKey, sessionEntry: params.sessionEntry, sessionStore: params.sessionStore, }); if (abortTarget.sessionId) { abortEmbeddedPiRun(abortTarget.sessionId); } const cleared = clearSessionQueues([abortTarget.key, abortTarget.sessionId]); if (cleared.followupCleared > 0 || cleared.laneCleared > 0) { logVerbose( `stop: cleared followups=${cleared.followupCleared} lane=${cleared.laneCleared} keys=${cleared.keys.join(",")}`, ); } if (abortTarget.entry && params.sessionStore && abortTarget.key) { abortTarget.entry.abortedLastRun = true; abortTarget.entry.updatedAt = Date.now(); params.sessionStore[abortTarget.key] = abortTarget.entry; if (params.storePath) { await updateSessionStore(params.storePath, (store) => { store[abortTarget.key] = abortTarget.entry as SessionEntry; }); } } else if (params.command.abortKey) { setAbortMemory(params.command.abortKey, true); } // Trigger internal hook for stop command const hookEvent = createInternalHookEvent( "command", "stop", abortTarget.key ?? params.sessionKey ?? "", { sessionEntry: abortTarget.entry ?? params.sessionEntry, sessionId: abortTarget.sessionId, commandSource: params.command.surface, senderId: params.command.senderId, }, ); await triggerInternalHook(hookEvent); const { stopped } = stopSubagentsForRequester({ cfg: params.cfg, requesterSessionKey: abortTarget.key ?? params.sessionKey, }); return { shouldContinue: false, reply: { text: formatAbortReplyText(stopped) } }; }; export const handleAbortTrigger: CommandHandler = async (params, allowTextCommands) => { if (!allowTextCommands) return null; if (!isAbortTrigger(params.command.rawBodyNormalized)) return null; const abortTarget = resolveAbortTarget({ ctx: params.ctx, sessionKey: params.sessionKey, sessionEntry: params.sessionEntry, sessionStore: params.sessionStore, }); if (abortTarget.sessionId) { abortEmbeddedPiRun(abortTarget.sessionId); } if (abortTarget.entry && params.sessionStore && abortTarget.key) { abortTarget.entry.abortedLastRun = true; abortTarget.entry.updatedAt = Date.now(); params.sessionStore[abortTarget.key] = abortTarget.entry; if (params.storePath) { await updateSessionStore(params.storePath, (store) => { store[abortTarget.key] = abortTarget.entry as SessionEntry; }); } } else if (params.command.abortKey) { setAbortMemory(params.command.abortKey, true); } return { shouldContinue: false, reply: { text: "⚙️ Agent was aborted." } }; };