@mohamedtebo/convai-platform 1.0.0

package/dist/providers/anthropic/anthropic.provider.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const claude_tool_loop_1 = require("./loops/claude-tool.loop");
+const error_mapper_1 = require("./utils/error-mapper");
+/**
+ * Anthropic Claude provider.
+ * Implements the same AIProvider interface as the OpenAI providers
+ * so telbany can swap providers by changing a single config field.
+ */
+class AnthropicProvider {
+    constructor(config) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const Anthropic = require('@anthropic-ai/sdk');
+            this.anthropic = new Anthropic({ apiKey: config.apiKey, maxRetries: config.maxRetries ?? 2 });
+        }
+        catch {
+            throw new Error('@anthropic-ai/sdk is required when using AnthropicProvider. Run: npm install @anthropic-ai/sdk');
+        }
+        this.model = config.model;
+        this.handler = config.toolHandler;
+    }
+    async askWithTools(params) {
+        try {
+            return await (0, claude_tool_loop_1.runClaudeToolLoop)({ anthropic: this.anthropic, model: this.model, handler: this.handler }, params);
+        }
+        catch (err) {
+            throw (0, error_mapper_1.mapAnthropicError)(err);
+        }
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=anthropic.provider.js.map

package/dist/providers/anthropic/anthropic.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.provider.js","sourceRoot":"","sources":["../../../src/providers/anthropic/anthropic.provider.ts"],"names":[],"mappings":";;;AAGA,+DAA6D;AAC7D,uDAAyD;AASzD;;;;GAIG;AACH,MAAa,iBAAiB;IAK5B,YAAY,MAA+B;QACzC,IAAI,CAAC;YACH,8DAA8D;YAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,IAAA,oCAAiB,EAC5B,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EACvE,MAAM,CACP,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,gCAAiB,EAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AA3BD,8CA2BC"}

package/dist/providers/anthropic/loops/claude-tool.loop.d.ts

@@ -0,0 +1,11 @@
+import type { AskWithToolsParams, AskWithToolsResult } from '../../../types/ask-with-tools.types';
+import type { ToolHandler } from '../../../types/tool-handler.interface';
+interface ClaudeLoopContext {
+    anthropic: unknown;
+    model: string;
+    handler?: ToolHandler;
+}
+/** Run the Anthropic tool loop for one user turn. */
+export declare function runClaudeToolLoop(ctx: ClaudeLoopContext, params: AskWithToolsParams): Promise<AskWithToolsResult>;
+export {};
+//# sourceMappingURL=claude-tool.loop.d.ts.map

package/dist/providers/anthropic/loops/claude-tool.loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-tool.loop.d.ts","sourceRoot":"","sources":["../../../../src/providers/anthropic/loops/claude-tool.loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,uCAAuC,CAAC;AAKlG,UAAU,iBAAiB;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAID,qDAAqD;AACrD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA+C7B"}

package/dist/providers/anthropic/loops/claude-tool.loop.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runClaudeToolLoop = runClaudeToolLoop;
+const errors_1 = require("../../../errors");
+const MAX_TURNS = 10;
+/** Run the Anthropic tool loop for one user turn. */
+async function runClaudeToolLoop(ctx, params) {
+    const { anthropic, model, handler } = ctx;
+    const messages = [{ role: 'user', content: params.userQuestion }];
+    for (let turn = 0; turn < MAX_TURNS; turn++) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const sdk = anthropic;
+        const response = await sdk.messages.create({
+            model: params.model ?? model,
+            max_tokens: 4096,
+            system: params.instructions,
+            tools: params.tools ?? [],
+            messages,
+        });
+        const responseId = response.id;
+        const stopReason = response.stop_reason;
+        if (stopReason === 'end_turn') {
+            const text = response.content
+                .filter((b) => b.type === 'text')
+                .map((b) => b.text ?? '')
+                .join('');
+            return { kind: 'text', outputText: text, responseId, usage: mapClaudeUsage(response.usage), model: params.model ?? model };
+        }
+        if (stopReason === 'tool_use') {
+            if (!handler)
+                throw new errors_1.NoToolHandlerError();
+            messages.push({ role: 'assistant', content: response.content });
+            const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+            const calls = toolUseBlocks.map((b) => ({ id: b.id, name: b.name, arguments: JSON.stringify(b.input) }));
+            const toolContext = { threadKey: params.threadKey, chatbotId: params.chatbotId, organizationId: params.organizationId, userQuestion: params.userQuestion };
+            const outputs = [];
+            for (const call of calls) {
+                const out = await handler.buildOutput(call, toolContext);
+                if (out)
+                    outputs.push(out);
+            }
+            const appResult = await handler.extractResult(calls, outputs, toolContext);
+            if (appResult !== null) {
+                return { kind: 'toolResult', toolCallResult: appResult, responseId, usage: null, model: params.model ?? model };
+            }
+            const toolResultContent = outputs.map((o) => ({ type: 'tool_result', tool_use_id: o.call_id, content: o.output }));
+            messages.push({ role: 'user', content: toolResultContent });
+        }
+    }
+    throw new errors_1.ToolLoopError(MAX_TURNS);
+}
+function mapClaudeUsage(usage) {
+    if (!usage || typeof usage !== 'object')
+        return null;
+    const u = usage;
+    return { inputTokens: u['input_tokens'] ?? 0, outputTokens: u['output_tokens'] ?? 0, totalTokens: (u['input_tokens'] ?? 0) + (u['output_tokens'] ?? 0) };
+}
+//# sourceMappingURL=claude-tool.loop.js.map

package/dist/providers/anthropic/loops/claude-tool.loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-tool.loop.js","sourceRoot":"","sources":["../../../../src/providers/anthropic/loops/claude-tool.loop.ts"],"names":[],"mappings":"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"}

package/dist/providers/anthropic/utils/error-mapper.d.ts

@@ -0,0 +1,4 @@
+import { ProviderError } from '../../../errors/provider.error';
+/** Map an Anthropic SDK error to a typed ProviderError. */
+export declare function mapAnthropicError(err: unknown): ProviderError;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/providers/anthropic/utils/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../../../src/providers/anthropic/utils/error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAS/D,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAmB7D"}

package/dist/providers/anthropic/utils/error-mapper.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapAnthropicError = mapAnthropicError;
+const provider_error_1 = require("../../../errors/provider.error");
+/** Map an Anthropic SDK error to a typed ProviderError. */
+function mapAnthropicError(err) {
+    const apiErr = err;
+    if (apiErr?.status !== undefined) {
+        const retryable = apiErr.status === 429 || (apiErr.status >= 500 && apiErr.status < 600);
+        const retryAfterMs = retryable ? parseRetryAfter(apiErr.headers) : undefined;
+        return new provider_error_1.ProviderError({
+            provider: 'anthropic',
+            code: `ANTHROPIC_${apiErr.status}`,
+            message: apiErr.error?.message ?? apiErr.message ?? 'Anthropic API error',
+            statusCode: apiErr.status,
+            retryable,
+            retryAfterMs,
+        });
+    }
+    return new provider_error_1.ProviderError({
+        provider: 'anthropic',
+        code: 'ANTHROPIC_UNEXPECTED',
+        message: err instanceof Error ? err.message : 'Unexpected Anthropic error',
+    });
+}
+function parseRetryAfter(headers) {
+    if (!headers)
+        return undefined;
+    const v = headers['retry-after'] ?? headers['Retry-After'];
+    if (!v)
+        return undefined;
+    const s = parseInt(v, 10);
+    return isNaN(s) ? undefined : s * 1000;
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/providers/anthropic/utils/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../../../src/providers/anthropic/utils/error-mapper.ts"],"names":[],"mappings":";;AAUA,8CAmBC;AA7BD,mEAA+D;AAS/D,2DAA2D;AAC3D,SAAgB,iBAAiB,CAAC,GAAY;IAC5C,MAAM,MAAM,GAAG,GAAwB,CAAC;IACxC,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACzF,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,OAAO,IAAI,8BAAa,CAAC;YACvB,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,aAAa,MAAM,CAAC,MAAM,EAAE;YAClC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,qBAAqB;YACzE,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,SAAS;YACT,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,8BAAa,CAAC;QACvB,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B;KAC3E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,OAAgC;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC"}

package/dist/providers/openai/builders/conversation-or-create.builder.d.ts

@@ -0,0 +1,15 @@
+import type OpenAI from 'openai';
+import type { ConversationStore } from '../../../types/conversation-store.interface';
+/**
+ * Resolve the conversationId for a thread.
+ * Creates a new OpenAI conversation when none exists yet (lazy creation).
+ */
+export declare function resolveConversationId({ openai, store, threadKey, }: {
+    openai: OpenAI;
+    store: ConversationStore;
+    threadKey: string;
+}): Promise<{
+    conversationId: string;
+    lastResponseId: string | undefined;
+}>;
+//# sourceMappingURL=conversation-or-create.builder.d.ts.map

package/dist/providers/openai/builders/conversation-or-create.builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-or-create.builder.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/builders/conversation-or-create.builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAGrF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAU1E"}

package/dist/providers/openai/builders/conversation-or-create.builder.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConversationId = resolveConversationId;
+const create_conversation_operation_1 = require("../operations/create-conversation.operation");
+/**
+ * Resolve the conversationId for a thread.
+ * Creates a new OpenAI conversation when none exists yet (lazy creation).
+ */
+async function resolveConversationId({ openai, store, threadKey, }) {
+    const existing = await store.load(threadKey);
+    if (existing) {
+        return { conversationId: existing.conversationId, lastResponseId: existing.lastResponseId };
+    }
+    const conversationId = await (0, create_conversation_operation_1.createConversation)(openai);
+    await store.create(threadKey, conversationId);
+    return { conversationId, lastResponseId: undefined };
+}
+//# sourceMappingURL=conversation-or-create.builder.js.map

package/dist/providers/openai/builders/conversation-or-create.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-or-create.builder.js","sourceRoot":"","sources":["../../../../src/providers/openai/builders/conversation-or-create.builder.ts"],"names":[],"mappings":";;AAQA,sDAkBC;AAxBD,+FAAiF;AAEjF;;;GAGG;AACI,KAAK,UAAU,qBAAqB,CAAC,EAC1C,MAAM,EACN,KAAK,EACL,SAAS,GAKV;IACC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC9F,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,IAAA,kDAAkB,EAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC"}

package/dist/providers/openai/loops/assistants-tool.loop.d.ts

@@ -0,0 +1,19 @@
+import type OpenAI from 'openai';
+import type { AskWithToolsResult } from '../../../types/ask-with-tools.types';
+import type { ToolHandler } from '../../../types/tool-handler.interface';
+interface AssistantsLoopCtx {
+    openai: OpenAI;
+    handler?: ToolHandler;
+}
+export interface AssistantsLoopParams {
+    threadId: string;
+    runId: string;
+    chatbotId: string;
+    organizationId?: string;
+    userQuestion: string;
+    model: string;
+}
+/** Poll a beta.threads run until completion, executing tool calls via the ToolHandler. */
+export declare function runAssistantsToolLoop(ctx: AssistantsLoopCtx, params: AssistantsLoopParams): Promise<AskWithToolsResult>;
+export {};
+//# sourceMappingURL=assistants-tool.loop.d.ts.map

package/dist/providers/openai/loops/assistants-tool.loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistants-tool.loop.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/loops/assistants-tool.loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,uCAAuC,CAAC;AAOtF,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA+C7B"}

package/dist/providers/openai/loops/assistants-tool.loop.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAssistantsToolLoop = runAssistantsToolLoop;
+const errors_1 = require("../../../errors");
+const usage_mapper_1 = require("../utils/usage-mapper");
+const MAX_POLLS = 60;
+const POLL_INTERVAL_MS = 1000;
+/** Poll a beta.threads run until completion, executing tool calls via the ToolHandler. */
+async function runAssistantsToolLoop(ctx, params) {
+    const { openai, handler } = ctx;
+    for (let poll = 0; poll < MAX_POLLS; poll++) {
+        await sleep(POLL_INTERVAL_MS);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const run = await openai.beta.threads.runs.retrieve(params.threadId, params.runId);
+        if (run.status === 'completed') {
+            const messages = await openai.beta.threads.messages.list(params.threadId, { limit: 1 });
+            const first = messages.data[0];
+            const text = first?.content
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text.value)
+                .join('') ?? '';
+            return { kind: 'text', outputText: text, responseId: run.id, usage: (0, usage_mapper_1.mapUsage)(run.usage), model: params.model };
+        }
+        if (run.status === 'requires_action') {
+            if (!handler)
+                throw new errors_1.NoToolHandlerError();
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const rawToolCalls = (run.required_action?.submit_tool_outputs?.tool_calls ?? []);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const toolCalls = rawToolCalls.map((tc) => ({
+                id: tc.id, name: tc.function.name, arguments: tc.function.arguments,
+            }));
+            const toolContext = { threadKey: params.threadId, chatbotId: params.chatbotId, organizationId: params.organizationId, userQuestion: params.userQuestion };
+            const outputs = [];
+            for (const call of toolCalls) {
+                const out = await handler.buildOutput(call, toolContext);
+                if (out)
+                    outputs.push(out);
+            }
+            const appResult = await handler.extractResult(toolCalls, outputs, toolContext);
+            if (appResult !== null) {
+                return { kind: 'toolResult', toolCallResult: appResult, responseId: run.id, usage: null, model: params.model };
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await openai.beta.threads.runs.submitToolOutputs(params.threadId, params.runId, {
+                tool_outputs: outputs.map((o) => ({ tool_call_id: o.call_id, output: o.output })),
+            });
+        }
+        if (['failed', 'cancelled', 'expired'].includes(run.status)) {
+            throw new Error(`Assistants run ended with status: ${run.status}`);
+        }
+    }
+    throw new errors_1.ToolLoopError(MAX_POLLS);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=assistants-tool.loop.js.map

package/dist/providers/openai/loops/assistants-tool.loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistants-tool.loop.js","sourceRoot":"","sources":["../../../../src/providers/openai/loops/assistants-tool.loop.ts"],"names":[],"mappings":";;AAwBA,sDAkDC;AAvED,4CAAoE;AACpE,wDAAiD;AAEjD,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAgB9B,0FAA0F;AACnF,KAAK,UAAU,qBAAqB,CACzC,GAAsB,EACtB,MAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAEhC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC9B,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5F,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACxF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,KAAK,EAAE,OAAO;iBACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA+C,CAAC,IAAI,CAAC,KAAK,CAAC;iBACvE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAA,uBAAQ,EAAC,GAAG,CAAC,KAAc,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1H,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,2BAAkB,EAAE,CAAC;YAC7C,8DAA8D;YAC9D,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,mBAAmB,EAAE,UAAU,IAAI,EAAE,CAAU,CAAC;YAC3F,8DAA8D;YAC9D,MAAM,SAAS,GAAkB,YAAY,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC;gBAC9D,EAAE,EAAE,EAAE,CAAC,EAAY,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAc,EAAE,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAmB;aAClG,CAAC,CAAC,CAAC;YACJ,MAAM,WAAW,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;YAC1J,MAAM,OAAO,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBACzD,IAAI,GAAG;oBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAC/E,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjH,CAAC;YACD,8DAA8D;YAC9D,MAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE;gBACvF,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aAClF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,MAAM,IAAI,sBAAa,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/providers/openai/loops/responses-tool.loop.d.ts

@@ -0,0 +1,14 @@
+import type OpenAI from 'openai';
+import type { AskWithToolsParams, AskWithToolsResult } from '../../../types/ask-with-tools.types';
+import type { ToolHandler } from '../../../types/tool-handler.interface';
+import type { ConversationStore } from '../../../types/conversation-store.interface';
+interface LoopContext {
+    openai: OpenAI;
+    store: ConversationStore;
+    handler?: ToolHandler;
+    model: string;
+}
+/** Run the full Responses API tool loop for one user turn. */
+export declare function runResponsesToolLoop(ctx: LoopContext, params: AskWithToolsParams, conversationId: string, previousResponseId: string | undefined): Promise<AskWithToolsResult>;
+export {};
+//# sourceMappingURL=responses-tool.loop.d.ts.map

package/dist/providers/openai/loops/responses-tool.loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-tool.loop.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/loops/responses-tool.loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAQrF,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAyD7B"}

package/dist/providers/openai/loops/responses-tool.loop.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runResponsesToolLoop = runResponsesToolLoop;
+const create_response_operation_1 = require("../operations/create-response.operation");
+const submit_tool_outputs_operation_1 = require("../operations/submit-tool-outputs.operation");
+const usage_mapper_1 = require("../utils/usage-mapper");
+const errors_1 = require("../../../errors");
+const MAX_TURNS = 10;
+/** Run the full Responses API tool loop for one user turn. */
+async function runResponsesToolLoop(ctx, params, conversationId, previousResponseId) {
+    const { openai, store, handler, model } = ctx;
+    let lastResponseId = previousResponseId;
+    for (let turn = 0; turn < MAX_TURNS; turn++) {
+        const response = (await (turn === 0
+            ? (0, create_response_operation_1.createResponse)(openai, {
+                conversationId,
+                previousResponseId: lastResponseId,
+                model,
+                instructions: params.instructions,
+                userQuestion: params.userQuestion,
+                tools: params.tools,
+                vectorStoreIds: params.vectorStoreIds,
+            })
+            : Promise.resolve(null)));
+        // On re-entry submit tool outputs instead
+        if (turn > 0 || !response)
+            break;
+        const raw = response;
+        const responseId = raw['id'];
+        lastResponseId = responseId;
+        await store.save(params.threadKey, { conversationId, lastResponseId: responseId });
+        const status = raw['status'];
+        if (status === 'completed') {
+            const outputText = extractOutputText(raw);
+            return { kind: 'text', outputText, responseId, usage: (0, usage_mapper_1.mapUsage)(raw['usage']), model };
+        }
+        if (status === 'requires_action' || status === 'failed_with_tool_calls') {
+            if (!handler)
+                throw new errors_1.NoToolHandlerError();
+            const calls = extractToolCalls(raw);
+            const toolContext = { threadKey: params.threadKey, chatbotId: params.chatbotId, organizationId: params.organizationId, userQuestion: params.userQuestion, mediaUrl: params.mediaUrl };
+            const outputs = [];
+            for (const call of calls) {
+                const out = await handler.buildOutput(call, toolContext);
+                if (out)
+                    outputs.push(out);
+            }
+            const appResult = await handler.extractResult(calls, outputs, toolContext);
+            if (appResult !== null) {
+                return { kind: 'toolResult', toolCallResult: appResult, responseId, usage: (0, usage_mapper_1.mapUsage)(raw['usage']), model };
+            }
+            const nextResponse = await (0, submit_tool_outputs_operation_1.submitToolOutputs)(openai, { previousResponseId: responseId, conversationId, model, instructions: params.instructions, toolOutputs: outputs, tools: params.tools });
+            const nextId = nextResponse['id'];
+            await store.save(params.threadKey, { conversationId, lastResponseId: nextId });
+            lastResponseId = nextId;
+            const nextStatus = nextResponse['status'];
+            if (nextStatus === 'completed') {
+                return { kind: 'text', outputText: extractOutputText(nextResponse), responseId: nextId, usage: (0, usage_mapper_1.mapUsage)(nextResponse['usage']), model };
+            }
+        }
+    }
+    throw new errors_1.ToolLoopError(MAX_TURNS);
+}
+function extractOutputText(response) {
+    const output = response['output'];
+    if (!Array.isArray(output))
+        return '';
+    const textBlock = output.find((b) => b['type'] === 'message');
+    if (!textBlock)
+        return '';
+    const content = textBlock['content'];
+    if (!Array.isArray(content))
+        return '';
+    return content.map((c) => c['text'] ?? '').join('');
+}
+function extractToolCalls(response) {
+    const output = response['output'];
+    if (!Array.isArray(output))
+        return [];
+    return output
+        .filter((b) => b['type'] === 'function_call')
+        .map((b) => {
+        const block = b;
+        return { id: block['call_id'], name: block['name'], arguments: block['arguments'] };
+    });
+}
+//# sourceMappingURL=responses-tool.loop.js.map

package/dist/providers/openai/loops/responses-tool.loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-tool.loop.js","sourceRoot":"","sources":["../../../../src/providers/openai/loops/responses-tool.loop.ts"],"names":[],"mappings":"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"}

package/dist/providers/openai/openai-assistants.provider.d.ts

@@ -0,0 +1,27 @@
+import type { AIProvider } from '../../types/provider.interface';
+import type { AskWithToolsParams, AskWithToolsResult } from '../../types/ask-with-tools.types';
+import type { ToolHandler } from '../../types/tool-handler.interface';
+export interface OpenAIAssistantsProviderConfig {
+    apiKey: string;
+    assistantId: string;
+    model: string;
+    toolHandler?: ToolHandler;
+    maxRetries?: number;
+    timeoutMs?: number;
+}
+/**
+ * Legacy OpenAI Assistants API provider.
+ * Use this during the dual-run migration period until all threads are moved
+ * to the Responses + Conversations API, then remove.
+ *
+ * @deprecated Prefer OpenAIResponsesProvider for new chatbots.
+ */
+export declare class OpenAIAssistantsProvider implements AIProvider {
+    private readonly openai;
+    private readonly assistantId;
+    private readonly model;
+    private readonly handler?;
+    constructor(config: OpenAIAssistantsProviderConfig);
+    askWithTools(params: AskWithToolsParams): Promise<AskWithToolsResult>;
+}
+//# sourceMappingURL=openai-assistants.provider.d.ts.map

package/dist/providers/openai/openai-assistants.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-assistants.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/openai-assistants.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAGtE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,UAAU;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAc;gBAE3B,MAAM,EAAE,8BAA8B;IAW5C,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAgB5E"}

package/dist/providers/openai/openai-assistants.provider.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAssistantsProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+const assistants_tool_loop_1 = require("./loops/assistants-tool.loop");
+/**
+ * Legacy OpenAI Assistants API provider.
+ * Use this during the dual-run migration period until all threads are moved
+ * to the Responses + Conversations API, then remove.
+ *
+ * @deprecated Prefer OpenAIResponsesProvider for new chatbots.
+ */
+class OpenAIAssistantsProvider {
+    constructor(config) {
+        this.openai = new openai_1.default({
+            apiKey: config.apiKey,
+            maxRetries: config.maxRetries ?? 2,
+            timeout: config.timeoutMs ?? 60000,
+        });
+        this.assistantId = config.assistantId;
+        this.model = config.model;
+        this.handler = config.toolHandler;
+    }
+    async askWithTools(params) {
+        await this.openai.beta.threads.messages.create(params.threadKey, {
+            role: 'user',
+            content: params.userQuestion,
+        });
+        const run = await this.openai.beta.threads.runs.create(params.threadKey, {
+            assistant_id: this.assistantId,
+            model: params.model ?? this.model,
+        });
+        return (0, assistants_tool_loop_1.runAssistantsToolLoop)({ openai: this.openai, handler: this.handler }, { threadId: params.threadKey, runId: run.id, chatbotId: params.chatbotId, organizationId: params.organizationId, userQuestion: params.userQuestion, model: params.model ?? this.model });
+    }
+}
+exports.OpenAIAssistantsProvider = OpenAIAssistantsProvider;
+//# sourceMappingURL=openai-assistants.provider.js.map

package/dist/providers/openai/openai-assistants.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-assistants.provider.js","sourceRoot":"","sources":["../../../src/providers/openai/openai-assistants.provider.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAI5B,uEAAqE;AAWrE;;;;;;GAMG;AACH,MAAa,wBAAwB;IAMnC,YAAY,MAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,KAAM;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;YAC/D,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,MAAM,CAAC,YAAY;SAC7B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;YACvE,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK;SAClC,CAAC,CAAC;QAEH,OAAO,IAAA,4CAAqB,EAC1B,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAC9C,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CACxL,CAAC;IACJ,CAAC;CACF;AAjCD,4DAiCC"}

package/dist/providers/openai/openai-responses.provider.d.ts

@@ -0,0 +1,25 @@
+import type { AIProvider } from '../../types/provider.interface';
+import type { AskWithToolsParams, AskWithToolsResult } from '../../types/ask-with-tools.types';
+import type { ConversationStore } from '../../types/conversation-store.interface';
+import type { ToolHandler } from '../../types/tool-handler.interface';
+export interface OpenAIResponsesProviderConfig {
+    apiKey: string;
+    model: string;
+    conversationStore: ConversationStore;
+    toolHandler?: ToolHandler;
+    maxRetries?: number;
+    timeoutMs?: number;
+}
+/**
+ * OpenAI Responses + Conversations API provider.
+ * Manages conversation state via the injected ConversationStore.
+ */
+export declare class OpenAIResponsesProvider implements AIProvider {
+    private readonly openai;
+    private readonly model;
+    private readonly store;
+    private readonly handler?;
+    constructor(config: OpenAIResponsesProviderConfig);
+    askWithTools(params: AskWithToolsParams): Promise<AskWithToolsResult>;
+}
+//# sourceMappingURL=openai-responses.provider.d.ts.map

package/dist/providers/openai/openai-responses.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/openai-responses.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAItE,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAc;gBAE3B,MAAM,EAAE,6BAA6B;IAW3C,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAc5E"}

package/dist/providers/openai/openai-responses.provider.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIResponsesProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+const conversation_or_create_builder_1 = require("./builders/conversation-or-create.builder");
+const responses_tool_loop_1 = require("./loops/responses-tool.loop");
+/**
+ * OpenAI Responses + Conversations API provider.
+ * Manages conversation state via the injected ConversationStore.
+ */
+class OpenAIResponsesProvider {
+    constructor(config) {
+        this.openai = new openai_1.default({
+            apiKey: config.apiKey,
+            maxRetries: config.maxRetries ?? 2,
+            timeout: config.timeoutMs ?? 60000,
+        });
+        this.model = config.model;
+        this.store = config.conversationStore;
+        this.handler = config.toolHandler;
+    }
+    async askWithTools(params) {
+        const { conversationId, lastResponseId } = await (0, conversation_or_create_builder_1.resolveConversationId)({
+            openai: this.openai,
+            store: this.store,
+            threadKey: params.threadKey,
+        });
+        return (0, responses_tool_loop_1.runResponsesToolLoop)({ openai: this.openai, store: this.store, handler: this.handler, model: params.model ?? this.model }, params, conversationId, lastResponseId);
+    }
+}
+exports.OpenAIResponsesProvider = OpenAIResponsesProvider;
+//# sourceMappingURL=openai-responses.provider.js.map

package/dist/providers/openai/openai-responses.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses.provider.js","sourceRoot":"","sources":["../../../src/providers/openai/openai-responses.provider.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAK5B,8FAAkF;AAClF,qEAAmE;AAWnE;;;GAGG;AACH,MAAa,uBAAuB;IAMlC,YAAY,MAAqC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,KAAM;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,IAAA,sDAAqB,EAAC;YACrE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,OAAO,IAAA,0CAAoB,EACzB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EACpG,MAAM,EACN,cAAc,EACd,cAAc,CACf,CAAC;IACJ,CAAC;CACF;AA/BD,0DA+BC"}

package/dist/providers/openai/operations/create-conversation.operation.d.ts

@@ -0,0 +1,7 @@
+import type OpenAI from 'openai';
+/**
+ * Creates an OpenAI Conversation via the Responses + Conversations API.
+ * Wraps the raw SDK call in a typed error boundary.
+ */
+export declare function createConversation(openai: OpenAI): Promise<string>;
+//# sourceMappingURL=create-conversation.operation.d.ts.map

package/dist/providers/openai/operations/create-conversation.operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-conversation.operation.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/operations/create-conversation.operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWxE"}

package/dist/providers/openai/operations/create-conversation.operation.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConversation = createConversation;
+const error_mapper_1 = require("../utils/error-mapper");
+/**
+ * Creates an OpenAI Conversation via the Responses + Conversations API.
+ * Wraps the raw SDK call in a typed error boundary.
+ */
+async function createConversation(openai) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const conversation = await openai.beta.conversations.create({});
+        if (!conversation?.id) {
+            throw new Error('createConversation returned no id');
+        }
+        return conversation.id;
+    }
+    catch (err) {
+        throw (0, error_mapper_1.mapOpenAIError)(err);
+    }
+}
+//# sourceMappingURL=create-conversation.operation.js.map

package/dist/providers/openai/operations/create-conversation.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-conversation.operation.js","sourceRoot":"","sources":["../../../../src/providers/openai/operations/create-conversation.operation.ts"],"names":[],"mappings":";;AAOA,gDAWC;AAjBD,wDAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CAAC,MAAc;IACrD,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,YAAY,GAAG,MAAO,MAAc,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,YAAY,CAAC,EAAY,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAA,6BAAc,EAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}