@aexol/spectral 0.8.2 → 0.8.6

package/dist/mcp/utils.js

@@ -1,25 +1,25 @@
 import { homedir, platform } from "node:os";
 import { join } from "node:path";
-async function execOpen(pi, target, browser) {
+async function execOpen(ext, target, browser) {
     const os = platform();
     if (os === "darwin") {
-        return browser ? pi.exec("open", ["-a", browser, target]) : pi.exec("open", [target]);
+        return browser ? ext.exec("open", ["-a", browser, target]) : ext.exec("open", [target]);
     }
     if (os === "win32") {
         return browser
-            ? pi.exec("cmd", ["/c", "start", "", browser, target])
-            : pi.exec("cmd", ["/c", "start", "", target]);
+            ? ext.exec("cmd", ["/c", "start", "", browser, target])
+            : ext.exec("cmd", ["/c", "start", "", target]);
     }
-    return browser ? pi.exec(browser, [target]) : pi.exec("xdg-open", [target]);
+    return browser ? ext.exec(browser, [target]) : ext.exec("xdg-open", [target]);
 }
-export async function openUrl(pi, url, browser) {
-    const result = await execOpen(pi, url, browser);
+export async function openUrl(ext, url, browser) {
+    const result = await execOpen(ext, url, browser);
     if (result.code !== 0) {
         throw new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);
     }
 }
-export async function openPath(pi, targetPath) {
-    const result = await execOpen(pi, targetPath);
+export async function openPath(ext, targetPath) {
+    const result = await execOpen(ext, targetPath);
     if (result.code !== 0) {
         throw new Error(result.stderr || `Failed to open path (exit code ${result.code})`);
     }
@@ -96,7 +96,7 @@ export function extractToolUiStreamMode(toolMeta) {
     const uiMeta = toolMeta?.ui;
     if (!uiMeta || typeof uiMeta !== "object")
         return undefined;
-    const streamMode = uiMeta["pi-mcp-adapter.streamMode"];
+    const streamMode = uiMeta["spectral-mcp-adapter.streamMode"];
     if (streamMode === "eager" || streamMode === "stream-first") {
         return streamMode;
     }

package/dist/mcp/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/mcp/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../../src/mcp/vitest.config.ts"],"names":[],"mappings":";AAEA,wBAWG"}

package/dist/mcp-client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Minimal hand-rolled JSON-RPC 2.0 client for the Aexol MCP backend.
+ *
+ * Why hand-rolled, not @modelcontextprotocol/sdk?
+ *  - The Aexol backend speaks a non-standard MCP dialect (custom content types,
+ *    protocol version 0.1.0 negotiation, no SSE). The official SDK adds a lot
+ *    of negotiation overhead we don't need and would actively break against
+ *    this server.
+ *  - All we want is: POST a JSON-RPC envelope with a Bearer token, get a
+ *    JSON-RPC reply, surface errors. fetch() is built into Node 20+.
+ */
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema: unknown;
+}
+export interface McpContentItem {
+    type: string;
+    json?: unknown;
+    text?: string;
+    [k: string]: unknown;
+}
+export interface McpToolCallResult {
+    content: McpContentItem[];
+    isError?: boolean;
+}
+/**
+ * Errors thrown by AexolMcpClient carry an optional HTTP `status` so callers
+ * can produce friendlier messages (e.g. 401 → "invalid token").
+ */
+export declare class AexolMcpError extends Error {
+    readonly status?: number;
+    readonly code?: number;
+    constructor(message: string, opts?: {
+        status?: number;
+        code?: number;
+    });
+}
+export declare class AexolMcpClient {
+    private readonly apiUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    constructor(apiUrl: string, apiKey: string, timeoutMs?: number);
+    /** Low-level: send a JSON-RPC call and return its `result` field. */
+    call<T>(method: string, params?: unknown): Promise<T>;
+    /**
+     * Fetch the tool catalog. The Aexol backend returns `{ tools: [...] }`
+     * per JSON-RPC convention, but we accept the raw array shape too in case
+     * the server format drifts.
+     */
+    listTools(): Promise<McpTool[]>;
+    /**
+     * Invoke a single tool. Returns the raw `{ content, isError? }` envelope —
+     * the caller (the spectral extension) decides how to surface it back to the model.
+     */
+    callTool(name: string, args: unknown): Promise<McpToolCallResult>;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgBD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;CAM3E;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAe;IAG7C,qEAAqE;IAC/D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAoE3D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IASrC;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAexE"}

package/dist/mcp-client.js

@@ -101,14 +101,15 @@ export class AexolMcpClient {
     }
     /**
      * Invoke a single tool. Returns the raw `{ content, isError? }` envelope —
-     * the caller (the pi extension) decides how to surface it back to the model.
+     * the caller (the spectral extension) decides how to surface it back to the model.
      */
     async callTool(name, args) {
         const result = await this.call("tools/call", {
             name,
             arguments: args ?? {},
         });
-        if (!result || typeof result !== "object" || !Array.isArray(result.content)) {
+        if (!result || typeof result !== "object" ||
+            !Array.isArray(result.content)) {
             throw new AexolMcpError(`tools/call returned an unexpected payload for "${name}"`);
         }
         return result;

package/dist/memory/branch.d.ts

@@ -0,0 +1,124 @@
+import { type MemoryReflection, type ObservationEntryData, type ObservationRecord, type ReflectionRecord } from "./types.js";
+export type Entry = {
+    type: string;
+    id: string;
+    timestamp?: string;
+    message?: unknown;
+    content?: unknown;
+    customType?: string;
+    summary?: unknown;
+    fromId?: string;
+    data?: unknown;
+    details?: unknown;
+    firstKeptEntryId?: string;
+};
+export declare function isSourceEntry(entry: Entry): boolean;
+export type RecallObservationMatch = {
+    status: "ok";
+    observation: ObservationRecord;
+    observationEntryId: string;
+    sourceEntryIds: string[];
+    sourceEntries: Entry[];
+} | {
+    status: "no_source";
+    observation: ObservationRecord;
+    observationEntryId: string;
+} | {
+    status: "source_unavailable";
+    observation: ObservationRecord;
+    observationEntryId: string;
+    sourceEntryIds: string[];
+    missingSourceEntryIds: string[];
+    nonSourceEntryIds: string[];
+};
+export type RecallObservationSourcesResult = {
+    status: "not_found";
+    observationId: string;
+    matches: [];
+    collision: false;
+} | {
+    status: "found";
+    observationId: string;
+    matches: RecallObservationMatch[];
+    collision: boolean;
+};
+export type RecallMemoryObservation = {
+    status: "ok";
+    observation: ObservationRecord;
+    observationEntryId: string;
+    observationRecordIndex: number;
+    sourceEntryIds: string[];
+    sourceEntries: Entry[];
+} | {
+    status: "no_source";
+    observation: ObservationRecord;
+    observationEntryId: string;
+    observationRecordIndex: number;
+} | {
+    status: "source_unavailable";
+    observation: ObservationRecord;
+    observationEntryId: string;
+    observationRecordIndex: number;
+    sourceEntryIds: string[];
+    sourceEntries: Entry[];
+    missingSourceEntryIds: string[];
+    nonSourceEntryIds: string[];
+};
+export type RecallMemoryReflectionMatch = {
+    reflection: ReflectionRecord;
+    reflectionIndex: number;
+};
+export type RecallUnavailableSupportingObservation = {
+    reflection: ReflectionRecord;
+    reflectionIndex: number;
+    observationId: string;
+};
+export type RecallUnavailableReflectionProvenance = {
+    reflection: ReflectionRecord;
+    reflectionIndex: number;
+    reason: "legacy";
+};
+export type RecallMemorySourcesResult = {
+    status: "not_found";
+    memoryId: string;
+    reflectionMatches: [];
+    directObservationMatches: [];
+    observations: [];
+    sourceEntries: [];
+    unavailableSupportingObservations: [];
+    unavailableReflectionProvenance: [];
+    missingSourceEntryIds: [];
+    nonSourceEntryIds: [];
+    collision: false;
+    partial: false;
+} | {
+    status: "found";
+    memoryId: string;
+    reflectionMatches: RecallMemoryReflectionMatch[];
+    directObservationMatches: RecallMemoryObservation[];
+    observations: RecallMemoryObservation[];
+    sourceEntries: Entry[];
+    unavailableSupportingObservations: RecallUnavailableSupportingObservation[];
+    unavailableReflectionProvenance: RecallUnavailableReflectionProvenance[];
+    missingSourceEntryIds: string[];
+    nonSourceEntryIds: string[];
+    collision: boolean;
+    partial: boolean;
+};
+export declare function findLastCompactionIndex(entries: Entry[]): number;
+export declare function lastObservationCoverEndIdx(entries: Entry[]): number;
+export declare function rawTokensSinceLastBound(entries: Entry[]): number;
+export declare function rawTokensSinceLastCompaction(entries: Entry[]): number;
+export declare function firstRawIdAfter(entries: Entry[], afterIndex: number): string | undefined;
+export declare function gapRawEntries(entries: Entry[], newFirstKeptEntryId: string): Entry[];
+export declare function rawTailEntriesBetween(entries: Entry[], fromId: string, untilId: string): Entry[];
+export declare function recallObservationSources(entries: Entry[], observationId: string): RecallObservationSourcesResult;
+export declare function recallMemorySources(entries: Entry[], memoryId: string): RecallMemorySourcesResult;
+export declare function collectObservationsByCoverage(entries: Entry[], priorFirstKeptEntryId: string | undefined, newFirstKeptEntryId: string): ObservationEntryData[];
+export interface MemoryState {
+    reflections: MemoryReflection[];
+    committedObs: ObservationRecord[];
+    pendingObs: ObservationRecord[];
+}
+export declare function getMemoryState(entries: Entry[]): MemoryState;
+//# sourceMappingURL=branch.d.ts.map

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

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

package/dist/memory/commands/status.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import type { Runtime } from "../runtime.js";
+export declare function registerStatusCommand(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/memory/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F/E"}

package/dist/memory/commands/status.js

@@ -4,8 +4,8 @@ import { observationPoolTokens as estimateObservationPoolTokens } from "../compa
 import { countByRelevance, formatRelevanceHistogram } from "../relevance.js";
 import { estimateStringTokens } from "../tokens.js";
 import { reflectionContent } from "../types.js";
-export function registerStatusCommand(pi, runtime) {
-    pi.registerCommand("om-status", {
+export function registerStatusCommand(ext, runtime) {
+    ext.registerCommand("om-status", {
         description: "Show observational memory status",
         handler: async (_args, ctx) => {
             runtime.ensureConfig(ctx.cwd);

package/dist/memory/commands/view.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import type { Runtime } from "../runtime.js";
+export declare function registerViewCommand(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=view.d.ts.map

package/dist/memory/commands/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAUpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E7E"}

package/dist/memory/commands/view.js

@@ -3,8 +3,8 @@ import { observationPoolTokens as estimateObservationPoolTokens, observationsToM
 import { countByRelevance, formatRelevanceHistogram } from "../relevance.js";
 import { estimateStringTokens } from "../tokens.js";
 import { reflectionContent } from "../types.js";
-export function registerViewCommand(pi, runtime) {
-    pi.registerCommand("om-view", {
+export function registerViewCommand(ext, runtime) {
+    ext.registerCommand("om-view", {
         description: "Print observational memory details (reflections + observations)",
         handler: async (_args, ctx) => {
             runtime.ensureConfig(ctx.cwd);

package/dist/memory/compaction.d.ts

@@ -0,0 +1,113 @@
+import { agentLoop } from "../sdk/agent-core/index.js";
+import { type Model } from "../sdk/ai/index.js";
+import type { MemoryReflection, ObservationRecord } from "./types.js";
+export declare const REFLECTOR_MAX_PASSES = 2;
+export declare const PRUNER_MAX_PASSES = 2;
+export declare function observationPoolTokens(observations: ObservationRecord[]): number;
+interface LlmArgs {
+    model: Model<any>;
+    apiKey: string;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    agentLoop?: typeof agentLoop;
+    onEvent?: (event: import("../sdk/agent-core/index.js").AgentEvent) => void;
+    maxTurns?: number;
+}
+export type ObservationCoverageTag = "uncited" | "cited" | "reinforced";
+export interface CoverageTagCounts {
+    uncited: number;
+    cited: number;
+    reinforced: number;
+}
+export declare function deriveObservationCoverageTags(reflections: MemoryReflection[], observations: ObservationRecord[]): Map<string, ObservationCoverageTag>;
+export declare function coverageTagCounts(reflections: MemoryReflection[], observations: ObservationRecord[]): CoverageTagCounts;
+export declare function renderObservationsForPrunerPrompt(observations: ObservationRecord[], coverageTags: ReadonlyMap<string, ObservationCoverageTag>): string;
+export declare function migrateLegacyReflections(reflections: MemoryReflection[]): MemoryReflection[];
+export declare function normalizeSupportingObservationIds(supportingObservationIds: readonly string[] | undefined, allowedObservationIds: readonly string[]): string[] | undefined;
+export interface ReflectorPassContext {
+    pass: number;
+    maxPasses: number;
+    minSupportingObservationIds: number;
+}
+export type ReflectionProposal = {
+    content: string;
+    supportingObservationIds?: readonly string[];
+};
+export interface ApplyReflectionProposalsResult {
+    reflections: MemoryReflection[];
+    accepted: number;
+    added: number;
+    merged: number;
+    promoted: number;
+    duplicates: number;
+    unsupported: number;
+}
+export interface ReflectorPassStats {
+    pass: number;
+    toolCalls: number;
+    accepted: number;
+    added: number;
+    merged: number;
+    promoted: number;
+    duplicates: number;
+    unsupported: number;
+    failed: boolean;
+}
+export interface ReflectorStats {
+    passes: ReflectorPassStats[];
+    toolCalls: number;
+    accepted: number;
+    added: number;
+    merged: number;
+    promoted: number;
+    duplicates: number;
+    unsupported: number;
+    failedPass?: number;
+}
+export interface ReflectorResult {
+    reflections: MemoryReflection[];
+    stats: ReflectorStats;
+}
+export declare function renderReflectionsForReflectorPrompt(reflections: MemoryReflection[]): string;
+export declare function applyReflectionProposals(reflections: MemoryReflection[], proposals: readonly ReflectionProposal[], allowedObservationIds: readonly string[], passContext: Pick<ReflectorPassContext, "minSupportingObservationIds">): ApplyReflectionProposalsResult;
+export declare function runReflector(args: LlmArgs, reflections: MemoryReflection[], observations: ObservationRecord[], onPassStart?: (pass: number, maxPasses: number) => void): Promise<ReflectorResult>;
+export type PrunerStopReason = "empty" | "under_target" | "fell_back" | "zero_drops" | "max_passes";
+export interface PrunerPassStats {
+    pass: number;
+    poolTokens: number;
+    targetTokens: number;
+    deltaTokens: number;
+    dropped: number;
+    remaining: number;
+    fellBack: boolean;
+}
+export interface PrunerResult {
+    observations: ObservationRecord[];
+    droppedIds: string[];
+    fellBack: boolean;
+    passes: PrunerPassStats[];
+    stopReason: PrunerStopReason;
+}
+export declare function runPruner(args: LlmArgs, reflections: MemoryReflection[], observations: ObservationRecord[], budgetTokens: number, onPassStart?: (pass: number, maxPasses: number) => void): Promise<PrunerResult>;
+/**
+ * Format an observation for Markdown-safe display.
+ * Wraps the ID in backticks so it renders as inline code in Markdown
+ * rather than being misinterpreted as a link reference.
+ */
+export declare function observationToMarkdown(record: ObservationRecord): string;
+/**
+ * Format a reflection for Markdown-safe display.
+ * Wraps the ID in backticks so it renders as inline code in Markdown.
+ */
+export declare function reflectionToMarkdown(reflection: MemoryReflection): string;
+/**
+ * Format observations as a Markdown bullet list for display.
+ */
+export declare function observationsToMarkdownList(observations: ObservationRecord[]): string;
+/**
+ * Format reflections as a Markdown bullet list for display.
+ */
+export declare function reflectionsToMarkdownList(reflections: MemoryReflection[]): string;
+export declare function renderSummary(reflections: MemoryReflection[], observations: ObservationRecord[]): string;
+export {};
+//# sourceMappingURL=compaction.d.ts.map

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

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

package/dist/memory/config.d.ts

@@ -0,0 +1,27 @@
+export interface Config {
+    observationThresholdTokens: number;
+    compactionThresholdTokens: number;
+    reflectionThresholdTokens: number;
+    passive: boolean;
+    debugLog: boolean;
+    compactionModel?: {
+        provider: string;
+        id: string;
+    };
+    observerMaxTurnsPerRun?: number;
+    observerMaxChunkTokens?: number;
+    reflectorMaxTurnsPerPass?: number;
+    prunerMaxTurnsPerPass?: number;
+    /** @deprecated Use reflectorMaxTurnsPerPass and prunerMaxTurnsPerPass. */
+    compactionMaxToolCalls?: number;
+}
+export interface EffectiveTurnLimits {
+    observerMaxTurnsPerRun: number;
+    reflectorMaxTurnsPerPass: number;
+    prunerMaxTurnsPerPass: number;
+}
+export declare const DEFAULTS: Config;
+export declare function resolveTurnLimits(config: Config): EffectiveTurnLimits;
+export declare function readEnvConfig(env?: NodeJS.ProcessEnv): Partial<Config>;
+export declare function loadConfig(cwd: string, env?: NodeJS.ProcessEnv): Config;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,QAAQ,EAAE,MAOtB,CAAC;AAiCF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF;AAaD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUpF"}

package/dist/memory/debug-log.d.ts

@@ -0,0 +1,12 @@
+export declare const DEBUG_LOG_MAX_BYTES: number;
+export declare const DEBUG_LOG_RELATIVE_PATH: string;
+interface DebugLogContext {
+    enabled: boolean;
+    cwd?: string;
+    runId?: string;
+}
+export declare function withDebugLogContext<T>(context: DebugLogContext, fn: () => T): T;
+export declare function isDebugLogEnabled(): boolean;
+export declare function debugLog(event: string, data?: Record<string, unknown>): void;
+export {};
+//# sourceMappingURL=debug-log.d.ts.map

package/dist/memory/debug-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.d.ts","sourceRoot":"","sources":["../../src/memory/debug-log.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,QAAmB,CAAC;AACpD,eAAO,MAAM,uBAAuB,QAA+C,CAAC;AAEpF,UAAU,eAAe;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAG/E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI,CAmBhF"}

package/dist/memory/hooks/compaction-hook.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import type { Runtime } from "../runtime.js";
+export declare function registerCompactionHook(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=compaction-hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAsBtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA6B7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA2VhF"}

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

@@ -20,8 +20,8 @@ function formatReflectorStats(stats) {
 function formatPrunerStats(result) {
     return `pruner dropped ${plural(result.droppedIds.length, "observation")} in ${plural(result.passes.length, "pass", "passes")}, stop: ${result.stopReason}`;
 }
-export function registerCompactionHook(pi, runtime) {
-    pi.on("session_before_compact", async (event, ctx) => {
+export function registerCompactionHook(ext, runtime) {
+    ext.on("session_before_compact", async (event, ctx) => {
         if (runtime.compactHookInFlight) {
             if (ctx.hasUI)
                 ctx.ui.notify("Observational memory: another compaction is already in progress; cancelling duplicate", "warning");
@@ -124,7 +124,7 @@ export function registerCompactionHook(pi, runtime) {
                                     coversUpToId: gapUpToId,
                                     records,
                                 });
-                                pi.appendEntry(OBSERVATION_CUSTOM_TYPE, gapObservationData);
+                                ext.appendEntry(OBSERVATION_CUSTOM_TYPE, gapObservationData);
                                 if (hasUI && ui)
                                     ui.notify(`Observational memory: sync catch-up recorded ${records.length} observation${records.length === 1 ? "" : "s"} (~${observationTokens.toLocaleString()} tokens)`, "info");
                             }
@@ -161,7 +161,7 @@ export function registerCompactionHook(pi, runtime) {
                 });
                 if (deltaObservationData.length === 0) {
                     // No new observations since last compaction. If we have existing memory,
-                    // carry it forward in a no-op compaction so it survives Pi's compaction.
+                    // carry it forward in a no-op compaction so it survives spectral's compaction.
                     // If there is truly nothing (no prior memory either), cancel.
                     if (memoryState.committedObs.length === 0 && memoryState.reflections.length === 0) {
                         debugLog("compaction.no_delta_cancel", {
@@ -296,7 +296,7 @@ export function registerCompactionHook(pi, runtime) {
     function persistProjectObservations(ctx, reflections) {
         const store = getProjectObsStore();
         if (!store)
-            return; // Not available in standalone pi mode.
+            return; // Not available in standalone spectral mode.
         const projectId = store.getProjectByCwd(ctx.cwd);
         if (!projectId)
             return; // No project registered for this cwd.

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

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import type { Runtime } from "../runtime.js";
+export declare function registerCompactionTrigger(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=compaction-trigger.d.ts.map

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

@@ -0,0 +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,CAsFnF"}

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

@@ -1,12 +1,12 @@
 import { rawTokensSinceLastCompaction } from "../branch.js";
 /**
- * Regex matching Pi's internal retryable error detection.
+ * Regex matching spectral's internal retryable error detection.
  * When the last assistant message in agent_end has stopReason "error" matching this pattern,
  * 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;
-export function registerCompactionTrigger(pi, runtime) {
-    pi.on("agent_end", (event, ctx) => {
+export function registerCompactionTrigger(ext, runtime) {
+    ext.on("agent_end", (event, ctx) => {
         runtime.ensureConfig(ctx.cwd);
         if (runtime.config.passive === true)
             return;

package/dist/memory/hooks/observer-trigger.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import type { Runtime } from "../runtime.js";
+export declare function registerObserverTrigger(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=observer-trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyKjF"}

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

@@ -5,8 +5,8 @@ import { observationsToPromptLines, runObserver } from "../observer.js";
 import { serializeSourceAddressedBranchEntries } from "../serialize.js";
 import { estimateEntryTokens, estimateStringTokens } from "../tokens.js";
 import { OBSERVATION_CUSTOM_TYPE, reflectionToPromptLine } from "../types.js";
-export function registerObserverTrigger(pi, runtime) {
-    pi.on("turn_end", (_event, ctx) => {
+export function registerObserverTrigger(ext, runtime) {
+    ext.on("turn_end", (_event, ctx) => {
         process.stderr.write("[obs-mem] turn_end fired\n");
         runtime.ensureConfig(ctx.cwd);
         if (runtime.config.passive === true) {
@@ -125,7 +125,7 @@ export function registerObserverTrigger(pi, runtime) {
                         coversUpToId: effectiveCoversUpToId,
                         tokenCount: 0,
                     };
-                    pi.appendEntry(OBSERVATION_CUSTOM_TYPE, placeholderData);
+                    ext.appendEntry(OBSERVATION_CUSTOM_TYPE, placeholderData);
                     debugLog("observer.empty_placeholder", { coversFromId, coversUpToId: effectiveCoversUpToId });
                     if (hasUI && ui)
                         ui.notify("Observational memory: observer returned no observations; bound advanced to prevent re-processing", "warning");
@@ -145,7 +145,7 @@ export function registerObserverTrigger(pi, runtime) {
                     coversUpToId: effectiveCoversUpToId,
                     records,
                 });
-                pi.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
+                ext.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
                 debugLog("observer.appended", { count: records.length, tokenCount: observationTokens, coversFromId, coversUpToId: effectiveCoversUpToId });
                 if (hasUI && ui)
                     ui.notify(`Observational memory: ${records.length} observation${records.length === 1 ? "" : "s"} recorded (~${observationTokens.toLocaleString()} tokens)`, "info");

package/dist/memory/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function hashId(content: string): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/memory/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/memory/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+export default function observationalMemory(ext: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

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

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