Sync period

Author: KirillSergeevich

package-lock.json

@@ -30,7 +30,7 @@
   "author": "Linked API",
   "license": "MIT",
   "dependencies": {
-    "@linkedapi/node": "^2.3.6",
+    "@linkedapi/node": "^2.3.7",
     "@modelcontextprotocol/sdk": "^1.17.4",
     "zod": "^4.1.1"
   },

package.json

@@ -57,7 +57,7 @@ operationName: OPERATION_NAME.syncConversation };
     return {
       name: this.name,
       description:
-        '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.',
+        '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. The result carries syncUntil — the moment syncing of this conversation stops. Once it is in the past the messages are still returned but no longer updated; call sync_conversation again for the same person to resume updates.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/get-conversation.ts

@@ -9,6 +9,7 @@ export class NvSyncConversationTool extends OperationTool<TNvSyncConversationPar
   public override readonly operationName = OPERATION_NAME.nvSyncConversation;
   protected override readonly schema = z.object({
     personUrl: z.string(),
+    days: z.number().int().min(1).max(90).optional(),
   });
 
   public override getTool(): Tool {
@@ -24,6 +25,11 @@ export class NvSyncConversationTool extends OperationTool<TNvSyncConversationPar
             description:
               "The LinkedIn URL of the person whose Sales Navigator conversation to sync (e.g., 'https://www.linkedin.com/in/john-doe')",
           },
+          days: {
+            type: 'number',
+            description:
+              'How many days the conversation stays synchronized, from 1 to 90. Defaults to 30. Counted from the moment the action starts running; a reply does not extend it. Syncing the same person again starts a new period and keeps the history already collected.',
+          },
         },
         required: ['personUrl'],
       },

src/tools/nv-sync-conversation.ts

@@ -9,6 +9,7 @@ export class SyncConversationTool extends OperationTool<TSyncConversationParams,
   public override readonly operationName = OPERATION_NAME.syncConversation;
   protected override readonly schema = z.object({
     personUrl: z.string(),
+    days: z.number().int().min(1).max(90).optional(),
   });
 
   public override getTool(): Tool {
@@ -24,6 +25,11 @@ export class SyncConversationTool extends OperationTool<TSyncConversationParams,
             description:
               "The LinkedIn URL of the person whose conversation you want to synchronize (e.g., 'https://www.linkedin.com/in/john-doe')",
           },
+          days: {
+            type: 'number',
+            description:
+              'How many days the conversation stays synchronized, from 1 to 90. Defaults to 30. Counted from the moment the action starts running; a reply does not extend it. Syncing the same person again starts a new period and keeps the history already collected.',
+          },
         },
         required: ['personUrl'],
       },