@celigo/api-specs 0.2.162 → 0.2.163

package/dist/ai-agent.yml

@@ -1299,7 +1299,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:

package/dist/export.yml

@@ -628,16 +628,19 @@ paths:
         - Exports
       summary: Invoke an export and return its data
       description: |-
-        Runs an existing export end-to-end and returns the fetched data (or errors)
+        Runs an existing export end-to-end and returns its records (or errors)
         synchronously. Unlike `POST /v1/flows/{_id}/run`, which starts a full flow
         job, this endpoint invokes a **single export** in isolation and returns the
-        raw result directly in the response body.
+        result directly in the response body.
 
         The request body is optional — pass `{}` or omit the body entirely for
         exports that require no input. Some adaptor types accept a `data` array in
         the body to supply input records.
 
-        On success, the response contains the export's fetched data. On
+        On success, the response contains the records as the export hands them
+        on: after its transform, output filter and preSavePage hook, so records
+        come back in their final shape and records the filter or hook drops aren't
+        returned. On
         application-level failure (e.g. the source system is unreachable), the
         endpoint still returns a successful HTTP status with the errors in an
         `errors` array — higher-level error codes are reserved for request-level
@@ -688,7 +691,8 @@ paths:
       responses:
         '200':
           description: |-
-            Export completed. The response contains either the fetched data or an
+            Export completed. The response contains either the export's records
+            (after its transform, output filter and preSavePage hook) or an
             `errors` array if the export encountered application-level failures
             (connection timeout, file not found, etc.). Always inspect for errors
             even on 200.
@@ -1340,11 +1344,11 @@ components:
     Once:
       type: object
       description: |-
-        Configures flag-based exports that process each record exactly once. Required when the
-        export's type is "once"; omit for other export types. Each run retrieves records where the
-        tracking boolean field is false, then sets that field to true after successful processing so
-        later runs skip them; if a run fails, the flags are left unchanged and the records are
-        retried automatically on the next run.
+        Configures flag-based exports that skip records an earlier run already processed. Required
+        when the export's type is "once"; omit for other export types. Each run retrieves records
+        where the tracking boolean field is false, then sets that field to true after successful
+        processing so later runs skip them; if a run fails, the flags are left unchanged and the
+        records are retried automatically on the next run.
       x-celigo-ai-guidance:
         - |-
           This object is REQUIRED when the export's type field is set to "once" and should
@@ -1369,7 +1373,6 @@ components:
               - One-time migrations where data should not be duplicated
               - Processing queues where records are marked as "processed"
               - Compliance scenarios requiring audit trails of exported records
-              - Implementing exactly-once delivery semantics
         - |-
           4. Error handling behavior:
               - If the export fails, the boolean fields remain unchanged
@@ -16523,6 +16526,8 @@ components:
           description: |-
             Custom JavaScript hooks that run at fixed points in the export lifecycle for
             transformations, validation, and filtering beyond what configuration alone can express.
+            A hook name not listed here (an import's `preMap`, for example) is dropped on save
+            without an error, so read `hooks` back after saving.
           properties:
             preSavePage:
               type: object

package/dist/guardrail.yml

@@ -997,7 +997,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:

package/dist/iclient.yml

@@ -318,8 +318,9 @@ paths:
       x-internal: false
       summary: Update an iClient
       description: |-
-        Replaces an iClient. All mutable fields must be provided — omitted
-        fields are reset to defaults. Secrets returned as `"******"` can be
+        Replaces an existing iClient; create one with `POST /v1/iclients`. All
+        mutable fields must be provided — omitted fields are reset to defaults.
+        Secrets returned as `"******"` can be
         sent back as-is to keep the existing value, except a Google service
         account: every update must include the full JSON key. An Azure
         service principal keeps its stored `clientSecret` or `certificate`

package/dist/import.yml

@@ -9681,7 +9681,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:
@@ -11072,7 +11072,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:

package/dist/tool.yml

@@ -21194,7 +21194,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:
@@ -22585,7 +22585,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:
@@ -26445,11 +26445,11 @@ components:
     Once:
       type: object
       description: |-
-        Configures flag-based exports that process each record exactly once. Required when the
-        export's type is "once"; omit for other export types. Each run retrieves records where the
-        tracking boolean field is false, then sets that field to true after successful processing so
-        later runs skip them; if a run fails, the flags are left unchanged and the records are
-        retried automatically on the next run.
+        Configures flag-based exports that skip records an earlier run already processed. Required
+        when the export's type is "once"; omit for other export types. Each run retrieves records
+        where the tracking boolean field is false, then sets that field to true after successful
+        processing so later runs skip them; if a run fails, the flags are left unchanged and the
+        records are retried automatically on the next run.
       x-celigo-ai-guidance:
         - |-
           This object is REQUIRED when the export's type field is set to "once" and should
@@ -26474,7 +26474,6 @@ components:
               - One-time migrations where data should not be duplicated
               - Processing queues where records are marked as "processed"
               - Compliance scenarios requiring audit trails of exported records
-              - Implementing exactly-once delivery semantics
         - |-
           4. Error handling behavior:
               - If the export fails, the boolean fields remain unchanged
@@ -37708,6 +37707,8 @@ components:
           description: |-
             Custom JavaScript hooks that run at fixed points in the export lifecycle for
             transformations, validation, and filtering beyond what configuration alone can express.
+            A hook name not listed here (an import's `preMap`, for example) is dropped on save
+            without an error, so read `hooks` back after saving.
           properties:
             preSavePage:
               type: object

package/package.json

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