@tpsdev-ai/agent 0.5.3 → 0.6.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 (64) hide show
  1. package/dist/bin.js +47 -2
  2. package/dist/bin.js.map +1 -1
  3. package/dist/config.d.ts +2 -1
  4. package/dist/config.d.ts.map +1 -1
  5. package/dist/config.js +8 -0
  6. package/dist/config.js.map +1 -1
  7. package/dist/index.d.ts +4 -0
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +4 -0
  10. package/dist/index.js.map +1 -1
  11. package/dist/io/flair.d.ts +43 -0
  12. package/dist/io/flair.d.ts.map +1 -0
  13. package/dist/io/flair.js +143 -0
  14. package/dist/io/flair.js.map +1 -0
  15. package/dist/io/mail.d.ts +24 -2
  16. package/dist/io/mail.d.ts.map +1 -1
  17. package/dist/io/mail.js +168 -15
  18. package/dist/io/mail.js.map +1 -1
  19. package/dist/lib/signEnvelope.d.ts +67 -0
  20. package/dist/lib/signEnvelope.d.ts.map +1 -0
  21. package/dist/lib/signEnvelope.js +244 -0
  22. package/dist/lib/signEnvelope.js.map +1 -0
  23. package/dist/llm/provider.d.ts +21 -1
  24. package/dist/llm/provider.d.ts.map +1 -1
  25. package/dist/llm/provider.js +422 -23
  26. package/dist/llm/provider.js.map +1 -1
  27. package/dist/runtime/agent.d.ts +2 -0
  28. package/dist/runtime/agent.d.ts.map +1 -1
  29. package/dist/runtime/agent.js +50 -3
  30. package/dist/runtime/agent.js.map +1 -1
  31. package/dist/runtime/event-loop.d.ts +44 -2
  32. package/dist/runtime/event-loop.d.ts.map +1 -1
  33. package/dist/runtime/event-loop.js +478 -56
  34. package/dist/runtime/event-loop.js.map +1 -1
  35. package/dist/runtime/types.d.ts +27 -1
  36. package/dist/runtime/types.d.ts.map +1 -1
  37. package/dist/telemetry/events.d.ts +57 -0
  38. package/dist/telemetry/events.d.ts.map +1 -0
  39. package/dist/telemetry/events.js +37 -0
  40. package/dist/telemetry/events.js.map +1 -0
  41. package/dist/tools/edit.d.ts.map +1 -1
  42. package/dist/tools/edit.js +94 -16
  43. package/dist/tools/edit.js.map +1 -1
  44. package/package.json +10 -2
  45. package/src/bin.ts +56 -3
  46. package/src/config.ts +10 -1
  47. package/src/index.ts +8 -0
  48. package/src/io/flair.ts +183 -0
  49. package/src/io/mail.ts +184 -19
  50. package/src/lib/signEnvelope.ts +332 -0
  51. package/src/llm/provider.ts +454 -22
  52. package/src/runtime/agent.ts +55 -3
  53. package/src/runtime/event-loop.ts +523 -44
  54. package/src/runtime/types.ts +32 -1
  55. package/src/telemetry/events.ts +101 -0
  56. package/src/tools/edit.ts +108 -17
  57. package/test/bin-launch-id.test.ts +104 -0
  58. package/test/core-loop.test.ts +240 -0
  59. package/test/events.test.ts +33 -0
  60. package/test/flair-context.test.ts +102 -0
  61. package/test/governance.test.ts +103 -2
  62. package/test/io.test.ts +8 -8
  63. package/test/provider.test.ts +471 -0
  64. package/test/security/mail-trust.test.ts +266 -0
@@ -0,0 +1,471 @@
1
+ import { beforeEach, afterEach } from "bun:test";
2
+ let _savedFetch: typeof globalThis.fetch;
3
+ beforeEach(() => { _savedFetch = globalThis.fetch; });
4
+ afterEach(() => { globalThis.fetch = _savedFetch; });
5
+ import { describe, expect, test } from "bun:test";
6
+ import { ProviderManager } from "../src/llm/provider.js";
7
+
8
+ // We test the response mappers by calling complete() with mocked fetch.
9
+ // Each provider has a distinct response format — these tests ensure
10
+ // tool calls are normalized correctly into { id, name, input }.
11
+
12
+ function makeProvider(provider: "anthropic" | "openai" | "ollama" | "google") {
13
+ return new ProviderManager({
14
+ provider,
15
+ model: "test-model",
16
+ apiKey: "test-key",
17
+ });
18
+ }
19
+
20
+ // --- Anthropic ---
21
+
22
+ describe("Anthropic response mapping", () => {
23
+ test("parses tool_use blocks", async () => {
24
+ const pm = makeProvider("anthropic");
25
+ const raw = {
26
+ content: [
27
+ { type: "text", text: "I'll write that file." },
28
+ {
29
+ type: "tool_use",
30
+ id: "toolu_123",
31
+ name: "write",
32
+ input: { path: "hello.txt", content: "Hello!" },
33
+ },
34
+ ],
35
+ usage: { input_tokens: 100, output_tokens: 50 },
36
+ };
37
+
38
+ globalThis.fetch = async () =>
39
+ new Response(JSON.stringify(raw), { status: 200 });
40
+
41
+ const res = await pm.complete({
42
+ messages: [{ role: "user", content: "test" }],
43
+ tools: [{ name: "write", description: "Write a file", input_schema: { type: "object", properties: {} } }],
44
+ });
45
+
46
+ expect(res.content).toBe("I'll write that file.");
47
+ expect(res.toolCalls).toHaveLength(1);
48
+ expect(res.toolCalls![0].id).toBe("toolu_123");
49
+ expect(res.toolCalls![0].name).toBe("write");
50
+ expect(res.toolCalls![0].input).toEqual({ path: "hello.txt", content: "Hello!" });
51
+ expect(res.inputTokens).toBe(100);
52
+ expect(res.outputTokens).toBe(50);
53
+ });
54
+
55
+ test("handles text-only response (no tools)", async () => {
56
+ const pm = makeProvider("anthropic");
57
+ const raw = {
58
+ content: [{ type: "text", text: "Done." }],
59
+ usage: { input_tokens: 10, output_tokens: 5 },
60
+ };
61
+
62
+ globalThis.fetch = async () =>
63
+ new Response(JSON.stringify(raw), { status: 200 });
64
+
65
+ const res = await pm.complete({
66
+ messages: [{ role: "user", content: "test" }],
67
+ tools: [],
68
+ });
69
+
70
+ expect(res.content).toBe("Done.");
71
+ expect(res.toolCalls).toBeUndefined();
72
+ });
73
+
74
+ test("handles multiple tool calls", async () => {
75
+ const pm = makeProvider("anthropic");
76
+ const raw = {
77
+ content: [
78
+ { type: "tool_use", id: "t1", name: "read", input: { path: "a.txt" } },
79
+ { type: "tool_use", id: "t2", name: "write", input: { path: "b.txt", content: "hi" } },
80
+ ],
81
+ usage: { input_tokens: 0, output_tokens: 0 },
82
+ };
83
+
84
+ globalThis.fetch = async () =>
85
+ new Response(JSON.stringify(raw), { status: 200 });
86
+
87
+ const res = await pm.complete({
88
+ messages: [{ role: "user", content: "test" }],
89
+ tools: [],
90
+ });
91
+
92
+ expect(res.toolCalls).toHaveLength(2);
93
+ expect(res.toolCalls![0].name).toBe("read");
94
+ expect(res.toolCalls![1].name).toBe("write");
95
+ });
96
+ });
97
+
98
+ // --- OpenAI ---
99
+
100
+ describe("OpenAI response mapping", () => {
101
+ test("parses function tool calls", async () => {
102
+ const pm = makeProvider("openai");
103
+ const raw = {
104
+ choices: [
105
+ {
106
+ message: {
107
+ content: "",
108
+ tool_calls: [
109
+ {
110
+ id: "call_abc",
111
+ function: {
112
+ name: "exec",
113
+ arguments: '{"command":"ls -la"}',
114
+ },
115
+ },
116
+ ],
117
+ },
118
+ },
119
+ ],
120
+ usage: { prompt_tokens: 200, completion_tokens: 30 },
121
+ };
122
+
123
+ globalThis.fetch = async () =>
124
+ new Response(JSON.stringify(raw), { status: 200 });
125
+
126
+ const res = await pm.complete({
127
+ messages: [{ role: "user", content: "test" }],
128
+ tools: [{ name: "exec", description: "Run command", input_schema: { type: "object", properties: {} } }],
129
+ });
130
+
131
+ expect(res.toolCalls).toHaveLength(1);
132
+ expect(res.toolCalls![0].id).toBe("call_abc");
133
+ expect(res.toolCalls![0].name).toBe("exec");
134
+ expect(res.toolCalls![0].input).toEqual({ command: "ls -la" });
135
+ expect(res.inputTokens).toBe(200);
136
+ expect(res.outputTokens).toBe(30);
137
+ });
138
+
139
+ test("handles text-only response", async () => {
140
+ const pm = makeProvider("openai");
141
+ const raw = {
142
+ choices: [{ message: { content: "All done.", tool_calls: undefined } }],
143
+ usage: { prompt_tokens: 10, completion_tokens: 5 },
144
+ };
145
+
146
+ globalThis.fetch = async () =>
147
+ new Response(JSON.stringify(raw), { status: 200 });
148
+
149
+ const res = await pm.complete({
150
+ messages: [{ role: "user", content: "test" }],
151
+ tools: [],
152
+ });
153
+
154
+ expect(res.content).toBe("All done.");
155
+ expect(res.toolCalls).toBeUndefined();
156
+ });
157
+ });
158
+
159
+ // --- Ollama ---
160
+
161
+ describe("Ollama response mapping", () => {
162
+ test("parses function tool calls (object arguments)", async () => {
163
+ const pm = makeProvider("ollama");
164
+ const raw = {
165
+ message: {
166
+ role: "assistant",
167
+ content: "",
168
+ tool_calls: [
169
+ {
170
+ id: "call_xyz",
171
+ function: {
172
+ name: "write",
173
+ arguments: { path: "test.txt", content: "hello" },
174
+ },
175
+ },
176
+ ],
177
+ },
178
+ prompt_eval_count: 143,
179
+ eval_count: 100,
180
+ };
181
+
182
+ globalThis.fetch = async () =>
183
+ new Response(JSON.stringify(raw), { status: 200 });
184
+
185
+ const res = await pm.complete({
186
+ messages: [{ role: "user", content: "test" }],
187
+ tools: [{ name: "write", description: "Write a file", input_schema: { type: "object", properties: {} } }],
188
+ });
189
+
190
+ expect(res.toolCalls).toHaveLength(1);
191
+ expect(res.toolCalls![0].name).toBe("write");
192
+ expect(res.toolCalls![0].input).toEqual({ path: "test.txt", content: "hello" });
193
+ expect(res.inputTokens).toBe(143);
194
+ expect(res.outputTokens).toBe(100);
195
+ });
196
+
197
+ test("parses function tool calls (string arguments)", async () => {
198
+ const pm = makeProvider("ollama");
199
+ const raw = {
200
+ message: {
201
+ role: "assistant",
202
+ content: "",
203
+ tool_calls: [
204
+ {
205
+ id: "call_str",
206
+ function: {
207
+ name: "read",
208
+ arguments: '{"path":"config.yaml"}',
209
+ },
210
+ },
211
+ ],
212
+ },
213
+ prompt_eval_count: 50,
214
+ eval_count: 20,
215
+ };
216
+
217
+ globalThis.fetch = async () =>
218
+ new Response(JSON.stringify(raw), { status: 200 });
219
+
220
+ const res = await pm.complete({
221
+ messages: [{ role: "user", content: "test" }],
222
+ tools: [{ name: "read", description: "Read a file", input_schema: { type: "object", properties: {} } }],
223
+ });
224
+
225
+ expect(res.toolCalls).toHaveLength(1);
226
+ expect(res.toolCalls![0].name).toBe("read");
227
+ expect(res.toolCalls![0].input).toEqual({ path: "config.yaml" });
228
+ });
229
+
230
+ test("handles text-only response", async () => {
231
+ const pm = makeProvider("ollama");
232
+ const raw = {
233
+ message: { role: "assistant", content: "File written." },
234
+ prompt_eval_count: 10,
235
+ eval_count: 5,
236
+ };
237
+
238
+ globalThis.fetch = async () =>
239
+ new Response(JSON.stringify(raw), { status: 200 });
240
+
241
+ const res = await pm.complete({
242
+ messages: [{ role: "user", content: "test" }],
243
+ tools: [],
244
+ });
245
+
246
+ expect(res.content).toBe("File written.");
247
+ expect(res.toolCalls).toBeUndefined();
248
+ });
249
+ });
250
+
251
+ // --- Google ---
252
+
253
+ describe("Google response mapping", () => {
254
+ test("parses functionCall parts", async () => {
255
+ const pm = makeProvider("google");
256
+ const raw = {
257
+ candidates: [
258
+ {
259
+ content: {
260
+ parts: [
261
+ {
262
+ functionCall: {
263
+ name: "write",
264
+ args: { path: "out.txt", content: "data" },
265
+ },
266
+ },
267
+ ],
268
+ },
269
+ },
270
+ ],
271
+ usageMetadata: { promptTokenCount: 80, candidatesTokenCount: 40 },
272
+ };
273
+
274
+ globalThis.fetch = async () =>
275
+ new Response(JSON.stringify(raw), { status: 200 });
276
+
277
+ const res = await pm.complete({
278
+ messages: [{ role: "user", content: "test" }],
279
+ tools: [{ name: "write", description: "Write", input_schema: { type: "object", properties: {} } }],
280
+ });
281
+
282
+ expect(res.toolCalls).toHaveLength(1);
283
+ expect(res.toolCalls![0].name).toBe("write");
284
+ expect(res.toolCalls![0].input).toEqual({ path: "out.txt", content: "data" });
285
+ expect(res.inputTokens).toBe(80);
286
+ expect(res.outputTokens).toBe(40);
287
+ });
288
+
289
+ test("parses text-only response", async () => {
290
+ const pm = makeProvider("google");
291
+ const raw = {
292
+ candidates: [
293
+ {
294
+ content: {
295
+ parts: [{ text: "Here's your answer." }],
296
+ },
297
+ },
298
+ ],
299
+ usageMetadata: { promptTokenCount: 10, candidatesTokenCount: 8 },
300
+ };
301
+
302
+ globalThis.fetch = async () =>
303
+ new Response(JSON.stringify(raw), { status: 200 });
304
+
305
+ const res = await pm.complete({
306
+ messages: [{ role: "user", content: "test" }],
307
+ tools: [],
308
+ });
309
+
310
+ expect(res.content).toBe("Here's your answer.");
311
+ expect(res.toolCalls).toBeUndefined();
312
+ });
313
+
314
+ test("handles mixed text + functionCall parts", async () => {
315
+ const pm = makeProvider("google");
316
+ const raw = {
317
+ candidates: [
318
+ {
319
+ content: {
320
+ parts: [
321
+ { text: "Let me check." },
322
+ { functionCall: { name: "read", args: { path: "data.json" } } },
323
+ ],
324
+ },
325
+ },
326
+ ],
327
+ usageMetadata: { promptTokenCount: 0, candidatesTokenCount: 0 },
328
+ };
329
+
330
+ globalThis.fetch = async () =>
331
+ new Response(JSON.stringify(raw), { status: 200 });
332
+
333
+ const res = await pm.complete({
334
+ messages: [{ role: "user", content: "test" }],
335
+ tools: [],
336
+ });
337
+
338
+ expect(res.content).toBe("Let me check.");
339
+ expect(res.toolCalls).toHaveLength(1);
340
+ expect(res.toolCalls![0].name).toBe("read");
341
+ });
342
+ });
343
+
344
+ // --- Tool schema formatting ---
345
+
346
+ describe("Tool schema formatting", () => {
347
+ const spec = {
348
+ name: "write",
349
+ description: "Write a file",
350
+ input_schema: { type: "object", properties: { path: { type: "string" } } },
351
+ };
352
+
353
+ test("Anthropic format", () => {
354
+ const pm = makeProvider("anthropic");
355
+ const fn = pm.toolInputSchemaFor("anthropic");
356
+ const result = fn([spec]) as any[];
357
+ expect(result[0].name).toBe("write");
358
+ expect(result[0].input_schema).toBeDefined();
359
+ expect(result[0].function).toBeUndefined();
360
+ });
361
+
362
+ test("OpenAI format wraps in function object", () => {
363
+ const pm = makeProvider("openai");
364
+ const fn = pm.toolInputSchemaFor("openai");
365
+ const result = fn([spec]) as any[];
366
+ expect(result[0].type).toBe("function");
367
+ expect(result[0].function.name).toBe("write");
368
+ expect(result[0].function.parameters).toBeDefined();
369
+ });
370
+
371
+ test("Ollama uses OpenAI format", () => {
372
+ const pm = makeProvider("ollama");
373
+ const fn = pm.toolInputSchemaFor("ollama");
374
+ const result = fn([spec]) as any[];
375
+ expect(result[0].type).toBe("function");
376
+ expect(result[0].function.name).toBe("write");
377
+ });
378
+
379
+ test("Google format uses functionDeclarations", () => {
380
+ const pm = makeProvider("google");
381
+ const fn = pm.toolInputSchemaFor("google");
382
+ const result = fn([spec]) as any;
383
+ expect(result.functionDeclarations).toHaveLength(1);
384
+ expect(result.functionDeclarations[0].name).toBe("write");
385
+ });
386
+ });
387
+
388
+ // --- Edge cases ---
389
+
390
+ describe("Edge cases", () => {
391
+ test("safeJson handles malformed string", async () => {
392
+ const pm = makeProvider("openai");
393
+ const raw = {
394
+ choices: [
395
+ {
396
+ message: {
397
+ tool_calls: [
398
+ { id: "c1", function: { name: "exec", arguments: "not json{" } },
399
+ ],
400
+ },
401
+ },
402
+ ],
403
+ usage: { prompt_tokens: 0, completion_tokens: 0 },
404
+ };
405
+
406
+ globalThis.fetch = async () =>
407
+ new Response(JSON.stringify(raw), { status: 200 });
408
+
409
+ const res = await pm.complete({
410
+ messages: [{ role: "user", content: "test" }],
411
+ tools: [],
412
+ });
413
+
414
+ expect(res.toolCalls![0].input).toEqual({});
415
+ });
416
+
417
+ test("handles empty/missing content gracefully", async () => {
418
+ const pm = makeProvider("anthropic");
419
+ const raw = { content: [], usage: {} };
420
+
421
+ globalThis.fetch = async () =>
422
+ new Response(JSON.stringify(raw), { status: 200 });
423
+
424
+ const res = await pm.complete({
425
+ messages: [{ role: "user", content: "test" }],
426
+ tools: [],
427
+ });
428
+
429
+ expect(res.content).toBe("");
430
+ expect(res.toolCalls).toBeUndefined();
431
+ });
432
+ });
433
+
434
+
435
+ describe("Google OAuth mode", () => {
436
+ test("uses bearer token when auth=oauth", async () => {
437
+ const { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } = await import("node:fs");
438
+ const { join } = await import("node:path");
439
+ const { homedir } = await import("node:os");
440
+
441
+ const authDir = join(process.env.HOME || homedir(), ".tps", "auth");
442
+ const authFile = join(authDir, "google.json");
443
+ mkdirSync(authDir, { recursive: true });
444
+
445
+ const hadOriginal = existsSync(authFile);
446
+ const original = hadOriginal ? readFileSync(authFile, "utf-8") : undefined;
447
+
448
+ writeFileSync(authFile, JSON.stringify({
449
+ provider: "google",
450
+ refreshToken: "r",
451
+ accessToken: "bearer-1",
452
+ expiresAt: Date.now() + 3600_000,
453
+ clientId: "cid",
454
+ scopes: "s",
455
+ }));
456
+
457
+ const pm = new ProviderManager({ provider: "google", model: "test-model", auth: "oauth" });
458
+ let authHeader = "";
459
+ globalThis.fetch = (async (_url: string, init: any) => {
460
+ authHeader = init?.headers?.Authorization || "";
461
+ return new Response(JSON.stringify({ candidates: [{ content: { parts: [{ text: "ok" }] } }], usageMetadata: {} }), { status: 200 });
462
+ }) as any;
463
+
464
+ const res = await pm.complete({ messages: [{ role: "user", content: "hi" }], tools: [] });
465
+ expect(res.content).toBe("ok");
466
+ expect(authHeader).toBe("Bearer bearer-1");
467
+
468
+ if (hadOriginal && original !== undefined) writeFileSync(authFile, original);
469
+ else rmSync(authFile, { force: true });
470
+ });
471
+ });