release: 2.4.0

.github/workflows/ci.yml

@@ -1,12 +1,14 @@
 name: CI
 on:
   push:
-    branches-ignore:
-      - 'generated'
-      - 'codegen/**'
-      - 'integrated/**'
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+    branches:
+      - '**'
+      - '!integrated/**'
+      - '!stl-preview-head/**'
+      - '!stl-preview-base/**'
+      - '!generated'
+      - '!codegen/**'
+      - 'codegen/stl/**'
   pull_request:
     branches-ignore:
       - 'stl-preview-head/**'
@@ -17,7 +19,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/arcade-engine-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@v6
 
@@ -41,7 +43,7 @@ jobs:
     timeout-minutes: 5
     name: build
     runs-on: ${{ github.repository == 'stainless-sdks/arcade-engine-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     permissions:
       contents: read
       id-token: write

.gitignore

@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 node_modules
 yarn-error.log
 codegen.log

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.3.0"
+  ".": "2.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-6ff494eafa2c154892716407682bb2296cff4f18c45765c5fb16bdf36f452ae1.yml
-openapi_spec_hash: 63dde2481a7d51042a241bfba232b0b0
-config_hash: bf64816643634a621cd0ffd93d9c4347
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-a509111298b23d3851de5439560c96b7d7831556094a790ba838cf11e9277ee7.yml
+openapi_spec_hash: 0ad3aecc9853e08130587d8e4b1bb468
+config_hash: 2d4163acdeacd75903f978cd79c35d14

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 2.4.0 (2026-04-18)
+
+Full Changelog: [v2.3.0...v2.4.0](https://github.com/ArcadeAI/arcade-js/compare/v2.3.0...v2.4.0)
+
+### Features
+
+* **api:** api update ([bcfa4e5](https://github.com/ArcadeAI/arcade-js/commit/bcfa4e57fdc0260ca78694b3a343f231fa788ebd))
+* **api:** api update ([c055166](https://github.com/ArcadeAI/arcade-js/commit/c055166eebae302570c99ba00ebb57b9d0a9b74f))
+* **api:** api update ([86fb9b7](https://github.com/ArcadeAI/arcade-js/commit/86fb9b73eba443187a68ce2ae672ccc8f350fe82))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([6eb86b4](https://github.com/ArcadeAI/arcade-js/commit/6eb86b474dc089af4619655d6b9ee8a194a042a0))
+* **internal:** codegen related update ([03c83ef](https://github.com/ArcadeAI/arcade-js/commit/03c83ef0b7796991d96ab6a20f657c1967525ea4))
+* **internal:** tweak CI branches ([a4f5461](https://github.com/ArcadeAI/arcade-js/commit/a4f5461fbba69b9c0461673ed4cf20c553a9840c))
+* **internal:** update gitignore ([42e376c](https://github.com/ArcadeAI/arcade-js/commit/42e376c96239d31b92c353743ea7d2602fe3ef5d))
+* **internal:** update multipart form array serialization ([1fc185b](https://github.com/ArcadeAI/arcade-js/commit/1fc185b9e695e67c6a31427091733bb14ba5b7e9))
+* **tests:** bump steady to v0.19.4 ([5b281e0](https://github.com/ArcadeAI/arcade-js/commit/5b281e041629c427dd0b1150eb35c0e71032aefd))
+* **tests:** bump steady to v0.19.5 ([4a7fbca](https://github.com/ArcadeAI/arcade-js/commit/4a7fbca94e370ed9d919182dce7ff2b4cf143b70))
+* **tests:** bump steady to v0.19.6 ([0c0518c](https://github.com/ArcadeAI/arcade-js/commit/0c0518c7c0a73ea8a6827dfd85402875a28fc13b))
+* **tests:** bump steady to v0.19.7 ([b95d4df](https://github.com/ArcadeAI/arcade-js/commit/b95d4df4d2ada95dcc8f06ef233f15379887f267))
+* **tests:** bump steady to v0.20.1 ([f6bbd99](https://github.com/ArcadeAI/arcade-js/commit/f6bbd99b9f1a1bcd160957f47bff5180f6447170))
+* **tests:** bump steady to v0.20.2 ([ad56f20](https://github.com/ArcadeAI/arcade-js/commit/ad56f20c6fee1f7164fed37033b9f45b794f0b4f))
+* **tests:** bump steady to v0.22.1 ([36d8fa3](https://github.com/ArcadeAI/arcade-js/commit/36d8fa3522dcab9af9c21f832ace15ad1b93f74a))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([6d28088](https://github.com/ArcadeAI/arcade-js/commit/6d280888d29864c3230c1e1c30274c15cd3dc63d))
+
 ## 2.3.0 (2026-03-10)
 
 Full Changelog: [v2.2.0...v2.3.0](https://github.com/ArcadeAI/arcade-js/compare/v2.2.0...v2.3.0)

CONTRIBUTING.md

@@ -65,7 +65,7 @@ $ pnpm link --global @arcadeai/arcadejs
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
+Most tests require you to [set up a mock server](https://github.com/dgellow/steady) against the OpenAPI spec to run the tests.
 
 ```sh
 $ ./scripts/mock

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@arcadeai/arcadejs",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "The official TypeScript library for the Arcade API",
   "author": "Arcade <dev@arcade.dev>",
   "types": "dist/index.d.ts",

scripts/mock

@@ -19,34 +19,34 @@ fi
 
 echo "==> Starting mock server with URL ${URL}"
 
-# Run prism mock on the given spec
+# Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism --version
+  npm exec --package=@stdy/cli@0.22.1 -- steady --version
 
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=comma --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
-  # Wait for server to come online (max 30s)
+  # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
   attempts=0
-  while ! grep -q "✖  fatal\|Prism is listening" ".prism.log" ; do
+  while ! curl --silent --fail "http://127.0.0.1:4010/_x-steady/health" >/dev/null 2>&1; do
+    if ! kill -0 $! 2>/dev/null; then
+      echo
+      cat .stdy.log
+      exit 1
+    fi
     attempts=$((attempts + 1))
     if [ "$attempts" -ge 300 ]; then
       echo
-      echo "Timed out waiting for Prism server to start"
-      cat .prism.log
+      echo "Timed out waiting for Steady server to start"
+      cat .stdy.log
       exit 1
     fi
     echo -n "."
     sleep 0.1
   done
 
-  if grep -q "✖  fatal" ".prism.log"; then
-    cat .prism.log
-    exit 1
-  fi
-
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
+  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=comma --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi

scripts/test

@@ -9,8 +9,8 @@ GREEN='\033[0;32m'
 YELLOW='\033[0;33m'
 NC='\033[0m' # No Color
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
+function steady_is_running() {
+  curl --silent "http://127.0.0.1:4010/_x-steady/health" >/dev/null 2>&1
 }
 
 kill_server_on_port() {
@@ -25,7 +25,7 @@ function is_overriding_api_base_url() {
   [ -n "$TEST_API_BASE_URL" ]
 }
 
-if ! is_overriding_api_base_url && ! prism_is_running ; then
+if ! is_overriding_api_base_url && ! steady_is_running ; then
   # When we exit this script, make sure to kill the background mock server process
   trap 'kill_server_on_port 4010' EXIT
 
@@ -36,19 +36,19 @@ fi
 if is_overriding_api_base_url ; then
   echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
   echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
+elif ! steady_is_running ; then
+  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Steady server"
   echo -e "running against your OpenAPI spec."
   echo
   echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
+  echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.22.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=comma --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1
 else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
+  echo -e "${GREEN}✔ Mock steady server is running with your OpenAPI spec${NC}"
   echo
 fi
 

src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

src/resources/tools/formatted.ts

@@ -40,6 +40,14 @@ export type FormattedListResponse = { [key: string]: unknown };
 export type FormattedGetResponse = { [key: string]: unknown };
 
 export interface FormattedListParams extends OffsetPageParams {
+  /**
+   * JSON metadata filter. Array fields (service_domains, operations): shorthand
+   * array or object with any_of/all_of/none_of operators (case-insensitive). Boolean
+   * fields: read_only, destructive, idempotent, open_world. Extras: case-sensitive
+   * key-value subset match.
+   */
+  filter?: string;
+
   /**
    * Provider format
    */

src/resources/tools/tools.ts

@@ -25,7 +25,7 @@ export class Tools extends APIResource {
 
   /**
    * Returns a page of tools from the engine configuration, optionally filtered by
-   * toolkit
+   * toolkit and/or metadata
    */
   list(
     query: ToolListParams | null | undefined = {},
@@ -172,6 +172,9 @@ export namespace ExecuteToolResponse {
         | 'UPSTREAM_RUNTIME_RATE_LIMIT'
         | 'UPSTREAM_RUNTIME_SERVER_ERROR'
         | 'UPSTREAM_RUNTIME_UNMAPPED'
+        | 'NETWORK_TRANSPORT_RUNTIME_TIMEOUT'
+        | 'NETWORK_TRANSPORT_RUNTIME_UNREACHABLE'
+        | 'NETWORK_TRANSPORT_RUNTIME_UNMAPPED'
         | 'UNKNOWN';
 
       message: string;
@@ -398,6 +401,9 @@ export namespace ToolExecutionAttempt {
         | 'UPSTREAM_RUNTIME_RATE_LIMIT'
         | 'UPSTREAM_RUNTIME_SERVER_ERROR'
         | 'UPSTREAM_RUNTIME_UNMAPPED'
+        | 'NETWORK_TRANSPORT_RUNTIME_TIMEOUT'
+        | 'NETWORK_TRANSPORT_RUNTIME_UNREACHABLE'
+        | 'NETWORK_TRANSPORT_RUNTIME_UNMAPPED'
         | 'UNKNOWN';
 
       message: string;
@@ -434,6 +440,14 @@ export interface ValueSchema {
 }
 
 export interface ToolListParams extends OffsetPageParams {
+  /**
+   * JSON metadata filter. Array fields (service_domains, operations): shorthand
+   * array or object with any_of/all_of/none_of operators (case-insensitive). Boolean
+   * fields: read_only, destructive, idempotent, open_world. Extras: case-sensitive
+   * key-value subset match.
+   */
+  filter?: string;
+
   /**
    * Include all versions of each tool
    */

src/resources/workers.ts

@@ -227,10 +227,14 @@ export namespace WorkerResponse {
   }
 
   export interface Mcp {
+    external_id?: string;
+
     headers?: { [key: string]: string };
 
     oauth2?: Mcp.Oauth2;
 
+    redirect_uri?: string;
+
     retry?: number;
 
     secrets?: { [key: string]: Mcp.Secrets };

src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.3.0'; // x-release-please-version
+export const VERSION = '2.4.0'; // x-release-please-version

tests/api-resources/tools/formatted.test.ts

@@ -24,6 +24,7 @@ describe('resource formatted', () => {
     await expect(
       client.tools.formatted.list(
         {
+          filter: 'filter',
           format: 'format',
           include_all_versions: true,
           limit: 0,

tests/api-resources/tools/tools.test.ts

@@ -24,6 +24,7 @@ describe('resource tools', () => {
     await expect(
       client.tools.list(
         {
+          filter: 'filter',
           include_all_versions: true,
           include_format: ['arcade'],
           limit: 0,