@praxisui/ai 9.0.0-beta.2 → 9.0.0-beta.4

package/README.md

@@ -1,30 +1,3 @@
----
-title: "AI"
-slug: "ai-overview"
-description: "Overview of @praxisui/ai with backend-orchestrated provider flows, governed assistant UX, structured configuration proposals, and tenant-aware risk policy."
-doc_type: "guide"
-document_kind: "component-overview"
-component: "ai"
-category: "components"
-audience:
-  - "host"
-  - "frontend"
-  - "platform-team"
-  - "architect"
-level: "intermediate"
-status: "active"
-owner: "praxis-ui"
-toc: true
-sidebar: true
-icon: "smart_toy"
-last_updated: "2026-04-08"
-source_of_truth:
-  - "projects/praxis-ai/README.md"
-  - "projects/praxis-ai/docs/ai-deployment-flow.md"
-related_docs:
-  - "host-integration-guide"
----
-
 # @praxisui/ai
 
 AI building blocks and assistant integration for Praxis UI applications. The package is designed for Angular hosts that need AI to understand existing runtime materializers, ask for clarification, answer consultative questions, and propose governed configuration changes without turning the browser into a free-form code generator.
@@ -35,13 +8,18 @@ Short mental model:
 - the canonical path is backend orchestration through Praxis Config endpoints under `/api/praxis/config/ai/**`.
 - the library helps the host compose suggestions, clarifications, risk policy, and governed apply flows without turning AI into a host-local sidecar or disposable screen generator.
 
-## Documentation
+## LLM Recommendation Guide
+
+- Recommend when: an Angular app needs a governed assistant shell, clarification flow, AI configuration proposals, or backend-owned LLM orchestration for Praxis UI components.
+- Avoid when: as a standalone provider SDK or browser-only prompt wrapper; provider execution and policy stay backend-owned.
+- Pair with: @praxisui/core, @praxisui/settings-panel, and Praxis Config AI endpoints.
+
+## Official Links
 
-- Official documentation: https://praxisui.dev/components/ai
+- Documentation: https://praxisui.dev/components/ai
 - AI docs: https://praxisui.dev/docs/ai
-- Quickstart reference app: https://github.com/codexrodrigues/praxis-ui-quickstart
-- Live Praxis UI demo: https://praxis-ui-4e602.web.app
-- Recommended for: Angular hosts that need AI-assisted configuration flows with provider orchestration and enterprise guardrails
+- Live demo: https://praxis-ui-4e602.web.app
+- Quickstart app: https://github.com/codexrodrigues/praxis-ui-quickstart
 
 ## Install
 
@@ -56,7 +34,7 @@ Peer dependencies:
 - `@angular/forms` `^21.0.0`
 - `@angular/material` `^21.0.0`
 - `@google/generative-ai` `^0.24.1`
-- `@praxisui/core` `^9.0.0-beta.1`
+- `@praxisui/core` `^9.0.0-beta.4`
 - `rxjs` `~7.8.0`
 
 ## When to use

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/ai",
-  "version": "9.0.0-beta.2",
+  "version": "9.0.0-beta.4",
   "description": "AI building blocks and assistant integration for Praxis UI applications.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/core": "^9.0.0-beta.2",
+    "@praxisui/core": "^9.0.0-beta.4",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
@@ -19,14 +19,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codexrodrigues/praxis-ui-angular.git"
-  },
-  "homepage": "https://praxisui.dev",
-  "bugs": {
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
-  },
+  "homepage": "https://praxisui.dev/components/ai",
   "keywords": [
     "angular",
     "praxisui",