@aexol/spectral 0.9.106 → 0.9.108

package/dist/agent/index.d.ts

@@ -24,11 +24,19 @@
  *   - Signal propagation (abort passthrough)
  *   - Access to observational memory via the recall tool
  */
-import { type ExtensionAPI } from "../sdk/coding-agent/index.js";
+import type { AgentTool } from "../sdk/agent-core/index.js";
+import { type ExtensionAPI, type ExtensionContext } from "../sdk/coding-agent/index.js";
 import { type AgentConfig } from "./agents.js";
 import type { ServerEvent } from "../server/wire.ts";
+import type { ExtensionContext as RichExtensionContext } from "../sdk/coding-agent/core/extensions/types.js";
 export declare function stripInjectedPrimaryAgentPrompt(systemPrompt: string | undefined): string | undefined;
 export declare function buildSubagentSystemPrompt(baseSystemPrompt: string | undefined, agent: Pick<AgentConfig, "name" | "systemPrompt">): string;
+/**
+ * Give subagents a point-in-time branch view without exposing the live parent
+ * SessionManager. Each getBranch call returns fresh clones of the snapshot.
+ */
+export declare function createSubagentSessionManagerSnapshot(sessionManager: ExtensionContext["sessionManager"]): Pick<RichExtensionContext["sessionManager"], "getBranch">;
+export declare function resolveSubagentTools(toolNames: string[] | undefined, cwd: string, ext: ExtensionAPI, ctx: ExtensionContext): AgentTool[];
 export default function subagentExtension(ext: ExtensionAPI, opts?: {
     disabledAgents?: string[];
     emitSubagentEvent?: (event: ServerEvent) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH,OAAO,EACN,KAAK,YAAY,EAEjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAsFrD,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpG;AAED,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,GAC/C,MAAM,CAKR;AAkdD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;CAAE,GACpF,IAAI,CAgZN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD,OAAO,KAAK,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAmF7G,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpG;AAED,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,GAC/C,MAAM,CAKR;AAiHD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAK3D;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAqCb;AA0VD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;CAAE,GACpF,IAAI,CAgZN"}

package/dist/agent/index.js

@@ -25,6 +25,8 @@
  *   - Access to observational memory via the recall tool
  */
 import { agentLoop } from "../sdk/agent-core/index.js";
+import { buildIsolatedRequestTimePrunedMessages, createIsolatedDcpNudgePayloadHook, } from "../memory/tools/compact-context.js";
+import { loadConfig } from "../memory/config.js";
 import { StringEnum } from "../sdk/ai/index.js";
 import { mutateSystemPrompt } from "../sdk/coding-agent/core/system-prompt-mutator.js";
 import { Type } from "typebox";
@@ -35,6 +37,9 @@ import { loadAgentSettings } from "../server/handlers/agent-settings.js";
 // ---------------------------------------------------------------------------
 import { createTool, allToolNames } from "../sdk/coding-agent/core/tools/index.js";
 import { wrapToolDefinition } from "../sdk/coding-agent/core/tools/tool-definition-wrapper.js";
+import { READ_PROJECT_OBSERVATIONS_TOOL_NAME } from "../memory/tools/read-project-observations.js";
+import { RECALL_OBSERVATION_TOOL_NAME } from "../memory/tools/recall-observation.js";
+import { compressSubagentToolResult } from "../memory/tool-output-compressor.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -174,11 +179,29 @@ function resolveModelString(modelStr, modelRegistry) {
  * `createTool()`. Extension-registered tools (e.g., recall) are resolved
  * via the ExtensionAPI and wrapped.
  */
-function resolveSubagentTools(toolNames, cwd, ext, ctx) {
-    if (!toolNames || toolNames.length === 0)
+function cloneSessionEntry(entry) {
+    return structuredClone(entry);
+}
+/**
+ * Give subagents a point-in-time branch view without exposing the live parent
+ * SessionManager. Each getBranch call returns fresh clones of the snapshot.
+ */
+export function createSubagentSessionManagerSnapshot(sessionManager) {
+    const snapshot = sessionManager.getBranch().map(cloneSessionEntry);
+    return {
+        getBranch: () => snapshot.map(cloneSessionEntry),
+    };
+}
+export function resolveSubagentTools(toolNames, cwd, ext, ctx) {
+    const requestedNames = new Set(toolNames ?? []);
+    // Project observation search is read-only and can use a minimal, invocation-
+    // local context without exposing the parent session manager.
+    requestedNames.add(READ_PROJECT_OBSERVATIONS_TOOL_NAME);
+    requestedNames.add(RECALL_OBSERVATION_TOOL_NAME);
+    if (requestedNames.size === 0)
         return [];
     const tools = [];
-    for (const name of toolNames) {
+    for (const name of requestedNames) {
         // Built-in tools
         if (allToolNames.has(name)) {
             try {
@@ -196,7 +219,11 @@ function resolveSubagentTools(toolNames, cwd, ext, ctx) {
         const richApi = ext;
         const toolDef = richApi.getToolDefinition(name);
         if (toolDef) {
-            tools.push(wrapToolDefinition(toolDef, () => ctx));
+            const isolatedContext = name === RECALL_OBSERVATION_TOOL_NAME
+                ? { cwd, sessionManager: createSubagentSessionManagerSnapshot(ctx.sessionManager) }
+                : { cwd };
+            const isolatedContextWithNoParent = isolatedContext;
+            tools.push(wrapToolDefinition(toolDef, () => isolatedContextWithNoParent));
         }
     }
     return tools;
@@ -322,12 +349,36 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
         }
     };
     try {
+        // Invocation-local hook state; never reuse the parent extension context/runtime.
         const config = {
             model,
             apiKey: auth.apiKey,
+            onPayload: createIsolatedDcpNudgePayloadHook({
+                config: loadConfig(effectiveCwd),
+                policy: ctx.settingsManager?.getCompactionPolicy?.(),
+            }),
             headers: auth.headers,
             convertToLlm: (msgs) => msgs.filter((m) => m.role === "user" || m.role === "assistant" || m.role === "toolResult"),
             toolExecution: "parallel",
+            transformContext: async (messages) => {
+                // Pure request-time DCP adapter: policy-derived, invocation-local, and
+                // never connected to the parent Runtime or SessionManager.
+                try {
+                    return buildIsolatedRequestTimePrunedMessages(messages);
+                }
+                catch {
+                    return messages;
+                }
+            },
+            afterToolCall: async ({ toolCall, args, result, isError }) => {
+                try {
+                    const content = compressSubagentToolResult(toolCall.name, args, result);
+                    return content ? { content, details: result.details, isError, terminate: result.terminate } : undefined;
+                }
+                catch {
+                    return undefined;
+                }
+            },
         };
         const stream = agentLoop([{ role: "user", content: [{ type: "text", text: task }], timestamp: Date.now() }], {
             systemPrompt: effectivePrompt,

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

@@ -51,5 +51,21 @@ export interface ToolOutputCompressionTelemetry {
 }
 export declare function getToolOutputCompressionTelemetry(runtime: Runtime): ToolOutputCompressionTelemetry;
 export declare function resetToolOutputCompressionTelemetry(runtime: Runtime): void;
+/** Compress a subagent tool result without using the parent Runtime or extension lifecycle. */
+export declare function compressSubagentToolResult(toolName: string, input: unknown, result: {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+}): Array<{
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+}> | undefined;
 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;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"}
+{"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,+FAA+F;AAC/F,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC3F,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAevG;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAqEN"}

package/dist/memory/tool-output-compressor.js

@@ -766,6 +766,30 @@ function compressedContentResult(runtime, event, toolName, original, compressed)
         content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: replacementText }],
     };
 }
+/** Compress a subagent tool result without using the parent Runtime or extension lifecycle. */
+export function compressSubagentToolResult(toolName, input, result) {
+    const safeInput = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+    const text = result.content.filter((part) => part.type === "text" && typeof part.text === "string").map((part) => part.text).join("\n");
+    if (!text || text.startsWith("[tool-output-compressor "))
+        return undefined;
+    const event = { content: result.content, input: safeInput, toolName };
+    let compressed;
+    const config = DEFAULT_COMPRESSOR_CONFIG;
+    if (toolName === "read")
+        compressed = compressReadOutput(event, config);
+    else if (toolName === "bash")
+        compressed = compressBashOutput(event, config);
+    else if (toolName === "ls")
+        compressed = compressLsOutput(event, config);
+    else if (toolName === "grep")
+        compressed = compressGrepOutput(event, config);
+    else if (toolName === "find")
+        compressed = compressFindOutput(event, config);
+    if (!compressed || compressed === text)
+        return undefined;
+    const compressedContent = result.content.map((part) => part.type === "text" ? { type: "text", text: part.text ?? "" } : part.type === "image" && part.data && part.mimeType ? { type: "image", data: part.data, mimeType: part.mimeType } : undefined).filter((part) => part !== undefined && part.type !== "text");
+    return [{ type: "text", text: `${formatCompressionHeader({ toolName, originalChars: text.length, compressedChars: compressed.length, savingsPercent: Math.round((1 - compressed.length / Math.max(1, text.length)) * 10_000) / 100 })}\n${compressed}` }, ...compressedContent];
+}
 export function registerToolOutputCompressor(ext, runtime) {
     ext.on("tool_result", (_event, _ctx) => {
         const config = resolveCompressorConfig(_ctx);

package/dist/memory/tools/compact-context.d.ts

@@ -1,5 +1,19 @@
+import type { AgentMessage } from "../../sdk/agent-core/index.js";
+import { type CompactionPolicy } from "../../sdk/coding-agent/core/compaction/index.js";
 import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
+import { type Config } from "../config.js";
 export declare const COMPACT_CONTEXT_TOOL_NAME = "compact_context";
+/**
+ * Creates an invocation-local provider payload hook for isolated agent loops.
+ * The values are snapshotted at invocation start; no Runtime, SessionManager, or
+ * extension state is retained by the returned hook.
+ */
+export declare function createIsolatedDcpNudgePayloadHook(options?: {
+    config?: Pick<Config, "dcpInRunNudgeIterationThreshold" | "dcpInRunNudgeFrequency">;
+    policy?: CompactionPolicy;
+}): NonNullable<import("../../sdk/ai/index.js").SimpleStreamOptions["onPayload"]>;
+/** Request-time DCP adapter for isolated loops: it borrows only pure policy helpers. */
+export declare function buildIsolatedRequestTimePrunedMessages(currentMessages: AgentMessage[], policy?: CompactionPolicy, keepRecentTokens?: number): AgentMessage[];
 export declare function registerCompactContextTool(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=compact-context.d.ts.map

package/dist/memory/tools/compact-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact-context.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/compact-context.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,iCAAiC,CAAC;AAIvG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AA4qB3D,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkSpF"}
+{"version":3,"file":"compact-context.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/compact-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EASN,KAAK,gBAAgB,EACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,iCAAiC,CAAC;AAKvG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAoO3D;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,GAAE;IAC1D,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,iCAAiC,GAAG,wBAAwB,CAAC,CAAC;IACpF,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACrB,GAAG,WAAW,CAAC,OAAO,uBAAuB,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAiBrF;AA+MD,wFAAwF;AACxF,wBAAgB,sCAAsC,CACrD,eAAe,EAAE,YAAY,EAAE,EAC/B,MAAM,GAAE,gBAA4C,EACpD,gBAAgB,CAAC,EAAE,MAAM,GACvB,YAAY,EAAE,CAchB;AAsQD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkSpF"}

package/dist/memory/tools/compact-context.js

@@ -4,6 +4,7 @@ import { defineTool } from "../../sdk/coding-agent/index.js";
 import { buildSessionContext } from "../../sdk/coding-agent/core/session-manager.js";
 import { rawTokensSinceLastCompaction } from "../branch.js";
 import { debugLog, withDebugLogContext } from "../debug-log.js";
+import { DEFAULTS } from "../config.js";
 export const COMPACT_CONTEXT_TOOL_NAME = "compact_context";
 const DCP_NUDGE_HEADING = "## DCP-lite context hygiene";
 const MAX_COMPACT_CONTEXT_TEXT_CHARS = 240;
@@ -194,6 +195,31 @@ function injectDcpNudgeIntoProviderPayload(payload, nudge) {
         return undefined;
     return injectDcpNudgeIntoAnthropicPayload(payload, nudge) ?? injectDcpNudgeIntoOpenAiPayload(payload, nudge);
 }
+/**
+ * Creates an invocation-local provider payload hook for isolated agent loops.
+ * The values are snapshotted at invocation start; no Runtime, SessionManager, or
+ * extension state is retained by the returned hook.
+ */
+export function createIsolatedDcpNudgePayloadHook(options = {}) {
+    let providerRequestCount = 0;
+    let lastNudgeRequest = 0;
+    const config = options.config ?? DEFAULTS;
+    const policy = options.policy ?? DEFAULT_COMPACTION_POLICY;
+    return (payload) => {
+        providerRequestCount += 1;
+        const frequency = config.dcpInRunNudgeFrequency;
+        const hasSignal = providerRequestCount >= config.dcpInRunNudgeIterationThreshold;
+        const frequencyReady = lastNudgeRequest === 0 || providerRequestCount - lastNudgeRequest >= frequency;
+        if (!hasSignal || !frequencyReady || payloadContainsDcpNudge(payload))
+            return undefined;
+        const nudge = buildDcpNudge(0, undefined, undefined, policy, providerRequestCount);
+        const nextPayload = injectDcpNudgeIntoProviderPayload(payload, nudge);
+        if (nextPayload === undefined)
+            return undefined;
+        lastNudgeRequest = providerRequestCount;
+        return nextPayload;
+    };
+}
 function rawTokensForContext(ctx) {
     const entries = ctx.sessionManager.getBranch();
     return rawTokensSinceLastCompaction(entries);
@@ -343,6 +369,20 @@ function createVirtualCompactionEntry(pathEntries, result) {
 }
 function buildRequestTimePrunedMessages(ctx, request, policy, currentMessages) {
     const pathEntries = getBranchEntries(ctx);
+    return buildRequestTimePrunedMessagesFromEntries(pathEntries, request, policy, currentMessages);
+}
+/** Request-time DCP adapter for isolated loops: it borrows only pure policy helpers. */
+export function buildIsolatedRequestTimePrunedMessages(currentMessages, policy = DEFAULT_COMPACTION_POLICY, keepRecentTokens) {
+    const syntheticEntries = currentMessages.map((message, index) => ({
+        type: "message",
+        id: `isolated-${index}`,
+        parentId: index > 0 ? `isolated-${index - 1}` : null,
+        timestamp: new Date(index).toISOString(),
+        message,
+    }));
+    return buildRequestTimePrunedMessagesFromEntries(syntheticEntries, { source: "auto", mode: "request_time", scope: "older_history", keepRecentTokens, phaseBoundary: false, minRawTokens: 0 }, policy, currentMessages)?.messages ?? currentMessages;
+}
+function buildRequestTimePrunedMessagesFromEntries(pathEntries, request, policy, currentMessages) {
     const settings = getRequestTimeCompactionSettings(request, policy);
     const preparation = prepareCompaction(pathEntries, settings, { phaseBoundary: request.phaseBoundary });
     if (!preparation)

package/dist/sdk/ai/providers/faux.d.ts

@@ -27,6 +27,7 @@ export declare function fauxAssistantMessage(content: string | FauxContentBlock
 }): AssistantMessage;
 export type FauxResponseFactory = (context: Context, options: StreamOptions | undefined, state: {
     callCount: number;
+    lastPayload?: unknown;
 }, model: Model<string>) => AssistantMessage | Promise<AssistantMessage>;
 export type FauxResponseStep = AssistantMessage | FauxResponseFactory;
 export interface RegisterFauxProviderOptions {

package/dist/sdk/ai/providers/faux.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faux.d.ts","sourceRoot":"","sources":["../../../../src/sdk/ai/providers/faux.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"faux.d.ts","sourceRoot":"","sources":["../../../../src/sdk/ai/providers/faux.ts"],"names":[],"mappings":"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"}

package/dist/sdk/ai/providers/faux.js

@@ -317,6 +317,15 @@ export function registerFauxProvider(options = {}) {
         state.callCount++;
         queueMicrotask(async () => {
             try {
+                const payload = {
+                    system: context.systemPrompt,
+                    messages: context.messages,
+                    tools: context.tools,
+                };
+                // Faux is intentionally a low-level provider: exercise the same payload
+                // interception seam as HTTP providers so agent-loop continuations can be
+                // tested without network calls.
+                state.lastPayload = (await streamOptions?.onPayload?.(payload, requestModel)) ?? payload;
                 await streamOptions?.onResponse?.({ status: 200, headers: {} }, requestModel);
                 if (!step) {
                     let message = createErrorMessage(new Error("No more faux responses queued"), api, provider, requestModel.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.106",
+  "version": "0.9.108",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,