@aexol/spectral 0.9.106 → 0.9.107

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;AAMpC,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;AAsVD,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,7 @@
  *   - Access to observational memory via the recall tool
  */
 import { agentLoop } from "../sdk/agent-core/index.js";
+import { buildIsolatedRequestTimePrunedMessages } from "../memory/tools/compact-context.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 +36,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 +178,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 +218,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 +348,32 @@ 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,
             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,9 @@
+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";
 export declare const COMPACT_CONTEXT_TOOL_NAME = "compact_context";
+/** 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;AAE7C,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAib3D,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

@@ -343,6 +343,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/package.json

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