@mohamedtebo/convai-platform 1.0.0

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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"}

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

@@ -0,0 +1,13 @@
+import type OpenAI from 'openai';
+export interface CreateResponseParams {
+    conversationId: string;
+    previousResponseId?: string;
+    model: string;
+    instructions: string;
+    userQuestion: string;
+    tools?: unknown[];
+    vectorStoreIds?: string[];
+}
+/** Wraps openai.responses.create — one call in the tool loop or the first turn. */
+export declare function createResponse(openai: OpenAI, params: CreateResponseParams): Promise<unknown>;
+//# sourceMappingURL=create-response.operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-response.operation.d.ts","sourceRoot":"","sources":["../../../../../src/providers/openai/operations/create-response.operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,OAAO,CAAC,CA8BlB"}

package/dist/src/providers/openai/operations/create-response.operation.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createResponse = createResponse;
+const error_mapper_1 = require("../utils/error-mapper");
+/** Wraps openai.responses.create — one call in the tool loop or the first turn. */
+async function createResponse(openai, params) {
+    const { conversationId, previousResponseId, model, instructions, userQuestion, tools, vectorStoreIds, } = params;
+    const body = {
+        model,
+        conversation_id: conversationId,
+        instructions,
+        input: userQuestion,
+        ...(previousResponseId ? { previous_response_id: previousResponseId } : {}),
+        ...(tools?.length ? { tools } : {}),
+    };
+    if (vectorStoreIds?.length) {
+        body['tool_resources'] = { file_search: { vector_store_ids: vectorStoreIds } };
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return await openai.responses.create(body);
+    }
+    catch (err) {
+        throw (0, error_mapper_1.mapOpenAIError)(err);
+    }
+}
+//# sourceMappingURL=create-response.operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-response.operation.js","sourceRoot":"","sources":["../../../../../src/providers/openai/operations/create-response.operation.ts"],"names":[],"mappings":";;AAcA,wCAiCC;AA9CD,wDAAuD;AAYvD,mFAAmF;AAC5E,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,MAA4B;IAE5B,MAAM,EACJ,cAAc,EACd,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,cAAc,GACf,GAAG,MAAM,CAAC;IAEX,MAAM,IAAI,GAA4B;QACpC,KAAK;QACL,eAAe,EAAE,cAAc;QAC/B,YAAY;QACZ,KAAK,EAAE,YAAY;QACnB,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC;IAEF,IAAI,cAAc,EAAE,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,gBAAgB,EAAE,cAAc,EAAE,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,CAAC;QACH,8DAA8D;QAC9D,OAAO,MAAO,MAAc,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAA,6BAAc,EAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/src/providers/openai/operations/submit-tool-outputs.operation.d.ts

@@ -0,0 +1,17 @@
+import type OpenAI from 'openai';
+import type { ToolOutput } from '../../../types/tool-handler.interface';
+export interface SubmitToolOutputsParams {
+    previousResponseId: string;
+    conversationId: string;
+    model: string;
+    instructions: string;
+    toolOutputs: ToolOutput[];
+    tools?: unknown[];
+}
+/**
+ * Resumes the AI response by submitting tool call outputs.
+ * In the Responses API this is a new responses.create call with the previous_response_id set
+ * and the tool results embedded in the input array.
+ */
+export declare function submitToolOutputs(openai: OpenAI, params: SubmitToolOutputsParams): Promise<unknown>;
+//# sourceMappingURL=submit-tool-outputs.operation.d.ts.map

package/dist/src/providers/openai/operations/submit-tool-outputs.operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-tool-outputs.operation.d.ts","sourceRoot":"","sources":["../../../../../src/providers/openai/operations/submit-tool-outputs.operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGxE,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAwBlB"}

package/dist/src/providers/openai/operations/submit-tool-outputs.operation.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitToolOutputs = submitToolOutputs;
+const error_mapper_1 = require("../utils/error-mapper");
+/**
+ * Resumes the AI response by submitting tool call outputs.
+ * In the Responses API this is a new responses.create call with the previous_response_id set
+ * and the tool results embedded in the input array.
+ */
+async function submitToolOutputs(openai, params) {
+    const { previousResponseId, conversationId, model, instructions, toolOutputs, tools } = params;
+    const toolResultMessages = toolOutputs.map((o) => ({
+        type: 'tool_result',
+        tool_use_id: o.call_id,
+        content: o.output,
+    }));
+    const body = {
+        model,
+        conversation_id: conversationId,
+        instructions,
+        previous_response_id: previousResponseId,
+        input: toolResultMessages,
+        ...(tools?.length ? { tools } : {}),
+    };
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return await openai.responses.create(body);
+    }
+    catch (err) {
+        throw (0, error_mapper_1.mapOpenAIError)(err);
+    }
+}
+//# sourceMappingURL=submit-tool-outputs.operation.js.map

package/dist/src/providers/openai/operations/submit-tool-outputs.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-tool-outputs.operation.js","sourceRoot":"","sources":["../../../../../src/providers/openai/operations/submit-tool-outputs.operation.ts"],"names":[],"mappings":";;AAkBA,8CA2BC;AA3CD,wDAAuD;AAWvD;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,MAA+B;IAE/B,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAE/F,MAAM,kBAAkB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,CAAC,CAAC,OAAO;QACtB,OAAO,EAAE,CAAC,CAAC,MAAM;KAClB,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAI,GAA4B;QACpC,KAAK;QACL,eAAe,EAAE,cAAc;QAC/B,YAAY;QACZ,oBAAoB,EAAE,kBAAkB;QACxC,KAAK,EAAE,kBAAkB;QACzB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC;IAEF,IAAI,CAAC;QACH,8DAA8D;QAC9D,OAAO,MAAO,MAAc,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAA,6BAAc,EAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/src/providers/openai/utils/error-mapper.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../../../../src/providers/openai/utils/error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAQ/D,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAmB1D"}

package/dist/src/providers/openai/utils/error-mapper.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapOpenAIError = mapOpenAIError;
+const provider_error_1 = require("../../../errors/provider.error");
+/** Map an OpenAI SDK error to a typed ProviderError. */
+function mapOpenAIError(err) {
+    if (isOpenAIAPIError(err)) {
+        const retryable = (err.status ?? 0) === 429 || ((err.status ?? 0) >= 500 && (err.status ?? 0) < 600);
+        const retryAfterMs = retryable ? parseRetryAfter(err.headers) : undefined;
+        return new provider_error_1.ProviderError({
+            provider: 'openai',
+            code: `OPENAI_${err.status ?? 'UNKNOWN'}`,
+            message: err.message ?? 'OpenAI API error',
+            statusCode: err.status,
+            retryable,
+            retryAfterMs,
+            requestId: extractRequestId(err.headers),
+        });
+    }
+    return new provider_error_1.ProviderError({
+        provider: 'openai',
+        code: 'OPENAI_UNEXPECTED',
+        message: err instanceof Error ? err.message : 'Unexpected error',
+    });
+}
+function isOpenAIAPIError(err) {
+    return typeof err === 'object' && err !== null && 'status' in err;
+}
+function parseRetryAfter(headers) {
+    if (!headers || typeof headers !== 'object')
+        return undefined;
+    const h = headers;
+    const v = h['retry-after'] ?? h['Retry-After'];
+    if (!v)
+        return undefined;
+    const seconds = parseInt(v, 10);
+    return isNaN(seconds) ? undefined : seconds * 1000;
+}
+function extractRequestId(headers) {
+    if (!headers || typeof headers !== 'object')
+        return undefined;
+    const h = headers;
+    return h['x-request-id'] ?? undefined;
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/src/providers/openai/utils/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../../../../src/providers/openai/utils/error-mapper.ts"],"names":[],"mappings":";;AASA,wCAmBC;AA5BD,mEAA+D;AAQ/D,wDAAwD;AACxD,SAAgB,cAAc,CAAC,GAAY;IACzC,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACrG,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,OAAO,IAAI,8BAAa,CAAC;YACvB,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,UAAU,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE;YACzC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,kBAAkB;YAC1C,UAAU,EAAE,GAAG,CAAC,MAAM;YACtB,SAAS;YACT,YAAY;YACZ,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,8BAAa,CAAC;QACvB,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;KACjE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,QAAQ,IAAI,GAAG,CAAC;AACpE,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,CAAC,GAAG,OAAiC,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,CAAC,GAAG,OAAiC,CAAC;IAC5C,OAAO,CAAC,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;AACxC,CAAC"}

package/dist/src/providers/openai/utils/usage-mapper.d.ts

@@ -0,0 +1,10 @@
+import type { UsageMetrics } from '../../../types/ask-with-tools.types';
+interface RawUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+}
+/** Normalize provider usage to the shared UsageMetrics shape. */
+export declare function mapUsage(raw: RawUsage | null | undefined): UsageMetrics | null;
+export {};
+//# sourceMappingURL=usage-mapper.d.ts.map

package/dist/src/providers/openai/utils/usage-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-mapper.d.ts","sourceRoot":"","sources":["../../../../../src/providers/openai/utils/usage-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,UAAU,QAAQ;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAS9E"}

package/dist/src/providers/openai/utils/usage-mapper.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapUsage = mapUsage;
+/** Normalize provider usage to the shared UsageMetrics shape. */
+function mapUsage(raw) {
+    if (!raw)
+        return null;
+    const input = raw.input_tokens ?? 0;
+    const output = raw.output_tokens ?? 0;
+    return {
+        inputTokens: input,
+        outputTokens: output,
+        totalTokens: raw.total_tokens ?? input + output,
+    };
+}
+//# sourceMappingURL=usage-mapper.js.map

package/dist/src/providers/openai/utils/usage-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-mapper.js","sourceRoot":"","sources":["../../../../../src/providers/openai/utils/usage-mapper.ts"],"names":[],"mappings":";;AASA,4BASC;AAVD,iEAAiE;AACjE,SAAgB,QAAQ,CAAC,GAAgC;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;IACtC,OAAO;QACL,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,KAAK,GAAG,MAAM;KAChD,CAAC;AACJ,CAAC"}

package/dist/src/safe/index.d.ts

@@ -0,0 +1,2 @@
+export { SafePlatformClient } from './safe-platform.client';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/safe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/safe/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafePlatformClient = void 0;
+var safe_platform_client_1 = require("./safe-platform.client");
+Object.defineProperty(exports, "SafePlatformClient", { enumerable: true, get: function () { return safe_platform_client_1.SafePlatformClient; } });
+//# sourceMappingURL=index.js.map

package/dist/src/safe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safe/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}

package/dist/src/safe/safe-platform.client.d.ts

@@ -0,0 +1,14 @@
+import type { AIProvider } from '../types/provider.interface';
+import type { AskWithToolsParams, AskWithToolsResult } from '../types/ask-with-tools.types';
+import type { SdkResult } from '../types/sdk-result.interface';
+/**
+ * Safe-layer wrapper around any AIProvider.
+ * All methods return SdkResult<T> — never throw.
+ * Use this in telbany controllers / services for clean error handling.
+ */
+export declare class SafePlatformClient {
+    private readonly provider;
+    constructor(provider: AIProvider);
+    askWithTools(params: AskWithToolsParams): Promise<SdkResult<AskWithToolsResult>>;
+}
+//# sourceMappingURL=safe-platform.client.d.ts.map

package/dist/src/safe/safe-platform.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-platform.client.d.ts","sourceRoot":"","sources":["../../../src/safe/safe-platform.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,+BAA+B,CAAC;AAI/E;;;;GAIG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,UAAU;IAE3C,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAQvF"}

package/dist/src/safe/safe-platform.client.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafePlatformClient = void 0;
+const sdk_result_interface_1 = require("../types/sdk-result.interface");
+const sdk_error_1 = require("../errors/sdk.error");
+/**
+ * Safe-layer wrapper around any AIProvider.
+ * All methods return SdkResult<T> — never throw.
+ * Use this in telbany controllers / services for clean error handling.
+ */
+class SafePlatformClient {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async askWithTools(params) {
+        try {
+            const result = await this.provider.askWithTools(params);
+            return (0, sdk_result_interface_1.ok)(result);
+        }
+        catch (err) {
+            return (0, sdk_result_interface_1.fail)(toFormattedError(err));
+        }
+    }
+}
+exports.SafePlatformClient = SafePlatformClient;
+function toFormattedError(err) {
+    if (err instanceof sdk_error_1.SdkError) {
+        return {
+            code: err.code,
+            message: err.message,
+            hint: buildHint(err.code),
+            retryable: err.retryable,
+            retryAfterMs: err.retryAfterMs,
+            requestId: err.requestId,
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        code: 'UNKNOWN_ERROR',
+        message,
+        hint: 'An unexpected error occurred. Check server logs for details.',
+        retryable: false,
+    };
+}
+function buildHint(code) {
+    const hints = {
+        OPENAI_401: 'Check your OpenAI API key.',
+        OPENAI_429: 'Rate limited by OpenAI. Retry after the indicated delay.',
+        ANTHROPIC_401: 'Check your Anthropic API key.',
+        ANTHROPIC_429: 'Rate limited by Anthropic. Retry after the indicated delay.',
+        TOOL_LOOP_MAX_TURNS_EXCEEDED: 'The AI tool loop exceeded max turns. Consider reducing tool complexity.',
+        NO_TOOL_HANDLER_CONFIGURED: 'The AI requested tool calls but no ToolHandler was configured.',
+    };
+    return hints[code] ?? 'See error.message for details.';
+}
+//# sourceMappingURL=safe-platform.client.js.map

package/dist/src/safe/safe-platform.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-platform.client.js","sourceRoot":"","sources":["../../../src/safe/safe-platform.client.ts"],"names":[],"mappings":";;;AAGA,wEAAyD;AACzD,mDAA+C;AAE/C;;;;GAIG;AACH,MAAa,kBAAkB;IAC7B,YAA6B,QAAoB;QAApB,aAAQ,GAAR,QAAQ,CAAY;IAAG,CAAC;IAErD,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACxD,OAAO,IAAA,yBAAE,EAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAA,2BAAI,EAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAXD,gDAWC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,YAAY,oBAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YACzB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO;QACP,IAAI,EAAE,8DAA8D;QACpE,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAA2B;QACpC,UAAU,EAAE,4BAA4B;QACxC,UAAU,EAAE,0DAA0D;QACtE,aAAa,EAAE,+BAA+B;QAC9C,aAAa,EAAE,6DAA6D;QAC5E,4BAA4B,EAAE,yEAAyE;QACvG,0BAA0B,EAAE,gEAAgE;KAC7F,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,gCAAgC,CAAC;AACzD,CAAC"}

package/dist/src/types/ask-with-tools.types.d.ts

@@ -0,0 +1,48 @@
+/** Normalized usage metrics across providers. */
+export interface UsageMetrics {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Input parameters for askWithTools() — provider-agnostic.
+ * telbany's buildResponseConfig produces the instructions/tools fields.
+ */
+export interface AskWithToolsParams {
+    /** App-level thread identifier (Thread.thread_id in MongoDB). */
+    threadKey: string;
+    /** Chatbot ID — passed to the tool handler for context resolution. */
+    chatbotId: string;
+    /** Organization ID — passed to tool handler for notifications. */
+    organizationId?: string;
+    /** The user's question / message text. */
+    userQuestion: string;
+    /** Pre-assembled system instructions (from buildResponseConfig or equivalent). */
+    instructions: string;
+    /** Pre-assembled tool definitions for this chatbot. */
+    tools?: unknown[];
+    /** Vector store IDs for file_search (OpenAI only). */
+    vectorStoreIds?: string[];
+    /** AI model override for this call. Falls back to ClientConfig.model. */
+    model?: string;
+    /** Media URLs attached by the user (images, files). */
+    mediaUrl?: string[];
+}
+/** Returned when the AI produced a plain text answer. */
+export interface TextResult {
+    kind: 'text';
+    outputText: string;
+    responseId: string;
+    usage: UsageMetrics | null;
+    model: string;
+}
+/** Returned when a tool call triggered an app-level side effect (ticket, product, etc.). */
+export interface ToolResult {
+    kind: 'toolResult';
+    toolCallResult: unknown;
+    responseId: string;
+    usage: UsageMetrics | null;
+    model: string;
+}
+export type AskWithToolsResult = TextResult | ToolResult;
+//# sourceMappingURL=ask-with-tools.types.d.ts.map

package/dist/src/types/ask-with-tools.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-with-tools.types.d.ts","sourceRoot":"","sources":["../../../src/types/ask-with-tools.types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAElB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IAErB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IAErB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAElB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/dist/src/types/ask-with-tools.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ask-with-tools.types.js.map

package/dist/src/types/ask-with-tools.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-with-tools.types.js","sourceRoot":"","sources":["../../../src/types/ask-with-tools.types.ts"],"names":[],"mappings":""}

package/dist/src/types/client-config.interface.d.ts

@@ -0,0 +1,33 @@
+import type { ConversationStore } from './conversation-store.interface';
+import type { ToolHandler } from './tool-handler.interface';
+/** Which AI provider to use for a given client instance. */
+export type ProviderType = 'openai-responses' | 'openai-assistants' | 'anthropic';
+/** Options accepted by createPlatformClient(). */
+export interface ClientConfig {
+    /** AI provider to use. */
+    provider: ProviderType;
+    /** Provider API key (OpenAI or Anthropic depending on provider). */
+    apiKey: string;
+    /**
+     * Default model to use when none is specified per-call.
+     * OpenAI: 'gpt-4o', 'gpt-4o-mini', etc.
+     * Anthropic: 'claude-opus-4-5', 'claude-sonnet-4-5', etc.
+     */
+    model?: string;
+    /**
+     * Pluggable persistence for conversation state.
+     * Required for openai-responses (maintains conversationId + lastResponseId).
+     * Optional for openai-assistants and anthropic.
+     */
+    conversationStore?: ConversationStore;
+    /**
+     * Pluggable tool handler — the app injects its own tool resolution logic.
+     * Required when the chatbot has custom assistant functions.
+     */
+    toolHandler?: ToolHandler;
+    /** Maximum retries on transient errors. Default: 2. */
+    maxRetries?: number;
+    /** Request timeout in milliseconds. Default: 60000. */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=client-config.interface.d.ts.map

package/dist/src/types/client-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.interface.d.ts","sourceRoot":"","sources":["../../../src/types/client-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAElF,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,CAAC;IAEvB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/types/client-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=client-config.interface.js.map

package/dist/src/types/client-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.interface.js","sourceRoot":"","sources":["../../../src/types/client-config.interface.ts"],"names":[],"mappings":""}

package/dist/src/types/conversation-store.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pluggable persistence contract for conversation state.
+ *
+ * Telbany implements this with Mongoose (Thread.openai_conversation_id / last_response_id).
+ * The SDK ships a MemoryConversationStore for tests and lightweight use cases.
+ *
+ * threadKey — the app-level identifier (e.g. Thread.thread_id from MongoDB).
+ */
+export interface ConversationState {
+    conversationId: string;
+    lastResponseId?: string;
+}
+export interface ConversationStore {
+    /** Load state for a thread. Returns null when no conversation has been created yet. */
+    load(threadKey: string): Promise<ConversationState | null>;
+    /** Persist updated state after each turn. */
+    save(threadKey: string, state: ConversationState): Promise<void>;
+    /**
+     * Create a new conversation and persist it.
+     * Called when load() returns null and a new conversation must be created.
+     */
+    create(threadKey: string, conversationId: string): Promise<ConversationState>;
+}
+//# sourceMappingURL=conversation-store.interface.d.ts.map

package/dist/src/types/conversation-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.interface.d.ts","sourceRoot":"","sources":["../../../src/types/conversation-store.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAE3D,6CAA6C;IAC7C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/E"}

package/dist/src/types/conversation-store.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=conversation-store.interface.js.map

package/dist/src/types/conversation-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.interface.js","sourceRoot":"","sources":["../../../src/types/conversation-store.interface.ts"],"names":[],"mappings":""}