@ycodium-ai/agent-acp 0.2.3210 → 0.2.3214

package/dist/index.js

@@ -8,8 +8,8 @@ var __export = (target, all) => {
 import { definePlugin } from "@ycodium-ai/plugin-api";
 
 // src/acpInstance.ts
-import * as NodeOS2 from "node:os";
-import * as NodePath3 from "node:path";
+import * as NodeOS3 from "node:os";
+import * as NodePath4 from "node:path";
 import { mergeLaunchEnv, modelSelectionStringOption } from "@ycodium-ai/plugin-api/executor";
 import { nodeStreamsFromHandle as nodeStreamsFromHandle2 } from "@ycodium-ai/plugin-api/process-stdin";
 
@@ -26927,6 +26927,92 @@ function readOpenToolCalls(toolCalls, turnId) {
   return running;
 }
 
+// ../../packages/ycodium-acp-executor/src/protocol-log.ts
+import * as NodeFS from "node:fs";
+import * as NodeOS from "node:os";
+import * as NodePath2 from "node:path";
+var DEFAULT_MAX_BYTES = 8 * 1024 * 1024;
+var UNSAFE_FILE_CHARS = /[^A-Za-z0-9._-]+/gu;
+function safeFileName(value) {
+  return value.replaceAll(UNSAFE_FILE_CHARS, "_");
+}
+function createAcpProtocolLogFile(input2) {
+  const maxBytes = input2.maxBytes ?? DEFAULT_MAX_BYTES;
+  NodeFS.mkdirSync(input2.directory, { recursive: true });
+  const filePath = NodePath2.join(
+    input2.directory,
+    `${safeFileName(input2.provider)}-${safeFileName(input2.threadId)}-${Date.now().toString(36)}.ndjson`
+  );
+  const stream = (input2.openStream ?? ((path) => NodeFS.createWriteStream(path, { flags: "a" })))(
+    filePath
+  );
+  let bytes = 0;
+  let stopped = false;
+  const closed = Promise.withResolvers();
+  let closing = false;
+  stream.once("close", () => closed.resolve());
+  stream.on("error", () => {
+    stopped = true;
+    stream.destroy();
+  });
+  const writeTruncated = () => {
+    stopped = true;
+    const marker = `${JSON.stringify({ at: (/* @__PURE__ */ new Date()).toISOString(), stage: "truncated" })}
+`;
+    if (bytes + Buffer.byteLength(marker) <= maxBytes) stream.write(marker);
+    stream.end();
+  };
+  const writeLine = (value) => {
+    if (stopped) return;
+    const line = `${JSON.stringify(value)}
+`;
+    const lineBytes = Buffer.byteLength(line);
+    if (bytes + lineBytes > maxBytes) {
+      writeTruncated();
+      return;
+    }
+    bytes += lineBytes;
+    stream.write(line);
+  };
+  return {
+    path: filePath,
+    write: (event) => writeLine({
+      at: (/* @__PURE__ */ new Date()).toISOString(),
+      direction: event.direction,
+      stage: event.stage,
+      payload: event.payload
+    }),
+    close: async () => {
+      if (closing) return closed.promise;
+      closing = true;
+      stopped = true;
+      stream.end();
+      await closed.promise;
+    }
+  };
+}
+function createAcpProtocolLogFromEnv(input2) {
+  const flag = process.env.YCODIUM_ACP_PROTOCOL_LOG;
+  if (flag !== "1" && flag?.toLowerCase() !== "true") return void 0;
+  const configured = process.env.YCODIUM_ACP_PROTOCOL_LOG_DIR?.trim();
+  const directory = configured && configured.length > 0 ? configured : NodePath2.join(NodeOS.tmpdir(), "ycodium-acp-protocol");
+  try {
+    const sink = createAcpProtocolLogFile({
+      directory,
+      provider: input2.provider,
+      threadId: input2.threadId
+    });
+    input2.log?.info("acp protocol frames are being recorded", { path: sink.path });
+    return sink;
+  } catch (error62) {
+    input2.log?.warn?.("acp protocol frame log could not be opened", {
+      directory,
+      error: error62 instanceof Error ? error62.message : String(error62)
+    });
+    return void 0;
+  }
+}
+
 // ../../packages/ycodium-acp-executor/src/executor.ts
 var DEFAULT_CANCEL_GRACE_MS = 5e3;
 function defaultNowIso() {
@@ -27035,9 +27121,16 @@ function createAcpExecutor(options) {
   });
   const { rememberSettledPromptKey, abortPendingSettlement, settleFromNotification } = createExecutorSettlement({ hooks, shared });
   const promptResults = createPromptResults({ options, shared });
+  const protocolLogSink = options.protocolLog === void 0 ? createAcpProtocolLogFromEnv({
+    provider: options.provider,
+    threadId: options.threadId,
+    ...options.log === void 0 ? {} : { log: options.log }
+  }) : void 0;
+  const protocolLog = options.protocolLog ?? protocolLogSink?.write;
   const connection = createAcpConnection({
     readable: options.readable,
     writable: options.writable,
+    ...protocolLog === void 0 ? {} : { logger: protocolLog },
     onInboundFailure: (error62) => {
       options.log?.warn?.("acp connection closed: an inbound request could not be answered", {
         threadId: options.threadId,
@@ -27134,7 +27227,11 @@ function createAcpExecutor(options) {
     notifyPromptSettled,
     shared
   });
-  const { cancel, compact, dispose } = createExecutorLifecycle({
+  const {
+    cancel,
+    compact,
+    dispose: disposeLifecycle
+  } = createExecutorLifecycle({
     promptResults,
     failIfDisposed,
     requireStarted,
@@ -27161,6 +27258,7 @@ function createAcpExecutor(options) {
     onInputDead,
     shared
   });
+  let disposeOnce;
   return {
     get generation() {
       return shared.generation;
@@ -27183,7 +27281,16 @@ function createAcpExecutor(options) {
     setNativeMode,
     compact,
     openToolCalls: () => readOpenToolCalls(toolCalls, shared.activeTurnId),
-    dispose
+    dispose: () => {
+      disposeOnce ??= (async () => {
+        try {
+          await disposeLifecycle();
+        } finally {
+          await protocolLogSink?.close();
+        }
+      })();
+      return disposeOnce;
+    }
   };
 }
 
@@ -27571,9 +27678,9 @@ function tokenizeLaunchArgs(value) {
 }
 
 // src/probeModels.ts
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath2 from "node:path";
+import * as NodeFS2 from "node:fs";
+import * as NodeOS2 from "node:os";
+import * as NodePath3 from "node:path";
 import {
   describeExecutorSpawnFailure,
   ExecutorSpawnRefusedError,
@@ -27585,7 +27692,7 @@ var CLIENT_INFO = { name: "ycodium-agent-acp-probe", version: "0.2.0" };
 var ACP_EFFORT_OPTION_ID = "reasoning";
 function acpProbeSessionCwd(instanceId) {
   const safe = instanceId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return NodePath2.join(NodeOS.tmpdir(), `ycodium-acp-probe-${safe}`);
+  return NodePath3.join(NodeOS2.tmpdir(), `ycodium-acp-probe-${safe}`);
 }
 function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -27648,7 +27755,7 @@ async function probeAcpModelsViaSession(input2) {
   const { recipe, host, env } = input2;
   const probeCwd = acpProbeSessionCwd(host.instanceId);
   try {
-    NodeFS.mkdirSync(probeCwd, { recursive: true });
+    NodeFS2.mkdirSync(probeCwd, { recursive: true });
   } catch (error62) {
     return { kind: "failed", detail: probeFailureDetail(error62), version: null };
   }
@@ -27755,9 +27862,9 @@ var EventBus = class {
   }
 };
 function expandHomePath(value) {
-  if (value === "~") return NodeOS2.homedir();
+  if (value === "~") return NodeOS3.homedir();
   if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath3.join(NodeOS2.homedir(), value.slice(2));
+    return NodePath4.join(NodeOS3.homedir(), value.slice(2));
   }
   return value;
 }
@@ -27782,7 +27889,7 @@ function nowIso() {
 }
 function acpContinuationKey(recipe) {
   const homePath = recipe.homePath.trim();
-  const resolvedHomePath = homePath.length > 0 ? NodePath3.resolve(expandHomePath(homePath)) : "";
+  const resolvedHomePath = homePath.length > 0 ? NodePath4.resolve(expandHomePath(homePath)) : "";
   return `acp:home:${recipe.binaryPath.trim()}\0${resolvedHomePath}`;
 }
 async function stopBooked(booked) {
@@ -28067,7 +28174,7 @@ var executors = [
 ];
 var index_default = definePlugin({
   id: "agent-acp",
-  apiVersion: 20,
+  apiVersion: 21,
   executors,
   activate(ctx) {
     ctx.log.info("generic ACP executor ready");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-acp",
-  "version": "0.2.3210",
+  "version": "0.2.3214",
   "description": "Generic ACP executor: user-supplied CLI over Agent Client Protocol stdio.",
   "keywords": [
     "ycodium",
@@ -21,9 +21,9 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "ycodium-acp-executor": "0.2.3210",
-    "ycodium-executor-testing": "0.0.0",
-    "@ycodium-ai/plugin-api": "0.2.3210"
+    "@ycodium-ai/plugin-api": "0.2.3214",
+    "ycodium-acp-executor": "0.2.3214",
+    "ycodium-executor-testing": "0.0.0"
   },
   "ycodium": {
     "plugin": "./dist/index.js",