@backendkit-labs/curator-codex-agent 0.2.0

package/dist/knowledge/engine.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Knowledge Engine
+ * Orchestrates RAG search, synthesis, and vault indexing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeEngine = void 0;
+const rag_provider_js_1 = require("./rag-provider.js");
+const synthesis_js_1 = require("./synthesis.js");
+class KnowledgeEngine {
+    rag;
+    synthesizer;
+    isInitialized = false;
+    constructor(provider, vaultPath) {
+        this.rag = new rag_provider_js_1.CuratorRagProvider(vaultPath);
+        this.synthesizer = new synthesis_js_1.KnowledgeSynthesizer(provider, vaultPath);
+    }
+    /**
+     * Initialize the knowledge engine
+     */
+    async initialize() {
+        try {
+            await this.rag.indexVault();
+            this.isInitialized = true;
+        }
+        catch (err) {
+            console.error('Knowledge engine initialization failed:', err);
+            throw err;
+        }
+    }
+    /**
+     * Search the vault
+     */
+    async search(query, opts = {}) {
+        const start = Date.now();
+        if (!this.isInitialized) {
+            await this.initialize();
+        }
+        try {
+            const results = await this.rag.search(query, { topK: opts.topK || 5 });
+            let synthesized = undefined;
+            if (opts.autoSynthesize !== false && results.length > 0) {
+                const synthesis = await this.synthesizer.synthesize(query, results);
+                if (synthesis) {
+                    const saved = await this.synthesizer.saveNote(synthesis);
+                    if (saved) {
+                        synthesized = {
+                            title: synthesis.title,
+                            content: synthesis.content.slice(0, 500), // Preview
+                            basedOn: synthesis.basedOn,
+                        };
+                    }
+                }
+            }
+            return {
+                query,
+                results,
+                synthesized,
+                totalResults: results.length,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            console.error('Search failed:', err);
+            throw err;
+        }
+    }
+    /**
+     * Reload and reindex the vault
+     */
+    async reload() {
+        const start = Date.now();
+        try {
+            const result = await this.rag.reload();
+            this.isInitialized = true;
+            return {
+                indexed: result.indexed,
+                updated: result.updated,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            console.error('Reload failed:', err);
+            throw err;
+        }
+    }
+    /**
+     * Get engine statistics
+     */
+    async getStats() {
+        return {
+            initialized: this.isInitialized,
+            vaultStats: await this.rag.getStats(),
+        };
+    }
+    /**
+     * Create MCP tools for knowledge operations
+     */
+    createTools() {
+        return [
+            {
+                name: 'knowledge_search',
+                description: 'Search the vault using semantic search (RAG). Returns relevant notes and optionally generates a synthetic summary note.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Search query (natural language, e.g., "How to handle errors?")',
+                        },
+                        topK: {
+                            type: 'number',
+                            description: 'Number of results to return (default: 5)',
+                        },
+                        autoSynthesize: {
+                            type: 'boolean',
+                            description: 'Automatically generate a synthesis note (default: true)',
+                        },
+                    },
+                    required: ['query'],
+                },
+                handler: async (args) => {
+                    try {
+                        const response = await this.search(args.query, {
+                            topK: args.topK,
+                            autoSynthesize: args.autoSynthesize !== false,
+                        });
+                        return JSON.stringify(response);
+                    }
+                    catch (err) {
+                        return JSON.stringify({
+                            error: err.message,
+                        });
+                    }
+                },
+            },
+            {
+                name: 'knowledge_reload',
+                description: 'Reload and reindex the vault. Call this after external changes to the vault.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                    required: [],
+                },
+                handler: async () => {
+                    try {
+                        const response = await this.reload();
+                        return JSON.stringify(response);
+                    }
+                    catch (err) {
+                        return JSON.stringify({
+                            error: err.message,
+                        });
+                    }
+                },
+            },
+            {
+                name: 'knowledge_stats',
+                description: 'Get knowledge engine statistics.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                    required: [],
+                },
+                handler: async () => {
+                    try {
+                        const stats = await this.getStats();
+                        return JSON.stringify(stats);
+                    }
+                    catch (err) {
+                        return JSON.stringify({
+                            error: err.message,
+                        });
+                    }
+                },
+            },
+        ];
+    }
+}
+exports.KnowledgeEngine = KnowledgeEngine;
+//# sourceMappingURL=engine.js.map

package/dist/knowledge/engine.js.map

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

package/dist/knowledge/rag-provider.d.ts

@@ -0,0 +1,87 @@
+/**
+ * RAG Provider for Curator-Codex
+ * Wraps ObsidianRAGProvider with semantic search capabilities
+ */
+export interface RagSearchResult {
+    title: string;
+    content: string;
+    relevance: number;
+    sourcePath: string;
+    sourceRef?: string;
+}
+export interface RagSearchOptions {
+    topK?: number;
+    minScore?: number;
+}
+export declare class CuratorRagProvider {
+    private rag;
+    private vaultPath;
+    private isIndexed;
+    constructor(vaultPath: string);
+    private getIndexPath;
+    /**
+     * Index the vault (loads all notes and creates embeddings)
+     */
+    indexVault(): Promise<{
+        indexed: number;
+        updated: number;
+    }>;
+    /**
+     * Search the vault with semantic search
+     */
+    search(query: string, opts?: RagSearchOptions): Promise<RagSearchResult[]>;
+    /**
+     * Reload/reindex the vault
+     */
+    reload(): Promise<{
+        indexed: number;
+        updated: number;
+    }>;
+    /**
+     * Get vault statistics
+     */
+    getStats(): Promise<{
+        indexed: boolean;
+        vaultPath: string;
+        indexPath: string;
+    }>;
+    /**
+     * Create MCP tool for search
+     */
+    createSearchTool(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                topK: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            query: string;
+            topK?: number;
+        }) => Promise<string>;
+    };
+    /**
+     * Create MCP tool for reload
+     */
+    createReloadTool(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<string>;
+    };
+}
+//# sourceMappingURL=rag-provider.d.ts.map

package/dist/knowledge/rag-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-provider.d.ts","sourceRoot":"","sources":["../../src/knowledge/rag-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,EAAE,MAAM;IAW7B,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAWjE;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4BpF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAK7D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAQF;;OAEG;IACH,gBAAgB;;;;;;;;;;;;;;;;;wBAkBc;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;IAiB9D;;OAEG;IACH,gBAAgB;;;;;;;;;;CAyBnB"}

package/dist/knowledge/rag-provider.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * RAG Provider for Curator-Codex
+ * Wraps ObsidianRAGProvider with semantic search capabilities
+ */
+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.CuratorRagProvider = void 0;
+const agent_enterprise_1 = require("@backendkit-labs/agent-enterprise");
+const path = __importStar(require("node:path"));
+class CuratorRagProvider {
+    rag;
+    vaultPath;
+    isIndexed = false;
+    constructor(vaultPath) {
+        this.vaultPath = vaultPath;
+        this.rag = new agent_enterprise_1.ObsidianRAGProvider({
+            vaultPath,
+            indexPath: this.getIndexPath(),
+            embedder: new agent_enterprise_1.SimpleEmbedder(),
+            topK: 5,
+            minScore: 0.1,
+        });
+    }
+    getIndexPath() {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        return path.join(homeDir, '.curator-codex', 'rag', `${path.basename(this.vaultPath)}.json`);
+    }
+    /**
+     * Index the vault (loads all notes and creates embeddings)
+     */
+    async indexVault() {
+        try {
+            const result = await this.rag.index({ verbose: false });
+            this.isIndexed = true;
+            return result;
+        }
+        catch (err) {
+            console.error('Failed to index vault:', err);
+            throw new Error(`RAG indexing failed: ${err.message}`);
+        }
+    }
+    /**
+     * Search the vault with semantic search
+     */
+    async search(query, opts = {}) {
+        if (!this.isIndexed) {
+            await this.indexVault();
+        }
+        try {
+            const results = await this.rag.search(query, {
+                topK: opts.topK || 5,
+                minScore: opts.minScore || 0.1,
+            });
+            if (!Array.isArray(results)) {
+                return [];
+            }
+            return results.map((r) => ({
+                title: r.title || 'Untitled',
+                content: r.content || r.text || '',
+                relevance: r.score || r.relevance || 0,
+                sourcePath: r.path || r.source || '',
+                sourceRef: r.sourceRef || undefined,
+            }));
+        }
+        catch (err) {
+            console.error('Search failed:', err);
+            throw new Error(`RAG search failed: ${err.message}`);
+        }
+    }
+    /**
+     * Reload/reindex the vault
+     */
+    async reload() {
+        this.isIndexed = false;
+        return await this.indexVault();
+    }
+    /**
+     * Get vault statistics
+     */
+    async getStats() {
+        return {
+            indexed: this.isIndexed,
+            vaultPath: this.vaultPath,
+            indexPath: this.getIndexPath(),
+        };
+    }
+    /**
+     * Create MCP tool for search
+     */
+    createSearchTool() {
+        return {
+            name: 'knowledge_search',
+            description: 'Search the vault using semantic search (RAG). Returns relevant notes based on your query.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query (natural language)',
+                    },
+                    topK: {
+                        type: 'number',
+                        description: 'Number of results to return (default: 5)',
+                    },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                try {
+                    const results = await this.search(args.query, { topK: args.topK });
+                    return JSON.stringify({
+                        query: args.query,
+                        results,
+                        count: results.length,
+                    });
+                }
+                catch (err) {
+                    return JSON.stringify({
+                        error: err.message,
+                    });
+                }
+            },
+        };
+    }
+    /**
+     * Create MCP tool for reload
+     */
+    createReloadTool() {
+        return {
+            name: 'knowledge_reload',
+            description: 'Reload and reindex the vault. Call this after external changes to the vault.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                try {
+                    const result = await this.reload();
+                    return JSON.stringify({
+                        success: true,
+                        indexed: result.indexed,
+                        updated: result.updated,
+                    });
+                }
+                catch (err) {
+                    return JSON.stringify({
+                        error: err.message,
+                    });
+                }
+            },
+        };
+    }
+}
+exports.CuratorRagProvider = CuratorRagProvider;
+//# sourceMappingURL=rag-provider.js.map

package/dist/knowledge/rag-provider.js.map

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

package/dist/knowledge/synthesis.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Knowledge Synthesis Engine
+ * Generates synthetic notes from search results and base notes
+ */
+import type { CuratorLLMProvider } from '../providers/types.js';
+import type { RagSearchResult } from './rag-provider.js';
+export interface SynthesizedNote {
+    title: string;
+    content: string;
+    basedOn: string[];
+    synthesisVersion: number;
+    generatedAt: string;
+}
+export declare class KnowledgeSynthesizer {
+    private provider;
+    private vaultPath;
+    constructor(provider: CuratorLLMProvider, vaultPath: string);
+    /**
+     * Generate a synthetic note from search results
+     */
+    synthesize(query: string, searchResults: RagSearchResult[]): Promise<SynthesizedNote | null>;
+    /**
+     * Save synthesized note to vault
+     */
+    saveNote(note: SynthesizedNote, domainFolder?: string): Promise<string | null>;
+}
+//# sourceMappingURL=synthesis.d.ts.map

package/dist/knowledge/synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.d.ts","sourceRoot":"","sources":["../../src/knowledge/synthesis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACvB;AAmBD,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM;IAK3D;;OAEG;IACG,UAAU,CACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,eAAe,EAAE,GACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAqClC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,YAAY,GAAE,MAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA+CpG"}

package/dist/knowledge/synthesis.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Knowledge Synthesis Engine
+ * Generates synthetic notes from search results and base notes
+ */
+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.KnowledgeSynthesizer = void 0;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const SYNTHESIS_PROMPT = `You are a knowledge synthesis expert.
+
+Given a search query and relevant documents from a vault, generate a comprehensive synthetic note that:
+1. Directly answers the query
+2. Integrates insights from multiple documents
+3. Adds clarifying context and practical examples
+4. Is self-contained (reader doesn't need originals)
+5. Uses markdown with ## headings
+
+Query: {query}
+
+Relevant Documents:
+{documents}
+
+Generate a markdown note that synthesizes these documents into a helpful guide.
+Return ONLY the markdown content, no frontmatter.`;
+class KnowledgeSynthesizer {
+    provider;
+    vaultPath;
+    constructor(provider, vaultPath) {
+        this.provider = provider;
+        this.vaultPath = vaultPath;
+    }
+    /**
+     * Generate a synthetic note from search results
+     */
+    async synthesize(query, searchResults) {
+        if (searchResults.length === 0) {
+            return null;
+        }
+        // Build prompt
+        const documentsText = searchResults
+            .map((r, i) => `## Document ${i + 1}: ${r.title}\n\n${r.content.slice(0, 1000)}`)
+            .join('\n\n---\n\n');
+        const prompt = SYNTHESIS_PROMPT.replace('{query}', query).replace('{documents}', documentsText);
+        try {
+            const synthesizedContent = await this.provider.complete('You are a knowledge synthesis expert. Generate high-quality markdown notes.', prompt);
+            return {
+                title: `${query} — Synthesis`,
+                content: synthesizedContent,
+                basedOn: searchResults.map(r => r.title),
+                synthesisVersion: 1,
+                generatedAt: new Date().toISOString(),
+            };
+        }
+        catch (err) {
+            console.error('Synthesis failed:', err);
+            return null;
+        }
+    }
+    /**
+     * Save synthesized note to vault
+     */
+    async saveNote(note, domainFolder = 'synthesis') {
+        try {
+            const dir = path.join(this.vaultPath, domainFolder);
+            await fs.mkdir(dir, { recursive: true });
+            // Create filename from title
+            const slug = note.title
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, '-')
+                .slice(0, 60);
+            const date = new Date().toISOString().slice(0, 10);
+            const filename = `${date}-${slug}-v${note.synthesisVersion}.md`;
+            const filePath = path.join(dir, filename);
+            // Check if exists
+            try {
+                await fs.access(filePath);
+                return null; // Already exists
+            }
+            catch {
+                // Doesn't exist, proceed
+            }
+            // Build frontmatter
+            const frontmatter = [
+                '---',
+                `title: "${note.title.replace(/"/g, '\\"')}"`,
+                'area: synthesis',
+                'tipo: synthesis',
+                `generated_by: knowledge-agent`,
+                `synthesis_version: ${note.synthesisVersion}`,
+                `based_on: [${note.basedOn.map(b => `"${b}"`).join(', ')}]`,
+                `date: ${new Date().toISOString().slice(0, 10)}`,
+                'author: "agent/codex"',
+                `tags: ["synthesis", "generated"]`,
+                '---',
+                '',
+                note.content,
+            ].join('\n');
+            await fs.writeFile(filePath, frontmatter, 'utf-8');
+            return filePath;
+        }
+        catch (err) {
+            console.error('Failed to save note:', err);
+            return null;
+        }
+    }
+}
+exports.KnowledgeSynthesizer = KnowledgeSynthesizer;
+//# sourceMappingURL=synthesis.js.map

package/dist/knowledge/synthesis.js.map

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

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

@@ -0,0 +1,14 @@
+import type { CuratorLLMProvider } from './types.js';
+export interface AnthropicAdapterOptions {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+}
+export declare class AnthropicAdapter implements CuratorLLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly maxTokens;
+    constructor(opts: AnthropicAdapterOptions);
+    complete(systemPrompt: string, userMessage: string): Promise<string>;
+}
+//# sourceMappingURL=anthropic-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,YAAW,kBAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,uBAAuB;IAMnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU7E"}