chore: remove stale PHP and Python packages (#643)

* chore: remove stale PHP and Python packages (closes #642)

Drop the PHP and Python packages and their example apps. TanStack AI now
focuses exclusively on TypeScript; AG-UI handles interop with non-JS
servers, so first-party PHP/Python clients are no longer maintained.

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

* chore: flatten packages/typescript/* into packages/*

The `typescript/` nesting was a leftover from when other-language packages
lived alongside it. With those gone (commit bda114e), the extra level is
just noise. Moves all 31 packages with `git mv` so blame/history follow,
then updates workspace globs, tsconfig extends, package.json `directory`
fields, scripts, CI, docs, lockfile, and CLAUDE.md accordingly.

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

* ci: apply automated fixes

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: 3 people

.agent/self-learning/coupling.json

@@ -3,20 +3,20 @@
   "couplings": [
     {
       "id": "ai-source-touches-agent-skills",
-      "trigger": "packages/typescript/ai*/src/**/*.ts",
+      "trigger": "packages/ai*/src/**/*.ts",
       "impacts": [
         {
           "target": [
-            "packages/typescript/ai/skills/ai-core/structured-outputs/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/chat-experience/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/tool-calling/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/adapter-configuration/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/middleware/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/media-generation/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/ag-ui-protocol/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/debug-logging/SKILL.md",
-            "packages/typescript/ai/skills/ai-core/custom-backend-integration/SKILL.md",
-            "packages/typescript/ai-code-mode/skills/ai-code-mode/SKILL.md"
+            "packages/ai/skills/ai-core/structured-outputs/SKILL.md",
+            "packages/ai/skills/ai-core/chat-experience/SKILL.md",
+            "packages/ai/skills/ai-core/tool-calling/SKILL.md",
+            "packages/ai/skills/ai-core/adapter-configuration/SKILL.md",
+            "packages/ai/skills/ai-core/middleware/SKILL.md",
+            "packages/ai/skills/ai-core/media-generation/SKILL.md",
+            "packages/ai/skills/ai-core/ag-ui-protocol/SKILL.md",
+            "packages/ai/skills/ai-core/debug-logging/SKILL.md",
+            "packages/ai/skills/ai-core/custom-backend-integration/SKILL.md",
+            "packages/ai-code-mode/skills/ai-code-mode/SKILL.md"
           ],
           "kind": "change-required",
           "why": "Agent skills are a contract with downstream coding agents. When the source surface they cover changes (new public API, changed type, new pattern, removed pattern, deprecation), the skill must be updated in the same PR — otherwise agents reading the skill keep generating obsolete or wrong code targeting a surface that no longer exists. Use this list to decide which skill(s) cover the file you're touching: `activities/chat/**` → chat-experience / structured-outputs / tool-calling; `activities/generateImage|generateAudio|generateVideo|generateSpeech|generateTranscription|summarize/**` → media-generation; `middleware/**` → middleware; `protocol/**` → ag-ui-protocol; `adapters/**` or anything that affects the adapter contract → adapter-configuration. Skip only for pure refactors / perf / internal-only changes that don't surface a new pattern or change observable behavior."
@@ -25,7 +25,7 @@
     },
     {
       "id": "ai-source-touches-public-docs",
-      "trigger": "packages/typescript/ai*/src/**/*.ts",
+      "trigger": "packages/ai*/src/**/*.ts",
       "impacts": [
         {
           "target": [
@@ -48,7 +48,7 @@
     },
     {
       "id": "ai-source-touches-e2e-coverage",
-      "trigger": "packages/typescript/ai*/src/**/*.ts",
+      "trigger": "packages/ai*/src/**/*.ts",
       "impacts": [
         {
           "target": [

.agent/self-learning/lessons/2026-05-14-build-before-running-examples.md

@@ -12,7 +12,7 @@ related: []
 
 # Build Workspace Packages Before Running Examples
 
-**Rule:** Run `pnpm -w run build:all` from the repo root before starting any example dev server (`examples/ts-react-chat`, `ts-solid-chat`, `ts-vue-chat`, `ts-svelte-chat`, `vanilla-chat`, `php-slim`, `python-fastapi`, `ts-group-chat`).
+**Rule:** Run `pnpm -w run build:all` from the repo root before starting any example dev server (`examples/ts-react-chat`, `ts-solid-chat`, `ts-vue-chat`, `ts-svelte-chat`, `vanilla-chat`, `ts-group-chat`).
 
 **Why:** "this was a mistake by you, you should always build packages inside of this repo before you run the examples" — examples import workspace packages (`@tanstack/ai`, `@tanstack/react-ai-devtools`, `@tanstack/ai-devtools-core`, etc.) via `workspace:*` and resolve through each package's `exports` field pointing at `dist/`. If `dist/` is missing for any package — including transitive ones — vite's dep-scan fails and SSR returns a 500. Fixing the first missing package one at a time wastes round-trips: I tried `pnpm --filter @tanstack/react-ai-devtools build`, hit a missing `@tanstack/ai-devtools-core`, etc. The cure is one command up front.
 

.agent/self-learning/lessons/2026-05-19-update-skills-with-feature-work.md

@@ -12,13 +12,13 @@ related: [update-docs-with-new-cases]
 
 # Agent Skills Need to Be Updated With the Feature Work That Touches Them
 
-**Rule:** When implementing a feature that changes or extends a surface covered by an agent skill under `packages/typescript/ai/skills/**` or `packages/typescript/ai-code-mode/skills/**`, update the skill in the same PR. Don't treat skill updates as a follow-up — they ship to coding agents that read them as authoritative.
+**Rule:** When implementing a feature that changes or extends a surface covered by an agent skill under `packages/ai/skills/**` or `packages/ai-code-mode/skills/**`, update the skill in the same PR. Don't treat skill updates as a follow-up — they ship to coding agents that read them as authoritative.
 
 **Why:** The user pointed this out after I'd already landed code, docs, e2e tests, and the example UI for the multi-turn structured-output PR (#577) without touching `ai-core/structured-outputs/SKILL.md`. The skill was still documenting the old single-slot `partial` / `final` design and still telling agents to filter `TextPart`s out of `useChat` renderers — the exact hack the PR removes. Without the skill update, every coding agent reading that skill would continue generating the obsolete pattern. Skills are a contract with downstream agents the same way the public API is a contract with users.
 
 **How to apply:**
 
-1. **Before shipping any non-trivial feature**, grep `packages/typescript/ai*/skills/**/SKILL.md` for the symbols, types, hooks, or patterns the feature touches. If any skill mentions them, that skill needs review.
+1. **Before shipping any non-trivial feature**, grep `packages/ai*/skills/**/SKILL.md` for the symbols, types, hooks, or patterns the feature touches. If any skill mentions them, that skill needs review.
 2. **Check both directions:** does the skill teach something the feature now makes wrong? Does the feature introduce a pattern the skill should add? Both warrant edits.
 3. **Update in the same PR as the feature code.** Splitting into a follow-up means the skill is stale during the window between merges — and during that window, agents reading the skill generate broken code that targets a surface that no longer exists.
 4. **After updating, fact-check the skill the same way as the docs** — dispatch a verification pass against the current source code. Hallucinations in skills propagate further than hallucinations in docs because agents act on them autonomously.

.changeset/config.json

@@ -15,8 +15,6 @@
     "@tanstack/ai-code-mode-models-eval",
     "@tanstack/ai-e2e",
     "stream-processor-panel",
-    "php-slim",
-    "python-fastapi",
     "ts-*",
     "vanilla-chat"
   ],

.changeset/remove-php-and-python-packages.md

@@ -0,0 +1,13 @@
+---
+---
+
+Remove the stale PHP and Python packages and their example apps. TanStack AI now focuses exclusively on TypeScript; AG-UI handles interop with non-JS servers, so first-party PHP/Python clients are no longer maintained.
+
+Removed:
+
+- `packages/php/tanstack-ai` (composer package `tanstack/ai`)
+- `packages/python/tanstack-ai` (PyPI package `tanstack-ai`)
+- `examples/php-slim`
+- `examples/python-fastapi`
+
+No published `@tanstack/*` npm packages are affected.

.claude/settings.json

@@ -34,7 +34,7 @@
       "Bash(pnpm --filter @tanstack/ai-vue test:lib)",
       "Bash(pnpm --filter @tanstack/ai-svelte test:lib)",
       "Bash(pnpm test:docs)",
-      "Bash(npx vitest run packages/typescript/ai-vue/tests/use-generation.test.ts)",
+      "Bash(npx vitest run packages/ai-vue/tests/use-generation.test.ts)",
       "Bash(pnpm test:types)",
       "Bash(npx tsr generate)",
       "Bash(npx nx run ts-react-media:build)",

.claude/skills/gap-analysis/SKILL.md

@@ -29,9 +29,9 @@ markdown report under `.agent/gap-analysis/`. **Do not edit source files.**
 2. **Load the truth files**, then read the per-scope inputs you need:
    - Matrix: `testing/e2e/src/lib/feature-support.ts`
    - Types: `testing/e2e/src/lib/types.ts` (Provider + Feature unions, ALL_PROVIDERS, ALL_FEATURES)
-   - Adapter index: `packages/typescript/ai-<provider>/src/index.ts`
-   - Model meta: `packages/typescript/ai-<provider>/src/model-meta.ts`
-   - Core types: `packages/typescript/ai/src/types.ts` (Modality, ContentPart, ToolCall)
+   - Adapter index: `packages/ai-<provider>/src/index.ts`
+   - Model meta: `packages/ai-<provider>/src/model-meta.ts`
+   - Core types: `packages/ai/src/types.ts` (Modality, ContentPart, ToolCall)
 3. **Research upstream.** Use WebFetch against the curated URLs in
    [references/provider-doc-urls.md](references/provider-doc-urls.md). When a
    doc page has moved, fall back to WebSearch. For SDK API surface details

.claude/skills/gap-analysis/references/audit-checklist.md

@@ -8,7 +8,7 @@ final report. Skip dimensions that don't apply to the scope (e.g.,
 
 ## 1. New models
 
-**Input:** `packages/typescript/ai-<provider>/src/model-meta.ts`
+**Input:** `packages/ai-<provider>/src/model-meta.ts`
 **Upstream:** the provider's models page (see provider-doc-urls.md).
 
 Steps:
@@ -116,7 +116,7 @@ Steps:
    - Computer use / browser tools
    - Memory / sessions
 3. Cross-check by grep'ing the adapter source:
-   - `Grep "<capability-keyword>" packages/typescript/ai-<provider>/src/`
+   - `Grep "<capability-keyword>" packages/ai-<provider>/src/`
    - If zero matches → likely untracked.
 4. For each untracked feature, note:
    - Upstream URL
@@ -166,7 +166,7 @@ Steps:
 ## 5. Telemetry / observability parity
 
 **Input:** every adapter's stream-emit and final-response paths in
-`packages/typescript/ai-<provider>/src/adapters/*.ts`.
+`packages/ai-<provider>/src/adapters/*.ts`.
 **Upstream:** the provider's API reference for the response envelope (usage,
 cost, cache, reasoning, request-id, safety/moderation fields).
 
@@ -180,7 +180,7 @@ Steps:
 
 1. For each adapter, grep the streaming and non-streaming paths for the
    fields it forwards into `StreamChunk` / final response usage:
-   - `Grep "usage|promptTokens|completionTokens|cached|reasoning|cache_creation|cache_read" packages/typescript/ai-<provider>/src/adapters/`
+   - `Grep "usage|promptTokens|completionTokens|cached|reasoning|cache_creation|cache_read" packages/ai-<provider>/src/adapters/`
 2. Build a cross-adapter table of which fields each adapter emits. Rows
    below are examples — extend per provider:
 
@@ -222,7 +222,7 @@ Steps:
 When fan-out is needed, launch one `Explore` subagent per provider with a
 prompt of this shape:
 
-> Audit the `<provider>` adapter at `packages/typescript/ai-<provider>/`
+> Audit the `<provider>` adapter at `packages/ai-<provider>/`
 > against upstream docs at the URLs in
 > `.claude/skills/gap-analysis/references/provider-doc-urls.md`. Walk
 > dimensions 1, 3, 4, and 5 from `audit-checklist.md`. Skip dimension 2

.claude/skills/gap-analysis/references/report-template.md

@@ -19,7 +19,7 @@ Replace every `{{placeholder}}`. Drop sections that have zero entries
 # Gap Analysis — {{scope-human}} — {{YYYY-MM-DD}}
 
 > Source-of-truth matrix: `testing/e2e/src/lib/feature-support.ts`
-> Local model lists: `packages/typescript/ai-*/src/model-meta.ts`
+> Local model lists: `packages/ai-*/src/model-meta.ts`
 > Generated by `.claude/skills/gap-analysis` — review before applying.
 
 ## Summary
@@ -51,7 +51,7 @@ Replace every `{{placeholder}}`. Drop sections that have zero entries
 
 - **[{{provider}}]** missing models: `{{model-id}}` ({{context-window}}, {{kn-cutoff}}), `{{model-id}}` ({{…}})
   - Upstream: [{{provider models page}}]({{url}})
-  - Suggested addition to `packages/typescript/ai-{{provider}}/src/model-meta.ts`:
+  - Suggested addition to `packages/ai-{{provider}}/src/model-meta.ts`:
     ```ts
     {{paste-ready ModelMeta entry skeleton}}
     ```
@@ -87,7 +87,7 @@ Replace every `{{placeholder}}`. Drop sections that have zero entries
   `cache_read_input_tokens`, `reasoning_tokens`, `cached_tokens`).
   - Upstream evidence: [{{doc-title}}]({{doc-url}})
   - Sibling adapters that already forward it: {{list}}
-  - Adapter path: `packages/typescript/ai-{{provider}}/src/adapters/{{file}}:{{line}}`
+  - Adapter path: `packages/ai-{{provider}}/src/adapters/{{file}}:{{line}}`
   - Effort: {{S / M / L}}
 
 - **[{{provider}}] logging asymmetry** — {{e.g., adapter swallows parse

.github/workflows/pr.yml

@@ -47,7 +47,7 @@ jobs:
       - name: Build Packages
         run: pnpm run build:all
       - name: Publish Previews
-        run: pnpx pkg-pr-new publish --pnpm './packages/typescript/*'
+        run: pnpx pkg-pr-new publish --pnpm './packages/*'
   version-preview:
     name: Version Preview
     runs-on: ubuntu-latest