@tyvm/knowhow 0.0.161 → 0.0.163

package/ts_build/src/services/stateful/channels/inputStream.js

@@ -0,0 +1,354 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileInputChannel = void 0;
+exports.appendInput = appendInput;
+exports.readInputBatch = readInputBatch;
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function appendInput(filePath, item) {
+    const record = {
+        id: item.id ?? (0, crypto_1.randomUUID)(),
+        kind: item.kind ?? "message",
+        from: item.from,
+        at: item.at ?? new Date().toISOString(),
+        text: item.text,
+        payload: item.payload,
+    };
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const buf = Buffer.from(JSON.stringify(record) + "\n", "utf8");
+    const fd = fs.openSync(filePath, "a");
+    try {
+        let written = 0;
+        while (written < buf.length) {
+            written += fs.writeSync(fd, buf, written, buf.length - written);
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return record;
+}
+function parseLines(lines, inode) {
+    const items = [];
+    let raw;
+    const flushRaw = () => {
+        if (!raw)
+            return;
+        items.push({
+            id: `${inode}:${raw.offset}`,
+            kind: "message",
+            payload: { text: raw.texts.join("\n") },
+            at: new Date().toISOString(),
+        });
+        raw = undefined;
+    };
+    for (const line of lines) {
+        const trimmed = line.text.trim();
+        if (!trimmed)
+            continue;
+        let rec;
+        if (trimmed.startsWith("{")) {
+            try {
+                rec = JSON.parse(trimmed);
+            }
+            catch {
+                rec = undefined;
+            }
+        }
+        if (rec && typeof rec === "object" && !Array.isArray(rec) && (rec.kind || rec.text !== undefined || rec.payload !== undefined)) {
+            flushRaw();
+            const { id, kind, from, at, payload, ...rest } = rec;
+            items.push({
+                id: id ?? `${inode}:${line.offset}`,
+                kind: kind ?? "message",
+                payload: payload !== undefined ? payload : rest,
+                from,
+                at: at ?? new Date().toISOString(),
+            });
+        }
+        else if (trimmed.startsWith("/")) {
+            flushRaw();
+            items.push({
+                id: `${inode}:${line.offset}`,
+                kind: "message",
+                payload: { text: trimmed },
+                at: new Date().toISOString(),
+            });
+        }
+        else {
+            if (!raw)
+                raw = { texts: [], offset: line.offset };
+            raw.texts.push(line.text.replace(/\r$/, ""));
+        }
+    }
+    flushRaw();
+    return items;
+}
+async function readInputBatch(filePath, cursor, opts = {}) {
+    let handle;
+    try {
+        handle = await fs.promises.open(filePath, "r");
+    }
+    catch (e) {
+        if (e?.code === "ENOENT") {
+            return {
+                items: [],
+                cursor: cursor ?? { inode: 0, offset: 0 },
+                size: 0,
+                partialPending: false,
+                exists: false,
+            };
+        }
+        throw e;
+    }
+    try {
+        const st = await handle.stat();
+        let offset = cursor && cursor.inode === st.ino ? cursor.offset : 0;
+        if (offset > st.size)
+            offset = 0;
+        const length = st.size - offset;
+        const buf = Buffer.alloc(length);
+        let read = 0;
+        while (read < length) {
+            const { bytesRead } = await handle.read(buf, read, length - read, offset + read);
+            if (bytesRead === 0)
+                break;
+            read += bytesRead;
+        }
+        const data = buf.subarray(0, read);
+        const lastNl = data.lastIndexOf(0x0a);
+        const completeLen = opts.includePartial ? data.length : lastNl + 1;
+        const complete = data.subarray(0, completeLen);
+        const text = complete.toString("utf8");
+        const lines = [];
+        let pos = offset;
+        for (const piece of text.split("\n")) {
+            lines.push({ text: piece, offset: pos });
+            pos += Buffer.byteLength(piece, "utf8") + 1;
+        }
+        return {
+            items: parseLines(lines, st.ino),
+            cursor: { inode: st.ino, offset: offset + completeLen },
+            size: st.size,
+            partialPending: !opts.includePartial && completeLen < data.length,
+            exists: true,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+const sameJson = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+class FileInputChannel {
+    opts;
+    id;
+    direction = "in";
+    ctx;
+    cursor;
+    timer;
+    watcher;
+    tail = Promise.resolve();
+    scheduled;
+    stopped = false;
+    partialSeen;
+    constructor(opts) {
+        this.opts = opts;
+        this.id = opts.id ?? "fs";
+    }
+    get consumingPath() {
+        return this.opts.path + ".consuming";
+    }
+    lock(fn) {
+        const p = this.tail.then(fn, fn);
+        this.tail = p.catch(() => { });
+        return p;
+    }
+    async start(ctx) {
+        this.ctx = ctx;
+        this.stopped = false;
+        this.cursor = ctx.cursor();
+        await this.poke();
+        const dir = path.dirname(this.opts.path);
+        if (this.opts.watch !== false) {
+            try {
+                fs.mkdirSync(dir, { recursive: true });
+                const base = path.basename(this.opts.path);
+                this.watcher = fs.watch(dir, (_ev, name) => {
+                    if (!name || name === base)
+                        void this.poke();
+                });
+                this.watcher.on("error", () => { });
+                this.watcher.unref?.();
+            }
+            catch {
+            }
+        }
+        this.timer = setInterval(() => void this.poke(), this.opts.pollMs ?? 250);
+        this.timer.unref?.();
+    }
+    poke() {
+        if (this.stopped)
+            return Promise.resolve();
+        if (this.scheduled)
+            return this.scheduled;
+        const p = this.lock(async () => {
+            this.scheduled = undefined;
+            try {
+                await this.cycle();
+            }
+            catch (e) {
+                this.ctx?.log.error(`input channel ${this.id} cycle failed: ${e?.message ?? e}`);
+            }
+        });
+        this.scheduled = p;
+        return p;
+    }
+    async flush() {
+        await this.poke();
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.watcher?.close();
+        this.timer = undefined;
+        this.watcher = undefined;
+        await this.tail;
+    }
+    async deliver(items, cursor) {
+        const ctx = this.ctx;
+        const version = await ctx.deliver(items, cursor);
+        const recorded = ctx.cursor();
+        if (sameJson(recorded, cursor)) {
+            this.cursor = cursor;
+            return version;
+        }
+        this.cursor = recorded;
+        return undefined;
+    }
+    async cycle() {
+        if (fs.existsSync(this.consumingPath))
+            await this.finishTrim();
+        if (this.stopped)
+            return;
+        let batch = await readInputBatch(this.opts.path, this.cursor);
+        if (batch.partialPending) {
+            const now = Date.now();
+            if (this.partialSeen && this.partialSeen.size === batch.size) {
+                if (now - this.partialSeen.since >= (this.opts.partialSettleMs ?? 1000)) {
+                    batch = await readInputBatch(this.opts.path, this.cursor, { includePartial: true });
+                    this.partialSeen = undefined;
+                }
+            }
+            else {
+                this.partialSeen = { size: batch.size, since: now };
+            }
+        }
+        else {
+            this.partialSeen = undefined;
+        }
+        if (!batch.items.length) {
+            if (batch.exists)
+                this.cursor = batch.cursor;
+            return;
+        }
+        const version = await this.deliver(batch.items, batch.cursor);
+        if (version !== undefined && this.opts.trim !== false)
+            this.scheduleTrim(version);
+    }
+    scheduleTrim(version) {
+        const ctx = this.ctx;
+        ctx
+            .persisted(version)
+            .then(() => this.lock(() => this.doTrim()))
+            .catch(() => { });
+    }
+    async doTrim() {
+        if (this.stopped || !this.ctx)
+            return;
+        const c = this.ctx.cursor();
+        if (!c || !c.offset || !this.cursor || !sameJson(c, this.cursor))
+            return;
+        let st;
+        try {
+            st = fs.statSync(this.opts.path);
+        }
+        catch {
+            return;
+        }
+        if (st.ino !== c.inode || st.size !== c.offset)
+            return;
+        if (fs.existsSync(this.consumingPath))
+            return;
+        fs.renameSync(this.opts.path, this.consumingPath);
+        await this.finishTrim();
+    }
+    async finishTrim() {
+        const ctx = this.ctx;
+        let st;
+        try {
+            st = fs.statSync(this.consumingPath);
+        }
+        catch {
+            return;
+        }
+        if (!this.cursor || this.cursor.inode !== st.ino) {
+            fs.rmSync(this.consumingPath, { force: true });
+            return;
+        }
+        for (let i = 0; i < 3; i++) {
+            const batch = await readInputBatch(this.consumingPath, this.cursor, { includePartial: true });
+            if (batch.cursor.offset === this.cursor.offset)
+                break;
+            if (batch.items.length) {
+                const v = await this.deliver(batch.items, batch.cursor);
+                if (v === undefined)
+                    return;
+                await ctx.persisted(v);
+            }
+            else {
+                this.cursor = batch.cursor;
+            }
+        }
+        fs.rmSync(this.consumingPath, { force: true });
+        const reset = { inode: 0, offset: 0 };
+        this.cursor = reset;
+        await ctx.deliver([], reset);
+    }
+}
+exports.FileInputChannel = FileInputChannel;
+//# sourceMappingURL=inputStream.js.map

package/ts_build/src/services/stateful/channels/inputStream.js.map

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

package/ts_build/src/services/stateful/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./types";
+export * from "./StatefulProcess";
+export * from "./ProcessMirror";
+export * from "./ResumableProcess";
+export * from "./changesIterable";
+export * from "./channels/Channel";
+export * from "./channels/base";
+export * from "./channels/delta";
+export * from "./channels/inputStream";
+export * from "./channels/MemoryChannel";
+export * from "./channels/JsonFileChannel";
+export * from "./agent";

package/ts_build/src/services/stateful/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./StatefulProcess"), exports);
+__exportStar(require("./ProcessMirror"), exports);
+__exportStar(require("./ResumableProcess"), exports);
+__exportStar(require("./changesIterable"), exports);
+__exportStar(require("./channels/Channel"), exports);
+__exportStar(require("./channels/base"), exports);
+__exportStar(require("./channels/delta"), exports);
+__exportStar(require("./channels/inputStream"), exports);
+__exportStar(require("./channels/MemoryChannel"), exports);
+__exportStar(require("./channels/JsonFileChannel"), exports);
+__exportStar(require("./agent"), exports);
+//# sourceMappingURL=index.js.map

package/ts_build/src/services/stateful/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/stateful/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,oDAAkC;AAClC,kDAAgC;AAChC,qDAAmC;AACnC,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,0CAAwB"}

package/ts_build/src/services/stateful/types.d.ts

@@ -0,0 +1,93 @@
+export type Unsubscribe = () => void;
+export type ProcessStatus = "created" | "running" | "paused" | "waiting" | "completed" | "failed" | "cancelled";
+export declare const TERMINAL_STATUSES: readonly ProcessStatus[];
+export declare function isTerminalStatus(s: ProcessStatus): boolean;
+export interface Lifecycle {
+    status: ProcessStatus;
+    startedAt?: string;
+    updatedAt: string;
+    endedAt?: string;
+    result?: unknown;
+    error?: {
+        message: string;
+        stack?: string;
+        code?: string;
+    };
+    resumable: "none" | "restart" | "checkpoint" | "replay";
+    executor?: {
+        host: string;
+        pid: number;
+        heartbeatAt: string;
+    };
+}
+export interface BaseControl {
+    desired?: "running" | "paused" | "cancelled";
+    interrupt?: {
+        id: string;
+        message?: string;
+    };
+}
+export interface ProcessMeta {
+    id: string;
+    kind: string;
+    name?: string;
+    parentId?: string;
+    createdAt: string;
+    schemaVersion: number;
+    links?: Record<string, string>;
+}
+export interface InputItem {
+    id: string;
+    kind: string;
+    payload: unknown;
+    at: string;
+    from?: string;
+    source: string;
+}
+export type InputCursors = Record<string, unknown>;
+export interface ProcessDocument<S = any, C extends BaseControl = BaseControl> {
+    meta: ProcessMeta;
+    state: S;
+    control: C;
+    lifecycle: Lifecycle;
+    version: number;
+    controlVersion: number;
+    observedControlVersion: number;
+}
+export interface StateChange<S, E = never> {
+    version: number;
+    prev: S;
+    next: S;
+    events: E[];
+    reason?: string;
+}
+export interface ControlChange<C> {
+    controlVersion: number;
+    prev: C;
+    next: C;
+    source: string;
+}
+export interface InputCursor {
+    source: string;
+    value: unknown;
+}
+export interface ProcessHandle<S = any, C extends BaseControl = BaseControl, E = any> {
+    readonly meta: ProcessMeta;
+    getState(): Readonly<S>;
+    getControl(): Readonly<C>;
+    getLifecycle(): Readonly<Lifecycle>;
+    onStateUpdated(cb: (c: StateChange<S, E>) => void): Unsubscribe;
+    changes(signal?: AbortSignal): AsyncIterable<StateChange<S, E>>;
+    applyControl(patch: Partial<C> | ((c: C) => C), source?: string): void | Promise<void>;
+    send(kind: string, payload: unknown, opts?: {
+        id?: string;
+        from?: string;
+    }): unknown;
+    pause(): void | Promise<void>;
+    resume(): void | Promise<void>;
+    cancel(): void | Promise<void>;
+    interrupt(message?: string): void | Promise<void>;
+}
+export declare class ProcessCancelledError extends Error {
+    constructor(message?: string);
+}

package/ts_build/src/services/stateful/types.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessCancelledError = exports.TERMINAL_STATUSES = void 0;
+exports.isTerminalStatus = isTerminalStatus;
+exports.TERMINAL_STATUSES = [
+    "completed",
+    "failed",
+    "cancelled",
+];
+function isTerminalStatus(s) {
+    return exports.TERMINAL_STATUSES.includes(s);
+}
+class ProcessCancelledError extends Error {
+    constructor(message = "process cancelled") {
+        super(message);
+        this.name = "ProcessCancelledError";
+    }
+}
+exports.ProcessCancelledError = ProcessCancelledError;
+//# sourceMappingURL=types.js.map

package/ts_build/src/services/stateful/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/stateful/types.ts"],"names":[],"mappings":";;;AAsBA,4CAEC;AARY,QAAA,iBAAiB,GAA6B;IACzD,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC;AAEF,SAAgB,gBAAgB,CAAC,CAAgB;IAC/C,OAAO,yBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAgGD,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC"}

package/ts_build/src/services/watchers/index.d.ts

@@ -1,2 +1 @@
-export * from "./FsSyncer";
-export * from "./RemoteSyncer";
+export { FsSyncedAgentWatcher, WebSyncedAgentWatcher, } from "../stateful/agent/agentMirror";

package/ts_build/src/services/watchers/index.js

@@ -1,19 +1,7 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./FsSyncer"), exports);
-__exportStar(require("./RemoteSyncer"), exports);
+exports.WebSyncedAgentWatcher = exports.FsSyncedAgentWatcher = void 0;
+var agentMirror_1 = require("../stateful/agent/agentMirror");
+Object.defineProperty(exports, "FsSyncedAgentWatcher", { enumerable: true, get: function () { return agentMirror_1.FsSyncedAgentWatcher; } });
+Object.defineProperty(exports, "WebSyncedAgentWatcher", { enumerable: true, get: function () { return agentMirror_1.WebSyncedAgentWatcher; } });
 //# sourceMappingURL=index.js.map

package/ts_build/src/services/watchers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/watchers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/watchers/index.ts"],"names":[],"mappings":";;;AAIA,6DAGuC;AAFrC,mHAAA,oBAAoB,OAAA;AACpB,oHAAA,qBAAqB,OAAA"}

package/ts_build/src/tunnel.d.ts

@@ -1,7 +1,11 @@
 import { WebSocket } from "ws";
 import { createTunnelHandler, TunnelHandler } from "@tyvm/knowhow-tunnel";
 import { getConfig } from "./config";
+import type { AllowedTunnelPort } from "./types";
 import { WorkerPasskeyAuthService } from "./workers/auth/WorkerPasskeyAuth";
+export declare function parseTunnelPortSpec(spec: string | number): AllowedTunnelPort;
+export declare function tunnelPortNumber(entry: AllowedTunnelPort): number;
+export declare function ensureTunnelPorts(specs: Array<string | number>): Promise<string[]>;
 export declare function extractTunnelDomain(apiUrl: string): {
     domain: string;
     useHttps: boolean;

package/ts_build/src/tunnel.js

@@ -1,17 +1,58 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TUNNEL_MINIMAL_TOOLS = void 0;
+exports.parseTunnelPortSpec = parseTunnelPortSpec;
+exports.tunnelPortNumber = tunnelPortNumber;
+exports.ensureTunnelPorts = ensureTunnelPorts;
 exports.extractTunnelDomain = extractTunnelDomain;
 exports.initTunnelHandler = initTunnelHandler;
 exports.resolveTunnelConfig = resolveTunnelConfig;
 exports.connectTunnelWebSocket = connectTunnelWebSocket;
 const ws_1 = require("ws");
 const knowhow_tunnel_1 = require("@tyvm/knowhow-tunnel");
+const config_1 = require("./config");
 const KnowhowClient_1 = require("./services/KnowhowClient");
 const modules_1 = require("./services/modules");
 const WsMiddleware_1 = require("./workers/auth/WsMiddleware");
 const authMiddleware_1 = require("./workers/auth/authMiddleware");
 const PROD_TUNNEL_WORKER_DOMAIN = "worker.tyvm-apps.com";
+function parseTunnelPortSpec(spec) {
+    const [rawPort, rawTransport] = String(spec).trim().split(":");
+    const port = Number(rawPort);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid tunnel port: ${spec}`);
+    }
+    if (!rawTransport)
+        return port;
+    const transport = rawTransport.toLowerCase();
+    if (transport !== "http" && transport !== "tcp") {
+        throw new Error(`Invalid tunnel transport "${rawTransport}" (use http or tcp)`);
+    }
+    return transport === "http" ? port : { port, transport };
+}
+function tunnelPortNumber(entry) {
+    return typeof entry === "number" ? entry : entry.port;
+}
+async function ensureTunnelPorts(specs) {
+    const config = await (0, config_1.getConfig)();
+    config.worker = config.worker || {};
+    config.worker.tunnel = config.worker.tunnel || {};
+    const allowed = config.worker.tunnel.allowedPorts || [];
+    const added = [];
+    for (const spec of specs) {
+        const entry = parseTunnelPortSpec(spec);
+        const port = tunnelPortNumber(entry);
+        if (allowed.some((e) => tunnelPortNumber(e) === port))
+            continue;
+        allowed.push(entry);
+        added.push(String(spec));
+    }
+    if (added.length) {
+        config.worker.tunnel.allowedPorts = allowed;
+        await (0, config_1.updateConfig)(config);
+    }
+    return added;
+}
 function extractTunnelDomain(apiUrl) {
     try {
         const url = new URL(apiUrl);
@@ -60,7 +101,7 @@ function resolveTunnelConfig(config, isInsideDocker) {
             console.log("🐳 Docker detected: tunnel will use host.docker.internal to reach host services");
         }
         else {
-            tunnelLocalHost = "127.0.0.1";
+            tunnelLocalHost = "localhost";
         }
     }
     const portMapping = (config.worker?.tunnel?.portMapping || {});