@felan-ai/daemon 0.0.0-stage → 0.0.0

package/dist/daemon/legacy-sessions.js

@@ -0,0 +1,328 @@
+import { constants } from 'node:fs';
+import { open, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { canonicalPath } from './profile-storage.js';
+import { parseSchema } from '@felan-ai/session-protocol';
+import { isConversationEntry, sessionHeaderSchema } from './session-files.js';
+const sessionId = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/u;
+const EMPTY = Object.freeze({ title: '', preview: '' });
+const HEADER_CHUNK = 4096;
+const HEADER_BYTES = 64 * 1024;
+const INDEX_CONCURRENCY = 16;
+const SUMMARY_READS = 4;
+const WARM_READS = 2;
+// Pi's default per-cwd directory name under agentDir/sessions, as written by pre-daemon Felan.
+export function legacySessionDirectoryName(cwd) {
+    return `--${cwd.replace(/^[/\\]/u, '').replace(/[/\\:]/gu, '-')}--`;
+}
+/**
+ * Finds unregistered Pi transcripts in the pre-daemon layouts of the owned stores: the per-cwd
+ * directories under agentDir/sessions and the top level of each store root (custom session
+ * directories). Discovery reads only header lines. A summary needs the whole file, like Pi's
+ * session list, so it is read on request. Both are cached until the file changes.
+ */
+export class LegacySessionIndex {
+    owner;
+    headers = new Map();
+    summaries = new Map();
+    reading = new Map();
+    // Listing pages and the warm-up share these, so neither can flood the file system.
+    reads = new Slots(SUMMARY_READS);
+    constructor(owner) {
+        this.owner = owner;
+    }
+    /** Newest first. Malformed and registered files are skipped; a duplicated ID keeps only its newest file. */
+    async discover(registered, options = {}) {
+        const { cwd, signal } = options;
+        const sessions = join(this.owner.target.agentDir, 'sessions');
+        // A transcript written under a symlinked project path lives in that path's directory, so a cwd filter cannot narrow the scan.
+        const nested = (await entries(sessions)).filter(entry => !entry.isFile() && /^--.+--$/u.test(entry.name)).map(entry => join(sessions, entry.name));
+        const directories = [sessions, ...nested, ...this.owner.target.rootSet.filter(root => root !== this.owner.target.agentDir && root !== sessions)];
+        const listings = await limited(directories, INDEX_CONCURRENCY, signal, async (directory) => (await entries(directory)).filter(entry => entry.name.endsWith('.jsonl')).map(entry => join(directory, entry.name)));
+        const skipped = new Set(registered.map(row => row.piPath));
+        const paths = [...new Set(listings.flat())].filter(path => !skipped.has(path));
+        const canonical = new Map();
+        const files = (await limited(paths, INDEX_CONCURRENCY, signal, async (path) => {
+            let info;
+            try {
+                info = await stat(path);
+            }
+            catch {
+                return undefined;
+            }
+            if (!info.isFile())
+                return undefined;
+            const header = await this.header(path, info);
+            if (!header)
+                return undefined;
+            let resolved = canonical.get(header.cwd);
+            if (!resolved)
+                canonical.set(header.cwd, resolved = canonicalPath(header.cwd).catch(() => header.cwd));
+            return { id: header.id, cwd: await resolved, path, mtimeMs: info.mtimeMs };
+        })).filter((file) => file !== undefined);
+        const present = new Set(paths);
+        for (const cache of [this.headers, this.summaries])
+            for (const path of cache.keys())
+                if (!present.has(path))
+                    cache.delete(path);
+        files.sort((a, b) => a.mtimeMs === b.mtimeMs ? a.path.localeCompare(b.path) : b.mtimeMs - a.mtimeMs);
+        const ids = new Set(registered.map(row => row.id));
+        const found = [];
+        for (const file of files) {
+            if (ids.has(file.id))
+                continue;
+            ids.add(file.id);
+            if (cwd === undefined || file.cwd === cwd)
+                found.push({ id: file.id, cwd: file.cwd, path: file.path, modifiedAt: Math.floor(file.mtimeMs) });
+        }
+        return found;
+    }
+    /** Empty when the file is gone, unreadable or no longer holds this session. */
+    async summary(session) {
+        let info;
+        try {
+            info = await stat(session.path);
+        }
+        catch {
+            return EMPTY;
+        }
+        const version = fileVersion(info);
+        const cached = this.summaries.get(session.path);
+        if (cached?.version === version)
+            return cached.id === session.id ? cached.summary : EMPTY;
+        const key = `${version}:${session.path}`;
+        let read = this.reading.get(key);
+        if (!read) {
+            read = this.reads.run(() => readTranscript(session.path, false)).then(result => {
+                if (result)
+                    this.summaries.set(session.path, { version, id: result.id, summary: { title: result.title, preview: result.preview } });
+                return result;
+            }).finally(() => this.reading.delete(key));
+            this.reading.set(key, read);
+        }
+        const result = await read;
+        return result?.id === session.id ? { title: result.title, preview: result.preview } : EMPTY;
+    }
+    /** Reads summaries in the given order, a few at a time, so listings rarely wait for a whole transcript. */
+    async warm(sessions, signal) {
+        await limited(sessions, WARM_READS, signal, session => this.summary(session));
+    }
+    async header(path, info) {
+        const version = fileVersion(info);
+        const cached = this.headers.get(path);
+        if (cached?.version === version)
+            return cached.header;
+        let header;
+        // A read failure may be transient, so only a parsed or rejected header is remembered.
+        try {
+            header = await readHeader(path);
+        }
+        catch {
+            return undefined;
+        }
+        this.headers.set(path, { version, header });
+        return header;
+    }
+}
+/** Whether a transcript holds a conversation message. Unreadable files count as conversations, so they are kept. */
+export async function transcriptHasConversation(path) {
+    try {
+        const handle = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+        const input = handle.createReadStream({ encoding: 'utf8', autoClose: false });
+        try {
+            for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+                try {
+                    if (isConversationEntry(JSON.parse(line)))
+                        return true;
+                }
+                catch { /* Partial lines are not entries. */ }
+            }
+            return false;
+        }
+        finally {
+            input.destroy();
+            await handle.close();
+        }
+    }
+    catch {
+        return true;
+    }
+}
+/** First user message of a transcript file; empty when absent or unreadable. */
+export async function readTranscriptPreview(path) {
+    return (await readTranscript(path, true))?.preview ?? '';
+}
+/** First user message among in-memory Pi session entries. */
+export function transcriptPreview(entries) {
+    const summary = summarizer();
+    for (const entry of entries)
+        summary.add(entry);
+    return summary.result().preview;
+}
+function fileVersion(info) {
+    return `${info.dev}:${info.ino}:${info.size}:${info.mtimeMs}`;
+}
+async function entries(directory) {
+    try {
+        return await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/** Undefined when the file is not a Pi session; I/O failures throw. */
+async function readHeader(path) {
+    // Non-blocking open keeps a FIFO named *.jsonl from stalling discovery.
+    const handle = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+    try {
+        if (!(await handle.stat()).isFile())
+            return undefined;
+        const buffer = Buffer.alloc(HEADER_BYTES);
+        let length = 0;
+        let end = -1;
+        while (end < 0 && length < buffer.length) {
+            const { bytesRead } = await handle.read(buffer, length, Math.min(HEADER_CHUNK, buffer.length - length), length);
+            if (!bytesRead)
+                break;
+            end = buffer.indexOf(10, length);
+            length += bytesRead;
+        }
+        if (end < 0 && length === buffer.length)
+            return undefined;
+        return parseHeader(buffer.toString('utf8', 0, end < 0 ? length : end));
+    }
+    finally {
+        await handle.close();
+    }
+}
+function parseHeader(line) {
+    try {
+        const header = parseSchema(sessionHeaderSchema, JSON.parse(line));
+        return sessionId.test(header.id) ? { id: header.id, cwd: header.cwd } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readTranscript(path, previewOnly) {
+    try {
+        const handle = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+        const input = handle.createReadStream({ encoding: 'utf8', autoClose: false });
+        try {
+            if (!(await handle.stat()).isFile())
+                return undefined;
+            let header;
+            const summary = summarizer();
+            for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+                if (!header) {
+                    header = parseHeader(line);
+                    if (!header)
+                        return undefined;
+                    continue;
+                }
+                summary.line(line);
+                if (previewOnly && summary.hasPreview())
+                    break;
+            }
+            return header && { ...header, ...summary.result() };
+        }
+        finally {
+            input.destroy();
+            await handle.close();
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+// Latest Pi session name and first user message.
+function summarizer() {
+    let name;
+    let message;
+    const add = (entry) => {
+        if (!entry || typeof entry !== 'object')
+            return;
+        const row = entry;
+        if (row.type === 'session_info')
+            name = typeof row.name === 'string' ? row.name : undefined;
+        else if (!message?.trim() && row.type === 'message' && row.message?.role === 'user')
+            message = textOf(row.message.content);
+    };
+    return {
+        add,
+        line(text) {
+            // Pi writes entries with JSON.stringify, so a relevant entry always contains its quoted type or role; other lines are not parsed.
+            if (!text.includes('"session_info"') && (message?.trim() || !text.includes('"user"')))
+                return;
+            try {
+                add(JSON.parse(text));
+            }
+            catch { /* Partial or foreign lines are not entries. */ }
+        },
+        hasPreview: () => !!message?.trim(),
+        result: () => ({ title: snippet(name?.trim() ?? ''), preview: snippet(message ?? '') }),
+    };
+}
+function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    return content.map(part => part && typeof part === 'object' && part.type === 'text' && typeof part.text === 'string' ? part.text : '').join(' ');
+}
+function snippet(text) {
+    const flat = text.replace(/[\p{Cc}\p{Cf}\s]+/gu, ' ').trim();
+    const points = [...flat];
+    return points.length > 120 ? `${points.slice(0, 119).join('').trimEnd()}…` : flat;
+}
+/** Maps in order with at most `limit` calls in flight. Once aborted it starts no more calls and rejects after the running ones settle. */
+async function limited(items, limit, signal, map) {
+    const results = new Array(items.length);
+    let next = 0;
+    let failed = false;
+    const worker = async () => {
+        try {
+            while (!failed && next < items.length) {
+                signal?.throwIfAborted();
+                const index = next++;
+                results[index] = await map(items[index]);
+            }
+        }
+        catch (error) {
+            failed = true;
+            throw error;
+        }
+    };
+    for (const result of await Promise.allSettled(Array.from({ length: Math.min(limit, items.length) }, worker)))
+        if (result.status === 'rejected')
+            throw result.reason;
+    signal?.throwIfAborted();
+    return results;
+}
+/** A counting semaphore; a released slot passes directly to the next waiter. */
+class Slots {
+    size;
+    active = 0;
+    waiting = [];
+    constructor(size) {
+        this.size = size;
+    }
+    async run(work) {
+        if (this.active < this.size)
+            this.active++;
+        else
+            await new Promise(resolve => this.waiting.push(resolve));
+        try {
+            return await work();
+        }
+        finally {
+            const next = this.waiting.shift();
+            if (next)
+                next();
+            else
+                this.active--;
+        }
+    }
+}
+//# sourceMappingURL=legacy-sessions.js.map

package/dist/daemon/legacy-sessions.js.map

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

package/dist/daemon/lifecycle.d.ts

@@ -0,0 +1,44 @@
+import type { DaemonIdentity, HostBlocked, OperationParams, OperationResult } from '@felan-ai/session-protocol';
+import type { AdmittedCommand, AdmissionOutcome } from './admission.js';
+import { type ResolvedDaemonTarget } from './target.js';
+import { type ShutdownStep } from './shutdown-error.js';
+export type HostState = OperationResult<'host.status'>['state'];
+export type HostAction = 'stop' | 'restart';
+export type HostMode = OperationParams<'host.stop'>['mode'];
+export interface HostLifecycleOptions {
+    target: ResolvedDaemonTarget;
+    identity: DaemonIdentity;
+    beginDrain(): void;
+    /** Reopens admission after a drain was abandoned; throws when the daemon can no longer resume. */
+    endDrain(): void;
+    /** Settlement must stop before releasing anything once `signal` aborts. */
+    settle(mode: HostMode, signal: AbortSignal): Promise<void>;
+    complete(action: HostAction): Promise<void>;
+    timeoutMs?: number;
+    canRetry?(): boolean;
+    onBlocked?(blocked: HostBlocked, error: unknown): void;
+    record?(event: 'stop_requested' | 'restart_requested' | 'drain_blocked' | 'drain_cancelled' | 'releasing'): void;
+}
+export declare class HostLifecycle {
+    private readonly options;
+    private current;
+    private generation;
+    private completing;
+    private pending;
+    private blockedRecord;
+    private readonly timeout;
+    constructor(options: HostLifecycleOptions);
+    get state(): HostState;
+    get blocked(): HostBlocked | undefined;
+    block(error?: unknown, step?: ShutdownStep, retryable?: boolean): void;
+    blockedError(work?: boolean): Error & {
+        code: string;
+    };
+    prepare(command: AdmittedCommand): AdmissionOutcome;
+    afterResponse(id: string, accepted?: boolean): void;
+    private finish;
+    private resume;
+    private settle;
+    private setState;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/daemon/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAkD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExG,MAAM,MAAM,SAAS,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,IAAI,IAAI,CAAC;IACnB,kGAAkG;IAClG,QAAQ,IAAI,IAAI,CAAC;IACjB,2EAA2E;IAC3E,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,OAAO,CAAC;IACrB,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,WAAW,GAAG,IAAI,CAAC;CAClH;AAID,qBAAa,aAAa;IAQZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEJ,OAAO,EAAE,oBAAoB;IAK1D,IAAI,KAAK,IAAI,SAAS,CAAyB;IAC/C,IAAI,OAAO,IAAI,WAAW,GAAG,SAAS,CAAqG;IAE3I,KAAK,CAAC,KAAK,GAAE,OAAiD,EAAE,IAAI,GAAE,YAA+B,EAAE,SAAS,UAAQ,GAAG,IAAI;IAY/H,YAAY,CAAC,IAAI,UAAQ,GAAG,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAQpD,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB;IA0BnD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;YAQlC,MAAM;IAkBpB,OAAO,CAAC,MAAM;YAQA,MAAM;IASpB,OAAO,CAAC,QAAQ;CACjB"}

package/dist/daemon/lifecycle.js

@@ -0,0 +1,164 @@
+import { accepted, commandError } from './commands.js';
+import { assertTargetIdentity } from './target.js';
+import { ShutdownError, shutdownDetail, shutdownMessage } from './shutdown-error.js';
+export class HostLifecycle {
+    options;
+    current = 'ready';
+    generation = 0;
+    completing = false;
+    pending;
+    blockedRecord;
+    timeout;
+    constructor(options) {
+        this.options = options;
+        this.timeout = options.timeoutMs ?? 30_000;
+        if (!Number.isInteger(this.timeout) || this.timeout < 1 || this.timeout > 120_000)
+            throw new Error('Invalid drain deadline.');
+    }
+    get state() { return this.current; }
+    get blocked() { return this.current === 'blocked' && this.blockedRecord ? { ...this.blockedRecord } : undefined; }
+    block(error = new Error('Daemon ownership was lost.'), step = 'ownership-lost', retryable = false) {
+        this.generation++;
+        this.pending?.abort.abort();
+        this.pending = undefined;
+        let recoverable = false;
+        try {
+            recoverable = retryable && (this.options.canRetry?.() ?? false);
+        }
+        catch { }
+        const detail = shutdownDetail(error);
+        this.blockedRecord = { recoverable, since: Date.now(), message: shutdownMessage(error), step: detail?.step ?? step,
+            ...(detail?.session ? { session: detail.session } : {}), pid: process.pid };
+        this.current = 'blocked';
+        try {
+            this.options.onBlocked?.(this.blockedRecord, error);
+        }
+        catch { }
+        try {
+            this.options.record?.('drain_blocked');
+        }
+        catch { }
+    }
+    blockedError(work = false) {
+        const blocked = this.blockedRecord;
+        const recovery = blocked?.recoverable ? work ? 'Retry the stop or restart with force.' : 'Retry with force to finish cleanup.'
+            : `Cleanup cannot be retried safely; force-terminate the daemon process ${forceTermination(blocked?.pid ?? process.pid)}.`;
+        return commandError('host_blocked', work ? `The daemon is blocked after an incomplete shutdown and refuses new work. ${recovery}`
+            : `The daemon is blocked after an incomplete shutdown at ${blocked?.step ?? 'settlement'}: ${blocked?.message ?? 'Shutdown failed.'} ${recovery}`);
+    }
+    prepare(command) {
+        const request = command.request;
+        if (request.op !== 'host.stop' && request.op !== 'host.restart')
+            throw commandError('invalid_request');
+        assertTargetIdentity(this.options.target, request.params.expected, this.options.identity);
+        if (this.current === 'stopped')
+            throw commandError('unavailable');
+        if (this.current === 'blocked' && request.params.mode === 'force' && this.blockedRecord?.recoverable) {
+            let retryable = false;
+            try {
+                retryable = this.options.canRetry?.() ?? false;
+            }
+            catch { }
+            if (!retryable)
+                this.blockedRecord = { ...this.blockedRecord, recoverable: false };
+        }
+        if (this.current === 'blocked' && (request.params.mode !== 'force' || !this.blockedRecord?.recoverable))
+            throw this.blockedError();
+        if (this.completing)
+            throw commandError('busy');
+        const action = request.op === 'host.stop' ? 'stop' : 'restart';
+        if (this.current === 'draining' && this.pending && (this.pending.action !== action || this.pending.mode === 'force' && request.params.mode !== 'force'))
+            throw commandError('busy');
+        command.dispatch(() => {
+            try {
+                this.options.beginDrain();
+            }
+            catch (error) {
+                this.block(error, 'begin-drain');
+                throw error;
+            }
+            if (this.current === 'draining' && this.pending?.action === action && this.pending.mode === request.params.mode)
+                return;
+            this.pending?.abort.abort();
+            this.pending = { id: request.id, action, mode: request.params.mode, generation: ++this.generation, abort: new AbortController() };
+            this.setState('draining');
+            try {
+                this.options.record?.(action === 'stop' ? 'stop_requested' : 'restart_requested');
+            }
+            catch (error) {
+                this.block(error, 'begin-drain');
+                throw error;
+            }
+        });
+        return { response: accepted(request, { state: this.current }) };
+    }
+    afterResponse(id, accepted = true) {
+        const pending = this.pending;
+        if (this.current !== 'draining' || !pending || pending.id !== id)
+            return;
+        if (!accepted) {
+            if (!this.resume())
+                this.block(new Error('Management outcome could not be committed.'), 'management-response');
+            return;
+        }
+        this.pending = { ...pending, id: '' };
+        void this.finish(pending);
+    }
+    async finish(pending) {
+        let releasing = false;
+        try {
+            await this.settle(pending);
+            if (pending.generation !== this.generation || this.current !== 'draining')
+                return;
+            releasing = true;
+            this.completing = true;
+            this.options.record?.('releasing');
+            await this.options.complete(pending.action);
+            this.setState('stopped');
+        }
+        catch (error) {
+            if (pending.generation !== this.generation)
+                return;
+            this.completing = false;
+            // A drain can reopen admission only before registry shutdown has made resumption unsafe.
+            if (!releasing && pending.mode === 'drain' && this.resume())
+                return;
+            this.block(error, releasing ? 'release' : 'settlement', !releasing && !(error instanceof ShutdownError && error.step === 'settlement-deadline'));
+        }
+    }
+    resume() {
+        this.pending?.abort.abort();
+        try {
+            this.options.endDrain();
+        }
+        catch {
+            return false;
+        }
+        this.generation++;
+        this.pending = undefined;
+        this.setState('ready');
+        try {
+            this.options.record?.('drain_cancelled');
+        }
+        catch { /* The daemon keeps serving even if diagnostics fail. */ }
+        return true;
+    }
+    async settle(pending) {
+        let timer;
+        try {
+            await Promise.race([Promise.resolve().then(() => this.options.settle(pending.mode, pending.abort.signal)), new Promise((_resolve, reject) => {
+                    timer = setTimeout(() => { pending.abort.abort(); reject(new ShutdownError('settlement-deadline', new Error('Settlement deadline exceeded.'))); }, this.timeout);
+                })]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    setState(state) { this.current = state; if (state !== 'blocked')
+        this.blockedRecord = undefined; }
+}
+/** A blocked daemon answers SIGTERM with a drain request, which it refuses, so only a forced termination ends it. */
+function forceTermination(pid) {
+    return `${pid} (${process.platform === 'win32' ? `taskkill /F /PID ${pid}` : `kill -9 ${pid}`})`;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/daemon/lifecycle.js.map

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

package/dist/daemon/main.d.ts

@@ -0,0 +1,3 @@
+import type { HostManager } from './host-config.js';
+export declare function runDaemonProcess(args: readonly string[], manager?: HostManager): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/daemon/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/daemon/main.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCpG"}