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

package/dist/terminal/terminal-plugin.js

@@ -1,3 +1,8 @@
+import { getH3App } from "../server/framework-request-handler.js";
+import { isNodeRuntime } from "../shared/runtime.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createRequire } from "node:module";
 /**
  * Nitro Plugin — Agent Terminal
  *
@@ -5,13 +10,43 @@
  * component can connect to a real CLI. Mounts a discovery endpoint at
  * /_agent-native/agent-terminal-info for the client component.
  *
- * Skips activation when running inside a harness (HARNESS_PORT is set).
+ * Skips activation when running inside a frame (FRAME_PORT is set).
  */
 import { defineEventHandler } from "h3";
+// ─── module-load self-heal: chmod node-pty's spawn-helper ─────────────────
+// pnpm can extract node-pty's prebuilds tarball without running the
+// post-install that chmods spawn-helper, leaving it as `-rw-r--r--` instead
+// of `-rwxr-xr-x`. Every PTY spawn then fails with `posix_spawnp failed`.
+// Run the fix synchronously at module load (static imports, sync fs calls)
+// so by the time ANY plugin worker starts spawning PTYs, the helper is
+// already executable.
+(function fixSpawnHelperPermissions() {
+    if (!isNodeRuntime())
+        return;
+    try {
+        const req = createRequire(import.meta.url);
+        const ptyPkg = req.resolve("node-pty/package.json");
+        const ptyDir = path.dirname(ptyPkg);
+        const helper = path.join(ptyDir, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+        if (fs.existsSync(helper)) {
+            const mode = fs.statSync(helper).mode;
+            if (!(mode & 0o100)) {
+                fs.chmodSync(helper, 0o755);
+                console.log(`[terminal] Fixed non-executable node-pty spawn-helper at ${helper}`);
+            }
+        }
+    }
+    catch (err) {
+        console.warn("[terminal] Could not verify node-pty spawn-helper permissions:", err.message);
+    }
+})();
 export function createTerminalPlugin(options = {}) {
     return async (nitroApp) => {
+        // Terminal requires Node.js (PTY, child_process) — skip on edge runtimes
+        if (!isNodeRuntime())
+            return;
         // Always mount /_agent-native/available-clis so the client doesn't get 404s
-        nitroApp.h3App.use("/_agent-native/available-clis", defineEventHandler(async () => {
+        getH3App(nitroApp).use("/_agent-native/available-clis", defineEventHandler(async () => {
             try {
                 const { CLI_REGISTRY, commandExists } = await import("./cli-registry.js");
                 const results = [];
@@ -19,7 +54,7 @@ export function createTerminalPlugin(options = {}) {
                     results.push({
                         command: cmd,
                         label: entry.label,
-                        available: commandExists(cmd),
+                        available: await commandExists(cmd),
                     });
                 }
                 return results;
@@ -28,9 +63,9 @@ export function createTerminalPlugin(options = {}) {
                 return [];
             }
         }));
-        // Skip if running inside a harness
-        if (process.env.HARNESS_PORT) {
-            console.log("[terminal] Harness detected, skipping embedded terminal");
+        // Skip if running inside a frame
+        if (process.env.FRAME_PORT) {
+            console.log("[terminal] Frame detected, skipping embedded terminal");
             return;
         }
         const isProd = process.env.NODE_ENV === "production";
@@ -39,14 +74,14 @@ export function createTerminalPlugin(options = {}) {
         if (!enabled) {
             console.log("[terminal] Disabled in production (set AGENT_TERMINAL_ENABLED=true to enable)");
             // Mount a disabled info endpoint
-            nitroApp.h3App.use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({ available: false })));
+            getH3App(nitroApp).use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({ available: false })));
             return;
         }
         // Require authCheck in production to prevent unauthenticated shell access
         if (isProd && !options.authCheck) {
             console.error("[terminal] FATAL: authCheck is required when enabling the terminal in production. " +
                 "Pass an authCheck function to createTerminalPlugin().");
-            nitroApp.h3App.use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
+            getH3App(nitroApp).use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
                 available: false,
                 error: "Terminal requires authCheck in production",
             })));
@@ -56,7 +91,7 @@ export function createTerminalPlugin(options = {}) {
         if (process.env.__AGENT_TERMINAL_RUNNING === "true") {
             const existingPort = process.env.AGENT_TERMINAL_PORT;
             console.log(`[terminal] PTY server already running on port ${existingPort}, skipping`);
-            nitroApp.h3App.use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
+            getH3App(nitroApp).use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
                 available: true,
                 wsPort: existingPort ? parseInt(existingPort, 10) : 0,
                 command: options.command || process.env.AGENT_CLI_COMMAND || "builder",
@@ -68,6 +103,12 @@ export function createTerminalPlugin(options = {}) {
             (process.env.AGENT_TERMINAL_PORT
                 ? parseInt(process.env.AGENT_TERMINAL_PORT, 10)
                 : 0);
+        // Mark as running BEFORE the async server start. The previous code only
+        // set this AFTER `await createPtyWebSocketServer(...)`, which left a
+        // TOCTOU window where two concurrent plugin invocations would both pass
+        // the running-check, both spawn a server, and end up fighting for the
+        // CLI's PTY pool — leading to `posix_spawnp failed` floods.
+        process.env.__AGENT_TERMINAL_RUNNING = "true";
         try {
             const { createPtyWebSocketServer } = await import("./pty-server.js");
             const result = await createPtyWebSocketServer({
@@ -77,11 +118,10 @@ export function createTerminalPlugin(options = {}) {
                 authCheck: isProd ? options.authCheck : undefined,
                 logPrefix: "[terminal]",
             });
-            // Store port for other consumers and mark as running to prevent HMR duplication
+            // Store port for other consumers
             process.env.AGENT_TERMINAL_PORT = String(result.port);
-            process.env.__AGENT_TERMINAL_RUNNING = "true";
             // Mount discovery endpoint
-            nitroApp.h3App.use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
+            getH3App(nitroApp).use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
                 available: true,
                 wsPort: result.port,
                 command,
@@ -91,13 +131,16 @@ export function createTerminalPlugin(options = {}) {
             process.once("SIGTERM", cleanup);
             process.once("SIGINT", cleanup);
             process.once("exit", cleanup);
-            console.log(`[terminal] Agent terminal ready (command: ${command}, port: ${result.port})`);
+            if (process.env.DEBUG)
+                console.log(`[terminal] Agent terminal ready (command: ${command}, port: ${result.port})`);
         }
         catch (err) {
+            // Clear the running flag so a retry can spawn a fresh server
+            delete process.env.__AGENT_TERMINAL_RUNNING;
             console.error("[terminal] Failed to start PTY server:", err);
             console.error("[terminal] Make sure node-pty is installed: pnpm add node-pty");
             // Mount a fallback info endpoint
-            nitroApp.h3App.use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
+            getH3App(nitroApp).use("/_agent-native/agent-terminal-info", defineEventHandler(() => ({
                 available: false,
                 error: "PTY server failed to start",
             })));

package/dist/terminal/terminal-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-plugin.js","sourceRoot":"","sources":["../../src/terminal/terminal-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-plugin.js","sourceRoot":"","sources":["../../src/terminal/terminal-plugin.ts"],"names":[],"mappings":"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"}

package/dist/usage/store.d.ts

@@ -0,0 +1,29 @@
+/** Default usage limit per user in cents ($1.00) */
+export declare const DEFAULT_USAGE_LIMIT_CENTS = 100;
+/**
+ * Calculate cost in cents * 100 (for integer precision) given token counts and model.
+ * Returns cost in "centicents" (1/100th of a cent) so we can store as integer.
+ */
+export declare function calculateCost(inputTokens: number, outputTokens: number, model: string): number;
+/**
+ * Record token usage for a user after an agent run.
+ */
+export declare function recordUsage(ownerEmail: string, inputTokens: number, outputTokens: number, model: string): Promise<void>;
+/**
+ * Get total usage cost for a user in cents.
+ */
+export declare function getUserUsageCents(ownerEmail: string): Promise<number>;
+/**
+ * Check if a user has exceeded their usage limit.
+ * Returns { allowed: true } or { allowed: false, usageCents, limitCents }.
+ */
+export declare function checkUsageLimit(ownerEmail: string, limitCents?: number): Promise<{
+    allowed: true;
+    usageCents: number;
+    limitCents: number;
+} | {
+    allowed: false;
+    usageCents: number;
+    limitCents: number;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/usage/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/usage/store.ts"],"names":[],"mappings":"AAOA,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAkC7C;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,MAAM,CAeR;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAC7D,CAQA"}

package/dist/usage/store.js

@@ -0,0 +1,102 @@
+/**
+ * Token usage tracking and cost limits.
+ * Tracks per-user API token consumption and enforces spending limits
+ * for hosted production deployments.
+ */
+import { getDbExec, intType } from "../db/client.js";
+/** Default usage limit per user in cents ($1.00) */
+export const DEFAULT_USAGE_LIMIT_CENTS = 100;
+/** Cost per million tokens in cents — Haiku 4.5 pricing */
+const HAIKU_INPUT_COST_PER_MTOK = 80; // $0.80
+const HAIKU_OUTPUT_COST_PER_MTOK = 400; // $4.00
+/** Cost per million tokens in cents — Sonnet pricing */
+const SONNET_INPUT_COST_PER_MTOK = 300; // $3.00
+const SONNET_OUTPUT_COST_PER_MTOK = 1500; // $15.00
+let _initPromise;
+async function ensureUsageTable() {
+    if (!_initPromise) {
+        _initPromise = (async () => {
+            const client = getDbExec();
+            await client.execute(`
+        CREATE TABLE IF NOT EXISTS token_usage (
+          id ${intType()} PRIMARY KEY,
+          owner_email TEXT NOT NULL,
+          input_tokens ${intType()} NOT NULL DEFAULT 0,
+          output_tokens ${intType()} NOT NULL DEFAULT 0,
+          cost_cents_x100 ${intType()} NOT NULL DEFAULT 0,
+          model TEXT NOT NULL DEFAULT '',
+          created_at ${intType()} NOT NULL
+        )
+      `);
+            // For id generation on SQLite we rely on rowid; on Postgres use a sequence.
+            // Using timestamp-based IDs to avoid needing AUTOINCREMENT.
+        })();
+    }
+    return _initPromise;
+}
+/**
+ * Calculate cost in cents * 100 (for integer precision) given token counts and model.
+ * Returns cost in "centicents" (1/100th of a cent) so we can store as integer.
+ */
+export function calculateCost(inputTokens, outputTokens, model) {
+    const isHaiku = model.includes("haiku");
+    const inputCost = isHaiku
+        ? HAIKU_INPUT_COST_PER_MTOK
+        : SONNET_INPUT_COST_PER_MTOK;
+    const outputCost = isHaiku
+        ? HAIKU_OUTPUT_COST_PER_MTOK
+        : SONNET_OUTPUT_COST_PER_MTOK;
+    // cost_cents_x100 = (tokens / 1_000_000) * cost_per_mtok * 100
+    const inputCostX100 = Math.round((inputTokens / 1_000_000) * inputCost * 100);
+    const outputCostX100 = Math.round((outputTokens / 1_000_000) * outputCost * 100);
+    return inputCostX100 + outputCostX100;
+}
+/**
+ * Record token usage for a user after an agent run.
+ */
+export async function recordUsage(ownerEmail, inputTokens, outputTokens, model) {
+    await ensureUsageTable();
+    const client = getDbExec();
+    const costX100 = calculateCost(inputTokens, outputTokens, model);
+    const id = Date.now() * 1000 + Math.floor(Math.random() * 1000);
+    await client.execute({
+        sql: `INSERT INTO token_usage (id, owner_email, input_tokens, output_tokens, cost_cents_x100, model, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+        args: [
+            id,
+            ownerEmail,
+            inputTokens,
+            outputTokens,
+            costX100,
+            model,
+            Date.now(),
+        ],
+    });
+}
+/**
+ * Get total usage cost for a user in cents.
+ */
+export async function getUserUsageCents(ownerEmail) {
+    await ensureUsageTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT COALESCE(SUM(cost_cents_x100), 0) as total FROM token_usage WHERE owner_email = ?`,
+        args: [ownerEmail],
+    });
+    const total = Number(rows[0]?.total ?? 0);
+    // Convert from centicents to cents
+    return total / 100;
+}
+/**
+ * Check if a user has exceeded their usage limit.
+ * Returns { allowed: true } or { allowed: false, usageCents, limitCents }.
+ */
+export async function checkUsageLimit(ownerEmail, limitCents) {
+    const limit = limitCents ?? DEFAULT_USAGE_LIMIT_CENTS;
+    const usageCents = await getUserUsageCents(ownerEmail);
+    return {
+        allowed: usageCents < limit,
+        usageCents,
+        limitCents: limit,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/usage/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/usage/store.ts"],"names":[],"mappings":"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"}

package/dist/vite/action-types-plugin.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from "vite";
+/**
+ * Vite plugin that watches `actions/` and generates type-safe action types.
+ *
+ * Add to your Vite config (auto-included by `defineConfig` from `@agent-native/core`):
+ *
+ * ```ts
+ * import { actionTypesPlugin } from "@agent-native/core/vite/action-types-plugin";
+ * plugins: [actionTypesPlugin()]
+ * ```
+ */
+export declare function actionTypesPlugin(): Plugin;
+//# sourceMappingURL=action-types-plugin.d.ts.map

package/dist/vite/action-types-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types-plugin.d.ts","sourceRoot":"","sources":["../../src/vite/action-types-plugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAmFnC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAgC1C"}

package/dist/vite/action-types-plugin.js

@@ -0,0 +1,132 @@
+/**
+ * Vite plugin that generates end-to-end type-safe action types.
+ *
+ * Watches the `actions/` directory and emits `.generated/action-types.d.ts`,
+ * which augments the `ActionRegistry` interface in `@agent-native/core/client`.
+ * This gives `useActionQuery` and `useActionMutation` full type inference
+ * for action names, parameters, and return types — similar to tRPC.
+ *
+ * The generated file uses `typeof import()` to reference action source files,
+ * so TypeScript resolves the actual types at type-check time without any
+ * runtime cost or complex AST parsing.
+ */
+import path from "path";
+import fs from "fs";
+/** Files to skip during discovery (matches action-discovery.ts). */
+const SKIP_FILES = new Set([
+    "helpers",
+    "run",
+    "db-connect",
+    "db-status",
+    "registry",
+]);
+/**
+ * Scan the actions directory and emit a `.generated/action-types.d.ts` file.
+ * Only writes if the content has changed, to avoid triggering unnecessary rebuilds.
+ */
+function generateActionTypes(actionsDir, projectRoot) {
+    let files;
+    try {
+        files = fs.readdirSync(actionsDir);
+    }
+    catch {
+        return; // No actions directory — nothing to generate
+    }
+    const actionFiles = files.filter((f) => {
+        if (!f.endsWith(".ts") && !f.endsWith(".js"))
+            return false;
+        const name = f.replace(/\.(ts|js)$/, "");
+        if (name.startsWith("_"))
+            return false;
+        if (SKIP_FILES.has(name))
+            return false;
+        return true;
+    });
+    // Compute relative path from .generated/ to actions/
+    const outDir = path.resolve(projectRoot, ".generated");
+    const relActionsDir = path.relative(outDir, actionsDir).replace(/\\/g, "/");
+    const entries = actionFiles.map((f) => {
+        const name = f.replace(/\.(ts|js)$/, "");
+        const relPath = `${relActionsDir}/${name}`;
+        return `    "${name}": ActionEntry<typeof import("${relPath}")>;`;
+    });
+    const content = `// AUTO-GENERATED by @agent-native/core — do not edit manually.
+// Regenerated when files in actions/ change.
+// This file augments the ActionRegistry interface so that useActionQuery and
+// useActionMutation infer the correct types from your action definitions.
+
+/** Extract the return type and parameter type from a defineAction module. */
+type ActionEntry<T> = T extends { default: { run: (...args: infer A) => infer R } }
+  ? {
+      result: Awaited<R>;
+      params: A extends [infer P, ...any[]] ? P : Record<string, any>;
+    }
+  : { result: any; params: Record<string, any> };
+
+declare module "@agent-native/core/client" {
+  interface ActionRegistry {
+${entries.join("\n")}
+  }
+}
+
+export {};
+`;
+    fs.mkdirSync(outDir, { recursive: true });
+    const outFile = path.join(outDir, "action-types.d.ts");
+    const existing = fs.existsSync(outFile)
+        ? fs.readFileSync(outFile, "utf-8")
+        : "";
+    if (existing !== content) {
+        fs.writeFileSync(outFile, content);
+    }
+    // Ensure .generated/ is in .gitignore
+    const gitignorePath = path.join(projectRoot, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+        const gitignore = fs.readFileSync(gitignorePath, "utf-8");
+        if (!gitignore.includes(".generated")) {
+            fs.appendFileSync(gitignorePath, "\n.generated/\n");
+        }
+    }
+}
+/**
+ * Vite plugin that watches `actions/` and generates type-safe action types.
+ *
+ * Add to your Vite config (auto-included by `defineConfig` from `@agent-native/core`):
+ *
+ * ```ts
+ * import { actionTypesPlugin } from "@agent-native/core/vite/action-types-plugin";
+ * plugins: [actionTypesPlugin()]
+ * ```
+ */
+export function actionTypesPlugin() {
+    let projectRoot = "";
+    let actionsDir = "";
+    return {
+        name: "agent-native-action-types",
+        configResolved(config) {
+            projectRoot = config.root;
+            actionsDir = path.resolve(projectRoot, "actions");
+        },
+        buildStart() {
+            generateActionTypes(actionsDir, projectRoot);
+        },
+        configureServer(server) {
+            // Generate on startup
+            generateActionTypes(actionsDir, projectRoot);
+            // Watch for changes in actions/
+            const watcher = server.watcher;
+            const handleChange = (file) => {
+                if (file.startsWith(actionsDir) && /\.(ts|js)$/.test(file)) {
+                    generateActionTypes(actionsDir, projectRoot);
+                }
+            };
+            watcher.add(actionsDir);
+            watcher.on("add", handleChange);
+            watcher.on("unlink", handleChange);
+            // Don't regenerate on content changes — only file additions/removals
+            // affect the registry. Return type changes are picked up by TypeScript
+            // from the source files via typeof import().
+        },
+    };
+}
+//# sourceMappingURL=action-types-plugin.js.map

package/dist/vite/action-types-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types-plugin.js","sourceRoot":"","sources":["../../src/vite/action-types-plugin.ts"],"names":[],"mappings":"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"}

package/dist/vite/agents-bundle-plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "vite";
+export declare function agentsBundlePlugin(): Plugin;
+//# sourceMappingURL=agents-bundle-plugin.d.ts.map

package/dist/vite/agents-bundle-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-bundle-plugin.d.ts","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkBnC,wBAAgB,kBAAkB,IAAI,MAAM,CA2D3C"}

package/dist/vite/agents-bundle-plugin.js

@@ -0,0 +1,87 @@
+/**
+ * Vite plugin that resolves `virtual:agents-bundle` to a statically-inlined
+ * ES module containing the template's AGENTS.md + .agents/skills/ content.
+ *
+ * This is how the framework's agent gets its instructions and skills into the
+ * system prompt on EVERY deployment target — Node, Netlify Functions, Vercel
+ * serverless, and Cloudflare Workers. The content is baked into the server
+ * bundle at build time, so nothing needs to exist on the runtime filesystem.
+ *
+ * In dev mode, the plugin re-reads from disk on each import and triggers HMR
+ * when any AGENTS.md or SKILL.md file changes, so edits show up instantly
+ * without restarting the server.
+ */
+import path from "path";
+import fs from "fs";
+import { readAgentsBundleFromFs } from "../server/agents-bundle.js";
+const VIRTUAL_ID = "virtual:agents-bundle";
+const RESOLVED_ID = "\0" + VIRTUAL_ID;
+function emitBundleModule(projectRoot) {
+    const bundle = readAgentsBundleFromFs(projectRoot);
+    // Serialize as JSON and wrap in `export default` — this produces a valid
+    // ES module that any bundler (Rollup, esbuild, Rolldown) can statically
+    // analyze and tree-shake if nothing imports it.
+    return `// AUTO-GENERATED by @agent-native/core/vite/agents-bundle-plugin
+// Contains the inlined AGENTS.md + .agents/skills/ content from the template.
+const bundle = ${JSON.stringify(bundle)};
+export default bundle;
+`;
+}
+export function agentsBundlePlugin() {
+    let projectRoot = "";
+    return {
+        name: "agent-native-agents-bundle",
+        configResolved(config) {
+            projectRoot = config.root;
+        },
+        resolveId(id) {
+            if (id === VIRTUAL_ID)
+                return RESOLVED_ID;
+            return null;
+        },
+        load(id) {
+            if (id !== RESOLVED_ID)
+                return null;
+            if (!projectRoot)
+                projectRoot = process.cwd();
+            return emitBundleModule(projectRoot);
+        },
+        configureServer(server) {
+            // Watch AGENTS.md + any SKILL.md changes and invalidate the virtual
+            // module so the next request picks up fresh content.
+            const watcher = server.watcher;
+            const shouldInvalidate = (file) => {
+                const rel = path.relative(projectRoot, file);
+                if (rel.startsWith(".."))
+                    return false;
+                if (rel === "AGENTS.md")
+                    return true;
+                if (rel.startsWith(".agents" + path.sep + "skills") &&
+                    rel.endsWith("SKILL.md"))
+                    return true;
+                return false;
+            };
+            const invalidate = (file) => {
+                if (!shouldInvalidate(file))
+                    return;
+                const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+                if (mod) {
+                    server.moduleGraph.invalidateModule(mod);
+                    server.ws.send({ type: "full-reload" });
+                }
+            };
+            // Also explicitly watch AGENTS.md and the skills directory so edits to
+            // files outside the normal Vite watch set still trigger invalidation.
+            const agentsMdPath = path.join(projectRoot, "AGENTS.md");
+            const skillsDir = path.join(projectRoot, ".agents", "skills");
+            if (fs.existsSync(agentsMdPath))
+                watcher.add(agentsMdPath);
+            if (fs.existsSync(skillsDir))
+                watcher.add(skillsDir);
+            watcher.on("change", invalidate);
+            watcher.on("add", invalidate);
+            watcher.on("unlink", invalidate);
+        },
+    };
+}
+//# sourceMappingURL=agents-bundle-plugin.js.map

package/dist/vite/agents-bundle-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-bundle-plugin.js","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"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"}

package/dist/vite/client.d.ts

@@ -24,6 +24,11 @@ export interface ClientConfigOptions {
     fsAllow?: string[];
     /** Additional fs.deny patterns */
     fsDeny?: string[];
+    /** Additional Vite optimizeDeps configuration */
+    optimizeDeps?: {
+        include?: string[];
+        exclude?: string[];
+    };
     /**
      * @deprecated Pass `reactRouter()` directly in the `plugins` array instead.
      * Previously used to auto-load the React Router Vite plugin via require(),

package/dist/vite/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,MAAM,CAAC;AAuG/C,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AA8ED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAqF1E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,MAAM,CAAC;AAoG/C,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1D;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAqPD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAoG1E"}