@aexol/spectral 0.9.157 → 0.9.159

package/dist/memory/unified-compaction.d.ts

@@ -1,59 +0,0 @@
-/**
- * Unified Compaction — single LLM call replacing both:
- *   1. Core spectral generateSummary() (narrative conversation summary)
- *   2. Sync catch-up observer (observation extraction from gap entries)
- *
- * Uses a text-based delimited output format (compatible with any model
- * without requiring native structured-output support):
- *
- *   ===NARRATIVE===
- *   ## Goal
- *   ...
- *
- *   ===OBSERVATIONS===
- *   [YYYY-MM-DD HH:MM] [relevance] Content line
- *   ...
- */
-import type { AgentMessage, ThinkingLevel } from "../sdk/agent-core/index.js";
-import type { Model } from "../sdk/ai/index.js";
-import type { ObservationRecord } from "./types.js";
-export interface UnifiedCompactionInput {
-    /** Messages to summarize (from core compaction preparation) */
-    messagesToSummarize: AgentMessage[];
-    /** Serialized gap entries as text with source entry labels */
-    gapChunk?: string;
-    /** Source entry IDs from gap entries */
-    gapSourceEntryIds?: string[];
-    /** Model to use */
-    model: Model<any>;
-    /** API key */
-    apiKey: string;
-    /** Request headers */
-    headers?: Record<string, string>;
-    /** Abort signal */
-    signal?: AbortSignal;
-    /** Previous compaction summary for iterative update */
-    previousSummary?: string;
-    /** Custom instructions for summarization focus */
-    customInstructions?: string;
-    /** Thinking level for reasoning models */
-    thinkingLevel?: ThinkingLevel;
-    /** Reserve tokens for prompt + output */
-    reserveTokens: number;
-}
-export interface UnifiedCompactionOutput {
-    /** Markdown narrative summary (for CompactionEntry.summary) */
-    narrativeSummary: string;
-    /** Observations extracted from the conversation */
-    observations: ObservationRecord[];
-    /** Files read */
-    readFiles: string[];
-    /** Files modified */
-    modifiedFiles: string[];
-}
-/**
- * Generate a unified compaction result: narrative summary + observations
- * in a single LLM call. Uses delimited text output for broad model compatibility.
- */
-export declare function generateUnifiedCompaction(input: UnifiedCompactionInput): Promise<UnifiedCompactionOutput>;
-//# sourceMappingURL=unified-compaction.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"unified-compaction.d.ts","sourceRoot":"","sources":["../../src/memory/unified-compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAUhD,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,YAAY,CAAC;AAkO/D,MAAM,WAAW,sBAAsB;IACtC,+DAA+D;IAC/D,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB;IACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACvC,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,sBAAsB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CA0IlC"}

package/dist/memory/unified-compaction.js

@@ -1,332 +0,0 @@
-/**
- * Unified Compaction — single LLM call replacing both:
- *   1. Core spectral generateSummary() (narrative conversation summary)
- *   2. Sync catch-up observer (observation extraction from gap entries)
- *
- * Uses a text-based delimited output format (compatible with any model
- * without requiring native structured-output support):
- *
- *   ===NARRATIVE===
- *   ## Goal
- *   ...
- *
- *   ===OBSERVATIONS===
- *   [YYYY-MM-DD HH:MM] [relevance] Content line
- *   ...
- */
-import { completeSimple } from "../sdk/ai/index.js";
-import { extractFileOpsFromMessage, computeFileLists, createFileOps, formatFileOperations, } from "../sdk/coding-agent/core/compaction/utils.js";
-import { hashId } from "./ids.js";
-import { nowTimestamp, truncateRecordContent } from "./serialize.js";
-import { debugLog } from "./debug-log.js";
-// ============================================================================
-// Section Delimiters
-// ============================================================================
-const NARRATIVE_SECTION = "===NARRATIVE===";
-const OBSERVATIONS_SECTION = "===OBSERVATIONS===";
-// ============================================================================
-// Prompt Templates
-// ============================================================================
-const UNIFIED_SYSTEM_PROMPT = `You are a context compression agent. Your task has TWO complementary outputs that MUST be produced together in a single response.
-
-TASK A — NARRATIVE SUMMARY: Create a structured checkpoint of the conversation progress. This is what another LLM reads to understand where the work stands.
-
-TASK B — FACTUAL MEMORY: Extract timestamped observations (single-line facts with relevance tags). These records are the assistant's ONLY memory of this conversation after the raw messages fall out of context.
-
-Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured result using the EXACT format specified.`;
-function buildUnifiedPrompt(conversationText, previousSummary, customInstructions, currentTime) {
-    let prompt = `<conversation>\n${conversationText}\n</conversation>\n\n`;
-    if (previousSummary) {
-        prompt += `<previous-summary>\n${previousSummary}\n</previous-summary>\n\n`;
-    }
-    prompt += `Current local time: ${currentTime}\n\n`;
-    prompt += `Output your response in TWO sections delimited by the exact markers shown below.
-
-SECTION A — ${NARRATIVE_SECTION}
-
-Produce a structured context checkpoint summary using this EXACT format:
-
-## Goal
-[What is the user trying to accomplish? Can be multiple items. If updating a previous summary, preserve existing goals and add new ones.]
-
-## Constraints & Preferences
-- [Any constraints, preferences, or requirements mentioned by user]
-- [Or "(none)" if none were mentioned]
-[When updating: preserve existing constraints, add new ones.]
-
-## Progress
-### Done
-- [x] [Completed tasks/changes. Preserve previously completed items, add newly completed ones.]
-
-### In Progress
-- [ ] [Current work. Update based on progress.]
-
-### Blocked
-- [Issues preventing progress, if any. Remove blockers that have been resolved.]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-[Preserve all previous decisions, add new ones.]
-
-## Next Steps
-1. [Ordered list of what should happen next. Update based on current state.]
-
-## Critical Context
-- [Any data, examples, or references needed to continue]
-- [Or "(none)" if not applicable]
-
-Keep each section concise. Preserve exact file paths, function names, and error messages.
-${customInstructions ? `\nAdditional focus for the narrative: ${customInstructions}` : ""}
-
-SECTION B — ${OBSERVATIONS_SECTION}
-
-Extract NEW timestamped facts from the conversation. Each observation must be on its own line in this exact format:
-
-[YYYY-MM-DD HH:MM] [relevance] Single-line plain prose fact. No markdown, no bullets.
-
-Do NOT restate facts already captured in the <previous-summary>. Skip routine, low-information events (tool-call acks, status updates).
-
-OBSERVATION CONTENT RULES:
-- Single line of plain prose. No markdown, no bullets, no code fences, no XML/HTML tags, no emojis.
-- Preserve user assertions exactly. When the user STATES something about themselves, their project, or their environment, capture it as an assertion. When the user ASKS something, capture it as a question.
-- Use precise action verbs (completed, resolved, implemented, chose, configured etc.).
-- Mark concrete completions explicitly: "completed: implemented X at path/to/file.ts; user confirmed tests pass."
-- Split compound statements into separate observations (one fact per line).
-- Group repeated similar tool calls into a single observation.
-- Preserve exact file paths, function names, line numbers, error messages (verbatim), package names, identifiers.
-- Use the timestamp from the closest conversation message. Fall back to the current local time if no message timestamp applies.
-
-RELEVANCE LEVELS (pick one per observation):
-- critical: user identity, role, persistent preferences, explicit corrections, concrete completions that future runs MUST NOT redo.
-- high: non-trivial technical decisions, architectural direction, unresolved blockers, key constraints.
-- medium: task-level context that helps within the current work. Default when unsure between medium and high.
-- low: routine tool-call acks, repetitive status updates, trivially re-derivable content. Skip these unless they carry unique detail.
-
-Do NOT default everything to "high" or "critical". Most observations should be "medium". Use "low" only for truly routine items.
-
-Focus areas for observations:
-- User identity, preferences, constraints, corrections.
-- Project goals, architectural decisions, rationale.
-- File paths and line numbers of changes.
-- Error messages (verbatim).
-- Completed work that should not be redone.
-- Named identifiers (package names, function/variable names, ticket IDs, commit SHAs).`;
-    return prompt;
-}
-// ============================================================================
-// Conversation Serialization
-// ============================================================================
-const TOOL_RESULT_MAX_CHARS = 2000;
-const VISION_DESCRIPTION_PREFIX = "[Image description from ";
-function stripVisionBlocks(text) {
-    if (!text.includes(VISION_DESCRIPTION_PREFIX))
-        return text;
-    const lines = text.split("\n");
-    const kept = [];
-    let skipping = false;
-    for (const line of lines) {
-        if (!skipping && line.startsWith(VISION_DESCRIPTION_PREFIX)) {
-            skipping = true;
-            continue;
-        }
-        if (skipping) {
-            if (line === "]") {
-                skipping = false;
-            }
-            continue;
-        }
-        kept.push(line);
-    }
-    return kept.join("\n").replace(/\n{3,}/g, "\n\n").trim();
-}
-function serializeMessagesForUnified(messages) {
-    const parts = [];
-    for (const msg of messages) {
-        if (msg.role === "user") {
-            const content = typeof msg.content === "string"
-                ? msg.content
-                : Array.isArray(msg.content)
-                    ? msg.content.filter((c) => c.type === "text").map(c => c.text).join("")
-                    : "";
-            const cleaned = stripVisionBlocks(content);
-            if (cleaned)
-                parts.push(`[User]: ${cleaned}`);
-        }
-        else if (msg.role === "assistant" && "content" in msg && Array.isArray(msg.content)) {
-            const textParts = [];
-            const toolParts = [];
-            for (const block of msg.content) {
-                if (block.type === "text" && "text" in block) {
-                    textParts.push(block.text);
-                }
-                else if (block.type === "toolCall" && "name" in block) {
-                    const args = block.arguments;
-                    const argsStr = Object.keys(args).sort().map(k => `${k}=${JSON.stringify(args[k])}`).join(", ");
-                    toolParts.push(`${block.name}(${argsStr})`);
-                }
-            }
-            const combined = [...textParts, ...(toolParts.length ? [`[Tools: ${toolParts.join("; ")}]`] : [])];
-            if (combined.length)
-                parts.push(`[Assistant]: ${combined.join("\n")}`);
-        }
-        else if (msg.role === "toolResult") {
-            const text = Array.isArray(msg.content)
-                ? msg.content.filter((c) => c.type === "text").map(c => c.text).join("")
-                : typeof msg.content === "string" ? msg.content : "";
-            if (text) {
-                const truncated = text.length > TOOL_RESULT_MAX_CHARS
-                    ? `${text.slice(0, TOOL_RESULT_MAX_CHARS)}\n[...truncated]`
-                    : text;
-                parts.push(`[Tool result]: ${truncated}`);
-            }
-        }
-        else if (msg.role === "compactionSummary" && "summary" in msg) {
-            parts.push(`[Previous compaction summary]: ${msg.summary}`);
-        }
-    }
-    return parts.join("\n\n");
-}
-// ============================================================================
-// Output Parsing
-// ============================================================================
-const OBSERVATION_LINE_RE = /^\[(\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2})\]\s*\[(low|medium|high|critical)\]\s*(.+)$/i;
-function parseObservations(text) {
-    const results = [];
-    const lines = text.split("\n");
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#") || trimmed === OBSERVATIONS_SECTION)
-            continue;
-        const match = trimmed.match(OBSERVATION_LINE_RE);
-        if (match) {
-            results.push({
-                timestamp: match[1],
-                relevance: match[2].toLowerCase(),
-                content: match[3].trim(),
-            });
-        }
-    }
-    return results;
-}
-function normalizeObservation(raw) {
-    const content = truncateRecordContent(raw.content);
-    if (!content)
-        return undefined;
-    const validRelevance = ["low", "medium", "high", "critical"];
-    const relevance = validRelevance.includes(raw.relevance)
-        ? raw.relevance
-        : "medium";
-    return {
-        id: hashId(content),
-        content,
-        timestamp: raw.timestamp,
-        relevance,
-    };
-}
-/**
- * Generate a unified compaction result: narrative summary + observations
- * in a single LLM call. Uses delimited text output for broad model compatibility.
- */
-export async function generateUnifiedCompaction(input) {
-    const { messagesToSummarize, gapChunk, model, apiKey, headers, signal, previousSummary, customInstructions, thinkingLevel, reserveTokens, } = input;
-    const maxTokens = Math.min(Math.floor(0.8 * reserveTokens), model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY);
-    // Build conversation text
-    const parts = [];
-    const coreText = serializeMessagesForUnified(messagesToSummarize);
-    if (coreText)
-        parts.push(coreText);
-    if (gapChunk?.trim()) {
-        parts.push(`\n--- Gap entries (unobserved raw conversation) ---\n${gapChunk}`);
-    }
-    const conversationText = parts.join("\n\n");
-    const currentTime = nowTimestamp();
-    const userPrompt = buildUnifiedPrompt(conversationText, previousSummary, customInstructions, currentTime);
-    const promptMessages = [
-        {
-            role: "user",
-            content: [{ type: "text", text: userPrompt }],
-            timestamp: Date.now(),
-        },
-    ];
-    const options = { maxTokens, signal, apiKey, headers };
-    if (model.reasoning && thinkingLevel && thinkingLevel !== "off") {
-        options.reasoning = thinkingLevel;
-    }
-    debugLog("unified_compaction.start", {
-        messageCount: messagesToSummarize.length,
-        hasGap: !!gapChunk?.trim(),
-        conversationLength: conversationText.length,
-    });
-    const response = await completeSimple(model, { systemPrompt: UNIFIED_SYSTEM_PROMPT, messages: promptMessages }, options);
-    if (response.stopReason === "error") {
-        throw new Error(`Unified compaction failed: ${response.errorMessage || "Unknown error"}`);
-    }
-    if (response.stopReason === "aborted") {
-        throw new Error("Unified compaction aborted");
-    }
-    const fullText = response.content
-        .filter((c) => c.type === "text")
-        .map((c) => c.text)
-        .join("\n");
-    // Parse the two sections
-    const narrativeIdx = fullText.indexOf(NARRATIVE_SECTION);
-    const obsIdx = fullText.indexOf(OBSERVATIONS_SECTION);
-    let narrativeSummary;
-    let rawObservationsText;
-    if (narrativeIdx >= 0 && obsIdx >= 0) {
-        // Both sections present
-        if (narrativeIdx < obsIdx) {
-            narrativeSummary = fullText.slice(narrativeIdx + NARRATIVE_SECTION.length, obsIdx).trim();
-        }
-        else {
-            narrativeSummary = fullText.slice(narrativeIdx + NARRATIVE_SECTION.length).trim();
-        }
-        rawObservationsText = fullText.slice(obsIdx + OBSERVATIONS_SECTION.length).trim();
-    }
-    else if (narrativeIdx >= 0) {
-        // Only narrative
-        narrativeSummary = fullText.slice(narrativeIdx + NARRATIVE_SECTION.length).trim();
-        rawObservationsText = "";
-    }
-    else if (obsIdx >= 0) {
-        // Only observations (unusual but handle gracefully)
-        narrativeSummary = fullText.slice(0, obsIdx).trim();
-        rawObservationsText = fullText.slice(obsIdx + OBSERVATIONS_SECTION.length).trim();
-    }
-    else {
-        // No delimiters found — treat entire output as narrative
-        debugLog("unified_compaction.no_delimiters", { textLength: fullText.length });
-        narrativeSummary = fullText;
-        rawObservationsText = "";
-    }
-    // Parse observations
-    const rawObservations = parseObservations(rawObservationsText);
-    const observations = [];
-    const seen = new Set();
-    for (const raw of rawObservations) {
-        const normalized = normalizeObservation(raw);
-        if (normalized && !seen.has(normalized.id)) {
-            seen.add(normalized.id);
-            observations.push(normalized);
-        }
-    }
-    // Compute file operations
-    const fileOps = createFileOps();
-    for (const msg of messagesToSummarize) {
-        extractFileOpsFromMessage(msg, fileOps);
-    }
-    const { readFiles, modifiedFiles } = computeFileLists(fileOps);
-    // Append file operations to narrative
-    const fullNarrativeSummary = narrativeSummary + formatFileOperations(readFiles, modifiedFiles);
-    debugLog("unified_compaction.result", {
-        narrativeLength: fullNarrativeSummary.length,
-        observationCount: observations.length,
-        rawObservationLines: rawObservations.length,
-    });
-    return {
-        narrativeSummary: fullNarrativeSummary,
-        observations,
-        readFiles,
-        modifiedFiles,
-    };
-}

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

@@ -1,54 +0,0 @@
-import Anthropic from "@anthropic-ai/sdk";
-import type { SimpleStreamOptions, StreamFunction, StreamOptions } from "../types.js";
-export type AnthropicEffort = "low" | "medium" | "high" | "xhigh" | "max";
-export type AnthropicThinkingDisplay = "summarized" | "omitted";
-export interface AnthropicOptions extends StreamOptions {
-    /**
-     * Enable extended thinking.
-     * For Opus 4.6 and Sonnet 4.6: uses adaptive thinking (model decides when/how much to think).
-     * For older models: uses budget-based thinking with thinkingBudgetTokens.
-     */
-    thinkingEnabled?: boolean;
-    /**
-     * Token budget for extended thinking (older models only).
-     * Ignored for Opus 4.6 and Sonnet 4.6, which use adaptive thinking.
-     */
-    thinkingBudgetTokens?: number;
-    /**
-     * Effort level for adaptive thinking (Opus 4.6+ and Sonnet 4.6).
-     * Controls how much thinking Claude allocates:
-     * - "max": Always thinks with no constraints (Opus 4.6 only)
-     * - "xhigh": Highest reasoning level (Opus 4.7)
-     * - "high": Always thinks, deep reasoning (default)
-     * - "medium": Moderate thinking, may skip for simple queries
-     * - "low": Minimal thinking, skips for simple tasks
-     * Ignored for older models.
-     */
-    effort?: AnthropicEffort;
-    /**
-     * Controls how thinking content is returned in API responses.
-     * - "summarized": Thinking blocks contain summarized thinking text (default here).
-     * - "omitted": Thinking blocks return an empty thinking field; the encrypted
-     *   signature still travels back for multi-turn continuity. Use for faster
-     *   time-to-first-text-token when your UI does not surface thinking.
-     *
-     * Note: Anthropic's API default for Claude Opus 4.7 and Claude Mythos Preview
-     * is "omitted". We default to "summarized" here to keep behavior consistent
-     * with older Claude 4 models. Set this explicitly to "omitted" to opt in.
-     */
-    thinkingDisplay?: AnthropicThinkingDisplay;
-    interleavedThinking?: boolean;
-    toolChoice?: "auto" | "any" | "none" | {
-        type: "tool";
-        name: string;
-    };
-    /**
-     * Pre-built Anthropic client instance. When provided, skips internal client
-     * construction entirely. Use this to inject alternative SDK clients such as
-     * `AnthropicVertex` that shares the same messaging API.
-     */
-    client?: Anthropic;
-}
-export declare const streamAnthropic: StreamFunction<"anthropic-messages", AnthropicOptions>;
-export declare const streamSimpleAnthropic: StreamFunction<"anthropic-messages", SimpleStreamOptions>;
-//# sourceMappingURL=anthropic.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/sdk/ai/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAU1C,OAAO,KAAK,EASX,mBAAmB,EAEnB,cAAc,EACd,aAAa,EAMb,MAAM,aAAa,CAAC;AAiIrB,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE1E,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,SAAS,CAAC;AAmBhE,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACtD;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB;AA4MD,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,oBAAoB,EAAE,gBAAgB,CAyPlF,CAAC;AAyCF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,oBAAoB,EAAE,mBAAmB,CAyC3F,CAAC"}