acp-kernel 0.0.21 → 0.0.22

package/dist/nudge-text.d.ts

@@ -1,9 +1,10 @@
 import type { NudgeDecision, CompressibleRange, ProtectedRange } from "./types.js";
+import type { Prompts } from "./prompts.js";
 export type NudgeVoice = "gentle" | "emergency";
 export interface RenderedNudge {
     voice: NudgeVoice;
     text: string;
 }
 export declare function formatRanges(compressible: CompressibleRange[], protectedRanges: ProtectedRange[]): string;
-export declare function renderNudgeText(decision: NudgeDecision): RenderedNudge;
+export declare function renderNudgeText(decision: NudgeDecision, prompts?: Prompts): RenderedNudge;
 //# sourceMappingURL=nudge-text.d.ts.map

package/dist/nudge-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nudge-text.d.ts","sourceRoot":"","sources":["../src/nudge-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAsC,MAAM,YAAY,CAAC;AAGvH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAqCD,wBAAgB,YAAY,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM,CAsEzG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAiEtE"}
+{"version":3,"file":"nudge-text.d.ts","sourceRoot":"","sources":["../src/nudge-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAsC,MAAM,YAAY,CAAC;AAEvH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD,wBAAgB,YAAY,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM,CAsEzG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,OAAwB,GAAG,aAAa,CAiEzG"}

package/dist/prompts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Overridable prompt text consumed by the kernel's nudge renderer and, via the
+ * adapter, the system prompt. Every field here is LOAD-BEARING: these rules
+ * were tuned over months of production use and are quality-critical. Overriding
+ * them can degrade summary quality (loss of paths / signatures / decisions →
+ * broken retrieval), so {@link resolvePrompts} requires `{ acknowledgeRisk: true }`.
+ *
+ * Surface-level text (summary section headers, status-report chrome, tool
+ * descriptions) is intentionally NOT part of this interface — it is owned by
+ * the adapter or a later "prompt-set format" layer and is safe to customize
+ * freely. See DESIGN.md for the load-bearing vs surface classification.
+ */
+export interface Prompts {
+    /** Core compression philosophy. Embedded in the system prompt + every nudge. */
+    compressPhilosophy: string;
+    /** Rules the model follows when writing a tier-1 summary. */
+    howToCompressRules: string;
+    /** Rules for tier-2 distillation of existing summaries. */
+    tier2DistillRules: string;
+    /** Rules for tier-3 ultra-condensation of distilled summaries. */
+    tier3CondenseRules: string;
+}
+/**
+ * The kernel's canonical prompt values (verbatim from compression-rules.ts).
+ * Frozen so a buggy caller cannot mutate the shared singleton and corrupt
+ * every other consumer of {@link defaultPrompts}.
+ */
+export declare const defaultPrompts: Prompts;
+export interface ResolvePromptsOptions {
+    /**
+     * Must be `true` to override any prompt field. Every {@link Prompts} field is
+     * load-bearing; overriding without acknowledging the quality risk is a
+     * programming error and throws.
+     */
+    acknowledgeRisk?: boolean;
+}
+/**
+ * Merge prompt overrides onto the kernel defaults. All fields are load-bearing,
+ * so ANY override requires `{ acknowledgeRisk: true }`.
+ *
+ * Only `string`-valued overrides take effect: an explicit `undefined`/`null` or
+ * a wrong type is silently dropped (never clobbers a good default), so a
+ * malformed partial never degrades the canonical rules. Resolve once at host
+ * startup, then pass the resulting {@link Prompts} to {@link renderNudgeText}
+ * and to the adapter's system-prompt composition so both layers stay consistent.
+ */
+export declare function resolvePrompts(overrides?: Partial<Prompts>, options?: ResolvePromptsOptions): Prompts;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO;IACtB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAKhB,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAC5B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAkBT"}

package/package.json

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