@agent-native/core 0.1.0

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

@@ -0,0 +1,40 @@
+import { useEffect } 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, onEvent } = options;
+    const keys = options.queryKeys ?? ["file", "fileTree"];
+    const url = options.eventsUrl ?? "/api/events";
+    useEffect(() => {
+        const eventSource = new EventSource(url);
+        eventSource.onmessage = (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                if (queryClient) {
+                    for (const key of keys) {
+                        queryClient.invalidateQueries({ queryKey: [key] });
+                    }
+                }
+                onEvent?.(data);
+            }
+            catch (err) {
+                console.error("[useFileWatcher] error parsing event data", err);
+            }
+        };
+        eventSource.onerror = (err) => {
+            console.error("[useFileWatcher] SSE connection error", err);
+        };
+        return () => {
+            eventSource.close();
+        };
+    }, [url, queryClient, onEvent, ...keys]);
+}
+//# sourceMappingURL=use-file-watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-watcher.js","sourceRoot":"","sources":["../../src/client/use-file-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,UAK3B,EAAE;IACJ,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,aAAa,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QAEzC,WAAW,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEpC,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC;QAEF,WAAW,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE;YAC5B,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/client/use-fusion-chat.d.ts

@@ -0,0 +1,14 @@
+import { type FusionChatMessage } from "./fusion-chat.js";
+/**
+ * Hook that wraps sendToFusionChat with a loading state.
+ *
+ * Returns [isGenerating, send] where:
+ * - isGenerating: true after send() is called, false when the
+ *   builder.fusion.chatRunning event fires with detail.isRunning === false
+ * - send: wrapper around sendToFusionChat that sets isGenerating to true
+ */
+export declare function useFusionChatGenerating(): [
+    boolean,
+    (opts: FusionChatMessage) => void
+];
+//# sourceMappingURL=use-fusion-chat.d.ts.map

package/dist/client/use-fusion-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fusion-chat.d.ts","sourceRoot":"","sources":["../../src/client/use-fusion-chat.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI;IACzC,OAAO;IACP,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI;CAClC,CAqBA"}

package/dist/client/use-fusion-chat.js

@@ -0,0 +1,29 @@
+import { useState, useEffect, useCallback } from "react";
+import { sendToFusionChat } from "./fusion-chat.js";
+/**
+ * Hook that wraps sendToFusionChat with a loading state.
+ *
+ * Returns [isGenerating, send] where:
+ * - isGenerating: true after send() is called, false when the
+ *   builder.fusion.chatRunning event fires with detail.isRunning === false
+ * - send: wrapper around sendToFusionChat that sets isGenerating to true
+ */
+export function useFusionChatGenerating() {
+    const [isGenerating, setIsGenerating] = useState(false);
+    useEffect(() => {
+        const handler = (e) => {
+            const detail = e.detail;
+            if (detail?.isRunning === false) {
+                setIsGenerating(false);
+            }
+        };
+        window.addEventListener("builder.fusion.chatRunning", handler);
+        return () => window.removeEventListener("builder.fusion.chatRunning", handler);
+    }, []);
+    const send = useCallback((opts) => {
+        setIsGenerating(true);
+        sendToFusionChat(opts);
+    }, []);
+    return [isGenerating, send];
+}
+//# sourceMappingURL=use-fusion-chat.js.map

package/dist/client/use-fusion-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fusion-chat.js","sourceRoot":"","sources":["../../src/client/use-fusion-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB;IAIrC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAI,CAAiB,CAAC,MAAM,CAAC;YACzC,IAAI,MAAM,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;gBAChC,eAAe,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,GAAG,EAAE,CACV,MAAM,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,IAAuB,EAAE,EAAE;QACnD,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/client/utils.d.ts

@@ -0,0 +1,4 @@
+import { type ClassValue } from "clsx";
+/** Merge class names with clsx + tailwind-merge. */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/client/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG7C,oDAAoD;AACpD,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/client/utils.js

@@ -0,0 +1,7 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+/** Merge class names with clsx + tailwind-merge. */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=utils.js.map

package/dist/client/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/client/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,oDAAoD;AACpD,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createServer, createFileWatcher, createSSEHandler, createProductionServer, } from "./server/index.js";
+export { sendToFusionChat, useFusionChatGenerating, useFileWatcher, cn } from "./client/index.js";
+export { fusionChat } from "./shared/index.js";
+export { runScript, loadEnv, parseArgs, camelCaseArgs, isValidPath, isValidProjectPath, ensureDir, fail, } from "./scripts/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAElG,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,IAAI,GACL,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Main entry point — re-exports from all subpackages for convenience.
+// Prefer importing from specific subpaths (e.g. "@agent-native/core/server")
+// for better tree-shaking and to avoid pulling in unnecessary dependencies.
+export { createServer, createFileWatcher, createSSEHandler, createProductionServer, } from "./server/index.js";
+export { sendToFusionChat, useFusionChatGenerating, useFileWatcher, cn } from "./client/index.js";
+export { fusionChat } from "./shared/index.js";
+export { runScript, loadEnv, parseArgs, camelCaseArgs, isValidPath, isValidProjectPath, ensureDir, fail, } from "./scripts/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,6EAA6E;AAC7E,4EAA4E;AAE5E,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAElG,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,IAAI,GACL,MAAM,oBAAoB,CAAC"}

package/dist/scripts/index.d.ts

@@ -0,0 +1,3 @@
+export { runScript } from "./runner.js";
+export { loadEnv, parseArgs, camelCaseArgs, isValidPath, isValidProjectPath, ensureDir, fail, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scripts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scripts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,IAAI,GACL,MAAM,YAAY,CAAC"}

package/dist/scripts/index.js

@@ -0,0 +1,3 @@
+export { runScript } from "./runner.js";
+export { loadEnv, parseArgs, camelCaseArgs, isValidPath, isValidProjectPath, ensureDir, fail, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/scripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scripts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,IAAI,GACL,MAAM,YAAY,CAAC"}

package/dist/scripts/runner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic script dispatcher for @agent-native/core apps.
+ *
+ * Dynamically imports and runs scripts from the app's scripts/ directory.
+ * Scripts must export a default function: (args: string[]) => Promise<void>
+ *
+ * Usage: pnpm script <script-name> [--args]
+ */
+/**
+ * Run the script dispatcher. Call this from your app's scripts/run.ts:
+ *
+ *   import { runScript } from "@agent-native/core/scripts";
+ *   runScript();
+ */
+export declare function runScript(): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/scripts/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/scripts/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA8B/C"}

package/dist/scripts/runner.js

@@ -0,0 +1,42 @@
+/**
+ * Generic script dispatcher for @agent-native/core apps.
+ *
+ * Dynamically imports and runs scripts from the app's scripts/ directory.
+ * Scripts must export a default function: (args: string[]) => Promise<void>
+ *
+ * Usage: pnpm script <script-name> [--args]
+ */
+/**
+ * Run the script dispatcher. Call this from your app's scripts/run.ts:
+ *
+ *   import { runScript } from "@agent-native/core/scripts";
+ *   runScript();
+ */
+export async function runScript() {
+    const scriptName = process.argv[2];
+    if (!scriptName || scriptName === "--help") {
+        console.log(`Usage: pnpm script <script-name> [--arg value ...]`);
+        console.log(`\nRun any script with --help for usage details.`);
+        process.exit(0);
+    }
+    // Validate script name (only allow alphanumeric + hyphens)
+    if (!/^[a-z][a-z0-9-]*$/.test(scriptName)) {
+        console.error(`Error: Invalid script name "${scriptName}"`);
+        process.exit(1);
+    }
+    // Dynamically import and run the script
+    try {
+        const mod = await import(`./${scriptName}.js`);
+        const args = process.argv.slice(3);
+        await mod.default(args);
+    }
+    catch (err) {
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+            console.error(`Error: Script "${scriptName}" not found. Run "pnpm script --help" for usage.`);
+            process.exit(1);
+        }
+        console.error(`Script "${scriptName}" failed:`, err.message || err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/scripts/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/scripts/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,+BAA+B,UAAU,GAAG,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CACX,kBAAkB,UAAU,kDAAkD,CAC/E,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,WAAW,UAAU,WAAW,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/scripts/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Load .env from project root (cwd).
+ */
+export declare function loadEnv(envPath?: string): void;
+/**
+ * Parse CLI args in --key value format.
+ * Supports: --key value, --key=value, --flag (boolean true)
+ */
+export declare function parseArgs(args: string[]): Record<string, string>;
+/**
+ * Convert kebab-case keys to camelCase.
+ */
+export declare function camelCaseArgs(args: Record<string, string>): Record<string, string>;
+/**
+ * Validate a relative file path (no traversal, no absolute).
+ */
+export declare function isValidPath(p: string): boolean;
+/**
+ * Validate a project slug (e.g. "my-project" or "group/my-project").
+ */
+export declare function isValidProjectPath(project: string): boolean;
+/**
+ * mkdir -p helper.
+ */
+export declare function ensureDir(dir: string): void;
+/**
+ * Print error to stderr and exit with code 1.
+ */
+export declare function fail(message: string): never;
+//# sourceMappingURL=utils.d.ts.map

package/dist/scripts/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/scripts/utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAK9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAG3C"}

package/dist/scripts/utils.js

@@ -0,0 +1,88 @@
+import fs from "fs";
+import path from "path";
+import dotenv from "dotenv";
+/**
+ * Load .env from project root (cwd).
+ */
+export function loadEnv(envPath) {
+    dotenv.config({ path: envPath ?? path.join(process.cwd(), ".env") });
+}
+/**
+ * Parse CLI args in --key value format.
+ * Supports: --key value, --key=value, --flag (boolean true)
+ */
+export function parseArgs(args) {
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg.startsWith("--"))
+            continue;
+        const eqIndex = arg.indexOf("=");
+        if (eqIndex !== -1) {
+            const key = arg.slice(2, eqIndex);
+            result[key] = arg.slice(eqIndex + 1);
+        }
+        else {
+            const key = arg.slice(2);
+            const next = args[i + 1];
+            if (next && !next.startsWith("--")) {
+                result[key] = next;
+                i++;
+            }
+            else {
+                result[key] = "true";
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Convert kebab-case keys to camelCase.
+ */
+export function camelCaseArgs(args) {
+    const result = {};
+    for (const [key, value] of Object.entries(args)) {
+        const camel = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        result[camel] = value;
+    }
+    return result;
+}
+/**
+ * Validate a relative file path (no traversal, no absolute).
+ */
+export function isValidPath(p) {
+    const normalized = path.normalize(p);
+    return (!normalized.startsWith("..") && !path.isAbsolute(normalized) && !p.includes("\0"));
+}
+/**
+ * Validate a project slug (e.g. "my-project" or "group/my-project").
+ */
+export function isValidProjectPath(project) {
+    if (!project)
+        return false;
+    const normalized = path.posix.normalize(project);
+    if (normalized.startsWith("..") || path.isAbsolute(normalized))
+        return false;
+    if (normalized.includes("\0"))
+        return false;
+    const segments = normalized.split("/").filter(Boolean);
+    if (!segments.length)
+        return false;
+    return segments.every((s) => /^[a-z0-9][a-z0-9-]*$/.test(s));
+}
+/**
+ * mkdir -p helper.
+ */
+export function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Print error to stderr and exit with code 1.
+ */
+export function fail(message) {
+    console.error(`Error: ${message}`);
+    process.exit(1);
+}
+//# sourceMappingURL=utils.js.map

package/dist/scripts/utils.js.map

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

package/dist/server/create-server.d.ts

@@ -0,0 +1,21 @@
+import express from "express";
+import cors from "cors";
+export interface CreateServerOptions {
+    /** CORS options. Pass false to disable. Default: enabled with defaults. */
+    cors?: cors.CorsOptions | false;
+    /** JSON body parser limit. Default: "50mb" */
+    jsonLimit?: string;
+    /** Custom ping message. Default: reads PING_MESSAGE env var, falls back to "pong" */
+    pingMessage?: string;
+    /** Disable the /api/ping health check. Default: false */
+    disablePing?: boolean;
+}
+/**
+ * Create a pre-configured Express app with standard agent-native middleware:
+ * - CORS
+ * - JSON body parser (50mb limit)
+ * - URL-encoded body parser
+ * - /api/ping health check
+ */
+export declare function createServer(options?: CreateServerOptions): express.Express;
+//# sourceMappingURL=create-server.d.ts.map

package/dist/server/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAChC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,OAAO,CAmB/E"}

package/dist/server/create-server.js

@@ -0,0 +1,27 @@
+import express from "express";
+import cors from "cors";
+/**
+ * Create a pre-configured Express app with standard agent-native middleware:
+ * - CORS
+ * - JSON body parser (50mb limit)
+ * - URL-encoded body parser
+ * - /api/ping health check
+ */
+export function createServer(options = {}) {
+    const app = express();
+    // Middleware
+    if (options.cors !== false) {
+        app.use(cors(options.cors));
+    }
+    app.use(express.json({ limit: options.jsonLimit ?? "50mb" }));
+    app.use(express.urlencoded({ extended: true }));
+    // Health check
+    if (!options.disablePing) {
+        app.get("/api/ping", (_req, res) => {
+            const message = options.pingMessage ?? process.env.PING_MESSAGE ?? "pong";
+            res.json({ message });
+        });
+    }
+    return app;
+}
+//# sourceMappingURL=create-server.js.map

package/dist/server/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAaxB;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,aAAa;IACb,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEhD,eAAe;IACf,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC;YAC1E,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+export { createServer, type CreateServerOptions } from "./create-server.js";
+export { createFileWatcher, createSSEHandler, type FileWatcherOptions, type SSEHandlerOptions, } from "./sse.js";
+export { createProductionServer, type ProductionServerOptions, } from "./production.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+export { createServer } from "./create-server.js";
+export { createFileWatcher, createSSEHandler, } from "./sse.js";
+export { createProductionServer, } from "./production.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GAGjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC"}

package/dist/server/production.d.ts

@@ -0,0 +1,18 @@
+import type { Express } from "express";
+export interface ProductionServerOptions {
+    /** Port to listen on. Default: process.env.PORT || 3000 */
+    port?: number | string;
+    /** Path to the built SPA directory. Default: inferred from import.meta or "dist/spa" */
+    spaDir?: string;
+    /** App name for log messages. Default: "Agent-Native" */
+    appName?: string;
+}
+/**
+ * Start a production server that:
+ * 1. Serves the built SPA static files
+ * 2. Falls back to index.html for client-side routing (SPA fallback)
+ * 3. Returns 404 JSON for unknown API routes
+ * 4. Handles graceful shutdown on SIGTERM/SIGINT
+ */
+export declare function createProductionServer(app: Express, options?: ProductionServerOptions): void;
+//# sourceMappingURL=production.d.ts.map

package/dist/server/production.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../src/server/production.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAgCN"}

package/dist/server/production.js

@@ -0,0 +1,37 @@
+import path from "path";
+import express from "express";
+/**
+ * Start a production server that:
+ * 1. Serves the built SPA static files
+ * 2. Falls back to index.html for client-side routing (SPA fallback)
+ * 3. Returns 404 JSON for unknown API routes
+ * 4. Handles graceful shutdown on SIGTERM/SIGINT
+ */
+export function createProductionServer(app, options = {}) {
+    const port = options.port ?? process.env.PORT ?? 3000;
+    const appName = options.appName ?? "Agent-Native";
+    // Resolve SPA directory
+    const spaDir = options.spaDir ?? path.resolve(process.cwd(), "dist/spa");
+    // Serve static files
+    app.use(express.static(spaDir));
+    // SPA fallback — serve index.html for all non-API routes
+    app.get("*", (req, res) => {
+        if (req.path.startsWith("/api/") || req.path.startsWith("/health")) {
+            return res.status(404).json({ error: "API endpoint not found" });
+        }
+        res.sendFile(path.join(spaDir, "index.html"));
+    });
+    app.listen(port, () => {
+        console.log(`${appName} server running on port ${port}`);
+        console.log(`  Frontend: http://localhost:${port}`);
+        console.log(`  API: http://localhost:${port}/api`);
+    });
+    // Graceful shutdown
+    const shutdown = (signal) => {
+        console.log(`Received ${signal}, shutting down gracefully`);
+        process.exit(0);
+    };
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    process.on("SIGINT", () => shutdown("SIGINT"));
+}
+//# sourceMappingURL=production.js.map

package/dist/server/production.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production.js","sourceRoot":"","sources":["../../src/server/production.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,OAAO,MAAM,SAAS,CAAC;AAW9B;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAY,EACZ,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAElD,wBAAwB;IACxB,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAE5D,qBAAqB;IACrB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEhC,yDAAyD;IACzD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,2BAA2B,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,4BAA4B,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/server/sse.d.ts

@@ -0,0 +1,30 @@
+import { type FSWatcher } from "chokidar";
+import { EventEmitter } from "events";
+import type { Request, Response } from "express";
+export type { FSWatcher } from "chokidar";
+export interface FileWatcherOptions {
+    /** Glob patterns or regex to ignore. */
+    ignored?: any;
+    /** Whether to emit events for the initial file scan. Default: false (ignoreInitial: true) */
+    emitInitial?: boolean;
+}
+/**
+ * Create a chokidar file watcher for the given directory.
+ * Returns a chokidar.FSWatcher that emits "all" events on file changes.
+ */
+export declare function createFileWatcher(dir: string, options?: FileWatcherOptions): FSWatcher;
+export interface SSEHandlerOptions {
+    /** Additional EventEmitters to stream events from (e.g. sync events). */
+    extraEmitters?: Array<{
+        emitter: EventEmitter;
+        event: string;
+    }>;
+}
+/**
+ * Create an Express route handler that streams Server-Sent Events for file changes.
+ *
+ * Usage:
+ *   app.get("/api/events", createSSEHandler(watcher));
+ */
+export declare function createSSEHandler(watcher: FSWatcher, options?: SSEHandlerOptions): (req: Request, res: Response) => void;
+//# sourceMappingURL=sse.d.ts.map

package/dist/server/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,SAAS,CAKX;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE,iBAAsB,GAC9B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CA8BvC"}

package/dist/server/sse.js

@@ -0,0 +1,44 @@
+import { watch } from "chokidar";
+/**
+ * Create a chokidar file watcher for the given directory.
+ * Returns a chokidar.FSWatcher that emits "all" events on file changes.
+ */
+export function createFileWatcher(dir, options = {}) {
+    return watch(dir, {
+        ignoreInitial: !options.emitInitial,
+        ignored: options.ignored,
+    });
+}
+/**
+ * Create an Express route handler that streams Server-Sent Events for file changes.
+ *
+ * Usage:
+ *   app.get("/api/events", createSSEHandler(watcher));
+ */
+export function createSSEHandler(watcher, options = {}) {
+    return (req, res) => {
+        res.setHeader("Content-Type", "text/event-stream");
+        res.setHeader("Cache-Control", "no-cache");
+        res.setHeader("Connection", "keep-alive");
+        res.flushHeaders();
+        const onChange = (eventName, filePath) => {
+            res.write(`data: ${JSON.stringify({ type: eventName, path: filePath })}\n\n`);
+        };
+        watcher.on("all", onChange);
+        // Subscribe to extra emitters
+        const cleanups = [];
+        for (const { emitter, event } of options.extraEmitters ?? []) {
+            const handler = (data) => {
+                res.write(`data: ${JSON.stringify(data)}\n\n`);
+            };
+            emitter.on(event, handler);
+            cleanups.push(() => emitter.off(event, handler));
+        }
+        req.on("close", () => {
+            watcher.off("all", onChange);
+            for (const cleanup of cleanups)
+                cleanup();
+        });
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/server/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,UAAU,CAAC;AAajD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,UAA8B,EAAE;IAEhC,OAAO,KAAK,CAAC,GAAG,EAAE;QAChB,aAAa,EAAE,CAAC,OAAO,CAAC,WAAW;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;AACL,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAkB,EAClB,UAA6B,EAAE;IAE/B,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACrC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QACnD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,EAAE,CAAC;QAEnB,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,QAAgB,EAAE,EAAE;YACvD,GAAG,CAAC,KAAK,CACP,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,CACnE,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAE5B,8BAA8B;QAC9B,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,CAAC,IAAS,EAAE,EAAE;gBAC5B,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjD,CAAC,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}