@agent-native/core 0.24.1 → 0.24.3

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 (68) hide show
  1. package/README.md +22 -2
  2. package/dist/agent/thread-data-builder.d.ts +1 -0
  3. package/dist/agent/thread-data-builder.d.ts.map +1 -1
  4. package/dist/agent/thread-data-builder.js +8 -2
  5. package/dist/agent/thread-data-builder.js.map +1 -1
  6. package/dist/chat-threads/store.d.ts +13 -0
  7. package/dist/chat-threads/store.d.ts.map +1 -1
  8. package/dist/chat-threads/store.js +87 -8
  9. package/dist/chat-threads/store.js.map +1 -1
  10. package/dist/cli/migrate.d.ts +1 -0
  11. package/dist/cli/migrate.d.ts.map +1 -1
  12. package/dist/cli/migrate.js +137 -5
  13. package/dist/cli/migrate.js.map +1 -1
  14. package/dist/cli/templates-meta.js +1 -1
  15. package/dist/cli/templates-meta.js.map +1 -1
  16. package/dist/client/AgentPanel.d.ts +2 -0
  17. package/dist/client/AgentPanel.d.ts.map +1 -1
  18. package/dist/client/AgentPanel.js +2 -2
  19. package/dist/client/AgentPanel.js.map +1 -1
  20. package/dist/client/MultiTabAssistantChat.d.ts +3 -1
  21. package/dist/client/MultiTabAssistantChat.d.ts.map +1 -1
  22. package/dist/client/MultiTabAssistantChat.js +12 -3
  23. package/dist/client/MultiTabAssistantChat.js.map +1 -1
  24. package/dist/client/NewWorkspaceAppFlow.js +2 -2
  25. package/dist/client/NewWorkspaceAppFlow.js.map +1 -1
  26. package/dist/client/onboarding/OnboardingPanel.js +1 -1
  27. package/dist/client/onboarding/OnboardingPanel.js.map +1 -1
  28. package/dist/client/org/OrgSwitcher.d.ts.map +1 -1
  29. package/dist/client/org/OrgSwitcher.js +29 -2
  30. package/dist/client/org/OrgSwitcher.js.map +1 -1
  31. package/dist/client/org/workspace-app-links.d.ts +1 -0
  32. package/dist/client/org/workspace-app-links.d.ts.map +1 -1
  33. package/dist/client/org/workspace-app-links.js +7 -1
  34. package/dist/client/org/workspace-app-links.js.map +1 -1
  35. package/dist/client/use-chat-threads.d.ts +9 -0
  36. package/dist/client/use-chat-threads.d.ts.map +1 -1
  37. package/dist/client/use-chat-threads.js +216 -32
  38. package/dist/client/use-chat-threads.js.map +1 -1
  39. package/dist/client/use-chat-threads.spec.js +368 -0
  40. package/dist/client/use-chat-threads.spec.js.map +1 -1
  41. package/dist/scripts/chat/search-chats.d.ts.map +1 -1
  42. package/dist/scripts/chat/search-chats.js +7 -1
  43. package/dist/scripts/chat/search-chats.js.map +1 -1
  44. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  45. package/dist/server/agent-chat-plugin.js +141 -6
  46. package/dist/server/agent-chat-plugin.js.map +1 -1
  47. package/dist/server/framework-request-handler.d.ts.map +1 -1
  48. package/dist/server/framework-request-handler.js +45 -0
  49. package/dist/server/framework-request-handler.js.map +1 -1
  50. package/dist/server/index.d.ts +1 -1
  51. package/dist/server/index.d.ts.map +1 -1
  52. package/dist/server/index.js +1 -1
  53. package/dist/server/index.js.map +1 -1
  54. package/dist/templates/workspace-root/AGENTS.md +6 -5
  55. package/dist/templates/workspace-root/README.md +1 -1
  56. package/docs/content/cloneable-saas.md +1 -0
  57. package/docs/content/dispatch.md +2 -2
  58. package/docs/content/faq.md +11 -10
  59. package/docs/content/getting-started.md +1 -0
  60. package/docs/content/multi-tenancy.md +1 -1
  61. package/docs/content/template-assets.md +23 -1
  62. package/docs/content/template-brain.md +31 -8
  63. package/docs/content/template-clips.md +19 -0
  64. package/docs/content/template-design.md +21 -0
  65. package/docs/content/template-forms.md +19 -0
  66. package/package.json +1 -1
  67. package/src/templates/workspace-root/AGENTS.md +6 -5
  68. package/src/templates/workspace-root/README.md +1 -1
@@ -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.1",
3
+ "version": "0.24.3",
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",
@@ -60,15 +60,16 @@ coding agents can discover the same workspace-wide guidance from the root.
60
60
  - Do not satisfy a new-app request by adding a route, page, component, or file
61
61
  to `apps/starter` or another existing app unless the user explicitly asks to
62
62
  modify that existing app.
63
- - Treat first-party apps such as Mail, Calendar, Analytics, Brain, and Dispatch as
63
+ - Treat first-party apps such as Mail, Calendar, Analytics, Brain, Assets, and Dispatch as
64
64
  existing hosted/connected neighbors available through links and A2A/default
65
- connected agents. For example, Mail, Calendar, Analytics, and Brain already exist at
65
+ connected agents. For example, Mail, Calendar, Analytics, Brain, and Assets already exist at
66
66
  `https://mail.agent-native.com`, `https://calendar.agent-native.com`, and
67
- `https://analytics.agent-native.com`, and `https://brain.agent-native.com`.
68
- - If a new app needs to use Mail, Calendar, Analytics, Brain, or similar first-party
67
+ `https://analytics.agent-native.com`, `https://brain.agent-native.com`, and
68
+ `https://assets.agent-native.com`.
69
+ - If a new app needs to use Mail, Calendar, Analytics, Brain, Assets, or similar first-party
69
70
  data/agents, build only the genuinely new workflow and delegate/link to those
70
71
  existing apps. Do not create wrapper apps, child apps, nested template copies,
71
- or cloned Mail/Calendar/Analytics/Brain implementations inside the new app just to
72
+ or cloned Mail/Calendar/Analytics/Brain/Assets implementations inside the new app just to
72
73
  provide access.
73
74
  - Only create a first-party app copy when the user explicitly asks for a
74
75
  customized fork/copy of that app. Otherwise prefer the hosted/shared app so
@@ -119,7 +119,7 @@ separate workspace app registry to edit. React Router apps must preserve
119
119
  For requests phrased as creating an "agent", classify the scope first: simple
120
120
  recurring Dispatch behavior can stay in Dispatch, while a robust app-like
121
121
  teammate should become a real workspace app listed with the rest of the apps.
122
- First-party apps such as Mail, Calendar, Analytics, Brain, and Dispatch should be
122
+ First-party apps such as Mail, Calendar, Analytics, Brain, Assets, and Dispatch should be
123
123
  treated as existing hosted or connected neighbors. If a new app needs access to
124
124
  their data or agents, link/delegate to those apps through the workspace/A2A
125
125
  path rather than creating wrapper apps, child apps, or cloned template copies