@@ -0,0 +1,22 @@
+---
+"@object-ui/types": minor
+"@object-ui/i18n": minor
+"@object-ui/cli": minor
+---
+
+refactor(ui)!: retire `@object-ui/plugin-ai` and its three node types
+
+Clause-②: no (narrowing)
+Metadata-protocol: narrowed
+
+<!-- adr-0087: not-required (runtime-export-retired @object-ui/plugin-ai#*) the retired operands are React components of a published ui package that nothing in the workspace loaded; no packages/spec schema, no ADR-0087 conversion surface and no stored shape names them, so there is nothing for `objectstack migrate meta` to rewrite, and the three node literals are refused by name on the zod face -->
+
+**BREAKING.** `@object-ui/plugin-ai` is retired: `18.2.0` is its last published version, and it gets no further release. The console registered it neither eagerly nor lazily and no workspace package imported it, so the `ai-form-assist`, `ai-recommendations` and `nl-query` node types it registered rendered nowhere in the product.
+
+What leaves, and what to do:
+
+- FROM `@object-ui/plugin-ai` TO nothing: drop the `@object-ui/plugin-ai` import and dependency. A host that still wants the component keeps its own copy and registers it under its own type key.
+- Page nodes of type `ai-form-assist`, `ai-recommendations` or `nl-query`: remove them from the page. `safeValidateSchema` and `objectui validate` now refuse each of the three literals by name at `type`, with that remedy; before, the page rendered the "Unknown component type" panel in their place whenever the package was not loaded.
+- `@object-ui/types`: `AIFormAssistSchema`, `AIRecommendationsSchema`, `NLQuerySchema`, `AIConfig`, `AIFieldSuggestion`, `AIRecommendationItem`, `NLQueryResult`, `AIProvider` and `AIModelType` are `@deprecated` and now `never`, and `AnySchema` has no member for the three literals. The zod names (`AIFormAssistSchema` and the rest under `@object-ui/types/zod`, `AIComponentSchema` included) are `@deprecated` `z.never()` schemas that accept nothing. Remove every reference. The names stay importable until the tombstone sunset rule decides when they leave the published face.
+- `@object-ui/i18n`: the `ai.*` message block (`ai.nlQuery.*`, `ai.formAssist.*`, `ai.recommendations.*`) is gone from all ten packs. A host that registered overrides for those keys can delete them.
+- `@object-ui/cli`: `objectui check` no longer lists the three literals as known component types.
@@ -11,7 +11,6 @@
 '@object-ui/layout': patch
 '@object-ui/mobile': patch
 '@object-ui/permissions': patch
-'@object-ui/plugin-ai': patch
 '@object-ui/plugin-calendar': patch
 '@object-ui/plugin-charts': patch
 '@object-ui/plugin-chatbot': patch
 
@@ -94,7 +94,6 @@
       "@object-ui/layout",
       "@object-ui/mobile",
       "@object-ui/permissions",
-      "@object-ui/plugin-ai",
       "@object-ui/plugin-calendar",
       "@object-ui/plugin-charts",
       "@object-ui/plugin-chatbot",
 
@@ -504,7 +504,6 @@ Atoms and fields stay light; heavy widgets live in lazy-loaded plugins.
 | [`@object-ui/plugin-editor`](ui/packages/plugin-editor) | Rich text editor powered by Monaco |
 | [`@object-ui/plugin-markdown`](ui/packages/plugin-markdown) | Markdown rendering |
 | [`@object-ui/plugin-chatbot`](ui/packages/plugin-chatbot) | Chatbot interface |
-| [`@object-ui/plugin-ai`](ui/packages/plugin-ai) | Schema generation and conversational assistants (Vercel AI SDK) |
 
 #### Tooling
 
 
@@ -1,7 +1,6 @@
 {
   "title": "Plugins",
   "pages": [
-    "plugin-ai",
     "plugin-calendar",
     "plugin-calendar-view",
     "plugin-charts",
 
@@ -16,8 +16,8 @@
  * (`validateAuthoredDocument`, objectui#5250), whose root is the strict twin of
  * `AnyComponentSchema` — a union discriminated on `type`. A registered type
  * with no arm in that union is refused with one `invalid_union` issue at
- * `['type']`, whatever else the document says: `ai-form-assist`, which
- * `packages/plugin-ai/README.md` teaches, was one of them. The mirror-parity
+ * `['type']`, whatever else the document says: `ai-form-assist`, which the
+ * since-retired `@object-ui/plugin-ai` README taught, was one of them. The mirror-parity
  * ratchet in `@object-ui/types` counts declaration↔mirror PAIRS and the keys
  * inside them; a registered type with no mirror at all is in neither, so
  * nothing counted this family until this file.
@@ -379,7 +379,7 @@ describe('registered component types refused at `type` — a ratchet (objectui#1
     // was 200 until objectui#10859 batch 8 unregistered thirty bare keys.)
     expect(BARE_KEYS.length).toBeGreaterThan(150);
     expect(BARE_KEYS).toContain('timeline');
-    expect(BARE_KEYS).toContain('ai-form-assist');
+    expect(BARE_KEYS).toContain('pivot');
   });
 
   it('tells a claimed type from an unclaimed one — both instrument controls fire', () => {
@@ -392,11 +392,24 @@ describe('registered component types refused at `type` — a ratchet (objectui#1
     expect(refusedAtType('no-such-component-10859')).toBe(true);
   });
 
-  it('counts the three plugin-ai keys as armed (objectui#10859 batch 1)', () => {
+  it('refuses the three plugin-ai keys BY NAME at `type` — the package retired and their arms became refusals (objectstack#25921)', () => {
+    // objectui#10859 batch 1 armed them; the registrations left with
+    // `@object-ui/plugin-ai`, so registration and arm leaving in one change move
+    // neither count. Each arm stays as `retiredNodeType()`'s refusal, the
+    // `cloud:plan-status` shape below.
     for (const key of ['ai-form-assist', 'ai-recommendations', 'nl-query']) {
-      expect(BARE_KEYS, key).toContain(key);
+      expect(BARE_KEYS, key).not.toContain(key);
+      const result = validateAuthoredDocument({ type: key });
+      expect(result.success, key).toBe(false);
+      const named = (result.success ? [] : result.error.issues).filter(
+        (issue) => issue.code === 'custom' && issue.path.length === 1 && issue.path[0] === 'type',
+      );
+      expect(named, key).toHaveLength(1);
+      expect(named[0]?.message, key).toContain('@object-ui/plugin-ai');
       expect(refusedAtType(key), key).toBe(false);
     }
+    // Control: an unknown bare literal still takes the generic path.
+    expect(refusedAtType('ai-no-such-node-25921')).toBe(true);
   });
 
   it('counts the three keys batch 2 armed (objectui#10859 batch 2)', () => {
@@ -712,7 +725,6 @@ describe('registered NAMESPACED component types refused at `type` — a ratchet
 
 /** Rooted on this file, never on `process.cwd()`. */
 const HERE = dirname(fileURLToPath(import.meta.url));
-const PLUGIN_AI_README = join(HERE, '..', '..', '..', 'plugin-ai', 'README.md');
 const QUICK_START = join(HERE, '..', '..', '..', '..', 'content', 'docs', 'guide', 'quick-start.md');
 
 /** See `validate-root-path-line.test.ts` — the escape byte is never spelled. */
@@ -750,26 +762,6 @@ afterEach(() => {
   rmSync(dir, { recursive: true, force: true });
 });
 
-describe('objectui validate — the plugin-ai README document (objectui#10859)', () => {
-  it('validates the "Schema-Driven Usage" `ai-form-assist` document', async () => {
-    const readme = readFileSync(PLUGIN_AI_README, 'utf8');
-    const section = readme.slice(readme.indexOf('## Schema-Driven Usage'));
-    const fence = /```json\n([\s\S]*?)\n```/.exec(section);
-    expect(fence, 'no ```json fence under "## Schema-Driven Usage"').not.toBeNull();
-    const file = join(dir, 'ai-form-assist.json');
-    writeFileSync(file, (fence as RegExpExecArray)[1], 'utf-8');
-    // Lit control on the extraction: it is the taught node.
-    expect(JSON.parse((fence as RegExpExecArray)[1]).type).toBe('ai-form-assist');
-
-    await validate(file);
-
-    const text = out.join('\n').replace(ANSI, '');
-    expect(text).not.toContain('Schema validation failed');
-    expect(text).toContain('Schema is valid');
-    expect(exitCodes).toEqual([0]);
-  });
-});
-
 /* ── End to end: a page of public blocks through `objectui validate` ─────── */
 
 describe('objectui validate — a page built from ADR-0080 public blocks (objectui#10872)', () => {
 
@@ -39,8 +39,6 @@ export const KNOWN_SCHEMA_TYPES: readonly string[] = [
   'action:icon',
   'action:menu',
   'address',
-  'ai-form-assist',
-  'ai-recommendations',
   'ai:feedback',
   'ai:input',
   'ai:suggestion',
@@ -222,7 +220,6 @@ export const KNOWN_SCHEMA_TYPES: readonly string[] = [
   'nav:breadcrumb',
   'nav:menu',
   'navigation-menu',
-  'nl-query',
   'object-calendar',
   'object-chart',
   'object-data-table',
 
@@ -262,7 +262,6 @@ const NOT_CONTROLS: Array<[file: string, key: string, reason: string]> = [
 const BACKLOG: Array<[file: string, key: string]> = [
   // The data form preview selects a field by a click delegated from its frame.
   ['packages/app-shell/src/views/studio-design/StudioDesignSurface.tsx', 'div · closest,getAttribute,some,readFields,setFieldSel'],
-  ['packages/plugin-ai/src/AIRecommendations.tsx', 'div · handleSelect'],
   ['packages/plugin-designer/src/DashboardEditor.tsx', 'div · onSelect'],
   ['packages/plugin-designer/src/DataModelDesigner.tsx', 'span · stopPropagation,handleStartFieldEdit'],
   ['packages/plugin-designer/src/PageDesigner.tsx', 'div · stopPropagation,toggle'],
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Plugins",`
`3`	`3`	`"pages": [`
`4`		`- "plugin-ai",`
`5`	`4`	`"plugin-calendar",`
`6`	`5`	`"plugin-calendar-view",`
`7`	`6`	`"plugin-charts",`