@duckmind/dm-darwin-x64 0.43.4 → 0.48.5

package/extensions/dm-subagents/src/extension/rpc.ts

@@ -1,369 +0,0 @@
-import * as path from "node:path";
-import type { AgentToolResult } from "@duckmind/dm-agent-core";
-import type { ExtensionContext } from "@duckmind/dm-coding-agent";
-import { Compile } from "typebox/compile";
-import { resolveAsyncRunLocation } from "../runs/background/async-resume.ts";
-import { deliverTimeoutRequest } from "../runs/background/control-channel.ts";
-import { reconcileAsyncRun } from "../runs/background/stale-run-reconciler.ts";
-import type { SubagentParamsLike } from "../runs/foreground/subagent-executor.ts";
-import { type Details, ASYNC_DIR, RESULTS_DIR } from "../shared/types.ts";
-import { readStatus } from "../shared/utils.ts";
-import { SubagentParams } from "./schemas.ts";
-
-export const SUBAGENT_RPC_PROTOCOL_VERSION = 1;
-export const SUBAGENT_RPC_REQUEST_EVENT = "subagents:rpc:v1:request";
-export const SUBAGENT_RPC_READY_EVENT = "subagents:rpc:v1:ready";
-export const SUBAGENT_RPC_REPLY_EVENT_PREFIX = "subagents:rpc:v1:reply:";
-
-export const SUBAGENT_RPC_METHODS = ["ping", "status", "spawn", "interrupt", "stop"] as const;
-export type SubagentRpcMethod = typeof SUBAGENT_RPC_METHODS[number];
-
-export interface SubagentRpcRequestEnvelope {
-	version: typeof SUBAGENT_RPC_PROTOCOL_VERSION;
-	requestId: string;
-	method: SubagentRpcMethod;
-	params?: unknown;
-	source?: {
-		extension?: string;
-		[key: string]: unknown;
-	};
-}
-
-export type SubagentRpcReplyEnvelope<T = unknown> = {
-	version: typeof SUBAGENT_RPC_PROTOCOL_VERSION;
-	requestId: string;
-	method?: SubagentRpcMethod;
-	success: true;
-	data: T;
-} | {
-	version: typeof SUBAGENT_RPC_PROTOCOL_VERSION;
-	requestId: string;
-	method?: SubagentRpcMethod;
-	success: false;
-	error: {
-		code: SubagentRpcErrorCode;
-		message: string;
-	};
-};
-
-type SubagentRpcErrorCode =
-	| "invalid_request"
-	| "invalid_params"
-	| "unsupported_version"
-	| "unsupported_method"
-	| "no_active_session"
-	| "execution_failed"
-	| "not_found"
-	| "invalid_state";
-
-interface EventBus {
-	on(event: string, handler: (data: unknown) => void): (() => void) | void;
-	emit(event: string, data: unknown): void;
-}
-
-interface RegisterSubagentRpcBridgeOptions {
-	events: EventBus;
-	getContext: () => ExtensionContext | null;
-	execute: (
-		id: string,
-		params: SubagentParamsLike,
-		signal: AbortSignal,
-		onUpdate: ((result: AgentToolResult<Details>) => void) | undefined,
-		ctx: ExtensionContext,
-	) => Promise<AgentToolResult<Details>>;
-	asyncDirRoot?: string;
-	resultsDir?: string;
-	kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
-	now?: () => number;
-}
-
-class SubagentRpcError extends Error {
-	readonly code: SubagentRpcErrorCode;
-
-	constructor(code: SubagentRpcErrorCode, message: string) {
-		super(message);
-		this.name = "SubagentRpcError";
-		this.code = code;
-	}
-}
-
-const subagentParamsValidator = Compile(SubagentParams);
-
-export function subagentRpcReplyEvent(requestId: string): string {
-	return `${SUBAGENT_RPC_REPLY_EVENT_PREFIX}${requestId}`;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-function assertRequestId(value: unknown): string {
-	if (typeof value !== "string" || value.trim().length === 0 || /[\r\n]/.test(value)) {
-		throw new SubagentRpcError("invalid_request", "RPC requestId must be a non-empty string without newlines.");
-	}
-	return value;
-}
-
-function assertRecordParams(params: unknown, method: SubagentRpcMethod): Record<string, unknown> {
-	if (params === undefined) return {};
-	if (!isRecord(params)) throw new SubagentRpcError("invalid_params", `RPC ${method} params must be an object.`);
-	return params;
-}
-
-function assertSubagentParams(params: SubagentParamsLike, label: string): void {
-	if (subagentParamsValidator.Check(params)) return;
-	const messages = [...subagentParamsValidator.Errors(params)]
-		.slice(0, 4)
-		.map((error) => error.message);
-	throw new SubagentRpcError("invalid_params", `${label}: ${messages.join("; ") || "invalid subagent parameters"}`);
-}
-
-function textFromToolResult(result: AgentToolResult<Details>): string {
-	return result.content
-		.filter((part): part is { type: "text"; text: string } => part.type === "text")
-		.map((part) => part.text)
-		.join("\n");
-}
-
-function dataFromToolResult(result: AgentToolResult<Details>): { text: string; details?: Details; isError?: boolean } {
-	return {
-		text: textFromToolResult(result),
-		...(result.details ? { details: result.details } : {}),
-		...(result.isError ? { isError: true } : {}),
-	};
-}
-
-function failIfToolError(result: AgentToolResult<Details>): void {
-	if (!result.isError) return;
-	throw new SubagentRpcError("execution_failed", textFromToolResult(result) || "Subagent RPC execution failed.");
-}
-
-function normalizeTargetParams(params: unknown, method: SubagentRpcMethod): Pick<SubagentParamsLike, "id" | "runId" | "dir" | "index"> {
-	const input = assertRecordParams(params, method);
-	const output: Pick<SubagentParamsLike, "id" | "runId" | "dir" | "index"> = {};
-	if (input.id !== undefined) output.id = input.id as string;
-	if (input.runId !== undefined) output.runId = input.runId as string;
-	if (input.dir !== undefined) output.dir = input.dir as string;
-	if (input.index !== undefined) output.index = input.index as number;
-	return output;
-}
-
-function sessionData(ctx: ExtensionContext | null): { cwd?: string; sessionId?: string; sessionFile?: string | null } {
-	if (!ctx) return {};
-	return {
-		cwd: ctx.cwd,
-		sessionId: ctx.sessionManager.getSessionId() ?? undefined,
-		sessionFile: ctx.sessionManager.getSessionFile() ?? null,
-	};
-}
-
-function pingData(ctx: ExtensionContext | null) {
-	return {
-		version: SUBAGENT_RPC_PROTOCOL_VERSION,
-		methods: [...SUBAGENT_RPC_METHODS],
-		capabilities: {
-			status: true,
-			asyncSpawn: true,
-			interrupt: true,
-			stop: true,
-		},
-		events: {
-			ready: SUBAGENT_RPC_READY_EVENT,
-			request: SUBAGENT_RPC_REQUEST_EVENT,
-			replyPrefix: SUBAGENT_RPC_REPLY_EVENT_PREFIX,
-		},
-		session: sessionData(ctx),
-	};
-}
-
-async function executeChecked(
-	options: RegisterSubagentRpcBridgeOptions,
-	ctx: ExtensionContext,
-	requestId: string,
-	method: SubagentRpcMethod,
-	params: SubagentParamsLike,
-): Promise<{ text: string; details?: Details; isError?: boolean }> {
-	assertSubagentParams(params, `RPC ${method} params`);
-	const controller = new AbortController();
-	const result = await options.execute(`rpc-${method}-${requestId}`, params, controller.signal, undefined, ctx);
-	failIfToolError(result);
-	return dataFromToolResult(result);
-}
-
-function spawnParams(params: unknown): SubagentParamsLike {
-	const input = assertRecordParams(params, "spawn");
-	if (input.action !== undefined) {
-		throw new SubagentRpcError("invalid_params", "RPC spawn does not accept management/control actions. Use status or interrupt RPC methods instead.");
-	}
-	if (input.async === false) {
-		throw new SubagentRpcError("invalid_params", "RPC spawn only supports detached async launches; omit async or set async: true.");
-	}
-	if (input.clarify === true) {
-		throw new SubagentRpcError("invalid_params", "RPC spawn cannot open the clarify UI; omit clarify or set clarify: false.");
-	}
-	return { ...(input as SubagentParamsLike), async: true, clarify: false };
-}
-
-function stopAsyncRun(
-	params: unknown,
-	options: RegisterSubagentRpcBridgeOptions,
-	ctx: ExtensionContext,
-): { runId: string; asyncDir: string; previousState: string; state: "stopping"; message: string } {
-	const target = normalizeTargetParams(params, "stop");
-	assertSubagentParams({ action: "status", ...target }, "RPC stop target params");
-	const asyncDirRoot = options.asyncDirRoot ?? ASYNC_DIR;
-	const resultsDir = options.resultsDir ?? RESULTS_DIR;
-	let location;
-	try {
-		location = resolveAsyncRunLocation(target, asyncDirRoot, resultsDir);
-	} catch (error) {
-		throw new SubagentRpcError("invalid_params", error instanceof Error ? error.message : String(error));
-	}
-	if (!location.asyncDir) {
-		throw new SubagentRpcError("not_found", "Async run not found or already completed; stop requires a live async run directory.");
-	}
-
-	const currentSessionId = ctx.sessionManager.getSessionId();
-	const initialStatus = readStatus(location.asyncDir);
-	const initialRunId = initialStatus?.runId ?? location.resolvedId ?? path.basename(location.asyncDir);
-	if (!initialStatus) throw new SubagentRpcError("not_found", `Status file not found for async run '${initialRunId}'.`);
-	if (!currentSessionId || initialStatus.sessionId !== currentSessionId) {
-		throw new SubagentRpcError("not_found", `Async run '${initialRunId}' was not found in the active session.`);
-	}
-
-	let status;
-	try {
-		status = reconcileAsyncRun(location.asyncDir, { resultsDir, kill: options.kill, now: options.now }).status;
-	} catch (error) {
-		throw new SubagentRpcError("execution_failed", error instanceof Error ? error.message : String(error));
-	}
-	const runId = status?.runId ?? initialRunId;
-	if (!status) throw new SubagentRpcError("not_found", `Status file not found for async run '${runId}'.`);
-	if (status.sessionId !== currentSessionId) {
-		throw new SubagentRpcError("not_found", `Async run '${runId}' was not found in the active session.`);
-	}
-	if (status.state !== "running") {
-		throw new SubagentRpcError("invalid_state", `Async run ${runId} is ${status.state}; stop only supports running async runs.`);
-	}
-
-	try {
-		deliverTimeoutRequest({
-			asyncDir: location.asyncDir,
-			pid: status.pid,
-			kill: options.kill,
-			now: options.now,
-			source: "rpc-stop",
-		});
-	} catch (error) {
-		throw new SubagentRpcError("execution_failed", error instanceof Error ? error.message : String(error));
-	}
-
-	return {
-		runId,
-		asyncDir: location.asyncDir,
-		previousState: status.state,
-		state: "stopping",
-		message: `Stop requested for async run ${runId}.`,
-	};
-}
-
-async function handleRequest(
-	request: SubagentRpcRequestEnvelope,
-	options: RegisterSubagentRpcBridgeOptions,
-): Promise<unknown> {
-	const ctx = options.getContext();
-	if (request.method === "ping") return pingData(ctx);
-	if (!ctx) throw new SubagentRpcError("no_active_session", "No active extension context for subagent RPC.");
-
-	if (request.method === "spawn") {
-		return executeChecked(options, ctx, request.requestId, request.method, spawnParams(request.params));
-	}
-	if (request.method === "status") {
-		return executeChecked(options, ctx, request.requestId, request.method, { action: "status", ...normalizeTargetParams(request.params, "status") });
-	}
-	if (request.method === "interrupt") {
-		return executeChecked(options, ctx, request.requestId, request.method, { action: "interrupt", ...normalizeTargetParams(request.params, "interrupt") });
-	}
-	if (request.method === "stop") {
-		return stopAsyncRun(request.params, options, ctx);
-	}
-	throw new SubagentRpcError("unsupported_method", `Unsupported subagent RPC method: ${String(request.method)}`);
-}
-
-function parseRequest(raw: unknown): SubagentRpcRequestEnvelope {
-	if (!isRecord(raw)) throw new SubagentRpcError("invalid_request", "Subagent RPC request must be an object.");
-	const requestId = assertRequestId(raw.requestId);
-	if (raw.version !== SUBAGENT_RPC_PROTOCOL_VERSION) {
-		throw new SubagentRpcError("unsupported_version", `Unsupported subagent RPC version: ${String(raw.version)}.`);
-	}
-	if (typeof raw.method !== "string" || !(SUBAGENT_RPC_METHODS as readonly string[]).includes(raw.method)) {
-		throw new SubagentRpcError("unsupported_method", `Unsupported subagent RPC method: ${String(raw.method)}.`);
-	}
-	return {
-		version: SUBAGENT_RPC_PROTOCOL_VERSION,
-		requestId,
-		method: raw.method as SubagentRpcMethod,
-		...(raw.params !== undefined ? { params: raw.params } : {}),
-		...(isRecord(raw.source) ? { source: raw.source as SubagentRpcRequestEnvelope["source"] } : {}),
-	};
-}
-
-function safeReplyRequestId(raw: unknown): string {
-	if (!isRecord(raw)) return "unknown";
-	const requestId = raw.requestId;
-	return typeof requestId === "string" && requestId.trim().length > 0 && !/[\r\n]/.test(requestId)
-		? requestId
-		: "unknown";
-}
-
-function errorReply(raw: unknown, error: unknown): SubagentRpcReplyEnvelope {
-	const requestId = safeReplyRequestId(raw);
-	const method = isRecord(raw) && typeof raw.method === "string" && (SUBAGENT_RPC_METHODS as readonly string[]).includes(raw.method)
-		? raw.method as SubagentRpcMethod
-		: undefined;
-	const rpcError = error instanceof SubagentRpcError
-		? error
-		: new SubagentRpcError("execution_failed", error instanceof Error ? error.message : String(error));
-	return {
-		version: SUBAGENT_RPC_PROTOCOL_VERSION,
-		requestId,
-		...(method ? { method } : {}),
-		success: false,
-		error: {
-			code: rpcError.code,
-			message: rpcError.message,
-		},
-	};
-}
-
-export function registerSubagentRpcBridge(options: RegisterSubagentRpcBridgeOptions): {
-	emitReady: (ctx?: ExtensionContext | null) => void;
-	dispose: () => void;
-} {
-	const unsubscribe = options.events.on(SUBAGENT_RPC_REQUEST_EVENT, async (raw) => {
-		let request: SubagentRpcRequestEnvelope | undefined;
-		try {
-			request = parseRequest(raw);
-			const data = await handleRequest(request, options);
-			options.events.emit(subagentRpcReplyEvent(request.requestId), {
-				version: SUBAGENT_RPC_PROTOCOL_VERSION,
-				requestId: request.requestId,
-				method: request.method,
-				success: true,
-				data,
-			} satisfies SubagentRpcReplyEnvelope);
-		} catch (error) {
-			const reply = errorReply(request ?? raw, error);
-			options.events.emit(subagentRpcReplyEvent(reply.requestId), reply);
-		}
-	});
-
-	return {
-		emitReady: (ctx) => {
-			options.events.emit(SUBAGENT_RPC_READY_EVENT, pingData(ctx ?? options.getContext()));
-		},
-		dispose: () => {
-			if (typeof unsubscribe === "function") unsubscribe();
-		},
-	};
-}

package/extensions/dm-subagents/src/extension/schemas.ts

@@ -1,309 +0,0 @@
-/**
- * TypeBox schemas for subagent tool parameters
- */
-
-import { Type } from "typebox";
-
-function keepTopLevelParameterDescriptions<T>(schema: T): T {
-	return pruneNestedDescriptions(schema, []) as T;
-}
-
-function pruneNestedDescriptions(value: unknown, path: string[]): unknown {
-	if (!value || typeof value !== "object") return value;
-
-	const result = Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value));
-	for (const key of Reflect.ownKeys(value)) {
-		const descriptor = Object.getOwnPropertyDescriptor(value, key);
-		if (!descriptor) continue;
-		if (key === "description" && !isTopLevelParameterDescription(path)) continue;
-		if ("value" in descriptor) {
-			const nextPath = typeof key === "string" ? [...path, key] : path;
-			descriptor.value = pruneNestedDescriptions(descriptor.value, nextPath);
-		}
-		Object.defineProperty(result, key, descriptor);
-	}
-	return result;
-}
-
-function isTopLevelParameterDescription(path: string[]): boolean {
-	return path.length === 2 && path[0] === "properties";
-}
-
-const SkillOverride = Type.Unsafe({
-	anyOf: [
-		{ type: "array", items: { type: "string" } },
-		{ type: "boolean" },
-		{ type: "string" },
-	],
-	description: "Skill name(s) to make available (comma-separated), array of strings, or boolean (false disables, true uses default)",
-});
-
-const OutputOverride = Type.Unsafe({
-	anyOf: [
-		{ type: "string" },
-		{ type: "boolean" },
-	],
-	description: "Output filename/path (string), or false to disable file output",
-});
-
-const OutputModeOverride = Type.String({
-	enum: ["inline", "file-only"],
-	description: "Return saved output inline (default) or only a concise file reference. file-only requires output to be a path.",
-});
-
-const ReadsOverride = Type.Unsafe({
-	anyOf: [
-		{ type: "array", items: { type: "string" } },
-		{ type: "boolean" },
-	],
-	description: "Files to read before running (array of filenames), or false to disable",
-});
-
-const JsonSchemaObject = Type.Unsafe({
-	type: "object",
-	additionalProperties: true,
-	description: "JSON Schema object for strict structured output. Non-object roots are rejected.",
-});
-
-const AcceptanceOverride = Type.Unsafe({
-	anyOf: [
-		{ type: "string", enum: ["auto", "none", "attested", "checked", "verified", "reviewed"] },
-		{ type: "boolean", enum: [false] },
-		{ type: "object", additionalProperties: true },
-	],
-	description: "Optional acceptance policy. Omitted means auto-inferred; verified requires configured runtime commands.",
-});
-
-const TurnBudgetOverride = Type.Object({
-	maxTurns: Type.Integer({ minimum: 1 }),
-	graceTurns: Type.Optional(Type.Integer({ minimum: 0 })),
-}, { additionalProperties: false, description: "Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns additional assistant turns it is aborted and partial output is returned." });
-
-const ToolBudgetBlock = Type.Unsafe({
-	anyOf: [
-		{ type: "array", minItems: 1, items: { type: "string", minLength: 1 } },
-		{ type: "string", enum: ["*"] },
-	],
-});
-
-const ToolBudgetOverride = Type.Object({
-	soft: Type.Optional(Type.Integer({ minimum: 1 })),
-	hard: Type.Integer({ minimum: 1 }),
-	block: Type.Optional(ToolBudgetBlock),
-}, { additionalProperties: false, description: "Optional child tool-call budget. soft nudges the child; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize." });
-
-const TaskItem = Type.Object({
-	agent: Type.String(),
-	task: Type.String(),
-	cwd: Type.Optional(Type.String()),
-	count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
-	output: Type.Optional(OutputOverride),
-	outputMode: Type.Optional(OutputModeOverride),
-	reads: Type.Optional(ReadsOverride),
-	progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking for this task" })),
-	model: Type.Optional(Type.String({ description: "Override model for this task (e.g. 'google/gemini-3-pro')" })),
-	skill: Type.Optional(SkillOverride),
-	toolBudget: Type.Optional(ToolBudgetOverride),
-	acceptance: Type.Optional(AcceptanceOverride),
-});
-
-// Parallel task item (within a parallel step)
-const ParallelTaskSchema = Type.Object({
-	agent: Type.String(),
-	task: Type.Optional(Type.String({ description: "Task template with {task}, {previous}, {chain_dir} variables. Defaults to {previous}." })),
-	phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
-	label: Type.Optional(Type.String({ description: "Optional user-facing label for this parallel task." })),
-	as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
-	outputSchema: Type.Optional(JsonSchemaObject),
-	cwd: Type.Optional(Type.String()),
-	count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
-	output: Type.Optional(OutputOverride),
-	outputMode: Type.Optional(OutputModeOverride),
-	reads: Type.Optional(ReadsOverride),
-	progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
-	skill: Type.Optional(SkillOverride),
-	model: Type.Optional(Type.String({ description: "Override model for this task" })),
-	toolBudget: Type.Optional(ToolBudgetOverride),
-	acceptance: Type.Optional(AcceptanceOverride),
-});
-
-const DynamicExpandSchema = Type.Object({
-	from: Type.Object({
-		output: Type.String({ description: "Prior named structured output to expand from." }),
-		path: Type.String({ description: "JSON Pointer into the structured output, e.g. /items." }),
-	}, { additionalProperties: false }),
-	item: Type.Optional(Type.String({ description: "Template variable name for each item. Defaults to item." })),
-	key: Type.Optional(Type.String({ description: "JSON Pointer relative to each item for stable child ids." })),
-	maxItems: Type.Optional(Type.Integer({ minimum: 0, description: "Required fanout bound unless configured globally." })),
-	onEmpty: Type.Optional(Type.String({ enum: ["skip", "fail"], description: "Empty input behavior. Defaults to skip." })),
-}, { additionalProperties: false });
-
-const DynamicParallelTemplateSchema = Type.Object({
-	agent: Type.String(),
-	task: Type.Optional(Type.String({ description: "Task template with {item}, {item.path}, {task}, {previous}, {chain_dir}, and {outputs.name} variables." })),
-	phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
-	label: Type.Optional(Type.String({ description: "Optional user-facing label; item templates are supported." })),
-	outputSchema: Type.Optional(JsonSchemaObject),
-	cwd: Type.Optional(Type.String()),
-	output: Type.Optional(OutputOverride),
-	outputMode: Type.Optional(OutputModeOverride),
-	reads: Type.Optional(ReadsOverride),
-	progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
-	skill: Type.Optional(SkillOverride),
-	model: Type.Optional(Type.String({ description: "Override model for this task" })),
-	toolBudget: Type.Optional(ToolBudgetOverride),
-	acceptance: Type.Optional(AcceptanceOverride),
-}, { additionalProperties: false });
-
-const DynamicCollectSchema = Type.Object({
-	as: Type.String({ description: "Safe output name for the ordered collected result array." }),
-	outputSchema: Type.Optional(JsonSchemaObject),
-}, { additionalProperties: false });
-
-// Flattened so chain steps do not need an object-shape anyOf/oneOf union.
-const ChainItem = Type.Object({
-	agent: Type.Optional(Type.String({ description: "Sequential step agent name" })),
-	task: Type.Optional(Type.String({
-		description: "Task template with variables: {task}=original request, {previous}=prior step's text response, {chain_dir}=shared folder, {outputs.name}=prior named output. Required for first step, defaults to '{previous}' for subsequent steps."
-	})),
-	phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
-	label: Type.Optional(Type.String({ description: "Optional user-facing label for this chain step." })),
-	as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
-	outputSchema: Type.Optional(JsonSchemaObject),
-	cwd: Type.Optional(Type.String()),
-	output: Type.Optional(OutputOverride),
-	outputMode: Type.Optional(OutputModeOverride),
-	reads: Type.Optional(ReadsOverride),
-	progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
-	skill: Type.Optional(SkillOverride),
-	model: Type.Optional(Type.String({ description: "Override model for this step" })),
-	toolBudget: Type.Optional(ToolBudgetOverride),
-	acceptance: Type.Optional(AcceptanceOverride),
-	parallel: Type.Optional(Type.Unsafe({
-		anyOf: [
-			Type.Array(ParallelTaskSchema, { minItems: 1, description: "Tasks to run in parallel" }),
-			DynamicParallelTemplateSchema,
-		],
-		description: "Static parallel tasks array, or a single dynamic fanout child template when expand/collect are present.",
-	})),
-	expand: Type.Optional(DynamicExpandSchema),
-	collect: Type.Optional(DynamicCollectSchema),
-	concurrency: Type.Optional(Type.Number({ description: "Max concurrent tasks (default: 4)" })),
-	failFast: Type.Optional(Type.Boolean({ description: "Stop on first failure (default: false)" })),
-	worktree: Type.Optional(Type.Boolean({
-		description: "Create isolated git worktrees for each parallel task."
-	})),
-}, {
-	description: "Chain step: use {agent, task?, ...} for sequential, {parallel: [...]} for static concurrent execution, or {expand, parallel: {...}, collect} for dynamic fanout.",
-	additionalProperties: false,
-});
-
-const ControlOverrides = Type.Object({
-	enabled: Type.Optional(Type.Boolean({ description: "Enable/disable subagent control attention tracking for this run" })),
-	needsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "No-observed-activity window before a run needs attention" })),
-	activeNoticeAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "Active-long-running notice threshold by elapsed ms (default: 240000)" })),
-	activeNoticeAfterTurns: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by assistant turns (disabled by default)" })),
-	activeNoticeAfterTokens: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by total tokens (disabled by default)" })),
-	failedToolAttemptsBeforeAttention: Type.Optional(Type.Integer({ minimum: 1, description: "Consecutive mutating-tool failures before escalating to needs_attention (default: 3)" })),
-	notifyOn: Type.Optional(Type.Array(Type.String({ enum: ["active_long_running", "needs_attention"] }), {
-		description: "Control event types that should notify the parent/orchestrator. Defaults to active_long_running and needs_attention.",
-	})),
-	notifyChannels: Type.Optional(Type.Array(Type.String({ enum: ["event", "async", "intercom"] }), {
-		description: "Notification channels to use when available. Defaults to event, async, and intercom.",
-	})),
-});
-
-const SubagentParamsSchema = Type.Object({
-	agent: Type.Optional(Type.String({ description: "Agent name (SINGLE mode) or target for management get/update/delete" })),
-	task: Type.Optional(Type.String({ description: "Task (SINGLE mode, optional for self-contained agents)" })),
-	// Management action (when present, tool operates in management mode)
-	action: Type.Optional(Type.String({
-		description: "Management/control action only. Must be omitted for execution mode (single, parallel, or chain)."
-	})),
-	id: Type.Optional(Type.String({
-		description: "Run id or prefix for action='status', action='interrupt', action='resume', action='steer', or action='append-step'."
-	})),
-	runId: Type.Optional(Type.String({
-		description: "Target run ID for action='interrupt', action='resume', action='steer', or action='append-step'. Defaults to the most recently active controllable run for interrupt. Prefer id for new calls."
-	})),
-	dir: Type.Optional(Type.String({
-		description: "Async run directory for action='status', action='resume', or action='steer'."
-	})),
-	index: Type.Optional(Type.Integer({ minimum: 0, description: "Zero-based child index for actions that target a specific child or transcript." })),
-	view: Type.Optional(Type.String({
-		enum: ["fleet", "transcript"],
-		description: "Optional status view. Use view='fleet' for a read-only active foreground/async fleet surface, or view='transcript' with id/dir (and optional index) to tail a run transcript.",
-	})),
-	lines: Type.Optional(Type.Integer({ minimum: 1, maximum: 500, description: "Maximum transcript lines for action='status', view='transcript'. Defaults to 80." })),
-	message: Type.Optional(Type.String({ description: "Follow-up message for action='resume' or non-terminal guidance for action='steer'. Use index to choose a child from multi-child runs." })),
-	schedule: Type.Optional(Type.String({ description: "Explicit one-shot schedule for action='schedule'. Only honored when scheduledRuns.enabled is true. Use '+10m' or a future ISO timestamp with timezone; scheduled runs always launch async with fresh context." })),
-	scheduleName: Type.Optional(Type.String({ description: "Optional display name for action='schedule'." })),
-	// Chain identifier for management (can't reuse 'chain' — that's the execution array)
-	chainName: Type.Optional(Type.String({
-		description: "Chain name for get/update/delete management actions"
-	})),
-	// Agent/chain configuration for create/update (nested to avoid conflicts with execution fields)
-	config: Type.Optional(Type.Unsafe({
-		anyOf: [
-			{ type: "object", additionalProperties: true },
-			{ type: "string" },
-		],
-		description: "Agent/chain config for create/update. Object or JSON string; presence of steps creates a chain."
-	})),
-	tasks: Type.Optional(Type.Array(TaskItem, { description: "PARALLEL mode: [{agent, task, count?, output?, outputMode?, reads?, progress?}, ...]" })),
-	concurrency: Type.Optional(Type.Integer({ minimum: 1, description: "Top-level PARALLEL mode only: max concurrent tasks. Defaults to config.parallel.concurrency or 4." })),
-	worktree: Type.Optional(Type.Boolean({
-		description: "Create isolated git worktrees for parallel tasks; requires clean git state."
-	})),
-	chain: Type.Optional(Type.Array(ChainItem, { description: "CHAIN mode: sequential steps; each result becomes {previous}. append-step takes one tail step and may use {chain_dir}/{outputs.name}." })),
-	context: Type.Optional(Type.String({
-		enum: ["fresh", "fork"],
-		description: "'fresh' or 'fork' to branch from parent session. Explicit context overrides every child in the invocation. If omitted, each requested agent uses its own defaultContext; agents without defaultContext: 'fork' run fresh.",
-	})),
-	chainDir: Type.Optional(Type.String({ description: "Persistent chain artifact directory; defaults to user-scoped temp storage." })),
-	async: Type.Optional(Type.Boolean({ description: "Run in background (default: false, or per config)" })),
-	timeoutMs: Type.Optional(Type.Integer({ minimum: 1, description: "Optional run-level timeout in ms for foreground and async/background runs. Alias of maxRuntimeMs." })),
-	maxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: "Alias of timeoutMs for optional run-level timeout in foreground and async/background runs." })),
-	turnBudget: Type.Optional(TurnBudgetOverride),
-	toolBudget: Type.Optional(ToolBudgetOverride),
-	agentScope: Type.Optional(Type.String({ description: "Agent discovery scope: 'user', 'project', or 'both' (default: 'both'; project wins on name collisions)" })),
-	cwd: Type.Optional(Type.String()),
-	artifacts: Type.Optional(Type.Boolean({ description: "Write debug artifacts (default: true)" })),
-	includeProgress: Type.Optional(Type.Boolean({ description: "Include full progress in result (default: false)" })),
-	share: Type.Optional(Type.Boolean({ description: "Upload session to GitHub Gist for sharing (default: false)" })),
-	sessionDir: Type.Optional(
-		Type.String({ description: "Directory to store session logs (default: temp; enables sessions even if share=false)" }),
-	),
-	// Clarification TUI
-	clarify: Type.Optional(Type.Boolean({ description: "Show TUI to preview/edit before execution. Explicit clarify: true keeps the run foreground for the clarify UI; omitted clarify can still run in the background when async: true is set." })),
-	control: Type.Optional(ControlOverrides),
-	// Solo agent overrides
-	output: Type.Optional(Type.Unsafe({
-		anyOf: [
-			{ type: "string" },
-			{ type: "boolean" },
-		],
-		description: "Output file for single agent (string), or false to disable. Relative paths resolve against cwd.",
-	})),
-	outputMode: Type.Optional(OutputModeOverride),
-	skill: Type.Optional(SkillOverride),
-	model: Type.Optional(Type.String({ description: "Override model for single agent (e.g. 'anthropic/claude-sonnet-4')" })),
-	acceptance: Type.Optional(AcceptanceOverride),
-});
-
-export const SubagentParams = keepTopLevelParameterDescriptions(SubagentParamsSchema);
-
-const WaitParamsSchema = Type.Object({
-	id: Type.Optional(Type.String({
-		description: "Run id or prefix to wait for one specific run. Omit to wait across every active async run started in this session.",
-	})),
-	all: Type.Optional(Type.Boolean({
-		description: "Wait for ALL active runs to finish. Default false: return as soon as the first run finishes, so a fleet manager can spawn a replacement and wait again. Ignored when id targets a single run.",
-	})),
-	timeoutMs: Type.Optional(Type.Integer({
-		minimum: 1,
-		description: "Give up waiting after this many milliseconds (the runs keep going regardless). Defaults to 1800000 (30 minutes).",
-	})),
-});
-
-export const WaitParams = keepTopLevelParameterDescriptions(WaitParamsSchema);