@praxisui/ai 5.0.0-beta.0 → 6.0.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +48 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,7 +1,41 @@
1
+ ---
2
+ title: "AI"
3
+ slug: "ai-overview"
4
+ description: "Overview of @praxisui/ai with backend-orchestrated provider flows, deterministic suggestions, patch generation, and tenant-aware risk policy."
5
+ doc_type: "guide"
6
+ document_kind: "component-overview"
7
+ component: "ai"
8
+ category: "components"
9
+ audience:
10
+ - "host"
11
+ - "frontend"
12
+ - "platform-team"
13
+ - "architect"
14
+ level: "intermediate"
15
+ status: "active"
16
+ owner: "praxis-ui"
17
+ toc: true
18
+ sidebar: true
19
+ icon: "smart_toy"
20
+ last_updated: "2026-04-08"
21
+ source_of_truth:
22
+ - "projects/praxis-ai/README.md"
23
+ - "projects/praxis-ai/docs/ai-deployment-flow.md"
24
+ related_docs:
25
+ - "core-public-surfaces-guide"
26
+ - "host-integration-guide"
27
+ ---
28
+
1
29
  # @praxisui/ai
2
30
 
3
31
  AI building blocks and assistant integration for Praxis UI applications. The package is designed for Angular hosts that need provider orchestration, metadata-aware UX and integration with the broader `@praxisui/*` ecosystem.
4
32
 
33
+ Short mental model:
34
+
35
+ - `@praxisui/ai` is not a direct wrapper around external LLM providers.
36
+ - the canonical path is backend orchestration through Praxis Config endpoints under `/api/praxis/config/ai/**`.
37
+ - the library helps the host compose suggestions, clarifications, risk policy, and patch application without turning AI into a host-local sidecar.
38
+
5
39
  ## Documentation
6
40
 
7
41
  - Official documentation: https://praxisui.dev
@@ -25,6 +59,20 @@ Peer dependencies (Angular v20):
25
59
  - Centralize provider and model validation behind backend-controlled endpoints
26
60
  - Apply tenant-aware confirmation and risk policies in enterprise environments
27
61
 
62
+ ## What this package is responsible for
63
+
64
+ - assistant UX surfaces and interaction flow
65
+ - backend API orchestration for provider catalog, suggestions, and patch generation
66
+ - local lightweight session history with tenant/env/user scoping
67
+ - confirmation and risk policy integration for sensitive changes
68
+
69
+ ## What this package does not own
70
+
71
+ - direct provider SDK integration when the backend contract already exists
72
+ - host auth, tenant resolution, or operational headers
73
+ - backend storage of provider keys or remote configuration policy
74
+ - domain-specific prompts that should stay in host or backend-owned configuration
75
+
28
76
  ## Build and test
29
77
 
30
78
  ```bash
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@praxisui/ai",
3
- "version": "5.0.0-beta.0",
3
+ "version": "6.0.0-beta.0",
4
4
  "description": "AI building blocks and assistant integration for Praxis UI applications.",
5
5
  "peerDependencies": {
6
6
  "@angular/common": "^20.3.0",
7
7
  "@angular/core": "^20.3.0",
8
- "@praxisui/core": "^5.0.0-beta.0"
8
+ "@praxisui/core": "^6.0.0-beta.0"
9
9
  },
10
10
  "dependencies": {
11
11
  "tslib": "^2.3.0"