@celljs/ai-pi 0.0.0-stage → 4.1.0

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 (158) hide show
  1. package/README.md +69 -2
  2. package/cell.yml +7 -0
  3. package/esm/node/chat/index.d.ts +3 -0
  4. package/esm/node/chat/index.js +4 -0
  5. package/esm/node/chat/index.js.map +1 -0
  6. package/esm/node/chat/pi-chat-model.d.ts +27 -0
  7. package/esm/node/chat/pi-chat-model.js +86 -0
  8. package/esm/node/chat/pi-chat-model.js.map +1 -0
  9. package/esm/node/chat/pi-chat-options.d.ts +9 -0
  10. package/esm/node/chat/pi-chat-options.js +2 -0
  11. package/esm/node/chat/pi-chat-options.js.map +1 -0
  12. package/esm/node/chat/pi-message-util.d.ts +11 -0
  13. package/esm/node/chat/pi-message-util.js +104 -0
  14. package/esm/node/chat/pi-message-util.js.map +1 -0
  15. package/esm/node/error/errors.d.ts +14 -0
  16. package/esm/node/error/errors.js +21 -0
  17. package/esm/node/error/errors.js.map +1 -0
  18. package/esm/node/error/index.d.ts +1 -0
  19. package/esm/node/error/index.js +2 -0
  20. package/esm/node/error/index.js.map +1 -0
  21. package/esm/node/index.d.ts +5 -0
  22. package/esm/node/index.js +6 -0
  23. package/esm/node/index.js.map +1 -0
  24. package/esm/node/models/index.d.ts +1 -0
  25. package/esm/node/models/index.js +2 -0
  26. package/esm/node/models/index.js.map +1 -0
  27. package/esm/node/models/pi-endpoint-util.d.ts +9 -0
  28. package/esm/node/models/pi-endpoint-util.js +51 -0
  29. package/esm/node/models/pi-endpoint-util.js.map +1 -0
  30. package/esm/node/models/pi-models-provider.d.ts +10 -0
  31. package/esm/node/models/pi-models-provider.js +80 -0
  32. package/esm/node/models/pi-models-provider.js.map +1 -0
  33. package/esm/node/module.d.ts +3 -0
  34. package/esm/node/module.js +4 -0
  35. package/esm/node/module.js.map +1 -0
  36. package/esm/node/pi/index.d.ts +2 -0
  37. package/esm/node/pi/index.js +3 -0
  38. package/esm/node/pi/index.js.map +1 -0
  39. package/esm/node/pi/pi-ai-util.d.ts +10 -0
  40. package/esm/node/pi/pi-ai-util.js +28 -0
  41. package/esm/node/pi/pi-ai-util.js.map +1 -0
  42. package/esm/node/pi/pi-types.d.ts +10 -0
  43. package/esm/node/pi/pi-types.js +2 -0
  44. package/esm/node/pi/pi-types.js.map +1 -0
  45. package/esm/node/pi-protocol.d.ts +49 -0
  46. package/esm/node/pi-protocol.js +5 -0
  47. package/esm/node/pi-protocol.js.map +1 -0
  48. package/esm/node/test/faux-pi-models.d.ts +29 -0
  49. package/esm/node/test/faux-pi-models.js +36 -0
  50. package/esm/node/test/faux-pi-models.js.map +1 -0
  51. package/esm/node/test/index.d.ts +2 -0
  52. package/esm/node/test/index.js +3 -0
  53. package/esm/node/test/index.js.map +1 -0
  54. package/esm/node/test/test-container.d.ts +13 -0
  55. package/esm/node/test/test-container.js +19 -0
  56. package/esm/node/test/test-container.js.map +1 -0
  57. package/esm/package.json +3 -0
  58. package/lib/node/chat/index.d.ts +4 -0
  59. package/lib/node/chat/index.d.ts.map +1 -0
  60. package/lib/node/chat/index.js +20 -0
  61. package/lib/node/chat/index.js.map +1 -0
  62. package/lib/node/chat/pi-chat-model.d.ts +28 -0
  63. package/lib/node/chat/pi-chat-model.d.ts.map +1 -0
  64. package/lib/node/chat/pi-chat-model.js +89 -0
  65. package/lib/node/chat/pi-chat-model.js.map +1 -0
  66. package/lib/node/chat/pi-chat-model.spec.d.ts +2 -0
  67. package/lib/node/chat/pi-chat-model.spec.d.ts.map +1 -0
  68. package/lib/node/chat/pi-chat-model.spec.js +98 -0
  69. package/lib/node/chat/pi-chat-model.spec.js.map +1 -0
  70. package/lib/node/chat/pi-chat-options.d.ts +10 -0
  71. package/lib/node/chat/pi-chat-options.d.ts.map +1 -0
  72. package/lib/node/chat/pi-chat-options.js +3 -0
  73. package/lib/node/chat/pi-chat-options.js.map +1 -0
  74. package/lib/node/chat/pi-message-util.d.ts +12 -0
  75. package/lib/node/chat/pi-message-util.d.ts.map +1 -0
  76. package/lib/node/chat/pi-message-util.js +107 -0
  77. package/lib/node/chat/pi-message-util.js.map +1 -0
  78. package/lib/node/error/errors.d.ts +15 -0
  79. package/lib/node/error/errors.d.ts.map +1 -0
  80. package/lib/node/error/errors.js +27 -0
  81. package/lib/node/error/errors.js.map +1 -0
  82. package/lib/node/error/index.d.ts +2 -0
  83. package/lib/node/error/index.d.ts.map +1 -0
  84. package/lib/node/error/index.js +18 -0
  85. package/lib/node/error/index.js.map +1 -0
  86. package/lib/node/index.d.ts +6 -0
  87. package/lib/node/index.d.ts.map +1 -0
  88. package/lib/node/index.js +22 -0
  89. package/lib/node/index.js.map +1 -0
  90. package/lib/node/models/index.d.ts +2 -0
  91. package/lib/node/models/index.d.ts.map +1 -0
  92. package/lib/node/models/index.js +18 -0
  93. package/lib/node/models/index.js.map +1 -0
  94. package/lib/node/models/pi-endpoint-util.d.ts +10 -0
  95. package/lib/node/models/pi-endpoint-util.d.ts.map +1 -0
  96. package/lib/node/models/pi-endpoint-util.js +54 -0
  97. package/lib/node/models/pi-endpoint-util.js.map +1 -0
  98. package/lib/node/models/pi-endpoint-util.spec.d.ts +2 -0
  99. package/lib/node/models/pi-endpoint-util.spec.d.ts.map +1 -0
  100. package/lib/node/models/pi-endpoint-util.spec.js +82 -0
  101. package/lib/node/models/pi-endpoint-util.spec.js.map +1 -0
  102. package/lib/node/models/pi-models-provider.d.ts +11 -0
  103. package/lib/node/models/pi-models-provider.d.ts.map +1 -0
  104. package/lib/node/models/pi-models-provider.js +83 -0
  105. package/lib/node/models/pi-models-provider.js.map +1 -0
  106. package/lib/node/module.d.ts +4 -0
  107. package/lib/node/module.d.ts.map +1 -0
  108. package/lib/node/module.js +6 -0
  109. package/lib/node/module.js.map +1 -0
  110. package/lib/node/pi/index.d.ts +3 -0
  111. package/lib/node/pi/index.d.ts.map +1 -0
  112. package/lib/node/pi/index.js +19 -0
  113. package/lib/node/pi/index.js.map +1 -0
  114. package/lib/node/pi/pi-ai-util.d.ts +11 -0
  115. package/lib/node/pi/pi-ai-util.d.ts.map +1 -0
  116. package/lib/node/pi/pi-ai-util.js +31 -0
  117. package/lib/node/pi/pi-ai-util.js.map +1 -0
  118. package/lib/node/pi/pi-types.d.ts +11 -0
  119. package/lib/node/pi/pi-types.d.ts.map +1 -0
  120. package/lib/node/pi/pi-types.js +3 -0
  121. package/lib/node/pi/pi-types.js.map +1 -0
  122. package/lib/node/pi-protocol.d.ts +50 -0
  123. package/lib/node/pi-protocol.d.ts.map +1 -0
  124. package/lib/node/pi-protocol.js +8 -0
  125. package/lib/node/pi-protocol.js.map +1 -0
  126. package/lib/node/test/faux-pi-models.d.ts +30 -0
  127. package/lib/node/test/faux-pi-models.d.ts.map +1 -0
  128. package/lib/node/test/faux-pi-models.js +40 -0
  129. package/lib/node/test/faux-pi-models.js.map +1 -0
  130. package/lib/node/test/index.d.ts +3 -0
  131. package/lib/node/test/index.d.ts.map +1 -0
  132. package/lib/node/test/index.js +19 -0
  133. package/lib/node/test/index.js.map +1 -0
  134. package/lib/node/test/test-container.d.ts +14 -0
  135. package/lib/node/test/test-container.d.ts.map +1 -0
  136. package/lib/node/test/test-container.js +25 -0
  137. package/lib/node/test/test-container.js.map +1 -0
  138. package/package.json +91 -4
  139. package/src/node/chat/index.ts +3 -0
  140. package/src/node/chat/pi-chat-model.spec.ts +113 -0
  141. package/src/node/chat/pi-chat-model.ts +76 -0
  142. package/src/node/chat/pi-chat-options.ts +10 -0
  143. package/src/node/chat/pi-message-util.ts +108 -0
  144. package/src/node/error/errors.ts +28 -0
  145. package/src/node/error/index.ts +1 -0
  146. package/src/node/index.ts +5 -0
  147. package/src/node/models/index.ts +1 -0
  148. package/src/node/models/pi-endpoint-util.spec.ts +88 -0
  149. package/src/node/models/pi-endpoint-util.ts +54 -0
  150. package/src/node/models/pi-models-provider.ts +66 -0
  151. package/src/node/module.ts +4 -0
  152. package/src/node/pi/index.ts +2 -0
  153. package/src/node/pi/pi-ai-util.ts +34 -0
  154. package/src/node/pi/pi-types.ts +12 -0
  155. package/src/node/pi-protocol.ts +57 -0
  156. package/src/node/test/faux-pi-models.ts +53 -0
  157. package/src/node/test/index.ts +2 -0
  158. package/src/node/test/test-container.ts +28 -0
package/README.md CHANGED
@@ -1,3 +1,70 @@
1
- # Temporary Holding Version
1
+ # Cell - AI pi Component
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 把 [pi-ai](https://www.npmjs.com/package/@earendil-works/pi-ai) 接进 Cell:pi-ai 统一了 20 多家模型服务商(Anthropic、OpenAI、Google、DeepSeek、xAI、OpenRouter、Bedrock、Ollama 等 OpenAI 兼容服务……)的调用、模型目录、凭据和用量统计。本组件提供:
4
+
5
+ - `PiModelsProvider`:应用级的 pi-ai `Models` 集合,由 `cell.ai.pi` 配置;
6
+ - `PiChatModel`:@celljs/ai-core 的 `ChatModel` 实现,经 `ProxyChatModel` 用 `pi:<provider>/<model id>` 调用;
7
+ - [@celljs/ai-agent](../ai-agent) 的 agent 用它取模型。
8
+
9
+ pi-ai 是 ES module 包,组件用动态 `import()` 加载,第一次用到模型时才加载。需要 Node.js >= 22.19 或 Bun。
10
+
11
+ ## 配置
12
+
13
+ ```yaml
14
+ cell:
15
+ ai:
16
+ pi:
17
+ providers: [anthropic, deepseek] # 默认 all:注册 pi-ai 全部内置服务商
18
+ apiKeys: # 只放在内存里;服务商也会读 ANTHROPIC_API_KEY 等环境变量
19
+ deepseek: "${ env.MY_DEEPSEEK_KEY }"
20
+ ```
21
+
22
+ ### 兼容端点
23
+
24
+ `endpoints` 把 OpenAI / Anthropic 兼容的服务注册成服务商,模型名是 `<端点 id>/<模型 id>`:
25
+
26
+ ```yaml
27
+ cell:
28
+ ai:
29
+ pi:
30
+ endpoints:
31
+ local: # 模型写 local/qwen3
32
+ baseUrl: http://localhost:11434/v1 # Ollama;vLLM、LM Studio、自建网关同理
33
+ models: [qwen3, { id: deepseek-r1, reasoning: true, contextWindow: 64000 }]
34
+ gateway:
35
+ baseUrl: https://llm.example.com/v1
36
+ api: anthropic-messages # 默认 openai-completions;还支持 openai-responses
37
+ apiKey: "${ env.GATEWAY_KEY }"
38
+ models: [claude-sonnet-4-5]
39
+ ```
40
+
41
+ 没有密钥的端点会收到占位密钥 `no-key`;`apiKeys` 里同名的项优先于 `apiKey`。
42
+
43
+ ## 使用
44
+
45
+ ```typescript
46
+ import { type ChatModel, PromptTemplate, ProxyChatModel } from '@celljs/ai-core';
47
+ import { Autowired, Component } from '@celljs/core';
48
+
49
+ @Component()
50
+ export class Assistant {
51
+ @Autowired(ProxyChatModel)
52
+ protected readonly chatModel: ChatModel;
53
+
54
+ @Autowired(PromptTemplate)
55
+ protected readonly promptTemplate: PromptTemplate;
56
+
57
+ async ask(question: string): Promise<string> {
58
+ const prompt = await this.promptTemplate.create(question, { chatOptions: { model: 'pi:anthropic/claude-sonnet-4-5' } });
59
+ return (await this.chatModel.call(prompt)).result.output.content;
60
+ }
61
+ }
62
+ ```
63
+
64
+ `PiChatOptions` 在 ai-core 的 `ChatOptions` 之外支持 `reasoning`(思考等级)和 `tools`(JSON Schema 参数的工具,模型的调用在 `AssistantMessage.toolCalls` 里)。`stream()` 每个文本增量发一个响应,最后一个响应带完整消息、结束原因(pi-ai 的 stop reason:`stop`、`toolUse`、`length`)和用量。模型返回错误时抛 `PiModelError`,模型名写错时抛 `PiModelNotFoundError` 并列出可用模型。
65
+
66
+ 要注册自定义服务商(例如自建的 OpenAI 兼容网关),实现 `PiModelsContribution`,在 `configure(models)` 里调用 `models.setProvider(...)`(见 pi-ai 文档 Custom Providers)。
67
+
68
+ ## 测试
69
+
70
+ `@celljs/ai-pi/lib/node/test` 的 `createPiTestContainer()` 和 `FauxPiModels` 基于 pi-ai 的 faux provider:脚本化回复、记录每次请求的上下文,不联网。
package/cell.yml ADDED
@@ -0,0 +1,7 @@
1
+ cell:
2
+ ai:
3
+ pi:
4
+ # Built-in pi-ai providers to register: all, or provider ids such as [anthropic, openai].
5
+ providers: all
6
+ # API keys by provider id, kept in memory; providers also read their environment variables.
7
+ apiKeys: {}
@@ -0,0 +1,3 @@
1
+ export * from './pi-chat-model.js';
2
+ export * from './pi-chat-options.js';
3
+ export * from './pi-message-util.js';
@@ -0,0 +1,4 @@
1
+ export * from './pi-chat-model.js';
2
+ export * from './pi-chat-options.js';
3
+ export * from './pi-message-util.js';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { type ChatModel, type ChatResponse, type Prompt } from '@celljs/ai-core';
2
+ import { Observable } from 'rxjs';
3
+ import type { PiModel } from '../pi/index.js';
4
+ import { PiModelsProvider } from '../pi-protocol.js';
5
+ import type { PiChatOptions } from './pi-chat-options.js';
6
+ /**
7
+ * ai-core's `ChatModel` on pi-ai: every provider pi-ai knows, with `<provider>/<model id>` as the model.
8
+ * Through `ProxyChatModel` the model is `pi:<provider>/<model id>`.
9
+ */
10
+ export declare class PiChatModel implements ChatModel {
11
+ readonly provider = "pi";
12
+ protected readonly modelsProvider: PiModelsProvider;
13
+ call(prompt: Prompt): Promise<ChatResponse>;
14
+ /** Emits one response per text delta, then a last one with the whole message (text, tool calls, usage). */
15
+ stream(prompt: Prompt): Promise<Observable<ChatResponse>>;
16
+ protected resolve(prompt: Prompt): Promise<{
17
+ model: PiModel;
18
+ options: PiChatOptions;
19
+ }>;
20
+ protected requestOptions(options: PiChatOptions): {
21
+ signal: AbortSignal | undefined;
22
+ temperature: number | undefined;
23
+ maxTokens: number | undefined;
24
+ reasoning: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
25
+ headers: Record<string, string> | undefined;
26
+ };
27
+ }
@@ -0,0 +1,86 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { ChatModel as ChatModelId } from '@celljs/ai-core';
11
+ import { Autowired, Component, IllegalArgumentError } from '@celljs/core';
12
+ import { Observable } from 'rxjs';
13
+ import { PiModelError } from '../error/index.js';
14
+ import { PiModelsProvider } from '../pi-protocol.js';
15
+ import { PiMessageUtil } from './pi-message-util.js';
16
+ /**
17
+ * ai-core's `ChatModel` on pi-ai: every provider pi-ai knows, with `<provider>/<model id>` as the model.
18
+ * Through `ProxyChatModel` the model is `pi:<provider>/<model id>`.
19
+ */
20
+ let PiChatModel = class PiChatModel {
21
+ constructor() {
22
+ this.provider = 'pi';
23
+ }
24
+ async call(prompt) {
25
+ var _a;
26
+ const { model, options } = await this.resolve(prompt);
27
+ const models = await this.modelsProvider.provide();
28
+ const message = await models.completeSimple(model, PiMessageUtil.toContext(prompt.instructions, model, options), this.requestOptions(options));
29
+ if (message.stopReason === 'error' || message.stopReason === 'aborted') {
30
+ throw new PiModelError(`${model.provider}/${model.id}`, (_a = message.errorMessage) !== null && _a !== void 0 ? _a : message.stopReason);
31
+ }
32
+ return PiMessageUtil.toChatResponse(PiMessageUtil.fromAssistantMessage(message), message);
33
+ }
34
+ /** Emits one response per text delta, then a last one with the whole message (text, tool calls, usage). */
35
+ async stream(prompt) {
36
+ const { model, options } = await this.resolve(prompt);
37
+ const models = await this.modelsProvider.provide();
38
+ const context = PiMessageUtil.toContext(prompt.instructions, model, options);
39
+ return new Observable(subscriber => {
40
+ const controller = new AbortController();
41
+ const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
42
+ (async () => {
43
+ var _a;
44
+ for await (const event of models.streamSimple(model, context, { ...this.requestOptions(options), signal })) {
45
+ if (event.type === 'text_delta') {
46
+ subscriber.next(PiMessageUtil.toChatResponse(PiMessageUtil.fromAssistantMessage({ ...event.partial, content: [{ type: 'text', text: event.delta }] })));
47
+ }
48
+ else if (event.type === 'done') {
49
+ subscriber.next(PiMessageUtil.toChatResponse(PiMessageUtil.fromAssistantMessage(event.message), event.message));
50
+ }
51
+ else if (event.type === 'error') {
52
+ throw new PiModelError(`${model.provider}/${model.id}`, (_a = event.error.errorMessage) !== null && _a !== void 0 ? _a : event.reason);
53
+ }
54
+ }
55
+ subscriber.complete();
56
+ })().catch(error => subscriber.error(error));
57
+ return () => controller.abort();
58
+ });
59
+ }
60
+ async resolve(prompt) {
61
+ var _a;
62
+ const options = ((_a = prompt.options) !== null && _a !== void 0 ? _a : {});
63
+ if (!options.model) {
64
+ throw new IllegalArgumentError('Model is not set! Use "<provider>/<model id>", e.g. anthropic/claude-sonnet-4-5.');
65
+ }
66
+ return { model: await this.modelsProvider.resolve(options.model), options };
67
+ }
68
+ requestOptions(options) {
69
+ return {
70
+ signal: options.signal,
71
+ temperature: options.temperature,
72
+ maxTokens: options.maxTokens,
73
+ reasoning: options.reasoning,
74
+ headers: options.httpHeaders,
75
+ };
76
+ }
77
+ };
78
+ __decorate([
79
+ Autowired(PiModelsProvider),
80
+ __metadata("design:type", Object)
81
+ ], PiChatModel.prototype, "modelsProvider", void 0);
82
+ PiChatModel = __decorate([
83
+ Component(ChatModelId)
84
+ ], PiChatModel);
85
+ export { PiChatModel };
86
+ //# sourceMappingURL=pi-chat-model.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-chat-model.js","sourceRoot":"","sources":["../../../src/node/chat/pi-chat-model.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import type { ChatOptions } from '@celljs/ai-core';
2
+ import type { PiThinkingLevel, PiTool } from '../pi/index.js';
3
+ /** Options of {@link PiChatModel}: the model is `<provider>/<model id>` (`pi:<provider>/<model id>` through ProxyChatModel). */
4
+ export interface PiChatOptions extends ChatOptions {
5
+ /** Thinking level for models that reason. */
6
+ reasoning?: PiThinkingLevel;
7
+ /** Tools the model may call, with JSON Schema parameters; tool calls come back in `AssistantMessage.toolCalls`. */
8
+ tools?: PiTool[];
9
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pi-chat-options.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-chat-options.js","sourceRoot":"","sources":["../../../src/node/chat/pi-chat-options.ts"],"names":[],"mappings":""}
@@ -0,0 +1,11 @@
1
+ import { AssistantMessage, type ChatResponse, type Message } from '@celljs/ai-core';
2
+ import type { PiAssistantMessage, PiContext, PiModel } from '../pi/index.js';
3
+ import type { PiChatOptions } from './pi-chat-options.js';
4
+ /** Converts between ai-core prompts and responses and pi-ai contexts and assistant messages. */
5
+ export declare namespace PiMessageUtil {
6
+ function toContext(messages: Message[], model: PiModel, options?: PiChatOptions): PiContext;
7
+ /** The text and tool calls of a pi-ai assistant message; thinking goes to `metadata.thinking`. */
8
+ function fromAssistantMessage(message: PiAssistantMessage): AssistantMessage;
9
+ /** A response for `output`; `message` gives the finish reason (pi-ai's stop reason), usage and model. */
10
+ function toChatResponse(output: AssistantMessage, message?: PiAssistantMessage): ChatResponse;
11
+ }
@@ -0,0 +1,104 @@
1
+ import { AssistantMessage, ChatGenerationMetadata, ChatResponseMetadata, SystemMessage, ToolResponseMessage, UserMessage, } from '@celljs/ai-core';
2
+ import { ByteUtil, IllegalArgumentError } from '@celljs/core';
3
+ /** Converts between ai-core prompts and responses and pi-ai contexts and assistant messages. */
4
+ export var PiMessageUtil;
5
+ (function (PiMessageUtil) {
6
+ function toContext(messages, model, options = {}) {
7
+ const system = [];
8
+ const converted = [];
9
+ for (const message of messages) {
10
+ if (message instanceof SystemMessage) {
11
+ system.push(message.content);
12
+ }
13
+ else if (message instanceof UserMessage) {
14
+ converted.push(toUserMessage(message));
15
+ }
16
+ else if (message instanceof AssistantMessage) {
17
+ converted.push(toAssistantMessage(message, model));
18
+ }
19
+ else if (message instanceof ToolResponseMessage) {
20
+ for (const response of message.responses) {
21
+ converted.push({
22
+ role: 'toolResult',
23
+ toolCallId: response.id,
24
+ toolName: response.name,
25
+ content: [{ type: 'text', text: response.responseData }],
26
+ isError: false,
27
+ timestamp: Date.now(),
28
+ });
29
+ }
30
+ }
31
+ else {
32
+ throw new IllegalArgumentError(`Unsupported message type: ${message.messageType}`);
33
+ }
34
+ }
35
+ return { systemPrompt: system.length ? system.join('\n\n') : undefined, messages: converted, tools: options.tools };
36
+ }
37
+ PiMessageUtil.toContext = toContext;
38
+ function toUserMessage(message) {
39
+ var _a;
40
+ if (!((_a = message.media) === null || _a === void 0 ? void 0 : _a.length)) {
41
+ return { role: 'user', content: message.content, timestamp: Date.now() };
42
+ }
43
+ const images = message.media.map(media => ({
44
+ type: 'image',
45
+ data: typeof media.data === 'string' ? media.data : ByteUtil.encodeBase64(media.data),
46
+ mimeType: media.mimeType.toString(),
47
+ }));
48
+ return { role: 'user', content: [{ type: 'text', text: message.content }, ...images], timestamp: Date.now() };
49
+ }
50
+ function toAssistantMessage(message, model) {
51
+ var _a;
52
+ const toolCalls = ((_a = message.toolCalls) !== null && _a !== void 0 ? _a : []).map(call => ({
53
+ type: 'toolCall',
54
+ id: call.id,
55
+ name: call.name,
56
+ arguments: call.arguments ? JSON.parse(call.arguments) : {},
57
+ }));
58
+ return {
59
+ role: 'assistant',
60
+ content: [...(message.content ? [{ type: 'text', text: message.content }] : []), ...toolCalls],
61
+ api: model.api,
62
+ provider: model.provider,
63
+ model: model.id,
64
+ usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
65
+ stopReason: toolCalls.length ? 'toolUse' : 'stop',
66
+ timestamp: Date.now(),
67
+ };
68
+ }
69
+ /** The text and tool calls of a pi-ai assistant message; thinking goes to `metadata.thinking`. */
70
+ function fromAssistantMessage(message) {
71
+ let text = '';
72
+ let thinking = '';
73
+ const toolCalls = [];
74
+ for (const block of message.content) {
75
+ if (block.type === 'text') {
76
+ text += block.text;
77
+ }
78
+ else if (block.type === 'thinking') {
79
+ thinking += block.thinking;
80
+ }
81
+ else if (block.type === 'toolCall') {
82
+ toolCalls.push({ id: block.id, type: 'function', name: block.name, arguments: JSON.stringify(block.arguments) });
83
+ }
84
+ }
85
+ return new AssistantMessage(text, [], thinking ? { thinking } : {}, toolCalls);
86
+ }
87
+ PiMessageUtil.fromAssistantMessage = fromAssistantMessage;
88
+ /** A response for `output`; `message` gives the finish reason (pi-ai's stop reason), usage and model. */
89
+ function toChatResponse(output, message) {
90
+ var _a, _b;
91
+ const generation = { output, metadata: ChatGenerationMetadata.from(message === null || message === void 0 ? void 0 : message.stopReason) };
92
+ const metadata = ChatResponseMetadata.createEmpty();
93
+ if (message) {
94
+ metadata.id = (_a = message.responseId) !== null && _a !== void 0 ? _a : '';
95
+ metadata.model = (_b = message.responseModel) !== null && _b !== void 0 ? _b : message.model;
96
+ metadata.usage = { promptTokens: message.usage.input, generationTokens: message.usage.output, totalTokens: message.usage.totalTokens };
97
+ metadata.extra.provider = message.provider;
98
+ metadata.extra.cost = message.usage.cost;
99
+ }
100
+ return { result: generation, results: [generation], metadata };
101
+ }
102
+ PiMessageUtil.toChatResponse = toChatResponse;
103
+ })(PiMessageUtil || (PiMessageUtil = {}));
104
+ //# sourceMappingURL=pi-message-util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-message-util.js","sourceRoot":"","sources":["../../../src/node/chat/pi-message-util.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { CustomError } from '@celljs/core';
2
+ export declare class PiError extends CustomError {
3
+ }
4
+ export declare class PiModelNotFoundError extends PiError {
5
+ readonly model: string;
6
+ readonly available: string[];
7
+ constructor(model: string, available: string[]);
8
+ }
9
+ /** The model answered with an error (pi-ai reports provider failures as messages, not exceptions). */
10
+ export declare class PiModelError extends PiError {
11
+ readonly model: string;
12
+ readonly reason: string;
13
+ constructor(model: string, reason: string);
14
+ }
@@ -0,0 +1,21 @@
1
+ import { CustomError } from '@celljs/core';
2
+ export class PiError extends CustomError {
3
+ }
4
+ export class PiModelNotFoundError extends PiError {
5
+ constructor(model, available) {
6
+ super(`The model ${model} is not known to pi-ai. Use "<provider>/<model id>"${available.length
7
+ ? `, one of: ${available.join(', ')}`
8
+ : '; no model has credentials yet: set the API key of a provider (e.g. ANTHROPIC_API_KEY) or cell.ai.pi.apiKeys'}.`);
9
+ this.model = model;
10
+ this.available = available;
11
+ }
12
+ }
13
+ /** The model answered with an error (pi-ai reports provider failures as messages, not exceptions). */
14
+ export class PiModelError extends PiError {
15
+ constructor(model, reason) {
16
+ super(`The model ${model} failed: ${reason}`);
17
+ this.model = model;
18
+ this.reason = reason;
19
+ }
20
+ }
21
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/node/error/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,OAAQ,SAAQ,WAAW;CAAG;AAE3C,MAAM,OAAO,oBAAqB,SAAQ,OAAO;IAC7C,YACa,KAAa,EACb,SAAmB;QAE5B,KAAK,CACD,aAAa,KAAK,sDACd,SAAS,CAAC,MAAM;YACZ,CAAC,CAAC,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrC,CAAC,CAAC,8GACV,GAAG,CACN,CAAC;qBATO,KAAK;yBACL,SAAS;IAStB,CAAC;CACJ;AAED,sGAAsG;AACtG,MAAM,OAAO,YAAa,SAAQ,OAAO;IACrC,YACa,KAAa,EACb,MAAc;QAEvB,KAAK,CAAC,aAAa,KAAK,YAAY,MAAM,EAAE,CAAC,CAAC;qBAHrC,KAAK;sBACL,MAAM;IAGnB,CAAC;CACJ"}
@@ -0,0 +1 @@
1
+ export * from './errors.js';
@@ -0,0 +1,2 @@
1
+ export * from './errors.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './chat/index.js';
2
+ export * from './error/index.js';
3
+ export * from './models/index.js';
4
+ export * from './pi/index.js';
5
+ export * from './pi-protocol.js';
@@ -0,0 +1,6 @@
1
+ export * from './chat/index.js';
2
+ export * from './error/index.js';
3
+ export * from './models/index.js';
4
+ export * from './pi/index.js';
5
+ export * from './pi-protocol.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,eAAe,CAAC"}
@@ -0,0 +1 @@
1
+ export * from './pi-models-provider.js';
@@ -0,0 +1,2 @@
1
+ export * from './pi-models-provider.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { type PiProvider } from '../pi/index.js';
2
+ import type { PiEndpoint, PiEndpointApi } from '../pi-protocol.js';
3
+ /** Turns `cell.ai.pi.endpoints` into pi-ai providers. */
4
+ export declare namespace PiEndpointUtil {
5
+ const APIS: PiEndpointApi[];
6
+ /** The key sent to endpoints configured without one. */
7
+ const NO_KEY = "no-key";
8
+ function toProvider(id: string, endpoint: PiEndpoint): Promise<PiProvider>;
9
+ }
@@ -0,0 +1,51 @@
1
+ import { PiAiUtil } from '../pi/index.js';
2
+ const API_LOADERS = {
3
+ 'openai-completions': async () => (await import('@earendil-works/pi-ai/api/openai-completions.lazy')).openAICompletionsApi(),
4
+ 'openai-responses': async () => (await import('@earendil-works/pi-ai/api/openai-responses.lazy')).openAIResponsesApi(),
5
+ 'anthropic-messages': async () => (await import('@earendil-works/pi-ai/api/anthropic-messages.lazy')).anthropicMessagesApi(),
6
+ };
7
+ /** Turns `cell.ai.pi.endpoints` into pi-ai providers. */
8
+ export var PiEndpointUtil;
9
+ (function (PiEndpointUtil) {
10
+ PiEndpointUtil.APIS = Object.keys(API_LOADERS);
11
+ /** The key sent to endpoints configured without one. */
12
+ PiEndpointUtil.NO_KEY = 'no-key';
13
+ async function toProvider(id, endpoint) {
14
+ var _a;
15
+ const api = (_a = endpoint.api) !== null && _a !== void 0 ? _a : 'openai-completions';
16
+ const load = API_LOADERS[api];
17
+ if (!load) {
18
+ throw new TypeError(`cell.ai.pi.endpoints.${id}.api must be one of ${PiEndpointUtil.APIS.join(', ')}, not ${api}.`);
19
+ }
20
+ const ai = await PiAiUtil.load();
21
+ const key = endpoint.apiKey || undefined;
22
+ return ai.createProvider({
23
+ id,
24
+ baseUrl: endpoint.baseUrl,
25
+ // A stored key (cell.ai.pi.apiKeys) wins over the configured one. pi-ai's OpenAI client needs a key,
26
+ // so servers without keys (Ollama, LM Studio) get a placeholder they ignore.
27
+ auth: {
28
+ apiKey: { name: `${id} API key`, resolve: async ({ credential }) => { var _a, _b; return ({ auth: { apiKey: (_b = (_a = credential === null || credential === void 0 ? void 0 : credential.key) !== null && _a !== void 0 ? _a : key) !== null && _b !== void 0 ? _b : PiEndpointUtil.NO_KEY } }); } },
29
+ },
30
+ models: endpoint.models.map(model => toModel(id, endpoint.baseUrl, api, typeof model === 'string' ? { id: model } : model)),
31
+ api: await load(),
32
+ });
33
+ }
34
+ PiEndpointUtil.toProvider = toProvider;
35
+ function toModel(provider, baseUrl, api, model) {
36
+ var _a, _b, _c, _d;
37
+ return {
38
+ id: model.id,
39
+ name: (_a = model.name) !== null && _a !== void 0 ? _a : model.id,
40
+ api,
41
+ provider,
42
+ baseUrl,
43
+ reasoning: (_b = model.reasoning) !== null && _b !== void 0 ? _b : false,
44
+ input: model.images ? ['text', 'image'] : ['text'],
45
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
46
+ contextWindow: (_c = model.contextWindow) !== null && _c !== void 0 ? _c : 128000,
47
+ maxTokens: (_d = model.maxTokens) !== null && _d !== void 0 ? _d : 16384,
48
+ };
49
+ }
50
+ })(PiEndpointUtil || (PiEndpointUtil = {}));
51
+ //# sourceMappingURL=pi-endpoint-util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-endpoint-util.js","sourceRoot":"","sources":["../../../src/node/models/pi-endpoint-util.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type Models, type PiModel } from '../pi/index.js';
2
+ import { PiModelsContribution, PiModelsProvider, type PiOptions } from '../pi-protocol.js';
3
+ export declare class DefaultPiModelsProvider implements PiModelsProvider {
4
+ protected readonly options?: PiOptions;
5
+ protected readonly contributions: PiModelsContribution[];
6
+ protected models?: Promise<Models>;
7
+ provide(): Promise<Models>;
8
+ resolve(ref: string): Promise<PiModel>;
9
+ protected doProvide(): Promise<Models>;
10
+ }
@@ -0,0 +1,80 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { Autowired, Component, Optional, Value } from '@celljs/core';
11
+ import { PiModelNotFoundError } from '../error/index.js';
12
+ import { PiAiUtil } from '../pi/index.js';
13
+ import { PI_OPTIONS, PiModelsContribution, PiModelsProvider } from '../pi-protocol.js';
14
+ import { PiEndpointUtil } from './pi-endpoint-util.js';
15
+ let DefaultPiModelsProvider = class DefaultPiModelsProvider {
16
+ constructor() {
17
+ this.contributions = [];
18
+ }
19
+ provide() {
20
+ if (!this.models) {
21
+ const models = this.doProvide();
22
+ this.models = models;
23
+ models.catch(() => {
24
+ if (this.models === models) {
25
+ this.models = undefined;
26
+ }
27
+ });
28
+ }
29
+ return this.models;
30
+ }
31
+ async resolve(ref) {
32
+ const models = await this.provide();
33
+ const index = ref.indexOf('/');
34
+ const model = index > 0 ? models.getModel(ref.slice(0, index), ref.slice(index + 1)) : undefined;
35
+ if (!model) {
36
+ const available = (await models.getAvailable()).map(m => `${m.provider}/${m.id}`);
37
+ throw new PiModelNotFoundError(ref, available);
38
+ }
39
+ return model;
40
+ }
41
+ async doProvide() {
42
+ var _a, _b, _c, _d;
43
+ const options = (_a = this.options) !== null && _a !== void 0 ? _a : {};
44
+ const [ai, all] = await Promise.all([PiAiUtil.load(), PiAiUtil.loadProviders()]);
45
+ const credentials = new ai.InMemoryCredentialStore();
46
+ const models = ai.createModels({ credentials });
47
+ const wanted = options.providers && options.providers !== 'all' ? new Set(options.providers) : undefined;
48
+ for (const provider of all.builtinProviders()) {
49
+ if (!wanted || wanted.has(provider.id)) {
50
+ models.setProvider(provider);
51
+ }
52
+ }
53
+ for (const [id, endpoint] of Object.entries((_b = options.endpoints) !== null && _b !== void 0 ? _b : {})) {
54
+ models.setProvider(await PiEndpointUtil.toProvider(id, endpoint));
55
+ }
56
+ for (const [provider, key] of Object.entries((_c = options.apiKeys) !== null && _c !== void 0 ? _c : {})) {
57
+ if (key) {
58
+ await credentials.modify(provider, async () => ({ type: 'api_key', key }));
59
+ }
60
+ }
61
+ for (const contribution of (_d = this.contributions) !== null && _d !== void 0 ? _d : []) {
62
+ await contribution.configure(models);
63
+ }
64
+ return models;
65
+ }
66
+ };
67
+ __decorate([
68
+ Value(PI_OPTIONS),
69
+ __metadata("design:type", Object)
70
+ ], DefaultPiModelsProvider.prototype, "options", void 0);
71
+ __decorate([
72
+ Autowired(PiModelsContribution),
73
+ Optional(),
74
+ __metadata("design:type", Array)
75
+ ], DefaultPiModelsProvider.prototype, "contributions", void 0);
76
+ DefaultPiModelsProvider = __decorate([
77
+ Component(PiModelsProvider)
78
+ ], DefaultPiModelsProvider);
79
+ export { DefaultPiModelsProvider };
80
+ //# sourceMappingURL=pi-models-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-models-provider.js","sourceRoot":"","sources":["../../../src/node/models/pi-models-provider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import './index.js';
2
+ declare const _default: import("inversify").interfaces.ContainerModule;
3
+ export default _default;
@@ -0,0 +1,4 @@
1
+ import { autoBind } from '@celljs/core';
2
+ import './index.js';
3
+ export default autoBind();
4
+ //# sourceMappingURL=module.js.map