@generacy-ai/control-plane 0.2.0 → 0.4.0

package/dist/src/services/docker-engine-client.js

@@ -0,0 +1,326 @@
+import http from 'node:http';
+import { DockerEngineError, DockerDaemonUnavailableError, } from './docker-engine-types.js';
+const DEFAULT_DOCKER_HOST = 'unix:///var/run/docker-host.sock';
+const DEFAULT_REQUEST_TIMEOUT = 30_000;
+export class DockerEngineClient {
+    socketPath;
+    requestTimeout;
+    constructor(options = {}) {
+        const dockerHost = options.dockerHost ?? process.env['DOCKER_HOST'] ?? DEFAULT_DOCKER_HOST;
+        if (!dockerHost.startsWith('unix://')) {
+            throw new Error(`DOCKER_HOST must use unix:// scheme (got "${dockerHost}"); TCP not supported by this client`);
+        }
+        this.socketPath = dockerHost.slice('unix://'.length);
+        this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
+    }
+    async listContainers(opts = {}) {
+        const query = {};
+        if (opts.all)
+            query['all'] = 'true';
+        if (opts.filters) {
+            // Docker expects filters as a URL-encoded JSON object of label→value-array maps.
+            const labelFilters = [];
+            const otherFilters = {};
+            for (const [key, values] of Object.entries(opts.filters)) {
+                if (key === 'label') {
+                    labelFilters.push(...values);
+                }
+                else {
+                    otherFilters[key] = values;
+                }
+            }
+            const filterObj = { ...otherFilters };
+            if (labelFilters.length > 0)
+                filterObj['label'] = labelFilters;
+            query['filters'] = JSON.stringify(filterObj);
+        }
+        const path = `/containers/json${this.buildQueryString(query)}`;
+        const res = await this.request('GET', path);
+        this.assertOk(res, path);
+        return JSON.parse(res.body);
+    }
+    async inspectContainer(id) {
+        const path = `/containers/${encodeURIComponent(id)}/json`;
+        const res = await this.request('GET', path);
+        this.assertOk(res, path);
+        return JSON.parse(res.body);
+    }
+    async createContainer(name, config) {
+        const path = `/containers/create?name=${encodeURIComponent(name)}`;
+        const res = await this.request('POST', path, JSON.stringify(config));
+        this.assertOk(res, path, 201);
+        return JSON.parse(res.body);
+    }
+    async startContainer(id) {
+        const path = `/containers/${encodeURIComponent(id)}/start`;
+        const res = await this.request('POST', path);
+        this.assertOk(res, path, 204);
+    }
+    async stopContainer(id) {
+        const path = `/containers/${encodeURIComponent(id)}/stop`;
+        const res = await this.request('POST', path);
+        // Engine returns 204 on stop, 304 if already stopped (both fine).
+        if (res.statusCode === 204 || res.statusCode === 304)
+            return;
+        this.assertOk(res, path, 204);
+    }
+    async removeContainer(id, opts = {}) {
+        const query = opts.force ? '?force=true' : '';
+        const path = `/containers/${encodeURIComponent(id)}${query}`;
+        const res = await this.request('DELETE', path);
+        this.assertOk(res, path, 204);
+    }
+    async connectNetwork(networkId, body) {
+        const path = `/networks/${encodeURIComponent(networkId)}/connect`;
+        const res = await this.request('POST', path, JSON.stringify(body));
+        this.assertOk(res, path);
+    }
+    /**
+     * Subscribe to the Docker Engine `/events` stream.
+     *
+     * Returns an async iterable that yields one `EngineEvent` per newline-delimited
+     * JSON line from the daemon. The stream is long-lived; consumers should
+     * implement their own reconnect/backoff. The iterator returns when:
+     * - the daemon closes the stream (e.g. its own restart),
+     * - the consumer breaks out of the `for await` loop, or
+     * - `opts.signal` aborts.
+     *
+     * Throws `DockerDaemonUnavailableError` if the initial socket connection is
+     * refused or the socket file is missing.
+     */
+    streamContainerEvents(opts) {
+        const socketPath = this.socketPath;
+        const filtersParam = encodeURIComponent(JSON.stringify(opts.filters));
+        const path = `/events?filters=${filtersParam}`;
+        const signal = opts.signal;
+        return {
+            [Symbol.asyncIterator]() {
+                let res = null;
+                let buffer = '';
+                let ended = false;
+                const eventQueue = [];
+                let pendingResolve = null;
+                let pendingReject = null;
+                let initError = null;
+                let connected = false;
+                const settle = () => {
+                    if (!pendingResolve && !pendingReject)
+                        return;
+                    if (initError && !connected) {
+                        const reject = pendingReject;
+                        pendingResolve = null;
+                        pendingReject = null;
+                        reject?.(initError);
+                        return;
+                    }
+                    if (eventQueue.length > 0) {
+                        const value = eventQueue.shift();
+                        const resolve = pendingResolve;
+                        pendingResolve = null;
+                        pendingReject = null;
+                        resolve?.({ value, done: false });
+                        return;
+                    }
+                    if (ended) {
+                        const resolve = pendingResolve;
+                        pendingResolve = null;
+                        pendingReject = null;
+                        resolve?.({ value: undefined, done: true });
+                    }
+                };
+                const handleLine = (line) => {
+                    const trimmed = line.trim();
+                    if (trimmed.length === 0)
+                        return;
+                    try {
+                        const parsed = JSON.parse(trimmed);
+                        eventQueue.push(parsed);
+                    }
+                    catch (err) {
+                        console.warn(`[docker-engine-client] skipping malformed /events line: ${trimmed.slice(0, 200)} (${err instanceof Error ? err.message : String(err)})`);
+                    }
+                };
+                const req = http.request({
+                    socketPath,
+                    path,
+                    method: 'GET',
+                    headers: { Host: 'docker' },
+                }, (response) => {
+                    res = response;
+                    const statusCode = response.statusCode ?? 0;
+                    if (statusCode < 200 || statusCode >= 300) {
+                        // Consume body for the error message, then signal initError.
+                        let body = '';
+                        response.on('data', (chunk) => {
+                            body += chunk.toString();
+                        });
+                        response.on('end', () => {
+                            initError = new DockerEngineError(statusCode, path, body || '<no body>');
+                            settle();
+                        });
+                        return;
+                    }
+                    connected = true;
+                    response.setEncoding('utf8');
+                    response.on('data', (chunk) => {
+                        buffer += chunk;
+                        let idx = buffer.indexOf('\n');
+                        while (idx !== -1) {
+                            const line = buffer.slice(0, idx);
+                            buffer = buffer.slice(idx + 1);
+                            handleLine(line);
+                            idx = buffer.indexOf('\n');
+                        }
+                        settle();
+                    });
+                    response.on('end', () => {
+                        if (buffer.length > 0) {
+                            handleLine(buffer);
+                            buffer = '';
+                        }
+                        ended = true;
+                        settle();
+                    });
+                    response.on('error', (err) => {
+                        if (!ended) {
+                            initError = err;
+                            ended = true;
+                            settle();
+                        }
+                    });
+                });
+                req.on('error', (err) => {
+                    const code = err.code;
+                    if (!connected) {
+                        if (code === 'ECONNREFUSED' || code === 'ENOENT') {
+                            initError = new DockerDaemonUnavailableError(socketPath, err);
+                        }
+                        else {
+                            initError = err;
+                        }
+                    }
+                    ended = true;
+                    settle();
+                });
+                const abortHandler = () => {
+                    ended = true;
+                    try {
+                        req.destroy();
+                    }
+                    catch {
+                        // ignore
+                    }
+                    if (res) {
+                        try {
+                            res.destroy();
+                        }
+                        catch {
+                            // ignore
+                        }
+                    }
+                    settle();
+                };
+                if (signal) {
+                    if (signal.aborted) {
+                        abortHandler();
+                    }
+                    else {
+                        signal.addEventListener('abort', abortHandler, { once: true });
+                    }
+                }
+                req.end();
+                return {
+                    next() {
+                        return new Promise((resolve, reject) => {
+                            pendingResolve = resolve;
+                            pendingReject = reject;
+                            settle();
+                        });
+                    },
+                    return() {
+                        ended = true;
+                        try {
+                            req.destroy();
+                        }
+                        catch {
+                            // ignore
+                        }
+                        if (res) {
+                            try {
+                                res.destroy();
+                            }
+                            catch {
+                                // ignore
+                            }
+                        }
+                        if (signal) {
+                            signal.removeEventListener('abort', abortHandler);
+                        }
+                        return Promise.resolve({ value: undefined, done: true });
+                    },
+                };
+            },
+        };
+    }
+    buildQueryString(query) {
+        const entries = Object.entries(query);
+        if (entries.length === 0)
+            return '';
+        return '?' + entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join('&');
+    }
+    assertOk(res, endpoint, expected = 200) {
+        if (res.statusCode === expected)
+            return;
+        if (res.statusCode >= 200 && res.statusCode < 300)
+            return;
+        let engineMessage = res.body;
+        try {
+            const parsed = JSON.parse(res.body);
+            if (parsed.message)
+                engineMessage = parsed.message;
+        }
+        catch {
+            // Body wasn't JSON — keep raw text.
+        }
+        throw new DockerEngineError(res.statusCode, endpoint, engineMessage);
+    }
+    request(method, path, body) {
+        return new Promise((resolve, reject) => {
+            const req = http.request({
+                socketPath: this.socketPath,
+                path,
+                method,
+                headers: {
+                    ...(body !== undefined && {
+                        'Content-Type': 'application/json',
+                        'Content-Length': Buffer.byteLength(body),
+                    }),
+                },
+            }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk.toString();
+                });
+                res.on('end', () => {
+                    resolve({ statusCode: res.statusCode ?? 500, body: data });
+                });
+            });
+            req.setTimeout(this.requestTimeout, () => {
+                req.destroy(new Error('Docker Engine API request timeout'));
+            });
+            req.on('error', (err) => {
+                const code = err.code;
+                if (code === 'ECONNREFUSED' || code === 'ENOENT') {
+                    reject(new DockerDaemonUnavailableError(this.socketPath, err));
+                    return;
+                }
+                reject(err);
+            });
+            if (body !== undefined) {
+                req.write(body);
+            }
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=docker-engine-client.js.map

package/dist/src/services/docker-engine-client.js.map

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

package/dist/src/services/docker-engine-types.d.ts

@@ -0,0 +1,152 @@
+export type ContainerState = 'running' | 'exited' | 'paused' | 'restarting' | 'dead' | 'created';
+export interface ContainerSummary {
+    Id: string;
+    Names: string[];
+    Labels: Record<string, string>;
+    State: ContainerState;
+    NetworkSettings?: {
+        Networks?: Record<string, {
+            NetworkID: string;
+        }>;
+    };
+}
+export interface NetworkEndpoint {
+    NetworkID: string;
+    Aliases?: string[];
+    IPAddress?: string;
+    IPPrefixLen?: number;
+    IPAMConfig?: {
+        IPv4Address?: string;
+    };
+}
+export interface HealthConfig {
+    Test?: string[];
+    Interval?: number;
+    Timeout?: number;
+    Retries?: number;
+    StartPeriod?: number;
+}
+export interface Mount {
+    Type: 'bind' | 'volume' | 'tmpfs';
+    Source?: string;
+    Target: string;
+    ReadOnly?: boolean;
+    BindOptions?: {
+        Propagation?: string;
+    };
+    VolumeOptions?: {
+        NoCopy?: boolean;
+        Labels?: Record<string, string>;
+    };
+}
+export interface ContainerInspect {
+    Id: string;
+    Name: string;
+    Image: string;
+    Config: {
+        Hostname?: string;
+        Domainname?: string;
+        User?: string;
+        Env?: string[];
+        Cmd?: string[];
+        Entrypoint?: string[] | string;
+        Labels?: Record<string, string>;
+        WorkingDir?: string;
+        Healthcheck?: HealthConfig;
+        StopSignal?: string;
+        StopTimeout?: number;
+        ExposedPorts?: Record<string, Record<string, never>>;
+    };
+    HostConfig: {
+        Binds?: string[];
+        Mounts?: Mount[];
+        NetworkMode?: string;
+        RestartPolicy?: {
+            Name: string;
+            MaximumRetryCount?: number;
+        };
+        LogConfig?: {
+            Type: string;
+            Config: Record<string, string>;
+        };
+        Resources?: {
+            Memory?: number;
+            MemorySwap?: number;
+            CpuShares?: number;
+            CpusetCpus?: string;
+        };
+        SecurityOpt?: string[];
+        CapAdd?: string[];
+        CapDrop?: string[];
+        Devices?: {
+            PathOnHost: string;
+            PathInContainer: string;
+            CgroupPermissions: string;
+        }[];
+        Init?: boolean;
+        IpcMode?: string;
+        PidMode?: string;
+        ReadonlyRootfs?: boolean;
+        Tmpfs?: Record<string, string>;
+    };
+    NetworkSettings: {
+        Networks: Record<string, NetworkEndpoint>;
+    };
+}
+export interface NetworkEndpointCreate {
+    Aliases?: string[];
+    IPAMConfig?: {
+        IPv4Address?: string;
+    };
+}
+export interface ContainerCreateBody {
+    Hostname?: string;
+    User?: string;
+    Env?: string[];
+    Cmd?: string[];
+    Entrypoint?: string[] | string;
+    Image: string;
+    Labels?: Record<string, string>;
+    WorkingDir?: string;
+    Healthcheck?: HealthConfig;
+    StopSignal?: string;
+    StopTimeout?: number;
+    ExposedPorts?: Record<string, Record<string, never>>;
+    HostConfig: ContainerInspect['HostConfig'];
+    NetworkingConfig: {
+        EndpointsConfig: Record<string, NetworkEndpointCreate>;
+    };
+}
+export interface NetworkConnectBody {
+    Container: string;
+    EndpointConfig?: NetworkEndpointCreate;
+}
+/**
+ * Narrowed shape of a Docker Engine `/events` line. Only the fields we read.
+ * Stable across Engine API v1.41+.
+ */
+export interface EngineEvent {
+    Type: 'container';
+    Action: string;
+    id?: string;
+    Actor?: {
+        ID?: string;
+        Attributes?: Record<string, string>;
+    };
+    time?: number;
+    timeNano?: number;
+}
+export declare class DockerEngineError extends Error {
+    readonly name = "DockerEngineError";
+    readonly statusCode: number;
+    readonly endpoint: string;
+    readonly engineMessage: string;
+    constructor(statusCode: number, endpoint: string, engineMessage: string);
+}
+export declare class DockerDaemonUnavailableError extends Error {
+    readonly name = "DockerDaemonUnavailableError";
+    readonly socketPath: string;
+    readonly cause?: Error;
+    constructor(socketPath: string, cause?: Error);
+}
+//# sourceMappingURL=docker-engine-types.d.ts.map

package/dist/src/services/docker-engine-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-engine-types.d.ts","sourceRoot":"","sources":["../../../src/services/docker-engine-types.ts"],"names":[],"mappings":"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"}

package/dist/src/services/docker-engine-types.js

@@ -0,0 +1,37 @@
+// Docker Engine API DTOs and error classes.
+//
+// PascalCase matches the Docker daemon's wire format directly — used as-is in
+// TypeScript types rather than translating to camelCase (saves a layer).
+//
+// Type definitions cover only the fields we read; full responses arrive as
+// `unknown` from node:http and are narrowed at the boundary.
+//
+// Stable across Docker Engine API v1.41+ (matches apt-installed docker on
+// Ubuntu 22+ and the daemon mounted via DooD in cluster-base).
+export class DockerEngineError extends Error {
+    name = 'DockerEngineError';
+    statusCode;
+    endpoint;
+    engineMessage;
+    constructor(statusCode, endpoint, engineMessage) {
+        super(`Docker Engine API ${endpoint} returned ${statusCode}: ${engineMessage}`);
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+        this.engineMessage = engineMessage;
+    }
+}
+export class DockerDaemonUnavailableError extends Error {
+    name = 'DockerDaemonUnavailableError';
+    socketPath;
+    cause;
+    constructor(socketPath, cause) {
+        // Message is 'DOCKER_DAEMON_UNAVAILABLE' so existing string-match code paths
+        // in lifecycle.ts can continue to discriminate by message before the route
+        // handler migrates to instanceof checks.
+        super('DOCKER_DAEMON_UNAVAILABLE');
+        this.socketPath = socketPath;
+        if (cause)
+            this.cause = cause;
+    }
+}
+//# sourceMappingURL=docker-engine-types.js.map

package/dist/src/services/docker-engine-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-engine-types.js","sourceRoot":"","sources":["../../../src/services/docker-engine-types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,2EAA2E;AAC3E,6DAA6D;AAC7D,EAAE;AACF,0EAA0E;AAC1E,+DAA+D;AAuI/D,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxB,IAAI,GAAG,mBAAmB,CAAC;IACpC,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,aAAa,CAAS;IAE/B,YAAY,UAAkB,EAAE,QAAgB,EAAE,aAAqB;QACrE,KAAK,CAAC,qBAAqB,QAAQ,aAAa,UAAU,KAAK,aAAa,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACnC,IAAI,GAAG,8BAA8B,CAAC;IAC/C,UAAU,CAAS;IACV,KAAK,CAAS;IAEhC,YAAY,UAAkB,EAAE,KAAa;QAC3C,6EAA6E;QAC7E,2EAA2E;QAC3E,yCAAyC;QACzC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;CACF"}

package/dist/src/services/vscode-tunnel-manager.d.ts

@@ -15,6 +15,7 @@ export interface VsCodeTunnelEvent {
 export interface VsCodeTunnelManager {
     start(): Promise<VsCodeTunnelStartResult>;
     stop(): Promise<void>;
+    unregister(): Promise<void>;
     getStatus(): VsCodeTunnelStatus;
     shutdown(): Promise<void>;
 }
@@ -27,6 +28,18 @@ export interface VsCodeTunnelManagerOptions {
 export declare const DEFAULT_VSCODE_CLI_BIN = "/usr/local/bin/code";
 export declare const DEFAULT_DEVICE_CODE_TIMEOUT_MS = 30000;
 export declare const DEFAULT_FORCE_KILL_TIMEOUT_MS = 5000;
+/**
+ * Derive a VS Code tunnel name from a cluster UUID.
+ *
+ * Microsoft's tunnel service requires names to satisfy
+ * `/^[a-z][a-z0-9-]{0,19}$/` (≤20 chars, lowercase, letter-initial,
+ * `[a-z0-9-]`). UUIDs are 36 chars and hyphens are stripped before slicing.
+ *
+ * Per-cluster derivation is required for multi-cluster support (#744 FR-001).
+ * Using the stable project id (the #618 fix) collided whenever a single
+ * project had more than one cluster; cloud-side per-cluster persistence
+ * (generacy-cloud#792, merge:true #563) makes the cluster UUID the right key.
+ */
 export declare function deriveTunnelName(clusterId: string): string;
 export declare function loadOptionsFromEnv(env?: NodeJS.ProcessEnv): VsCodeTunnelManagerOptions;
 export declare class VsCodeTunnelProcessManager implements VsCodeTunnelManager {
@@ -39,12 +52,22 @@ export declare class VsCodeTunnelProcessManager implements VsCodeTunnelManager {
     private deviceCode;
     private verificationUri;
     private tunnelUrl;
+    private actualTunnelName;
     private stopping;
     constructor(opts: VsCodeTunnelManagerOptions);
+    /** Extract the registered tunnel name from a `https://vscode.dev/tunnel/<name>/…` URL. */
+    private tunnelNameFromUrl;
     getStatus(): VsCodeTunnelStatus;
     start(): Promise<VsCodeTunnelStartResult>;
     stop(): Promise<void>;
     shutdown(): Promise<void>;
+    /**
+     * Release the cluster's tunnel name from Microsoft's tunnel service so the
+     * name can be reused after `generacy destroy`. Best-effort: spawns
+     * `code tunnel unregister --name <tunnelName>` with a 10s timeout. On
+     * timeout or non-zero exit, emits a warning event and resolves; never throws.
+     */
+    unregister(): Promise<void>;
     private handleStdoutLine;
     private clearDeviceCodeTimer;
 }

package/dist/src/services/vscode-tunnel-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode-tunnel-manager.d.ts","sourceRoot":"","sources":["../../../src/services/vscode-tunnel-manager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,UAAU,GACV,uBAAuB,GACvB,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,kBAAkB,CAAC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAQnD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,0BAA0B,CAkB5B;AAOD,qBAAa,0BAA2B,YAAW,mBAAmB;IAWxD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,0BAA0B;IAE7D,SAAS,IAAI,kBAAkB;IAIzB,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA2HzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,oBAAoB;CAM7B;AAID,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE7E"}
+{"version":3,"file":"vscode-tunnel-manager.d.ts","sourceRoot":"","sources":["../../../src/services/vscode-tunnel-manager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,UAAU,GACV,uBAAuB,GACvB,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,IAAI,kBAAkB,CAAC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAQnD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,0BAA0B,CAc5B;AAOD,qBAAa,0BAA2B,YAAW,mBAAmB;IAkBxD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBjC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAAuB;IAOxC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,0BAA0B;IAE7D,0FAA0F;IAC1F,OAAO,CAAC,iBAAiB;IAIzB,SAAS,IAAI,kBAAkB;IAIzB,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA+HzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDjC,OAAO,CAAC,gBAAgB;IA+DxB,OAAO,CAAC,oBAAoB;CAM7B;AAID,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE7E"}