npm - @celigo/api-specs - Versions diffs - 0.2.150 → 0.2.151 - Mend

@celigo/api-specs 0.2.150 → 0.2.151

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 (11) hide show

package/dist/guardrail.yml CHANGED Viewed

@@ -914,12 +914,17 @@ components:
                   run at `default` regardless of what's set here.
             output:
               type: object
-              description: Output format configuration
+              description: |-
+                Output format configuration. A guardrail stores `format` but doesn't use it: the
+                request to the model always carries the guardrail's own `validation_result` JSON
+                schema (`flagged`, `reasoning`, `confidence`), and the result returns `flagged` and
+                `reasoning` whatever `format` holds.
               properties:
                 format:
                   type: object
                   description: |
-                    Controls the structure of the model's output.
+                    Stored output structure. The request to the model uses the guardrail's own
+                    verdict schema instead (see `output`).
                   properties:
                     type:
                       type: string
@@ -928,10 +933,10 @@ components:
                         - json_schema
                         - blob
                       x-enumDescriptions:
-                        text: Free-form text response from the model.
-                        json_schema: Structured JSON output conforming to a defined schema.
-                        blob: Binary data output for non-text content.
-                      description: Output format type.
+                        text: Stored format type; the model request still uses the guardrail's verdict schema.
+                        json_schema: A stored JSON schema (`jsonSchema`); the model request still uses the guardrail's verdict schema.
+                        blob: Stored format type; the model request still uses the guardrail's verdict schema.
+                      description: Output format type, as stored.
                     schemaMode:
                       type: string
                       enum:
@@ -941,9 +946,9 @@ components:
                         manual: The schema editor opens `jsonSchema` in the visual field-by-field view
                         json: The schema editor opens `jsonSchema` in the raw JSON view
                       description: |-
-                        Which view a schema editor opens `jsonSchema` in; the schema sent to the
-                        provider is the same either way. Stored and echoed on guardrails for parity
-                        with the AI-agent format block — the guardrail form does not set it today.
+                        Which view a schema editor opens `jsonSchema` in. Stored and echoed on
+                        guardrails for parity with the AI-agent format block — the guardrail form
+                        does not set it today, and neither view changes the model request.
                       x-celigo-ai-guidance:
                         - |-
                           Resend the stored value on every update — a full PUT that omits the field
@@ -955,18 +960,20 @@ components:
                       x-celigo-ui-override: Required by the AI agent form when output format type is json_schema. Encoded here to mirror the form so builders produce connectable configurations.
                     strict:
                       type: boolean
-                      description: When true, enforces strict schema validation on output.
+                      description: Stored strict-validation flag for `jsonSchema`. A guardrail's model request uses its own verdict schema, so this doesn't apply there.
                       x-celigo-ai-guidance:
-                        - Whether to enforce strict schema validation on output
+                        - Stored only on a guardrail; it doesn't change the guardrail's verdict.
                     jsonSchema:
                       type: object
                       description: |
-                        JSON Schema for structured output. Required when `format.type` is "json_schema".
+                        Stored JSON Schema. Required when `format.type` is "json_schema". A guardrail
+                        doesn't send it to the model; the request carries the `validation_result`
+                        verdict schema instead.
                       x-celigo-ui-override: Required by the AI agent form when output format type is json_schema. Encoded here to mirror the form so builders produce connectable configurations.
                       properties:
                         type:
                           type: string
-                          description: Root JSON Schema type of the structured output; use "object" for record-shaped results.
+                          description: Root type of the stored JSON Schema.
                           enum:
                             - object
                             - array
@@ -984,15 +991,15 @@ components:
                         properties:
                           type: object
                           additionalProperties: true
-                          description: JSON Schema definitions for each field the structured output may contain.
+                          description: Field definitions in the stored JSON Schema.
                         required:
                           type: array
-                          description: Property names the model must include in the structured output.
+                          description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
                         additionalproperties:
                           type: boolean
-                          description: When true, the structured output may include properties beyond those defined in `properties`.
+                          description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:
                       type: object
                       readOnly: true

package/dist/import.yml CHANGED Viewed

@@ -10968,12 +10968,17 @@ components:
                   run at `default` regardless of what's set here.
             output:
               type: object
-              description: Output format configuration
+              description: |-
+                Output format configuration. A guardrail stores `format` but doesn't use it: the
+                request to the model always carries the guardrail's own `validation_result` JSON
+                schema (`flagged`, `reasoning`, `confidence`), and the result returns `flagged` and
+                `reasoning` whatever `format` holds.
               properties:
                 format:
                   type: object
                   description: |
-                    Controls the structure of the model's output.
+                    Stored output structure. The request to the model uses the guardrail's own
+                    verdict schema instead (see `output`).
                   properties:
                     type:
                       type: string
@@ -10982,10 +10987,10 @@ components:
                         - json_schema
                         - blob
                       x-enumDescriptions:
-                        text: Free-form text response from the model.
-                        json_schema: Structured JSON output conforming to a defined schema.
-                        blob: Binary data output for non-text content.
-                      description: Output format type.
+                        text: Stored format type; the model request still uses the guardrail's verdict schema.
+                        json_schema: A stored JSON schema (`jsonSchema`); the model request still uses the guardrail's verdict schema.
+                        blob: Stored format type; the model request still uses the guardrail's verdict schema.
+                      description: Output format type, as stored.
                     schemaMode:
                       type: string
                       enum:
@@ -10995,9 +11000,9 @@ components:
                         manual: The schema editor opens `jsonSchema` in the visual field-by-field view
                         json: The schema editor opens `jsonSchema` in the raw JSON view
                       description: |-
-                        Which view a schema editor opens `jsonSchema` in; the schema sent to the
-                        provider is the same either way. Stored and echoed on guardrails for parity
-                        with the AI-agent format block — the guardrail form does not set it today.
+                        Which view a schema editor opens `jsonSchema` in. Stored and echoed on
+                        guardrails for parity with the AI-agent format block — the guardrail form
+                        does not set it today, and neither view changes the model request.
                       x-celigo-ai-guidance:
                         - |-
                           Resend the stored value on every update — a full PUT that omits the field
@@ -11009,18 +11014,20 @@ components:
                       x-celigo-ui-override: Required by the AI agent form when output format type is json_schema. Encoded here to mirror the form so builders produce connectable configurations.
                     strict:
                       type: boolean
-                      description: When true, enforces strict schema validation on output.
+                      description: Stored strict-validation flag for `jsonSchema`. A guardrail's model request uses its own verdict schema, so this doesn't apply there.
                       x-celigo-ai-guidance:
-                        - Whether to enforce strict schema validation on output
+                        - Stored only on a guardrail; it doesn't change the guardrail's verdict.
                     jsonSchema:
                       type: object
                       description: |
-                        JSON Schema for structured output. Required when `format.type` is "json_schema".
+                        Stored JSON Schema. Required when `format.type` is "json_schema". A guardrail
+                        doesn't send it to the model; the request carries the `validation_result`
+                        verdict schema instead.
                       x-celigo-ui-override: Required by the AI agent form when output format type is json_schema. Encoded here to mirror the form so builders produce connectable configurations.
                       properties:
                         type:
                           type: string
-                          description: Root JSON Schema type of the structured output; use "object" for record-shaped results.
+                          description: Root type of the stored JSON Schema.
                           enum:
                             - object
                             - array
@@ -11038,15 +11045,15 @@ components:
                         properties:
                           type: object
                           additionalProperties: true
-                          description: JSON Schema definitions for each field the structured output may contain.
+                          description: Field definitions in the stored JSON Schema.
                         required:
                           type: array
-                          description: Property names the model must include in the structured output.
+                          description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
                         additionalproperties:
                           type: boolean
-                          description: When true, the structured output may include properties beyond those defined in `properties`.
+                          description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:
                       type: object
                       readOnly: true

package/dist/mcp-server.yml CHANGED Viewed

@@ -5139,7 +5139,12 @@ components:
           type: boolean
           description: |
             When true, uses iClient-managed OAuth credentials (clientId/clientSecret)
-            instead of the values in this configuration.
+            instead of the values in this configuration. The iClient is the connection's
+            `_iClientId` — on an HTTP connection `http._iClientId`, beside `auth`, not inside it —
+            and it also supplies the grant type and the authorization and token endpoints, so a
+            create needs only `auth.type: "oauth"`, `auth.oauth.useIClientFields: true` and the
+            iClient id. The connection holds no tokens until a person completes the authorization
+            in a browser.
         oauth1:
           type: object
           description: |-
@@ -5268,7 +5273,7 @@ components:
       x-celigo-ai-guidance:
         - |-
           ## OAUTH 2.0 GRANT TYPES
-          - "authorizationcode" — Authorization Code flow (browser-based user consent).
+          - "authorizecode" — Authorization Code flow (browser-based user consent).
             Requires authURI, tokenURI, and user authorization via browser.
           - "clientcredentials" — Client Credentials flow (server-to-server, no user).
             Requires tokenURI, clientId, clientSecret.
@@ -5859,7 +5864,11 @@ components:
                   description: |
                     The API key or bearer token value (encrypted at rest); returned masked as `"******"`.
                     On update, the mask sent back keeps the stored token; a new value replaces it.
-                    Required unless automatic token refresh is configured.
+                    Required unless automatic token refresh is configured: a token block without a
+                    token must carry a `refreshMethod`, so a create or update that sends neither fails
+                    with 422 `Expected field: refreshMethod to be present.` To create a static-token
+                    connection before the real token is available, send a placeholder value and
+                    replace it later.
                   examples:
                     - my-api-token-EXAMPLE
                 location:
@@ -8065,7 +8074,11 @@ components:
           description: |
             The API key or bearer token value (encrypted at rest); returned masked as `"******"`.
             On update, the mask sent back keeps the stored token; a new value replaces it.
-            Required unless automatic token refresh is configured.
+            Required unless automatic token refresh is configured: a token block without a
+            token must carry a `refreshMethod`, so a create or update that sends neither fails
+            with 422 `Expected field: refreshMethod to be present.` To create a static-token
+            connection before the real token is available, send a placeholder value and
+            replace it later.
           examples:
             - my-api-token-EXAMPLE
         location: