acp-kernel 0.0.65 → 0.0.66-pr.262.117

package/dist/packs.d.ts

@@ -0,0 +1,74 @@
+import type { Prompts } from "./prompts.js";
+import type { CompressPromptSections, ToolPrompts } from "./surface-config.js";
+import type { NudgePromptSections } from "./nudge-text.js";
+/** Raw on-disk pack JSON (user-authored file or installer payload). Every
+ * field optional; sanitized into a {@link PackSurface} before use. */
+export interface PromptPackFile {
+    name?: string;
+    version?: string;
+    description?: string;
+    prompts?: unknown;
+    promptSections?: unknown;
+    nudgeSections?: unknown;
+    toolPrompts?: unknown;
+    /** Opaque per-host extras, keyed by host id (e.g. `pi`). Hosts sanitize
+     * their own sub-object; the kernel only checks it is a plain object. */
+    adapters?: unknown;
+}
+/** Sanitized surface bundle a pack contributes. */
+export interface PackSurface {
+    prompts?: Partial<Prompts>;
+    promptSections?: CompressPromptSections;
+    nudgeSections?: NudgePromptSections;
+    toolPrompts?: ToolPrompts;
+    adapters?: Record<string, unknown>;
+}
+/** A resolved prompt pack: name + sanitized surface, tagged with provenance
+ * (`builtin:lean`, `file:/home/u/.config/x/packs/lean.json`, …). */
+export interface Pack {
+    name: string;
+    version?: string;
+    description?: string;
+    surface: PackSurface;
+    source: string;
+}
+/** A pluggable pack origin. Sources are consulted in resolver order; the
+ * first non-null wins. Implementations must be safe to call per turn (sync,
+ * no throw). */
+export interface PackSource {
+    readonly id: string;
+    resolve(name: string): Pack | null;
+    list?(): Pack[];
+}
+/** Ordered pack resolution over pluggable sources. */
+export interface PackResolver {
+    readonly sources: readonly PackSource[];
+    resolve(name: string): Pack | null;
+    listPacks(): Pack[];
+}
+export declare function isValidPackName(name: string): boolean;
+/** Sanitize a raw pack file body into a kernel {@link PackSurface}. Malformed
+ * values are dropped — a bad override never clobbers a good default. The
+ * `adapters` record is passed through opaquely for host-side validation. */
+export declare function sanitizePackSurface(raw: PromptPackFile | null | undefined): PackSurface;
+/** The identity pack: no overrides, kernel defaults everywhere. */
+export declare const defaultPack: Pack;
+/** Token-lean surface: one-line tool descriptions, no snippets or guidelines.
+ * Host-specific trims (e.g. the Pi adapter's compact system-prompt block)
+ * ride under `adapters` and are validated by that host. Compression rules
+ * stay default — delivered by nudges on demand. */
+export declare const leanPack: Pack;
+export declare const builtinSource: PackSource;
+/** A pack directory source: `<dir>/<name>.json` files. Serves project-local,
+ * user-global, and any future installer-managed directory identically. */
+export declare function createDirPackSource(id: string, dir: string): PackSource;
+/** Ordered resolution over the given sources; the first non-null wins. */
+export declare function createPackResolver(sources: readonly PackSource[]): PackResolver;
+/** Default source chain: project pack dir, then any user pack dirs, then the
+ * builtin registry. Directory paths are host policy — the kernel only
+ * assembles the chain. */
+export declare function defaultPackSources(opts: {
+    projectDir: string;
+    userDirs?: readonly string[];
+}): PackSource[];
+//# sourceMappingURL=packs.d.ts.map

package/dist/packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../src/packs.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;sEACsE;AACtE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;oEACoE;AACpE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;gBAEgB;AAChB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,SAAS,IAAI,IAAI,EAAE,CAAC;CACrB;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAaD;;4EAE4E;AAC5E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAuCvF;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,IAMzB,CAAC;AA0BF;;;mDAGmD;AACnD,eAAO,MAAM,QAAQ,EAAE,IA2CtB,CAAC;AASF,eAAO,MAAM,aAAa,EAAE,UAQ3B,CAAC;AAWF;0EAC0E;AAC1E,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAoCvE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,YAAY,CAyB/E;AAED;;0BAE0B;AAC1B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,UAAU,EAAE,CAK3G"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "acp-kernel",
-    "version": "0.0.65",
+    "version": "0.0.66-pr.262.117",
     "description": "Framework-agnostic context-compression engine (model-driven, 3-tier LSM). Pure core: no host dependency.",
     "license": "MIT",
     "author": "ranxianglei",