@praxisui/ai 8.0.0-beta.32 → 8.0.0-beta.34

package/README.md

@@ -1,7 +1,7 @@
 ---
 title: "AI"
 slug: "ai-overview"
-description: "Overview of @praxisui/ai with backend-orchestrated provider flows, deterministic suggestions, patch generation, and tenant-aware risk policy."
+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"
@@ -27,13 +27,13 @@ related_docs:
 
 # @praxisui/ai
 
-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.
+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.
 
 Short mental model:
 
 - `@praxisui/ai` is not a direct wrapper around external LLM providers.
 - 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 patch application without turning AI into a host-local sidecar.
+- 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
 
@@ -54,7 +54,7 @@ Peer dependencies (Angular v20):
 
 ## When to use
 
-- Add AI-assisted suggestions and patch generation to Praxis UI components
+- Add AI-assisted consultation, clarification, and governed configuration proposals to Praxis UI components
 - Centralize provider and model validation behind backend-controlled endpoints
 - Apply tenant-aware confirmation and risk policies in enterprise environments
 
@@ -62,7 +62,7 @@ Peer dependencies (Angular v20):
 
 - assistant UX surfaces and interaction flow
 - reusable assistant shell primitives such as conversation messages, quick replies, prompt composer, governed actions, viewport-level drag/resize chrome, layout restore and minimized-session dock
-- backend API orchestration for provider catalog, suggestions, and patch generation
+- backend API orchestration for provider catalog, suggestions, structured proposals, and governed apply flows
 - local lightweight session history with tenant/env/user scoping
 - confirmation and risk policy integration for sensitive changes
 
@@ -237,6 +237,12 @@ Payload:
 Notes:
 - `currentState` must be the config root (not wrapped under `config`).
 - Clarifications may return `{ type: "clarification", message, options }`.
+- Responses may include `observationId`. `PraxisAiAssistantShellComponent` uses it to send write-only quality feedback to the backend triage endpoint without exposing prompt listings in public clients.
+
+### Assistant observation feedback
+- `POST /api/praxis/config/ai/triage/observations/{observationId}/feedback`
+
+`AiBackendApiService.sendAssistantObservationFeedback` posts `rating`, `reasonCode` and optional `comment` to the governed triage endpoint. The shell renders positive/negative feedback controls only when an assistant message has an `observationId`; listing observations remains an administrative backend capability, not a public UI concern.
 
 ### Agentic authoring manifest tools
 - `GET /api/praxis/config/ai/authoring/manifests/{componentId}`