@diyor28/context 1.0.0

package/dist/providers/anthropic-compiler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Anthropic compiler: Pure compilation to Anthropic message format.
+ *
+ * Features:
+ * - System messages with prompt caching
+ * - Cache breakpoint resolution ("after last matching block")
+ * - Diagnostics for cache configuration
+ */
+import type { ContextBlock } from '../types/block.js';
+import type { ContextPolicy } from '../types/policy.js';
+import type { AnthropicCompiledContext } from '../types/compiled.js';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Cache breakpoint selector for Anthropic prompt caching.
+ */
+export interface CacheBreakpointSelector {
+    /** Block kind to match */
+    kind?: string;
+    /** Codec ID to match */
+    codecId?: string;
+    /** Tag to match */
+    tag?: string;
+    /** Source to match */
+    source?: string;
+}
+/**
+ * Cache breakpoint diagnostic.
+ */
+export interface CacheBreakpointDiagnostic {
+    /** Diagnostic level */
+    level: 'error' | 'warning' | 'info';
+    /** Diagnostic message */
+    message: string;
+    /** Matched blocks count */
+    matchedBlocks?: number;
+    /** Breakpoint position (if resolved) */
+    position?: number;
+}
+/**
+ * Anthropic compilation options.
+ */
+export interface AnthropicCompilationOptions {
+    /** Cache breakpoint selector (omit = no caching) */
+    cacheBreakpoint?: CacheBreakpointSelector;
+    /** Codec registry for rendering */
+    codecRegistry: Map<string, BlockCodec<unknown>>;
+}
+/**
+ * Compile context to Anthropic message format.
+ * Pure function: same inputs → identical outputs.
+ *
+ * @param blocks - Ordered blocks from ContextView
+ * @param policy - Context policy
+ * @param options - Compilation options
+ * @returns Anthropic compiled context
+ */
+export declare function compileAnthropicContext(blocks: ContextBlock[], policy: ContextPolicy, options: AnthropicCompilationOptions): AnthropicCompiledContext;
+//# sourceMappingURL=anthropic-compiler.d.ts.map

package/dist/providers/anthropic-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-compiler.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAmB,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAEpC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,oDAAoD;IACpD,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAE1C,mCAAmC;IACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,2BAA2B,GACnC,wBAAwB,CAsC1B"}

package/dist/providers/anthropic-compiler.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Anthropic compiler: Pure compilation to Anthropic message format.
+ *
+ * Features:
+ * - System messages with prompt caching
+ * - Cache breakpoint resolution ("after last matching block")
+ * - Diagnostics for cache configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileAnthropicContext = compileAnthropicContext;
+const capabilities_js_1 = require("./capabilities.js");
+/**
+ * Compile context to Anthropic message format.
+ * Pure function: same inputs → identical outputs.
+ *
+ * @param blocks - Ordered blocks from ContextView
+ * @param policy - Context policy
+ * @param options - Compilation options
+ * @returns Anthropic compiled context
+ */
+function compileAnthropicContext(blocks, policy, options) {
+    const capabilities = (0, capabilities_js_1.getProviderCapabilities)('anthropic');
+    // Separate system blocks from message blocks
+    const systemBlocks = blocks.filter((b) => b.meta.kind === 'pinned');
+    const messageBlocks = blocks.filter((b) => b.meta.kind !== 'pinned');
+    // Compile system messages
+    const systemMessages = compileSystemMessages(systemBlocks, options.codecRegistry, options.cacheBreakpoint);
+    // Compile message blocks
+    const messages = compileMessages(messageBlocks, options.codecRegistry);
+    // Calculate tokens (simplified - would use actual estimator in production)
+    const estimatedTokens = blocks.length * 100; // Placeholder
+    return {
+        provider: 'anthropic',
+        modelId: policy.modelId,
+        messages,
+        system: systemMessages.length > 0 ? systemMessages : undefined,
+        estimatedTokens,
+        blocks,
+        meta: {
+            compiledAt: Math.floor(Date.now() / 1000),
+            contextWindow: policy.contextWindow,
+            completionReserve: policy.completionReserve,
+            availableTokens: policy.contextWindow - policy.completionReserve,
+            overflowed: false,
+            compacted: false,
+            truncated: false,
+            tokensByKind: {},
+        },
+    };
+}
+/**
+ * Compile system messages with optional prompt caching.
+ *
+ * @param blocks - System blocks
+ * @param codecRegistry - Codec registry
+ * @param cacheBreakpoint - Cache breakpoint selector
+ * @returns Anthropic system messages
+ */
+function compileSystemMessages(blocks, codecRegistry, cacheBreakpoint) {
+    if (blocks.length === 0) {
+        return [];
+    }
+    const messages = [];
+    // Resolve cache breakpoint position
+    let cacheBreakpointPos = -1;
+    const diagnostics = [];
+    if (cacheBreakpoint) {
+        const result = resolveCacheBreakpoint(blocks, cacheBreakpoint);
+        cacheBreakpointPos = result.position;
+        diagnostics.push(...result.diagnostics);
+    }
+    // Compile each system block
+    for (let i = 0; i < blocks.length; i++) {
+        const block = blocks[i];
+        const codec = codecRegistry.get(block.meta.codecId);
+        if (!codec) {
+            console.warn(`[Anthropic] Codec not found: ${block.meta.codecId}`);
+            continue;
+        }
+        const rendered = codec.render(block);
+        const anthropicContent = rendered.anthropic;
+        // Add cache control if this is the breakpoint
+        const isCacheBreakpoint = i === cacheBreakpointPos;
+        messages.push({
+            type: 'text',
+            text: anthropicContent.text || JSON.stringify(anthropicContent),
+            ...(isCacheBreakpoint && { cache_control: { type: 'ephemeral' } }),
+        });
+    }
+    return messages;
+}
+/**
+ * Compile message blocks to Anthropic message format.
+ *
+ * @param blocks - Message blocks
+ * @param codecRegistry - Codec registry
+ * @returns Anthropic messages
+ */
+function compileMessages(blocks, codecRegistry) {
+    const messages = [];
+    for (const block of blocks) {
+        const codec = codecRegistry.get(block.meta.codecId);
+        if (!codec) {
+            console.warn(`[Anthropic] Codec not found: ${block.meta.codecId}`);
+            continue;
+        }
+        const rendered = codec.render(block);
+        const anthropicContent = rendered.anthropic;
+        // Handle different block kinds
+        if (block.meta.kind === 'history') {
+            // History blocks are already in message format
+            if (Array.isArray(anthropicContent)) {
+                messages.push(...anthropicContent);
+            }
+        }
+        else if (block.meta.kind === 'turn') {
+            // Turn blocks are user messages
+            messages.push({
+                role: 'user',
+                content: anthropicContent.content || anthropicContent,
+            });
+        }
+        else {
+            // Other blocks (reference, memory, state, tool_output) as user messages
+            messages.push({
+                role: 'user',
+                content: typeof anthropicContent === 'string'
+                    ? anthropicContent
+                    : JSON.stringify(anthropicContent),
+            });
+        }
+    }
+    return messages;
+}
+/**
+ * Resolve cache breakpoint position using "after last matching block" strategy.
+ *
+ * @param blocks - System blocks
+ * @param selector - Cache breakpoint selector
+ * @returns Resolved position and diagnostics
+ */
+function resolveCacheBreakpoint(blocks, selector) {
+    const diagnostics = [];
+    // Find all matching blocks
+    const matchedIndices = [];
+    for (let i = 0; i < blocks.length; i++) {
+        const block = blocks[i];
+        const matches = (selector.kind === undefined || block.meta.kind === selector.kind) &&
+            (selector.codecId === undefined || block.meta.codecId === selector.codecId) &&
+            (selector.tag === undefined || block.meta.tags?.includes(selector.tag)) &&
+            (selector.source === undefined || block.meta.source === selector.source);
+        if (matches) {
+            matchedIndices.push(i);
+        }
+    }
+    // Apply "after last matching block" rule
+    if (matchedIndices.length === 0) {
+        diagnostics.push({
+            level: 'warning',
+            message: 'No blocks matched cache breakpoint selector',
+            matchedBlocks: 0,
+        });
+        return { position: -1, diagnostics };
+    }
+    if (matchedIndices.length > 10) {
+        diagnostics.push({
+            level: 'warning',
+            message: `Many blocks matched (${matchedIndices.length}), using last match`,
+            matchedBlocks: matchedIndices.length,
+        });
+    }
+    const lastMatchIndex = matchedIndices[matchedIndices.length - 1];
+    diagnostics.push({
+        level: 'info',
+        message: `Cache breakpoint resolved to block ${lastMatchIndex}`,
+        matchedBlocks: matchedIndices.length,
+        position: lastMatchIndex,
+    });
+    return { position: lastMatchIndex, diagnostics };
+}
+//# sourceMappingURL=anthropic-compiler.js.map

package/dist/providers/anthropic-compiler.js.map

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

package/dist/providers/capabilities.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Provider capabilities and feature detection.
+ */
+import type { Provider } from '../types/policy.js';
+/**
+ * Provider capabilities.
+ */
+export interface ProviderCapabilities {
+    /** Provider identifier */
+    provider: Provider;
+    /** Supports prompt caching */
+    supportsPromptCaching: boolean;
+    /** Supports structured outputs */
+    supportsStructuredOutputs: boolean;
+    /** Supports tool/function calling */
+    supportsToolCalling: boolean;
+    /** Supports vision (image inputs) */
+    supportsVision: boolean;
+    /** Maximum context window (tokens) */
+    maxContextWindow: number;
+    /** Maximum output tokens */
+    maxOutputTokens: number;
+    /** Message format details */
+    messageFormat: {
+        /** Supports system messages */
+        supportsSystemMessages: boolean;
+        /** System message location */
+        systemMessageLocation: 'inline' | 'separate' | 'none';
+        /** Role names */
+        roles: {
+            system?: string;
+            user: string;
+            assistant: string;
+            tool?: string;
+        };
+    };
+    /** Cache breakpoint configuration */
+    caching?: {
+        /** Minimum tokens for caching */
+        minTokensForCaching: number;
+        /** Cache TTL (seconds) */
+        cacheTTL: number;
+        /** Breakpoint selector strategy */
+        breakpointStrategy: 'after_last_match' | 'manual';
+    };
+}
+/**
+ * Get capabilities for a provider.
+ *
+ * @param provider - Provider identifier
+ * @returns Provider capabilities
+ */
+export declare function getProviderCapabilities(provider: Provider): ProviderCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/providers/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/providers/capabilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,8BAA8B;IAC9B,qBAAqB,EAAE,OAAO,CAAC;IAE/B,kCAAkC;IAClC,yBAAyB,EAAE,OAAO,CAAC;IAEnC,qCAAqC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAE7B,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;IAExB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IAExB,6BAA6B;IAC7B,aAAa,EAAE;QACb,+BAA+B;QAC/B,sBAAsB,EAAE,OAAO,CAAC;QAEhC,8BAA8B;QAC9B,qBAAqB,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;QAEtD,iBAAiB;QACjB,KAAK,EAAE;YACL,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IAEF,qCAAqC;IACrC,OAAO,CAAC,EAAE;QACR,iCAAiC;QACjC,mBAAmB,EAAE,MAAM,CAAC;QAE5B,0BAA0B;QAC1B,QAAQ,EAAE,MAAM,CAAC;QAEjB,mCAAmC;QACnC,kBAAkB,EAAE,kBAAkB,GAAG,QAAQ,CAAC;KACnD,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,oBAAoB,CA4EhF"}

package/dist/providers/capabilities.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Provider capabilities and feature detection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProviderCapabilities = getProviderCapabilities;
+/**
+ * Get capabilities for a provider.
+ *
+ * @param provider - Provider identifier
+ * @returns Provider capabilities
+ */
+function getProviderCapabilities(provider) {
+    switch (provider) {
+        case 'anthropic':
+            return {
+                provider: 'anthropic',
+                supportsPromptCaching: true,
+                supportsStructuredOutputs: true,
+                supportsToolCalling: true,
+                supportsVision: true,
+                maxContextWindow: 200000,
+                maxOutputTokens: 64000,
+                messageFormat: {
+                    supportsSystemMessages: true,
+                    systemMessageLocation: 'separate',
+                    roles: {
+                        system: 'system',
+                        user: 'user',
+                        assistant: 'assistant',
+                        tool: 'user',
+                    },
+                },
+                caching: {
+                    minTokensForCaching: 1024,
+                    cacheTTL: 300,
+                    breakpointStrategy: 'after_last_match',
+                },
+            };
+        case 'openai':
+            return {
+                provider: 'openai',
+                supportsPromptCaching: false,
+                supportsStructuredOutputs: true,
+                supportsToolCalling: true,
+                supportsVision: true,
+                maxContextWindow: 128000,
+                maxOutputTokens: 16000,
+                messageFormat: {
+                    supportsSystemMessages: true,
+                    systemMessageLocation: 'inline',
+                    roles: {
+                        system: 'system',
+                        user: 'user',
+                        assistant: 'assistant',
+                        tool: 'tool',
+                    },
+                },
+            };
+        case 'gemini':
+            return {
+                provider: 'gemini',
+                supportsPromptCaching: true,
+                supportsStructuredOutputs: true,
+                supportsToolCalling: true,
+                supportsVision: true,
+                maxContextWindow: 1000000,
+                maxOutputTokens: 64000,
+                messageFormat: {
+                    supportsSystemMessages: true,
+                    systemMessageLocation: 'separate',
+                    roles: {
+                        user: 'user',
+                        assistant: 'model',
+                    },
+                },
+                caching: {
+                    minTokensForCaching: 32000,
+                    cacheTTL: 300,
+                    breakpointStrategy: 'after_last_match',
+                },
+            };
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/providers/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/providers/capabilities.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAiEH,0DA4EC;AAlFD;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,QAAkB;IACxD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO;gBACL,QAAQ,EAAE,WAAW;gBACrB,qBAAqB,EAAE,IAAI;gBAC3B,yBAAyB,EAAE,IAAI;gBAC/B,mBAAmB,EAAE,IAAI;gBACzB,cAAc,EAAE,IAAI;gBACpB,gBAAgB,EAAE,MAAM;gBACxB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE;oBACb,sBAAsB,EAAE,IAAI;oBAC5B,qBAAqB,EAAE,UAAU;oBACjC,KAAK,EAAE;wBACL,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,MAAM;wBACZ,SAAS,EAAE,WAAW;wBACtB,IAAI,EAAE,MAAM;qBACb;iBACF;gBACD,OAAO,EAAE;oBACP,mBAAmB,EAAE,IAAI;oBACzB,QAAQ,EAAE,GAAG;oBACb,kBAAkB,EAAE,kBAAkB;iBACvC;aACF,CAAC;QAEJ,KAAK,QAAQ;YACX,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,qBAAqB,EAAE,KAAK;gBAC5B,yBAAyB,EAAE,IAAI;gBAC/B,mBAAmB,EAAE,IAAI;gBACzB,cAAc,EAAE,IAAI;gBACpB,gBAAgB,EAAE,MAAM;gBACxB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE;oBACb,sBAAsB,EAAE,IAAI;oBAC5B,qBAAqB,EAAE,QAAQ;oBAC/B,KAAK,EAAE;wBACL,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,MAAM;wBACZ,SAAS,EAAE,WAAW;wBACtB,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QAEJ,KAAK,QAAQ;YACX,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,qBAAqB,EAAE,IAAI;gBAC3B,yBAAyB,EAAE,IAAI;gBAC/B,mBAAmB,EAAE,IAAI;gBACzB,cAAc,EAAE,IAAI;gBACpB,gBAAgB,EAAE,OAAO;gBACzB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE;oBACb,sBAAsB,EAAE,IAAI;oBAC5B,qBAAqB,EAAE,UAAU;oBACjC,KAAK,EAAE;wBACL,IAAI,EAAE,MAAM;wBACZ,SAAS,EAAE,OAAO;qBACnB;iBACF;gBACD,OAAO,EAAE;oBACP,mBAAmB,EAAE,KAAK;oBAC1B,QAAQ,EAAE,GAAG;oBACb,kBAAkB,EAAE,kBAAkB;iBACvC;aACF,CAAC;QAEJ;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/providers/gemini-compiler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Gemini compiler: Pure compilation to Gemini content format.
+ *
+ * Features:
+ * - Separate system instruction
+ * - User/model role mapping
+ * - Parts-based content structure
+ * - Caching support (for large contexts)
+ */
+import type { ContextBlock } from '../types/block.js';
+import type { ContextPolicy } from '../types/policy.js';
+import type { GeminiCompiledContext } from '../types/compiled.js';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Gemini compilation options.
+ */
+export interface GeminiCompilationOptions {
+    /** Codec registry for rendering */
+    codecRegistry: Map<string, BlockCodec<unknown>>;
+    /** Cache configuration (optional) */
+    caching?: {
+        /** Enable caching for large contexts */
+        enabled: boolean;
+        /** Minimum tokens for caching */
+        minTokens: number;
+    };
+}
+/**
+ * Compile context to Gemini content format.
+ * Pure function: same inputs → identical outputs.
+ *
+ * @param blocks - Ordered blocks from ContextView
+ * @param policy - Context policy
+ * @param options - Compilation options
+ * @returns Gemini compiled context
+ */
+export declare function compileGeminiContext(blocks: ContextBlock[], policy: ContextPolicy, options: GeminiCompilationOptions): GeminiCompiledContext;
+/**
+ * Validate Gemini message sequence.
+ *
+ * @param messages - Gemini messages
+ * @returns Validation diagnostics
+ */
+export declare function validateGeminiMessages(messages: Array<{
+    role: 'user' | 'model';
+    parts: unknown[];
+}>): Array<{
+    level: 'error' | 'warning';
+    message: string;
+}>;
+//# sourceMappingURL=gemini-compiler.d.ts.map

package/dist/providers/gemini-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-compiler.d.ts","sourceRoot":"","sources":["../../src/providers/gemini-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mCAAmC;IACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhD,qCAAqC;IACrC,OAAO,CAAC,EAAE;QACR,wCAAwC;QACxC,OAAO,EAAE,OAAO,CAAC;QAEjB,iCAAiC;QACjC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,wBAAwB,GAChC,qBAAqB,CAkCvB;AA+ID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,GAC5D,KAAK,CAAC;IAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCxD"}

package/dist/providers/gemini-compiler.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Gemini compiler: Pure compilation to Gemini content format.
+ *
+ * Features:
+ * - Separate system instruction
+ * - User/model role mapping
+ * - Parts-based content structure
+ * - Caching support (for large contexts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileGeminiContext = compileGeminiContext;
+exports.validateGeminiMessages = validateGeminiMessages;
+const capabilities_js_1 = require("./capabilities.js");
+/**
+ * Compile context to Gemini content format.
+ * Pure function: same inputs → identical outputs.
+ *
+ * @param blocks - Ordered blocks from ContextView
+ * @param policy - Context policy
+ * @param options - Compilation options
+ * @returns Gemini compiled context
+ */
+function compileGeminiContext(blocks, policy, options) {
+    const capabilities = (0, capabilities_js_1.getProviderCapabilities)('gemini');
+    // Separate system blocks from message blocks
+    const systemBlocks = blocks.filter((b) => b.meta.kind === 'pinned');
+    const messageBlocks = blocks.filter((b) => b.meta.kind !== 'pinned');
+    // Compile system instruction
+    const systemInstruction = compileSystemInstruction(systemBlocks, options.codecRegistry);
+    // Compile message blocks
+    const messages = compileMessages(messageBlocks, options.codecRegistry);
+    // Calculate tokens (simplified - would use actual estimator in production)
+    const estimatedTokens = blocks.length * 100; // Placeholder
+    return {
+        provider: 'gemini',
+        modelId: policy.modelId,
+        messages,
+        system: systemInstruction,
+        estimatedTokens,
+        blocks,
+        meta: {
+            compiledAt: Math.floor(Date.now() / 1000),
+            contextWindow: policy.contextWindow,
+            completionReserve: policy.completionReserve,
+            availableTokens: policy.contextWindow - policy.completionReserve,
+            overflowed: false,
+            compacted: false,
+            truncated: false,
+            tokensByKind: {},
+        },
+    };
+}
+/**
+ * Compile system instruction from system blocks.
+ * Gemini uses a single string for system instruction.
+ *
+ * @param blocks - System blocks
+ * @param codecRegistry - Codec registry
+ * @returns System instruction string (or undefined)
+ */
+function compileSystemInstruction(blocks, codecRegistry) {
+    if (blocks.length === 0) {
+        return undefined;
+    }
+    const parts = [];
+    for (const block of blocks) {
+        const codec = codecRegistry.get(block.meta.codecId);
+        if (!codec) {
+            console.warn(`[Gemini] Codec not found: ${block.meta.codecId}`);
+            continue;
+        }
+        const rendered = codec.render(block);
+        const geminiContent = rendered.gemini;
+        // Extract text from rendered content
+        if (typeof geminiContent === 'string') {
+            parts.push(geminiContent);
+        }
+        else {
+            parts.push(JSON.stringify(geminiContent));
+        }
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Compile blocks to Gemini messages.
+ * Gemini uses user/model roles and parts-based content.
+ *
+ * @param blocks - Message blocks
+ * @param codecRegistry - Codec registry
+ * @returns Gemini messages
+ */
+function compileMessages(blocks, codecRegistry) {
+    const messages = [];
+    for (const block of blocks) {
+        const codec = codecRegistry.get(block.meta.codecId);
+        if (!codec) {
+            console.warn(`[Gemini] Codec not found: ${block.meta.codecId}`);
+            continue;
+        }
+        const rendered = codec.render(block);
+        const geminiContent = rendered.gemini;
+        // Handle different block kinds
+        if (block.meta.kind === 'history') {
+            // History blocks are already in message format
+            if (Array.isArray(geminiContent)) {
+                messages.push(...geminiContent);
+            }
+            else {
+                messages.push(geminiContent);
+            }
+        }
+        else if (block.meta.kind === 'turn') {
+            // Turn blocks are user messages
+            messages.push({
+                role: 'user',
+                parts: geminiContent.parts || [{ text: geminiContent }],
+            });
+        }
+        else {
+            // Other blocks (reference, memory, state, tool_output) as user messages
+            const textContent = typeof geminiContent === 'string'
+                ? geminiContent
+                : JSON.stringify(geminiContent);
+            messages.push({
+                role: 'user',
+                parts: [{ text: textContent }],
+            });
+        }
+    }
+    // Ensure alternating user/model roles (required by Gemini)
+    return enforceAlternatingRoles(messages);
+}
+/**
+ * Enforce alternating user/model roles.
+ * Gemini requires strict alternation between user and model messages.
+ *
+ * @param messages - Input messages
+ * @returns Messages with enforced alternation
+ */
+function enforceAlternatingRoles(messages) {
+    const result = [];
+    let currentRole = null;
+    let currentParts = [];
+    for (const msg of messages) {
+        if (msg.role === currentRole) {
+            // Same role - merge parts
+            currentParts.push(...msg.parts);
+        }
+        else {
+            // Different role - flush current message
+            if (currentRole !== null && currentParts.length > 0) {
+                result.push({ role: currentRole, parts: currentParts });
+            }
+            // Start new message
+            currentRole = msg.role;
+            currentParts = [...msg.parts];
+        }
+    }
+    // Flush final message
+    if (currentRole !== null && currentParts.length > 0) {
+        result.push({ role: currentRole, parts: currentParts });
+    }
+    return result;
+}
+/**
+ * Validate Gemini message sequence.
+ *
+ * @param messages - Gemini messages
+ * @returns Validation diagnostics
+ */
+function validateGeminiMessages(messages) {
+    const diagnostics = [];
+    // Check for empty messages
+    if (messages.length === 0) {
+        diagnostics.push({
+            level: 'error',
+            message: 'Message array is empty',
+        });
+        return diagnostics;
+    }
+    // Check for strict alternation
+    let lastRole = null;
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        if (msg.role === lastRole) {
+            diagnostics.push({
+                level: 'error',
+                message: `Consecutive ${msg.role} messages at index ${i} (Gemini requires strict alternation)`,
+            });
+        }
+        lastRole = msg.role;
+    }
+    // Check for empty parts
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        if (msg.parts.length === 0) {
+            diagnostics.push({
+                level: 'error',
+                message: `Empty parts array at index ${i}`,
+            });
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=gemini-compiler.js.map