@alfe.ai/gateway 0.0.1

package/dist/src/index.d.ts

@@ -0,0 +1,164 @@
+//#region src/protocol.d.ts
+
+interface IPCRequest {
+  type: 'req';
+  id: string;
+  method: string;
+  params: Record<string, unknown>;
+}
+interface IPCResponse {
+  id: string;
+  ok: boolean;
+  payload?: unknown;
+  error?: {
+    code: string;
+    message: string;
+  };
+}
+interface IPCEvent {
+  type: 'event';
+  event: string;
+  payload: unknown;
+}
+/** Current IPC protocol version */
+declare const PROTOCOL_VERSION = 1;
+//#endregion
+//#region src/daemon.d.ts
+
+declare function startDaemon(): Promise<void>;
+//#endregion
+//#region src/config.d.ts
+/**
+ * Daemon configuration — reads ~/.alfe/config.toml and resolves agent identity.
+ *
+ * Bootstrap flow:
+ *   1. Read api_key from ~/.alfe/config.toml (via @alfe.ai/config)
+ *   2. Derive API endpoint from token prefix
+ *   3. Call /auth/validate to get tenantId (orgId)
+ *   4. Use tokenId as agent identity for cloud registration
+ */
+interface AgentWorkspaceConfig {
+  personalityKey?: string;
+  files: Record<string, string>;
+}
+declare const ALFE_DIR: string;
+declare const SOCKET_PATH: string;
+declare const PID_PATH: string;
+interface RuntimeConfig {
+  workspace: string;
+}
+interface DaemonConfig {
+  apiKey: string;
+  apiEndpoint: string;
+  gatewayWsUrl: string;
+  socketPath: string;
+  pidPath: string;
+  agentId: string;
+  orgId: string;
+  runtime: string;
+  /** Runtime configurations keyed by runtime name (e.g. 'openclaw') */
+  runtimes: Record<string, RuntimeConfig>;
+}
+interface AgentIdentity {
+  agentId: string;
+  orgId: string;
+  runtime: string;
+}
+/**
+ * Resolve agent identity by validating the api_key with the auth service.
+ * Returns agentId (derived from tokenId) and orgId (tenantId).
+ */
+declare function resolveAgentIdentity(apiKey: string, apiEndpoint: string): Promise<AgentIdentity>;
+/**
+ * Whether the daemon is running in managed mode (ECS Fargate container).
+ * In managed mode, configuration comes from environment variables instead
+ * of ~/.alfe/config.toml, and IPC/PID features are disabled.
+ */
+
+/**
+ * Load full daemon configuration.
+ * Reads config.toml, validates the API key, resolves agent identity,
+ * and parses runtime configurations.
+ *
+ * In managed mode, loads from environment variables instead.
+ */
+declare function loadDaemonConfig(): Promise<DaemonConfig>;
+/**
+ * Fetch agent workspace config from the API.
+ *
+ * 1. GET /agents/me/workspace → { personalityKey }
+ * 2. If personalityKey set, GET /personalities/:key/files → persona file contents
+ *
+ * Returns null if the agent has no personality assigned or the fetch fails.
+ */
+declare function fetchAgentConfig(apiKey: string, apiEndpoint: string): Promise<AgentWorkspaceConfig | null>;
+//#endregion
+//#region src/health.d.ts
+/**
+ * Health reporting — used by `alfe doctor` and `alfe gateway status`.
+ *
+ * Connects to the daemon's IPC socket and queries health information.
+ * Works even when the daemon is the only thing running (OpenClaw can be down).
+ */
+interface DaemonHealth {
+  daemon: {
+    status: 'running' | 'stopped' | 'unreachable';
+    pid?: number;
+    uptime?: number;
+    version?: string;
+  };
+  cloud: {
+    status: 'connected' | 'disconnected' | 'unknown';
+    latencyMs?: number;
+  };
+  plugins: {
+    name: string;
+    version: string;
+    capabilities: string[];
+    connectedAt: number;
+    lastSeen: number;
+  }[];
+  commandQueue: {
+    totalPending: number;
+  };
+}
+/**
+ * Query daemon health via IPC socket.
+ * Used by `alfe doctor` and `alfe gateway status`.
+ */
+declare function queryDaemonHealth(socketPath: string, timeoutMs?: number): Promise<DaemonHealth>;
+/**
+ * Format health info for terminal display.
+ */
+declare function formatHealthReport(health: DaemonHealth): string;
+//#endregion
+//#region src/process-manager.d.ts
+/**
+ * Process management — launchd/systemd service installation.
+ *
+ * Generates and installs user-space service units for auto-start on boot.
+ * No root required — uses user agents (Mac) or user units (Linux).
+ */
+/**
+ * Install the service unit for the current platform.
+ */
+declare function installService(): Promise<string>;
+/**
+ * Uninstall the service unit for the current platform.
+ */
+declare function uninstallService(): Promise<string>;
+/**
+ * Write the current process PID to the PID file.
+ */
+
+/**
+ * Check if a daemon is already running.
+ * Returns the PID if alive, null if not running.
+ */
+declare function checkExistingDaemon(): Promise<number | null>;
+/**
+ * Send SIGTERM to an existing daemon process.
+ */
+declare function stopExistingDaemon(): Promise<boolean>;
+//#endregion
+export { ALFE_DIR, type AgentIdentity, type AgentWorkspaceConfig, type DaemonConfig, type DaemonHealth, type IPCEvent, type IPCRequest, type IPCResponse, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };

package/dist/src/index.js

@@ -0,0 +1,2 @@
+import { a as installService, c as PROTOCOL_VERSION, d as SOCKET_PATH, f as fetchAgentConfig, i as checkExistingDaemon, l as ALFE_DIR, m as resolveAgentIdentity, n as queryDaemonHealth, o as stopExistingDaemon, p as loadDaemonConfig, r as startDaemon, s as uninstallService, t as formatHealthReport, u as PID_PATH } from "../health.js";
+export { ALFE_DIR, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@alfe.ai/gateway",
+  "version": "0.0.1",
+  "description": "Alfe local gateway daemon — persistent control plane for agent integrations",
+  "type": "module",
+  "bin": {
+    "alfe-gateway": "./dist/bin/gateway.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "pino": "^9.6.0",
+    "smol-toml": "^1.3.0",
+    "pino-roll": "^1.2.0",
+    "ws": "^8.18.0",
+    "@alfe.ai/config": "^0.0.1",
+    "@alfe.ai/integrations": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.13",
+    "tsx": "^4.19.0",
+    "@alfe/ids": "0.1.0"
+  },
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "start": "node dist/bin/gateway.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint ."
+  }
+}