acp-kernel 0.0.65-pr.261.116 → 0.0.66-pr.262.117

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,13 +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 { sanitizePackSurface } from "./packs/sanitize.js";
-export { isValidPackName } from "./packs/types.js";
-export type { PromptPackFile, PackSurface, Pack, PackSource } from "./packs/types.js";
-export { defaultPack, leanPack, builtinSource } from "./packs/builtin.js";
-export { createDirPackSource } from "./packs/dir.js";
-export { createPackResolver, defaultPackSources } from "./packs/resolver.js";
-export type { PackResolver, DefaultPackSourcesOptions } from "./packs/resolver.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":"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,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACnF,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3031,94 +3031,65 @@ function countOccurrences(haystack, needle) {
   return count;
 }
 
-// src/packs/sanitize.ts
-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 pickSection(raw, keys) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
-  const out = {};
-  for (const key of keys) {
-    const value = raw[key];
-    if (typeof value === "string" || value === null) out[key] = value;
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
+// 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 pickToolPrompts(raw) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+function triStateSection(raw, keys) {
   const out = {};
-  for (const [tool, value] of Object.entries(raw)) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) continue;
-    const src = value;
-    const entry = {};
-    if (typeof src.description === "string")
-      entry.description = src.description;
-    if (src.paramDescriptions && typeof src.paramDescriptions === "object" && !Array.isArray(src.paramDescriptions)) {
-      const params = {};
-      for (const [name, description] of Object.entries(
-        src.paramDescriptions
-      )) {
-        if (typeof description === "string") params[name] = description;
-      }
-      if (Object.keys(params).length > 0) entry.paramDescriptions = params;
-    }
-    if (Object.keys(entry).length > 0) out[tool] = entry;
+  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 Object.keys(out).length > 0 ? out : void 0;
+  return out;
 }
-function sanitizePackSurface(pack) {
-  if (!pack || typeof pack !== "object" || Array.isArray(pack)) return {};
-  const surface = {};
+function sanitizePackSurface(raw) {
+  if (!raw) return {};
   const prompts = {};
-  const rawPrompts = pack.prompts;
+  const rawPrompts = raw.prompts;
   if (rawPrompts && typeof rawPrompts === "object" && !Array.isArray(rawPrompts)) {
-    for (const key of PROMPT_RULE_KEYS) {
-      const value = rawPrompts[key];
-      if (typeof value === "string")
-        prompts[key] = value;
+    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;
     }
   }
-  if (Object.keys(prompts).length > 0) surface.prompts = prompts;
-  const promptSections = pickSection(
-    pack.promptSections,
-    COMPRESS_SECTION_KEYS
-  );
-  if (promptSections)
-    surface.promptSections = promptSections;
-  const nudgeSections = pickSection(pack.nudgeSections, NUDGE_SECTION_KEYS);
-  if (nudgeSections)
-    surface.nudgeSections = nudgeSections;
-  const toolPrompts = pickToolPrompts(pack.toolPrompts);
-  if (toolPrompts) surface.toolPrompts = toolPrompts;
-  if (pack.adapters && typeof pack.adapters === "object" && !Array.isArray(pack.adapters)) {
-    surface.adapters = { ...pack.adapters };
+  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;
 }
-
-// src/packs/types.ts
-function isValidPackName(name) {
-  return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) && !name.includes("..");
-}
-
-// src/packs/builtin.ts
 var defaultPack = {
   name: "default",
   version: "1.0.0",
@@ -3126,40 +3097,67 @@ var defaultPack = {
   source: "builtin:default",
   surface: {}
 };
-var LEAN_ACP_TAGS = [
-  "ACP TAGS",
-  "",
-  "User/tool messages carry hidden \\x3cacp\\x3e refs such as m00123. Never echo the XML tags; use only refs in ACP tool calls."
-].join("\n");
+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 adapted from kunkun9527/billion-context-pi-lean: compact ACP-tags section plus one-line tool descriptions for the four ACP tools. Compression rules stay default (load-bearing, delivered by the builders and nudges); host-specific lean surfaces ride under adapters.<hostId>.",
+  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: {
-    promptSections: {
-      acpTags: LEAN_ACP_TAGS
-    },
-    toolPrompts: {
-      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."
+    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: [] }
         }
-      },
-      decompress: {
-        description: "Restore compressed content by block id (b5) or message ref; one tier up by default, full:true restores originals, toFile writes to a file instead of context."
-      },
-      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."
       }
     }
   }
@@ -3177,10 +3175,6 @@ var builtinSource = {
     return Object.values(BUILTIN_REGISTRY);
   }
 };
-
-// src/packs/dir.ts
-import { readFileSync, readdirSync } from "fs";
-import * as path from "path";
 function readPackFile(file) {
   try {
     const parsed = JSON.parse(readFileSync(file, "utf8"));
@@ -3190,21 +3184,22 @@ function readPackFile(file) {
   }
 }
 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(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}`
-      };
-    },
+    resolve,
     list() {
       let names;
       try {
@@ -3213,16 +3208,14 @@ function createDirPackSource(id, dir) {
         return [];
       }
       const out = [];
-      for (const file of names) {
-        const pack = this.resolve(file.slice(0, -5));
+      for (const f of names) {
+        const pack = resolve(f.slice(0, -5));
         if (pack) out.push(pack);
       }
       return out;
     }
   };
 }
-
-// src/packs/resolver.ts
 function createPackResolver(sources) {
   return {
     sources,
@@ -3249,13 +3242,9 @@ function createPackResolver(sources) {
     }
   };
 }
-function defaultPackSources(options = {}) {
-  const sources = [];
-  if (options.projectDir)
-    sources.push(createDirPackSource("project", options.projectDir));
-  let i = 0;
-  for (const dir of options.userDirs ?? [])
-    sources.push(createDirPackSource(`user${i++}`, dir));
+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;
 }