agent-native-docs

name	agent-native-docs
description	How to find version-matched Agent Native framework docs bundled in node_modules. Use before implementing or answering questions about @agent-native/core APIs, generated apps, workspaces, or advanced features.
metadata	{"internal":true}

Agent Native Docs Lookup

Rule

Before implementing or explaining non-trivial Agent Native behavior, read the version-matched docs installed with @agent-native/core.

Why

Generated apps and workspaces may be on a different framework version than the public docs or model memory. The installed package is the source that matches the app in front of you.

How

From a generated app directory:

pnpm action docs-search --query "<feature>"
pnpm action docs-search --slug <slug>
pnpm action docs-search --list

The headless pnpm agent loop and built-in app agent also expose a read-only docs-search tool with the same query, slug, and list options.

If the action runner is unavailable, search the package docs directly:

rg -n "actions|automations|a2a|sharing" node_modules/@agent-native/core/docs

Then read node_modules/@agent-native/core/docs/AGENTS.md or the matching file under node_modules/@agent-native/core/docs/content/.

Useful Slugs

Need	Slugs
Actions and typed client calls	actions, client
SQL, auth, access, sharing	database, authentication, security, sharing
UI state visible to the agent	context-awareness
Headless and chat-first apps	pure-agent-apps, agent-surfaces, using-your-agent
Automations and schedules	automations, recurring-jobs
Cross-app and external agents	a2a-protocol, external-agents, mcp-protocol, mcp-apps
Skills and instructions	skills-guide, writing-agent-instructions

Don't

• Do not rely on memory for framework APIs when package docs are present.
• Do not add custom REST wrappers for app data before reading actions.
• Do not add inline LLM calls before reading using-your-agent and agent-surfaces.