nextclaw 0.52.1 → 0.54.0

package/dist/cli/app/index.js

@@ -5,7 +5,7 @@ import { NextclawDistributionService } from "@nextclaw/service";
 const distribution = createNextclawDistribution(import.meta.url);
 repairPackagedPortableRunnerPermissions(distribution);
 NextclawDistributionService.configureRuntime(distribution);
-const { nextclawCliProgram } = await import("../../nextclaw-cli-app-npOWL5Nm.js");
+const { nextclawCliProgram } = await import("../../nextclaw-cli-app-DaICBR1L.js");
 await nextclawCliProgram.parseAsync(process.argv);
 //#endregion
 export {};

package/dist/{nextclaw-cli-app-npOWL5Nm.js → nextclaw-cli-app-DaICBR1L.js}

@@ -19,6 +19,117 @@ import { formatNextClawAppInstallCommand } from "@nextclaw/shared";
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
+//#region src/cli/app/services/local-api/local-ui-api-client.service.ts
+function createLocalUiApiClient() {
+	const apiBase = resolveLocalUiApiBase();
+	return apiBase ? new LocalUiApiClient(apiBase) : null;
+}
+var LocalUiApiClient = class {
+	cookie;
+	constructor(apiBase) {
+		this.apiBase = apiBase;
+	}
+	request = async (params) => {
+		const { body, method, path } = params;
+		const cookie = await this.getCookie();
+		const headers = {};
+		if (body) headers["Content-Type"] = "application/json";
+		if (cookie) headers.Cookie = cookie;
+		const response = await fetch(`${this.apiBase}${path}`, {
+			method: method ?? "GET",
+			headers,
+			...body ? { body: JSON.stringify(body) } : {}
+		});
+		const responseBody = await response.text();
+		const payload = this.parsePayload(responseBody);
+		if (!response.ok) {
+			const detail = [payload && !payload.ok ? payload.error?.code : void 0, payload && !payload.ok ? payload.error?.message : void 0].filter(Boolean).join(": ") || responseBody.trim().slice(0, 240);
+			throw new Error(`api request failed with status ${response.status}${detail ? `: ${detail}` : ""}`);
+		}
+		if (!payload) throw new Error("api request returned invalid JSON");
+		if (!payload.ok) throw new Error([payload.error?.code, payload.error?.message].filter(Boolean).join(": ") || "api request failed");
+		return payload.data;
+	};
+	parsePayload = (body) => {
+		try {
+			return JSON.parse(body);
+		} catch {
+			return null;
+		}
+	};
+	getCookie = async () => {
+		if (this.cookie !== void 0) return this.cookie;
+		const response = await fetch(`${this.apiBase}/api/auth/bridge`, {
+			method: "POST",
+			headers: { "x-nextclaw-ui-bridge-secret": ensureUiBridgeSecret() }
+		});
+		if (!response.ok) throw new Error(`bridge auth failed with status ${response.status}`);
+		const payload = await response.json();
+		if (!payload.ok) throw new Error(payload.error?.message ?? "bridge auth failed");
+		this.cookie = typeof payload.data.cookie === "string" && payload.data.cookie.trim() ? payload.data.cookie.trim() : null;
+		return this.cookie;
+	};
+};
+function resolveLocalUiApiBase() {
+	const state = readRunningRuntimeState(resolve(getRunPath(), "ui-runtime.json")) ?? readRunningRuntimeState(resolve(getRunPath(), "service.json"));
+	if (!state) return null;
+	if (typeof state.uiUrl === "string" && state.uiUrl.trim()) return state.uiUrl.replace(/\/+$/, "");
+	if (typeof state.apiUrl === "string" && state.apiUrl.trim()) return state.apiUrl.replace(/\/api\/?$/, "").replace(/\/+$/, "");
+	return null;
+}
+function readRunningRuntimeState(statePath) {
+	if (!existsSync(statePath)) return null;
+	try {
+		const state = JSON.parse(readFileSync(statePath, "utf-8"));
+		return typeof state.pid === "number" && isProcessRunning(state.pid) ? state : null;
+	} catch {
+		return null;
+	}
+}
+function isProcessRunning(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function ensureUiBridgeSecret() {
+	const dirPath = join(getDataDir(), "remote");
+	const secretPath = join(dirPath, "ui-bridge-secret");
+	if (existsSync(secretPath)) {
+		const existing = readFileSync(secretPath, "utf-8").trim();
+		if (existing) return existing;
+	}
+	mkdirSync(dirPath, { recursive: true });
+	const secret = randomBytes(24).toString("hex");
+	writeFileSync(secretPath, `${secret}\n`, "utf-8");
+	return secret;
+}
+//#endregion
+//#region src/cli/app/commands/resource-command-registration.utils.ts
+/** CLI discovery uses the running kernel catalog, matching UI and AI exactly. */
+function registerResourceCommands(program, createClient = createLocalUiApiClient) {
+	const resources = program.command("resources").description("Discover NextClaw resource URIs and snapshots");
+	const request = async (params) => {
+		const client = createClient();
+		if (!client) throw new Error("No local NextClaw service is running. Start nextclaw first.");
+		console.log(JSON.stringify(await client.request(params), null, 2));
+	};
+	resources.command("list").description("List resource categories or search objects (JSON)").option("--type <type>", "Registered object type").option("--query <text>", "Search object names and descriptions").option("--limit <count>", "Result limit per category (1-50)").action(async ({ type, query: search, limit }) => {
+		const query = new URLSearchParams();
+		if (type !== void 0) query.set("objectType", type);
+		if (search !== void 0) query.set("query", search);
+		if (limit !== void 0) query.set("limit", limit);
+		await request({ path: `/api/system-object-references?${query}` });
+	});
+	resources.command("resolve <uri>").description("Resolve a resource URI to an immutable asset reference (JSON)").action(async (uri) => request({
+		path: "/api/system-object-references/resolve",
+		method: "POST",
+		body: { uri }
+	}));
+}
+//#endregion
 //#region src/cli/app/services/feedback/feedback-client.service.ts
 var FeedbackClient = class {
 	endpoint;
@@ -1011,15 +1122,36 @@ function executeDiscussionTrigger(command, options) {
 }
 //#endregion
 //#region src/cli/app/commands/discussion-listener-command-registration.utils.ts
+async function migratedDiscussionState() {
+	try {
+		return JSON.parse(await readFile(join(new DiscussionListenerStateStore().root, "collaboration-migration.json"), "utf8"));
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+async function routeMigratedDiscussion(command) {
+	const migration = await migratedDiscussionState();
+	if (!migration) return false;
+	const { runCollaborationCli } = await import("@nextclaw/collaboration");
+	await runCollaborationCli([
+		"--state-dir",
+		dirname(migration.statePath),
+		command
+	]);
+	return true;
+}
 function registerDiscussionListenerCommands(group, skillPath) {
 	const lifecycleOptions = (target) => target.option("--endpoint <url>", "Discussion service origin").option("--token-file <path>", "Private participant token file").option("--workspace <path>", "Codex Desktop preset workspace; not part of the trigger protocol").option("--interval <milliseconds>", "Polling interval; defaults to 30000").option("--timeout <milliseconds>", "Trigger handshake timeout; defaults to 60000").option("--preset <name>", "Recommended trigger preset: codex-desktop");
 	lifecycleOptions(group.command("configure [command...]", { hidden: false }).description("Save the discussion listener configuration; pass a trigger argv after --")).action(async (commandArgs, options) => {
+		if (await migratedDiscussionState()) throw new Error("This listener has migrated. Manage its connection with nextclaw collaboration.");
 		const { preset, workspace } = options;
 		const config = await writeDiscussionListenerConfig(options, commandArgs ?? []);
 		if (preset === "codex-desktop") await new CodexDesktopDiscussionConsumerService().check();
 		console.log(JSON.stringify(discussionListenerConfigOutput(config, preset, workspace), null, 2));
 	});
 	lifecycleOptions(group.command("start [command...]", { hidden: false }).description("Start the configured discussion listener in the background")).action(async (commandArgs, options) => {
+		if (await routeMigratedDiscussion("start")) return;
 		const store = new DiscussionListenerStateStore();
 		const hasOverrides = Boolean((commandArgs?.length ?? 0) || Object.values(options).some(Boolean));
 		if (hasOverrides) await writeDiscussionListenerConfig(options, commandArgs ?? [], store);
@@ -1027,13 +1159,24 @@ function registerDiscussionListenerCommands(group, skillPath) {
 		const supervisor = new DiscussionListenerSupervisorService(store);
 		console.log(JSON.stringify(await (hasOverrides ? supervisor.restart() : supervisor.start()), null, 2));
 	});
-	group.command("status").description("Show listener health and the last trigger error").action(async () => console.log(JSON.stringify(await new DiscussionListenerSupervisorService().status(), null, 2)));
-	group.command("stop").description("Stop the configured discussion listener").action(async () => console.log(JSON.stringify(await new DiscussionListenerSupervisorService().stop(), null, 2)));
+	group.command("status").description("Show listener health and the last trigger error").action(async () => {
+		if (await routeMigratedDiscussion("status")) return;
+		console.log(JSON.stringify(await new DiscussionListenerSupervisorService().status(), null, 2));
+	});
+	group.command("stop").description("Stop the configured discussion listener").action(async () => {
+		if (await routeMigratedDiscussion("stop")) return;
+		console.log(JSON.stringify(await new DiscussionListenerSupervisorService().stop(), null, 2));
+	});
 	group.command("restart").description("Restart the configured discussion listener").action(async () => {
+		if (await routeMigratedDiscussion("restart")) return;
 		const store = new DiscussionListenerStateStore();
 		console.log(JSON.stringify(await new DiscussionListenerSupervisorService(store).restart(), null, 2));
 	});
+	registerLegacyWorkerCommands(group, skillPath);
+}
+function registerLegacyWorkerCommands(group, skillPath) {
 	group.command("worker", { hidden: true }).action(async () => {
+		if (await migratedDiscussionState()) throw new Error("Legacy worker is retired for this state directory; use collaboration run.");
 		const store = new DiscussionListenerStateStore();
 		const config = await store.readConfig();
 		const instanceId = process.env.NEXTCLAW_DISCUSSION_LISTENER_INSTANCE_ID;
@@ -1214,6 +1357,19 @@ function print(value) {
 	console.log(JSON.stringify(value, null, 2));
 }
 //#endregion
+//#region src/cli/app/commands/collaboration/collaboration-command-registration.utils.ts
+/** Load the standalone public owner only when this Node-22 capability is requested. */
+function registerCollaborationCommand(program) {
+	program.command("collaboration").description("Connect external conversations to local agents (Node.js 22.13+)").helpOption(false).allowUnknownOption().argument("[args...]").action(async (args) => {
+		const [major, minor] = process.versions.node.split(".").map(Number);
+		if (major < 22 || major === 22 && minor < 13) throw new Error("Collaboration requires Node.js 22.13 or newer");
+		const { registerCollaborationCommands } = await import("@nextclaw/collaboration");
+		const command = new Command().name("nextclaw collaboration");
+		registerCollaborationCommands(command);
+		await command.parseAsync(args, { from: "user" });
+	});
+}
+//#endregion
 //#region ../../node_modules/.pnpm/ws@8.19.0/node_modules/ws/lib/constants.js
 var require_constants = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	const BINARY_TYPES = [
@@ -6007,94 +6163,6 @@ var AppDevCommandController = class {
 	};
 };
 //#endregion
-//#region src/cli/app/services/local-api/local-ui-api-client.service.ts
-function createLocalUiApiClient() {
-	const apiBase = resolveLocalUiApiBase();
-	return apiBase ? new LocalUiApiClient(apiBase) : null;
-}
-var LocalUiApiClient = class {
-	cookie;
-	constructor(apiBase) {
-		this.apiBase = apiBase;
-	}
-	request = async (params) => {
-		const { body, method, path } = params;
-		const cookie = await this.getCookie();
-		const headers = {};
-		if (body) headers["Content-Type"] = "application/json";
-		if (cookie) headers.Cookie = cookie;
-		const response = await fetch(`${this.apiBase}${path}`, {
-			method: method ?? "GET",
-			headers,
-			...body ? { body: JSON.stringify(body) } : {}
-		});
-		const responseBody = await response.text();
-		const payload = this.parsePayload(responseBody);
-		if (!response.ok) {
-			const detail = [payload && !payload.ok ? payload.error?.code : void 0, payload && !payload.ok ? payload.error?.message : void 0].filter(Boolean).join(": ") || responseBody.trim().slice(0, 240);
-			throw new Error(`api request failed with status ${response.status}${detail ? `: ${detail}` : ""}`);
-		}
-		if (!payload) throw new Error("api request returned invalid JSON");
-		if (!payload.ok) throw new Error([payload.error?.code, payload.error?.message].filter(Boolean).join(": ") || "api request failed");
-		return payload.data;
-	};
-	parsePayload = (body) => {
-		try {
-			return JSON.parse(body);
-		} catch {
-			return null;
-		}
-	};
-	getCookie = async () => {
-		if (this.cookie !== void 0) return this.cookie;
-		const response = await fetch(`${this.apiBase}/api/auth/bridge`, {
-			method: "POST",
-			headers: { "x-nextclaw-ui-bridge-secret": ensureUiBridgeSecret() }
-		});
-		if (!response.ok) throw new Error(`bridge auth failed with status ${response.status}`);
-		const payload = await response.json();
-		if (!payload.ok) throw new Error(payload.error?.message ?? "bridge auth failed");
-		this.cookie = typeof payload.data.cookie === "string" && payload.data.cookie.trim() ? payload.data.cookie.trim() : null;
-		return this.cookie;
-	};
-};
-function resolveLocalUiApiBase() {
-	const state = readRunningRuntimeState(resolve(getRunPath(), "ui-runtime.json")) ?? readRunningRuntimeState(resolve(getRunPath(), "service.json"));
-	if (!state) return null;
-	if (typeof state.uiUrl === "string" && state.uiUrl.trim()) return state.uiUrl.replace(/\/+$/, "");
-	if (typeof state.apiUrl === "string" && state.apiUrl.trim()) return state.apiUrl.replace(/\/api\/?$/, "").replace(/\/+$/, "");
-	return null;
-}
-function readRunningRuntimeState(statePath) {
-	if (!existsSync(statePath)) return null;
-	try {
-		const state = JSON.parse(readFileSync(statePath, "utf-8"));
-		return typeof state.pid === "number" && isProcessRunning(state.pid) ? state : null;
-	} catch {
-		return null;
-	}
-}
-function isProcessRunning(pid) {
-	try {
-		process.kill(pid, 0);
-		return true;
-	} catch {
-		return false;
-	}
-}
-function ensureUiBridgeSecret() {
-	const dirPath = join(getDataDir(), "remote");
-	const secretPath = join(dirPath, "ui-bridge-secret");
-	if (existsSync(secretPath)) {
-		const existing = readFileSync(secretPath, "utf-8").trim();
-		if (existing) return existing;
-	}
-	mkdirSync(dirPath, { recursive: true });
-	const secret = randomBytes(24).toString("hex");
-	writeFileSync(secretPath, `${secret}\n`, "utf-8");
-	return secret;
-}
-//#endregion
 //#region src/cli/app/services/local-api/app-data-live.service.ts
 var AppDataLiveService = class {
 	constructor(params = {}) {
@@ -7636,6 +7704,7 @@ program.command("login").description("Sign in to NextClaw Platform and save the
 const account = program.command("account").description("Inspect and manage your NextClaw account");
 registerFeedbackCommands(program);
 registerDiscussionCommands(program);
+registerCollaborationCommand(program);
 account.command("status").description("Show account status and personal marketplace publish readiness").option("--api-base <url>", "Platform API base (supports /v1 suffix)").option("--json", "Output JSON", false).action(async (opts) => runtime.account.status(opts));
 account.command("set-username <username>").description("Set your NextClaw username for personal marketplace publishing").option("--api-base <url>", "Platform API base (supports /v1 suffix)").option("--json", "Output JSON", false).action(async (username, opts) => runtime.account.setUsername(username, opts));
 registerRemoteCommandGroup(program, runtime);
@@ -7654,6 +7723,7 @@ program.command("update").description(`Update the ${APP_NAME} runtime`).option("
 registerSkillsCommands(program, runtime);
 registerAgentsCommands(program, runtime);
 registerProjectCommands(program, runtime);
+registerResourceCommands(program);
 registerSessionCommands(program, runtime);
 registerExecCommand(program, runtime);
 registerAppCommands(program, { portableServiceRunnerPath: NextclawDistributionService.get().portableServiceRunnerPath });
@@ -7698,4 +7768,4 @@ program.command("usage").description("Show observed LLM usage snapshots, history
 //#endregion
 export { program as nextclawCliProgram };
 
-//# sourceMappingURL=nextclaw-cli-app-npOWL5Nm.js.map
+//# sourceMappingURL=nextclaw-cli-app-DaICBR1L.js.map