@openrouter/agent 0.1.0

package/esm/lib/chat-compat.test.js

@@ -0,0 +1,405 @@
+import { describe, expect, it } from 'vitest';
+import { fromChatMessages, toChatMessage } from './chat-compat.js';
+/**
+ * Creates a properly typed mock OpenResponsesResult for testing.
+ * This factory provides all required fields with sensible defaults.
+ */
+function createMockResponse(overrides) {
+    return {
+        id: 'resp_test',
+        object: 'response',
+        createdAt: Date.now(),
+        completedAt: Date.now(),
+        model: 'openai/gpt-4',
+        status: 'completed',
+        error: null,
+        incompleteDetails: null,
+        temperature: null,
+        topP: null,
+        presencePenalty: null,
+        frequencyPenalty: null,
+        metadata: null,
+        tools: [],
+        toolChoice: 'auto',
+        parallelToolCalls: false,
+        ...overrides,
+    };
+}
+describe('fromChatMessages', () => {
+    describe('basic message conversion', () => {
+        it('converts user message with string content', () => {
+            const messages = [
+                {
+                    role: 'user',
+                    content: 'Hello, how are you?',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'user',
+                    content: 'Hello, how are you?',
+                },
+            ]);
+        });
+        it('converts assistant message with string content', () => {
+            const messages = [
+                {
+                    role: 'assistant',
+                    content: 'I am doing well, thank you!',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'assistant',
+                    content: 'I am doing well, thank you!',
+                },
+            ]);
+        });
+        it('converts system message with string content', () => {
+            const messages = [
+                {
+                    role: 'system',
+                    content: 'You are a helpful assistant.',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'system',
+                    content: 'You are a helpful assistant.',
+                },
+            ]);
+        });
+        it('converts developer message with string content', () => {
+            const messages = [
+                {
+                    role: 'developer',
+                    content: 'Developer instructions here.',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'developer',
+                    content: 'Developer instructions here.',
+                },
+            ]);
+        });
+        it('converts multiple messages in conversation', () => {
+            const messages = [
+                {
+                    role: 'system',
+                    content: 'You are helpful.',
+                },
+                {
+                    role: 'user',
+                    content: 'Hi',
+                },
+                {
+                    role: 'assistant',
+                    content: 'Hello!',
+                },
+                {
+                    role: 'user',
+                    content: 'How are you?',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'system',
+                    content: 'You are helpful.',
+                },
+                {
+                    role: 'user',
+                    content: 'Hi',
+                },
+                {
+                    role: 'assistant',
+                    content: 'Hello!',
+                },
+                {
+                    role: 'user',
+                    content: 'How are you?',
+                },
+            ]);
+        });
+    });
+    describe('tool response message conversion', () => {
+        it('converts tool message to function_call_output', () => {
+            const messages = [
+                {
+                    role: 'tool',
+                    content: 'The weather is sunny and 72F',
+                    toolCallId: 'call_abc123',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    type: 'function_call_output',
+                    callId: 'call_abc123',
+                    output: 'The weather is sunny and 72F',
+                },
+            ]);
+        });
+        it('converts tool message with object content by stringifying', () => {
+            const messages = [
+                {
+                    role: 'tool',
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Structured response',
+                        },
+                    ],
+                    toolCallId: 'call_def456',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    type: 'function_call_output',
+                    callId: 'call_def456',
+                    output: JSON.stringify([
+                        {
+                            type: 'text',
+                            text: 'Structured response',
+                        },
+                    ]),
+                },
+            ]);
+        });
+    });
+    describe('content array handling', () => {
+        it('stringifies array content for user messages', () => {
+            const messages = [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Hello from array',
+                        },
+                    ],
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'user',
+                    content: JSON.stringify([
+                        {
+                            type: 'text',
+                            text: 'Hello from array',
+                        },
+                    ]),
+                },
+            ]);
+        });
+        it('stringifies array content for assistant messages', () => {
+            const messages = [
+                {
+                    role: 'assistant',
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Response in array',
+                        },
+                    ],
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'assistant',
+                    content: JSON.stringify([
+                        {
+                            type: 'text',
+                            text: 'Response in array',
+                        },
+                    ]),
+                },
+            ]);
+        });
+    });
+    describe('null and empty content handling', () => {
+        it('handles null content in assistant message', () => {
+            const messages = [
+                {
+                    role: 'assistant',
+                    content: null,
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'assistant',
+                    content: '',
+                },
+            ]);
+        });
+        it('handles empty string content', () => {
+            const messages = [
+                {
+                    role: 'user',
+                    content: '',
+                },
+            ];
+            const result = fromChatMessages(messages);
+            expect(result).toEqual([
+                {
+                    role: 'user',
+                    content: '',
+                },
+            ]);
+        });
+        it('handles empty messages array', () => {
+            const result = fromChatMessages([]);
+            expect(result).toEqual([]);
+        });
+    });
+});
+describe('toChatMessage', () => {
+    describe('basic message conversion', () => {
+        it('converts response with text output to ChatAssistantMessage', () => {
+            const response = createMockResponse({
+                id: 'resp_123',
+                output: [
+                    {
+                        id: 'msg_1',
+                        type: 'message',
+                        role: 'assistant',
+                        status: 'completed',
+                        content: [
+                            {
+                                type: 'output_text',
+                                text: 'Hello! How can I help you?',
+                                annotations: [],
+                            },
+                        ],
+                    },
+                ],
+                usage: {
+                    inputTokens: 10,
+                    outputTokens: 20,
+                    totalTokens: 30,
+                    inputTokensDetails: {
+                        cachedTokens: 0,
+                    },
+                    outputTokensDetails: {
+                        reasoningTokens: 0,
+                    },
+                },
+            });
+            const result = toChatMessage(response);
+            expect(result).toEqual({
+                role: 'assistant',
+                content: 'Hello! How can I help you?',
+            });
+        });
+        it('combines multiple text parts into single content string', () => {
+            const response = createMockResponse({
+                id: 'resp_456',
+                output: [
+                    {
+                        id: 'msg_1',
+                        type: 'message',
+                        role: 'assistant',
+                        status: 'completed',
+                        content: [
+                            {
+                                type: 'output_text',
+                                text: 'Part 1. ',
+                                annotations: [],
+                            },
+                            {
+                                type: 'output_text',
+                                text: 'Part 2.',
+                                annotations: [],
+                            },
+                        ],
+                    },
+                ],
+                usage: {
+                    inputTokens: 5,
+                    outputTokens: 10,
+                    totalTokens: 15,
+                    inputTokensDetails: {
+                        cachedTokens: 0,
+                    },
+                    outputTokensDetails: {
+                        reasoningTokens: 0,
+                    },
+                },
+            });
+            const result = toChatMessage(response);
+            expect(result).toEqual({
+                role: 'assistant',
+                content: 'Part 1. Part 2.',
+            });
+        });
+        it('returns null content when message has no text', () => {
+            const response = createMockResponse({
+                id: 'resp_789',
+                output: [
+                    {
+                        id: 'msg_1',
+                        type: 'message',
+                        role: 'assistant',
+                        status: 'completed',
+                        content: [],
+                    },
+                ],
+                usage: {
+                    inputTokens: 5,
+                    outputTokens: 0,
+                    totalTokens: 5,
+                    inputTokensDetails: {
+                        cachedTokens: 0,
+                    },
+                    outputTokensDetails: {
+                        reasoningTokens: 0,
+                    },
+                },
+            });
+            const result = toChatMessage(response);
+            expect(result).toEqual({
+                role: 'assistant',
+                content: null,
+            });
+        });
+    });
+    describe('error handling', () => {
+        it('throws error when no message found in output', () => {
+            const response = createMockResponse({
+                id: 'resp_err',
+                output: [
+                    {
+                        type: 'function_call',
+                        callId: 'call_1',
+                        name: 'test_tool',
+                        arguments: '{}',
+                        id: 'fc_1',
+                        status: 'completed',
+                    },
+                ],
+                usage: {
+                    inputTokens: 5,
+                    outputTokens: 10,
+                    totalTokens: 15,
+                    inputTokensDetails: {
+                        cachedTokens: 0,
+                    },
+                    outputTokensDetails: {
+                        reasoningTokens: 0,
+                    },
+                },
+            });
+            expect(() => toChatMessage(response)).toThrow('No message found in response output');
+        });
+    });
+});
+//# sourceMappingURL=chat-compat.test.js.map

package/esm/lib/chat-compat.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-compat.test.js","sourceRoot":"","sources":["../../src/lib/chat-compat.test.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;GAGG;AACH,SAAS,kBAAkB,CACzB,SAEC;IAED,OAAO;QACL,EAAE,EAAE,WAAW;QACf,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,IAAI;QACX,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;QACV,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,MAAM;QAClB,iBAAiB,EAAE,KAAK;QACxB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,qBAAqB;iBAC/B;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,qBAAqB;iBAC/B;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,6BAA6B;iBACvC;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,6BAA6B;iBACvC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,8BAA8B;iBACxC;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,8BAA8B;iBACxC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,8BAA8B;iBACxC;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,8BAA8B;iBACxC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,kBAAkB;iBAC5B;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI;iBACd;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,QAAQ;iBAClB;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,cAAc;iBACxB;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,kBAAkB;iBAC5B;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI;iBACd;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,QAAQ;iBAClB;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,cAAc;iBACxB;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,8BAA8B;oBACvC,UAAU,EAAE,aAAa;iBAC1B;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,MAAM,EAAE,aAAa;oBACrB,MAAM,EAAE,8BAA8B;iBACvC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qBAAqB;yBAC5B;qBACF;oBACD,UAAU,EAAE,aAAa;iBAC1B;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,MAAM,EAAE,aAAa;oBACrB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;wBACrB;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qBAAqB;yBAC5B;qBACF,CAAC;iBACH;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,kBAAkB;yBACzB;qBACF;iBACF;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;wBACtB;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,kBAAkB;yBACzB;qBACF,CAAC;iBACH;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mBAAmB;yBAC1B;qBACF;iBACF;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;wBACtB;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mBAAmB;yBAC1B;qBACF,CAAC;iBACH;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI;iBACd;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,EAAE;iBACZ;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE;iBACZ;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE;iBACZ;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,MAAM,QAAQ,GAAG,kBAAkB,CAAC;gBAClC,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,OAAO;wBACX,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,WAAW;wBACnB,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,aAAa;gCACnB,IAAI,EAAE,4BAA4B;gCAClC,WAAW,EAAE,EAAE;6BAChB;yBACF;qBACF;iBACF;gBACD,KAAK,EAAE;oBACL,WAAW,EAAE,EAAE;oBACf,YAAY,EAAE,EAAE;oBAChB,WAAW,EAAE,EAAE;oBACf,kBAAkB,EAAE;wBAClB,YAAY,EAAE,CAAC;qBAChB;oBACD,mBAAmB,EAAE;wBACnB,eAAe,EAAE,CAAC;qBACnB;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,4BAA4B;aACtC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,QAAQ,GAAG,kBAAkB,CAAC;gBAClC,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,OAAO;wBACX,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,WAAW;wBACnB,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,aAAa;gCACnB,IAAI,EAAE,UAAU;gCAChB,WAAW,EAAE,EAAE;6BAChB;4BACD;gCACE,IAAI,EAAE,aAAa;gCACnB,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,EAAE;6BAChB;yBACF;qBACF;iBACF;gBACD,KAAK,EAAE;oBACL,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,EAAE;oBAChB,WAAW,EAAE,EAAE;oBACf,kBAAkB,EAAE;wBAClB,YAAY,EAAE,CAAC;qBAChB;oBACD,mBAAmB,EAAE;wBACnB,eAAe,EAAE,CAAC;qBACnB;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,iBAAiB;aAC3B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC;gBAClC,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,OAAO;wBACX,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,WAAW;wBACnB,OAAO,EAAE,EAAE;qBACZ;iBACF;gBACD,KAAK,EAAE;oBACL,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,CAAC;oBACf,WAAW,EAAE,CAAC;oBACd,kBAAkB,EAAE;wBAClB,YAAY,EAAE,CAAC;qBAChB;oBACD,mBAAmB,EAAE;wBACnB,eAAe,EAAE,CAAC;qBACnB;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,QAAQ,GAAG,kBAAkB,CAAC;gBAClC,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,eAAe;wBACrB,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,WAAW;wBACjB,SAAS,EAAE,IAAI;wBACf,EAAE,EAAE,MAAM;wBACV,MAAM,EAAE,WAAW;qBACpB;iBACF;gBACD,KAAK,EAAE;oBACL,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,EAAE;oBAChB,WAAW,EAAE,EAAE;oBACf,kBAAkB,EAAE;wBAClB,YAAY,EAAE,CAAC;qBAChB;oBACD,mBAAmB,EAAE;wBACnB,eAAe,EAAE,CAAC;qBACnB;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/esm/lib/claude-constants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Claude-specific content block types
+ * Used for detecting Claude message format
+ */
+export declare const ClaudeContentBlockType: {
+    readonly Text: "text";
+    readonly Image: "image";
+    readonly ToolUse: "tool_use";
+    readonly ToolResult: "tool_result";
+};
+export type ClaudeContentBlockType = (typeof ClaudeContentBlockType)[keyof typeof ClaudeContentBlockType];
+/**
+ * Message roles that are NOT supported in Claude format
+ * Used for distinguishing Claude vs OpenAI format
+ */
+export declare const NonClaudeMessageRole: {
+    readonly System: "system";
+    readonly Developer: "developer";
+    readonly Tool: "tool";
+};
+export type NonClaudeMessageRole = (typeof NonClaudeMessageRole)[keyof typeof NonClaudeMessageRole];
+//# sourceMappingURL=claude-constants.d.ts.map

package/esm/lib/claude-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-constants.d.ts","sourceRoot":"","sources":["../../src/lib/claude-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC"}

package/esm/lib/claude-constants.js

@@ -0,0 +1,20 @@
+/**
+ * Claude-specific content block types
+ * Used for detecting Claude message format
+ */
+export const ClaudeContentBlockType = {
+    Text: 'text',
+    Image: 'image',
+    ToolUse: 'tool_use',
+    ToolResult: 'tool_result',
+};
+/**
+ * Message roles that are NOT supported in Claude format
+ * Used for distinguishing Claude vs OpenAI format
+ */
+export const NonClaudeMessageRole = {
+    System: 'system',
+    Developer: 'developer',
+    Tool: 'tool',
+};
+//# sourceMappingURL=claude-constants.js.map

package/esm/lib/claude-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-constants.js","sourceRoot":"","sources":["../../src/lib/claude-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;CACjB,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/esm/lib/claude-type-guards.d.ts

@@ -0,0 +1,10 @@
+import type { ClaudeMessageParam } from '../api-shape-helpers/claude-message.js';
+/**
+ * Check if input is in Claude message format
+ * Uses structural analysis to detect Claude-specific patterns
+ *
+ * @param input - Input to check
+ * @returns True if input appears to be Claude format
+ */
+export declare function isClaudeStyleMessages(input: unknown): input is ClaudeMessageParam[];
+//# sourceMappingURL=claude-type-guards.d.ts.map

package/esm/lib/claude-type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-type-guards.d.ts","sourceRoot":"","sources":["../../src/lib/claude-type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AA8CjF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,EAAE,CAuBnF"}

package/esm/lib/claude-type-guards.js

@@ -0,0 +1,68 @@
+import { ClaudeContentBlockType, NonClaudeMessageRole } from './claude-constants.js';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isNonClaudeRole(role) {
+    return (role === NonClaudeMessageRole.System ||
+        role === NonClaudeMessageRole.Developer ||
+        role === NonClaudeMessageRole.Tool);
+}
+function isClaudeToolResultBlock(block) {
+    if (!isRecord(block))
+        return false;
+    return block['type'] === ClaudeContentBlockType.ToolResult;
+}
+function isClaudeImageBlockWithSource(block) {
+    if (!isRecord(block))
+        return false;
+    return (block['type'] === ClaudeContentBlockType.Image && 'source' in block && isRecord(block['source']));
+}
+function isClaudeToolUseBlockWithId(block) {
+    if (!isRecord(block))
+        return false;
+    return (block['type'] === ClaudeContentBlockType.ToolUse &&
+        'id' in block &&
+        typeof block['id'] === 'string');
+}
+function hasClaudeSpecificBlocks(content) {
+    for (const block of content) {
+        if (isClaudeToolResultBlock(block))
+            return true;
+        if (isClaudeImageBlockWithSource(block))
+            return true;
+        if (isClaudeToolUseBlockWithId(block))
+            return true;
+    }
+    return false;
+}
+/**
+ * Check if input is in Claude message format
+ * Uses structural analysis to detect Claude-specific patterns
+ *
+ * @param input - Input to check
+ * @returns True if input appears to be Claude format
+ */
+export function isClaudeStyleMessages(input) {
+    if (!Array.isArray(input) || input.length === 0) {
+        return false;
+    }
+    for (const msg of input) {
+        if (!isRecord(msg))
+            continue;
+        if (!('role' in msg))
+            continue;
+        if ('type' in msg)
+            continue; // Claude messages don't have top-level "type"
+        // If we find a non-Claude role, it's not Claude format
+        if (isNonClaudeRole(msg['role'])) {
+            return false;
+        }
+        // If we find Claude-specific content blocks, it's Claude format
+        const content = msg['content'];
+        if (Array.isArray(content) && hasClaudeSpecificBlocks(content)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=claude-type-guards.js.map

package/esm/lib/claude-type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-type-guards.js","sourceRoot":"","sources":["../../src/lib/claude-type-guards.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAErF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACpC,OAAO,CACL,IAAI,KAAK,oBAAoB,CAAC,MAAM;QACpC,IAAI,KAAK,oBAAoB,CAAC,SAAS;QACvC,IAAI,KAAK,oBAAoB,CAAC,IAAI,CACnC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,sBAAsB,CAAC,UAAU,CAAC;AAC7D,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc;IAClD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CACL,KAAK,CAAC,MAAM,CAAC,KAAK,sBAAsB,CAAC,KAAK,IAAI,QAAQ,IAAI,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CACjG,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CACL,KAAK,CAAC,MAAM,CAAC,KAAK,sBAAsB,CAAC,OAAO;QAChD,IAAI,IAAI,KAAK;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAkB;IACjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,uBAAuB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,IAAI,4BAA4B,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrD,IAAI,0BAA0B,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;YAAE,SAAS;QAC/B,IAAI,MAAM,IAAI,GAAG;YAAE,SAAS,CAAC,8CAA8C;QAE3E,uDAAuD;QACvD,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gEAAgE;QAChE,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/esm/lib/conversation-state.d.ts

@@ -0,0 +1,61 @@
+import type * as models from '@openrouter/sdk/models';
+import type { ConversationState, ParsedToolCall, Tool, TurnContext, UnsentToolResult } from './tool-types.js';
+/**
+ * Generate a unique ID for a conversation
+ * Uses crypto.randomUUID if available, falls back to timestamp + random
+ */
+export declare function generateConversationId(): string;
+/**
+ * Create an initial conversation state
+ * @param id - Optional custom ID, generates one if not provided
+ */
+export declare function createInitialState<TTools extends readonly Tool[] = readonly Tool[]>(id?: string): ConversationState<TTools>;
+/**
+ * Update a conversation state with new values
+ * Automatically updates the updatedAt timestamp
+ */
+export declare function updateState<TTools extends readonly Tool[] = readonly Tool[]>(state: ConversationState<TTools>, updates: Partial<Omit<ConversationState<TTools>, 'id' | 'createdAt' | 'updatedAt'>>): ConversationState<TTools>;
+/**
+ * Append new items to the message history
+ */
+export declare function appendToMessages(current: models.InputsUnion, newItems: models.BaseInputsUnion[]): models.InputsUnion;
+/**
+ * Check if a tool call requires approval
+ * @param toolCall - The tool call to check
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export declare function toolRequiresApproval<TTools extends readonly Tool[]>(toolCall: ParsedToolCall<TTools[number]>, tools: TTools, context: TurnContext, callLevelCheck?: (toolCall: ParsedToolCall<TTools[number]>, context: TurnContext) => boolean | Promise<boolean>): Promise<boolean>;
+/**
+ * Partition tool calls into those requiring approval and those that can auto-execute
+ * @param toolCalls - Tool calls to partition
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export declare function partitionToolCalls<TTools extends readonly Tool[]>(toolCalls: ParsedToolCall<TTools[number]>[], tools: TTools, context: TurnContext, callLevelCheck?: (toolCall: ParsedToolCall<TTools[number]>, context: TurnContext) => boolean | Promise<boolean>): Promise<{
+    requiresApproval: ParsedToolCall<TTools[number]>[];
+    autoExecute: ParsedToolCall<TTools[number]>[];
+}>;
+/**
+ * Create an unsent tool result from a successful execution
+ */
+export declare function createUnsentResult<TTools extends readonly Tool[] = readonly Tool[]>(callId: string, name: string, output: unknown): UnsentToolResult<TTools>;
+/**
+ * Create an unsent tool result from a rejection
+ */
+export declare function createRejectedResult<TTools extends readonly Tool[] = readonly Tool[]>(callId: string, name: string, reason?: string): UnsentToolResult<TTools>;
+/**
+ * Convert unsent tool results to API format for sending to the model
+ */
+export declare function unsentResultsToAPIFormat(results: UnsentToolResult[]): models.FunctionCallOutputItem[];
+/**
+ * Extract text content from a response
+ */
+export declare function extractTextFromResponse(response: models.OpenResponsesResult): string;
+/**
+ * Extract tool calls from a response
+ */
+export declare function extractToolCallsFromResponse<TTools extends readonly Tool[]>(response: models.OpenResponsesResult): ParsedToolCall<TTools[number]>[];
+//# sourceMappingURL=conversation-state.d.ts.map

package/esm/lib/conversation-state.d.ts.map

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