@a5c-ai/agent-mux-gateway 0.0.0

package/README.md

@@ -0,0 +1,13 @@
+# @a5c-ai/agent-mux-gateway
+
+`@a5c-ai/agent-mux-gateway` is the package scaffold for remote and browser-facing
+agent-mux surfaces.
+
+Current scope:
+
+- `GatewayConfig` and default configuration helpers
+- `createGateway(config)` returning a start/stop gateway handle
+- basic gateway logger wiring
+
+Later tasks in `advanced-uis.md` will add the protocol server, auth, fanout,
+run management, and static web UI hosting.

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface GatewayConfig {
+    host: string;
+    port: number;
+    webuiRoot?: string | null;
+    enableWebui: boolean;
+}
+export declare const DEFAULT_GATEWAY_CONFIG: Readonly<GatewayConfig>;
+export declare function resolveGatewayConfig(config?: Partial<GatewayConfig>): GatewayConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAKzD,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa,CAKvF"}

package/dist/config.js

@@ -0,0 +1,13 @@
+export const DEFAULT_GATEWAY_CONFIG = Object.freeze({
+    host: '127.0.0.1',
+    port: 7878,
+    webuiRoot: null,
+    enableWebui: true,
+});
+export function resolveGatewayConfig(config = {}) {
+    return {
+        ...DEFAULT_GATEWAY_CONFIG,
+        ...config,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,sBAAsB,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC3E,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,SAAiC,EAAE;IACtE,OAAO;QACL,GAAG,sBAAsB;QACzB,GAAG,MAAM;KACV,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { GatewayConfig } from './config.js';
+import { GatewayLogger } from './logging.js';
+export type { GatewayConfig } from './config.js';
+export { DEFAULT_GATEWAY_CONFIG, resolveGatewayConfig, } from './config.js';
+export type { GatewayLogger } from './logging.js';
+export { createGatewayLogger } from './logging.js';
+export interface Gateway {
+    readonly config: GatewayConfig;
+    readonly logger: GatewayLogger;
+    readonly started: boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function createGateway(config?: Partial<GatewayConfig>): Gateway;
+//# 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,OAAO,EAEL,aAAa,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,OAAO,CAiC1E"}

package/dist/index.js

@@ -0,0 +1,38 @@
+import { resolveGatewayConfig, } from './config.js';
+import { createGatewayLogger, } from './logging.js';
+export { DEFAULT_GATEWAY_CONFIG, resolveGatewayConfig, } from './config.js';
+export { createGatewayLogger } from './logging.js';
+export function createGateway(config = {}) {
+    const resolvedConfig = resolveGatewayConfig(config);
+    const logger = createGatewayLogger();
+    let started = false;
+    return {
+        config: resolvedConfig,
+        logger,
+        get started() {
+            return started;
+        },
+        async start() {
+            if (started) {
+                return;
+            }
+            started = true;
+            logger.info('Gateway started', {
+                host: resolvedConfig.host,
+                port: resolvedConfig.port,
+                enableWebui: resolvedConfig.enableWebui,
+            });
+        },
+        async stop() {
+            if (!started) {
+                return;
+            }
+            started = false;
+            logger.info('Gateway stopped', {
+                host: resolvedConfig.host,
+                port: resolvedConfig.port,
+            });
+        },
+    };
+}
+//# 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,OAAO,EAGL,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAUnD,MAAM,UAAU,aAAa,CAAC,SAAiC,EAAE;IAC/D,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACrC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,MAAM;QACN,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC7B,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,WAAW,EAAE,cAAc,CAAC,WAAW;aACxC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC7B,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,IAAI,EAAE,cAAc,CAAC,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,8 @@
+export interface GatewayLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export declare function createGatewayLogger(): GatewayLogger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAoBD,wBAAgB,mBAAmB,IAAI,aAAa,CAenD"}

package/dist/logging.js

@@ -0,0 +1,33 @@
+function write(level, message, meta) {
+    const suffix = meta ? ` ${JSON.stringify(meta)}` : '';
+    const line = `[agent-mux-gateway:${level}] ${message}${suffix}`;
+    switch (level) {
+        case 'debug':
+        case 'info':
+            console.log(line);
+            return;
+        case 'warn':
+            console.warn(line);
+            return;
+        case 'error':
+            console.error(line);
+            return;
+    }
+}
+export function createGatewayLogger() {
+    return {
+        debug(message, meta) {
+            write('debug', message, meta);
+        },
+        info(message, meta) {
+            write('info', message, meta);
+        },
+        warn(message, meta) {
+            write('warn', message, meta);
+        },
+        error(message, meta) {
+            write('error', message, meta);
+        },
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAOA,SAAS,KAAK,CAAC,KAA0C,EAAE,OAAe,EAAE,IAA8B;IACxG,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,sBAAsB,KAAK,KAAK,OAAO,GAAG,MAAM,EAAE,CAAC;IAEhE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,KAAK,OAAO;YACV,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,CAAC,OAAO,EAAE,IAAI;YACjB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,IAAI;YAChB,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,IAAI;YAChB,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,IAAI;YACjB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@a5c-ai/agent-mux-gateway",
+  "version": "0.0.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Gateway package for remote and browser-facing agent-mux surfaces",
+  "author": "a5c-ai",
+  "homepage": "https://github.com/a5c-ai/agent-mux#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a5c-ai/agent-mux.git",
+    "directory": "packages/gateway"
+  },
+  "bugs": {
+    "url": "https://github.com/a5c-ai/agent-mux/issues"
+  },
+  "keywords": [
+    "agent-mux",
+    "gateway",
+    "websocket",
+    "remote",
+    "sdk"
+  ],
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "prepublishOnly": "npm run build"
+  }
+}