ci: type-check examples/** and testing/** to catch call-site regressions (#820)

`test:pr`/`test:ci` excluded examples/** and testing/** from every target, so
`test:types` never checked the apps where the library is actually consumed —
call-site type regressions (e.g. a provider summarize adapter not assignable to
`summarize()`) slipped through CI. Because those surfaces were never type-checked,
they had also accumulated ~80 latent type errors.

CI wiring:
- test:pr / test:ci now run a second pass — `test:types` over examples/** and
  testing/** — after the existing packages-only run. Heavy targets (build/lib/...)
  stay excluded; only the cheap, high-value type check is added.
- Add `test:types:examples` convenience script and document the gate in CLAUDE.md.

Coverage:
- Add a `test:types` target to every example/testing project that lacked one
  (e2e, panel, react-native-chat, react-native-smoke). ts-angular-chat type-checks
  templates via `ngc`, resolved from an existing @angular/build peer (no new dep,
  no lockfile change).

Fixes (examples/testing drift from the current API; nothing under packages/**):
- ts-react-chat, ts-solid-chat, ts-code-mode-web: MediaPrompt, maxTokens→modelOptions,
  ContentPart[] narrowing, transport XOR.
- testing/e2e: drop poisoning `as never` model casts, fix adapter/tool typings,
  OpenRouter summarize httpClient header injection.
- testing/panel: AnyAdapter factory maps, AG-UI EventType migration, remove dead
  app.config.ts (Vinxi-era), rewrite createEventRecording to emit AG-UI StreamChunks.

Guard:
- packages/ai-grok/tests/summarize-callsite-type-safety.test.ts asserts the
  grokSummarize → summarize() contract in an included package (@ts-expect-error
  tracks the known #821 options-shape bug; flips positive when #835 lands).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: tombeckenham

CLAUDE.md

@@ -230,15 +230,16 @@ The single canonical command is:
 pnpm test:pr
 ```
 
-This runs the exact target set the `PR` workflow runs in CI (`nx affected --targets=test:sherif,test:knip,test:docs,test:eslint,test:lib,test:types,test:build,build --exclude=examples/**,testing/**`).
+This runs the exact target set the `PR` workflow runs in CI: first `nx affected --targets=test:sherif,test:knip,test:docs,test:kiira,test:eslint,test:lib,test:types,test:build,build --exclude=examples/**,testing/**` (the heavy targets, packages only), then a second `nx affected --targets=test:types --projects=examples/**,testing/**` pass that **does** type-check the example apps and `testing/` packages. The example/testing surfaces are deliberately excluded from the heavy targets (build/lib/etc.) but included for `test:types`, because call-site type regressions often only manifest where the library is actually consumed (see issue #820). Use `pnpm test:types:examples` to run just that second pass locally.
 
 If you can't run `test:pr` (e.g. it's too slow on your machine), at minimum run each of these and confirm they're green before pushing:
 
 - `pnpm test:sherif` — workspace consistency
 - `pnpm test:knip` — unused dependencies
 - `pnpm test:docs` — doc link verification
 - `pnpm test:eslint` — lint
-- `pnpm test:types` — typecheck
+- `pnpm test:types` — typecheck (packages)
+- `pnpm test:types:examples` — typecheck the example apps + `testing/` packages
 - `pnpm test:lib` — unit tests
 - `pnpm test:build` — build artifact verification
 - `pnpm build` — build all affected packages

examples/ts-angular-chat/package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "test:types": "node scripts/typecheck.mjs"
   },
   "dependencies": {
     "@angular/common": "^21.2.0",

examples/ts-angular-chat/scripts/typecheck.mjs

@@ -0,0 +1,28 @@
+// Type-check this Angular example, including template type-checking.
+//
+// Angular template type-checking (`strictTemplates`) requires the Angular
+// compiler (`ngc`), not plain `tsc`. `ngc` ships in `@angular/compiler-cli`,
+// which is a *peer* dependency of `@angular/build` (a direct devDependency of
+// this example). We resolve it from there instead of declaring it directly so
+// CI's frozen lockfile install stays unchanged.
+import { createRequire } from 'node:module'
+import { spawnSync } from 'node:child_process'
+import { dirname, join } from 'node:path'
+
+const require = createRequire(import.meta.url)
+
+// `@angular/compiler-cli` is resolvable from `@angular/build`'s location.
+const buildPkg = require.resolve('@angular/build/package.json')
+const cliPkgPath = require.resolve('@angular/compiler-cli/package.json', {
+  paths: [buildPkg],
+})
+const cliPkg = require(cliPkgPath)
+const ngc = join(dirname(cliPkgPath), cliPkg.bin.ngc)
+
+const { status } = spawnSync(
+  process.execPath,
+  [ngc, '-p', 'tsconfig.app.json', '--noEmit'],
+  { stdio: 'inherit' },
+)
+
+process.exit(status ?? 1)

examples/ts-angular-chat/src/app.component.ts

@@ -187,7 +187,7 @@ export class AppComponent {
 
   /** A message is worth rendering if it has visible text or a tool call. */
   isRenderable(message: {
-    parts: ReadonlyArray<{ type: string; content?: string }>
+    parts: ReadonlyArray<{ type: string; content?: unknown }>
   }): boolean {
     return message.parts.some(
       (part) =>

examples/ts-code-mode-web/src/lib/tool-result-content.ts

@@ -0,0 +1,31 @@
+import type { UIMessage } from '@tanstack/ai-react'
+
+type ToolResultPart = Extract<
+  UIMessage['parts'][number],
+  { type: 'tool-result' }
+>
+
+/** `string | Array<ContentPart>` — a tool result's raw content. */
+type ToolResultContent = ToolResultPart['content']
+
+type ContentPartItem = Exclude<ToolResultContent, string>[number]
+
+/**
+ * Reduce a tool-result part's `content` to a plain string for rendering.
+ *
+ * Tool results carry `string | Array<ContentPart>` (multimodal results are
+ * normalized to an array of content parts upstream). These demos render tool
+ * results as plain strings, so array content is flattened to the concatenation
+ * of its text parts; non-text parts (image, audio, video, document) have no
+ * string form here and are skipped.
+ */
+export function toolResultContentToString(content: ToolResultContent): string {
+  if (typeof content === 'string') return content
+  return content
+    .filter(
+      (part): part is Extract<ContentPartItem, { type: 'text' }> =>
+        part.type === 'text',
+    )
+    .map((part) => part.content)
+    .join('')
+}

examples/ts-code-mode-web/src/routes/_banking-demo/banking-demo.tsx

@@ -18,6 +18,7 @@ import {
 } from '@/components/reports/useReportSSE'
 import ChatInput from '@/components/ChatInput'
 import { Header } from '@/components'
+import { toolResultContentToString } from '@/lib/tool-result-content'
 import { applyUIEvent, applyUIUpdates } from '@/lib/reports/apply-event'
 import type {
   RefreshResult,
@@ -159,7 +160,7 @@ function Messages({ messages }: { messages: Array<UIMessage> }) {
         for (const p of message.parts) {
           if (p.type === 'tool-result') {
             toolResults.set(p.toolCallId, {
-              content: p.content,
+              content: toolResultContentToString(p.content),
               state: p.state,
               error: p.error,
             })

examples/ts-code-mode-web/src/routes/_database-demo/api.database-demo.ts

@@ -17,6 +17,7 @@ import type { AnyTextAdapter, ServerTool, StreamChunk } from '@tanstack/ai'
 import type { IsolateDriver } from '@tanstack/ai-code-mode'
 
 import { databaseTools, getSchemaInfoTool } from '@/lib/tools/database-tools'
+import { maxTokensModelOptions } from '@/lib/max-tokens-model-options'
 
 type Provider = 'anthropic' | 'openai' | 'gemini'
 
@@ -284,7 +285,7 @@ export const Route = createFileRoute(
             systemPrompts,
             agentLoopStrategy: maxIterations(15),
             abortController,
-            maxTokens: 8192,
+            modelOptions: maxTokensModelOptions(rawAdapter, 8192),
           })
 
           const instrumentedStream = wrapWithTimingEvents(stream, rawAdapter)

examples/ts-code-mode-web/src/routes/_database-demo/database-demo.tsx

@@ -23,6 +23,7 @@ import type { VMEvent } from '@/components'
 import { CodeBlock, ExecutionResult, JavaScriptVM, Header } from '@/components'
 import ChatInput from '@/components/ChatInput'
 import { formatDuration } from '@/lib/efficiency'
+import { toolResultContentToString } from '@/lib/tool-result-content'
 
 export const Route = createFileRoute('/_database-demo/database-demo' as any)({
   component: DatabaseDemoPage,
@@ -378,7 +379,7 @@ function Messages({
         for (const p of message.parts) {
           if (p.type === 'tool-result') {
             toolResults.set(p.toolCallId, {
-              content: p.content,
+              content: toolResultContentToString(p.content),
               state: p.state,
               error: p.error,
             })

examples/ts-code-mode-web/src/routes/_home/api.product-regular.ts

@@ -5,6 +5,7 @@ import { openaiText } from '@tanstack/ai-openai'
 import { geminiText } from '@tanstack/ai-gemini'
 import type { AnyTextAdapter, StreamChunk } from '@tanstack/ai'
 import { productTools } from '@/lib/tools/product-tools'
+import { maxTokensModelOptions } from '@/lib/max-tokens-model-options'
 
 type Provider = 'anthropic' | 'openai' | 'gemini'
 
@@ -90,7 +91,7 @@ export const Route = createFileRoute('/_home/api/product-regular')({
             ],
             agentLoopStrategy: maxIterations(30),
             abortController,
-            maxTokens: 8192,
+            modelOptions: maxTokensModelOptions(adapter, 8192),
           })
 
           const requestStartTimeMs = Date.now()

examples/ts-code-mode-web/src/routes/_home/index.tsx

@@ -18,6 +18,7 @@ import { parsePartialJSON } from '@tanstack/ai'
 import { fetchServerSentEvents, useChat } from '@tanstack/ai-react'
 import type { VMEvent } from '@/components'
 import { CodeBlock, ExecutionResult, JavaScriptVM, Header } from '@/components'
+import { toolResultContentToString } from '@/lib/tool-result-content'
 
 export const Route = createFileRoute('/_home/')({
   component: ProductDemoPage,
@@ -792,7 +793,7 @@ function CodeModePanel({
             for (const p of message.parts) {
               if (p.type === 'tool-result') {
                 toolResults.set(p.toolCallId, {
-                  content: p.content,
+                  content: toolResultContentToString(p.content),
                   state: p.state,
                   error: p.error,
                 })
@@ -1088,7 +1089,7 @@ function RegularToolsPanel({
             for (const part of message.parts) {
               if (part.type === 'tool-result') {
                 toolResults.set(part.toolCallId, {
-                  content: part.content,
+                  content: toolResultContentToString(part.content),
                   state: part.state,
                   error: part.error,
                 })