@zimtsui/typechat 0.0.61

package/DEVELOPMENT.md

@@ -0,0 +1,22 @@
+## Architecture Diagram
+
+```mermaid
+classDiagram
+
+Engine <|.. CompatibleEngine
+
+Engine <|.. OpenAIResponsesNativeEngine
+OpenAIResponsesNativeEngine o--> OpenAIResponsesNativeHelpers
+OpenAIResponsesNativeHelpers o--> OpenAIResponsesHelpers
+
+CompatibleEngine <|.. AliyunEngine
+OpenAIChatCompletionsCompatibleHelpers o--> OpenAIChatCompletionsHelpers
+OpenAIChatCompletionsCompatibleMonolithHelpers o--> OpenAIChatCompletionsCompatibleHelpers
+OpenAIChatCompletionsCompatibleStreamHelpers o--> OpenAIChatCompletionsCompatibleHelpers
+AliyunEngine o--> OpenAIChatCompletionsCompatibleStreamHelpers
+
+CompatibleEngine <|.. OpenAICompatibleEngine
+OpenAICompatibleEngine o--> OpenAIResponsesCompatibleHelpers
+OpenAIResponsesCompatibleHelpers o--> OpenAIResponsesHelpers
+
+```

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,202 @@
+# TypeChat
+
+[![NPM Version](https://img.shields.io/npm/v/@zimtsui/typechat?style=flat-square)](https://www.npmjs.com/package/@zimtsui/typechat)
+
+TypeChat 是一个强类型的 LLM 推理 API 适配器。
+
+## 支持服务商 API 类型
+
+-   OpenAI Responses
+-   Google
+-   阿里云 OpenAI Chat Completions Compatible
+-   Anthropic
+
+## 核心概念
+
+- `Session`：会话状态。
+- `InferenceContext`：工作流环境，包含 [Typelemetry](https://github.com/zimtsui/typelemetry) Logger、`AbortSignal`、用户防止并发过载的[读写锁](https://github.com/zimtsui/typelocks)。
+- `Engine`：推理引擎，从一个会话状态生成下一个会话状态。
+- `Endpoint`：代表一家服务商的一个模型的 API 端点。
+- `Adaptor`：Engine 工厂。
+- `RoleMessage`：三类角色消息 `Developer`、`User`、`AI`，消息由 `Text/Function.Call/Response` 片段组成。
+- `Function.Declaration.Map`：函数工具声明集合，使用 [JSON Schema](https://json-schema.org/) 描述函数参数。
+
+## 配置
+
+```ts
+import { type Config } from '@zimtsui/typechat';
+
+// 配置推理服务商 API 接入点
+export const config: Config = {
+    typechat: {
+        endpoints: {
+            'gpt-5.4-mini': {
+                name: 'GPT-5.4 mini',
+                apiType: 'openai-responses',
+                baseUrl: 'https://api.openai.com/v1',
+                apiKey: process.env.OPENAI_API_KEY!,
+                model: 'gpt-5-mini',
+            },
+            'gemini-3-flash': {
+                name: 'Gemini 3 Flash',
+                apiType: 'google',
+                baseUrl: 'https://generativelanguage.googleapis.com',
+                apiKey: process.env.GOOGLE_API_KEY!,
+                model: 'gemini-3-flash',
+            },
+        }
+    }
+}
+```
+
+## 对话
+
+```ts
+import { Adaptor, RoleMessage, type Session } from '@zimtsui/typechat';
+import { config } from './config.ts';
+
+
+// 创建会话
+const session: Session<never, never> = {
+    developerMessage: new RoleMessage.Developer([
+        RoleMessage.Part.Text.paragraph('You are a helpful assistant.'),
+    ]),
+    chatMessages: [
+        new RoleMessage.User([ RoleMessage.Part.Text.paragraph('Hello!') ]),
+    ],
+};
+
+// 选择推理引擎
+const adaptor = Adaptor.create(config);
+const engine = adaptor.makeCompatibleEngine<{}, {}>({
+    endpoint: 'gpt-5.4-mini',
+    functionDeclarationMap: {},
+    verbatimDeclarationMap: {},
+});
+
+const response = await engine.stateless({}, session);
+console.log(response.getText());
+```
+
+## 智能体
+
+```ts
+import { Adaptor, agentloop, RoleMessage, Function, type Session, Structuring } from '@zimtsui/typechat';
+import { Type } from '@sinclair/typebox';
+import { config } from './config.ts';
+
+// 声明函数工具
+const fdm = {
+    get_weather: {
+        description: '获取指定城市的天气',
+        parameters: Type.Object({
+            city: Type.String(),
+            unit: Type.Optional(Type.Union([Type.Literal('C'), Type.Literal('F')]))
+        }),
+    },
+    submit_result: {
+        description: '提交最终结果',
+        parameters: Type.Object({
+            weather: Type.String(),
+            advice: Type.String(),
+        }),
+    },
+} satisfies Function.Decl.Map.Proto;
+type fdm = typeof fdm;
+type fdu = Function.Decl.From<fdm>;
+
+// 实现函数工具
+export class Submission {
+    public constructor(public weather: string, public advice: string) {}
+}
+const fnm: Function.Map<fdm> = {
+    async get_weather({ city, unit }) {
+        const data = { city, unit: unit ?? 'C', temperature: 26, sky: 'sunny' };
+        return JSON.stringify(data);
+    },
+    async submit_result({ weather, advice }) {
+        throw new Submission(weather, advice);
+    },
+};
+
+// 创建会话
+const session: Session<fdu, never> = {
+    developerMessage: new RoleMessage.Developer([
+        RoleMessage.Part.Text.paragraph('你的工作是为用户查询天气，并给出穿衣建议。调用工具提交最终结果'),
+    ]),
+    chatMessages: [
+        new RoleMessage.User([ RoleMessage.Part.Text.paragraph('请查询现在北京的天气，并给穿衣建议。') ]),
+    ],
+};
+
+// 选择推理引擎
+const adaptor = Adaptor.create(config);
+const engine = adaptor.makeCompatibleEngine<fdm, {}>({
+    endpoint: 'gpt-5.4-mini',
+    functionDeclarationMap: fdm,
+    verbatimDeclarationMap: {},
+    structuringChoice: Structuring.Choice.FCall.REQUIRED,
+});
+
+// 使用 agentloop 驱动智能体循环，最多 8 轮对话
+try {
+    for await (const text of agentloop({}, session, engine, fnm, 8)) console.log(text);
+} catch (e) {
+    if (e instanceof Submission) {} else throw e;
+    console.log(e.weather);
+    console.log(e.advice);
+}
+```
+
+### XML Verbatim 频道
+
+When a LLM outputs structured data in JSON format, if there are too many special characters in the parameters (for example, a large Markdown document containing a lot of LaTeX math formulas), the LLM is prone to make mistakes in JSON escaping.
+
+XML Verbatim Channel is designed to avoid escaping in structured output of large text.
+
+```ts
+import { Adaptor, RoleMessage, type Session, Structuring, Verbatim } from '@zimtsui/typechat';
+import Assets from '@zimtsui/typechat/assets';
+import * as Codec from '@zimtsui/typechat/codec';
+import { config } from './config.ts';
+
+// 声明 XML Verbatim 频道
+const vdm = {
+    bash: {
+        description: '执行 Bash 命令',
+        parameters: {
+            command: {
+                description: 'Bash 命令',
+                mimeType: 'text/plain',
+            },
+        },
+    },
+} satisfies Verbatim.Decl.Map.Proto;
+type vdm = typeof vdm;
+type vdu = Verbatim.Decl.From<vdm>;
+
+
+// 创建会话
+const session: Session<never, vdu> = {
+    developerMessage: new RoleMessage.Developer([
+        RoleMessage.Part.Text.paragraph(Assets.verbatim.instruction),
+        RoleMessage.Part.Text.paragraph('# Available Verbatim Channels'),
+        RoleMessage.Part.Text.paragraph(Codec.Declarations.encode(vdm)),
+    ]),
+    chatMessages: [
+        new RoleMessage.User([ RoleMessage.Part.Text.paragraph('请使用 Bash 命令查询当前系统时间。') ]),
+    ],
+};
+
+// 选择推理引擎
+const adaptor = Adaptor.create(config);
+const engine = adaptor.makeCompatibleEngine<{}, vdm>({
+    endpoint: 'gpt-5.4-mini',
+    functionDeclarationMap: {},
+    verbatimDeclarationMap: vdm,
+    structuringChoice: Structuring.Choice.VRequest.ANYONE,
+});
+
+const response = await engine.stateless({}, session);
+console.log(response.getOnlyVerbatimRequest().args.command);
+```

package/assets/verbatim/declarations.handlebars

@@ -0,0 +1,11 @@
+{{#each declarations}}
+<verbatim:declaration name="{{this.name}}">
+    <verbatim:description>{{this.description}}</verbatim:description>
+    {{#each this.parameters}}
+    <verbatim:parameter name="{{this.name}}">
+        <verbatim:description>{{this.description}}</verbatim:description>
+        <verbatim:mime-type>{{this.mimeType}}</verbatim:mime-type>
+    </verbatim:parameter>
+    {{/each}}
+</verbatim:declaration>
+{{/each}}

package/assets/verbatim/instruction.md

@@ -0,0 +1,49 @@
+# XML Verbatim Channel
+
+## Motivation
+
+When a LLM outputs structured data in JSON format, if there are too many special characters in the parameters (for example, a large Markdown document containing a lot of LaTeX math formulas), the LLM is prone to make mistakes in JSON escaping.
+
+XML Verbatim Channel is designed to avoid escaping in structured output of large text.
+
+## Declaration
+
+The system or the user will declare all available XML Verbatim Channels in the form of
+
+<verbatim:declaration name="CHANNEL_1_NAME">
+    <verbatim:description>DESCRIPTION_OF_CHANNEL_1</verbatim:description>
+    <verbatim:parameter name="PARAMETER_1_NAME">
+        <verbatim:description>DESCRIPTION_OF_PARAMETER_1</verbatim:description>
+        <verbatim:mime-type>VALUE_MIME_TYPE_OF_PARAMETER_1</verbatim:mime-type>
+    </verbatim:parameter>
+    <verbatim:parameter name="PARAMETER_2_NAME">
+        <verbatim:description>DESCRIPTION_OF_PARAMETER_2</verbatim:description>
+        <verbatim:mime-type>VALUE_MIME_TYPE_OF_PARAMETER_2</verbatim:mime-type>
+    </verbatim:parameter>
+</verbatim:declaration>
+
+## Request
+
+You can make a request through the channel CHANNEL_1_NAME in the form of
+
+<verbatim:request name="CHANNEL_1_NAME">
+    <verbatim:argument name="PARAMETER_1_NAME"><![CDATA[PARAMETER_1_VALUE]]></verbatim:argument>
+    <verbatim:argument name="PARAMETER_2_NAME"><![CDATA[PARAMETER_2_VALUE]]></verbatim:argument>
+</verbatim:request>
+
+-   All parameters are required
+-   All arguments must be wrapped in CDATA
+
+# Available XML Verbatim Channels
+
+<verbatim:declaration name="submit">
+    <verbatim:description>提交文章</verbatim:description>
+    <verbatim:parameter name="title">
+        <verbatim:description>文章标题</verbatim:description>
+        <verbatim:mime-type>text/plain</verbatim:mime-type>
+    </verbatim:parameter>
+    <verbatim:parameter name="body">
+        <verbatim:description>文章内容</verbatim:description>
+        <verbatim:mime-type>text/markdown;dialect=gfm+tex_math_dollars</verbatim:mime-type>
+    </verbatim:parameter>
+</verbatim:declaration>

package/build/adaptor.d.ts

@@ -0,0 +1,45 @@
+import { Config } from './config.ts';
+import { Function } from './function.ts';
+import { type CompatibleEngine } from './compatible-engine.ts';
+import { Throttle } from './throttle.ts';
+import { OpenAIResponsesNativeEngine } from './native-engines.d/openai-responses.ts';
+import { GoogleNativeEngine } from './native-engines.d/google.ts';
+import type { Verbatim } from './verbatim.ts';
+import type { Structuring } from './compatible-engine/structuring.ts';
+import type { Structuring as OpenAIResponsesNativeStructuring } from './native-engines.d/openai-responses/structuring.ts';
+export declare class Adaptor {
+    config: Config;
+    static create(config: Config): Adaptor;
+    protected throttles: Map<string, Throttle>;
+    protected constructor(config: Config);
+    makeCompatibleEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.CompatibleEngine.Options<fdm, vdm>): CompatibleEngine<fdm, vdm>;
+    makeOpenAIResponsesNativeEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.OpenAIResponsesNativeEngineOptions<fdm, vdm>): OpenAIResponsesNativeEngine<fdm, vdm>;
+    makeGoogleNativeEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.GoogleNativeEngineOptions<fdm, vdm>): GoogleNativeEngine<fdm, vdm>;
+}
+export declare namespace Adaptor {
+    namespace CompatibleEngine {
+        interface Options<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> {
+            endpoint: string;
+            functionDeclarationMap: fdm;
+            verbatimDeclarationMap: vdm;
+            structuringChoice?: Structuring.Choice.From<fdm, vdm>;
+        }
+    }
+    interface OpenAIResponsesNativeEngineOptions<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> {
+        endpoint: string;
+        functionDeclarationMap: fdm;
+        verbatimDeclarationMap: vdm;
+        applyPatch?: boolean;
+        structuringChoice?: OpenAIResponsesNativeStructuring.Choice.From<fdm, vdm>;
+    }
+    interface GoogleNativeEngineOptions<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> {
+        endpoint: string;
+        functionDeclarationMap: fdm;
+        verbatimDeclarationMap: vdm;
+        structuringChoice?: Structuring.Choice.From<fdm, vdm>;
+        codeExecution?: boolean;
+        urlContext?: boolean;
+        googleSearch?: boolean;
+        parallelToolCall?: boolean;
+    }
+}

package/build/adaptor.js

@@ -0,0 +1,90 @@
+import { Throttle } from "./throttle.js";
+import { GoogleCompatibleEngine } from "./compatible-engine.d/google.js";
+import { OpenAIResponsesCompatibleEngine } from "./compatible-engine.d/openai-responses.js";
+import { AnthropicCompatibleEngine } from "./compatible-engine.d/anthropic.js";
+import { AliyunCompatibleEngine } from "./compatible-engine.d/aliyun.js";
+import { OpenAIResponsesNativeEngine } from "./native-engines.d/openai-responses.js";
+import { GoogleNativeEngine } from "./native-engines.d/google.js";
+export class Adaptor {
+    config;
+    static create(config) {
+        return new Adaptor(config);
+    }
+    throttles = new Map();
+    constructor(config) {
+        this.config = config;
+        for (const endpointId in this.config.typechat.endpoints) {
+            const rpm = this.config.typechat.endpoints[endpointId].rpm ?? Number.POSITIVE_INFINITY;
+            this.throttles.set(endpointId, new Throttle(rpm));
+        }
+    }
+    makeCompatibleEngine(adaptorOptions) {
+        const endpointSpec = this.config.typechat.endpoints[adaptorOptions.endpoint];
+        if (endpointSpec) { }
+        else
+            throw new Error();
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
+        if (throttle) { }
+        else
+            throw new Error();
+        const options = {
+            ...endpointSpec,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
+            throttle,
+        };
+        if (endpointSpec.apiType === 'openai-responses')
+            return new OpenAIResponsesCompatibleEngine.Instance(options);
+        else if (endpointSpec.apiType === 'google')
+            return new GoogleCompatibleEngine.Instance(options);
+        else if (endpointSpec.apiType === 'aliyun')
+            return new AliyunCompatibleEngine.Instance(options);
+        else if (endpointSpec.apiType === 'anthropic')
+            return new AnthropicCompatibleEngine.Instance(options);
+        else
+            throw new Error();
+    }
+    makeOpenAIResponsesNativeEngine(adaptorOptions) {
+        const endpointSpec = this.config.typechat.endpoints[adaptorOptions.endpoint];
+        if (endpointSpec?.apiType === 'openai-responses') { }
+        else
+            throw new Error();
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
+        if (throttle) { }
+        else
+            throw new Error();
+        const options = {
+            ...endpointSpec,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
+            throttle,
+            applyPatch: adaptorOptions.applyPatch,
+        };
+        return new OpenAIResponsesNativeEngine.Instance(options);
+    }
+    makeGoogleNativeEngine(adaptorOptions) {
+        const endpointSpec = this.config.typechat.endpoints[adaptorOptions.endpoint];
+        if (endpointSpec?.apiType === 'google') { }
+        else
+            throw new Error();
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
+        if (throttle) { }
+        else
+            throw new Error();
+        const options = {
+            ...endpointSpec,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
+            parallelToolCall: adaptorOptions.parallelToolCall,
+            throttle,
+            codeExecution: adaptorOptions.codeExecution,
+            urlContext: adaptorOptions.urlContext,
+            googleSearch: adaptorOptions.googleSearch,
+        };
+        return new GoogleNativeEngine.Instance(options);
+    }
+}
+//# sourceMappingURL=adaptor.js.map

package/build/adaptor.js.map

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

package/build/api-types/anthropic/billing.d.ts

@@ -0,0 +1,12 @@
+import type { Pricing } from '../../engine.ts';
+import Anthropic from '@anthropic-ai/sdk';
+export declare class Billing {
+    protected ctx: Billing.Context;
+    constructor(ctx: Billing.Context);
+    charge(usage: Anthropic.Usage): number;
+}
+export declare namespace Billing {
+    interface Context {
+        pricing: Pricing;
+    }
+}

package/build/api-types/anthropic/billing.js

@@ -0,0 +1,14 @@
+export class Billing {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    charge(usage) {
+        const cacheHitTokenCount = usage.cache_read_input_tokens || 0;
+        const cacheMissTokenCount = usage.input_tokens - cacheHitTokenCount;
+        return (this.ctx.pricing.inputPrice * cacheMissTokenCount / 1e6 +
+            this.ctx.pricing.cachePrice * cacheHitTokenCount / 1e6 +
+            this.ctx.pricing.outputPrice * usage.output_tokens / 1e6);
+    }
+}
+//# sourceMappingURL=billing.js.map

package/build/api-types/anthropic/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/api-types/anthropic/billing.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,OAAO;IACa;IAA7B,YAA6B,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE9C,MAAM,CAAC,KAAsB;QAChC,MAAM,kBAAkB,GAAG,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC;QAC9D,MAAM,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,kBAAkB,CAAC;QACpE,OAAO,CACH,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,mBAAmB,GAAG,GAAG;YACvD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,kBAAkB,GAAG,GAAG;YACtD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,aAAa,GAAG,GAAG,CAC3D,CAAC;IACN,CAAC;CACJ"}

package/build/api-types/anthropic/tool-codec.d.ts

@@ -0,0 +1,16 @@
+import { Function } from '../../function.ts';
+import Anthropic from '@anthropic-ai/sdk';
+export declare class ToolCodec<in out fdm extends Function.Decl.Map.Proto> {
+    protected ctx: ToolCodec.Context<fdm>;
+    constructor(ctx: ToolCodec.Context<fdm>);
+    encodeFunctionCall(fc: Function.Call.From<fdm>): Anthropic.ToolUseBlock;
+    decodeFunctionCall(apifc: Anthropic.ToolUseBlock): Function.Call.From<fdm>;
+    encodeFunctionResponse(fr: Function.Response.From<fdm>): Anthropic.ToolResultBlockParam;
+    protected encodeFunctionDeclarationEntry(fdentry: Function.Decl.Entry.From<fdm>): Anthropic.Tool;
+    encodeFunctionDeclarationMap(fdm: fdm): Anthropic.Tool[];
+}
+export declare namespace ToolCodec {
+    interface Context<in out fdm extends Function.Decl.Map.Proto> {
+        fdm: fdm;
+    }
+}