@diyor28/context 1.0.0

package/dist/adapters/gemini-estimator.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * GeminiTokenEstimator: High-confidence token counting via tiktoken.
+ *
+ * Uses tiktoken with gpt-4 encoding as a good approximation for Gemini.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiTokenEstimator = void 0;
+const tiktoken_1 = require("tiktoken");
+const token_estimator_js_1 = require("./token-estimator.js");
+/**
+ * GeminiTokenEstimator using tiktoken (gpt-4 encoding as approximation).
+ */
+class GeminiTokenEstimator {
+    /**
+     * Estimate tokens for a single block using tiktoken.
+     *
+     * @param block - Block to estimate
+     * @returns Token estimate (high confidence)
+     */
+    async estimateBlock(block) {
+        try {
+            const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+            const encoding = (0, tiktoken_1.encoding_for_model)('gpt-4');
+            const tokens = encoding.encode(text);
+            encoding.free(); // Important: free memory
+            return {
+                tokens: tokens.length,
+                confidence: 'high',
+            };
+        }
+        catch (error) {
+            // Fallback to heuristic on error
+            console.warn('[GeminiTokenEstimator] tiktoken error, falling back to heuristic:', error);
+            const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+            return {
+                tokens: (0, token_estimator_js_1.heuristicTokenCount)(text),
+                confidence: 'low',
+            };
+        }
+    }
+    /**
+     * Estimate tokens for multiple blocks.
+     *
+     * @param blocks - Blocks to estimate
+     * @returns Token estimate (high confidence if all succeed)
+     */
+    async estimate(blocks) {
+        if (blocks.length === 0) {
+            return { tokens: 0, confidence: 'high' };
+        }
+        try {
+            const combinedText = blocks
+                .map((block) => (0, token_estimator_js_1.serializeBlockForEstimation)(block))
+                .join('\n\n');
+            const encoding = (0, tiktoken_1.encoding_for_model)('gpt-4');
+            const tokens = encoding.encode(combinedText);
+            encoding.free(); // Important: free memory
+            return {
+                tokens: tokens.length,
+                confidence: 'high',
+            };
+        }
+        catch (error) {
+            // Fallback: sum individual heuristic estimates
+            console.warn('[GeminiTokenEstimator] tiktoken error, falling back to heuristic:', error);
+            let totalTokens = 0;
+            for (const block of blocks) {
+                const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+                totalTokens += (0, token_estimator_js_1.heuristicTokenCount)(text);
+            }
+            return {
+                tokens: totalTokens,
+                confidence: 'low',
+            };
+        }
+    }
+}
+exports.GeminiTokenEstimator = GeminiTokenEstimator;
+//# sourceMappingURL=gemini-estimator.js.map

package/dist/adapters/gemini-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-estimator.js","sourceRoot":"","sources":["../../src/adapters/gemini-estimator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAA8C;AAG9C,6DAG8B;AAE9B;;GAEG;AACH,MAAa,oBAAoB;IAC/B;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,KAA4B;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAA,6BAAkB,EAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,yBAAyB;YAE1C,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;YACjC,OAAO,CAAC,IAAI,CACV,mEAAmE,EACnE,KAAK,CACN,CAAC;YACF,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;YAChD,OAAO;gBACL,MAAM,EAAE,IAAA,wCAAmB,EAAC,IAAI,CAAC;gBACjC,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM;iBACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;iBAClD,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,MAAM,QAAQ,GAAG,IAAA,6BAAkB,EAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,yBAAyB;YAE1C,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,CAAC,IAAI,CACV,mEAAmE,EACnE,KAAK,CACN,CAAC;YAEF,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;gBAChD,WAAW,IAAI,IAAA,wCAAmB,EAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA3ED,oDA2EC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapter exports (token estimators, attachment resolvers, etc.)
+ */
+export * from './token-estimator.js';
+export * from './anthropic-estimator.js';
+export * from './openai-estimator.js';
+export * from './gemini-estimator.js';
+export * from './attachment-resolver.js';
+export * from './attachment-selector.js';
+export * from './summarizer.js';
+export * from './memory-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Adapter exports (token estimators, attachment resolvers, etc.)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./token-estimator.js"), exports);
+__exportStar(require("./anthropic-estimator.js"), exports);
+__exportStar(require("./openai-estimator.js"), exports);
+__exportStar(require("./gemini-estimator.js"), exports);
+__exportStar(require("./attachment-resolver.js"), exports);
+__exportStar(require("./attachment-selector.js"), exports);
+__exportStar(require("./summarizer.js"), exports);
+__exportStar(require("./memory-store.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,2DAAyC;AACzC,wDAAsC;AACtC,wDAAsC;AACtC,2DAAyC;AACzC,2DAAyC;AACzC,kDAAgC;AAChC,oDAAkC"}

package/dist/adapters/memory-store.d.ts

@@ -0,0 +1,139 @@
+/**
+ * MemoryStore: Persistence interface for context blocks.
+ *
+ * Provides a common interface for storing and retrieving context blocks
+ * with support for querying and deletion.
+ *
+ * External implementations:
+ * - @foundry/context-store-postgres - PostgreSQL backend
+ * - @foundry/context-store-redis - Redis backend
+ * - @foundry/context-store-memory - In-memory backend (testing)
+ */
+import type { ContextBlock } from '../types/block.js';
+import type { BlockQuery } from '../graph/queries.js';
+/**
+ * Memory store query options.
+ */
+export interface MemoryQueryOptions {
+    /** Block query filter */
+    query?: BlockQuery;
+    /** Maximum number of results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort by field (default: createdAt descending) */
+    sortBy?: 'createdAt' | 'blockHash';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Memory store save options.
+ */
+export interface MemorySaveOptions {
+    /** Time-to-live (seconds, optional) */
+    ttl?: number;
+    /** Overwrite existing block with same hash */
+    overwrite?: boolean;
+}
+/**
+ * MemoryStore interface for context block persistence.
+ */
+export interface MemoryStore {
+    /**
+     * Save a block to the store.
+     *
+     * @param block - Block to save
+     * @param options - Save options
+     * @returns Promise resolving when save is complete
+     */
+    save<TPayload>(block: ContextBlock<TPayload>, options?: MemorySaveOptions): Promise<void>;
+    /**
+     * Load a block by hash.
+     *
+     * @param blockHash - Block hash to load
+     * @returns Block if found, undefined otherwise
+     */
+    load<TPayload = unknown>(blockHash: string): Promise<ContextBlock<TPayload> | undefined>;
+    /**
+     * Query blocks matching criteria.
+     *
+     * @param options - Query options
+     * @returns Matching blocks
+     */
+    query(options?: MemoryQueryOptions): Promise<ContextBlock<unknown>[]>;
+    /**
+     * Delete a block by hash.
+     *
+     * @param blockHash - Block hash to delete
+     * @returns True if block was deleted, false if not found
+     */
+    delete(blockHash: string): Promise<boolean>;
+    /**
+     * Delete all blocks matching a query.
+     *
+     * @param query - Block query filter
+     * @returns Number of blocks deleted
+     */
+    deleteMany(query: BlockQuery): Promise<number>;
+    /**
+     * Check if a block exists in the store.
+     *
+     * @param blockHash - Block hash to check
+     * @returns True if block exists
+     */
+    exists(blockHash: string): Promise<boolean>;
+    /**
+     * Get store statistics.
+     *
+     * @returns Store stats
+     */
+    getStats(): Promise<{
+        blockCount: number;
+        totalSizeBytes?: number;
+    }>;
+    /**
+     * Clear all blocks from the store.
+     * Use with caution!
+     *
+     * @returns Promise resolving when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * InMemoryStore: Simple in-memory implementation for testing.
+ *
+ * WARNING: Not suitable for production use. Data is lost on process restart.
+ */
+export declare class InMemoryStore implements MemoryStore {
+    private readonly blocks;
+    private readonly ttls;
+    constructor();
+    /**
+     * Clean up expired blocks (called before operations).
+     */
+    private cleanupExpired;
+    save<TPayload>(block: ContextBlock<TPayload>, options?: MemorySaveOptions): Promise<void>;
+    load<TPayload = unknown>(blockHash: string): Promise<ContextBlock<TPayload> | undefined>;
+    query(options?: MemoryQueryOptions): Promise<ContextBlock<unknown>[]>;
+    delete(blockHash: string): Promise<boolean>;
+    deleteMany(query: BlockQuery): Promise<number>;
+    exists(blockHash: string): Promise<boolean>;
+    getStats(): Promise<{
+        blockCount: number;
+        totalSizeBytes?: number;
+    }>;
+    clear(): Promise<void>;
+    /**
+     * Get all blocks (testing only).
+     *
+     * @returns All blocks in the store
+     */
+    getAllBlocks(): ContextBlock<unknown>[];
+}
+/**
+ * Create an in-memory store for testing.
+ *
+ * @returns InMemoryStore instance
+ */
+export declare function createInMemoryStore(): MemoryStore;
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/adapters/memory-store.d.ts.map

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

package/dist/adapters/memory-store.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * MemoryStore: Persistence interface for context blocks.
+ *
+ * Provides a common interface for storing and retrieving context blocks
+ * with support for querying and deletion.
+ *
+ * External implementations:
+ * - @foundry/context-store-postgres - PostgreSQL backend
+ * - @foundry/context-store-redis - Redis backend
+ * - @foundry/context-store-memory - In-memory backend (testing)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = void 0;
+exports.createInMemoryStore = createInMemoryStore;
+/**
+ * InMemoryStore: Simple in-memory implementation for testing.
+ *
+ * WARNING: Not suitable for production use. Data is lost on process restart.
+ */
+class InMemoryStore {
+    blocks;
+    ttls; // blockHash -> expiresAt timestamp
+    constructor() {
+        this.blocks = new Map();
+        this.ttls = new Map();
+    }
+    /**
+     * Clean up expired blocks (called before operations).
+     */
+    cleanupExpired() {
+        const now = Math.floor(Date.now() / 1000);
+        const expiredHashes = [];
+        for (const [blockHash, expiresAt] of this.ttls.entries()) {
+            if (expiresAt <= now) {
+                expiredHashes.push(blockHash);
+            }
+        }
+        for (const hash of expiredHashes) {
+            this.blocks.delete(hash);
+            this.ttls.delete(hash);
+        }
+    }
+    async save(block, options) {
+        this.cleanupExpired();
+        const { blockHash } = block;
+        // Check for existing block
+        if (this.blocks.has(blockHash) && !options?.overwrite) {
+            // Block already exists and overwrite is false - skip
+            return;
+        }
+        // Save block
+        this.blocks.set(blockHash, block);
+        // Set TTL if provided
+        if (options?.ttl) {
+            const expiresAt = Math.floor(Date.now() / 1000) + options.ttl;
+            this.ttls.set(blockHash, expiresAt);
+        }
+        else {
+            // Remove TTL if overwriting without TTL
+            this.ttls.delete(blockHash);
+        }
+    }
+    async load(blockHash) {
+        this.cleanupExpired();
+        return this.blocks.get(blockHash);
+    }
+    async query(options) {
+        this.cleanupExpired();
+        let results = Array.from(this.blocks.values());
+        // Apply query filter if provided
+        if (options?.query) {
+            const { matchesQuery } = await Promise.resolve().then(() => __importStar(require('../graph/queries.js')));
+            results = results.filter((block) => matchesQuery(block, options.query, {
+                select: () => [],
+                hasBlock: (hash) => this.blocks.has(hash),
+            }));
+        }
+        // Sort results
+        const sortBy = options?.sortBy ?? 'createdAt';
+        const sortOrder = options?.sortOrder ?? 'desc';
+        results.sort((a, b) => {
+            let comparison = 0;
+            if (sortBy === 'createdAt') {
+                comparison = a.meta.createdAt - b.meta.createdAt;
+            }
+            else if (sortBy === 'blockHash') {
+                comparison = a.blockHash.localeCompare(b.blockHash);
+            }
+            return sortOrder === 'asc' ? comparison : -comparison;
+        });
+        // Apply limit and offset
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? results.length;
+        return results.slice(offset, offset + limit);
+    }
+    async delete(blockHash) {
+        this.cleanupExpired();
+        const existed = this.blocks.delete(blockHash);
+        this.ttls.delete(blockHash);
+        return existed;
+    }
+    async deleteMany(query) {
+        this.cleanupExpired();
+        const matchingBlocks = await this.query({ query });
+        let deleted = 0;
+        for (const block of matchingBlocks) {
+            if (await this.delete(block.blockHash)) {
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    async exists(blockHash) {
+        this.cleanupExpired();
+        return this.blocks.has(blockHash);
+    }
+    async getStats() {
+        this.cleanupExpired();
+        // Estimate total size in bytes
+        let totalSizeBytes = 0;
+        for (const block of this.blocks.values()) {
+            // Rough estimate: JSON.stringify length
+            totalSizeBytes += JSON.stringify(block).length;
+        }
+        return {
+            blockCount: this.blocks.size,
+            totalSizeBytes,
+        };
+    }
+    async clear() {
+        this.blocks.clear();
+        this.ttls.clear();
+    }
+    /**
+     * Get all blocks (testing only).
+     *
+     * @returns All blocks in the store
+     */
+    getAllBlocks() {
+        this.cleanupExpired();
+        return Array.from(this.blocks.values());
+    }
+}
+exports.InMemoryStore = InMemoryStore;
+/**
+ * Create an in-memory store for testing.
+ *
+ * @returns InMemoryStore instance
+ */
+function createInMemoryStore() {
+    return new InMemoryStore();
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/adapters/memory-store.js.map

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

package/dist/adapters/openai-estimator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OpenAITokenEstimator: High-confidence token counting via tiktoken.
+ *
+ * Uses tiktoken library for accurate token counts.
+ */
+import type { TiktokenModel } from 'tiktoken';
+import type { ContextBlock } from '../types/block.js';
+import type { TokenEstimator, TokenEstimate } from './token-estimator.js';
+/**
+ * OpenAITokenEstimator using tiktoken.
+ */
+export declare class OpenAITokenEstimator implements TokenEstimator {
+    private readonly model;
+    /**
+     * Create an OpenAITokenEstimator.
+     *
+     * @param model - Model name (e.g., 'gpt-4', 'gpt-3.5-turbo')
+     */
+    constructor(model?: TiktokenModel);
+    /**
+     * Estimate tokens for a single block using tiktoken.
+     *
+     * @param block - Block to estimate
+     * @returns Token estimate (high confidence)
+     */
+    estimateBlock(block: ContextBlock<unknown>): Promise<TokenEstimate>;
+    /**
+     * Estimate tokens for multiple blocks.
+     *
+     * @param blocks - Blocks to estimate
+     * @returns Token estimate (high confidence if all succeed)
+     */
+    estimate(blocks: ContextBlock<unknown>[]): Promise<TokenEstimate>;
+}
+//# sourceMappingURL=openai-estimator.d.ts.map

package/dist/adapters/openai-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-estimator.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-estimator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1E;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC;;;;OAIG;gBACS,KAAK,GAAE,aAAuB;IAI1C;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBzE;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAqCxE"}

package/dist/adapters/openai-estimator.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * OpenAITokenEstimator: High-confidence token counting via tiktoken.
+ *
+ * Uses tiktoken library for accurate token counts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAITokenEstimator = void 0;
+const tiktoken_1 = require("tiktoken");
+const token_estimator_js_1 = require("./token-estimator.js");
+/**
+ * OpenAITokenEstimator using tiktoken.
+ */
+class OpenAITokenEstimator {
+    model;
+    /**
+     * Create an OpenAITokenEstimator.
+     *
+     * @param model - Model name (e.g., 'gpt-4', 'gpt-3.5-turbo')
+     */
+    constructor(model = 'gpt-4') {
+        this.model = model;
+    }
+    /**
+     * Estimate tokens for a single block using tiktoken.
+     *
+     * @param block - Block to estimate
+     * @returns Token estimate (high confidence)
+     */
+    async estimateBlock(block) {
+        try {
+            const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+            const encoding = (0, tiktoken_1.encoding_for_model)(this.model);
+            const tokens = encoding.encode(text);
+            encoding.free(); // Important: free memory
+            return {
+                tokens: tokens.length,
+                confidence: 'high',
+            };
+        }
+        catch (error) {
+            // Fallback to heuristic on error
+            console.warn('[OpenAITokenEstimator] tiktoken error, falling back to heuristic:', error);
+            const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+            return {
+                tokens: (0, token_estimator_js_1.heuristicTokenCount)(text),
+                confidence: 'low',
+            };
+        }
+    }
+    /**
+     * Estimate tokens for multiple blocks.
+     *
+     * @param blocks - Blocks to estimate
+     * @returns Token estimate (high confidence if all succeed)
+     */
+    async estimate(blocks) {
+        if (blocks.length === 0) {
+            return { tokens: 0, confidence: 'high' };
+        }
+        try {
+            const combinedText = blocks
+                .map((block) => (0, token_estimator_js_1.serializeBlockForEstimation)(block))
+                .join('\n\n');
+            const encoding = (0, tiktoken_1.encoding_for_model)(this.model);
+            const tokens = encoding.encode(combinedText);
+            encoding.free(); // Important: free memory
+            return {
+                tokens: tokens.length,
+                confidence: 'high',
+            };
+        }
+        catch (error) {
+            // Fallback: sum individual heuristic estimates
+            console.warn('[OpenAITokenEstimator] tiktoken error, falling back to heuristic:', error);
+            let totalTokens = 0;
+            for (const block of blocks) {
+                const text = (0, token_estimator_js_1.serializeBlockForEstimation)(block);
+                totalTokens += (0, token_estimator_js_1.heuristicTokenCount)(text);
+            }
+            return {
+                tokens: totalTokens,
+                confidence: 'low',
+            };
+        }
+    }
+}
+exports.OpenAITokenEstimator = OpenAITokenEstimator;
+//# sourceMappingURL=openai-estimator.js.map

package/dist/adapters/openai-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-estimator.js","sourceRoot":"","sources":["../../src/adapters/openai-estimator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAA8C;AAI9C,6DAG8B;AAE9B;;GAEG;AACH,MAAa,oBAAoB;IACd,KAAK,CAAgB;IAEtC;;;;OAIG;IACH,YAAY,QAAuB,OAAO;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,KAA4B;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAA,6BAAkB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,yBAAyB;YAE1C,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;YACjC,OAAO,CAAC,IAAI,CACV,mEAAmE,EACnE,KAAK,CACN,CAAC;YACF,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;YAChD,OAAO;gBACL,MAAM,EAAE,IAAA,wCAAmB,EAAC,IAAI,CAAC;gBACjC,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM;iBACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;iBAClD,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,MAAM,QAAQ,GAAG,IAAA,6BAAkB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,yBAAyB;YAE1C,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,CAAC,IAAI,CACV,mEAAmE,EACnE,KAAK,CACN,CAAC;YAEF,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAA,gDAA2B,EAAC,KAAK,CAAC,CAAC;gBAChD,WAAW,IAAI,IAAA,wCAAmB,EAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAtFD,oDAsFC"}