topchester-ai 0.53.0 → 0.55.0

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as runTopchesterCli } from "./cli-CqFhOvlt.mjs";
+import { t as runTopchesterCli } from "./cli-AJknxj59.mjs";
 //#region src/bin.ts
 await runTopchesterCli();
 //#endregion

package/dist/{cli-CqFhOvlt.mjs → cli-AJknxj59.mjs}

@@ -127,13 +127,13 @@ function extractAccountIdFromClaims(claims) {
 	const flatClaim = getStringProperty(claims, "chatgpt_account_id");
 	if (flatClaim) return flatClaim;
 	const authClaims = claims["https://api.openai.com/auth"];
-	if (isPlainObject$2(authClaims)) {
+	if (isPlainObject$3(authClaims)) {
 		const namespacedClaim = getStringProperty(authClaims, "chatgpt_account_id");
 		if (namespacedClaim) return namespacedClaim;
 	}
 	const organizations = claims.organizations;
 	if (Array.isArray(organizations)) {
-		const firstOrganization = organizations.find(isPlainObject$2);
+		const firstOrganization = organizations.find(isPlainObject$3);
 		const organizationId = firstOrganization ? getStringProperty(firstOrganization, "id") : void 0;
 		if (organizationId) return organizationId;
 	}
@@ -143,7 +143,7 @@ function parseJwtClaims(token) {
 	if (!parts || parts.length !== 3 || !parts[1]) return;
 	try {
 		const parsed = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
-		return isPlainObject$2(parsed) ? parsed : void 0;
+		return isPlainObject$3(parsed) ? parsed : void 0;
 	} catch {
 		return;
 	}
@@ -190,7 +190,7 @@ async function readJsonObject(response, label) {
 	} catch (error) {
 		throw new CodexAuthError("invalid_response", `Invalid Codex ${label}: ${formatErrorMessage$4(error)}.`);
 	}
-	if (!isPlainObject$2(parsed)) throw new CodexAuthError("invalid_response", `Invalid Codex ${label}: expected an object.`);
+	if (!isPlainObject$3(parsed)) throw new CodexAuthError("invalid_response", `Invalid Codex ${label}: expected an object.`);
 	return parsed;
 }
 function isPendingDeviceAuthResponse(response) {
@@ -214,7 +214,7 @@ function optionalPositiveNumber(value) {
 	const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
 	return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
 }
-function isPlainObject$2(value) {
+function isPlainObject$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function formatErrorMessage$4(error) {
@@ -249,7 +249,7 @@ async function readAuthStore(options = {}) {
 	try {
 		source = await readFile(path, "utf8");
 	} catch (error) {
-		if (isNodeError$4(error) && error.code === "ENOENT") return createEmptyAuthStore();
+		if (isNodeError$5(error) && error.code === "ENOENT") return createEmptyAuthStore();
 		throw error;
 	}
 	let parsed;
@@ -297,7 +297,7 @@ async function getAuthStoreStatus(options = {}) {
 	try {
 		await stat(path);
 	} catch (error) {
-		if (isNodeError$4(error) && error.code === "ENOENT") return {
+		if (isNodeError$5(error) && error.code === "ENOENT") return {
 			path,
 			exists: false,
 			providers: []
@@ -325,13 +325,13 @@ async function getAuthStoreStatus(options = {}) {
 	}
 }
 function parseAuthStore(path, value) {
-	if (!isPlainObject$1(value)) throw new AuthStoreError(path, "<root>: expected an object");
+	if (!isPlainObject$2(value)) throw new AuthStoreError(path, "<root>: expected an object");
 	if (value.version !== 1) throw new AuthStoreError(path, "version: expected 1");
-	if (!isPlainObject$1(value.providers)) throw new AuthStoreError(path, "providers: expected an object");
+	if (!isPlainObject$2(value.providers)) throw new AuthStoreError(path, "providers: expected an object");
 	const providers = {};
 	for (const [providerId, providerRecord] of Object.entries(value.providers)) {
 		if (!providerId) throw new AuthStoreError(path, "providers: provider id must not be empty");
-		if (!isPlainObject$1(providerRecord)) throw new AuthStoreError(path, `providers.${providerId}: expected an object`);
+		if (!isPlainObject$2(providerRecord)) throw new AuthStoreError(path, `providers.${providerId}: expected an object`);
 		providers[providerId] = parseProviderRecord(path, providerId, providerRecord);
 	}
 	return {
@@ -388,14 +388,14 @@ function redactProviderStatus(id, record, now) {
 }
 async function setModeIfSupported(path, mode) {
 	await chmod(path, mode).catch((error) => {
-		if (isNodeError$4(error) && (error.code === "ENOSYS" || error.code === "EPERM" || error.code === "EINVAL")) return;
+		if (isNodeError$5(error) && (error.code === "ENOSYS" || error.code === "EPERM" || error.code === "EINVAL")) return;
 		throw error;
 	});
 }
-function isPlainObject$1(value) {
+function isPlainObject$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isNodeError$4(error) {
+function isNodeError$5(error) {
 	return error instanceof Error && "code" in error;
 }
 function formatErrorMessage$3(error) {
@@ -1299,7 +1299,7 @@ async function statExistingFile(resolvedPath, originalPath) {
 	try {
 		fileStat = await stat(resolvedPath);
 	} catch (error) {
-		if (isNodeError$3(error) && error.code === "ENOENT") throw new Error(`edit_file can only edit existing files: ${originalPath}`);
+		if (isNodeError$4(error) && error.code === "ENOENT") throw new Error(`edit_file can only edit existing files: ${originalPath}`);
 		throw error;
 	}
 	if (!fileStat.isFile()) throw new Error(`edit_file can only edit regular files: ${originalPath}`);
@@ -1341,7 +1341,7 @@ function summarizeDiff(diff) {
 	}
 	return `+${added}/-${removed}`;
 }
-function isNodeError$3(error) {
+function isNodeError$4(error) {
 	return error instanceof Error && "code" in error;
 }
 function normalizeEdits(edits) {
@@ -4859,7 +4859,7 @@ async function statTarget(path) {
 	try {
 		return await stat(path);
 	} catch (error) {
-		if (isNodeError$2(error) && error.code === "ENOENT") return;
+		if (isNodeError$3(error) && error.code === "ENOENT") return;
 		throw error;
 	}
 }
@@ -4869,7 +4869,7 @@ async function ensureParentDirectory(workspaceRoot, path, relativePath, createPa
 		if (!(await stat(parent)).isDirectory()) throw new Error(`write_file parent path is not a directory: ${dirname(relativePath)}`);
 		return [];
 	} catch (error) {
-		if (!isNodeError$2(error) || error.code !== "ENOENT") throw error;
+		if (!isNodeError$3(error) || error.code !== "ENOENT") throw error;
 	}
 	if (!createParentDirs) throw new Error(`write_file parent directory does not exist: ${dirname(relativePath)}`);
 	const createdParentDirs = await collectMissingParentDirs(workspaceRoot, parent);
@@ -4883,7 +4883,7 @@ async function collectMissingParentDirs(workspaceRoot, parent) {
 		if (!(await stat(current)).isDirectory()) throw new Error(`write_file parent path is not a directory: ${relative(workspaceRoot, current)}`);
 		break;
 	} catch (error) {
-		if (!isNodeError$2(error) || error.code !== "ENOENT") throw error;
+		if (!isNodeError$3(error) || error.code !== "ENOENT") throw error;
 		missing.push(relative(workspaceRoot, current));
 		current = dirname(current);
 	}
@@ -4924,7 +4924,7 @@ function countLogicalLines$1(content) {
 	const withoutTrailingLineEnding = content.replace(/\r?\n$/u, "");
 	return withoutTrailingLineEnding.length === 0 ? 1 : withoutTrailingLineEnding.split(/\r?\n/u).length;
 }
-function isNodeError$2(error) {
+function isNodeError$3(error) {
 	return error instanceof Error && "code" in error;
 }
 //#endregion
@@ -5335,6 +5335,7 @@ function createCodexProviderFetch(options = {}) {
 	const providerId = options.providerId ?? "codex";
 	const upstreamFetch = options.fetch ?? fetch;
 	return (async (input, init) => {
+		const request = await rewriteCodexRequest(input, init);
 		const auth = await resolveCodexAuth({
 			...options,
 			providerId,
@@ -5344,10 +5345,13 @@ function createCodexProviderFetch(options = {}) {
 		headers.delete("authorization");
 		headers.set("Authorization", `Bearer ${auth.accessToken}`);
 		if (auth.accountId) headers.set("ChatGPT-Account-Id", auth.accountId);
-		return upstreamFetch(rewriteCodexRequestUrl(input), {
-			...init,
+		const response = await upstreamFetch(request.input, {
+			...request.init,
 			headers
 		});
+		if (request.responseMode === "chat-json") return codexResponsesSseToChatJson(response);
+		if (request.responseMode === "chat-sse") return codexResponsesSseToChatSse(response);
+		return response;
 	});
 }
 function rewriteCodexRequestUrl(input) {
@@ -5360,6 +5364,193 @@ function rewriteCodexRequestUrl(input) {
 	}
 	return input;
 }
+async function rewriteCodexRequest(input, init) {
+	const rewrittenUrl = rewriteCodexRequestUrl(input);
+	const body = await readJsonBody(init?.body);
+	if (!isChatCompletionsBody(body)) return {
+		input: rewrittenUrl,
+		...init ? { init } : {}
+	};
+	const stream = body.stream === true;
+	const codexBody = chatCompletionsBodyToCodexResponsesBody(body);
+	const headers = new Headers(init?.headers);
+	headers.set("Content-Type", "application/json");
+	return {
+		input: rewrittenUrl,
+		init: {
+			...init,
+			headers,
+			body: JSON.stringify(codexBody)
+		},
+		responseMode: stream ? "chat-sse" : "chat-json"
+	};
+}
+function chatCompletionsBodyToCodexResponsesBody(body) {
+	const instructions = body.messages.filter((message) => message.role === "system" || message.role === "developer").map((message) => messageContentToText(message.content)).filter((text) => text.trim().length > 0).join("\n\n");
+	const input = body.messages.filter((message) => message.role !== "system" && message.role !== "developer").map(chatMessageToResponseInputItem).filter((item) => item !== void 0);
+	return {
+		model: body.model,
+		instructions: instructions || "You are a helpful assistant.",
+		input,
+		store: false,
+		stream: true,
+		...typeof body.temperature === "number" ? { temperature: body.temperature } : {},
+		...typeof body.top_p === "number" ? { top_p: body.top_p } : {},
+		...typeof body.max_tokens === "number" ? { max_output_tokens: body.max_tokens } : {}
+	};
+}
+function chatMessageToResponseInputItem(message) {
+	const text = messageContentToText(message.content);
+	if (!text.trim()) return;
+	return {
+		type: "message",
+		role: message.role === "assistant" ? "assistant" : "user",
+		content: [{
+			type: message.role === "assistant" ? "output_text" : "input_text",
+			text
+		}]
+	};
+}
+async function codexResponsesSseToChatJson(response) {
+	if (!response.ok) return response;
+	const parsed = parseCodexResponsesSse(await response.text());
+	const headers = new Headers(response.headers);
+	headers.set("Content-Type", "application/json");
+	return new Response(JSON.stringify({
+		id: parsed.id ?? "codex-response",
+		object: "chat.completion",
+		created: parsed.created ?? Math.floor(Date.now() / 1e3),
+		model: parsed.model ?? "codex",
+		choices: [{
+			index: 0,
+			finish_reason: "stop",
+			message: {
+				role: "assistant",
+				content: parsed.text
+			}
+		}],
+		...parsed.usage ? { usage: parsed.usage } : {}
+	}), {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+}
+async function codexResponsesSseToChatSse(response) {
+	if (!response.ok) return response;
+	const parsed = parseCodexResponsesSse(await response.text());
+	const encoder = new TextEncoder();
+	const id = parsed.id ?? "codex-response";
+	const created = parsed.created ?? Math.floor(Date.now() / 1e3);
+	const model = parsed.model ?? "codex";
+	const chunks = [
+		{
+			id,
+			object: "chat.completion.chunk",
+			created,
+			model,
+			choices: [{
+				index: 0,
+				delta: { role: "assistant" },
+				finish_reason: null
+			}]
+		},
+		...(parsed.text.match(/[\s\S]{1,2048}/gu) ?? []).map((delta) => ({
+			id,
+			object: "chat.completion.chunk",
+			created,
+			model,
+			choices: [{
+				index: 0,
+				delta: { content: delta },
+				finish_reason: null
+			}]
+		})),
+		{
+			id,
+			object: "chat.completion.chunk",
+			created,
+			model,
+			choices: [{
+				index: 0,
+				delta: {},
+				finish_reason: "stop"
+			}],
+			...parsed.usage ? { usage: parsed.usage } : {}
+		}
+	];
+	const stream = new ReadableStream({ start(controller) {
+		for (const chunk of chunks) controller.enqueue(encoder.encode(`data: ${JSON.stringify(chunk)}\n\n`));
+		controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+		controller.close();
+	} });
+	const headers = new Headers(response.headers);
+	headers.set("Content-Type", "text/event-stream");
+	return new Response(stream, {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+}
+function parseCodexResponsesSse(source) {
+	let text = "";
+	let response;
+	for (const event of source.split(/\n\n/u)) {
+		const dataLines = event.split(/\r?\n/u).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart());
+		if (dataLines.length === 0) continue;
+		const data = dataLines.join("\n");
+		if (data === "[DONE]") continue;
+		const parsed = safeJsonParse(data);
+		if (!isPlainObject$1(parsed)) continue;
+		if (parsed.type === "response.output_text.delta" && typeof parsed.delta === "string") text += parsed.delta;
+		if (parsed.type === "response.completed" && isPlainObject$1(parsed.response)) response = parsed.response;
+	}
+	return {
+		...typeof response?.id === "string" ? { id: response.id } : {},
+		...typeof response?.created_at === "number" ? { created: response.created_at } : {},
+		...typeof response?.model === "string" ? { model: response.model } : {},
+		text,
+		...normalizeCodexUsage(response?.usage)
+	};
+}
+function normalizeCodexUsage(usage) {
+	if (!isPlainObject$1(usage)) return {};
+	const promptTokens = typeof usage.input_tokens === "number" ? usage.input_tokens : void 0;
+	const completionTokens = typeof usage.output_tokens === "number" ? usage.output_tokens : void 0;
+	const totalTokens = typeof usage.total_tokens === "number" ? usage.total_tokens : void 0;
+	return { usage: {
+		...promptTokens === void 0 ? {} : { prompt_tokens: promptTokens },
+		...completionTokens === void 0 ? {} : { completion_tokens: completionTokens },
+		...totalTokens === void 0 ? {} : { total_tokens: totalTokens }
+	} };
+}
+async function readJsonBody(body) {
+	if (typeof body !== "string") return;
+	return safeJsonParse(body);
+}
+function safeJsonParse(source) {
+	try {
+		return JSON.parse(source);
+	} catch {
+		return;
+	}
+}
+function isChatCompletionsBody(value) {
+	return isPlainObject$1(value) && typeof value.model === "string" && Array.isArray(value.messages) && value.messages.every((message) => isPlainObject$1(message) && typeof message.role === "string");
+}
+function messageContentToText(content) {
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	return content.map((part) => {
+		if (!isPlainObject$1(part)) return "";
+		if (typeof part.text === "string") return part.text;
+		if (typeof part.content === "string") return part.content;
+		return "";
+	}).filter(Boolean).join("\n");
+}
+function isPlainObject$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 async function resolveCodexAuth(options = {}) {
 	const providerId = options.providerId ?? "codex";
 	const record = (await readAuthStore({ path: options.authStorePath })).providers[providerId];
@@ -6197,7 +6388,8 @@ const openRouterProviderDefaults = {
 };
 const codexProviderDefaults = {
 	type: "openai-compatible",
-	baseURL: CODEX_BACKEND_BASE_URL
+	baseURL: CODEX_BACKEND_BASE_URL,
+	toolProtocol: "text-json"
 };
 const codexStarterModelChoices = [
 	"codex/gpt-5.5",
@@ -7973,11 +8165,11 @@ async function directoryExists(path) {
 		if (!(await stat(path)).isDirectory()) throw new Error(`${path} exists but is not a folder`);
 		return true;
 	} catch (error) {
-		if (isNodeError$1(error) && error.code === "ENOENT") return false;
+		if (isNodeError$2(error) && error.code === "ENOENT") return false;
 		throw error;
 	}
 }
-function isNodeError$1(error) {
+function isNodeError$2(error) {
 	return error instanceof Error && "code" in error;
 }
 //#endregion
@@ -8016,7 +8208,7 @@ async function removeIfPresent(path) {
 		});
 		return true;
 	} catch (error) {
-		if (isNodeError(error) && error.code === "ENOENT") return false;
+		if (isNodeError$1(error) && error.code === "ENOENT") return false;
 		throw error;
 	}
 }
@@ -8029,7 +8221,7 @@ function assertSafeResetPath(workspaceRoot, path) {
 	if (target === workspace) throw new Error(`Refusing to reset KB because the configured KB path is the workspace root: ${target}`);
 	if (dirname(target) === target) throw new Error(`Refusing to reset KB because the configured KB path is a filesystem root: ${target}`);
 }
-function isNodeError(error) {
+function isNodeError$1(error) {
 	return error instanceof Error && "code" in error;
 }
 //#endregion
@@ -11844,10 +12036,16 @@ const agentMetadataSchema = z.object({
 	capabilities: z.array(z.string().min(1)).optional(),
 	model_support: agentModelSupportSchema.optional()
 }).strict();
-z.object({
+const agentsMetadata = z.object({
 	version: z.literal(1),
 	agents: z.record(z.string().min(1), agentMetadataSchema)
 }).strict().parse(agents_default);
+function listAgentMetadata() {
+	return Object.entries(agentsMetadata.agents).map(([id, metadata]) => ({
+		id,
+		metadata
+	})).sort((left, right) => left.id.localeCompare(right.id));
+}
 //#endregion
 //#region src/agent/prompts.ts
 function getChatSystemPrompt(options = {}) {
@@ -15317,6 +15515,135 @@ function formatInfoError(error) {
 	return error instanceof Error ? error.message : String(error);
 }
 //#endregion
+//#region src/cli/integrations.ts
+const TOPCHESTER_CODEX_BLOCK_START = "# >>> topchester integration: codex";
+const TOPCHESTER_CODEX_BLOCK_END = "# <<< topchester integration: codex";
+function listIntegrationStatuses() {
+	return listAgentMetadata().filter(({ id }) => id !== "topchester").map(({ id, metadata }) => getIntegrationStatus(id, metadata.display_name));
+}
+function getIntegrationStatus(agent, displayName) {
+	const normalizedAgent = normalizeAgentId(agent);
+	const metadata = listAgentMetadata().find(({ id }) => id === normalizedAgent)?.metadata;
+	const name = displayName ?? metadata?.display_name ?? normalizedAgent;
+	if (normalizedAgent !== "codex") return {
+		agent: normalizedAgent,
+		displayName: name,
+		supported: false,
+		installed: false,
+		detail: "not supported yet"
+	};
+	return {
+		agent: normalizedAgent,
+		displayName: name,
+		supported: true,
+		installed: false,
+		configPath: getCodexConfigPath(),
+		detail: "not installed"
+	};
+}
+async function getIntegrationStatusAsync(agent) {
+	const status = getIntegrationStatus(agent);
+	if (status.agent !== "codex" || !status.configPath) return status;
+	const contents = await readTextIfExists(status.configPath);
+	const installed = contents.includes(TOPCHESTER_CODEX_BLOCK_START) && contents.includes(TOPCHESTER_CODEX_BLOCK_END);
+	return {
+		...status,
+		installed,
+		detail: installed ? "installed" : "not installed"
+	};
+}
+async function listIntegrationStatusesAsync(agent) {
+	if (agent) return [await getIntegrationStatusAsync(agent)];
+	return await Promise.all(listIntegrationStatuses().map((status) => getIntegrationStatusAsync(status.agent)));
+}
+async function installIntegration(agent, action = "installed") {
+	const status = await getIntegrationStatusAsync(agent);
+	if (!status.supported || status.agent !== "codex" || !status.configPath) throw new Error(`Unsupported integration: ${agent}`);
+	const next = appendMarkedBlock(removeMarkedBlock(await readTextIfExists(status.configPath)), formatCodexIntegrationBlock());
+	await mkdir(dirname(status.configPath), { recursive: true });
+	await writeFile(status.configPath, next);
+	return {
+		action,
+		status: await getIntegrationStatusAsync(status.agent)
+	};
+}
+async function removeIntegration(agent) {
+	const status = await getIntegrationStatusAsync(agent);
+	if (!status.supported || status.agent !== "codex" || !status.configPath) throw new Error(`Unsupported integration: ${agent}`);
+	const before = await readTextIfExists(status.configPath);
+	await mkdir(dirname(status.configPath), { recursive: true });
+	await writeFile(status.configPath, ensureTrailingNewline(removeMarkedBlock(before)));
+	return {
+		action: "removed",
+		status: await getIntegrationStatusAsync(status.agent)
+	};
+}
+function formatIntegrationStatuses(statuses) {
+	const lines = ["Integrations"];
+	for (const status of statuses) {
+		const state = status.supported ? status.installed ? "installed" : "not installed" : "unsupported";
+		lines.push(`${status.agent}: ${state}`);
+		if (status.configPath) lines.push(`  config: ${status.configPath}`);
+		if (!status.supported) lines.push(`  detail: ${status.detail}`);
+	}
+	return lines;
+}
+function formatIntegrationAction(action, status) {
+	return [
+		action === "installed" ? "Integration installed" : action === "repaired" ? "Integration repaired" : "Integration removed",
+		`agent: ${status.agent}`,
+		`state: ${status.installed ? "installed" : "not installed"}`,
+		...status.configPath ? [`config: ${status.configPath}`] : []
+	];
+}
+async function executeHookStop(agent) {
+	if (normalizeAgentId(agent ?? "") !== "codex") throw new Error(agent ? `Unsupported hook agent: ${agent}` : "Usage: topchester hook stop <agent>");
+}
+function getCodexConfigPath() {
+	return join(process.env.CODEX_HOME?.trim() || join(process.env.HOME || homedir(), ".codex"), "config.toml");
+}
+function formatCodexIntegrationBlock() {
+	return [
+		TOPCHESTER_CODEX_BLOCK_START,
+		"[[Stop]]",
+		"",
+		"[[Stop.hooks]]",
+		"type = \"command\"",
+		"command = \"topchester hook stop codex\"",
+		"timeout = 10",
+		"statusMessage = \"Notifying Topchester\"",
+		TOPCHESTER_CODEX_BLOCK_END
+	].join("\n");
+}
+function appendMarkedBlock(contents, block) {
+	const base = contents.trimEnd();
+	return `${base ? `${base}\n\n` : ""}${block}\n`;
+}
+function removeMarkedBlock(contents) {
+	const start = contents.indexOf(TOPCHESTER_CODEX_BLOCK_START);
+	if (start === -1) return contents;
+	const end = contents.indexOf(TOPCHESTER_CODEX_BLOCK_END, start);
+	if (end === -1) return contents;
+	return `${contents.slice(0, start)}${contents.slice(end + 35)}`.trimEnd();
+}
+async function readTextIfExists(path) {
+	try {
+		return await readFile(path, "utf8");
+	} catch (error) {
+		if (isNodeError(error) && error.code === "ENOENT") return "";
+		throw error;
+	}
+}
+function ensureTrailingNewline(value) {
+	return value ? `${value.trimEnd()}\n` : "";
+}
+function normalizeAgentId(value) {
+	return value.trim().toLowerCase();
+}
+function isNodeError(error) {
+	return error instanceof Error && "code" in error;
+}
+//#endregion
 //#region src/cli.ts
 async function runTopchesterCli(argv = process.argv, options = {}) {
 	const program = createTopchesterProgram();
@@ -15407,6 +15734,58 @@ function createTopchesterProgram() {
 	program.command("search").description("search compiled L1 knowledge entries").argument("<query...>", "search query").option("--limit <count>", "maximum number of matches", parsePositiveInteger).option("--json", "write full JSON search result to stdout").action(async (queryParts, options) => {
 		await executeKbSearchCommand(program, queryParts, options);
 	});
+	const integrationsCommand = program.command("integrations").description("manage Topchester integrations with other agents");
+	integrationsCommand.command("list").description("list supported integrations").action(async () => {
+		try {
+			console.log(formatIntegrationStatuses(await listIntegrationStatusesAsync()).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	integrationsCommand.command("status").description("check whether integrations are installed").argument("[agent]", "agent id").action(async (agent) => {
+		try {
+			console.log(formatIntegrationStatuses(await listIntegrationStatusesAsync(agent)).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	integrationsCommand.command("install").description("install Topchester lifecycle hooks for another agent").argument("<agent>", "agent id").action(async (agent) => {
+		try {
+			const result = await installIntegration(agent);
+			console.log(formatIntegrationAction(result.action, result.status).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	integrationsCommand.command("repair").description("repair a Topchester integration").argument("<agent>", "agent id").action(async (agent) => {
+		try {
+			const result = await installIntegration(agent, "repaired");
+			console.log(formatIntegrationAction(result.action, result.status).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	integrationsCommand.command("remove").description("remove a Topchester integration").argument("<agent>", "agent id").action(async (agent) => {
+		try {
+			const result = await removeIntegration(agent);
+			console.log(formatIntegrationAction(result.action, result.status).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	program.command("hook").description("low-level lifecycle hook endpoints").command("stop").description("receive a Stop hook from another agent").argument("<agent>", "agent id").action(async (agent) => {
+		try {
+			await executeHookStop(agent);
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
 	const kbCommand = program.command("kb").description("knowledge base commands");
 	kbCommand.command("init").description("initialize a project knowledge base").action(async () => {
 		const context = createContextFromOptions(program);
@@ -15650,4 +16029,4 @@ function formatDryRunSyncStatus(status) {
 //#endregion
 export { runTopchesterCli as t };
 
-//# sourceMappingURL=cli-CqFhOvlt.mjs.map
+//# sourceMappingURL=cli-AJknxj59.mjs.map