@agent-native/core 0.48.2 → 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.
- package/README.md +4 -4
- package/dist/cli/skills.js +14 -14
- package/dist/cli/skills.js.map +1 -1
- package/dist/client/index.d.ts +1 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/require-session.d.ts +61 -0
- package/dist/client/require-session.d.ts.map +1 -0
- package/dist/client/require-session.js +75 -0
- package/dist/client/require-session.js.map +1 -0
- package/dist/mcp/actions/service-token-access.d.ts.map +1 -1
- package/dist/mcp/actions/service-token-access.js +30 -2
- package/dist/mcp/actions/service-token-access.js.map +1 -1
- package/dist/server/auth.d.ts.map +1 -1
- package/dist/server/auth.js +5 -5
- package/dist/server/auth.js.map +1 -1
- package/dist/templates/workspace-core/.agents/skills/authentication/SKILL.md +36 -1
- package/docs/content/agent-web-surfaces.md +2 -2
- package/docs/content/authentication.md +1 -1
- package/docs/content/cloneable-saas.md +2 -2
- package/docs/content/code-agents-ui.md +16 -17
- package/docs/content/creating-templates.md +3 -3
- package/docs/content/deployment.md +18 -18
- package/docs/content/dispatch.md +2 -2
- package/docs/content/external-agents.md +21 -28
- package/docs/content/faq.md +1 -1
- package/docs/content/frames.md +1 -1
- package/docs/content/getting-started.md +7 -7
- package/docs/content/mcp-apps.md +1 -1
- package/docs/content/mcp-protocol.md +2 -2
- package/docs/content/migration-workbench.md +2 -2
- package/docs/content/multi-app-workspace.md +8 -8
- package/docs/content/multi-tenancy.md +1 -1
- package/docs/content/plan-plugin.md +6 -8
- package/docs/content/pr-visual-recap.md +23 -23
- package/docs/content/pure-agent-apps.md +1 -1
- package/docs/content/skills-guide.md +3 -3
- package/docs/content/template-analytics.md +1 -1
- package/docs/content/template-assets.md +4 -4
- package/docs/content/template-brain.md +1 -1
- package/docs/content/template-calendar.md +1 -1
- package/docs/content/template-clips.md +1 -1
- package/docs/content/template-content.md +1 -1
- package/docs/content/template-design.md +1 -1
- package/docs/content/template-dispatch.md +1 -1
- package/docs/content/template-forms.md +2 -2
- package/docs/content/template-mail.md +2 -2
- package/docs/content/template-plan.md +6 -12
- package/docs/content/template-slides.md +1 -1
- package/docs/content/template-starter.md +2 -2
- package/docs/content/template-videos.md +1 -1
- package/docs/content/workspace-management.md +1 -1
- package/package.json +1 -1
- 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
|
package/dist/cli/skills.js
CHANGED
|
@@ -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,
|