npm - @celigo/api-specs - Versions diffs - 0.2.68 → 0.2.70 - Mend

@celigo/api-specs 0.2.68 → 0.2.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/api.yml CHANGED Viewed

@@ -4856,12 +4856,24 @@ components:
               type: string
               format: objectId
               x-celigo-refModel: connections
-              description: |
-                Reference to another connection to share concurrency limits with.
-                When set, this connection's concurrency is counted against the referenced
-                connection's limit instead of maintaining its own.
+              description: |-
+                Reference to another connection to share concurrency limits with. When set, this
+                connection's traffic counts against the referenced connection's limit instead of its own,
+                and its own concurrency and auto-recovery settings have no effect. One level only: the
+                referenced connection may not itself borrow, and a connection that others borrow from
+                cannot start borrowing.
               examples:
                 - 615dfa0742763671275b70ab
+              x-celigo-ai-guidance:
+                - |-
+                  Set this when several connections target one external account whose API enforces a
+                  single account-wide concurrency limit (for example one NetSuite account): put the limit
+                  on one parent connection and point the others here, so their combined traffic can never
+                  exceed it.
+                - |-
+                  A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+                  borrower competes with the parent's own flows — settle the priority split before
+                  choosing who borrows from whom.
             debugDate:
               type: string
               format: date-time
@@ -5239,21 +5251,52 @@ components:
             Required for some authentication configurations to identify the calling application.
         concurrencyLevel:
           type: integer
-          description: |
-            General concurrency level for this connection. Controls the overall
-            maximum concurrent requests across all operation types.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+          description: |-
+            Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
+            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
+            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
+            APIs shares — all integrator.io connections to that account and every other client
+            calling those APIs from outside integrator.io (other integrations, third-party tools).
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              Before raising this connection's ceiling — `targetConcurrencyLevel` while
+              `autoRecoverRateLimitErrors` is on (the default; a PUT of `concurrencyLevel` then
+              changes nothing), `concurrencyLevel` only while it is off — total the ceilings of every
+              connection that targets the same NetSuite `account` and `environment` (a connection
+              that borrows counts under its parent) and keep that total, plus whatever calls the
+              account's APIs from outside integrator.io, within the NetSuite account limit; a value
+              that fits this connection alone can still push the whole account over.
+            - |-
+              The NetSuite limit is the service-tier base (Standard 5, Premium 15, Enterprise and
+              Ultimate 20; legacy tiers 5–20) plus 10 per SuiteCloud Plus license; a sandbox matches
+              its production account. Development and partner accounts are fixed at 5 and do not
+              scale with licenses. NetSuite shows the limit at Setup > Integration > Integration
+              Management > Integration Governance; integrator.io cannot read it — ask for the number
+              rather than assuming headroom.
+            - |-
+              Over the limit, NetSuite rejects requests from every caller of that account at once,
+              not only this connection's — SOAP: `ExceededConcurrentRequestLimitFault` /
+              `WS_REQUEST_BLOCKED`; REST web services: HTTP 429; RESTlets: HTTP 400
+              `SSS_REQUEST_LIMIT_EXCEEDED`. To run several connections against one NetSuite account,
+              put the limit on one parent and point the others at it with
+              `_borrowConcurrencyFromConnectionId`; otherwise raise in small steps.
         targetConcurrencyLevel:
           type: integer
-          description: |
+          description: |-
             Target concurrency level for auto-scaling. The system adjusts concurrency
             between 1 and this value based on rate limit and governance feedback.
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              With `autoRecoverRateLimitErrors` on, this is the level the connection climbs back to
+              after a recovery, so it — not `concurrencyLevel` — is the value that must fit the shared
+              NetSuite account budget described on `concurrencyLevel`.
         _iClientId:
           type: string
           format: objectId

package/dist/connection.yml CHANGED Viewed

@@ -3164,12 +3164,24 @@ components:
               type: string
               format: objectId
               x-celigo-refModel: connections
-              description: |
-                Reference to another connection to share concurrency limits with.
-                When set, this connection's concurrency is counted against the referenced
-                connection's limit instead of maintaining its own.
+              description: |-
+                Reference to another connection to share concurrency limits with. When set, this
+                connection's traffic counts against the referenced connection's limit instead of its own,
+                and its own concurrency and auto-recovery settings have no effect. One level only: the
+                referenced connection may not itself borrow, and a connection that others borrow from
+                cannot start borrowing.
               examples:
                 - 615dfa0742763671275b70ab
+              x-celigo-ai-guidance:
+                - |-
+                  Set this when several connections target one external account whose API enforces a
+                  single account-wide concurrency limit (for example one NetSuite account): put the limit
+                  on one parent connection and point the others here, so their combined traffic can never
+                  exceed it.
+                - |-
+                  A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+                  borrower competes with the parent's own flows — settle the priority split before
+                  choosing who borrows from whom.
             debugDate:
               type: string
               format: date-time
@@ -3547,21 +3559,52 @@ components:
             Required for some authentication configurations to identify the calling application.
         concurrencyLevel:
           type: integer
-          description: |
-            General concurrency level for this connection. Controls the overall
-            maximum concurrent requests across all operation types.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+          description: |-
+            Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
+            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
+            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
+            APIs shares — all integrator.io connections to that account and every other client
+            calling those APIs from outside integrator.io (other integrations, third-party tools).
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              Before raising this connection's ceiling — `targetConcurrencyLevel` while
+              `autoRecoverRateLimitErrors` is on (the default; a PUT of `concurrencyLevel` then
+              changes nothing), `concurrencyLevel` only while it is off — total the ceilings of every
+              connection that targets the same NetSuite `account` and `environment` (a connection
+              that borrows counts under its parent) and keep that total, plus whatever calls the
+              account's APIs from outside integrator.io, within the NetSuite account limit; a value
+              that fits this connection alone can still push the whole account over.
+            - |-
+              The NetSuite limit is the service-tier base (Standard 5, Premium 15, Enterprise and
+              Ultimate 20; legacy tiers 5–20) plus 10 per SuiteCloud Plus license; a sandbox matches
+              its production account. Development and partner accounts are fixed at 5 and do not
+              scale with licenses. NetSuite shows the limit at Setup > Integration > Integration
+              Management > Integration Governance; integrator.io cannot read it — ask for the number
+              rather than assuming headroom.
+            - |-
+              Over the limit, NetSuite rejects requests from every caller of that account at once,
+              not only this connection's — SOAP: `ExceededConcurrentRequestLimitFault` /
+              `WS_REQUEST_BLOCKED`; REST web services: HTTP 429; RESTlets: HTTP 400
+              `SSS_REQUEST_LIMIT_EXCEEDED`. To run several connections against one NetSuite account,
+              put the limit on one parent and point the others at it with
+              `_borrowConcurrencyFromConnectionId`; otherwise raise in small steps.
         targetConcurrencyLevel:
           type: integer
-          description: |
+          description: |-
             Target concurrency level for auto-scaling. The system adjusts concurrency
             between 1 and this value based on rate limit and governance feedback.
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              With `autoRecoverRateLimitErrors` on, this is the level the connection climbs back to
+              after a recovery, so it — not `concurrencyLevel` — is the value that must fit the shared
+              NetSuite account budget described on `concurrencyLevel`.
         _iClientId:
           type: string
           format: objectId
@@ -8266,6 +8309,16 @@ components:
             cannot start borrowing.
           examples:
             - 615dfa0742763671275b70ab
+          x-celigo-ai-guidance:
+            - |-
+              Set this when several connections target one external account whose API enforces a
+              single account-wide concurrency limit (for example one NetSuite account): put the limit
+              on one parent connection and point the others here, so their combined traffic can never
+              exceed it.
+            - |-
+              A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+              borrower competes with the parent's own flows — settle the priority split before
+              choosing who borrows from whom.
         autoRecoverRateLimitErrors:
           type: boolean
           default: true

package/dist/enduser.yml CHANGED Viewed

@@ -2177,12 +2177,24 @@ components:
               type: string
               format: objectId
               x-celigo-refModel: connections
-              description: |
-                Reference to another connection to share concurrency limits with.
-                When set, this connection's concurrency is counted against the referenced
-                connection's limit instead of maintaining its own.
+              description: |-
+                Reference to another connection to share concurrency limits with. When set, this
+                connection's traffic counts against the referenced connection's limit instead of its own,
+                and its own concurrency and auto-recovery settings have no effect. One level only: the
+                referenced connection may not itself borrow, and a connection that others borrow from
+                cannot start borrowing.
               examples:
                 - 615dfa0742763671275b70ab
+              x-celigo-ai-guidance:
+                - |-
+                  Set this when several connections target one external account whose API enforces a
+                  single account-wide concurrency limit (for example one NetSuite account): put the limit
+                  on one parent connection and point the others here, so their combined traffic can never
+                  exceed it.
+                - |-
+                  A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+                  borrower competes with the parent's own flows — settle the priority split before
+                  choosing who borrows from whom.
             debugDate:
               type: string
               format: date-time
@@ -2560,21 +2572,52 @@ components:
             Required for some authentication configurations to identify the calling application.
         concurrencyLevel:
           type: integer
-          description: |
-            General concurrency level for this connection. Controls the overall
-            maximum concurrent requests across all operation types.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+          description: |-
+            Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
+            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
+            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
+            APIs shares — all integrator.io connections to that account and every other client
+            calling those APIs from outside integrator.io (other integrations, third-party tools).
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              Before raising this connection's ceiling — `targetConcurrencyLevel` while
+              `autoRecoverRateLimitErrors` is on (the default; a PUT of `concurrencyLevel` then
+              changes nothing), `concurrencyLevel` only while it is off — total the ceilings of every
+              connection that targets the same NetSuite `account` and `environment` (a connection
+              that borrows counts under its parent) and keep that total, plus whatever calls the
+              account's APIs from outside integrator.io, within the NetSuite account limit; a value
+              that fits this connection alone can still push the whole account over.
+            - |-
+              The NetSuite limit is the service-tier base (Standard 5, Premium 15, Enterprise and
+              Ultimate 20; legacy tiers 5–20) plus 10 per SuiteCloud Plus license; a sandbox matches
+              its production account. Development and partner accounts are fixed at 5 and do not
+              scale with licenses. NetSuite shows the limit at Setup > Integration > Integration
+              Management > Integration Governance; integrator.io cannot read it — ask for the number
+              rather than assuming headroom.
+            - |-
+              Over the limit, NetSuite rejects requests from every caller of that account at once,
+              not only this connection's — SOAP: `ExceededConcurrentRequestLimitFault` /
+              `WS_REQUEST_BLOCKED`; REST web services: HTTP 429; RESTlets: HTTP 400
+              `SSS_REQUEST_LIMIT_EXCEEDED`. To run several connections against one NetSuite account,
+              put the limit on one parent and point the others at it with
+              `_borrowConcurrencyFromConnectionId`; otherwise raise in small steps.
         targetConcurrencyLevel:
           type: integer
-          description: |
+          description: |-
             Target concurrency level for auto-scaling. The system adjusts concurrency
             between 1 and this value based on rate limit and governance feedback.
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              With `autoRecoverRateLimitErrors` on, this is the level the connection climbs back to
+              after a recovery, so it — not `concurrencyLevel` — is the value that must fit the shared
+              NetSuite account budget described on `concurrencyLevel`.
         _iClientId:
           type: string
           format: objectId

package/dist/filedefinition.yml CHANGED Viewed

@@ -982,6 +982,8 @@ components:
             - 3c7a8f2e-1234-5678-9abc-def012345678
         rules:
           type: array
+          x-celigo-agent:
+            - file_definition_rules
           description: |
             Ordered array of recursive parsing/generation `Rule` nodes that
             describe the file's structure — segments, elements, loops, and

package/dist/mcp-server.yml CHANGED Viewed

@@ -3987,12 +3987,24 @@ components:
               type: string
               format: objectId
               x-celigo-refModel: connections
-              description: |
-                Reference to another connection to share concurrency limits with.
-                When set, this connection's concurrency is counted against the referenced
-                connection's limit instead of maintaining its own.
+              description: |-
+                Reference to another connection to share concurrency limits with. When set, this
+                connection's traffic counts against the referenced connection's limit instead of its own,
+                and its own concurrency and auto-recovery settings have no effect. One level only: the
+                referenced connection may not itself borrow, and a connection that others borrow from
+                cannot start borrowing.
               examples:
                 - 615dfa0742763671275b70ab
+              x-celigo-ai-guidance:
+                - |-
+                  Set this when several connections target one external account whose API enforces a
+                  single account-wide concurrency limit (for example one NetSuite account): put the limit
+                  on one parent connection and point the others here, so their combined traffic can never
+                  exceed it.
+                - |-
+                  A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+                  borrower competes with the parent's own flows — settle the priority split before
+                  choosing who borrows from whom.
             debugDate:
               type: string
               format: date-time
@@ -4370,21 +4382,52 @@ components:
             Required for some authentication configurations to identify the calling application.
         concurrencyLevel:
           type: integer
-          description: |
-            General concurrency level for this connection. Controls the overall
-            maximum concurrent requests across all operation types.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+          description: |-
+            Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
+            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
+            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
+            APIs shares — all integrator.io connections to that account and every other client
+            calling those APIs from outside integrator.io (other integrations, third-party tools).
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              Before raising this connection's ceiling — `targetConcurrencyLevel` while
+              `autoRecoverRateLimitErrors` is on (the default; a PUT of `concurrencyLevel` then
+              changes nothing), `concurrencyLevel` only while it is off — total the ceilings of every
+              connection that targets the same NetSuite `account` and `environment` (a connection
+              that borrows counts under its parent) and keep that total, plus whatever calls the
+              account's APIs from outside integrator.io, within the NetSuite account limit; a value
+              that fits this connection alone can still push the whole account over.
+            - |-
+              The NetSuite limit is the service-tier base (Standard 5, Premium 15, Enterprise and
+              Ultimate 20; legacy tiers 5–20) plus 10 per SuiteCloud Plus license; a sandbox matches
+              its production account. Development and partner accounts are fixed at 5 and do not
+              scale with licenses. NetSuite shows the limit at Setup > Integration > Integration
+              Management > Integration Governance; integrator.io cannot read it — ask for the number
+              rather than assuming headroom.
+            - |-
+              Over the limit, NetSuite rejects requests from every caller of that account at once,
+              not only this connection's — SOAP: `ExceededConcurrentRequestLimitFault` /
+              `WS_REQUEST_BLOCKED`; REST web services: HTTP 429; RESTlets: HTTP 400
+              `SSS_REQUEST_LIMIT_EXCEEDED`. To run several connections against one NetSuite account,
+              put the limit on one parent and point the others at it with
+              `_borrowConcurrencyFromConnectionId`; otherwise raise in small steps.
         targetConcurrencyLevel:
           type: integer
-          description: |
+          description: |-
             Target concurrency level for auto-scaling. The system adjusts concurrency
             between 1 and this value based on rate limit and governance feedback.
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              With `autoRecoverRateLimitErrors` on, this is the level the connection climbs back to
+              after a recovery, so it — not `concurrencyLevel` — is the value that must fit the shared
+              NetSuite account budget described on `concurrencyLevel`.
         _iClientId:
           type: string
           format: objectId

package/dist/tool.yml CHANGED Viewed

@@ -6602,12 +6602,24 @@ components:
               type: string
               format: objectId
               x-celigo-refModel: connections
-              description: |
-                Reference to another connection to share concurrency limits with.
-                When set, this connection's concurrency is counted against the referenced
-                connection's limit instead of maintaining its own.
+              description: |-
+                Reference to another connection to share concurrency limits with. When set, this
+                connection's traffic counts against the referenced connection's limit instead of its own,
+                and its own concurrency and auto-recovery settings have no effect. One level only: the
+                referenced connection may not itself borrow, and a connection that others borrow from
+                cannot start borrowing.
               examples:
                 - 615dfa0742763671275b70ab
+              x-celigo-ai-guidance:
+                - |-
+                  Set this when several connections target one external account whose API enforces a
+                  single account-wide concurrency limit (for example one NetSuite account): put the limit
+                  on one parent connection and point the others here, so their combined traffic can never
+                  exceed it.
+                - |-
+                  A borrower drains through the parent's queue as well as its ceiling, so a high-volume
+                  borrower competes with the parent's own flows — settle the priority split before
+                  choosing who borrows from whom.
             debugDate:
               type: string
               format: date-time
@@ -6985,21 +6997,52 @@ components:
             Required for some authentication configurations to identify the calling application.
         concurrencyLevel:
           type: integer
-          description: |
-            General concurrency level for this connection. Controls the overall
-            maximum concurrent requests across all operation types.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+          description: |-
+            Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
+            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
+            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
+            APIs shares — all integrator.io connections to that account and every other client
+            calling those APIs from outside integrator.io (other integrations, third-party tools).
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              Before raising this connection's ceiling — `targetConcurrencyLevel` while
+              `autoRecoverRateLimitErrors` is on (the default; a PUT of `concurrencyLevel` then
+              changes nothing), `concurrencyLevel` only while it is off — total the ceilings of every
+              connection that targets the same NetSuite `account` and `environment` (a connection
+              that borrows counts under its parent) and keep that total, plus whatever calls the
+              account's APIs from outside integrator.io, within the NetSuite account limit; a value
+              that fits this connection alone can still push the whole account over.
+            - |-
+              The NetSuite limit is the service-tier base (Standard 5, Premium 15, Enterprise and
+              Ultimate 20; legacy tiers 5–20) plus 10 per SuiteCloud Plus license; a sandbox matches
+              its production account. Development and partner accounts are fixed at 5 and do not
+              scale with licenses. NetSuite shows the limit at Setup > Integration > Integration
+              Management > Integration Governance; integrator.io cannot read it — ask for the number
+              rather than assuming headroom.
+            - |-
+              Over the limit, NetSuite rejects requests from every caller of that account at once,
+              not only this connection's — SOAP: `ExceededConcurrentRequestLimitFault` /
+              `WS_REQUEST_BLOCKED`; REST web services: HTTP 429; RESTlets: HTTP 400
+              `SSS_REQUEST_LIMIT_EXCEEDED`. To run several connections against one NetSuite account,
+              put the limit on one parent and point the others at it with
+              `_borrowConcurrencyFromConnectionId`; otherwise raise in small steps.
         targetConcurrencyLevel:
           type: integer
-          description: |
+          description: |-
             Target concurrency level for auto-scaling. The system adjusts concurrency
             between 1 and this value based on rate limit and governance feedback.
           minimum: 1
           maximum: 50
           default: 5
+          x-celigo-ai-guidance:
+            - |-
+              With `autoRecoverRateLimitErrors` on, this is the level the connection climbs back to
+              after a recovery, so it — not `concurrencyLevel` — is the value that must fit the shared
+              NetSuite account budget described on `concurrencyLevel`.
         _iClientId:
           type: string
           format: objectId

package/package.json CHANGED Viewed

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

package/schemas.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "d5f4380",
-		"generatedAt": "2026-10-01"
+		"iasCommit": "d5da91d",
+		"generatedAt": "2026-10-02"
 	},
 	"roots": {
 		"aiagent": 133,