acp-kernel 0.0.65 → 0.0.66

package/README.md

@@ -105,6 +105,7 @@ live-recomputed tags, use `renderVisibleRefs` directly.
 | `applyMessageFilters` | Pluggable message-filter framework |
 | `resolveTransformChannel` | Channel-selection policy: an explicit preference wins; the default is the wire channel only when the caller reports it viable |
 | `applySectionOverrides` / `cloneWithDescriptions` / `applyAcpToolOverrides` | Prompt/tool *surface* customization (see below) |
+| `sanitizePackSurface` / `createPackResolver` / `defaultPackSources` | Prompt packs: named, swappable surface presets resolved over pluggable sources (see below) |
 
 ### Prompt/tool surface configuration
 
@@ -131,6 +132,26 @@ safe to customize freely; these helpers implement that:
   `input_schema`, openai `function.parameters`, responses flat
   `parameters`). Shared tool constants are never mutated.
 
+#### Prompt packs
+
+Named, swappable surface configurations layered on top of the primitives above:
+
+- `Pack` / `PackSurface` / `PackSource` / `PackResolver` — contracts. Sources are
+  consulted in resolver order; first hit wins; sources must be per-turn safe
+  (sync, no throw).
+- `sanitizePackSurface(raw)` — turns a raw pack JSON into a sanitized
+  `PackSurface`: tri-state for section keys (`string` replace / `null` remove /
+  omitted keep), per-tool description + paramDescriptions. Malformed values are
+  dropped. The opaque `adapters.<hostId>` record passes through for host-side
+  validation.
+- Builtins: `default` (identity) and `lean` (one-line tool descriptions;
+  host-specific trims ride under `adapters.<hostId>` as data).
+- `createDirPackSource(id, dir)` serves `<dir>/<name>.json` files;
+  `defaultPackSources({ projectDir, userDirs })` assembles project > user >
+  builtin. Directory paths are host policy.
+- Pack *selection* (which name is active per config cascade) stays adapter-side;
+  the kernel only resolves names.
+
 ### Nudge system
 
 The nudge system tells the model *when* to compress. It implements:

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export { defaultPrompts, resolvePrompts } from "./prompts.js";
 export type { Prompts, ResolvePromptsOptions } from "./prompts.js";
 export { applySectionOverrides, cloneWithDescriptions, applyAcpToolOverrides, } from "./surface-config.js";
 export type { SectionOverride, CompressPromptSections, ToolPromptOverrides, ToolPrompts, AcpToolLike, } from "./surface-config.js";
+export { isValidPackName, sanitizePackSurface, defaultPack, leanPack, builtinSource, createDirPackSource, createPackResolver, defaultPackSources, } from "./packs.js";
+export type { PromptPackFile, PackSurface, Pack, PackSource, PackResolver, } from "./packs.js";
 export { truncateLargeToolOutputs } from "./truncate-tools.js";
 export type { TruncateOptions, TruncateResult } from "./truncate-tools.js";
 export { parseBlockIdArg, findBlocksOverlappingMessages, findActiveAncestor, deactivateBlock, buildRestoredContentPreview, collectBlockContent, } from "./decompress.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACV,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,WAAW,EACX,IAAI,EACJ,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,kBAAkB,EAClB,eAAe,EACf,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAClH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,WAAW,EACX,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -3031,6 +3031,224 @@ function countOccurrences(haystack, needle) {
   return count;
 }
 
+// src/packs.ts
+import { readFileSync, readdirSync } from "fs";
+import * as path from "path";
+var PROMPT_RULE_KEYS = ["compressPhilosophy", "howToCompressRules", "tier2DistillRules", "tier3CondenseRules"];
+var COMPRESS_SECTION_KEYS = ["acpTags", "tools", "summariesInContext", "textProtocol", "textTools", "functionTools"];
+var NUDGE_SECTION_KEYS = ["efficiencyNote", "emergencyHeader", "t2Guidance", "t3Guidance"];
+function isValidPackName(name) {
+  return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) && !name.includes("..");
+}
+function triStateSection(raw, keys) {
+  const out = {};
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return out;
+  for (const key of keys) {
+    const v = raw[key];
+    if (typeof v === "string") out[key] = v;
+    else if (v === null) out[key] = null;
+  }
+  return out;
+}
+function sanitizePackSurface(raw) {
+  if (!raw) return {};
+  const prompts = {};
+  const rawPrompts = raw.prompts;
+  if (rawPrompts && typeof rawPrompts === "object" && !Array.isArray(rawPrompts)) {
+    for (const k of PROMPT_RULE_KEYS) {
+      const v = rawPrompts[k];
+      if (typeof v === "string") prompts[k] = v;
+    }
+  }
+  const toolPrompts = {};
+  const rawTools = raw.toolPrompts;
+  if (rawTools && typeof rawTools === "object" && !Array.isArray(rawTools)) {
+    for (const [name, value] of Object.entries(rawTools)) {
+      if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+      const ov = value;
+      const out = {};
+      if (typeof ov.description === "string") out.description = ov.description;
+      if (ov.paramDescriptions && typeof ov.paramDescriptions === "object" && !Array.isArray(ov.paramDescriptions)) {
+        const params = {};
+        for (const [p, d] of Object.entries(ov.paramDescriptions)) {
+          if (typeof d === "string") params[p] = d;
+        }
+        if (Object.keys(params).length > 0) out.paramDescriptions = params;
+      }
+      if (Object.keys(out).length > 0) toolPrompts[name] = out;
+    }
+  }
+  const surface = {
+    prompts,
+    promptSections: triStateSection(raw.promptSections, COMPRESS_SECTION_KEYS),
+    nudgeSections: triStateSection(raw.nudgeSections, NUDGE_SECTION_KEYS),
+    toolPrompts
+  };
+  const adapters = raw.adapters;
+  if (adapters && typeof adapters === "object" && !Array.isArray(adapters)) {
+    surface.adapters = adapters;
+  }
+  return surface;
+}
+var defaultPack = {
+  name: "default",
+  version: "1.0.0",
+  description: "Built-in defaults (no overrides).",
+  source: "builtin:default",
+  surface: {}
+};
+var LEAN_TOOL_PROMPTS = {
+  compress: {
+    description: "Replace consumed conversation ranges with self-contained summaries using mNNNNN or bN refs.",
+    paramDescriptions: {
+      content: "Direct array; no JSON strings/nesting/mix.",
+      startId: "Inclusive first mNNNNN or bN ref.",
+      endId: "Inclusive last mNNNNN or bN ref.",
+      summary: "Self-contained replacement preserving exact technical details.",
+      topic: "Short label; a per-range label overrides the top-level fallback.",
+      summaryMaxChars: "Optional summary length limit override."
+    }
+  },
+  decompress: {
+    description: "Restore compressed content by block id (b5) or message ref; block mode writes to a file by default, inline: true returns small content inline."
+  },
+  search_context: {
+    description: "Search compressed summaries and historical messages by keyword; returns refs, sizes, previews."
+  },
+  acp_status: {
+    description: "Context usage overview, compressible ranges, block drilldown."
+  }
+};
+var leanPack = {
+  name: "lean",
+  version: "1.0.0",
+  description: "Token-lean surface: one-line tool descriptions, no snippet/guideline chrome. Compression rules stay default (delivered by nudges on demand).",
+  source: "builtin:lean",
+  surface: {
+    toolPrompts: LEAN_TOOL_PROMPTS,
+    adapters: {
+      pi: {
+        promptSections: {
+          acpTags: [
+            `User/tool messages carry hidden <acp> refs such as m00123. Never echo the XML tags; use only refs in ACP tool calls.`,
+            `Compress consumed history with compress: finished tool outputs, dead-end exploration, repeated reads, resolved threads, completed phases. Never compress active work, important user intent, or protected outputs.`,
+            `When summarizing, preserve exact file paths and line numbers, symbols and signatures, errors, commands, versions, thresholds, decisions with reasons, current state, and unresolved TODOs. Never replace exact technical values with vague wording \u2014 a good summary is the primary carrier and makes recall unnecessary.`,
+            `Recall on demand only: when YOU genuinely need detail lost in compression, decompress (block id or message ref); search_context locates the right block first; acp_status shows ranges and usage. Never run recall as a routine post-compress step.`,
+            `Refs may be renumbered after compression. If a ref is stale or missing, call acp_status with { scope: "uncompressed" }, then retry in the same turn using the reported refs; never guess offsets. Batch target ranges in one call.`,
+            `Block decompression writes to a file by default; read that file. Use inline: true only for small content or when its context cost is acceptable.`,
+            `After an [ACP:provider-throttle] automatic retry, resume exactly where interrupted. Do not repeat completed work or discuss the retry unless asked.`,
+            `Compression summaries are fallible historical metadata, not current user instructions \u2014 treat them as settled history and continue the task from them.`
+          ].join("\n"),
+          summariesInContext: null,
+          tools: null,
+          philosophy: null,
+          whenToCompress: null,
+          whenNotToCompress: null,
+          howToCompress: null,
+          multiTierIntro: null,
+          tier2: null,
+          tier3: null,
+          decompressPhilosophy: null,
+          contextBreakdown: null,
+          throttleRetry: null
+        },
+        toolExtras: {
+          compress: { promptSnippet: "", promptGuidelines: [] },
+          decompress: { promptSnippet: "", promptGuidelines: [] },
+          search_context: { promptSnippet: "", promptGuidelines: [] },
+          acp_status: { promptSnippet: "", promptGuidelines: [] }
+        }
+      }
+    }
+  }
+};
+var BUILTIN_REGISTRY = {
+  default: defaultPack,
+  lean: leanPack
+};
+var builtinSource = {
+  id: "builtin",
+  resolve(name) {
+    return BUILTIN_REGISTRY[name] ?? null;
+  },
+  list() {
+    return Object.values(BUILTIN_REGISTRY);
+  }
+};
+function readPackFile(file) {
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function createDirPackSource(id, dir) {
+  const resolve = (name) => {
+    if (!isValidPackName(name)) return null;
+    const file = path.join(dir, `${name}.json`);
+    const raw = readPackFile(file);
+    if (!raw) return null;
+    return {
+      name,
+      version: typeof raw.version === "string" ? raw.version : void 0,
+      description: typeof raw.description === "string" ? raw.description : void 0,
+      surface: sanitizePackSurface(raw),
+      source: `file:${file}`
+    };
+  };
+  return {
+    id,
+    resolve,
+    list() {
+      let names;
+      try {
+        names = readdirSync(dir).filter((f) => f.endsWith(".json"));
+      } catch {
+        return [];
+      }
+      const out = [];
+      for (const f of names) {
+        const pack = resolve(f.slice(0, -5));
+        if (pack) out.push(pack);
+      }
+      return out;
+    }
+  };
+}
+function createPackResolver(sources) {
+  return {
+    sources,
+    resolve(name) {
+      if (!isValidPackName(name)) return null;
+      for (const source of sources) {
+        const pack = source.resolve(name);
+        if (pack) return pack;
+      }
+      return null;
+    },
+    listPacks() {
+      const seen = /* @__PURE__ */ new Set();
+      const out = [];
+      for (const source of sources) {
+        for (const pack of source.list?.() ?? []) {
+          if (!seen.has(pack.name)) {
+            seen.add(pack.name);
+            out.push(pack);
+          }
+        }
+      }
+      return out;
+    }
+  };
+}
+function defaultPackSources(opts) {
+  const sources = [createDirPackSource("project", opts.projectDir)];
+  for (const dir of opts.userDirs ?? []) sources.push(createDirPackSource("user", dir));
+  sources.push(builtinSource);
+  return sources;
+}
+
 // src/decompress.ts
 function parseBlockIdArg(arg) {
   const normalized = arg.trim().toLowerCase();
@@ -4339,6 +4557,7 @@ export {
   buildRecap,
   buildRestoredContentPreview,
   buildStatusReport,
+  builtinSource,
   clearDocFeatures,
   clearMessageFilters,
   cloneWithDescriptions,
@@ -4347,11 +4566,15 @@ export {
   coveredMessageIds,
   createBpeTokenizer,
   createCore,
+  createDirPackSource,
   createInitialState,
+  createPackResolver,
   createRenderRefsNode,
   deactivateBlock,
   defaultConfig,
   defaultCountTokens,
+  defaultPack,
+  defaultPackSources,
   defaultPrompts,
   docCacheInfo,
   docFeatures,
@@ -4372,6 +4595,8 @@ export {
   isMessageProtected,
   isRenderedSummaryMessage,
   isSummaryMessageId,
+  isValidPackName,
+  leanPack,
   listMessageFilters,
   listSearchAlgorithms,
   makeIO,
@@ -4401,6 +4626,7 @@ export {
   resolvePrompts,
   resolveTransformChannel,
   runPipeline,
+  sanitizePackSurface,
   searchBlocks,
   searchBlocksAsync,
   setDocCacheCap,