@celigo/api-specs 0.2.215 → 0.2.216

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.
package/dist/ai-agent.yml CHANGED
@@ -23,9 +23,11 @@ tags:
23
23
 
24
24
  Three built-in providers — OpenAI (via the Responses API), Google Gemini (via
25
25
  LiteLLM), and Anthropic Claude (via LiteLLM) — run on platform-managed
26
- credentials or, with a `_connectionId`, on your own key (BYOK). Catalog
27
- providers — Mistral, xAI, Hugging Face, DeepSeek, Cohere, and Groq — use one generic
28
- flat configuration format and always run on a BYOK connection.
26
+ credentials or, with a `_connectionId`, on your own key (BYOK). Every other
27
+ provider is a catalog provider — Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq,
28
+ Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM, Ollama Cloud and
29
+ Google Vertex AI today, with new rows seeded without a platform release — and uses
30
+ one generic flat configuration format and always runs on a BYOK connection.
29
31
 
30
32
  Every model carries a lifecycle in the platform's model catalog (`active`,
31
33
  `deprecated`, `retired`, plus an availability switch). The save and every run
@@ -133,12 +135,16 @@ paths:
133
135
  Creates a new AI agent import. The provider decides the configuration
134
136
  format: `aiAgent.openai` for OpenAI, `aiAgent.litellm` for Gemini and
135
137
  Anthropic Claude, or the generic flat format (`aiAgent.model`,
136
- `aiAgent.modelOptions`, …) for the catalog providers Mistral, xAI,
137
- Hugging Face, DeepSeek, Cohere, and Groq — a block that does not match the
138
- provider is rejected. For a built-in provider, omit `_connectionId` to
139
- use platform-managed credentials or include it for BYOK; a catalog
140
- provider needs a BYOK connection to save — without one the request
141
- fails with 422 `connection_required` on `_connectionId`.
138
+ `aiAgent.modelOptions`, …) for every other provider (the catalog
139
+ providers — Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq, Together
140
+ AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM, Ollama Cloud and
141
+ Google Vertex AI today) — a block that does not match the provider is
142
+ rejected. For a built-in provider, omit `_connectionId` to use
143
+ platform-managed credentials or include it for BYOK; a catalog provider
144
+ needs a BYOK connection to save — without one the request fails with 422
145
+ on `aiAgent.model`: `ai_model_not_available` for a catalog-listed model,
146
+ `ai_model_not_in_catalog` for an id the catalog does not list (the model
147
+ catalog check answers before any `connection_required`).
142
148
  operationId: createAiAgent
143
149
  tags:
144
150
  - AI Agents
@@ -1047,8 +1053,10 @@ components:
1047
1053
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
1048
1054
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
1049
1055
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
1050
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
1051
- as catalog data rather than platform code, they share one generic flat format:
1056
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
1057
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
1058
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
1059
+ Added as catalog data rather than platform code, they share one generic flat format:
1052
1060
  `model`, `modelOptions`, `instructions`, `output`, and the `tools` / `prompts` /
1053
1061
  `resources` arrays directly on this object.
1054
1062
 
@@ -1094,26 +1102,45 @@ components:
1094
1102
  - deepseek
1095
1103
  - cohere
1096
1104
  - groq
1105
+ - together_ai
1106
+ - azure_ai
1107
+ - fireworks_ai
1108
+ - bedrock
1109
+ - nvidia_nim
1110
+ - ollama_chat
1111
+ - vertex_ai
1097
1112
  x-enumDescriptions:
1098
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
1099
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
1100
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
1101
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
1102
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
1103
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
1104
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
1105
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
1106
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
1107
- description: AI provider to use.
1113
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
1114
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
1115
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
1116
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
1117
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
1118
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
1119
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
1120
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
1121
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
1122
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
1123
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
1124
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
1125
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
1126
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
1127
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
1128
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
1129
+ description: |-
1130
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
1131
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
1132
+ connection. The catalog is data — a provider can be added without a platform
1133
+ release, and `GET /api/aiproviders` lists the rows currently offered.
1108
1134
  x-celigo-ai-guidance:
1109
1135
  - |-
1110
1136
  The provider decides the configuration format, and the server rejects a
1111
1137
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
1112
1138
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
1113
- Claude-specific settings under `litellm._overrides`), and the catalog
1114
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
1115
- generic flat format — `model` and `modelOptions` directly on this object,
1116
- never an `openai` or `litellm` block.
1139
+ Claude-specific settings under `litellm._overrides`), and every other
1140
+ provider (the catalog providers) needs the generic flat format — `model` and
1141
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
1142
+ Switching across that boundary replaces the whole configuration in the target
1143
+ format; nothing is translated field by field.
1117
1144
  - |-
1118
1145
  Catalog providers are BYOK-only, and the save enforces it through the model
1119
1146
  catalog: without a `_connectionId` the agent fails to save with 422
@@ -1122,6 +1149,18 @@ components:
1122
1149
  configuration.") — the model is a catalog row that is not offered on
1123
1150
  platform-managed credentials. Attach an HTTP connection to the vendor's API
1124
1151
  (token auth) before saving a catalog-provider agent.
1152
+ - |-
1153
+ Without a connection, a provider the catalog does not list is refused at the
1154
+ model check — 422 `ai_model_not_in_catalog` on `aiAgent.model` — so the
1155
+ message names the model, not the provider. Check the provider against the
1156
+ catalog before blaming the model.
1157
+ - |-
1158
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
1159
+ connection, not this object: an optional connection `baseURI` (the vendor
1160
+ endpoint the connector asks for), and connection settings forwarded to the
1161
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
1162
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
1163
+ the deployment name.
1125
1164
  model:
1126
1165
  type: string
1127
1166
  description: |-
@@ -1594,13 +1633,27 @@ components:
1594
1633
  web_search: Search the web for real-time information.
1595
1634
  mcp: Connect to an MCP server for additional external tools.
1596
1635
  image_generation: Generate images using an AI image model.
1597
- code_execution: 'Enable OpenAI''s built-in code-execution tool; carries no configuration block, send `{type: code_execution}` only'
1636
+ code_execution: 'Let the model write and run code in OpenAI''s sandbox on a BYOK agent; carries no configuration block, send `{type: code_execution}` only'
1598
1637
  tool: Reference a reusable Celigo Tool resource.
1599
1638
  description: |-
1600
1639
  Type of tool. Every type except `code_execution` is configured through the
1601
1640
  sibling object of the same name; OpenAI spells this one `code_execution`, while
1602
1641
  the Gemini and Anthropic overrides spell theirs `codeExecution` — the other spelling
1603
- fails with 422 `enum`.
1642
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
1643
+ models that support it: the code runs in OpenAI's sandbox with no outbound
1644
+ network access, the session lasts one hour, and each execution is billed as an
1645
+ AI Action to the connection's OpenAI account rather than as Celigo AI credits.
1646
+ x-celigo-ai-guidance:
1647
+ - |-
1648
+ Add `code_execution` only when the agent has a `_connectionId`. The save does
1649
+ not check the credential type, but every run and preview of an agent on
1650
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
1651
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
1652
+ - |-
1653
+ Send the tool as `{type: code_execution}` with no other key — a sandbox or
1654
+ options object on it is rejected. Check that the chosen model supports code
1655
+ execution before adding it; the platform does not verify that at save and
1656
+ the UI hides the tool for models that lack it.
1604
1657
  webSearch:
1605
1658
  type: object
1606
1659
  description: Web search configuration (empty object to enable)
@@ -1954,12 +2007,28 @@ components:
1954
2007
  googleSearch: Use Google Search for real-time information grounding.
1955
2008
  urlContext: Retrieve and use content from specified URLs.
1956
2009
  fileSearch: Search through previously uploaded files.
1957
- codeExecution: 'Enable Gemini''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
2010
+ codeExecution: 'Let the model write and run code in Gemini''s sandbox on a BYOK agent; carries no configuration block, send `{type: codeExecution}` only'
1958
2011
  mcp: Connect to an MCP server for additional external tools.
1959
2012
  tool: Reference a reusable Celigo Tool resource.
1960
2013
  description: |-
1961
2014
  Type of Gemini tool. `codeExecution` is the Gemini spelling — `code_execution`
1962
- fails with 422 `enum`.
2015
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
2016
+ models that support it (not on `gemini-2.5-flash-image`): the code runs in
2017
+ Gemini's sandbox with no outbound network access for up to 30 seconds per
2018
+ execution and at most 5 executions per API call (the limit resets each turn),
2019
+ and each execution is billed as an AI Action to the connection's Google
2020
+ account rather than as Celigo AI credits.
2021
+ x-celigo-ai-guidance:
2022
+ - |-
2023
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
2024
+ not check the credential type, but every run and preview of an agent on
2025
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
2026
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
2027
+ - |-
2028
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
2029
+ it is rejected. Check that the chosen model supports code execution before
2030
+ adding it; the platform does not verify that at save and the UI hides the
2031
+ tool for models that lack it.
1963
2032
  googleSearch:
1964
2033
  type: object
1965
2034
  description: Google Search configuration (empty object to enable)
@@ -2291,10 +2360,26 @@ components:
2291
2360
  tool: Reference a reusable Celigo Tool resource.
2292
2361
  mcp: Connect to an MCP server for additional external tools.
2293
2362
  webSearch: Search the web for real-time information.
2294
- codeExecution: 'Enable Anthropic''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
2363
+ codeExecution: 'Let the model write and run code in Anthropic''s sandbox on a BYOK agent (beta); carries no configuration block, send `{type: codeExecution}` only'
2295
2364
  description: |-
2296
2365
  Type of Claude tool. `codeExecution` is the Anthropic spelling — `code_execution`
2297
- fails with 422 `enum`.
2366
+ fails with 422 `enum`. Code execution (beta on Anthropic) runs only on a BYOK
2367
+ agent and only on models that support it: the code runs per API call in
2368
+ Anthropic's sandbox (Python 3.11 with pandas, numpy and matplotlib) with no
2369
+ outbound network access and no state kept between turns, and each execution is
2370
+ billed as an AI Action to the connection's Anthropic account rather than as
2371
+ Celigo AI credits.
2372
+ x-celigo-ai-guidance:
2373
+ - |-
2374
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
2375
+ not check the credential type, but every run and preview of an agent on
2376
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
2377
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
2378
+ - |-
2379
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
2380
+ it is rejected. Check that the chosen model supports code execution before
2381
+ adding it; the platform does not verify that at save and the UI hides the
2382
+ tool for models that lack it.
2298
2383
  tool:
2299
2384
  type: object
2300
2385
  description: Reference to a Celigo Tool resource, used when type is "tool".
@@ -2511,6 +2596,13 @@ components:
2511
2596
  - deepseek
2512
2597
  - cohere
2513
2598
  - groq
2599
+ - together_ai
2600
+ - azure_ai
2601
+ - fireworks_ai
2602
+ - bedrock
2603
+ - nvidia_nim
2604
+ - ollama_chat
2605
+ - vertex_ai
2514
2606
  required:
2515
2607
  - provider
2516
2608
  then:
@@ -6077,8 +6169,10 @@ components:
6077
6169
  `aiAgent.provider` to choose the LLM backend, then configure the matching format:
6078
6170
  `aiAgent.openai` for OpenAI, `aiAgent.litellm` for Gemini and Anthropic Claude
6079
6171
  (with provider-specific settings under `aiAgent.litellm._overrides`), or the
6080
- generic flat format (`aiAgent.model`, `aiAgent.modelOptions`, …) for the catalog
6081
- providers Mistral, xAI, Hugging Face, DeepSeek, Cohere, and Groq.
6172
+ generic flat format (`aiAgent.model`, `aiAgent.modelOptions`, …) for every other
6173
+ provider — the catalog providers (Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq,
6174
+ Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM, Ollama Cloud and
6175
+ Google Vertex AI today; the catalog grows without a platform release).
6082
6176
  properties:
6083
6177
  name:
6084
6178
  type: string
@@ -6100,10 +6194,11 @@ components:
6100
6194
  description: |-
6101
6195
  Connection for BYOK (bring your own key) — an HTTP connection to the vendor's API.
6102
6196
  Optional for the built-in providers (`openai`, `gemini`, `anthropic`), which run on
6103
- platform-managed credentials when it is omitted. Catalog providers (`mistral`, `xai`,
6104
- `huggingface`, `deepseek`, `cohere`, `groq`) have no platform-managed credentials: the save
6105
- requires it — without one the agent fails to save with 422 `connection_required` on
6106
- `_connectionId`.
6197
+ platform-managed credentials when it is omitted. Catalog providers (every other value
6198
+ of `provider`) have no platform-managed credentials: the save requires it — without
6199
+ one the agent fails to save with 422 on `aiAgent.model` (`ai_model_not_available` for
6200
+ a catalog-listed model, `ai_model_not_in_catalog` for an id the catalog does not
6201
+ list; the model catalog check answers before any `connection_required`).
6107
6202
  examples:
6108
6203
  - 662aaa6576bf4040548dbbe4
6109
6204
  _integrationId:
@@ -602,8 +602,10 @@ components:
602
602
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
603
603
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
604
604
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
605
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
606
- as catalog data rather than platform code, they share one generic flat format:
605
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
606
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
607
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
608
+ Added as catalog data rather than platform code, they share one generic flat format:
607
609
  `model`, `modelOptions`, `instructions`, `output`, and the `prompts` / `resources`
608
610
  arrays directly on this object.
609
611
 
@@ -655,26 +657,43 @@ components:
655
657
  - deepseek
656
658
  - cohere
657
659
  - groq
660
+ - together_ai
661
+ - azure_ai
662
+ - fireworks_ai
663
+ - bedrock
664
+ - nvidia_nim
665
+ - ollama_chat
666
+ - vertex_ai
658
667
  x-enumDescriptions:
659
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
660
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
661
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
662
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
663
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
664
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
665
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
666
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
667
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
668
- description: AI provider to use.
668
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
669
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
670
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
671
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
672
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
673
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
674
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
675
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
676
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
677
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
678
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
679
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
680
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
681
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
682
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
683
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
684
+ description: |-
685
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
686
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
687
+ connection. The catalog is data — a provider can be added without a platform
688
+ release, and `GET /api/aiproviders` lists the rows currently offered.
669
689
  x-celigo-ai-guidance:
670
690
  - |-
671
691
  The provider decides the configuration format, and the server rejects a
672
692
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
673
693
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
674
- Claude-specific settings under `litellm._overrides`), and the catalog
675
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
676
- generic flat format — `model` and `modelOptions` directly on this object,
677
- never an `openai` or `litellm` block.
694
+ Claude-specific settings under `litellm._overrides`), and every other
695
+ provider (the catalog providers) needs the generic flat format — `model` and
696
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
678
697
  - |-
679
698
  Catalog providers are BYOK-only, and the save enforces it through the model
680
699
  catalog: without a `_connectionId` the guardrail fails to save with 422
@@ -683,6 +702,18 @@ components:
683
702
  configuration.") — the model is a catalog row that is not offered on
684
703
  platform-managed credentials. Attach an HTTP connection to the vendor's API
685
704
  (token auth) before saving a catalog-provider guardrail.
705
+ - |-
706
+ Without a connection, a provider the catalog does not list is refused at the
707
+ model check — 422 `ai_model_not_in_catalog` on `guardrail.aiAgent.model` — so the
708
+ message names the model, not the provider. Check the provider against the
709
+ catalog before blaming the model.
710
+ - |-
711
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
712
+ connection, not this object: an optional connection `baseURI` (the vendor
713
+ endpoint the connector asks for), and connection settings forwarded to the
714
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
715
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
716
+ the deployment name.
686
717
  model:
687
718
  type: string
688
719
  description: |-
@@ -1566,6 +1597,13 @@ components:
1566
1597
  - deepseek
1567
1598
  - cohere
1568
1599
  - groq
1600
+ - together_ai
1601
+ - azure_ai
1602
+ - fireworks_ai
1603
+ - bedrock
1604
+ - nvidia_nim
1605
+ - ollama_chat
1606
+ - vertex_ai
1569
1607
  required:
1570
1608
  - provider
1571
1609
  then:
@@ -2389,7 +2427,7 @@ components:
2389
2427
  Connection for BYOK (bring your own key) — only meaningful for `ai_agent` type
2390
2428
  guardrails. Optional for the built-in providers (`openai`, `gemini`, `anthropic`),
2391
2429
  which run on platform-managed credentials when it is omitted; catalog providers
2392
- (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) have no platform-managed
2430
+ (every other value of `provider`) have no platform-managed
2393
2431
  credentials and need it to run.
2394
2432
  examples:
2395
2433
  - 68ae48d6b5f755d2dd38c294
package/dist/import.yml CHANGED
@@ -9585,8 +9585,10 @@ components:
9585
9585
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
9586
9586
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
9587
9587
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
9588
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
9589
- as catalog data rather than platform code, they share one generic flat format:
9588
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
9589
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
9590
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
9591
+ Added as catalog data rather than platform code, they share one generic flat format:
9590
9592
  `model`, `modelOptions`, `instructions`, `output`, and the `tools` / `prompts` /
9591
9593
  `resources` arrays directly on this object.
9592
9594
 
@@ -9632,26 +9634,45 @@ components:
9632
9634
  - deepseek
9633
9635
  - cohere
9634
9636
  - groq
9637
+ - together_ai
9638
+ - azure_ai
9639
+ - fireworks_ai
9640
+ - bedrock
9641
+ - nvidia_nim
9642
+ - ollama_chat
9643
+ - vertex_ai
9635
9644
  x-enumDescriptions:
9636
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
9637
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
9638
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
9639
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
9640
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
9641
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
9642
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
9643
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
9644
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
9645
- description: AI provider to use.
9645
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
9646
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
9647
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
9648
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
9649
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
9650
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
9651
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
9652
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
9653
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
9654
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
9655
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
9656
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
9657
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
9658
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
9659
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
9660
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
9661
+ description: |-
9662
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
9663
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
9664
+ connection. The catalog is data — a provider can be added without a platform
9665
+ release, and `GET /api/aiproviders` lists the rows currently offered.
9646
9666
  x-celigo-ai-guidance:
9647
9667
  - |-
9648
9668
  The provider decides the configuration format, and the server rejects a
9649
9669
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
9650
9670
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
9651
- Claude-specific settings under `litellm._overrides`), and the catalog
9652
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
9653
- generic flat format — `model` and `modelOptions` directly on this object,
9654
- never an `openai` or `litellm` block.
9671
+ Claude-specific settings under `litellm._overrides`), and every other
9672
+ provider (the catalog providers) needs the generic flat format — `model` and
9673
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
9674
+ Switching across that boundary replaces the whole configuration in the target
9675
+ format; nothing is translated field by field.
9655
9676
  - |-
9656
9677
  Catalog providers are BYOK-only, and the save enforces it through the model
9657
9678
  catalog: without a `_connectionId` the agent fails to save with 422
@@ -9660,6 +9681,18 @@ components:
9660
9681
  configuration.") — the model is a catalog row that is not offered on
9661
9682
  platform-managed credentials. Attach an HTTP connection to the vendor's API
9662
9683
  (token auth) before saving a catalog-provider agent.
9684
+ - |-
9685
+ Without a connection, a provider the catalog does not list is refused at the
9686
+ model check — 422 `ai_model_not_in_catalog` on `aiAgent.model` — so the
9687
+ message names the model, not the provider. Check the provider against the
9688
+ catalog before blaming the model.
9689
+ - |-
9690
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
9691
+ connection, not this object: an optional connection `baseURI` (the vendor
9692
+ endpoint the connector asks for), and connection settings forwarded to the
9693
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
9694
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
9695
+ the deployment name.
9663
9696
  model:
9664
9697
  type: string
9665
9698
  description: |-
@@ -10132,13 +10165,27 @@ components:
10132
10165
  web_search: Search the web for real-time information.
10133
10166
  mcp: Connect to an MCP server for additional external tools.
10134
10167
  image_generation: Generate images using an AI image model.
10135
- code_execution: 'Enable OpenAI''s built-in code-execution tool; carries no configuration block, send `{type: code_execution}` only'
10168
+ code_execution: 'Let the model write and run code in OpenAI''s sandbox on a BYOK agent; carries no configuration block, send `{type: code_execution}` only'
10136
10169
  tool: Reference a reusable Celigo Tool resource.
10137
10170
  description: |-
10138
10171
  Type of tool. Every type except `code_execution` is configured through the
10139
10172
  sibling object of the same name; OpenAI spells this one `code_execution`, while
10140
10173
  the Gemini and Anthropic overrides spell theirs `codeExecution` — the other spelling
10141
- fails with 422 `enum`.
10174
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
10175
+ models that support it: the code runs in OpenAI's sandbox with no outbound
10176
+ network access, the session lasts one hour, and each execution is billed as an
10177
+ AI Action to the connection's OpenAI account rather than as Celigo AI credits.
10178
+ x-celigo-ai-guidance:
10179
+ - |-
10180
+ Add `code_execution` only when the agent has a `_connectionId`. The save does
10181
+ not check the credential type, but every run and preview of an agent on
10182
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
10183
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
10184
+ - |-
10185
+ Send the tool as `{type: code_execution}` with no other key — a sandbox or
10186
+ options object on it is rejected. Check that the chosen model supports code
10187
+ execution before adding it; the platform does not verify that at save and
10188
+ the UI hides the tool for models that lack it.
10142
10189
  webSearch:
10143
10190
  type: object
10144
10191
  description: Web search configuration (empty object to enable)
@@ -10492,12 +10539,28 @@ components:
10492
10539
  googleSearch: Use Google Search for real-time information grounding.
10493
10540
  urlContext: Retrieve and use content from specified URLs.
10494
10541
  fileSearch: Search through previously uploaded files.
10495
- codeExecution: 'Enable Gemini''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
10542
+ codeExecution: 'Let the model write and run code in Gemini''s sandbox on a BYOK agent; carries no configuration block, send `{type: codeExecution}` only'
10496
10543
  mcp: Connect to an MCP server for additional external tools.
10497
10544
  tool: Reference a reusable Celigo Tool resource.
10498
10545
  description: |-
10499
10546
  Type of Gemini tool. `codeExecution` is the Gemini spelling — `code_execution`
10500
- fails with 422 `enum`.
10547
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
10548
+ models that support it (not on `gemini-2.5-flash-image`): the code runs in
10549
+ Gemini's sandbox with no outbound network access for up to 30 seconds per
10550
+ execution and at most 5 executions per API call (the limit resets each turn),
10551
+ and each execution is billed as an AI Action to the connection's Google
10552
+ account rather than as Celigo AI credits.
10553
+ x-celigo-ai-guidance:
10554
+ - |-
10555
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
10556
+ not check the credential type, but every run and preview of an agent on
10557
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
10558
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
10559
+ - |-
10560
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
10561
+ it is rejected. Check that the chosen model supports code execution before
10562
+ adding it; the platform does not verify that at save and the UI hides the
10563
+ tool for models that lack it.
10501
10564
  googleSearch:
10502
10565
  type: object
10503
10566
  description: Google Search configuration (empty object to enable)
@@ -10829,10 +10892,26 @@ components:
10829
10892
  tool: Reference a reusable Celigo Tool resource.
10830
10893
  mcp: Connect to an MCP server for additional external tools.
10831
10894
  webSearch: Search the web for real-time information.
10832
- codeExecution: 'Enable Anthropic''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
10895
+ codeExecution: 'Let the model write and run code in Anthropic''s sandbox on a BYOK agent (beta); carries no configuration block, send `{type: codeExecution}` only'
10833
10896
  description: |-
10834
10897
  Type of Claude tool. `codeExecution` is the Anthropic spelling — `code_execution`
10835
- fails with 422 `enum`.
10898
+ fails with 422 `enum`. Code execution (beta on Anthropic) runs only on a BYOK
10899
+ agent and only on models that support it: the code runs per API call in
10900
+ Anthropic's sandbox (Python 3.11 with pandas, numpy and matplotlib) with no
10901
+ outbound network access and no state kept between turns, and each execution is
10902
+ billed as an AI Action to the connection's Anthropic account rather than as
10903
+ Celigo AI credits.
10904
+ x-celigo-ai-guidance:
10905
+ - |-
10906
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
10907
+ not check the credential type, but every run and preview of an agent on
10908
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
10909
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
10910
+ - |-
10911
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
10912
+ it is rejected. Check that the chosen model supports code execution before
10913
+ adding it; the platform does not verify that at save and the UI hides the
10914
+ tool for models that lack it.
10836
10915
  tool:
10837
10916
  type: object
10838
10917
  description: Reference to a Celigo Tool resource, used when type is "tool".
@@ -11049,6 +11128,13 @@ components:
11049
11128
  - deepseek
11050
11129
  - cohere
11051
11130
  - groq
11131
+ - together_ai
11132
+ - azure_ai
11133
+ - fireworks_ai
11134
+ - bedrock
11135
+ - nvidia_nim
11136
+ - ollama_chat
11137
+ - vertex_ai
11052
11138
  required:
11053
11139
  - provider
11054
11140
  then:
@@ -11068,8 +11154,10 @@ components:
11068
11154
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
11069
11155
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
11070
11156
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
11071
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
11072
- as catalog data rather than platform code, they share one generic flat format:
11157
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
11158
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
11159
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
11160
+ Added as catalog data rather than platform code, they share one generic flat format:
11073
11161
  `model`, `modelOptions`, `instructions`, `output`, and the `prompts` / `resources`
11074
11162
  arrays directly on this object.
11075
11163
 
@@ -11121,26 +11209,43 @@ components:
11121
11209
  - deepseek
11122
11210
  - cohere
11123
11211
  - groq
11212
+ - together_ai
11213
+ - azure_ai
11214
+ - fireworks_ai
11215
+ - bedrock
11216
+ - nvidia_nim
11217
+ - ollama_chat
11218
+ - vertex_ai
11124
11219
  x-enumDescriptions:
11125
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
11126
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
11127
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
11128
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
11129
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
11130
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
11131
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
11132
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
11133
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
11134
- description: AI provider to use.
11220
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
11221
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
11222
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
11223
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
11224
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
11225
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
11226
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
11227
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
11228
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
11229
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
11230
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
11231
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
11232
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
11233
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
11234
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
11235
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
11236
+ description: |-
11237
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
11238
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
11239
+ connection. The catalog is data — a provider can be added without a platform
11240
+ release, and `GET /api/aiproviders` lists the rows currently offered.
11135
11241
  x-celigo-ai-guidance:
11136
11242
  - |-
11137
11243
  The provider decides the configuration format, and the server rejects a
11138
11244
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
11139
11245
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
11140
- Claude-specific settings under `litellm._overrides`), and the catalog
11141
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
11142
- generic flat format — `model` and `modelOptions` directly on this object,
11143
- never an `openai` or `litellm` block.
11246
+ Claude-specific settings under `litellm._overrides`), and every other
11247
+ provider (the catalog providers) needs the generic flat format — `model` and
11248
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
11144
11249
  - |-
11145
11250
  Catalog providers are BYOK-only, and the save enforces it through the model
11146
11251
  catalog: without a `_connectionId` the guardrail fails to save with 422
@@ -11149,6 +11254,18 @@ components:
11149
11254
  configuration.") — the model is a catalog row that is not offered on
11150
11255
  platform-managed credentials. Attach an HTTP connection to the vendor's API
11151
11256
  (token auth) before saving a catalog-provider guardrail.
11257
+ - |-
11258
+ Without a connection, a provider the catalog does not list is refused at the
11259
+ model check — 422 `ai_model_not_in_catalog` on `guardrail.aiAgent.model` — so the
11260
+ message names the model, not the provider. Check the provider against the
11261
+ catalog before blaming the model.
11262
+ - |-
11263
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
11264
+ connection, not this object: an optional connection `baseURI` (the vendor
11265
+ endpoint the connector asks for), and connection settings forwarded to the
11266
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
11267
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
11268
+ the deployment name.
11152
11269
  model:
11153
11270
  type: string
11154
11271
  description: |-
@@ -12032,6 +12149,13 @@ components:
12032
12149
  - deepseek
12033
12150
  - cohere
12034
12151
  - groq
12152
+ - together_ai
12153
+ - azure_ai
12154
+ - fireworks_ai
12155
+ - bedrock
12156
+ - nvidia_nim
12157
+ - ollama_chat
12158
+ - vertex_ai
12035
12159
  required:
12036
12160
  - provider
12037
12161
  then:
@@ -16811,7 +16935,7 @@ components:
16811
16935
  MongodbImport: MongoDB database import for document-based operations.
16812
16936
  DynamodbImport: Amazon DynamoDB import for NoSQL table operations.
16813
16937
  WrapperImport: Custom adaptor import built outside of Celigo (rarely used).
16814
- AiAgentImport: AI agent import using OpenAI, Gemini, Anthropic Claude, or a BYOK catalog provider (Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq) for data processing.
16938
+ AiAgentImport: AI agent import using OpenAI, Gemini, Anthropic Claude, or a BYOK catalog provider (Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM, Ollama Cloud, Google Vertex AI) for data processing.
16815
16939
  GuardrailImport: Safety and compliance check import for PII detection, moderation, or AI evaluation.
16816
16940
  FileSystemImport: Local or network file system import.
16817
16941
  ToolImport: Import that executes a reusable Celigo Tool resource.
package/dist/tool.yml CHANGED
@@ -21592,8 +21592,10 @@ components:
21592
21592
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
21593
21593
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
21594
21594
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
21595
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
21596
- as catalog data rather than platform code, they share one generic flat format:
21595
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
21596
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
21597
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
21598
+ Added as catalog data rather than platform code, they share one generic flat format:
21597
21599
  `model`, `modelOptions`, `instructions`, `output`, and the `tools` / `prompts` /
21598
21600
  `resources` arrays directly on this object.
21599
21601
 
@@ -21639,26 +21641,45 @@ components:
21639
21641
  - deepseek
21640
21642
  - cohere
21641
21643
  - groq
21644
+ - together_ai
21645
+ - azure_ai
21646
+ - fireworks_ai
21647
+ - bedrock
21648
+ - nvidia_nim
21649
+ - ollama_chat
21650
+ - vertex_ai
21642
21651
  x-enumDescriptions:
21643
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
21644
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
21645
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
21646
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
21647
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
21648
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
21649
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
21650
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
21651
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
21652
- description: AI provider to use.
21652
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
21653
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
21654
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
21655
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
21656
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
21657
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
21658
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
21659
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
21660
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
21661
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
21662
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
21663
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
21664
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
21665
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
21666
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
21667
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
21668
+ description: |-
21669
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
21670
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
21671
+ connection. The catalog is data — a provider can be added without a platform
21672
+ release, and `GET /api/aiproviders` lists the rows currently offered.
21653
21673
  x-celigo-ai-guidance:
21654
21674
  - |-
21655
21675
  The provider decides the configuration format, and the server rejects a
21656
21676
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
21657
21677
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
21658
- Claude-specific settings under `litellm._overrides`), and the catalog
21659
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
21660
- generic flat format — `model` and `modelOptions` directly on this object,
21661
- never an `openai` or `litellm` block.
21678
+ Claude-specific settings under `litellm._overrides`), and every other
21679
+ provider (the catalog providers) needs the generic flat format — `model` and
21680
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
21681
+ Switching across that boundary replaces the whole configuration in the target
21682
+ format; nothing is translated field by field.
21662
21683
  - |-
21663
21684
  Catalog providers are BYOK-only, and the save enforces it through the model
21664
21685
  catalog: without a `_connectionId` the agent fails to save with 422
@@ -21667,6 +21688,18 @@ components:
21667
21688
  configuration.") — the model is a catalog row that is not offered on
21668
21689
  platform-managed credentials. Attach an HTTP connection to the vendor's API
21669
21690
  (token auth) before saving a catalog-provider agent.
21691
+ - |-
21692
+ Without a connection, a provider the catalog does not list is refused at the
21693
+ model check — 422 `ai_model_not_in_catalog` on `aiAgent.model` — so the
21694
+ message names the model, not the provider. Check the provider against the
21695
+ catalog before blaming the model.
21696
+ - |-
21697
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
21698
+ connection, not this object: an optional connection `baseURI` (the vendor
21699
+ endpoint the connector asks for), and connection settings forwarded to the
21700
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
21701
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
21702
+ the deployment name.
21670
21703
  model:
21671
21704
  type: string
21672
21705
  description: |-
@@ -22139,13 +22172,27 @@ components:
22139
22172
  web_search: Search the web for real-time information.
22140
22173
  mcp: Connect to an MCP server for additional external tools.
22141
22174
  image_generation: Generate images using an AI image model.
22142
- code_execution: 'Enable OpenAI''s built-in code-execution tool; carries no configuration block, send `{type: code_execution}` only'
22175
+ code_execution: 'Let the model write and run code in OpenAI''s sandbox on a BYOK agent; carries no configuration block, send `{type: code_execution}` only'
22143
22176
  tool: Reference a reusable Celigo Tool resource.
22144
22177
  description: |-
22145
22178
  Type of tool. Every type except `code_execution` is configured through the
22146
22179
  sibling object of the same name; OpenAI spells this one `code_execution`, while
22147
22180
  the Gemini and Anthropic overrides spell theirs `codeExecution` — the other spelling
22148
- fails with 422 `enum`.
22181
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
22182
+ models that support it: the code runs in OpenAI's sandbox with no outbound
22183
+ network access, the session lasts one hour, and each execution is billed as an
22184
+ AI Action to the connection's OpenAI account rather than as Celigo AI credits.
22185
+ x-celigo-ai-guidance:
22186
+ - |-
22187
+ Add `code_execution` only when the agent has a `_connectionId`. The save does
22188
+ not check the credential type, but every run and preview of an agent on
22189
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
22190
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
22191
+ - |-
22192
+ Send the tool as `{type: code_execution}` with no other key — a sandbox or
22193
+ options object on it is rejected. Check that the chosen model supports code
22194
+ execution before adding it; the platform does not verify that at save and
22195
+ the UI hides the tool for models that lack it.
22149
22196
  webSearch:
22150
22197
  type: object
22151
22198
  description: Web search configuration (empty object to enable)
@@ -22499,12 +22546,28 @@ components:
22499
22546
  googleSearch: Use Google Search for real-time information grounding.
22500
22547
  urlContext: Retrieve and use content from specified URLs.
22501
22548
  fileSearch: Search through previously uploaded files.
22502
- codeExecution: 'Enable Gemini''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
22549
+ codeExecution: 'Let the model write and run code in Gemini''s sandbox on a BYOK agent; carries no configuration block, send `{type: codeExecution}` only'
22503
22550
  mcp: Connect to an MCP server for additional external tools.
22504
22551
  tool: Reference a reusable Celigo Tool resource.
22505
22552
  description: |-
22506
22553
  Type of Gemini tool. `codeExecution` is the Gemini spelling — `code_execution`
22507
- fails with 422 `enum`.
22554
+ fails with 422 `enum`. Code execution runs only on a BYOK agent and only on
22555
+ models that support it (not on `gemini-2.5-flash-image`): the code runs in
22556
+ Gemini's sandbox with no outbound network access for up to 30 seconds per
22557
+ execution and at most 5 executions per API call (the limit resets each turn),
22558
+ and each execution is billed as an AI Action to the connection's Google
22559
+ account rather than as Celigo AI credits.
22560
+ x-celigo-ai-guidance:
22561
+ - |-
22562
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
22563
+ not check the credential type, but every run and preview of an agent on
22564
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
22565
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
22566
+ - |-
22567
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
22568
+ it is rejected. Check that the chosen model supports code execution before
22569
+ adding it; the platform does not verify that at save and the UI hides the
22570
+ tool for models that lack it.
22508
22571
  googleSearch:
22509
22572
  type: object
22510
22573
  description: Google Search configuration (empty object to enable)
@@ -22836,10 +22899,26 @@ components:
22836
22899
  tool: Reference a reusable Celigo Tool resource.
22837
22900
  mcp: Connect to an MCP server for additional external tools.
22838
22901
  webSearch: Search the web for real-time information.
22839
- codeExecution: 'Enable Anthropic''s built-in code-execution tool; carries no configuration block, send `{type: codeExecution}` only'
22902
+ codeExecution: 'Let the model write and run code in Anthropic''s sandbox on a BYOK agent (beta); carries no configuration block, send `{type: codeExecution}` only'
22840
22903
  description: |-
22841
22904
  Type of Claude tool. `codeExecution` is the Anthropic spelling — `code_execution`
22842
- fails with 422 `enum`.
22905
+ fails with 422 `enum`. Code execution (beta on Anthropic) runs only on a BYOK
22906
+ agent and only on models that support it: the code runs per API call in
22907
+ Anthropic's sandbox (Python 3.11 with pandas, numpy and matplotlib) with no
22908
+ outbound network access and no state kept between turns, and each execution is
22909
+ billed as an AI Action to the connection's Anthropic account rather than as
22910
+ Celigo AI credits.
22911
+ x-celigo-ai-guidance:
22912
+ - |-
22913
+ Add `codeExecution` only when the agent has a `_connectionId`. The save does
22914
+ not check the credential type, but every run and preview of an agent on
22915
+ Celigo-managed credentials is refused with `Code Execution requires a BYOK
22916
+ connection.` — switch the agent to a BYOK connection or leave the tool out.
22917
+ - |-
22918
+ Send the tool as `{type: codeExecution}` with no other key — any other key on
22919
+ it is rejected. Check that the chosen model supports code execution before
22920
+ adding it; the platform does not verify that at save and the UI hides the
22921
+ tool for models that lack it.
22843
22922
  tool:
22844
22923
  type: object
22845
22924
  description: Reference to a Celigo Tool resource, used when type is "tool".
@@ -23056,6 +23135,13 @@ components:
23056
23135
  - deepseek
23057
23136
  - cohere
23058
23137
  - groq
23138
+ - together_ai
23139
+ - azure_ai
23140
+ - fireworks_ai
23141
+ - bedrock
23142
+ - nvidia_nim
23143
+ - ollama_chat
23144
+ - vertex_ai
23059
23145
  required:
23060
23146
  - provider
23061
23147
  then:
@@ -23075,8 +23161,10 @@ components:
23075
23161
  - **openai**: OpenAI models (GPT-4.1, GPT-5, etc.). Configure via the `openai` object.
23076
23162
  - **gemini**: Google Gemini models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.gemini`.
23077
23163
  - **anthropic**: Anthropic Claude models via the LiteLLM proxy. Configure via `litellm` with overrides in `litellm._overrides.anthropic`.
23078
- - **Catalog providers** — `mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`. Added
23079
- as catalog data rather than platform code, they share one generic flat format:
23164
+ - **Catalog providers** — every other value of `provider` (Mistral, xAI, Hugging Face,
23165
+ DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM,
23166
+ Ollama Cloud and Google Vertex AI today; the catalog grows without a platform release).
23167
+ Added as catalog data rather than platform code, they share one generic flat format:
23080
23168
  `model`, `modelOptions`, `instructions`, `output`, and the `prompts` / `resources`
23081
23169
  arrays directly on this object.
23082
23170
 
@@ -23128,26 +23216,43 @@ components:
23128
23216
  - deepseek
23129
23217
  - cohere
23130
23218
  - groq
23219
+ - together_ai
23220
+ - azure_ai
23221
+ - fireworks_ai
23222
+ - bedrock
23223
+ - nvidia_nim
23224
+ - ollama_chat
23225
+ - vertex_ai
23131
23226
  x-enumDescriptions:
23132
- openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block).
23133
- gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block).
23134
- anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block).
23135
- mistral: Use Mistral models (catalog provider; generic flat format, BYOK).
23136
- xai: Use xAI Grok models (catalog provider; generic flat format, BYOK).
23137
- huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK).
23138
- deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK).
23139
- cohere: Use Cohere models (catalog provider; generic flat format, BYOK).
23140
- groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK).
23141
- description: AI provider to use.
23227
+ openai: Use OpenAI models via the OpenAI Responses API (built-in; `openai` block; Celigo AI or BYOK)
23228
+ gemini: Use Google Gemini models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
23229
+ anthropic: Use Anthropic Claude models via the LiteLLM proxy (built-in; `litellm` block; Celigo AI or BYOK)
23230
+ mistral: Use Mistral models (catalog provider; generic flat format, BYOK)
23231
+ xai: Use xAI Grok models (catalog provider; generic flat format, BYOK)
23232
+ huggingface: Use Hugging Face inference endpoint models (catalog provider; generic flat format, BYOK)
23233
+ deepseek: Use DeepSeek models (catalog provider; generic flat format, BYOK)
23234
+ cohere: Use Cohere models (catalog provider; generic flat format, BYOK)
23235
+ groq: Use Groq-hosted models (catalog provider; generic flat format, BYOK)
23236
+ together_ai: Use models served by Together AI (catalog provider; generic flat format, BYOK)
23237
+ azure_ai: Use deployments on an Azure AI Foundry / Azure OpenAI resource — `model` is the deployment name (catalog provider; generic flat format, BYOK)
23238
+ fireworks_ai: Use models served by Fireworks AI (catalog provider; generic flat format, BYOK)
23239
+ bedrock: Use AWS Bedrock models through cross-region inference profile ids such as `global.anthropic.claude-sonnet-4-6` (catalog provider; generic flat format, BYOK)
23240
+ nvidia_nim: Use models served by NVIDIA NIM (catalog provider; generic flat format, BYOK)
23241
+ ollama_chat: Use models served by Ollama Cloud (catalog provider; generic flat format, BYOK)
23242
+ vertex_ai: Use Gemini models on Google Vertex AI with the customer's own GCP project (catalog provider; generic flat format, BYOK)
23243
+ description: |-
23244
+ AI provider to use. Built-in providers run on Celigo AI credentials or on a
23245
+ BYOK connection; every other provider is a catalog row that runs only on a BYOK
23246
+ connection. The catalog is data — a provider can be added without a platform
23247
+ release, and `GET /api/aiproviders` lists the rows currently offered.
23142
23248
  x-celigo-ai-guidance:
23143
23249
  - |-
23144
23250
  The provider decides the configuration format, and the server rejects a
23145
23251
  mismatch with 422 `invalid_provider_config_format`: `openai` needs the
23146
23252
  `openai` block, `gemini` and `anthropic` need the `litellm` block (Gemini- or
23147
- Claude-specific settings under `litellm._overrides`), and the catalog
23148
- providers (`mistral`, `xai`, `huggingface`, `deepseek`, `cohere`, `groq`) need the
23149
- generic flat format — `model` and `modelOptions` directly on this object,
23150
- never an `openai` or `litellm` block.
23253
+ Claude-specific settings under `litellm._overrides`), and every other
23254
+ provider (the catalog providers) needs the generic flat format — `model` and
23255
+ `modelOptions` directly on this object, never an `openai` or `litellm` block.
23151
23256
  - |-
23152
23257
  Catalog providers are BYOK-only, and the save enforces it through the model
23153
23258
  catalog: without a `_connectionId` the guardrail fails to save with 422
@@ -23156,6 +23261,18 @@ components:
23156
23261
  configuration.") — the model is a catalog row that is not offered on
23157
23262
  platform-managed credentials. Attach an HTTP connection to the vendor's API
23158
23263
  (token auth) before saving a catalog-provider guardrail.
23264
+ - |-
23265
+ Without a connection, a provider the catalog does not list is refused at the
23266
+ model check — 422 `ai_model_not_in_catalog` on `guardrail.aiAgent.model` — so the
23267
+ message names the model, not the provider. Check the provider against the
23268
+ catalog before blaming the model.
23269
+ - |-
23270
+ For `azure_ai` and `bedrock` the vendor-specific settings ride the BYOK
23271
+ connection, not this object: an optional connection `baseURI` (the vendor
23272
+ endpoint the connector asks for), and connection settings forwarded to the
23273
+ vendor — Azure's `apiVersion`, Bedrock's `awsRegionName`. `bedrock`
23274
+ authenticates with a Bedrock API key (no IAM role); for `azure_ai`, `model` is
23275
+ the deployment name.
23159
23276
  model:
23160
23277
  type: string
23161
23278
  description: |-
@@ -24039,6 +24156,13 @@ components:
24039
24156
  - deepseek
24040
24157
  - cohere
24041
24158
  - groq
24159
+ - together_ai
24160
+ - azure_ai
24161
+ - fireworks_ai
24162
+ - bedrock
24163
+ - nvidia_nim
24164
+ - ollama_chat
24165
+ - vertex_ai
24042
24166
  required:
24043
24167
  - provider
24044
24168
  then:
@@ -26166,7 +26290,7 @@ components:
26166
26290
  MongodbImport: MongoDB database import for document-based operations.
26167
26291
  DynamodbImport: Amazon DynamoDB import for NoSQL table operations.
26168
26292
  WrapperImport: Custom adaptor import built outside of Celigo (rarely used).
26169
- AiAgentImport: AI agent import using OpenAI, Gemini, Anthropic Claude, or a BYOK catalog provider (Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq) for data processing.
26293
+ AiAgentImport: AI agent import using OpenAI, Gemini, Anthropic Claude, or a BYOK catalog provider (Mistral, xAI, Hugging Face, DeepSeek, Cohere, Groq, Together AI, Azure OpenAI, Fireworks AI, AWS Bedrock, NVIDIA NIM, Ollama Cloud, Google Vertex AI) for data processing.
26170
26294
  GuardrailImport: Safety and compliance check import for PII detection, moderation, or AI evaluation.
26171
26295
  FileSystemImport: Local or network file system import.
26172
26296
  ToolImport: Import that executes a reusable Celigo Tool resource.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@celigo/api-specs",
3
- "version": "0.2.215",
3
+ "version": "0.2.216",
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,8 +1,8 @@
1
1
  {
2
2
  "provenance": {
3
3
  "repo": "celigo/integrator-api-specs",
4
- "iasCommit": "6bca256a",
5
- "generatedAt": "2026-10-30"
4
+ "iasCommit": "0b379620",
5
+ "generatedAt": "2026-11-01"
6
6
  },
7
7
  "roots": {
8
8
  "aiagent": 128,
@@ -66,13 +66,20 @@
66
66
  ],
67
67
  "e": [
68
68
  "anthropic",
69
+ "azure_ai",
70
+ "bedrock",
69
71
  "cohere",
70
72
  "deepseek",
73
+ "fireworks_ai",
71
74
  "gemini",
72
75
  "groq",
73
76
  "huggingface",
74
77
  "mistral",
78
+ "nvidia_nim",
79
+ "ollama_chat",
75
80
  "openai",
81
+ "together_ai",
82
+ "vertex_ai",
76
83
  "xai"
77
84
  ]
78
85
  },