@ycodium-ai/agent-grok 0.2.3210 → 0.2.3214

package/dist/index.js

@@ -26990,6 +26990,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() {
@@ -27098,9 +27184,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,
@@ -27197,7 +27290,11 @@ function createAcpExecutor(options) {
     notifyPromptSettled,
     shared
   });
-  const { cancel, compact, dispose } = createExecutorLifecycle({
+  const {
+    cancel,
+    compact,
+    dispose: disposeLifecycle
+  } = createExecutorLifecycle({
     promptResults,
     failIfDisposed,
     requireStarted,
@@ -27224,6 +27321,7 @@ function createAcpExecutor(options) {
     onInputDead,
     shared
   });
+  let disposeOnce;
   return {
     get generation() {
       return shared.generation;
@@ -27246,7 +27344,16 @@ function createAcpExecutor(options) {
     setNativeMode,
     compact,
     openToolCalls: () => readOpenToolCalls(toolCalls, shared.activeTurnId),
-    dispose
+    dispose: () => {
+      disposeOnce ??= (async () => {
+        try {
+          await disposeLifecycle();
+        } finally {
+          await protocolLogSink?.close();
+        }
+      })();
+      return disposeOnce;
+    }
   };
 }
 
@@ -27657,8 +27764,8 @@ function readDeviceCodeOutput(stdout, onText) {
 }
 
 // src/grokAccount.ts
-import * as NodeFS from "node:fs";
-import * as NodePath2 from "node:path";
+import * as NodeFS2 from "node:fs";
+import * as NodePath3 from "node:path";
 var AUTH_FILE_NAME = "auth.json";
 var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var readString2 = (record3, key) => {
@@ -27678,14 +27785,14 @@ var parseJsonRecord = (raw) => {
 };
 var directoryExists = (homePath) => {
   try {
-    return NodeFS.statSync(homePath).isDirectory();
+    return NodeFS2.statSync(homePath).isDirectory();
   } catch {
     return false;
   }
 };
 var readCredentialFile = (path) => {
   try {
-    return NodeFS.readFileSync(path, "utf8");
+    return NodeFS2.readFileSync(path, "utf8");
   } catch {
     return void 0;
   }
@@ -27726,7 +27833,7 @@ var isExpired = (expiresAt, nowMs) => {
 };
 var readGrokAccount = (homePath) => {
   const exists = directoryExists(homePath);
-  const raw = readCredentialFile(NodePath2.join(homePath, AUTH_FILE_NAME));
+  const raw = readCredentialFile(NodePath3.join(homePath, AUTH_FILE_NAME));
   if (raw === void 0) return signedOutProbe(exists);
   const parsed = parseJsonRecord(raw);
   const identity = parsed === void 0 ? void 0 : findIdentityEntry(parsed);
@@ -27742,8 +27849,8 @@ var readGrokAccount = (homePath) => {
 };
 
 // src/grokQuota.ts
-import * as NodeFS2 from "node:fs";
-import * as NodePath3 from "node:path";
+import * as NodeFS3 from "node:fs";
+import * as NodePath4 from "node:path";
 import {
   parseRetryAfterMs
 } from "@ycodium-ai/plugin-api/usage";
@@ -27790,7 +27897,7 @@ var grokQuotaWindows = (body) => {
 };
 var createGrokUsage = (input2) => {
   const now = input2.now ?? Date.now;
-  const authPath = NodePath3.join(input2.homePath, AUTH_FILE_NAME2);
+  const authPath = NodePath4.join(input2.homePath, AUTH_FILE_NAME2);
   const readQuota = async (request) => {
     const baseUrlKey = GROK_CARD.modelConnectivity.baseUrlEnvKey;
     if (baseUrlKey !== void 0 && (input2.environment[baseUrlKey]?.trim() ?? "") !== "") {
@@ -27798,7 +27905,7 @@ var createGrokUsage = (input2) => {
     }
     let token = null;
     try {
-      token = extractGrokToken(parseJson(NodeFS2.readFileSync(authPath, "utf8")));
+      token = extractGrokToken(parseJson(NodeFS3.readFileSync(authPath, "utf8")));
     } catch {
       token = null;
     }
@@ -28506,8 +28613,8 @@ var grokPromptSettlement = {
 };
 
 // src/grokSkills.ts
-import * as NodeOS from "node:os";
-import * as NodePath4 from "node:path";
+import * as NodeOS2 from "node:os";
+import * as NodePath5 from "node:path";
 var INSPECT_TIMEOUT_MS = 15e3;
 var MAX_INSPECT_OUTPUT_BYTES = 4 * 1024 * 1024;
 var GROK_INSPECT_ARGS = ["inspect", "--json"];
@@ -28566,7 +28673,7 @@ var runGrokInspect = async (input2) => {
 };
 async function probeGrokSkills(input2) {
   try {
-    return await runGrokInspect({ ...input2, cwd: NodeOS.homedir() });
+    return await runGrokInspect({ ...input2, cwd: NodeOS2.homedir() });
   } catch {
     return [];
   }
@@ -28575,14 +28682,14 @@ async function inspectGrokWorkspace(input2) {
   const skills = await runGrokInspect(input2);
   const watched = /* @__PURE__ */ new Set([
     // 项目技能目录的位置没有实测，这两处只是触发重查的提示，不影响答案本身。
-    NodePath4.join(input2.cwd, ".grok", "skills"),
-    NodePath4.join(input2.cwd, ".agents", "skills")
+    NodePath5.join(input2.cwd, ".grok", "skills"),
+    NodePath5.join(input2.cwd, ".agents", "skills")
   ]);
   for (const skill of skills) {
     watched.add(skill.path);
-    const skillDirectory = NodePath4.dirname(skill.path);
+    const skillDirectory = NodePath5.dirname(skill.path);
     watched.add(skillDirectory);
-    watched.add(NodePath4.dirname(skillDirectory));
+    watched.add(NodePath5.dirname(skillDirectory));
   }
   return { skills, watchPaths: [...watched] };
 }
@@ -28699,20 +28806,20 @@ async function probeGrokVersion(input2) {
 
 // src/grokHome.ts
 import * as NodeCrypto2 from "node:crypto";
-import * as NodeOS2 from "node:os";
-import * as NodePath5 from "node:path";
+import * as NodeOS3 from "node:os";
+import * as NodePath6 from "node:path";
 import { mergeLaunchEnv } from "@ycodium-ai/plugin-api/executor";
 function expandHomePath(value) {
-  if (value === "~") return NodeOS2.homedir();
+  if (value === "~") return NodeOS3.homedir();
   if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath5.join(NodeOS2.homedir(), value.slice(2));
+    return NodePath6.join(NodeOS3.homedir(), value.slice(2));
   }
   return value;
 }
 function resolveGrokHomePath(value) {
   const trimmed3 = value.trim();
-  if (trimmed3.length === 0) return NodePath5.join(NodeOS2.homedir(), ".grok");
-  return NodePath5.resolve(expandHomePath(trimmed3));
+  if (trimmed3.length === 0) return NodePath6.join(NodeOS3.homedir(), ".grok");
+  return NodePath6.resolve(expandHomePath(trimmed3));
 }
 function probeGrokAccount(accountPath) {
   const resolved = resolveGrokHomePath(accountPath);
@@ -28731,13 +28838,13 @@ function grokContinuationKey(recipe) {
 function resolveAccountHomePath(recipe, configuredHome) {
   const fromEnvironment = recipe.environment["GROK_HOME"]?.trim();
   if (fromEnvironment !== void 0 && fromEnvironment.length > 0) {
-    return NodePath5.resolve(expandHomePath(fromEnvironment));
+    return NodePath6.resolve(expandHomePath(fromEnvironment));
   }
   return resolveGrokHomePath(configuredHome);
 }
 function absentPath() {
-  return NodePath5.join(
-    NodeOS2.tmpdir(),
+  return NodePath6.join(
+    NodeOS3.tmpdir(),
     `ycodium-grok-no-auth-${NodeCrypto2.randomUUID()}`,
     "auth.json"
   );
@@ -29248,7 +29355,7 @@ var executors = [
 ];
 var index_default = definePlugin({
   id: "agent-grok",
-  apiVersion: 20,
+  apiVersion: 21,
   executors,
   activate(ctx) {
     ctx.log.info("grok executor ready");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-grok",
-  "version": "0.2.3210",
+  "version": "0.2.3214",
   "description": "Grok executor: grok 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-ai/plugin-api": "0.2.3210",
-    "ycodium-executor-testing": "0.0.0",
-    "ycodium-acp-executor": "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",