acp-kernel 0.0.21 → 0.0.23

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/dist/prune.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../src/prune.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,cAAc,sCAAsC,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,KAAK,CACnB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,YAAiB,GACzB,WAAW,EAAE,CAmBf"}
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../src/prune.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,cAAc,sCAAsC,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,KAAK,CACnB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,YAAiB,GACzB,WAAW,EAAE,CAqBf"}

package/dist/reasoning-pairs.d.ts

@@ -0,0 +1,33 @@
+import type { CoreMessage } from "./types.js";
+/**
+ * Adjust compression range boundaries to keep a `reasoning` message together
+ * with the assistant text/tool-call it belongs to.
+ *
+ * Reasoning models (DeepSeek-R1, GLM-4.6 thinking, Qwen-QwQ, Anthropic
+ * thinking) emit a `reasoning_content` / thinking block that strict providers
+ * require to be echoed back alongside the response on every subsequent
+ * request. In acp-kernel that block is a separate `contentType: "reasoning"`
+ * message immediately preceding the assistant text/tool-call of the same turn.
+ * If a compression range covers only one half of the pair, the rebuilt
+ * conversation ships reasoning without its response (or vice versa) and the
+ * provider returns HTTP 400 (DeepSeek: "reasoning_content in the thinking mode
+ * must be passed back to the API").
+ *
+ * This is the reasoning analogue of {@link adjustBoundariesForToolPairs}:
+ * before a range is applied, pull the orphan half INTO the range so the pair
+ * compresses together — zero information loss. Only MESSAGE-boundary ranges
+ * are adjusted (block-boundary ranges are left untouched, like tool pairs).
+ *
+ * Pairing is adjacency-based — there is no shared id (unlike toolCallId). A
+ * `reasoning` message pairs with the assistant text/tool-call immediately
+ * following its reasoning run, and an assistant text/tool-call pairs with the
+ * reasoning run immediately preceding it. This matches the round-trip contract
+ * every adapter relies on when reconstructing reasoning_content.
+ *
+ * @returns Adjusted { startIndex, endIndex } — may be wider than input.
+ */
+export declare function adjustBoundariesForReasoningPairs(startIndex: number, endIndex: number, messages: CoreMessage[]): {
+    startIndex: number;
+    endIndex: number;
+};
+//# sourceMappingURL=reasoning-pairs.d.ts.map

package/dist/reasoning-pairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-pairs.d.ts","sourceRoot":"","sources":["../src/reasoning-pairs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,WAAW,EAAE,GACtB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAwD1C"}

package/package.json

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