@celljs/ai-coding-agent 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 (171) hide show
  1. package/README.md +225 -2
  2. package/cell.yml +16 -0
  3. package/esm/node/application-lifecycle.d.ts +7 -0
  4. package/esm/node/application-lifecycle.js +25 -0
  5. package/esm/node/application-lifecycle.js.map +1 -0
  6. package/esm/node/coding-agent-protocol.d.ts +92 -0
  7. package/esm/node/coding-agent-protocol.js +8 -0
  8. package/esm/node/coding-agent-protocol.js.map +1 -0
  9. package/esm/node/error/errors.d.ts +22 -0
  10. package/esm/node/error/errors.js +25 -0
  11. package/esm/node/error/errors.js.map +1 -0
  12. package/esm/node/error/index.d.ts +1 -0
  13. package/esm/node/error/index.js +2 -0
  14. package/esm/node/error/index.js.map +1 -0
  15. package/esm/node/event/agent-event-util.d.ts +1 -0
  16. package/esm/node/event/agent-event-util.js +3 -0
  17. package/esm/node/event/agent-event-util.js.map +1 -0
  18. package/esm/node/event/index.d.ts +1 -0
  19. package/esm/node/event/index.js +2 -0
  20. package/esm/node/event/index.js.map +1 -0
  21. package/esm/node/index.d.ts +8 -0
  22. package/esm/node/index.js +10 -0
  23. package/esm/node/index.js.map +1 -0
  24. package/esm/node/module.d.ts +3 -0
  25. package/esm/node/module.js +4 -0
  26. package/esm/node/module.js.map +1 -0
  27. package/esm/node/pi/index.d.ts +2 -0
  28. package/esm/node/pi/index.js +3 -0
  29. package/esm/node/pi/index.js.map +1 -0
  30. package/esm/node/pi/pi-sdk-util.d.ts +9 -0
  31. package/esm/node/pi/pi-sdk-util.js +20 -0
  32. package/esm/node/pi/pi-sdk-util.js.map +1 -0
  33. package/esm/node/pi/pi-types.d.ts +10 -0
  34. package/esm/node/pi/pi-types.js +2 -0
  35. package/esm/node/pi/pi-types.js.map +1 -0
  36. package/esm/node/runtime/index.d.ts +1 -0
  37. package/esm/node/runtime/index.js +2 -0
  38. package/esm/node/runtime/index.js.map +1 -0
  39. package/esm/node/runtime/model-runtime-provider.d.ts +11 -0
  40. package/esm/node/runtime/model-runtime-provider.js +67 -0
  41. package/esm/node/runtime/model-runtime-provider.js.map +1 -0
  42. package/esm/node/session/agent-session-factory.d.ts +23 -0
  43. package/esm/node/session/agent-session-factory.js +178 -0
  44. package/esm/node/session/agent-session-factory.js.map +1 -0
  45. package/esm/node/session/agent-session-manager.d.ts +16 -0
  46. package/esm/node/session/agent-session-manager.js +72 -0
  47. package/esm/node/session/agent-session-manager.js.map +1 -0
  48. package/esm/node/session/index.d.ts +2 -0
  49. package/esm/node/session/index.js +3 -0
  50. package/esm/node/session/index.js.map +1 -0
  51. package/esm/node/test/faux-models.d.ts +28 -0
  52. package/esm/node/test/faux-models.js +39 -0
  53. package/esm/node/test/faux-models.js.map +1 -0
  54. package/esm/node/test/index.d.ts +2 -0
  55. package/esm/node/test/index.js +3 -0
  56. package/esm/node/test/index.js.map +1 -0
  57. package/esm/node/test/test-container.d.ts +18 -0
  58. package/esm/node/test/test-container.js +25 -0
  59. package/esm/node/test/test-container.js.map +1 -0
  60. package/esm/package.json +3 -0
  61. package/lib/node/application-lifecycle.d.ts +8 -0
  62. package/lib/node/application-lifecycle.d.ts.map +1 -0
  63. package/lib/node/application-lifecycle.js +28 -0
  64. package/lib/node/application-lifecycle.js.map +1 -0
  65. package/lib/node/coding-agent-protocol.d.ts +93 -0
  66. package/lib/node/coding-agent-protocol.d.ts.map +1 -0
  67. package/lib/node/coding-agent-protocol.js +11 -0
  68. package/lib/node/coding-agent-protocol.js.map +1 -0
  69. package/lib/node/error/errors.d.ts +23 -0
  70. package/lib/node/error/errors.d.ts.map +1 -0
  71. package/lib/node/error/errors.js +32 -0
  72. package/lib/node/error/errors.js.map +1 -0
  73. package/lib/node/error/index.d.ts +2 -0
  74. package/lib/node/error/index.d.ts.map +1 -0
  75. package/lib/node/error/index.js +18 -0
  76. package/lib/node/error/index.js.map +1 -0
  77. package/lib/node/event/agent-event-util.d.ts +2 -0
  78. package/lib/node/event/agent-event-util.d.ts.map +1 -0
  79. package/lib/node/event/agent-event-util.js +7 -0
  80. package/lib/node/event/agent-event-util.js.map +1 -0
  81. package/lib/node/event/agent-event-util.spec.d.ts +2 -0
  82. package/lib/node/event/agent-event-util.spec.d.ts.map +1 -0
  83. package/lib/node/event/agent-event-util.spec.js +85 -0
  84. package/lib/node/event/agent-event-util.spec.js.map +1 -0
  85. package/lib/node/event/index.d.ts +2 -0
  86. package/lib/node/event/index.d.ts.map +1 -0
  87. package/lib/node/event/index.js +18 -0
  88. package/lib/node/event/index.js.map +1 -0
  89. package/lib/node/index.d.ts +9 -0
  90. package/lib/node/index.d.ts.map +1 -0
  91. package/lib/node/index.js +28 -0
  92. package/lib/node/index.js.map +1 -0
  93. package/lib/node/module.d.ts +4 -0
  94. package/lib/node/module.d.ts.map +1 -0
  95. package/lib/node/module.js +6 -0
  96. package/lib/node/module.js.map +1 -0
  97. package/lib/node/pi/index.d.ts +3 -0
  98. package/lib/node/pi/index.d.ts.map +1 -0
  99. package/lib/node/pi/index.js +19 -0
  100. package/lib/node/pi/index.js.map +1 -0
  101. package/lib/node/pi/pi-sdk-util.d.ts +10 -0
  102. package/lib/node/pi/pi-sdk-util.d.ts.map +1 -0
  103. package/lib/node/pi/pi-sdk-util.js +23 -0
  104. package/lib/node/pi/pi-sdk-util.js.map +1 -0
  105. package/lib/node/pi/pi-types.d.ts +11 -0
  106. package/lib/node/pi/pi-types.d.ts.map +1 -0
  107. package/lib/node/pi/pi-types.js +3 -0
  108. package/lib/node/pi/pi-types.js.map +1 -0
  109. package/lib/node/runtime/index.d.ts +2 -0
  110. package/lib/node/runtime/index.d.ts.map +1 -0
  111. package/lib/node/runtime/index.js +18 -0
  112. package/lib/node/runtime/index.js.map +1 -0
  113. package/lib/node/runtime/model-runtime-provider.d.ts +12 -0
  114. package/lib/node/runtime/model-runtime-provider.d.ts.map +1 -0
  115. package/lib/node/runtime/model-runtime-provider.js +70 -0
  116. package/lib/node/runtime/model-runtime-provider.js.map +1 -0
  117. package/lib/node/session/agent-session-builtins.spec.d.ts +2 -0
  118. package/lib/node/session/agent-session-builtins.spec.d.ts.map +1 -0
  119. package/lib/node/session/agent-session-builtins.spec.js +55 -0
  120. package/lib/node/session/agent-session-builtins.spec.js.map +1 -0
  121. package/lib/node/session/agent-session-factory.d.ts +24 -0
  122. package/lib/node/session/agent-session-factory.d.ts.map +1 -0
  123. package/lib/node/session/agent-session-factory.js +181 -0
  124. package/lib/node/session/agent-session-factory.js.map +1 -0
  125. package/lib/node/session/agent-session-manager.d.ts +17 -0
  126. package/lib/node/session/agent-session-manager.d.ts.map +1 -0
  127. package/lib/node/session/agent-session-manager.js +75 -0
  128. package/lib/node/session/agent-session-manager.js.map +1 -0
  129. package/lib/node/session/agent-session-manager.spec.d.ts +33 -0
  130. package/lib/node/session/agent-session-manager.spec.d.ts.map +1 -0
  131. package/lib/node/session/agent-session-manager.spec.js +203 -0
  132. package/lib/node/session/agent-session-manager.spec.js.map +1 -0
  133. package/lib/node/session/index.d.ts +3 -0
  134. package/lib/node/session/index.d.ts.map +1 -0
  135. package/lib/node/session/index.js +19 -0
  136. package/lib/node/session/index.js.map +1 -0
  137. package/lib/node/test/faux-models.d.ts +29 -0
  138. package/lib/node/test/faux-models.d.ts.map +1 -0
  139. package/lib/node/test/faux-models.js +43 -0
  140. package/lib/node/test/faux-models.js.map +1 -0
  141. package/lib/node/test/index.d.ts +3 -0
  142. package/lib/node/test/index.d.ts.map +1 -0
  143. package/lib/node/test/index.js +19 -0
  144. package/lib/node/test/index.js.map +1 -0
  145. package/lib/node/test/test-container.d.ts +19 -0
  146. package/lib/node/test/test-container.d.ts.map +1 -0
  147. package/lib/node/test/test-container.js +28 -0
  148. package/lib/node/test/test-container.js.map +1 -0
  149. package/package.json +96 -4
  150. package/src/node/application-lifecycle.ts +13 -0
  151. package/src/node/coding-agent-protocol.ts +106 -0
  152. package/src/node/error/errors.ts +32 -0
  153. package/src/node/error/index.ts +1 -0
  154. package/src/node/event/agent-event-util.spec.ts +95 -0
  155. package/src/node/event/agent-event-util.ts +2 -0
  156. package/src/node/event/index.ts +1 -0
  157. package/src/node/index.ts +9 -0
  158. package/src/node/module.ts +4 -0
  159. package/src/node/pi/index.ts +2 -0
  160. package/src/node/pi/pi-sdk-util.ts +25 -0
  161. package/src/node/pi/pi-types.ts +12 -0
  162. package/src/node/runtime/index.ts +1 -0
  163. package/src/node/runtime/model-runtime-provider.ts +50 -0
  164. package/src/node/session/agent-session-builtins.spec.ts +59 -0
  165. package/src/node/session/agent-session-factory.ts +175 -0
  166. package/src/node/session/agent-session-manager.spec.ts +198 -0
  167. package/src/node/session/agent-session-manager.ts +64 -0
  168. package/src/node/session/index.ts +2 -0
  169. package/src/node/test/faux-models.ts +54 -0
  170. package/src/node/test/index.ts +2 -0
  171. package/src/node/test/test-container.ts +36 -0
@@ -0,0 +1,198 @@
1
+ import { afterEach, describe, it } from 'bun:test';
2
+ import { readFileSync, writeFileSync } from 'node:fs';
3
+ import { join } from 'node:path';
4
+ import { AgentTool } from '@celljs/ai-agent';
5
+ import { ApplicationLifecycle, Autowired, autoBind, Component } from '@celljs/core';
6
+ import { expect } from 'chai';
7
+ import { CodingAgentApplicationLifecycle } from '../application-lifecycle';
8
+ import { AgentExtension, AgentSessionManager, ModelRuntimeProvider } from '../coding-agent-protocol';
9
+ import { AgentExtensionError, AgentModelNotFoundError, AgentSessionNotFoundError } from '../error';
10
+ import type { ExtensionAPI } from '../pi';
11
+ import { createTestContainer, type TestContainer } from '../test';
12
+
13
+ @Component()
14
+ export class GreetingService {
15
+ greet(name: string): string {
16
+ return `Hello, ${name}!`;
17
+ }
18
+ }
19
+
20
+ @Component(AgentExtension)
21
+ export class GreetingExtension implements AgentExtension {
22
+ @Autowired(GreetingService)
23
+ protected readonly greetingService: GreetingService;
24
+
25
+ register(pi: ExtensionAPI): void {
26
+ pi.registerTool({
27
+ name: 'greet',
28
+ label: 'Greet',
29
+ description: 'Greets a person by name',
30
+ parameters: { type: 'object', properties: { name: { type: 'string' } }, required: ['name'] },
31
+ execute: async (_id, params: { name: string }) => ({ content: [{ type: 'text', text: this.greetingService.greet(params.name) }], details: {} }),
32
+ });
33
+ }
34
+ }
35
+
36
+ const greetingModule = autoBind();
37
+
38
+ @Component(AgentExtension)
39
+ export class BrokenExtension implements AgentExtension {
40
+ register(): void {
41
+ throw new Error('boom');
42
+ }
43
+ }
44
+
45
+ const brokenModule = autoBind();
46
+
47
+ @Component(AgentTool)
48
+ export class StockTool implements AgentTool<{ type: 'object' }> {
49
+ readonly name = 'stock';
50
+ readonly label = 'Stock';
51
+ readonly description = 'Items in stock';
52
+ readonly parameters = { type: 'object' as const, properties: {} };
53
+
54
+ @Autowired(GreetingService)
55
+ protected readonly greetingService: GreetingService;
56
+
57
+ async execute() {
58
+ return { content: [{ type: 'text' as const, text: this.greetingService.greet('stock') }], details: {} };
59
+ }
60
+ }
61
+
62
+ const stockModule = autoBind();
63
+
64
+ describe('AgentSessionManager', () => {
65
+ let test: TestContainer;
66
+
67
+ const sessions = () => test.container.get<AgentSessionManager>(AgentSessionManager);
68
+
69
+ afterEach(() => sessions().disposeAll());
70
+
71
+ it('creates a session that answers with the configured model', async () => {
72
+ test = await createTestContainer({}, greetingModule);
73
+ test.faux.reply('Hi there');
74
+ const session = await sessions().create();
75
+ await session.prompt('hello');
76
+ expect(session.getLastAssistantText()).to.equal('Hi there');
77
+ expect(sessions().info(session.sessionId)).to.include({
78
+ id: session.sessionId,
79
+ cwd: test.dir,
80
+ model: 'faux/faux-1',
81
+ streaming: false,
82
+ messageCount: session.messages.length,
83
+ });
84
+ expect(session.messages.filter(m => m.role === 'user' || m.role === 'assistant')).to.have.length(2);
85
+ });
86
+
87
+ it('runs the tools of AgentExtension components with their injected services', async () => {
88
+ test = await createTestContainer({}, greetingModule);
89
+ test.faux.reply({ tool: 'greet', args: { name: 'Cell' } }, 'Done');
90
+ const session = await sessions().create();
91
+ expect(session.getActiveToolNames()).to.include('greet');
92
+ await session.prompt('greet Cell');
93
+ const result = session.messages.find(m => m.role === 'toolResult') as any;
94
+ expect(result.content[0].text).to.equal('Hello, Cell!');
95
+ expect(session.getLastAssistantText()).to.equal('Done');
96
+ expect(test.faux.requests).to.equal(2);
97
+ });
98
+
99
+ it('gives sessions the AgentTool components of @celljs/ai-agent', async () => {
100
+ test = await createTestContainer({}, greetingModule, stockModule);
101
+ test.faux.reply({ tool: 'stock', args: {} }, 'Done');
102
+ const session = await sessions().create();
103
+ expect(session.getActiveToolNames()).to.include('stock');
104
+ await session.prompt('stock?');
105
+ const result = session.messages.find(m => m.role === 'toolResult') as any;
106
+ expect(result.content[0].text).to.equal('Hello, stock!');
107
+ });
108
+
109
+ it('applies session options over the configuration', async () => {
110
+ test = await createTestContainer({ tools: ['read'] }, greetingModule);
111
+ expect((await sessions().create()).getActiveToolNames()).to.deep.equal(['read']);
112
+ expect((await sessions().create({ tools: ['read', 'greet'] })).getActiveToolNames().sort()).to.deep.equal(['greet', 'read']);
113
+ });
114
+
115
+ it('adds the configured system prompt and the AGENTS.md of cwd when resources are discovered', async () => {
116
+ test = await createTestContainer({ appendSystemPrompt: 'Answer in French.' });
117
+ writeFileSync(join(test.dir, 'AGENTS.md'), 'Use tabs for indentation.');
118
+ expect((await sessions().create()).systemPrompt)
119
+ .to.include('Answer in French.')
120
+ .and.not.include('Use tabs');
121
+ test = await createTestContainer({ discoverResources: true });
122
+ writeFileSync(join(test.dir, 'AGENTS.md'), 'Use tabs for indentation.');
123
+ expect((await sessions().create()).systemPrompt).to.include('Use tabs for indentation.');
124
+ });
125
+
126
+ it('reports no model for the placeholder pi uses when no model is available', async () => {
127
+ test = await createTestContainer();
128
+ const session = await sessions().create();
129
+ // pi's placeholder model is unknown to the runtime; credentials of the environment would pick a real model.
130
+ session.modelRuntime.getModel = () => undefined;
131
+ expect(sessions().info(session.sessionId).model).to.equal(undefined);
132
+ });
133
+
134
+ it('lists, finds and disposes sessions', async () => {
135
+ test = await createTestContainer();
136
+ const first = await sessions().create();
137
+ const second = await sessions().create();
138
+ expect(
139
+ sessions()
140
+ .list()
141
+ .map(s => s.id),
142
+ ).to.deep.equal([first.sessionId, second.sessionId]);
143
+ sessions().dispose(first.sessionId);
144
+ expect(sessions().find(first.sessionId)).to.equal(undefined);
145
+ expect(() => sessions().get(first.sessionId)).to.throw(AgentSessionNotFoundError, first.sessionId);
146
+ expect(() => sessions().info('missing')).to.throw(AgentSessionNotFoundError);
147
+ expect(sessions().list()).to.have.length(1);
148
+ });
149
+
150
+ it('reports an unknown model together with the available ones', async () => {
151
+ test = await createTestContainer();
152
+ let error: unknown;
153
+ await sessions()
154
+ .create({ model: 'nope/model' })
155
+ .catch(e => (error = e));
156
+ expect(error).to.be.instanceOf(AgentModelNotFoundError);
157
+ expect((error as Error).message)
158
+ .to.include('nope/model')
159
+ .and.include('faux/faux-1');
160
+ });
161
+
162
+ it('fails to create a session when an AgentExtension cannot register', async () => {
163
+ test = await createTestContainer({}, brokenModule);
164
+ let error: unknown;
165
+ await sessions()
166
+ .create()
167
+ .catch(e => (error = e));
168
+ expect(error).to.be.instanceOf(AgentExtensionError);
169
+ expect((error as Error).message)
170
+ .to.include('BrokenExtension')
171
+ .and.include('boom');
172
+ });
173
+
174
+ it('shares one model runtime and sets the configured API keys', async () => {
175
+ test = await createTestContainer({ apiKeys: { xai: 'xai-test-key', groq: '' } });
176
+ const provider = test.container.get<ModelRuntimeProvider>(ModelRuntimeProvider);
177
+ const runtime = await provider.provide();
178
+ expect(await provider.provide()).to.equal(runtime);
179
+ expect((await runtime.getAuth('xai'))?.auth.apiKey).to.equal('xai-test-key');
180
+ // Kept in memory: pi's credential file stays as it was.
181
+ expect(readFileSync(join(test.dir, '.pi-agent', 'auth.json'), 'utf8')).to.not.include('xai-test-key');
182
+ });
183
+
184
+ it('disposes the sessions when the application stops', async () => {
185
+ test = await createTestContainer();
186
+ const session = await sessions().create();
187
+ let disposed = false;
188
+ const dispose = session.dispose.bind(session);
189
+ session.dispose = () => {
190
+ disposed = true;
191
+ dispose();
192
+ };
193
+ const lifecycle = test.container.getAll<ApplicationLifecycle<any>>(ApplicationLifecycle).find(l => l instanceof CodingAgentApplicationLifecycle)!;
194
+ lifecycle.onStop!();
195
+ expect(disposed).to.equal(true);
196
+ expect(sessions().list()).to.deep.equal([]);
197
+ });
198
+ });
@@ -0,0 +1,64 @@
1
+ import { Autowired, Component } from '@celljs/core';
2
+ import { AgentSessionFactory, type AgentSessionInfo, AgentSessionManager, type AgentSessionOptions } from '../coding-agent-protocol';
3
+ import { AgentSessionNotFoundError } from '../error';
4
+ import type { AgentSession } from '../pi';
5
+
6
+ @Component(AgentSessionManager)
7
+ export class DefaultAgentSessionManager implements AgentSessionManager {
8
+ @Autowired(AgentSessionFactory)
9
+ protected readonly sessionFactory: AgentSessionFactory;
10
+
11
+ protected readonly sessions = new Map<string, { session: AgentSession; createdAt: number }>();
12
+
13
+ async create(options?: AgentSessionOptions): Promise<AgentSession> {
14
+ const session = await this.sessionFactory.create(options);
15
+ this.sessions.set(session.sessionId, { session, createdAt: Date.now() });
16
+ return session;
17
+ }
18
+
19
+ get(id: string): AgentSession {
20
+ const session = this.find(id);
21
+ if (!session) {
22
+ throw new AgentSessionNotFoundError(id);
23
+ }
24
+ return session;
25
+ }
26
+
27
+ find(id: string): AgentSession | undefined {
28
+ return this.sessions.get(id)?.session;
29
+ }
30
+
31
+ info(id: string): AgentSessionInfo {
32
+ const entry = this.sessions.get(id);
33
+ if (!entry) {
34
+ throw new AgentSessionNotFoundError(id);
35
+ }
36
+ const { session, createdAt } = entry;
37
+ // Without a model pi's agent holds a placeholder that no runtime knows.
38
+ const model = session.model && session.modelRuntime.getModel(session.model.provider, session.model.id);
39
+ return {
40
+ id,
41
+ cwd: session.sessionManager.getCwd(),
42
+ model: model ? `${model.provider}/${model.id}` : undefined,
43
+ thinkingLevel: session.thinkingLevel,
44
+ streaming: session.isStreaming,
45
+ messageCount: session.messages.length,
46
+ createdAt,
47
+ };
48
+ }
49
+
50
+ list(): AgentSessionInfo[] {
51
+ return [...this.sessions.keys()].map(id => this.info(id));
52
+ }
53
+
54
+ dispose(id: string): void {
55
+ this.get(id).dispose();
56
+ this.sessions.delete(id);
57
+ }
58
+
59
+ disposeAll(): void {
60
+ for (const id of [...this.sessions.keys()]) {
61
+ this.dispose(id);
62
+ }
63
+ }
64
+ }
@@ -0,0 +1,2 @@
1
+ export * from './agent-session-factory';
2
+ export * from './agent-session-manager';
@@ -0,0 +1,54 @@
1
+ import type { ModelRuntimeContribution } from '../coding-agent-protocol';
2
+ import type { ModelRuntime } from '../pi';
3
+
4
+ type FauxSdk = typeof import('@earendil-works/pi-ai/providers/faux', { with: { 'resolution-mode': 'import' }});
5
+ type FauxResponseStep = import('@earendil-works/pi-ai/providers/faux', { with: { 'resolution-mode': 'import' }}).FauxResponseStep;
6
+
7
+ /** A scripted reply: assistant text, or a call of a tool with its arguments. */
8
+ export type FauxReply = string | { tool: string; args: Parameters<FauxSdk['fauxToolCall']>[1] };
9
+
10
+ /**
11
+ * A scripted model for tests, built on pi's faux provider. Bind it as a {@link ModelRuntimeContribution}
12
+ * and set `cell.ai.codingAgent.model` to {@link FauxModels.MODEL}; each model request takes the next reply.
13
+ */
14
+ export class FauxModels implements ModelRuntimeContribution {
15
+ static readonly PROVIDER = 'faux';
16
+ static readonly MODEL = 'faux/faux-1';
17
+
18
+ static async create(): Promise<FauxModels> {
19
+ return new FauxModels(await import('@earendil-works/pi-ai/providers/faux'));
20
+ }
21
+
22
+ protected readonly core: ReturnType<FauxSdk['createFauxCore']>;
23
+
24
+ protected constructor(protected readonly sdk: FauxSdk) {
25
+ this.core = sdk.createFauxCore({ provider: FauxModels.PROVIDER, api: FauxModels.PROVIDER, models: [{ id: 'faux-1' }], tokensPerSecond: 1_000_000 });
26
+ }
27
+
28
+ /** Number of model requests so far. */
29
+ get requests(): number {
30
+ return this.core.state.callCount;
31
+ }
32
+
33
+ configure(runtime: ModelRuntime): void {
34
+ runtime.registerProvider(FauxModels.PROVIDER, {
35
+ api: this.core.api,
36
+ baseUrl: 'http://faux.invalid',
37
+ apiKey: 'faux',
38
+ streamSimple: this.core.streamSimple,
39
+ models: this.core.models.map(model => ({ ...model, api: this.core.api })),
40
+ });
41
+ }
42
+
43
+ /** Replaces the scripted replies, one per model request. */
44
+ reply(...replies: FauxReply[]): void {
45
+ this.core.setResponses(replies.map(reply => this.toStep(reply)));
46
+ }
47
+
48
+ protected toStep(reply: FauxReply): FauxResponseStep {
49
+ if (typeof reply === 'string') {
50
+ return this.sdk.fauxAssistantMessage(reply);
51
+ }
52
+ return this.sdk.fauxAssistantMessage(this.sdk.fauxToolCall(reply.tool, reply.args), { stopReason: 'toolUse' });
53
+ }
54
+ }
@@ -0,0 +1,2 @@
1
+ export * from './faux-models';
2
+ export * from './test-container';
@@ -0,0 +1,36 @@
1
+ import { mkdtempSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { autoBind, ContainerFactory, ContainerProvider, currentThis } from '@celljs/core';
5
+ import { coreTestModule } from '@celljs/core/lib/common/test/test-module';
6
+ import { type CodingAgentOptions, ModelRuntimeContribution } from '../coding-agent-protocol';
7
+ import { FauxModels } from './faux-models';
8
+ import '../index';
9
+
10
+ const codingAgentModule = autoBind();
11
+
12
+ type Container = ReturnType<typeof ContainerFactory.create>;
13
+ type ContainerModule = Parameters<typeof ContainerFactory.create>[number];
14
+
15
+ export interface TestContainer {
16
+ container: Container;
17
+ faux: FauxModels;
18
+ /** A new empty directory; also the cwd of sessions. */
19
+ dir: string;
20
+ }
21
+
22
+ /**
23
+ * A container with this package, the scripted {@link FauxModels} as the default model, and pi's
24
+ * directories in a new temporary directory, so tests neither read nor write `~/.pi`.
25
+ */
26
+ export async function createTestContainer(options: CodingAgentOptions = {}, ...modules: ContainerModule[]): Promise<TestContainer> {
27
+ const dir = mkdtempSync(join(tmpdir(), 'cell-coding-agent-'));
28
+ currentThis.cellProps = {
29
+ cell: { ai: { codingAgent: { cwd: dir, agentDir: join(dir, '.pi-agent'), model: FauxModels.MODEL, discoverResources: false, ...options } } },
30
+ };
31
+ const faux = await FauxModels.create();
32
+ const container = ContainerFactory.create(coreTestModule, codingAgentModule, ...modules);
33
+ container.bind(ModelRuntimeContribution).toConstantValue(faux);
34
+ ContainerProvider.set(container);
35
+ return { container, faux, dir };
36
+ }