@celigo/api-specs 0.2.60 → 0.2.62

package/dist/api.yml

@@ -4903,7 +4903,9 @@ components:
                 Dot-paths of this connection's fields (for example `http.encrypted.apiKey` or
                 `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead
                 of inheriting the parent's value. Only returned on a `standard` connection that has
-                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`.
+                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`;
+                by the platform contract, a write that changes the list invalidates the children end
+                users already hold against this parent.
               examples:
                 - - http.encrypted.apiKey
                   - http.unencrypted.accountId

package/dist/connection.yml

@@ -3228,7 +3228,9 @@ components:
                 Dot-paths of this connection's fields (for example `http.encrypted.apiKey` or
                 `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead
                 of inheriting the parent's value. Only returned on a `standard` connection that has
-                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`.
+                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`;
+                by the platform contract, a write that changes the list invalidates the children end
+                users already hold against this parent.
               examples:
                 - - http.encrypted.apiKey
                   - http.unencrypted.accountId
@@ -8286,7 +8288,10 @@ components:
             `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead of
             inheriting the parent's value. Set it on the parent connection an MCP server collects
             end-user credentials for; omit it everywhere else. Omitting it (or sending `[]`) on
-            `PUT` keeps the stored paths; send `null` to clear them.
+            `PUT` keeps the stored paths; send `null` to clear them. By the platform contract,
+            changing the stored list — adding, removing, or clearing paths — invalidates the
+            `mcpChild` connections end users already hold against this parent, so each of them
+            sets up again through the MCP setup page before tools that use it run for them.
           x-celigo-ai-guidance:
             - |-
               List only the credential and tenant fields that differ per end user, never a path the

package/dist/enduser.yml

@@ -2213,7 +2213,9 @@ components:
                 Dot-paths of this connection's fields (for example `http.encrypted.apiKey` or
                 `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead
                 of inheriting the parent's value. Only returned on a `standard` connection that has
-                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`.
+                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`;
+                by the platform contract, a write that changes the list invalidates the children end
+                users already hold against this parent.
               examples:
                 - - http.encrypted.apiKey
                   - http.unencrypted.accountId

package/dist/export.yml

@@ -16555,6 +16555,45 @@ components:
                   example:
                     threshold: 100
                     prefix: EXP-
+            preParse:
+              type: object
+              x-celigo-agent:
+                - script
+              description: |-
+                Hook that runs on file-based exports after the file is downloaded and before it is
+                parsed: it receives the raw file text as `preParseData` together with `fileMeta` and
+                returns both, modified or not, for the configured parser to read. Used to normalize a
+                non-standard file — fix a header row, strip a preamble, convert a format — before
+                parsing; an exception thrown here fails the run.
+              properties:
+                function:
+                  type: string
+                  description: Function to invoke within the referenced script.
+                  examples:
+                    - fixHeader
+                    - normalizeFile
+                    - convertToCsv
+                _scriptId:
+                  type: string
+                  format: objectId
+                  x-celigo-refModel: scripts
+                  description: Script containing the hook function named in `function`.
+                  examples:
+                    - 60a2c4e6f321d800129a1a3c
+                    - 5f8e7d2c1b54e6003a9c7e12
+                _stackId:
+                  type: string
+                  x-celigo-refModel: stacks
+                  format: objectId
+                  description: Stack that hosts the hook logic, used instead of a script for stack-based deployments.
+                configuration:
+                  type: object
+                  description: |-
+                    Static parameters passed to the hook function at runtime, letting one script be
+                    reused across exports with different settings.
+                  example:
+                    headerRow: 1
+                    encoding: utf8
         settingsForm:
           x-celigo-agent:
             - settings_form

package/dist/mcp-server.yml

@@ -4051,7 +4051,9 @@ components:
                 Dot-paths of this connection's fields (for example `http.encrypted.apiKey` or
                 `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead
                 of inheriting the parent's value. Only returned on a `standard` connection that has
-                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`.
+                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`;
+                by the platform contract, a write that changes the list invalidates the children end
+                users already hold against this parent.
               examples:
                 - - http.encrypted.apiKey
                   - http.unencrypted.accountId

package/dist/tool.yml

@@ -6652,7 +6652,9 @@ components:
                 Dot-paths of this connection's fields (for example `http.encrypted.apiKey` or
                 `rdbms.user`) that each MCP end user must supply on their own `mcpChild` copy instead
                 of inheriting the parent's value. Only returned on a `standard` connection that has
-                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`.
+                paths set; never returned on a child. Writable through `POST`, `PUT`, and `PATCH`;
+                by the platform contract, a write that changes the list invalidates the children end
+                users already hold against this parent.
               examples:
                 - - http.encrypted.apiKey
                   - http.unencrypted.accountId
@@ -36487,6 +36489,45 @@ components:
                   example:
                     threshold: 100
                     prefix: EXP-
+            preParse:
+              type: object
+              x-celigo-agent:
+                - script
+              description: |-
+                Hook that runs on file-based exports after the file is downloaded and before it is
+                parsed: it receives the raw file text as `preParseData` together with `fileMeta` and
+                returns both, modified or not, for the configured parser to read. Used to normalize a
+                non-standard file — fix a header row, strip a preamble, convert a format — before
+                parsing; an exception thrown here fails the run.
+              properties:
+                function:
+                  type: string
+                  description: Function to invoke within the referenced script.
+                  examples:
+                    - fixHeader
+                    - normalizeFile
+                    - convertToCsv
+                _scriptId:
+                  type: string
+                  format: objectId
+                  x-celigo-refModel: scripts
+                  description: Script containing the hook function named in `function`.
+                  examples:
+                    - 60a2c4e6f321d800129a1a3c
+                    - 5f8e7d2c1b54e6003a9c7e12
+                _stackId:
+                  type: string
+                  x-celigo-refModel: stacks
+                  format: objectId
+                  description: Stack that hosts the hook logic, used instead of a script for stack-based deployments.
+                configuration:
+                  type: object
+                  description: |-
+                    Static parameters passed to the hook function at runtime, letting one script be
+                    reused across exports with different settings.
+                  example:
+                    headerRow: 1
+                    encoding: utf8
         settingsForm:
           x-celigo-agent:
             - settings_form

package/package.json

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

package/schemas.json

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "618ea83",
-		"generatedAt": "2026-09-26"
+		"iasCommit": "f757489",
+		"generatedAt": "2026-09-28"
 	},
 	"roots": {
 		"aiagent": 133,
@@ -5224,6 +5224,7 @@
 				"object"
 			],
 			"p": {
+				"preParse": 445,
 				"preSavePage": 445
 			}
 		},