@superblocksteam/vite-plugin-file-sync 2.0.42 → 2.0.43-next.0

package/dist/ai-service/llm/context/serialization.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Serialization types and utilities for persisting context state.
+ *
+ * These types define the JSON-serializable format used to save and load
+ * context state from the database. They mirror the internal turn structures
+ * but are pure data (no methods).
+ */
+import type { TokenizedUserMessage, TokenizedResponseMessage, TokenizedAssistantMessage, Step } from "./internal-types.js";
+/**
+ * Complete serialized context state.
+ *
+ * This is the format saved to storage and loaded on context restoration.
+ * It contains all conversation turns organized by compression level, and
+ * the latest characters per token estimate.
+ *
+ * Preserving the estimate allows for more accurate token budgeting on
+ * session resumption.
+ */
+export type ContextRecord = {
+    /** Estimated average characters per token */
+    charsPerToken: number;
+    /** Level 1 turns (newest, full detail) */
+    l1Turns: L1TurnRecord[];
+    /** Level 2 turns (moderate compression) */
+    l2Turns: L2TurnRecord[];
+    /** Level 3 turns (heavy compression) */
+    l3Turns: L3TurnRecord[];
+};
+/**
+ * Serialized representation of an L1 (Level 1) turn.
+ */
+export type L1TurnRecord = {
+    /** The user message that initiated this turn */
+    user: TokenizedUserMessage;
+    /** Array of steps, where each step contains response messages */
+    steps: Step[];
+};
+/**
+ * Serialized representation of an L2 (Level 2) turn.
+ */
+export type L2TurnRecord = {
+    /** The user message that initiated this turn */
+    user: TokenizedUserMessage;
+    /** Flattened array of all response messages from all steps */
+    response: TokenizedResponseMessage[];
+};
+/**
+ * Serialized representation of an L3 (Level 3) turn.
+ */
+export type L3TurnRecord = {
+    /** The user message that initiated this turn */
+    user: TokenizedUserMessage;
+    /** Optional last assistant message (if any) */
+    assistant?: TokenizedAssistantMessage;
+};
+//# sourceMappingURL=serialization.d.ts.map

package/dist/ai-service/llm/context/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,IAAI,EACL,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2CAA2C;IAC3C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gDAAgD;IAChD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,iEAAiE;IACjE,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gDAAgD;IAChD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gDAAgD;IAChD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC,CAAC"}

package/dist/ai-service/llm/context/serialization.js

@@ -0,0 +1,9 @@
+/**
+ * Serialization types and utilities for persisting context state.
+ *
+ * These types define the JSON-serializable format used to save and load
+ * context state from the database. They mirror the internal turn structures
+ * but are pure data (no methods).
+ */
+export {};
+//# sourceMappingURL=serialization.js.map

package/dist/ai-service/llm/context/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ai-service/llm/context/storage/index.d.ts

@@ -0,0 +1,10 @@
+import type { ContextRecord } from "../serialization.js";
+import type { ContextId } from "../types.js";
+/**
+ * Storage backend interface for persisting and retrieving context records.
+ */
+export interface ContextStorage {
+    saveContext(id: ContextId, context: ContextRecord): Promise<void>;
+    loadContext(id: ContextId): Promise<ContextRecord | null>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/llm/context/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/dist/ai-service/llm/context/storage/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/ai-service/llm/context/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/storage/index.ts"],"names":[],"mappings":""}

package/dist/ai-service/llm/context/storage/local.d.ts

@@ -0,0 +1,22 @@
+import type { ContextRecord } from "../serialization.js";
+import type { ContextStorage } from "./index.js";
+import type { ContextId } from "../types.js";
+/**
+ * Local filesystem storage backend for context records.
+ *
+ * Contexts are stored as JSON files in the following structure:
+ * {rootDir}/.superblocks/context/{userId}/{contextName}.json
+ *
+ * Example:
+ * /data/.superblocks/context/user123/chat-session.json
+ */
+export declare class LocalContextStorage implements ContextStorage {
+    readonly rootDir: string;
+    private readonly SUPERBLOCKS_SYSTEM_DIR;
+    constructor(rootDir: string);
+    loadContext(id: ContextId): Promise<ContextRecord | null>;
+    saveContext(id: ContextId, record: ContextRecord): Promise<void>;
+    private ensureBaseDirExists;
+    private getFilePath;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/ai-service/llm/context/storage/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/storage/local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAE5C,QAAQ,CAAC,OAAO,EAAE,MAAM;IADpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAkB;gBACpC,OAAO,EAAE,MAAM;IAE9B,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAYzD,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAMxD,mBAAmB;IAIjC,OAAO,CAAC,WAAW;CASpB"}

package/dist/ai-service/llm/context/storage/local.js

@@ -0,0 +1,42 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Local filesystem storage backend for context records.
+ *
+ * Contexts are stored as JSON files in the following structure:
+ * {rootDir}/.superblocks/context/{userId}/{contextName}.json
+ *
+ * Example:
+ * /data/.superblocks/context/user123/chat-session.json
+ */
+export class LocalContextStorage {
+    rootDir;
+    SUPERBLOCKS_SYSTEM_DIR = ".superblocks";
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    async loadContext(id) {
+        try {
+            const content = await readFile(this.getFilePath(id), "utf-8");
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return null; // File does not exist
+            }
+            throw err; // Rethrow other errors
+        }
+    }
+    async saveContext(id, record) {
+        const filePath = this.getFilePath(id);
+        await this.ensureBaseDirExists(filePath);
+        await writeFile(filePath, JSON.stringify(record, null, 2));
+    }
+    async ensureBaseDirExists(filePath) {
+        await mkdir(path.dirname(filePath), { recursive: true });
+    }
+    getFilePath(id) {
+        return path.join(this.rootDir, this.SUPERBLOCKS_SYSTEM_DIR, "context", id.userId, `${id.name}.json`);
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/ai-service/llm/context/storage/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/storage/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IAET;IADJ,sBAAsB,GAAG,cAAc,CAAC;IACzD,YAAqB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,WAAW,CAAC,EAAa;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,CAAC,sBAAsB;YACrC,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,uBAAuB;QACpC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAa,EAAE,MAAqB;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QAChD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEO,WAAW,CAAC,EAAa;QAC/B,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,sBAAsB,EAC3B,SAAS,EACT,EAAE,CAAC,MAAM,EACT,GAAG,EAAE,CAAC,IAAI,OAAO,CAClB,CAAC;IACJ,CAAC;CACF"}

package/dist/ai-service/llm/context/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Public type definitions for the Context management system.
+ */
+/**
+ * Globally unique identifier for a conversation context.
+ */
+export type ContextId = {
+    /** Application identifier */
+    appId: string;
+    /** User identifier */
+    userId: string;
+    /** Context name */
+    name: string;
+};
+/**
+ * Configuration options for context creation and management.
+ * Undefined values will resolve to defaults.
+ */
+export interface ContextOptions {
+    /** Maximum tokens allowed in context window */
+    maxTokens?: number;
+    /** Character-to-token conversion ratio (auto-refined during usage) */
+    charsPerToken?: number;
+    /** If false, an error will be thrown if maxTokens exceeded after compaction */
+    allowOverflow?: boolean;
+    /** Compaction behavior (fractions of maxTokens) */
+    compaction?: CompactionOptions;
+    /** Token estimation configuration */
+    tokenEstimation?: TokenEstimationOptions;
+    /** Prompt caching configuration */
+    caching?: CachingOptions;
+}
+/**
+ * Token count estimation configuration.
+ */
+export interface TokenEstimationOptions {
+    /** Minimum tokens required before updating estimate */
+    minTokensForUpdate?: number;
+    /** Minimum valid chars/token ratio */
+    minCharsPerToken?: number;
+    /** Maximum valid chars/token ratio */
+    maxCharsPerToken?: number;
+}
+/**
+ * Prompt caching configuration.
+ */
+export interface CachingOptions {
+    /** Maximum number of cache breakpoints (provider-specific) */
+    maxBreakpoints?: number;
+    /** Minimum tokens required between cache points for efficiency */
+    minCacheableTokens?: number;
+}
+/**
+ * Compaction behavior configuration.
+ */
+export interface CompactionOptions {
+    /** Token threshold that triggers compaction (as fraction of maxTokens) */
+    trigger?: number;
+    /** Target token count after compaction (as fraction of maxTokens) */
+    target?: number;
+    /** Budget allocation for each compaction level (as fractions of compaction target) */
+    budgets?: CompactionLevelBudgets;
+    /** Number of most recent steps to protect from compression on a best-effort basis (most recent 2 will never be compressed) */
+    prioritizedSteps?: number;
+}
+/** Budget allocations for each compaction level.
+ * Values are fractions of the overall compaction target.
+ * Budget for L3 is implicit as remainder (1 - l1 - l2).
+ */
+export interface CompactionLevelBudgets {
+    /** Fraction of compaction target allocated to Level 1 */
+    l1?: number;
+    /** Fraction of compaction target allocated to Level 2 */
+    l2?: number;
+}
+/** Options for logging context activity. */
+export type LoggingOptions = {
+    /** Enable verbose logging */
+    verbose: boolean;
+    visualization: VisualizationOptions;
+};
+/** Options for context visualizations */
+export type VisualizationOptions = {
+    mode: VisualizationMode;
+    /** Width of visualization output (default: 120) */
+    width?: number;
+    /** Path to write visualizations (overwrites file each time for use with `watch` command) */
+    outputPath?: string;
+};
+/** Visualization mode (default: "detailed")
+ * - "off": No visualization
+ * - "summary": Shows turn, step, and token counts at each level
+ * - "detailed": All messages and parts
+ * */
+export type VisualizationMode = "off" | "summary" | "detailed";
+/**
+ * Information provided when user prompt exceeds size limits.
+ */
+export interface UserPromptTooLargeInfo {
+    /** User message token count */
+    userTokens: number;
+    /** System prompt token count */
+    systemTokens: number;
+    /** Combined user + system tokens */
+    combined: number;
+    /** Maximum allowed tokens */
+    maxTokens: number;
+}
+/**
+ * Information provided when context exceeds limits after compaction.
+ */
+export interface ContextLimitExceededInfo {
+    /** Current total token count */
+    currentTokens: number;
+    /** Maximum allowed tokens */
+    maxTokens: number;
+    /** Token breakdown by component */
+    breakdown: {
+        system: number;
+        user: number;
+        activeStep: number;
+        history: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai-service/llm/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,qCAAqC;IACrC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,mCAAmC;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,8HAA8H;IAC9H,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;KAIK;AACL,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/ai-service/llm/context/types.js

@@ -0,0 +1,5 @@
+/**
+ * Public type definitions for the Context management system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai-service/llm/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/ai-service/llm/context/utils/content-compaction.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Content compaction utilities for removing or reducing tool interaction details.
+ *
+ * These functions are used when demoting turns to more compressed levels,
+ * removing tool call inputs and results while preserving the conversation structure.
+ */
+import type { ContentPart } from "../internal-types.js";
+import type { ReasoningPart } from "@ai-sdk/provider-utils";
+import type { TextPart, ToolCallPart, ToolResultPart } from "ai";
+/**
+ * Compacts content parts by removing tool interaction details.
+ *
+ * Used when demoting turns to L2 (moderate compression):
+ * - Text parts: Preserved unchanged
+ * - Reasoning parts: Preserved unchanged
+ *   Reasoning blocks from current turn must be preserved, and reasoning from previous turns is automatically ignored
+ *   https://docs.aws.amazon.com/bedrock/latest/userguide/claude-messages-extended-thinking.html#claude-messages-how-extended-thinking-works
+ * - Tool call parts: Input replaced with empty object
+ * - Tool result parts: Output replaced with placeholder text
+ * - File parts: Removed
+ *
+ * @param parts - Content parts to compact
+ * @returns Compacted content parts
+ */
+export declare function compactContentParts(parts: ContentPart[]): (TextPart | ReasoningPart | ToolCallPart | ToolResultPart)[];
+//# sourceMappingURL=content-compaction.d.ts.map

package/dist/ai-service/llm/context/utils/content-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-compaction.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/content-compaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAAE,GACnB,CAAC,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,CAAC,EAAE,CA0B9D"}

package/dist/ai-service/llm/context/utils/content-compaction.js

@@ -0,0 +1,52 @@
+/**
+ * Content compaction utilities for removing or reducing tool interaction details.
+ *
+ * These functions are used when demoting turns to more compressed levels,
+ * removing tool call inputs and results while preserving the conversation structure.
+ */
+/**
+ * Compacts content parts by removing tool interaction details.
+ *
+ * Used when demoting turns to L2 (moderate compression):
+ * - Text parts: Preserved unchanged
+ * - Reasoning parts: Preserved unchanged
+ *   Reasoning blocks from current turn must be preserved, and reasoning from previous turns is automatically ignored
+ *   https://docs.aws.amazon.com/bedrock/latest/userguide/claude-messages-extended-thinking.html#claude-messages-how-extended-thinking-works
+ * - Tool call parts: Input replaced with empty object
+ * - Tool result parts: Output replaced with placeholder text
+ * - File parts: Removed
+ *
+ * @param parts - Content parts to compact
+ * @returns Compacted content parts
+ */
+export function compactContentParts(parts) {
+    return parts.flatMap((part) => {
+        if (part.type === "text" || part.type === "reasoning") {
+            return part;
+        }
+        else if (part.type === "tool-call") {
+            return {
+                type: "tool-call",
+                toolCallId: part.toolCallId,
+                toolName: part.toolName,
+                input: {},
+            };
+        }
+        else if (part.type === "tool-result") {
+            return {
+                type: "tool-result",
+                toolCallId: part.toolCallId,
+                toolName: part.toolName,
+                output: {
+                    type: "text",
+                    value: "[tool output trimmed]",
+                },
+            };
+        }
+        else {
+            // File parts are removed
+            return [];
+        }
+    });
+}
+//# sourceMappingURL=content-compaction.js.map

package/dist/ai-service/llm/context/utils/content-compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-compaction.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/content-compaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoB;IAEpB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,EAAE;aACa,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,uBAAuB;iBAC/B;aACuB,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ai-service/llm/context/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utility function exports for context management.
+ *
+ * Internal utilities used by Context and Turn classes.
+ */
+export { estimateTokenCount, countChars as countChars, } from "./token-estimation.js";
+export { compactContentParts } from "./content-compaction.js";
+export { normalizeToolResultOutput } from "./message-utils.js";
+export { renderContext } from "./visualization.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/llm/context/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,UAAU,IAAI,UAAU,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai-service/llm/context/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * Utility function exports for context management.
+ *
+ * Internal utilities used by Context and Turn classes.
+ */
+export { estimateTokenCount, countChars as countChars, } from "./token-estimation.js";
+export { compactContentParts } from "./content-compaction.js";
+export { normalizeToolResultOutput } from "./message-utils.js";
+export { renderContext } from "./visualization.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/llm/context/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,UAAU,IAAI,UAAU,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai-service/llm/context/utils/message-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Message normalization and validation utilities.
+ *
+ * Ensures messages conform to expected formats, particularly for tool results
+ * which must match the LanguageModelV2ToolResultOutput schema.
+ */
+import type { LanguageModelV2ToolResultOutput } from "@ai-sdk/provider";
+import type { AssistantModelMessage } from "ai";
+/**
+ * Validates and normalizes a tool result output to ensure it conforms to
+ * LanguageModelV2ToolResultOutput.
+ *
+ * Handles common issues:
+ * - Null/undefined outputs → wrapped in json type
+ * - Non-object outputs → wrapped in json type
+ * - Missing type field → defaults to json type
+ * - Invalid type values → normalized to json type
+ *
+ * @param output - Tool result output to normalize
+ * @returns Normalized output conforming to LanguageModelV2ToolResultOutput
+ */
+export declare function normalizeToolResultOutput(output: unknown): LanguageModelV2ToolResultOutput;
+/**
+ * Ensures an assistant message's content starts with a reasoning block.
+ * If the first content part is not a reasoning block, one is prepended.
+ *
+ * Avoids issues that can arise when dropping messages, as some models
+ * expect reasoning blocks in specific positions in the turn sequence.
+ *
+ * @param message - Assistant message to check and modify if needed
+ * @returns Assistant message guaranteed to start with a reasoning block
+ */
+export declare function prependReasoningBlockIfNeeded(message: AssistantModelMessage): AssistantModelMessage;
+//# sourceMappingURL=message-utils.d.ts.map

package/dist/ai-service/llm/context/utils/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/message-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,IAAI,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,GACd,+BAA+B,CAuBjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAuBvB"}

package/dist/ai-service/llm/context/utils/message-utils.js

@@ -0,0 +1,73 @@
+/**
+ * Message normalization and validation utilities.
+ *
+ * Ensures messages conform to expected formats, particularly for tool results
+ * which must match the LanguageModelV2ToolResultOutput schema.
+ */
+import { getLogger } from "../../../../util/logger.js";
+/**
+ * Validates and normalizes a tool result output to ensure it conforms to
+ * LanguageModelV2ToolResultOutput.
+ *
+ * Handles common issues:
+ * - Null/undefined outputs → wrapped in json type
+ * - Non-object outputs → wrapped in json type
+ * - Missing type field → defaults to json type
+ * - Invalid type values → normalized to json type
+ *
+ * @param output - Tool result output to normalize
+ * @returns Normalized output conforming to LanguageModelV2ToolResultOutput
+ */
+export function normalizeToolResultOutput(output) {
+    if (output === null || output === undefined) {
+        return { type: "json", value: null };
+    }
+    if (typeof output !== "object") {
+        return { type: "json", value: output };
+    }
+    const outputObj = output;
+    if (!("type" in outputObj) || typeof outputObj.type !== "string") {
+        return { type: "json", value: output };
+    }
+    const validTypes = ["text", "json", "error-text", "error-json"];
+    if (!validTypes.includes(outputObj.type)) {
+        getLogger().warn(`[context] Invalid tool result output type: ${outputObj.type}. Normalizing to json type.`);
+        return { type: "json", value: output };
+    }
+    return output;
+}
+/**
+ * Ensures an assistant message's content starts with a reasoning block.
+ * If the first content part is not a reasoning block, one is prepended.
+ *
+ * Avoids issues that can arise when dropping messages, as some models
+ * expect reasoning blocks in specific positions in the turn sequence.
+ *
+ * @param message - Assistant message to check and modify if needed
+ * @returns Assistant message guaranteed to start with a reasoning block
+ */
+export function prependReasoningBlockIfNeeded(message) {
+    if (typeof message.content == "string") {
+        message.content = [
+            {
+                type: "text",
+                text: message.content,
+            },
+        ];
+    }
+    const firstPart = message.content.at(0);
+    if (!firstPart || firstPart.type === "reasoning") {
+        return message;
+    }
+    return {
+        ...message,
+        content: [
+            {
+                type: "reasoning",
+                text: "",
+            },
+            ...message.content,
+        ],
+    };
+}
+//# sourceMappingURL=message-utils.js.map

package/dist/ai-service/llm/context/utils/message-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/message-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAIvD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAe;IAEf,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAqC,CAAC;IAC1E,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAqC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,MAAiC,CAAC;IACpD,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAqC,CAAC;IAC5E,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,SAAS,EAAE,CAAC,IAAI,CACd,8CAA8C,SAAS,CAAC,IAAI,6BAA6B,CAC1F,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAqC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAyC,CAAC;AACnD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA8B;IAE9B,IAAI,OAAO,OAAO,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;QACvC,OAAO,CAAC,OAAO,GAAG;YAChB;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,CAAC,OAAO;aACtB;SACF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,EAAE;aACT;YACD,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC;AACJ,CAAC"}

package/dist/ai-service/llm/context/utils/token-estimation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Token estimation utilities.
+ *
+ * Provides functions for estimating token counts from message content.
+ * Token estimation is based on a character-to-token ratio that is
+ * learned and refined during usage.
+ */
+import type { ModelMessage } from "ai";
+/**
+ * Estimates the token count for a message based on its content.
+ *
+ * Token estimation strategy:
+ * - String content: Direct character count / ratio
+ * - Array content: Sum of all parts after JSON serialization
+ * - Text/reasoning parts: Use text length
+ * - Tool call parts: JSON serialize the input
+ * - Tool result parts: JSON serialize the output
+ *
+ * @param message - The message to estimate tokens for
+ * @param charactersPerToken - Estimated characters per token ratio (typically 2-5)
+ * @returns Estimated token count (rounded up to nearest integer)
+ */
+export declare function estimateTokenCount(message: ModelMessage, charactersPerToken: number): number;
+/**
+ * Counts the number of characters in a message
+ *
+ * @param message - The message to count characters for
+ * @returns Total character count
+ */
+export declare function countChars(message: ModelMessage): number;
+//# sourceMappingURL=token-estimation.d.ts.map

package/dist/ai-service/llm/context/utils/token-estimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimation.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/token-estimation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAoBxD"}

package/dist/ai-service/llm/context/utils/token-estimation.js

@@ -0,0 +1,52 @@
+/**
+ * Token estimation utilities.
+ *
+ * Provides functions for estimating token counts from message content.
+ * Token estimation is based on a character-to-token ratio that is
+ * learned and refined during usage.
+ */
+import { safeJsonStringify } from "../../../util/safe-stringify.js";
+/**
+ * Estimates the token count for a message based on its content.
+ *
+ * Token estimation strategy:
+ * - String content: Direct character count / ratio
+ * - Array content: Sum of all parts after JSON serialization
+ * - Text/reasoning parts: Use text length
+ * - Tool call parts: JSON serialize the input
+ * - Tool result parts: JSON serialize the output
+ *
+ * @param message - The message to estimate tokens for
+ * @param charactersPerToken - Estimated characters per token ratio (typically 2-5)
+ * @returns Estimated token count (rounded up to nearest integer)
+ */
+export function estimateTokenCount(message, charactersPerToken) {
+    return Math.ceil(countChars(message) / charactersPerToken);
+}
+/**
+ * Counts the number of characters in a message
+ *
+ * @param message - The message to count characters for
+ * @returns Total character count
+ */
+export function countChars(message) {
+    const content = message.content;
+    if (typeof content === "string") {
+        return content.length;
+    }
+    // For array content, estimate each part separately
+    return content.reduce((sum, part) => {
+        let count = 0;
+        if (part.type === "text" || part.type === "reasoning") {
+            count += part.text.length;
+        }
+        else if (part.type === "tool-call") {
+            count += safeJsonStringify(part.input).length;
+        }
+        else if (part.type === "tool-result") {
+            count += safeJsonStringify(part.output).length;
+        }
+        return sum + count;
+    }, 0);
+}
+//# sourceMappingURL=token-estimation.js.map

package/dist/ai-service/llm/context/utils/token-estimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimation.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context/utils/token-estimation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,kBAA0B;IAE1B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,mDAAmD;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACtD,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrC,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAChD,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACvC,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QACjD,CAAC;QAED,OAAO,GAAG,GAAG,KAAK,CAAC;IACrB,CAAC,EAAE,CAAC,CAAC,CAAC;AACR,CAAC"}