opencode-acp 1.15.0-pr.381.116 → 1.16.0-pr.297.127

package/README.md

@@ -41,6 +41,19 @@ This brings two concrete effects:
 
 ---
 
+## Which do I need?
+
+Pick by your client:
+
+| Client | Use |
+|---|---|
+| **pi** | [`billion-context-pi`](https://github.com/ranxianglei/billion-context-pi) (in-process extension) |
+| **opencode** | [`opencode-acp`](https://github.com/ranxianglei/opencode-acp) (in-process extension) |
+| **omp** | [`billion-context`](https://github.com/ranxianglei/billion-context) via `bili omp` (built-in plugin) |
+| **everything else** (no context hook) | [`billion-context`](https://github.com/ranxianglei/billion-context) — `bili <client>` (launcher, preferred) or `/bili/` prefix |
+
+---
+
 ## Proven at scale
 
 Real engineering context, in practice.

package/README.zh-CN.md

@@ -33,6 +33,19 @@ ACP 将上下文管理的所有权限全部交给模型自己，而不依靠外
 
 ---
 
+## 该选哪个?
+
+按客户端选:
+
+| 客户端 | 用这个 |
+|---|---|
+| **pi** | [`billion-context-pi`](https://github.com/ranxianglei/billion-context-pi)(进程内扩展) |
+| **opencode** | [`opencode-acp`](https://github.com/ranxianglei/opencode-acp)(进程内扩展) |
+| **omp** | [`billion-context`](https://github.com/ranxianglei/billion-context),`bili omp`(内置插件) |
+| **其余所有**(没有上下文 hook) | [`billion-context`](https://github.com/ranxianglei/billion-context) —— `bili <client>`(启动器,优先)或 `/bili/` 前缀 |
+
+---
+
 ## 实战验证
 
 真实工程中的上下文情况。

package/dist/index.js

@@ -869,6 +869,7 @@ var VALID_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "autoUpdate",
   "debug",
   "logLevel",
+  "storagePath",
   "showUpdateToasts",
   "allowSubAgents",
   "pruneNotification",
@@ -959,6 +960,9 @@ function validateConfigTypes(config) {
   if (config.debug !== void 0 && typeof config.debug !== "boolean") {
     errors.push({ key: "debug", expected: "boolean", actual: typeof config.debug });
   }
+  if (config.storagePath !== void 0 && typeof config.storagePath !== "string") {
+    errors.push({ key: "storagePath", expected: "string", actual: typeof config.storagePath });
+  }
   if (config.allowSubAgents !== void 0 && typeof config.allowSubAgents !== "boolean") {
     errors.push({ key: "allowSubAgents", expected: "boolean", actual: typeof config.allowSubAgents });
   }
@@ -1995,6 +1999,7 @@ function mergeLayer(config, data) {
     autoUpdate: data.autoUpdate ?? config.autoUpdate,
     debug: data.debug ?? config.debug,
     logLevel: data.logLevel ?? config.logLevel,
+    storagePath: data.storagePath ?? config.storagePath,
     allowSubAgents: data.allowSubAgents ?? data.experimental?.allowSubAgents ?? config.allowSubAgents,
     pruneNotification: data.pruneNotification ?? config.pruneNotification,
     pruneNotificationType: data.pruneNotificationType ?? config.pruneNotificationType,
@@ -2349,7 +2354,7 @@ Each entry needs a topic \u2014 either its own or the top-level fallback.`;
 import * as fs from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { isAbsolute, join as join2 } from "path";
 
 // lib/state/utils.ts
 var isMessageCompacted = (state, msg) => {
@@ -2632,7 +2637,7 @@ function resetOnCompaction(state) {
 }
 
 // lib/state/persistence.ts
-function getStorageDir() {
+function getDefaultStorageDir() {
   return join2(
     process.env.XDG_DATA_HOME || join2(homedir2(), ".local", "share"),
     "opencode",
@@ -2641,14 +2646,33 @@ function getStorageDir() {
     "acp"
   );
 }
-function getSessionFilePath(sessionId) {
-  return join2(getStorageDir(), `${sessionId}.json`);
+function resolveStorageDir(configured, projectDir) {
+  const trimmed = configured?.trim();
+  if (!trimmed) {
+    return getDefaultStorageDir();
+  }
+  if (trimmed === "~") {
+    return homedir2();
+  }
+  if (trimmed.startsWith("~/")) {
+    return join2(homedir2(), trimmed.slice(2));
+  }
+  if (isAbsolute(trimmed)) {
+    return trimmed;
+  }
+  return join2(projectDir, trimmed);
+}
+function getStorageDir(override) {
+  return override || getDefaultStorageDir();
+}
+function getSessionFilePath(sessionId, storageDir) {
+  return join2(getStorageDir(storageDir), `${sessionId}.json`);
 }
-async function writePersistedSessionState(sessionId, state, logger) {
-  const filePath = getSessionFilePath(sessionId);
-  const storageDir = getStorageDir();
-  if (!existsSync2(storageDir)) {
-    await fs.mkdir(storageDir, { recursive: true });
+async function writePersistedSessionState(sessionId, state, logger, storageDir) {
+  const filePath = getSessionFilePath(sessionId, storageDir);
+  const dir = getStorageDir(storageDir);
+  if (!existsSync2(dir)) {
+    await fs.mkdir(dir, { recursive: true });
   }
   const content = JSON.stringify(state, null, 2);
   await fs.writeFile(filePath, content, "utf-8");
@@ -2690,11 +2714,11 @@ async function saveSessionState(sessionState, logger, sessionName) {
     modelProviderID: sessionState.modelProviderID,
     modelID: sessionState.modelID
   };
-  await writePersistedSessionState(sessionState.sessionId, state, logger);
+  await writePersistedSessionState(sessionState.sessionId, state, logger, sessionState.storageDir);
 }
-async function loadSessionState(sessionId, logger) {
+async function loadSessionState(sessionId, logger, storageDir) {
   try {
-    const filePath = getSessionFilePath(sessionId);
+    const filePath = getSessionFilePath(sessionId, storageDir);
     if (!existsSync2(filePath)) {
       return null;
     }
@@ -2770,6 +2794,11 @@ async function loadSessionState(sessionId, logger) {
   }
 }
 
+// lib/state/state.ts
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+import { cwd } from "process";
+
 // lib/message-ids.ts
 var MESSAGE_REF_REGEX = /^m(\d{4,5})$/;
 var BLOCK_REF_REGEX = /^b([1-9]\d*)$/;
@@ -4446,10 +4475,12 @@ async function updatePerTurnState(state, logger, messages) {
 }
 var REGISTRY_SOFT_CAP = 32;
 var SessionStateRegistry = class {
-  constructor(logger) {
+  constructor(logger, projectDir) {
     this.logger = logger;
+    this.projectDir = projectDir;
   }
   logger;
+  projectDir;
   states = /* @__PURE__ */ new Map();
   compressionTiming = {
     startsByCallId: /* @__PURE__ */ new Map(),
@@ -4502,7 +4533,8 @@ var SessionStateRegistry = class {
         sessionId,
         this.logger,
         messages,
-        config
+        config,
+        this.projectDir
       );
     } catch (err) {
       this.logger.error("Failed to initialize session state", {
@@ -4566,6 +4598,7 @@ function createSessionState() {
     modelProviderID: void 0,
     modelID: void 0,
     systemPromptTokens: void 0,
+    storageDir: void 0,
     qualityGateRetryPending: false
   };
 }
@@ -4607,21 +4640,30 @@ function resetSessionState(state) {
   state.modelProviderID = void 0;
   state.modelID = void 0;
   state.systemPromptTokens = void 0;
+  state.storageDir = void 0;
   state.qualityGateRetryPending = false;
 }
-async function ensureSessionInitialized(client, state, sessionId, logger, messages, config) {
+async function ensureSessionInitialized(client, state, sessionId, logger, messages, config, projectDir) {
   if (state.sessionId === sessionId) {
     return;
   }
   resetSessionState(state);
   state.sessionId = sessionId;
+  state.storageDir = config?.storagePath ? resolveStorageDir(config.storagePath, projectDir ?? cwd()) : void 0;
   const isSubAgent = await isSubAgentSession(client, sessionId);
   state.isSubAgent = isSubAgent;
   state.lastCompaction = findLastCompactionTimestamp(messages);
   state.currentTurn = countTurns(state, messages);
   state.nudges.turnNudgeAnchors = collectTurnNudgeAnchors(messages);
-  const persisted = await loadSessionState(sessionId, logger);
+  const persisted = await loadSessionState(sessionId, logger, state.storageDir);
   if (persisted === null) {
+    const defaultPath = join3(getDefaultStorageDir(), `${sessionId}.json`);
+    if (state.storageDir && existsSync3(defaultPath)) {
+      logger.warn(
+        "storagePath is set but no valid state was found there; a state file exists at the default location \u2014 move it manually to keep history",
+        { sessionId, storageDir: state.storageDir, defaultPath }
+      );
+    }
     if (config) {
       const rebuilt = rebuildCompressionState(state, messages, config, logger);
       if (rebuilt > 0) {
@@ -9485,10 +9527,10 @@ function hideFailedCompressCalls(messages) {
 
 // lib/logger.ts
 import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
-import { join as join3 } from "path";
-import { existsSync as existsSync3 } from "fs";
+import { join as join4 } from "path";
+import { existsSync as existsSync4 } from "fs";
 import { homedir as homedir3 } from "os";
-var LOG_VERSION = true ? "1.15.0-pr.381.116" : "dev";
+var LOG_VERSION = true ? "1.16.0-pr.297.127" : "dev";
 var LEVEL_RANK = {
   debug: 10,
   info: 20,
@@ -9508,8 +9550,8 @@ var Logger = class {
   constructor(enabled, level) {
     const resolved = level !== void 0 && LEVEL_RANK[level] !== void 0 ? level : void 0;
     this.level = resolved ?? (enabled ? "debug" : "warn");
-    const configHome = process.env.XDG_CONFIG_HOME || join3(homedir3(), ".config");
-    this.logDir = join3(configHome, "opencode", "logs", "acp");
+    const configHome = process.env.XDG_CONFIG_HOME || join4(homedir3(), ".config");
+    this.logDir = join4(configHome, "opencode", "logs", "acp");
   }
   /** Back-compat view of the old flag: true only at full debug verbosity. */
   get enabled() {
@@ -9519,7 +9561,7 @@ var Logger = class {
     return LEVEL_RANK[level] >= LEVEL_RANK[this.level];
   }
   async ensureLogDir() {
-    if (!existsSync3(this.logDir)) {
+    if (!existsSync4(this.logDir)) {
       await mkdir2(this.logDir, { recursive: true });
     }
   }
@@ -9571,11 +9613,11 @@ var Logger = class {
       const dataStr = this.formatData(data);
       const logLine = `${timestamp} ${level.padEnd(5)} ${component}: ${message}${dataStr ? " | " + dataStr : ""} | v=${LOG_VERSION}
 `;
-      const dailyLogDir = join3(this.logDir, "daily");
-      if (!existsSync3(dailyLogDir)) {
+      const dailyLogDir = join4(this.logDir, "daily");
+      if (!existsSync4(dailyLogDir)) {
         await mkdir2(dailyLogDir, { recursive: true });
       }
-      const logFile = join3(dailyLogDir, `${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.log`);
+      const logFile = join4(dailyLogDir, `${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.log`);
       await writeFile2(logFile, logLine, { flag: "a" });
     } catch (error) {
     }
@@ -9686,18 +9728,18 @@ var Logger = class {
   async saveContext(sessionId, messages) {
     if (this.level !== "debug") return;
     try {
-      const contextDir = join3(this.logDir, "context", sessionId);
-      if (!existsSync3(contextDir)) {
+      const contextDir = join4(this.logDir, "context", sessionId);
+      if (!existsSync4(contextDir)) {
         await mkdir2(contextDir, { recursive: true });
       }
       const minimized = this.minimizeForDebug(messages).filter(
         (msg) => msg.parts && msg.parts.length > 0
       );
       const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-      const contextFile = join3(contextDir, `${timestamp}.json`);
+      const contextFile = join4(contextDir, `${timestamp}.json`);
       await writeFile2(contextFile, JSON.stringify(minimized, null, 2));
-      const versionFile = join3(contextDir, "_version");
-      if (!existsSync3(versionFile)) {
+      const versionFile = join4(contextDir, "_version");
+      if (!existsSync4(versionFile)) {
         await writeFile2(versionFile, LOG_VERSION);
       }
     } catch (error) {
@@ -9706,8 +9748,8 @@ var Logger = class {
 };
 
 // lib/prompts/store.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, statSync as statSync2 } from "fs";
-import { join as join4, dirname as dirname2 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, statSync as statSync2 } from "fs";
+import { join as join5, dirname as dirname2 } from "path";
 import { homedir as homedir4 } from "os";
 
 // lib/prompts/system.ts
@@ -10037,8 +10079,8 @@ function createBundledRuntimePrompts() {
 function findOpencodeDir2(startDir) {
   let current = startDir;
   while (current !== "/") {
-    const candidate = join4(current, ".opencode");
-    if (existsSync4(candidate)) {
+    const candidate = join5(current, ".opencode");
+    if (existsSync5(candidate)) {
       try {
         if (statSync2(candidate).isDirectory()) {
           return candidate;
@@ -10055,13 +10097,13 @@ function findOpencodeDir2(startDir) {
   return null;
 }
 function resolvePromptPaths(workingDirectory) {
-  const configHome = process.env.XDG_CONFIG_HOME || join4(homedir4(), ".config");
-  const globalRoot = join4(configHome, "opencode", "acp-prompts");
-  const defaultsDir = join4(globalRoot, "defaults");
-  const globalOverridesDir = join4(globalRoot, "overrides");
-  const configDirOverridesDir = process.env.OPENCODE_CONFIG_DIR ? join4(process.env.OPENCODE_CONFIG_DIR, "acp-prompts", "overrides") : null;
+  const configHome = process.env.XDG_CONFIG_HOME || join5(homedir4(), ".config");
+  const globalRoot = join5(configHome, "opencode", "acp-prompts");
+  const defaultsDir = join5(globalRoot, "defaults");
+  const globalOverridesDir = join5(globalRoot, "overrides");
+  const configDirOverridesDir = process.env.OPENCODE_CONFIG_DIR ? join5(process.env.OPENCODE_CONFIG_DIR, "acp-prompts", "overrides") : null;
   const opencodeDir = findOpencodeDir2(workingDirectory);
-  const projectOverridesDir = opencodeDir ? join4(opencodeDir, "acp-prompts", "overrides") : null;
+  const projectOverridesDir = opencodeDir ? join5(opencodeDir, "acp-prompts", "overrides") : null;
   return {
     defaultsDir,
     globalOverridesDir,
@@ -10161,7 +10203,7 @@ function buildDefaultsReadmeContent() {
 `;
 }
 function readFileIfExists(filePath) {
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     return null;
   }
   try {
@@ -10232,16 +10274,16 @@ var PromptStore = class {
     const candidates = [];
     if (this.paths.projectOverridesDir) {
       candidates.push({
-        path: join4(this.paths.projectOverridesDir, fileName)
+        path: join5(this.paths.projectOverridesDir, fileName)
       });
     }
     if (this.paths.configDirOverridesDir) {
       candidates.push({
-        path: join4(this.paths.configDirOverridesDir, fileName)
+        path: join5(this.paths.configDirOverridesDir, fileName)
       });
     }
     candidates.push({
-      path: join4(this.paths.globalOverridesDir, fileName)
+      path: join5(this.paths.globalOverridesDir, fileName)
     });
     return candidates;
   }
@@ -10264,7 +10306,7 @@ var PromptStore = class {
       const managedContent = buildDefaultPromptFileContent(
         bundledEditable || BUNDLED_EDITABLE_PROMPTS[definition.runtimeField]
       );
-      const filePath = join4(this.paths.defaultsDir, definition.fileName);
+      const filePath = join5(this.paths.defaultsDir, definition.fileName);
       try {
         const existing = readFileIfExists(filePath);
         if (existing === managedContent) {
@@ -10278,7 +10320,7 @@ var PromptStore = class {
         });
       }
     }
-    const readmePath = join4(this.paths.defaultsDir, DEFAULTS_README_FILE);
+    const readmePath = join5(this.paths.defaultsDir, DEFAULTS_README_FILE);
     const readmeContent = buildDefaultsReadmeContent();
     try {
       const existing = readFileIfExists(readmePath);
@@ -10575,8 +10617,8 @@ ${report}`;
 
 // lib/commands/export.ts
 import * as fs2 from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
-import { dirname as dirname3, isAbsolute, join as join5, resolve } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join6, resolve } from "path";
 var ALL_TIERS = [1, 2, 3];
 var TIER_NAMES = {
   1: "Tier 1 \u2014 Capture",
@@ -10687,9 +10729,9 @@ function parseTiers(raw) {
   }
   return result;
 }
-function resolveDefaultOutputPath(sessionId, cwd) {
+function resolveDefaultOutputPath(sessionId, cwd2) {
   const short = (sessionId || "session").slice(0, 8);
-  return join5(cwd, ".opencode", `acp-export-${short}.md`);
+  return join6(cwd2, ".opencode", `acp-export-${short}.md`);
 }
 function formatTokens2(n) {
   if (!Number.isFinite(n) || n <= 0) return "0";
@@ -10816,15 +10858,15 @@ async function handleExportCommand(ctx, args) {
     await sendExportNotice(client, sessionId, ctx, markdown);
     return;
   }
-  const cwd = ctx.workingDirectory || process.cwd();
-  const targetPath = options.outputPath !== "" ? isAbsolute(options.outputPath) ? options.outputPath : resolve(cwd, options.outputPath) : resolveDefaultOutputPath(sessionId, cwd);
+  const cwd2 = ctx.workingDirectory || process.cwd();
+  const targetPath = options.outputPath !== "" ? isAbsolute2(options.outputPath) ? options.outputPath : resolve(cwd2, options.outputPath) : resolveDefaultOutputPath(sessionId, cwd2);
   try {
     const dir = dirname3(targetPath);
-    if (!existsSync5(dir)) {
+    if (!existsSync6(dir)) {
       await fs2.mkdir(dir, { recursive: true });
     }
     const flag = options.append ? "a" : "w";
-    if (options.append && existsSync5(targetPath)) {
+    if (options.append && existsSync6(targetPath)) {
       await fs2.appendFile(targetPath, `
 
 ---
@@ -11611,7 +11653,7 @@ function createCommandExecuteHandler(client, registry4, logger, config, workingD
       const sub = input.arguments?.trim().toLowerCase();
       if (sub === "stats" || sub === "status" || sub === "") {
         await handleStatsCommand(commandCtx);
-        throw new Error("__DCP_CONTEXT_HANDLED__");
+        return;
       }
       if (sub === "export" || sub.startsWith("export ")) {
         const exportArgs = input.arguments?.trim().slice("export".length).trim() || "";
@@ -11629,7 +11671,6 @@ function createCommandExecuteHandler(client, registry4, logger, config, workingD
         throw new Error("__DCP_CONTEXT_HANDLED__");
       }
       await handleContextCommand(commandCtx);
-      throw new Error("__DCP_CONTEXT_HANDLED__");
     }
   };
 }
@@ -11767,7 +11808,7 @@ function findBiliProxyProviders(provider) {
 
 // lib/update.ts
 import { readFile as readFile2, rm } from "fs/promises";
-import { basename, dirname as dirname4, join as join6 } from "path";
+import { basename, dirname as dirname4, join as join7 } from "path";
 import { fileURLToPath } from "url";
 var PACKAGE_NAME = "opencode-acp";
 function startAutoUpdate(ctx, enabled, logger) {
@@ -11814,7 +11855,7 @@ async function checkAutoUpdate(signal, logger) {
     logger?.info("Auto-update skipped: package dir not found");
     return { updated: false };
   }
-  const pkg = await readPackageJson(join6(packageDir, "package.json"));
+  const pkg = await readPackageJson(join7(packageDir, "package.json"));
   if (!pkg?.name || !pkg.version) {
     logger?.info("Auto-update skipped: package.json unreadable", { packageDir });
     return { updated: false };
@@ -11855,7 +11896,7 @@ async function checkAutoUpdate(signal, logger) {
 async function findPackageDir(name) {
   let dir = dirname4(fileURLToPath(import.meta.url));
   for (; ; ) {
-    const pkg = await readPackageJson(join6(dir, "package.json"));
+    const pkg = await readPackageJson(join7(dir, "package.json"));
     if (pkg?.name === name) return dir;
     const parent = dirname4(dir);
     if (parent === dir) return void 0;
@@ -11867,7 +11908,7 @@ async function updateTarget(packageDir, name) {
   const nodeModulesDir = basename(packageParent).startsWith("@") ? dirname4(packageParent) : packageParent;
   if (basename(nodeModulesDir) !== "node_modules") return void 0;
   const wrapperDir = dirname4(nodeModulesDir);
-  const wrapperPkg = await readPackageJson(join6(wrapperDir, "package.json"));
+  const wrapperPkg = await readPackageJson(join7(wrapperDir, "package.json"));
   const spec = wrapperSpec(wrapperDir, name) ?? wrapperPkg?.dependencies?.[name];
   if (!spec || !isAutoUpdatableSpec(spec)) return void 0;
   return { removeDir: wrapperDir, spec };
@@ -11979,14 +12020,14 @@ var server = (async (ctx) => {
   }
   const logger = new Logger(config.debug, config.debug ? "debug" : config.logLevel);
   logger.info("ACP plugin initialized", {
-    version: true ? "1.15.0-pr.381.116" : "dev",
+    version: true ? "1.16.0-pr.297.127" : "dev",
     workspace: ctx.directory,
     logLevel: logger.level,
     debug: config.debug,
     autoUpdate: config.autoUpdate,
     secureMode: isSecureMode()
   });
-  const registry4 = new SessionStateRegistry(logger);
+  const registry4 = new SessionStateRegistry(logger, ctx.directory);
   const prompts = new PromptStore(logger, ctx.directory, config.experimental.customPrompts);
   const hostPermissions = {
     global: void 0,