@lexwdex-org/opencode-dcp 3.4.13 → 3.5.0

package/dist/lib/auto-prune.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-prune.d.ts","sourceRoot":"","sources":["../../lib/auto-prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAA;CACzB;AAUD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBlD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAO9D;AAoBD,qBAAa,UAAU;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,eAAe,EACxC,GAAG,CAAC,EAAE,MAAM,MAAM;IAKtB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAa,GAAG,aAAa;IAoBvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,WAAW,EAAE,GAAG,IAAI;IAUxE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,IAAI;IASpD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,CAAC,QAAQ;IA2BhB,OAAO,CAAC,KAAK;CAYhB"}
+{"version":3,"file":"auto-prune.d.ts","sourceRoot":"","sources":["../../lib/auto-prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAA;CACzB;AAUD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBlD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAO9D;AAwBD,qBAAa,UAAU;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,eAAe,EACxC,GAAG,CAAC,EAAE,MAAM,MAAM;IAKtB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAa,GAAG,aAAa;IAoBvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,WAAW,EAAE,GAAG,IAAI;IAUxE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,IAAI;IASpD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,KAAK;CAYhB"}

package/dist/lib/config.d.ts

@@ -8,8 +8,15 @@ export interface ExperimentalConfig {
 export interface SummarizeConfig {
     failureCooldownMs: number;
 }
+export interface AutoPruneSignals {
+    topicDrift: boolean;
+    volume: boolean;
+    idleGap: boolean;
+}
 export interface AutoPruneConfig {
     enabled: boolean;
+    /** Per-signal switches; only topic changes are enabled by default (LD1). */
+    signals: AutoPruneSignals;
     minMessages: number;
     volumeThreshold: number;
     driftThreshold: number;
@@ -42,6 +49,13 @@ interface ValidationError {
     actual: string;
 }
 export declare function validateConfigTypes(config: Record<string, any>): ValidationError[];
+/**
+ * SR1 migration hint condition: auto prune is on but the user config predates
+ * the per-signal switches. The hint fires on every config load where this
+ * holds (same always-fires, stateless mechanism as the compress.* hints — no
+ * persistent "one-time" flag).
+ */
+export declare function needsSignalsMigrationHint(configData: Record<string, any>): boolean;
 export declare function getConfig(ctx: PluginInput): PluginConfig;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;AAErC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,WAAW,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,SAAS,EAAE,eAAe,CAAA;IAC1B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACnB;AAID,eAAO,MAAM,kBAAkB,EAAE,eAOhC,CAAA;AAED,eAAO,MAAM,iBAAiB,aAqB5B,CAAA;AAKF,eAAO,MAAM,sBAAsB,aA0CjC,CAAA;AAeF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAEjF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAI9E;AAED,UAAU,eAAe;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CAuJlF;AA2SD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAsCxD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,OAAO,EAAE,gBAAgB,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;AAErC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,WAAW,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,SAAS,EAAE,eAAe,CAAA;IAC1B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACnB;AAID,eAAO,MAAM,kBAAkB,EAAE,eAQhC,CAAA;AAED,eAAO,MAAM,iBAAiB,aAyB5B,CAAA;AAKF,eAAO,MAAM,sBAAsB,aA0CjC,CAAA;AAeF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAEjF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAI9E;AAED,UAAU,eAAe;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CA4KlF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CASlF;AA2UD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAsCxD"}

package/dist/lib/hooks.d.ts

@@ -3,7 +3,8 @@ import type { Logger } from "./logger";
 import type { OpenCodeClient } from "./opencode-client";
 import type { PromptStore } from "./prompts/store";
 import type { AutoPruner } from "./auto-prune";
-import type { SummarizeCoordinator } from "./summarize";
+import type { PruneService } from "./prune-service";
+import type { RestFireReason } from "./session-boundary";
 interface CompactionOutput {
     context: string[];
     prompt?: string;
@@ -15,19 +16,37 @@ export declare function createChatMessageHandler(autoPruner: AutoPruner): (input
     sessionID: string;
 }, _output?: unknown) => Promise<void>;
 export interface EventHandlerDeps {
-    client: OpenCodeClient;
-    summarize: SummarizeCoordinator;
+    prune: PruneService;
     autoPruner: AutoPruner;
-    config: AutoPruneConfig;
     logger: Logger;
 }
+/**
+ * Every host event feeds the PruneService first: `session.status` / legacy
+ * `session.idle` observations go to the boundary tracker, which classifies
+ * at-rest boundaries (quiet window + live probe) and drives both the
+ * deferred-prune drain and the at-rest auto-prune listener. This handler only
+ * keeps the heuristic pruner's own lifecycle state in sync.
+ */
 export declare function createEventHandler(deps: EventHandlerDeps): (input: {
     event: {
         type: string;
         properties?: Record<string, any>;
     };
 }) => Promise<void>;
-export declare function createCommandExecuteHandler(client: OpenCodeClient, summarize: SummarizeCoordinator, logger: Logger): (input: {
+export interface AtRestAutoPruneDeps {
+    client: OpenCodeClient;
+    prune: PruneService;
+    autoPruner: AutoPruner;
+    config: AutoPruneConfig;
+    logger: Logger;
+}
+/**
+ * At-rest listener #2: the heuristic auto prune. The `enabled` gate stays at
+ * this mount point — a tool-only configuration (auto prune disabled) never
+ * registers the listener, so it gains no auto-prune behavior.
+ */
+export declare function createAtRestAutoPruneListener(deps: AtRestAutoPruneDeps): (sessionID: string, _reason: RestFireReason) => Promise<void>;
+export declare function createCommandExecuteHandler(client: OpenCodeClient, prune: PruneService, logger: Logger): (input: {
     command: string;
     sessionID: string;
     arguments: string;

package/dist/lib/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,cAAc,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,UAAU,gBAAgB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IACjE,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBvF;AAeD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,IAC7C,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAQD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IAyBvC,OAAO;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,mBA2BrF;AAED,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,oBAAoB,EAC/B,MAAM,EAAE,MAAM,IAGV,OAAO;IACH,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB,EACD,UAAU;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC/B,OAAO,CAAC,IAAI,CAAC,CAgDnB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,UAAU,gBAAgB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IACjE,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBvF;AAeD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,IAC7C,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAQD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IACvC,OAAO;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,mBAoBrF;AAoDD,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,mBAAmB,IACrD,WAAW,MAAM,EAAE,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAK3E;AAED,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,IAGV,OAAO;IACH,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB,EACD,UAAU;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC/B,OAAO,CAAC,IAAI,CAAC,CAuDnB"}

package/dist/lib/prune-service.d.ts

@@ -0,0 +1,104 @@
+import type { Logger } from "./logger";
+import type { OpenCodeClient } from "./opencode-client";
+import { SessionBoundaryTracker } from "./session-boundary";
+import type { SummarizeCoordinator } from "./summarize";
+export { eventSessionID, retrySeconds } from "./session-boundary";
+/**
+ * How a trigger surface wants the service to react when the session is (or may
+ * be) mid-turn:
+ * - `"defer"`: compaction must never interrupt a running turn. Queue the prune
+ *   and execute it at the next confirmed at-rest boundary. Used by the
+ *   model-invokable tool, which by definition executes mid-turn.
+ * - `"proceed"`: fire at turn boundaries anyway; only stand down on positive
+ *   busy evidence. Used by at-rest-driven auto prune and the manual command.
+ */
+export type PruneBusyPolicy = "defer" | "proceed";
+export type PruneOutcome = {
+    status: "succeeded";
+} | {
+    status: "deferred";
+} | {
+    status: "busy";
+} | {
+    status: "no-model";
+} | {
+    status: "cooldown";
+    retryAfterMs: number;
+} | {
+    status: "failed";
+    error: string;
+};
+export interface PruneRequest {
+    sessionID: string;
+    onBusy: PruneBusyPolicy;
+}
+export interface PruneServiceDeps {
+    client: OpenCodeClient;
+    summarize: SummarizeCoordinator;
+    logger: Logger;
+    /** Injectable clock/timers (tests). BOUNDARY_QUIET_MS stays a code constant. */
+    now?: () => number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (t: unknown) => void;
+    /** Injectable probe deadline (tests only; defaults to PROBE_TIMEOUT_MS). */
+    probeTimeoutMs?: number;
+}
+/** Host event names this service derives safety decisions from. */
+export type PruneEventName = "session.idle" | "session.status" | "session.compacted" | "session.deleted" | (string & {});
+/**
+ * The single compression entry point. Every trigger surface (model tool,
+ * heuristic auto prune, manual command) goes through `request`; the service
+ * owns everything a caller must not have to know: session busy state, the
+ * never-interrupt-a-running-turn invariant, deferral to the next confirmed
+ * at-rest boundary, session model resolution, and delegation to the native
+ * summarize coordinator (single-flight + failure cooldown).
+ *
+ * `request` never rejects: every failure mode is a `PruneOutcome`.
+ */
+export declare class PruneService {
+    private readonly deferred;
+    private readonly client;
+    private readonly summarize;
+    private readonly logger;
+    private readonly probeTimeoutMs;
+    /** THE single busy/idle event state machine (absorbed the former
+     * SessionActivityTracker — no second busy cache may exist). */
+    readonly boundary: SessionBoundaryTracker;
+    constructor(deps: PruneServiceDeps);
+    /**
+     * Feed every host event through here. `session.status` and legacy
+     * `session.idle` feed the boundary tracker (quiet window + expiry probe);
+     * the deferral queue drains at the confirmed at-rest classification, and
+     * queued prunes are forgotten once a compaction (or the session itself)
+     * is gone.
+     */
+    observeEvent(type: PruneEventName, properties?: Record<string, any>): void;
+    request(request: PruneRequest): Promise<PruneOutcome>;
+    /** One admission check; `null` means the request may proceed. */
+    private gate;
+    /**
+     * Executes a queued prune at the confirmed at-rest boundary. The tool
+     * already promised its caller this prune would run; losing the busy race
+     * must not silently break that promise, so a busy outcome re-queues for
+     * the next at-rest boundary. Every other outcome is terminal: it is
+     * logged and never retried — new prune demand arrives through new
+     * triggers only. Execution is re-guarded on every attempt, so re-queueing
+     * never violates the never-interrupt invariant.
+     */
+    private drainQueued;
+    /**
+     * Turns an admission decision into a terminal outcome, or `null` when the
+     * request may proceed. Deferral additionally enqueues the session.
+     */
+    private outcomeFor;
+    private admit;
+    /**
+     * THE single live busy probe, reused verbatim by the boundary tracker's
+     * expiry check. Bounded by a finite deadline: a never-returning probe
+     * resolves `null` within the timeout (fail-open). Returns `null` when the
+     * answer is unknown (endpoint or SDK method missing, request failed,
+     * timeout) — callers must fail open in that case.
+     */
+    probeBusy(sessionID: string): Promise<boolean | null>;
+}
+//# sourceMappingURL=prune-service.d.ts.map

package/dist/lib/prune-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-service.d.ts","sourceRoot":"","sources":["../../lib/prune-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,EAEH,sBAAsB,EAGzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,YAAY,GAClB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACjC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAID,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC;mEAC+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;gBAE7B,IAAI,EAAE,gBAAgB;IAqBlC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAwBpE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAmC3D,iEAAiE;IACjE,OAAO,CAAC,IAAI;IAIZ;;;;;;;;OAQG;YACW,WAAW;IAqBzB;;;OAGG;YACW,UAAU;IAaxB,OAAO,CAAC,KAAK;IAUb;;;;;;OAMG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAqB9D"}

package/dist/lib/prune-tool.d.ts

@@ -1,10 +1,8 @@
 import type { Logger } from "./logger";
-import type { OpenCodeClient } from "./opencode-client";
-import type { SummarizeCoordinator } from "./summarize";
+import type { PruneService } from "./prune-service";
 export declare const PRUNE_TOOL_NAME = "dcp_prune";
 export interface PruneToolDeps {
-    client: OpenCodeClient;
-    summarize: SummarizeCoordinator;
+    prune: PruneService;
     logger: Logger;
 }
 export declare function createPruneTool(deps: PruneToolDeps): {

package/dist/lib/prune-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prune-tool.d.ts","sourceRoot":"","sources":["../../lib/prune-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,eAAO,MAAM,eAAe,cAAc,CAAA;AAW1C,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa;;;;EAwBlD"}
+{"version":3,"file":"prune-tool.d.ts","sourceRoot":"","sources":["../../lib/prune-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,eAAO,MAAM,eAAe,cAAc,CAAA;AAU1C,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa;;;;EA6BlD"}

package/dist/lib/session-boundary.d.ts

@@ -0,0 +1,90 @@
+import type { Logger } from "./logger";
+/**
+ * Per-session boundary phase. The compression boundary is NOT the raw
+ * `session.idle` instant: an idle observation opens a quiet window, and only
+ * a window that survives its full duration plus a live status probe is
+ * classified as AT-REST. Busy/retry evidence at any point cancels the window.
+ */
+export type BoundaryPhase = "unknown" | "busy" | "pending-rest" | "at-rest";
+/** Why an at-rest classification fired. `probe-failopen` covers a missing
+ * endpoint, an HTTP error, and a timed-out probe — all fail open. */
+export type RestFireReason = "window-expired" | "probe-failopen";
+export type AtRestListener = (sessionID: string, reason: RestFireReason) => void | Promise<void>;
+/** Internal constants — deliberately NOT config: safety semantics, not user
+ * preference (design ADR-0004). Clock and timers are injectable for tests. */
+export declare const BOUNDARY_QUIET_MS = 2000;
+export declare const PROBE_TIMEOUT_MS = 2000;
+export interface SessionBoundaryDeps {
+    /** THE single busy probe (PruneService.probeBusy), injected — never
+     * imported, so this module never depends on prune-service. */
+    probeBusy: (sessionID: string) => Promise<boolean | null>;
+    logger: Logger;
+    now?: () => number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (t: unknown) => void;
+}
+/**
+ * Classifies turn boundaries as AT-REST or relay-idle. Owns the ONLY
+ * per-session busy/idle event state machine (it absorbed the former
+ * SessionActivityTracker): exactly one entry per session, LRU-bounded.
+ *
+ * State model per session:
+ * - unknown            no evidence (fresh, TTL-decayed, or post-lifecycle); fail-open
+ * - busy               busy/retry evidence cached; TTL-decays to unknown
+ * - pending-rest       quiet window armed (BOUNDARY_QUIET_MS); busy/retry cancels
+ * - at-rest            rest confirmed; onAtRest fired once
+ *
+ * Idle handling: `pending-rest` + idle -> ignore (dual-publish second leg).
+ * `at-rest` + idle -> ignore on status-capable hosts (T1/T2: a real next turn
+ * is preceded by a busy/retry status that exits at-rest first). In degrade
+ * mode (T3: no status observation ever received) a legacy idle from at-rest
+ * RE-ARMS the window — every turn-end idle is a new boundary candidate.
+ */
+export declare class SessionBoundaryTracker {
+    private readonly sessions;
+    private readonly listeners;
+    private readonly probeBusy;
+    private readonly logger;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    constructor(deps: SessionBoundaryDeps);
+    /** Register an at-rest listener; listeners fire in registration order
+     * (1. deferred drain, 2. heuristic auto prune) and are individually
+     * error-isolated: a throw or rejection is warn-logged and never blocks
+     * later listeners nor escapes into the timer callback. */
+    onAtRest(listener: AtRestListener): void;
+    /** Primary input: `session.status` event payload status type. */
+    observeStatus(sessionID: string | undefined, statusType: unknown): void;
+    /** First-class input: legacy `session.idle`. Absorbed by dedup on hosts
+     * that dual-publish; the only boundary signal on status-less hosts (T3). */
+    observeLegacyIdle(sessionID: string | undefined): void;
+    /** Lifecycle: cancel any pending window and forget the session. */
+    observeDeleted(sessionID: string | undefined): void;
+    /** Lifecycle: compaction ended; reset to unknown so the next idle opens a
+     * fresh window. */
+    observeCompacted(sessionID: string | undefined): void;
+    /** Absorbed busy-evidence cache: `busy` decays to `unknown` after the TTL;
+     * the table is LRU-bounded (pending-rest/at-rest entries have no TTL exit
+     * and rely on the cap). */
+    state(sessionID: string): BoundaryPhase;
+    dispose(sessionID: string): void;
+    private observeIdle;
+    private armWindow;
+    private onWindowExpiry;
+    private transition;
+    private cancelWindow;
+    private fireAtRest;
+    private entry;
+    private refresh;
+    private evictIfNeeded;
+}
+/** Ceil a cooldown to whole seconds for user-facing copy. */
+export declare function retrySeconds(retryAfterMs: number): number;
+/**
+ * Resolves the session ID from a host event's properties. Most events carry
+ * `sessionID` directly, but some (e.g. `session.deleted`) only carry
+ * `info: Session`. Returns `undefined` when neither is a non-empty string.
+ */
+export declare function eventSessionID(properties?: Record<string, any>): string | undefined;
+//# sourceMappingURL=session-boundary.d.ts.map

package/dist/lib/session-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-boundary.d.ts","sourceRoot":"","sources":["../../lib/session-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;AAE3E;qEACqE;AACrE,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAEhE,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEhG;8EAC8E;AAC9E,eAAO,MAAM,iBAAiB,OAAQ,CAAA;AACtC,eAAO,MAAM,gBAAgB,OAAQ,CAAA;AAMrC,MAAM,WAAW,mBAAmB;IAChC;kEAC8D;IAC9D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACzD,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAErC,IAAI,EAAE,mBAAmB;IASrC;;;8DAG0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIxC,iEAAiE;IACjE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAkBvE;gFAC4E;IAC5E,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKtD,mEAAmE;IACnE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IASnD;uBACmB;IACnB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgBrD;;+BAE2B;IAC3B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAavC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,SAAS;YAeH,cAAc;IAyC5B,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,aAAa;CAQxB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAMnF"}

package/dist/lib/summarize.d.ts

@@ -9,6 +9,9 @@ export interface SummarizeRequest {
 }
 export type SummarizeResult = {
     status: "succeeded";
+} | {
+    status: "rejected";
+    reason: "busy";
 } | {
     status: "failed";
     error: string;

package/dist/lib/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../lib/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;KAClB,CAAA;CACJ;AAED,MAAM,MAAM,eAAe,GACrB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,UAAU,2BAA2B;IACjC,iBAAiB,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACrB;AAiBD,qBAAa,oBAAoB;IAMzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,2BAA2B;IAKzD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YAsBhD,YAAY;CAqB7B"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../lib/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;KAClB,CAAA;CACJ;AAED,MAAM,MAAM,eAAe,GACrB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,UAAU,2BAA2B;IACjC,iBAAiB,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACrB;AAwCD,qBAAa,oBAAoB;IAMzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,2BAA2B;IAKzD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YAsBhD,YAAY;CA8B7B"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@lexwdex-org/opencode-dcp",
-    "version": "3.4.13",
+    "version": "3.5.0",
     "type": "module",
     "description": "Semantic pruning for OpenCode native context compaction",
     "main": "./dist/index.js",