@minpeter/pss-runtime 0.0.11 → 0.1.0-next.1

package/dist/subagent-job-cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-job-cancel.js","names":[],"sources":["../src/subagent-job-cancel.ts"],"sourcesContent":["import { jsonSchema, tool } from \"ai\";\nimport {\n  assertBackgroundTaskId,\n  cancelJob,\n  isActiveJob,\n} from \"./subagent-jobs\";\nimport type { BackgroundCancelInput, SubagentJob } from \"./subagent-types\";\n\nexport function createBackgroundCancelTool(jobs: Map<string, SubagentJob>) {\n  return tool<BackgroundCancelInput, unknown, Record<string, unknown>>({\n    description: \"Cancel an active background subagent job.\",\n    execute: (input: BackgroundCancelInput) => {\n      assertBackgroundTaskId(input.task_id, \"background_cancel\");\n      const job = jobs.get(input.task_id);\n      if (!job) {\n        throw new Error(`Unknown background subagent task ${input.task_id}.`);\n      }\n\n      if (isActiveJob(job.status)) {\n        cancelJob(job);\n      }\n\n      return {\n        status: job.status,\n        task_id: job.id,\n      };\n    },\n    inputSchema: jsonSchema<BackgroundCancelInput>({\n      additionalProperties: false,\n      properties: {\n        task_id: { type: \"string\" },\n      },\n      required: [\"task_id\"],\n      type: \"object\",\n    }),\n  });\n}\n"],"mappings":";;;AAQA,SAAgB,2BAA2B,MAAgC;CACzE,OAAO,KAA8D;EACnE,aAAa;EACb,UAAU,UAAiC;GACzC,uBAAuB,MAAM,SAAS,mBAAmB;GACzD,MAAM,MAAM,KAAK,IAAI,MAAM,OAAO;GAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,oCAAoC,MAAM,QAAQ,EAAE;GAGtE,IAAI,YAAY,IAAI,MAAM,GACxB,UAAU,GAAG;GAGf,OAAO;IACL,QAAQ,IAAI;IACZ,SAAS,IAAI;GACf;EACF;EACA,aAAa,WAAkC;GAC7C,sBAAsB;GACtB,YAAY,EACV,SAAS,EAAE,MAAM,SAAS,EAC5B;GACA,UAAU,CAAC,SAAS;GACpB,MAAM;EACR,CAAC;CACH,CAAC;AACH"}

package/dist/subagent-job-output.js

@@ -0,0 +1,63 @@
+import { assertBackgroundTaskId, cleanupJob, isActiveJob } from "./subagent-jobs.js";
+import { jsonSchema, tool } from "ai";
+//#region src/subagent-job-output.ts
+function createBackgroundOutputTool(jobs) {
+	return tool({
+		description: "Retrieve compact output for a background subagent job.",
+		execute: async (input, { abortSignal }) => {
+			assertBackgroundTaskId(input.task_id, "background_output");
+			const job = jobs.get(input.task_id);
+			if (!job) throw new Error(`Unknown background subagent task ${input.task_id}.`);
+			if (input.block === true && isActiveJob(job.status)) await waitForJob(job, input.timeout, abortSignal);
+			const output = {
+				result: job.result,
+				status: job.status,
+				subagent: job.subagent,
+				task_id: job.id
+			};
+			if (!(isActiveJob(job.status) || !job.settled)) {
+				if (await cleanupJob(job).then(() => true, () => false)) jobs.delete(job.id);
+			}
+			return output;
+		},
+		inputSchema: jsonSchema({
+			additionalProperties: false,
+			properties: {
+				block: { type: "boolean" },
+				task_id: { type: "string" },
+				timeout: {
+					minimum: 0,
+					type: "number"
+				}
+			},
+			required: ["task_id"],
+			type: "object"
+		})
+	});
+}
+async function waitForJob(job, timeout, abortSignal) {
+	if (abortSignal?.aborted) return;
+	const timeoutMs = Math.min(timeout ?? 6e4, 6e5);
+	let timeoutId;
+	let abortListener;
+	const abortPromise = abortSignal ? new Promise((resolve) => {
+		abortListener = resolve;
+		abortSignal.addEventListener("abort", abortListener, { once: true });
+	}) : void 0;
+	try {
+		await Promise.race([
+			job.promise,
+			...abortPromise ? [abortPromise] : [],
+			new Promise((resolve) => {
+				timeoutId = setTimeout(resolve, timeoutMs);
+			})
+		]);
+	} finally {
+		if (timeoutId) clearTimeout(timeoutId);
+		if (abortListener) abortSignal?.removeEventListener("abort", abortListener);
+	}
+}
+//#endregion
+export { createBackgroundOutputTool };
+
+//# sourceMappingURL=subagent-job-output.js.map

package/dist/subagent-job-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-job-output.js","names":[],"sources":["../src/subagent-job-output.ts"],"sourcesContent":["import { jsonSchema, tool } from \"ai\";\nimport {\n  assertBackgroundTaskId,\n  cleanupJob,\n  isActiveJob,\n} from \"./subagent-jobs\";\nimport type { BackgroundOutputInput, SubagentJob } from \"./subagent-types\";\n\nexport function createBackgroundOutputTool(jobs: Map<string, SubagentJob>) {\n  return tool<BackgroundOutputInput, unknown, Record<string, unknown>>({\n    description: \"Retrieve compact output for a background subagent job.\",\n    execute: async (input: BackgroundOutputInput, { abortSignal }) => {\n      assertBackgroundTaskId(input.task_id, \"background_output\");\n      const job = jobs.get(input.task_id);\n      if (!job) {\n        throw new Error(`Unknown background subagent task ${input.task_id}.`);\n      }\n\n      if (input.block === true && isActiveJob(job.status)) {\n        await waitForJob(job, input.timeout, abortSignal);\n      }\n\n      const output = {\n        result: job.result,\n        status: job.status,\n        subagent: job.subagent,\n        task_id: job.id,\n      };\n      if (!(isActiveJob(job.status) || !job.settled)) {\n        const cleaned = await cleanupJob(job).then(\n          () => true,\n          () => false\n        );\n        if (cleaned) {\n          jobs.delete(job.id);\n        }\n      }\n\n      return output;\n    },\n    inputSchema: jsonSchema<BackgroundOutputInput>({\n      additionalProperties: false,\n      properties: {\n        block: { type: \"boolean\" },\n        task_id: { type: \"string\" },\n        timeout: { minimum: 0, type: \"number\" },\n      },\n      required: [\"task_id\"],\n      type: \"object\",\n    }),\n  });\n}\n\nasync function waitForJob(\n  job: SubagentJob,\n  timeout: number | undefined,\n  abortSignal: AbortSignal | undefined\n) {\n  if (abortSignal?.aborted) {\n    return;\n  }\n\n  const timeoutMs = Math.min(timeout ?? 60_000, 600_000);\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let abortListener: (() => void) | undefined;\n  const abortPromise = abortSignal\n    ? new Promise<void>((resolve) => {\n        abortListener = resolve;\n        abortSignal.addEventListener(\"abort\", abortListener, { once: true });\n      })\n    : undefined;\n  try {\n    await Promise.race([\n      job.promise,\n      ...(abortPromise ? [abortPromise] : []),\n      new Promise<void>((resolve) => {\n        timeoutId = setTimeout(resolve, timeoutMs);\n      }),\n    ]);\n  } finally {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n    if (abortListener) {\n      abortSignal?.removeEventListener(\"abort\", abortListener);\n    }\n  }\n}\n"],"mappings":";;;AAQA,SAAgB,2BAA2B,MAAgC;CACzE,OAAO,KAA8D;EACnE,aAAa;EACb,SAAS,OAAO,OAA8B,EAAE,kBAAkB;GAChE,uBAAuB,MAAM,SAAS,mBAAmB;GACzD,MAAM,MAAM,KAAK,IAAI,MAAM,OAAO;GAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,oCAAoC,MAAM,QAAQ,EAAE;GAGtE,IAAI,MAAM,UAAU,QAAQ,YAAY,IAAI,MAAM,GAChD,MAAM,WAAW,KAAK,MAAM,SAAS,WAAW;GAGlD,MAAM,SAAS;IACb,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,SAAS,IAAI;GACf;GACA,IAAI,EAAE,YAAY,IAAI,MAAM,KAAK,CAAC,IAAI;QAKhC,MAJkB,WAAW,GAAG,EAAE,WAC9B,YACA,KACR,GAEE,KAAK,OAAO,IAAI,EAAE;GAAA;GAItB,OAAO;EACT;EACA,aAAa,WAAkC;GAC7C,sBAAsB;GACtB,YAAY;IACV,OAAO,EAAE,MAAM,UAAU;IACzB,SAAS,EAAE,MAAM,SAAS;IAC1B,SAAS;KAAE,SAAS;KAAG,MAAM;IAAS;GACxC;GACA,UAAU,CAAC,SAAS;GACpB,MAAM;EACR,CAAC;CACH,CAAC;AACH;AAEA,eAAe,WACb,KACA,SACA,aACA;CACA,IAAI,aAAa,SACf;CAGF,MAAM,YAAY,KAAK,IAAI,WAAW,KAAQ,GAAO;CACrD,IAAI;CACJ,IAAI;CACJ,MAAM,eAAe,cACjB,IAAI,SAAe,YAAY;EAC7B,gBAAgB;EAChB,YAAY,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;CACrE,CAAC,IACD,KAAA;CACJ,IAAI;EACF,MAAM,QAAQ,KAAK;GACjB,IAAI;GACJ,GAAI,eAAe,CAAC,YAAY,IAAI,CAAC;GACrC,IAAI,SAAe,YAAY;IAC7B,YAAY,WAAW,SAAS,SAAS;GAC3C,CAAC;EACH,CAAC;CACH,UAAU;EACR,IAAI,WACF,aAAa,SAAS;EAExB,IAAI,eACF,aAAa,oBAAoB,SAAS,aAAa;CAE3D;AACF"}

package/dist/subagent-jobs.js

@@ -0,0 +1,151 @@
+import { collectSubagentRunWithEvents } from "./subagent-run.js";
+//#region src/subagent-jobs.ts
+const maxBackgroundJobs = 64;
+const maxRetainedBackgroundJobs = maxBackgroundJobs * 4;
+function startBackgroundJob({ abortSignal, description, jobs, parentSession, prompt, registerCleanup, sessionKey, subagent }) {
+	const id = `bg_${crypto.randomUUID().replaceAll("-", "")}`;
+	const childSessionKey = `${sessionKey}:task:${id}`;
+	if (!hasJobCapacity(jobs)) return {
+		message: "Background subagent job was not started because the background job limit is full.",
+		run_in_background: true,
+		status: "cancelled",
+		subagent: subagent.name,
+		task_id: id
+	};
+	if (abortSignal.aborted) return {
+		message: `Background subagent job ${id} was cancelled before it started.`,
+		run_in_background: true,
+		status: "cancelled",
+		subagent: subagent.name,
+		task_id: id
+	};
+	const childSession = subagent.session(childSessionKey);
+	const abort = () => childSession.interrupt();
+	abortSignal.addEventListener("abort", abort, { once: true });
+	const cleanup = () => childSession.delete();
+	const unregisterCleanup = registerCleanup(cleanup);
+	const job = {
+		abort,
+		cleanup,
+		description,
+		id,
+		promise: Promise.resolve(),
+		sessionKey: childSessionKey,
+		settled: false,
+		status: "pending",
+		subagent: subagent.name ?? "subagent",
+		unregisterCleanup
+	};
+	job.promise = runBackgroundJob({
+		childSession,
+		job,
+		parentSession,
+		prompt
+	}).finally(() => {
+		abortSignal.removeEventListener("abort", abort);
+		job.settled = true;
+	});
+	jobs.set(id, job);
+	parentSession.emitObserverEvent({
+		description,
+		run_in_background: true,
+		subagent: subagent.name ?? "subagent",
+		task_id: id,
+		type: "subagent-job-start"
+	});
+	return {
+		message: `Background subagent job ${id} started. Use background_output({ task_id: "${id}" }) to retrieve the result.`,
+		run_in_background: true,
+		status: job.status,
+		subagent: subagent.name,
+		task_id: id
+	};
+}
+async function runBackgroundJob({ childSession, job, parentSession, prompt }) {
+	if (job.status === "cancelled") return;
+	job.status = "running";
+	try {
+		const { result } = await collectSubagentRunWithEvents(await childSession.send(prompt), job.subagent, (event) => emitJobUpdate(parentSession, job, event));
+		if (isCancelledJob(job)) return;
+		job.result = result;
+		job.status = result.result;
+	} catch (error) {
+		if (isCancelledJob(job)) return;
+		const jobError = error instanceof Error ? error : new Error(String(error));
+		job.status = "error";
+		job.result = {
+			error: errorMessage(jobError),
+			eventCount: 0,
+			result: "error",
+			run_in_background: false,
+			subagent: job.subagent,
+			text: ""
+		};
+	}
+	if (isCancelledJob(job)) return;
+	parentSession.enqueueRuntimeInput({
+		text: [
+			"<system-reminder>",
+			"[SUBAGENT JOB RESULT READY]",
+			`Task ID: ${job.id}`,
+			`Subagent: ${job.subagent}`,
+			`Description: ${sanitizeReminderField(job.description ?? "")}`,
+			`Use background_output({ task_id: "${job.id}" }) to retrieve the result.`,
+			"</system-reminder>"
+		].join("\n"),
+		type: "user-text"
+	}, "turn-start");
+	parentSession.emitObserverEvent({
+		error: job.result?.error,
+		eventCount: job.result?.eventCount ?? 0,
+		status: job.result?.result ?? "error",
+		subagent: job.subagent,
+		task_id: job.id,
+		type: "subagent-job-end"
+	});
+}
+function emitJobUpdate(parentSession, job, event) {
+	parentSession.emitObserverEvent({
+		eventType: event.type,
+		status: job.status,
+		subagent: job.subagent,
+		task_id: job.id,
+		type: "subagent-job-update"
+	});
+}
+function assertBackgroundTaskId(value, toolName) {
+	if (value.startsWith("bg_")) return;
+	throw new Error(`${toolName} expects a background task_id starting with bg_, not a session key: ${value}`);
+}
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+function isActiveJob(status) {
+	return status === "pending" || status === "running";
+}
+function isCancelledJob(job) {
+	return job.status === "cancelled";
+}
+function hasJobCapacity(jobs) {
+	if (jobs.size >= maxRetainedBackgroundJobs) return false;
+	let activeJobs = 0;
+	for (const job of jobs.values()) if (isActiveJob(job.status) || !job.settled) activeJobs += 1;
+	return activeJobs < maxBackgroundJobs;
+}
+function cancelJob(job) {
+	job.status = "cancelled";
+	job.abort();
+}
+function cleanupJob(job) {
+	return job.cleanup().then(() => {
+		job.unregisterCleanup?.();
+	});
+}
+function sanitizeReminderField(value) {
+	return value.replaceAll("\r", " ").replaceAll("\n", " ").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+//#endregion
+export { assertBackgroundTaskId, cancelJob, cleanupJob, isActiveJob, startBackgroundJob };
+
+//# sourceMappingURL=subagent-jobs.js.map

package/dist/subagent-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-jobs.js","names":[],"sources":["../src/subagent-jobs.ts"],"sourcesContent":["import type { AgentEvent } from \"./session/events\";\nimport type { AgentInput } from \"./session/input\";\nimport { collectSubagentRunWithEvents } from \"./subagent-run\";\nimport type { RuntimeInputSink, Subagent, SubagentJob } from \"./subagent-types\";\n\nconst maxBackgroundJobs = 64;\nconst maxRetainedBackgroundJobs = maxBackgroundJobs * 4;\n\nexport function startBackgroundJob({\n  abortSignal,\n  description,\n  jobs,\n  parentSession,\n  prompt,\n  registerCleanup,\n  sessionKey,\n  subagent,\n}: {\n  readonly abortSignal: AbortSignal;\n  readonly description?: string;\n  readonly jobs: Map<string, SubagentJob>;\n  readonly parentSession: RuntimeInputSink;\n  readonly prompt: AgentInput;\n  readonly registerCleanup: (cleanup: () => Promise<void>) => () => void;\n  readonly sessionKey: string;\n  readonly subagent: Subagent;\n}) {\n  const id = `bg_${crypto.randomUUID().replaceAll(\"-\", \"\")}`;\n  const childSessionKey = `${sessionKey}:task:${id}`;\n  if (!hasJobCapacity(jobs)) {\n    return {\n      message:\n        \"Background subagent job was not started because the background job limit is full.\",\n      run_in_background: true,\n      status: \"cancelled\",\n      subagent: subagent.name,\n      task_id: id,\n    };\n  }\n\n  if (abortSignal.aborted) {\n    return {\n      message: `Background subagent job ${id} was cancelled before it started.`,\n      run_in_background: true,\n      status: \"cancelled\",\n      subagent: subagent.name,\n      task_id: id,\n    };\n  }\n\n  const childSession = subagent.session(childSessionKey);\n  const abort = () => childSession.interrupt();\n  abortSignal.addEventListener(\"abort\", abort, { once: true });\n  const cleanup = () => childSession.delete();\n  const unregisterCleanup = registerCleanup(cleanup);\n\n  const job: SubagentJob = {\n    abort,\n    cleanup,\n    description,\n    id,\n    promise: Promise.resolve(),\n    sessionKey: childSessionKey,\n    settled: false,\n    status: \"pending\",\n    subagent: subagent.name ?? \"subagent\",\n    unregisterCleanup,\n  };\n  job.promise = runBackgroundJob({\n    childSession,\n    job,\n    parentSession,\n    prompt,\n  }).finally(() => {\n    abortSignal.removeEventListener(\"abort\", abort);\n    job.settled = true;\n  });\n  jobs.set(id, job);\n  parentSession.emitObserverEvent({\n    description,\n    run_in_background: true,\n    subagent: subagent.name ?? \"subagent\",\n    task_id: id,\n    type: \"subagent-job-start\",\n  });\n\n  return {\n    message: `Background subagent job ${id} started. Use background_output({ task_id: \"${id}\" }) to retrieve the result.`,\n    run_in_background: true,\n    status: job.status,\n    subagent: subagent.name,\n    task_id: id,\n  };\n}\n\nasync function runBackgroundJob({\n  childSession,\n  job,\n  parentSession,\n  prompt,\n}: {\n  readonly childSession: ReturnType<Subagent[\"session\"]>;\n  readonly job: SubagentJob;\n  readonly parentSession: RuntimeInputSink;\n  readonly prompt: AgentInput;\n}): Promise<void> {\n  if (job.status === \"cancelled\") {\n    return;\n  }\n\n  job.status = \"running\";\n  try {\n    const { result } = await collectSubagentRunWithEvents(\n      await childSession.send(prompt),\n      job.subagent,\n      (event) => emitJobUpdate(parentSession, job, event)\n    );\n    if (isCancelledJob(job)) {\n      return;\n    }\n    job.result = result;\n    job.status = result.result;\n  } catch (error) {\n    if (isCancelledJob(job)) {\n      return;\n    }\n    const jobError = error instanceof Error ? error : new Error(String(error));\n    job.status = \"error\";\n    job.result = {\n      error: errorMessage(jobError),\n      eventCount: 0,\n      result: \"error\",\n      run_in_background: false,\n      subagent: job.subagent,\n      text: \"\",\n    };\n  }\n\n  if (isCancelledJob(job)) {\n    return;\n  }\n\n  parentSession.enqueueRuntimeInput(\n    {\n      text: [\n        \"<system-reminder>\",\n        \"[SUBAGENT JOB RESULT READY]\",\n        `Task ID: ${job.id}`,\n        `Subagent: ${job.subagent}`,\n        `Description: ${sanitizeReminderField(job.description ?? \"\")}`,\n        `Use background_output({ task_id: \"${job.id}\" }) to retrieve the result.`,\n        \"</system-reminder>\",\n      ].join(\"\\n\"),\n      type: \"user-text\",\n    },\n    \"turn-start\"\n  );\n  parentSession.emitObserverEvent({\n    error: job.result?.error,\n    eventCount: job.result?.eventCount ?? 0,\n    status: job.result?.result ?? \"error\",\n    subagent: job.subagent,\n    task_id: job.id,\n    type: \"subagent-job-end\",\n  });\n}\n\nfunction emitJobUpdate(\n  parentSession: RuntimeInputSink,\n  job: SubagentJob,\n  event: AgentEvent\n): void {\n  parentSession.emitObserverEvent({\n    eventType: event.type,\n    status: job.status,\n    subagent: job.subagent,\n    task_id: job.id,\n    type: \"subagent-job-update\" as const,\n  });\n}\n\nexport function assertBackgroundTaskId(value: string, toolName: string): void {\n  if (value.startsWith(\"bg_\")) {\n    return;\n  }\n\n  throw new Error(\n    `${toolName} expects a background task_id starting with bg_, not a session key: ${value}`\n  );\n}\n\nfunction errorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\nexport function isActiveJob(status: SubagentJob[\"status\"]): boolean {\n  return status === \"pending\" || status === \"running\";\n}\n\nfunction isCancelledJob(job: SubagentJob): boolean {\n  return job.status === \"cancelled\";\n}\n\nfunction hasJobCapacity(jobs: Map<string, SubagentJob>): boolean {\n  if (jobs.size >= maxRetainedBackgroundJobs) {\n    return false;\n  }\n\n  let activeJobs = 0;\n  for (const job of jobs.values()) {\n    if (isActiveJob(job.status) || !job.settled) {\n      activeJobs += 1;\n    }\n  }\n\n  return activeJobs < maxBackgroundJobs;\n}\n\nexport function cancelJob(job: SubagentJob): void {\n  job.status = \"cancelled\";\n  job.abort();\n}\n\nexport function cleanupJob(job: SubagentJob): Promise<void> {\n  return job.cleanup().then(() => {\n    job.unregisterCleanup?.();\n  });\n}\n\nfunction sanitizeReminderField(value: string): string {\n  return value\n    .replaceAll(\"\\r\", \" \")\n    .replaceAll(\"\\n\", \" \")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\");\n}\n"],"mappings":"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"}

package/dist/subagent-prompt-schema.js

@@ -0,0 +1,114 @@
+//#region src/subagent-prompt-schema.ts
+const contentArraySchema = {
+	items: { anyOf: [
+		{
+			additionalProperties: false,
+			properties: {
+				text: { type: "string" },
+				type: { const: "text" }
+			},
+			required: ["type", "text"],
+			type: "object"
+		},
+		{
+			additionalProperties: false,
+			properties: {
+				image: { type: "string" },
+				mediaType: { type: "string" },
+				type: { const: "image" }
+			},
+			required: ["type", "image"],
+			type: "object"
+		},
+		{
+			additionalProperties: false,
+			properties: {
+				data: { anyOf: [
+					{ type: "string" },
+					{
+						additionalProperties: false,
+						properties: {
+							data: { type: "string" },
+							type: { const: "data" }
+						},
+						required: ["type", "data"],
+						type: "object"
+					},
+					{
+						additionalProperties: false,
+						properties: {
+							reference: {
+								additionalProperties: { type: "string" },
+								type: "object"
+							},
+							type: { const: "reference" }
+						},
+						required: ["type", "reference"],
+						type: "object"
+					},
+					{
+						additionalProperties: false,
+						properties: {
+							text: { type: "string" },
+							type: { const: "text" }
+						},
+						required: ["type", "text"],
+						type: "object"
+					},
+					{
+						additionalProperties: false,
+						properties: {
+							type: { const: "url" },
+							url: { type: "string" }
+						},
+						required: ["type", "url"],
+						type: "object"
+					}
+				] },
+				filename: { type: "string" },
+				mediaType: { type: "string" },
+				type: { const: "file" }
+			},
+			required: [
+				"type",
+				"data",
+				"mediaType"
+			],
+			type: "object"
+		}
+	] },
+	type: "array"
+};
+const delegatePromptSchema = { anyOf: [
+	{ type: "string" },
+	{
+		items: { type: "string" },
+		type: "array"
+	},
+	{
+		additionalProperties: false,
+		properties: {
+			text: { anyOf: [{ type: "string" }, {
+				items: { type: "string" },
+				type: "array"
+			}] },
+			type: { const: "user-text" }
+		},
+		required: ["type", "text"],
+		type: "object"
+	},
+	{
+		additionalProperties: false,
+		properties: {
+			content: contentArraySchema,
+			type: { const: "user-message" }
+		},
+		required: ["type", "content"],
+		type: "object"
+	},
+	contentArraySchema
+] };
+//#endregion
+export { delegatePromptSchema };
+
+//# sourceMappingURL=subagent-prompt-schema.js.map

package/dist/subagent-prompt-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-prompt-schema.js","names":[],"sources":["../src/subagent-prompt-schema.ts"],"sourcesContent":["const fileDataSchema = {\n  anyOf: [\n    { type: \"string\" },\n    {\n      additionalProperties: false,\n      properties: {\n        data: { type: \"string\" },\n        type: { const: \"data\" },\n      },\n      required: [\"type\", \"data\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        reference: {\n          additionalProperties: { type: \"string\" },\n          type: \"object\",\n        },\n        type: { const: \"reference\" },\n      },\n      required: [\"type\", \"reference\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        text: { type: \"string\" },\n        type: { const: \"text\" },\n      },\n      required: [\"type\", \"text\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        type: { const: \"url\" },\n        url: { type: \"string\" },\n      },\n      required: [\"type\", \"url\"],\n      type: \"object\",\n    },\n  ],\n};\n\nconst contentPartSchema = {\n  anyOf: [\n    {\n      additionalProperties: false,\n      properties: {\n        text: { type: \"string\" },\n        type: { const: \"text\" },\n      },\n      required: [\"type\", \"text\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        image: { type: \"string\" },\n        mediaType: { type: \"string\" },\n        type: { const: \"image\" },\n      },\n      required: [\"type\", \"image\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        data: fileDataSchema,\n        filename: { type: \"string\" },\n        mediaType: { type: \"string\" },\n        type: { const: \"file\" },\n      },\n      required: [\"type\", \"data\", \"mediaType\"],\n      type: \"object\",\n    },\n  ],\n};\n\nconst contentArraySchema = {\n  items: contentPartSchema,\n  type: \"array\",\n};\n\nexport const delegatePromptSchema = {\n  anyOf: [\n    { type: \"string\" },\n    { items: { type: \"string\" }, type: \"array\" },\n    {\n      additionalProperties: false,\n      properties: {\n        text: {\n          anyOf: [\n            { type: \"string\" },\n            { items: { type: \"string\" }, type: \"array\" },\n          ],\n        },\n        type: { const: \"user-text\" },\n      },\n      required: [\"type\", \"text\"],\n      type: \"object\",\n    },\n    {\n      additionalProperties: false,\n      properties: {\n        content: contentArraySchema,\n        type: { const: \"user-message\" },\n      },\n      required: [\"type\", \"content\"],\n      type: \"object\",\n    },\n    contentArraySchema,\n  ],\n};\n"],"mappings":";AAgFA,MAAM,qBAAqB;CACzB,OAAO,EAnCP,OAAO;EACL;GACE,sBAAsB;GACtB,YAAY;IACV,MAAM,EAAE,MAAM,SAAS;IACvB,MAAM,EAAE,OAAO,OAAO;GACxB;GACA,UAAU,CAAC,QAAQ,MAAM;GACzB,MAAM;EACR;EACA;GACE,sBAAsB;GACtB,YAAY;IACV,OAAO,EAAE,MAAM,SAAS;IACxB,WAAW,EAAE,MAAM,SAAS;IAC5B,MAAM,EAAE,OAAO,QAAQ;GACzB;GACA,UAAU,CAAC,QAAQ,OAAO;GAC1B,MAAM;EACR;EACA;GACE,sBAAsB;GACtB,YAAY;IACV,MAAM,EApEZ,OAAO;KACL,EAAE,MAAM,SAAS;KACjB;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,MAAM,SAAS;OACvB,MAAM,EAAE,OAAO,OAAO;MACxB;MACA,UAAU,CAAC,QAAQ,MAAM;MACzB,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,WAAW;QACT,sBAAsB,EAAE,MAAM,SAAS;QACvC,MAAM;OACR;OACA,MAAM,EAAE,OAAO,YAAY;MAC7B;MACA,UAAU,CAAC,QAAQ,WAAW;MAC9B,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,MAAM,SAAS;OACvB,MAAM,EAAE,OAAO,OAAO;MACxB;MACA,UAAU,CAAC,QAAQ,MAAM;MACzB,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,OAAO,MAAM;OACrB,KAAK,EAAE,MAAM,SAAS;MACxB;MACA,UAAU,CAAC,QAAQ,KAAK;MACxB,MAAM;KACR;IACF,EA2ByB;IACnB,UAAU,EAAE,MAAM,SAAS;IAC3B,WAAW,EAAE,MAAM,SAAS;IAC5B,MAAM,EAAE,OAAO,OAAO;GACxB;GACA,UAAU;IAAC;IAAQ;IAAQ;GAAW;GACtC,MAAM;EACR;CACF,EAIuB;CACvB,MAAM;AACR;AAEA,MAAa,uBAAuB,EAClC,OAAO;CACL,EAAE,MAAM,SAAS;CACjB;EAAE,OAAO,EAAE,MAAM,SAAS;EAAG,MAAM;CAAQ;CAC3C;EACE,sBAAsB;EACtB,YAAY;GACV,MAAM,EACJ,OAAO,CACL,EAAE,MAAM,SAAS,GACjB;IAAE,OAAO,EAAE,MAAM,SAAS;IAAG,MAAM;GAAQ,CAC7C,EACF;GACA,MAAM,EAAE,OAAO,YAAY;EAC7B;EACA,UAAU,CAAC,QAAQ,MAAM;EACzB,MAAM;CACR;CACA;EACE,sBAAsB;EACtB,YAAY;GACV,SAAS;GACT,MAAM,EAAE,OAAO,eAAe;EAChC;EACA,UAAU,CAAC,QAAQ,SAAS;EAC5B,MAAM;CACR;CACA;AACF,EACF"}

package/dist/subagent-run.js

@@ -0,0 +1,111 @@
+//#region src/subagent-run.ts
+const maxCompactTextLength = 2e4;
+const maxStoredEvents = 200;
+const childSessionKeySuffixPattern = /^[A-Za-z0-9_-]{1,80}$/;
+async function runBlockingDelegation({ abortSignal, prompt, sessionKey, subagent }) {
+	const childSession = subagent.session(sessionKey);
+	if (abortSignal?.aborted) return {
+		eventCount: 0,
+		result: "aborted",
+		run_in_background: false,
+		subagent: subagent.name ?? "subagent",
+		text: ""
+	};
+	const abort = () => childSession.interrupt();
+	abortSignal?.addEventListener("abort", abort, { once: true });
+	try {
+		return await collectSubagentRun(await childSession.send(prompt), subagent.name ?? "subagent");
+	} finally {
+		abortSignal?.removeEventListener("abort", abort);
+	}
+}
+async function collectSubagentRun(run, subagent) {
+	return (await collectSubagentRunWithEvents(run, subagent)).result;
+}
+async function collectSubagentRunWithEvents(run, subagent, onEvent) {
+	let eventCount = 0;
+	let result = "completed";
+	const events = [];
+	const textParts = [];
+	let textLength = 0;
+	let textTruncated = false;
+	try {
+		for await (const event of run.events()) {
+			eventCount += 1;
+			if (events.length < maxStoredEvents) events.push(event);
+			onEvent?.(event);
+			if (event.type === "assistant-text") {
+				const appended = appendCompactText(textParts, textLength, event.text);
+				textLength = appended.length;
+				textTruncated ||= appended.truncated;
+			} else if (event.type === "turn-abort") result = "aborted";
+			else if (event.type === "turn-error") return {
+				events,
+				result: {
+					error: event.message,
+					eventCount,
+					result: "error",
+					run_in_background: false,
+					subagent,
+					text: compactText(textParts, textTruncated)
+				}
+			};
+		}
+	} catch (error) {
+		return {
+			events,
+			result: {
+				error: errorMessage(error),
+				eventCount,
+				result: "error",
+				run_in_background: false,
+				subagent,
+				text: compactText(textParts, textTruncated)
+			}
+		};
+	}
+	return {
+		events,
+		result: {
+			eventCount,
+			result,
+			run_in_background: false,
+			subagent,
+			text: compactText(textParts, textTruncated)
+		}
+	};
+}
+function defaultChildSessionKey(parentAgentNamespace, parentSessionKey, subagent) {
+	return `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:${subagent}`;
+}
+function scopedChildSessionKey({ parentAgentNamespace, parentSessionKey, sessionKey, subagent }) {
+	const base = defaultChildSessionKey(parentAgentNamespace, parentSessionKey, subagent);
+	if (!sessionKey) return base;
+	if (!childSessionKeySuffixPattern.test(sessionKey)) throw new Error("delegate sessionKey must be a short alphanumeric child-session suffix");
+	return `${base}:${sessionKey}`;
+}
+function compactText(parts, truncated) {
+	const text = parts.join("");
+	return truncated ? `${text}…[truncated]` : text;
+}
+function appendCompactText(parts, currentLength, next) {
+	if (currentLength >= maxCompactTextLength) return {
+		length: currentLength,
+		truncated: next.length > 0
+	};
+	const remaining = maxCompactTextLength - currentLength;
+	const chunk = next.length > remaining ? next.slice(0, remaining) : next;
+	parts.push(chunk);
+	return {
+		length: currentLength + chunk.length,
+		truncated: next.length > remaining
+	};
+}
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+//#endregion
+export { collectSubagentRunWithEvents, runBlockingDelegation, scopedChildSessionKey };
+
+//# sourceMappingURL=subagent-run.js.map

package/dist/subagent-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-run.js","names":[],"sources":["../src/subagent-run.ts"],"sourcesContent":["import type { AgentEvent } from \"./session/events\";\nimport type { AgentInput } from \"./session/input\";\nimport type { AgentRun } from \"./session/run\";\nimport type {\n  CompactSubagentResult,\n  Subagent,\n  SubagentRunResult,\n} from \"./subagent-types\";\n\nconst maxCompactTextLength = 20_000;\nconst maxStoredEvents = 200;\nconst childSessionKeySuffixPattern = /^[A-Za-z0-9_-]{1,80}$/;\n\nexport async function runBlockingDelegation({\n  abortSignal,\n  prompt,\n  sessionKey,\n  subagent,\n}: {\n  readonly abortSignal?: AbortSignal;\n  readonly prompt: AgentInput;\n  readonly sessionKey: string;\n  readonly subagent: Subagent;\n}): Promise<CompactSubagentResult> {\n  const childSession = subagent.session(sessionKey);\n  if (abortSignal?.aborted) {\n    return {\n      eventCount: 0,\n      result: \"aborted\",\n      run_in_background: false,\n      subagent: subagent.name ?? \"subagent\",\n      text: \"\",\n    };\n  }\n\n  const abort = () => childSession.interrupt();\n  abortSignal?.addEventListener(\"abort\", abort, { once: true });\n  try {\n    return await collectSubagentRun(\n      await childSession.send(prompt),\n      subagent.name ?? \"subagent\"\n    );\n  } finally {\n    abortSignal?.removeEventListener(\"abort\", abort);\n  }\n}\n\nexport async function collectSubagentRun(\n  run: AgentRun,\n  subagent: string\n): Promise<CompactSubagentResult> {\n  return (await collectSubagentRunWithEvents(run, subagent)).result;\n}\n\nexport async function collectSubagentRunWithEvents(\n  run: AgentRun,\n  subagent: string,\n  onEvent?: (event: AgentEvent) => void\n): Promise<SubagentRunResult> {\n  let eventCount = 0;\n  let result: CompactSubagentResult[\"result\"] = \"completed\";\n  const events: AgentEvent[] = [];\n  const textParts: string[] = [];\n  let textLength = 0;\n  let textTruncated = false;\n\n  try {\n    for await (const event of run.events()) {\n      eventCount += 1;\n      if (events.length < maxStoredEvents) {\n        events.push(event);\n      }\n      onEvent?.(event);\n      if (event.type === \"assistant-text\") {\n        const appended = appendCompactText(textParts, textLength, event.text);\n        textLength = appended.length;\n        textTruncated ||= appended.truncated;\n      } else if (event.type === \"turn-abort\") {\n        result = \"aborted\";\n      } else if (event.type === \"turn-error\") {\n        return {\n          events,\n          result: {\n            error: event.message,\n            eventCount,\n            result: \"error\",\n            run_in_background: false,\n            subagent,\n            text: compactText(textParts, textTruncated),\n          },\n        };\n      }\n    }\n  } catch (error) {\n    return {\n      events,\n      result: {\n        error: errorMessage(error),\n        eventCount,\n        result: \"error\",\n        run_in_background: false,\n        subagent,\n        text: compactText(textParts, textTruncated),\n      },\n    };\n  }\n\n  return {\n    events,\n    result: {\n      eventCount,\n      result,\n      run_in_background: false,\n      subagent,\n      text: compactText(textParts, textTruncated),\n    },\n  };\n}\n\nexport function defaultChildSessionKey(\n  parentAgentNamespace: string,\n  parentSessionKey: string,\n  subagent: string\n): string {\n  return `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:${subagent}`;\n}\n\nexport function scopedChildSessionKey({\n  parentAgentNamespace,\n  parentSessionKey,\n  sessionKey,\n  subagent,\n}: {\n  readonly parentAgentNamespace: string;\n  readonly parentSessionKey: string;\n  readonly sessionKey?: string;\n  readonly subagent: string;\n}): string {\n  const base = defaultChildSessionKey(\n    parentAgentNamespace,\n    parentSessionKey,\n    subagent\n  );\n  if (!sessionKey) {\n    return base;\n  }\n\n  if (!childSessionKeySuffixPattern.test(sessionKey)) {\n    throw new Error(\n      \"delegate sessionKey must be a short alphanumeric child-session suffix\"\n    );\n  }\n\n  return `${base}:${sessionKey}`;\n}\n\nfunction compactText(parts: readonly string[], truncated: boolean): string {\n  const text = parts.join(\"\");\n  return truncated ? `${text}…[truncated]` : text;\n}\n\nfunction appendCompactText(\n  parts: string[],\n  currentLength: number,\n  next: string\n): { readonly length: number; readonly truncated: boolean } {\n  if (currentLength >= maxCompactTextLength) {\n    return { length: currentLength, truncated: next.length > 0 };\n  }\n\n  const remaining = maxCompactTextLength - currentLength;\n  const chunk = next.length > remaining ? next.slice(0, remaining) : next;\n  parts.push(chunk);\n  return {\n    length: currentLength + chunk.length,\n    truncated: next.length > remaining,\n  };\n}\n\nfunction errorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n"],"mappings":";AASA,MAAM,uBAAuB;AAC7B,MAAM,kBAAkB;AACxB,MAAM,+BAA+B;AAErC,eAAsB,sBAAsB,EAC1C,aACA,QACA,YACA,YAMiC;CACjC,MAAM,eAAe,SAAS,QAAQ,UAAU;CAChD,IAAI,aAAa,SACf,OAAO;EACL,YAAY;EACZ,QAAQ;EACR,mBAAmB;EACnB,UAAU,SAAS,QAAQ;EAC3B,MAAM;CACR;CAGF,MAAM,cAAc,aAAa,UAAU;CAC3C,aAAa,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;CAC5D,IAAI;EACF,OAAO,MAAM,mBACX,MAAM,aAAa,KAAK,MAAM,GAC9B,SAAS,QAAQ,UACnB;CACF,UAAU;EACR,aAAa,oBAAoB,SAAS,KAAK;CACjD;AACF;AAEA,eAAsB,mBACpB,KACA,UACgC;CAChC,QAAQ,MAAM,6BAA6B,KAAK,QAAQ,GAAG;AAC7D;AAEA,eAAsB,6BACpB,KACA,UACA,SAC4B;CAC5B,IAAI,aAAa;CACjB,IAAI,SAA0C;CAC9C,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAAsB,CAAC;CAC7B,IAAI,aAAa;CACjB,IAAI,gBAAgB;CAEpB,IAAI;EACF,WAAW,MAAM,SAAS,IAAI,OAAO,GAAG;GACtC,cAAc;GACd,IAAI,OAAO,SAAS,iBAClB,OAAO,KAAK,KAAK;GAEnB,UAAU,KAAK;GACf,IAAI,MAAM,SAAS,kBAAkB;IACnC,MAAM,WAAW,kBAAkB,WAAW,YAAY,MAAM,IAAI;IACpE,aAAa,SAAS;IACtB,kBAAkB,SAAS;GAC7B,OAAO,IAAI,MAAM,SAAS,cACxB,SAAS;QACJ,IAAI,MAAM,SAAS,cACxB,OAAO;IACL;IACA,QAAQ;KACN,OAAO,MAAM;KACb;KACA,QAAQ;KACR,mBAAmB;KACnB;KACA,MAAM,YAAY,WAAW,aAAa;IAC5C;GACF;EAEJ;CACF,SAAS,OAAO;EACd,OAAO;GACL;GACA,QAAQ;IACN,OAAO,aAAa,KAAK;IACzB;IACA,QAAQ;IACR,mBAAmB;IACnB;IACA,MAAM,YAAY,WAAW,aAAa;GAC5C;EACF;CACF;CAEA,OAAO;EACL;EACA,QAAQ;GACN;GACA;GACA,mBAAmB;GACnB;GACA,MAAM,YAAY,WAAW,aAAa;EAC5C;CACF;AACF;AAEA,SAAgB,uBACd,sBACA,kBACA,UACQ;CACR,OAAO,UAAU,qBAAqB,GAAG,iBAAiB,YAAY;AACxE;AAEA,SAAgB,sBAAsB,EACpC,sBACA,kBACA,YACA,YAMS;CACT,MAAM,OAAO,uBACX,sBACA,kBACA,QACF;CACA,IAAI,CAAC,YACH,OAAO;CAGT,IAAI,CAAC,6BAA6B,KAAK,UAAU,GAC/C,MAAM,IAAI,MACR,uEACF;CAGF,OAAO,GAAG,KAAK,GAAG;AACpB;AAEA,SAAS,YAAY,OAA0B,WAA4B;CACzE,MAAM,OAAO,MAAM,KAAK,EAAE;CAC1B,OAAO,YAAY,GAAG,KAAK,gBAAgB;AAC7C;AAEA,SAAS,kBACP,OACA,eACA,MAC0D;CAC1D,IAAI,iBAAiB,sBACnB,OAAO;EAAE,QAAQ;EAAe,WAAW,KAAK,SAAS;CAAE;CAG7D,MAAM,YAAY,uBAAuB;CACzC,MAAM,QAAQ,KAAK,SAAS,YAAY,KAAK,MAAM,GAAG,SAAS,IAAI;CACnE,MAAM,KAAK,KAAK;CAChB,OAAO;EACL,QAAQ,gBAAgB,MAAM;EAC9B,WAAW,KAAK,SAAS;CAC3B;AACF;AAEA,SAAS,aAAa,OAAwB;CAC5C,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,KAAK;AACrB"}

package/dist/subagents.js

@@ -0,0 +1,92 @@
+import { normalizeAgentInput } from "./session/input-normalization.js";
+import { runBlockingDelegation, scopedChildSessionKey } from "./subagent-run.js";
+import { startBackgroundJob } from "./subagent-jobs.js";
+import { createBackgroundCancelTool } from "./subagent-job-cancel.js";
+import { createBackgroundOutputTool } from "./subagent-job-output.js";
+import { delegatePromptSchema } from "./subagent-prompt-schema.js";
+import { jsonSchema, tool } from "ai";
+//#region src/subagents.ts
+function createSubagentTools({ parentAgentNamespace, parentSession, parentSessionKey, registerChildSession, subagents }) {
+	if (subagents.length === 0) return {};
+	const jobs = /* @__PURE__ */ new Map();
+	const generatedTools = {
+		background_cancel: createBackgroundCancelTool(jobs),
+		background_output: createBackgroundOutputTool(jobs)
+	};
+	for (const subagent of subagents) {
+		const name = subagent.name;
+		if (!name) continue;
+		generatedTools[`delegate_to_${name.replaceAll("-", "_")}`] = createDelegateTool({
+			jobs,
+			parentAgentNamespace,
+			parentSession,
+			parentSessionKey,
+			registerChildSession,
+			subagent
+		});
+	}
+	return generatedTools;
+}
+function createDelegateTool({ jobs, parentAgentNamespace, parentSession, parentSessionKey, registerChildSession, subagent }) {
+	return tool({
+		description: `Delegate work to ${subagent.name}: ${subagent.description}`,
+		execute: async (input, { abortSignal }) => {
+			const prompt = normalizeAgentInput(input.prompt);
+			const sessionKey = scopedChildSessionKey({
+				parentAgentNamespace,
+				parentSessionKey,
+				sessionKey: input.sessionKey,
+				subagent: subagent.name ?? "subagent"
+			});
+			if (input.run_in_background === true) return startBackgroundJob({
+				abortSignal: abortSignal ?? new AbortController().signal,
+				description: input.description,
+				jobs,
+				parentSession,
+				prompt,
+				registerCleanup: (cleanup) => registerChildSession(parentSessionKey, cleanup),
+				sessionKey,
+				subagent
+			});
+			registerChildSession(parentSessionKey, () => subagent.session(sessionKey).delete());
+			parentSession.emitObserverEvent({
+				description: input.description,
+				run_in_background: false,
+				subagent: subagent.name ?? "subagent",
+				type: "subagent-job-start"
+			});
+			const result = await runBlockingDelegation({
+				abortSignal,
+				prompt,
+				sessionKey,
+				subagent
+			});
+			parentSession.emitObserverEvent({
+				error: result.error,
+				eventCount: result.eventCount,
+				status: result.result,
+				subagent: subagent.name ?? "subagent",
+				type: "subagent-job-end"
+			});
+			return result;
+		},
+		inputSchema: jsonSchema({
+			additionalProperties: false,
+			properties: {
+				description: { type: "string" },
+				prompt: delegatePromptSchema,
+				run_in_background: {
+					default: false,
+					type: "boolean"
+				},
+				sessionKey: { type: "string" }
+			},
+			required: ["prompt"],
+			type: "object"
+		})
+	});
+}
+//#endregion
+export { createSubagentTools };
+
+//# sourceMappingURL=subagents.js.map

package/dist/subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","names":[],"sources":["../src/subagents.ts"],"sourcesContent":["import { jsonSchema, type ToolSet, tool } from \"ai\";\nimport { normalizeAgentInput } from \"./session/input-normalization\";\nimport { createBackgroundCancelTool } from \"./subagent-job-cancel\";\nimport { createBackgroundOutputTool } from \"./subagent-job-output\";\nimport { startBackgroundJob } from \"./subagent-jobs\";\nimport { delegatePromptSchema } from \"./subagent-prompt-schema\";\nimport { runBlockingDelegation, scopedChildSessionKey } from \"./subagent-run\";\nimport type {\n  CreateSubagentToolsOptions,\n  DelegateInput,\n  RuntimeInputSink,\n  Subagent,\n  SubagentJob,\n} from \"./subagent-types\";\n\nexport function createSubagentTools({\n  parentAgentNamespace,\n  parentSession,\n  parentSessionKey,\n  registerChildSession,\n  subagents,\n}: CreateSubagentToolsOptions): ToolSet {\n  if (subagents.length === 0) {\n    return {};\n  }\n\n  const jobs = new Map<string, SubagentJob>();\n  const generatedTools: Record<string, unknown> = {\n    background_cancel: createBackgroundCancelTool(jobs),\n    background_output: createBackgroundOutputTool(jobs),\n  };\n\n  for (const subagent of subagents) {\n    const name = subagent.name;\n    if (!name) {\n      continue;\n    }\n\n    generatedTools[`delegate_to_${name.replaceAll(\"-\", \"_\")}`] =\n      createDelegateTool({\n        jobs,\n        parentAgentNamespace,\n        parentSession,\n        parentSessionKey,\n        registerChildSession,\n        subagent,\n      });\n  }\n\n  return generatedTools as ToolSet;\n}\n\nfunction createDelegateTool({\n  jobs,\n  parentAgentNamespace,\n  parentSession,\n  parentSessionKey,\n  registerChildSession,\n  subagent,\n}: {\n  readonly jobs: Map<string, SubagentJob>;\n  readonly parentAgentNamespace: string;\n  readonly parentSession: RuntimeInputSink;\n  readonly parentSessionKey: string;\n  readonly registerChildSession: CreateSubagentToolsOptions[\"registerChildSession\"];\n  readonly subagent: Subagent;\n}) {\n  return tool<DelegateInput, unknown, Record<string, unknown>>({\n    description: `Delegate work to ${subagent.name}: ${subagent.description}`,\n    execute: async (input: DelegateInput, { abortSignal }) => {\n      const prompt = normalizeAgentInput(input.prompt);\n      const sessionKey = scopedChildSessionKey({\n        parentAgentNamespace,\n        parentSessionKey,\n        sessionKey: input.sessionKey,\n        subagent: subagent.name ?? \"subagent\",\n      });\n      if (input.run_in_background === true) {\n        return startBackgroundJob({\n          abortSignal: abortSignal ?? new AbortController().signal,\n          description: input.description,\n          jobs,\n          parentSession,\n          prompt,\n          registerCleanup: (cleanup) =>\n            registerChildSession(parentSessionKey, cleanup),\n          sessionKey,\n          subagent,\n        });\n      }\n\n      registerChildSession(parentSessionKey, () =>\n        subagent.session(sessionKey).delete()\n      );\n      parentSession.emitObserverEvent({\n        description: input.description,\n        run_in_background: false,\n        subagent: subagent.name ?? \"subagent\",\n        type: \"subagent-job-start\",\n      });\n      const result = await runBlockingDelegation({\n        abortSignal,\n        prompt,\n        sessionKey,\n        subagent,\n      });\n      parentSession.emitObserverEvent({\n        error: result.error,\n        eventCount: result.eventCount,\n        status: result.result,\n        subagent: subagent.name ?? \"subagent\",\n        type: \"subagent-job-end\",\n      });\n      return result;\n    },\n    inputSchema: jsonSchema<DelegateInput>({\n      additionalProperties: false,\n      properties: {\n        description: { type: \"string\" },\n        prompt: delegatePromptSchema,\n        run_in_background: { default: false, type: \"boolean\" },\n        sessionKey: { type: \"string\" },\n      },\n      required: [\"prompt\"],\n      type: \"object\",\n    }),\n  });\n}\n"],"mappings":";;;;;;;;AAeA,SAAgB,oBAAoB,EAClC,sBACA,eACA,kBACA,sBACA,aACsC;CACtC,IAAI,UAAU,WAAW,GACvB,OAAO,CAAC;CAGV,MAAM,uBAAO,IAAI,IAAyB;CAC1C,MAAM,iBAA0C;EAC9C,mBAAmB,2BAA2B,IAAI;EAClD,mBAAmB,2BAA2B,IAAI;CACpD;CAEA,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,OAAO,SAAS;EACtB,IAAI,CAAC,MACH;EAGF,eAAe,eAAe,KAAK,WAAW,KAAK,GAAG,OACpD,mBAAmB;GACjB;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;CACL;CAEA,OAAO;AACT;AAEA,SAAS,mBAAmB,EAC1B,MACA,sBACA,eACA,kBACA,sBACA,YAQC;CACD,OAAO,KAAsD;EAC3D,aAAa,oBAAoB,SAAS,KAAK,IAAI,SAAS;EAC5D,SAAS,OAAO,OAAsB,EAAE,kBAAkB;GACxD,MAAM,SAAS,oBAAoB,MAAM,MAAM;GAC/C,MAAM,aAAa,sBAAsB;IACvC;IACA;IACA,YAAY,MAAM;IAClB,UAAU,SAAS,QAAQ;GAC7B,CAAC;GACD,IAAI,MAAM,sBAAsB,MAC9B,OAAO,mBAAmB;IACxB,aAAa,eAAe,IAAI,gBAAgB,EAAE;IAClD,aAAa,MAAM;IACnB;IACA;IACA;IACA,kBAAkB,YAChB,qBAAqB,kBAAkB,OAAO;IAChD;IACA;GACF,CAAC;GAGH,qBAAqB,wBACnB,SAAS,QAAQ,UAAU,EAAE,OAAO,CACtC;GACA,cAAc,kBAAkB;IAC9B,aAAa,MAAM;IACnB,mBAAmB;IACnB,UAAU,SAAS,QAAQ;IAC3B,MAAM;GACR,CAAC;GACD,MAAM,SAAS,MAAM,sBAAsB;IACzC;IACA;IACA;IACA;GACF,CAAC;GACD,cAAc,kBAAkB;IAC9B,OAAO,OAAO;IACd,YAAY,OAAO;IACnB,QAAQ,OAAO;IACf,UAAU,SAAS,QAAQ;IAC3B,MAAM;GACR,CAAC;GACD,OAAO;EACT;EACA,aAAa,WAA0B;GACrC,sBAAsB;GACtB,YAAY;IACV,aAAa,EAAE,MAAM,SAAS;IAC9B,QAAQ;IACR,mBAAmB;KAAE,SAAS;KAAO,MAAM;IAAU;IACrD,YAAY,EAAE,MAAM,SAAS;GAC/B;GACA,UAAU,CAAC,QAAQ;GACnB,MAAM;EACR,CAAC;CACH,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minpeter/pss-runtime",
-  "version": "0.0.11",
+  "version": "0.1.0-next.1",
   "description": "Generic agent runtime for sessions, model loops, and synchronized run events.",
   "type": "module",
   "main": "./dist/index.js",