@waniwani/sdk 0.14.6 → 0.14.8-beta.1
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 +13 -13
- package/dist/chat/embed.js +64 -66
- package/dist/chat/embed.js.map +1 -1
- package/dist/chat/index.js +7 -7
- package/dist/chat/index.js.map +1 -1
- package/dist/chat/styles.css +1 -1
- package/package.json +8 -1
package/README.md
CHANGED
|
@@ -83,19 +83,19 @@ The mapping from funnel to flow is direct:
|
|
|
83
83
|
| Branching question | Conditional edge |
|
|
84
84
|
| Lead data | Typed state (Zod) |
|
|
85
85
|
|
|
86
|
-
See [Why MCP funnels](https://docs.waniwani.ai/why-mcp-funnels) for the full argument.
|
|
86
|
+
See [Why MCP funnels](https://docs.waniwani.ai/sdk/why-mcp-funnels) for the full argument.
|
|
87
87
|
|
|
88
88
|
## How it compares
|
|
89
89
|
|
|
90
90
|
- **vs the raw MCP SDK.** You would serialize state through the model on every turn. `createFlow` persists state server-side under the session id; the model carries nothing between calls.
|
|
91
|
-
- **vs LangChain or LangGraph.** General-purpose agent graphs. Waniwani is funnel-shaped: interrupts, re-ask on validation, auto-skip pre-filled fields, widget delegation, typed state via Zod. See [vs LangGraph](https://docs.waniwani.ai/compare/vs-langgraph).
|
|
91
|
+
- **vs LangChain or LangGraph.** General-purpose agent graphs. Waniwani is funnel-shaped: interrupts, re-ask on validation, auto-skip pre-filled fields, widget delegation, typed state via Zod. See [vs LangGraph](https://docs.waniwani.ai/sdk/compare/vs-langgraph).
|
|
92
92
|
- **vs closed-source platform SDKs.** MIT. The flow engine has zero runtime dependency on `app.waniwani.ai`. The hosted Platform is opt-in via a single env var.
|
|
93
93
|
|
|
94
94
|
## Engine + optional Platform
|
|
95
95
|
|
|
96
96
|
The flow engine is MIT and runs without an API key against any `get` / `set` / `delete` store (Redis, Upstash, Cloudflare KV, DynamoDB, Postgres, in-memory).
|
|
97
97
|
|
|
98
|
-
Set `WANIWANI_API_KEY` to connect the [Waniwani Platform](https://docs.waniwani.ai/platform/overview):
|
|
98
|
+
Set `WANIWANI_API_KEY` to connect the [Waniwani Platform](https://docs.waniwani.ai/sdk/platform/overview):
|
|
99
99
|
|
|
100
100
|
- Hosted, encrypted-at-rest flow state. No infra to run.
|
|
101
101
|
- Event tracking and funnel analytics.
|
|
@@ -106,10 +106,10 @@ Same code, opt in by env var. `withWaniwani(server)` wraps any MCP server to add
|
|
|
106
106
|
|
|
107
107
|
## What you can build
|
|
108
108
|
|
|
109
|
-
- [Sales funnel MCP](https://docs.waniwani.ai/guides/sales-funnel). Qualify intent, capture lead, branch on stage, push to CRM.
|
|
110
|
-
- [Lead generation MCP](https://docs.waniwani.ai/guides/lead-generation). Email, role, use case, webhook to CRM.
|
|
111
|
-
- [Booking MCP](https://docs.waniwani.ai/guides/booking). Pick service, check availability, pick slot, confirm.
|
|
112
|
-
- [Insurance or pricing quote MCP](https://docs.waniwani.ai/guides/insurance-quote). Collect details, validate, call your pricing API, return widget cards.
|
|
109
|
+
- [Sales funnel MCP](https://docs.waniwani.ai/sdk/guides/sales-funnel). Qualify intent, capture lead, branch on stage, push to CRM.
|
|
110
|
+
- [Lead generation MCP](https://docs.waniwani.ai/sdk/guides/lead-generation). Email, role, use case, webhook to CRM.
|
|
111
|
+
- [Booking MCP](https://docs.waniwani.ai/sdk/guides/booking). Pick service, check availability, pick slot, confirm.
|
|
112
|
+
- [Insurance or pricing quote MCP](https://docs.waniwani.ai/sdk/guides/insurance-quote). Collect details, validate, call your pricing API, return widget cards.
|
|
113
113
|
|
|
114
114
|
For a fuller starter project with chat widget, dev tunnel, and a sample funnel pre-wired:
|
|
115
115
|
|
|
@@ -128,16 +128,16 @@ waniwani connect # pick an org + agent, writes waniwani.config.ts
|
|
|
128
128
|
waniwani dev # run local MCP, open playground bridged to localhost
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
See the [CLI docs](https://docs.waniwani.ai/cli/overview) for the full command reference.
|
|
131
|
+
See the [CLI docs](https://docs.waniwani.ai/sdk/cli/overview) for the full command reference.
|
|
132
132
|
|
|
133
133
|
## Documentation
|
|
134
134
|
|
|
135
|
-
Full docs at **[docs.waniwani.ai](https://docs.waniwani.ai)**.
|
|
135
|
+
Full docs at **[docs.waniwani.ai](https://docs.waniwani.ai)**.
|
|
136
136
|
|
|
137
|
-
- **Start:** [Quickstart](https://docs.waniwani.ai/quickstart) · [Why MCP funnels](https://docs.waniwani.ai/why-mcp-funnels) · [Funnels overview](https://docs.waniwani.ai/guides/funnels)
|
|
138
|
-
- **Engine:** [Flows](https://docs.waniwani.ai/flows/overview) · [State](https://docs.waniwani.ai/flows/state) · [Interrupts](https://docs.waniwani.ai/flows/interrupts) · [KV store adapters](https://docs.waniwani.ai/flows/kv-store)
|
|
139
|
-
- **Deploy:** [Overview](https://docs.waniwani.ai/deployment/overview) · [Self-hosting](https://docs.waniwani.ai/deployment/self-hosting)
|
|
140
|
-
- **Platform:** [Overview](https://docs.waniwani.ai/platform/overview) · [Tracking](https://docs.waniwani.ai/tracking/overview) · [Knowledge base](https://docs.waniwani.ai/knowledge-base/overview) · [Chat widget](https://docs.waniwani.ai/chat/embed)
|
|
137
|
+
- **Start:** [Quickstart](https://docs.waniwani.ai/sdk/quickstart) · [Why MCP funnels](https://docs.waniwani.ai/sdk/why-mcp-funnels) · [Funnels overview](https://docs.waniwani.ai/sdk/guides/funnels)
|
|
138
|
+
- **Engine:** [Flows](https://docs.waniwani.ai/sdk/flows/overview) · [State](https://docs.waniwani.ai/sdk/flows/state) · [Interrupts](https://docs.waniwani.ai/sdk/flows/interrupts) · [KV store adapters](https://docs.waniwani.ai/sdk/flows/kv-store)
|
|
139
|
+
- **Deploy:** [Overview](https://docs.waniwani.ai/sdk/deployment/overview) · [Self-hosting](https://docs.waniwani.ai/sdk/deployment/self-hosting)
|
|
140
|
+
- **Platform:** [Overview](https://docs.waniwani.ai/sdk/platform/overview) · [Tracking](https://docs.waniwani.ai/sdk/tracking/overview) · [Knowledge base](https://docs.waniwani.ai/sdk/knowledge-base/overview) · [Chat widget](https://docs.waniwani.ai/sdk/chat/embed)
|
|
141
141
|
|
|
142
142
|
## Links
|
|
143
143
|
|