@minpeter/pss-runtime 0.1.0-next.0 → 0.1.0-next.2

package/dist/subagent-job-cancel.js

@@ -0,0 +1,84 @@
+import { cancelBackgroundChildRun } from "./subagent-background-child-run.js";
+import { assertBackgroundTaskId, backgroundRunJobStatus, cancelJob, isActiveJob } from "./subagent-job-state.js";
+import { jsonSchema, tool } from "ai";
+//#region src/subagent-job-cancel.ts
+function createBackgroundCancelTool(jobs, executionHost, scope) {
+	return tool({
+		description: "Cancel an active background subagent job.",
+		execute: async (input) => {
+			assertBackgroundTaskId(input.task_id, "background_cancel");
+			const job = jobs.get(input.task_id);
+			if (!job) {
+				const durableCancel = await durableBackgroundCancel(input.task_id, executionHost, scope);
+				if (durableCancel) return durableCancel;
+				throw new Error(`Unknown background subagent task ${input.task_id}.`);
+			}
+			const durableLocalCancel = await cancelDurableLocalJob(job, scope);
+			if (durableLocalCancel) return durableLocalCancel;
+			if (isActiveJob(job.status)) cancelJob(job);
+			return {
+				status: job.status,
+				task_id: job.id
+			};
+		},
+		inputSchema: jsonSchema({
+			additionalProperties: false,
+			properties: { task_id: { type: "string" } },
+			required: ["task_id"],
+			type: "object"
+		})
+	});
+}
+async function cancelDurableLocalJob(job, scope) {
+	if (!(job.executionHost && job.childRunId)) return null;
+	const record = await job.executionHost.store.runs.get(job.childRunId);
+	if (record?.kind !== "background-subagent") return null;
+	if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) return null;
+	const currentStatus = backgroundRunJobStatus(record.status);
+	if (!currentStatus) return null;
+	if (currentStatus === "pending" || currentStatus === "running") {
+		const nextStatus = backgroundRunJobStatus((await cancelBackgroundChildRun({
+			executionHost: job.executionHost,
+			runId: record.runId
+		}))?.status);
+		if (nextStatus === "cancelled") {
+			cancelJob(job);
+			return {
+				status: "cancelled",
+				task_id: job.id
+			};
+		}
+		return {
+			status: nextStatus ?? currentStatus,
+			task_id: job.id
+		};
+	}
+	return {
+		status: currentStatus,
+		task_id: job.id
+	};
+}
+async function durableBackgroundCancel(taskId, executionHost, scope) {
+	if (!executionHost) return null;
+	const host = executionHost;
+	const record = await host.store.runs.get(`background:${taskId}`);
+	if (record?.kind !== "background-subagent") return null;
+	if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) return null;
+	const currentStatus = backgroundRunJobStatus(record.status);
+	if (!currentStatus) return null;
+	if (currentStatus === "pending" || currentStatus === "running") return {
+		status: backgroundRunJobStatus((await cancelBackgroundChildRun({
+			executionHost: host,
+			runId: record.runId
+		}))?.status) ?? currentStatus,
+		task_id: taskId
+	};
+	return {
+		status: currentStatus,
+		task_id: taskId
+	};
+}
+//#endregion
+export { createBackgroundCancelTool };
+
+//# sourceMappingURL=subagent-job-cancel.js.map

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 type { ExecutionHost } from \"./execution/types\";\nimport { cancelBackgroundChildRun } from \"./subagent-background-child-run\";\nimport {\n  assertBackgroundTaskId,\n  backgroundRunJobStatus,\n  cancelJob,\n  isActiveJob,\n} from \"./subagent-job-state\";\nimport type { BackgroundCancelInput, SubagentJob } from \"./subagent-types\";\n\ninterface BackgroundToolScope {\n  readonly childSessionKeyPrefix: string;\n}\n\nexport function createBackgroundCancelTool(\n  jobs: Map<string, SubagentJob>,\n  executionHost?: ExecutionHost,\n  scope?: BackgroundToolScope\n) {\n  return tool<BackgroundCancelInput, unknown, Record<string, unknown>>({\n    description: \"Cancel an active background subagent job.\",\n    execute: async (input: BackgroundCancelInput) => {\n      assertBackgroundTaskId(input.task_id, \"background_cancel\");\n      const job = jobs.get(input.task_id);\n      if (!job) {\n        const durableCancel = await durableBackgroundCancel(\n          input.task_id,\n          executionHost,\n          scope\n        );\n        if (durableCancel) {\n          return durableCancel;\n        }\n\n        throw new Error(`Unknown background subagent task ${input.task_id}.`);\n      }\n\n      const durableLocalCancel = await cancelDurableLocalJob(job, scope);\n      if (durableLocalCancel) {\n        return durableLocalCancel;\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\nasync function cancelDurableLocalJob(\n  job: SubagentJob,\n  scope: BackgroundToolScope | undefined\n): Promise<Record<string, unknown> | null> {\n  if (!(job.executionHost && job.childRunId)) {\n    return null;\n  }\n\n  const record = await job.executionHost.store.runs.get(job.childRunId);\n  if (record?.kind !== \"background-subagent\") {\n    return null;\n  }\n  if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) {\n    return null;\n  }\n\n  const currentStatus = backgroundRunJobStatus(record.status);\n  if (!currentStatus) {\n    return null;\n  }\n  if (currentStatus === \"pending\" || currentStatus === \"running\") {\n    const cancelled = await cancelBackgroundChildRun({\n      executionHost: job.executionHost,\n      runId: record.runId,\n    });\n    const nextStatus = backgroundRunJobStatus(cancelled?.status);\n    if (nextStatus === \"cancelled\") {\n      cancelJob(job);\n      return { status: \"cancelled\", task_id: job.id };\n    }\n\n    return { status: nextStatus ?? currentStatus, task_id: job.id };\n  }\n\n  return { status: currentStatus, task_id: job.id };\n}\n\nasync function durableBackgroundCancel(\n  taskId: string,\n  executionHost: ExecutionHost | undefined,\n  scope: BackgroundToolScope | undefined\n): Promise<Record<string, unknown> | null> {\n  if (!executionHost) {\n    return null;\n  }\n  const host = executionHost;\n\n  const record = await host.store.runs.get(`background:${taskId}`);\n  if (record?.kind !== \"background-subagent\") {\n    return null;\n  }\n  if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) {\n    return null;\n  }\n\n  const currentStatus = backgroundRunJobStatus(record.status);\n  if (!currentStatus) {\n    return null;\n  }\n\n  if (currentStatus === \"pending\" || currentStatus === \"running\") {\n    const cancelled = await cancelBackgroundChildRun({\n      executionHost: host,\n      runId: record.runId,\n    });\n    return {\n      status: backgroundRunJobStatus(cancelled?.status) ?? currentStatus,\n      task_id: taskId,\n    };\n  }\n\n  return { status: currentStatus, task_id: taskId };\n}\n"],"mappings":";;;;AAeA,SAAgB,2BACd,MACA,eACA,OACA;CACA,OAAO,KAA8D;EACnE,aAAa;EACb,SAAS,OAAO,UAAiC;GAC/C,uBAAuB,MAAM,SAAS,mBAAmB;GACzD,MAAM,MAAM,KAAK,IAAI,MAAM,OAAO;GAClC,IAAI,CAAC,KAAK;IACR,MAAM,gBAAgB,MAAM,wBAC1B,MAAM,SACN,eACA,KACF;IACA,IAAI,eACF,OAAO;IAGT,MAAM,IAAI,MAAM,oCAAoC,MAAM,QAAQ,EAAE;GACtE;GAEA,MAAM,qBAAqB,MAAM,sBAAsB,KAAK,KAAK;GACjE,IAAI,oBACF,OAAO;GAGT,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;AAEA,eAAe,sBACb,KACA,OACyC;CACzC,IAAI,EAAE,IAAI,iBAAiB,IAAI,aAC7B,OAAO;CAGT,MAAM,SAAS,MAAM,IAAI,cAAc,MAAM,KAAK,IAAI,IAAI,UAAU;CACpE,IAAI,QAAQ,SAAS,uBACnB,OAAO;CAET,IAAI,SAAS,CAAC,OAAO,WAAW,WAAW,MAAM,qBAAqB,GACpE,OAAO;CAGT,MAAM,gBAAgB,uBAAuB,OAAO,MAAM;CAC1D,IAAI,CAAC,eACH,OAAO;CAET,IAAI,kBAAkB,aAAa,kBAAkB,WAAW;EAK9D,MAAM,aAAa,wBAAuB,MAJlB,yBAAyB;GAC/C,eAAe,IAAI;GACnB,OAAO,OAAO;EAChB,CAAC,IACoD,MAAM;EAC3D,IAAI,eAAe,aAAa;GAC9B,UAAU,GAAG;GACb,OAAO;IAAE,QAAQ;IAAa,SAAS,IAAI;GAAG;EAChD;EAEA,OAAO;GAAE,QAAQ,cAAc;GAAe,SAAS,IAAI;EAAG;CAChE;CAEA,OAAO;EAAE,QAAQ;EAAe,SAAS,IAAI;CAAG;AAClD;AAEA,eAAe,wBACb,QACA,eACA,OACyC;CACzC,IAAI,CAAC,eACH,OAAO;CAET,MAAM,OAAO;CAEb,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,IAAI,cAAc,QAAQ;CAC/D,IAAI,QAAQ,SAAS,uBACnB,OAAO;CAET,IAAI,SAAS,CAAC,OAAO,WAAW,WAAW,MAAM,qBAAqB,GACpE,OAAO;CAGT,MAAM,gBAAgB,uBAAuB,OAAO,MAAM;CAC1D,IAAI,CAAC,eACH,OAAO;CAGT,IAAI,kBAAkB,aAAa,kBAAkB,WAKnD,OAAO;EACL,QAAQ,wBAAuB,MALT,yBAAyB;GAC/C,eAAe;GACf,OAAO,OAAO;EAChB,CAAC,IAE2C,MAAM,KAAK;EACrD,SAAS;CACX;CAGF,OAAO;EAAE,QAAQ;EAAe,SAAS;CAAO;AAClD"}

package/dist/subagent-job-observer.js

@@ -0,0 +1,19 @@
+//#region src/subagent-job-observer.ts
+function emitBackgroundJobUpdate(parentSession, job, event) {
+	if (!isParentVisibleJobUpdate(event)) return Promise.resolve();
+	return parentSession.emitObserverEvent({
+		eventType: event.type,
+		delegateToolCallId: job.delegateToolCallId,
+		status: job.status,
+		subagent: job.subagent,
+		task_id: job.id,
+		type: "subagent-job-update"
+	});
+}
+function isParentVisibleJobUpdate(event) {
+	return event.type === "assistant-text" || event.type === "tool-call" || event.type === "tool-result" || event.type === "turn-abort" || event.type === "turn-error";
+}
+//#endregion
+export { emitBackgroundJobUpdate };
+
+//# sourceMappingURL=subagent-job-observer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-job-observer.js","names":[],"sources":["../src/subagent-job-observer.ts"],"sourcesContent":["import type { AgentEvent } from \"./session/events\";\nimport type { RuntimeInputSink, SubagentJob } from \"./subagent-types\";\n\nexport function emitBackgroundJobUpdate(\n  parentSession: RuntimeInputSink,\n  job: SubagentJob,\n  event: AgentEvent\n): Promise<void> {\n  if (!isParentVisibleJobUpdate(event)) {\n    return Promise.resolve();\n  }\n\n  return parentSession.emitObserverEvent({\n    eventType: event.type,\n    delegateToolCallId: job.delegateToolCallId,\n    status: job.status,\n    subagent: job.subagent,\n    task_id: job.id,\n    type: \"subagent-job-update\" as const,\n  });\n}\n\nfunction isParentVisibleJobUpdate(event: AgentEvent): boolean {\n  return (\n    event.type === \"assistant-text\" ||\n    event.type === \"tool-call\" ||\n    event.type === \"tool-result\" ||\n    event.type === \"turn-abort\" ||\n    event.type === \"turn-error\"\n  );\n}\n"],"mappings":";AAGA,SAAgB,wBACd,eACA,KACA,OACe;CACf,IAAI,CAAC,yBAAyB,KAAK,GACjC,OAAO,QAAQ,QAAQ;CAGzB,OAAO,cAAc,kBAAkB;EACrC,WAAW,MAAM;EACjB,oBAAoB,IAAI;EACxB,QAAQ,IAAI;EACZ,UAAU,IAAI;EACd,SAAS,IAAI;EACb,MAAM;CACR,CAAC;AACH;AAEA,SAAS,yBAAyB,OAA4B;CAC5D,OACE,MAAM,SAAS,oBACf,MAAM,SAAS,eACf,MAAM,SAAS,iBACf,MAAM,SAAS,gBACf,MAAM,SAAS;AAEnB"}

package/dist/subagent-job-output.js

@@ -0,0 +1,87 @@
+import { assertBackgroundTaskId, cleanupJob, isActiveJob } from "./subagent-job-state.js";
+import { jsonSchema, tool } from "ai";
+//#region src/subagent-job-output.ts
+function createBackgroundOutputTool(jobs, executionHost, scope) {
+	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) {
+				const durableOutput = await durableBackgroundOutput(input.task_id, executionHost, scope);
+				if (durableOutput) return durableOutput;
+				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 = await durableBackgroundOutput(input.task_id, job.executionHost ?? executionHost, scope, job.subagent) ?? {
+				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 durableBackgroundOutput(taskId, executionHost, scope, fallbackSubagent = "subagent") {
+	const record = await executionHost?.store.runs.get(`background:${taskId}`);
+	if (record?.kind !== "background-subagent") return null;
+	if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) return null;
+	return {
+		result: record.output,
+		status: backgroundStatus(record.status),
+		subagent: subagentName(record.output, fallbackSubagent),
+		task_id: taskId
+	};
+}
+function backgroundStatus(status) {
+	if (status === "completed" || status === "cancelled" || status === "error") return status;
+	if (status === "running" || status === "leased") return "running";
+	return "pending";
+}
+function subagentName(output, fallback) {
+	if (typeof output === "object" && output !== null && "subagent" in output && typeof output.subagent === "string") return output.subagent;
+	return fallback;
+}
+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 type { ExecutionHost, RunStatus } from \"./execution/types\";\nimport {\n  assertBackgroundTaskId,\n  cleanupJob,\n  isActiveJob,\n} from \"./subagent-job-state\";\nimport type { BackgroundOutputInput, SubagentJob } from \"./subagent-types\";\n\ninterface BackgroundToolScope {\n  readonly childSessionKeyPrefix: string;\n}\n\nexport function createBackgroundOutputTool(\n  jobs: Map<string, SubagentJob>,\n  executionHost?: ExecutionHost,\n  scope?: BackgroundToolScope\n) {\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        const durableOutput = await durableBackgroundOutput(\n          input.task_id,\n          executionHost,\n          scope\n        );\n        if (durableOutput) {\n          return durableOutput;\n        }\n\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 durableOutput = await durableBackgroundOutput(\n        input.task_id,\n        job.executionHost ?? executionHost,\n        scope,\n        job.subagent\n      );\n      const output = durableOutput ?? {\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 durableBackgroundOutput(\n  taskId: string,\n  executionHost: ExecutionHost | undefined,\n  scope: BackgroundToolScope | undefined,\n  fallbackSubagent = \"subagent\"\n): Promise<Record<string, unknown> | null> {\n  const record = await executionHost?.store.runs.get(`background:${taskId}`);\n  if (record?.kind !== \"background-subagent\") {\n    return null;\n  }\n  if (scope && !record.sessionKey.startsWith(scope.childSessionKeyPrefix)) {\n    return null;\n  }\n\n  return {\n    result: record.output,\n    status: backgroundStatus(record.status),\n    subagent: subagentName(record.output, fallbackSubagent),\n    task_id: taskId,\n  };\n}\n\nfunction backgroundStatus(status: RunStatus): string {\n  if (status === \"completed\" || status === \"cancelled\" || status === \"error\") {\n    return status;\n  }\n\n  if (status === \"running\" || status === \"leased\") {\n    return \"running\";\n  }\n\n  return \"pending\";\n}\n\nfunction subagentName(output: unknown, fallback: string): string {\n  if (\n    typeof output === \"object\" &&\n    output !== null &&\n    \"subagent\" in output &&\n    typeof output.subagent === \"string\"\n  ) {\n    return output.subagent;\n  }\n\n  return fallback;\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":";;;AAaA,SAAgB,2BACd,MACA,eACA,OACA;CACA,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,KAAK;IACR,MAAM,gBAAgB,MAAM,wBAC1B,MAAM,SACN,eACA,KACF;IACA,IAAI,eACF,OAAO;IAGT,MAAM,IAAI,MAAM,oCAAoC,MAAM,QAAQ,EAAE;GACtE;GAEA,IAAI,MAAM,UAAU,QAAQ,YAAY,IAAI,MAAM,GAChD,MAAM,WAAW,KAAK,MAAM,SAAS,WAAW;GASlD,MAAM,SAAS,MANa,wBAC1B,MAAM,SACN,IAAI,iBAAiB,eACrB,OACA,IAAI,QACN,KACgC;IAC9B,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,wBACb,QACA,eACA,OACA,mBAAmB,YACsB;CACzC,MAAM,SAAS,MAAM,eAAe,MAAM,KAAK,IAAI,cAAc,QAAQ;CACzE,IAAI,QAAQ,SAAS,uBACnB,OAAO;CAET,IAAI,SAAS,CAAC,OAAO,WAAW,WAAW,MAAM,qBAAqB,GACpE,OAAO;CAGT,OAAO;EACL,QAAQ,OAAO;EACf,QAAQ,iBAAiB,OAAO,MAAM;EACtC,UAAU,aAAa,OAAO,QAAQ,gBAAgB;EACtD,SAAS;CACX;AACF;AAEA,SAAS,iBAAiB,QAA2B;CACnD,IAAI,WAAW,eAAe,WAAW,eAAe,WAAW,SACjE,OAAO;CAGT,IAAI,WAAW,aAAa,WAAW,UACrC,OAAO;CAGT,OAAO;AACT;AAEA,SAAS,aAAa,QAAiB,UAA0B;CAC/D,IACE,OAAO,WAAW,YAClB,WAAW,QACX,cAAc,UACd,OAAO,OAAO,aAAa,UAE3B,OAAO,OAAO;CAGhB,OAAO;AACT;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-job-state.js

@@ -0,0 +1,66 @@
+import { updateBackgroundRunStatus } from "./subagent-background-child-run.js";
+//#region src/subagent-job-state.ts
+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 isActiveJob(status) {
+	return status === "pending" || status === "running";
+}
+function hasBackgroundJobCapacity({ jobs, maxActiveJobs, maxRetainedJobs }) {
+	if (jobs.size >= maxRetainedJobs) return false;
+	let activeJobs = 0;
+	for (const job of jobs.values()) if (isActiveJob(job.status) || !job.settled) activeJobs += 1;
+	return activeJobs < maxActiveJobs;
+}
+function cancelJob(job) {
+	job.status = "cancelled";
+	job.abort();
+	const statusUpdate = updateBackgroundRunStatus(job, "cancelled");
+	job.promise = Promise.allSettled([job.promise, statusUpdate]).then(() => void 0);
+}
+async function cleanupJob(job) {
+	await job.cleanup();
+	job.unregisterCleanup?.();
+}
+function backgroundLaunchOutput(job) {
+	return {
+		message: [
+			`Background subagent job ${job.id} started.`,
+			`Please wait for <system-reminder> before checking task ${job.id}.`,
+			`Do NOT call background_output({ task_id: "${job.id}" }) now; wait for <system-reminder> first.`
+		].join(" "),
+		run_in_background: true,
+		status: job.status,
+		subagent: job.subagent,
+		task_id: job.id
+	};
+}
+function backgroundCancelledLaunchOutput({ id, subagent }) {
+	return {
+		message: `Background subagent job ${id} was cancelled before it started.`,
+		run_in_background: true,
+		status: "cancelled",
+		subagent,
+		task_id: id
+	};
+}
+function backgroundRunJobStatus(status) {
+	if (status === "cancelled" || status === "completed" || status === "error") return status;
+	if (status === "leased" || status === "running") return "running";
+	if (status === "needs-recovery" || status === "queued" || status === "suspended") return "pending";
+	return null;
+}
+function backgroundReplayOutput({ id, status, subagent }) {
+	return {
+		message: `Background subagent job ${id} was already ${status}. Reuse the existing task_id instead of launching it again.`,
+		run_in_background: true,
+		status,
+		subagent,
+		task_id: id
+	};
+}
+//#endregion
+export { assertBackgroundTaskId, backgroundCancelledLaunchOutput, backgroundLaunchOutput, backgroundReplayOutput, backgroundRunJobStatus, cancelJob, cleanupJob, hasBackgroundJobCapacity, isActiveJob };
+
+//# sourceMappingURL=subagent-job-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-job-state.js","names":[],"sources":["../src/subagent-job-state.ts"],"sourcesContent":["import type { RunStatus } from \"./execution/types\";\nimport { updateBackgroundRunStatus } from \"./subagent-background-child-run\";\nimport type { SubagentJob } from \"./subagent-types\";\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\nexport function isActiveJob(status: SubagentJob[\"status\"]): boolean {\n  return status === \"pending\" || status === \"running\";\n}\n\nexport function hasBackgroundJobCapacity({\n  jobs,\n  maxActiveJobs,\n  maxRetainedJobs,\n}: {\n  readonly jobs: Map<string, SubagentJob>;\n  readonly maxActiveJobs: number;\n  readonly maxRetainedJobs: number;\n}): boolean {\n  if (jobs.size >= maxRetainedJobs) {\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 < maxActiveJobs;\n}\n\nexport function cancelJob(job: SubagentJob): void {\n  job.status = \"cancelled\";\n  job.abort();\n  const statusUpdate = updateBackgroundRunStatus(job, \"cancelled\");\n  job.promise = Promise.allSettled([job.promise, statusUpdate]).then(\n    () => undefined\n  );\n}\n\nexport async function cleanupJob(job: SubagentJob): Promise<void> {\n  await job.cleanup();\n  job.unregisterCleanup?.();\n}\n\nexport function backgroundLaunchOutput(job: SubagentJob) {\n  return {\n    message: [\n      `Background subagent job ${job.id} started.`,\n      `Please wait for <system-reminder> before checking task ${job.id}.`,\n      `Do NOT call background_output({ task_id: \"${job.id}\" }) now; wait for <system-reminder> first.`,\n    ].join(\" \"),\n    run_in_background: true,\n    status: job.status,\n    subagent: job.subagent,\n    task_id: job.id,\n  };\n}\n\nexport function backgroundCancelledLaunchOutput({\n  id,\n  subagent,\n}: {\n  readonly id: string;\n  readonly subagent?: string;\n}) {\n  return {\n    message: `Background subagent job ${id} was cancelled before it started.`,\n    run_in_background: true,\n    status: \"cancelled\",\n    subagent,\n    task_id: id,\n  };\n}\n\nexport function backgroundRunJobStatus(\n  status: RunStatus | undefined\n): Exclude<SubagentJob[\"status\"], \"aborted\"> | null {\n  if (status === \"cancelled\" || status === \"completed\" || status === \"error\") {\n    return status;\n  }\n\n  if (status === \"leased\" || status === \"running\") {\n    return \"running\";\n  }\n\n  if (\n    status === \"needs-recovery\" ||\n    status === \"queued\" ||\n    status === \"suspended\"\n  ) {\n    return \"pending\";\n  }\n\n  return null;\n}\n\nexport function backgroundReplayOutput({\n  id,\n  status,\n  subagent,\n}: {\n  readonly id: string;\n  readonly status: Exclude<SubagentJob[\"status\"], \"aborted\">;\n  readonly subagent: string;\n}) {\n  return {\n    message: `Background subagent job ${id} was already ${status}. Reuse the existing task_id instead of launching it again.`,\n    run_in_background: true,\n    status,\n    subagent,\n    task_id: id,\n  };\n}\n"],"mappings":";;AAIA,SAAgB,uBAAuB,OAAe,UAAwB;CAC5E,IAAI,MAAM,WAAW,KAAK,GACxB;CAGF,MAAM,IAAI,MACR,GAAG,SAAS,sEAAsE,OACpF;AACF;AAEA,SAAgB,YAAY,QAAwC;CAClE,OAAO,WAAW,aAAa,WAAW;AAC5C;AAEA,SAAgB,yBAAyB,EACvC,MACA,eACA,mBAKU;CACV,IAAI,KAAK,QAAQ,iBACf,OAAO;CAGT,IAAI,aAAa;CACjB,KAAK,MAAM,OAAO,KAAK,OAAO,GAC5B,IAAI,YAAY,IAAI,MAAM,KAAK,CAAC,IAAI,SAClC,cAAc;CAIlB,OAAO,aAAa;AACtB;AAEA,SAAgB,UAAU,KAAwB;CAChD,IAAI,SAAS;CACb,IAAI,MAAM;CACV,MAAM,eAAe,0BAA0B,KAAK,WAAW;CAC/D,IAAI,UAAU,QAAQ,WAAW,CAAC,IAAI,SAAS,YAAY,CAAC,EAAE,WACtD,KAAA,CACR;AACF;AAEA,eAAsB,WAAW,KAAiC;CAChE,MAAM,IAAI,QAAQ;CAClB,IAAI,oBAAoB;AAC1B;AAEA,SAAgB,uBAAuB,KAAkB;CACvD,OAAO;EACL,SAAS;GACP,2BAA2B,IAAI,GAAG;GAClC,0DAA0D,IAAI,GAAG;GACjE,6CAA6C,IAAI,GAAG;EACtD,EAAE,KAAK,GAAG;EACV,mBAAmB;EACnB,QAAQ,IAAI;EACZ,UAAU,IAAI;EACd,SAAS,IAAI;CACf;AACF;AAEA,SAAgB,gCAAgC,EAC9C,IACA,YAIC;CACD,OAAO;EACL,SAAS,2BAA2B,GAAG;EACvC,mBAAmB;EACnB,QAAQ;EACR;EACA,SAAS;CACX;AACF;AAEA,SAAgB,uBACd,QACkD;CAClD,IAAI,WAAW,eAAe,WAAW,eAAe,WAAW,SACjE,OAAO;CAGT,IAAI,WAAW,YAAY,WAAW,WACpC,OAAO;CAGT,IACE,WAAW,oBACX,WAAW,YACX,WAAW,aAEX,OAAO;CAGT,OAAO;AACT;AAEA,SAAgB,uBAAuB,EACrC,IACA,QACA,YAKC;CACD,OAAO;EACL,SAAS,2BAA2B,GAAG,eAAe,OAAO;EAC7D,mBAAmB;EACnB;EACA;EACA,SAAS;CACX;AACF"}

package/dist/subagent-jobs.js

@@ -0,0 +1,96 @@
+import { createBackgroundTaskId, createDurableBackgroundTaskId, getBackgroundChildRun, getOrCreateBackgroundChildRun } from "./subagent-background-child-run.js";
+import { backgroundCancelledLaunchOutput, backgroundLaunchOutput, backgroundReplayOutput, backgroundRunJobStatus, hasBackgroundJobCapacity } from "./subagent-job-state.js";
+import { startInProcessBackgroundJob } from "./subagent-background-in-process.js";
+import { scheduleDurableBackgroundJob } from "./subagent-background-schedule.js";
+//#region src/subagent-jobs.ts
+const maxBackgroundJobs = 64;
+const maxRetainedBackgroundJobs = maxBackgroundJobs * 4;
+async function startBackgroundJob({ abortSignal, description, executionHost, jobs, groupId, groups = /* @__PURE__ */ new Map(), delegateToolCallId, parentSession, parentRunId, parentSessionKey, ownerNamespace, prompt, registerCleanup, sessionKey, subagent }) {
+	const existingChildRun = await getBackgroundChildRun({
+		delegateToolCallId,
+		executionHost,
+		parentRunId,
+		parentSessionKey,
+		prompt,
+		sessionKey
+	});
+	const id = existingChildRun?.publicTaskId ?? (executionHost ? await createDurableBackgroundTaskId({
+		delegateToolCallId,
+		prompt,
+		sessionKey
+	}) : createBackgroundTaskId());
+	const existingJob = jobs.get(id);
+	if (existingJob) return backgroundLaunchOutput(existingJob);
+	const replayedStatus = backgroundRunJobStatus(existingChildRun?.status);
+	if (existingChildRun?.publicTaskId && replayedStatus) return backgroundReplayOutput({
+		id: existingChildRun.publicTaskId,
+		status: replayedStatus,
+		subagent: subagent.name ?? "subagent"
+	});
+	if (!hasBackgroundJobCapacity({
+		jobs,
+		maxActiveJobs: maxBackgroundJobs,
+		maxRetainedJobs: maxRetainedBackgroundJobs
+	})) 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 backgroundCancelledLaunchOutput({
+		id,
+		subagent: subagent.name
+	});
+	const childRun = executionHost ? existingChildRun ?? await getOrCreateBackgroundChildRun({
+		delegateToolCallId,
+		description,
+		executionHost,
+		groupId,
+		ownerNamespace,
+		parentRunId,
+		parentSessionKey,
+		prompt,
+		publicTaskId: id,
+		sessionKey,
+		subagent: subagent.name ?? "subagent"
+	}) : void 0;
+	if (executionHost?.capabilities.backgroundSubagents === "durable" && childRun) return backgroundLaunchOutput(await scheduleDurableBackgroundJob({
+		childRun,
+		delegateToolCallId,
+		description,
+		executionHost,
+		groupId,
+		groups,
+		id,
+		jobs,
+		parentRunId,
+		parentSession,
+		parentSessionKey,
+		ownerNamespace,
+		subagent: subagent.name ?? "subagent"
+	}));
+	return await startInProcessBackgroundJob({
+		abortSignal,
+		childRun,
+		delegateToolCallId,
+		description,
+		executionHost,
+		groupId,
+		groups,
+		id,
+		jobs,
+		parentRunId,
+		parentSession,
+		parentSessionKey,
+		ownerNamespace,
+		prompt,
+		registerCleanup,
+		sessionKey,
+		subagent
+	});
+}
+//#endregion
+export { 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 { ExecutionHost } from \"./execution/types\";\nimport type { AgentInput } from \"./session/input\";\nimport {\n  createBackgroundTaskId,\n  createDurableBackgroundTaskId,\n  getBackgroundChildRun,\n  getOrCreateBackgroundChildRun,\n} from \"./subagent-background-child-run\";\nimport { startInProcessBackgroundJob } from \"./subagent-background-in-process\";\nimport { scheduleDurableBackgroundJob } from \"./subagent-background-schedule\";\nimport {\n  backgroundCancelledLaunchOutput,\n  backgroundLaunchOutput,\n  backgroundReplayOutput,\n  backgroundRunJobStatus,\n  hasBackgroundJobCapacity,\n} from \"./subagent-job-state\";\nimport type {\n  RuntimeInputSink,\n  Subagent,\n  SubagentJob,\n  SubagentJobGroup,\n} from \"./subagent-types\";\n\nconst maxBackgroundJobs = 64;\nconst maxRetainedBackgroundJobs = maxBackgroundJobs * 4;\n\nexport async function startBackgroundJob({\n  abortSignal,\n  description,\n  executionHost,\n  jobs,\n  groupId,\n  groups = new Map<string, SubagentJobGroup>(),\n  delegateToolCallId,\n  parentSession,\n  parentRunId,\n  parentSessionKey,\n  ownerNamespace,\n  prompt,\n  registerCleanup,\n  sessionKey,\n  subagent,\n}: {\n  readonly abortSignal: AbortSignal;\n  readonly description?: string;\n  readonly executionHost?: ExecutionHost;\n  readonly jobs: Map<string, SubagentJob>;\n  readonly groupId?: string;\n  readonly groups?: Map<string, SubagentJobGroup>;\n  readonly delegateToolCallId?: string;\n  readonly parentSession: RuntimeInputSink;\n  readonly parentRunId?: string;\n  readonly parentSessionKey?: string;\n  readonly ownerNamespace?: string;\n  readonly prompt: AgentInput;\n  readonly registerCleanup: (cleanup: () => Promise<void>) => () => void;\n  readonly sessionKey: string;\n  readonly subagent: Subagent;\n}) {\n  const existingChildRun = await getBackgroundChildRun({\n    delegateToolCallId,\n    executionHost,\n    parentRunId,\n    parentSessionKey,\n    prompt,\n    sessionKey,\n  });\n  const id =\n    existingChildRun?.publicTaskId ??\n    (executionHost\n      ? await createDurableBackgroundTaskId({\n          delegateToolCallId,\n          prompt,\n          sessionKey,\n        })\n      : createBackgroundTaskId());\n  const existingJob = jobs.get(id);\n  if (existingJob) {\n    return backgroundLaunchOutput(existingJob);\n  }\n  const replayedStatus = backgroundRunJobStatus(existingChildRun?.status);\n  if (existingChildRun?.publicTaskId && replayedStatus) {\n    return backgroundReplayOutput({\n      id: existingChildRun.publicTaskId,\n      status: replayedStatus,\n      subagent: subagent.name ?? \"subagent\",\n    });\n  }\n\n  if (\n    !hasBackgroundJobCapacity({\n      jobs,\n      maxActiveJobs: maxBackgroundJobs,\n      maxRetainedJobs: maxRetainedBackgroundJobs,\n    })\n  ) {\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 backgroundCancelledLaunchOutput({ id, subagent: subagent.name });\n  }\n\n  const childRun = executionHost\n    ? (existingChildRun ??\n      (await getOrCreateBackgroundChildRun({\n        delegateToolCallId,\n        description,\n        executionHost,\n        groupId,\n        ownerNamespace,\n        parentRunId,\n        parentSessionKey,\n        prompt,\n        publicTaskId: id,\n        sessionKey,\n        subagent: subagent.name ?? \"subagent\",\n      })))\n    : undefined;\n  if (\n    executionHost?.capabilities.backgroundSubagents === \"durable\" &&\n    childRun\n  ) {\n    const job = await scheduleDurableBackgroundJob({\n      childRun,\n      delegateToolCallId,\n      description,\n      executionHost,\n      groupId,\n      groups,\n      id,\n      jobs,\n      parentRunId,\n      parentSession,\n      parentSessionKey,\n      ownerNamespace,\n      subagent: subagent.name ?? \"subagent\",\n    });\n    return backgroundLaunchOutput(job);\n  }\n  return await startInProcessBackgroundJob({\n    abortSignal,\n    childRun,\n    delegateToolCallId,\n    description,\n    executionHost,\n    groupId,\n    groups,\n    id,\n    jobs,\n    parentRunId,\n    parentSession,\n    parentSessionKey,\n    ownerNamespace,\n    prompt,\n    registerCleanup,\n    sessionKey,\n    subagent,\n  });\n}\n"],"mappings":";;;;;AAwBA,MAAM,oBAAoB;AAC1B,MAAM,4BAA4B,oBAAoB;AAEtD,eAAsB,mBAAmB,EACvC,aACA,aACA,eACA,MACA,SACA,yBAAS,IAAI,IAA8B,GAC3C,oBACA,eACA,aACA,kBACA,gBACA,QACA,iBACA,YACA,YAiBC;CACD,MAAM,mBAAmB,MAAM,sBAAsB;EACnD;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,MAAM,KACJ,kBAAkB,iBACjB,gBACG,MAAM,8BAA8B;EAClC;EACA;EACA;CACF,CAAC,IACD,uBAAuB;CAC7B,MAAM,cAAc,KAAK,IAAI,EAAE;CAC/B,IAAI,aACF,OAAO,uBAAuB,WAAW;CAE3C,MAAM,iBAAiB,uBAAuB,kBAAkB,MAAM;CACtE,IAAI,kBAAkB,gBAAgB,gBACpC,OAAO,uBAAuB;EAC5B,IAAI,iBAAiB;EACrB,QAAQ;EACR,UAAU,SAAS,QAAQ;CAC7B,CAAC;CAGH,IACE,CAAC,yBAAyB;EACxB;EACA,eAAe;EACf,iBAAiB;CACnB,CAAC,GAED,OAAO;EACL,SACE;EACF,mBAAmB;EACnB,QAAQ;EACR,UAAU,SAAS;EACnB,SAAS;CACX;CAGF,IAAI,YAAY,SACd,OAAO,gCAAgC;EAAE;EAAI,UAAU,SAAS;CAAK,CAAC;CAGxE,MAAM,WAAW,gBACZ,oBACA,MAAM,8BAA8B;EACnC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA,UAAU,SAAS,QAAQ;CAC7B,CAAC,IACD,KAAA;CACJ,IACE,eAAe,aAAa,wBAAwB,aACpD,UAiBA,OAAO,uBAAuB,MAfZ,6BAA6B;EAC7C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU,SAAS,QAAQ;CAC7B,CAAC,CACgC;CAEnC,OAAO,MAAM,4BAA4B;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;AACH"}

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);
+			await 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 {
+				retainedEvents: events,
+				result: {
+					error: event.message,
+					eventCount,
+					result: "error",
+					run_in_background: false,
+					subagent,
+					text: compactText(textParts, textTruncated)
+				}
+			};
+		}
+	} catch (error) {
+		return {
+			retainedEvents: events,
+			result: {
+				error: errorMessage(error),
+				eventCount,
+				result: "error",
+				run_in_background: false,
+				subagent,
+				text: compactText(textParts, textTruncated)
+			}
+		};
+	}
+	return {
+		retainedEvents: 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