@mohamedtebo/convai-platform 1.0.0

package/dist/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/safe/index.d.ts

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

package/dist/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/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/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/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/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/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/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/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export { MemoryConversationStore } from './memory-conversation.store';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/adapters/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryConversationStore = void 0;
+var memory_conversation_store_1 = require("./memory-conversation.store");
+Object.defineProperty(exports, "MemoryConversationStore", { enumerable: true, get: function () { return memory_conversation_store_1.MemoryConversationStore; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":";;;AAAA,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA"}

package/dist/src/adapters/memory-conversation.store.d.ts

@@ -0,0 +1,12 @@
+import type { ConversationState, ConversationStore } from '../types/conversation-store.interface';
+/**
+ * In-memory ConversationStore — useful for tests and lightweight apps.
+ * State is lost when the process restarts. Use MongoConversationStore in production.
+ */
+export declare class MemoryConversationStore implements ConversationStore {
+    private readonly map;
+    load(threadKey: string): Promise<ConversationState | null>;
+    save(threadKey: string, state: ConversationState): Promise<void>;
+    create(threadKey: string, conversationId: string): Promise<ConversationState>;
+}
+//# sourceMappingURL=memory-conversation.store.d.ts.map

package/dist/src/adapters/memory-conversation.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation.store.d.ts","sourceRoot":"","sources":["../../../src/adapters/memory-conversation.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAElG;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwC;IAEtD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAKpF"}

package/dist/src/adapters/memory-conversation.store.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryConversationStore = void 0;
+/**
+ * In-memory ConversationStore — useful for tests and lightweight apps.
+ * State is lost when the process restarts. Use MongoConversationStore in production.
+ */
+class MemoryConversationStore {
+    constructor() {
+        this.map = new Map();
+    }
+    async load(threadKey) {
+        return this.map.get(threadKey) ?? null;
+    }
+    async save(threadKey, state) {
+        this.map.set(threadKey, state);
+    }
+    async create(threadKey, conversationId) {
+        const state = { conversationId };
+        this.map.set(threadKey, state);
+        return state;
+    }
+}
+exports.MemoryConversationStore = MemoryConversationStore;
+//# sourceMappingURL=memory-conversation.store.js.map

package/dist/src/adapters/memory-conversation.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversation.store.js","sourceRoot":"","sources":["../../../src/adapters/memory-conversation.store.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,uBAAuB;IAApC;QACmB,QAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IAe9D,CAAC;IAbC,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,KAAwB;QACpD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,cAAsB;QACpD,MAAM,KAAK,GAAsB,EAAE,cAAc,EAAE,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAhBD,0DAgBC"}

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

@@ -0,0 +1,29 @@
+import type { ClientConfig } from '../types/client-config.interface';
+import type { AskWithToolsParams, AskWithToolsResult } from '../types/ask-with-tools.types';
+import type { SdkResult } from '../types/sdk-result.interface';
+/**
+ * Fully composed SDK client.
+ * Exposes both a raw API (throws on error) and a safe API (returns SdkResult).
+ *
+ * @example
+ * const client = createPlatformClient({
+ *   provider: 'openai-responses',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   model: 'gpt-4o',
+ *   conversationStore: new MongoConversationStore(),
+ *   toolHandler: new TelbanyToolHandler(),
+ * });
+ *
+ * const result = await client.safe.askWithTools({ ... });
+ * if (result.success) console.log(result.data.outputText);
+ */
+export interface PlatformClient {
+    /** Call askWithTools directly — throws SdkError on failure. */
+    askWithTools(params: AskWithToolsParams): Promise<AskWithToolsResult>;
+    /** Safe version — never throws, returns SdkResult<T>. */
+    safe: {
+        askWithTools(params: AskWithToolsParams): Promise<SdkResult<AskWithToolsResult>>;
+    };
+}
+export declare function createPlatformClient(config: ClientConfig): PlatformClient;
+//# sourceMappingURL=platform-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.d.ts","sourceRoot":"","sources":["../../../src/composed/platform-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtE,yDAAyD;IACzD,IAAI,EAAE;QACJ,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC;KAClF,CAAC;CACH;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAUzE"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlatformClient = createPlatformClient;
+const provider_factory_1 = require("../factory/provider.factory");
+const safe_platform_client_1 = require("../safe/safe-platform.client");
+function createPlatformClient(config) {
+    const provider = (0, provider_factory_1.buildProvider)(config);
+    const safeClient = new safe_platform_client_1.SafePlatformClient(provider);
+    return {
+        askWithTools: (params) => provider.askWithTools(params),
+        safe: {
+            askWithTools: (params) => safeClient.askWithTools(params),
+        },
+    };
+}
+//# sourceMappingURL=platform-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.js","sourceRoot":"","sources":["../../../src/composed/platform-client.ts"],"names":[],"mappings":";;AA+BA,oDAUC;AAtCD,kEAA4D;AAC5D,uEAAkE;AA2BlE,SAAgB,oBAAoB,CAAC,MAAoB;IACvD,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,yCAAkB,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO;QACL,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC;QACvD,IAAI,EAAE;YACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC;SAC1D;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+export { SdkError } from './sdk.error';
+export { ProviderError } from './provider.error';
+export { ToolLoopError, NoToolHandlerError } from './tool-loop.error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/errors/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoToolHandlerError = exports.ToolLoopError = exports.ProviderError = exports.SdkError = void 0;
+var sdk_error_1 = require("./sdk.error");
+Object.defineProperty(exports, "SdkError", { enumerable: true, get: function () { return sdk_error_1.SdkError; } });
+var provider_error_1 = require("./provider.error");
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return provider_error_1.ProviderError; } });
+var tool_loop_error_1 = require("./tool-loop.error");
+Object.defineProperty(exports, "ToolLoopError", { enumerable: true, get: function () { return tool_loop_error_1.ToolLoopError; } });
+Object.defineProperty(exports, "NoToolHandlerError", { enumerable: true, get: function () { return tool_loop_error_1.NoToolHandlerError; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qDAAsE;AAA7D,gHAAA,aAAa,OAAA;AAAE,qHAAA,kBAAkB,OAAA"}

package/dist/src/errors/provider.error.d.ts

@@ -0,0 +1,16 @@
+import { SdkError } from './sdk.error';
+/** Error from the AI provider itself (API error, rate limit, auth failure). */
+export declare class ProviderError extends SdkError {
+    readonly statusCode?: number;
+    readonly provider: string;
+    constructor({ provider, code, message, statusCode, retryable, retryAfterMs, requestId, }: {
+        provider: string;
+        code: string;
+        message: string;
+        statusCode?: number;
+        retryable?: boolean;
+        retryAfterMs?: number;
+        requestId?: string;
+    });
+}
+//# sourceMappingURL=provider.error.d.ts.map

package/dist/src/errors/provider.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.error.d.ts","sourceRoot":"","sources":["../../../src/errors/provider.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,+EAA+E;AAC/E,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,EACV,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,UAAU,EACV,SAAiB,EACjB,YAAY,EACZ,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAMF"}

package/dist/src/errors/provider.error.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderError = void 0;
+const sdk_error_1 = require("./sdk.error");
+/** Error from the AI provider itself (API error, rate limit, auth failure). */
+class ProviderError extends sdk_error_1.SdkError {
+    constructor({ provider, code, message, statusCode, retryable = false, retryAfterMs, requestId, }) {
+        super({ code, message, retryable, retryAfterMs, requestId });
+        this.name = 'ProviderError';
+        this.provider = provider;
+        this.statusCode = statusCode;
+    }
+}
+exports.ProviderError = ProviderError;
+//# sourceMappingURL=provider.error.js.map

package/dist/src/errors/provider.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.error.js","sourceRoot":"","sources":["../../../src/errors/provider.error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAEvC,+EAA+E;AAC/E,MAAa,aAAc,SAAQ,oBAAQ;IAIzC,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,UAAU,EACV,SAAS,GAAG,KAAK,EACjB,YAAY,EACZ,SAAS,GASV;QACC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AA1BD,sCA0BC"}

package/dist/src/errors/sdk.error.d.ts

@@ -0,0 +1,15 @@
+/** Base SDK error — all thrown errors extend this. */
+export declare class SdkError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly retryAfterMs?: number;
+    readonly requestId?: string;
+    constructor({ code, message, retryable, retryAfterMs, requestId, }: {
+        code: string;
+        message: string;
+        retryable?: boolean;
+        retryAfterMs?: number;
+        requestId?: string;
+    });
+}
+//# sourceMappingURL=sdk.error.d.ts.map

package/dist/src/errors/sdk.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.error.d.ts","sourceRoot":"","sources":["../../../src/errors/sdk.error.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,EACV,IAAI,EACJ,OAAO,EACP,SAAiB,EACjB,YAAY,EACZ,SAAS,GACV,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAQF"}

package/dist/src/errors/sdk.error.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SdkError = void 0;
+/** Base SDK error — all thrown errors extend this. */
+class SdkError extends Error {
+    constructor({ code, message, retryable = false, retryAfterMs, requestId, }) {
+        super(message);
+        this.name = 'SdkError';
+        this.code = code;
+        this.retryable = retryable;
+        this.retryAfterMs = retryAfterMs;
+        this.requestId = requestId;
+    }
+}
+exports.SdkError = SdkError;
+//# sourceMappingURL=sdk.error.js.map

package/dist/src/errors/sdk.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.error.js","sourceRoot":"","sources":["../../../src/errors/sdk.error.ts"],"names":[],"mappings":";;;AAAA,sDAAsD;AACtD,MAAa,QAAS,SAAQ,KAAK;IAMjC,YAAY,EACV,IAAI,EACJ,OAAO,EACP,SAAS,GAAG,KAAK,EACjB,YAAY,EACZ,SAAS,GAOV;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AA1BD,4BA0BC"}

package/dist/src/errors/tool-loop.error.d.ts

@@ -0,0 +1,11 @@
+import { SdkError } from './sdk.error';
+/** Error thrown when the AI tool loop exceeds the maximum number of turns. */
+export declare class ToolLoopError extends SdkError {
+    readonly turnsExceeded: number;
+    constructor(turnsExceeded: number);
+}
+/** Error thrown when no tool handler is configured but the AI requests tool calls. */
+export declare class NoToolHandlerError extends SdkError {
+    constructor();
+}
+//# sourceMappingURL=tool-loop.error.d.ts.map

package/dist/src/errors/tool-loop.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop.error.d.ts","sourceRoot":"","sources":["../../../src/errors/tool-loop.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,8EAA8E;AAC9E,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,aAAa,EAAE,MAAM;CASlC;AAED,sFAAsF;AACtF,qBAAa,kBAAmB,SAAQ,QAAQ;;CAS/C"}

package/dist/src/errors/tool-loop.error.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoToolHandlerError = exports.ToolLoopError = void 0;
+const sdk_error_1 = require("./sdk.error");
+/** Error thrown when the AI tool loop exceeds the maximum number of turns. */
+class ToolLoopError extends sdk_error_1.SdkError {
+    constructor(turnsExceeded) {
+        super({
+            code: 'TOOL_LOOP_MAX_TURNS_EXCEEDED',
+            message: `Tool loop exceeded ${turnsExceeded} turns without a final answer`,
+            retryable: false,
+        });
+        this.name = 'ToolLoopError';
+        this.turnsExceeded = turnsExceeded;
+    }
+}
+exports.ToolLoopError = ToolLoopError;
+/** Error thrown when no tool handler is configured but the AI requests tool calls. */
+class NoToolHandlerError extends sdk_error_1.SdkError {
+    constructor() {
+        super({
+            code: 'NO_TOOL_HANDLER_CONFIGURED',
+            message: 'AI requested tool calls but no ToolHandler was configured in ClientConfig',
+            retryable: false,
+        });
+        this.name = 'NoToolHandlerError';
+    }
+}
+exports.NoToolHandlerError = NoToolHandlerError;
+//# sourceMappingURL=tool-loop.error.js.map

package/dist/src/errors/tool-loop.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop.error.js","sourceRoot":"","sources":["../../../src/errors/tool-loop.error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAEvC,8EAA8E;AAC9E,MAAa,aAAc,SAAQ,oBAAQ;IAGzC,YAAY,aAAqB;QAC/B,KAAK,CAAC;YACJ,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,sBAAsB,aAAa,+BAA+B;YAC3E,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAZD,sCAYC;AAED,sFAAsF;AACtF,MAAa,kBAAmB,SAAQ,oBAAQ;IAC9C;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,2EAA2E;YACpF,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AATD,gDASC"}

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

@@ -0,0 +1,2 @@
+export { buildProvider } from './provider.factory';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/factory/index.js

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