acpx 0.12.0 → 0.12.1

package/dist/{output-CjdF5rHk.js → output-fNqTAsFQ.js}

@@ -1,4 +1,4 @@
-import { $ as getPerfMetricsSnapshot, B as absolutePath, C as mergeSessionOptions, Ct as promptToDisplayText, D as applyLifecycleSnapshotToRecord, Dt as withInterrupt, E as applyConversation, Et as TimeoutError, F as modelStateFromConfigOptions, Ft as isRetryablePromptError, G as listSessions, H as findSession, I as splitCommandLine, It as normalizeOutputError, J as pruneSessions, K as listSessionsForAgent, Lt as extractAcpError, N as assertRequestedModelSupported, Ot as withTimeout, Pt as formatErrorMessage, Q as formatPerfMetric, Qt as QueueProtocolError, S as advertisedModelState, T as sessionOptionsFromRecord, Tt as InterruptedError, U as findSessionByDirectoryWalk, Ut as OUTPUT_ERROR_CODES, V as findGitRepositoryRoot, W as isoNow, Wt as OUTPUT_ERROR_ORIGINS, X as writeSessionRecord, Y as resolveSessionRecord, Zt as QueueConnectionError, _ as createSessionConversation, _t as parseJsonRpcErrorMessage, a as applyRequestedModelIfAdvertised, at as startPerfTimer, b as recordSessionUpdate, bt as isPromptInput, c as setCurrentModelId, ct as normalizeRuntimeSessionId, d as setDesiredModelId, dt as sessionBaseDir, et as incrementPerfCounter, f as syncAdvertisedModelState, ft as sessionEventActivePath, g as cloneSessionConversation, gt as isAcpJsonRpcMessage, h as cloneSessionAcpxState, ht as extractSessionUpdateNotification, i as connectAndLoadSession, it as setPerfGauge, k as AcpClient, l as setDesiredConfigOption, m as applyConfigOptionsToState, mt as sessionEventSegmentPath, n as runPromptTurn, nt as recordPerfDuration, o as currentModelIdFromSetModelResponse, p as applyConfigOptionsToRecord, pt as sessionEventLockPath, q as normalizeName, r as withConnectedSession, rt as resetPerfMetrics, s as clearDesiredConfigOption, t as LiveSessionCheckpoint, tt as measurePerf, u as setDesiredModeId, ut as defaultSessionEventLog, v as recordClientOperation, vt as parsePromptStopReason, w as persistSessionOptions, wt as textPrompt, x as trimConversationForRuntime, y as recordPromptSubmission, zt as toAcpErrorPayload } from "./live-checkpoint-ClPCSdrW.js";
+import { $ as getPerfMetricsSnapshot, B as absolutePath, C as mergeSessionOptions, Ct as promptToDisplayText, D as applyLifecycleSnapshotToRecord, Dt as withInterrupt, E as applyConversation, Et as TimeoutError, F as modelStateFromConfigOptions, Ft as isRetryablePromptError, G as listSessions, H as findSession, I as splitCommandLine, It as normalizeOutputError, J as pruneSessions, K as listSessionsForAgent, Lt as extractAcpError, N as assertRequestedModelSupported, Ot as withTimeout, Pt as formatErrorMessage, Q as formatPerfMetric, Qt as QueueProtocolError, S as advertisedModelState, T as sessionOptionsFromRecord, Tt as InterruptedError, U as findSessionByDirectoryWalk, Ut as OUTPUT_ERROR_CODES, V as findGitRepositoryRoot, W as isoNow, Wt as OUTPUT_ERROR_ORIGINS, X as writeSessionRecord, Y as resolveSessionRecord, Zt as QueueConnectionError, _ as createSessionConversation, _t as parseJsonRpcErrorMessage, a as applyRequestedModelIfAdvertised, at as startPerfTimer, b as recordSessionUpdate, bt as isPromptInput, c as setCurrentModelId, ct as normalizeRuntimeSessionId, d as setDesiredModelId, dt as sessionBaseDir, et as incrementPerfCounter, f as syncAdvertisedModelState, ft as sessionEventActivePath, g as cloneSessionConversation, gt as isAcpJsonRpcMessage, h as cloneSessionAcpxState, ht as extractSessionUpdateNotification, i as connectAndLoadSession, it as setPerfGauge, k as AcpClient, l as setDesiredConfigOption, m as applyConfigOptionsToState, mt as sessionEventSegmentPath, n as runPromptTurn, nt as recordPerfDuration, o as currentModelIdFromSetModelResponse, p as applyConfigOptionsToRecord, pt as sessionEventLockPath, q as normalizeName, r as withConnectedSession, rt as resetPerfMetrics, s as clearDesiredConfigOption, t as LiveSessionCheckpoint, tt as measurePerf, u as setDesiredModeId, ut as defaultSessionEventLog, v as recordClientOperation, vt as parsePromptStopReason, w as persistSessionOptions, wt as textPrompt, x as trimConversationForRuntime, y as recordPromptSubmission, zt as toAcpErrorPayload } from "./live-checkpoint-DQp4JSHD.js";
 import fs, { mkdtempSync, realpathSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import fs$1 from "node:fs/promises";
@@ -104,18 +104,26 @@ function isQueueOwnerHeartbeatStale(owner) {
 }
 async function ensureQueueDir() {
 	const baseDir = queueBaseDir();
-	await fs$1.mkdir(baseDir, {
-		recursive: true,
-		mode: 448
-	});
-	await fs$1.chmod(baseDir, 448);
+	try {
+		await fs$1.mkdir(baseDir, {
+			recursive: true,
+			mode: 448
+		});
+		await fs$1.chmod(baseDir, 448);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Failed to prepare queue directory ${baseDir}: ${message}`, { cause: error });
+	}
 	const socketDir = queueSocketBaseDir();
-	if (socketDir) {
+	if (socketDir) try {
 		await fs$1.mkdir(socketDir, {
 			recursive: true,
 			mode: 448
 		});
 		await fs$1.chmod(socketDir, 448);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Failed to prepare queue socket directory ${socketDir}: ${message}`, { cause: error });
 	}
 }
 async function removeSocketFile(socketPath) {
@@ -1310,6 +1318,7 @@ async function submitToQueueOwner(owner, options) {
 		owner,
 		request,
 		onAccepted: ({ resolve }) => {
+			options.onQueueAccepted?.();
 			options.outputFormatter.setContext({ sessionId: options.sessionId });
 			if (!options.waitForCompletion) resolve({
 				queued: true,
@@ -2311,7 +2320,9 @@ function writeQueueOwnerPayloadFile(payload) {
 	});
 	return payloadPath;
 }
-function buildQueueOwnerSpawnOptions(payloadFilePath) {
+/** Max stderr bytes retained for cold-start diagnostics. */
+const QUEUE_OWNER_STARTUP_STDERR_MAX_BYTES = 4e3;
+function buildQueueOwnerSpawnOptions(payloadFilePath, opts) {
 	const env = {
 		...process.env,
 		[QUEUE_OWNER_PAYLOAD_FILE_ENV]: payloadFilePath
@@ -2319,14 +2330,77 @@ function buildQueueOwnerSpawnOptions(payloadFilePath) {
 	delete env[QUEUE_OWNER_PAYLOAD_ENV];
 	return {
 		detached: true,
-		stdio: "ignore",
+		stdio: opts?.captureStderr === true ? [
+			"ignore",
+			"ignore",
+			"pipe"
+		] : "ignore",
 		env,
 		windowsHide: true
 	};
 }
+function formatQueueOwnerStartupFailure(params) {
+	const parts = [`Session queue owner failed to start for session ${params.sessionId}`];
+	if (params.exit.spawnError) parts.push(`spawn error: ${params.exit.spawnError.message}`);
+	else if (params.exit.exited) {
+		const codePart = params.exit.code === null ? "null" : String(params.exit.code);
+		const signalPart = params.exit.signal ? `, signal ${params.exit.signal}` : "";
+		parts.push(`exited with code ${codePart}${signalPart} before binding its socket`);
+	}
+	const tail = params.logTail.trim();
+	if (tail.length > 0) parts.push(`stderr:\n${tail}`);
+	return parts.join(": ");
+}
 function spawnQueueOwnerProcess(options) {
 	const payloadPath = writeQueueOwnerPayloadFile(JSON.stringify(options));
-	spawn(process.execPath, resolveQueueOwnerSpawnArgs(), buildQueueOwnerSpawnOptions(payloadPath)).unref();
+	let exited = false;
+	let code = null;
+	let signal = null;
+	let spawnError;
+	let capturing = true;
+	let stderrTail = Buffer.alloc(0);
+	const child = spawn(process.execPath, resolveQueueOwnerSpawnArgs(), buildQueueOwnerSpawnOptions(payloadPath, { captureStderr: true }));
+	const stopStartupCapture = () => {
+		if (!capturing) return;
+		capturing = false;
+		const stderr = child.stderr;
+		if (!stderr) return;
+		stderr.removeAllListeners("data");
+		stderr.on("data", () => {});
+		stderr.resume();
+		stderr.unref();
+	};
+	child.stderr?.on("data", (chunk) => {
+		if (!capturing) return;
+		const buf = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+		const combined = Buffer.concat([stderrTail, buf]);
+		stderrTail = combined.length > 4e3 ? combined.subarray(combined.length - QUEUE_OWNER_STARTUP_STDERR_MAX_BYTES) : combined;
+	});
+	child.stderr?.on("error", () => {});
+	child.on("error", (error) => {
+		spawnError = error;
+	});
+	child.on("close", (exitCode, exitSignal) => {
+		exited = true;
+		code = exitCode;
+		signal = exitSignal;
+		stopStartupCapture();
+	});
+	child.unref();
+	return {
+		pid: child.pid,
+		getExitState: () => ({
+			exited,
+			code,
+			signal,
+			...spawnError ? { spawnError } : {}
+		}),
+		readLogTail: (maxBytes = QUEUE_OWNER_STARTUP_STDERR_MAX_BYTES) => {
+			const start = Math.max(0, stderrTail.length - maxBytes);
+			return stderrTail.subarray(start).toString("utf8");
+		},
+		stopStartupCapture
+	};
 }
 //#endregion
 //#region src/session/events.ts
@@ -3093,7 +3167,8 @@ async function runSessionPrompt(options) {
 	const savePromptSuccess = async (response) => {
 		await flushPendingMessages(false);
 		output.flush();
-		record.lastUsedAt = isoNow();
+		const now = isoNow();
+		record.lastUsedAt = now;
 		record.closed = false;
 		record.closedAt = void 0;
 		record.protocolVersion = client.initializeResult?.protocolVersion;
@@ -3282,7 +3357,7 @@ async function sendSessionDirect(options) {
 const QUEUE_OWNER_STARTUP_MAX_ATTEMPTS = 120;
 const QUEUE_OWNER_HEARTBEAT_INTERVAL_MS = 5e3;
 const QUEUE_OWNER_ACTIVE_TURN_CANCEL_GRACE_MS = 750;
-async function submitToRunningOwner(options, waitForCompletion) {
+async function submitToRunningOwner(options, waitForCompletion, extras) {
 	return await trySubmitToRunningOwner({
 		sessionId: options.sessionId,
 		message: promptToDisplayText(options.prompt),
@@ -3299,7 +3374,8 @@ async function submitToRunningOwner(options, waitForCompletion) {
 		promptRetries: options.promptRetries,
 		waitForCompletion,
 		verbose: options.verbose,
-		sessionOptions: options.sessionOptions
+		sessionOptions: options.sessionOptions,
+		onQueueAccepted: extras?.onQueueAccepted
 	});
 }
 function createQueueOwnerSharedClient(options, sessionRecord) {
@@ -3366,6 +3442,9 @@ function logDeferredCancelFailure(error, verbose) {
 	if (!verbose) return;
 	process.stderr.write(`[acpx] failed to apply deferred cancel: ${formatErrorMessage(error)}\n`);
 }
+function queueOwnerExitIsFatal(exit) {
+	return exit.exited && (exit.spawnError !== void 0 || exit.code !== 0 || exit.signal !== null);
+}
 function logQueueOwnerReady(params) {
 	if (!params.verbose) return;
 	process.stderr.write(`[acpx] queue owner ready for session ${params.sessionId} (ttlMs=${params.ttlMs}, maxQueueDepth=${params.maxQueueDepth})\n`);
@@ -3602,14 +3681,42 @@ async function sendSession(options) {
 	const waitForCompletion = options.waitForCompletion !== false;
 	const queuedToOwner = await submitToRunningOwner(options, waitForCompletion);
 	if (queuedToOwner) return queuedToOwner;
-	spawnQueueOwnerProcess(queueOwnerRuntimeOptionsFromSend(options));
+	const owner = spawnQueueOwnerProcess(queueOwnerRuntimeOptionsFromSend(options));
+	const onQueueAccepted = () => {
+		owner.stopStartupCapture();
+	};
 	for (let attempt = 0; attempt < QUEUE_OWNER_STARTUP_MAX_ATTEMPTS; attempt += 1) {
-		const queued = await submitToRunningOwner(options, waitForCompletion);
-		if (queued) return queued;
+		const queued = await submitToRunningOwner(options, waitForCompletion, { onQueueAccepted });
+		if (queued) {
+			owner.stopStartupCapture();
+			return queued;
+		}
+		const exit = owner.getExitState();
+		if (queueOwnerExitIsFatal(exit)) {
+			const message = formatQueueOwnerStartupFailure({
+				sessionId: options.sessionId,
+				exit,
+				logTail: owner.readLogTail()
+			});
+			owner.stopStartupCapture();
+			throw new Error(message);
+		}
 		await waitMs(50);
 	}
-	throw new Error(`Session queue owner failed to start for session ${options.sessionId}`);
+	const finalExit = owner.getExitState();
+	const message = formatQueueOwnerStartupFailure({
+		sessionId: options.sessionId,
+		exit: finalExit.exited ? finalExit : {
+			exited: false,
+			code: null,
+			signal: null
+		},
+		logTail: owner.readLogTail()
+	});
+	owner.stopStartupCapture();
+	throw new Error(message);
 }
+const queueOwnerRuntimeTestInternals = { queueOwnerExitIsFatal };
 //#endregion
 //#region src/session/session.ts
 var session_exports = /* @__PURE__ */ __exportAll({
@@ -3632,6 +3739,7 @@ var session_exports = /* @__PURE__ */ __exportAll({
 	mergeConnectedModelState: () => mergeConnectedModelState,
 	normalizeQueueOwnerTtlMs: () => normalizeQueueOwnerTtlMs,
 	pruneSessions: () => pruneSessions,
+	queueOwnerRuntimeTestInternals: () => queueOwnerRuntimeTestInternals,
 	runOnce: () => runOnce,
 	runQueuedTask: () => runQueuedTask,
 	runSessionQueueOwner: () => runSessionQueueOwner,
@@ -4590,4 +4698,4 @@ function createOutputFormatter(format, options = {}) {
 //#endregion
 export { runSessionQueueOwner as a, buildQueueOwnerArgOverride as c, createSessionWithClient as d, cancelSessionPrompt as f, __exportAll as g, isProcessAlive as h, session_exports as i, flushPerfMetricsCapture as l, DEFAULT_QUEUE_OWNER_TTL_MS as m, getTextErrorRemediationHints as n, runOnce as o, probeQueueOwnerHealth as p, output_exports as r, sendSessionDirect as s, createOutputFormatter as t, installPerfMetricsCapture as u };
 
-//# sourceMappingURL=output-CjdF5rHk.js.map
+//# sourceMappingURL=output-fNqTAsFQ.js.map