5a3a448bc4
Add a `spawn` action to the /subagents command handler that invokes spawnSubagentDirect() to deterministically launch a named subagent. Usage: /subagents spawn <agentId> <task> [--model <model>] [--thinking <level>] Also includes the shared subagent-spawn module extraction (same as the refactor/extract-shared-subagent-spawn branch) since it hasn't merged yet. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
87 lines
3.4 KiB
TypeScript
87 lines
3.4 KiB
TypeScript
import { Type } from "@sinclair/typebox";
|
|
import type { GatewayMessageChannel } from "../../utils/message-channel.js";
|
|
import type { AnyAgentTool } from "./common.js";
|
|
import { optionalStringEnum } from "../schema/typebox.js";
|
|
import { spawnSubagentDirect } from "../subagent-spawn.js";
|
|
import { jsonResult, readStringParam } from "./common.js";
|
|
|
|
const SessionsSpawnToolSchema = Type.Object({
|
|
task: Type.String(),
|
|
label: Type.Optional(Type.String()),
|
|
agentId: Type.Optional(Type.String()),
|
|
model: Type.Optional(Type.String()),
|
|
thinking: Type.Optional(Type.String()),
|
|
runTimeoutSeconds: Type.Optional(Type.Number({ minimum: 0 })),
|
|
// Back-compat: older callers used timeoutSeconds for this tool.
|
|
timeoutSeconds: Type.Optional(Type.Number({ minimum: 0 })),
|
|
cleanup: optionalStringEnum(["delete", "keep"] as const),
|
|
});
|
|
|
|
export function createSessionsSpawnTool(opts?: {
|
|
agentSessionKey?: string;
|
|
agentChannel?: GatewayMessageChannel;
|
|
agentAccountId?: string;
|
|
agentTo?: string;
|
|
agentThreadId?: string | number;
|
|
agentGroupId?: string | null;
|
|
agentGroupChannel?: string | null;
|
|
agentGroupSpace?: string | null;
|
|
sandboxed?: boolean;
|
|
/** Explicit agent ID override for cron/hook sessions where session key parsing may not work. */
|
|
requesterAgentIdOverride?: string;
|
|
}): AnyAgentTool {
|
|
return {
|
|
label: "Sessions",
|
|
name: "sessions_spawn",
|
|
description:
|
|
"Spawn a background sub-agent run in an isolated session and announce the result back to the requester chat.",
|
|
parameters: SessionsSpawnToolSchema,
|
|
execute: async (_toolCallId, args) => {
|
|
const params = args as Record<string, unknown>;
|
|
const task = readStringParam(params, "task", { required: true });
|
|
const label = typeof params.label === "string" ? params.label.trim() : "";
|
|
const requestedAgentId = readStringParam(params, "agentId");
|
|
const modelOverride = readStringParam(params, "model");
|
|
const thinkingOverrideRaw = readStringParam(params, "thinking");
|
|
const cleanup =
|
|
params.cleanup === "keep" || params.cleanup === "delete" ? params.cleanup : "keep";
|
|
// Back-compat: older callers used timeoutSeconds for this tool.
|
|
const timeoutSecondsCandidate =
|
|
typeof params.runTimeoutSeconds === "number"
|
|
? params.runTimeoutSeconds
|
|
: typeof params.timeoutSeconds === "number"
|
|
? params.timeoutSeconds
|
|
: undefined;
|
|
const runTimeoutSeconds =
|
|
typeof timeoutSecondsCandidate === "number" && Number.isFinite(timeoutSecondsCandidate)
|
|
? Math.max(0, Math.floor(timeoutSecondsCandidate))
|
|
: undefined;
|
|
|
|
const result = await spawnSubagentDirect(
|
|
{
|
|
task,
|
|
label: label || undefined,
|
|
agentId: requestedAgentId,
|
|
model: modelOverride,
|
|
thinking: thinkingOverrideRaw,
|
|
runTimeoutSeconds,
|
|
cleanup,
|
|
},
|
|
{
|
|
agentSessionKey: opts?.agentSessionKey,
|
|
agentChannel: opts?.agentChannel,
|
|
agentAccountId: opts?.agentAccountId,
|
|
agentTo: opts?.agentTo,
|
|
agentThreadId: opts?.agentThreadId,
|
|
agentGroupId: opts?.agentGroupId,
|
|
agentGroupChannel: opts?.agentGroupChannel,
|
|
agentGroupSpace: opts?.agentGroupSpace,
|
|
requesterAgentIdOverride: opts?.requesterAgentIdOverride,
|
|
},
|
|
);
|
|
|
|
return jsonResult(result);
|
|
},
|
|
};
|
|
}
|