@celigo/api-specs 0.2.224 → 0.2.226

package/dist/integration.yml

@@ -3867,8 +3867,137 @@ components:
                   - computeInstallURL
               options:
                 type: object
-                description: Free-form options used by installer logic for this step.
+                description: |-
+                  Options the installer logic reads for this step. Free-form, except
+                  that the MCP-server template install writes `mcpServerTemplate` on
+                  its `template_zip` step.
                 additionalProperties: true
+                properties:
+                  mcpServerTemplate:
+                    type: object
+                    additionalProperties: true
+                    description: |-
+                      Marks the `template_zip` step of the Integration that installing an
+                      MCP-server template creates when the template packs dependencies
+                      (`POST /v1/mcpservers/template`, or a Marketplace MCP listing); the
+                      server itself is created by this step's final save, not before.
+                      Written with the template's identity and connection shapes when the
+                      Integration is created, then extended with the step's checkpoint as
+                      the step runs, so a retry of a failed step reuses what an earlier
+                      attempt already created instead of creating it again. Completing the
+                      step creates the MCP server, disabled, and copies the template's
+                      resource files into this Integration's folder in Celigo Storage.
+                    properties:
+                      sourceIntegrationId:
+                        type: string
+                        format: objectId
+                        examples:
+                          - 6aea494c48fddac08b0d2509
+                        description: |-
+                          Integration document the template's resources belong to — the
+                          `integration.json` in the template ZIP. The Integration being
+                          installed is cloned from it (its `_sourceId`); it is not an
+                          Integration in this account.
+                      _templateId:
+                        type: string
+                        format: objectId
+                        x-celigo-refModel: templates
+                        examples:
+                          - 6ab129aeb9e4547494c0667f
+                        description: Marketplace template the install came from. Absent when the ZIP was uploaded directly.
+                      connectionShapes:
+                        type: array
+                        description: |-
+                          One entry per connection the template packs, read when the matching
+                          `connection` step binds or creates a connection: a connection the step
+                          creates receives the entry's `endUserProvidedFields`; an existing
+                          connection is updated only when the entry requires end-user
+                          credentials and the connection has no list of its own yet. When the
+                          entry requires end-user credentials, an existing connection of
+                          another `type` is refused.
+                        items:
+                          type: object
+                          properties:
+                            _id:
+                              type: string
+                              format: objectId
+                              examples:
+                                - 6ab5f08e3afef011468e9588
+                              description: The connection's id inside the template, matched against the `connection` step's `sourceConnection._id`.
+                            type:
+                              type: string
+                              examples:
+                                - http
+                              description: Connection type the step's connection must have when the entry requires end-user credentials.
+                            endUserProvidedFields:
+                              type: array
+                              items:
+                                type: string
+                              examples:
+                                - - http.encrypted.apiKey
+                              description: Dot-paths of the connection's fields each end user supplies on their own copy, as the template's publisher set them.
+                            requiresEndUserCredentials:
+                              type: boolean
+                              description: When true, the template's server requires every end user to supply their own credentials on this connection.
+                      mcpServerId:
+                        type: string
+                        format: objectId
+                        x-celigo-refModel: mcpservers
+                        examples:
+                          - 6ae967f559ba56599337bc8d
+                        description: |-
+                          Id reserved for the MCP server once the template's tools are created,
+                          before any resource file is uploaded. While the step is incomplete it
+                          is only a reservation — no server document exists under it until the
+                          step's final save; a retry returns the saved server without uploading
+                          again only when an earlier attempt already saved a server for this id.
+                      toolIdMap:
+                        type: object
+                        additionalProperties:
+                          type: string
+                          format: objectId
+                        examples:
+                          - 6ab1290000000000000000a1: 6ae967f559ba56599337bc01
+                        description: Tool id inside the template → id of the Tool the install created from it, written with `mcpServerId`; a retry reuses the created tools.
+                      apiIdMap:
+                        type: object
+                        additionalProperties:
+                          type: string
+                          format: objectId
+                        examples:
+                          - 6ab1290000000000000000b1: 6ae967f559ba56599337bc02
+                        description: API id inside the template → id of the API the install created from it, written with `toolIdMap`.
+                      resourceFileMap:
+                        type: object
+                        additionalProperties:
+                          type: string
+                          format: objectId
+                        examples:
+                          - 6a6baa4e6ac4879f0ac7febd: 6ae967f67daa705eb67aca8b
+                        description: |-
+                          Resource file entry in the template ZIP (`resources/<key>`) → id of its
+                          copy in this Integration's Celigo Storage folder. Written only after
+                          every copied file is active, so a retry that finds the map skips the
+                          upload; cleared, together with `createdFolderIds` and
+                          `createdFileIds`, before a failed attempt's files are removed.
+                      createdFolderIds:
+                        type: array
+                        items:
+                          type: string
+                          format: objectId
+                          x-celigo-refModel: storageitems
+                        examples:
+                          - - 6ae967f57daa705eb67aca88
+                        description: Storage folders the install created under this Integration's folder for the resource files' relative paths — the current checkpoint, cleared with `resourceFileMap` before a failed attempt's rollback and rewritten by the next attempt.
+                      createdFileIds:
+                        type: array
+                        items:
+                          type: string
+                          format: objectId
+                          x-celigo-refModel: storageitems
+                        examples:
+                          - - 6ae967f67daa705eb67aca8b
+                        description: Storage files the install has copied — the current checkpoint, cleared and rewritten the same way as `createdFolderIds`; the completed server serves them as its resources.
         uninstallSteps:
           type: array
           description: Ordered list of lifecycle steps used by the Integration App uninstaller.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.224",
+  "version": "0.2.226",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,7 +1,7 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "5dc67bf2",
+		"iasCommit": "a1befe22",
 		"generatedAt": "2026-11-03"
 	},
 	"roots": {
@@ -17,14 +17,14 @@
 		"flow": 542,
 		"iclient": 563,
 		"import": 667,
-		"integration": 683,
-		"lookupcache": 684,
-		"mcpoauthprovider": 687,
-		"mcpserver": 736,
-		"script": 737,
-		"stack": 744,
-		"sync": 754,
-		"tool": 770
+		"integration": 689,
+		"lookupcache": 690,
+		"mcpoauthprovider": 693,
+		"mcpserver": 742,
+		"script": 743,
+		"stack": 750,
+		"sync": 760,
+		"tool": 776
 	},
 	"defs": [
 		{
@@ -8172,6 +8172,84 @@
 				"url"
 			]
 		},
+		{
+			"t": [
+				"object"
+			],
+			"p": {
+				"_id": 0,
+				"endUserProvidedFields": 20,
+				"requiresEndUserCredentials": 8,
+				"type": 0
+			}
+		},
+		{
+			"t": [
+				"array"
+			],
+			"i": 674
+		},
+		{
+			"t": [
+				"object"
+			],
+			"p": {
+				"_templateId": 0,
+				"apiIdMap": 9,
+				"connectionShapes": 675,
+				"createdFileIds": 20,
+				"createdFolderIds": 20,
+				"mcpServerId": 0,
+				"resourceFileMap": 9,
+				"sourceIntegrationId": 0,
+				"toolIdMap": 9
+			},
+			"open": 1
+		},
+		{
+			"t": [
+				"object"
+			],
+			"p": {
+				"mcpServerTemplate": 676
+			},
+			"open": 1
+		},
+		{
+			"t": [
+				"object"
+			],
+			"p": {
+				"_connectionId": 0,
+				"_scriptId": 0,
+				"_stackId": 0,
+				"completed": 8,
+				"description": 0,
+				"form": 9,
+				"function": 0,
+				"getUrlFunction": 0,
+				"imageUrl": 0,
+				"initFormFunction": 0,
+				"isClone": 8,
+				"name": 0,
+				"options": 677,
+				"sourceConnection": 9,
+				"templateZip": 8,
+				"type": 673,
+				"url": 0
+			},
+			"open": 1,
+			"r": [
+				"name",
+				"type"
+			]
+		},
+		{
+			"t": [
+				"array"
+			],
+			"i": 678
+		},
 		{
 			"t": [
 				"object"
@@ -8205,7 +8283,7 @@
 			"t": [
 				"array"
 			],
-			"i": 674
+			"i": 680
 		},
 		{
 			"t": [
@@ -8236,7 +8314,7 @@
 			"t": [
 				"array"
 			],
-			"i": 677
+			"i": 683
 		},
 		{
 			"t": [
@@ -8254,7 +8332,7 @@
 			],
 			"p": {
 				"accountId": 0,
-				"environment": 679,
+				"environment": 685,
 				"integrationId": 0
 			}
 		},
@@ -8276,7 +8354,7 @@
 			"t": [
 				"array"
 			],
-			"i": 681
+			"i": 687
 		},
 		{
 			"t": [
@@ -8291,24 +8369,24 @@
 				"_registeredTopicIds": 20,
 				"_sourceId": 0,
 				"_templateId": 0,
-				"aliases": 682,
-				"apiGroupings": 678,
+				"aliases": 688,
+				"apiGroupings": 684,
 				"celigoAgentAutoRunMode": 8,
-				"changeEditionSteps": 675,
+				"changeEditionSteps": 681,
 				"childDisplayName": 0,
 				"createdAt": 0,
 				"deletedAt": 88,
 				"description": 88,
-				"flowGroupings": 678,
+				"flowGroupings": 684,
 				"iLMIgnore": 9,
 				"initChild": 672,
 				"install": 669,
-				"installSteps": 675,
+				"installSteps": 679,
 				"lastModified": 0,
 				"mode": 670,
 				"name": 0,
-				"netSuiteDistributedAdaptor": 680,
-				"pendingLicense": 676,
+				"netSuiteDistributedAdaptor": 686,
+				"pendingLicense": 682,
 				"preSave": 104,
 				"readme": 88,
 				"resolvedAt": 0,
@@ -8317,7 +8395,7 @@
 				"settingsForm": 671,
 				"syncs": 8,
 				"tag": 88,
-				"uninstallSteps": 675,
+				"uninstallSteps": 681,
 				"update": 672,
 				"updateInProgress": 8,
 				"version": 88
@@ -8377,7 +8455,7 @@
 			"t": [
 				"array"
 			],
-			"i": 685
+			"i": 691
 		},
 		{
 			"t": [
@@ -8395,7 +8473,7 @@
 				"issuerURL": 0,
 				"lastModified": 0,
 				"name": 0,
-				"scopes": 686,
+				"scopes": 692,
 				"useIntrospection": 8
 			},
 			"r": [
@@ -8424,7 +8502,7 @@
 			"t": [
 				"array"
 			],
-			"i": 688
+			"i": 694
 		},
 		{
 			"t": [
@@ -8432,10 +8510,10 @@
 			],
 			"p": {
 				"_toolId": 0,
-				"annotations": 691,
+				"annotations": 697,
 				"disabled": 8,
 				"name": 0,
-				"overrides": 692
+				"overrides": 698
 			},
 			"r": [
 				"_toolId",
@@ -8459,10 +8537,10 @@
 				"object"
 			],
 			"p": {
-				"connections": 694,
-				"exports": 698,
-				"imports": 700,
-				"routers": 704
+				"connections": 700,
+				"exports": 704,
+				"imports": 706,
+				"routers": 710
 			}
 		},
 		{
@@ -8483,7 +8561,7 @@
 			"t": [
 				"array"
 			],
-			"i": 693
+			"i": 699
 		},
 		{
 			"t": [
@@ -8520,9 +8598,9 @@
 				"_id": 0,
 				"pageSize": 4,
 				"proceedOnFailure": 8,
-				"responseMapping": 696,
+				"responseMapping": 702,
 				"skipRetries": 8,
-				"type": 695
+				"type": 701
 			},
 			"r": [
 				"_abstractId"
@@ -8532,7 +8610,7 @@
 			"t": [
 				"array"
 			],
-			"i": 697
+			"i": 703
 		},
 		{
 			"t": [
@@ -8543,7 +8621,7 @@
 				"_connectionId": 0,
 				"hooks": 205,
 				"proceedOnFailure": 8,
-				"responseMapping": 696
+				"responseMapping": 702
 			},
 			"r": [
 				"_abstractId"
@@ -8553,7 +8631,7 @@
 			"t": [
 				"array"
 			],
-			"i": 699
+			"i": 705
 		},
 		{
 			"t": [
@@ -8570,7 +8648,7 @@
 			"t": [
 				"array"
 			],
-			"i": 701
+			"i": 707
 		},
 		{
 			"t": [
@@ -8578,7 +8656,7 @@
 			],
 			"p": {
 				"_abstractId": 0,
-				"branches": 702,
+				"branches": 708,
 				"name": 0,
 				"routeRecordsTo": 510,
 				"routeRecordsUsing": 174,
@@ -8592,13 +8670,13 @@
 			"t": [
 				"array"
 			],
-			"i": 703
+			"i": 709
 		},
 		{
 			"t": [
 				"array"
 			],
-			"i": 690
+			"i": 696
 		},
 		{
 			"t": [
@@ -8618,7 +8696,7 @@
 			"t": [
 				"array"
 			],
-			"i": 706
+			"i": 712
 		},
 		{
 			"t": [
@@ -8638,7 +8716,7 @@
 			"t": [
 				"array"
 			],
-			"i": 708
+			"i": 714
 		},
 		{
 			"t": [
@@ -8646,10 +8724,10 @@
 			],
 			"p": {
 				"_id": 0,
-				"arguments": 712,
+				"arguments": 718,
 				"description": 0,
 				"disabled": 8,
-				"messagesTemplate": 716,
+				"messagesTemplate": 722,
 				"mockInput": 41,
 				"name": 0,
 				"title": 0
@@ -8676,17 +8754,17 @@
 			"t": [
 				"array"
 			],
-			"i": 711
+			"i": 717
 		},
 		{
 			"t": [
 				"object"
 			],
 			"p": {
-				"contentType": 715,
+				"contentType": 721,
 				"data": 0,
 				"mimeType": 0,
-				"role": 714,
+				"role": 720,
 				"template": 0
 			},
 			"r": [
@@ -8717,13 +8795,13 @@
 			"t": [
 				"array"
 			],
-			"i": 713
+			"i": 719
 		},
 		{
 			"t": [
 				"array"
 			],
-			"i": 710
+			"i": 716
 		},
 		{
 			"t": [
@@ -8735,7 +8813,7 @@
 				"_promptIds": 20,
 				"_resourceIds": 20,
 				"_toolIds": 20,
-				"accessLevel": 719,
+				"accessLevel": 725,
 				"description": 0,
 				"name": 0
 			},
@@ -8756,7 +8834,7 @@
 			"t": [
 				"array"
 			],
-			"i": 718
+			"i": 724
 		},
 		{
 			"t": [
@@ -8765,12 +8843,12 @@
 			"p": {
 				"_connectionId": 0,
 				"alias": 0,
-				"discoveryStatus": 722,
+				"discoveryStatus": 728,
 				"lastDiscoveredAt": 0,
 				"name": 0,
-				"prompts": 725,
-				"resources": 727,
-				"tools": 725
+				"prompts": 731,
+				"resources": 733,
+				"tools": 731
 			},
 			"r": [
 				"_connectionId"
@@ -8792,14 +8870,14 @@
 			],
 			"p": {
 				"_id": 0,
-				"annotations": 691,
+				"annotations": 697,
 				"approvedDefinitionHash": 0,
 				"changedSinceApproval": 8,
 				"description": 0,
 				"disabled": 8,
 				"discoveredAt": 0,
 				"name": 0,
-				"overrides": 724,
+				"overrides": 730,
 				"title": 0,
 				"unavailable": 8,
 				"upstreamName": 0
@@ -8813,7 +8891,7 @@
 				"object"
 			],
 			"p": {
-				"annotations": 691,
+				"annotations": 697,
 				"description": 0,
 				"name": 0,
 				"title": 0
@@ -8823,7 +8901,7 @@
 			"t": [
 				"array"
 			],
-			"i": 723
+			"i": 729
 		},
 		{
 			"t": [
@@ -8831,14 +8909,14 @@
 			],
 			"p": {
 				"_id": 0,
-				"annotations": 691,
+				"annotations": 697,
 				"approvedDefinitionHash": 0,
 				"changedSinceApproval": 8,
 				"description": 0,
 				"disabled": 8,
 				"discoveredAt": 0,
 				"name": 0,
-				"overrides": 724,
+				"overrides": 730,
 				"title": 0,
 				"unavailable": 8,
 				"upstreamName": 0,
@@ -8852,23 +8930,23 @@
 			"t": [
 				"array"
 			],
-			"i": 726
+			"i": 732
 		},
 		{
 			"t": [
 				"array"
 			],
-			"i": 721
+			"i": 727
 		},
 		{
 			"t": [
 				"object"
 			],
 			"p": {
-				"config": 733,
+				"config": 739,
 				"enabled": 8,
 				"name": 0,
-				"type": 730
+				"type": 736
 			},
 			"r": [
 				"config",
@@ -8911,10 +8989,10 @@
 				"object"
 			],
 			"p": {
-				"keyResolver": 732,
+				"keyResolver": 738,
 				"limit": 120,
 				"periodTime": 120,
-				"periodTimeUnit": 731
+				"periodTimeUnit": 737
 			},
 			"r": [
 				"limit",
@@ -8926,7 +9004,7 @@
 			"t": [
 				"array"
 			],
-			"i": 729
+			"i": 735
 		},
 		{
 			"t": [
@@ -8938,7 +9016,7 @@
 				"clientId": 88,
 				"clientSecret": 88,
 				"issuerURL": 0,
-				"scopes": 686,
+				"scopes": 692,
 				"useCeligoOauth": 8,
 				"useIntrospection": 8
 			}
@@ -8952,8 +9030,8 @@
 				"_networkPolicyId": 88,
 				"_templateId": 0,
 				"_userId": 0,
-				"apis": 707,
-				"connections": 689,
+				"apis": 713,
+				"connections": 695,
 				"createdAt": 0,
 				"deletedAt": 88,
 				"description": 0,
@@ -8963,14 +9041,14 @@
 				"enabledItemCount": 120,
 				"lastModified": 0,
 				"name": 0,
-				"oauth": 735,
-				"permissionSets": 720,
-				"policies": 734,
-				"prompts": 717,
+				"oauth": 741,
+				"permissionSets": 726,
+				"policies": 740,
+				"prompts": 723,
 				"relativeURI": 0,
-				"resources": 709,
-				"tools": 705,
-				"upstreamMcpConnections": 728
+				"resources": 715,
+				"tools": 711,
+				"upstreamMcpConnections": 734
 			},
 			"r": [
 				"_id",
@@ -9069,9 +9147,9 @@
 			],
 			"p": {
 				"accessKeyId": 0,
-				"awsRegion": 741,
+				"awsRegion": 747,
 				"functionName": 0,
-				"language": 742,
+				"language": 748,
 				"secretAccessKey": 0
 			},
 			"r": [
@@ -9088,12 +9166,12 @@
 			"p": {
 				"_id": 0,
 				"createdAt": 0,
-				"framework": 739,
-				"lambda": 743,
+				"framework": 745,
+				"lambda": 749,
 				"lastModified": 0,
 				"name": 0,
-				"server": 740,
-				"type": 738
+				"server": 746,
+				"type": 744
 			},
 			"r": [
 				"_id",
@@ -9130,8 +9208,8 @@
 				"object"
 			],
 			"p": {
-				"dataset": 750,
-				"element": 751
+				"dataset": 756,
+				"element": 757
 			}
 		},
 		{
@@ -9156,8 +9234,8 @@
 				"object"
 			],
 			"p": {
-				"added": 748,
-				"removed": 749
+				"added": 754,
+				"removed": 755
 			}
 		},
 		{
@@ -9165,12 +9243,12 @@
 				"object"
 			],
 			"p": {
-				"added": 748,
-				"arrayAdded": 753,
-				"expanded": 749,
-				"objectAdded": 752,
-				"reduced": 749,
-				"removed": 749
+				"added": 754,
+				"arrayAdded": 759,
+				"expanded": 755,
+				"objectAdded": 758,
+				"reduced": 755,
+				"removed": 755
 			}
 		},
 		{
@@ -9200,13 +9278,13 @@
 				"_integrationId": 0,
 				"_userId": 0,
 				"description": 0,
-				"destination": 746,
+				"destination": 752,
 				"disabled": 8,
-				"driftPolicy": 747,
+				"driftPolicy": 753,
 				"historicDateTime": 0,
 				"name": 0,
 				"schedule": 0,
-				"source": 745,
+				"source": 751,
 				"timezone": 0
 			},
 			"r": [
@@ -9232,7 +9310,7 @@
 				"schema": 9,
 				"schemaMode": 34,
 				"traceKeyTemplate": 180,
-				"transform": 756
+				"transform": 762
 			}
 		},
 		{
@@ -9240,7 +9318,7 @@
 				"object"
 			],
 			"p": {
-				"expression": 762,
+				"expression": 768,
 				"script": 104,
 				"type": 99
 			}
@@ -9249,14 +9327,14 @@
 			"t": [
 				"array"
 			],
-			"i": 758
+			"i": 764
 		},
 		{
 			"t": [
 				"object"
 			],
 			"p": {
-				"buildArrayHelper": 760,
+				"buildArrayHelper": 766,
 				"conditional": 97,
 				"dataType": 87,
 				"default": 88,
@@ -9269,7 +9347,7 @@
 				"generateDateTimezone": 0,
 				"hardCodedValue": 88,
 				"lookupName": 0,
-				"mappings": 757,
+				"mappings": 763,
 				"sourceDataType": 89,
 				"status": 95
 			},
@@ -9285,7 +9363,7 @@
 				"conditional": 92,
 				"default": 88,
 				"extract": 0,
-				"mappings": 757,
+				"mappings": 763,
 				"name": 0,
 				"sourceDataType": 89
 			}
@@ -9294,7 +9372,7 @@
 			"t": [
 				"array"
 			],
-			"i": 759
+			"i": 765
 		},
 		{
 			"t": [
@@ -9303,7 +9381,7 @@
 			"p": {
 				"inputContext": 98,
 				"lookups": 114,
-				"mappings": 757,
+				"mappings": 763,
 				"mode": 110
 			}
 		},
@@ -9313,7 +9391,7 @@
 			],
 			"p": {
 				"rules": 109,
-				"rulesTwoDotZero": 761,
+				"rulesTwoDotZero": 767,
 				"version": 106
 			}
 		},
@@ -9325,8 +9403,8 @@
 				"debugUntil": 0,
 				"description": 0,
 				"hooks": 205,
-				"lookups": 765,
-				"mappings": 757,
+				"lookups": 771,
+				"mappings": 763,
 				"mockInput": 9,
 				"name": 0,
 				"schema": 9,
@@ -9348,14 +9426,14 @@
 			"t": [
 				"array"
 			],
-			"i": 764
+			"i": 770
 		},
 		{
 			"t": [
 				"object"
 			],
 			"p": {
-				"branches": 768,
+				"branches": 774,
 				"id": 0,
 				"name": 0,
 				"routeRecordsTo": 173,
@@ -9380,13 +9458,13 @@
 			"t": [
 				"array"
 			],
-			"i": 767
+			"i": 773
 		},
 		{
 			"t": [
 				"array"
 			],
-			"i": 766
+			"i": 772
 		},
 		{
 			"t": [
@@ -9402,11 +9480,11 @@
 				"description": 0,
 				"draft": 8,
 				"draftExpiresAt": 0,
-				"input": 755,
+				"input": 761,
 				"lastModified": 0,
 				"name": 0,
-				"output": 763,
-				"routers": 769
+				"output": 769,
+				"routers": 775
 			},
 			"r": [
 				"_id",