acpx 0.19.1 → 0.19.2

package/dist/runtime.js

@@ -1,7 +1,7 @@
-import { D as textPrompt, H as parseSessionRecord, R as readSessionRecord, St as isAcpResourceNotFoundError, U as serializeSessionRecordForDisk, V as assertPersistedKeyPolicy, bt as extractAcpError, j as findSession, t as tryCancelOnRunningOwner, vt as writePrivateJsonFile, z as resolveSessionRecord } from "./ipc-DAApJ5mi.js";
-import { $ as isRequestedModelUnsupportedError, A as applyInitialModelSelection, B as reconcileAgentSessionId, C as setSessionModeOnOwner, D as connectAndLoadSession, E as withConnectedSession, F as persistSessionOptions, G as recordPromptSubmission, H as cloneSessionConversation, I as sessionOptionsFromRecord, J as advertisedModelState, K as recordSessionUpdate, L as applyConversation, M as applyRequestedModelIfAdvertised, N as setDesiredModeId, O as applyConfigOptionSelection, P as normalizeSessionOptionShape, Q as RequestedModelUnsupportedError, R as applyLifecycleSnapshotToRecord, T as setSessionModelOnOwner, V as cloneSessionAcpxState, W as recordClientOperation, X as REQUESTED_MODEL_UNSUPPORTED_ERROR_CODE, Y as AcpClient, Z as REQUESTED_MODEL_UNSUPPORTED_REASONS, _ as cancelSessionPrompt, c as LiveSessionCheckpoint, ct as assertControlAuthority, ft as normalizeOutputError, h as ensureSession, j as applyModelSelection, k as applyConfigOptionsToRecord, l as runPromptTurn, q as trimConversationForRuntime, r as sendSession, s as DISCARD_OUTPUT_FORMATTER, st as TimeoutError, ut as withTimeout, v as closeSession, x as setSessionConfigOptionOnOwner, z as createInitialSessionRecord } from "./queue-owner-runtime-C4OOosbo.js";
+import { A as findSession, B as assertPersistedKeyPolicy, Ct as extractAcpError, E as textPrompt, H as serializeSessionRecordForDisk, L as readSessionRecord, R as resolveSessionRecord, St as normalizeOutputError, V as parseSessionRecord, gt as writePrivateJsonFile, t as tryCancelOnRunningOwner, wt as isAcpResourceNotFoundError } from "./ipc-D0ZMQ0q9.js";
 import { O as normalizeAgentCommandInput, a as createAgentRegistry, i as DEFAULT_AGENT_NAME } from "./agent-registry-DWlx5BQ4.js";
-import { t as watchSession } from "./watch-Cz6jbrRs.js";
+import { $ as isRequestedModelUnsupportedError, A as applyInitialModelSelection, B as reconcileAgentSessionId, C as setSessionModeOnOwner, D as connectAndLoadSession, E as withConnectedSession, F as persistSessionOptions, G as recordPromptSubmission, H as cloneSessionConversation, I as sessionOptionsFromRecord, J as advertisedModelState, K as recordSessionUpdate, L as applyConversation, M as applyRequestedModelIfAdvertised, N as setDesiredModeId, O as applyConfigOptionSelection, P as normalizeSessionOptionShape, Q as RequestedModelUnsupportedError, R as applyLifecycleSnapshotToRecord, T as setSessionModelOnOwner, V as cloneSessionAcpxState, W as recordClientOperation, X as REQUESTED_MODEL_UNSUPPORTED_ERROR_CODE, Y as AcpClient, Z as REQUESTED_MODEL_UNSUPPORTED_REASONS, _ as cancelSessionPrompt, c as LiveSessionCheckpoint, ct as assertControlAuthority, h as ensureSession, j as applyModelSelection, k as applyConfigOptionsToRecord, l as runPromptTurn, q as trimConversationForRuntime, r as sendSession, s as DISCARD_OUTPUT_FORMATTER, st as TimeoutError, ut as withTimeout, v as closeSession, x as setSessionConfigOptionOnOwner, z as createInitialSessionRecord } from "./queue-owner-runtime-W0lly6ap.js";
+import { t as watchSession } from "./watch-C0mwpJcN.js";
 import { fileURLToPath } from "node:url";
 import path from "node:path";
 import fs from "node:fs/promises";

package/dist/{session-watch-Bj9LoYUq.js → session-watch-_8yxQ6ba.js}

@@ -1,6 +1,6 @@
-import { i as JsonMessageSanitizer, t as createOutputFormatter } from "./output-Cnuji8Bo.js";
-import { at as isAcpJsonRpcMessage, ut as parsePromptStopReason } from "./ipc-DAApJ5mi.js";
-import { t as watchSession } from "./watch-Cz6jbrRs.js";
+import { i as JsonMessageSanitizer, t as createOutputFormatter } from "./output-GQnhkJMU.js";
+import { ct as parsePromptStopReason, rt as isAcpJsonRpcMessage } from "./ipc-D0ZMQ0q9.js";
+import { t as watchSession } from "./watch-C0mwpJcN.js";
 import { once } from "node:events";
 //#region src/cli/session-watch.ts
 function watchRenderer(policy) {
@@ -73,4 +73,4 @@ async function runSessionWatch(record, options) {
 //#endregion
 export { runSessionWatch };
 
-//# sourceMappingURL=session-watch-Bj9LoYUq.js.map
+//# sourceMappingURL=session-watch-_8yxQ6ba.js.map

package/dist/{session-watch-Bj9LoYUq.js.map → session-watch-_8yxQ6ba.js.map}

@@ -1 +1 @@
-{"version":3,"file":"session-watch-Bj9LoYUq.js","names":[],"sources":["../src/cli/session-watch.ts"],"sourcesContent":["import { once } from \"node:events\";\nimport { isAcpJsonRpcMessage, parsePromptStopReason } from \"../acp/jsonrpc.js\";\nimport type { SessionWatchEvent } from \"../session/journal.js\";\nimport { watchSession } from \"../session/watch.js\";\nimport type { OutputFormatter, OutputPolicy, SessionRecord } from \"../types.js\";\nimport { JsonMessageSanitizer } from \"./output/json-formatter.js\";\nimport { createOutputFormatter } from \"./output/output.js\";\n\nfunction watchRenderer(policy: OutputPolicy): (event: SessionWatchEvent) => string[] {\n  const chunks: string[] = [];\n  const stdout = {\n    write: (chunk: string) => {\n      chunks.push(chunk);\n    },\n  };\n  let sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);\n  let formatter = createOutputFormatter(policy.format, { stdout });\n  return (event) => {\n    chunks.length = 0;\n    if (event.type === \"turn_started\") {\n      sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);\n      formatter = createOutputFormatter(policy.format, { stdout });\n    }\n    if (policy.format === \"json\") {\n      chunks.push(\n        JSON.stringify(\n          event.type === \"message\"\n            ? { ...event, message: sanitizer.sanitize(event.message) }\n            : event,\n        ) + \"\\n\",\n      );\n    } else if (event.type === \"message\") {\n      renderWatchMessage(event, sanitizer, formatter, policy.format === \"quiet\");\n    } else {\n      if (event.type === \"turn_result\") {\n        formatter.flush();\n      }\n      if (policy.format !== \"quiet\") {\n        chunks.push(watchLifecycleLine(event));\n      }\n    }\n    return chunks;\n  };\n}\n\nfunction renderWatchMessage(\n  event: Extract<SessionWatchEvent, { type: \"message\" }>,\n  sanitizer: JsonMessageSanitizer,\n  formatter: OutputFormatter,\n  quiet: boolean,\n): void {\n  const message = sanitizer.sanitize(event.message);\n  if (!isAcpJsonRpcMessage(message)) {\n    throw new Error(\"Invalid sanitized session message\");\n  }\n  if (quiet || parsePromptStopReason(message) === undefined) {\n    formatter.onAcpMessage(message);\n  }\n}\n\nfunction watchLifecycleLine(event: Exclude<SessionWatchEvent, { type: \"message\" }>): string {\n  if (event.type === \"turn_started\") {\n    return `\\n[${event.requestId}] started cursor=${event.cursor}\\n`;\n  }\n  const detail =\n    event.result.status === \"failed\" ? event.result.error.message : event.result.stopReason;\n  return `\\n[${event.requestId}] ${event.result.status}${detail ? `: ${detail}` : \"\"} cursor=${event.cursor}\\n`;\n}\n\nexport async function runSessionWatch(\n  record: SessionRecord,\n  options: { cursor?: string; policy: OutputPolicy },\n): Promise<void> {\n  const stopped = new AbortController();\n  let outputError: Error | undefined;\n  const stop = () => stopped.abort();\n  const onOutputError = (error: Error) => {\n    if ((error as NodeJS.ErrnoException).code !== \"EPIPE\") {\n      outputError = error;\n    }\n    stop();\n  };\n  const render = watchRenderer(options.policy);\n  process.on(\"SIGINT\", stop);\n  process.on(\"SIGTERM\", stop);\n  process.on(\"SIGHUP\", stop);\n  process.stdout.on(\"error\", onOutputError);\n  try {\n    for await (const event of watchSession({\n      record,\n      cursor: options.cursor,\n      signal: stopped.signal,\n    })) {\n      for (const chunk of render(event)) {\n        if (stopped.signal.aborted) {\n          break;\n        }\n        if (!process.stdout.write(chunk)) {\n          await once(process.stdout, \"drain\", { signal: stopped.signal });\n        }\n      }\n    }\n  } catch (error) {\n    if (!stopped.signal.aborted) {\n      throw error;\n    }\n  } finally {\n    process.off(\"SIGINT\", stop);\n    process.off(\"SIGTERM\", stop);\n    process.off(\"SIGHUP\", stop);\n    process.stdout.off(\"error\", onOutputError);\n  }\n  if (outputError) {\n    throw outputError;\n  }\n}\n"],"mappings":";;;;;AAQA,SAAS,cAAc,QAA8D;CACnF,MAAM,SAAmB,CAAC;CAC1B,MAAM,SAAS,EACb,QAAQ,UAAkB;EACxB,OAAO,KAAK,KAAK;CACnB,EACF;CACA,IAAI,YAAY,IAAI,qBAAqB,OAAO,eAAe,IAAI;CACnE,IAAI,YAAY,sBAAsB,OAAO,QAAQ,EAAE,OAAO,CAAC;CAC/D,QAAQ,UAAU;EAChB,OAAO,SAAS;EAChB,IAAI,MAAM,SAAS,gBAAgB;GACjC,YAAY,IAAI,qBAAqB,OAAO,eAAe,IAAI;GAC/D,YAAY,sBAAsB,OAAO,QAAQ,EAAE,OAAO,CAAC;EAC7D;EACA,IAAI,OAAO,WAAW,QACpB,OAAO,KACL,KAAK,UACH,MAAM,SAAS,YACX;GAAE,GAAG;GAAO,SAAS,UAAU,SAAS,MAAM,OAAO;EAAE,IACvD,KACN,IAAI,IACN;OACK,IAAI,MAAM,SAAS,WACxB,mBAAmB,OAAO,WAAW,WAAW,OAAO,WAAW,OAAO;OACpE;GACL,IAAI,MAAM,SAAS,eACjB,UAAU,MAAM;GAElB,IAAI,OAAO,WAAW,SACpB,OAAO,KAAK,mBAAmB,KAAK,CAAC;EAEzC;EACA,OAAO;CACT;AACF;AAEA,SAAS,mBACP,OACA,WACA,WACA,OACM;CACN,MAAM,UAAU,UAAU,SAAS,MAAM,OAAO;CAChD,IAAI,CAAC,oBAAoB,OAAO,GAC9B,MAAM,IAAI,MAAM,mCAAmC;CAErD,IAAI,SAAS,sBAAsB,OAAO,MAAM,KAAA,GAC9C,UAAU,aAAa,OAAO;AAElC;AAEA,SAAS,mBAAmB,OAAgE;CAC1F,IAAI,MAAM,SAAS,gBACjB,OAAO,MAAM,MAAM,UAAU,mBAAmB,MAAM,OAAO;CAE/D,MAAM,SACJ,MAAM,OAAO,WAAW,WAAW,MAAM,OAAO,MAAM,UAAU,MAAM,OAAO;CAC/E,OAAO,MAAM,MAAM,UAAU,IAAI,MAAM,OAAO,SAAS,SAAS,KAAK,WAAW,GAAG,UAAU,MAAM,OAAO;AAC5G;AAEA,eAAsB,gBACpB,QACA,SACe;CACf,MAAM,UAAU,IAAI,gBAAgB;CACpC,IAAI;CACJ,MAAM,aAAa,QAAQ,MAAM;CACjC,MAAM,iBAAiB,UAAiB;EACtC,IAAK,MAAgC,SAAS,SAC5C,cAAc;EAEhB,KAAK;CACP;CACA,MAAM,SAAS,cAAc,QAAQ,MAAM;CAC3C,QAAQ,GAAG,UAAU,IAAI;CACzB,QAAQ,GAAG,WAAW,IAAI;CAC1B,QAAQ,GAAG,UAAU,IAAI;CACzB,QAAQ,OAAO,GAAG,SAAS,aAAa;CACxC,IAAI;EACF,WAAW,MAAM,SAAS,aAAa;GACrC;GACA,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;EAClB,CAAC,GACC,KAAK,MAAM,SAAS,OAAO,KAAK,GAAG;GACjC,IAAI,QAAQ,OAAO,SACjB;GAEF,IAAI,CAAC,QAAQ,OAAO,MAAM,KAAK,GAC7B,MAAM,KAAK,QAAQ,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,CAAC;EAElE;CAEJ,SAAS,OAAO;EACd,IAAI,CAAC,QAAQ,OAAO,SAClB,MAAM;CAEV,UAAU;EACR,QAAQ,IAAI,UAAU,IAAI;EAC1B,QAAQ,IAAI,WAAW,IAAI;EAC3B,QAAQ,IAAI,UAAU,IAAI;EAC1B,QAAQ,OAAO,IAAI,SAAS,aAAa;CAC3C;CACA,IAAI,aACF,MAAM;AAEV"}
+{"version":3,"file":"session-watch-_8yxQ6ba.js","names":[],"sources":["../src/cli/session-watch.ts"],"sourcesContent":["import { once } from \"node:events\";\nimport { isAcpJsonRpcMessage, parsePromptStopReason } from \"../acp/jsonrpc.js\";\nimport type { SessionWatchEvent } from \"../session/journal.js\";\nimport { watchSession } from \"../session/watch.js\";\nimport type { OutputFormatter, OutputPolicy, SessionRecord } from \"../types.js\";\nimport { JsonMessageSanitizer } from \"./output/json-formatter.js\";\nimport { createOutputFormatter } from \"./output/output.js\";\n\nfunction watchRenderer(policy: OutputPolicy): (event: SessionWatchEvent) => string[] {\n  const chunks: string[] = [];\n  const stdout = {\n    write: (chunk: string) => {\n      chunks.push(chunk);\n    },\n  };\n  let sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);\n  let formatter = createOutputFormatter(policy.format, { stdout });\n  return (event) => {\n    chunks.length = 0;\n    if (event.type === \"turn_started\") {\n      sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);\n      formatter = createOutputFormatter(policy.format, { stdout });\n    }\n    if (policy.format === \"json\") {\n      chunks.push(\n        JSON.stringify(\n          event.type === \"message\"\n            ? { ...event, message: sanitizer.sanitize(event.message) }\n            : event,\n        ) + \"\\n\",\n      );\n    } else if (event.type === \"message\") {\n      renderWatchMessage(event, sanitizer, formatter, policy.format === \"quiet\");\n    } else {\n      if (event.type === \"turn_result\") {\n        formatter.flush();\n      }\n      if (policy.format !== \"quiet\") {\n        chunks.push(watchLifecycleLine(event));\n      }\n    }\n    return chunks;\n  };\n}\n\nfunction renderWatchMessage(\n  event: Extract<SessionWatchEvent, { type: \"message\" }>,\n  sanitizer: JsonMessageSanitizer,\n  formatter: OutputFormatter,\n  quiet: boolean,\n): void {\n  const message = sanitizer.sanitize(event.message);\n  if (!isAcpJsonRpcMessage(message)) {\n    throw new Error(\"Invalid sanitized session message\");\n  }\n  if (quiet || parsePromptStopReason(message) === undefined) {\n    formatter.onAcpMessage(message);\n  }\n}\n\nfunction watchLifecycleLine(event: Exclude<SessionWatchEvent, { type: \"message\" }>): string {\n  if (event.type === \"turn_started\") {\n    return `\\n[${event.requestId}] started cursor=${event.cursor}\\n`;\n  }\n  const detail =\n    event.result.status === \"failed\" ? event.result.error.message : event.result.stopReason;\n  return `\\n[${event.requestId}] ${event.result.status}${detail ? `: ${detail}` : \"\"} cursor=${event.cursor}\\n`;\n}\n\nexport async function runSessionWatch(\n  record: SessionRecord,\n  options: { cursor?: string; policy: OutputPolicy },\n): Promise<void> {\n  const stopped = new AbortController();\n  let outputError: Error | undefined;\n  const stop = () => stopped.abort();\n  const onOutputError = (error: Error) => {\n    if ((error as NodeJS.ErrnoException).code !== \"EPIPE\") {\n      outputError = error;\n    }\n    stop();\n  };\n  const render = watchRenderer(options.policy);\n  process.on(\"SIGINT\", stop);\n  process.on(\"SIGTERM\", stop);\n  process.on(\"SIGHUP\", stop);\n  process.stdout.on(\"error\", onOutputError);\n  try {\n    for await (const event of watchSession({\n      record,\n      cursor: options.cursor,\n      signal: stopped.signal,\n    })) {\n      for (const chunk of render(event)) {\n        if (stopped.signal.aborted) {\n          break;\n        }\n        if (!process.stdout.write(chunk)) {\n          await once(process.stdout, \"drain\", { signal: stopped.signal });\n        }\n      }\n    }\n  } catch (error) {\n    if (!stopped.signal.aborted) {\n      throw error;\n    }\n  } finally {\n    process.off(\"SIGINT\", stop);\n    process.off(\"SIGTERM\", stop);\n    process.off(\"SIGHUP\", stop);\n    process.stdout.off(\"error\", onOutputError);\n  }\n  if (outputError) {\n    throw outputError;\n  }\n}\n"],"mappings":";;;;;AAQA,SAAS,cAAc,QAA8D;CACnF,MAAM,SAAmB,CAAC;CAC1B,MAAM,SAAS,EACb,QAAQ,UAAkB;EACxB,OAAO,KAAK,KAAK;CACnB,EACF;CACA,IAAI,YAAY,IAAI,qBAAqB,OAAO,eAAe,IAAI;CACnE,IAAI,YAAY,sBAAsB,OAAO,QAAQ,EAAE,OAAO,CAAC;CAC/D,QAAQ,UAAU;EAChB,OAAO,SAAS;EAChB,IAAI,MAAM,SAAS,gBAAgB;GACjC,YAAY,IAAI,qBAAqB,OAAO,eAAe,IAAI;GAC/D,YAAY,sBAAsB,OAAO,QAAQ,EAAE,OAAO,CAAC;EAC7D;EACA,IAAI,OAAO,WAAW,QACpB,OAAO,KACL,KAAK,UACH,MAAM,SAAS,YACX;GAAE,GAAG;GAAO,SAAS,UAAU,SAAS,MAAM,OAAO;EAAE,IACvD,KACN,IAAI,IACN;OACK,IAAI,MAAM,SAAS,WACxB,mBAAmB,OAAO,WAAW,WAAW,OAAO,WAAW,OAAO;OACpE;GACL,IAAI,MAAM,SAAS,eACjB,UAAU,MAAM;GAElB,IAAI,OAAO,WAAW,SACpB,OAAO,KAAK,mBAAmB,KAAK,CAAC;EAEzC;EACA,OAAO;CACT;AACF;AAEA,SAAS,mBACP,OACA,WACA,WACA,OACM;CACN,MAAM,UAAU,UAAU,SAAS,MAAM,OAAO;CAChD,IAAI,CAAC,oBAAoB,OAAO,GAC9B,MAAM,IAAI,MAAM,mCAAmC;CAErD,IAAI,SAAS,sBAAsB,OAAO,MAAM,KAAA,GAC9C,UAAU,aAAa,OAAO;AAElC;AAEA,SAAS,mBAAmB,OAAgE;CAC1F,IAAI,MAAM,SAAS,gBACjB,OAAO,MAAM,MAAM,UAAU,mBAAmB,MAAM,OAAO;CAE/D,MAAM,SACJ,MAAM,OAAO,WAAW,WAAW,MAAM,OAAO,MAAM,UAAU,MAAM,OAAO;CAC/E,OAAO,MAAM,MAAM,UAAU,IAAI,MAAM,OAAO,SAAS,SAAS,KAAK,WAAW,GAAG,UAAU,MAAM,OAAO;AAC5G;AAEA,eAAsB,gBACpB,QACA,SACe;CACf,MAAM,UAAU,IAAI,gBAAgB;CACpC,IAAI;CACJ,MAAM,aAAa,QAAQ,MAAM;CACjC,MAAM,iBAAiB,UAAiB;EACtC,IAAK,MAAgC,SAAS,SAC5C,cAAc;EAEhB,KAAK;CACP;CACA,MAAM,SAAS,cAAc,QAAQ,MAAM;CAC3C,QAAQ,GAAG,UAAU,IAAI;CACzB,QAAQ,GAAG,WAAW,IAAI;CAC1B,QAAQ,GAAG,UAAU,IAAI;CACzB,QAAQ,OAAO,GAAG,SAAS,aAAa;CACxC,IAAI;EACF,WAAW,MAAM,SAAS,aAAa;GACrC;GACA,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;EAClB,CAAC,GACC,KAAK,MAAM,SAAS,OAAO,KAAK,GAAG;GACjC,IAAI,QAAQ,OAAO,SACjB;GAEF,IAAI,CAAC,QAAQ,OAAO,MAAM,KAAK,GAC7B,MAAM,KAAK,QAAQ,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,CAAC;EAElE;CAEJ,SAAS,OAAO;EACd,IAAI,CAAC,QAAQ,OAAO,SAClB,MAAM;CAEV,UAAU;EACR,QAAQ,IAAI,UAAU,IAAI;EAC1B,QAAQ,IAAI,WAAW,IAAI;EAC3B,QAAQ,IAAI,UAAU,IAAI;EAC1B,QAAQ,OAAO,IAAI,SAAS,aAAa;CAC3C;CACA,IAAI,aACF,MAAM;AAEV"}

package/dist/watch-C0mwpJcN.js

@@ -0,0 +1,85 @@
+import { J as watchSession$1, Kt as SessionNotFoundError, L as readSessionRecord, b as observeProcessIncarnation, l as readQueueOwnerRecord, q as SessionWatchError } from "./ipc-D0ZMQ0q9.js";
+//#region src/session/watch.ts
+const OWNER_OBSERVATION_REUSE_MS = 1e3;
+function reuseObservation(cached) {
+	if (!cached) return false;
+	if (cached.decisionPending) {
+		cached.decisionPending = false;
+		return true;
+	}
+	return cached.state === "gone" || performance.now() - cached.checkedAt < OWNER_OBSERVATION_REUSE_MS;
+}
+function selectOwner(owner, observation) {
+	const key = owner ? JSON.stringify([
+		owner.pid,
+		owner.ownerGeneration,
+		owner.processIdentity
+	]) : null;
+	if (key === observation.ownerKey) return false;
+	observation.ownerKey = key;
+	observation.incarnation = void 0;
+	observation.missingRequest = null;
+	return true;
+}
+async function runningOwner(recordId, observation) {
+	let owner = await readQueueOwnerRecord(recordId);
+	selectOwner(owner, observation);
+	if (!owner) return { queried: false };
+	const cached = observation.incarnation;
+	let queried = false;
+	if (!reuseObservation(cached)) {
+		queried = true;
+		const state = await observeProcessIncarnation(owner.pid, owner.processIdentity);
+		owner = await readQueueOwnerRecord(recordId);
+		if (selectOwner(owner, observation)) return {
+			owner,
+			queried
+		};
+		observation.incarnation = {
+			state,
+			checkedAt: performance.now(),
+			decisionPending: true
+		};
+	}
+	return {
+		owner: observation.incarnation?.state === "gone" ? void 0 : owner,
+		queried
+	};
+}
+async function continueWatching(recordId, pendingRequestId, observation) {
+	const { owner, queried } = await runningOwner(recordId, observation);
+	if (queried) {
+		observation.missingRequest = owner ? null : pendingRequestId;
+		return true;
+	}
+	if (owner) {
+		if (!owner.sessionWatch) throw new SessionWatchError("WATCH_OWNER_UNSUPPORTED", "This running session owner predates passive watching. Let it expire when idle or explicitly close the session before starting new work.");
+		observation.missingRequest = null;
+		return true;
+	}
+	if (pendingRequestId && pendingRequestId === observation.missingRequest) throw new SessionWatchError("WATCH_OUTCOME_UNKNOWN", `Session owner ended without a settled result for request ${pendingRequestId}; its outcome is unknown. Resume watching from the last cursor after recovery, and do not automatically replay the prompt.`);
+	observation.missingRequest = pendingRequestId;
+	if (pendingRequestId) return true;
+	return await isSessionOpen(recordId);
+}
+async function isSessionOpen(recordId) {
+	const record = await readSessionRecord(recordId);
+	if (!record || record.acpxRecordId !== recordId) throw new SessionNotFoundError(recordId);
+	return record.closed !== true;
+}
+function watchSession(options) {
+	return { [Symbol.asyncIterator]() {
+		const observation = {
+			ownerKey: null,
+			missingRequest: null
+		};
+		return watchSession$1({
+			...options,
+			continueWatching: (record, requestId) => continueWatching(record.acpxRecordId, requestId, observation)
+		})[Symbol.asyncIterator]();
+	} };
+}
+//#endregion
+export { watchSession as t };
+
+//# sourceMappingURL=watch-C0mwpJcN.js.map

package/dist/watch-C0mwpJcN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-C0mwpJcN.js","names":["watchJournal"],"sources":["../src/session/watch.ts"],"sourcesContent":["import { SessionNotFoundError } from \"../errors.js\";\nimport { observeProcessIncarnation, type ProcessIncarnation } from \"../process-identity.js\";\nimport type { SessionRecord } from \"../types.js\";\nimport {\n  SessionWatchError,\n  watchSession as watchJournal,\n  type SessionWatchEvent,\n} from \"./journal.js\";\nimport { readSessionRecord } from \"./persistence.js\";\nimport { readQueueOwnerRecord, type QueueOwnerRecord } from \"./queue/lease-store.js\";\n\nconst OWNER_OBSERVATION_REUSE_MS = 1_000;\n\ntype WatchObservation = {\n  ownerKey: string | null;\n  incarnation?: { state: ProcessIncarnation; checkedAt: number; decisionPending: boolean };\n  missingRequest: string | null;\n};\n\nfunction reuseObservation(cached: WatchObservation[\"incarnation\"]): boolean {\n  if (!cached) {\n    return false;\n  }\n  // A query first forces a journal reread, then gets one decision pass even\n  // after a slow consumer. Otherwise repeated probes can defer errors forever.\n  if (cached.decisionPending) {\n    cached.decisionPending = false;\n    return true;\n  }\n  return (\n    cached.state === \"gone\" || performance.now() - cached.checkedAt < OWNER_OBSERVATION_REUSE_MS\n  );\n}\n\nfunction selectOwner(owner: QueueOwnerRecord | undefined, observation: WatchObservation): boolean {\n  // Heartbeats and retirement receipts do not change the owner's incarnation.\n  // Keep only this small key, never the potentially large descendant receipt.\n  const key = owner\n    ? JSON.stringify([owner.pid, owner.ownerGeneration, owner.processIdentity])\n    : null;\n  if (key === observation.ownerKey) {\n    return false;\n  }\n  observation.ownerKey = key;\n  observation.incarnation = undefined;\n  observation.missingRequest = null;\n  return true;\n}\n\nasync function runningOwner(\n  recordId: string,\n  observation: WatchObservation,\n): Promise<{ owner?: QueueOwnerRecord; queried: boolean }> {\n  let owner = await readQueueOwnerRecord(recordId);\n  selectOwner(owner, observation);\n  if (!owner) {\n    return { queried: false };\n  }\n  const cached = observation.incarnation;\n  let queried = false;\n  // A verified departed incarnation cannot return. Cache that fact even for\n  // idle watches; other observations are bounded independently of journal polls.\n  if (!reuseObservation(cached)) {\n    queried = true;\n    // Observation cadence must not truncate the canonical provider's query budget.\n    const state = await observeProcessIncarnation(owner.pid, owner.processIdentity);\n    owner = await readQueueOwnerRecord(recordId);\n    if (selectOwner(owner, observation)) {\n      // A replacement may have settled or recovered the journal during the\n      // query. Let the reader revisit it before interpreting the old result.\n      return { owner, queried };\n    }\n    observation.incarnation = { state, checkedAt: performance.now(), decisionPending: true };\n  }\n  return { owner: observation.incarnation?.state === \"gone\" ? undefined : owner, queried };\n}\n\nasync function continueWatching(\n  recordId: string,\n  pendingRequestId: string | null,\n  observation: WatchObservation,\n): Promise<boolean> {\n  const { owner, queried } = await runningOwner(recordId, observation);\n  if (queried) {\n    // A probe can outlast a journal update, including replacement by an older\n    // owner. Revisit the journal before any unsupported/unknown/end decision.\n    observation.missingRequest = owner ? null : pendingRequestId;\n    return true;\n  }\n  if (owner) {\n    if (!owner.sessionWatch) {\n      throw new SessionWatchError(\n        \"WATCH_OWNER_UNSUPPORTED\",\n        \"This running session owner predates passive watching. Let it expire when idle or explicitly close the session before starting new work.\",\n      );\n    }\n    observation.missingRequest = null;\n    return true;\n  }\n  if (pendingRequestId && pendingRequestId === observation.missingRequest) {\n    throw new SessionWatchError(\n      \"WATCH_OUTCOME_UNKNOWN\",\n      `Session owner ended without a settled result for request ${pendingRequestId}; its outcome is unknown. Resume watching from the last cursor after recovery, and do not automatically replay the prompt.`,\n    );\n  }\n  observation.missingRequest = pendingRequestId;\n  if (pendingRequestId) {\n    return true;\n  }\n  return await isSessionOpen(recordId);\n}\n\nasync function isSessionOpen(recordId: string): Promise<boolean> {\n  const record = await readSessionRecord(recordId);\n  if (!record || record.acpxRecordId !== recordId) {\n    throw new SessionNotFoundError(recordId);\n  }\n  return record.closed !== true;\n}\n\nexport function watchSession(options: {\n  record: SessionRecord | Promise<SessionRecord>;\n  cursor?: string;\n  signal?: AbortSignal;\n}): AsyncIterable<SessionWatchEvent> {\n  return {\n    [Symbol.asyncIterator]() {\n      const observation: WatchObservation = { ownerKey: null, missingRequest: null };\n      return watchJournal({\n        ...options,\n        continueWatching: (record, requestId) =>\n          continueWatching(record.acpxRecordId, requestId, observation),\n      })[Symbol.asyncIterator]();\n    },\n  };\n}\n"],"mappings":";;AAWA,MAAM,6BAA6B;AAQnC,SAAS,iBAAiB,QAAkD;CAC1E,IAAI,CAAC,QACH,OAAO;CAIT,IAAI,OAAO,iBAAiB;EAC1B,OAAO,kBAAkB;EACzB,OAAO;CACT;CACA,OACE,OAAO,UAAU,UAAU,YAAY,IAAI,IAAI,OAAO,YAAY;AAEtE;AAEA,SAAS,YAAY,OAAqC,aAAwC;CAGhG,MAAM,MAAM,QACR,KAAK,UAAU;EAAC,MAAM;EAAK,MAAM;EAAiB,MAAM;CAAe,CAAC,IACxE;CACJ,IAAI,QAAQ,YAAY,UACtB,OAAO;CAET,YAAY,WAAW;CACvB,YAAY,cAAc,KAAA;CAC1B,YAAY,iBAAiB;CAC7B,OAAO;AACT;AAEA,eAAe,aACb,UACA,aACyD;CACzD,IAAI,QAAQ,MAAM,qBAAqB,QAAQ;CAC/C,YAAY,OAAO,WAAW;CAC9B,IAAI,CAAC,OACH,OAAO,EAAE,SAAS,MAAM;CAE1B,MAAM,SAAS,YAAY;CAC3B,IAAI,UAAU;CAGd,IAAI,CAAC,iBAAiB,MAAM,GAAG;EAC7B,UAAU;EAEV,MAAM,QAAQ,MAAM,0BAA0B,MAAM,KAAK,MAAM,eAAe;EAC9E,QAAQ,MAAM,qBAAqB,QAAQ;EAC3C,IAAI,YAAY,OAAO,WAAW,GAGhC,OAAO;GAAE;GAAO;EAAQ;EAE1B,YAAY,cAAc;GAAE;GAAO,WAAW,YAAY,IAAI;GAAG,iBAAiB;EAAK;CACzF;CACA,OAAO;EAAE,OAAO,YAAY,aAAa,UAAU,SAAS,KAAA,IAAY;EAAO;CAAQ;AACzF;AAEA,eAAe,iBACb,UACA,kBACA,aACkB;CAClB,MAAM,EAAE,OAAO,YAAY,MAAM,aAAa,UAAU,WAAW;CACnE,IAAI,SAAS;EAGX,YAAY,iBAAiB,QAAQ,OAAO;EAC5C,OAAO;CACT;CACA,IAAI,OAAO;EACT,IAAI,CAAC,MAAM,cACT,MAAM,IAAI,kBACR,2BACA,yIACF;EAEF,YAAY,iBAAiB;EAC7B,OAAO;CACT;CACA,IAAI,oBAAoB,qBAAqB,YAAY,gBACvD,MAAM,IAAI,kBACR,yBACA,4DAA4D,iBAAiB,2HAC/E;CAEF,YAAY,iBAAiB;CAC7B,IAAI,kBACF,OAAO;CAET,OAAO,MAAM,cAAc,QAAQ;AACrC;AAEA,eAAe,cAAc,UAAoC;CAC/D,MAAM,SAAS,MAAM,kBAAkB,QAAQ;CAC/C,IAAI,CAAC,UAAU,OAAO,iBAAiB,UACrC,MAAM,IAAI,qBAAqB,QAAQ;CAEzC,OAAO,OAAO,WAAW;AAC3B;AAEA,SAAgB,aAAa,SAIQ;CACnC,OAAO,EACL,CAAC,OAAO,iBAAiB;EACvB,MAAM,cAAgC;GAAE,UAAU;GAAM,gBAAgB;EAAK;EAC7E,OAAOA,eAAa;GAClB,GAAG;GACH,mBAAmB,QAAQ,cACzB,iBAAiB,OAAO,cAAc,WAAW,WAAW;EAChE,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC;CAC3B,EACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acpx",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "description": "Headless CLI client for the Agent Client Protocol (ACP) — talk to coding agents from the command line",
   "keywords": [
     "acp",