acpx 0.16.0 → 0.17.0

package/dist/{session-options-t3d-F4dn.d.ts → session-options-Dp6mzNSy.d.ts}

@@ -342,5 +342,5 @@ type SessionAgentOptions = {
   env?: Record<string, string>;
 };
 //#endregion
-export { PermissionStats as C, PermissionPolicy as S, PromptInput as T, AcpProcessStarted as _, AcpElicitationHandler as a, NonInteractivePermissionPolicy as b, AcpElicitationResponse as c, AcpPermissionRequest as d, AcpProcessExit as f, AcpProcessSpawnFailure as g, AcpProcessLifecycle as h, AcpElicitationContext as i, AcpPermissionDecision as l, AcpProcessLaunchScope as m, SystemPromptOption as n, AcpElicitationMode as o, AcpProcessLaunch as p, AcpClientOptions as r, AcpElicitationRequest as s, SessionAgentOptions as t, AcpPermissionHandler as u, AuthPolicy as v, SessionRecord as w, PermissionMode as x, McpServer$1 as y };
-//# sourceMappingURL=session-options-t3d-F4dn.d.ts.map
+export { PermissionPolicy as C, PromptInput as E, PermissionMode as S, SessionRecord as T, AcpProcessSpawnFailure as _, AcpElicitationHandler as a, McpServer$1 as b, AcpElicitationResponse as c, AcpPermissionHandler as d, AcpPermissionRequest as f, AcpProcessLifecycle as g, AcpProcessLaunchScope as h, AcpElicitationContext as i, AcpJsonRpcMessage as l, AcpProcessLaunch as m, SystemPromptOption as n, AcpElicitationMode as o, AcpProcessExit as p, AcpClientOptions as r, AcpElicitationRequest as s, SessionAgentOptions as t, AcpPermissionDecision as u, AcpProcessStarted as v, PermissionStats as w, NonInteractivePermissionPolicy as x, AuthPolicy as y };
+//# sourceMappingURL=session-options-Dp6mzNSy.d.ts.map

package/dist/{session-options-t3d-F4dn.d.ts.map → session-options-Dp6mzNSy.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"session-options-t3d-F4dn.d.ts","names":[],"sources":["../src/prompt-content.ts","../src/types.ts","../src/runtime/engine/session-options.ts"],"mappings":";;KAEY,cAAc;;;KCgBd;EACV;EACA,KAAK;EACL,cAAc;;KAGJ;EACN;;EACA;;EACA;;EACA;;EACA;;KAEM,wBACV,SAAS,sBACT;EAAW,QAAQ;MAChB,QAAQ;cAEA;KACD,6BAA6B;KAC7B,wBAAwB;KAExB;;EAEV,WAAW;;EAEX,QAAQ;;KAGL;EACH,QAAQ;;KAGE;EAEN;EACA,UAAU,eAAe;IACvB;EACD;IAAsB;EACtB;IAAqB;KAEhB,yBACV,SAAS,uBACT,SAAS,0BACN,QAAQ;cAiBA;KACD,yBAAyB;cAExB;KACD,qBAAqB;cAEpB;KACD,yCAAyC;cAExC;KACD,iCAAiC;KAEjC;EACV;EACA;EACA;EACA,gBAAgB;;KAGN;EACV;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA;EACA;EACA;;KAQU,oBAAoB;KACpB;KAwCA;EACV;EACA;EACA;EACA;;KAGU;KAUA;KAEA;EACV,QAAQ;EACR,QAAQ;EACR;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;;KAgDU,wBACR;EAAW;KACX;EAAW;EAAyB;KACpC;EAAW;EAAuB;;KAE1B,mBAAmB;EAC7B;EACA,OAAO;EACP;EACA;EACA;;KAGU,oBAAoB,mBAC9B;EACE;EACA;;KAGQ,yBAAyB,mBACnC;EACE;EACA;;KAGQ,iBAAiB,oBAC3B;EACE;EACA,QAAQ,OAAO;EACf;;;;;;;;;KAUQ;EACV,iBAAiB,QAAQ,qBAAqB;EAC9C,aAAa,SAAS,sBAAsB;EAC5C,iBAAiB,SAAS,2BAA2B;EACrD,UAAU,MAAM,mBAAmB;;KAGzB;EACV;EACA;;EAEA,kBAAkB;EAClB;EACA,aAAa;EACb,gBAAgB;EAChB,4BAA4B;EAC5B,mBAAmB;EACnB,kBAAkB;EAClB,aAAa;EACb;EACA;EACA,4BAA4B;EAC5B,mBAAmB;EACnB,qBAAqB;EACrB;EACA;EACA;IACE;IACA;IACA;IACA;MAA0B;;IAC1B,MAAM;;EAER,gBAAgB,WAAW,qBAAqB,SAAS;EACzD,sBAAsB,WAAW,qBAAqB,SAAS;EAC/D,mBAAmB,cAAc;EACjC,qBAAqB,WAAW;EAChC,0BAA0B,OAAO;EACjC,sBAAsB;;cAGX;KACD;EACV;EACA;IACE;IACA;;;KAIQ;EACV;EACA;;KAGU;EAEN;;EAGA;IACE;IACA;;;EAIF,OAAO;;EAGP,OAAO;;KAGD;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EAEN;;EAGA,OAAO;;KAGD;EACV;EACA;EACA;EACA,SAAS;EACT;;KAGU;EAEN;;EAGA;IACE;IACA;;;EAIF;;EAGA,SAAS;;KAGH;EACV;EACA,SAAS;;KAGC;EACV,SAAS;EACT,cAAc,eAAe;EAC7B;;KAGU;EAEN,MAAM;;EAGN,OAAO;;KAID;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;;KAYU;EACV;EACA;EACA;EACA,yBAAyB;EACzB;EACA;EACA,wBAAwB;EACxB;EACA,qBAAqB;EACrB,iBAAiB;EACjB;IACE;IACA;IACA;IACA;MAA2B;;IAC3B,MAAM;;;KAIE;EACV;EACA;EACA;EACA;;KAGU;EACV,eAAe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA,sBAAsB,OAAO;EAC7B;EACA;EACA;EACA,oBAAoB;EACpB;EACA,UAAU;EACV;EACA,wBAAwB;EACxB,kBAAkB;EAClB,qBAAqB,eAAe;EACpC,OAAO;EACP,eAAe;;;;KClfL;EAAgC;;KAEhC;EACV;EACA;EACA;EACA,eAAe;;;;;;;;;;EAUf,MAAM"}
+{"version":3,"file":"session-options-Dp6mzNSy.d.ts","names":[],"sources":["../src/prompt-content.ts","../src/types.ts","../src/runtime/engine/session-options.ts"],"mappings":";;KAEY,cAAc;;;KCgBd;EACV;EACA,KAAK;EACL,cAAc;;KAGJ;EACN;;EACA;;EACA;;EACA;;EACA;;KAEM,wBACV,SAAS,sBACT;EAAW,QAAQ;MAChB,QAAQ;cAEA;KACD,6BAA6B;KAC7B,wBAAwB;KAExB;;EAEV,WAAW;;EAEX,QAAQ;;KAGL;EACH,QAAQ;;KAGE;EAEN;EACA,UAAU,eAAe;IACvB;EACD;IAAsB;EACtB;IAAqB;KAEhB,yBACV,SAAS,uBACT,SAAS,0BACN,QAAQ;cAiBA;KACD,yBAAyB;cAExB;KACD,qBAAqB;cAEpB;KACD,yCAAyC;cAExC;KACD,iCAAiC;KAEjC;EACV;EACA;EACA;EACA,gBAAgB;;KAGN;EACV;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA;EACA;EACA;;KAQU,oBAAoB;KACpB;KAwCA;EACV;EACA;EACA;EACA;;KAGU;KAUA;KAEA;EACV,QAAQ;EACR,QAAQ;EACR;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;;KAgDU,wBACR;EAAW;KACX;EAAW;EAAyB;KACpC;EAAW;EAAuB;;KAE1B,mBAAmB;EAC7B;EACA,OAAO;EACP;EACA;EACA;;KAGU,oBAAoB,mBAC9B;EACE;EACA;;KAGQ,yBAAyB,mBACnC;EACE;EACA;;KAGQ,iBAAiB,oBAC3B;EACE;EACA,QAAQ,OAAO;EACf;;;;;;;;;KAUQ;EACV,iBAAiB,QAAQ,qBAAqB;EAC9C,aAAa,SAAS,sBAAsB;EAC5C,iBAAiB,SAAS,2BAA2B;EACrD,UAAU,MAAM,mBAAmB;;KAGzB;EACV;EACA;;EAEA,kBAAkB;EAClB;EACA,aAAa;EACb,gBAAgB;EAChB,4BAA4B;EAC5B,mBAAmB;EACnB,kBAAkB;EAClB,aAAa;EACb;EACA;EACA,4BAA4B;EAC5B,mBAAmB;EACnB,qBAAqB;EACrB;EACA;EACA;IACE;IACA;IACA;IACA;MAA0B;;IAC1B,MAAM;;EAER,gBAAgB,WAAW,qBAAqB,SAAS;EACzD,sBAAsB,WAAW,qBAAqB,SAAS;EAC/D,mBAAmB,cAAc;EACjC,qBAAqB,WAAW;EAChC,0BAA0B,OAAO;EACjC,sBAAsB;;cAGX;KACD;EACV;EACA;IACE;IACA;;;KAIQ;EACV;EACA;;KAGU;EAEN;;EAGA;IACE;IACA;;;EAIF,OAAO;;EAGP,OAAO;;KAGD;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EAEN;;EAGA,OAAO;;KAGD;EACV;EACA;EACA;EACA,SAAS;EACT;;KAGU;EAEN;;EAGA;IACE;IACA;;;EAIF;;EAGA,SAAS;;KAGH;EACV;EACA,SAAS;;KAGC;EACV,SAAS;EACT,cAAc,eAAe;EAC7B;;KAGU;EAEN,MAAM;;EAGN,OAAO;;KAID;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;;KAYU;EACV;EACA;EACA;EACA,yBAAyB;EACzB;EACA;EACA,wBAAwB;EACxB;EACA,qBAAqB;EACrB,iBAAiB;EACjB;IACE;IACA;IACA;IACA;MAA2B;;IAC3B,MAAM;;;KAIE;EACV;EACA;EACA;EACA;;KAGU;EACV,eAAe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA,sBAAsB,OAAO;EAC7B;EACA;EACA;EACA,oBAAoB;EACpB;EACA,UAAU;EACV;EACA,wBAAwB;EACxB,kBAAkB;EAClB,qBAAqB,eAAe;EACpC,OAAO;EACP,eAAe;;;;KClfL;EAAgC;;KAEhC;EACV;EACA;EACA;EACA,eAAe;;;;;;;;;;EAUf,MAAM"}

package/dist/session-watch--UX5dh00.js

@@ -0,0 +1,76 @@
+import { i as JsonMessageSanitizer, t as createOutputFormatter } from "./output-BPPjvJTI.js";
+import { ot as parsePromptStopReason, tt as isAcpJsonRpcMessage } from "./ipc-D3akHMEq.js";
+import { t as watchSession } from "./watch-BbBxO-kb.js";
+import { once } from "node:events";
+//#region src/cli/session-watch.ts
+function watchRenderer(policy) {
+	const chunks = [];
+	const stdout = { write: (chunk) => {
+		chunks.push(chunk);
+	} };
+	let sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);
+	let formatter = createOutputFormatter(policy.format, { stdout });
+	return (event) => {
+		chunks.length = 0;
+		if (event.type === "turn_started") {
+			sanitizer = new JsonMessageSanitizer(policy.suppressReads, true);
+			formatter = createOutputFormatter(policy.format, { stdout });
+		}
+		if (policy.format === "json") chunks.push(JSON.stringify(event.type === "message" ? {
+			...event,
+			message: sanitizer.sanitize(event.message)
+		} : event) + "\n");
+		else if (event.type === "message") renderWatchMessage(event, sanitizer, formatter, policy.format === "quiet");
+		else {
+			formatter.flush();
+			if (policy.format !== "quiet") chunks.push(watchLifecycleLine(event));
+		}
+		return chunks;
+	};
+}
+function renderWatchMessage(event, sanitizer, formatter, quiet) {
+	const message = sanitizer.sanitize(event.message);
+	if (!isAcpJsonRpcMessage(message)) throw new Error("Invalid sanitized session message");
+	if (quiet || parsePromptStopReason(message) === void 0) formatter.onAcpMessage(message);
+}
+function watchLifecycleLine(event) {
+	if (event.type === "turn_started") return `\n[${event.requestId}] started cursor=${event.cursor}\n`;
+	const detail = event.result.status === "failed" ? event.result.error.message : event.result.stopReason;
+	return `\n[${event.requestId}] ${event.result.status}${detail ? `: ${detail}` : ""} cursor=${event.cursor}\n`;
+}
+async function runSessionWatch(record, options) {
+	const stopped = new AbortController();
+	let outputError;
+	const stop = () => stopped.abort();
+	const onOutputError = (error) => {
+		if (error.code !== "EPIPE") outputError = error;
+		stop();
+	};
+	const render = watchRenderer(options.policy);
+	process.on("SIGINT", stop);
+	process.on("SIGTERM", stop);
+	process.on("SIGHUP", stop);
+	process.stdout.on("error", onOutputError);
+	try {
+		for await (const event of watchSession({
+			record,
+			cursor: options.cursor,
+			signal: stopped.signal
+		})) for (const chunk of render(event)) {
+			if (stopped.signal.aborted) break;
+			if (!process.stdout.write(chunk)) await once(process.stdout, "drain", { signal: stopped.signal });
+		}
+	} catch (error) {
+		if (!stopped.signal.aborted) throw error;
+	} finally {
+		process.off("SIGINT", stop);
+		process.off("SIGTERM", stop);
+		process.off("SIGHUP", stop);
+		process.stdout.off("error", onOutputError);
+	}
+	if (outputError) throw outputError;
+}
+//#endregion
+export { runSessionWatch };
+
+//# sourceMappingURL=session-watch--UX5dh00.js.map

package/dist/session-watch--UX5dh00.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-watch--UX5dh00.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      formatter.flush();\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,UAAU,MAAM;GAChB,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-BbBxO-kb.js

@@ -0,0 +1,32 @@
+import { G as watchSession$1, Ht as SessionNotFoundError, P as readSessionRecord, W as SessionWatchError, d as readQueueOwnerRecord, ht as isProcessAlive } from "./ipc-D3akHMEq.js";
+//#region src/session/watch.ts
+async function continueWatching(recordId, pendingRequestId, observation) {
+	const owner = await readQueueOwnerRecord(recordId);
+	if (owner && isProcessAlive(owner.pid)) {
+		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 = { missingRequest: null };
+		return watchSession$1({
+			...options,
+			continueWatching: (record, requestId) => continueWatching(record.acpxRecordId, requestId, observation)
+		})[Symbol.asyncIterator]();
+	} };
+}
+//#endregion
+export { watchSession as t };
+
+//# sourceMappingURL=watch-BbBxO-kb.js.map

package/dist/watch-BbBxO-kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-BbBxO-kb.js","names":["watchJournal"],"sources":["../src/session/watch.ts"],"sourcesContent":["import { SessionNotFoundError } from \"../errors.js\";\nimport { isProcessAlive } from \"../process-liveness.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 } from \"./queue/lease-store.js\";\n\nasync function continueWatching(\n  recordId: string,\n  pendingRequestId: string | null,\n  observation: { missingRequest: string | null },\n): Promise<boolean> {\n  const owner = await readQueueOwnerRecord(recordId);\n  if (owner && isProcessAlive(owner.pid)) {\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: { missingRequest: string | 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,eAAe,iBACb,UACA,kBACA,aACkB;CAClB,MAAM,QAAQ,MAAM,qBAAqB,QAAQ;CACjD,IAAI,SAAS,eAAe,MAAM,GAAG,GAAG;EACtC,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,cAAiD,EAAE,gBAAgB,KAAK;EAC9E,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.16.0",
+  "version": "0.17.0",
   "description": "Headless CLI client for the Agent Client Protocol (ACP) — talk to coding agents from the command line",
   "keywords": [
     "acp",

package/skills/acpx/SKILL.md

@@ -29,6 +29,7 @@ Core capabilities:
 - Prompt input via stdin or `--file`
 - Config files with global+project merge and `config show|init`
 - Session metadata/history inspection (`sessions show`, `sessions history`)
+- Passive replay and live observation (`sessions watch -s <name> --cursor <cursor>`; omit the cursor for retained history)
 - Local agent process checks via `status`
 - Stable ACP client methods for filesystem and terminal requests
 - Stable ACP `authenticate` handshake via env/config credentials
@@ -62,7 +63,7 @@ acpx [global_options] cancel [-s <name>]
 acpx [global_options] set-mode <mode> [-s <name>]
 acpx [global_options] set <key> <value> [-s <name>]
 acpx [global_options] status [-s <name>]
-acpx [global_options] sessions [list | new [--name <name>] | ensure [--name <name>] | close [name] | show [name] | history [name] [--limit <count>] | export [name] --output <path> | import <archive> [--name <name>] [--cwd <dir>] | prune [--dry-run] [--before <date> | --older-than <days>] [--include-history]]
+acpx [global_options] sessions [list | new [--name <name>] | ensure [--name <name>] | close [name] | show [name] | history [name] [--limit <count>] | watch [-s <name>] [--cursor <cursor>] | export [name] --output <path> | import <archive> [--name <name>] [--cwd <dir>] | prune [--dry-run] [--before <date> | --older-than <days>] [--include-history]]
 acpx [global_options] config [show | init]
 acpx [global_options] flow run <file> [--input-json '<json>' | --input-file <path>] [--default-agent <name>]
 
@@ -73,7 +74,7 @@ acpx [global_options] <agent> cancel [-s <name>]
 acpx [global_options] <agent> set-mode <mode> [-s <name>]
 acpx [global_options] <agent> set <key> <value> [-s <name>]
 acpx [global_options] <agent> status [-s <name>]
-acpx [global_options] <agent> sessions [list | new [--name <name>] | ensure [--name <name>] | close [name] | show [name] | history [name] [--limit <count>] | export [name] --output <path> | import <archive> [--name <name>] [--cwd <dir>] | prune [--dry-run] [--before <date> | --older-than <days>] [--include-history]]
+acpx [global_options] <agent> sessions [list | new [--name <name>] | ensure [--name <name>] | close [name] | show [name] | history [name] [--limit <count>] | watch [-s <name>] [--cursor <cursor>] | export [name] --output <path> | import <archive> [--name <name>] [--cwd <dir>] | prune [--dry-run] [--before <date> | --older-than <days>] [--include-history]]
 ```
 
 If prompt text is omitted and stdin is piped, `acpx` reads prompt text from stdin.
@@ -211,6 +212,8 @@ Behavior:
 
 ### Sessions
 
+Use `acpx --format json pi sessions watch -s reviewer` to observe another client's work. Resume with `--cursor` using the last event's opaque cursor. Watchers do not cancel turns when stopped; use `turn_result` for the settled outcome, and treat owner-loss errors as unknown outcomes rather than retry instructions. See [Watching sessions](https://github.com/openclaw/acpx/blob/main/docs/session-watch.md).
+
 ```bash
 acpx sessions
 acpx sessions list

package/dist/client-5levcBIs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-5levcBIs.d.ts","names":[],"sources":["../src/acp/model-support.ts","../src/acp/client.ts"],"mappings":";;;KAGY;EACV;EACA;EACA,iBAAiB;IACf;IACA;;;cAaS;KAED,4CAA4C;cAE3C;KAKD,0CAA0C;cAEzC,uCAAuC;WACzC;WACA,QAAQ;EAEL,YAAA,iBAAiB,QAAQ;;iBAgBvB,iCACd,iBACC,SAAS;;;KCqJP;EACH;EACA;EACA;;KAGU;EACV;EACA;EACA,gBAAgB;EAChB,SAAS;EACT;EACA;;KAGU;EACV;EACA,gBAAgB;EAChB,SAAS;EACT;EACA;;KAGU,sBAAsB;KA8B7B;KA8EA,uBAAuB,KAAK,iCAC/B,QAAQ,KAAK;KAEH;EACV;EACA,QAAQ,OAAO;EACf;EACA,QAAQ;EACR;;KAGU;EACV;EACA;EACA;EACA,WAAW;;cA0CA;UACH;UACA;UACA;mBACS;mBACA;UACT;UACA;UACA;mBAQS;mBAMA;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;mBACS;mBACA;mBACA;UACT;UACA;UACA;UACA;mBACS;mBACA;mBACA;mBACA;EAEL,YAAA,SAAS;MAmCjB,oBAAoB;EAIxB;EAIA,sBAAsB;EAItB,6BAA6B;EAW7B;EAIA;EAIA;EAIA;EAIA,iBACE,UAAU,KACR;EAWJ;EAIA,qBAAqB;IACnB,iBAAiB;IACjB,4BAA4B;IAC5B,mBAAmB;IACnB;IACA;IACA;IACA;;UAuBM;UASA;EAcR,mBAAmB;EASnB,gBAAgB;EAUhB;EAIA,qBAAqB;EASf,SAAS;UA6ED;UA6BN;UAiBM;UAcA;UAsDA;UAmBN;UAuDM;UAuBA;UAwBA;UA4BN;EAeF,cAAc,eAAyB,QAAQ;EA+C/C,YAAY,mBAAmB,eAAyB,QAAQ;EAKhE,uBACJ,mBACA,cACA,UAAS,qBACR,QAAQ;EAiCL,cAAc,mBAAmB,eAAyB,QAAQ;UAkBhE;UAWA;EAKF,OACJ,mBACA,QAAQ,sBACR,yBAAyB,sBACzB,gBAAgB,uBAChB,sBAAsB,uBACrB,QAAQ;UA4CH;UAmBA;UAaA;UAcA;UAuBA;UAYA;UAQA;EAOF,eAAe,mBAAmB,iBAAiB;EAcnD,uBACJ,mBACA,kBACA,gBACC,QAAQ;EAmBL,gBACJ,mBACA,iBACA,kBAAkB,uBACjB,QAAQ;UAoBG;UAqBA;UAkBN;UAoBA;UAgBA;UAeA;EAOF,OAAO,oBAAoB;EA0B3B,aAAa,oBAAoB;EAkBjC,aAAa,SAAQ,sBAA2B,QAAQ;EAOxD,6BAA6B;EAS7B,mBAAmB,kBAAiB,QAAQ;EAyC5C,SAAS;UAiDP;UAIA;UAIM;UAON;UAWM;UAgCN;UAYM;UAyBN;UAkBA;UAOA;UAOA;UAcA;UASA;UAqEM;UA0BN;UA2CA;UAQA;UAUA;UAcM;UA6BA;UAqBA;UAgCN;UAuBA;UAqBA;UAIA;UAwBM;UA6BN;UAsBA;UAmBM;UAiBN;UAqBA;UAQA;UAYA;UA+BA;UAmBA;UAyBA;UAKA;UAwBA;UASA;UAUM;UAmCN;UAYM;UAeA;UASA;UAWN;UASA;UAMA;UAaA;UAWM;UAkBA;EAgCR,0BAA0B;IAC9B;IACA;MACE"}