@keo-ai/axiom 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +402 -2
  2. package/dist/embedding_search/enums.d.ts +6 -0
  3. package/dist/embedding_search/enums.js +105 -0
  4. package/dist/embedding_search/index.js +10 -3
  5. package/dist/embedding_search/types.d.ts +1 -0
  6. package/dist/function_call_loop/harness.d.ts +34 -0
  7. package/dist/function_call_loop/harness.js +48 -0
  8. package/dist/function_call_loop/index.d.ts +14 -0
  9. package/dist/function_call_loop/index.js +17 -0
  10. package/dist/function_call_loop/loop.d.ts +2 -0
  11. package/dist/function_call_loop/loop.js +438 -0
  12. package/dist/function_call_loop/provider.d.ts +19 -0
  13. package/dist/function_call_loop/provider.js +73 -0
  14. package/dist/function_call_loop/types.d.ts +206 -0
  15. package/dist/function_call_loop/types.js +2 -0
  16. package/dist/index.d.ts +6 -3
  17. package/dist/index.js +39 -4
  18. package/dist/llm_provider/bailian.d.ts +28 -0
  19. package/dist/llm_provider/bailian.js +174 -0
  20. package/dist/llm_provider/index.d.ts +73 -0
  21. package/dist/llm_provider/index.js +62 -0
  22. package/dist/llm_provider/llm.d.ts +32 -0
  23. package/dist/llm_provider/llm.js +2 -0
  24. package/dist/llm_provider/models.d.ts +14 -0
  25. package/dist/llm_provider/models.js +17 -0
  26. package/dist/llm_provider/types.d.ts +51 -0
  27. package/dist/llm_provider/types.js +2 -0
  28. package/dist/predict/config.d.ts +2 -2
  29. package/dist/predict/index.d.ts +6 -5
  30. package/dist/predict/index.js +2 -2
  31. package/dist/predict/llm.d.ts +3 -33
  32. package/dist/predict/llm.js +1 -1
  33. package/dist/predict/models.d.ts +2 -14
  34. package/dist/predict/models.js +2 -14
  35. package/dist/predict/predict.d.ts +1 -1
  36. package/dist/predict/predict.js +1 -1
  37. package/dist/predict/types.d.ts +1 -51
  38. package/package.json +1 -1
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.MODEL_REGISTRY = void 0;
4
+ /**
5
+ * 模型注册表。每个模型对应一个或多个 Provider 候选,按优先级排序。
6
+ * 当首选 Provider 失败时,Predictor 按此表顺序尝试下一个。
7
+ */
8
+ exports.MODEL_REGISTRY = {
9
+ 'qwen3.7-max': [{ model: 'qwen3.7-max', provider: 'bailian' }],
10
+ 'qwen-plus': [{ model: 'qwen-plus', provider: 'bailian' }],
11
+ 'qwen-turbo': [{ model: 'qwen-turbo', provider: 'bailian' }],
12
+ 'qwq-plus': [{ model: 'qwq-plus', provider: 'bailian' }],
13
+ 'deepseek-v4-pro': [{ model: 'deepseek-v4-pro', provider: 'bailian' }],
14
+ 'deepseek-v4-flash': [{ model: 'deepseek-v4-flash', provider: 'bailian' }],
15
+ 'kimi-k2.6': [{ model: 'kimi-k2.6', provider: 'bailian' }],
16
+ 'qwen-vl-plus': [{ model: 'qwen-vl-plus', provider: 'bailian' }],
17
+ };
@@ -0,0 +1,51 @@
1
+ /**
2
+ * LLM 对话消息。支持 system、user、assistant 三种角色。
3
+ */
4
+ export interface Message {
5
+ readonly role: 'system' | 'user' | 'assistant';
6
+ readonly content: string;
7
+ }
8
+ /**
9
+ * 标准化 LLM 请求参数。各 Provider 据此构建自身的协议请求。
10
+ */
11
+ export interface LLMRequest {
12
+ readonly messages: ReadonlyArray<Message>;
13
+ readonly temperature?: number;
14
+ readonly maxTokens?: number;
15
+ readonly topP?: number;
16
+ readonly stream?: boolean;
17
+ readonly model?: string;
18
+ readonly responseFormat?: 'text' | 'json';
19
+ }
20
+ /**
21
+ * 标准化 LLM 响应。各 Provider 将原始响应解析为此格式后返回。
22
+ */
23
+ export interface LLMResponse {
24
+ readonly content: string | null;
25
+ readonly usage?: {
26
+ readonly promptTokens: number;
27
+ readonly completionTokens: number;
28
+ readonly totalTokens: number;
29
+ };
30
+ readonly model: string;
31
+ }
32
+ /**
33
+ * 流式输出片段。迭代器每次 yield 一个 chunk。
34
+ */
35
+ export type StreamChunk = {
36
+ readonly type: 'content';
37
+ readonly delta: string;
38
+ } | {
39
+ readonly type: 'finish';
40
+ usage?: LLMResponse['usage'];
41
+ };
42
+ /**
43
+ * Provider 配置。每个 Provider 实例需要一组连接参数。
44
+ */
45
+ export interface ProviderConfig {
46
+ readonly name: string;
47
+ readonly apiKey: string;
48
+ readonly baseUrl: string;
49
+ readonly defaultModel: string;
50
+ readonly timeoutMs?: number;
51
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,5 +1,5 @@
1
- import type { Message } from './types';
2
- import type { Model } from './models';
1
+ import type { Message } from '../llm_provider/types';
2
+ import type { Model } from '../llm_provider/models';
3
3
  /**
4
4
  * `predict()` 的配置参数。用于单轮快速调用场景,内部自动构建 user message。
5
5
  */
@@ -1,8 +1,9 @@
1
- export type { LLMRequest, LLMResponse, Message, ProviderConfig, StreamChunk, } from './types';
2
- export type { LLMProvider, PredictorOptions } from './llm';
1
+ export type { LLMRequest, LLMResponse, Message, ProviderConfig, StreamChunk, } from '../llm_provider/types';
2
+ export type { LLMProvider } from '../llm_provider/llm';
3
+ export type { PredictorOptions } from './llm';
3
4
  export { Predictor } from './llm';
4
- export { BailianProvider } from './providers/bailian';
5
- export type { Model } from './models';
6
- export { MODEL_REGISTRY } from './models';
5
+ export { BailianProvider } from '../llm_provider/bailian';
6
+ export type { Model } from '../llm_provider/models';
7
+ export { MODEL_REGISTRY } from '../llm_provider/models';
7
8
  export type { PredictConfig, PredictWithMessagesConfig } from './config';
8
9
  export { LLM } from './predict';
@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.LLM = exports.MODEL_REGISTRY = exports.BailianProvider = exports.Predictor = void 0;
4
4
  var llm_1 = require("./llm");
5
5
  Object.defineProperty(exports, "Predictor", { enumerable: true, get: function () { return llm_1.Predictor; } });
6
- var bailian_1 = require("./providers/bailian");
6
+ var bailian_1 = require("../llm_provider/bailian");
7
7
  Object.defineProperty(exports, "BailianProvider", { enumerable: true, get: function () { return bailian_1.BailianProvider; } });
8
- var models_1 = require("./models");
8
+ var models_1 = require("../llm_provider/models");
9
9
  Object.defineProperty(exports, "MODEL_REGISTRY", { enumerable: true, get: function () { return models_1.MODEL_REGISTRY; } });
10
10
  var predict_1 = require("./predict");
11
11
  Object.defineProperty(exports, "LLM", { enumerable: true, get: function () { return predict_1.LLM; } });
@@ -1,36 +1,6 @@
1
- import type { LLMRequest, LLMResponse, ProviderConfig, StreamChunk } from './types';
2
- import type { Model } from './models';
3
- /**
4
- * LLM Provider 抽象接口。每个 Provider 实现负责对接具体的模型服务
5
- *(如百炼、OpenAI、Anthropic 等),处理 HTTP 请求、流式解析和错误转换。
6
- */
7
- export interface LLMProvider {
8
- /** Provider 标识名,用于路由和故障转移日志 */
9
- readonly name: string;
10
- /** Provider 配置(API Key、Base URL、默认模型等) */
11
- readonly config: ProviderConfig;
12
- /**
13
- * 校验当前 Provider 是否支持指定模型。
14
- * 框架层在 MODEL_REGISTRY 候选过滤后,再调用此方法做二次确认。
15
- * @param model - 模型标识名
16
- * @returns true 表示支持,false 表示不支持(将自动轮询下一个候选)
17
- */
18
- supports(model: string): boolean;
19
- /**
20
- * 发送非流式请求,返回完整的模型响应。
21
- * @param request - LLM 请求参数
22
- * @returns 模型生成的完整响应
23
- * @throws 网络异常、HTTP 错误、解析失败等均抛 {@link Error}
24
- */
25
- generate(request: LLMRequest): Promise<LLMResponse>;
26
- /**
27
- * 发送流式请求,逐块返回模型输出。
28
- * @param request - LLM 请求参数
29
- * @yields 内容片段或结束标记
30
- * @throws 网络异常、HTTP 错误等均抛 {@link Error}
31
- */
32
- stream(request: LLMRequest): AsyncGenerator<StreamChunk, void, unknown>;
33
- }
1
+ import type { LLMRequest, LLMResponse, StreamChunk } from '../llm_provider/types';
2
+ import type { LLMProvider } from '../llm_provider/llm';
3
+ import type { Model } from '../llm_provider/models';
34
4
  /** Predictor 构造选项 */
35
5
  export interface PredictorOptions {
36
6
  /** Provider 列表,按优先级排序 */
@@ -30,7 +30,7 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
30
30
  };
31
31
  Object.defineProperty(exports, "__esModule", { value: true });
32
32
  exports.Predictor = void 0;
33
- const models_1 = require("./models");
33
+ const models_1 = require("../llm_provider/models");
34
34
  /**
35
35
  * 预测器核心类。负责按模型路由到对应 Provider,执行故障转移和重试。
36
36
  * 对外透明:调用方只需指定模型,无需关心底层是哪个 Provider。
@@ -1,14 +1,2 @@
1
- /**
2
- * 支持的模型枚举。项目层通过此枚举选择模型,Axiom 内部路由到对应 Provider。
3
- */
4
- export type Model = 'qwen3.7-max' | 'qwen-plus' | 'qwen-turbo' | 'qwq-plus' | 'deepseek-v4-pro' | 'deepseek-v4-flash' | 'kimi-k2.6' | 'qwen-vl-plus';
5
- /** 模型到 Provider 的映射配置 */
6
- export interface ModelConfig {
7
- readonly model: string;
8
- readonly provider: string;
9
- }
10
- /**
11
- * 模型注册表。每个模型对应一个或多个 Provider 候选,按优先级排序。
12
- * 当首选 Provider 失败时,Predictor 按此表顺序尝试下一个。
13
- */
14
- export declare const MODEL_REGISTRY: Readonly<Record<Model, ReadonlyArray<ModelConfig>>>;
1
+ export type { Model, ModelConfig } from '../llm_provider/models';
2
+ export { MODEL_REGISTRY } from '../llm_provider/models';
@@ -1,17 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.MODEL_REGISTRY = void 0;
4
- /**
5
- * 模型注册表。每个模型对应一个或多个 Provider 候选,按优先级排序。
6
- * 当首选 Provider 失败时,Predictor 按此表顺序尝试下一个。
7
- */
8
- exports.MODEL_REGISTRY = {
9
- 'qwen3.7-max': [{ model: 'qwen3.7-max', provider: 'bailian' }],
10
- 'qwen-plus': [{ model: 'qwen-plus', provider: 'bailian' }],
11
- 'qwen-turbo': [{ model: 'qwen-turbo', provider: 'bailian' }],
12
- 'qwq-plus': [{ model: 'qwq-plus', provider: 'bailian' }],
13
- 'deepseek-v4-pro': [{ model: 'deepseek-v4-pro', provider: 'bailian' }],
14
- 'deepseek-v4-flash': [{ model: 'deepseek-v4-flash', provider: 'bailian' }],
15
- 'kimi-k2.6': [{ model: 'kimi-k2.6', provider: 'bailian' }],
16
- 'qwen-vl-plus': [{ model: 'qwen-vl-plus', provider: 'bailian' }],
17
- };
4
+ var models_1 = require("../llm_provider/models");
5
+ Object.defineProperty(exports, "MODEL_REGISTRY", { enumerable: true, get: function () { return models_1.MODEL_REGISTRY; } });
@@ -1,4 +1,4 @@
1
- import type { Message, StreamChunk } from './types';
1
+ import type { Message, StreamChunk } from '../llm_provider/types';
2
2
  import type { PredictConfig, PredictWithMessagesConfig } from './config';
3
3
  /**
4
4
  * LLM 静态类。封装 Provider 连接、请求组装、故障转移和返回解析。
@@ -37,7 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
37
37
  exports.LLM = void 0;
38
38
  const llm_1 = require("./llm");
39
39
  const config_1 = require("./config");
40
- const bailian_1 = require("./providers/bailian");
40
+ const bailian_1 = require("../llm_provider/bailian");
41
41
  const DEFAULT_BAILIAN_BASE_URL = 'https://dashscope.aliyuncs.com/compatible-mode/v1';
42
42
  const DEFAULT_BAILIAN_MODEL = 'qwen-max';
43
43
  function createBailianProvider() {
@@ -1,51 +1 @@
1
- /**
2
- * LLM 对话消息。支持 system、user、assistant 三种角色。
3
- */
4
- export interface Message {
5
- readonly role: 'system' | 'user' | 'assistant';
6
- readonly content: string;
7
- }
8
- /**
9
- * 标准化 LLM 请求参数。各 Provider 据此构建自身的协议请求。
10
- */
11
- export interface LLMRequest {
12
- readonly messages: ReadonlyArray<Message>;
13
- readonly temperature?: number;
14
- readonly maxTokens?: number;
15
- readonly topP?: number;
16
- readonly stream?: boolean;
17
- readonly model?: string;
18
- readonly responseFormat?: 'text' | 'json';
19
- }
20
- /**
21
- * 标准化 LLM 响应。各 Provider 将原始响应解析为此格式后返回。
22
- */
23
- export interface LLMResponse {
24
- readonly content: string | null;
25
- readonly usage?: {
26
- readonly promptTokens: number;
27
- readonly completionTokens: number;
28
- readonly totalTokens: number;
29
- };
30
- readonly model: string;
31
- }
32
- /**
33
- * 流式输出片段。迭代器每次 yield 一个 chunk。
34
- */
35
- export type StreamChunk = {
36
- readonly type: 'content';
37
- readonly delta: string;
38
- } | {
39
- readonly type: 'finish';
40
- readonly usage?: LLMResponse['usage'];
41
- };
42
- /**
43
- * Provider 配置。每个 Provider 实例需要一组连接参数。
44
- */
45
- export interface ProviderConfig {
46
- readonly name: string;
47
- readonly apiKey: string;
48
- readonly baseUrl: string;
49
- readonly defaultModel: string;
50
- readonly timeoutMs?: number;
51
- }
1
+ export type { Message, LLMRequest, LLMResponse, ProviderConfig, StreamChunk, } from '../llm_provider/types';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@keo-ai/axiom",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "description": "基于 LLM 的预测与推理库,支持多 Provider 切换",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",