cencori 1.0.4 → 1.2.0

package/dist/tanstack/index.mjs

@@ -1,10 +1,22 @@
 // src/tanstack/index.ts
 var CENCORI_CHAT_MODELS = [
   // OpenAI
+  "gpt-5.5",
+  "gpt-5.4",
+  "gpt-5.4-pro",
+  "gpt-5.3-chat-latest",
+  "gpt-5.2",
+  "gpt-5.1",
+  "gpt-5",
+  "gpt-5-mini",
+  "gpt-5-nano",
+  "gpt-4.1",
   "gpt-4o",
   "gpt-4o-mini",
+  "o3-pro",
+  "o3",
+  "o4-mini",
   "o1",
-  "o1-mini",
   // Anthropic
   "claude-3-5-sonnet",
   "claude-3-opus",
@@ -14,6 +26,7 @@ var CENCORI_CHAT_MODELS = [
   "gemini-2.0-flash",
   "gemini-3-pro",
   // xAI
+  "grok-voice-think-fast",
   "grok-4",
   "grok-3",
   // Mistral

package/dist/tanstack/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tanstack/index.ts"],"sourcesContent":["/**\n * Cencori AI SDK - TanStack AI Integration\n * \n * @example\n * import { cencori } from 'cencori/tanstack';\n * import { chat } from '@tanstack/ai';\n * \n * const result = await chat({\n *   adapter: cencori('gpt-4o'),\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n * \n * @packageDocumentation\n */\n\nimport type {\n    TextAdapter,\n    TextOptions,\n    StreamChunk,\n    ContentStreamChunk,\n    DoneStreamChunk,\n    ErrorStreamChunk,\n    ToolCallStreamChunk,\n    Modality,\n    DefaultMessageMetadataByModality,\n} from '@tanstack/ai';\n\n// Re-export types for convenience\nexport type {\n    TextAdapter,\n    TextOptions,\n    StreamChunk,\n};\n\n/**\n * Cencori provider options\n */\nexport interface CencoriProviderOptions {\n    /** Cencori API key */\n    apiKey?: string;\n    /** Base URL for Cencori API (defaults to https://cencori.com) */\n    baseUrl?: string;\n    /** Custom headers */\n    headers?: Record<string, string>;\n}\n\n/**\n * Cencori model-specific options\n */\nexport interface CencoriModelOptions {\n    /** User ID for attribution */\n    userId?: string;\n}\n\n// All models supported through Cencori Gateway\nexport const CENCORI_CHAT_MODELS = [\n    // OpenAI\n    'gpt-4o',\n    'gpt-4o-mini',\n    'o1',\n    'o1-mini',\n    // Anthropic\n    'claude-3-5-sonnet',\n    'claude-3-opus',\n    'claude-3-haiku',\n    // Google\n    'gemini-2.5-flash',\n    'gemini-2.0-flash',\n    'gemini-3-pro',\n    // xAI\n    'grok-4',\n    'grok-3',\n    // Mistral\n    'mistral-large',\n    'codestral',\n    // DeepSeek\n    'deepseek-v3.2',\n    'deepseek-reasoner',\n    // Groq\n    'llama-3-70b',\n    'mixtral-8x7b',\n] as const;\n\nexport type CencoriChatModel = (typeof CENCORI_CHAT_MODELS)[number];\n\n/**\n * Cencori adapter for TanStack AI\n */\nclass CencoriTextAdapter implements TextAdapter<\n    CencoriChatModel,\n    CencoriModelOptions,\n    readonly ['text', 'image'],\n    DefaultMessageMetadataByModality\n> {\n    readonly kind = 'text' as const;\n    readonly name = 'cencori';\n    readonly model: CencoriChatModel;\n\n    '~types': {\n        providerOptions: CencoriModelOptions;\n        inputModalities: readonly ['text', 'image'];\n        messageMetadataByModality: DefaultMessageMetadataByModality;\n    } = {} as any;\n\n    private config: {\n        apiKey: string;\n        baseUrl: string;\n        headers?: Record<string, string>;\n    };\n    private providerOptions: CencoriProviderOptions;\n\n    constructor(model: CencoriChatModel, options: CencoriProviderOptions = {}) {\n        this.model = model;\n        this.providerOptions = options;\n\n        const apiKey = options.apiKey ?? process.env.CENCORI_API_KEY;\n        if (!apiKey) {\n            throw new Error(\n                'Cencori API key is required. Pass it via options.apiKey or set CENCORI_API_KEY environment variable.'\n            );\n        }\n\n        this.config = {\n            apiKey,\n            baseUrl: options.baseUrl ?? 'https://cencori.com',\n            headers: options.headers,\n        };\n    }\n\n    /**\n     * Stream chat completions from the model\n     */\n    async *chatStream(options: TextOptions<CencoriModelOptions>): AsyncIterable<StreamChunk> {\n        // Convert tools to Cencori format if present\n        const tools = options.tools ? Object.values(options.tools).map(t => ({\n            type: 'function' as const,\n            function: {\n                name: t.name,\n                description: t.description,\n                parameters: t.inputSchema || {},\n            },\n        })) : undefined;\n\n        const response = await fetch(`${this.config.baseUrl}/api/ai/chat`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'CENCORI_API_KEY': this.config.apiKey!,\n                ...this.config.headers,\n            },\n            body: JSON.stringify({\n                model: this.model,\n                messages: options.messages,\n                temperature: options.temperature,\n                maxTokens: options.maxTokens,\n                stream: true,\n                userId: options.modelOptions?.userId,\n                tools,\n            }),\n            signal: options.abortController?.signal,\n        });\n\n        if (!response.ok) {\n            const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n            const errorChunk: ErrorStreamChunk = {\n                type: 'error',\n                id: this.generateId(),\n                model: this.model,\n                timestamp: Date.now(),\n                error: {\n                    message: errorData.error || response.statusText,\n                    code: String(response.status),\n                },\n            };\n            yield errorChunk;\n            return;\n        }\n\n        const reader = response.body?.getReader();\n        if (!reader) {\n            throw new Error('Response body is null');\n        }\n\n        const decoder = new TextDecoder();\n        let buffer = '';\n        let content = '';\n        const promptTokens = 0;\n        let completionTokens = 0;\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                    // Emit done chunk\n                    const doneChunk: DoneStreamChunk = {\n                        type: 'done',\n                        id: this.generateId(),\n                        model: this.model,\n                        timestamp: Date.now(),\n                        finishReason: 'stop',\n                        usage: {\n                            promptTokens,\n                            completionTokens,\n                            totalTokens: promptTokens + completionTokens,\n                        },\n                    };\n                    yield doneChunk;\n                    return;\n                }\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                buffer = lines.pop() || '';\n\n                for (const line of lines) {\n                    if (line.trim() === '') continue;\n                    if (!line.startsWith('data: ')) continue;\n\n                    const data = line.slice(6);\n                    if (data === '[DONE]') {\n                        const doneChunk: DoneStreamChunk = {\n                            type: 'done',\n                            id: this.generateId(),\n                            model: this.model,\n                            timestamp: Date.now(),\n                            finishReason: 'stop',\n                            usage: {\n                                promptTokens,\n                                completionTokens,\n                                totalTokens: promptTokens + completionTokens,\n                            },\n                        };\n                        yield doneChunk;\n                        return;\n                    }\n\n                    try {\n                        const chunk = JSON.parse(data);\n\n                        if (chunk.delta) {\n                            content += chunk.delta;\n                            completionTokens += Math.ceil(chunk.delta.length / 4);\n\n                            const contentChunk: ContentStreamChunk = {\n                                type: 'content',\n                                id: this.generateId(),\n                                model: this.model,\n                                timestamp: Date.now(),\n                                delta: chunk.delta,\n                                content: content,\n                                role: 'assistant',\n                            };\n                            yield contentChunk;\n                        }\n\n                        // Handle tool calls\n                        if (chunk.tool_calls && chunk.tool_calls.length > 0) {\n                            for (const tc of chunk.tool_calls) {\n                                const toolCallChunk: ToolCallStreamChunk = {\n                                    type: 'tool_call',\n                                    id: this.generateId(),\n                                    model: this.model,\n                                    timestamp: Date.now(),\n                                    toolCall: {\n                                        id: tc.id,\n                                        type: 'function',\n                                        function: {\n                                            name: tc.function.name,\n                                            arguments: tc.function.arguments,\n                                        },\n                                    },\n                                    index: 0,\n                                };\n                                yield toolCallChunk;\n                            }\n                        }\n\n                        if (chunk.finish_reason) {\n                            const doneChunk: DoneStreamChunk = {\n                                type: 'done',\n                                id: this.generateId(),\n                                model: this.model,\n                                timestamp: Date.now(),\n                                finishReason: chunk.finish_reason === 'tool_calls' ? 'tool_calls'\n                                    : chunk.finish_reason === 'stop' ? 'stop' : null,\n                                usage: {\n                                    promptTokens,\n                                    completionTokens,\n                                    totalTokens: promptTokens + completionTokens,\n                                },\n                            };\n                            yield doneChunk;\n                            return;\n                        }\n                    } catch {\n                        // Skip malformed JSON\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Generate structured output\n     */\n    async structuredOutput(options: {\n        chatOptions: TextOptions<CencoriModelOptions>;\n        outputSchema: any;\n    }): Promise<{ data: unknown; rawText: string }> {\n        const response = await fetch(`${this.config.baseUrl}/api/ai/chat`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'CENCORI_API_KEY': this.config.apiKey!,\n                ...this.config.headers,\n            },\n            body: JSON.stringify({\n                model: this.model,\n                messages: options.chatOptions.messages,\n                temperature: options.chatOptions.temperature,\n                maxTokens: options.chatOptions.maxTokens,\n                stream: false,\n                responseFormat: {\n                    type: 'json_schema',\n                    json_schema: {\n                        name: 'structured_output',\n                        schema: options.outputSchema,\n                        strict: true,\n                    },\n                },\n            }),\n        });\n\n        if (!response.ok) {\n            const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n            throw new Error(`Cencori API error: ${errorData.error || response.statusText}`);\n        }\n\n        const result = await response.json() as { content: string };\n        const rawText = result.content;\n\n        try {\n            const data = JSON.parse(rawText);\n            return { data, rawText };\n        } catch {\n            throw new Error(`Failed to parse structured output: ${rawText}`);\n        }\n    }\n\n    private generateId(): string {\n        return `cencori-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n    }\n}\n\n/**\n * Create a Cencori adapter for TanStack AI\n * \n * @example\n * import { createCencori } from 'cencori/tanstack';\n * \n * const myProvider = createCencori({ apiKey: 'csk_...' });\n * const adapter = myProvider('gpt-4o');\n */\nexport function createCencori(options: CencoriProviderOptions = {}) {\n    return function cencoriProvider<T extends CencoriChatModel>(model: T) {\n        return new CencoriTextAdapter(model, options);\n    };\n}\n\n/**\n * Default Cencori provider\n * Uses CENCORI_API_KEY environment variable\n * \n * @example\n * import { cencori } from 'cencori/tanstack';\n * import { chat } from '@tanstack/ai';\n * \n * const result = await chat({\n *   adapter: cencori('gpt-4o'),\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n */\nexport function cencori<T extends CencoriChatModel>(model: T) {\n    return new CencoriTextAdapter(model, {});\n}\n\n// Export adapter class for advanced use cases\nexport { CencoriTextAdapter };\n"],"mappings":";AAuDO,IAAM,sBAAsB;AAAA;AAAA,EAE/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AACJ;AAOA,IAAM,qBAAN,MAKE;AAAA,EAkBE,YAAY,OAAyB,UAAkC,CAAC,GAAG;AAjB3E,SAAS,OAAO;AAChB,SAAS,OAAO;AAGhB,qBAII,CAAC;AAUD,SAAK,QAAQ;AACb,SAAK,kBAAkB;AAEvB,UAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAC7C,QAAI,CAAC,QAAQ;AACT,YAAM,IAAI;AAAA,QACN;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,SAAS;AAAA,MACV;AAAA,MACA,SAAS,QAAQ,WAAW;AAAA,MAC5B,SAAS,QAAQ;AAAA,IACrB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,WAAW,SAAuE;AAErF,UAAM,QAAQ,QAAQ,QAAQ,OAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,QAAM;AAAA,MACjE,MAAM;AAAA,MACN,UAAU;AAAA,QACN,MAAM,EAAE;AAAA,QACR,aAAa,EAAE;AAAA,QACf,YAAY,EAAE,eAAe,CAAC;AAAA,MAClC;AAAA,IACJ,EAAE,IAAI;AAEN,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,OAAO,gBAAgB;AAAA,MAC/D,QAAQ;AAAA,MACR,SAAS;AAAA,QACL,gBAAgB;AAAA,QAChB,mBAAmB,KAAK,OAAO;AAAA,QAC/B,GAAG,KAAK,OAAO;AAAA,MACnB;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACjB,OAAO,KAAK;AAAA,QACZ,UAAU,QAAQ;AAAA,QAClB,aAAa,QAAQ;AAAA,QACrB,WAAW,QAAQ;AAAA,QACnB,QAAQ;AAAA,QACR,QAAQ,QAAQ,cAAc;AAAA,QAC9B;AAAA,MACJ,CAAC;AAAA,MACD,QAAQ,QAAQ,iBAAiB;AAAA,IACrC,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,EAAE,OAAO,gBAAgB,EAAE;AAChF,YAAM,aAA+B;AAAA,QACjC,MAAM;AAAA,QACN,IAAI,KAAK,WAAW;AAAA,QACpB,OAAO,KAAK;AAAA,QACZ,WAAW,KAAK,IAAI;AAAA,QACpB,OAAO;AAAA,UACH,SAAS,UAAU,SAAS,SAAS;AAAA,UACrC,MAAM,OAAO,SAAS,MAAM;AAAA,QAChC;AAAA,MACJ;AACA,YAAM;AACN;AAAA,IACJ;AAEA,UAAM,SAAS,SAAS,MAAM,UAAU;AACxC,QAAI,CAAC,QAAQ;AACT,YAAM,IAAI,MAAM,uBAAuB;AAAA,IAC3C;AAEA,UAAM,UAAU,IAAI,YAAY;AAChC,QAAI,SAAS;AACb,QAAI,UAAU;AACd,UAAM,eAAe;AACrB,QAAI,mBAAmB;AAEvB,QAAI;AACA,aAAO,MAAM;AACT,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAE1C,YAAI,MAAM;AAEN,gBAAM,YAA6B;AAAA,YAC/B,MAAM;AAAA,YACN,IAAI,KAAK,WAAW;AAAA,YACpB,OAAO,KAAK;AAAA,YACZ,WAAW,KAAK,IAAI;AAAA,YACpB,cAAc;AAAA,YACd,OAAO;AAAA,cACH;AAAA,cACA;AAAA,cACA,aAAa,eAAe;AAAA,YAChC;AAAA,UACJ;AACA,gBAAM;AACN;AAAA,QACJ;AAEA,kBAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAChD,cAAM,QAAQ,OAAO,MAAM,IAAI;AAC/B,iBAAS,MAAM,IAAI,KAAK;AAExB,mBAAW,QAAQ,OAAO;AACtB,cAAI,KAAK,KAAK,MAAM,GAAI;AACxB,cAAI,CAAC,KAAK,WAAW,QAAQ,EAAG;AAEhC,gBAAM,OAAO,KAAK,MAAM,CAAC;AACzB,cAAI,SAAS,UAAU;AACnB,kBAAM,YAA6B;AAAA,cAC/B,MAAM;AAAA,cACN,IAAI,KAAK,WAAW;AAAA,cACpB,OAAO,KAAK;AAAA,cACZ,WAAW,KAAK,IAAI;AAAA,cACpB,cAAc;AAAA,cACd,OAAO;AAAA,gBACH;AAAA,gBACA;AAAA,gBACA,aAAa,eAAe;AAAA,cAChC;AAAA,YACJ;AACA,kBAAM;AACN;AAAA,UACJ;AAEA,cAAI;AACA,kBAAM,QAAQ,KAAK,MAAM,IAAI;AAE7B,gBAAI,MAAM,OAAO;AACb,yBAAW,MAAM;AACjB,kCAAoB,KAAK,KAAK,MAAM,MAAM,SAAS,CAAC;AAEpD,oBAAM,eAAmC;AAAA,gBACrC,MAAM;AAAA,gBACN,IAAI,KAAK,WAAW;AAAA,gBACpB,OAAO,KAAK;AAAA,gBACZ,WAAW,KAAK,IAAI;AAAA,gBACpB,OAAO,MAAM;AAAA,gBACb;AAAA,gBACA,MAAM;AAAA,cACV;AACA,oBAAM;AAAA,YACV;AAGA,gBAAI,MAAM,cAAc,MAAM,WAAW,SAAS,GAAG;AACjD,yBAAW,MAAM,MAAM,YAAY;AAC/B,sBAAM,gBAAqC;AAAA,kBACvC,MAAM;AAAA,kBACN,IAAI,KAAK,WAAW;AAAA,kBACpB,OAAO,KAAK;AAAA,kBACZ,WAAW,KAAK,IAAI;AAAA,kBACpB,UAAU;AAAA,oBACN,IAAI,GAAG;AAAA,oBACP,MAAM;AAAA,oBACN,UAAU;AAAA,sBACN,MAAM,GAAG,SAAS;AAAA,sBAClB,WAAW,GAAG,SAAS;AAAA,oBAC3B;AAAA,kBACJ;AAAA,kBACA,OAAO;AAAA,gBACX;AACA,sBAAM;AAAA,cACV;AAAA,YACJ;AAEA,gBAAI,MAAM,eAAe;AACrB,oBAAM,YAA6B;AAAA,gBAC/B,MAAM;AAAA,gBACN,IAAI,KAAK,WAAW;AAAA,gBACpB,OAAO,KAAK;AAAA,gBACZ,WAAW,KAAK,IAAI;AAAA,gBACpB,cAAc,MAAM,kBAAkB,eAAe,eAC/C,MAAM,kBAAkB,SAAS,SAAS;AAAA,gBAChD,OAAO;AAAA,kBACH;AAAA,kBACA;AAAA,kBACA,aAAa,eAAe;AAAA,gBAChC;AAAA,cACJ;AACA,oBAAM;AACN;AAAA,YACJ;AAAA,UACJ,QAAQ;AAAA,UAER;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,UAAE;AACE,aAAO,YAAY;AAAA,IACvB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAiB,SAGyB;AAC5C,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,OAAO,gBAAgB;AAAA,MAC/D,QAAQ;AAAA,MACR,SAAS;AAAA,QACL,gBAAgB;AAAA,QAChB,mBAAmB,KAAK,OAAO;AAAA,QAC/B,GAAG,KAAK,OAAO;AAAA,MACnB;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACjB,OAAO,KAAK;AAAA,QACZ,UAAU,QAAQ,YAAY;AAAA,QAC9B,aAAa,QAAQ,YAAY;AAAA,QACjC,WAAW,QAAQ,YAAY;AAAA,QAC/B,QAAQ;AAAA,QACR,gBAAgB;AAAA,UACZ,MAAM;AAAA,UACN,aAAa;AAAA,YACT,MAAM;AAAA,YACN,QAAQ,QAAQ;AAAA,YAChB,QAAQ;AAAA,UACZ;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,EAAE,OAAO,gBAAgB,EAAE;AAChF,YAAM,IAAI,MAAM,sBAAsB,UAAU,SAAS,SAAS,UAAU,EAAE;AAAA,IAClF;AAEA,UAAM,SAAS,MAAM,SAAS,KAAK;AACnC,UAAM,UAAU,OAAO;AAEvB,QAAI;AACA,YAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,aAAO,EAAE,MAAM,QAAQ;AAAA,IAC3B,QAAQ;AACJ,YAAM,IAAI,MAAM,sCAAsC,OAAO,EAAE;AAAA,IACnE;AAAA,EACJ;AAAA,EAEQ,aAAqB;AACzB,WAAO,WAAW,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC;AAAA,EAC3E;AACJ;AAWO,SAAS,cAAc,UAAkC,CAAC,GAAG;AAChE,SAAO,SAAS,gBAA4C,OAAU;AAClE,WAAO,IAAI,mBAAmB,OAAO,OAAO;AAAA,EAChD;AACJ;AAeO,SAAS,QAAoC,OAAU;AAC1D,SAAO,IAAI,mBAAmB,OAAO,CAAC,CAAC;AAC3C;","names":[]}
+{"version":3,"sources":["../../src/tanstack/index.ts"],"sourcesContent":["/**\n * Cencori AI SDK - TanStack AI Integration\n * \n * @example\n * import { cencori } from 'cencori/tanstack';\n * import { chat } from '@tanstack/ai';\n * \n * const result = await chat({\n *   adapter: cencori('gpt-4o'),\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n * \n * @packageDocumentation\n */\n\nimport type {\n    TextAdapter,\n    TextOptions,\n    StreamChunk,\n    ContentStreamChunk,\n    DoneStreamChunk,\n    ErrorStreamChunk,\n    ToolCallStreamChunk,\n    Modality,\n    DefaultMessageMetadataByModality,\n} from '@tanstack/ai';\n\n// Re-export types for convenience\nexport type {\n    TextAdapter,\n    TextOptions,\n    StreamChunk,\n};\n\n/**\n * Cencori provider options\n */\nexport interface CencoriProviderOptions {\n    /** Cencori API key */\n    apiKey?: string;\n    /** Base URL for Cencori API (defaults to https://cencori.com) */\n    baseUrl?: string;\n    /** Custom headers */\n    headers?: Record<string, string>;\n}\n\n/**\n * Cencori model-specific options\n */\nexport interface CencoriModelOptions {\n    /** User ID for attribution */\n    userId?: string;\n}\n\n// All models supported through Cencori Gateway\nexport const CENCORI_CHAT_MODELS = [\n    // OpenAI\n    'gpt-5.5',\n    'gpt-5.4',\n    'gpt-5.4-pro',\n    'gpt-5.3-chat-latest',\n    'gpt-5.2',\n    'gpt-5.1',\n    'gpt-5',\n    'gpt-5-mini',\n    'gpt-5-nano',\n    'gpt-4.1',\n    'gpt-4o',\n    'gpt-4o-mini',\n    'o3-pro',\n    'o3',\n    'o4-mini',\n    'o1',\n    // Anthropic\n    'claude-3-5-sonnet',\n    'claude-3-opus',\n    'claude-3-haiku',\n    // Google\n    'gemini-2.5-flash',\n    'gemini-2.0-flash',\n    'gemini-3-pro',\n    // xAI\n    'grok-voice-think-fast',\n    'grok-4',\n    'grok-3',\n    // Mistral\n    'mistral-large',\n    'codestral',\n    // DeepSeek\n    'deepseek-v3.2',\n    'deepseek-reasoner',\n    // Groq\n    'llama-3-70b',\n    'mixtral-8x7b',\n] as const;\n\nexport type CencoriChatModel = (typeof CENCORI_CHAT_MODELS)[number];\n\n/**\n * Cencori adapter for TanStack AI\n */\nclass CencoriTextAdapter implements TextAdapter<\n    CencoriChatModel,\n    CencoriModelOptions,\n    readonly ['text', 'image'],\n    DefaultMessageMetadataByModality\n> {\n    readonly kind = 'text' as const;\n    readonly name = 'cencori';\n    readonly model: CencoriChatModel;\n\n    '~types': {\n        providerOptions: CencoriModelOptions;\n        inputModalities: readonly ['text', 'image'];\n        messageMetadataByModality: DefaultMessageMetadataByModality;\n    } = {} as any;\n\n    private config: {\n        apiKey: string;\n        baseUrl: string;\n        headers?: Record<string, string>;\n    };\n    private providerOptions: CencoriProviderOptions;\n\n    constructor(model: CencoriChatModel, options: CencoriProviderOptions = {}) {\n        this.model = model;\n        this.providerOptions = options;\n\n        const apiKey = options.apiKey ?? process.env.CENCORI_API_KEY;\n        if (!apiKey) {\n            throw new Error(\n                'Cencori API key is required. Pass it via options.apiKey or set CENCORI_API_KEY environment variable.'\n            );\n        }\n\n        this.config = {\n            apiKey,\n            baseUrl: options.baseUrl ?? 'https://cencori.com',\n            headers: options.headers,\n        };\n    }\n\n    /**\n     * Stream chat completions from the model\n     */\n    async *chatStream(options: TextOptions<CencoriModelOptions>): AsyncIterable<StreamChunk> {\n        // Convert tools to Cencori format if present\n        const tools = options.tools ? Object.values(options.tools).map(t => ({\n            type: 'function' as const,\n            function: {\n                name: t.name,\n                description: t.description,\n                parameters: t.inputSchema || {},\n            },\n        })) : undefined;\n\n        const response = await fetch(`${this.config.baseUrl}/api/ai/chat`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'CENCORI_API_KEY': this.config.apiKey!,\n                ...this.config.headers,\n            },\n            body: JSON.stringify({\n                model: this.model,\n                messages: options.messages,\n                temperature: options.temperature,\n                maxTokens: options.maxTokens,\n                stream: true,\n                userId: options.modelOptions?.userId,\n                tools,\n            }),\n            signal: options.abortController?.signal,\n        });\n\n        if (!response.ok) {\n            const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n            const errorChunk: ErrorStreamChunk = {\n                type: 'error',\n                id: this.generateId(),\n                model: this.model,\n                timestamp: Date.now(),\n                error: {\n                    message: errorData.error || response.statusText,\n                    code: String(response.status),\n                },\n            };\n            yield errorChunk;\n            return;\n        }\n\n        const reader = response.body?.getReader();\n        if (!reader) {\n            throw new Error('Response body is null');\n        }\n\n        const decoder = new TextDecoder();\n        let buffer = '';\n        let content = '';\n        const promptTokens = 0;\n        let completionTokens = 0;\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                    // Emit done chunk\n                    const doneChunk: DoneStreamChunk = {\n                        type: 'done',\n                        id: this.generateId(),\n                        model: this.model,\n                        timestamp: Date.now(),\n                        finishReason: 'stop',\n                        usage: {\n                            promptTokens,\n                            completionTokens,\n                            totalTokens: promptTokens + completionTokens,\n                        },\n                    };\n                    yield doneChunk;\n                    return;\n                }\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                buffer = lines.pop() || '';\n\n                for (const line of lines) {\n                    if (line.trim() === '') continue;\n                    if (!line.startsWith('data: ')) continue;\n\n                    const data = line.slice(6);\n                    if (data === '[DONE]') {\n                        const doneChunk: DoneStreamChunk = {\n                            type: 'done',\n                            id: this.generateId(),\n                            model: this.model,\n                            timestamp: Date.now(),\n                            finishReason: 'stop',\n                            usage: {\n                                promptTokens,\n                                completionTokens,\n                                totalTokens: promptTokens + completionTokens,\n                            },\n                        };\n                        yield doneChunk;\n                        return;\n                    }\n\n                    try {\n                        const chunk = JSON.parse(data);\n\n                        if (chunk.delta) {\n                            content += chunk.delta;\n                            completionTokens += Math.ceil(chunk.delta.length / 4);\n\n                            const contentChunk: ContentStreamChunk = {\n                                type: 'content',\n                                id: this.generateId(),\n                                model: this.model,\n                                timestamp: Date.now(),\n                                delta: chunk.delta,\n                                content: content,\n                                role: 'assistant',\n                            };\n                            yield contentChunk;\n                        }\n\n                        // Handle tool calls\n                        if (chunk.tool_calls && chunk.tool_calls.length > 0) {\n                            for (const tc of chunk.tool_calls) {\n                                const toolCallChunk: ToolCallStreamChunk = {\n                                    type: 'tool_call',\n                                    id: this.generateId(),\n                                    model: this.model,\n                                    timestamp: Date.now(),\n                                    toolCall: {\n                                        id: tc.id,\n                                        type: 'function',\n                                        function: {\n                                            name: tc.function.name,\n                                            arguments: tc.function.arguments,\n                                        },\n                                    },\n                                    index: 0,\n                                };\n                                yield toolCallChunk;\n                            }\n                        }\n\n                        if (chunk.finish_reason) {\n                            const doneChunk: DoneStreamChunk = {\n                                type: 'done',\n                                id: this.generateId(),\n                                model: this.model,\n                                timestamp: Date.now(),\n                                finishReason: chunk.finish_reason === 'tool_calls' ? 'tool_calls'\n                                    : chunk.finish_reason === 'stop' ? 'stop' : null,\n                                usage: {\n                                    promptTokens,\n                                    completionTokens,\n                                    totalTokens: promptTokens + completionTokens,\n                                },\n                            };\n                            yield doneChunk;\n                            return;\n                        }\n                    } catch {\n                        // Skip malformed JSON\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Generate structured output\n     */\n    async structuredOutput(options: {\n        chatOptions: TextOptions<CencoriModelOptions>;\n        outputSchema: any;\n    }): Promise<{ data: unknown; rawText: string }> {\n        const response = await fetch(`${this.config.baseUrl}/api/ai/chat`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'CENCORI_API_KEY': this.config.apiKey!,\n                ...this.config.headers,\n            },\n            body: JSON.stringify({\n                model: this.model,\n                messages: options.chatOptions.messages,\n                temperature: options.chatOptions.temperature,\n                maxTokens: options.chatOptions.maxTokens,\n                stream: false,\n                responseFormat: {\n                    type: 'json_schema',\n                    json_schema: {\n                        name: 'structured_output',\n                        schema: options.outputSchema,\n                        strict: true,\n                    },\n                },\n            }),\n        });\n\n        if (!response.ok) {\n            const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n            throw new Error(`Cencori API error: ${errorData.error || response.statusText}`);\n        }\n\n        const result = await response.json() as { content: string };\n        const rawText = result.content;\n\n        try {\n            const data = JSON.parse(rawText);\n            return { data, rawText };\n        } catch {\n            throw new Error(`Failed to parse structured output: ${rawText}`);\n        }\n    }\n\n    private generateId(): string {\n        return `cencori-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n    }\n}\n\n/**\n * Create a Cencori adapter for TanStack AI\n * \n * @example\n * import { createCencori } from 'cencori/tanstack';\n * \n * const myProvider = createCencori({ apiKey: 'csk_...' });\n * const adapter = myProvider('gpt-4o');\n */\nexport function createCencori(options: CencoriProviderOptions = {}) {\n    return function cencoriProvider<T extends CencoriChatModel>(model: T) {\n        return new CencoriTextAdapter(model, options);\n    };\n}\n\n/**\n * Default Cencori provider\n * Uses CENCORI_API_KEY environment variable\n * \n * @example\n * import { cencori } from 'cencori/tanstack';\n * import { chat } from '@tanstack/ai';\n * \n * const result = await chat({\n *   adapter: cencori('gpt-4o'),\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n */\nexport function cencori<T extends CencoriChatModel>(model: T) {\n    return new CencoriTextAdapter(model, {});\n}\n\n// Export adapter class for advanced use cases\nexport { CencoriTextAdapter };\n"],"mappings":"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","names":[]}

package/dist/telemetry/index.d.mts

@@ -0,0 +1,73 @@
+import { C as CencoriConfig } from '../types-Cr0muEt3.mjs';
+
+/**
+ * Cencori Telemetry Client
+ *
+ * Report web traffic from your application to the Cencori dashboard.
+ * Logs appear under the project's "Web Gateway" tab with your app's
+ * real domain as the host.
+ *
+ * @example
+ * const cencori = new Cencori({ apiKey: 'csk_...' });
+ *
+ * // In your server middleware / API route handler:
+ * await cencori.telemetry.reportWebRequest({
+ *   host: 'dochat-zeta.vercel.app',
+ *   method: 'GET',
+ *   path: '/api/chat',
+ *   statusCode: 200,
+ * });
+ */
+
+interface WebTelemetryPayload {
+    /** The hostname of your application, e.g. "dochat-zeta.vercel.app" */
+    host: string;
+    /** HTTP method: GET, POST, PUT, DELETE, etc. */
+    method: string;
+    /** Request path, e.g. "/api/chat" */
+    path: string;
+    /** HTTP status code returned */
+    statusCode: number;
+    /** Optional unique request ID for tracing */
+    requestId?: string;
+    /** Query string without the leading "?" */
+    queryString?: string;
+    /** Human-readable log message */
+    message?: string;
+    /** Client User-Agent string */
+    userAgent?: string;
+    /** Referer header value */
+    referer?: string;
+    /** Client IP address */
+    ipAddress?: string;
+    /** ISO 3166-1 alpha-2 country code */
+    countryCode?: string;
+    /** Request latency in milliseconds */
+    latencyMs?: number;
+}
+declare class TelemetryClient {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /**
+     * Report a web request to the Cencori dashboard.
+     *
+     * Fire-and-forget — this method never throws and never blocks
+     * your application. If the request fails, the error is silently
+     * swallowed so it cannot disrupt your app's critical path.
+     *
+     * @param payload - Web request details to log
+     *
+     * @example
+     * await cencori.telemetry.reportWebRequest({
+     *   host: req.headers.get('host') || 'unknown',
+     *   method: req.method,
+     *   path: new URL(req.url).pathname,
+     *   statusCode: response.status,
+     *   userAgent: req.headers.get('user-agent') || undefined,
+     *   latencyMs: Date.now() - startTime,
+     * });
+     */
+    reportWebRequest(payload: WebTelemetryPayload): Promise<void>;
+}
+
+export { TelemetryClient, type WebTelemetryPayload };

package/dist/telemetry/index.d.ts

@@ -0,0 +1,73 @@
+import { C as CencoriConfig } from '../types-Cr0muEt3.js';
+
+/**
+ * Cencori Telemetry Client
+ *
+ * Report web traffic from your application to the Cencori dashboard.
+ * Logs appear under the project's "Web Gateway" tab with your app's
+ * real domain as the host.
+ *
+ * @example
+ * const cencori = new Cencori({ apiKey: 'csk_...' });
+ *
+ * // In your server middleware / API route handler:
+ * await cencori.telemetry.reportWebRequest({
+ *   host: 'dochat-zeta.vercel.app',
+ *   method: 'GET',
+ *   path: '/api/chat',
+ *   statusCode: 200,
+ * });
+ */
+
+interface WebTelemetryPayload {
+    /** The hostname of your application, e.g. "dochat-zeta.vercel.app" */
+    host: string;
+    /** HTTP method: GET, POST, PUT, DELETE, etc. */
+    method: string;
+    /** Request path, e.g. "/api/chat" */
+    path: string;
+    /** HTTP status code returned */
+    statusCode: number;
+    /** Optional unique request ID for tracing */
+    requestId?: string;
+    /** Query string without the leading "?" */
+    queryString?: string;
+    /** Human-readable log message */
+    message?: string;
+    /** Client User-Agent string */
+    userAgent?: string;
+    /** Referer header value */
+    referer?: string;
+    /** Client IP address */
+    ipAddress?: string;
+    /** ISO 3166-1 alpha-2 country code */
+    countryCode?: string;
+    /** Request latency in milliseconds */
+    latencyMs?: number;
+}
+declare class TelemetryClient {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /**
+     * Report a web request to the Cencori dashboard.
+     *
+     * Fire-and-forget — this method never throws and never blocks
+     * your application. If the request fails, the error is silently
+     * swallowed so it cannot disrupt your app's critical path.
+     *
+     * @param payload - Web request details to log
+     *
+     * @example
+     * await cencori.telemetry.reportWebRequest({
+     *   host: req.headers.get('host') || 'unknown',
+     *   method: req.method,
+     *   path: new URL(req.url).pathname,
+     *   statusCode: response.status,
+     *   userAgent: req.headers.get('user-agent') || undefined,
+     *   latencyMs: Date.now() - startTime,
+     * });
+     */
+    reportWebRequest(payload: WebTelemetryPayload): Promise<void>;
+}
+
+export { TelemetryClient, type WebTelemetryPayload };

package/dist/telemetry/index.js

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/telemetry/index.ts
+var telemetry_exports = {};
+__export(telemetry_exports, {
+  TelemetryClient: () => TelemetryClient
+});
+module.exports = __toCommonJS(telemetry_exports);
+var TelemetryClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Report a web request to the Cencori dashboard.
+   *
+   * Fire-and-forget — this method never throws and never blocks
+   * your application. If the request fails, the error is silently
+   * swallowed so it cannot disrupt your app's critical path.
+   *
+   * @param payload - Web request details to log
+   *
+   * @example
+   * await cencori.telemetry.reportWebRequest({
+   *   host: req.headers.get('host') || 'unknown',
+   *   method: req.method,
+   *   path: new URL(req.url).pathname,
+   *   statusCode: response.status,
+   *   userAgent: req.headers.get('user-agent') || undefined,
+   *   latencyMs: Date.now() - startTime,
+   * });
+   */
+  async reportWebRequest(payload) {
+    try {
+      const url = `${this.config.baseUrl}/api/v1/telemetry/web`;
+      await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "CENCORI_API_KEY": this.config.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+    } catch {
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TelemetryClient
+});
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/index.ts"],"sourcesContent":["/**\n * Cencori Telemetry Client\n *\n * Report web traffic from your application to the Cencori dashboard.\n * Logs appear under the project's \"Web Gateway\" tab with your app's\n * real domain as the host.\n *\n * @example\n * const cencori = new Cencori({ apiKey: 'csk_...' });\n *\n * // In your server middleware / API route handler:\n * await cencori.telemetry.reportWebRequest({\n *   host: 'dochat-zeta.vercel.app',\n *   method: 'GET',\n *   path: '/api/chat',\n *   statusCode: 200,\n * });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport interface WebTelemetryPayload {\n    /** The hostname of your application, e.g. \"dochat-zeta.vercel.app\" */\n    host: string;\n    /** HTTP method: GET, POST, PUT, DELETE, etc. */\n    method: string;\n    /** Request path, e.g. \"/api/chat\" */\n    path: string;\n    /** HTTP status code returned */\n    statusCode: number;\n\n    /** Optional unique request ID for tracing */\n    requestId?: string;\n    /** Query string without the leading \"?\" */\n    queryString?: string;\n    /** Human-readable log message */\n    message?: string;\n    /** Client User-Agent string */\n    userAgent?: string;\n    /** Referer header value */\n    referer?: string;\n    /** Client IP address */\n    ipAddress?: string;\n    /** ISO 3166-1 alpha-2 country code */\n    countryCode?: string;\n    /** Request latency in milliseconds */\n    latencyMs?: number;\n}\n\nexport class TelemetryClient {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /**\n     * Report a web request to the Cencori dashboard.\n     *\n     * Fire-and-forget — this method never throws and never blocks\n     * your application. If the request fails, the error is silently\n     * swallowed so it cannot disrupt your app's critical path.\n     *\n     * @param payload - Web request details to log\n     *\n     * @example\n     * await cencori.telemetry.reportWebRequest({\n     *   host: req.headers.get('host') || 'unknown',\n     *   method: req.method,\n     *   path: new URL(req.url).pathname,\n     *   statusCode: response.status,\n     *   userAgent: req.headers.get('user-agent') || undefined,\n     *   latencyMs: Date.now() - startTime,\n     * });\n     */\n    async reportWebRequest(payload: WebTelemetryPayload): Promise<void> {\n        try {\n            const url = `${this.config.baseUrl}/api/v1/telemetry/web`;\n\n            await fetch(url, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    'CENCORI_API_KEY': this.config.apiKey,\n                },\n                body: JSON.stringify(payload),\n            });\n        } catch {\n            // Telemetry is best-effort — never disrupt the customer's app.\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiDO,IAAM,kBAAN,MAAsB;AAAA,EAGzB,YAAY,QAAiC;AACzC,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAM,iBAAiB,SAA6C;AAChE,QAAI;AACA,YAAM,MAAM,GAAG,KAAK,OAAO,OAAO;AAElC,YAAM,MAAM,KAAK;AAAA,QACb,QAAQ;AAAA,QACR,SAAS;AAAA,UACL,gBAAgB;AAAA,UAChB,mBAAmB,KAAK,OAAO;AAAA,QACnC;AAAA,QACA,MAAM,KAAK,UAAU,OAAO;AAAA,MAChC,CAAC;AAAA,IACL,QAAQ;AAAA,IAER;AAAA,EACJ;AACJ;","names":[]}

package/dist/telemetry/index.mjs

@@ -0,0 +1,43 @@
+// src/telemetry/index.ts
+var TelemetryClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Report a web request to the Cencori dashboard.
+   *
+   * Fire-and-forget — this method never throws and never blocks
+   * your application. If the request fails, the error is silently
+   * swallowed so it cannot disrupt your app's critical path.
+   *
+   * @param payload - Web request details to log
+   *
+   * @example
+   * await cencori.telemetry.reportWebRequest({
+   *   host: req.headers.get('host') || 'unknown',
+   *   method: req.method,
+   *   path: new URL(req.url).pathname,
+   *   statusCode: response.status,
+   *   userAgent: req.headers.get('user-agent') || undefined,
+   *   latencyMs: Date.now() - startTime,
+   * });
+   */
+  async reportWebRequest(payload) {
+    try {
+      const url = `${this.config.baseUrl}/api/v1/telemetry/web`;
+      await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "CENCORI_API_KEY": this.config.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+    } catch {
+    }
+  }
+};
+export {
+  TelemetryClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/telemetry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/index.ts"],"sourcesContent":["/**\n * Cencori Telemetry Client\n *\n * Report web traffic from your application to the Cencori dashboard.\n * Logs appear under the project's \"Web Gateway\" tab with your app's\n * real domain as the host.\n *\n * @example\n * const cencori = new Cencori({ apiKey: 'csk_...' });\n *\n * // In your server middleware / API route handler:\n * await cencori.telemetry.reportWebRequest({\n *   host: 'dochat-zeta.vercel.app',\n *   method: 'GET',\n *   path: '/api/chat',\n *   statusCode: 200,\n * });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport interface WebTelemetryPayload {\n    /** The hostname of your application, e.g. \"dochat-zeta.vercel.app\" */\n    host: string;\n    /** HTTP method: GET, POST, PUT, DELETE, etc. */\n    method: string;\n    /** Request path, e.g. \"/api/chat\" */\n    path: string;\n    /** HTTP status code returned */\n    statusCode: number;\n\n    /** Optional unique request ID for tracing */\n    requestId?: string;\n    /** Query string without the leading \"?\" */\n    queryString?: string;\n    /** Human-readable log message */\n    message?: string;\n    /** Client User-Agent string */\n    userAgent?: string;\n    /** Referer header value */\n    referer?: string;\n    /** Client IP address */\n    ipAddress?: string;\n    /** ISO 3166-1 alpha-2 country code */\n    countryCode?: string;\n    /** Request latency in milliseconds */\n    latencyMs?: number;\n}\n\nexport class TelemetryClient {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /**\n     * Report a web request to the Cencori dashboard.\n     *\n     * Fire-and-forget — this method never throws and never blocks\n     * your application. If the request fails, the error is silently\n     * swallowed so it cannot disrupt your app's critical path.\n     *\n     * @param payload - Web request details to log\n     *\n     * @example\n     * await cencori.telemetry.reportWebRequest({\n     *   host: req.headers.get('host') || 'unknown',\n     *   method: req.method,\n     *   path: new URL(req.url).pathname,\n     *   statusCode: response.status,\n     *   userAgent: req.headers.get('user-agent') || undefined,\n     *   latencyMs: Date.now() - startTime,\n     * });\n     */\n    async reportWebRequest(payload: WebTelemetryPayload): Promise<void> {\n        try {\n            const url = `${this.config.baseUrl}/api/v1/telemetry/web`;\n\n            await fetch(url, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    'CENCORI_API_KEY': this.config.apiKey,\n                },\n                body: JSON.stringify(payload),\n            });\n        } catch {\n            // Telemetry is best-effort — never disrupt the customer's app.\n        }\n    }\n}\n"],"mappings":";AAiDO,IAAM,kBAAN,MAAsB;AAAA,EAGzB,YAAY,QAAiC;AACzC,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAM,iBAAiB,SAA6C;AAChE,QAAI;AACA,YAAM,MAAM,GAAG,KAAK,OAAO,OAAO;AAElC,YAAM,MAAM,KAAK;AAAA,QACb,QAAQ;AAAA,QACR,SAAS;AAAA,UACL,gBAAgB;AAAA,UAChB,mBAAmB,KAAK,OAAO;AAAA,QACnC;AAAA,QACA,MAAM,KAAK,UAAU,OAAO;AAAA,MAChC,CAAC;AAAA,IACL,QAAQ;AAAA,IAER;AAAA,EACJ;AACJ;","names":[]}

package/dist/{types-Azq6TqIA.d.mts → types-Cr0muEt3.d.mts}

@@ -81,6 +81,20 @@ interface ChatRequest {
     tools?: ToolDefinition[];
     /** How the model chooses to call tools */
     toolChoice?: ToolChoice;
+    /**
+     * Reference a named prompt from the Cencori Prompt Registry.
+     * When provided, the gateway resolves the active version and
+     * injects it as the system message — no need to hardcode prompts.
+     *
+     * @example
+     * prompt: { name: 'support-agent', variables: { tier: 'pro' } }
+     */
+    prompt?: {
+        /** Prompt name or slug as shown in the dashboard */
+        name: string;
+        /** Template variables to interpolate (e.g. {{tier}} → 'pro') */
+        variables?: Record<string, string>;
+    };
 }
 interface ChatResponse {
     id: string;

package/dist/{types-Azq6TqIA.d.ts → types-Cr0muEt3.d.ts}

@@ -81,6 +81,20 @@ interface ChatRequest {
     tools?: ToolDefinition[];
     /** How the model chooses to call tools */
     toolChoice?: ToolChoice;
+    /**
+     * Reference a named prompt from the Cencori Prompt Registry.
+     * When provided, the gateway resolves the active version and
+     * injects it as the system message — no need to hardcode prompts.
+     *
+     * @example
+     * prompt: { name: 'support-agent', variables: { tier: 'pro' } }
+     */
+    prompt?: {
+        /** Prompt name or slug as shown in the dashboard */
+        name: string;
+        /** Template variables to interpolate (e.g. {{tier}} → 'pro') */
+        variables?: Record<string, string>;
+    };
 }
 interface ChatResponse {
     id: string;

package/dist/workflow/index.d.mts

@@ -1,4 +1,4 @@
-import { W as WorkflowTriggerOptions } from '../types-Azq6TqIA.mjs';
+import { W as WorkflowTriggerOptions } from '../types-Cr0muEt3.mjs';
 
 /**
  * Workflow Namespace - AI Pipelines & Orchestration

package/dist/workflow/index.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkflowTriggerOptions } from '../types-Azq6TqIA.js';
+import { W as WorkflowTriggerOptions } from '../types-Cr0muEt3.js';
 
 /**
  * Workflow Namespace - AI Pipelines & Orchestration

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "cencori",
-    "version": "1.0.4",
+    "version": "1.2.0",
     "description": "Cencori - The unified infrastructure layer for AI applications. One SDK for AI Gateway, Compute, Workflow, and Storage.",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -41,6 +41,11 @@
             "types": "./dist/storage/index.d.ts",
             "import": "./dist/storage/index.mjs",
             "require": "./dist/storage/index.js"
+        },
+        "./telemetry": {
+            "types": "./dist/telemetry/index.d.ts",
+            "import": "./dist/telemetry/index.mjs",
+            "require": "./dist/telemetry/index.js"
         }
     },
     "files": [
@@ -96,4 +101,4 @@
         "tsup": "^8.0.0",
         "typescript": "^5.3.0"
     }
-}
+}