@agent-native/core 0.4.4 → 0.5.0-dev.b51eaae

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

@@ -0,0 +1,53 @@
+/**
+ * Navigate the UI to a view.
+ *
+ * Writes a navigate command to application state which the UI reads and auto-deletes.
+ *
+ * Usage:
+ *   pnpm action navigate --view=home
+ *   pnpm action navigate --path=/some/route
+ *
+ * Options:
+ *   --view   View name to navigate to
+ *   --path   URL path to navigate to
+ */
+
+import { parseArgs } from "@agent-native/core";
+import { writeAppState } from "@agent-native/core/application-state";
+import type { ScriptTool } from "@agent-native/core";
+
+export const tool: ScriptTool = {
+  description:
+    "Navigate the UI to a specific view or path. Writes a navigate command to application state which the UI reads and auto-deletes.",
+  parameters: {
+    type: "object",
+    properties: {
+      view: { type: "string", description: "View name to navigate to" },
+      path: { type: "string", description: "URL path to navigate to" },
+    },
+  },
+};
+
+export async function run(args: Record<string, string>): Promise<string> {
+  if (!args.view && !args.path) {
+    return "Error: At least --view or --path is required.";
+  }
+  const nav: Record<string, string> = {};
+  if (args.view) nav.view = args.view;
+  if (args.path) nav.path = args.path;
+  await writeAppState("navigate", nav);
+  return `Navigating to ${args.view || args.path}`;
+}
+
+export default async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2)) as Record<string, string>;
+  if (!args.view && !args.path) {
+    console.error(
+      "Error: At least --view or --path is required. Usage: pnpm action navigate --view=home",
+    );
+    process.exit(1);
+  }
+  const result = await run(args);
+  console.error(result);
+  console.log(JSON.stringify({ result }));
+}

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

@@ -0,0 +1,39 @@
+/**
+ * See what the user is currently looking at on screen.
+ *
+ * Reads and returns the current navigation state from application state.
+ *
+ * Usage:
+ *   pnpm action view-screen
+ */
+
+import { parseArgs } from "@agent-native/core";
+import { readAppState } from "@agent-native/core/application-state";
+import type { ScriptTool } from "@agent-native/core";
+
+export const tool: ScriptTool = {
+  description:
+    "See what the user is currently looking at on screen. Returns the current navigation state. Always call this first before taking any action.",
+  parameters: {
+    type: "object",
+    properties: {},
+  },
+};
+
+export async function run(_args: Record<string, string>): Promise<string> {
+  const navigation = await readAppState("navigation");
+
+  const screen: Record<string, unknown> = {};
+  if (navigation) screen.navigation = navigation;
+
+  if (Object.keys(screen).length === 0) {
+    return "No application state found. Is the app running?";
+  }
+  return JSON.stringify(screen, null, 2);
+}
+
+export default async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2)) as Record<string, string>;
+  const result = await run(args);
+  console.log(result);
+}

package/src/templates/default/app/entry.server.tsx

@@ -3,6 +3,7 @@ import { ServerRouter } from "react-router";
 import ReactDOMServer from "react-dom/server.browser";
 const { renderToReadableStream } = ReactDOMServer;
 import { isbot } from "isbot";
+import { wrapWithAnalytics } from "@agent-native/core/server";
 
 export const streamTimeout = 5_000;
 
@@ -45,7 +46,7 @@ export default async function handleRequest(
     }
 
     responseHeaders.set("Content-Type", "text/html");
-    return new Response(body, {
+    return new Response(wrapWithAnalytics(body), {
       headers: responseHeaders,
       status: responseStatusCode,
     });

package/src/templates/default/app/global.css

@@ -48,7 +48,7 @@
     --secondary: 220 4% 12%;
     --secondary-foreground: 0 0% 90%;
     --muted: 220 4% 10%;
-    --muted-foreground: 220 4% 50%;
+    --muted-foreground: 220 4% 60%;
     --accent: 220 4% 13%;
     --accent-foreground: 0 0% 90%;
     --destructive: 0 63% 51%;
@@ -58,7 +58,7 @@
     --ring: 0 0% 60%;
     --radius: 0.5rem;
     --sidebar-background: 220 6% 4%;
-    --sidebar-foreground: 220 4% 50%;
+    --sidebar-foreground: 220 4% 60%;
     --sidebar-primary: 0 0% 75%;
     --sidebar-primary-foreground: 220 6% 6%;
     --sidebar-accent: 220 4% 10%;

package/src/templates/default/app/root.tsx

@@ -13,7 +13,8 @@ import {
   useQueryClient,
 } from "@tanstack/react-query";
 import { ThemeProvider } from "next-themes";
-import { useFileWatcher } from "@agent-native/core";
+import { useDbSync } from "@agent-native/core";
+import { ClientOnly, DefaultSpinner } from "@agent-native/core/client";
 import { Toaster } from "sonner";
 import "./global.css";
 
@@ -23,6 +24,15 @@ export function Layout({ children }: { children: React.ReactNode }) {
       <head>
         <meta charSet="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <link rel="manifest" href="/manifest.json" />
+        <meta name="theme-color" content="#111111" />
+        <meta name="mobile-web-app-capable" content="yes" />
+        <meta
+          name="apple-mobile-web-app-status-bar-style"
+          content="black-translucent"
+        />
+        <meta name="apple-mobile-web-app-title" content="App" />
+        <link rel="apple-touch-icon" href="/icon-180.svg" />
         <Meta />
         <Links />
       </head>
@@ -35,27 +45,29 @@ export function Layout({ children }: { children: React.ReactNode }) {
   );
 }
 
-function FileWatcherSetup() {
+function DbSyncSetup() {
   const qc = useQueryClient();
-  useFileWatcher({ queryClient: qc, queryKeys: ["files", "data"] });
+  useDbSync({ queryClient: qc, queryKeys: ["files", "data"] });
   return null;
 }
 
 export default function Root() {
   const [queryClient] = useState(() => new QueryClient());
   return (
-    <ThemeProvider
-      attribute="class"
-      defaultTheme="system"
-      enableSystem
-      disableTransitionOnChange
-    >
-      <QueryClientProvider client={queryClient}>
-        <FileWatcherSetup />
-        <Outlet />
-        <Toaster />
-      </QueryClientProvider>
-    </ThemeProvider>
+    <ClientOnly fallback={<DefaultSpinner />}>
+      <ThemeProvider
+        attribute="class"
+        defaultTheme="system"
+        enableSystem
+        disableTransitionOnChange
+      >
+        <QueryClientProvider client={queryClient}>
+          <DbSyncSetup />
+          <Outlet />
+          <Toaster />
+        </QueryClientProvider>
+      </ThemeProvider>
+    </ClientOnly>
   );
 }
 

package/src/templates/default/app/routes/_index.tsx

@@ -34,7 +34,7 @@ export default function IndexPage() {
 
         <div className="grid grid-cols-2 gap-3 text-left">
           <a
-            href="https://agent-native.dev/docs"
+            href="https://agent-native.com/docs"
             target="_blank"
             rel="noopener noreferrer"
             className="group rounded-lg border border-border/50 px-4 py-3 hover:bg-accent/50 transition-colors"

package/src/templates/default/package.json

@@ -7,10 +7,14 @@
     "build": "agent-native build",
     "start": "agent-native start",
     "typecheck": "agent-native typecheck",
+    "action": "agent-native action",
     "script": "agent-native script"
   },
   "dependencies": {
     "@agent-native/core": "^0.4.1",
+    "@assistant-ui/react": "^0.12.19",
+    "@assistant-ui/react-markdown": "^0.12.6",
+    "@tabler/icons-react": "^3.40.0",
     "h3": "^1.13.0",
     "isbot": "^5"
   },

package/src/templates/default/public/icon-180.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="180" height="180" viewBox="0 0 180 180">
+  <rect width="180" height="180" rx="36" fill="#111111"/>
+  <text x="50%" y="50%" dominant-baseline="central" text-anchor="middle" font-size="99">⚡</text>
+</svg>

package/src/templates/default/public/icon-192.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" viewBox="0 0 192 192">
+  <rect width="192" height="192" rx="38" fill="#111111"/>
+  <text x="50%" y="50%" dominant-baseline="central" text-anchor="middle" font-size="105">⚡</text>
+</svg>

package/src/templates/default/public/icon-512.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="102" fill="#111111"/>
+  <text x="50%" y="50%" dominant-baseline="central" text-anchor="middle" font-size="281">⚡</text>
+</svg>

package/src/templates/default/public/manifest.json

@@ -0,0 +1,13 @@
+{
+  "name": "Agent Native App",
+  "short_name": "App",
+  "description": "Agent-native application",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#111111",
+  "theme_color": "#111111",
+  "icons": [
+    { "src": "/icon-192.svg", "sizes": "192x192", "type": "image/svg+xml" },
+    { "src": "/icon-512.svg", "sizes": "512x512", "type": "image/svg+xml" }
+  ]
+}

package/dist/a2a/middleware.d.ts

@@ -1,3 +0,0 @@
-import type { Request, Response, NextFunction } from "express";
-export declare function createAuthMiddleware(apiKeyEnv: string | undefined): (req: Request, res: Response, next: NextFunction) => void;
-//# sourceMappingURL=middleware.d.ts.map

package/dist/a2a/middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/a2a/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IACxD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAqC/D"}

package/dist/a2a/middleware.js

@@ -1,36 +0,0 @@
-export function createAuthMiddleware(apiKeyEnv) {
-    return (req, res, next) => {
-        if (!apiKeyEnv) {
-            next();
-            return;
-        }
-        const expectedKey = process.env[apiKeyEnv];
-        if (!expectedKey) {
-            // No key configured — skip auth (dev mode)
-            next();
-            return;
-        }
-        const authHeader = req.headers.authorization;
-        if (!authHeader || !authHeader.startsWith("Bearer ")) {
-            const error = {
-                jsonrpc: "2.0",
-                id: null,
-                error: { code: -32001, message: "Authentication required" },
-            };
-            res.status(401).json(error);
-            return;
-        }
-        const token = authHeader.slice(7);
-        if (token !== expectedKey) {
-            const error = {
-                jsonrpc: "2.0",
-                id: null,
-                error: { code: -32001, message: "Invalid API key" },
-            };
-            res.status(401).json(error);
-            return;
-        }
-        next();
-    };
-}
-//# sourceMappingURL=middleware.js.map

package/dist/a2a/middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/a2a/middleware.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,2CAA2C;YAC3C,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;QAC7C,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAoB;gBAC7B,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE;aAC5D,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAoB;gBAC7B,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE;aACpD,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/client/use-file-watcher.d.ts

@@ -1,23 +0,0 @@
-interface QueryClient {
-    invalidateQueries(opts: {
-        queryKey: string[];
-    }): void;
-}
-/**
- * Hook that opens an EventSource connection to /api/events and invalidates
- * react-query caches when file changes are detected.
- *
- * @param options.queryClient - The react-query QueryClient instance (from useQueryClient())
- * @param options.queryKeys - Array of query key prefixes to invalidate on change.
- *   Default: ["file", "fileTree"]
- * @param options.eventsUrl - SSE endpoint URL. Default: "/api/events"
- * @param options.onEvent - Optional callback for each SSE event
- */
-export declare function useFileWatcher(options?: {
-    queryClient?: QueryClient;
-    queryKeys?: string[];
-    eventsUrl?: string;
-    onEvent?: (data: any) => void;
-}): void;
-export {};
-//# sourceMappingURL=use-file-watcher.d.ts.map

package/dist/client/use-file-watcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-file-watcher.d.ts","sourceRoot":"","sources":["../../src/client/use-file-watcher.ts"],"names":[],"mappings":"AAEA,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CAC1B,GACL,IAAI,CAgDN"}

package/dist/client/use-file-watcher.js

@@ -1,50 +0,0 @@
-import { useEffect, useRef } from "react";
-/**
- * Hook that opens an EventSource connection to /api/events and invalidates
- * react-query caches when file changes are detected.
- *
- * @param options.queryClient - The react-query QueryClient instance (from useQueryClient())
- * @param options.queryKeys - Array of query key prefixes to invalidate on change.
- *   Default: ["file", "fileTree"]
- * @param options.eventsUrl - SSE endpoint URL. Default: "/api/events"
- * @param options.onEvent - Optional callback for each SSE event
- */
-export function useFileWatcher(options = {}) {
-    const { queryClient, queryKeys = ["file", "fileTree"], eventsUrl = "/api/events", } = options;
-    const url = eventsUrl;
-    // Stable refs — updated every render, read inside the effect
-    const onEventRef = useRef(options.onEvent);
-    onEventRef.current = options.onEvent;
-    const keysRef = useRef(queryKeys);
-    keysRef.current = queryKeys;
-    useEffect(() => {
-        const eventSource = new EventSource(url);
-        eventSource.onopen = () => {
-            // Invalidate all keys on reconnection to catch events missed during downtime
-            if (queryClient) {
-                for (const key of keysRef.current) {
-                    queryClient.invalidateQueries({ queryKey: [key] });
-                }
-            }
-        };
-        eventSource.onmessage = (event) => {
-            try {
-                const data = JSON.parse(event.data);
-                if (queryClient) {
-                    for (const key of keysRef.current) {
-                        queryClient.invalidateQueries({ queryKey: [key] });
-                    }
-                }
-                onEventRef.current?.(data);
-            }
-            catch (e) {
-                console.warn("[useFileWatcher] Failed to parse SSE event:", e);
-            }
-        };
-        eventSource.onerror = () => {
-            console.warn("[useFileWatcher] EventSource error, will reconnect");
-        };
-        return () => eventSource.close();
-    }, [url, queryClient]); // only reconnect on genuine config changes
-}
-//# sourceMappingURL=use-file-watcher.js.map

package/dist/client/use-file-watcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-file-watcher.js","sourceRoot":"","sources":["../../src/client/use-file-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAM1C;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,UAKI,EAAE;IAEN,MAAM,EACJ,WAAW,EACX,SAAS,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,SAAS,GAAG,aAAa,GAC1B,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,SAAS,CAAC;IAEtB,6DAA6D;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QAEzC,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE;YACxB,6EAA6E;YAC7E,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBAClC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,WAAW,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBAClC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBACD,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC;QAEF,WAAW,CAAC,OAAO,GAAG,GAAG,EAAE;YACzB,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACrE,CAAC,CAAC;QAEF,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,2CAA2C;AACrE,CAAC"}

package/src/templates/default/.agents/skills/scripts/SKILL.md

@@ -1,121 +0,0 @@
----
-name: scripts
-description: >-
-  How to create and run agent-callable scripts in scripts/. Use when creating
-  a new script, adding an API integration, implementing a complex agent
-  operation, or running pnpm script commands.
----
-
-# Agent Scripts
-
-## Rule
-
-Complex operations the agent needs to perform are implemented as scripts in `scripts/`. The agent runs them via `pnpm script <name>`.
-
-## Why
-
-Scripts give the agent callable tools with structured input/output. They keep the agent's chat context clean (no massive code blocks), they're reusable, and they can be tested independently.
-
-## How to Create a Script
-
-Create `scripts/my-script.ts`:
-
-```ts
-import { parseArgs, loadEnv, fail, agentChat } from "@agent-native/core";
-import { readSetting, writeSetting } from "@agent-native/core/settings";
-import { readAppState, writeAppState } from "@agent-native/core/application-state";
-
-export default async function myScript(args: string[]) {
-  loadEnv();
-
-  const parsed = parseArgs(args);
-  const input = parsed.input;
-  if (!input) fail("--input is required");
-
-  // Read/write settings (persistent config)
-  const settings = await readSetting("my-settings");
-  await writeSetting("my-settings", { ...settings, lastRun: new Date().toISOString() });
-
-  // Read/write app state (ephemeral UI state)
-  await writeAppState("processing-status", { status: "done", input });
-
-  agentChat.submit(`Processed ${input}`);
-}
-```
-
-## How to Run
-
-```bash
-pnpm script my-script --input some-value
-```
-
-## Script Dispatcher
-
-The default template uses core's `runScript()` in `scripts/run.ts`:
-
-```ts
-import { runScript } from "@agent-native/core";
-runScript();
-```
-
-This is the canonical approach for new apps. Script names must be lowercase with hyphens only (e.g., `my-script`).
-
-## Guidelines
-
-- **One script, one job.** Keep scripts focused on a single operation. The agent composes multiple script calls for complex operations.
-- **Use `parseArgs()`** for structured argument parsing. It converts `--key value` pairs to a `Record<string, string>`.
-- **Use `loadEnv()`** if the script needs environment variables (API keys, etc.).
-- **Use `fail()`** for user-friendly error messages (exits with message, no stack trace).
-- **Write results to the database.** Use `writeSetting()` or `writeAppState()` for structured data. The UI will pick up changes via SSE.
-- **Use `agentChat.submit()`** to report results or errors back to the agent chat.
-- **Import from `@agent-native/core`** — Don't redefine `parseArgs()` or other utilities locally.
-
-## Common Patterns
-
-**API integration script** (e.g., image generation):
-
-```ts
-import fs from "fs";
-import { parseArgs, loadEnv, fail } from "@agent-native/core";
-
-export default async function generateImage(args: string[]) {
-  loadEnv();
-  const parsed = parseArgs(args);
-  const prompt = parsed.prompt;
-  if (!prompt) fail("--prompt is required");
-
-  const outputPath = parsed.output ?? "data/generated-image.png";
-  const imageUrl = await callImageAPI(prompt);
-  const buffer = await fetch(imageUrl).then((r) => r.arrayBuffer());
-  fs.writeFileSync(outputPath, Buffer.from(buffer));
-}
-```
-
-**Data processing script:**
-
-```ts
-import { parseArgs, fail } from "@agent-native/core";
-import { readSetting, writeSetting } from "@agent-native/core/settings";
-
-export default async function transform(args: string[]) {
-  const parsed = parseArgs(args);
-  const key = parsed.key;
-  if (!key) fail("--key is required");
-
-  const data = await readSetting(key);
-  const result = processData(data);
-  await writeSetting(key, result);
-}
-```
-
-## Troubleshooting
-
-- **Script not found** — Check that the filename matches the command name exactly. `pnpm script foo-bar` looks for `scripts/foo-bar.ts`.
-- **Args not parsing** — Ensure args use `--key value` or `--key=value` format. Boolean flags use `--flag` (sets value to `"true"`).
-- **Script runs but UI doesn't update** — Make sure you're using core store helpers (`writeSetting`, `writeAppState`) which emit SSE events automatically. Direct SQL writes don't emit events.
-
-## Related Skills
-
-- **storing-data** — Scripts read/write data via core SQL stores and Drizzle ORM
-- **delegate-to-agent** — The agent invokes scripts via `pnpm script <name>`
-- **real-time-sync** — Database writes from scripts trigger SSE events to update the UI

package/src/templates/default/.agents/skills/sse-file-watcher/SKILL.md

@@ -1,80 +0,0 @@
----
-name: real-time-sync
-description: >-
-  How the UI stays in sync when the agent writes data. Use when wiring up
-  query invalidation, debugging UI not updating, or understanding how SSE
-  connects the agent to the browser.
----
-
-# Real-Time Sync
-
-## How It Works
-
-When the agent writes data (via scripts or server handlers), the UI updates instantly. No polling, no manual refresh.
-
-The flow:
-
-1. **Agent writes** → `writeAppState("navigate", { view: "starred" })`
-2. **Store emits SSE event** → `{ source: "app-state", type: "change", key: "navigate" }`
-3. **Browser receives** → `useFileWatcher()` hook gets the event
-4. **React Query invalidates** → relevant queries refetch, UI re-renders
-
-This happens automatically for all writes through `@agent-native/core/application-state` and `@agent-native/core/settings`.
-
-## SSE Events
-
-| Source | Emitted by | Example |
-|--------|-----------|---------|
-| `"app-state"` | `writeAppState`, `deleteAppState` | `{ source: "app-state", type: "change", key: "navigation" }` |
-| `"settings"` | `putSetting`, `deleteSetting` | `{ source: "settings", type: "change", key: "mail-settings" }` |
-
-## Client Setup
-
-Every template has an SSE endpoint and a `useFileWatcher` hook in `root.tsx`:
-
-```ts
-// server/routes/api/events.get.ts
-import { createDefaultSSEHandler } from "@agent-native/core/server";
-export default createDefaultSSEHandler();
-```
-
-```ts
-// In root.tsx
-useFileWatcher({
-  queryClient: qc,
-  queryKeys: [],
-  onEvent: (data) => {
-    if (data.source === "app-state") {
-      // Invalidate queries affected by app state changes
-      qc.invalidateQueries({ queryKey: ["compose-drafts"] });
-    } else if (data.source === "settings") {
-      qc.invalidateQueries({ queryKey: ["settings"] });
-    }
-  },
-});
-```
-
-Use the `key` field to selectively invalidate — don't invalidate everything on every event.
-
-## For Custom Domain Data
-
-If your template has Drizzle tables and you want SSE notifications after writes, emit from your handler:
-
-```ts
-import { getAppStateEmitter } from "@agent-native/core/application-state";
-
-// After inserting a booking:
-getAppStateEmitter().emit("app-state", {
-  source: "app-state",
-  type: "change",
-  key: "bookings-updated",
-});
-```
-
-## Troubleshooting
-
-| Symptom | Check |
-|---------|-------|
-| UI not updating after script writes | Is the script using `writeAppState`/`writeSetting`? Direct SQL writes don't emit SSE. |
-| SSE not connected | Browser devtools → Network → EventStream. Is `/api/events` connected? |
-| Wrong queries invalidating | Check the `onEvent` callback — filter by `data.source` and `data.key` |

package/src/templates/default/server/plugins/agent-chat.ts

@@ -1 +0,0 @@
-export { defaultAgentChatPlugin as default } from "@agent-native/core/server";

package/src/templates/default/server/plugins/auth.ts

@@ -1 +0,0 @@
-export { defaultAuthPlugin as default } from "@agent-native/core/server";

package/src/templates/default/server/plugins/file-sync.ts

@@ -1 +0,0 @@
-export { defaultFileSyncPlugin as default } from "@agent-native/core/server";

package/src/templates/default/server/plugins/terminal.ts

@@ -1 +0,0 @@
-export { defaultTerminalPlugin as default } from "@agent-native/core/server";

package/src/templates/default/server/routes/api/events.get.ts

@@ -1,3 +0,0 @@
-import { createDefaultSSEHandler } from "@agent-native/core/server";
-
-export default createDefaultSSEHandler();

package/src/templates/default/server/routes/api/file-sync/status.get.ts

@@ -1,4 +0,0 @@
-import { defineEventHandler } from "h3";
-import { defaultSyncStatusHandler } from "@agent-native/core/server";
-
-export default defineEventHandler(() => defaultSyncStatusHandler());