@nextclaw/kernel 0.6.19 → 0.6.20

package/dist/index.js

@@ -5,7 +5,7 @@ import { APP_NAME, AgentRouteResolver, BUILTIN_MAIN_AGENT_ID, CLEAR_THINKING_TOK
 import { NCP_AI_EXECUTION_METADATA_KEY, NcpEventType, createUnavailableNcpAiExecutionMetadata, normalizeAssistantText, readNcpAiExecutionMetadata, sanitizeAssistantReplyTags } from "@nextclaw/ncp";
 import { LocalAssetStore, buildAssetContentPath, buildNcpUserContent, buildOpenAiFunctionTool, ncpMessageToOpenAiMessages, validateToolArgs } from "@nextclaw/ncp-agent-runtime";
 import { createHash, createHmac, randomBytes, randomUUID, scryptSync, timingSafeEqual } from "node:crypto";
-import { CHAT_INLINE_TOKENS_METADATA_KEY, CHAT_INLINE_TOKENS_SCHEMA_VERSION, CHAT_PROJECT_TOKEN_KIND, CHAT_SESSION_MATERIALIZATION_METADATA_KEY, CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND, CHAT_WORKSPACE_FILE_TOKEN_KIND, EventBus, Ingress, PANEL_APP_INLINE_HOST_CONTRACT, UI_CONTENT_PARAMS_HOST_CONTRACT, eventKeys, ingressKeys, isRuntimeDefaultModelValue, normalizeRuntimeModelSelectionMode, readInlineContentHeight, readUiContentParams } from "@nextclaw/shared";
+import { CHAT_INLINE_TOKENS_METADATA_KEY, CHAT_INLINE_TOKENS_SCHEMA_VERSION, CHAT_PROJECT_TOKEN_KIND, CHAT_SESSION_MATERIALIZATION_METADATA_KEY, CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND, CHAT_WORKSPACE_FILE_TOKEN_KIND, EventBus, INBOX_DELIVERY_SESSION_METADATA_KEY, Ingress, PANEL_APP_INLINE_HOST_CONTRACT, UI_CONTENT_PARAMS_HOST_CONTRACT, eventKeys, ingressKeys, isRuntimeDefaultModelValue, normalizeRuntimeModelSelectionMode, readInlineContentHeight, readUiContentParams } from "@nextclaw/shared";
 import { catchError, filter, from, lastValueFrom, tap } from "rxjs";
 import { appendFileSync, chmodSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { basename, delimiter, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep } from "node:path";
@@ -693,13 +693,13 @@ function createUnavailableAiExecutionMetadataEvent(params) {
 }
 //#endregion
 //#region src/utils/agent-run-request.utils.ts
-function readOptionalString$11(value) {
+function readOptionalString$12(value) {
 	if (typeof value !== "string") return;
 	return value.trim() || void 0;
 }
 function toAgentRunRequest(envelope) {
 	const metadata = envelope.metadata ?? {};
-	const peerId = readOptionalString$11(envelope.peerId);
+	const peerId = readOptionalString$12(envelope.peerId);
 	const requestMetadata = {
 		agentRuntimeId: metadata.agentRuntimeId,
 		agentId: metadata.agentId,
@@ -712,7 +712,7 @@ function toAgentRunRequest(envelope) {
 		thinkingEffort: metadata.thinkingEffort
 	};
 	if (Array.isArray(envelope.content)) {
-		const sessionId = readOptionalString$11(envelope.sessionId);
+		const sessionId = readOptionalString$12(envelope.sessionId);
 		if (sessionId && peerId) throw new Error("agent-run.send cannot accept both sessionId and peerId.");
 		return {
 			...requestMetadata,
@@ -730,8 +730,8 @@ function toAgentRunRequest(envelope) {
 	}
 	const sourceMessage = envelope.message;
 	if (!sourceMessage) throw new Error("Invalid agent run send request.");
-	const envelopeSessionId = readOptionalString$11(envelope.sessionId);
-	const messageSessionId = readOptionalString$11(sourceMessage.sessionId);
+	const envelopeSessionId = readOptionalString$12(envelope.sessionId);
+	const messageSessionId = readOptionalString$12(sourceMessage.sessionId);
 	const sessionId = envelopeSessionId ?? messageSessionId;
 	if (sessionId && peerId) throw new Error("agent-run.send cannot accept both sessionId and peerId.");
 	return {
@@ -792,7 +792,7 @@ function readSessionMaterialization(metadata) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
 	const materialization = value;
 	if (materialization.kind !== "child") throw new Error("session_materialization.kind must be \"child\".");
-	const parentSessionId = readOptionalString$11(materialization.parentSessionId);
+	const parentSessionId = readOptionalString$12(materialization.parentSessionId);
 	if (!parentSessionId) throw new Error("session_materialization.parentSessionId is required.");
 	if (materialization.inheritContext !== true) throw new Error("session_materialization.inheritContext must be true.");
 	return {
@@ -2737,7 +2737,7 @@ function readString$5(value) {
 function readRecord$1(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function readRequiredString$7(value, name) {
+function readRequiredString$8(value, name) {
 	const trimmed = readString$5(value);
 	if (!trimmed) throw new Error(`${name} is required`);
 	return trimmed;
@@ -2768,9 +2768,9 @@ function readInboundAttachments(value) {
 function toInboundMessage(value) {
 	const payload = readRecord$1(value);
 	return {
-		channel: readRequiredString$7(payload.channelId, "channelId"),
-		chatId: readRequiredString$7(payload.conversationId, "conversationId"),
-		senderId: readRequiredString$7(payload.senderId, "senderId"),
+		channel: readRequiredString$8(payload.channelId, "channelId"),
+		chatId: readRequiredString$8(payload.conversationId, "conversationId"),
+		senderId: readRequiredString$8(payload.senderId, "senderId"),
 		content: readTextContent(payload.content),
 		timestamp: /* @__PURE__ */ new Date(),
 		attachments: readInboundAttachments(payload.attachments),
@@ -2792,7 +2792,7 @@ function normalizeAuthPollResult(value) {
 	if (!value) return null;
 	const record = readRecord$1(value);
 	return {
-		channel: readRequiredString$7(record.channel, "channel"),
+		channel: readRequiredString$8(record.channel, "channel"),
 		status: record.status,
 		message: readString$5(record.message),
 		nextPollMs: readOptionalNumber(record.nextPollMs),
@@ -2890,7 +2890,7 @@ var ExtensionRuntimeService = class {
 		if (running.length > 0) console.log(`✓ Extensions started: ${running.map((entry) => entry.manifest.id).join(", ")}`);
 	};
 	getExtensionProcessToken = (extensionId) => {
-		const id = readRequiredString$7(extensionId, "extensionId");
+		const id = readRequiredString$8(extensionId, "extensionId");
 		const current = this.extensionTokens.get(id);
 		if (current) return current;
 		const token = randomUUID();
@@ -2953,7 +2953,7 @@ var ExtensionRuntimeService = class {
 	};
 	handleChannelConfigGet = (envelope, context) => {
 		this.assertAuthorized(envelope, context);
-		const channelId = readRequiredString$7(readRecord$1(envelope.payload).channelId, "channelId");
+		const channelId = readRequiredString$8(readRecord$1(envelope.payload).channelId, "channelId");
 		return { config: this.options.getConfig().channels[channelId] ?? {} };
 	};
 	handleChannelMessageSubmit = async (envelope, context) => {
@@ -2968,9 +2968,9 @@ var ExtensionRuntimeService = class {
 	handleChannelCommandExecute = async (envelope, context) => {
 		this.assertAuthorized(envelope, context);
 		const payload = readRecord$1(envelope.payload);
-		const channel = readRequiredString$7(payload.channelId, "channelId");
-		const chatId = readRequiredString$7(payload.conversationId, "conversationId");
-		const senderId = readRequiredString$7(payload.senderId, "senderId");
+		const channel = readRequiredString$8(payload.channelId, "channelId");
+		const chatId = readRequiredString$8(payload.conversationId, "conversationId");
+		const senderId = readRequiredString$8(payload.senderId, "senderId");
 		const metadata = readRecord$1(payload.metadata);
 		const config = this.options.getConfig();
 		const registry = new CommandRegistry(config, this.options.sessionManager);
@@ -2997,7 +2997,7 @@ var ExtensionRuntimeService = class {
 			content: "",
 			ephemeral: true
 		};
-		return await registry.execute(readRequiredString$7(payload.commandName, "commandName"), readRecord$1(payload.args), {
+		return await registry.execute(readRequiredString$8(payload.commandName, "commandName"), readRecord$1(payload.args), {
 			channel,
 			chatId,
 			senderId,
@@ -3007,7 +3007,7 @@ var ExtensionRuntimeService = class {
 	handleExtensionResponse = (envelope, context) => {
 		this.assertAuthorized(envelope, context);
 		const payload = readRecord$1(envelope.payload);
-		const requestId = readRequiredString$7(payload.requestId, "requestId");
+		const requestId = readRequiredString$8(payload.requestId, "requestId");
 		const pending = this.pendingRequests.get(requestId);
 		if (!pending) return { accepted: false };
 		this.pendingRequests.delete(requestId);
@@ -3689,6 +3689,228 @@ var LlmUsageManager = class {
 	};
 };
 //#endregion
+//#region src/stores/inbox-delivery.store.ts
+const INBOX_DELIVERY_STORE_VERSION = 1;
+var InboxDeliveryStoreError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "InboxDeliveryStoreError";
+	}
+};
+var InboxDeliveryStore = class {
+	constructor(storePath) {
+		this.storePath = storePath;
+	}
+	list = async () => {
+		try {
+			return this.parseStoreFile(await readFile(this.storePath, "utf8")).deliveries;
+		} catch (error) {
+			if (this.isMissingFileError(error)) return [];
+			if (error instanceof SyntaxError) throw new InboxDeliveryStoreError("inbox delivery store contains invalid JSON");
+			throw error;
+		}
+	};
+	save = async (deliveries) => {
+		const tempPath = `${this.storePath}.${randomUUID()}.tmp`;
+		const storeFile = {
+			version: INBOX_DELIVERY_STORE_VERSION,
+			deliveries: deliveries.map((delivery) => structuredClone(delivery))
+		};
+		await mkdir(dirname(this.storePath), { recursive: true });
+		try {
+			await writeFile(tempPath, `${JSON.stringify(storeFile, null, 2)}\n`, "utf8");
+			await rename(tempPath, this.storePath);
+		} catch (error) {
+			await rm(tempPath, { force: true }).catch(() => void 0);
+			throw error;
+		}
+	};
+	parseStoreFile = (source) => {
+		const value = JSON.parse(source);
+		if (!this.isRecord(value) || value.version !== INBOX_DELIVERY_STORE_VERSION || !Array.isArray(value.deliveries) || !value.deliveries.every(this.isDelivery)) throw new InboxDeliveryStoreError("inbox delivery store has an unsupported structure");
+		return {
+			version: INBOX_DELIVERY_STORE_VERSION,
+			deliveries: value.deliveries.map((delivery) => structuredClone(delivery))
+		};
+	};
+	isDelivery = (value) => {
+		if (!this.isRecord(value) || !this.isSource(value.source)) return false;
+		return typeof value.id === "string" && typeof value.title === "string" && (value.summary === null || typeof value.summary === "string") && typeof value.content === "string" && (value.contentType === "markdown" || value.contentType === "html") && typeof value.createdAt === "string" && typeof value.updatedAt === "string" && this.isOptionalTimestamp(value.presentedAt) && this.isOptionalTimestamp(value.readAt) && this.isOptionalTimestamp(value.archivedAt) && (value.conversationSessionId === null || typeof value.conversationSessionId === "string");
+	};
+	isSource = (value) => this.isRecord(value) && value.kind === "agent" && this.isOptionalString(value.agentId) && this.isOptionalString(value.sessionId) && this.isOptionalString(value.toolCallId) && this.isOptionalString(value.filePath);
+	isOptionalString = (value) => value === null || typeof value === "string";
+	isOptionalTimestamp = (value) => this.isOptionalString(value);
+	isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+	isMissingFileError = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+};
+//#endregion
+//#region src/managers/inbox-delivery.manager.ts
+const MAX_TITLE_LENGTH = 160;
+const MAX_SUMMARY_LENGTH = 500;
+const MAX_INBOX_DELIVERY_CONTENT_LENGTH = 512 * 1024;
+var InboxDeliveryError = class extends Error {
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.name = "InboxDeliveryError";
+	}
+};
+function isInboxDeliveryError(error) {
+	return error instanceof InboxDeliveryError;
+}
+var InboxDeliveryManager = class {
+	store;
+	writeQueue = Promise.resolve();
+	constructor(options) {
+		this.options = options;
+		this.store = new InboxDeliveryStore(options.storePath);
+	}
+	listDeliveries = async () => {
+		await this.writeQueue;
+		const deliveries = (await this.store.list()).sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+		return {
+			deliveries,
+			total: deliveries.length,
+			unreadCount: deliveries.filter((delivery) => !delivery.readAt && !delivery.archivedAt).length,
+			unpresentedCount: deliveries.filter((delivery) => !delivery.presentedAt && !delivery.readAt && !delivery.archivedAt).length
+		};
+	};
+	getDelivery = async (deliveryId) => {
+		await this.writeQueue;
+		const delivery = (await this.store.list()).find(({ id }) => id === deliveryId);
+		return delivery ? structuredClone(delivery) : null;
+	};
+	createDelivery = async (input) => await this.mutate(async () => {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const delivery = {
+			id: randomUUID(),
+			title: this.normalizeRequiredText(input.title, "title", MAX_TITLE_LENGTH),
+			summary: this.normalizeOptionalText(input.summary, "summary", MAX_SUMMARY_LENGTH),
+			content: this.normalizeRequiredText(input.content, "content", MAX_INBOX_DELIVERY_CONTENT_LENGTH),
+			contentType: input.contentType,
+			source: structuredClone(input.source),
+			createdAt: now,
+			updatedAt: now,
+			presentedAt: null,
+			readAt: null,
+			archivedAt: null,
+			conversationSessionId: null
+		};
+		const deliveries = await this.store.list();
+		await this.store.save([delivery, ...deliveries]);
+		this.publishChange(delivery.id, "upsert");
+		return structuredClone(delivery);
+	});
+	updateDeliveryState = async (deliveryId, action) => await this.mutate(async () => {
+		const deliveries = await this.store.list();
+		const index = deliveries.findIndex(({ id }) => id === deliveryId);
+		if (index < 0) throw this.notFound(deliveryId);
+		const current = deliveries[index];
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const next = this.applyStateAction(current, action, now);
+		deliveries[index] = next;
+		await this.store.save(deliveries);
+		this.publishChange(deliveryId, "upsert");
+		return structuredClone(next);
+	});
+	deleteDelivery = async (deliveryId) => await this.mutate(async () => {
+		const deliveries = await this.store.list();
+		const remaining = deliveries.filter(({ id }) => id !== deliveryId);
+		if (remaining.length === deliveries.length) return false;
+		await this.store.save(remaining);
+		this.publishChange(deliveryId, "delete");
+		return true;
+	});
+	continueInChat = async (deliveryId) => await this.mutate(async () => {
+		const deliveries = await this.store.list();
+		const index = deliveries.findIndex(({ id }) => id === deliveryId);
+		if (index < 0) throw this.notFound(deliveryId);
+		const current = deliveries[index];
+		const existingSession = current.conversationSessionId ? await this.options.sessionManager.getSessionRecord(current.conversationSessionId) : null;
+		let sessionId = current.conversationSessionId;
+		let created = false;
+		if (!sessionId || !existingSession) {
+			sessionId = (await this.options.sessionManager.createSession({
+				sourceSessionMetadata: {},
+				metadataOverrides: { [INBOX_DELIVERY_SESSION_METADATA_KEY]: current.id },
+				task: `Continue discussing inbox delivery: ${current.title}`,
+				title: current.title,
+				agentId: current.source.agentId ?? void 0
+			})).sessionId;
+			created = true;
+		}
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const delivery = {
+			...current,
+			updatedAt: now,
+			presentedAt: current.presentedAt ?? now,
+			readAt: current.readAt ?? now,
+			conversationSessionId: sessionId
+		};
+		deliveries[index] = delivery;
+		await this.store.save(deliveries);
+		this.publishChange(deliveryId, "upsert");
+		return {
+			delivery: structuredClone(delivery),
+			sessionId,
+			created
+		};
+	});
+	applyStateAction = (delivery, action, now) => {
+		switch (action) {
+			case "present": return {
+				...delivery,
+				updatedAt: now,
+				presentedAt: delivery.presentedAt ?? now
+			};
+			case "read": return {
+				...delivery,
+				updatedAt: now,
+				presentedAt: delivery.presentedAt ?? now,
+				readAt: delivery.readAt ?? now
+			};
+			case "mark_unread": return {
+				...delivery,
+				updatedAt: now,
+				readAt: null
+			};
+			case "archive": return {
+				...delivery,
+				updatedAt: now,
+				presentedAt: delivery.presentedAt ?? now,
+				archivedAt: delivery.archivedAt ?? now
+			};
+			case "restore": return {
+				...delivery,
+				updatedAt: now,
+				archivedAt: null
+			};
+		}
+	};
+	normalizeRequiredText = (value, field, maxLength) => {
+		const normalized = value.trim();
+		if (!normalized || normalized.length > maxLength) throw new InboxDeliveryError(field === "title" ? "INBOX_DELIVERY_INVALID_TITLE" : "INBOX_DELIVERY_INVALID_CONTENT", `${field} must contain between 1 and ${maxLength} characters`);
+		return normalized;
+	};
+	normalizeOptionalText = (value, field, maxLength) => {
+		const normalized = value?.trim() ?? "";
+		if (normalized.length > maxLength) throw new InboxDeliveryError("INBOX_DELIVERY_INVALID_SUMMARY", `${field} must contain at most ${maxLength} characters`);
+		return normalized || null;
+	};
+	notFound = (deliveryId) => new InboxDeliveryError("INBOX_DELIVERY_NOT_FOUND", `inbox delivery not found: ${deliveryId}`);
+	publishChange = (deliveryId, operation) => {
+		this.options.eventBus.emit(eventKeys.inboxDeliveryChanged, {
+			deliveryId,
+			operation
+		}, { source: "inbox-delivery" });
+	};
+	mutate = (operation) => {
+		const result = this.writeQueue.then(operation, operation);
+		this.writeQueue = result.then(() => void 0, () => void 0);
+		return result;
+	};
+};
+//#endregion
 //#region src/managers/mcp.manager.ts
 var McpManager = class {
 	currentMcpConfig;
@@ -3743,11 +3965,11 @@ function createAgentPeerSessionIdentity(params) {
 }
 function resolveAgentPeerScope(params) {
 	const metadata = params.metadata ?? {};
-	const explicitScope = readOptionalString$10(metadata["agent_peer_scope"]) ?? readOptionalString$10(metadata.agentPeerScope);
+	const explicitScope = readOptionalString$11(metadata["agent_peer_scope"]) ?? readOptionalString$11(metadata.agentPeerScope);
 	if (explicitScope) return explicitScope;
-	return `agent:${readOptionalString$10(params.agentId) ?? BUILTIN_MAIN_AGENT_ID}:${readOptionalString$10(params.channel) ?? readOptionalString$10(metadata.channel) ?? "agent-run"}:${readOptionalString$10(metadata.accountId) ?? readOptionalString$10(metadata.account_id) ?? "default"}`;
+	return `agent:${readOptionalString$11(params.agentId) ?? BUILTIN_MAIN_AGENT_ID}:${readOptionalString$11(params.channel) ?? readOptionalString$11(metadata.channel) ?? "agent-run"}:${readOptionalString$11(metadata.accountId) ?? readOptionalString$11(metadata.account_id) ?? "default"}`;
 }
-function readOptionalString$10(value) {
+function readOptionalString$11(value) {
 	if (typeof value !== "string") return;
 	return value.trim() || void 0;
 }
@@ -4054,7 +4276,7 @@ function applyLimit(items, limit) {
 	if (!Number.isFinite(limit) || typeof limit !== "number" || limit <= 0) return items;
 	return items.slice(0, Math.trunc(limit));
 }
-function readOptionalString$9(value) {
+function readOptionalString$10(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
@@ -4107,7 +4329,7 @@ function mergeMetadataOverrides(metadata, overrides) {
 }
 function resolveSessionType(params) {
 	const { metadata, runtime, sessionType } = params;
-	return readOptionalString$9(runtime) ?? readOptionalString$9(metadata.runtime) ?? readOptionalString$9(sessionType) ?? readOptionalString$9(metadata.session_type) ?? "native";
+	return readOptionalString$10(runtime) ?? readOptionalString$10(metadata.runtime) ?? readOptionalString$10(sessionType) ?? readOptionalString$10(metadata.session_type) ?? "native";
 }
 function applySessionOverrides(params) {
 	const { lifecycle, metadata, model, parentSessionId, projectRoot, requestId, sessionType, thinkingLevel, title } = params;
@@ -4117,15 +4339,15 @@ function applySessionOverrides(params) {
 	metadata[CHILD_SESSION_LIFECYCLE_METADATA_KEY] = lifecycle;
 	if (parentSessionId) metadata[CHILD_SESSION_PARENT_METADATA_KEY] = parentSessionId;
 	if (requestId) metadata[CHILD_SESSION_REQUEST_METADATA_KEY] = requestId;
-	if (readOptionalString$9(model)) {
+	if (readOptionalString$10(model)) {
 		metadata.model = model?.trim();
 		metadata.preferred_model = model?.trim();
 	}
-	if (readOptionalString$9(thinkingLevel)) {
+	if (readOptionalString$10(thinkingLevel)) {
 		metadata.thinking = thinkingLevel?.trim();
 		metadata.preferred_thinking = thinkingLevel?.trim();
 	}
-	if (readOptionalString$9(projectRoot)) metadata.project_root = projectRoot?.trim();
+	if (readOptionalString$10(projectRoot)) metadata.project_root = projectRoot?.trim();
 }
 //#endregion
 //#region src/utils/session-context-inheritance.utils.ts
@@ -4136,7 +4358,7 @@ function hasToolCall(message, toolCallId) {
 	return message.parts.some((part) => part.type === "tool-invocation" && part.toolCallId === toolCallId);
 }
 function findContextInheritanceAnchor(params) {
-	const anchorToolCallId = readOptionalString$9(params.anchorToolCallId);
+	const anchorToolCallId = readOptionalString$10(params.anchorToolCallId);
 	if (!anchorToolCallId) return null;
 	const index = params.messages.findIndex((message) => hasToolCall(message, anchorToolCallId));
 	const message = index >= 0 ? params.messages[index] : void 0;
@@ -4176,7 +4398,7 @@ function createInheritedContextSnapshot(params) {
 			enabled: true,
 			sourceSessionId: sourceRecord.sessionId,
 			anchorKind: anchor ? "tool_call" : "latest_persisted",
-			anchorToolCallId: readOptionalString$9(anchorToolCallId),
+			anchorToolCallId: readOptionalString$10(anchorToolCallId),
 			anchorMessageId: anchor?.message.id,
 			inheritedMessageCount: messages.length
 		}
@@ -4322,7 +4544,7 @@ const SESSION_ACTIVITY_PREVIEW_STATES = new Set([
 function isRecord$10(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function readOptionalString$8(value) {
+function readOptionalString$9(value) {
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
@@ -4330,13 +4552,13 @@ function readOptionalString$8(value) {
 function readSessionActivityPreviewMetadata(value) {
 	if (!isRecord$10(value)) return null;
 	const state = value.state;
-	const timestamp = readOptionalString$8(value.timestamp);
+	const timestamp = readOptionalString$9(value.timestamp);
 	if (!SESSION_ACTIVITY_PREVIEW_STATES.has(state) || !timestamp) return null;
 	return {
 		state,
 		timestamp,
-		...readOptionalString$8(value.statusText) ? { statusText: readOptionalString$8(value.statusText) } : {},
-		...readOptionalString$8(value.replyText) ? { replyText: readOptionalString$8(value.replyText) } : {}
+		...readOptionalString$9(value.statusText) ? { statusText: readOptionalString$9(value.statusText) } : {},
+		...readOptionalString$9(value.replyText) ? { replyText: readOptionalString$9(value.replyText) } : {}
 	};
 }
 function compareIsoTimestamp(left, right) {
@@ -4490,7 +4712,7 @@ var SessionWorkingDirResolver = class {
 		return this.resolveContext(params).effectiveWorkspace;
 	};
 	resolveContext = (params) => {
-		const profile = this.agentManager.resolveAgentProfile(readOptionalString$9(params.agentId));
+		const profile = this.agentManager.resolveAgentProfile(readOptionalString$10(params.agentId));
 		return resolveSessionProjectContext({
 			sessionMetadata: params.metadata,
 			workspace: profile.workspace
@@ -4546,9 +4768,9 @@ var SessionManager = class {
 		const { agentId: requestedAgentId, contextInheritance, metadataOverrides, model, parentSessionId: rawParentSessionId, projectRoot, requestId: rawRequestId, runtime, sessionId: requestedSessionId, sessionType: requestedSessionType, sourceSessionId, sourceSessionMetadata, task, thinkingLevel, title: requestedTitle } = params;
 		const sourceRecord = sourceSessionId ? await this.getSessionRecord(sourceSessionId) : null;
 		const metadata = cloneInheritedMetadata(sourceSessionMetadata);
-		const title = readOptionalString$9(requestedTitle) ?? summarizeTask(task);
-		const parentSessionId = readOptionalString$9(rawParentSessionId);
-		const requestId = readOptionalString$9(rawRequestId);
+		const title = readOptionalString$10(requestedTitle) ?? summarizeTask(task);
+		const parentSessionId = readOptionalString$10(rawParentSessionId);
+		const requestId = readOptionalString$10(rawRequestId);
 		const sessionType = resolveSessionType({
 			runtime,
 			sessionType: requestedSessionType,
@@ -4574,8 +4796,8 @@ var SessionManager = class {
 			if (normalizedProjectRoot) nextMetadata.project_root = normalizedProjectRoot;
 			else delete nextMetadata.project_root;
 		}
-		const agentId = readOptionalString$9(requestedAgentId) ?? readOptionalString$9(sourceRecord?.agentId) ?? BUILTIN_MAIN_AGENT_ID;
-		const sessionId = readOptionalString$9(requestedSessionId) ?? buildSessionId();
+		const agentId = readOptionalString$10(requestedAgentId) ?? readOptionalString$10(sourceRecord?.agentId) ?? BUILTIN_MAIN_AGENT_ID;
+		const sessionId = readOptionalString$10(requestedSessionId) ?? buildSessionId();
 		const inheritedContext = createSessionContextInheritance({
 			childSessionId: sessionId,
 			contextInheritance,
@@ -4670,7 +4892,7 @@ var SessionManager = class {
 		return await this.options.journalStore.getSession(normalizedSessionId);
 	};
 	listSessions = async (options) => {
-		const peerId = readOptionalString$9(options?.peerId);
+		const peerId = readOptionalString$10(options?.peerId);
 		return applyLimit((await this.options.journalStore.listSessionSummaries()).filter((summary) => !peerId || summary.peerId === peerId).map(this.workingDirResolver.withWorkingDir), options?.limit);
 	};
 	listSessionMessages = async (sessionId, options) => {
@@ -4733,9 +4955,9 @@ var SessionManager = class {
 	};
 	createAgentRunSession = async (params) => {
 		const { agentId, agentRuntimeId: requestedAgentRuntimeId, channel, contextInheritance, metadata, model, parentSessionId: rawParentSessionId, peerId: rawPeerId, projectRoot, sessionId, sourceSessionId: rawSourceSessionId, sourceSessionMetadata: requestedSourceSessionMetadata, task, thinkingEffort } = params;
-		const peerId = readOptionalString$9(rawPeerId);
-		const parentSessionId = readOptionalString$9(rawParentSessionId);
-		const sourceSessionId = readOptionalString$9(rawSourceSessionId);
+		const peerId = readOptionalString$10(rawPeerId);
+		const parentSessionId = readOptionalString$10(rawParentSessionId);
+		const sourceSessionId = readOptionalString$10(rawSourceSessionId);
 		const sourceRecord = sourceSessionId ? await this.getSessionRecord(sourceSessionId) : null;
 		const sourceSessionMetadata = requestedSourceSessionMetadata ?? sourceRecord?.metadata ?? {};
 		const agentRuntimeId = requestedAgentRuntimeId ?? readAgentRuntimeId(sourceSessionMetadata) ?? "native";
@@ -4745,7 +4967,7 @@ var SessionManager = class {
 			metadata,
 			peerId
 		}) : void 0;
-		const requestedSessionId = readOptionalString$9(sessionId);
+		const requestedSessionId = readOptionalString$10(sessionId);
 		const created = await this.createSession({
 			contextInheritance,
 			parentSessionId: parentSessionId ?? void 0,
@@ -5928,14 +6150,14 @@ function parsePanelAppFolderManifest(raw) {
 		throw new Error(`panel-app.json is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
 	}
 	if (!isRecord$6(parsed)) throw new Error("panel-app.json must contain an object.");
-	const id = readOptionalString$7(parsed, "id");
+	const id = readOptionalString$8(parsed, "id");
 	if (id && !PANEL_APP_ID_PATTERN.test(id)) throw new Error("panel app id must be kebab-case.");
 	return {
 		id,
-		title: readRequiredString$6(parsed, "title"),
-		description: readOptionalString$7(parsed, "description"),
-		icon: readOptionalString$7(parsed, "icon"),
-		entry: readRequiredString$6(parsed, "entry"),
+		title: readRequiredString$7(parsed, "title"),
+		description: readOptionalString$8(parsed, "description"),
+		icon: readOptionalString$8(parsed, "icon"),
+		entry: readRequiredString$7(parsed, "entry"),
 		capabilities: readStringArray$1(parsed.capabilities, "capabilities"),
 		client: readOptionalBoolean$2(parsed, "client"),
 		serviceActions: readStringArray$1(parsed.actions, "actions")
@@ -5995,12 +6217,12 @@ function parseTokenList(content) {
 	if (!content) return [];
 	return [...new Set(content.split(/[,\s]+/).map((entry) => entry.trim()).filter(Boolean))];
 }
-function readRequiredString$6(record, key) {
-	const value = readOptionalString$7(record, key);
+function readRequiredString$7(record, key) {
+	const value = readOptionalString$8(record, key);
 	if (!value) throw new Error(`panel app ${key} is required.`);
 	return value;
 }
-function readOptionalString$7(record, key) {
+function readOptionalString$8(record, key) {
 	return typeof record[key] === "string" && record[key].trim() ? record[key].trim() : void 0;
 }
 function readOptionalBoolean$2(record, key) {
@@ -7147,17 +7369,17 @@ function parseServiceAppManifest(raw) {
 		throw new Error(`service-app.json is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
 	}
 	if (!isRecord$4(parsed)) throw new Error("service-app.json must contain an object.");
-	const id = readRequiredString$5(parsed, "id");
+	const id = readRequiredString$6(parsed, "id");
 	if (!SERVICE_APP_ID_PATTERN.test(id)) throw new Error("service app id must be kebab-case.");
-	const protocol = readOptionalString$6(parsed, "protocol") ?? "mcp";
+	const protocol = readOptionalString$7(parsed, "protocol") ?? "mcp";
 	if (protocol !== "mcp") throw new Error("service app protocol must be mcp.");
 	return {
 		id,
-		title: readRequiredString$5(parsed, "title"),
-		description: readOptionalString$6(parsed, "description"),
+		title: readRequiredString$6(parsed, "title"),
+		description: readOptionalString$7(parsed, "description"),
 		enabled: readOptionalBoolean$1(parsed, "enabled") ?? true,
 		protocol,
-		command: readRequiredString$5(parsed, "command"),
+		command: readRequiredString$6(parsed, "command"),
 		args: readStringArray(parsed.args, "args"),
 		actions: readManifestActions(parsed.actions)
 	};
@@ -7170,25 +7392,25 @@ function readManifestActions(value) {
 	for (const [name, action] of Object.entries(value)) {
 		if (!name.trim()) throw new Error("service app action name cannot be empty.");
 		if (!isRecord$4(action)) throw new Error(`service app action ${name} must be an object.`);
-		const risk = readOptionalString$6(action, "risk");
+		const risk = readOptionalString$7(action, "risk");
 		if (risk !== void 0 && !SERVICE_ACTION_RISKS.has(risk)) throw new Error(`service app action ${name} has invalid risk.`);
 		const inputSchema = action.inputSchema;
 		if (inputSchema !== void 0 && !isRecord$4(inputSchema)) throw new Error(`service app action ${name} inputSchema must be an object.`);
 		actions[name] = {
 			risk,
-			title: readOptionalString$6(action, "title"),
-			description: readOptionalString$6(action, "description"),
+			title: readOptionalString$7(action, "title"),
+			description: readOptionalString$7(action, "description"),
 			inputSchema
 		};
 	}
 	return actions;
 }
-function readRequiredString$5(record, key) {
-	const value = readOptionalString$6(record, key);
+function readRequiredString$6(record, key) {
+	const value = readOptionalString$7(record, key);
 	if (!value) throw new Error(`service app ${key} is required.`);
 	return value;
 }
-function readOptionalString$6(record, key) {
+function readOptionalString$7(record, key) {
 	return typeof record[key] === "string" && record[key].trim() ? record[key].trim() : void 0;
 }
 function readOptionalBoolean$1(record, key) {
@@ -9206,13 +9428,13 @@ var ProviderManagerNcpLLMApi = class {
 };
 //#endregion
 //#region src/features/native-runtime/tools/ncp-asset.tools.ts
-function readOptionalString$5(value) {
+function readOptionalString$6(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
 }
 function readOptionalBase64Bytes(value) {
-	const base64 = readOptionalString$5(value);
+	const base64 = readOptionalString$6(value);
 	if (!base64) return null;
 	try {
 		return Buffer.from(base64, "base64");
@@ -9263,18 +9485,18 @@ var AssetPutTool = class {
 		this.contentBasePath = contentBasePath;
 	}
 	validateArgs = (args) => {
-		const path = readOptionalString$5(args.path);
-		const bytesBase64 = readOptionalString$5(args.bytesBase64);
-		const fileName = readOptionalString$5(args.fileName);
+		const path = readOptionalString$6(args.path);
+		const bytesBase64 = readOptionalString$6(args.bytesBase64);
+		const fileName = readOptionalString$6(args.fileName);
 		if (path && bytesBase64) return ["Provide either path, or bytesBase64 + fileName, not both."];
 		if (path) return [];
 		if (bytesBase64) return fileName ? [] : ["fileName is required when using bytesBase64."];
 		return ["Provide either path, or bytesBase64 + fileName."];
 	};
 	execute = async (args) => {
-		const path = readOptionalString$5(args?.path);
-		const fileName = readOptionalString$5(args?.fileName);
-		const mimeType = readOptionalString$5(args?.mimeType);
+		const path = readOptionalString$6(args?.path);
+		const fileName = readOptionalString$6(args?.fileName);
+		const mimeType = readOptionalString$6(args?.mimeType);
 		const bytes = readOptionalBase64Bytes(args?.bytesBase64);
 		if (path) return {
 			ok: true,
@@ -9317,8 +9539,8 @@ var AssetExportTool = class {
 		this.assetStore = assetStore;
 	}
 	execute = async (args) => {
-		const assetUri = readOptionalString$5(args?.assetUri);
-		const targetPath = readOptionalString$5(args?.targetPath);
+		const assetUri = readOptionalString$6(args?.assetUri);
+		const targetPath = readOptionalString$6(args?.targetPath);
 		if (!assetUri || !targetPath) throw new Error("asset_export requires assetUri and targetPath.");
 		return {
 			ok: true,
@@ -9344,7 +9566,7 @@ var AssetStatTool = class {
 		this.contentBasePath = contentBasePath;
 	}
 	execute = async (args) => {
-		const assetUri = readOptionalString$5(args?.assetUri);
+		const assetUri = readOptionalString$6(args?.assetUri);
 		if (!assetUri) throw new Error("asset_stat requires assetUri.");
 		const record = await this.assetStore.statRecord(assetUri);
 		if (!record) return {
@@ -9967,6 +10189,30 @@ var CurrentSessionContextProvider = class {
 	};
 };
 //#endregion
+//#region src/contributions/context-provider/providers/inbox-delivery-context.provider.ts
+var InboxDeliveryContextProvider = class {
+	constructor(deliveryManager, sessionManager) {
+		this.deliveryManager = deliveryManager;
+		this.sessionManager = sessionManager;
+	}
+	provide = async (request) => {
+		if (!request.sessionId) return [];
+		const rawDeliveryId = (await this.sessionManager.getSessionRecord(request.sessionId))?.metadata?.[INBOX_DELIVERY_SESSION_METADATA_KEY];
+		if (typeof rawDeliveryId !== "string" || !rawDeliveryId.trim()) return [];
+		const delivery = await this.deliveryManager.getDelivery(rawDeliveryId);
+		if (!delivery) return [];
+		const lines = [
+			"## Inbox Delivery Context",
+			"This chat was opened from a durable inbox delivery. Treat the following content as the shared subject for this conversation.",
+			`Delivery ID: ${delivery.id}`,
+			`Title: ${delivery.title}`
+		];
+		if (delivery.summary) lines.push(`Summary: ${delivery.summary}`);
+		lines.push("", "### Delivered content", delivery.content);
+		return [lines.join("\n")];
+	};
+};
+//#endregion
 //#region src/contributions/context-provider/providers/execution-policy-context.provider.ts
 function normalizeModel(model) {
 	return model?.trim().toLowerCase() ?? "";
@@ -10783,6 +11029,7 @@ var ContextProviderContribution = class {
 			new SkillsContextProvider(context),
 			createSessionOrchestrationContextProvider(),
 			new ExecutionPolicyContextProvider(context),
+			new InboxDeliveryContextProvider(this.kernel.inboxDeliveryManager, this.kernel.sessionManager),
 			new CurrentSessionContextProvider(context),
 			new ReplyFormatContextProvider()
 		]) this.cleanups.push(this.kernel.contextProviderManager.register(provider));
@@ -11127,11 +11374,11 @@ var MessagingToolProvider = class {
 };
 //#endregion
 //#region src/tools/project.tools.ts
-function readRequiredString$4(value, key) {
+function readRequiredString$5(value, key) {
 	if (typeof value !== "string" || !value.trim()) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$4(value) {
+function readOptionalString$5(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 var ProjectsListTool = class {
@@ -11182,9 +11429,9 @@ var ProjectsCreateTool = class {
 	}
 	execute = async (args) => {
 		const params = normalizeToolParams(args);
-		const name = readRequiredString$4(params.name, "name");
-		const rootPath = readOptionalString$4(params.rootPath);
-		const template = readOptionalString$4(params.template);
+		const name = readRequiredString$5(params.name, "name");
+		const rootPath = readOptionalString$5(params.rootPath);
+		const template = readOptionalString$5(params.template);
 		return JSON.stringify(await this.projects.createProject({
 			name,
 			...rootPath ? { rootPath } : {},
@@ -11335,12 +11582,12 @@ var SessionsHistoryTool = class {
 };
 //#endregion
 //#region src/tools/session-request.tools.ts
-function readRequiredString$3(params, key) {
+function readRequiredString$4(params, key) {
 	const value = params[key];
 	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$3(params, key) {
+function readOptionalString$4(params, key) {
 	const value = params[key];
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
@@ -11394,16 +11641,16 @@ var SessionRequestTool = class {
 		const params = normalizeToolParams(args);
 		const target = params.target;
 		if (!target || typeof target !== "object" || Array.isArray(target)) throw new Error("target must be an object.");
-		const task = readRequiredString$3(params, "task");
-		const notifyMode = readOptionalString$3(params, "notify")?.toLowerCase();
+		const task = readRequiredString$4(params, "task");
+		const notifyMode = readOptionalString$4(params, "notify")?.toLowerCase();
 		if (notifyMode !== "none" && notifyMode !== "final_reply") throw new Error("notify must be \"none\" or \"final_reply\".");
 		return this.manager.requestSession({
 			sourceSessionId: this.sourceSessionId,
 			sourceToolCallId: context?.toolCallId,
 			updateToolCallResult: context?.updateToolCallResult,
-			targetSessionId: readRequiredString$3(target, "session_id"),
+			targetSessionId: readRequiredString$4(target, "session_id"),
 			task,
-			title: readOptionalString$3(params, "title"),
+			title: readOptionalString$4(params, "title"),
 			notify: notifyMode,
 			handoffDepth: this.handoffDepth
 		});
@@ -11474,23 +11721,23 @@ var SessionSearchTool = class {
 };
 //#endregion
 //#region src/tools/session-spawn.tools.ts
-function readRequiredString$2(value, key) {
+function readRequiredString$3(value, key) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$2(value) {
+function readOptionalString$3(value) {
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }
 function readSpawnScope(value) {
-	const normalized = readOptionalString$2(value)?.toLowerCase();
+	const normalized = readOptionalString$3(value)?.toLowerCase();
 	if (!normalized || normalized === "standalone") return "standalone";
 	if (normalized === "child") return "child";
 	throw new Error("scope must be \"standalone\" or \"child\".");
 }
 function readSpawnNotify(value) {
-	const notifyMode = readOptionalString$2(value)?.toLowerCase();
+	const notifyMode = readOptionalString$3(value)?.toLowerCase();
 	if (!notifyMode && typeof value === "undefined") return;
 	if (notifyMode === "none" || notifyMode === "final_reply") return notifyMode;
 	throw new Error("notify must be \"none\" or \"final_reply\".");
@@ -11558,7 +11805,7 @@ var SessionSpawnTool = class {
 	};
 	execute = async (args, context) => {
 		const { agentId: rawAgentId, model: rawModel, notify: rawNotify, runtime: rawRuntime, scope: rawScope, task: rawTask, title: rawTitle, inheritContext: rawInheritContext } = normalizeToolParams(args);
-		const task = readRequiredString$2(rawTask, "task");
+		const task = readRequiredString$3(rawTask, "task");
 		const scope = readSpawnScope(rawScope);
 		const notify = readSpawnNotify(rawNotify);
 		const inheritContext = readInheritContext(rawInheritContext);
@@ -11571,10 +11818,10 @@ var SessionSpawnTool = class {
 			updateToolCallResult: context?.updateToolCallResult,
 			sourceSessionMetadata: this.sourceSessionMetadata,
 			task,
-			title: readOptionalString$2(rawTitle),
-			agentId: readOptionalString$2(rawAgentId),
-			model: readOptionalString$2(rawModel),
-			runtime: readOptionalString$2(rawRuntime),
+			title: readOptionalString$3(rawTitle),
+			agentId: readOptionalString$3(rawAgentId),
+			model: readOptionalString$3(rawModel),
+			runtime: readOptionalString$3(rawRuntime),
 			contextInheritance,
 			handoffDepth: this.handoffDepth,
 			parentSessionId,
@@ -11583,11 +11830,11 @@ var SessionSpawnTool = class {
 		const session = await this.sessionManager.createSession({
 			sourceSessionId: this.sourceSessionId,
 			task,
-			title: readOptionalString$2(rawTitle),
+			title: readOptionalString$3(rawTitle),
 			sourceSessionMetadata: this.sourceSessionMetadata,
-			agentId: readOptionalString$2(rawAgentId),
-			model: readOptionalString$2(rawModel),
-			runtime: readOptionalString$2(rawRuntime),
+			agentId: readOptionalString$3(rawAgentId),
+			model: readOptionalString$3(rawModel),
+			runtime: readOptionalString$3(rawRuntime),
 			contextInheritance,
 			parentSessionId
 		});
@@ -11611,7 +11858,7 @@ var SessionSpawnTool = class {
 };
 //#endregion
 //#region src/tools/session-update.tools.ts
-function readRequiredString$1(value, key) {
+function readRequiredString$2(value, key) {
 	if (typeof value !== "string" || !value.trim()) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
@@ -11642,10 +11889,10 @@ var SessionsUpdateTool = class {
 	}
 	execute = async (args) => {
 		const params = normalizeToolParams(args);
-		const sessionKey = readRequiredString$1(params.sessionKey, "sessionKey");
+		const sessionKey = readRequiredString$2(params.sessionKey, "sessionKey");
 		const patch = {};
-		if (Object.prototype.hasOwnProperty.call(params, "label")) patch.label = readRequiredString$1(params.label, "label");
-		if (Object.prototype.hasOwnProperty.call(params, "projectRoot")) patch.projectRoot = readRequiredString$1(params.projectRoot, "projectRoot");
+		if (Object.prototype.hasOwnProperty.call(params, "label")) patch.label = readRequiredString$2(params.label, "label");
+		if (Object.prototype.hasOwnProperty.call(params, "projectRoot")) patch.projectRoot = readRequiredString$2(params.projectRoot, "projectRoot");
 		if (patch.label === void 0 && patch.projectRoot === void 0) throw new Error("label or projectRoot is required.");
 		const session = await this.sessions.patchSessionSettings(sessionKey, patch);
 		if (!session) throw new Error(`Session not found: ${sessionKey}`);
@@ -11701,11 +11948,11 @@ const FILE_VIEWERS = [
 	"source",
 	"rendered"
 ];
-function readRequiredString(value, key) {
+function readRequiredString$1(value, key) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$1(value) {
+function readOptionalString$2(value) {
 	if (typeof value !== "string") return;
 	return value.trim() || void 0;
 }
@@ -11715,14 +11962,14 @@ function readOptionalPositiveInteger(value, key) {
 	return value;
 }
 function readOptionalEnum(value, key, allowed) {
-	const normalized = readOptionalString$1(value);
+	const normalized = readOptionalString$2(value);
 	if (!normalized) return;
 	if (allowed.includes(normalized)) return normalized;
 	const expected = allowed.map((item) => `"${item}"`).join(", ");
 	throw new Error(`${key} must be ${expected}.`);
 }
 function readUrl(value) {
-	const url = readRequiredString(value, "url");
+	const url = readRequiredString$1(value, "url");
 	let parsed;
 	try {
 		parsed = new URL(url);
@@ -11734,13 +11981,13 @@ function readUrl(value) {
 }
 function readCommonRequestFields(params, allowedPurposes) {
 	return {
-		title: readOptionalString$1(params.title),
+		title: readOptionalString$2(params.title),
 		purpose: readOptionalEnum(params.purpose, "purpose", allowedPurposes)
 	};
 }
 function normalizeShowFileArgs(args) {
 	const params = normalizeToolParams(args);
-	const path = readRequiredString(params.path, "path");
+	const path = readRequiredString$1(params.path, "path");
 	const viewer = readOptionalEnum(params.viewer, "viewer", FILE_VIEWERS) ?? "auto";
 	const contentParams = readUiContentParams(params.params);
 	if (contentParams && (viewer === "source" || !/\.html?$/i.test(path))) throw new Error("params are supported only for rendered HTML file previews.");
@@ -11770,14 +12017,14 @@ function normalizeShowUrlArgs(args) {
 }
 function normalizeShowPanelAppArgs(args) {
 	const params = normalizeToolParams(args);
-	const path = readOptionalString$1(params.path);
+	const path = readOptionalString$2(params.path);
 	const contentParams = readUiContentParams(params.params);
 	if (path && !isAbsolute(path)) throw new Error("path must be an absolute path.");
 	return {
 		target: {
 			type: "panel_app",
 			payload: {
-				appId: readRequiredString(params.appId, "appId"),
+				appId: readRequiredString$1(params.appId, "appId"),
 				path,
 				params: contentParams
 			}
@@ -11791,7 +12038,7 @@ function summarizeTarget(target) {
 	return target.payload.appId;
 }
 function createShowContentEventPayload(request, context) {
-	const toolCallId = readOptionalString$1(context?.toolCallId);
+	const toolCallId = readOptionalString$2(context?.toolCallId);
 	return {
 		id: toolCallId ? `tool:${toolCallId}:show-content` : `show-content:${request.target.type}:${summarizeTarget(request.target)}`,
 		toolCallId,
@@ -11941,6 +12188,119 @@ var ShowContentToolProvider = class {
 	provide = () => createShowContentTools(this.eventBus);
 };
 //#endregion
+//#region src/tools/inbox-delivery.tools.ts
+function readRequiredString(value, key) {
+	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
+	return value.trim();
+}
+function readOptionalString$1(value) {
+	if (typeof value !== "string") return null;
+	return value.trim() || null;
+}
+function readContentType(value) {
+	if (value === void 0 || value === null) return null;
+	if (value !== "markdown" && value !== "html") throw new Error("contentType must be markdown or html.");
+	return value;
+}
+function normalizeRequest(args) {
+	const params = normalizeToolParams(args);
+	const content = readOptionalString$1(params.content);
+	const filePath = readOptionalString$1(params.filePath);
+	if (Boolean(content) === Boolean(filePath)) throw new Error("exactly one of content or filePath must be provided.");
+	if (filePath && !isAbsolute(filePath)) throw new Error("filePath must be an absolute path.");
+	const requestedContentType = readContentType(params.contentType);
+	return {
+		title: readRequiredString(params.title, "title"),
+		summary: readOptionalString$1(params.summary),
+		content,
+		contentType: requestedContentType ?? (filePath && [".htm", ".html"].includes(extname(filePath).toLowerCase()) ? "html" : "markdown"),
+		filePath
+	};
+}
+var DeliverToInboxTool = class {
+	name = "deliver_to_inbox";
+	description = "Deliver a durable Markdown or static HTML report, recommendation, or article to the user's NextClaw inbox. Use content for direct text or filePath to snapshot a local UTF-8 text file. Set contentType for direct HTML; .html and .htm files are detected automatically. The user can read it later and continue in a new chat.";
+	parameters = {
+		type: "object",
+		properties: {
+			title: {
+				type: "string",
+				description: "Concise user-facing title, at most 160 characters."
+			},
+			summary: {
+				type: "string",
+				description: "Optional one-paragraph summary, at most 500 characters."
+			},
+			content: {
+				type: "string",
+				description: "Markdown or static HTML content. Provide exactly one of content or filePath."
+			},
+			contentType: {
+				type: "string",
+				enum: ["markdown", "html"],
+				description: "Content format. Defaults to HTML for .html/.htm files and Markdown otherwise."
+			},
+			filePath: {
+				type: "string",
+				description: "Absolute path to a UTF-8 Markdown, HTML, or text file to snapshot."
+			}
+		},
+		required: ["title"],
+		additionalProperties: false
+	};
+	constructor(manager, source) {
+		this.manager = manager;
+		this.source = source;
+	}
+	execute = async (args, context) => {
+		const request = normalizeRequest(args);
+		const content = request.content ?? await this.readFileContent(request.filePath);
+		const delivery = await this.manager.createDelivery({
+			title: request.title,
+			summary: request.summary,
+			content,
+			contentType: request.contentType,
+			source: {
+				kind: "agent",
+				agentId: this.source.agentId,
+				sessionId: this.source.sessionId,
+				toolCallId: readOptionalString$1(context?.toolCallId),
+				filePath: request.filePath
+			}
+		});
+		return {
+			ok: true,
+			deliveryId: delivery.id,
+			title: delivery.title
+		};
+	};
+	readFileContent = async (filePath) => {
+		const file = await stat(filePath);
+		if (!file.isFile()) throw new Error("filePath must point to a regular file.");
+		if (file.size > 524288) throw new Error(`filePath must be at most ${MAX_INBOX_DELIVERY_CONTENT_LENGTH} bytes.`);
+		try {
+			return new TextDecoder("utf-8", { fatal: true }).decode(await readFile(filePath));
+		} catch (error) {
+			if (error instanceof TypeError) throw new Error("filePath must contain valid UTF-8 text.");
+			throw error;
+		}
+	};
+};
+function createInboxDeliveryTools(manager, source) {
+	return [new DeliverToInboxTool(manager, source)];
+}
+//#endregion
+//#region src/contributions/tool-provider/providers/inbox-delivery-tool.provider.ts
+var InboxDeliveryToolProvider = class {
+	constructor(manager) {
+		this.manager = manager;
+	}
+	provide = (request) => createInboxDeliveryTools(this.manager, {
+		agentId: request.agentId ?? null,
+		sessionId: request.sessionId ?? null
+	});
+};
+//#endregion
 //#region src/contributions/tool-provider/providers/structured-result-tool.provider.ts
 var StructuredResultToolProvider = class {
 	provide = (request) => {
@@ -12015,6 +12375,7 @@ var ToolProviderContribution = class {
 		return [
 			new StructuredResultToolProvider(),
 			new ShowContentToolProvider(this.kernel.eventBus),
+			new InboxDeliveryToolProvider(this.kernel.inboxDeliveryManager),
 			new CoreToolProvider(runContextService, this.kernel.getGatewayController),
 			new MessagingToolProvider(runContextService, this.kernel.channels, this.kernel.automation, this.kernel.extensions),
 			new ProjectToolProvider(this.kernel.projectManager),
@@ -12046,6 +12407,11 @@ function resolveKernelProjectStorePath(options) {
 	if (homeDir) return resolve(expandHome(homeDir), "projects", "projects.json");
 	return resolve(getDataDir(), "projects", "projects.json");
 }
+function resolveKernelInboxDeliveryStorePath(options) {
+	const homeDir = options.homeDir?.trim();
+	if (homeDir) return resolve(expandHome(homeDir), "inbox", "deliveries.json");
+	return resolve(getDataDir(), "inbox", "deliveries.json");
+}
 var NextclawKernelControlManager = class {
 	runtimeControl = null;
 	installRuntimeControl = (runtimeControl) => {
@@ -12074,6 +12440,7 @@ var NextclawKernel = class {
 	assetStore;
 	mcpManager;
 	sessionManager;
+	inboxDeliveryManager;
 	panelAppManager;
 	preferenceManager;
 	projectManager;
@@ -12122,6 +12489,11 @@ var NextclawKernel = class {
 			projectManager: this.projectManager,
 			sessionSearch: this.sessionSearch
 		});
+		this.inboxDeliveryManager = new InboxDeliveryManager({
+			eventBus: this.eventBus,
+			sessionManager: this.sessionManager,
+			storePath: resolveKernelInboxDeliveryStorePath(options)
+		});
 		this.panelAppManager = new PanelAppManager({
 			configManager: this.configManager,
 			eventBus: this.eventBus,
@@ -12760,6 +13132,6 @@ function resolveLegacyEventType(message) {
 	return `message.${role || "other"}`;
 }
 //#endregion
-export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessManager, AgentManager, AgentRunClient, AutomationManager, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, CommandRegistry, ConfigManager, ContextCompactionPreflightService, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, ExtensionManager, GatewayInboundProcessor, LlmProviderManager, LlmUsageManager, LlmUsageStore, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PanelAppAssetTokenService, PanelAppError, PanelAppManager, PreferenceError, PreferenceManager, ProjectError, ProjectManager, ProviderManagerNcpLLMApi, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAppError, ServiceAppManager, SessionContextCompactionError, SessionContextCompactionManager, SessionManager, SessionMessageCursorError, SessionRequestManager, SessionSettingsError, SkillManager, UpdateManifestReader, buildAgentRunSendPayload, buildContextCompactionModelInput, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
+export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessManager, AgentManager, AgentRunClient, AutomationManager, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, CommandRegistry, ConfigManager, ContextCompactionPreflightService, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, ExtensionManager, GatewayInboundProcessor, InboxDeliveryError, InboxDeliveryManager, LlmProviderManager, LlmUsageManager, LlmUsageStore, MAX_INBOX_DELIVERY_CONTENT_LENGTH, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PanelAppAssetTokenService, PanelAppError, PanelAppManager, PreferenceError, PreferenceManager, ProjectError, ProjectManager, ProviderManagerNcpLLMApi, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAppError, ServiceAppManager, SessionContextCompactionError, SessionContextCompactionManager, SessionManager, SessionMessageCursorError, SessionRequestManager, SessionSettingsError, SkillManager, UpdateManifestReader, buildAgentRunSendPayload, buildContextCompactionModelInput, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isInboxDeliveryError, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
 
 //# sourceMappingURL=index.js.map