@linkedapi/mcp 1.0.0 → 2.0.0

package/src/tools/get-conversation.ts

@@ -1,7 +1,12 @@
-import LinkedApi, { TConversationPollResult, TMappedResponse } from '@linkedapi/node';
+import LinkedApi, {
+  OPERATION_NAME,
+  TConversationPollResult,
+  TMappedResponse,
+} from '@linkedapi/node';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import z from 'zod';
 
+import type { TWorkflowAck } from '../types/linked-api-tool-result.type.js';
 import { LinkedApiTool } from '../utils/linked-api-tool.js';
 
 export class GetConversationTool extends LinkedApiTool<
@@ -20,19 +25,17 @@ export class GetConversationTool extends LinkedApiTool<
   }: {
     linkedapi: LinkedApi;
     args: { personUrl: string; since?: string };
-    workflowTimeout: number;
-    progressToken?: string | number;
-  }): Promise<TMappedResponse<TConversationPollResult>> {
-    const conversations = await this.getConversation(linkedapi, personUrl, since);
+  }): Promise<TMappedResponse<TConversationPollResult> | TWorkflowAck> {
+    const conversations = await this.pollConversation(linkedapi, personUrl, since);
     if (conversations.errors.length === 0) {
       return conversations;
     }
-    const workflowId = await linkedapi.syncConversation.execute({ personUrl });
-    await linkedapi.syncConversation.result(workflowId);
-    return await this.getConversation(linkedapi, personUrl, since);
+    const ack = await linkedapi.syncConversation.execute({ personUrl });
+    return { ...ack,
+operationName: OPERATION_NAME.syncConversation };
   }
 
-  private async getConversation(
+  private async pollConversation(
     linkedapi: LinkedApi,
     personUrl: string,
     since?: string,
@@ -54,7 +57,7 @@ export class GetConversationTool extends LinkedApiTool<
     return {
       name: this.name,
       description:
-        'Allows you to get a conversation with a LinkedIn person using standard LinkedIn messaging.',
+        'Retrieve a conversation with a LinkedIn person via standard LinkedIn messaging. Returns the conversation immediately if it has already been synced. If the conversation has not been synced yet, this tool starts a syncConversation workflow and returns its ack ({status, workflowId, operationName: "syncConversation", message}); the client should call get_workflow_result with that workflowId until completion, then call get_conversation again to read the synced messages.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/get-workflow-result.ts

@@ -1,13 +1,24 @@
-import LinkedApi, { OPERATION_NAME, TMappedResponse } from '@linkedapi/node';
+import LinkedApi, {
+  Operation,
+  OPERATION_NAME,
+  TMappedResponse,
+  TOperationName,
+  TWorkflowInProgressResponse,
+} from '@linkedapi/node';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import z from 'zod';
 
-import { executeWithProgress } from '../utils/execute-with-progress.js';
+import type { TWorkflowAck } from '../types/linked-api-tool-result.type.js';
+import { defineRequestTimeoutInSeconds } from '../utils/define-request-timeout.js';
 import { LinkedApiTool } from '../utils/linked-api-tool.js';
 
+const POLL_INTERVAL_MS = 5000 as const;
+const REQUEST_BUDGET_BUFFER_SECONDS = 5 as const;
+
 interface IGetWorkflowResultParams {
   workflowId: string;
   operationName: string;
+  waitSeconds?: number;
 }
 
 export class GetWorkflowResultTool extends LinkedApiTool<IGetWorkflowResultParams, unknown> {
@@ -15,44 +26,66 @@ export class GetWorkflowResultTool extends LinkedApiTool<IGetWorkflowResultParam
   protected readonly schema = z.object({
     workflowId: z.string(),
     operationName: z.enum(Object.values(OPERATION_NAME)),
+    waitSeconds: z.number().int().min(0).optional(),
   });
 
   public override async execute({
     linkedapi,
-    args: { workflowId, operationName },
-    workflowTimeout,
-    progressToken,
+    args: { workflowId, operationName, waitSeconds },
+    mcpClient,
   }: {
     linkedapi: LinkedApi;
     args: IGetWorkflowResultParams;
-    workflowTimeout: number;
-    progressToken?: string | number;
-  }): Promise<TMappedResponse<unknown>> {
+    mcpClient: string;
+  }): Promise<TMappedResponse<unknown> | TWorkflowAck> {
+    const typedOperationName = operationName as TOperationName;
     const operation = linkedapi.operations.find(
-      (operation) => operation.operationName === operationName,
-    )!;
-    return await executeWithProgress(this.progressCallback, operation, workflowTimeout, {
-      workflowId,
-      progressToken,
-    });
+      (operation) => operation.operationName === typedOperationName,
+    )! as Operation<unknown, unknown>;
+
+    const cap = Math.max(
+      defineRequestTimeoutInSeconds(mcpClient) - REQUEST_BUDGET_BUFFER_SECONDS,
+      0,
+    );
+    const budgetSeconds = Math.min(waitSeconds ?? cap, cap);
+    const deadline = Date.now() + budgetSeconds * 1000;
+
+    while (true) {
+      const status = await operation.status(workflowId);
+      if (!isWorkflowInProgress(status)) {
+        return status;
+      }
+      const remainingMs = deadline - Date.now();
+      if (remainingMs <= 0) {
+        return { ...status,
+workflowId,
+operationName: typedOperationName };
+      }
+      await sleep(Math.min(POLL_INTERVAL_MS, remainingMs));
+    }
   }
 
   public override getTool(): Tool {
     return {
       name: this.name,
       description:
-        'CONTINUE LISTENING TO BACKGROUND WORKFLOW - THIS IS NORMAL OPERATION! Background workflows are OPTIMAL BEHAVIOR for Linked API operations and keep the MCP client responsive. When a workflow runs in the background, this tool should be used with the provided workflowId and operationName parameters to continue listening for updates. The workflow continues processing in the background while you wait. This is the STANDARD way Linked API works - background processing provides optimal user experience!',
+        'Check the current state of a previously started Linked API workflow. Returns the final result when the workflow has completed, otherwise returns the current in-progress snapshot ({status, workflowId, operationName, message}). The server long-polls up to waitSeconds while the workflow is still running; if the budget elapses without completion, the in-progress snapshot is returned and the client should call this tool again with the same workflowId and operationName.',
       inputSchema: {
         type: 'object',
         properties: {
           workflowId: {
             type: 'string',
-            description: 'The workflow ID provided in the background workflow status message',
+            description: 'Required. The workflow ID returned by the original Linked API tool call.',
           },
           operationName: {
             type: 'string',
             description:
-              'Optional function name for proper type restoration (provided in background workflow status if available)',
+              'Required. The operationName returned by the original Linked API tool call. Used to map the response to the right operation.',
+          },
+          waitSeconds: {
+            type: 'number',
+            description:
+              'Optional. Maximum seconds the server should wait for the workflow to complete before returning the current in-progress snapshot. Defaults to the maximum the current MCP client allows; pass 0 to get an immediate one-shot snapshot.',
           },
         },
         required: ['workflowId', 'operationName'],
@@ -60,3 +93,16 @@ export class GetWorkflowResultTool extends LinkedApiTool<IGetWorkflowResultParam
     };
   }
 }
+
+function isWorkflowInProgress(
+  result: TMappedResponse<unknown> | TWorkflowInProgressResponse,
+): result is TWorkflowInProgressResponse {
+  return (
+    'workflowStatus' in result &&
+    (result.workflowStatus === 'running' || result.workflowStatus === 'pending')
+  );
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/src/tools/nv-get-conversation.ts

@@ -1,7 +1,12 @@
-import LinkedApi, { TConversationPollResult, TMappedResponse } from '@linkedapi/node';
+import LinkedApi, {
+  OPERATION_NAME,
+  TConversationPollResult,
+  TMappedResponse,
+} from '@linkedapi/node';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import z from 'zod';
 
+import type { TWorkflowAck } from '../types/linked-api-tool-result.type.js';
 import { LinkedApiTool } from '../utils/linked-api-tool.js';
 
 export class NvGetConversationTool extends LinkedApiTool<
@@ -20,19 +25,17 @@ export class NvGetConversationTool extends LinkedApiTool<
   }: {
     linkedapi: LinkedApi;
     args: { personUrl: string; since?: string };
-    workflowTimeout: number;
-    progressToken?: string | number;
-  }): Promise<TMappedResponse<TConversationPollResult>> {
-    const conversations = await this.getConversation(linkedapi, personUrl, since);
+  }): Promise<TMappedResponse<TConversationPollResult> | TWorkflowAck> {
+    const conversations = await this.pollConversation(linkedapi, personUrl, since);
     if (conversations.errors.length === 0) {
       return conversations;
     }
-    const workflowId = await linkedapi.nvSyncConversation.execute({ personUrl });
-    await linkedapi.nvSyncConversation.result(workflowId);
-    return await this.getConversation(linkedapi, personUrl, since);
+    const ack = await linkedapi.nvSyncConversation.execute({ personUrl });
+    return { ...ack,
+operationName: OPERATION_NAME.nvSyncConversation };
   }
 
-  private async getConversation(
+  private async pollConversation(
     linkedapi: LinkedApi,
     personUrl: string,
     since?: string,
@@ -54,7 +57,7 @@ export class NvGetConversationTool extends LinkedApiTool<
     return {
       name: this.name,
       description:
-        'Allows you to get a conversation with a LinkedIn person using Sales Navigator messaging.',
+        'Retrieve a conversation with a LinkedIn person via Sales Navigator messaging. Returns the conversation immediately if it has already been synced. If the conversation has not been synced yet, this tool starts an nvSyncConversation workflow and returns its ack ({status, workflowId, operationName: "nvSyncConversation", message}); the client should call get_workflow_result with that workflowId until completion, then call nv_get_conversation again to read the synced messages.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/nv-send-message.ts

@@ -17,7 +17,7 @@ export class NvSendMessageTool extends OperationTool<TNvSendMessageParams, unkno
     return {
       name: this.name,
       description:
-        'Allows you to send a message to a person in Sales Navigator (nv.sendMessage action)',
+        'Allows you to send a message to a person in Sales Navigator (nv.sendMessage action). If this workflow is still running, do not retry this tool; retrying can send duplicate Sales Navigator messages to the same person.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/react-to-post.ts

@@ -17,7 +17,7 @@ export class ReactToPostTool extends OperationTool<TReactToPostParams, unknown>
     return {
       name: this.name,
       description:
-        'Allows you to react to a post using any available reaction type (st.reactToPost action).',
+        'Allows you to react to a post using any available reaction type (st.reactToPost action). If this workflow is still running, do not retry this tool; retrying can queue duplicate reaction attempts.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/remove-connection.ts

@@ -15,7 +15,7 @@ export class RemoveConnectionTool extends OperationTool<TRemoveConnectionParams,
     return {
       name: this.name,
       description:
-        'Allows you to remove a person from your connections (st.removeConnection action).',
+        'Allows you to remove a person from your connections (st.removeConnection action). If this workflow is still running, do not retry this tool; retrying can queue duplicate removal attempts for the same person.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/send-connection-request.ts

@@ -20,7 +20,7 @@ export class SendConnectionRequestTool extends OperationTool<
     return {
       name: this.name,
       description:
-        'Allows you to send a connection request to a person (st.sendConnectionRequest action).',
+        'Allows you to send a connection request to a person (st.sendConnectionRequest action). If this workflow is still running, do not retry this tool; retrying can queue duplicate connection request attempts for the same person.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/send-message.ts

@@ -15,7 +15,8 @@ export class SendMessageTool extends OperationTool<TSendMessageParams, unknown>
   public override getTool(): Tool {
     return {
       name: this.name,
-      description: 'Allows you to send a message to a person (st.sendMessage action).',
+      description:
+        'Allows you to send a message to a person (st.sendMessage action). If this workflow is still running, do not retry this tool; retrying can send duplicate messages to the same person.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/tools/withdraw-connection-request.ts

@@ -19,7 +19,7 @@ export class WithdrawConnectionRequestTool extends OperationTool<
     return {
       name: this.name,
       description:
-        'Allows you to withdraw the connection request sent to a person (st.withdrawConnectionRequest action).',
+        'Allows you to withdraw the connection request sent to a person (st.withdrawConnectionRequest action). If this workflow is still running, do not retry this tool; retrying can queue duplicate withdrawal attempts for the same person.',
       inputSchema: {
         type: 'object',
         properties: {

package/src/types/linked-api-tool-result.type.ts

@@ -0,0 +1,12 @@
+import type {
+  TMappedResponse,
+  TOperationName,
+  TWorkflowInProgressResponse,
+  TWorkflowStartedResponse,
+} from '@linkedapi/node';
+
+export type TWorkflowAck = (TWorkflowStartedResponse | TWorkflowInProgressResponse) & {
+  operationName: TOperationName;
+};
+
+export type TLinkedApiToolResult<TResult> = TWorkflowAck | TMappedResponse<TResult>;

package/src/utils/define-request-timeout.ts

@@ -1,16 +1,28 @@
 export function defineRequestTimeoutInSeconds(mcpClient: string): number {
-  const bigTimeout = 600;
+  const BIG_TIMEOUT = 600 as const;
+  const normalizedMcpClient = mcpClient.trim().toLowerCase();
 
-  console.error('mcpClient', mcpClient);
-  switch (mcpClient) {
+  switch (normalizedMcpClient) {
+    case 'codex':
+    case 'codex-cli':
+    case 'codex-desktop':
+    case 'openai-codex':
+      return BIG_TIMEOUT;
+    case 'claude-code':
+    case 'claude_code':
+    case 'claude code':
+      return BIG_TIMEOUT;
     case 'claude':
+    case 'claude-desktop':
+    case 'anthropic':
       return 180;
     case 'chatgpt':
+    case 'openai':
       return 50;
     case 'cursor':
     case 'vscode':
     case 'windsurf':
-      return bigTimeout;
+      return BIG_TIMEOUT;
     default:
       return 60;
   }

package/src/utils/handle-linked-api-error.ts

@@ -1,16 +1,8 @@
-import { LinkedApiError, LinkedApiWorkflowTimeoutError } from '@linkedapi/node';
+import { LinkedApiError } from '@linkedapi/node';
 
 import { authenticationPrompt } from '../prompts';
 
-export function handleLinkedApiError(error: LinkedApiError): object {
-  if (error instanceof LinkedApiWorkflowTimeoutError) {
-    const { message, workflowId, operationName } = error;
-    return {
-      message,
-      workflowId,
-      operationName,
-    };
-  }
+export function handleLinkedApiError(error: LinkedApiError): Record<string, unknown> {
   switch (error.type) {
     case 'identificationTokenRequired':
     case 'linkedApiTokenRequired':

package/src/utils/json-http-transport.ts

@@ -77,12 +77,13 @@ export class JsonHTTPServerTransport implements Transport {
   }
 
   async send(message: JSONRPCMessage, options?: TransportSendOptions): Promise<void> {
+    const isResponse = isJSONRPCResponse(message) || isJSONRPCError(message);
     let relatedId = options?.relatedRequestId;
-    if (isJSONRPCResponse(message) || isJSONRPCError(message)) {
+    if (isResponse) {
       relatedId = message.id;
     }
-    // If a related HTTP connection is pending, complete it with JSON
-    if (relatedId !== undefined) {
+    // If a related HTTP connection is pending, only final responses complete it.
+    if (isResponse && relatedId !== undefined) {
       const connId = this.requestIdToConn.get(relatedId);
       if (connId) {
         const ctx = this.connections.get(connId);

package/src/utils/linked-api-tool.ts

@@ -1,18 +1,18 @@
-import LinkedApi, { Operation, TMappedResponse, TOperationName } from '@linkedapi/node';
+import LinkedApi, { Operation, TOperationName } from '@linkedapi/node';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import { LinkedApiProgressNotification } from 'src/utils/types';
 import z from 'zod';
 
-import { executeWithProgress } from './execute-with-progress';
+import type { TLinkedApiToolResult, TWorkflowAck } from '../types/linked-api-tool-result.type.js';
+
+interface TLinkedApiToolExecuteOptions<TParams> {
+  linkedapi: LinkedApi;
+  args: TParams;
+  mcpClient: string;
+}
 
 export abstract class LinkedApiTool<TParams, TResult> {
   public abstract readonly name: string;
   protected abstract readonly schema: z.ZodSchema;
-  protected readonly progressCallback: (progress: LinkedApiProgressNotification) => void;
-
-  constructor(progressCallback: (progress: LinkedApiProgressNotification) => void) {
-    this.progressCallback = progressCallback;
-  }
 
   public abstract getTool(): Tool;
 
@@ -20,39 +20,23 @@ export abstract class LinkedApiTool<TParams, TResult> {
     return this.schema.parse(args) as TParams;
   }
 
-  public abstract execute({
-    linkedapi,
-    args,
-    workflowTimeout,
-    progressToken,
-  }: {
-    linkedapi: LinkedApi;
-    args: TParams;
-    workflowTimeout: number;
-    progressToken?: string | number;
-  }): Promise<TMappedResponse<TResult>>;
+  public abstract execute(
+    options: TLinkedApiToolExecuteOptions<TParams>,
+  ): Promise<TLinkedApiToolResult<TResult>>;
 }
 
 export abstract class OperationTool<TParams, TResult> extends LinkedApiTool<TParams, TResult> {
   public abstract readonly operationName: TOperationName;
 
-  public override execute({
+  public override async execute({
     linkedapi,
     args,
-    workflowTimeout,
-    progressToken,
-  }: {
-    linkedapi: LinkedApi;
-    args: TParams;
-    workflowTimeout: number;
-    progressToken?: string | number;
-  }): Promise<TMappedResponse<TResult>> {
+  }: TLinkedApiToolExecuteOptions<TParams>): Promise<TWorkflowAck> {
     const operation = linkedapi.operations.find(
       (operation) => operation.operationName === this.operationName,
     )! as Operation<TParams, TResult>;
-    return executeWithProgress(this.progressCallback, operation, workflowTimeout, {
-      params: args,
-      progressToken,
-    });
+    const response = await operation.execute(args);
+    return { ...response,
+operationName: this.operationName };
   }
 }

package/src/utils/types.ts

@@ -9,9 +9,3 @@ export interface ExtendedCallToolRequest extends CallToolRequest {
     };
   };
 }
-export interface LinkedApiProgressNotification {
-  progressToken?: string | number;
-  progress: number;
-  total?: number;
-  message?: string;
-}

package/dist/utils/execute-with-progress.d.ts

@@ -1,8 +0,0 @@
-import { Operation, TMappedResponse } from '@linkedapi/node';
-import { LinkedApiProgressNotification } from './types';
-export declare function executeWithProgress<TParams, TResult>(progressCallback: (progress: LinkedApiProgressNotification) => void, operation: Operation<TParams, TResult>, workflowTimeout: number, { params, workflowId, progressToken, }?: {
-    params?: TParams;
-    workflowId?: string;
-    progressToken?: string | number;
-}): Promise<TMappedResponse<TResult>>;
-//# sourceMappingURL=execute-with-progress.d.ts.map

package/dist/utils/execute-with-progress.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-with-progress.d.ts","sourceRoot":"","sources":["../../src/utils/execute-with-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5F,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAExD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EACxD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,6BAA6B,KAAK,IAAI,EACnE,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EACtC,eAAe,EAAE,MAAM,EACvB,EACE,MAAM,EACN,UAAU,EACV,aAAa,GACd,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAO,GACjF,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAqDnC"}

package/dist/utils/execute-with-progress.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeWithProgress = executeWithProgress;
-const node_1 = require("@linkedapi/node");
-async function executeWithProgress(progressCallback, operation, workflowTimeout, { params, workflowId, progressToken, } = {}) {
-    let progress = 0;
-    progressCallback({
-        progressToken,
-        progress,
-        total: 100,
-        message: `Starting workflow ${operation.operationName}...`,
-    });
-    const interval = setInterval(() => {
-        if (progress < 50) {
-            progress += 5;
-        }
-        else if (progress < 98) {
-            progress += 1;
-        }
-        progressCallback({
-            progressToken,
-            progress,
-            total: 100,
-            message: `Executing workflow ${operation.operationName}...`,
-        });
-    }, Math.max(workflowTimeout / 20, 10000));
-    try {
-        if (!workflowId) {
-            workflowId = await operation.execute(params);
-        }
-        const result = await operation.result(workflowId, {
-            timeout: workflowTimeout,
-        });
-        clearInterval(interval);
-        progressCallback({
-            progressToken,
-            progress: 100,
-            total: 100,
-            message: `Workflow ${operation.operationName} completed successfully`,
-        });
-        return result;
-    }
-    catch (error) {
-        clearInterval(interval);
-        if (error instanceof node_1.LinkedApiWorkflowTimeoutError) {
-            throw generateTimeoutError(error);
-        }
-        throw error;
-    }
-}
-function generateTimeoutError(error) {
-    const restoreMessage = `Workflow is running in the background. Continue listening for updates.
-
-ACTION REQUIRED (MCP CLIENT):
-- Do not retry the original tool; the workflow is already running
-- Call the get_workflow_result tool with the parameters below and keep listening until completion
-
-PARAMETERS TO USE:
-- workflowId: ${error.workflowId}
-- operationName: ${error.operationName}
-
-GENERIC MCP CALL EXAMPLE:
-{
-  "name": "get_workflow_result",
-  "arguments": {
-    "workflowId": "${error.workflowId}",
-    "operationName": "${error.operationName}"
-  }
-}
-
-Background processing keeps the MCP client responsive while the workflow completes.`;
-    error.message = restoreMessage;
-    return error;
-}
-//# sourceMappingURL=execute-with-progress.js.map

package/dist/utils/execute-with-progress.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-with-progress.js","sourceRoot":"","sources":["../../src/utils/execute-with-progress.ts"],"names":[],"mappings":";;AAIA,kDA8DC;AAlED,0CAA4F;AAIrF,KAAK,UAAU,mBAAmB,CACvC,gBAAmE,EACnE,SAAsC,EACtC,eAAuB,EACvB,EACE,MAAM,EACN,UAAU,EACV,aAAa,MACiE,EAAE;IAElF,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,gBAAgB,CAAC;QACf,aAAa;QACb,QAAQ;QACR,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,qBAAqB,SAAS,CAAC,aAAa,KAAK;KAC3D,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAC1B,GAAG,EAAE;QACH,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;YAClB,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;YACzB,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;QAED,gBAAgB,CAAC;YACf,aAAa;YACb,QAAQ;YACR,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,sBAAsB,SAAS,CAAC,aAAa,KAAK;SAC5D,CAAC,CAAC;IACL,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,EAAE,EAAE,KAAK,CAAC,CACtC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAiB,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE;YAChD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QACH,aAAa,CAAC,QAAQ,CAAC,CAAC;QAExB,gBAAgB,CAAC;YACf,aAAa;YACb,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,YAAY,SAAS,CAAC,aAAa,yBAAyB;SACtE,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxB,IAAI,KAAK,YAAY,oCAA6B,EAAE,CAAC;YACnD,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAoC;IAChE,MAAM,cAAc,GAAG;;;;;;;gBAOT,KAAK,CAAC,UAAU;mBACb,KAAK,CAAC,aAAa;;;;;;qBAMjB,KAAK,CAAC,UAAU;wBACb,KAAK,CAAC,aAAa;;;;oFAIyC,CAAC;IAEnF,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/utils/execute-with-progress.ts

@@ -1,93 +0,0 @@
-import { LinkedApiWorkflowTimeoutError, Operation, TMappedResponse } from '@linkedapi/node';
-
-import { LinkedApiProgressNotification } from './types';
-
-export async function executeWithProgress<TParams, TResult>(
-  progressCallback: (progress: LinkedApiProgressNotification) => void,
-  operation: Operation<TParams, TResult>,
-  workflowTimeout: number,
-  {
-    params,
-    workflowId,
-    progressToken,
-  }: { params?: TParams; workflowId?: string; progressToken?: string | number } = {},
-): Promise<TMappedResponse<TResult>> {
-  let progress = 0;
-
-  progressCallback({
-    progressToken,
-    progress,
-    total: 100,
-    message: `Starting workflow ${operation.operationName}...`,
-  });
-
-  const interval = setInterval(
-    () => {
-      if (progress < 50) {
-        progress += 5;
-      } else if (progress < 98) {
-        progress += 1;
-      }
-
-      progressCallback({
-        progressToken,
-        progress,
-        total: 100,
-        message: `Executing workflow ${operation.operationName}...`,
-      });
-    },
-    Math.max(workflowTimeout / 20, 10000),
-  );
-
-  try {
-    if (!workflowId) {
-      workflowId = await operation.execute(params as TParams);
-    }
-    const result = await operation.result(workflowId, {
-      timeout: workflowTimeout,
-    });
-    clearInterval(interval);
-
-    progressCallback({
-      progressToken,
-      progress: 100,
-      total: 100,
-      message: `Workflow ${operation.operationName} completed successfully`,
-    });
-
-    return result;
-  } catch (error) {
-    clearInterval(interval);
-    if (error instanceof LinkedApiWorkflowTimeoutError) {
-      throw generateTimeoutError(error);
-    }
-
-    throw error;
-  }
-}
-
-function generateTimeoutError(error: LinkedApiWorkflowTimeoutError) {
-  const restoreMessage = `Workflow is running in the background. Continue listening for updates.
-
-ACTION REQUIRED (MCP CLIENT):
-- Do not retry the original tool; the workflow is already running
-- Call the get_workflow_result tool with the parameters below and keep listening until completion
-
-PARAMETERS TO USE:
-- workflowId: ${error.workflowId}
-- operationName: ${error.operationName}
-
-GENERIC MCP CALL EXAMPLE:
-{
-  "name": "get_workflow_result",
-  "arguments": {
-    "workflowId": "${error.workflowId}",
-    "operationName": "${error.operationName}"
-  }
-}
-
-Background processing keeps the MCP client responsive while the workflow completes.`;
-
-  error.message = restoreMessage;
-  return error;
-}