@agent-native/core 0.24.2 → 0.24.4

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 (37) hide show
  1. package/dist/chat-threads/store.d.ts +6 -2
  2. package/dist/chat-threads/store.d.ts.map +1 -1
  3. package/dist/chat-threads/store.js +20 -6
  4. package/dist/chat-threads/store.js.map +1 -1
  5. package/dist/cli/migrate.d.ts +1 -0
  6. package/dist/cli/migrate.d.ts.map +1 -1
  7. package/dist/cli/migrate.js +137 -5
  8. package/dist/cli/migrate.js.map +1 -1
  9. package/dist/client/use-chat-threads.d.ts +2 -2
  10. package/dist/client/use-chat-threads.d.ts.map +1 -1
  11. package/dist/client/use-chat-threads.js +91 -10
  12. package/dist/client/use-chat-threads.js.map +1 -1
  13. package/dist/client/use-chat-threads.spec.js +225 -0
  14. package/dist/client/use-chat-threads.spec.js.map +1 -1
  15. package/dist/scripts/db/exec.d.ts.map +1 -1
  16. package/dist/scripts/db/exec.js +2 -1
  17. package/dist/scripts/db/exec.js.map +1 -1
  18. package/dist/scripts/db/patch.d.ts.map +1 -1
  19. package/dist/scripts/db/patch.js +2 -1
  20. package/dist/scripts/db/patch.js.map +1 -1
  21. package/dist/scripts/db/safety.d.ts +2 -0
  22. package/dist/scripts/db/safety.d.ts.map +1 -1
  23. package/dist/scripts/db/safety.js +130 -0
  24. package/dist/scripts/db/safety.js.map +1 -1
  25. package/dist/scripts/dev/index.js +1 -1
  26. package/dist/scripts/dev/index.js.map +1 -1
  27. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  28. package/dist/server/agent-chat-plugin.js +33 -7
  29. package/dist/server/agent-chat-plugin.js.map +1 -1
  30. package/docs/content/dispatch.md +2 -2
  31. package/docs/content/faq.md +11 -11
  32. package/docs/content/template-assets.md +23 -1
  33. package/docs/content/template-brain.md +31 -8
  34. package/docs/content/template-clips.md +19 -0
  35. package/docs/content/template-design.md +21 -0
  36. package/docs/content/template-forms.md +19 -0
  37. package/package.json +1 -1
@@ -9,7 +9,7 @@ Dispatch is the central app that sits in front of every other app in your worksp
9
9
 
10
10
  Without Dispatch, every app in a multi-app workspace ends up re-implementing the same plumbing: its own Slack bot, its own secret store, its own scheduled jobs, its own copy of the workspace's instructions. Rotating one API key turns into ten redeployments. Adding a new policy turns into ten copy-pastes. Dispatch centralizes all of that in one app so the others stay focused on their domain.
11
11
 
12
- > Dispatch is shipped as a first-party template. This page covers the **concept** — what it is, why you'd want it, and how it fits into a workspace. For the scaffolded app itself (routes, screens, agent guide), see the [Dispatch template](/templates/dispatch).
12
+ > Dispatch is shipped as a first-party template. This page covers the **concept** — what it is, why you'd want it, and how it fits into a workspace. For the scaffolded app itself (routes, screens, agent guide), see the [Dispatch template](/docs/template-dispatch).
13
13
 
14
14
  ## When you want Dispatch {#when}
15
15
 
@@ -151,7 +151,7 @@ Then add credentials to the vault and (optionally) author global workspace resou
151
151
 
152
152
  ## See also {#see-also}
153
153
 
154
- - [Dispatch template](/templates/dispatch) — the actual scaffolded app, with its full action catalog and agent guide
154
+ - [Dispatch template](/docs/template-dispatch) — the actual scaffolded app, with its full action catalog and agent guide
155
155
  - [Messaging](/docs/messaging) — connecting Slack, email, Telegram, WhatsApp
156
156
  - [A2A Protocol](/docs/a2a-protocol) — how cross-app delegation works under the hood
157
157
  - [Multi-App Workspace](/docs/multi-app-workspace) — the deployment shape Dispatch is built for
@@ -60,17 +60,17 @@ You can, but agent-native works best when built from the ground up. The architec
60
60
 
61
61
  The framework ships with production-ready templates you can use as daily drivers:
62
62
 
63
- - **[Calendar](/templates/calendar)** — Google Calendar + Calendly-style booking links
64
- - **[Content](/templates/content)** — Notion-style documents
65
- - **[Brain](/templates/brain)** — full-page company chat, cited memory, sources, and review queue
66
- - **[Assets](/templates/assets)** — brand asset libraries, uploads, and generated media
67
- - **[Slides](/templates/slides)** — presentation builder
68
- - **[Analytics](/templates/analytics)** — data platform (like Amplitude/Mixpanel)
69
- - **[Mail](/templates/mail)** — full-featured email client (like Superhuman)
70
- - **[Clips](/templates/clips)** — async screen + camera recording (replaces Loom)
71
- - **[Design](/templates/design)** — agent-native HTML prototyping studio
72
- - **[Forms](/templates/forms)** — form builder (like Typeform)
73
- - **[Dispatch](/templates/dispatch)** — workspace control plane: shared secrets, integrations, jobs
63
+ - **[Calendar](/docs/template-calendar)** — Google Calendar + Calendly-style booking links
64
+ - **[Content](/docs/template-content)** — Notion-style documents
65
+ - **[Brain](/docs/template-brain)** — full-page company chat, cited memory, sources, and review queue
66
+ - **[Assets](/docs/template-assets)** — brand asset libraries, uploads, and generated media
67
+ - **[Slides](/docs/template-slides)** — presentation builder
68
+ - **[Analytics](/docs/template-analytics)** — data platform (like Amplitude/Mixpanel)
69
+ - **[Mail](/docs/template-mail)** — full-featured email client (like Superhuman)
70
+ - **[Clips](/docs/template-clips)** — async screen + camera recording (replaces Loom)
71
+ - **[Design](/docs/template-design)** — agent-native HTML prototyping studio
72
+ - **[Forms](/docs/template-forms)** — form builder (like Typeform)
73
+ - **[Dispatch](/docs/template-dispatch)** — workspace control plane: shared secrets, integrations, jobs
74
74
 
75
75
  Each template is a complete app with UI, agent actions, database schema, and AI instructions. See [Templates](/docs/cloneable-saas) for the full picture, or all [Templates](/templates).
76
76
 
@@ -9,6 +9,28 @@ Assets is an agent-native workspace for creating and managing brand-consistent m
9
9
 
10
10
  Use it when your team needs reusable visual direction and searchable source assets instead of one-off generic media prompts.
11
11
 
12
+ ![Assets library for brand media and generated output](https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F769092170a14474f998cbca47384f891?format=webp&width=1200)
13
+
14
+ ## Start Here
15
+
16
+ 1. **Create a library.** Add the brand, campaign, product, or content stream you
17
+ want to manage.
18
+ 2. **Upload references.** Add approved logos, product shots, style examples, or
19
+ existing videos so the agent has concrete material to work from.
20
+ 3. **Generate from chat or a library.** Ask for a hero image, diagram, product
21
+ shot, or video variant. Assets stores the prompt, references, model, status,
22
+ and lineage for review.
23
+ 4. **Use the asset elsewhere.** Copy the export, embed the picker in another
24
+ app, or let another agent call Assets over A2A.
25
+
26
+ ## Useful Prompts
27
+
28
+ - "Generate three blog hero options using the Acme product screenshots as references."
29
+ - "Create a square social image in the launch-campaign style."
30
+ - "Find all approved assets for the onboarding redesign."
31
+ - "Turn this uploaded diagram into a cleaner product explainer image."
32
+ - "Create a video storyboard and save the best frame set to this library."
33
+
12
34
  ## What You Can Do With It
13
35
 
14
36
  - **Create asset libraries.** Group reference images, videos, canonical logos, style notes, palettes, folders, and generated output by brand, campaign, product, or category.
@@ -77,7 +99,7 @@ context where the host supports it.
77
99
  Use A2A when another agent needs to create, search, or export assets without a
78
100
  human picker UI.
79
101
 
80
- ### Distribute The App Skill
102
+ ### Developer: Distribute The App Skill
81
103
 
82
104
  The Assets app skill has app id `assets` and hosted MCP URL
83
105
  `https://assets.agent-native.com/_agent-native/mcp`.
@@ -19,17 +19,40 @@ The product surface stays simple on purpose: **Ask** is the primary chat
19
19
  experience, while **Sources**, **Review**, and **Knowledge** are admin/support
20
20
  surfaces for connecting data, approving proposals, and inspecting cited memory.
21
21
 
22
+ ![Brain company chat with cited memory sources](https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F9c9fe3b5b9494e33803cd3f494cba356?format=webp&width=1200)
23
+
22
24
  Use Brain when your team wants agents to answer questions like "why did we make
23
25
  this product decision?", "how does this in-development feature work?", or "what
24
26
  changed in this process?" with links back to the source conversation, meeting,
25
27
  or issue.
26
28
 
27
- Brain is intentionally on an open-source, Glean-shaped path, but it is not a
28
- complete Glean replacement today. V1 is company chat plus cited memory over
29
- reviewed knowledge. V1.5 adds Brain-wide search across knowledge,
30
- captures, and sources, plus reusable workspace connections for source
31
- credentials. V2 points toward federated app/source search, permission-aware
32
- result filtering, ranking, and an expertise graph as a future platform layer.
29
+ Brain's shipped shape is company chat plus cited, reviewed memory over approved
30
+ sources. The current template also includes Brain-wide search across knowledge,
31
+ captures, and source records, plus reusable workspace connections for source
32
+ credentials. Broader federated workspace search and expertise ranking are
33
+ platform direction, not something you need to set up on day one.
34
+
35
+ ## Start Here
36
+
37
+ 1. **Try the demo.** Open Ask and choose **Start demo**. Brain seeds a small
38
+ product-decision corpus, runs the trust checks, and asks a cited question so
39
+ you can see answers, citations, review, and not-found behavior before adding
40
+ real company data.
41
+ 2. **Add one source.** Start with a single Slack channel, Granola Team-space
42
+ feed, GitHub repository, Clips export, or generic transcript webhook. Keep
43
+ the scope small until citations and review quality look right.
44
+ 3. **Review before publishing.** Use Review to inspect evidence, edit wording,
45
+ and approve only durable company memory.
46
+ 4. **Ask from the source.** Use Ask for questions that should be grounded in
47
+ approved knowledge, not raw chat logs.
48
+
49
+ ## Useful Prompts
50
+
51
+ - "What did we decide about annual pricing, and where was that discussed?"
52
+ - "Find the most recent onboarding-process change and cite the source."
53
+ - "Summarize what this GitHub discussion means for the launch plan."
54
+ - "Review the pending memory proposals and flag anything too vague to publish."
55
+ - "Which sources are stale or failing sync?"
33
56
 
34
57
  ## What It Includes
35
58
 
@@ -402,7 +425,7 @@ workspaces and reveals Review, Knowledge, and **Run eval** follow-ups once the
402
425
  demo is ready.
403
426
 
404
427
  `run-retrieval-eval` checks an offline real-channel-style retrieval set. It
405
- uses existing workspace Brain data when #dev-fusion stale Fusion branch answers
428
+ uses existing workspace Brain data when the expected branch-safety answers
406
429
  already have citation-backed support; otherwise, with `seedIfMissing` enabled,
407
430
  it seeds a small Slack-style fallback corpus and re-runs the same checks. The
408
431
  result covers Slack-style citations, branch-safety terms, and an unsupported
@@ -442,6 +465,6 @@ The template follows the agent-native four-area contract:
442
465
  - **Application state:** route, filters, and selected IDs mirror into `application_state` for agent context.
443
466
 
444
467
  See [Dispatch](/docs/dispatch) for the workspace control plane, the
445
- [Dispatch template](/templates/dispatch) for the scaffolded app,
468
+ [Dispatch template](/docs/template-dispatch) for the scaffolded app,
446
469
  [Workspace](/docs/workspace) for shared resources, and
447
470
  [A2A Protocol](/docs/a2a-protocol) for cross-app delegation.
@@ -30,6 +30,25 @@ Think along the lines of Loom + Granola + Wisprflow rolled into one app — but
30
30
  - **Smart library views.** Group by project, filter by speaker, auto-tag based on content.
31
31
  - **Edit the transcript through chat.** "Fix the mis-transcribed word at 1:42." "Pull three quotes for a blog post." The agent edits the transcript and the UI updates live.
32
32
 
33
+ ## Start Here
34
+
35
+ 1. **Open Library.** Browse screen recordings, meeting recordings, dictations,
36
+ folders, and spaces from one place.
37
+ 2. **Record or import.** Capture a screen recording, start from a calendar
38
+ meeting, or use push-to-talk dictation.
39
+ 3. **Let the agent clean it up.** Generate a title, summary, chapters, action
40
+ items, or cleaned-up transcript text.
41
+ 4. **Search and reuse.** Ask for the clip, quote, action item, or decision you
42
+ need, then share the result with the right visibility.
43
+
44
+ ## Useful Prompts
45
+
46
+ - "Summarize this clip for a product update."
47
+ - "Find the meeting where we discussed the rollout plan."
48
+ - "Pull three customer quotes from this transcript."
49
+ - "Create action items from the last sales call."
50
+ - "Clean up this dictation and turn it into a Linear ticket."
51
+
33
52
  ## Why it's interesting
34
53
 
35
54
  Three things make Clips a good showcase of what agent-native enables:
@@ -9,6 +9,27 @@ Design is an agent-native HTML prototyping studio. Instead of a layered drawing
9
9
 
10
10
  Use it when you want a polished landing page concept, product UI direction, brand exploration, or interactive prototype that can leave the tool as real HTML.
11
11
 
12
+ ![Design studio showing generated HTML prototypes and tweak controls](https://cdn.builder.io/api/v1/image/assets%2F348da13fcd8b414c87de9066196f7266%2F961bedb713a94463b834c1f2f4643bcf?format=webp&width=1200)
13
+
14
+ ## Start Here
15
+
16
+ 1. **Describe the artifact.** Ask for the screen, flow, landing page, or visual
17
+ direction you want. Include audience, tone, and any product constraints.
18
+ 2. **Compare directions.** Generate a few variants, pick the strongest one, and
19
+ keep refining instead of starting over.
20
+ 3. **Tune the details.** Use tweak controls for common visual changes, or ask
21
+ the agent for layout, copy, responsive, and interaction changes.
22
+ 4. **Export when it is useful.** Download HTML, ZIP, or PDF once the prototype
23
+ is ready to hand to another tool or teammate.
24
+
25
+ ## Useful Prompts
26
+
27
+ - "Create three landing-page directions for a technical analytics product."
28
+ - "Make this dashboard denser and easier to scan for an operations team."
29
+ - "Apply our saved design system and simplify the mobile layout."
30
+ - "Export this prototype as a ZIP once the final variant is selected."
31
+ - "Turn this HTML into a stronger pricing page without changing the brand colors."
32
+
12
33
  ## What You Can Do With It
13
34
 
14
35
  - **Generate complete prototypes.** Describe the screen or page you need and the agent creates a working HTML document with Tailwind styling and Alpine interactions.
@@ -28,6 +28,25 @@ When you open the app, you see your forms, the current editor, and a live previe
28
28
  - **Route submissions.** Send submission payloads to webhooks, Slack, Discord, or Google Sheets using the built-in integrations.
29
29
  - **Publish public forms.** Share a public form URL and show a thank-you message after submission.
30
30
 
31
+ ## Start Here
32
+
33
+ 1. **Create a form from a prompt.** Ask for the form you want, including the
34
+ audience and what should happen after submission.
35
+ 2. **Refine in the editor.** Adjust labels, validation, choices, and order in
36
+ the visual builder when direct editing is faster.
37
+ 3. **Publish and share.** Use the public form URL for respondents, then watch
38
+ results arrive in the Responses view.
39
+ 4. **Connect destinations.** Route new submissions to Slack, Discord, Google
40
+ Sheets, webhooks, or your own extension point.
41
+
42
+ ## Useful Prompts
43
+
44
+ - "Create a beta signup form with role, team size, and priority use case."
45
+ - "Add a required NPS question and a free-text follow-up."
46
+ - "Post every new response to the product Slack channel."
47
+ - "Summarize this week's submissions and group them by customer segment."
48
+ - "Make this form shorter without losing the fields we need for routing."
49
+
31
50
  ## Why it's interesting
32
51
 
33
52
  The useful part of an agent-native form builder is that setup and iteration happen in the same place. You can ask the agent to add fields, adjust copy, connect Slack notifications, or inspect the submission data, while the UI remains the direct editor for the same SQL records.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-native/core",
3
- "version": "0.24.2",
3
+ "version": "0.24.4",
4
4
  "type": "module",
5
5
  "description": "Framework for agent-native application development — where AI agents and UI share state via files",
6
6
  "license": "MIT",