@snokam/mcp-api 2.15.0 → 2.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/sales.json

@@ -1515,6 +1515,214 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunities": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List Salesforce Opportunities (open by default).",
+        "operationId": "ListSalesforceOpportunities",
+        "parameters": [
+          {
+            "name": "includeClosed",
+            "in": "query",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include closed opportunities (default false)."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Row cap, max 200 (default 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunity"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Batch-refresh the cached Salesforce state on every linked Snøkam tender.",
+        "operationId": "RefreshAllSalesforceLinks",
+        "responses": {
+          "200": {
+            "description": "Payload of SalesforceRefreshResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salesforceRefreshResult"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
+        "parameters": [
+          {
+            "name": "sfId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the tender.",
+        "operationId": "RefreshTenderSalesforceLink",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/stats": {
       "get": {
         "tags": [
@@ -1834,6 +2042,97 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/reingest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
+        "operationId": "ReingestTender",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/jobs": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Recent agent jobs (ingestion, CV matching, …) for a tender — newest first.",
+        "operationId": "ListTenderJobs",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Max rows (default 10, capped at 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/agentJob"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/admin/tenders": {
       "delete": {
         "tags": [
@@ -2895,6 +3194,95 @@
         },
         "nullable": true
       },
+      "salesforceAttributes": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceOpportunity": {
+        "type": "object",
+        "properties": {
+          "attributes": {
+            "$ref": "#/components/schemas/salesforceAttributes"
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          },
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "StageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "CloseDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "Amount": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "Account": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Owner": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Snokam_Tender_Id__c": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "salesforceReference": {
+        "type": "object",
+        "properties": {
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceRefreshResult": {
+        "type": "object",
+        "properties": {
+          "checked": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "updated": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {
@@ -3005,6 +3393,9 @@
           "blobContainer": {
             "type": "string",
             "nullable": true
+          },
+          "salesforce": {
+            "$ref": "#/components/schemas/tenderSalesforce"
           }
         }
       },
@@ -3263,6 +3654,37 @@
         },
         "nullable": true
       },
+      "tenderSalesforce": {
+        "type": "object",
+        "properties": {
+          "opportunityId": {
+            "type": "string",
+            "nullable": true
+          },
+          "stageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "isClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          },
+          "lastSyncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "tenderSource": {
         "type": "object",
         "properties": {

package/specs/test/sales.json

@@ -1515,6 +1515,214 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunities": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List Salesforce Opportunities (open by default).",
+        "operationId": "ListSalesforceOpportunities",
+        "parameters": [
+          {
+            "name": "includeClosed",
+            "in": "query",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include closed opportunities (default false)."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Row cap, max 200 (default 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunity"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Batch-refresh the cached Salesforce state on every linked Snøkam tender.",
+        "operationId": "RefreshAllSalesforceLinks",
+        "responses": {
+          "200": {
+            "description": "Payload of SalesforceRefreshResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salesforceRefreshResult"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
+        "parameters": [
+          {
+            "name": "sfId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the tender.",
+        "operationId": "RefreshTenderSalesforceLink",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/stats": {
       "get": {
         "tags": [
@@ -1834,6 +2042,97 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/reingest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
+        "operationId": "ReingestTender",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/jobs": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Recent agent jobs (ingestion, CV matching, …) for a tender — newest first.",
+        "operationId": "ListTenderJobs",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Max rows (default 10, capped at 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/agentJob"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/admin/tenders": {
       "delete": {
         "tags": [
@@ -2895,6 +3194,95 @@
         },
         "nullable": true
       },
+      "salesforceAttributes": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceOpportunity": {
+        "type": "object",
+        "properties": {
+          "attributes": {
+            "$ref": "#/components/schemas/salesforceAttributes"
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          },
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "StageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "CloseDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "Amount": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "Account": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Owner": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Snokam_Tender_Id__c": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "salesforceReference": {
+        "type": "object",
+        "properties": {
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceRefreshResult": {
+        "type": "object",
+        "properties": {
+          "checked": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "updated": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {
@@ -3005,6 +3393,9 @@
           "blobContainer": {
             "type": "string",
             "nullable": true
+          },
+          "salesforce": {
+            "$ref": "#/components/schemas/tenderSalesforce"
           }
         }
       },
@@ -3263,6 +3654,37 @@
         },
         "nullable": true
       },
+      "tenderSalesforce": {
+        "type": "object",
+        "properties": {
+          "opportunityId": {
+            "type": "string",
+            "nullable": true
+          },
+          "stageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "isClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          },
+          "lastSyncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "tenderSource": {
         "type": "object",
         "properties": {