@praxisui/ai 8.0.0-beta.104 → 8.0.0-beta.106
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.
- package/README.md +45 -6
- package/fesm2022/praxisui-ai.mjs +192 -20
- package/package.json +2 -2
- package/types/praxisui-ai.d.ts +40 -1
package/README.md
CHANGED
|
@@ -37,20 +37,27 @@ Short mental model:
|
|
|
37
37
|
|
|
38
38
|
## Documentation
|
|
39
39
|
|
|
40
|
-
- Official documentation: https://praxisui.dev
|
|
40
|
+
- Official documentation: https://praxisui.dev/components/ai
|
|
41
|
+
- AI docs: https://praxisui.dev/docs/ai
|
|
41
42
|
- Quickstart reference app: https://github.com/codexrodrigues/praxis-ui-quickstart
|
|
43
|
+
- Live Praxis UI demo: https://praxis-ui-4e602.web.app
|
|
42
44
|
- Recommended for: Angular hosts that need AI-assisted configuration flows with provider orchestration and enterprise guardrails
|
|
43
45
|
|
|
44
46
|
## Install
|
|
45
47
|
|
|
46
48
|
```bash
|
|
47
|
-
npm i @praxisui/ai
|
|
49
|
+
npm i @praxisui/ai@beta
|
|
48
50
|
```
|
|
49
51
|
|
|
50
|
-
Peer dependencies
|
|
51
|
-
- `@angular/core` `^
|
|
52
|
-
- `@angular/common` `^
|
|
53
|
-
- `@
|
|
52
|
+
Peer dependencies:
|
|
53
|
+
- `@angular/core` `^21.0.0`
|
|
54
|
+
- `@angular/common` `^21.0.0`
|
|
55
|
+
- `@angular/cdk` `^21.0.0`
|
|
56
|
+
- `@angular/forms` `^21.0.0`
|
|
57
|
+
- `@angular/material` `^21.0.0`
|
|
58
|
+
- `@google/generative-ai` `^0.24.1`
|
|
59
|
+
- `@praxisui/core` `^8.0.0-beta.106`
|
|
60
|
+
- `rxjs` `~7.8.0`
|
|
54
61
|
|
|
55
62
|
## When to use
|
|
56
63
|
|
|
@@ -58,6 +65,38 @@ Peer dependencies (Angular v20):
|
|
|
58
65
|
- Centralize provider and model validation behind backend-controlled endpoints
|
|
59
66
|
- Apply tenant-aware confirmation and risk policies in enterprise environments
|
|
60
67
|
|
|
68
|
+
## Minimal standalone shell
|
|
69
|
+
|
|
70
|
+
Use the shell for governed assistant UX. The host still owns the backend flow,
|
|
71
|
+
safe context, storage, and apply semantics.
|
|
72
|
+
|
|
73
|
+
```ts
|
|
74
|
+
import { Component } from '@angular/core';
|
|
75
|
+
import { PraxisAiAssistantShellComponent } from '@praxisui/ai';
|
|
76
|
+
|
|
77
|
+
@Component({
|
|
78
|
+
selector: 'app-ai-assistant-entry',
|
|
79
|
+
standalone: true,
|
|
80
|
+
imports: [PraxisAiAssistantShellComponent],
|
|
81
|
+
template: `
|
|
82
|
+
<praxis-ai-assistant-shell
|
|
83
|
+
mode="agentic-authoring"
|
|
84
|
+
state="idle"
|
|
85
|
+
[messages]="messages"
|
|
86
|
+
[contextItems]="contextItems"
|
|
87
|
+
(submitPrompt)="submitPrompt($event)" />
|
|
88
|
+
`,
|
|
89
|
+
})
|
|
90
|
+
export class AiAssistantEntryComponent {
|
|
91
|
+
messages = [];
|
|
92
|
+
contextItems = [{ label: 'Surface', value: 'Page Builder' }];
|
|
93
|
+
|
|
94
|
+
submitPrompt(prompt: string): void {
|
|
95
|
+
// Forward to the backend-owned Praxis Config AI flow.
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
61
100
|
## What this package is responsible for
|
|
62
101
|
|
|
63
102
|
- assistant UX surfaces and interaction flow
|