@agentuity/vite 3.0.0-beta.8

package/README.md

@@ -0,0 +1,39 @@
+# @agentuity/vite
+
+Vite plugin for the Agentuity public-URL devmode tunnel.
+
+When `agentuity dev --public` is active, the CLI exports
+`AGENTUITY_DEVMODE_HOSTNAME` so this plugin can configure Vite for the
+gravity tunnel: it adds the public hostname to `server.allowedHosts`
+and points `server.hmr` at `wss://<hostname>:443` so HMR works for
+users browsing the public URL.
+
+The plugin is a no-op when the env var isn't set, so it's safe to
+keep in `vite.config.ts` permanently.
+
+## Install
+
+```bash
+bun add -d @agentuity/vite
+```
+
+## Usage
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import agentuity from '@agentuity/vite';
+
+export default defineConfig({
+  plugins: [agentuity()],
+});
+```
+
+For SvelteKit / Astro / similar — the plugin works in any Vite-based
+config; just add it to the `plugins` array.
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `hostname` | `string` | `process.env.AGENTUITY_DEVMODE_HOSTNAME` | Override the public hostname the plugin reacts to. Useful for testing. |

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Agentuity Vite plugin.
+ *
+ * Wires Vite's dev server up to a gravity public-URL tunnel that the
+ * Agentuity CLI may be running. When `agentuity dev --public` is
+ * active, the CLI exports `AGENTUITY_DEVMODE_HOSTNAME` (and
+ * `AGENTUITY_DEVMODE_URL`) into the user's framework process.
+ *
+ * This plugin reads that hostname and:
+ *
+ *   1. Adds it to `server.allowedHosts` so Vite stops rejecting
+ *      requests with "Blocked request. This host is not allowed."
+ *   2. Configures `server.hmr` so the HMR WebSocket connects back
+ *      through the tunnel using `wss://<hostname>:443`. Without this,
+ *      the browser tries to dial Vite directly on the local port and
+ *      HMR silently fails for users browsing the public URL.
+ *
+ * The plugin is a no-op when the env var is absent, so it's safe to
+ * always include in `vite.config.ts`.
+ */
+import type { Plugin } from 'vite';
+export interface AgentuityVitePluginOptions {
+    /**
+     * Override the hostname the plugin reacts to. When omitted, the
+     * plugin reads `process.env.AGENTUITY_DEVMODE_HOSTNAME`.
+     */
+    hostname?: string;
+}
+/**
+ * Vite plugin: enables Agentuity public-URL devmode (gravity tunnel).
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import agentuity from '@agentuity/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [agentuity()],
+ * });
+ * ```
+ */
+export default function agentuity(options?: AgentuityVitePluginOptions): Plugin;
+export { agentuity };
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAI/C,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,CA2BlF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,65 @@
+/**
+ * Agentuity Vite plugin.
+ *
+ * Wires Vite's dev server up to a gravity public-URL tunnel that the
+ * Agentuity CLI may be running. When `agentuity dev --public` is
+ * active, the CLI exports `AGENTUITY_DEVMODE_HOSTNAME` (and
+ * `AGENTUITY_DEVMODE_URL`) into the user's framework process.
+ *
+ * This plugin reads that hostname and:
+ *
+ *   1. Adds it to `server.allowedHosts` so Vite stops rejecting
+ *      requests with "Blocked request. This host is not allowed."
+ *   2. Configures `server.hmr` so the HMR WebSocket connects back
+ *      through the tunnel using `wss://<hostname>:443`. Without this,
+ *      the browser tries to dial Vite directly on the local port and
+ *      HMR silently fails for users browsing the public URL.
+ *
+ * The plugin is a no-op when the env var is absent, so it's safe to
+ * always include in `vite.config.ts`.
+ */
+const ENV_HOSTNAME = 'AGENTUITY_DEVMODE_HOSTNAME';
+/**
+ * Vite plugin: enables Agentuity public-URL devmode (gravity tunnel).
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import agentuity from '@agentuity/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [agentuity()],
+ * });
+ * ```
+ */
+export default function agentuity(options = {}) {
+    return {
+        name: 'agentuity:devmode',
+        // Only apply during dev. Production builds don't need this.
+        apply: 'serve',
+        config() {
+            const hostname = options.hostname ?? process.env[ENV_HOSTNAME];
+            if (!hostname) {
+                return undefined;
+            }
+            return {
+                server: {
+                    // Vite requires the hostname to be in this list — strings
+                    // are matched exactly, regex entries can broaden matches.
+                    allowedHosts: [hostname],
+                    // HMR comes in over the gravity TLS tunnel on port 443.
+                    // Without this Vite tells the browser to dial localhost
+                    // directly, which fails for clients hitting the public URL.
+                    hmr: {
+                        host: hostname,
+                        clientPort: 443,
+                        protocol: 'wss',
+                    },
+                },
+            };
+        },
+    };
+}
+export { agentuity };
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAUlD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,UAAsC,EAAE;IACzE,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,4DAA4D;QAC5D,KAAK,EAAE,OAAO;QACd,MAAM;YACL,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,OAAO;gBACN,MAAM,EAAE;oBACP,0DAA0D;oBAC1D,0DAA0D;oBAC1D,YAAY,EAAE,CAAC,QAAQ,CAAC;oBACxB,wDAAwD;oBACxD,wDAAwD;oBACxD,4DAA4D;oBAC5D,GAAG,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,GAAG;wBACf,QAAQ,EAAE,KAAK;qBACf;iBACD;aACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@agentuity/vite",
+	"version": "3.0.0-beta.8",
+	"description": "Vite plugin for the Agentuity dev public-URL tunnel",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "tsgo --build --force",
+		"typecheck": "tsgo --noEmit",
+		"prepublishOnly": "bun run clean && bun run build",
+		"test": "bun test"
+	},
+	"peerDependencies": {
+		"vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^22.0.0",
+		"typescript": "^6.0.2",
+		"vite": "^7.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false,
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agentuity/sdk.git",
+		"directory": "packages/vite"
+	}
+}

package/src/index.ts

@@ -0,0 +1,77 @@
+/**
+ * Agentuity Vite plugin.
+ *
+ * Wires Vite's dev server up to a gravity public-URL tunnel that the
+ * Agentuity CLI may be running. When `agentuity dev --public` is
+ * active, the CLI exports `AGENTUITY_DEVMODE_HOSTNAME` (and
+ * `AGENTUITY_DEVMODE_URL`) into the user's framework process.
+ *
+ * This plugin reads that hostname and:
+ *
+ *   1. Adds it to `server.allowedHosts` so Vite stops rejecting
+ *      requests with "Blocked request. This host is not allowed."
+ *   2. Configures `server.hmr` so the HMR WebSocket connects back
+ *      through the tunnel using `wss://<hostname>:443`. Without this,
+ *      the browser tries to dial Vite directly on the local port and
+ *      HMR silently fails for users browsing the public URL.
+ *
+ * The plugin is a no-op when the env var is absent, so it's safe to
+ * always include in `vite.config.ts`.
+ */
+
+import type { Plugin, UserConfig } from 'vite';
+
+const ENV_HOSTNAME = 'AGENTUITY_DEVMODE_HOSTNAME';
+
+export interface AgentuityVitePluginOptions {
+	/**
+	 * Override the hostname the plugin reacts to. When omitted, the
+	 * plugin reads `process.env.AGENTUITY_DEVMODE_HOSTNAME`.
+	 */
+	hostname?: string;
+}
+
+/**
+ * Vite plugin: enables Agentuity public-URL devmode (gravity tunnel).
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import agentuity from '@agentuity/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [agentuity()],
+ * });
+ * ```
+ */
+export default function agentuity(options: AgentuityVitePluginOptions = {}): Plugin {
+	return {
+		name: 'agentuity:devmode',
+		// Only apply during dev. Production builds don't need this.
+		apply: 'serve',
+		config(): UserConfig | undefined {
+			const hostname = options.hostname ?? process.env[ENV_HOSTNAME];
+			if (!hostname) {
+				return undefined;
+			}
+			return {
+				server: {
+					// Vite requires the hostname to be in this list — strings
+					// are matched exactly, regex entries can broaden matches.
+					allowedHosts: [hostname],
+					// HMR comes in over the gravity TLS tunnel on port 443.
+					// Without this Vite tells the browser to dial localhost
+					// directly, which fails for clients hitting the public URL.
+					hmr: {
+						host: hostname,
+						clientPort: 443,
+						protocol: 'wss',
+					},
+				},
+			};
+		},
+	};
+}
+
+export { agentuity };