@applica-software-guru/persona-chat-sdk 0.1.102 → 0.1.104
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 +52 -22
- package/bitbucket-pipelines.yml +1 -0
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,33 +1,63 @@
|
|
|
1
|
-
# Persona Chat SDK
|
|
1
|
+
# Persona Chat SDK
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@applica-software-guru/persona-chat-sdk)
|
|
4
4
|
[](#)
|
|
5
|
-
[](docs/README.md)
|
|
6
5
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
6
|
+
Official Chat SDK for the Persona API. It provides a simple and efficient way to integrate the Persona API into your applications using [assistant-ui](https://www.assistant-ui.com/).
|
|
7
|
+
|
|
8
|
+
## Quick Start
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
npm install @applica-software-guru/persona-chat-sdk
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
```tsx
|
|
15
|
+
import { PersonaRuntimeProvider, PersonaConsoleLogger } from '@applica-software-guru/persona-chat-sdk';
|
|
16
|
+
|
|
17
|
+
const logger = new PersonaConsoleLogger();
|
|
18
|
+
|
|
19
|
+
function Chat() {
|
|
20
|
+
return (
|
|
21
|
+
<PersonaRuntimeProvider
|
|
22
|
+
logger={logger}
|
|
23
|
+
protocols={{ rest: true, websocket: true }}
|
|
24
|
+
session="your-session-id"
|
|
25
|
+
apiKey="your-api-key"
|
|
26
|
+
agentId="your-agent-id"
|
|
27
|
+
>
|
|
28
|
+
<Thread />
|
|
29
|
+
</PersonaRuntimeProvider>
|
|
30
|
+
);
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Features
|
|
35
|
+
|
|
36
|
+
- **Multiple Protocols** — REST, WebSocket, WebRTC with automatic fallback
|
|
37
|
+
- **Real-time Audio** — WebRTC peer-to-peer audio with minimal latency
|
|
38
|
+
- **Tool Execution** — Define custom tools with `createTool()` for function calling
|
|
39
|
+
- **Thread Management** — Built-in multi-thread support with persistence
|
|
40
|
+
- **Message Filtering** — Filter and transform messages before display
|
|
41
|
+
- **Custom Storage** — Pluggable message storage (memory, localStorage, or custom)
|
|
42
|
+
- **React Integration** — First-class support via assistant-ui components
|
|
43
|
+
|
|
44
|
+
## Documentation
|
|
45
|
+
|
|
46
|
+
| Section | Description |
|
|
47
|
+
|---|---|
|
|
48
|
+
| [Installation](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/installation.md) | Setup and dependencies |
|
|
49
|
+
| [Usage](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/usage.md) | Integration guide with Next.js |
|
|
50
|
+
| [Messages & Storage](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/messages.md) | Message access, filtering and persistence |
|
|
51
|
+
| [Protocols](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/protocols.md) | REST, WebSocket, WebRTC overview |
|
|
52
|
+
| [API Reference](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/api-reference.md) | Props and configuration |
|
|
53
|
+
| [Transactions & Tools](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/transactions.md) | Custom tool definitions |
|
|
54
|
+
| [Customization](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/customization.md) | Custom protocols and loggers |
|
|
55
|
+
| [Contributing](https://bitbucket.org/applicaguru/persona-sdk-chat/src/main/docs/contributing.md) | How to contribute |
|
|
24
56
|
|
|
25
57
|
## Support
|
|
26
58
|
|
|
27
59
|
For questions or support, contact us at [info@applica.guru](mailto:info@applica.guru).
|
|
28
60
|
|
|
29
|
-
---
|
|
30
|
-
|
|
31
61
|
## License
|
|
32
62
|
|
|
33
|
-
|
|
63
|
+
MIT
|
package/bitbucket-pipelines.yml
CHANGED
|
@@ -15,5 +15,6 @@ pipelines:
|
|
|
15
15
|
variables:
|
|
16
16
|
NPM_TOKEN: $NPM_TOKEN
|
|
17
17
|
EXTRA_ARGS: '--access public'
|
|
18
|
+
- git remote set-url origin git@bitbucket.org:applicaguru/persona-chat-sdk.git
|
|
18
19
|
- git tag -a "$VERSION.$BITBUCKET_BUILD_NUMBER" -m "Version $VERSION.$BITBUCKET_BUILD_NUMBER"
|
|
19
20
|
- git push origin "$VERSION.$BITBUCKET_BUILD_NUMBER"
|
package/package.json
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@applica-software-guru/persona-chat-sdk",
|
|
3
|
+
"description": "Official Chat SDK for the Persona API — React runtime provider with REST, WebSocket and WebRTC protocols via assistant-ui.",
|
|
3
4
|
"private": false,
|
|
4
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.104",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"scripts": {
|
|
7
8
|
"dev": "vite",
|