@zimtsui/brainswitch 0.0.55 → 0.0.57

package/DEVELOPMENT.md

@@ -3,21 +3,20 @@
 ```mermaid
 classDiagram
 
-OpenAIResponsesEngine <|.. OpenAIResponsesNativeEngine
-
-CompatibleEngine <|.. OpenAIResponsesCompatibleEngine
-OpenAIResponsesEngine <|.. OpenAIResponsesCompatibleEngine
-Engine <|.. OpenAIResponsesEngine
-
 Engine <|.. CompatibleEngine
 
-Engine <|.. OpenAIChatCompletionsEngine
-OpenAIChatCompletionsEngine <|.. OpenAIChatCompletionsCompatibleEngine
-CompatibleEngine <|.. OpenAIChatCompletionsCompatibleEngine
-OpenAIChatCompletionsCompatibleEngine <|.. OpenAIChatCompletionsCompatibleMonolithEngine
-OpenAIChatCompletionsCompatibleEngine <|.. OpenAIChatCompletionsCompatibleStreamEngine
-```
+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/README.md

@@ -4,13 +4,7 @@
 
 [![NPM Version](https://img.shields.io/npm/v/@zimtsui/brainswitch?style=flat-square)](https://www.npmjs.com/package/@zimtsui/brainswitch)
 
-Brainswitch 是一个为 AI 工作流设计的 LLM 推理 API 适配器，支持在会话中途切换模型。
-
-## Motivation
-
-大多数 LLM 的[聊天模板](https://huggingface.co/docs/transformers/en/chat_templating) ChatML 原生不支持[严格函数调用](https://platform.openai.com/docs/guides/function-calling#strict-mode)，在批处理 AI 工作流中难以达到生产级可靠性。如果仅使用 OpenAI 等支持严格函数调用的服务商，那么可选的模型型号会大幅受限。
-
-Brainswitch 支持在一次会话中途切换模型并保持对话上下文，包括 OpenAI、Google、Anthropic 的深度思考模型[交替思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)的加密思考内容，这样即可在会话的大量推理阶段使用最合适的模型生成自然语言结果，在最后的总结阶段切换成支持严格函数调用的模型进行结构化提交。
+Brainswitch 是一个强类型的 LLM 推理 API 适配器。
 
 ## 支持服务商 API 类型
 
@@ -40,47 +34,14 @@ npm install @zimtsui/brainswitch
 ## 配置
 
 ```ts
-export type Config = {
-    brainswitch: {
-        endpoints: Record<string, {
-            baseUrl: string;
-            apiKey: string;
-            model: string;
-            name: string;
-            apiType:
-                | 'openai-responses'
-                | 'google'
-                | 'aliyun'
-                | 'anthropic'
-            ;
-            proxy?: string;
-            inputPrice?: number;    // CNY per MToken
-            outputPrice?: number;   // CNY per MToken
-            cachePrice?: number;    // CNY per MToken
-            rpm?: number;           // Requests per minute
-            timeout?: number;       // Time limit in milliseconds
-            maxTokens?: number;     // Maximum number of generated tokens
-            additionalOptions?: Record<string, unknown>;
-        };
-    };
-}
-```
-
-## 快速上手
-
-```ts
-import { Adaptor, agentloop, RoleMessage, Function, type InferenceContext, type Config, Session } from '@zimtsui/brainswitch';
-import { Type } from '@sinclair/typebox';
-import { RWLock } from '@zimtsui/coroutine-locks';
-import { Channel } from '@zimtsui/typelog';
-import * as Presets from '@zimtsui/typelog/presets';
+import { type Config } from '@zimtsui/brainswitch';
 
 // 配置推理服务商 API 接入点
-const config: Config = {
+export const config: Config = {
     brainswitch: {
         endpoints: {
-            'gpt-5-mini': {
-                name: 'GPT-5 mini',
+            'gpt-5.4-mini': {
+                name: 'GPT-5.4 mini',
                 apiType: 'openai-responses',
                 baseUrl: 'https://api.openai.com/v1',
                 apiKey: process.env.OPENAI_API_KEY!,
@@ -96,26 +57,63 @@ const config: Config = {
         }
     }
 }
+```
+
+## 对话
+
+```ts
+import { Adaptor, RoleMessage, type Session } from '@zimtsui/brainswitch';
+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/brainswitch';
+import { Type } from '@sinclair/typebox';
+import { config } from './config.ts';
 
 // 声明函数工具
 const fdm = {
     get_weather: {
         description: '获取指定城市的天气',
-        paraschema: Type.Object({
+        parameters: Type.Object({
             city: Type.String(),
             unit: Type.Optional(Type.Union([Type.Literal('C'), Type.Literal('F')]))
         }),
     },
     submit_result: {
         description: '提交最终结果',
-        paraschema: Type.Object({
+        parameters: Type.Object({
             weather: Type.String(),
             advice: Type.String(),
         }),
     },
-} satisfies Function.Declaration.Map;
+} satisfies Function.Decl.Map.Proto;
 type fdm = typeof fdm;
-type fdu = Function.Declaration.From<fdm>;
+type fdu = Function.Decl.From<fdm>;
 
 // 实现函数工具
 export class Submission {
@@ -131,34 +129,84 @@ const fnm: Function.Map<fdm> = {
     },
 };
 
-// 初始化工作流上下文
-const ctx: InferenceContext = {
-    busy: new RWLock(),
-    cost(deltaCost) {
-        console.log((-deltaCost).toFixed(2));
-    },
-};
-
 // 创建会话
-const session: Session<fdu> = {
-    developerMessage: RoleMessage.Developer.create([
-        RoleMessage.Part.Text.create('你的工作是为用户查询天气，并给出穿衣建议。调用工具提交最终结果'),
+const session: Session<fdu, never> = {
+    developerMessage: new RoleMessage.Developer([
+        RoleMessage.Part.Text.paragraph('你的工作是为用户查询天气，并给出穿衣建议。调用工具提交最终结果'),
     ]),
     chatMessages: [
-        RoleMessage.User.create([ RoleMessage.Part.Text.create('请查询现在北京的天气，并给穿衣建议。') ]),
+        new RoleMessage.User([ RoleMessage.Part.Text.paragraph('请查询现在北京的天气，并给穿衣建议。') ]),
     ],
 };
 
 // 选择推理引擎
 const adaptor = Adaptor.create(config);
-const engine = adaptor.makeEngine('gpt-5-mini', fdm, Function.ToolChoice.REQUIRED);
+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(ctx, session, engine, fnm, 8)) console.log(text);
+    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/brainswitch';
+import Assets from '@zimtsui/brainswitch/assets';
+import * as Codec from '@zimtsui/brainswitch/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([
+        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

@@ -1,14 +1,45 @@
-import { Config } from '#config';
+import { Config } from './config.ts';
 import { Function } from './function.ts';
 import { type CompatibleEngine } from './compatible-engine.ts';
-import { OpenAIResponsesNativeEngine } from './native-engines.d/openai-responses/engine.ts';
-import { GoogleNativeEngine } from './native-engines.d/google/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;
-    private throttles;
+    protected throttles: Map<string, Throttle>;
     protected constructor(config: Config);
-    makeEngine<fdm extends Function.Declaration.Map>(endpoint: string, functionDeclarationMap: fdm, toolChoice?: Function.ToolChoice<fdm>, parallelToolCall?: boolean): CompatibleEngine<fdm>;
-    makeOpenAIResponsesNativeEngine<fdm extends Function.Declaration.Map>(endpoint: string, functionDeclarationMap: fdm, applyPatch?: boolean, toolChoice?: Function.ToolChoice<fdm>, parallelToolCall?: boolean): OpenAIResponsesNativeEngine<fdm>;
-    makeGoogleNativeEngine<fdm extends Function.Declaration.Map>(endpoint: string, functionDeclarationMap: fdm, toolChoice?: Function.ToolChoice<fdm>, codeExecution?: boolean, urlContext?: boolean, googleSearch?: boolean, parallelToolCall?: boolean): GoogleNativeEngine<fdm>;
+    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

@@ -1,13 +1,10 @@
-import { Config } from '#config';
-import { Function } from "./function.js";
-import {} from "./compatible-engine.js";
 import { Throttle } from "./throttle.js";
-import { GoogleCompatibleEngine } from "./compatible-engines.d/google.js";
-import { AliyunEngine } from "./compatible-engines.d/aliyun.js";
-import { OpenAIResponsesCompatibleEngine } from "./compatible-engines.d/openai-responses.js";
-import { AnthropicCompatibleEngine } from "./compatible-engines.d/anthropic.js";
-import { OpenAIResponsesNativeEngine } from "./native-engines.d/openai-responses/engine.js";
-import { GoogleNativeEngine } from "./native-engines.d/google/engine.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) {
@@ -21,72 +18,73 @@ export class Adaptor {
             this.throttles.set(endpointId, new Throttle(rpm));
         }
     }
-    makeEngine(endpoint, functionDeclarationMap, toolChoice, parallelToolCall) {
-        const endpointSpec = this.config.brainswitch.endpoints[endpoint];
+    makeCompatibleEngine(adaptorOptions) {
+        const endpointSpec = this.config.brainswitch.endpoints[adaptorOptions.endpoint];
         if (endpointSpec) { }
         else
             throw new Error();
-        const throttle = this.throttles.get(endpoint);
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
         if (throttle) { }
         else
             throw new Error();
         const options = {
             ...endpointSpec,
-            functionDeclarationMap,
-            toolChoice,
-            parallelToolCall,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
             throttle,
         };
         if (endpointSpec.apiType === 'openai-responses')
-            return OpenAIResponsesCompatibleEngine.create(options);
+            return new OpenAIResponsesCompatibleEngine.Instance(options);
         else if (endpointSpec.apiType === 'google')
-            return GoogleCompatibleEngine.create(options);
+            return new GoogleCompatibleEngine.Instance(options);
         else if (endpointSpec.apiType === 'aliyun')
-            return AliyunEngine.create(options);
+            return new AliyunCompatibleEngine.Instance(options);
         else if (endpointSpec.apiType === 'anthropic')
-            return AnthropicCompatibleEngine.create(options);
+            return new AnthropicCompatibleEngine.Instance(options);
         else
             throw new Error();
     }
-    makeOpenAIResponsesNativeEngine(endpoint, functionDeclarationMap, applyPatch, toolChoice, parallelToolCall) {
-        const endpointSpec = this.config.brainswitch.endpoints[endpoint];
+    makeOpenAIResponsesNativeEngine(adaptorOptions) {
+        const endpointSpec = this.config.brainswitch.endpoints[adaptorOptions.endpoint];
         if (endpointSpec?.apiType === 'openai-responses') { }
         else
             throw new Error();
-        const throttle = this.throttles.get(endpoint);
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
         if (throttle) { }
         else
             throw new Error();
         const options = {
             ...endpointSpec,
-            functionDeclarationMap,
-            toolChoice,
-            parallelToolCall,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
             throttle,
-            applyPatch,
+            applyPatch: adaptorOptions.applyPatch,
         };
-        return OpenAIResponsesNativeEngine.create(options);
+        return new OpenAIResponsesNativeEngine.Instance(options);
     }
-    makeGoogleNativeEngine(endpoint, functionDeclarationMap, toolChoice, codeExecution, urlContext, googleSearch, parallelToolCall) {
-        const endpointSpec = this.config.brainswitch.endpoints[endpoint];
+    makeGoogleNativeEngine(adaptorOptions) {
+        const endpointSpec = this.config.brainswitch.endpoints[adaptorOptions.endpoint];
         if (endpointSpec?.apiType === 'google') { }
         else
             throw new Error();
-        const throttle = this.throttles.get(endpoint);
+        const throttle = this.throttles.get(adaptorOptions.endpoint);
         if (throttle) { }
         else
             throw new Error();
         const options = {
             ...endpointSpec,
-            functionDeclarationMap,
-            toolChoice,
-            parallelToolCall,
+            functionDeclarationMap: adaptorOptions.functionDeclarationMap,
+            verbatimDeclarationMap: adaptorOptions.verbatimDeclarationMap,
+            structuringChoice: adaptorOptions.structuringChoice,
+            parallelToolCall: adaptorOptions.parallelToolCall,
             throttle,
-            codeExecution,
-            urlContext,
-            googleSearch,
+            codeExecution: adaptorOptions.codeExecution,
+            urlContext: adaptorOptions.urlContext,
+            googleSearch: adaptorOptions.googleSearch,
         };
-        return GoogleNativeEngine.create(options);
+        return new GoogleNativeEngine.Instance(options);
     }
 }
 //# sourceMappingURL=adaptor.js.map

package/build/adaptor.js.map

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

package/build/api-types/anthropic/tool-codec.js

@@ -0,0 +1,58 @@
+import { Function } from "../../function.js";
+import { ResponseInvalid } from "../../engine.js";
+import Ajv from 'ajv';
+const ajv = new Ajv();
+export class ToolCodec {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    encodeFunctionCall(fc) {
+        throw new Error('Anthropic compatible engine requires native function calls.');
+    }
+    decodeFunctionCall(apifc) {
+        const fditem = this.ctx.fdm[apifc.name];
+        if (fditem) { }
+        else
+            throw new ResponseInvalid('Unknown function call', { cause: apifc });
+        if (ajv.validate(fditem.parameters, apifc.input)) { }
+        else
+            throw new ResponseInvalid('Function call not conforming to schema', { cause: apifc });
+        return Function.Call.of({
+            id: apifc.id,
+            name: apifc.name,
+            args: apifc.input,
+        });
+    }
+    encodeFunctionResponse(fr) {
+        if (fr.id) { }
+        else
+            throw new Error();
+        if (fr instanceof Function.Response.Successful)
+            return {
+                type: 'tool_result',
+                tool_use_id: fr.id,
+                content: fr.text,
+            };
+        else if (fr instanceof Function.Response.Failed)
+            return {
+                type: 'tool_result',
+                tool_use_id: fr.id,
+                content: fr.error,
+            };
+        else
+            throw new Error();
+    }
+    encodeFunctionDeclarationEntry(fdentry) {
+        return {
+            name: fdentry[0],
+            description: fdentry[1].description,
+            input_schema: fdentry[1].parameters,
+        };
+    }
+    encodeFunctionDeclarationMap(fdm) {
+        const fdentries = Object.entries(fdm);
+        return fdentries.map(fdentry => this.encodeFunctionDeclarationEntry(fdentry));
+    }
+}
+//# sourceMappingURL=tool-codec.js.map

package/build/api-types/anthropic/tool-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-codec.js","sourceRoot":"","sources":["../../../src/api-types/anthropic/tool-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,GAAG,MAAM,KAAK,CAAC;AAGtB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;AAGtB,MAAM,OAAO,SAAS;IACW;IAA7B,YAA6B,GAA2B;QAA3B,QAAG,GAAH,GAAG,CAAwB;IAAG,CAAC;IAErD,kBAAkB,CACrB,EAA2B;QAE3B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACnF,CAAC;IAEM,kBAAkB,CACrB,KAA6B;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,eAAe,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzF,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA,CAAC;;YAC/C,MAAM,IAAI,eAAe,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,KAAK;SACe,CAAC,CAAC;IAC1C,CAAC;IAEM,sBAAsB,CACzB,EAA+B;QAE/B,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACrC,IAAI,EAAE,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU;YAC1C,OAAO;gBACH,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,EAAE,CAAC,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,IAAI;aACnB,CAAC;aACD,IAAI,EAAE,YAAY,QAAQ,CAAC,QAAQ,CAAC,MAAM;YAC3C,OAAO;gBACH,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,EAAE,CAAC,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,KAAK;aACpB,CAAC;;YACD,MAAM,IAAI,KAAK,EAAE,CAAC;IAC3B,CAAC;IAES,8BAA8B,CACpC,OAAsC;QAEtC,OAAO;YACH,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAChB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW;YACnC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAqB;SACjD,CAAC;IACN,CAAC;IAEM,4BAA4B,CAC/B,GAAQ;QAER,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAoC,CAAC;QAEzE,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;CAEJ"}

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

@@ -0,0 +1,12 @@
+import * as Google from '@google/genai';
+import type { Pricing } from '../../engine.ts';
+export declare class Billing {
+    protected ctx: Billing.Context;
+    constructor(ctx: Billing.Context);
+    charge(usageMetadata: Google.GenerateContentResponseUsageMetadata): number;
+}
+export declare namespace Billing {
+    interface Context {
+        pricing: Pricing;
+    }
+}