@agent-native/core 0.48.1 → 0.48.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 (63) hide show
  1. package/README.md +4 -4
  2. package/dist/cli/skills.js +14 -14
  3. package/dist/cli/skills.js.map +1 -1
  4. package/dist/client/index.d.ts +1 -0
  5. package/dist/client/index.d.ts.map +1 -1
  6. package/dist/client/index.js +1 -0
  7. package/dist/client/index.js.map +1 -1
  8. package/dist/client/require-session.d.ts +61 -0
  9. package/dist/client/require-session.d.ts.map +1 -0
  10. package/dist/client/require-session.js +75 -0
  11. package/dist/client/require-session.js.map +1 -0
  12. package/dist/collab/client.d.ts +1 -1
  13. package/dist/collab/client.d.ts.map +1 -1
  14. package/dist/collab/client.js +5 -5
  15. package/dist/collab/client.js.map +1 -1
  16. package/dist/mcp/actions/service-token-access.d.ts.map +1 -1
  17. package/dist/mcp/actions/service-token-access.js +30 -2
  18. package/dist/mcp/actions/service-token-access.js.map +1 -1
  19. package/dist/server/auth.d.ts.map +1 -1
  20. package/dist/server/auth.js +5 -5
  21. package/dist/server/auth.js.map +1 -1
  22. package/dist/server/core-routes-plugin.d.ts +3 -0
  23. package/dist/server/core-routes-plugin.d.ts.map +1 -1
  24. package/dist/server/core-routes-plugin.js +12 -2
  25. package/dist/server/core-routes-plugin.js.map +1 -1
  26. package/dist/templates/workspace-core/.agents/skills/authentication/SKILL.md +36 -1
  27. package/docs/content/agent-web-surfaces.md +2 -2
  28. package/docs/content/authentication.md +1 -1
  29. package/docs/content/cloneable-saas.md +2 -2
  30. package/docs/content/code-agents-ui.md +16 -17
  31. package/docs/content/creating-templates.md +3 -3
  32. package/docs/content/deployment.md +18 -18
  33. package/docs/content/dispatch.md +2 -2
  34. package/docs/content/external-agents.md +21 -28
  35. package/docs/content/faq.md +1 -1
  36. package/docs/content/frames.md +1 -1
  37. package/docs/content/getting-started.md +7 -7
  38. package/docs/content/mcp-apps.md +1 -1
  39. package/docs/content/mcp-protocol.md +2 -2
  40. package/docs/content/migration-workbench.md +2 -2
  41. package/docs/content/multi-app-workspace.md +8 -8
  42. package/docs/content/multi-tenancy.md +1 -1
  43. package/docs/content/plan-plugin.md +6 -8
  44. package/docs/content/pr-visual-recap.md +23 -23
  45. package/docs/content/pure-agent-apps.md +1 -1
  46. package/docs/content/skills-guide.md +3 -3
  47. package/docs/content/template-analytics.md +1 -1
  48. package/docs/content/template-assets.md +4 -4
  49. package/docs/content/template-brain.md +1 -1
  50. package/docs/content/template-calendar.md +1 -1
  51. package/docs/content/template-clips.md +1 -1
  52. package/docs/content/template-content.md +1 -1
  53. package/docs/content/template-design.md +1 -1
  54. package/docs/content/template-dispatch.md +1 -1
  55. package/docs/content/template-forms.md +2 -2
  56. package/docs/content/template-mail.md +2 -2
  57. package/docs/content/template-plan.md +6 -12
  58. package/docs/content/template-slides.md +1 -1
  59. package/docs/content/template-starter.md +2 -2
  60. package/docs/content/template-videos.md +1 -1
  61. package/docs/content/workspace-management.md +1 -1
  62. package/package.json +3 -3
  63. package/src/templates/workspace-core/.agents/skills/authentication/SKILL.md +36 -1
package/README.md CHANGED
@@ -200,7 +200,7 @@ Every template is a complete cloneable SaaS — fork it, customize it with the a
200
200
  ## Quick Start
201
201
 
202
202
  ```bash
203
- npx @agent-native/core create my-platform
203
+ npx @agent-native/core@latest create my-platform
204
204
  cd my-platform
205
205
  pnpm install
206
206
  pnpm dev
@@ -211,7 +211,7 @@ The CLI shows a multi-select picker so you can include as many templates as you
211
211
  Want a single app, no monorepo? Use `--standalone`:
212
212
 
213
213
  ```bash
214
- npx @agent-native/core create my-app --standalone --template mail
214
+ npx @agent-native/core@latest create my-app --standalone --template mail
215
215
  ```
216
216
 
217
217
  ## Workspaces (Monorepo)
@@ -234,13 +234,13 @@ my-platform/
234
234
  Add another app later:
235
235
 
236
236
  ```bash
237
- npx @agent-native/core add-app notes --template content
237
+ npx @agent-native/core@latest add-app notes --template content
238
238
  ```
239
239
 
240
240
  Deploy every app behind one origin:
241
241
 
242
242
  ```bash
243
- agent-native deploy
243
+ npx @agent-native/core@latest deploy
244
244
  # https://your-agents.com/mail/* → mail
245
245
  # https://your-agents.com/calendar/* → calendar
246
246
  # https://your-agents.com/forms/* → forms
@@ -125,7 +125,7 @@ of using a generic image generator.
125
125
  browser approved but the local MCP config unwritten. Restart or reload the
126
126
  agent client after installing or connecting if Assets tools do not appear in
127
127
  the live session.
128
- - Local customization: use \`agent-native app-skill launch --local\` from an
128
+ - Local customization: use \`npx @agent-native/core@latest app-skill launch --local\` from an
129
129
  Assets app-skill manifest, or pass \`--into <path>\` for editable source.
130
130
  - Do not call image/video providers directly from another app. Assets owns
131
131
  generation, picker UI, search/list/export, and asset context.
@@ -228,7 +228,7 @@ authenticates it in the same step (a one-time browser sign-in at setup — this
228
228
  intended), so the first tool call does not hit an OAuth wall:
229
229
 
230
230
  \`\`\`bash
231
- agent-native skills add visual-plan
231
+ npx @agent-native/core@latest skills add visual-plan
232
232
  \`\`\`
233
233
 
234
234
  After that, \`/visual-plan\` and \`/visual-recap\` are the two installed slash
@@ -236,7 +236,7 @@ commands. The other planning modes (\`create-ui-plan\`, \`create-prototype-plan\
236
236
  \`create-plan-design\`, \`create-visual-questions\`) are MCP tools reachable from
237
237
  \`/visual-plan\`, not separate slash commands. Pass \`--no-connect\` to register
238
238
  the connector without authenticating, then run
239
- \`agent-native connect https://plan.agent-native.com\` whenever you are ready.
239
+ \`npx @agent-native/core@latest connect https://plan.agent-native.com\` whenever you are ready.
240
240
 
241
241
  **Browser (people you share with).** Open the Plans editor and create & edit
242
242
  with no sign-up — you work as a guest. Sign in only when you want to save or
@@ -251,7 +251,7 @@ hosted flow.
251
251
 
252
252
  If a Plans tool returns \`needs auth\`, \`Unauthorized\`, or \`Session terminated\`,
253
253
  do not keep retrying the tool. Authenticate the connector with
254
- \`agent-native connect https://plan.agent-native.com\` (OAuth-capable hosts can
254
+ \`npx @agent-native/core@latest connect https://plan.agent-native.com\` (OAuth-capable hosts can
255
255
  instead re-run /mcp and choose Authenticate), then continue once the connector
256
256
  is available.
257
257
 
@@ -917,7 +917,7 @@ inline output: the usual cause is a connector that did not finish connecting
917
917
  this session (it registers zero tools), not auth. Stop and give the user the
918
918
  exact restore step — reconnect via \`/mcp\` (or restart the session); only if
919
919
  genuinely unauthenticated, run
920
- \`agent-native connect https://plan.agent-native.com\`. Publish once the tool is
920
+ \`npx @agent-native/core@latest connect https://plan.agent-native.com\`. Publish once the tool is
921
921
  reachable. Local-files privacy mode (after Tool Guidance) is the only
922
922
  exception.
923
923
 
@@ -1091,7 +1091,7 @@ The local-files contract is:
1091
1091
  - Write the plan as a local MDX folder under \`plans/<slug>/\`: \`plan.mdx\`,
1092
1092
  optional \`canvas.mdx\`, optional \`prototype.mdx\`, and optional
1093
1093
  \`.plan-state.json\`.
1094
- - Run \`agent-native plan local preview --dir plans/<slug> --kind plan\` after
1094
+ - Run \`npx @agent-native/core@latest plan local preview --dir plans/<slug> --kind plan\` after
1095
1095
  writing or updating the folder. Report the returned local URL or the
1096
1096
  \`/local-plans/<slug>\` route if the local Plan app is running with the same
1097
1097
  \`PLAN_LOCAL_DIR\`.
@@ -1179,14 +1179,14 @@ exception to the hosted publish rule below.
1179
1179
  In local-files mode:
1180
1180
 
1181
1181
  - Read the diff/stat/source context from local files and shell commands only.
1182
- The existing \`agent-native recap collect-diff\`, \`scan\`, and
1182
+ The existing \`npx @agent-native/core@latest recap collect-diff\`, \`scan\`, and
1183
1183
  \`build-prompt --local-files\` helpers are safe to use because they operate on
1184
1184
  local files and do not write to the Plan database.
1185
1185
  - Write the recap as a local MDX folder under \`plans/<slug>/\`: \`plan.mdx\`,
1186
1186
  optional \`canvas.mdx\`, optional \`prototype.mdx\`, and optional
1187
1187
  \`.plan-state.json\`. Set \`kind: "recap"\` and \`localOnly: true\` in
1188
1188
  frontmatter/state when authoring the source.
1189
- - Run \`agent-native plan local preview --dir plans/<slug> --kind recap\` after
1189
+ - Run \`npx @agent-native/core@latest plan local preview --dir plans/<slug> --kind recap\` after
1190
1190
  writing or updating the folder. Report the returned local URL or the
1191
1191
  \`/local-plans/<slug>\` route if the local Plan app is running with the same
1192
1192
  \`PLAN_LOCAL_DIR\`.
@@ -1224,7 +1224,7 @@ connector that did not finish connecting this session (it registers zero tools),
1224
1224
  NOT necessarily an auth problem — so do not assume the user must authenticate.
1225
1225
  Stop and tell the user how to restore it: reconnect the Plan MCP connector (in
1226
1226
  Claude Code, run \`/mcp\` and reconnect, or restart the session); only if it is
1227
- genuinely unauthenticated, run \`agent-native connect <plan-app-url>\` or
1227
+ genuinely unauthenticated, run \`npx @agent-native/core@latest connect <plan-app-url>\` or
1228
1228
  re-authenticate via \`/mcp\`. Then publish once the tool is reachable. Falling
1229
1229
  back to inline content is a defect, not a degraded mode.
1230
1230
 
@@ -1401,7 +1401,7 @@ a headless CI agent), state that in the recap handoff instead.
1401
1401
  ## Open And Report The Recap
1402
1402
 
1403
1403
  In local-files privacy mode, report the local preview URL/path from
1404
- \`agent-native plan local preview\` or the \`/local-plans/<slug>\` route for a local
1404
+ \`npx @agent-native/core@latest plan local preview\` or the \`/local-plans/<slug>\` route for a local
1405
1405
  Plan app using the same \`PLAN_LOCAL_DIR\`. Do not invent a hosted URL and do not
1406
1406
  publish just to get an absolute Plan link.
1407
1407
 
@@ -2214,10 +2214,10 @@ function prVisualRecapWorkflowDisplayPath() {
2214
2214
  return path.join(".github", "workflows", "pr-visual-recap.yml");
2215
2215
  }
2216
2216
  function prVisualRecapInstallCommand() {
2217
- return "agent-native skills add visual-plan --with-github-action";
2217
+ return "npx @agent-native/core@latest skills add visual-plan --with-github-action";
2218
2218
  }
2219
2219
  function prVisualRecapSetupCommand() {
2220
- return "agent-native recap setup";
2220
+ return "npx @agent-native/core@latest recap setup";
2221
2221
  }
2222
2222
  async function promptForGithubAction(context) {
2223
2223
  const clack = await import("@clack/prompts");
@@ -2705,7 +2705,7 @@ function canRunInteractiveConnect(options) {
2705
2705
  return false;
2706
2706
  return !!process.stdin.isTTY && !!process.stdout.isTTY;
2707
2707
  }
2708
- /** Build the `agent-native connect <url> --client … --scope …` command. */
2708
+ /** Build the `npx @agent-native/core@latest connect <url> --client … --scope …` command. */
2709
2709
  function connectCommandFor(hostedUrl, clients, scope) {
2710
2710
  const args = [
2711
2711
  "connect",
@@ -2881,7 +2881,7 @@ export async function addAgentNativeSkill(parsed, options = {}) {
2881
2881
  }
2882
2882
  }
2883
2883
  if (parsed.mcp) {
2884
- commands.push(`agent-native app-skill ensure --manifest ${installTarget.loaded.file} --client ${parsed.client} --scope ${parsed.scope} --yes`);
2884
+ commands.push(`npx @agent-native/core@latest app-skill ensure --manifest ${installTarget.loaded.file} --client ${parsed.client} --scope ${parsed.scope} --yes`);
2885
2885
  if (!parsed.dryRun) {
2886
2886
  await ensureAppSkill(installTarget.loaded, {
2887
2887
  clients,