aimeat 1.20.6 → 1.22.0

package/dist/src/cli/connect/api-client.d.ts

@@ -6,12 +6,36 @@ export interface ApiResponse {
         message: string;
     };
 }
+/**
+ * Pluggable request transport. `path` is always node-relative (`/v1/...`);
+ * absolute URLs never reach a transport (they go direct — see `send()`).
+ * Returns the HTTP status and the parsed (envelope) body.
+ */
+export interface Transport {
+    request(method: string, path: string, opts?: {
+        body?: unknown;
+        query?: Record<string, string>;
+    }): Promise<{
+        status: number;
+        body: unknown;
+    }>;
+}
 export declare class AimeatClient {
     private baseUrl;
     private token;
+    private transport;
     constructor(baseUrl: string, token?: string);
     static fromConfig(): Promise<AimeatClient>;
+    /** Route subsequent requests through `t` (e.g. the tunnel). `null` restores direct fetch. */
+    setTransport(t: Transport | null): void;
+    hasTransport(): boolean;
     private headers;
+    /**
+     * Single dispatch point for every verb. Node-relative paths go through the
+     * transport when one is set; absolute URLs (presigned uploads etc.) and the
+     * default case use direct fetch with `Connection: close`.
+     */
+    private send;
     get(path: string): Promise<ApiResponse>;
     post(path: string, body?: unknown): Promise<ApiResponse>;
     put(path: string, body?: unknown): Promise<ApiResponse>;

package/dist/src/cli/connect/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/api-client.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuB;gBAExB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;WAK9B,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAQhD,OAAO,CAAC,OAAO;IAMT,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAUxD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAUvD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAUzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMhD,UAAU,IAAI,MAAM;IACpB,aAAa,IAAI,MAAM,GAAG,IAAI;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAC1B"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/api-client.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9I;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAA0B;gBAE/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;WAK9B,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAQhD,6FAA6F;IAC7F,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IACvC,YAAY,IAAI,OAAO;IAEvB,OAAO,CAAC,OAAO;IAMf;;;;OAIG;YACW,IAAI;IAcZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IACxD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IACvD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IACzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAEhD,UAAU,IAAI,MAAM;IACpB,aAAa,IAAI,MAAM,GAAG,IAAI;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAC1B"}

package/dist/src/cli/connect/api-client.js

@@ -1,15 +1,22 @@
 /**
  * @file api-client.ts
  * @description HTTP client for AIMEAT node API with automatic auth header injection.
- * @structure Wraps fetch, response-envelope handling, and stored-token based client construction.
+ * @structure Wraps fetch, response-envelope handling, and stored-token based client
+ *   construction. `Transport` is the pluggable seam: the default transport does a
+ *   direct `fetch` with `Connection: close` (one-shot CLI behavior); the serve
+ *   daemon swaps in a tunnel transport (`ConnectTunnelClient.forward`) so every
+ *   MCP tool call flows over the single persistent WS without per-tool changes.
  * @usage Imported by `aimeat connect` subcommands and MCP tools.
- * @version-history v1.9.4 — 2026-05-28 — Update connector guidance and close one-shot CLI HTTP connections.
+ * @version-history
+ *   v1.9.4 — 2026-05-28 — Update connector guidance and close one-shot CLI HTTP connections.
+ *   v2.0.0 — 2026-06-10 — Phase 4: Transport seam (direct fetch default, tunnel override).
  */
 import { getToken } from './keychain.js';
 import { loadConfig } from './config.js';
 export class AimeatClient {
     baseUrl;
     token = null;
+    transport = null;
     constructor(baseUrl, token) {
         this.baseUrl = baseUrl.replace(/\/$/, '');
         this.token = token ?? null;
@@ -23,49 +30,38 @@ export class AimeatClient {
             throw new Error('No stored token. Run: npx aimeat connect');
         return new AimeatClient(config.node_url, token);
     }
+    /** Route subsequent requests through `t` (e.g. the tunnel). `null` restores direct fetch. */
+    setTransport(t) { this.transport = t; }
+    hasTransport() { return this.transport !== null; }
     headers() {
         const h = { 'Content-Type': 'application/json', Connection: 'close' };
         if (this.token)
             h['Authorization'] = `Bearer ${this.token}`;
         return h;
     }
-    async get(path) {
-        const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
-        const res = await fetch(url, { headers: this.headers() });
-        return res.json();
-    }
-    async post(path, body) {
-        const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
-        const res = await fetch(url, {
-            method: 'POST',
-            headers: this.headers(),
-            body: body ? JSON.stringify(body) : undefined,
-        });
-        return res.json();
-    }
-    async put(path, body) {
+    /**
+     * Single dispatch point for every verb. Node-relative paths go through the
+     * transport when one is set; absolute URLs (presigned uploads etc.) and the
+     * default case use direct fetch with `Connection: close`.
+     */
+    async send(method, path, body) {
+        if (this.transport && !path.startsWith('http')) {
+            const r = await this.transport.request(method, path, { body });
+            return r.body;
+        }
         const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
         const res = await fetch(url, {
-            method: 'PUT',
+            method,
             headers: this.headers(),
-            body: body ? JSON.stringify(body) : undefined,
+            body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,
         });
         return res.json();
     }
-    async patch(path, body) {
-        const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
-        const res = await fetch(url, {
-            method: 'PATCH',
-            headers: this.headers(),
-            body: body ? JSON.stringify(body) : undefined,
-        });
-        return res.json();
-    }
-    async delete(path) {
-        const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
-        const res = await fetch(url, { method: 'DELETE', headers: this.headers() });
-        return res.json();
-    }
+    async get(path) { return this.send('GET', path); }
+    async post(path, body) { return this.send('POST', path, body); }
+    async put(path, body) { return this.send('PUT', path, body); }
+    async patch(path, body) { return this.send('PATCH', path, body); }
+    async delete(path) { return this.send('DELETE', path); }
     getBaseUrl() { return this.baseUrl; }
     getTokenValue() { return this.token; }
     setToken(t) { this.token = t; }

package/dist/src/cli/connect/api-client.js.map

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

package/dist/src/cli/connect/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/config.ts"],"names":[],"mappings":"AAmCA,wBAAgB,YAAY,IAAI,MAAM,CAAuB;AAI7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAKd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;CAChF;AAED,wBAAgB,UAAU,IAAI,mBAAmB,GAAG,IAAI,CAIvD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAG5D;AAID,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,CAAC;IACpF,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,yGAAyG;IACzG,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAQ7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAIpF;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAyB5D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAQhG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/config.ts"],"names":[],"mappings":"AAsCA,wBAAgB,YAAY,IAAI,MAAM,CAAuB;AAI7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAKd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;CAChF;AAED,wBAAgB,UAAU,IAAI,mBAAmB,GAAG,IAAI,CAIvD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAG5D;AAID,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,CAAC;IACpF,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,yGAAyG;IACzG,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAQ7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAIpF;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAyB5D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAQhG"}

package/dist/src/cli/connect/config.js

@@ -23,13 +23,16 @@
  *   v1.0.0 -- original single-agent config
  *   v1.1.0 -- 2026-05-28 -- Security warning on wake.command (executes via exec)
  *   v2.0.0 -- 2026-05-29 -- Per-agent config layout + runner block + loadAllAgents
+ *   v2.1.0 -- 2026-06-10 -- AIMEAT_HOME env override for the connector home dir
  */
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { parse, stringify } from 'yaml';
 import { listAllTokens } from './keychain.js';
-const CONFIG_DIR = join(homedir(), '.aimeat');
+// AIMEAT_HOME overrides the connector home (~/.aimeat) — used by tests to run
+// against a throwaway directory and by operators running isolated daemons.
+const CONFIG_DIR = process.env.AIMEAT_HOME ?? join(homedir(), '.aimeat');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.yaml');
 export function getConfigDir() { return CONFIG_DIR; }
 export function loadConfig() {

package/dist/src/cli/connect/config.js.map

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

package/dist/src/cli/connect/mcp/local-server.d.ts

@@ -0,0 +1,25 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentRegistry } from '../agent-registry.js';
+export declare const SERVE_DISCOVERY_SCHEMA_VERSION = 1;
+export interface ServeDiscoveryAgent {
+    agent: string;
+    owner: string;
+    node_url: string;
+    /** How this agent's API calls reach the node right now. */
+    transport: 'tunnel' | 'direct' | 'auth_failed';
+}
+export interface ServeDiscovery {
+    schema_version: number;
+    port: number;
+    pid: number;
+    agents: ServeDiscoveryAgent[];
+    started_at: string;
+}
+export declare function serveDiscoveryPath(): string;
+export interface ServeDaemonOptions {
+    registry: AgentRegistry;
+    /** Fresh, fully tool-registered MCP server (one per Streamable-HTTP session). */
+    buildMcp: () => McpServer;
+}
+export declare function runServeDaemon(opts: ServeDaemonOptions): Promise<void>;
+//# sourceMappingURL=local-server.d.ts.map

package/dist/src/cli/connect/mcp/local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/mcp/local-server.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AAK3E,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAqFD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAC;IACxB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,SAAS,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoQ5E"}

package/dist/src/cli/connect/mcp/local-server.js

@@ -0,0 +1,411 @@
+/**
+ * @file local-server.ts
+ * @description Loopback serve daemon for `aimeat connect serve --http` (Phase 4
+ *   of the Connector Forward Tunnel). Holds ONE persistent tunnel WS per agent
+ *   to its AIMEAT node and exposes everything a local crew needs on
+ *   `127.0.0.1:<ephemeral>`:
+ *     - `/v1/mcp` — local Streamable-HTTP MCP endpoint (fresh McpServer per
+ *       session, same tool surface as stdio serve; no auth — the loopback bind
+ *       is the trust boundary).
+ *     - `ALL /v1/*` — REST proxy: method/path/query/body forwarded over the
+ *       agent's tunnel (`X-Aimeat-Agent` header picks the agent; defaults to
+ *       the registry's primary). Falls back to direct HTTP when degraded.
+ *     - `GET /local/tasks/next?wait=ms[&agent=name]` — long-poll fed by the
+ *       tunnel's `deliver`/`backlog` frames: realtime task delivery for
+ *       synchronous clients, no upstream polling.
+ *     - `GET /local/status`, `POST /local/shutdown` — introspection + clean stop.
+ *   Writes the discovery file `<AIMEAT_HOME>/serve.json` (schema_version, port,
+ *   pid, agents, started_at) atomically on start, removes it on clean exit, and
+ *   stale-detects a previous daemon by pid.
+ *
+ *   Graceful degradation: if an agent's node has the tunnel disabled / too old
+ *   (`unsupported`/`unreachable`), that agent keeps the direct-fetch transport
+ *   and the legacy upstream poll loop. `auth_failed` surfaces the
+ *   "Run: aimeat connect" guidance and starts nothing (a dead token must not
+ *   hot-loop). With the tunnel online there is NO upstream poll: `deliver`/
+ *   `backlog` drive the same wake adapter + task-runner hook the poller used.
+ * @structure
+ *   - AgentChannel — per-agent push state: task queue + long-poll waiters,
+ *     seen-id dedup (live deliver vs backlog), wake/task-runner dispatch.
+ *   - runServeDaemon() — tunnel startup per agent, Express loopback server,
+ *     discovery-file lifecycle, signal handling.
+ * @usage Called by mcp/server.ts `runServe()` when `--http`/`--daemon` is set.
+ * @version-history
+ *   v1.0.0 — 2026-06-10 — Phase 4: initial loopback daemon (local MCP + REST
+ *     proxy + long-poll push surface + discovery file + degraded fallback).
+ */
+import express from 'express';
+import { randomBytes } from 'node:crypto';
+import { writeFileSync, renameSync, existsSync, readFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { ConnectTunnelClient } from '../tunnel-client.js';
+import { getToken } from '../keychain.js';
+import { getConfigDir } from '../config.js';
+import { wakeAgent } from './wakeup.js';
+import { startPollerForAgent, legacyWakeAdapter } from './poller.js';
+import { launchTaskRunner, isRunner } from '../task-runner.js';
+export const SERVE_DISCOVERY_SCHEMA_VERSION = 1;
+export function serveDiscoveryPath() {
+    return join(getConfigDir(), 'serve.json');
+}
+/**
+ * Per-agent push state. Fed by the tunnel's `deliver` (live) and `backlog`
+ * (on-connect snapshot) frames; tasks are deduped by id across both sources so
+ * a live-pushed-then-backlogged task fires the wake/runner/long-poll exactly
+ * once per daemon lifetime. (Storage stays the source of truth — a consumer
+ * that missed a long-poll window can always list tasks via the REST proxy.)
+ */
+class AgentChannel {
+    entry;
+    transportMode = 'direct';
+    tunnel = null;
+    seenTaskIds = new Set();
+    seenMessageIds = new Set();
+    queue = [];
+    waiters = [];
+    constructor(entry) {
+        this.entry = entry;
+    }
+    handleTask(payload, via) {
+        const task = payload;
+        const id = typeof task?.id === 'string' ? task.id : null;
+        if (!task || !id || this.seenTaskIds.has(id))
+            return;
+        this.seenTaskIds.add(id);
+        // Same side effects the poll loop used to produce on a new queued task.
+        void wakeAgent(legacyWakeAdapter(this.entry), 'task_new', `task ${id} via ${via}`);
+        if (isRunner(this.entry)) {
+            launchTaskRunner(this.entry, {
+                id,
+                title: typeof task.title === 'string' ? task.title : undefined,
+                description: typeof task.description === 'string' ? task.description : undefined,
+            }).catch(err => {
+                console.error(`[serve:${this.entry.agent}] runner launch failed for ${id}: ${err.message}`);
+            });
+        }
+        const item = { task, via, receivedAt: new Date().toISOString() };
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter(item);
+        else
+            this.queue.push(item);
+    }
+    handleMessages(messages) {
+        let fresh = 0;
+        for (const m of messages) {
+            const id = typeof m?.id === 'string' ? m.id : null;
+            if (!id || this.seenMessageIds.has(id))
+                continue;
+            this.seenMessageIds.add(id);
+            fresh++;
+        }
+        if (fresh > 0) {
+            void wakeAgent(legacyWakeAdapter(this.entry), 'message_new', `${fresh} new message(s)`);
+        }
+    }
+    /** Long-poll: next undelivered task, or null after `waitMs` with none. */
+    nextTask(waitMs) {
+        const queued = this.queue.shift();
+        if (queued)
+            return Promise.resolve(queued);
+        if (waitMs <= 0)
+            return Promise.resolve(null);
+        return new Promise((resolve) => {
+            const waiter = (item) => { clearTimeout(timer); resolve(item); };
+            const timer = setTimeout(() => {
+                const i = this.waiters.indexOf(waiter);
+                if (i >= 0)
+                    this.waiters.splice(i, 1);
+                resolve(null);
+            }, waitMs);
+            this.waiters.push(waiter);
+        });
+    }
+    drainWaiters() {
+        for (const w of this.waiters.splice(0))
+            w(null);
+    }
+}
+/** Is the pid recorded in an existing discovery file still alive? */
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+export async function runServeDaemon(opts) {
+    const { registry, buildMcp } = opts;
+    const discoveryFile = serveDiscoveryPath();
+    // Stale-detect: a live daemon owns the discovery file; a dead pid is overwritten.
+    if (existsSync(discoveryFile)) {
+        try {
+            const prev = JSON.parse(readFileSync(discoveryFile, 'utf-8'));
+            if (prev.pid && prev.pid !== process.pid && pidAlive(prev.pid)) {
+                console.error(`Another serve daemon appears to be running (pid ${prev.pid}, port ${prev.port}).`);
+                console.error(`Stop it first, or delete ${discoveryFile} if it is stale.`);
+                process.exit(1);
+            }
+        }
+        catch { /* unreadable file — treat as stale and overwrite */ }
+    }
+    const startedAt = new Date().toISOString();
+    const channels = new Map();
+    // ── One tunnel client per agent, with graceful degradation ──
+    for (const entry of registry.list()) {
+        const ch = new AgentChannel(entry);
+        channels.set(entry.agent, ch);
+        const tunnel = new ConnectTunnelClient({
+            nodeUrl: entry.config.node_url,
+            getToken: () => getToken(entry.agent, entry.owner),
+            label: `tunnel:${entry.agent}`,
+            onDeliver: (kind, payload) => {
+                if (kind === 'task_assigned')
+                    ch.handleTask(payload, 'deliver');
+            },
+            onBacklog: ({ tasks, messages }) => {
+                for (const t of tasks)
+                    ch.handleTask(t, 'backlog');
+                ch.handleMessages(messages);
+            },
+            onAuthFailure: () => {
+                // Token died mid-session: fall back to direct fetch so already-running
+                // tool calls fail with the node's own 401 (clear guidance) instead of
+                // "Tunnel not connected".
+                ch.transportMode = 'auth_failed';
+                entry.client.setTransport(null);
+            },
+        });
+        const outcome = await tunnel.start();
+        if (outcome === 'online') {
+            ch.tunnel = tunnel;
+            ch.transportMode = 'tunnel';
+            entry.client.setTransport({ request: (m, p, o) => tunnel.forward(m, p, o ?? {}) });
+            console.error(`[serve] ${entry.agent}@${entry.owner}: tunnel online — API + realtime delivery over one WS (no upstream polling)`);
+        }
+        else if (outcome === 'auth_failed') {
+            ch.transportMode = 'auth_failed';
+            // Guidance already printed by the tunnel client; do NOT start a poller —
+            // it would hot-fail against the same dead credential.
+        }
+        else {
+            ch.transportMode = 'direct';
+            console.error(`[serve] ${entry.agent}@${entry.owner}: tunnel ${outcome} — degraded to direct HTTP + poll loop`);
+            startPollerForAgent(entry);
+        }
+    }
+    // ── Loopback HTTP server ──
+    const app = express();
+    app.use(express.json({ limit: '25mb' }));
+    const resolveAgent = (req) => {
+        const header = req.headers['x-aimeat-agent'];
+        const q = req.query.agent;
+        const name = (typeof header === 'string' && header)
+            || (typeof q === 'string' && q)
+            || undefined;
+        return registry.resolve(name || undefined);
+    };
+    // ── Local MCP (Streamable HTTP) — mirrors the node's session plumbing, no auth ──
+    const transports = new Map();
+    app.post('/v1/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (sessionId && transports.has(sessionId)) {
+            await transports.get(sessionId).handleRequest(req, res, req.body);
+            return;
+        }
+        if (sessionId) {
+            const body = req.body;
+            const method = Array.isArray(body) ? body[0]?.method : body?.method;
+            if (method !== 'initialize') {
+                res.status(404).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32600, message: 'Session not found. Please re-initialize.' },
+                    id: (Array.isArray(body) ? body[0]?.id : body?.id) ?? null,
+                });
+                return;
+            }
+        }
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => `local-${randomBytes(16).toString('hex')}`,
+        });
+        const mcp = buildMcp();
+        transport.onclose = () => {
+            if (transport.sessionId)
+                transports.delete(transport.sessionId);
+        };
+        await mcp.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        if (transport.sessionId)
+            transports.set(transport.sessionId, transport);
+    });
+    app.get('/v1/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(400).json({ error: 'Missing or invalid mcp-session-id header' });
+            return;
+        }
+        await transports.get(sessionId).handleRequest(req, res);
+    });
+    app.delete('/v1/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(404).json({ error: 'Session not found' });
+            return;
+        }
+        await transports.get(sessionId).close();
+        transports.delete(sessionId);
+        res.status(200).json({ closed: true });
+    });
+    // ── Push surface: long-poll fed by deliver/backlog (realtime, no spin) ──
+    app.get('/local/tasks/next', async (req, res) => {
+        let entry;
+        try {
+            entry = resolveAgent(req);
+        }
+        catch (err) {
+            res.status(400).json({ ok: false, error: { code: 'UNKNOWN_AGENT', message: err.message } });
+            return;
+        }
+        const rawWait = typeof req.query.wait === 'string' ? parseInt(req.query.wait, 10) : NaN;
+        const waitMs = Math.min(Math.max(Number.isFinite(rawWait) ? rawWait : 25_000, 0), 120_000);
+        const item = await channels.get(entry.agent).nextTask(waitMs);
+        if (!item) {
+            res.status(204).end();
+            return;
+        }
+        res.json({
+            ok: true,
+            data: { agent: entry.agent, owner: entry.owner, via: item.via, received_at: item.receivedAt, task: item.task },
+        });
+    });
+    app.get('/local/status', (_req, res) => {
+        res.json({
+            ok: true,
+            data: {
+                pid: process.pid,
+                started_at: startedAt,
+                agents: registry.list().map(e => ({
+                    agent: e.agent,
+                    owner: e.owner,
+                    node_url: e.config.node_url,
+                    transport: channels.get(e.agent).transportMode,
+                    tunnel_status: channels.get(e.agent).tunnel?.getStatus() ?? null,
+                })),
+            },
+        });
+    });
+    app.post('/local/shutdown', (_req, res) => {
+        res.json({ ok: true, data: { stopping: true } });
+        setTimeout(() => { void shutdown(0); }, 50);
+    });
+    // ── REST proxy: everything else under /v1 funnels into the tunnel ──
+    app.all('/v1/*splat', async (req, res) => {
+        let entry;
+        try {
+            entry = resolveAgent(req);
+        }
+        catch (err) {
+            res.status(400).json({ ok: false, error: { code: 'UNKNOWN_AGENT', message: err.message } });
+            return;
+        }
+        const ch = channels.get(entry.agent);
+        const query = {};
+        for (const [k, v] of Object.entries(req.query)) {
+            if (k === 'agent')
+                continue; // local routing parameter, not for the node
+            query[k] = Array.isArray(v) ? String(v[0]) : String(v);
+        }
+        const hasBody = req.method !== 'GET' && req.method !== 'HEAD'
+            && req.body !== undefined && req.body !== null
+            && (typeof req.body !== 'object' || Object.keys(req.body).length > 0);
+        const body = hasBody ? req.body : undefined;
+        try {
+            if (ch.tunnel?.isOnline()) {
+                const r = await ch.tunnel.forward(req.method, req.path, { query, body });
+                res.status(r.status).json(r.body);
+                return;
+            }
+            // Degraded (or tunnel mid-reconnect): direct HTTP with the stored token.
+            const url = new URL(entry.config.node_url.replace(/\/+$/, '') + req.path);
+            for (const [k, v] of Object.entries(query))
+                url.searchParams.set(k, v);
+            const token = await getToken(entry.agent, entry.owner);
+            const headers = { 'Content-Type': 'application/json', Connection: 'close' };
+            if (token)
+                headers['Authorization'] = `Bearer ${token}`;
+            const r = await fetch(url, { method: req.method, headers, body: body !== undefined ? JSON.stringify(body) : undefined });
+            const text = await r.text();
+            let parsed;
+            try {
+                parsed = text ? JSON.parse(text) : null;
+            }
+            catch {
+                parsed = text;
+            }
+            res.status(r.status).json(parsed);
+        }
+        catch (err) {
+            res.status(502).json({ ok: false, error: { code: 'PROXY_ERROR', message: err.message } });
+        }
+    });
+    // ── Start, write discovery, wire shutdown ──
+    const server = await new Promise((resolve) => {
+        const s = app.listen(0, '127.0.0.1', () => resolve(s));
+    });
+    const port = server.address().port;
+    const writeDiscovery = () => {
+        const doc = {
+            schema_version: SERVE_DISCOVERY_SCHEMA_VERSION,
+            port,
+            pid: process.pid,
+            started_at: startedAt,
+            agents: registry.list().map(e => ({
+                agent: e.agent,
+                owner: e.owner,
+                node_url: e.config.node_url,
+                transport: channels.get(e.agent).transportMode,
+            })),
+        };
+        mkdirSync(getConfigDir(), { recursive: true });
+        const tmp = `${discoveryFile}.tmp-${process.pid}`;
+        writeFileSync(tmp, JSON.stringify(doc, null, 2), 'utf-8');
+        renameSync(tmp, discoveryFile); // atomic replace on the same volume
+    };
+    writeDiscovery();
+    let shuttingDown = false;
+    async function shutdown(code) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        try {
+            if (existsSync(discoveryFile))
+                unlinkSync(discoveryFile);
+        }
+        catch { /* best effort */ }
+        for (const ch of channels.values()) {
+            ch.drainWaiters();
+            try {
+                await ch.tunnel?.close();
+            }
+            catch { /* ignore */ }
+        }
+        await new Promise((resolve) => {
+            const t = setTimeout(() => resolve(), 1_000);
+            server.close(() => { clearTimeout(t); resolve(); });
+        });
+        process.exit(code);
+    }
+    process.on('SIGINT', () => { void shutdown(0); });
+    process.on('SIGTERM', () => { void shutdown(0); });
+    const tunnelCount = [...channels.values()].filter(c => c.transportMode === 'tunnel').length;
+    const summary = registry.list()
+        .map(e => `${e.agent}@${e.owner} [${channels.get(e.agent).transportMode}]`)
+        .join(', ');
+    console.error(`AIMEAT serve daemon listening on http://127.0.0.1:${port} (MCP: /v1/mcp, proxy: /v1/*, push: /local/tasks/next)`);
+    console.error(`[serve] discovery: ${discoveryFile}`);
+    console.error(`[serve] ${registry.size()} agent(s): ${summary} — ${tunnelCount} over tunnel`);
+}
+//# sourceMappingURL=local-server.js.map