@celljs/ai-pi 0.0.0-stage → 4.0.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 +92 -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
@@ -0,0 +1,11 @@
1
+ /** The module namespace of `@earendil-works/pi-ai`. */
2
+ export type PiAi = typeof import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } });
3
+ /** The module namespace of `@earendil-works/pi-ai/providers/all`. */
4
+ export type PiAiProviders = typeof import('@earendil-works/pi-ai/providers/all', { with: { 'resolution-mode': 'import' } });
5
+ export declare namespace PiAiUtil {
6
+ /** Loads pi-ai once, with a dynamic `import()`: it is an ES module package. */
7
+ function load(): Promise<PiAi>;
8
+ /** Loads the factories of pi-ai's built-in providers once. */
9
+ function loadProviders(): Promise<PiAiProviders>;
10
+ }
11
+ //# sourceMappingURL=pi-ai-util.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-ai-util.d.ts","sourceRoot":"","sources":["../../../src/node/pi/pi-ai-util.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,MAAM,IAAI,GAAG,cAAc,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,CAAE,CAAC;AAEpG,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,cAAc,qCAAqC,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,CAAE,CAAC;AAE3H,yBAAiB,QAAQ,CAAC;IAItB,+EAA+E;IAC/E,SAAgB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpC;IAED,8DAA8D;IAC9D,SAAgB,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAMtD;CAKJ"}
@@ -0,0 +1,31 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PiAiUtil = void 0;
4
+ const error_1 = require("../error");
5
+ var PiAiUtil;
6
+ (function (PiAiUtil) {
7
+ let ai;
8
+ let providers;
9
+ /** Loads pi-ai once, with a dynamic `import()`: it is an ES module package. */
10
+ function load() {
11
+ ai !== null && ai !== void 0 ? ai : (ai = import('@earendil-works/pi-ai').catch(cause => {
12
+ ai = undefined;
13
+ throw notLoaded(cause);
14
+ }));
15
+ return ai;
16
+ }
17
+ PiAiUtil.load = load;
18
+ /** Loads the factories of pi-ai's built-in providers once. */
19
+ function loadProviders() {
20
+ providers !== null && providers !== void 0 ? providers : (providers = import('@earendil-works/pi-ai/providers/all').catch(cause => {
21
+ providers = undefined;
22
+ throw notLoaded(cause);
23
+ }));
24
+ return providers;
25
+ }
26
+ PiAiUtil.loadProviders = loadProviders;
27
+ function notLoaded(cause) {
28
+ return new error_1.PiError('Cannot load @earendil-works/pi-ai. Install it next to @celljs/ai-pi; it needs Node.js >= 22.19.0 or Bun.', { cause });
29
+ }
30
+ })(PiAiUtil || (exports.PiAiUtil = PiAiUtil = {}));
31
+ //# sourceMappingURL=pi-ai-util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-ai-util.js","sourceRoot":"","sources":["../../../src/node/pi/pi-ai-util.ts"],"names":[],"mappings":";;;AAAA,oCAAmC;AAQnC,IAAiB,QAAQ,CAyBxB;AAzBD,WAAiB,QAAQ;IACrB,IAAI,EAA6B,CAAC;IAClC,IAAI,SAA6C,CAAC;IAElD,+EAA+E;IAC/E,SAAgB,IAAI;QAChB,EAAE,aAAF,EAAE,cAAF,EAAE,IAAF,EAAE,GAAK,MAAM,CAAC,uBAAuB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACjD,EAAE,GAAG,SAAS,CAAC;YACf,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,EAAC;QACH,OAAO,EAAE,CAAC;IACd,CAAC;IANe,SAAA,IAAI,OAMnB,CAAA;IAED,8DAA8D;IAC9D,SAAgB,aAAa;QACzB,SAAS,aAAT,SAAS,cAAT,SAAS,IAAT,SAAS,GAAK,MAAM,CAAC,qCAAqC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACtE,SAAS,GAAG,SAAS,CAAC;YACtB,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,EAAC;QACH,OAAO,SAAS,CAAC;IACrB,CAAC;IANe,SAAA,aAAa,gBAM5B,CAAA;IAED,SAAS,SAAS,CAAC,KAAc;QAC7B,OAAO,IAAI,eAAO,CAAC,0GAA0G,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9I,CAAC;AACL,CAAC,EAzBgB,QAAQ,aAAR,QAAQ,GAAR,QAAQ,QAyBxB"}
@@ -0,0 +1,11 @@
1
+ export type Models = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).MutableModels;
2
+ export type PiModel = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).Model<any>;
3
+ export type PiContext = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).Context;
4
+ export type PiMessage = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).Message;
5
+ export type PiAssistantMessage = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).AssistantMessage;
6
+ export type PiAssistantMessageEvent = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).AssistantMessageEvent;
7
+ export type PiTool = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).Tool;
8
+ export type PiThinkingLevel = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).ThinkingLevel;
9
+ export type PiProvider = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).Provider;
10
+ export type CredentialStore = import('@earendil-works/pi-ai', { with: { 'resolution-mode': 'import' } }).CredentialStore;
11
+ //# sourceMappingURL=pi-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-types.d.ts","sourceRoot":"","sources":["../../../src/node/pi/pi-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,aAAa,CAAC;AAC7G,MAAM,MAAM,OAAO,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3G,MAAM,MAAM,SAAS,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,OAAO,CAAC;AAC1G,MAAM,MAAM,SAAS,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,OAAO,CAAC;AAC1G,MAAM,MAAM,kBAAkB,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,gBAAgB,CAAC;AAC5H,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,qBAAqB,CAAC;AACtI,MAAM,MAAM,MAAM,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,IAAI,CAAC;AACpG,MAAM,MAAM,eAAe,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,aAAa,CAAC;AACtH,MAAM,MAAM,UAAU,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,QAAQ,CAAC;AAC5G,MAAM,MAAM,eAAe,GAAG,OAAO,uBAAuB,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=pi-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-types.js","sourceRoot":"","sources":["../../../src/node/pi/pi-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,50 @@
1
+ import type { Models, PiModel } from './pi';
2
+ export declare const PiModelsProvider: unique symbol;
3
+ export declare const PiModelsContribution: unique symbol;
4
+ /** Configuration key of {@link PiOptions}. */
5
+ export declare const PI_OPTIONS = "cell.ai.pi";
6
+ /** `cell.ai.pi`. */
7
+ export interface PiOptions {
8
+ /** Built-in providers to register: `all`, or provider ids such as `[anthropic, openai]`. Default: all. */
9
+ providers?: 'all' | string[];
10
+ /** Extra providers by id: OpenAI- or Anthropic-compatible endpoints such as Ollama, vLLM, LM Studio or a gateway. */
11
+ endpoints?: Record<string, PiEndpoint>;
12
+ /** API keys by provider id, kept in memory. Empty values are ignored; providers also read their environment variables. */
13
+ apiKeys?: Record<string, string | undefined>;
14
+ }
15
+ /** Wire protocols {@link PiEndpoint} speaks. */
16
+ export type PiEndpointApi = 'openai-completions' | 'openai-responses' | 'anthropic-messages';
17
+ /** An endpoint registered as a pi-ai provider; its models are `<endpoint id>/<model id>`. */
18
+ export interface PiEndpoint {
19
+ /** e.g. `http://localhost:11434/v1` for Ollama. */
20
+ baseUrl: string;
21
+ /** Default: openai-completions. */
22
+ api?: PiEndpointApi;
23
+ /** Sent as the API key; empty for servers without keys. `cell.ai.pi.apiKeys.<endpoint id>` works too. */
24
+ apiKey?: string;
25
+ /** Model ids, or models with their limits. */
26
+ models: (string | PiEndpointModel)[];
27
+ }
28
+ export interface PiEndpointModel {
29
+ id: string;
30
+ name?: string;
31
+ /** Whether the model thinks. Default: false. */
32
+ reasoning?: boolean;
33
+ /** Accepts images. Default: false. */
34
+ images?: boolean;
35
+ /** Default: 128000. */
36
+ contextWindow?: number;
37
+ /** Default: 16384. */
38
+ maxTokens?: number;
39
+ }
40
+ /** The pi-ai `Models` collection of the application: providers, catalogs and credentials. */
41
+ export interface PiModelsProvider {
42
+ provide(): Promise<Models>;
43
+ /** The model of a `<provider>/<model id>` reference. Throws {@link PiModelNotFoundError}. */
44
+ resolve(ref: string): Promise<PiModel>;
45
+ }
46
+ /** Configures the `Models` collection once it is created: register providers, set credentials. */
47
+ export interface PiModelsContribution {
48
+ configure(models: Models): void | Promise<void>;
49
+ }
50
+ //# sourceMappingURL=pi-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-protocol.d.ts","sourceRoot":"","sources":["../../src/node/pi-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE5C,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAC3D,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,8CAA8C;AAC9C,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC,oBAAoB;AACpB,MAAM,WAAW,SAAS;IACtB,0GAA0G;IAC1G,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;IAC7B,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,0HAA0H;IAC1H,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAChD;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAE7F,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACvB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC7B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,6FAA6F;IAC7F,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,kGAAkG;AAClG,MAAM,WAAW,oBAAoB;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PI_OPTIONS = exports.PiModelsContribution = exports.PiModelsProvider = void 0;
4
+ exports.PiModelsProvider = Symbol('PiModelsProvider');
5
+ exports.PiModelsContribution = Symbol('PiModelsContribution');
6
+ /** Configuration key of {@link PiOptions}. */
7
+ exports.PI_OPTIONS = 'cell.ai.pi';
8
+ //# sourceMappingURL=pi-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-protocol.js","sourceRoot":"","sources":["../../src/node/pi-protocol.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC9C,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEnE,8CAA8C;AACjC,QAAA,UAAU,GAAG,YAAY,CAAC"}
@@ -0,0 +1,30 @@
1
+ import { type Models, type PiAi } from '../pi';
2
+ import type { PiModelsContribution } from '../pi-protocol';
3
+ type FauxHandle = ReturnType<PiAi['fauxProvider']>;
4
+ type FauxStep = Parameters<FauxHandle['setResponses']>[0][number];
5
+ type FauxContext = Parameters<Extract<FauxStep, (...args: any[]) => any>>[0];
6
+ /** A scripted reply: assistant text, a call of a tool with its arguments, or an error of the model. */
7
+ export type FauxPiReply = string | {
8
+ tool: string;
9
+ args: Parameters<PiAi['fauxToolCall']>[1];
10
+ } | {
11
+ error: string;
12
+ };
13
+ /**
14
+ * A scripted model for tests, on pi-ai's faux provider: bind it as a {@link PiModelsContribution} and
15
+ * use {@link FauxPiModels.MODEL}. Each model request takes the next reply; `contexts` records the requests.
16
+ */
17
+ export declare class FauxPiModels implements PiModelsContribution {
18
+ protected readonly ai: PiAi;
19
+ static readonly MODEL = "faux/faux-1";
20
+ static create(): Promise<FauxPiModels>;
21
+ readonly contexts: FauxContext[];
22
+ protected readonly faux: FauxHandle;
23
+ protected constructor(ai: PiAi);
24
+ configure(models: Models): void;
25
+ /** Replaces the scripted replies, one per model request. */
26
+ reply(...replies: FauxPiReply[]): void;
27
+ protected toMessage(reply: FauxPiReply): import("@earendil-works/pi-ai", { with: { "resolution-mode": "import" } }).AssistantMessage;
28
+ }
29
+ export {};
30
+ //# sourceMappingURL=faux-pi-models.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"faux-pi-models.d.ts","sourceRoot":"","sources":["../../../src/node/test/faux-pi-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAY,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,KAAK,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;AACnD,KAAK,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7E,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH;;;GAGG;AACH,qBAAa,YAAa,YAAW,oBAAoB;IAW/B,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAVjD,MAAM,CAAC,QAAQ,CAAC,KAAK,iBAAiB;IAEtC,OAAa,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAE3C;IAED,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAM;IAEtC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAEpC,SAAS,aAAgC,EAAE,EAAE,IAAI,EAEhD;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAED,4DAA4D;IAC5D,KAAK,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAOrC;IAED,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,+FAQrC;CACJ"}
@@ -0,0 +1,40 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FauxPiModels = void 0;
4
+ const pi_1 = require("../pi");
5
+ /**
6
+ * A scripted model for tests, on pi-ai's faux provider: bind it as a {@link PiModelsContribution} and
7
+ * use {@link FauxPiModels.MODEL}. Each model request takes the next reply; `contexts` records the requests.
8
+ */
9
+ class FauxPiModels {
10
+ static async create() {
11
+ return new FauxPiModels(await pi_1.PiAiUtil.load());
12
+ }
13
+ constructor(ai) {
14
+ this.ai = ai;
15
+ this.contexts = [];
16
+ this.faux = ai.fauxProvider({ provider: 'faux', models: [{ id: 'faux-1' }] });
17
+ }
18
+ configure(models) {
19
+ models.setProvider(this.faux.provider);
20
+ }
21
+ /** Replaces the scripted replies, one per model request. */
22
+ reply(...replies) {
23
+ this.faux.setResponses(replies.map(reply => (context) => {
24
+ this.contexts.push(context);
25
+ return this.toMessage(reply);
26
+ }));
27
+ }
28
+ toMessage(reply) {
29
+ if (typeof reply === 'string') {
30
+ return this.ai.fauxAssistantMessage(reply);
31
+ }
32
+ if ('error' in reply) {
33
+ return this.ai.fauxAssistantMessage('', { stopReason: 'error', errorMessage: reply.error });
34
+ }
35
+ return this.ai.fauxAssistantMessage(this.ai.fauxToolCall(reply.tool, reply.args), { stopReason: 'toolUse' });
36
+ }
37
+ }
38
+ exports.FauxPiModels = FauxPiModels;
39
+ FauxPiModels.MODEL = 'faux/faux-1';
40
+ //# sourceMappingURL=faux-pi-models.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"faux-pi-models.js","sourceRoot":"","sources":["../../../src/node/test/faux-pi-models.ts"],"names":[],"mappings":";;;AAAA,8BAAyD;AAUzD;;;GAGG;AACH;IAGI,MAAM,CAAC,KAAK,CAAC,MAAM;QACf,OAAO,IAAI,YAAY,CAAC,MAAM,aAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAMD,YAAyC,EAAQ;QAAR,OAAE,GAAF,EAAE,CAAM;QAJxC,aAAQ,GAAkB,EAAE,CAAC;QAKlC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,GAAG,OAAsB;QAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,CAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAoB,EAAE,EAAE;YAC1C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CACL,CAAC;IACN,CAAC;IAES,SAAS,CAAC,KAAkB;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IACjH,CAAC;CACJ;;AArCmB,kBAAK,GAAG,aAAa,AAAhB,CAAiB"}
@@ -0,0 +1,3 @@
1
+ export * from './faux-pi-models';
2
+ export * from './test-container';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./faux-pi-models"), exports);
18
+ __exportStar(require("./test-container"), exports);
19
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/test/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,mDAAiC"}
@@ -0,0 +1,14 @@
1
+ import { ContainerFactory } from '@celljs/core';
2
+ import { type PiOptions } from '../pi-protocol';
3
+ import { FauxPiModels } from './faux-pi-models';
4
+ import '../index';
5
+ type Container = ReturnType<typeof ContainerFactory.create>;
6
+ type ContainerModule = Parameters<typeof ContainerFactory.create>[number];
7
+ export interface PiTestContainer {
8
+ container: Container;
9
+ faux: FauxPiModels;
10
+ }
11
+ /** A container with ai-core, this package and the scripted {@link FauxPiModels}. */
12
+ export declare function createPiTestContainer(options?: PiOptions, ...modules: ContainerModule[]): Promise<PiTestContainer>;
13
+ export {};
14
+ //# sourceMappingURL=test-container.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-container.d.ts","sourceRoot":"","sources":["../../../src/node/test/test-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,gBAAgB,EAAkC,MAAM,cAAc,CAAC;AAE1F,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,UAAU,CAAC;AAIlB,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC5D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;CACtB;AAED,oFAAoF;AACpF,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,SAAc,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAS5H"}
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.createPiTestContainer = createPiTestContainer;
7
+ const module_1 = __importDefault(require("@celljs/ai-core/lib/common/module"));
8
+ const core_1 = require("@celljs/core");
9
+ const test_module_1 = require("@celljs/core/lib/common/test/test-module");
10
+ const pi_protocol_1 = require("../pi-protocol");
11
+ const faux_pi_models_1 = require("./faux-pi-models");
12
+ require("../index");
13
+ const piModule = (0, core_1.autoBind)();
14
+ /** A container with ai-core, this package and the scripted {@link FauxPiModels}. */
15
+ async function createPiTestContainer(options = {}, ...modules) {
16
+ core_1.currentThis.cellProps = { cell: { ai: { pi: options } } };
17
+ const faux = await faux_pi_models_1.FauxPiModels.create();
18
+ // ai-core's module is imported first, so it also holds the components of @celljs/core (autoBind() takes
19
+ // everything registered before it); core's test module then replaces their logger.
20
+ const container = core_1.ContainerFactory.create(module_1.default, test_module_1.coreTestModule, piModule, ...modules);
21
+ container.bind(pi_protocol_1.PiModelsContribution).toConstantValue(faux);
22
+ core_1.ContainerProvider.set(container);
23
+ return { container, faux };
24
+ }
25
+ //# sourceMappingURL=test-container.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-container.js","sourceRoot":"","sources":["../../../src/node/test/test-container.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA6D;AAC7D,uCAA0F;AAC1F,0EAA0E;AAC1E,gDAAsE;AACtE,qDAAgD;AAChD,oBAAkB;AAElB,MAAM,QAAQ,GAAG,IAAA,eAAQ,GAAE,CAAC;AAU5B,oFAAoF;AAC7E,KAAK,gCAAgC,OAAO,GAAc,EAAE,EAAE,GAAG,OAA0B;IAC9F,kBAAW,CAAC,SAAS,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,6BAAY,CAAC,MAAM,EAAE,CAAC;IACzC,wGAAwG;IACxG,mFAAmF;IACnF,MAAM,SAAS,GAAG,uBAAgB,CAAC,MAAM,CAAC,gBAAY,EAAE,4BAAc,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC;IAC9F,SAAS,CAAC,IAAI,CAAC,kCAAoB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3D,wBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,94 @@
1
1
  {
2
2
  "name": "@celljs/ai-pi",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "4.0.0",
4
+ "description": "pi-ai models (20+ providers) as Cell chat models",
5
+ "keywords": [
6
+ "cell-component"
7
+ ],
8
+ "homepage": "https://github.com/cellbang/cell",
9
+ "bugs": {
10
+ "url": "https://github.com/cellbang/cell/issues"
11
+ },
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/cellbang/cell.git"
15
+ },
16
+ "license": "MIT",
17
+ "engines": {
18
+ "node": ">=22.19.0"
19
+ },
20
+ "main": "lib/node/index.js",
21
+ "typings": "lib/node/index.d.ts",
22
+ "files": [
23
+ "lib",
24
+ "esm",
25
+ "src",
26
+ "cell.yml"
27
+ ],
28
+ "scripts": {
29
+ "build": "tsc -b && bun ../../scripts/build-esm.ts",
30
+ "clean": "rm -rf lib esm *.tsbuildinfo",
31
+ "test": "bun test --preload reflect-metadata ./lib",
32
+ "watch": "tsc -b -w --preserveWatchOutput"
33
+ },
34
+ "dependencies": {
35
+ "@celljs/ai-core": "4.0.0",
36
+ "@celljs/core": "4.0.0",
37
+ "@earendil-works/pi-ai": "^1.5.0",
38
+ "rxjs": "^6.6.0",
39
+ "tslib": "^2.8.0"
40
+ },
41
+ "publishConfig": {
42
+ "access": "public"
43
+ },
44
+ "cell": {
45
+ "modules": {
46
+ "backend": [
47
+ "lib/node/module"
48
+ ]
49
+ },
50
+ "optionalDependencies": [
51
+ "@earendil-works/pi-ai"
52
+ ]
53
+ },
54
+ "exports": {
55
+ ".": {
56
+ "import": "./esm/node/index.js",
57
+ "default": "./lib/node/index.js"
58
+ },
59
+ "./package.json": "./package.json",
60
+ "./lib/node": {
61
+ "import": "./esm/node/index.js",
62
+ "default": "./lib/node/index.js"
63
+ },
64
+ "./lib/node/chat": {
65
+ "import": "./esm/node/chat/index.js",
66
+ "default": "./lib/node/chat/index.js"
67
+ },
68
+ "./lib/node/error": {
69
+ "import": "./esm/node/error/index.js",
70
+ "default": "./lib/node/error/index.js"
71
+ },
72
+ "./lib/node/models": {
73
+ "import": "./esm/node/models/index.js",
74
+ "default": "./lib/node/models/index.js"
75
+ },
76
+ "./lib/node/pi": {
77
+ "import": "./esm/node/pi/index.js",
78
+ "default": "./lib/node/pi/index.js"
79
+ },
80
+ "./lib/node/test": {
81
+ "import": "./esm/node/test/index.js",
82
+ "default": "./lib/node/test/index.js"
83
+ },
84
+ "./lib/*.js": {
85
+ "import": "./esm/*.js",
86
+ "default": "./lib/*.js"
87
+ },
88
+ "./lib/*": {
89
+ "import": "./esm/*.js",
90
+ "default": "./lib/*.js"
91
+ },
92
+ "./*": "./*"
93
+ }
94
+ }
@@ -0,0 +1,3 @@
1
+ export * from './pi-chat-model';
2
+ export * from './pi-chat-options';
3
+ export * from './pi-message-util';
@@ -0,0 +1,113 @@
1
+ import { describe, it } from 'bun:test';
2
+ import {
3
+ AssistantMessage,
4
+ type ChatModel,
5
+ type ChatResponse,
6
+ PromptTemplate,
7
+ ProxyChatModel,
8
+ SystemMessage,
9
+ ToolResponseMessage,
10
+ UserMessage,
11
+ } from '@celljs/ai-core';
12
+ import { expect } from 'chai';
13
+ import { PiModelError, PiModelNotFoundError } from '../error';
14
+ import { PiModelsProvider } from '../pi-protocol';
15
+ import { createPiTestContainer, FauxPiModels } from '../test';
16
+ import { PiChatModel } from './pi-chat-model';
17
+
18
+ async function setup(options = {}) {
19
+ const test = await createPiTestContainer(options);
20
+ return {
21
+ ...test,
22
+ chatModel: test.container.get<ChatModel>(PiChatModel),
23
+ prompts: test.container.get<PromptTemplate>(PromptTemplate),
24
+ };
25
+ }
26
+
27
+ async function collect(response$: import('rxjs').Observable<ChatResponse>): Promise<ChatResponse[]> {
28
+ const responses: ChatResponse[] = [];
29
+ await new Promise<void>((resolve, reject) => response$.subscribe({ next: r => responses.push(r), error: reject, complete: resolve }));
30
+ return responses;
31
+ }
32
+
33
+ describe('PiChatModel', () => {
34
+ it('answers with the model of the prompt', async () => {
35
+ const { chatModel, prompts, faux } = await setup();
36
+ faux.reply('Hi there');
37
+ const response = await chatModel.call(await prompts.create('Hello', { chatOptions: { model: FauxPiModels.MODEL } }));
38
+ expect(response.result.output).to.be.instanceOf(AssistantMessage);
39
+ expect(response.result.output.content).to.equal('Hi there');
40
+ expect(response.result.metadata.finishReason).to.equal('stop');
41
+ expect(response.metadata.model).to.equal('faux-1');
42
+ expect(response.metadata.usage.totalTokens).to.be.greaterThan(0);
43
+ });
44
+
45
+ it('is the pi provider of ProxyChatModel', async () => {
46
+ const { container, prompts, faux } = await setup();
47
+ faux.reply('Routed');
48
+ const response = await container
49
+ .get<ChatModel>(ProxyChatModel)
50
+ .call(await prompts.create('Hello', { chatOptions: { model: `pi:${FauxPiModels.MODEL}` } }));
51
+ expect(response.result.output.content).to.equal('Routed');
52
+ });
53
+
54
+ it('sends the conversation and tools, and returns tool calls', async () => {
55
+ const { chatModel, prompts, faux } = await setup();
56
+ faux.reply({ tool: 'get_weather', args: { city: 'Paris' } });
57
+ const messages = [
58
+ new SystemMessage('You are a weather bot.'),
59
+ new UserMessage('Weather in Rome?'),
60
+ new AssistantMessage('', [], {}, [{ id: 'call-1', type: 'function', name: 'get_weather', arguments: '{"city":"Rome"}' }]),
61
+ new ToolResponseMessage([{ id: 'call-1', name: 'get_weather', responseData: 'Sunny' }]),
62
+ new UserMessage('And in Paris?'),
63
+ ];
64
+ const tools = [{ name: 'get_weather', description: 'Weather of a city', parameters: { type: 'object', properties: { city: { type: 'string' } } } }];
65
+ const response = await chatModel.call(await prompts.create(messages, { chatOptions: { model: FauxPiModels.MODEL, tools } as any }));
66
+ expect(response.result.metadata.finishReason).to.equal('toolUse');
67
+ expect(response.result.output.toolCalls).to.have.length(1);
68
+ expect(response.result.output.toolCalls[0]).to.include({ name: 'get_weather', arguments: '{"city":"Paris"}' });
69
+ const context = faux.contexts[0] as any;
70
+ expect(JSON.stringify(context.messages)).to.include('You are a weather bot.').and.include('get_weather');
71
+ expect(context.messages.map((m: any) => m.role)).to.include.members(['user', 'assistant', 'toolResult']);
72
+ });
73
+
74
+ it('streams text deltas, then the whole message', async () => {
75
+ const { chatModel, prompts, faux } = await setup();
76
+ faux.reply('Streaming works');
77
+ const responses = await collect(await chatModel.stream(await prompts.create('Hello', { chatOptions: { model: FauxPiModels.MODEL } })));
78
+ const last = responses.pop()!;
79
+ expect(responses.map(r => r.result.output.content).join('')).to.equal('Streaming works');
80
+ expect(last.result.output.content).to.equal('Streaming works');
81
+ expect(last.result.metadata.finishReason).to.equal('stop');
82
+ });
83
+
84
+ it('reports unknown models and model errors', async () => {
85
+ const { chatModel, prompts, faux } = await setup();
86
+ let error: unknown;
87
+ await chatModel.call(await prompts.create('Hello', { chatOptions: { model: 'nope/model' } })).catch(e => (error = e));
88
+ expect(error).to.be.instanceOf(PiModelNotFoundError);
89
+ faux.reply({ error: 'quota exceeded' });
90
+ error = undefined;
91
+ await chatModel.call(await prompts.create('Hello', { chatOptions: { model: FauxPiModels.MODEL } })).catch(e => (error = e));
92
+ expect(error).to.be.instanceOf(PiModelError);
93
+ expect((error as Error).message).to.include('quota exceeded');
94
+ faux.reply({ error: 'stream broke' });
95
+ error = undefined;
96
+ await collect(await chatModel.stream(await prompts.create('Hello', { chatOptions: { model: FauxPiModels.MODEL } }))).catch(e => (error = e));
97
+ expect(error).to.be.instanceOf(PiModelError);
98
+ });
99
+ });
100
+
101
+ describe('PiModelsProvider', () => {
102
+ it('registers the configured providers and API keys', async () => {
103
+ const { container } = await setup({ providers: ['anthropic', 'xai'], apiKeys: { xai: 'xai-test-key', groq: '' } });
104
+ const models = await container.get<PiModelsProvider>(PiModelsProvider).provide();
105
+ expect(
106
+ models
107
+ .getProviders()
108
+ .map(p => p.id)
109
+ .sort(),
110
+ ).to.deep.equal(['anthropic', 'faux', 'xai']);
111
+ expect((await models.getAuth('xai'))?.auth.apiKey).to.equal('xai-test-key');
112
+ });
113
+ });
@@ -0,0 +1,76 @@
1
+ import { type ChatModel, ChatModel as ChatModelId, type ChatResponse, type Prompt } from '@celljs/ai-core';
2
+ import { Autowired, Component, IllegalArgumentError } from '@celljs/core';
3
+ import { Observable } from 'rxjs';
4
+ import { PiModelError } from '../error';
5
+ import type { PiModel } from '../pi';
6
+ import { PiModelsProvider } from '../pi-protocol';
7
+ import type { PiChatOptions } from './pi-chat-options';
8
+ import { PiMessageUtil } from './pi-message-util';
9
+
10
+ /**
11
+ * ai-core's `ChatModel` on pi-ai: every provider pi-ai knows, with `<provider>/<model id>` as the model.
12
+ * Through `ProxyChatModel` the model is `pi:<provider>/<model id>`.
13
+ */
14
+ @Component(ChatModelId)
15
+ export class PiChatModel implements ChatModel {
16
+ readonly provider = 'pi';
17
+
18
+ @Autowired(PiModelsProvider)
19
+ protected readonly modelsProvider: PiModelsProvider;
20
+
21
+ async call(prompt: Prompt): Promise<ChatResponse> {
22
+ const { model, options } = await this.resolve(prompt);
23
+ const models = await this.modelsProvider.provide();
24
+ const message = await models.completeSimple(model, PiMessageUtil.toContext(prompt.instructions, model, options), this.requestOptions(options));
25
+ if (message.stopReason === 'error' || message.stopReason === 'aborted') {
26
+ throw new PiModelError(`${model.provider}/${model.id}`, message.errorMessage ?? message.stopReason);
27
+ }
28
+ return PiMessageUtil.toChatResponse(PiMessageUtil.fromAssistantMessage(message), message);
29
+ }
30
+
31
+ /** Emits one response per text delta, then a last one with the whole message (text, tool calls, usage). */
32
+ async stream(prompt: Prompt): Promise<Observable<ChatResponse>> {
33
+ const { model, options } = await this.resolve(prompt);
34
+ const models = await this.modelsProvider.provide();
35
+ const context = PiMessageUtil.toContext(prompt.instructions, model, options);
36
+ return new Observable<ChatResponse>(subscriber => {
37
+ const controller = new AbortController();
38
+ const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
39
+ (async () => {
40
+ for await (const event of models.streamSimple(model, context, { ...this.requestOptions(options), signal })) {
41
+ if (event.type === 'text_delta') {
42
+ subscriber.next(
43
+ PiMessageUtil.toChatResponse(
44
+ PiMessageUtil.fromAssistantMessage({ ...event.partial, content: [{ type: 'text', text: event.delta }] }),
45
+ ),
46
+ );
47
+ } else if (event.type === 'done') {
48
+ subscriber.next(PiMessageUtil.toChatResponse(PiMessageUtil.fromAssistantMessage(event.message), event.message));
49
+ } else if (event.type === 'error') {
50
+ throw new PiModelError(`${model.provider}/${model.id}`, event.error.errorMessage ?? event.reason);
51
+ }
52
+ }
53
+ subscriber.complete();
54
+ })().catch(error => subscriber.error(error));
55
+ return () => controller.abort();
56
+ });
57
+ }
58
+
59
+ protected async resolve(prompt: Prompt): Promise<{ model: PiModel; options: PiChatOptions }> {
60
+ const options = (prompt.options ?? {}) as PiChatOptions;
61
+ if (!options.model) {
62
+ throw new IllegalArgumentError('Model is not set! Use "<provider>/<model id>", e.g. anthropic/claude-sonnet-4-5.');
63
+ }
64
+ return { model: await this.modelsProvider.resolve(options.model), options };
65
+ }
66
+
67
+ protected requestOptions(options: PiChatOptions) {
68
+ return {
69
+ signal: options.signal,
70
+ temperature: options.temperature,
71
+ maxTokens: options.maxTokens,
72
+ reasoning: options.reasoning,
73
+ headers: options.httpHeaders,
74
+ };
75
+ }
76
+ }
@@ -0,0 +1,10 @@
1
+ import type { ChatOptions } from '@celljs/ai-core';
2
+ import type { PiThinkingLevel, PiTool } from '../pi';
3
+
4
+ /** Options of {@link PiChatModel}: the model is `<provider>/<model id>` (`pi:<provider>/<model id>` through ProxyChatModel). */
5
+ export interface PiChatOptions extends ChatOptions {
6
+ /** Thinking level for models that reason. */
7
+ reasoning?: PiThinkingLevel;
8
+ /** Tools the model may call, with JSON Schema parameters; tool calls come back in `AssistantMessage.toolCalls`. */
9
+ tools?: PiTool[];
10
+ }