@agent-native/core 0.59.1 → 0.60.0

package/dist/styles/blocks.css

@@ -162,13 +162,16 @@
   line-height: 1.3;
 }
 
-/* Callout: a self-contained tinted box with a left accent bar and a tone. */
+/* Callout: a self-contained tinted box with an inline-start accent bar and a tone. */
 .an-callout {
   max-width: 860px;
-  border-left: 3px solid hsl(var(--border));
-  border-radius: 0 8px 8px 0;
+  border-inline-start: 3px solid hsl(var(--border));
+  border-start-start-radius: 0;
+  border-end-start-radius: 0;
+  border-start-end-radius: 8px;
+  border-end-end-radius: 8px;
   padding-block: 0.9rem;
-  padding-left: 1.25rem;
+  padding-inline-start: 1.25rem;
 }
 
 /* The body editor/reader may carry a leading margin; the box padding owns the
@@ -194,7 +197,7 @@
 }
 
 .an-callout[data-tone] {
-  border-left-color: hsl(var(--an-callout-accent));
+  border-inline-start-color: hsl(var(--an-callout-accent));
   background-image: linear-gradient(
     90deg,
     hsl(var(--an-callout-accent) / 0.08),
@@ -203,6 +206,16 @@
   );
 }
 
+[dir="rtl"] .an-callout[data-tone],
+.an-callout[dir="rtl"][data-tone] {
+  background-image: linear-gradient(
+    270deg,
+    hsl(var(--an-callout-accent) / 0.08),
+    hsl(var(--an-callout-accent) / 0.02) 38%,
+    transparent 72%
+  );
+}
+
 .an-callout[data-tone] .an-block-label {
   color: hsl(var(--an-callout-accent));
 }
@@ -313,6 +326,7 @@
   color: hsl(var(--foreground));
   font-size: 1.0625rem;
   line-height: 1.75;
+  text-align: start;
 }
 
 .plan-rich-markdown-editor .an-rich-md-prose > :first-child {
@@ -410,9 +424,14 @@
 .plan-rich-markdown-editor .an-rich-md-prose ol,
 .plan-rich-markdown-editor .an-rich-md-task-list {
   margin: 0.85rem 0;
+  padding-inline-start: 1.45em;
   color: hsl(var(--muted-foreground));
 }
 
+.plan-rich-markdown-editor .an-rich-md-task-list {
+  padding-inline-start: 0;
+}
+
 .plan-rich-markdown-editor .an-rich-md-prose li {
   margin: 0.35rem 0;
 }
@@ -432,7 +451,7 @@
 
 .plan-rich-markdown-editor .an-rich-md-prose blockquote {
   margin: 1.1rem 0;
-  border-left-color: hsl(var(--border));
+  border-inline-start-color: hsl(var(--border));
   color: hsl(var(--muted-foreground));
 }
 
@@ -444,6 +463,8 @@
 .plan-rich-markdown-editor .an-rich-md-prose :not(pre) > code {
   background: hsl(var(--muted));
   color: hsl(var(--foreground));
+  direction: ltr;
+  unicode-bidi: isolate;
 }
 
 /* Block code surface fallback for any stray bare <pre>. */
@@ -527,7 +548,7 @@
   color: hsl(var(--muted-foreground));
   font-size: 0.75rem;
   font-weight: 500;
-  text-align: left;
+  text-align: start;
   cursor: pointer;
   transition:
     color 0.15s,
@@ -1224,7 +1245,7 @@
   --wf-font: var(--wf-font-clean);
 
   position: relative;
-  overflow: hidden;
+  overflow: auto;
   width: 100%;
   border: 0;
   border-radius: 10px;
@@ -1250,6 +1271,7 @@
 .plan-diagram-frame-content {
   width: 100%;
   padding: 8px 0;
+  direction: inherit;
 }
 
 .plan-diagram-frame-content

package/dist/styles/rich-markdown-editor.css

@@ -18,6 +18,7 @@
   line-height: 1.65;
   font-size: 0.95rem;
   min-height: 1.65em;
+  text-align: start;
 }
 
 .an-rich-md-prose > *:first-child {
@@ -59,7 +60,7 @@
 
 .an-rich-md-prose ul:not(.an-rich-md-task-list),
 .an-rich-md-prose ol {
-  padding-left: 1.45em;
+  padding-inline-start: 1.45em;
   margin: 0.35em 0;
 }
 
@@ -82,7 +83,7 @@
 .an-rich-md-task-list {
   list-style: none;
   margin: 0.35em 0;
-  padding-left: 0;
+  padding-inline-start: 0;
 }
 
 .an-rich-md-task-list li {
@@ -109,13 +110,14 @@
 }
 
 .an-rich-md-prose blockquote {
-  border-left: 2px solid hsl(var(--border));
-  padding-left: 0.9em;
+  border-inline-start: 2px solid hsl(var(--border));
+  padding-inline-start: 0.9em;
   margin: 0.45em 0;
   color: hsl(var(--muted-foreground));
 }
 
 .an-rich-md-prose code {
+  unicode-bidi: isolate;
   font-family:
     ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
   font-size: 0.88em;
@@ -124,6 +126,10 @@
   border-radius: 4px;
 }
 
+.an-rich-md-prose :not(pre) > code {
+  direction: ltr;
+}
+
 .an-rich-md-prose pre {
   font-family:
     ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;

package/dist/templates/{starter-shell-sync.spec.ts → chat-shell-sync.spec.ts}

@@ -1,23 +1,23 @@
 /**
  * Guard: the scaffold template (packages/core/src/templates/default) and
- * templates/starter must ship byte-identical shell files so that scaffolded
- * apps start from exactly the same code as the reference starter template.
+ * templates/chat must ship byte-identical shell files so that scaffolded apps
+ * start from exactly the same code as the reference chat template.
  *
  * When you update entry.server.tsx or entry.client.tsx in either location,
  * update the other copy to match (copy in either direction — the content is
  * canonical, not the direction).
  *
  * Sync commands:
- *   # scaffold → starter
+ *   # scaffold → chat
  *   cp packages/core/src/templates/default/app/entry.server.tsx \
- *      templates/starter/app/entry.server.tsx
+ *      templates/chat/app/entry.server.tsx
  *   cp packages/core/src/templates/default/app/entry.client.tsx \
- *      templates/starter/app/entry.client.tsx
+ *      templates/chat/app/entry.client.tsx
  *
- *   # starter → scaffold
- *   cp templates/starter/app/entry.server.tsx \
+ *   # chat → scaffold
+ *   cp templates/chat/app/entry.server.tsx \
  *      packages/core/src/templates/default/app/entry.server.tsx
- *   cp templates/starter/app/entry.client.tsx \
+ *   cp templates/chat/app/entry.client.tsx \
  *      packages/core/src/templates/default/app/entry.client.tsx
  */
 
@@ -40,7 +40,7 @@ function workspaceRoot(): string {
 const ROOT = workspaceRoot();
 
 const SCAFFOLD_DIR = path.join(ROOT, "packages/core/src/templates/default/app");
-const STARTER_DIR = path.join(ROOT, "templates/starter/app");
+const CHAT_TEMPLATE_DIR = path.join(ROOT, "templates/chat/app");
 
 function md5(content: string): string {
   return crypto.createHash("md5").update(content).digest("hex");
@@ -51,7 +51,7 @@ function readFile(dir: string, filename: string): string {
 }
 
 /**
- * Shell files that must be byte-identical between scaffold and starter.
+ * Shell files that must be byte-identical between scaffold and chat template.
  * Each entry is [filename, reason]:
  *   entry.server.tsx — both import the app-local React Router ServerRouter
  *     and pass it into the shared core handler; any future change to the
@@ -70,20 +70,20 @@ const SHELL_FILES: Array<[string, string]> = [
   ],
 ];
 
-describe("starter-shell sync guard", () => {
-  it("keeps scaffold and starter shell files byte-identical", () => {
+describe("chat-shell sync guard", () => {
+  it("keeps scaffold and chat shell files byte-identical", () => {
     const violations: string[] = [];
 
     for (const [filename] of SHELL_FILES) {
       const scaffoldContent = readFile(SCAFFOLD_DIR, filename);
-      const starterContent = readFile(STARTER_DIR, filename);
+      const chatContent = readFile(CHAT_TEMPLATE_DIR, filename);
 
       const scaffoldHash = md5(scaffoldContent);
-      const starterHash = md5(starterContent);
+      const chatHash = md5(chatContent);
 
-      if (scaffoldHash !== starterHash) {
+      if (scaffoldHash !== chatHash) {
         violations.push(
-          `${filename}: scaffold (packages/core/src/templates/default/app) and starter (templates/starter/app) differ.\n` +
+          `${filename}: scaffold (packages/core/src/templates/default/app) and chat (templates/chat/app) differ.\n` +
             `  Update both to match or copy one to the other.`,
         );
       }
@@ -92,7 +92,7 @@ describe("starter-shell sync guard", () => {
     expect(
       violations,
       [
-        "Scaffold/starter shell files have drifted.",
+        "Scaffold/chat shell files have drifted.",
         "Copy the updated file to the other location to fix.",
         "",
         ...violations,
@@ -100,10 +100,10 @@ describe("starter-shell sync guard", () => {
     ).toEqual([]);
   });
 
-  it("every listed shell file exists in both scaffold and starter", () => {
+  it("every listed shell file exists in both scaffold and chat template", () => {
     for (const [filename, reason] of SHELL_FILES) {
       const scaffoldPath = path.join(SCAFFOLD_DIR, filename);
-      const starterPath = path.join(STARTER_DIR, filename);
+      const chatPath = path.join(CHAT_TEMPLATE_DIR, filename);
 
       expect(
         fs.existsSync(scaffoldPath),
@@ -111,8 +111,8 @@ describe("starter-shell sync guard", () => {
       ).toBe(true);
 
       expect(
-        fs.existsSync(starterPath),
-        `${filename} missing from starter (${reason})`,
+        fs.existsSync(chatPath),
+        `${filename} missing from chat template (${reason})`,
       ).toBe(true);
     }
   });

package/dist/templates/default/.agents/skills/actions/SKILL.md

@@ -49,7 +49,7 @@ Use `defineAction` with a Zod schema (required for new actions):
 ```ts
 // actions/list-meals.ts
 import { z } from "zod";
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { getDb } from "../server/db/index.js";
 import { meals } from "../server/db/schema.js";
 
@@ -352,7 +352,7 @@ This still works but is not auto-exposed as HTTP. Prefer `defineAction` for all
   credentials belong in the encrypted secrets/credential/OAuth stores, never as
   hardcoded literals or shared env fallbacks.
 - **Use `fail()`** for user-friendly error messages (exits with message, no stack trace).
-- **Import from `@agent-native/core`** — Don't redefine `parseArgs()` or other utilities locally.
+- **Import action primitives from `@agent-native/core/action`** and CLI helpers such as `parseArgs()` from `@agent-native/core` — do not redefine framework utilities locally.
 - **Do not re-export actions as REST.** The mounted `/_agent-native/actions/:name` endpoint is the REST surface; duplicating it under `/api/*` creates drift and hides the operation from agents.
 
 ## Common Patterns
@@ -361,7 +361,7 @@ This still works but is not auto-exposed as HTTP. Prefer `defineAction` for all
 
 ```ts
 import { z } from "zod";
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 
 export default defineAction({
   description: "List calendar events",
@@ -380,7 +380,7 @@ export default defineAction({
 
 ```ts
 import { z } from "zod";
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 
 export default defineAction({
   description: "Log a meal",
@@ -400,7 +400,7 @@ export default defineAction({
 
 ```ts
 import { z } from "zod";
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 
 export default defineAction({
   description: "Navigate the UI to a view",

package/dist/templates/default/.agents/skills/agent-native-docs/SKILL.md

@@ -0,0 +1,63 @@
+---
+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:
+
+```bash
+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:
+
+```bash
+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`.

package/dist/templates/default/AGENTS.md

@@ -1,6 +1,6 @@
 # {{APP_NAME}} — Agent Guide
 
-This app follows the agent-native core philosophy: the agent and UI are equal partners. Everything the UI can do, the agent can do via actions. The agent always knows what you're looking at via application state. See the root AGENTS.md for full framework documentation.
+This app follows the agent-native core philosophy: the agent and UI are equal partners. Everything the UI can do, the agent can do via actions. The agent always knows what you're looking at via application state. Use the framework docs lookup below for version-matched Agent Native documentation.
 
 This is an **@agent-native/core** application -- the AI agent and UI share state through a SQL database, with SSE for in-process live sync and polling as the cross-process/serverless fallback.
 
@@ -13,6 +13,26 @@ This is an **@agent-native/core** application -- the AI agent and UI share state
 5. **Agent can update code** -- The agent can modify this app's source code directly.
 6. **No hardcoded secrets or private data** -- Never put API keys, tokens, webhook URLs, signing secrets, private Builder/internal data, customer data, or credential-looking literals in source, docs, tests, fixtures, prompts, screenshots, application state, action responses, or generated content. Use secrets/OAuth/runtime configuration and obvious placeholders in examples.
 
+## Framework Docs Lookup
+
+Version-matched Agent Native docs ship with `@agent-native/core` in
+`node_modules/@agent-native/core/docs`.
+
+- Use `pnpm action docs-search --query "<topic>"` to search framework docs,
+  bundled `AGENTS.md`, and codebase skills.
+- Use `pnpm action docs-search --slug <slug>` to read a full page. Start with
+  `actions`, `database`, `context-awareness`, `client`, `automations`,
+  `recurring-jobs`, `a2a-protocol`, `external-agents`, `mcp-protocol`,
+  `sharing`, `security`, `pure-agent-apps`, or `agent-surfaces`.
+- Use `pnpm action docs-search --list` to see everything available.
+- If the action runner is unavailable, read
+  `node_modules/@agent-native/core/docs/AGENTS.md` and search
+  `node_modules/@agent-native/core/docs/content/` directly with `rg`.
+
+Read these local package docs before implementing advanced Agent Native
+features. Prefer this app's own `AGENTS.md` and `.agents/skills/` for
+app-specific rules.
+
 ### Database Code
 
 - Define tables with `@agent-native/core/db/schema` helpers (`table`, `text`, `integer`, `real`, `now`, sharing helpers), never `drizzle-orm/sqlite-core` or `drizzle-orm/pg-core`.
@@ -115,6 +135,7 @@ Skills in `.agents/skills/` provide detailed guidance for each architectural rul
 
 | Skill                 | When to read                                                                      |
 | --------------------- | --------------------------------------------------------------------------------- |
+| `agent-native-docs`   | Before using advanced Agent Native framework APIs or generated-app features       |
 | `adding-a-feature`    | **Read first when adding ANY new feature** — the four-area parity checklist       |
 | `real-time-sync`      | Before wiring data fetching for anything the agent can mutate (must auto-refresh) |
 | `storing-data`        | Before storing or reading any app state                                           |

package/dist/templates/default/actions/hello.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 export default defineAction({

package/dist/templates/default/actions/navigate.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";
 

package/dist/templates/default/actions/view-screen.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { readAppState } from "@agent-native/core/application-state";
 import { z } from "zod";
 

package/dist/templates/headless/.agents/skills/agent-native-docs/SKILL.md

@@ -0,0 +1,63 @@
+---
+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:
+
+```bash
+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:
+
+```bash
+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`.

package/dist/templates/headless/.env.example

@@ -0,0 +1,4 @@
+# Local development can use the SQLite fallback at data/app.db.
+# Set DATABASE_URL for a persistent hosted database.
+# DATABASE_URL=postgres://user:password@host:5432/database
+

package/dist/templates/headless/.prettierrc

@@ -0,0 +1,5 @@
+{
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "all"
+}

package/dist/templates/headless/AGENTS.md

@@ -0,0 +1,58 @@
+# {{APP_NAME}} - Agent Guide
+
+This is a headless Agent Native app. It starts with actions instead of a browser UI, so the first useful primitive is callable from the agent, CLI, and action runtime.
+
+This app is not stateless. The Agent Native runtime uses SQL-backed stores for app state, settings, auth/session data, resources, and other framework capabilities when those surfaces are used. Local development can use SQLite at `data/app.db`; hosted or long-lived deployments should set `DATABASE_URL` to a persistent database.
+
+## Working In This App
+
+- Prefer actions in `actions/` for every app operation. Do not create REST wrappers around actions.
+- Keep action inputs validated with Zod and return structured data, not JSON strings.
+- Do not hardcode API keys, tokens, webhook URLs, private data, or credential-looking literals.
+- There is intentionally no `app/` UI shell in this scaffold. When you need a browser UI, use the Chat template as the UI on-ramp and keep `agent-native add` for integration blueprints.
+
+## Framework Docs Lookup
+
+Version-matched Agent Native docs ship with `@agent-native/core` in
+`node_modules/@agent-native/core/docs`.
+
+- Use `pnpm action docs-search --query "<topic>"` to search framework docs,
+  bundled `AGENTS.md`, and codebase skills.
+- Use `pnpm action docs-search --slug <slug>` to read a full page. Start with
+  `actions`, `pure-agent-apps`, `automations`, `recurring-jobs`,
+  `a2a-protocol`, `external-agents`, `mcp-protocol`, `database`, `sharing`,
+  and `security` for advanced headless workflows.
+- Use `pnpm action docs-search --list` to see everything available.
+- If the action runner is unavailable, read
+  `node_modules/@agent-native/core/docs/AGENTS.md` and search
+  `node_modules/@agent-native/core/docs/content/` directly with `rg`.
+
+Read these local package docs before implementing advanced Agent Native
+features. Prefer this app's own `AGENTS.md` for app-specific rules.
+
+## Actions
+
+| Action      | Args              | Purpose                 |
+| ----------- | ----------------- | ----------------------- |
+| `hello`     | `[--name <name>]` | Return a greeting       |
+| `db-schema` |                   | Show SQL schema         |
+| `db-query`  | `--sql "SELECT"`  | Run a scoped SELECT     |
+| `db-exec`   | `--sql "UPDATE"`  | Last-resort maintenance |
+
+Run actions from this app root:
+
+```bash
+pnpm action hello --name Builder
+```
+
+Run the app-agent loop against those actions:
+
+```bash
+pnpm agent "Call the hello action for Builder and explain the result"
+```
+
+## Skills
+
+Skills in `.agents/skills/` provide detailed guidance. Read
+`.agents/skills/agent-native-docs/SKILL.md` before using advanced Agent Native
+framework APIs, generated-app features, automations, A2A, sharing, or MCP.

package/dist/templates/headless/DEVELOPING.md

@@ -0,0 +1,22 @@
+# Developing {{APP_NAME}}
+
+Install dependencies, then run the hello action:
+
+```bash
+pnpm install
+pnpm action hello --name Builder
+```
+
+Then run the production app-agent loop against this folder:
+
+```bash
+pnpm agent "Call hello for Builder"
+```
+
+Useful checks:
+
+```bash
+pnpm typecheck
+```
+
+This scaffold intentionally has no `app/` directory, React Router config, Vite config, or dev server. Add those only when you are ready for a UI surface; the Chat template is the UI-first scaffold.

package/dist/templates/headless/_gitignore

@@ -0,0 +1,36 @@
+.agent-native/
+
+# Logs
+logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+node_modules
+dist
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Runtime data
+data/*.db
+data/*.db-shm
+data/*.db-wal
+data/uploads/
+data/settings.json
+data/.sessions.json
+

package/dist/templates/headless/actions/hello.ts

@@ -0,0 +1,14 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+export default defineAction({
+  description: "Return a friendly greeting.",
+  schema: z.object({
+    name: z.string().default("world").describe("Name to greet"),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async ({ name }) => {
+    return { message: `Hello, ${name}!` };
+  },
+});

package/dist/templates/headless/actions/run.ts

@@ -0,0 +1,3 @@
+import { runScript } from "@agent-native/core/scripts";
+
+runScript();