@mohamedtebo/convai-platform 1.0.0 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # @mohamedtebo/convai-platform
 
-> Multi-provider AI conversation SDK — OpenAI Responses/Conversations API, OpenAI Assistants (legacy), and Anthropic Claude — with explicit tool loops, pluggable persistence, and strict Single Responsibility architecture.
+> Multi-provider AI SDK — OpenAI **Responses + Conversations** (recommended), OpenAI Assistants (legacy), Anthropic Claude. Explicit tool loops, pluggable `ConversationStore` + `ToolHandler`, `SdkResult` safe API.
 
 ---
 
@@ -8,7 +8,7 @@
 
 ```bash
 npm install @mohamedtebo/convai-platform openai
-# optional: add Anthropic support
+# optional
 npm install @anthropic-ai/sdk
 ```
 
@@ -22,132 +22,140 @@ import { createPlatformClient, MemoryConversationStore } from '@mohamedtebo/conv
 const client = createPlatformClient({
   provider: 'openai-responses',
   apiKey: process.env.OPENAI_API_KEY!,
-  model: 'gpt-4o',
+  model: 'gpt-4o-mini',
   conversationStore: new MemoryConversationStore(),
 });
 
 const result = await client.safe.askWithTools({
-  threadKey: 'thread_abc123',
-  chatbotId: 'bot_001',
-  userQuestion: 'Hello, how can I book a ticket?',
+  threadKey: 'resp_conv_abc123',
+  chatbotId: '507f1f77bcf86cd799439011',
+  userQuestion: 'Book a ticket for tomorrow',
   instructions: 'You are a helpful booking assistant.',
 });
 
 if (result.success) {
-  console.log(result.data.outputText);
+  if (result.data.kind === 'text') {
+    console.log(result.data.outputText);
+  } else {
+    console.log(result.data.toolCallResult);
+  }
 } else {
-  console.error(result.error.hint);
+  console.error(result.error.code, result.error.hint);
 }
 ```
 
 ---
 
-## Architecture
+## Documentation (included in npm package)
 
-```
-src/
-├── index.ts                        ← Public API (exports)
-├── composed/
-│   └── platform-client.ts          ← createPlatformClient() — composed entry point
-├── factory/
-│   └── provider.factory.ts         ← Maps ClientConfig → AIProvider
-├── safe/
-│   └── safe-platform.client.ts     ← SdkResult<T> wrapper (never throws)
-├── types/                          ← Shared interfaces (all ≤ 60 lines)
-│   ├── ask-with-tools.types.ts
-│   ├── client-config.interface.ts
-│   ├── conversation-store.interface.ts
-│   ├── provider.interface.ts
-│   ├── sdk-result.interface.ts
-│   └── tool-handler.interface.ts
-├── errors/                         ← Typed error hierarchy
-│   ├── sdk.error.ts
-│   ├── provider.error.ts
-│   └── tool-loop.error.ts
-├── adapters/
-│   └── memory-conversation.store.ts ← In-memory ConversationStore (for tests)
-└── providers/
-    ├── openai/
-    │   ├── openai-responses.provider.ts  ← NEW API: Responses + Conversations
-    │   ├── openai-assistants.provider.ts ← LEGACY API: beta.threads (deprecated)
-    │   ├── operations/                   ← Single-operation files (createResponse, etc.)
-    │   ├── loops/                        ← Tool loop implementations
-    │   ├── builders/                     ← State builders (resolveConversationId)
-    │   └── utils/                        ← error-mapper, usage-mapper
-    └── anthropic/
-        ├── anthropic.provider.ts
-        ├── loops/claude-tool.loop.ts
-        └── utils/error-mapper.ts
-```
+| Doc | Description |
+|-----|-------------|
+| **[docs/API_INTEGRATION.md](./docs/API_INTEGRATION.md)** | Full **api** integration: migration, lifecycle, WhatsApp, Facebook |
+| **[../api/docs/COMPLETE_CONVAI_SDK_INTEGRATION_GUIDE.md](../api/docs/COMPLETE_CONVAI_SDK_INTEGRATION_GUIDE.md)** | Master guide (api monorepo) — all channels + migration |
+| [README.md](./README.md) | This file — SDK API reference |
+
+After install: `node_modules/@mohamedtebo/convai-platform/docs/API_INTEGRATION.md`
+
+**api monorepo copies:**
+
+- `api/docs/CONVAI_SDK_INTEGRATION.md` — integration guide
+- `api/docs/reports/CONVAI_SDK_INTEGRATION_REPORT.md` — formal rollout report
 
 ---
 
 ## Providers
 
-| Provider | Config `provider` value | Notes |
-|---|---|---|
-| OpenAI Responses + Conversations | `openai-responses` | **Recommended** |
-| OpenAI Assistants (legacy) | `openai-assistants` | Deprecated — use during migration |
-| Anthropic Claude | `anthropic` | Requires `@anthropic-ai/sdk` peer dep |
+| `provider` value | API |
+|------------------|-----|
+| `openai-responses` | OpenAI Responses + Conversations (**recommended**) |
+| `openai-assistants` | OpenAI Assistants beta (legacy) |
+| `anthropic` | Claude |
 
 ---
 
-## Pluggable Persistence — ConversationStore
+## Core interfaces
+
+### ConversationStore
+
+Persist `conversationId` and `lastResponseId` per app thread key.
 
 ```typescript
-export interface ConversationStore {
+interface ConversationStore {
   load(threadKey: string): Promise<ConversationState | null>;
   save(threadKey: string, state: ConversationState): Promise<void>;
   create(threadKey: string, conversationId: string): Promise<ConversationState>;
 }
 ```
 
-Telbany ships a `MongoConversationStore` inside `api/src/core/convai-adapters/` that reads/writes `Thread.openai_conversation_id` and `Thread.last_response_id`.
+**api** implements this as `MongoConversationStore` (`Thread.openai_conversation_id`).
 
----
+### ToolHandler
 
-## Pluggable Tool Handling — ToolHandler
+Execute business tools when the model returns `function_call`.
 
 ```typescript
-export interface ToolHandler {
+interface ToolHandler {
   buildOutput(call: RawToolCall, ctx: ToolHandlerContext): Promise<ToolOutput | undefined>;
   extractResult(calls: RawToolCall[], outputs: ToolOutput[], ctx: ToolHandlerContext): Promise<unknown>;
 }
 ```
 
-Telbany ships a `TelbanyToolHandler` that delegates to existing run-completion services so all business logic stays in `telbany`, not in the SDK.
+**api** implements this as **ApiToolHandler** in `api/src/core/convai-adapters/telbany-tool.handler.ts`.
 
 ---
 
-## Result type
+## api integration (production)
 
 ```typescript
-const result = await client.safe.askWithTools(params);
+import { getAIPlatformClient } from './core/convai-adapters';
+
+const client = getAIPlatformClient({ backend: 'openai-responses', model: 'gpt-4o-mini' });
+
+await client.safe.askWithTools({
+  threadKey: threadId,
+  chatbotId,
+  organizationId,
+  userQuestion: enrichedQuestion,
+  instructions: params.instructions,
+  tools: params.tools,
+  model: params.model,
+  mediaUrl,
+});
+```
+
+Enable: `AI_USE_CONVAI_SDK=true` in api `.env` (after migration steps 01–06).
+
+---
+
+## Package layout
 
-if (result.success) {
-  if (result.data.kind === 'text') {
-    console.log(result.data.outputText); // plain AI reply
-  } else {
-    console.log(result.data.toolCallResult); // ticket, product, etc.
-  }
-} else {
-  console.error(result.error.code, result.error.hint);
-}
+```
+src/
+├── composed/platform-client.ts
+├── factory/provider.factory.ts
+├── safe/safe-platform.client.ts
+├── types/
+├── errors/
+├── adapters/memory-conversation.store.ts
+└── providers/openai/
+    ├── openai-responses.provider.ts
+    ├── operations/create-response.operation.ts
+    ├── operations/submit-tool-outputs.operation.ts
+    └── loops/responses-tool.loop.ts
+docs/
+└── API_INTEGRATION.md    ← full api rollout guide
 ```
 
 ---
 
-## Build & Publish
+## Build & publish
 
 ```bash
-# inside convai-platform/
-npm install
 npm run build
+npm test
 npm publish --access public
 ```
 
-Requires npm login under `mohamedtebo` account, or `npm login --registry https://registry.npmjs.org`.
-
 ---
 
 ## License

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

@@ -1,15 +1,16 @@
-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).
+ * Load existing conversation state for a thread.
+ * Returns undefined conversationId on first turn — OpenAI auto-creates the
+ * conversation and returns its ID in the response (response.conversation.id).
+ * The caller is responsible for persisting that ID via store.save() after
+ * receiving the first response.
  */
-export declare function resolveConversationId({ openai, store, threadKey, }: {
-    openai: OpenAI;
+export declare function loadConversationState({ store, threadKey, }: {
     store: ConversationStore;
     threadKey: string;
 }): Promise<{
-    conversationId: string;
+    conversationId: string | undefined;
     lastResponseId: string | undefined;
 }>;
 //# sourceMappingURL=conversation-or-create.builder.d.ts.map

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

@@ -1 +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"}
+{"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,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAErF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,KAAK,EACL,SAAS,GACV,EAAE;IACD,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAMtF"}

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

@@ -1,18 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveConversationId = resolveConversationId;
-const create_conversation_operation_1 = require("../operations/create-conversation.operation");
+exports.loadConversationState = loadConversationState;
 /**
- * Resolve the conversationId for a thread.
- * Creates a new OpenAI conversation when none exists yet (lazy creation).
+ * Load existing conversation state for a thread.
+ * Returns undefined conversationId on first turn — OpenAI auto-creates the
+ * conversation and returns its ID in the response (response.conversation.id).
+ * The caller is responsible for persisting that ID via store.save() after
+ * receiving the first response.
  */
-async function resolveConversationId({ openai, store, threadKey, }) {
+async function loadConversationState({ 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 };
+    return {
+        conversationId: existing?.conversationId,
+        lastResponseId: existing?.lastResponseId,
+    };
 }
 //# sourceMappingURL=conversation-or-create.builder.js.map

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

@@ -1 +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"}
+{"version":3,"file":"conversation-or-create.builder.js","sourceRoot":"","sources":["../../../../src/providers/openai/builders/conversation-or-create.builder.ts"],"names":[],"mappings":";;AASA,sDAYC;AAnBD;;;;;;GAMG;AACI,KAAK,UAAU,qBAAqB,CAAC,EAC1C,KAAK,EACL,SAAS,GAIV;IACC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;QACL,cAAc,EAAE,QAAQ,EAAE,cAAc;QACxC,cAAc,EAAE,QAAQ,EAAE,cAAc;KACzC,CAAC;AACJ,CAAC"}

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

@@ -8,7 +8,12 @@ interface LoopContext {
     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>;
+/**
+ * Run the full Responses API tool loop for one user turn.
+ *
+ * Mirrors telbany's legacy runResponseToolLoop: tool calls are detected from
+ * `output[]` items with type `function_call`, not from status `requires_action`.
+ */
+export declare function runResponsesToolLoop(ctx: LoopContext, params: AskWithToolsParams, conversationId: string | undefined, previousResponseId: string | undefined): Promise<AskWithToolsResult>;
 export {};
 //# sourceMappingURL=responses-tool.loop.d.ts.map

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

@@ -1 +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"}
+{"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;AA+BD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAsG7B"}

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

@@ -6,60 +6,104 @@ const submit_tool_outputs_operation_1 = require("../operations/submit-tool-outpu
 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. */
+function buildTextResult(response, responseId, model) {
+    return {
+        kind: 'text',
+        outputText: extractOutputText(response),
+        responseId,
+        usage: (0, usage_mapper_1.mapUsage)(response['usage']),
+        model,
+    };
+}
+function buildToolResult(toolCallResult, response, responseId, model) {
+    return {
+        kind: 'toolResult',
+        toolCallResult,
+        responseId,
+        usage: (0, usage_mapper_1.mapUsage)(response['usage']),
+        model,
+    };
+}
+/**
+ * Run the full Responses API tool loop for one user turn.
+ *
+ * Mirrors telbany's legacy runResponseToolLoop: tool calls are detected from
+ * `output[]` items with type `function_call`, not from status `requires_action`.
+ */
 async function runResponsesToolLoop(ctx, params, conversationId, previousResponseId) {
     const { openai, store, handler, model } = ctx;
-    let lastResponseId = previousResponseId;
+    let currentResponse = await createResponseWithRecovery(openai, store, params, conversationId, previousResponseId, model);
+    const resolvedConversationId = currentResponse['conversation']?.['id']
+        ?? conversationId
+        ?? '';
+    let currentResponseId = currentResponse['id'];
+    await store.save(params.threadKey, {
+        conversationId: resolvedConversationId,
+        lastResponseId: currentResponseId,
+    });
     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)
+        const status = currentResponse['status'];
+        if (status === 'failed') {
             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 };
+        const calls = extractToolCalls(currentResponse);
+        // No function calls — plain text turn complete
+        if (!calls.length) {
+            return buildTextResult(currentResponse, currentResponseId, model);
+        }
+        if (!handler)
+            throw new errors_1.NoToolHandlerError();
+        const toolCtx = {
+            threadKey: params.threadKey,
+            chatbotId: params.chatbotId,
+            organizationId: params.organizationId,
+            userQuestion: params.userQuestion,
+            mediaUrl: params.mediaUrl,
+        };
+        const outputs = (await Promise.all(calls.map((call) => handler.buildOutput(call, toolCtx)))).filter((o) => o !== undefined);
+        const appResult = await handler.extractResult(calls, outputs, toolCtx);
+        if (appResult !== null) {
+            // Side-effect ready (ticket, calendar, etc.) — api post-processes via AssistantResponseService.
+            // Must still submit tool outputs so the OpenAI conversation is not left with a pending
+            // function_call (matches legacy runResponseToolLoop + handleRunCompletion).
+            if (outputs.length) {
+                currentResponse = (await (0, submit_tool_outputs_operation_1.submitToolOutputs)(openai, {
+                    previousResponseId: currentResponseId,
+                    conversationId: resolvedConversationId,
+                    model,
+                    instructions: params.instructions,
+                    toolOutputs: outputs,
+                    tools: params.tools,
+                }));
+                currentResponseId = currentResponse['id'];
+                await store.save(params.threadKey, {
+                    conversationId: resolvedConversationId,
+                    lastResponseId: currentResponseId,
+                });
             }
+            return buildToolResult(appResult, currentResponse, currentResponseId, model);
+        }
+        if (!outputs.length) {
+            break;
         }
+        currentResponse = (await (0, submit_tool_outputs_operation_1.submitToolOutputs)(openai, {
+            previousResponseId: currentResponseId,
+            conversationId: resolvedConversationId,
+            model,
+            instructions: params.instructions,
+            toolOutputs: outputs,
+            tools: params.tools,
+        }));
+        currentResponseId = currentResponse['id'];
+        await store.save(params.threadKey, {
+            conversationId: resolvedConversationId,
+            lastResponseId: currentResponseId,
+        });
     }
-    throw new errors_1.ToolLoopError(MAX_TURNS);
+    if (currentResponse['status'] === 'failed') {
+        throw new errors_1.ToolLoopError(MAX_TURNS);
+    }
+    return buildTextResult(currentResponse, currentResponseId, model);
 }
 function extractOutputText(response) {
     const output = response['output'];
@@ -71,7 +115,12 @@ function extractOutputText(response) {
     const content = textBlock['content'];
     if (!Array.isArray(content))
         return '';
-    return content.map((c) => c['text'] ?? '').join('');
+    return content
+        .map((c) => {
+        const part = c;
+        return (part['text'] ?? part['output_text'] ?? '');
+    })
+        .join('');
 }
 function extractToolCalls(response) {
     const output = response['output'];
@@ -81,7 +130,74 @@ function extractToolCalls(response) {
         .filter((b) => b['type'] === 'function_call')
         .map((b) => {
         const block = b;
-        return { id: block['call_id'], name: block['name'], arguments: block['arguments'] };
+        return {
+            id: (block['call_id'] ?? block['id']),
+            name: block['name'],
+            arguments: (block['arguments'] ?? '{}'),
+        };
     });
 }
+function isPendingToolOutputError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return msg.includes('No tool output found for function call');
+}
+/** Heal conversations left with unanswered function_call (pre-fix SDK short-circuit). */
+async function recoverPendingToolOutputs(openai, opts) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const stuck = (await openai.responses.retrieve(opts.previousResponseId));
+    const calls = extractToolCalls(stuck);
+    if (!calls.length)
+        return undefined;
+    const outputs = calls.map((call) => ({
+        call_id: call.id,
+        output: JSON.stringify({ status: 'completed' }),
+    }));
+    const healed = (await (0, submit_tool_outputs_operation_1.submitToolOutputs)(openai, {
+        previousResponseId: opts.previousResponseId,
+        conversationId: opts.conversationId,
+        model: opts.model,
+        instructions: opts.instructions,
+        toolOutputs: outputs,
+        tools: opts.tools,
+    }));
+    return healed['id'];
+}
+async function createResponseWithRecovery(openai, store, params, conversationId, previousResponseId, model) {
+    try {
+        return (await (0, create_response_operation_1.createResponse)(openai, {
+            conversationId,
+            previousResponseId,
+            model,
+            instructions: params.instructions,
+            userQuestion: params.userQuestion,
+            tools: params.tools,
+            vectorStoreIds: params.vectorStoreIds,
+        }));
+    }
+    catch (err) {
+        if (!isPendingToolOutputError(err) || !previousResponseId)
+            throw err;
+        const healedId = await recoverPendingToolOutputs(openai, {
+            previousResponseId,
+            conversationId,
+            model,
+            instructions: params.instructions,
+            tools: params.tools,
+        });
+        if (healedId && conversationId) {
+            await store.save(params.threadKey, {
+                conversationId,
+                lastResponseId: healedId,
+            });
+        }
+        return (await (0, create_response_operation_1.createResponse)(openai, {
+            conversationId,
+            model,
+            instructions: params.instructions,
+            userQuestion: params.userQuestion,
+            tools: params.tools,
+            vectorStoreIds: params.vectorStoreIds,
+        }));
+    }
+}
 //# sourceMappingURL=responses-tool.loop.js.map

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

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

@@ -1 +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"}
+{"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;CAa5E"}

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

@@ -23,8 +23,7 @@ class OpenAIResponsesProvider {
         this.handler = config.toolHandler;
     }
     async askWithTools(params) {
-        const { conversationId, lastResponseId } = await (0, conversation_or_create_builder_1.resolveConversationId)({
-            openai: this.openai,
+        const { conversationId, lastResponseId } = await (0, conversation_or_create_builder_1.loadConversationState)({
             store: this.store,
             threadKey: params.threadKey,
         });

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

@@ -1 +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"}
+{"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,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;AA9BD,0DA8BC"}

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

@@ -1,6 +1,7 @@
 import type OpenAI from 'openai';
 export interface CreateResponseParams {
-    conversationId: string;
+    /** Existing OpenAI conversation ID, or undefined for the very first turn (auto-created by OpenAI). */
+    conversationId?: string;
     previousResponseId?: string;
     model: string;
     instructions: string;

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

@@ -1 +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"}
+{"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,sGAAsG;IACtG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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,CAwClB"}