@nextclaw/kernel 0.6.23 → 0.6.24

package/dist/index.js

@@ -7,7 +7,7 @@ import { CHAT_CONTINUATION_TARGET_MESSAGE_METADATA_KEY, CHAT_CONVERSATION_EXCERP
 import { LocalAssetStore, buildAssetContentPath, buildNcpUserContent, buildOpenAiFunctionTool, ncpMessageToOpenAiMessages, validateToolArgs } from "@nextclaw/ncp-agent-runtime";
 import { createHash, createHmac, randomBytes, randomUUID, scryptSync, timingSafeEqual } from "node:crypto";
 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 { appendFileSync, chmodSync, constants, createReadStream, 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";
 import { execFileSync, spawn } from "node:child_process";
 import { access, appendFile, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
@@ -17,6 +17,7 @@ import { McpRegistryService, McpServerLifecycleManager } from "@nextclaw/mcp";
 import { McpNcpToolRegistryAdapter } from "@nextclaw/ncp-mcp";
 import { DefaultNcpAgentConversationStateManager, insertMessageByTimeline } from "@nextclaw/ncp-toolkit";
 import { parse } from "yaml";
+import { createInterface } from "node:readline";
 import { HttpRuntimeConfigResolver, HttpRuntimeNcpAgentRuntime } from "@nextclaw/nextclaw-ncp-runtime-http-client";
 import { StdioRuntimeConfigResolver, StdioRuntimeNcpAgentRuntime, probeStdioRuntime } from "@nextclaw/nextclaw-ncp-runtime-stdio-client";
 import { DefaultNcpAgentRuntime } from "@nextclaw/ncp-agent-runtime-next";
@@ -2901,9 +2902,9 @@ var ConfigManager = class {
 			required: true,
 			automatic: false,
 			changedPaths: [...plan.restartRequired],
-			message: `Config saved. Restart manually to apply: ${plan.restartRequired.join(", ")}.`
+			message: `Config saved. Run nextclaw restart in an external terminal to apply: ${plan.restartRequired.join(", ")}.`
 		} : null;
-		const message = changedPaths.length === 0 ? "Config already matched the requested state." : pendingRestart ? changedPaths.length > plan.restartRequired.length ? "Config saved. Supported changes were applied immediately; restart manually to apply the rest." : "Config saved. Restart manually to apply changes." : "Config saved and applied.";
+		const message = changedPaths.length === 0 ? "Config already matched the requested state." : pendingRestart ? changedPaths.length > plan.restartRequired.length ? "Config saved. Supported changes were applied immediately; run nextclaw restart in an external terminal to apply the rest." : "Config saved. Run nextclaw restart in an external terminal to apply changes." : "Config saved and applied.";
 		return {
 			ok: true,
 			note: note ?? null,
@@ -9639,23 +9640,61 @@ function resolveAgentHandoffDepth(metadata) {
 }
 //#endregion
 //#region src/utils/ncp-agent-unfinished-run.utils.ts
-function readUnfinishedNcpAgentRun(sessionId, events) {
-	let activeRun = null;
-	for (const event of events) {
-		if (event.type === NcpEventType.RunStarted) {
-			activeRun = {
-				sessionId,
-				...event.payload.messageId ? { messageId: event.payload.messageId } : {},
-				...event.payload.runId ? { runId: event.payload.runId } : {},
-				...event.payload.startedAt ? { startedAt: event.payload.startedAt } : {}
-			};
-			continue;
-		}
-		if (activeRun && (event.type === NcpEventType.RunFinished || event.type === NcpEventType.RunError || event.type === NcpEventType.MessageAbort) && (!event.payload.runId || !activeRun.runId || event.payload.runId === activeRun.runId)) activeRun = null;
-	}
+function applyNcpAgentRunLifecycleEvent(sessionId, activeRun, event) {
+	if (event.type === NcpEventType.RunStarted) return {
+		sessionId,
+		...event.payload.messageId ? { messageId: event.payload.messageId } : {},
+		...event.payload.runId ? { runId: event.payload.runId } : {},
+		...event.payload.startedAt ? { startedAt: event.payload.startedAt } : {}
+	};
+	if (activeRun && (event.type === NcpEventType.RunFinished || event.type === NcpEventType.RunError || event.type === NcpEventType.MessageAbort) && (!event.payload.runId || !activeRun.runId || event.payload.runId === activeRun.runId)) return null;
 	return activeRun;
 }
 //#endregion
+//#region src/stores/ncp-agent-unfinished-run.store.ts
+var NcpAgentUnfinishedRunStore = class {
+	constructor(journalDir, listSessionIds) {
+		this.journalDir = journalDir;
+		this.listSessionIds = listSessionIds;
+	}
+	list = async () => {
+		const runs = [];
+		for (const sessionId of await this.listSessionIds()) {
+			const run = await this.read(sessionId);
+			if (run) runs.push(run);
+		}
+		return runs;
+	};
+	read = async (sessionId) => {
+		const input = createReadStream(this.sessionPath(sessionId), { encoding: "utf-8" });
+		const lines = createInterface({
+			input,
+			crlfDelay: Infinity
+		});
+		let activeRun = null;
+		try {
+			for await (const line of lines) {
+				if (!line.trim()) continue;
+				let parsed;
+				try {
+					parsed = JSON.parse(line);
+				} catch {
+					continue;
+				}
+				if (!isRecord$12(parsed) || parsed._type !== "event" || !isRecord$12(parsed.event)) continue;
+				activeRun = applyNcpAgentRunLifecycleEvent(sessionId, activeRun, parsed.event);
+			}
+			return activeRun;
+		} catch {
+			return null;
+		} finally {
+			lines.close();
+			input.destroy();
+		}
+	};
+	sessionPath = (sessionId) => join(this.journalDir, `${safeNcpSessionFilename(sessionId.replace(/:/g, "_"))}.jsonl`);
+};
+//#endregion
 //#region src/utils/ncp-agent-session-journal-entry.utils.ts
 function isNcpAgentSessionMessageProjectionBoundaryEvent(event) {
 	return event.type === NcpEventType.MessageSent || event.type === NcpEventType.MessageCompleted || event.type === NcpEventType.MessageAbort || event.type === NcpEventType.RunFinished || event.type === NcpEventType.RunError || event.type === "session.snapshot.message";
@@ -9740,25 +9779,6 @@ function parseNcpAgentSessionJournal(raw) {
 	return parser.finish();
 }
 //#endregion
-//#region src/stores/ncp-agent-unfinished-run.store.ts
-var NcpAgentUnfinishedRunStore = class {
-	constructor(journalDir, listSessionIds) {
-		this.journalDir = journalDir;
-		this.listSessionIds = listSessionIds;
-	}
-	list = async () => {
-		return (await Promise.all((await this.listSessionIds()).map(this.read))).filter((run) => run !== null);
-	};
-	read = async (sessionId) => {
-		try {
-			return readUnfinishedNcpAgentRun(sessionId, parseNcpAgentSessionJournal(await readFile(this.sessionPath(sessionId), "utf-8")).events);
-		} catch {
-			return null;
-		}
-	};
-	sessionPath = (sessionId) => join(this.journalDir, `${safeNcpSessionFilename(sessionId.replace(/:/g, "_"))}.jsonl`);
-};
-//#endregion
 //#region src/stores/ncp-agent-session-metadata.store.ts
 var NcpAgentSessionMetadataStore = class {
 	constructor(journalDir) {
@@ -12051,23 +12071,24 @@ const createCliQuickReferenceContextProvider = () => {
 	return staticBlock([
 		`## ${APP_NAME} CLI Quick Reference`,
 		`${APP_NAME} is controlled via subcommands. Do not invent commands.`,
-		"To manage the Gateway daemon service (start/stop/restart):",
-		`- ${appLower} gateway status`,
-		`- ${appLower} gateway start`,
-		`- ${appLower} gateway stop`,
-		`- ${appLower} gateway restart`,
-		`If unsure, ask the user to run \`${appLower} help\` (or \`${appLower} gateway --help\`) and paste the output.`
+		"To manage the background service:",
+		`- ${appLower} status`,
+		`- ${appLower} start`,
+		`- ${appLower} restart`,
+		`- ${appLower} stop`,
+		`The \`${appLower} gateway\` command starts a foreground gateway; it has no lifecycle subcommands.`,
+		`If unsure, ask the user to run \`${appLower} help\` and paste the output.`
 	]);
 };
 const createSelfUpdateContextProvider = () => staticBlock([
 	`## ${APP_NAME} Self-Update`,
 	"Get Updates (self-update) is ONLY allowed when the user explicitly asks for it.",
 	"Do not run config.apply or update.run unless the user explicitly requests an update or config change; if it's not explicit, ask first.",
-	"Actions: config.get, config.schema, config.apply (validate + write full config, then restart), config.patch (merge + restart), update.run (update deps or git, then restart).",
+	"Actions: config.get, config.schema, config.apply (validate + write full config), config.patch (merge config), update.run (update the runtime and relaunch the service).",
 	"When patching config, copy enum values exactly from config.schema; never invent new variants.",
 	"session.dmScope legal values are exactly: main | per-peer | per-channel-peer | per-account-channel-peer.",
 	"If an enum/path is uncertain, stop and call config.schema first; do not guess.",
-	`After restart, ${APP_NAME} pings the last active session automatically.`
+	`If a config change requires restart, tell the user to run \`${APP_NAME.toLowerCase()} restart\` in an external terminal. Do not run it from the active agent session.`
 ]);
 const createReplyTagsContextProvider = () => staticBlock([
 	"## Reply Tags",