@proteinjs/conversation 2.7.2 → 3.0.0

package/dist/src/resolveModel.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferProvider = exports.resolveModel = void 0;
+/**
+ * Known provider prefixes and their model factory functions.
+ *
+ * Each factory lazily imports the provider package and creates a model instance.
+ * This keeps imports optional: if a provider package is not installed, the
+ * factory simply throws a helpful error at call time.
+ */
+var PROVIDER_FACTORIES = {
+    openai: function (modelId) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        var openai = require('@ai-sdk/openai').openai;
+        return openai(modelId);
+    },
+    anthropic: function (modelId) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        var anthropic = require('@ai-sdk/anthropic').anthropic;
+        return anthropic(modelId);
+    },
+    google: function (modelId) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        var google = require('@ai-sdk/google').google;
+        return google(modelId);
+    },
+    xai: function (modelId) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        var xai = require('@ai-sdk/xai').xai;
+        return xai(modelId);
+    },
+};
+/**
+ * Model name patterns that map to a provider.
+ *
+ * Order matters: first match wins. Patterns are tested against the raw model
+ * string (case-insensitive).
+ */
+var MODEL_PROVIDER_PATTERNS = [
+    // OpenAI models
+    { test: /^(gpt-|o[134]-|o[134]$|chatgpt|dall-e|computer-use|codex)/i, provider: 'openai' },
+    // Anthropic models
+    { test: /^claude/i, provider: 'anthropic' },
+    // Google models
+    { test: /^(gemini|gemma)/i, provider: 'google' },
+    // xAI models
+    { test: /^grok/i, provider: 'xai' },
+];
+/**
+ * Resolve a model identifier to a concrete `LanguageModel` instance.
+ *
+ * Accepted inputs:
+ * - A `LanguageModel` instance (returned as-is)
+ * - A prefixed string like `"openai:gpt-5"` or `"anthropic:claude-sonnet-4-20250514"`
+ * - A bare model name like `"gpt-5"`, `"claude-sonnet-4-20250514"`, `"gemini-2.5-pro"`, `"grok-3"`
+ *   (provider inferred from name patterns)
+ */
+function resolveModel(model) {
+    // Already a model instance
+    if (typeof model !== 'string') {
+        return model;
+    }
+    var raw = model.trim();
+    if (!raw) {
+        throw new Error('resolveModel: empty model string');
+    }
+    // Explicit provider prefix: "provider:model-id"
+    var colonIdx = raw.indexOf(':');
+    if (colonIdx > 0) {
+        var prefix = raw.slice(0, colonIdx).toLowerCase();
+        var modelId = raw.slice(colonIdx + 1);
+        var factory = PROVIDER_FACTORIES[prefix];
+        if (!factory) {
+            throw new Error("resolveModel: unknown provider prefix \"".concat(prefix, "\" in \"").concat(raw, "\". ") +
+                "Known providers: ".concat(Object.keys(PROVIDER_FACTORIES).join(', ')));
+        }
+        return factory(modelId);
+    }
+    // Infer provider from model name patterns
+    for (var _i = 0, MODEL_PROVIDER_PATTERNS_1 = MODEL_PROVIDER_PATTERNS; _i < MODEL_PROVIDER_PATTERNS_1.length; _i++) {
+        var _a = MODEL_PROVIDER_PATTERNS_1[_i], test_1 = _a.test, provider = _a.provider;
+        if (test_1.test(raw)) {
+            return PROVIDER_FACTORIES[provider](raw);
+        }
+    }
+    // Default to OpenAI for unrecognized model names
+    // (OpenAI has the most model aliases and is the most common provider)
+    return PROVIDER_FACTORIES.openai(raw);
+}
+exports.resolveModel = resolveModel;
+/**
+ * Extract the provider name from a model identifier string.
+ * Returns 'openai', 'anthropic', 'google', 'xai', or 'unknown'.
+ */
+function inferProvider(model) {
+    var _a;
+    if (typeof model !== 'string') {
+        // Try to extract from the model's provider property if available
+        var modelId = (_a = model.modelId) !== null && _a !== void 0 ? _a : '';
+        return inferProvider(modelId);
+    }
+    var raw = model.trim();
+    // Explicit prefix
+    var colonIdx = raw.indexOf(':');
+    if (colonIdx > 0) {
+        var prefix = raw.slice(0, colonIdx).toLowerCase();
+        if (PROVIDER_FACTORIES[prefix]) {
+            return prefix;
+        }
+    }
+    // Pattern match
+    for (var _i = 0, MODEL_PROVIDER_PATTERNS_2 = MODEL_PROVIDER_PATTERNS; _i < MODEL_PROVIDER_PATTERNS_2.length; _i++) {
+        var _b = MODEL_PROVIDER_PATTERNS_2[_i], test_2 = _b.test, provider = _b.provider;
+        if (test_2.test(raw)) {
+            return provider;
+        }
+    }
+    return 'unknown';
+}
+exports.inferProvider = inferProvider;
+//# sourceMappingURL=resolveModel.js.map

package/dist/src/resolveModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveModel.js","sourceRoot":"","sources":["../../src/resolveModel.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,IAAM,kBAAkB,GAAuD;IAC7E,MAAM,EAAE,UAAC,OAAO;QACd,8DAA8D;QACtD,IAAA,MAAM,GAAK,OAAO,CAAC,gBAAgB,CAAC,OAA9B,CAA+B;QAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,SAAS,EAAE,UAAC,OAAO;QACjB,8DAA8D;QACtD,IAAA,SAAS,GAAK,OAAO,CAAC,mBAAmB,CAAC,UAAjC,CAAkC;QACnD,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,EAAE,UAAC,OAAO;QACd,8DAA8D;QACtD,IAAA,MAAM,GAAK,OAAO,CAAC,gBAAgB,CAAC,OAA9B,CAA+B;QAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,GAAG,EAAE,UAAC,OAAO;QACX,8DAA8D;QACtD,IAAA,GAAG,GAAK,OAAO,CAAC,aAAa,CAAC,IAA3B,CAA4B;QACvC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,IAAM,uBAAuB,GAA8C;IACzE,gBAAgB;IAChB,EAAE,IAAI,EAAE,4DAA4D,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAE1F,mBAAmB;IACnB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE;IAE3C,gBAAgB;IAChB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAEhD,aAAa;IACb,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;CACpC,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,KAA6B;IACxD,2BAA2B;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,IAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE;QACR,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;KACrD;IAED,gDAAgD;IAChD,IAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,EAAE;QAChB,IAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACpD,IAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACxC,IAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE;YACZ,MAAM,IAAI,KAAK,CACb,kDAA0C,MAAM,qBAAS,GAAG,SAAK;gBAC/D,2BAAoB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAE,CACnE,CAAC;SACH;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;KACzB;IAED,0CAA0C;IAC1C,KAAiC,UAAuB,EAAvB,mDAAuB,EAAvB,qCAAuB,EAAvB,IAAuB,EAAE;QAA/C,IAAA,kCAAkB,EAAhB,MAAI,UAAA,EAAE,QAAQ,cAAA;QACzB,IAAI,MAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAClB,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;SAC1C;KACF;IAED,iDAAiD;IACjD,sEAAsE;IACtE,OAAO,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AApCD,oCAoCC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAA6B;;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,iEAAiE;QACjE,IAAM,OAAO,GAAG,MAAC,KAAa,CAAC,OAAO,mCAAI,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;KAC/B;IAED,IAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAEzB,kBAAkB;IAClB,IAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,EAAE;QAChB,IAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACpD,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC9B,OAAO,MAAM,CAAC;SACf;KACF;IAED,gBAAgB;IAChB,KAAiC,UAAuB,EAAvB,mDAAuB,EAAvB,qCAAuB,EAAvB,IAAuB,EAAE;QAA/C,IAAA,kCAAkB,EAAhB,MAAI,UAAA,EAAE,QAAQ,cAAA;QACzB,IAAI,MAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAClB,OAAO,QAAQ,CAAC;SACjB;KACF;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AA1BD,sCA0BC"}

package/dist/test/conversation/conversation.generateObject.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation.generateObject.test.d.ts.map

package/dist/test/conversation/conversation.generateObject.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.generateObject.test.d.ts","sourceRoot":"","sources":["../../../test/conversation/conversation.generateObject.test.ts"],"names":[],"mappings":""}

package/dist/test/conversation/conversation.generateObject.test.js

@@ -0,0 +1,153 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var Conversation_1 = require("../../src/Conversation");
+var zod_1 = require("zod");
+/**
+ * Integration tests for Conversation.generateObject.
+ *
+ * These hit the real OpenAI API (requires OPENAI_API_KEY env var).
+ * They verify structured output generation, schema strictification,
+ * JSON repair, and usage data extraction.
+ */
+var hasApiKey = !!process.env.OPENAI_API_KEY;
+var describeIfKey = hasApiKey ? describe : describe.skip;
+var TEST_MODEL = 'gpt-4.1-nano';
+var TIMEOUT = 60000;
+describeIfKey('Conversation.generateObject', function () {
+    test('returns a typed object matching a Zod schema', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var schema, conversation, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    schema = zod_1.z.object({
+                        name: zod_1.z.string(),
+                        population: zod_1.z.number(),
+                        continent: zod_1.z.string(),
+                    });
+                    conversation = new Conversation_1.Conversation({ name: 'test-object-zod' });
+                    return [4 /*yield*/, conversation.generateObject({
+                            messages: [
+                                'Give me info about France. Return the country name, population (approximate number), and continent.',
+                            ],
+                            model: TEST_MODEL,
+                            schema: schema,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    expect(result.object).toBeDefined();
+                    expect(typeof result.object.name).toBe('string');
+                    expect(typeof result.object.population).toBe('number');
+                    expect(typeof result.object.continent).toBe('string');
+                    expect(result.object.name.toLowerCase()).toContain('france');
+                    expect(result.object.population).toBeGreaterThan(1000000);
+                    // Usage should be populated
+                    expect(result.usage.totalTokenUsage.inputTokens).toBeGreaterThan(0);
+                    expect(result.usage.totalTokenUsage.outputTokens).toBeGreaterThan(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+    test('returns a typed object matching a JSON Schema', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var jsonSchema, conversation, result, lower;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    jsonSchema = {
+                        type: 'object',
+                        properties: {
+                            colors: {
+                                type: 'array',
+                                items: { type: 'string' },
+                            },
+                        },
+                        required: ['colors'],
+                    };
+                    conversation = new Conversation_1.Conversation({ name: 'test-object-json-schema' });
+                    return [4 /*yield*/, conversation.generateObject({
+                            messages: ['List the 3 primary colors (red, blue, yellow).'],
+                            model: TEST_MODEL,
+                            schema: jsonSchema,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    expect(result.object).toBeDefined();
+                    expect(Array.isArray(result.object.colors)).toBe(true);
+                    expect(result.object.colors.length).toBe(3);
+                    lower = result.object.colors.map(function (c) { return c.toLowerCase(); });
+                    expect(lower).toContain('red');
+                    expect(lower).toContain('blue');
+                    expect(lower).toContain('yellow');
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+    test('handles nested object schemas (strictification)', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var schema, conversation, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    schema = zod_1.z.object({
+                        person: zod_1.z.object({
+                            firstName: zod_1.z.string(),
+                            lastName: zod_1.z.string(),
+                            age: zod_1.z.number(),
+                        }),
+                        occupation: zod_1.z.string(),
+                    });
+                    conversation = new Conversation_1.Conversation({ name: 'test-object-nested' });
+                    return [4 /*yield*/, conversation.generateObject({
+                            messages: [
+                                'Create a fictional person profile. Use firstName "Ada", lastName "Lovelace", age 36, occupation "Mathematician".',
+                            ],
+                            model: TEST_MODEL,
+                            schema: schema,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    expect(result.object.person).toBeDefined();
+                    expect(result.object.person.firstName).toBe('Ada');
+                    expect(result.object.person.lastName).toBe('Lovelace');
+                    expect(result.object.person.age).toBe(36);
+                    expect(result.object.occupation).toBe('Mathematician');
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+});
+//# sourceMappingURL=conversation.generateObject.test.js.map

package/dist/test/conversation/conversation.generateObject.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.generateObject.test.js","sourceRoot":"","sources":["../../../test/conversation/conversation.generateObject.test.ts"],"names":[],"mappings":"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"}

package/dist/test/conversation/conversation.generateResponse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation.generateResponse.test.d.ts.map

package/dist/test/conversation/conversation.generateResponse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.generateResponse.test.d.ts","sourceRoot":"","sources":["../../../test/conversation/conversation.generateResponse.test.ts"],"names":[],"mappings":""}

package/dist/test/conversation/conversation.generateResponse.test.js

@@ -0,0 +1,167 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var Conversation_1 = require("../../src/Conversation");
+/**
+ * Integration tests for Conversation.generateResponse (non-streaming convenience).
+ *
+ * These hit the real OpenAI API (requires OPENAI_API_KEY env var).
+ */
+var hasApiKey = !!process.env.OPENAI_API_KEY;
+var describeIfKey = hasApiKey ? describe : describe.skip;
+var TEST_MODEL = 'gpt-4.1-nano';
+var TIMEOUT = 60000;
+function createTestModule(systemMessage, functions) {
+    return {
+        getName: function () { return 'TestModule'; },
+        getSystemMessages: function () { return [systemMessage]; },
+        getFunctions: function () { return functions; },
+        getMessageModerators: function () { return []; },
+    };
+}
+describeIfKey('Conversation.generateResponse', function () {
+    test('returns a complete text response with usage', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var conversation, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    conversation = new Conversation_1.Conversation({ name: 'test-response' });
+                    return [4 /*yield*/, conversation.generateResponse({
+                            messages: ['Say "hello" and nothing else.'],
+                            model: TEST_MODEL,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    expect(result.text.toLowerCase()).toContain('hello');
+                    expect(result.usage.totalTokenUsage.inputTokens).toBeGreaterThan(0);
+                    expect(result.usage.totalTokenUsage.outputTokens).toBeGreaterThan(0);
+                    expect(result.toolInvocations).toEqual([]);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+    test('accumulates usage across multiple tool call steps', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var lookupCalls, lookupTool, conversation, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    lookupCalls = [];
+                    lookupTool = {
+                        definition: {
+                            name: 'lookupCapital',
+                            description: 'Looks up the capital city of a country.',
+                            parameters: {
+                                type: 'object',
+                                properties: {
+                                    country: { type: 'string', description: 'The country name' },
+                                },
+                                required: ['country'],
+                            },
+                        },
+                        call: function (args) {
+                            var _a;
+                            return __awaiter(this, void 0, void 0, function () {
+                                var capitals;
+                                return __generator(this, function (_b) {
+                                    lookupCalls.push(args.country);
+                                    capitals = {
+                                        france: 'Paris',
+                                        japan: 'Tokyo',
+                                        brazil: 'Brasília',
+                                    };
+                                    return [2 /*return*/, { capital: (_a = capitals[args.country.toLowerCase()]) !== null && _a !== void 0 ? _a : 'Unknown' }];
+                                });
+                            });
+                        },
+                    };
+                    conversation = new Conversation_1.Conversation({
+                        name: 'test-multi-tool',
+                        modules: [
+                            createTestModule('You are a geography assistant. Use lookupCapital for each country the user asks about. Make a separate call for each country.', [lookupTool]),
+                        ],
+                    });
+                    return [4 /*yield*/, conversation.generateResponse({
+                            messages: ['What are the capitals of France, Japan, and Brazil?'],
+                            model: TEST_MODEL,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    // Should have called the tool at least 2 times (ideally 3, but LLMs can batch)
+                    expect(lookupCalls.length).toBeGreaterThanOrEqual(2);
+                    // Response should mention the capitals
+                    expect(result.text).toContain('Paris');
+                    expect(result.text).toContain('Tokyo');
+                    // Usage should reflect multiple steps
+                    expect(result.usage.totalRequestsToAssistant).toBeGreaterThanOrEqual(2);
+                    expect(result.usage.totalToolCalls).toBeGreaterThanOrEqual(2);
+                    expect(result.usage.callsPerTool['lookupCapital']).toBeGreaterThanOrEqual(2);
+                    // Total tokens should be substantial (multiple round trips)
+                    expect(result.usage.totalTokenUsage.inputTokens).toBeGreaterThan(50);
+                    expect(result.usage.totalTokenUsage.outputTokens).toBeGreaterThan(10);
+                    // Cost should be calculated (gpt-4.1-nano is in our pricing table)
+                    expect(result.usage.totalCostUsd.totalUsd).toBeGreaterThanOrEqual(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+    test('handles conversation modules with system messages', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var conversation, result, lower, hasPirateWord;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    conversation = new Conversation_1.Conversation({
+                        name: 'test-system-msg',
+                        modules: [createTestModule('You are a pirate. Always respond in pirate speak.', [])],
+                    });
+                    return [4 /*yield*/, conversation.generateResponse({
+                            messages: ['Say hello.'],
+                            model: TEST_MODEL,
+                        })];
+                case 1:
+                    result = _a.sent();
+                    lower = result.text.toLowerCase();
+                    hasPirateWord = ['ahoy', 'matey', 'arr', 'ye', 'aye', 'avast', 'yarr', 'shiver'].some(function (w) {
+                        return lower.includes(w);
+                    });
+                    expect(hasPirateWord).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, TIMEOUT);
+});
+//# sourceMappingURL=conversation.generateResponse.test.js.map

package/dist/test/conversation/conversation.generateResponse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.generateResponse.test.js","sourceRoot":"","sources":["../../../test/conversation/conversation.generateResponse.test.ts"],"names":[],"mappings":"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"}

package/dist/test/conversation/conversation.generateStream.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation.generateStream.test.d.ts.map

package/dist/test/conversation/conversation.generateStream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.generateStream.test.d.ts","sourceRoot":"","sources":["../../../test/conversation/conversation.generateStream.test.ts"],"names":[],"mappings":""}