@agentdeck/bridge 1.0.19 → 1.0.21

package/dist/codex-hook-silence.js

@@ -0,0 +1,80 @@
+/**
+ * Codex hook-silence warning — detects the "lifecycle channel dead on
+ * arrival" failure with zero signal today.
+ *
+ * Codex lifecycle hooks AND the notify turn-complete fallback ride the same
+ * mechanism (a curl POST to this bridge's AGENTDECK_PORT, installed in
+ * ~/.codex/config.toml), so they share failure modes: a stale port in the
+ * config, a hooks.json/inline-[hooks] layer conflict, or a broken curl kills
+ * both at once. Since the PTY fallback state machine was removed (1.0.19), a
+ * managed Codex session in that condition is lifecycle-blind silently —
+ * no state changes, no timeline, no APME — while the terminal itself works.
+ *
+ * Detection is deliberately modest: if the PTY has produced real activity but
+ * NO codex_* hook or notify event has EVER arrived by the grace deadline, the
+ * install is broken — warn once (log + timeline row). The first hook event
+ * proves the channel and disarms permanently; mid-session hook death is out
+ * of scope (it cannot be distinguished from an idle session without parsing
+ * the screen, which lifecycle correctness must not do).
+ *
+ * `--no-codex-hooks` opted out of lifecycle monitoring explicitly; callers
+ * must not arm this warning in that case (cli.ts already prints the
+ * degradation notice at startup).
+ */
+import { debug } from './logger.js';
+/** How long after session start to expect the first codex_* event.
+ *  codex_session_start fires immediately on launch, so one grace period
+ *  covers slow starts without a turn ever being submitted. */
+export const CODEX_HOOK_SILENCE_GRACE_MS = 120_000;
+/** Minimum PTY activity events before silence is judged — a session that
+ *  never rendered anything may simply not have started. */
+export const CODEX_HOOK_SILENCE_MIN_ACTIVITY = 10;
+export class CodexHookSilenceWarning {
+    onSilent;
+    minActivity;
+    timer = null;
+    activityCount = 0;
+    hookSeen = false;
+    deadlinePassed = false;
+    constructor(opts) {
+        this.onSilent = opts.onSilent;
+        this.minActivity = opts.minActivity ?? CODEX_HOOK_SILENCE_MIN_ACTIVITY;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.deadlinePassed = true;
+            this.judge();
+        }, opts.graceMs ?? CODEX_HOOK_SILENCE_GRACE_MS);
+        this.timer.unref?.();
+    }
+    /** Any codex_* hook or notify event proves the channel; disarms forever. */
+    noteHookEvent() {
+        if (this.hookSeen)
+            return;
+        this.hookSeen = true;
+        this.stop();
+    }
+    /** PTY activity — the terminal is being used. If the grace deadline already
+     *  passed with too little activity, late activity re-judges once. */
+    noteActivity() {
+        this.activityCount++;
+        if (this.deadlinePassed)
+            this.judge();
+    }
+    stop() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.deadlinePassed = false;
+    }
+    judge() {
+        if (this.hookSeen)
+            return;
+        if (this.activityCount < this.minActivity)
+            return;
+        this.deadlinePassed = false; // fire once
+        debug('codex', `hook silence: ${this.activityCount} PTY activity events, zero codex_* hooks`);
+        this.onSilent();
+    }
+}
+//# sourceMappingURL=codex-hook-silence.js.map

package/dist/codex-hook-silence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-silence.js","sourceRoot":"","sources":["../src/codex-hook-silence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;8DAE8D;AAC9D,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AACnD;2DAC2D;AAC3D,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAQlD,MAAM,OAAO,uBAAuB;IACjB,QAAQ,CAAa;IACrB,WAAW,CAAS;IAC7B,KAAK,GAAyC,IAAI,CAAC;IACnD,aAAa,GAAG,CAAC,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IACjB,cAAc,GAAG,KAAK,CAAC;IAE/B,YAAY,IAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,+BAA+B,CAAC;QACvE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,EAAE,IAAI,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC;IAED,4EAA4E;IAC5E,aAAa;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED;yEACqE;IACrE,YAAY;QACV,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,cAAc;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,CAAC;IAEO,KAAK;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW;YAAE,OAAO;QAClD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,YAAY;QACzC,KAAK,CAAC,OAAO,EAAE,iBAAiB,IAAI,CAAC,aAAa,0CAA0C,CAAC,CAAC;QAC9F,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/daemon-port.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The CLI daemon's **preferred port** — the port it intends to serve, as
+ * opposed to the port it ended up on.
+ *
+ * Roadmap item 11 (docs/ENTERPRISE-ROADMAP.md §1.5) asks for a persistent
+ * `daemonPort` for the CLI to match the macOS app's `AppPreferences.daemonPort`.
+ * The reason it matters is not configurability for its own sake — it is that
+ * without a recorded intent, a daemon that landed on a fallback port has no way
+ * to know it is on the wrong one.
+ *
+ * ## Intent is persisted; the outcome never is
+ *
+ * This is the rule the whole module exists to enforce. `daemon.json` records
+ * where the daemon *is*, and every client resolves through it. This setting
+ * records where the daemon *wants to be*. Persisting the outcome instead would
+ * be self-reinforcing: a daemon bumped to 9121 by a transient hold would write
+ * 9121 down and start there forever, turning a 14-second kernel reservation
+ * into a permanent move. So nothing in the daemon's startup path ever writes
+ * this value — only the user does, via `agentdeck daemon port <n>`.
+ *
+ * ## Sources
+ *
+ * `-p/--port` › `AGENTDECK_DAEMON_PORT` › `settings.json` `daemonPort` › 9120.
+ * All four are statements of intent; they differ only in precedence and in how
+ * long they last. The resolved `source` is carried alongside the number because
+ * one caller needs it: `daemon start` treats a port the user typed on THIS
+ * invocation differently from one it merely defaulted to (an explicit choice
+ * fails loudly rather than quietly binding a different port).
+ */
+/** `settings.json` key. Same name as the macOS app's `prefs.daemonPort`. */
+export declare const DAEMON_PORT_SETTING_KEY = "daemonPort";
+/** Environment override, for a shell or MDM profile that cannot edit files. */
+export declare const DAEMON_PORT_ENV_VAR = "AGENTDECK_DAEMON_PORT";
+/**
+ * Accepted range, mirroring `AppPreferences.clampPort` (1024–65535). Below 1024
+ * needs root on every platform we support, which the daemon never has.
+ */
+export declare const DAEMON_PORT_MIN = 1024;
+export declare const DAEMON_PORT_MAX = 65535;
+/**
+ * How long the daemon waits for its preferred port to come free before
+ * conceding to a fallback, when nothing answers `/health` on it.
+ *
+ * Sized from a measurement, not a guess: cancelling a listener on macOS leaves
+ * a NECP reservation on the port for ~14s (bindable at ~17s, measured
+ * 2026-08-06 — `lsof` shows zero sockets for the whole interval and `bind()`
+ * still returns EADDRINUSE). 20s clears that with margin.
+ *
+ * The wait polls, so it costs only as long as the port is actually held. The
+ * full budget is paid only when something outside AgentDeck really is
+ * listening there — once per daemon start, with a log line saying so.
+ */
+export declare const PREFERRED_PORT_RECLAIM_MS = 20000;
+export type DaemonPortSource = 'flag' | 'env' | 'settings' | 'default';
+export interface ResolvedDaemonPort {
+    port: number;
+    source: DaemonPortSource;
+}
+/** True when `value` is a port this daemon may be asked to bind. */
+export declare function isValidDaemonPort(value: unknown): value is number;
+/**
+ * Parse a port written as text (a flag value, an env var). Returns null for
+ * anything that is not a valid port — including `"9120abc"`, which `parseInt`
+ * would happily read as 9120.
+ */
+export declare function parseDaemonPort(raw: string | undefined | null): number | null;
+/**
+ * The persisted preference, or null when absent or unusable.
+ *
+ * Lenient on purpose: a malformed `daemonPort` must fall through to the
+ * default rather than stop the daemon from starting. The *setter* is the strict
+ * half — it rejects out-of-range input with a message, so a typo is caught
+ * where the user can see it instead of silently reverting six weeks later.
+ */
+export declare function preferredDaemonPortFrom(settings: Record<string, unknown>): number | null;
+export interface ResolveDaemonPortInput {
+    /** `-p/--port` as typed on THIS invocation, or undefined when defaulted. */
+    flag?: string | number | null;
+    env?: NodeJS.ProcessEnv;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Resolve the preferred port and where it came from. Pure — every input is
+ * injectable so the precedence order can be pinned without touching the real
+ * environment or the real settings file.
+ */
+export declare function resolveDaemonPort(input?: ResolveDaemonPortInput): ResolvedDaemonPort;
+/** Human-readable provenance, for `daemon port` and the startup log. */
+export declare function describeDaemonPortSource(source: DaemonPortSource): string;
+//# sourceMappingURL=daemon-port.d.ts.map

package/dist/daemon-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-port.d.ts","sourceRoot":"","sources":["../src/daemon-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAK7E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAMxF;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,sBAA2B,GAAG,kBAAkB,CAYxF;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAOzE"}

package/dist/daemon-port.js

@@ -0,0 +1,119 @@
+/**
+ * The CLI daemon's **preferred port** — the port it intends to serve, as
+ * opposed to the port it ended up on.
+ *
+ * Roadmap item 11 (docs/ENTERPRISE-ROADMAP.md §1.5) asks for a persistent
+ * `daemonPort` for the CLI to match the macOS app's `AppPreferences.daemonPort`.
+ * The reason it matters is not configurability for its own sake — it is that
+ * without a recorded intent, a daemon that landed on a fallback port has no way
+ * to know it is on the wrong one.
+ *
+ * ## Intent is persisted; the outcome never is
+ *
+ * This is the rule the whole module exists to enforce. `daemon.json` records
+ * where the daemon *is*, and every client resolves through it. This setting
+ * records where the daemon *wants to be*. Persisting the outcome instead would
+ * be self-reinforcing: a daemon bumped to 9121 by a transient hold would write
+ * 9121 down and start there forever, turning a 14-second kernel reservation
+ * into a permanent move. So nothing in the daemon's startup path ever writes
+ * this value — only the user does, via `agentdeck daemon port <n>`.
+ *
+ * ## Sources
+ *
+ * `-p/--port` › `AGENTDECK_DAEMON_PORT` › `settings.json` `daemonPort` › 9120.
+ * All four are statements of intent; they differ only in precedence and in how
+ * long they last. The resolved `source` is carried alongside the number because
+ * one caller needs it: `daemon start` treats a port the user typed on THIS
+ * invocation differently from one it merely defaulted to (an explicit choice
+ * fails loudly rather than quietly binding a different port).
+ */
+import { loadDaemonSettings } from './daemon-settings.js';
+import { DAEMON_DEFAULT_PORT } from './session-registry.js';
+/** `settings.json` key. Same name as the macOS app's `prefs.daemonPort`. */
+export const DAEMON_PORT_SETTING_KEY = 'daemonPort';
+/** Environment override, for a shell or MDM profile that cannot edit files. */
+export const DAEMON_PORT_ENV_VAR = 'AGENTDECK_DAEMON_PORT';
+/**
+ * Accepted range, mirroring `AppPreferences.clampPort` (1024–65535). Below 1024
+ * needs root on every platform we support, which the daemon never has.
+ */
+export const DAEMON_PORT_MIN = 1024;
+export const DAEMON_PORT_MAX = 65535;
+/**
+ * How long the daemon waits for its preferred port to come free before
+ * conceding to a fallback, when nothing answers `/health` on it.
+ *
+ * Sized from a measurement, not a guess: cancelling a listener on macOS leaves
+ * a NECP reservation on the port for ~14s (bindable at ~17s, measured
+ * 2026-08-06 — `lsof` shows zero sockets for the whole interval and `bind()`
+ * still returns EADDRINUSE). 20s clears that with margin.
+ *
+ * The wait polls, so it costs only as long as the port is actually held. The
+ * full budget is paid only when something outside AgentDeck really is
+ * listening there — once per daemon start, with a log line saying so.
+ */
+export const PREFERRED_PORT_RECLAIM_MS = 20_000;
+/** True when `value` is a port this daemon may be asked to bind. */
+export function isValidDaemonPort(value) {
+    return typeof value === 'number'
+        && Number.isInteger(value)
+        && value >= DAEMON_PORT_MIN
+        && value <= DAEMON_PORT_MAX;
+}
+/**
+ * Parse a port written as text (a flag value, an env var). Returns null for
+ * anything that is not a valid port — including `"9120abc"`, which `parseInt`
+ * would happily read as 9120.
+ */
+export function parseDaemonPort(raw) {
+    const text = raw?.trim();
+    if (!text || !/^\d+$/.test(text))
+        return null;
+    const value = Number(text);
+    return isValidDaemonPort(value) ? value : null;
+}
+/**
+ * The persisted preference, or null when absent or unusable.
+ *
+ * Lenient on purpose: a malformed `daemonPort` must fall through to the
+ * default rather than stop the daemon from starting. The *setter* is the strict
+ * half — it rejects out-of-range input with a message, so a typo is caught
+ * where the user can see it instead of silently reverting six weeks later.
+ */
+export function preferredDaemonPortFrom(settings) {
+    const value = settings[DAEMON_PORT_SETTING_KEY];
+    if (isValidDaemonPort(value))
+        return value;
+    // A port stored as a string is a plausible hand-edit of settings.json.
+    if (typeof value === 'string')
+        return parseDaemonPort(value);
+    return null;
+}
+/**
+ * Resolve the preferred port and where it came from. Pure — every input is
+ * injectable so the precedence order can be pinned without touching the real
+ * environment or the real settings file.
+ */
+export function resolveDaemonPort(input = {}) {
+    const flag = typeof input.flag === 'number' ? input.flag : parseDaemonPort(input.flag ?? undefined);
+    if (isValidDaemonPort(flag))
+        return { port: flag, source: 'flag' };
+    const env = input.env ?? process.env;
+    const fromEnv = parseDaemonPort(env[DAEMON_PORT_ENV_VAR]);
+    if (fromEnv !== null)
+        return { port: fromEnv, source: 'env' };
+    const fromSettings = preferredDaemonPortFrom(input.settings ?? loadDaemonSettings());
+    if (fromSettings !== null)
+        return { port: fromSettings, source: 'settings' };
+    return { port: DAEMON_DEFAULT_PORT, source: 'default' };
+}
+/** Human-readable provenance, for `daemon port` and the startup log. */
+export function describeDaemonPortSource(source) {
+    switch (source) {
+        case 'flag': return '--port';
+        case 'env': return DAEMON_PORT_ENV_VAR;
+        case 'settings': return `settings.json ${DAEMON_PORT_SETTING_KEY}`;
+        case 'default': return 'built-in default';
+    }
+}
+//# sourceMappingURL=daemon-port.js.map

package/dist/daemon-port.js.map

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

package/dist/daemon-server.d.ts

@@ -12,6 +12,7 @@
  */
 import WebSocket from 'ws';
 import { BridgeCore } from './bridge-core.js';
+import { type DaemonPortSource } from './daemon-port.js';
 import { type ApiUsageData } from './usage-api.js';
 /**
  * Single-path transport dedup. A physical ESP32 can be reachable over BOTH a
@@ -96,12 +97,24 @@ export declare function enrichGatewayTimelineEntry<T extends {
  */
 export declare function classifyObservedHookEvent(eventName: string, mapped: string): {
     boundary: string;
-    agentType: 'claude-code' | 'codex-cli' | 'opencode' | 'antigravity';
+    agentType: 'claude-code' | 'codex-cli' | 'opencode' | 'antigravity' | 'kiro-cli' | 'kiro-ide';
 };
 export interface DaemonOptions {
+    /** The preferred port — already resolved by the caller when present. */
     port?: number;
+    /**
+     * Where `port` came from. Carried so the fallback log can name the real
+     * source: the CLI resolves the port itself (so the parent's singleton guard
+     * and the forked child cannot aim at different ports), which would otherwise
+     * make every port look like it was typed as `--port`.
+     */
+    portSource?: DaemonPortSource;
     debug?: boolean;
     wakeWord?: boolean;
+    /** `--local`: every device module off, USB serial included. */
+    local?: boolean;
+    /** `--loopback`: bind 127.0.0.1 and emit nothing onto the LAN. */
+    loopback?: boolean;
 }
 export declare function startDaemon(opts: DaemonOptions): Promise<void>;
 export {};

package/dist/daemon-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAwH1E,OAAO,EAA8D,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAqQ/G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,OAAO,CAST;AAkBD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA+C1E;AAYD,iBAAS,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAStD;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBlE;AA6ED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AACD,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AACD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,iBAAe,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8F3H;AAoHD,iEAAiE;AACjE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACnH,KAAK,EAAE,CAAC,GACP,CAAC,CAWH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAA;CAAE,CAa3F;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqwIpE"}
+{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAyH1E,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA8D,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA8Q/G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,OAAO,CAST;AAkBD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA+C1E;AAYD,iBAAS,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAStD;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBlE;AA6ED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AACD,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AACD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,iBAAe,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8F3H;AA6FD,iEAAiE;AACjE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACnH,KAAK,EAAE,CAAC,GACP,CAAC,CAWH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAA;CAAE,CAiBrH;AAID,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAw/IpE"}