@deepseek-ai/dsh-schedule 0.2.0-rc.2 → 0.2.1-alpha.1

package/lib/index.js

@@ -2,10 +2,10 @@ import { randomUUID } from "node:crypto";
 import z from "@deepseek-ai/schemastery";
 import { Service } from "@deepseek-ai/cordis";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import { delegationDepthOf } from "@deepseek-ai/dsh-subagent";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { Temporal } from "@js-temporal/polyfill";
 import { SessionId, SessionLogOffset } from "@deepseek-ai/dsh-session";
-import { defineTool } from "@deepseek-ai/dsh-tools";
 import { z as z$1 } from "zod";
 import { MessageId } from "@deepseek-ai/dsh-llm/brand";
 import { defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
@@ -42,7 +42,7 @@ var ScheduleLogError = class extends Error {
 		this.name = "ScheduleLogError";
 	}
 };
-/** Error from a model-supplied Schedule rule that cannot become a record. */
+/** Error from a model-supplied Schedule rule or target Session that cannot become a record. */
 var ScheduleInputError = class extends Error {
 	/** Stable public Schedule input code. */
 	code;
@@ -1647,627 +1647,6 @@ var ScheduleRuntime = class {
 	}
 };
 //#endregion
-//#region lib/types/tools.js
-/**
-* Agent-scoped consumers of the shared Host Schedule management service.
-* @module @deepseek-ai/dsh-schedule
-*/
-const SHARED_VIEW_PROPERTIES = {
-	id: {
-		type: "string",
-		required: true
-	},
-	title: {
-		type: "string",
-		required: true
-	},
-	prompt: {
-		type: "string",
-		required: true
-	},
-	scheduledAt: {
-		type: "string",
-		required: true
-	},
-	state: {
-		type: "string",
-		required: true,
-		enum: ["scheduled", "overdue"]
-	},
-	deliveryMode: {
-		type: "string",
-		required: true,
-		const: "host"
-	}
-};
-const VIEW_SCHEMA = { oneOf: [
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "after"
-			},
-			afterSeconds: {
-				type: "integer",
-				required: true
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "at"
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "every"
-			},
-			everySeconds: {
-				type: "integer",
-				required: true
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "daily"
-			},
-			time: {
-				type: "string",
-				required: true
-			},
-			timeZone: {
-				type: "string",
-				required: true
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "weekly"
-			},
-			time: {
-				type: "string",
-				required: true
-			},
-			timeZone: {
-				type: "string",
-				required: true
-			},
-			weekdays: {
-				type: "array",
-				required: true,
-				items: { type: "integer" }
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			...SHARED_VIEW_PROPERTIES,
-			kind: {
-				type: "string",
-				required: true,
-				const: "cron"
-			},
-			expression: {
-				type: "string",
-				required: true
-			},
-			timeZone: {
-				type: "string",
-				required: true
-			}
-		}
-	}
-] };
-/** Build one exact two-field error schema while preserving its literal code. */
-function basicErrorSchema(code) {
-	return {
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			code: {
-				type: "string",
-				required: true,
-				const: code
-			},
-			message: {
-				type: "string",
-				required: true
-			}
-		}
-	};
-}
-const ERROR_SCHEMAS = [
-	basicErrorSchema("invalid_prompt"),
-	basicErrorSchema("invalid_selector"),
-	basicErrorSchema("invalid_rule"),
-	basicErrorSchema("invalid_time_zone"),
-	basicErrorSchema("not_future"),
-	basicErrorSchema("time_out_of_range"),
-	basicErrorSchema("frequency_too_high"),
-	basicErrorSchema("internal_error")
-];
-const CREATE_OUTPUT_SCHEMA = { oneOf: [VIEW_SCHEMA, ...ERROR_SCHEMAS] };
-const LIST_OUTPUT_SCHEMA = { oneOf: [{
-	type: "array",
-	items: VIEW_SCHEMA
-}, ...ERROR_SCHEMAS] };
-const DELETE_OUTPUT_SCHEMA = { oneOf: [
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			id: {
-				type: "string",
-				required: true
-			},
-			deleted: {
-				type: "boolean",
-				required: true,
-				const: true
-			}
-		}
-	},
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			id: {
-				type: "string",
-				required: true
-			},
-			deleted: {
-				type: "boolean",
-				required: true,
-				const: false
-			},
-			code: {
-				type: "string",
-				required: true,
-				const: "schedule_not_found"
-			}
-		}
-	},
-	...ERROR_SCHEMAS
-] };
-const UPDATE_OUTPUT_SCHEMA = { oneOf: [
-	VIEW_SCHEMA,
-	{
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			id: {
-				type: "string",
-				required: true
-			},
-			updated: {
-				type: "boolean",
-				required: true,
-				const: false
-			},
-			code: {
-				type: "string",
-				required: true,
-				enum: [
-					"schedule_not_found",
-					"schedule_ended",
-					"schedule_conflict"
-				]
-			}
-		}
-	},
-	...ERROR_SCHEMAS
-] };
-const CREATE_DESCRIPTION = "Create a reminder in the current session that delivers prompt when it becomes due. Supply exactly one timing parameter: after_seconds, at, every_seconds, daily, weekly, or cron. Local times that do not exist in the zone are skipped; repeated local times fire once, at the earlier instant. After downtime, a recurring reminder delivers only its latest missed occurrence. Delivery can repeat after a crash.";
-const LIST_DESCRIPTION = "List the active reminders in the current session.";
-const DELETE_DESCRIPTION = "Delete a reminder in the current session, active or inactive. Deletion does not retract a reminder message that is already queued.";
-const UPDATE_DESCRIPTION = "Change a reminder in place, keeping its id. Supply a new title, prompt, or at most one timing parameter; omitted fields keep their stored values. To change a relative delay, create a new reminder.";
-/** Deterministic model content for every canonical Schedule value. */
-function renderValue(_args, value) {
-	return [{
-		type: "text",
-		text: JSON.stringify(value)
-	}];
-}
-/** Pure generic pending card. */
-function present(title, kind, rawInput) {
-	return {
-		card: "generic",
-		title,
-		kind,
-		...rawInput === void 0 ? {} : { rawInput }
-	};
-}
-/** Stable error for failures not safe to expose. */
-function internalError() {
-	return {
-		code: "internal_error",
-		message: "The schedule operation failed."
-	};
-}
-/** Translate invalid input while withholding internal storage failures. */
-function operationError(error) {
-	return error instanceof ScheduleInputError ? {
-		code: error.code,
-		message: error.message
-	} : internalError();
-}
-/** One supplied fixed-rate interval: a safe integer at or above the Host floor, or undefined. */
-function invalidInterval(everySeconds) {
-	if (everySeconds === void 0) return void 0;
-	if (!Number.isSafeInteger(everySeconds)) return {
-		code: "invalid_rule",
-		message: "every_seconds must be a safe integer."
-	};
-	if (everySeconds < 60) return {
-		code: "frequency_too_high",
-		message: `every_seconds must be at least 60.`
-	};
-}
-/** Validate selector constraints that the open parameter root cannot express. */
-function validateCreateArgs(args) {
-	if (Object.keys(args).some((key) => key !== "prompt" && key !== "title" && key !== "after_seconds" && key !== "at" && key !== "every_seconds" && key !== "daily" && key !== "weekly" && key !== "cron") || Number(args.after_seconds !== void 0) + Number(args.at !== void 0) + Number(args.every_seconds !== void 0) + Number(args.daily !== void 0) + Number(args.weekly !== void 0) + Number(args.cron !== void 0) !== 1) return {
-		code: "invalid_selector",
-		message: "schedule_create accepts exactly one of after_seconds, at, every_seconds, daily, weekly, or cron."
-	};
-	if (args.prompt.trim().length === 0) return {
-		code: "invalid_prompt",
-		message: "prompt must be non-empty after trimming."
-	};
-	if (args.title.trim().length === 0) return {
-		code: "invalid_prompt",
-		message: REQUIRED_TITLE_MESSAGE
-	};
-	if (args.title.trim().length > 120) return {
-		code: "invalid_prompt",
-		message: `title must be at most 120 characters.`
-	};
-	if (args.after_seconds !== void 0 && (!Number.isSafeInteger(args.after_seconds) || args.after_seconds <= 0)) return {
-		code: "invalid_rule",
-		message: "after_seconds must be a positive safe integer."
-	};
-	return invalidInterval(args.every_seconds);
-}
-/** Validate the in-place update's selector count, id, and any supplied name, instruction, or interval. */
-function validateUpdateArgs(args) {
-	const selectors = [
-		args.at !== void 0,
-		args.every_seconds !== void 0,
-		args.daily !== void 0,
-		args.weekly !== void 0,
-		args.cron !== void 0
-	].filter(Boolean).length;
-	if (Object.keys(args).some((key) => key !== "id" && key !== "title" && key !== "prompt" && key !== "at" && key !== "every_seconds" && key !== "daily" && key !== "weekly" && key !== "cron") || selectors > 1) return {
-		code: "invalid_selector",
-		message: "schedule_update accepts at most one of at, every_seconds, daily, weekly, or cron."
-	};
-	if (args.id.length === 0 || args.id.trim() !== args.id) return {
-		code: "invalid_rule",
-		message: "schedule_update id must be non-empty without surrounding whitespace."
-	};
-	if (selectors === 0 && args.title === void 0 && args.prompt === void 0) return {
-		code: "invalid_selector",
-		message: "schedule_update needs a new title, prompt, or one of at, every_seconds, daily, weekly, or cron."
-	};
-	if (args.title !== void 0 && args.title.trim().length === 0) return {
-		code: "invalid_prompt",
-		message: REQUIRED_TITLE_MESSAGE
-	};
-	if (args.title !== void 0 && args.title.trim().length > 120) return {
-		code: "invalid_prompt",
-		message: `title must be at most 120 characters.`
-	};
-	if (args.prompt !== void 0 && args.prompt.trim().length === 0) return {
-		code: "invalid_prompt",
-		message: "prompt must be non-empty after trimming."
-	};
-	return invalidInterval(args.every_seconds);
-}
-/** The one timing replacement the update carries, or undefined when the request keeps the committed target. */
-function timingChangeFrom(args) {
-	if (args.at !== void 0) return {
-		kind: "at",
-		at: args.at
-	};
-	if (args.every_seconds !== void 0) return {
-		kind: "every",
-		every_seconds: args.every_seconds
-	};
-	if (args.daily !== void 0) return {
-		kind: "daily",
-		daily: args.daily
-	};
-	if (args.weekly !== void 0) return {
-		kind: "weekly",
-		weekly: args.weekly
-	};
-	if (args.cron !== void 0) return {
-		kind: "cron",
-		cron: args.cron
-	};
-}
-/**
-* Selector parameters shared by `schedule_create` and `schedule_update`, in the order the
-* generated tool catalog states them.
-*/
-const SELECTOR_PARAMETERS = {
-	every_seconds: {
-		type: "number",
-		description: `Fixed-rate interval in whole seconds, at least 60, aligned to the creation time; changing it with schedule_update re-aligns it to the save time.`
-	},
-	daily: {
-		type: "object",
-		additionalProperties: false,
-		description: "Every day at a local time.",
-		properties: {
-			time: {
-				type: "string",
-				required: true,
-				description: "HH:mm:ss with optional 1-3 fractional digits, for example 23:00:00."
-			},
-			time_zone: {
-				type: "string",
-				required: true,
-				description: "UTC or IANA Area/Location, for example Asia/Shanghai."
-			}
-		}
-	},
-	weekly: {
-		type: "object",
-		additionalProperties: false,
-		description: "On the given weekdays at a local time.",
-		properties: {
-			time: {
-				type: "string",
-				required: true,
-				description: "HH:mm:ss with optional 1-3 fractional digits, for example 09:00:00."
-			},
-			time_zone: {
-				type: "string",
-				required: true,
-				description: "UTC or IANA Area/Location, for example Asia/Shanghai."
-			},
-			weekdays: {
-				type: "array",
-				required: true,
-				description: "ISO weekdays, Monday 1 through Sunday 7, without repetitions.",
-				items: { type: "integer" }
-			}
-		}
-	},
-	cron: {
-		type: "object",
-		additionalProperties: false,
-		description: "Five-field Vixie cron expression in a time zone.",
-		properties: {
-			expression: {
-				type: "string",
-				required: true,
-				description: "minute hour day-of-month month day-of-week, for example \"*/15 9-17 * * 1-5\". When both day fields are restricted, a date matches if either one matches."
-			},
-			time_zone: {
-				type: "string",
-				required: true,
-				description: "UTC or IANA Area/Location, for example Asia/Shanghai."
-			}
-		}
-	},
-	at: {
-		description: "Absolute target: an RFC 3339 date-time with offset, or a local date, time, and IANA time_zone.",
-		oneOf: [{ type: "string" }, {
-			type: "object",
-			additionalProperties: false,
-			properties: {
-				date: {
-					type: "string",
-					required: true
-				},
-				time: {
-					type: "string",
-					required: true
-				},
-				time_zone: {
-					type: "string",
-					required: true
-				}
-			}
-		}]
-	}
-};
-/**
-* Register all four Schedule tools in one exact agent scope.
-* @param rootCtx - Host context owning the shared Schedule service.
-* @param toolCtx - Exact agent-scoped context receiving the definitions.
-* @param agent - Exact live owner whose session the tools mutate.
-* @returns Idempotent aggregate disposer for the four registrations.
-*/
-function registerScheduleTools(rootCtx, toolCtx, agent) {
-	const disposers = [];
-	try {
-		disposers.push(toolCtx.tools.register(defineTool({
-			name: "schedule_create",
-			description: CREATE_DESCRIPTION,
-			parameters: {
-				prompt: {
-					type: "string",
-					required: true,
-					description: "Reminder content to present when the target becomes due."
-				},
-				title: {
-					type: "string",
-					required: true,
-					description: `Task name of at most 120 characters, shown on the task card and in task lists.`
-				},
-				after_seconds: {
-					type: "number",
-					description: "Delay in whole seconds."
-				},
-				...SELECTOR_PARAMETERS
-			},
-			output: {
-				schema: CREATE_OUTPUT_SCHEMA,
-				render: renderValue
-			},
-			async execute(args, exec) {
-				if (exec.agent !== agent) return internalError();
-				const invalid = validateCreateArgs(args);
-				if (invalid !== void 0) return invalid;
-				if (exec.signal.aborted) return internalError();
-				try {
-					return scheduleView(await rootCtx.schedule.create(agent.session.id, args, exec.signal), Date.now());
-				} catch (error) {
-					return operationError(error);
-				}
-			},
-			presentCall: (args) => present("Create reminder", "other", args.prompt)
-		})));
-		disposers.push(toolCtx.tools.register(defineTool({
-			name: "schedule_list",
-			description: LIST_DESCRIPTION,
-			parameters: {},
-			output: {
-				schema: LIST_OUTPUT_SCHEMA,
-				render: renderValue
-			},
-			async execute(_args, exec) {
-				if (exec.agent !== agent) return internalError();
-				if (exec.signal.aborted) return internalError();
-				try {
-					return (await rootCtx.schedule.list({ sessionId: agent.session.id })).map((record) => scheduleView(record, Date.now()));
-				} catch (error) {
-					return operationError(error);
-				}
-			},
-			presentCall: () => present("List reminders", "read")
-		})));
-		disposers.push(toolCtx.tools.register(defineTool({
-			name: "schedule_delete",
-			description: DELETE_DESCRIPTION,
-			parameters: { id: {
-				type: "string",
-				required: true,
-				description: "Schedule id returned by schedule_list."
-			} },
-			output: {
-				schema: DELETE_OUTPUT_SCHEMA,
-				render: renderValue
-			},
-			async execute(args, exec) {
-				if (args.id.length === 0 || args.id.trim() !== args.id) return {
-					code: "invalid_rule",
-					message: "schedule_delete id must be non-empty without surrounding whitespace."
-				};
-				const id = ScheduleId(args.id);
-				if (exec.agent !== agent) return internalError();
-				if (exec.signal.aborted) return internalError();
-				try {
-					return await rootCtx.schedule.delete({
-						sessionId: agent.session.id,
-						id
-					}, exec.signal);
-				} catch (error) {
-					return operationError(error);
-				}
-			},
-			presentCall: (args) => present("Delete reminder", "other", args.id)
-		})));
-		disposers.push(toolCtx.tools.register(defineTool({
-			name: "schedule_update",
-			description: UPDATE_DESCRIPTION,
-			parameters: {
-				id: {
-					type: "string",
-					required: true,
-					description: "Schedule id returned by schedule_list."
-				},
-				title: {
-					type: "string",
-					description: `New task name of at most 120 characters.`
-				},
-				prompt: {
-					type: "string",
-					description: "New reminder content."
-				},
-				...SELECTOR_PARAMETERS
-			},
-			output: {
-				schema: UPDATE_OUTPUT_SCHEMA,
-				render: renderValue
-			},
-			async execute(args, exec) {
-				if (exec.agent !== agent) return internalError();
-				const invalid = validateUpdateArgs(args);
-				if (invalid !== void 0) return invalid;
-				if (exec.signal.aborted) return internalError();
-				const id = ScheduleId(args.id);
-				try {
-					const sessionId = agent.session.id;
-					const expected = (await rootCtx.schedule.list({ sessionId })).find((record) => record.id === id);
-					if (expected === void 0) return {
-						id,
-						updated: false,
-						code: (await rootCtx.schedule.catalog()).some((entry) => entry.sessionId === sessionId && entry.id === id) ? "schedule_ended" : "schedule_not_found"
-					};
-					const change = timingChangeFrom(args);
-					const result = await rootCtx.schedule.update({
-						sessionId,
-						id,
-						expected,
-						...change === void 0 ? {} : { change },
-						...args.title === void 0 ? {} : { title: args.title },
-						...args.prompt === void 0 ? {} : { prompt: args.prompt }
-					}, exec.signal);
-					return "record" in result ? scheduleView(result.record, Date.now()) : result;
-				} catch (error) {
-					return operationError(error);
-				}
-			},
-			presentCall: (args) => present("Update reminder", "other", args.id)
-		})));
-	} catch (error) {
-		for (const dispose of disposers.reverse()) dispose();
-		throw error;
-	}
-	let active = true;
-	return () => {
-		if (!active) return;
-		active = false;
-		for (const dispose of disposers.reverse()) dispose();
-	};
-}
-//#endregion
 //#region lib/types/storage.js
 /** Durable Host-wide Schedule tasks, independently of Session activation. */
 const recordSchema = z$1.unknown().transform((value, context) => {
@@ -2590,7 +1969,6 @@ let ScheduleService = (() => {
 		static inject = [
 			"agents",
 			"sessions",
-			"tools",
 			"storageDomain",
 			"sessionController",
 			"sessionPersistence"
@@ -2650,22 +2028,6 @@ let ScheduleService = (() => {
 				this.runtime.requestDrive();
 				return cleanup;
 			});
-			const registered = /* @__PURE__ */ new WeakSet();
-			const attached = /* @__PURE__ */ new Map();
-			const attach = (agent) => {
-				if (this.stopping || registered.has(agent) || !ctx.agents.roots().includes(agent)) return;
-				registered.add(agent);
-				attached.set(agent, ctx.effect(() => agent.ctx.effect(() => registerScheduleTools(ctx, agent.ctx, agent))));
-			};
-			ctx.on("agent/created", ({ agent }) => {
-				attach(agent);
-			});
-			ctx.on("agent/disposed", ({ agent }) => {
-				const detach = attached.get(agent);
-				if (detach === void 0) return;
-				attached.delete(agent);
-				detach();
-			});
 			ctx.on("session/created", (session) => {
 				let activeLegacy = 0;
 				try {
@@ -2699,7 +2061,6 @@ let ScheduleService = (() => {
 					activity();
 				};
 			}, "schedule.archiveAdmission()");
-			for (const agent of ctx.agents.roots()) attach(agent);
 		}
 		async [Service.init]() {
 			await this.initialized;
@@ -2709,6 +2070,8 @@ let ScheduleService = (() => {
 		*
 		* The request must supply a title; a missing, blank-after-trim, or over-long
 		* title rejects with `invalid_prompt` instead of deriving one from the prompt.
+		* A Session a delegated child owns rejects with `subagent_session`, because delivery
+		* can never reach it: the child is one whose delegation depth is above zero.
 		* The record is built from the clock reading taken before the request joins the
 		* serialized queue, so a create that waits behind a longer operation keeps its
 		* request-time anchor and may already be due when the queue reaches it.
@@ -2731,6 +2094,8 @@ let ScheduleService = (() => {
 			else if (request.cron !== void 0) record = createCronScheduleRecord(id, request.prompt, request.cron, now, title);
 			else throw new ScheduleInputError("invalid_selector", "Exactly one reminder selector is required.");
 			return this.serialize(async () => {
+				const refusal = this.reminderTargetRefusal(sessionId);
+				if (refusal !== void 0) throw new ScheduleInputError("subagent_session", refusal.message);
 				const domain = await this.getDomain();
 				signal?.throwIfAborted();
 				await domain.table("tasks").put(id, {
@@ -2789,7 +2154,9 @@ let ScheduleService = (() => {
 		* Delete one task belonging to the selected Session, leaving queued messages intact.
 		*
 		* The row is removed: the task no longer schedules, leaves `list` and `catalog`, and its
-		* saved delivery records go with it.
+		* saved delivery records go with it. A task bound to a Session a delegated child owns
+		* stays deletable even though creation and timing edits refuse that binding, so a task
+		* stored before that rule existed remains removable.
 		* @param request - Session and exact task identity.
 		* @param signal - Optional cancellation checked before persistence begins, including after FIFO waits.
 		* @returns Whether that Session owned a deleted task. Cancellation does not roll back an in-flight write.
@@ -2818,14 +2185,19 @@ let ScheduleService = (() => {
 		* binding without activating the Session or changing saved deliveries.
 		*
 		* Each supplied field replaces its stored value; an omitted field keeps it. A name or
-		* instruction change alone does not reset the committed target.
+		* instruction change alone does not reset the committed target. A Session a delegated
+		* child owns returns the non-mutating `subagent_session` result, so an edit cannot
+		* re-arm a task bound to a Session delivery can never reach, and the Web editor can
+		* explain the refusal through the ordinary result it already renders.
 		* @param request - Task binding, complete observed record, and any combination of timing, name, and instruction.
 		* @param signal - Cancellation checked after domain readiness and FIFO waits, before persistence begins.
-		* @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict result.
+		* @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict/refusal result.
 		* Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.
 		*/
 		async update(request, signal) {
 			return this.serialize(async () => {
+				const refusal = this.reminderTargetRefusal(request.sessionId);
+				if (refusal !== void 0) return refusal;
 				const tasks = (await this.getDomain()).table("tasks");
 				signal?.throwIfAborted();
 				const current = tasks.get(request.id);
@@ -2868,6 +2240,26 @@ let ScheduleService = (() => {
 			return this.ready;
 		}
 		/**
+		* Refuse a Session no delivery can reach because a delegated child owns it.
+		*
+		* Delivery resolves the bound Session through `ctx.sessionController.resolveAgent`,
+		* which rejects the live Agent of a delegated child; a stored task for such a Session
+		* would stay permanently overdue and retry on every drive. Both operations that can
+		* arm a delivery read that same fact here instead of restating it: a delegated child
+		* is one whose {@link delegationDepthOf} is above zero, the accounting the delegation
+		* cap itself enforces, which survives a cold resume through the persisted header.
+		* @param sessionId - Session the task would be bound to.
+		* @returns The stable refusal for a delegated child's Session, or undefined when the Session is eligible.
+		*/
+		reminderTargetRefusal(sessionId) {
+			const agent = this.ctx.agents.get(sessionId);
+			if (agent === void 0 || delegationDepthOf(agent) === 0) return void 0;
+			return {
+				code: "subagent_session",
+				message: "This Session belongs to subagent routing, which never receives reminder delivery."
+			};
+		}
+		/**
 		* Remove every active task stored for one Session, inside the queue the tools
 		* use.
 		*
@@ -2907,4 +2299,4 @@ let ScheduleService = (() => {
 	};
 })();
 //#endregion
-export { MAX_TITLE_LENGTH, MIN_EVERY_INTERVAL_SECONDS, SCHEDULE_CHANGE_VERSION, ScheduleId, ScheduleInputError, ScheduleLogError, ScheduleService, ScheduleService as default, canonicalizeCronExpression, createAfterScheduleRecord, createAtScheduleRecord, createCronScheduleRecord, createDailyScheduleRecord, createEveryScheduleRecord, createWeeklyScheduleRecord, decodeScheduleChange, decodeScheduleRecord, foldScheduleEvents, isRecurringScheduleRecord, normalizeWeekdays, parseCronInput, parseWeeklyInput, registerScheduleTools, renderRecurringReminderBatchFraming, renderReminderFraming, resolveCronOccurrence, resolveDailyOccurrence, resolveEveryOccurrence, resolveRecurringOccurrence, resolveWeeklyOccurrence, scheduleDomain, scheduleTitle, scheduleView, weeklyTime };
+export { MAX_TITLE_LENGTH, MIN_EVERY_INTERVAL_SECONDS, REQUIRED_TITLE_MESSAGE, SCHEDULE_CHANGE_VERSION, ScheduleId, ScheduleInputError, ScheduleLogError, ScheduleService, ScheduleService as default, canonicalizeCronExpression, createAfterScheduleRecord, createAtScheduleRecord, createCronScheduleRecord, createDailyScheduleRecord, createEveryScheduleRecord, createWeeklyScheduleRecord, decodeScheduleChange, decodeScheduleRecord, foldScheduleEvents, isRecurringScheduleRecord, normalizeWeekdays, parseCronInput, parseWeeklyInput, renderRecurringReminderBatchFraming, renderReminderFraming, resolveCronOccurrence, resolveDailyOccurrence, resolveEveryOccurrence, resolveRecurringOccurrence, resolveWeeklyOccurrence, scheduleDomain, scheduleTitle, scheduleView, weeklyTime };