@aexol/spectral 0.9.58 → 0.9.59

package/dist/memory/config.js

@@ -3,11 +3,17 @@ import { join } from "node:path";
 import { getAgentDir } from "../sdk/coding-agent/index.js";
 export const DEFAULTS = {
     observationThresholdTokens: 1_000,
-    compactionThresholdTokens: 50_000,
+    compactionThresholdTokens: 40_000,
     reflectionThresholdTokens: 10_000,
     passive: false,
     debugLog: false,
     observerMaxChunkTokens: 30_000,
+    dcpNudgeMinRawTokens: 15_000,
+    dcpNudgeMinContextTokens: 50_000,
+    dcpNudgeContextPercent: 35,
+    dcpNudgeTurnInterval: 5,
+    dcpInRunNudgeIterationThreshold: 15,
+    dcpInRunNudgeFrequency: 5,
 };
 const SETTINGS_KEY = "observational-memory";
 const PASSIVE_ENV = "PI_OBSERVATIONAL_MEMORY_PASSIVE";
@@ -23,10 +29,17 @@ function normalizeTurnLimit(normalized, key) {
         delete normalized[key];
     }
     else {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         normalized[key] = value;
     }
 }
+function normalizePercent(normalized, key) {
+    if (!(key in normalized))
+        return;
+    const value = normalized[key];
+    if (typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 100)
+        return;
+    delete normalized[key];
+}
 const RELEVANCE_VALUES = ["low", "medium", "high", "critical"];
 function normalizeInterAgentConfig(value) {
     if (!value || typeof value !== "object")
@@ -55,6 +68,12 @@ function normalizeSettingsConfig(value) {
     normalizeTurnLimit(normalized, "observerMaxChunkTokens");
     normalizeTurnLimit(normalized, "reflectorMaxTurnsPerPass");
     normalizeTurnLimit(normalized, "prunerMaxTurnsPerPass");
+    normalizeTurnLimit(normalized, "dcpNudgeMinRawTokens");
+    normalizeTurnLimit(normalized, "dcpNudgeMinContextTokens");
+    normalizeTurnLimit(normalized, "dcpNudgeTurnInterval");
+    normalizeTurnLimit(normalized, "dcpInRunNudgeIterationThreshold");
+    normalizeTurnLimit(normalized, "dcpInRunNudgeFrequency");
+    normalizePercent(normalized, "dcpNudgeContextPercent");
     normalizeTurnLimit(normalized, "compactionMaxToolCalls");
     if ("interAgent" in normalized) {
         const normalizedInterAgent = normalizeInterAgentConfig(normalized.interAgent);

package/dist/memory/hooks/compaction-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyFnF"}
+{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAGtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAkB7C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAmGnF"}

package/dist/memory/hooks/compaction-trigger.js

@@ -1,3 +1,4 @@
+import { DEFAULT_COMPACTION_POLICY } from "../../sdk/coding-agent/core/compaction/index.js";
 import { rawTokensSinceLastCompaction } from "../branch.js";
 /**
  * Regex matching spectral's internal retryable error detection.
@@ -5,11 +6,20 @@ import { rawTokensSinceLastCompaction } from "../branch.js";
  * Pi will auto-retry — we must not trigger compaction between attempts.
  */
 const RETRYABLE_ERROR_RE = /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i;
+function getCompactionPolicy(ctx) {
+    return ctx.settingsManager?.getCompactionPolicy?.() ?? DEFAULT_COMPACTION_POLICY;
+}
+function getPostRunCompactionThresholdTokens(runtime, policy) {
+    return Math.max(runtime.config.compactionThresholdTokens, policy.autoOlderHistory.minRawTokens);
+}
 export function registerCompactionTrigger(ext, runtime) {
     ext.on("agent_end", (event, ctx) => {
         runtime.ensureConfig(ctx.cwd);
         if (runtime.config.passive === true)
             return;
+        const policy = getCompactionPolicy(ctx);
+        if (!policy.conversation.enabled || !policy.autoOlderHistory.enabled)
+            return;
         if (runtime.compactInFlight)
             return;
         // Don't trigger compaction if Pi will auto-retry — the agent hasn't truly finished.
@@ -24,7 +34,8 @@ export function registerCompactionTrigger(ext, runtime) {
         }
         const entries = ctx.sessionManager.getBranch();
         const tokens = rawTokensSinceLastCompaction(entries);
-        if (tokens < runtime.config.compactionThresholdTokens)
+        const thresholdTokens = getPostRunCompactionThresholdTokens(runtime, policy);
+        if (tokens < thresholdTokens)
             return;
         // Capture ctx properties synchronously — the setTimeout + async work below
         // may outlive the extension ctx (stale after session replacement/reload).
@@ -53,15 +64,20 @@ export function registerCompactionTrigger(ext, runtime) {
                 }
                 const currentEntries = ctx.sessionManager.getBranch();
                 const currentTokens = rawTokensSinceLastCompaction(currentEntries);
-                if (currentTokens < runtime.config.compactionThresholdTokens) {
+                if (currentTokens < thresholdTokens) {
                     runtime.compactInFlight = false;
                     if (hasUI)
                         ui?.notify("Observational memory: compaction skipped — another compaction already ran during observer wait", "info");
                     return;
                 }
                 ctx.compact({
-                    onComplete: () => {
+                    onComplete: (result) => {
                         runtime.compactInFlight = false;
+                        if (result.skipped) {
+                            if (hasUI)
+                                ui?.notify(`Observational memory: compaction skipped — ${result.message ?? "summary would not shrink context"}`, "warning");
+                            return;
+                        }
                         if (hasUI)
                             ui?.notify("Observational memory: compaction complete", "info");
                     },

package/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAejE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAoB5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgBjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAqB5D"}

package/dist/memory/index.js

@@ -6,6 +6,7 @@ import { registerInterAgentReceiver } from "./hooks/inter-agent-receiver.js";
 import { registerObserverTrigger } from "./hooks/observer-trigger.js";
 import { Runtime } from "./runtime.js";
 import { registerToolOutputCompressor } from "./tool-output-compressor.js";
+import { registerCompactContextTool } from "./tools/compact-context.js";
 import { registerRecallTool } from "./tools/recall-observation.js";
 import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
 import { registerReceiveAgentObservationsTool } from "./tools/receive-agent-observations.js";
@@ -16,6 +17,7 @@ export default function observationalMemory(ext) {
     // Log extension load so we can confirm it's running in serve mode.
     process.stderr.write("[obs-mem] extension loaded\n");
     registerObserverTrigger(ext, runtime);
+    registerCompactContextTool(ext, runtime);
     registerCompactionTrigger(ext, runtime);
     registerCompactionHook(ext, runtime);
     registerToolOutputCompressor(ext, runtime);

package/dist/memory/tool-output-compressor.d.ts

@@ -29,27 +29,9 @@
  *    - Docker/build output: collapse progress lines
  */
 import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+import { type ToolOutputCompressorPolicy } from "../sdk/coding-agent/core/compaction/policy.js";
 import type { Runtime } from "./runtime.js";
-export interface CompressorConfig {
-    /** Enable compression (default: true) */
-    enabled: boolean;
-    /** Maximum characters for any single tool result before truncation */
-    maxResultChars: number;
-    /** Maximum lines for read results before truncation */
-    maxReadLines: number;
-    /** Maximum lines for directory listings */
-    maxLsLines: number;
-    /** Maximum lines for grep/find results before grouping */
-    maxSearchLines: number;
-    /** Enable ANSI escape code stripping */
-    stripAnsi: boolean;
-    /** Enable comment stripping for code files */
-    stripComments: boolean;
-    /** Enable test-runner failure-only filtering */
-    testFailuresOnly: boolean;
-    /** Enable git output compacting */
-    compactGit: boolean;
-}
+export type CompressorConfig = ToolOutputCompressorPolicy;
 export declare const DEFAULT_COMPRESSOR_CONFIG: CompressorConfig;
 export interface CompressionStats {
     originalChars: number;
@@ -57,5 +39,17 @@ export interface CompressionStats {
     savingsPercent: number;
     toolName: string;
 }
+export interface ToolOutputCompressionTelemetry {
+    events: number;
+    originalChars: number;
+    compressedChars: number;
+    byTool: Record<string, {
+        events: number;
+        originalChars: number;
+        compressedChars: number;
+    }>;
+}
+export declare function getToolOutputCompressionTelemetry(runtime: Runtime): ToolOutputCompressionTelemetry;
+export declare function resetToolOutputCompressionTelemetry(runtime: Runtime): void;
 export declare function registerToolOutputCompressor(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=tool-output-compressor.d.ts.map

package/dist/memory/tool-output-compressor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAUjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,WAAW,gBAAgB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAUvC,CAAC;AAghBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CA4HN"}
+{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAWjE,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,EAAE,gBAEvC,CAAC;AAqyBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AA8BD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,8BAA8B,CAElG;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1E;AAkDD,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAqEN"}