chore(ai-sdk): support AI SDK v7 and test the full peer range

.github/workflows/ci.yaml

@@ -60,6 +60,44 @@ jobs:
       - name: Run Tests
         run: pnpm test
 
+  # The `ai` peer range spans three majors whose tool types differ, so the
+  # single build-and-test job above only ever proves the version pinned in the
+  # dev catalog. This job checks the rest of the declared range.
+  #
+  # Versions are pinned rather than ranged: newer v5/v6 patches resolve
+  # transitive packages that this repo's `trustPolicy: no-downgrade` rejects,
+  # which would fail CI for reasons unrelated to the code under test.
+  ai-peer-range:
+    name: ai-peer-range (${{ matrix.ai }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ai:
+          - 5.0.108 # lower bound of the peer range
+          - 6.0.7 # last v6 the dev catalog shipped
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Nix
+        uses: ./.github/actions/setup-nix
+        with:
+          skip-pnpm-install: 'true'
+
+      # `--filter .` keeps the examples workspace out of resolution; it pulls a
+      # dependency that `blockExoticSubdeps` rejects on any lockfile update.
+      - name: Install with ai@${{ matrix.ai }}
+        run: |
+          sed -i -E "/^  dev:/,/^  [a-z]+:/ s|^    ai: .*|    ai: '${{ matrix.ai }}'|" pnpm-workspace.yaml
+          grep -nE "^    ai: " pnpm-workspace.yaml
+          pnpm install --no-frozen-lockfile --filter .
+
+      # Type errors are the failure mode here, and vitest type-checks the suite
+      # via the root project's `typecheck` config.
+      - name: Run Tests
+        run: pnpm exec vitest run --project root
+
   coverage:
     runs-on: ubuntu-latest
     if: github.ref == 'refs/heads/main'

README.md

@@ -196,9 +196,11 @@ await anthropic.messages.create({
 npm install @stackone/ai ai @ai-sdk/openai  # or: yarn/pnpm/bun add
 ```
 
+> Supports AI SDK v5–v7 (`ai` `>=5.0.108 <8.0.0`). AI SDK v7 requires Node.js 22+.
+
 ```typescript
 import { openai } from '@ai-sdk/openai';
-import { generateText } from 'ai';
+import { generateText, stepCountIs } from 'ai';
 import { StackOneToolSet } from '@stackone/ai';
 
 // Reads STACKONE_API_KEY and STACKONE_ACCOUNT_ID from environment
@@ -209,7 +211,7 @@ const tools = await toolset.fetchTools();
 await generateText({
 	model: openai('gpt-5.1'),
 	tools: await tools.toAISDK(),
-	maxSteps: 3,
+	stopWhen: stepCountIs(3),
 });
 ```
 

examples/README.md

@@ -60,7 +60,7 @@ Converts StackOne tools to Anthropic format with `tools.toAnthropic()` and sends
 
 ### [`ai-sdk-integration.ts`](./ai-sdk-integration.ts) -- Vercel AI SDK
 
-Integrates with the Vercel AI SDK via `tools.toAISDK()`. Runs a multi-step agent loop using `generateText` with `stopWhen: stepCountIs(3)`, letting the model autonomously call tools and reason over results.
+Integrates with the Vercel AI SDK via `tools.toAISDK()`. Runs a multi-step agent loop using `generateText` with `stopWhen: stepCountIs(3)`, letting the model autonomously call tools and reason over results. Compatible with AI SDK v5–v7; AI SDK v7 requires Node.js 22+.
 
 ### [`claude-agent-sdk-integration.ts`](./claude-agent-sdk-integration.ts) -- Claude Agent SDK
 

examples/ai-sdk-integration.ts

@@ -6,8 +6,10 @@
  * can autonomously call tools and reason over results until the stop condition
  * is met.
  *
- * In AI SDK v6+, you can use the `ToolLoopAgent` class for more explicit
- * agent functionality.
+ * Compatible with AI SDK v5–v7 (`ai` peer `>=5.0.108 <8.0.0`). Uses
+ * `stepCountIs`, which exists in v5/v6 and remains available as an alias in v7.
+ * AI SDK v7 requires Node.js 22+. You can also use the `ToolLoopAgent` class
+ * for more explicit agent functionality.
  */
 
 import process from 'node:process';