@nextclaw/kernel 0.1.15-beta.7 → 0.1.16

package/dist/index.js

@@ -9,7 +9,7 @@ import { catchError, from, lastValueFrom, tap } from "rxjs";
 import { appendFileSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { access, appendFile, mkdir, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
-import { basename, delimiter, dirname, join, relative, resolve } from "node:path";
+import { basename, delimiter, dirname, extname, isAbsolute, join, normalize, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { BUILTIN_PROVIDER_PLUGINS } from "@nextclaw/runtime";
 import { McpRegistryService, McpServerLifecycleManager } from "@nextclaw/mcp";
@@ -572,7 +572,7 @@ var AgentRunContextCompactionManager = class {
 //#region src/managers/agent-run-request.manager.ts
 function toAgentRunRequest(envelope) {
 	const metadata = envelope.metadata ?? {};
-	const peerId = readOptionalString$8(envelope.peerId);
+	const peerId = readOptionalString$9(envelope.peerId);
 	const requestMetadata = {
 		agentRuntimeId: metadata.agentRuntimeId,
 		agentId: metadata.agentId,
@@ -585,7 +585,7 @@ function toAgentRunRequest(envelope) {
 		thinkingEffort: metadata.thinkingEffort
 	};
 	if (Array.isArray(envelope.content)) {
-		const sessionId = readOptionalString$8(envelope.sessionId);
+		const sessionId = readOptionalString$9(envelope.sessionId);
 		if (sessionId && peerId) throw new Error("agent-run.send cannot accept both sessionId and peerId.");
 		return {
 			...requestMetadata,
@@ -603,8 +603,8 @@ function toAgentRunRequest(envelope) {
 	}
 	const sourceMessage = envelope.message;
 	if (!sourceMessage) throw new Error("Invalid agent run send request.");
-	const envelopeSessionId = readOptionalString$8(envelope.sessionId);
-	const messageSessionId = readOptionalString$8(sourceMessage.sessionId);
+	const envelopeSessionId = readOptionalString$9(envelope.sessionId);
+	const messageSessionId = readOptionalString$9(sourceMessage.sessionId);
 	const sessionId = envelopeSessionId ?? messageSessionId;
 	if (sessionId && peerId) throw new Error("agent-run.send cannot accept both sessionId and peerId.");
 	const message = {
@@ -623,7 +623,7 @@ function toAgentRunRequest(envelope) {
 		message
 	};
 }
-function readOptionalString$8(value) {
+function readOptionalString$9(value) {
 	if (typeof value !== "string") return;
 	return value.trim() || void 0;
 }
@@ -1593,7 +1593,7 @@ const runtimeRequire = createRequire(import.meta.url);
 function readString$6(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-function readStringArray$1(value) {
+function readStringArray$2(value) {
 	return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
 }
 function readStringRecord(value) {
@@ -1652,7 +1652,7 @@ function toManifest(value, rootDir) {
 		server: {
 			type: "stdio",
 			command,
-			...readStringArray$1(server.args) ? { args: readStringArray$1(server.args) } : {},
+			...readStringArray$2(server.args) ? { args: readStringArray$2(server.args) } : {},
 			...readStringRecord(server.env) ? { env: readStringRecord(server.env) } : {}
 		},
 		...record.contributes && typeof record.contributes === "object" && !Array.isArray(record.contributes) ? { contributes: record.contributes } : {}
@@ -1753,7 +1753,7 @@ function readString$5(value) {
 function readRecord$2(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function readRequiredString$3(value, name) {
+function readRequiredString$4(value, name) {
 	const trimmed = readString$5(value);
 	if (!trimmed) throw new Error(`${name} is required`);
 	return trimmed;
@@ -1784,9 +1784,9 @@ function readInboundAttachments(value) {
 function toInboundMessage(value) {
 	const payload = readRecord$2(value);
 	return {
-		channel: readRequiredString$3(payload.channelId, "channelId"),
-		chatId: readRequiredString$3(payload.conversationId, "conversationId"),
-		senderId: readRequiredString$3(payload.senderId, "senderId"),
+		channel: readRequiredString$4(payload.channelId, "channelId"),
+		chatId: readRequiredString$4(payload.conversationId, "conversationId"),
+		senderId: readRequiredString$4(payload.senderId, "senderId"),
 		content: readTextContent(payload.content),
 		timestamp: /* @__PURE__ */ new Date(),
 		attachments: readInboundAttachments(payload.attachments),
@@ -1808,7 +1808,7 @@ function normalizeAuthPollResult(value) {
 	if (!value) return null;
 	const record = readRecord$2(value);
 	return {
-		channel: readRequiredString$3(record.channel, "channel"),
+		channel: readRequiredString$4(record.channel, "channel"),
 		status: record.status,
 		message: readString$5(record.message),
 		nextPollMs: readOptionalNumber(record.nextPollMs),
@@ -1955,7 +1955,7 @@ var ExtensionRuntimeService = class {
 	};
 	handleChannelConfigGet = (envelope, context) => {
 		this.assertAuthorized(context);
-		const channelId = readRequiredString$3(readRecord$2(envelope.payload).channelId, "channelId");
+		const channelId = readRequiredString$4(readRecord$2(envelope.payload).channelId, "channelId");
 		return { config: this.options.getConfig().channels[channelId] ?? {} };
 	};
 	handleChannelMessageSubmit = async (envelope, context) => {
@@ -1970,9 +1970,9 @@ var ExtensionRuntimeService = class {
 	handleChannelCommandExecute = async (envelope, context) => {
 		this.assertAuthorized(context);
 		const payload = readRecord$2(envelope.payload);
-		const channel = readRequiredString$3(payload.channelId, "channelId");
-		const chatId = readRequiredString$3(payload.conversationId, "conversationId");
-		const senderId = readRequiredString$3(payload.senderId, "senderId");
+		const channel = readRequiredString$4(payload.channelId, "channelId");
+		const chatId = readRequiredString$4(payload.conversationId, "conversationId");
+		const senderId = readRequiredString$4(payload.senderId, "senderId");
 		const metadata = readRecord$2(payload.metadata);
 		const config = this.options.getConfig();
 		const registry = new CommandRegistry(config, this.options.sessionManager);
@@ -1999,7 +1999,7 @@ var ExtensionRuntimeService = class {
 			content: "",
 			ephemeral: true
 		};
-		return await registry.execute(readRequiredString$3(payload.commandName, "commandName"), readRecord$2(payload.args), {
+		return await registry.execute(readRequiredString$4(payload.commandName, "commandName"), readRecord$2(payload.args), {
 			channel,
 			chatId,
 			senderId,
@@ -2009,7 +2009,7 @@ var ExtensionRuntimeService = class {
 	handleExtensionResponse = (envelope, context) => {
 		this.assertAuthorized(context);
 		const payload = readRecord$2(envelope.payload);
-		const requestId = readRequiredString$3(payload.requestId, "requestId");
+		const requestId = readRequiredString$4(payload.requestId, "requestId");
 		const pending = this.pendingRequests.get(requestId);
 		if (!pending) return { accepted: false };
 		this.pendingRequests.delete(requestId);
@@ -2183,11 +2183,11 @@ var ExtensionManager = class {
 //#endregion
 //#region src/utils/model-message-vision.utils.ts
 const IMAGE_OMITTED_TEXT = "[Image omitted: the selected model is not configured for vision input.]";
-function isRecord$9(value) {
+function isRecord$10(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function isImageContentPart(value) {
-	if (!isRecord$9(value)) return false;
+	if (!isRecord$10(value)) return false;
 	const type = value.type;
 	return type === "image_url" || type === "input_image";
 }
@@ -2203,7 +2203,7 @@ function normalizeContentWithoutVision(content) {
 		};
 	});
 	if (!sawImage) return content;
-	const textParts = parts.filter((part) => isRecord$9(part) && part.type === "text" && typeof part.text === "string").map((part) => part.text.trim()).filter(Boolean);
+	const textParts = parts.filter((part) => isRecord$10(part) && part.type === "text" && typeof part.text === "string").map((part) => part.text.trim()).filter(Boolean);
 	if (textParts.length === parts.length) return textParts.join("\n\n");
 	return parts;
 }
@@ -2698,7 +2698,7 @@ function safeNcpSessionFilename(value) {
 function normalizeNcpAgentId(agentId) {
 	return agentId?.trim().toLowerCase() || void 0;
 }
-function isRecord$8(value) {
+function isRecord$9(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function toIsoString(value, fallback) {
@@ -2809,11 +2809,11 @@ function createAgentPeerSessionIdentity(params) {
 }
 function resolveAgentPeerScope(params) {
 	const metadata = params.metadata ?? {};
-	const explicitScope = readOptionalString$7(metadata["agent_peer_scope"]) ?? readOptionalString$7(metadata.agentPeerScope);
+	const explicitScope = readOptionalString$8(metadata["agent_peer_scope"]) ?? readOptionalString$8(metadata.agentPeerScope);
 	if (explicitScope) return explicitScope;
-	return `agent:${readOptionalString$7(params.agentId) ?? BUILTIN_MAIN_AGENT_ID}:${readOptionalString$7(params.channel) ?? readOptionalString$7(metadata.channel) ?? "agent-run"}:${readOptionalString$7(metadata.accountId) ?? readOptionalString$7(metadata.account_id) ?? "default"}`;
+	return `agent:${readOptionalString$8(params.agentId) ?? BUILTIN_MAIN_AGENT_ID}:${readOptionalString$8(params.channel) ?? readOptionalString$8(metadata.channel) ?? "agent-run"}:${readOptionalString$8(metadata.accountId) ?? readOptionalString$8(metadata.account_id) ?? "default"}`;
 }
-function readOptionalString$7(value) {
+function readOptionalString$8(value) {
 	if (typeof value !== "string") return;
 	return value.trim() || void 0;
 }
@@ -2832,7 +2832,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$6(value) {
+function readOptionalString$7(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
@@ -2883,7 +2883,7 @@ function mergeMetadataOverrides(metadata, overrides) {
 }
 function resolveSessionType(params) {
 	const { metadata, runtime, sessionType } = params;
-	return readOptionalString$6(runtime) ?? readOptionalString$6(metadata.runtime) ?? readOptionalString$6(sessionType) ?? readOptionalString$6(metadata.session_type) ?? DEFAULT_SESSION_TYPE;
+	return readOptionalString$7(runtime) ?? readOptionalString$7(metadata.runtime) ?? readOptionalString$7(sessionType) ?? readOptionalString$7(metadata.session_type) ?? DEFAULT_SESSION_TYPE;
 }
 function applySessionOverrides(params) {
 	const { lifecycle, metadata, model, parentSessionId, projectRoot, requestId, sessionType, thinkingLevel, title } = params;
@@ -2893,15 +2893,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$6(model)) {
+	if (readOptionalString$7(model)) {
 		metadata.model = model?.trim();
 		metadata.preferred_model = model?.trim();
 	}
-	if (readOptionalString$6(thinkingLevel)) {
+	if (readOptionalString$7(thinkingLevel)) {
 		metadata.thinking = thinkingLevel?.trim();
 		metadata.preferred_thinking = thinkingLevel?.trim();
 	}
-	if (readOptionalString$6(projectRoot)) metadata.project_root = projectRoot?.trim();
+	if (readOptionalString$7(projectRoot)) metadata.project_root = projectRoot?.trim();
 }
 function isSessionSummaryRefreshEvent(event) {
 	switch (event.type) {
@@ -2941,9 +2941,9 @@ var SessionManager = class {
 		const { agentId: requestedAgentId, 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$6(requestedTitle) ?? summarizeTask(task);
-		const parentSessionId = readOptionalString$6(rawParentSessionId);
-		const requestId = readOptionalString$6(rawRequestId);
+		const title = readOptionalString$7(requestedTitle) ?? summarizeTask(task);
+		const parentSessionId = readOptionalString$7(rawParentSessionId);
+		const requestId = readOptionalString$7(rawRequestId);
 		const sessionType = resolveSessionType({
 			runtime,
 			sessionType: requestedSessionType,
@@ -2962,8 +2962,8 @@ var SessionManager = class {
 		});
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		const nextMetadata = mergeMetadataOverrides(metadata, metadataOverrides);
-		const agentId = readOptionalString$6(requestedAgentId) ?? readOptionalString$6(sourceRecord?.agentId) ?? BUILTIN_MAIN_AGENT_ID;
-		const sessionId = readOptionalString$6(requestedSessionId) ?? buildSessionId();
+		const agentId = readOptionalString$7(requestedAgentId) ?? readOptionalString$7(sourceRecord?.agentId) ?? BUILTIN_MAIN_AGENT_ID;
+		const sessionId = readOptionalString$7(requestedSessionId) ?? buildSessionId();
 		const record = {
 			sessionId,
 			...agentId ? { agentId } : {},
@@ -3068,14 +3068,14 @@ var SessionManager = class {
 	createAgentRunSession = async (params) => {
 		const { agentId, agentRuntimeId: requestedAgentRuntimeId, channel, metadata, model, peerId: rawPeerId, projectRoot, sessionId, task, thinkingEffort } = params;
 		const agentRuntimeId = requestedAgentRuntimeId ?? "native";
-		const peerId = readOptionalString$6(rawPeerId);
+		const peerId = readOptionalString$7(rawPeerId);
 		const peerIdentity = peerId ? createAgentPeerSessionIdentity({
 			agentId,
 			channel,
 			metadata,
 			peerId
 		}) : void 0;
-		const requestedSessionId = readOptionalString$6(sessionId);
+		const requestedSessionId = readOptionalString$7(sessionId);
 		const created = await this.createSession({
 			sourceSessionMetadata: {},
 			sessionId: requestedSessionId ?? peerIdentity?.sessionId,
@@ -3291,7 +3291,7 @@ var PanelAppCapabilityGrantStore = class {
 		try {
 			return normalizeStoreData$1(JSON.parse(await readFile(this.filePath, "utf8")));
 		} catch (error) {
-			if (isMissingFileError$1(error)) return structuredClone(EMPTY_GRANTS$1);
+			if (isMissingFileError$2(error)) return structuredClone(EMPTY_GRANTS$1);
 			throw error;
 		}
 	};
@@ -3301,12 +3301,12 @@ var PanelAppCapabilityGrantStore = class {
 	};
 };
 function normalizeStoreData$1(value) {
-	if (!isRecord$7(value) || value.version !== 1 || !isRecord$7(value.grants)) return structuredClone(EMPTY_GRANTS$1);
+	if (!isRecord$8(value) || value.version !== 1 || !isRecord$8(value.grants)) return structuredClone(EMPTY_GRANTS$1);
 	const grants = {};
 	for (const [callerKey, callerValue] of Object.entries(value.grants)) {
-		if (!isRecord$7(callerValue) || !isRecord$7(callerValue.capabilities)) continue;
+		if (!isRecord$8(callerValue) || !isRecord$8(callerValue.capabilities)) continue;
 		const capabilities = {};
-		for (const [capability, grantValue] of Object.entries(callerValue.capabilities)) if (isRecord$7(grantValue) && typeof grantValue.grantedAt === "string") capabilities[capability] = { grantedAt: grantValue.grantedAt };
+		for (const [capability, grantValue] of Object.entries(callerValue.capabilities)) if (isRecord$8(grantValue) && typeof grantValue.grantedAt === "string") capabilities[capability] = { grantedAt: grantValue.grantedAt };
 		grants[callerKey] = { capabilities };
 	}
 	return {
@@ -3317,10 +3317,10 @@ function normalizeStoreData$1(value) {
 function getCallerKey(caller) {
 	return `${caller.surface}:${caller.appId}`;
 }
-function isRecord$7(value) {
+function isRecord$8(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function isMissingFileError$1(error) {
+function isMissingFileError$2(error) {
 	return Boolean(error) && typeof error === "object" && error.code === "ENOENT";
 }
 //#endregion
@@ -3335,8 +3335,9 @@ var PanelAppError = class extends Error {
 function isPanelAppError(error) {
 	return error instanceof PanelAppError;
 }
+const PANEL_APP_AGENT_CAPABILITIES = ["agent:send", "agent:generateObject"];
 function isPanelAppAgentCapability(value) {
-	return value === "agent:send" || value === "agent:generateObject";
+	return PANEL_APP_AGENT_CAPABILITIES.includes(value);
 }
 //#endregion
 //#region src/services/agent-run-client.service.ts
@@ -3611,6 +3612,7 @@ function getPanelAppBridgeScript() {
 }
 //#endregion
 //#region src/utils/panel-app-manifest.utils.ts
+const PANEL_APP_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 function parsePanelAppManifest(html) {
 	return {
 		...readHtmlTitle(html),
@@ -3620,6 +3622,26 @@ function parsePanelAppManifest(html) {
 		serviceActions: readPanelAppServiceActions(html)
 	};
 }
+function parsePanelAppFolderManifest(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch (error) {
+		throw new Error(`panel-app.json is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (!isRecord$7(parsed)) throw new Error("panel-app.json must contain an object.");
+	const id = readOptionalString$6(parsed, "id");
+	if (id && !PANEL_APP_ID_PATTERN.test(id)) throw new Error("panel app id must be kebab-case.");
+	return {
+		id,
+		title: readRequiredString$3(parsed, "title"),
+		description: readOptionalString$6(parsed, "description"),
+		icon: readOptionalString$6(parsed, "icon"),
+		entry: readRequiredString$3(parsed, "entry"),
+		capabilities: readStringArray$1(parsed.capabilities, "capabilities"),
+		serviceActions: readStringArray$1(parsed.actions, "actions")
+	};
+}
 function readPanelAppMeta(html) {
 	return {
 		...readPanelAppMetaField(html, "title"),
@@ -3674,6 +3696,22 @@ function parseTokenList(content) {
 	if (!content) return [];
 	return [...new Set(content.split(/[,\s]+/).map((entry) => entry.trim()).filter(Boolean))];
 }
+function readRequiredString$3(record, key) {
+	const value = readOptionalString$6(record, key);
+	if (!value) throw new Error(`panel app ${key} is required.`);
+	return value;
+}
+function readOptionalString$6(record, key) {
+	return typeof record[key] === "string" && record[key].trim() ? record[key].trim() : void 0;
+}
+function readStringArray$1(value, key) {
+	if (value === void 0) return [];
+	if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) throw new Error(`panel app ${key} must be a string array.`);
+	return [...new Set(value.map((entry) => entry.trim()).filter(Boolean))];
+}
+function isRecord$7(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function normalizeTextValue(value) {
 	return decodeHtmlAttribute(value ?? "").replace(/\s+/g, " ").trim() || void 0;
 }
@@ -3687,6 +3725,169 @@ function normalizeIconHref(value) {
 function decodeHtmlAttribute(value) {
 	return value.replace(/&quot;/g, "\"").replace(/&#34;/g, "\"").replace(/&apos;/g, "'").replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
 }
+const PANEL_APP_FOLDER_MANIFEST_FILE_NAME = "panel-app.json";
+function isPanelAppSourceEntry(entry) {
+	return entry.isFile() && isPanelAppFileName(entry.name) || entry.isDirectory() && isPanelAppDirName(entry.name);
+}
+function isPanelAppFileName(fileName) {
+	return hasSafeBaseName(fileName) && fileName.endsWith(".panel.html");
+}
+function isPanelAppDirName(dirName) {
+	return hasSafeBaseName(dirName) && dirName.endsWith(".panel");
+}
+function toPanelAppTitle(sourceName) {
+	return sourceName.replace(new RegExp(`${escapeRegExp(".panel.html")}$`), "").replace(new RegExp(`${escapeRegExp(".panel")}$`), "").replace(/[-_]+/g, " ").trim() || sourceName;
+}
+function encodePanelAppId(sourceName) {
+	return Buffer.from(sourceName, "utf8").toString("base64url");
+}
+function decodePanelAppId(id) {
+	const normalizedId = id.trim();
+	if (!normalizedId) throw new PanelAppError("PANEL_APP_INVALID_ID", "panel app id is required");
+	let sourceName = "";
+	try {
+		sourceName = Buffer.from(normalizedId, "base64url").toString("utf8");
+	} catch {
+		throw new PanelAppError("PANEL_APP_INVALID_ID", "invalid panel app id");
+	}
+	if (encodePanelAppId(sourceName) !== normalizedId || !isPanelAppFileName(sourceName) && !isPanelAppDirName(sourceName)) throw new PanelAppError("PANEL_APP_INVALID_ID", "invalid panel app id");
+	return sourceName;
+}
+async function readPanelAppFolderManifest(dirPath, dirName) {
+	const manifest = parsePanelAppFolderManifest(await readFile(join(dirPath, PANEL_APP_FOLDER_MANIFEST_FILE_NAME), "utf8"));
+	const expectedId = dirName.slice(0, -6);
+	if (manifest.id && manifest.id !== expectedId) throw new PanelAppError("PANEL_APP_MANIFEST_INVALID", "panel app manifest id must match the directory name");
+	return {
+		...manifest,
+		id: expectedId
+	};
+}
+function resolvePanelAppRelativePath(rootPath, relativePath) {
+	if (!relativePath.trim() || relativePath.includes("\0") || isAbsolute(relativePath)) throw new PanelAppError("PANEL_APP_INVALID_ASSET_PATH", "invalid panel app asset path");
+	const normalizedPath = normalize(relativePath);
+	if (normalizedPath === "." || normalizedPath.startsWith("..")) throw new PanelAppError("PANEL_APP_INVALID_ASSET_PATH", "invalid panel app asset path");
+	const resolvedPath = resolve(rootPath, normalizedPath);
+	const pathFromRoot = relative(resolve(rootPath), resolvedPath);
+	if (pathFromRoot.startsWith("..") || isAbsolute(pathFromRoot)) throw new PanelAppError("PANEL_APP_INVALID_ASSET_PATH", "invalid panel app asset path");
+	return resolvedPath;
+}
+function resolvePanelAppAssetContentType(path) {
+	switch (extname(path).toLowerCase()) {
+		case ".css": return "text/css; charset=utf-8";
+		case ".js":
+		case ".mjs": return "application/javascript; charset=utf-8";
+		case ".json": return "application/json; charset=utf-8";
+		case ".png": return "image/png";
+		case ".svg": return "image/svg+xml; charset=utf-8";
+		case ".webp": return "image/webp";
+		case ".txt": return "text/plain; charset=utf-8";
+		default: return "application/octet-stream";
+	}
+}
+function resolvePanelAppIconUrl(id, icon) {
+	if (!icon) return;
+	if (icon.startsWith("data:image/") || icon.startsWith("http://") || icon.startsWith("https://") || icon.startsWith("/") || isLikelyTextIcon(icon)) return icon;
+	return `/api/panel-apps/${encodeURIComponent(id)}/assets/${encodePanelAppAssetPath(icon)}`;
+}
+function injectPanelAppAssetBase(html, id) {
+	const base = `<base href="/api/panel-apps/${encodeURIComponent(id)}/assets/">`;
+	if (/<base\b/i.test(html)) return html;
+	if (/<head[^>]*>/i.test(html)) return html.replace(/<head[^>]*>/i, (head) => `${head}${base}`);
+	return `${base}${html}`;
+}
+function encodePanelAppAssetPath(path) {
+	return path.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
+function hasSafeBaseName(name) {
+	return !name.includes("/") && !name.includes("\\") && !name.includes("\0");
+}
+function isLikelyTextIcon(icon) {
+	return !icon.includes("/") && !icon.includes(".") && icon.length <= 4;
+}
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//#endregion
+//#region src/services/panel-app-source.service.ts
+var PanelAppSourceService = class {
+	listSources = async (panelsPath) => {
+		try {
+			const entries = await readdir(panelsPath, { withFileTypes: true });
+			const sources = [];
+			for (const entry of entries.filter(isPanelAppSourceEntry)) try {
+				sources.push(await this.readSource(panelsPath, entry.name));
+			} catch (error) {
+				if (!isPanelAppError(error) || error.code !== "PANEL_APP_NOT_FOUND") throw error;
+			}
+			return sources;
+		} catch (error) {
+			if (isPanelAppError(error)) throw error;
+			if (isMissingFileError$1(error)) return [];
+			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
+		}
+	};
+	resolveSource = async (panelsPath, id) => {
+		const sourceName = decodePanelAppId(id);
+		try {
+			return await this.readSource(panelsPath, sourceName);
+		} catch (error) {
+			if (isPanelAppError(error)) throw error;
+			if (isMissingFileError$1(error)) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
+			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
+		}
+	};
+	getAsset = async (panelsPath, id, assetPath) => {
+		const source = await this.resolveSource(panelsPath, id);
+		if (source.kind !== "folder") throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app asset not found");
+		const filePath = resolvePanelAppRelativePath(source.sourcePath, assetPath);
+		try {
+			if (!(await stat(filePath)).isFile()) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app asset not found");
+			return {
+				content: await readFile(filePath),
+				contentType: resolvePanelAppAssetContentType(filePath)
+			};
+		} catch (error) {
+			if (isPanelAppError(error)) throw error;
+			if (isMissingFileError$1(error)) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app asset not found");
+			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
+		}
+	};
+	readSource = async (panelsPath, sourceName) => {
+		const sourcePath = join(panelsPath, sourceName);
+		const sourceStat = await stat(sourcePath);
+		if (sourceStat.isFile() && isPanelAppFileName(sourceName)) return {
+			kind: "single-file",
+			sourceName,
+			sourcePath,
+			entryPath: sourcePath,
+			sourceStat
+		};
+		if (sourceStat.isDirectory() && isPanelAppDirName(sourceName)) return await this.readFolderSource(sourcePath, sourceName, sourceStat);
+		throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
+	};
+	readFolderSource = async (sourcePath, sourceName, sourceStat) => {
+		try {
+			const manifest = await readPanelAppFolderManifest(sourcePath, sourceName);
+			const entryPath = resolvePanelAppRelativePath(sourcePath, manifest.entry);
+			if (!(await stat(entryPath)).isFile()) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app entry not found");
+			return {
+				kind: "folder",
+				sourceName,
+				sourcePath,
+				entryPath,
+				manifest,
+				sourceStat
+			};
+		} catch (error) {
+			if (isPanelAppError(error)) throw error;
+			if (isMissingFileError$1(error)) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
+			throw new PanelAppError("PANEL_APP_MANIFEST_INVALID", error instanceof Error ? error.message : String(error));
+		}
+	};
+};
+function isMissingFileError$1(error) {
+	return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
 //#endregion
 //#region src/utils/panel-app-time.utils.ts
 function resolvePanelAppCreatedAt(fileStat) {
@@ -3881,13 +4082,13 @@ function isRecord$6(value) {
 }
 //#endregion
 //#region src/managers/panel-app.manager.ts
-const PANEL_APP_FILE_SUFFIX = ".panel.html";
 const PANEL_APP_CONTENT_BASE_PATH = "/api/panel-apps";
 const PANEL_APP_CONTENT_TYPE = "text/html; charset=utf-8";
 const PANEL_APP_CAPABILITY_GRANTS_FILE_NAME = ".panel-app-capability-grants.json";
 var PanelAppManager = class {
 	bridgeSessions = /* @__PURE__ */ new Map();
 	agentRunClient;
+	sourceService = new PanelAppSourceService();
 	constructor(params) {
 		this.params = params;
 		this.agentRunClient = params.agentRunClient ?? (params.eventBus && params.ingress ? new AgentRunClient({
@@ -3898,25 +4099,26 @@ var PanelAppManager = class {
 	listPanelApps = async () => {
 		const workspacePath = this.getWorkspacePath();
 		const panelsPath = this.getPanelsPath(workspacePath);
-		const fileNames = await this.listPanelAppFileNames(panelsPath);
+		const sources = await this.sourceService.listSources(panelsPath);
 		const appState = await this.createStateStore(panelsPath).load();
 		return {
 			workspacePath,
 			panelsPath,
-			entries: (await Promise.all(fileNames.map((fileName) => this.buildPanelAppEntry(panelsPath, fileName, appState[this.encodePanelAppId(fileName)] ?? {})))).sort(this.comparePanelApps)
+			entries: (await Promise.all(sources.map((source) => this.buildPanelAppEntry(source, appState[encodePanelAppId(source.sourceName)] ?? {})))).sort(this.comparePanelApps)
 		};
 	};
 	getPanelAppContent = async (id) => {
-		const fileName = this.decodePanelAppId(id);
-		const filePath = join(this.getPanelsPath(this.getWorkspacePath()), fileName);
+		const panelsPath = this.getPanelsPath(this.getWorkspacePath());
 		try {
-			if (!(await stat(filePath)).isFile()) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
-			const html = await readFile(filePath, "utf8");
-			const manifest = parsePanelAppManifest(html);
+			const source = await this.sourceService.resolveSource(panelsPath, id);
+			const html = await readFile(source.entryPath, "utf8");
+			const manifest = source.manifest ?? parsePanelAppManifest(html);
+			const sourceId = encodePanelAppId(source.sourceName);
+			const htmlWithBase = source.kind === "folder" ? injectPanelAppAssetBase(html, sourceId) : html;
 			return {
-				id: this.encodePanelAppId(fileName),
-				fileName,
-				html: injectPanelAppBridgeScript(html),
+				id: sourceId,
+				fileName: source.sourceName,
+				html: injectPanelAppBridgeScript(htmlWithBase),
 				capabilities: manifest.capabilities,
 				contentType: PANEL_APP_CONTENT_TYPE,
 				serviceActions: manifest.serviceActions
@@ -3927,6 +4129,10 @@ var PanelAppManager = class {
 			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
 		}
 	};
+	getPanelAppAsset = async (id, assetPath) => {
+		const panelsPath = this.getPanelsPath(this.getWorkspacePath());
+		return await this.sourceService.getAsset(panelsPath, id, assetPath);
+	};
 	getPanelAppBridgeScript = () => getPanelAppBridgeScript();
 	createPanelAppBridgeSession = async (params) => {
 		const content = await this.getPanelAppContent(params.id);
@@ -3996,20 +4202,20 @@ var PanelAppManager = class {
 	updatePanelAppPreferences = async (id, preferences) => {
 		const fileName = await this.resolvePanelAppFileName(id);
 		const panelsPath = this.getPanelsPath(this.getWorkspacePath());
-		const state = await this.createStateStore(panelsPath).updatePreferences(this.encodePanelAppId(fileName), preferences);
-		return await this.buildPanelAppEntry(panelsPath, fileName, state);
+		const state = await this.createStateStore(panelsPath).updatePreferences(encodePanelAppId(fileName), preferences);
+		return await this.buildPanelAppEntry(await this.sourceService.resolveSource(panelsPath, encodePanelAppId(fileName)), state);
 	};
 	recordPanelAppOpened = async (id) => {
 		const fileName = await this.resolvePanelAppFileName(id);
 		const panelsPath = this.getPanelsPath(this.getWorkspacePath());
-		const state = await this.createStateStore(panelsPath).recordOpened(this.encodePanelAppId(fileName));
-		return await this.buildPanelAppEntry(panelsPath, fileName, state);
+		const state = await this.createStateStore(panelsPath).recordOpened(encodePanelAppId(fileName));
+		return await this.buildPanelAppEntry(await this.sourceService.resolveSource(panelsPath, encodePanelAppId(fileName)), state);
 	};
 	deletePanelApp = async (id) => {
-		const fileName = await this.resolvePanelAppFileName(id);
 		const panelsPath = this.getPanelsPath(this.getWorkspacePath());
-		const panelAppId = this.encodePanelAppId(fileName);
-		await rm(join(panelsPath, fileName));
+		const source = await this.sourceService.resolveSource(panelsPath, id);
+		const panelAppId = encodePanelAppId(source.sourceName);
+		await rm(source.sourcePath, { recursive: source.kind === "folder" });
 		await this.createStateStore(panelsPath).deleteEntry(panelAppId);
 		await this.createCapabilityGrantStore().deleteCaller({
 			surface: "panel-app",
@@ -4018,7 +4224,7 @@ var PanelAppManager = class {
 		this.deleteBridgeSessionsByPanelAppId(panelAppId);
 		return {
 			deleted: true,
-			fileName,
+			fileName: source.sourceName,
 			id: panelAppId
 		};
 	};
@@ -4027,7 +4233,19 @@ var PanelAppManager = class {
 		if (!await this.createCapabilityGrantStore().isGranted(bridgeSession.caller, capability)) throw new PanelAppError("AUTHORIZATION_REQUIRED", `This panel app needs permission to use ${capability}.`);
 	};
 	assertDeclaredCapability = (bridgeSession, capability) => {
-		if (!bridgeSession.declaredCapabilities.includes(capability)) throw new PanelAppError("PANEL_APP_CAPABILITY_NOT_DECLARED", "panel app did not declare this agent capability");
+		if (!bridgeSession.declaredCapabilities.includes(capability)) throw new PanelAppError("PANEL_APP_CAPABILITY_NOT_DECLARED", this.describeMissingAgentCapability(bridgeSession.declaredCapabilities, capability));
+	};
+	describeMissingAgentCapability = (declaredCapabilities, capability) => {
+		const declared = declaredCapabilities.length > 0 ? declaredCapabilities.join(", ") : "none";
+		const valid = PANEL_APP_AGENT_CAPABILITIES.join(", ");
+		const hint = declaredCapabilities.includes(capability.replace(":", ".")) ? ` Use ${capability}, not ${capability.replace(":", ".")}.` : "";
+		return [
+			`panel app did not declare ${capability}.`,
+			`Declared: ${declared}.`,
+			`Valid capabilities: ${valid}.`,
+			`Declare it with nextclaw-panel-capabilities or panel-app.json capabilities.`,
+			hint.trim()
+		].filter(Boolean).join(" ");
 	};
 	requireAgentRunClient = () => {
 		if (!this.agentRunClient) throw new PanelAppError("PANEL_APP_AGENT_REQUEST_INVALID", "panel app agent client is not configured");
@@ -4037,63 +4255,31 @@ var PanelAppManager = class {
 	getPanelsPath = (workspacePath) => join(workspacePath, DEFAULT_PANELS_DIR);
 	createStateStore = (panelsPath) => new PanelAppStateStore(panelsPath);
 	createCapabilityGrantStore = () => new PanelAppCapabilityGrantStore(join(this.getPanelsPath(this.getWorkspacePath()), PANEL_APP_CAPABILITY_GRANTS_FILE_NAME));
-	listPanelAppFileNames = async (panelsPath) => {
-		try {
-			return (await readdir(panelsPath, { withFileTypes: true })).filter((entry) => entry.isFile() && this.isPanelAppFileName(entry.name)).map((entry) => entry.name);
-		} catch (error) {
-			if (this.isMissingFileError(error)) return [];
-			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
-		}
-	};
-	buildPanelAppEntry = async (panelsPath, fileName, state) => {
-		const filePath = join(panelsPath, fileName);
-		const [fileStat, html] = await Promise.all([stat(filePath), readFile(filePath, "utf8")]);
-		const manifest = parsePanelAppManifest(html);
-		const id = this.encodePanelAppId(fileName);
-		const createdAt = resolvePanelAppCreatedAt(fileStat);
-		const updatedAt = fileStat.mtime.toISOString();
+	buildPanelAppEntry = async (source, state) => {
+		const manifest = source.manifest ?? parsePanelAppManifest(await readFile(source.entryPath, "utf8"));
+		const id = encodePanelAppId(source.sourceName);
+		const createdAt = resolvePanelAppCreatedAt(source.sourceStat);
+		const updatedAt = source.sourceStat.mtime.toISOString();
 		const entry = {
 			id,
-			fileName,
-			title: manifest.title ?? this.toPanelAppTitle(fileName),
+			fileName: source.sourceName,
+			kind: source.kind,
+			title: manifest.title ?? toPanelAppTitle(source.sourceName),
 			contentPath: `${PANEL_APP_CONTENT_BASE_PATH}/${encodeURIComponent(id)}/content`,
 			createdAt,
 			updatedAt,
-			sizeBytes: fileStat.size,
+			sizeBytes: source.sourceStat.size,
 			favorite: state.favorite ?? false,
 			openCount: state.openCount ?? 0
 		};
 		if (manifest.description) entry.description = manifest.description;
-		if (manifest.icon) entry.icon = manifest.icon;
+		if (manifest.icon) entry.icon = source.kind === "folder" ? resolvePanelAppIconUrl(id, manifest.icon) : manifest.icon;
 		if (state.lastOpenedAt) entry.lastOpenedAt = state.lastOpenedAt;
 		return entry;
 	};
 	resolvePanelAppFileName = async (id) => {
-		const fileName = this.decodePanelAppId(id);
-		const filePath = join(this.getPanelsPath(this.getWorkspacePath()), fileName);
-		try {
-			if ((await stat(filePath)).isFile()) return fileName;
-		} catch (error) {
-			if (this.isMissingFileError(error)) throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
-			throw new PanelAppError("PANEL_APP_READ_FAILED", error instanceof Error ? error.message : String(error));
-		}
-		throw new PanelAppError("PANEL_APP_NOT_FOUND", "panel app not found");
-	};
-	encodePanelAppId = (fileName) => Buffer.from(fileName, "utf8").toString("base64url");
-	decodePanelAppId = (id) => {
-		const normalizedId = id.trim();
-		if (!normalizedId) throw new PanelAppError("PANEL_APP_INVALID_ID", "panel app id is required");
-		let fileName = "";
-		try {
-			fileName = Buffer.from(normalizedId, "base64url").toString("utf8");
-		} catch {
-			throw new PanelAppError("PANEL_APP_INVALID_ID", "invalid panel app id");
-		}
-		if (this.encodePanelAppId(fileName) !== normalizedId || !this.isPanelAppFileName(fileName)) throw new PanelAppError("PANEL_APP_INVALID_ID", "invalid panel app id");
-		return fileName;
+		return (await this.sourceService.resolveSource(this.getPanelsPath(this.getWorkspacePath()), id)).sourceName;
 	};
-	isPanelAppFileName = (fileName) => fileName.endsWith(PANEL_APP_FILE_SUFFIX) && !fileName.includes("/") && !fileName.includes("\\") && !fileName.includes("\0");
-	toPanelAppTitle = (fileName) => fileName.slice(0, -11).replace(/[-_]+/g, " ").trim() || fileName;
 	comparePanelApps = (left, right) => resolvePanelAppActivityMs(right) - resolvePanelAppActivityMs(left) || Number(right.favorite) - Number(left.favorite) || left.title.localeCompare(right.title);
 	deleteExpiredBridgeSessions = () => {
 		const now = Date.now();
@@ -4993,7 +5179,7 @@ var NcpAgentSessionMetadataStore = class {
 	read = async (sessionId, activitySnapshot) => {
 		try {
 			const parsed = JSON.parse(await readFile(this.metadataPath(sessionId), "utf-8"));
-			if (!isRecord$8(parsed) || parsed._type !== "metadata" || !isRecord$8(parsed.metadata)) throw new Error(`invalid ncp agent session metadata sidecar: ${sessionId}`);
+			if (!isRecord$9(parsed) || parsed._type !== "metadata" || !isRecord$9(parsed.metadata)) throw new Error(`invalid ncp agent session metadata sidecar: ${sessionId}`);
 			const createdAt = toIsoString(parsed.created_at, activitySnapshot.createdAt);
 			const agentId = normalizeNcpAgentId(typeof parsed.agent_id === "string" ? parsed.agent_id : void 0);
 			return {
@@ -5094,7 +5280,7 @@ var NcpAgentSessionSummaryIndexStore = class {
 function serializeJournalEntry(entry) {
 	const serialized = JSON.stringify(entry);
 	if (!serialized) throw new Error("ncp agent session journal entry serialization produced empty output");
-	if (!isRecord$8(JSON.parse(serialized))) throw new Error("ncp agent session journal entry serialization produced a non-object entry");
+	if (!isRecord$9(JSON.parse(serialized))) throw new Error("ncp agent session journal entry serialization produced a non-object entry");
 	return serialized;
 }
 var NcpAgentSessionJournalStore = class {
@@ -5310,15 +5496,15 @@ var NcpAgentSessionJournalStore = class {
 				console.warn(`[ncp-agent-session-journal] skipped corrupted journal line ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
 				continue;
 			}
-			if (!isRecord$8(parsed)) continue;
+			if (!isRecord$9(parsed)) continue;
 			if (parsed._type === "metadata") {
-				metadata = isRecord$8(parsed.metadata) ? structuredClone(parsed.metadata) : {};
+				metadata = isRecord$9(parsed.metadata) ? structuredClone(parsed.metadata) : {};
 				agentId = normalizeNcpAgentId(typeof parsed.agent_id === "string" ? parsed.agent_id : void 0);
 				createdAt = toIsoString(parsed.created_at, createdAt);
 				updatedAt = toIsoString(parsed.updated_at, updatedAt);
 				continue;
 			}
-			if (parsed._type === "event" && isRecord$8(parsed.event)) {
+			if (parsed._type === "event" && isRecord$9(parsed.event)) {
 				const seq = Number(parsed.seq);
 				nextSeq = Math.max(nextSeq, Number.isFinite(seq) ? Math.trunc(seq) + 1 : nextSeq);
 				updatedAt = toIsoString(parsed.timestamp, updatedAt);
@@ -8575,6 +8761,6 @@ function resolveLegacyEventType(message) {
 	return `message.${role || "other"}`;
 }
 //#endregion
-export { AgentManager, AgentRunClient, AgentRuntimeRegistry, AutomationManager, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, CommandRegistry, ConfigManager, ContextCompactionPreflightService, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, ExtensionManager, GatewayInboundProcessor, LlmProviderManager, LlmUsageManager, LlmUsageStore, McpManager, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, PanelAppError, PanelAppManager, ProviderManagerNcpLLMApi, ServiceAppError, ServiceAppManager, SessionManager, SessionRequestManager, SkillManager, UpdateManifestReader, buildAgentRunSendPayload, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildSessionOrchestrationSection, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextWindowSignature, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isContextWindowSnapshot, isPanelAppAgentCapability, isPanelAppError, isReplyCapableChannel, isServiceAppError, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readContextWindowEventSessionId, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveNextclawNcpRunContext, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
+export { AgentManager, AgentRunClient, AgentRuntimeRegistry, AutomationManager, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, CommandRegistry, ConfigManager, ContextCompactionPreflightService, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, ExtensionManager, GatewayInboundProcessor, LlmProviderManager, LlmUsageManager, LlmUsageStore, McpManager, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, PANEL_APP_AGENT_CAPABILITIES, PanelAppError, PanelAppManager, ProviderManagerNcpLLMApi, ServiceAppError, ServiceAppManager, SessionManager, SessionRequestManager, SkillManager, UpdateManifestReader, buildAgentRunSendPayload, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildSessionOrchestrationSection, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextWindowSignature, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isContextWindowSnapshot, isPanelAppAgentCapability, isPanelAppError, isReplyCapableChannel, isServiceAppError, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readContextWindowEventSessionId, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveNextclawNcpRunContext, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
 
 //# sourceMappingURL=index.js.map