@celigo/api-specs 0.2.155 → 0.2.157

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.
@@ -412,7 +412,10 @@ components:
412
412
  description: |-
413
413
  Trading partner's interchange identifier: the sender ID on files the partner sends and the
414
414
  receiver ID on files you send (X12 ISA06 and ISA08 respectively; the UNB sender and
415
- recipient in EDIFACT).
415
+ recipient in EDIFACT). On an X12 profile, store it unpadded: parsing compares an inbound
416
+ file's ISA06 without its padding, so a value padded to 15 characters fails every inbound
417
+ file (`Interchange Sender ID with data <id> in the EDI file doesn't match with the expected
418
+ data in the EDI profile.`).
416
419
  examples:
417
420
  - ACMECORP
418
421
  - '5412345678901'
@@ -421,7 +424,10 @@ components:
421
424
  description: |-
422
425
  Your interchange identifier: the receiver ID on files the partner sends and the sender ID
423
426
  on files you send (X12 ISA08 and ISA06 respectively; the UNB recipient and sender in
424
- EDIFACT).
427
+ EDIFACT). On an X12 profile, store it unpadded: parsing compares an inbound file's ISA08
428
+ without its padding, so a value padded to 15 characters fails every inbound file
429
+ (`Interchange Receiver ID with data <id> in the EDI file doesn't match with the expected
430
+ data in the EDI profile.`).
425
431
  examples:
426
432
  - MYCOMPANY
427
433
  - '1234567890123'
@@ -462,7 +468,7 @@ components:
462
468
  description: |-
463
469
  X12 ISA02 — Authorization Information. When parsing, an inbound file's ISA02 must match
464
470
  this value after trimming (`data_mismatch` otherwise), so a blank ISA02 matches `""` and
465
- not ten spaces.
471
+ not ten spaces or one (values some trading partner connector forms prescribe).
466
472
  examples:
467
473
  - ''
468
474
  isa03:
@@ -481,7 +487,7 @@ components:
481
487
  description: |-
482
488
  X12 ISA04 — Security Information. When parsing, an inbound file's ISA04 must match this
483
489
  value after trimming (`data_mismatch` otherwise), so a blank ISA04 matches `""` and not
484
- ten spaces.
490
+ ten spaces or one (values some trading partner connector forms prescribe).
485
491
  examples:
486
492
  - ''
487
493
  tpIdQualifier:
@@ -497,6 +497,10 @@ components:
497
497
  record); for the row-type marker, equals `value` (in a
498
498
  container's child rule, a marker whose `name` differs from
499
499
  its `value` parses to an empty record without an error).
500
+ Names must be unique within a rule's `elements`: a save or a
501
+ parse with two of the same name is refused (`Sibling element
502
+ names need to be unique. Duplicate "<name>" found in
503
+ elements: [<i>, <j>]`).
500
504
  examples:
501
505
  - Order ID
502
506
  - Authorization Information Qualifier
@@ -569,13 +573,30 @@ components:
569
573
  Inclusive minimum string length. Used heavily on EDI
570
574
  elements where the X12 / EDIFACT standard fixes the length
571
575
  of envelope qualifiers (e.g. `ISA05` is exactly 2 chars,
572
- `ISA13` is exactly 9 chars).
576
+ `ISA13` is exactly 9 chars). A parse refuses a shorter value
577
+ (`Min. length not met for the field "ISA06"`). Generation
578
+ doesn't pad to it; see `maxLength`.
573
579
  maxLength:
574
580
  type: integer
575
581
  minimum: 0
576
582
  description: |
577
583
  Inclusive maximum string length. See `minLength` for
578
584
  usage notes.
585
+
586
+ Generation pads a shorter non-empty value with spaces up to
587
+ `maxLength` (`minLength` doesn't pad). An empty value stays
588
+ empty, except on ISA02/ISA04 elements that keep their
589
+ standard names (`Authorization Information`, `Security
590
+ Information`), which are written as `maxLength` spaces. So a
591
+ generate definition keeps the fixed-width X12 ISA at full
592
+ width (ISA02/ISA04 10 characters, ISA06/ISA08 15, 106
593
+ characters with the terminator) only with `maxLength` on
594
+ those elements. Without it, a blank `isa02` comes out empty
595
+ and an unpadded interchange id short, and Celigo's own parser
596
+ refuses that ISA (`Mandatory element "ISA02" is not present`,
597
+ `Min. length not met for the field "ISA06"`). A value longer
598
+ than `maxLength` fails the generation (`Max. length not met
599
+ for the field "<name>"`).
579
600
  referenceValue:
580
601
  type: string
581
602
  description: |
@@ -660,6 +681,14 @@ components:
660
681
  assigned numbers, HL hierarchical ids).
661
682
  examples:
662
683
  - true
684
+ ignore:
685
+ type: boolean
686
+ description: |
687
+ When true, the parser reads the element (on a fixed-width row
688
+ it still takes its `length`) but leaves it out of the parsed
689
+ record.
690
+ examples:
691
+ - true
663
692
  startPosition:
664
693
  type: integer
665
694
  minimum: 1
@@ -793,7 +822,7 @@ components:
793
822
  per segment-element (`ISA01`, `ISA02`, ...). Delimited
794
823
  rules use one element per column. Omit the key on a rule
795
824
  with no elements of its own, such as a container wrapper: an
796
- empty `elements` array fails the parse.
825
+ empty `elements` array saves, but fails the parse.
797
826
  items:
798
827
  $ref: '#/components/schemas/Element'
799
828
  children:
@@ -821,6 +850,11 @@ components:
821
850
  round-trips file definitions should preserve whichever shape
822
851
  the source document uses.
823
852
 
853
+ Put it on the rule that opens the envelope (ISA, GS, ST, UNB,
854
+ UNH), never on a `container` wrapper. A container's close rule
855
+ saves and parses without an error, but it consumes the row it
856
+ names, so the rule meant to read that row comes back empty.
857
+
824
858
  For non-EDI / non-loop rules `closeRule` is omitted.
825
859
  oneOf:
826
860
  - title: rule
@@ -841,10 +875,15 @@ components:
841
875
  under the wrapper's `name`; `container: true` on a rule with
842
876
  its own `elements` isn't honored as a loop.
843
877
 
844
- The parser rejects `container: true` paired with
845
- `maxOccurrence <= 1` with
846
- `Invalid rules: maxOccurences should be greater than '1',
847
- when the container is 'true'`.
878
+ A container repeats up to its `maxOccurrence`, which defaults
879
+ to `1`. A container with `1`, or without the key, saves and
880
+ parses but matches a single row: in fixed-width and delimited
881
+ files the rows after it are dropped without an error, and an
882
+ X12 parse fails at the next row it can't place, naming a
883
+ mandatory segment as missing (for example `Mandatory segment
884
+ "SE" is missing on line: 6`). A rule outside any container
885
+ matches one row the same way. Give the wrapper the most rows
886
+ the file can hold, such as `1000`.
848
887
  default: false
849
888
  examples:
850
889
  - true
@@ -859,8 +898,12 @@ components:
859
898
  an `ST` transaction set or a line-item loop; EDI envelopes use
860
899
  `1` (one ISA per file, one GS per group).
861
900
 
862
- Required to be greater than `1` when `container` is
863
- `true`.
901
+ Defaults to `1`, so a container needs a larger value to repeat
902
+ (see `container`). A value above `1` on any other rule saves,
903
+ but the parse refuses it with `Max no. of occurrences for
904
+ segment "<name>" is applicable only if it is a
905
+ container/loop.` `0` is refused on save and on parse (`if
906
+ present, maxOccurrence must be greater than or equal to 1`).
864
907
  examples:
865
908
  - 1
866
909
  - 1000
@@ -928,6 +971,16 @@ components:
928
971
  - P,04,05
929
972
  - - L,03,04,05,13
930
973
  - R,02,03
974
+ ignoreIdentifier:
975
+ type: boolean
976
+ description: |
977
+ Fixed-width: the rule matches rows without looking for a
978
+ row-type marker. Set it on the row rule of a file whose rows
979
+ carry no marker, inside a `container` so every row is read.
980
+ Without it such rows parse to one empty record (`{}`) with no
981
+ error, wrapped or not.
982
+ examples:
983
+ - true
931
984
  FileDefinitionBase:
932
985
  type: object
933
986
  description: Writable file definition fields shared by the request and response schemas.
@@ -1131,8 +1184,10 @@ components:
1131
1184
  - |-
1132
1185
  Rows repeat only under an elements-less `container: true` rule (a group `name`,
1133
1186
  `maxOccurrence` above 1, no `elements`) whose child rule carries the row's elements. A
1134
- row-marker rule with no such container above it matches only the first row, and the parser
1135
- drops the rest without an error.
1187
+ row-marker rule with no such container above it, or under a container whose
1188
+ `maxOccurrence` is 1 or unset, matches only the first row: in fixed-width and delimited
1189
+ files the parser drops the rest without an error, and an X12 parse fails at the next row,
1190
+ naming a mandatory segment as missing.
1136
1191
  ResourceResponse:
1137
1192
  type: object
1138
1193
  description: Response
@@ -593,9 +593,10 @@ components:
593
593
  description: |
594
594
  LLM configuration for an `ai_agent` guardrail — which provider and model evaluate each
595
595
  record, with instructions, parameter tuning, and output format. Guardrails never invoke
596
- tools, so unlike an AI agent import no block here accepts a `tools` array; MCP `prompts`
597
- and `resources` remain available. Providers come in two families with two configuration
598
- formats:
596
+ tools, so unlike an AI agent import no block here accepts a `tools` array. MCP `prompts`
597
+ and `resources` are accepted on save, but an unreachable MCP server doesn't fail the
598
+ run (verified on OpenAI), so put the policy the guardrail must apply in its
599
+ instructions. Providers come in two families with two configuration formats:
599
600
 
600
601
  - **Built-in providers** — each has its own configuration block.
601
602
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
@@ -759,7 +760,7 @@ components:
759
760
  prompts:
760
761
  type: array
761
762
  description: |-
762
- MCP prompt entries available to a catalog-provider guardrail (generic flat format).
763
+ MCP prompt entries saved with a catalog-provider guardrail (generic flat format).
763
764
  Each entry references one MCP connection and the prompt names allowed from it.
764
765
  items:
765
766
  type: object
@@ -815,7 +816,6 @@ components:
815
816
  - gpt-5-mini
816
817
  - gpt-5-nano
817
818
  - gpt-4.1-mini
818
- - gpt-4o
819
819
  x-celigo-ui-override: Required by the AI agent configuration form. Encoded here to mirror the form so builders produce connectable configurations.
820
820
  x-celigo-ai-guidance:
821
821
  - |-
@@ -1038,7 +1038,7 @@ components:
1038
1038
  prompts:
1039
1039
  type: array
1040
1040
  description: |-
1041
- MCP prompt entries available to the guardrail's model. Each item references one
1041
+ MCP prompt entries saved with the guardrail. Each item references one
1042
1042
  MCP connection and the prompt names allowed from it.
1043
1043
  items:
1044
1044
  type: object
@@ -1227,7 +1227,7 @@ components:
1227
1227
  prompts:
1228
1228
  type: array
1229
1229
  description: |-
1230
- MCP prompt entries available to the Gemini model. Each item references one
1230
+ MCP prompt entries saved with a Gemini guardrail. Each item references one
1231
1231
  MCP connection and the prompt names allowed from it.
1232
1232
  items:
1233
1233
  type: object
@@ -1449,7 +1449,7 @@ components:
1449
1449
  prompts:
1450
1450
  type: array
1451
1451
  description: |-
1452
- MCP prompt entries available to the Claude model. Each item references one
1452
+ MCP prompt entries saved with a Claude guardrail. Each item references one
1453
1453
  MCP connection and the prompt names allowed from it.
1454
1454
  items:
1455
1455
  type: object
@@ -1543,7 +1543,11 @@ components:
1543
1543
  Guardrails never invoke tools. A non-empty `tools` array anywhere under `aiAgent`
1544
1544
  (`aiAgent.tools`, `aiAgent.openai.tools`, `aiAgent.litellm._overrides.gemini.tools`,
1545
1545
  `aiAgent.litellm._overrides.anthropic.tools`) fails the save with 422
1546
- `guardrail_tools_not_allowed`; MCP `prompts` and `resources` are still accepted.
1546
+ `guardrail_tools_not_allowed`. MCP `prompts` and `resources` are still accepted on
1547
+ save, but don't rely on them for the check: with their MCP server unreachable, a
1548
+ guardrail runs on its instructions and input alone, with no error, where an AI agent's
1549
+ run fails (verified on OpenAI). Put the policy the guardrail must apply in its
1550
+ instructions.
1547
1551
  properties:
1548
1552
  type:
1549
1553
  type: string
package/dist/import.yml CHANGED
@@ -10668,9 +10668,10 @@ components:
10668
10668
  description: |
10669
10669
  LLM configuration for an `ai_agent` guardrail — which provider and model evaluate each
10670
10670
  record, with instructions, parameter tuning, and output format. Guardrails never invoke
10671
- tools, so unlike an AI agent import no block here accepts a `tools` array; MCP `prompts`
10672
- and `resources` remain available. Providers come in two families with two configuration
10673
- formats:
10671
+ tools, so unlike an AI agent import no block here accepts a `tools` array. MCP `prompts`
10672
+ and `resources` are accepted on save, but an unreachable MCP server doesn't fail the
10673
+ run (verified on OpenAI), so put the policy the guardrail must apply in its
10674
+ instructions. Providers come in two families with two configuration formats:
10674
10675
 
10675
10676
  - **Built-in providers** — each has its own configuration block.
10676
10677
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
@@ -10834,7 +10835,7 @@ components:
10834
10835
  prompts:
10835
10836
  type: array
10836
10837
  description: |-
10837
- MCP prompt entries available to a catalog-provider guardrail (generic flat format).
10838
+ MCP prompt entries saved with a catalog-provider guardrail (generic flat format).
10838
10839
  Each entry references one MCP connection and the prompt names allowed from it.
10839
10840
  items:
10840
10841
  type: object
@@ -10890,7 +10891,6 @@ components:
10890
10891
  - gpt-5-mini
10891
10892
  - gpt-5-nano
10892
10893
  - gpt-4.1-mini
10893
- - gpt-4o
10894
10894
  x-celigo-ui-override: Required by the AI agent configuration form. Encoded here to mirror the form so builders produce connectable configurations.
10895
10895
  x-celigo-ai-guidance:
10896
10896
  - |-
@@ -11113,7 +11113,7 @@ components:
11113
11113
  prompts:
11114
11114
  type: array
11115
11115
  description: |-
11116
- MCP prompt entries available to the guardrail's model. Each item references one
11116
+ MCP prompt entries saved with the guardrail. Each item references one
11117
11117
  MCP connection and the prompt names allowed from it.
11118
11118
  items:
11119
11119
  type: object
@@ -11302,7 +11302,7 @@ components:
11302
11302
  prompts:
11303
11303
  type: array
11304
11304
  description: |-
11305
- MCP prompt entries available to the Gemini model. Each item references one
11305
+ MCP prompt entries saved with a Gemini guardrail. Each item references one
11306
11306
  MCP connection and the prompt names allowed from it.
11307
11307
  items:
11308
11308
  type: object
@@ -11524,7 +11524,7 @@ components:
11524
11524
  prompts:
11525
11525
  type: array
11526
11526
  description: |-
11527
- MCP prompt entries available to the Claude model. Each item references one
11527
+ MCP prompt entries saved with a Claude guardrail. Each item references one
11528
11528
  MCP connection and the prompt names allowed from it.
11529
11529
  items:
11530
11530
  type: object
@@ -11649,7 +11649,9 @@ components:
11649
11649
  `aiAgent.openai.tools`, `aiAgent.litellm._overrides.gemini.tools`, `….anthropic.tools`) —
11650
11650
  any non-empty array fails the save with 422 `guardrail_tools_not_allowed` ("Tools aren't
11651
11651
  supported on a guardrail AI agent configuration…"), on create and on update. `prompts` and
11652
- `resources` are accepted; the server still echoes `openai.tools: []` on OpenAI guardrails.
11652
+ `resources` are accepted on save, but an unreachable MCP server doesn't fail the run
11653
+ (verified on OpenAI), so put the policy in the instructions. The server still echoes
11654
+ `openai.tools: []` on OpenAI guardrails.
11653
11655
  properties:
11654
11656
  type:
11655
11657
  type: string
package/dist/tool.yml CHANGED
@@ -22136,9 +22136,10 @@ components:
22136
22136
  description: |
22137
22137
  LLM configuration for an `ai_agent` guardrail — which provider and model evaluate each
22138
22138
  record, with instructions, parameter tuning, and output format. Guardrails never invoke
22139
- tools, so unlike an AI agent import no block here accepts a `tools` array; MCP `prompts`
22140
- and `resources` remain available. Providers come in two families with two configuration
22141
- formats:
22139
+ tools, so unlike an AI agent import no block here accepts a `tools` array. MCP `prompts`
22140
+ and `resources` are accepted on save, but an unreachable MCP server doesn't fail the
22141
+ run (verified on OpenAI), so put the policy the guardrail must apply in its
22142
+ instructions. Providers come in two families with two configuration formats:
22142
22143
 
22143
22144
  - **Built-in providers** — each has its own configuration block.
22144
22145
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
@@ -22302,7 +22303,7 @@ components:
22302
22303
  prompts:
22303
22304
  type: array
22304
22305
  description: |-
22305
- MCP prompt entries available to a catalog-provider guardrail (generic flat format).
22306
+ MCP prompt entries saved with a catalog-provider guardrail (generic flat format).
22306
22307
  Each entry references one MCP connection and the prompt names allowed from it.
22307
22308
  items:
22308
22309
  type: object
@@ -22358,7 +22359,6 @@ components:
22358
22359
  - gpt-5-mini
22359
22360
  - gpt-5-nano
22360
22361
  - gpt-4.1-mini
22361
- - gpt-4o
22362
22362
  x-celigo-ui-override: Required by the AI agent configuration form. Encoded here to mirror the form so builders produce connectable configurations.
22363
22363
  x-celigo-ai-guidance:
22364
22364
  - |-
@@ -22581,7 +22581,7 @@ components:
22581
22581
  prompts:
22582
22582
  type: array
22583
22583
  description: |-
22584
- MCP prompt entries available to the guardrail's model. Each item references one
22584
+ MCP prompt entries saved with the guardrail. Each item references one
22585
22585
  MCP connection and the prompt names allowed from it.
22586
22586
  items:
22587
22587
  type: object
@@ -22770,7 +22770,7 @@ components:
22770
22770
  prompts:
22771
22771
  type: array
22772
22772
  description: |-
22773
- MCP prompt entries available to the Gemini model. Each item references one
22773
+ MCP prompt entries saved with a Gemini guardrail. Each item references one
22774
22774
  MCP connection and the prompt names allowed from it.
22775
22775
  items:
22776
22776
  type: object
@@ -22992,7 +22992,7 @@ components:
22992
22992
  prompts:
22993
22993
  type: array
22994
22994
  description: |-
22995
- MCP prompt entries available to the Claude model. Each item references one
22995
+ MCP prompt entries saved with a Claude guardrail. Each item references one
22996
22996
  MCP connection and the prompt names allowed from it.
22997
22997
  items:
22998
22998
  type: object
@@ -23117,7 +23117,9 @@ components:
23117
23117
  `aiAgent.openai.tools`, `aiAgent.litellm._overrides.gemini.tools`, `….anthropic.tools`) —
23118
23118
  any non-empty array fails the save with 422 `guardrail_tools_not_allowed` ("Tools aren't
23119
23119
  supported on a guardrail AI agent configuration…"), on create and on update. `prompts` and
23120
- `resources` are accepted; the server still echoes `openai.tools: []` on OpenAI guardrails.
23120
+ `resources` are accepted on save, but an unreachable MCP server doesn't fail the run
23121
+ (verified on OpenAI), so put the policy in the instructions. The server still echoes
23122
+ `openai.tools: []` on OpenAI guardrails.
23121
23123
  properties:
23122
23124
  type:
23123
23125
  type: string
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@celigo/api-specs",
3
- "version": "0.2.155",
3
+ "version": "0.2.157",
4
4
  "private": false,
5
5
  "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
6
6
  "keywords": [
package/schemas.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "provenance": {
3
3
  "repo": "celigo/integrator-api-specs",
4
- "iasCommit": "37aee3d1",
4
+ "iasCommit": "063d41cc",
5
5
  "generatedAt": "2026-10-21"
6
6
  },
7
7
  "roots": {
@@ -5575,6 +5575,7 @@
5575
5575
  "container": 9,
5576
5576
  "description": 1,
5577
5577
  "elements": 476,
5578
+ "ignoreIdentifier": 9,
5578
5579
  "maxOccurrence": 125,
5579
5580
  "name": 1,
5580
5581
  "relationship": 21,
@@ -5593,6 +5594,7 @@
5593
5594
  "description": 1,
5594
5595
  "end": 125,
5595
5596
  "enum": 21,
5597
+ "ignore": 9,
5596
5598
  "length": 125,
5597
5599
  "maxLength": 125,
5598
5600
  "minLength": 125,