@stratusagent/cli 0.2.2 → 0.3.0

package/dist/logs.d.ts

@@ -0,0 +1,123 @@
+/**
+ * One line of `~/.stratus/logs/stratusd.jsonl`. Structured rather than
+ * pretty-printed because the interesting questions are filters — what did
+ * this agent do, what happened in this session — and a whole roster
+ * answering at once makes an unattributed stream unreadable.
+ */
+export interface LogRecord {
+    /** ISO-8601, always UTC. */
+    ts: string;
+    level: 'info' | 'warn' | 'event';
+    /** Event type for level 'event'; absent for daemon lines. */
+    event?: string;
+    /** Human-readable line for level 'info' and 'warn'. */
+    msg?: string;
+    agentId?: string;
+    sessionId?: string;
+    /** Event-specific fields: tool name, status, part count, error text. */
+    detail?: Record<string, unknown>;
+}
+export declare const LOG_FILENAME = "stratusd.jsonl";
+/** Rotate past this size. Small enough to stay greppable, large enough to hold a busy day. */
+export declare const LOG_MAX_BYTES: number;
+/** Rotated generations kept beside the live file. */
+export declare const LOG_KEEP = 3;
+export interface LogWriter {
+    write(record: LogRecord): Promise<void>;
+    /**
+     * Resolves once every queued write has reached disk. Callers on the hot
+     * path drop the promise `write` returns, so a process that exits without
+     * flushing loses whatever is still queued — which is exactly the last
+     * few lines, the ones saying why it stopped.
+     */
+    flush(): Promise<void>;
+    /** Absolute path of the live log file. */
+    readonly path: string;
+}
+/**
+ * Files a service manager redirects the daemon's stdout/stderr into. They
+ * are plain files it holds open with no rotation of its own, so they grow
+ * for the life of the daemon — and everything in them is already in this
+ * log, which does rotate. Truncated alongside a rotation rather than
+ * deleted: launchd and systemd keep writing to the same open descriptor.
+ */
+export declare const REDIRECT_LOG_FILENAMES: string[];
+/**
+ * Truncate the manager's redirect files if they have grown past `maxBytes`.
+ *
+ * Called on rotation AND on its own schedule, because the two can come
+ * apart: a daemon crash-looping at startup, or one whose structured
+ * logging is itself failing, produces launchd diagnostics without ever
+ * producing enough records to rotate the JSONL. Tying this to rotation
+ * alone would leave exactly that case unbounded.
+ */
+export declare const truncateRedirectLogs: (dir: string, maxBytes?: number) => Promise<void>;
+export interface LogWriterOptions {
+    dir: string;
+    maxBytes?: number;
+    keep?: number;
+    /** Reports a logging failure without taking the daemon down with it. */
+    onError?: (error: unknown) => void;
+}
+/**
+ * Appends JSONL, rotating by size. Writes are serialized through a promise
+ * chain: concurrent turns emit events from independent async contexts, and
+ * interleaved appends would split lines down the middle.
+ */
+export declare const createLogWriter: (options: LogWriterOptions) => LogWriter;
+export interface LogFilter {
+    agentId?: string;
+    sessionId?: string;
+}
+export declare const matchesFilter: (record: LogRecord, filter: LogFilter) => boolean;
+/** Malformed lines are skipped: a torn final line must not end the read. */
+export declare const parseLogLines: (chunk: string) => LogRecord[];
+/**
+ * The most recent `limit` records, oldest first, reaching back through
+ * rotated generations when the live file is short — a rotation must not
+ * make `stratus logs` look like the daemon just started.
+ */
+export declare const readRecentRecords: (dir: string, limit: number, filter?: LogFilter, 
+/**
+ * Stop where a follower will resume. The bound is an offset INTO A
+ * SPECIFIC FILE: if the log rotated between capturing it and reading
+ * here, applying the offset to the replacement would truncate the wrong
+ * file and re-read the whole of the old one, duplicating everything past
+ * the cutoff. Matching by inode puts the bound back on the right file.
+ */
+until?: LogPosition) => Promise<LogRecord[]>;
+/**
+ * Where a follower should resume from: a byte offset AND the identity of
+ * the file it refers to. The offset alone is meaningless after a rotation,
+ * because the bytes it counted are in a different file by then.
+ */
+export interface LogPosition {
+    offset: number;
+    /** inode of the live file; undefined when there is no file yet. */
+    ino?: number;
+}
+export declare const currentLogPosition: (dir: string) => Promise<LogPosition>;
+export interface TailOptions {
+    dir: string;
+    filter?: LogFilter;
+    /** Poll interval; the daemon writes from another process, so there is nothing to await. */
+    intervalMs?: number;
+    signal?: AbortSignal;
+    /**
+     * Where to resume. Callers that print a backlog first must capture this
+     * BEFORE reading it (`currentLogPosition`), or records written in between
+     * are in neither the backlog nor the stream — and the file identity has
+     * to travel with the offset, or a rotation in that same window makes the
+     * offset point into the wrong file.
+     */
+    startPosition?: LogPosition;
+    onRecord: (record: LogRecord) => void;
+}
+/**
+ * Follows the live log from its current end. Polls rather than watching:
+ * fs.watch semantics differ across platforms and miss rotation, and a
+ * rotation mid-tail is exactly when you are reading the log.
+ */
+export declare const tailLog: (options: TailOptions) => Promise<void>;
+export declare const formatLogRecord: (record: LogRecord) => string;
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,8FAA8F;AAC9F,eAAO,MAAM,aAAa,QAAkB,CAAC;AAC7C,qDAAqD;AACrD,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,UAA2C,CAAC;AAE/E;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAU,KAAK,MAAM,EAAE,iBAAwB,KAAG,OAAO,CAAC,IAAI,CAW9F,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAID;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SA6D3D,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,EAAE,QAAQ,SAAS,KAAG,OAQpE,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,SAAS,EAiBtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,MAAM,EACX,OAAO,MAAM,EACb,SAAQ,SAAc;AACtB;;;;;;GAMG;AACH,QAAQ,WAAW,KAClB,OAAO,CAAC,SAAS,EAAE,CAkErB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,WAAW,CAGzC,CAAC;AAuBlC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;CACvC;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAU,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAwFhE,CAAC;AAaF,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,KAAG,MAmBnD,CAAC"}

package/dist/logs.js

@@ -0,0 +1,358 @@
+import { appendFile, chmod, mkdir, open, readdir, rename, stat, unlink } from 'node:fs/promises';
+import path from 'node:path';
+export const LOG_FILENAME = 'stratusd.jsonl';
+/** Rotate past this size. Small enough to stay greppable, large enough to hold a busy day. */
+export const LOG_MAX_BYTES = 8 * 1024 * 1024;
+/** Rotated generations kept beside the live file. */
+export const LOG_KEEP = 3;
+/**
+ * Files a service manager redirects the daemon's stdout/stderr into. They
+ * are plain files it holds open with no rotation of its own, so they grow
+ * for the life of the daemon — and everything in them is already in this
+ * log, which does rotate. Truncated alongside a rotation rather than
+ * deleted: launchd and systemd keep writing to the same open descriptor.
+ */
+export const REDIRECT_LOG_FILENAMES = ['stratusd.out.log', 'stratusd.err.log'];
+/**
+ * Truncate the manager's redirect files if they have grown past `maxBytes`.
+ *
+ * Called on rotation AND on its own schedule, because the two can come
+ * apart: a daemon crash-looping at startup, or one whose structured
+ * logging is itself failing, produces launchd diagnostics without ever
+ * producing enough records to rotate the JSONL. Tying this to rotation
+ * alone would leave exactly that case unbounded.
+ */
+export const truncateRedirectLogs = async (dir, maxBytes = LOG_MAX_BYTES) => {
+    const { truncate } = await import('node:fs/promises');
+    for (const name of REDIRECT_LOG_FILENAMES) {
+        const target = path.join(dir, name);
+        const size = await stat(target).then((info) => info.size).catch(() => 0);
+        if (size >= maxBytes) {
+            // O_APPEND writers resume at the new end, so the daemon keeps
+            // logging; only the duplicate history goes.
+            await truncate(target, 0).catch(() => undefined);
+        }
+    }
+};
+const rotatedName = (index) => `${LOG_FILENAME}.${index}`;
+/**
+ * Appends JSONL, rotating by size. Writes are serialized through a promise
+ * chain: concurrent turns emit events from independent async contexts, and
+ * interleaved appends would split lines down the middle.
+ */
+export const createLogWriter = (options) => {
+    const maxBytes = options.maxBytes ?? LOG_MAX_BYTES;
+    const keep = options.keep ?? LOG_KEEP;
+    const logPath = path.join(options.dir, LOG_FILENAME);
+    let queue = Promise.resolve();
+    let ensured = false;
+    const rotate = async () => {
+        await truncateRedirectLogs(options.dir, maxBytes);
+        // Oldest first, so each generation moves into a free slot.
+        for (let index = keep; index >= 1; index -= 1) {
+            const from = path.join(options.dir, index === 1 ? LOG_FILENAME : rotatedName(index - 1));
+            const to = path.join(options.dir, rotatedName(index));
+            if (index === keep) {
+                await unlink(to).catch(() => undefined);
+            }
+            await rename(from, to).catch((error) => {
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            });
+        }
+    };
+    const append = async (record) => {
+        if (!ensured) {
+            await mkdir(options.dir, { recursive: true, mode: 0o700 });
+            ensured = true;
+        }
+        const size = await stat(logPath).then((info) => info.size).catch(() => 0);
+        if (size >= maxBytes) {
+            await rotate();
+        }
+        // Sessions carry prompts and tool output, so the log is as sensitive
+        // as the transcript it describes. appendFile's mode applies only when
+        // it CREATES the file, so a log that already exists — from an older
+        // build, a restored backup, a different umask — would keep whatever
+        // permissions it had while the daemon kept writing to it.
+        await chmod(logPath, 0o600).catch((error) => {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        });
+        await appendFile(logPath, `${JSON.stringify(record)}\n`, { mode: 0o600 });
+    };
+    return {
+        path: logPath,
+        write(record) {
+            // A logging failure must never fail the turn that produced the line.
+            queue = queue.then(() => append(record)).catch((error) => {
+                options.onError?.(error);
+            });
+            return queue;
+        },
+        flush() {
+            // The chain already swallows its own errors through onError, so this
+            // settles rather than rejecting into a shutdown path.
+            return queue;
+        },
+    };
+};
+export const matchesFilter = (record, filter) => {
+    if (filter.agentId && record.agentId !== filter.agentId) {
+        return false;
+    }
+    if (filter.sessionId && record.sessionId !== filter.sessionId) {
+        return false;
+    }
+    return true;
+};
+/** Malformed lines are skipped: a torn final line must not end the read. */
+export const parseLogLines = (chunk) => {
+    const records = [];
+    for (const line of chunk.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed?.ts === 'string' && typeof parsed?.level === 'string') {
+                records.push(parsed);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return records;
+};
+/**
+ * The most recent `limit` records, oldest first, reaching back through
+ * rotated generations when the live file is short — a rotation must not
+ * make `stratus logs` look like the daemon just started.
+ */
+export const readRecentRecords = async (dir, limit, filter = {}, 
+/**
+ * Stop where a follower will resume. The bound is an offset INTO A
+ * SPECIFIC FILE: if the log rotated between capturing it and reading
+ * here, applying the offset to the replacement would truncate the wrong
+ * file and re-read the whole of the old one, duplicating everything past
+ * the cutoff. Matching by inode puts the bound back on the right file.
+ */
+until) => {
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    // Newest first: the live file, then .1, .2, …
+    const ordered = [
+        ...(names.includes(LOG_FILENAME) ? [LOG_FILENAME] : []),
+        ...names
+            .filter((name) => name.startsWith(`${LOG_FILENAME}.`))
+            .sort((left, right) => Number(left.split('.').pop()) - Number(right.split('.').pop())),
+    ];
+    // slice(-0) is slice(0), which would return everything — the opposite of
+    // what `-n 0` asks for, and `-n 0 -f` is the ordinary way to follow
+    // without replaying the file.
+    if (limit === 0) {
+        return [];
+    }
+    const collected = [];
+    const { readFile } = await import('node:fs/promises');
+    // Which file the cutoff belongs to now — the live one until a rotation
+    // moved it, and nothing at all once it has been evicted.
+    let boundedName;
+    if (until !== undefined) {
+        if (until.ino === undefined) {
+            boundedName = LOG_FILENAME;
+        }
+        else {
+            const liveIno = await stat(path.join(dir, LOG_FILENAME)).then((info) => info.ino).catch(() => undefined);
+            if (liveIno === until.ino) {
+                boundedName = LOG_FILENAME;
+            }
+            else {
+                const rotated = (await rotatedGenerations(dir)).find((entry) => entry.ino === until.ino);
+                boundedName = rotated ? path.basename(rotated.path) : undefined;
+            }
+        }
+    }
+    // Everything newer than the file the cutoff lives in is, by definition,
+    // after the cutoff — it belongs to the follower, not the backlog.
+    const scanned = until === undefined
+        ? ordered
+        : boundedName === undefined
+            // The cutoff's file has been evicted, so every retained generation
+            // was written after it.
+            ? []
+            : ordered.slice(ordered.indexOf(boundedName));
+    for (const name of scanned) {
+        const raw = await readFile(path.join(dir, name)).catch(() => Buffer.alloc(0));
+        // Sliced as bytes, not characters: the offset a follower resumes from
+        // is a byte count, and a multi-byte character would shift the seam.
+        const contents = (until !== undefined && name === boundedName
+            ? raw.subarray(0, until.offset)
+            : raw).toString('utf8');
+        const matching = parseLogLines(contents).filter((record) => matchesFilter(record, filter));
+        collected.unshift(...matching);
+        if (collected.length >= limit) {
+            break;
+        }
+    }
+    return collected.slice(-limit);
+};
+export const currentLogPosition = async (dir) => stat(path.join(dir, LOG_FILENAME))
+    .then((info) => ({ offset: info.size, ino: info.ino }))
+    .catch(() => ({ offset: 0 }));
+/** Rotated generations present on disk, newest first, with their inodes. */
+const rotatedGenerations = async (dir) => {
+    const names = await readdir(dir).catch(() => []);
+    const entries = [];
+    for (const name of names) {
+        if (!name.startsWith(`${LOG_FILENAME}.`)) {
+            continue;
+        }
+        const index = Number(name.slice(LOG_FILENAME.length + 1));
+        if (!Number.isInteger(index) || index < 1) {
+            continue;
+        }
+        const full = path.join(dir, name);
+        const ino = await stat(full).then((info) => info.ino).catch(() => undefined);
+        if (ino !== undefined) {
+            entries.push({ index, path: full, ino });
+        }
+    }
+    return entries.sort((left, right) => left.index - right.index);
+};
+/**
+ * Follows the live log from its current end. Polls rather than watching:
+ * fs.watch semantics differ across platforms and miss rotation, and a
+ * rotation mid-tail is exactly when you are reading the log.
+ */
+export const tailLog = async (options) => {
+    const intervalMs = options.intervalMs ?? 400;
+    const filter = options.filter ?? {};
+    const logPath = path.join(options.dir, LOG_FILENAME);
+    const start = options.startPosition ?? await currentLogPosition(options.dir);
+    let offset = start.offset;
+    let carry = '';
+    // Rotation is a file-identity change, not a size change. A burst can
+    // rotate and grow the replacement past the old offset before the next
+    // poll, and a size comparison reads that as "the file just grew" —
+    // skipping the replacement's prefix and never draining what moved to .1.
+    let liveIno = start.ino;
+    /** Reads from `from` to EOF, emitting whole lines. Returns the new offset. */
+    const drain = async (target, from) => {
+        const handle = await open(target, 'r').catch(() => undefined);
+        if (!handle) {
+            return from;
+        }
+        try {
+            const size = await handle.stat().then((info) => info.size);
+            if (size <= from) {
+                return from;
+            }
+            const length = size - from;
+            const buffer = Buffer.alloc(length);
+            const { bytesRead } = await handle.read(buffer, 0, length, from);
+            const text = carry + buffer.subarray(0, bytesRead).toString('utf8');
+            // A partial trailing line is held back until its newline lands.
+            const lastBreak = text.lastIndexOf('\n');
+            carry = lastBreak >= 0 ? text.slice(lastBreak + 1) : text;
+            for (const record of parseLogLines(lastBreak >= 0 ? text.slice(0, lastBreak) : '')) {
+                if (matchesFilter(record, filter)) {
+                    options.onRecord(record);
+                }
+            }
+            return from + bytesRead;
+        }
+        finally {
+            await handle.close();
+        }
+    };
+    while (!options.signal?.aborted) {
+        const info = await stat(logPath).catch(() => undefined);
+        if (info) {
+            if (liveIno !== undefined && info.ino !== liveIno) {
+                // The file we were reading has been rotated away. It is not
+                // necessarily .1: several rotations can happen between polls under
+                // a burst, in which case it is .2 or later and every generation
+                // newer than it is a complete file we never saw at all. Find it by
+                // inode, drain the rest of it, then walk forward through the
+                // generations it was pushed past — anything less loses whole
+                // files, and draining by position instead of identity would replay
+                // records rather than recover them.
+                const generations = await rotatedGenerations(options.dir);
+                const previous = generations.find((entry) => entry.ino === liveIno);
+                if (previous) {
+                    await drain(previous.path, offset).catch(() => offset);
+                    carry = '';
+                    for (const entry of generations.filter((candidate) => candidate.index < previous.index).reverse()) {
+                        await drain(entry.path, 0).catch(() => 0);
+                        carry = '';
+                    }
+                }
+                offset = 0;
+                carry = '';
+            }
+            liveIno = info.ino;
+            offset = await drain(logPath, offset);
+        }
+        if (options.signal?.aborted) {
+            return;
+        }
+        await new Promise((resolve) => {
+            // Both paths detach the listener: {once:true} only fires on abort, so
+            // a poll loop running for days would otherwise retain one closure per
+            // tick — roughly 216,000 a day at the default interval.
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                options.signal?.removeEventListener('abort', onAbort);
+                resolve();
+            }, intervalMs);
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+};
+/** `14:32:07  ava  tool.called memory.remember` — time, who, what. */
+const formatDetail = (detail) => {
+    if (detail === undefined || detail === null) {
+        return '';
+    }
+    if (typeof detail !== 'object') {
+        return String(detail);
+    }
+    return Object.entries(detail).map(([key, value]) => `${key}=${String(value)}`).join(' ');
+};
+export const formatLogRecord = (record) => {
+    const time = record.ts.slice(11, 19);
+    const who = (record.agentId ?? '—').padEnd(12);
+    if (record.level === 'event') {
+        // Records are parsed from a file, not handed over in-process: a
+        // hand-edited line or one written by another version can carry a
+        // string where this version writes an object, and spreading that
+        // into entries renders a word one character per pair.
+        const detail = formatDetail(record.detail);
+        // The whole session id, never a prefix of it. A channel id is
+        // `channel:agent:team:conversation[:thread]`, so eight characters of
+        // one is `slack:av` — the same string for every Slack conversation on
+        // the machine. This is also the column you copy into `stratus logs
+        // --session`, which matches on equality, so a prefix finds nothing.
+        const session = record.sessionId ? ` [${record.sessionId}]` : '';
+        return `${time}  ${who}${record.event ?? 'event'}${detail ? ` ${detail}` : ''}${session}`;
+    }
+    const prefix = record.level === 'warn' ? 'warning: ' : '';
+    return `${time}  ${who}${prefix}${record.msg ?? ''}`;
+};
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Running `stratus serve` as a managed service.
+ *
+ * `serve` itself stays a plain foreground process — debuggable, drains on
+ * SIGTERM, composes with any supervisor. Everything about surviving logout,
+ * crashes, and reboots belongs here, in the platform's own service manager,
+ * rather than in a hand-rolled daemonizer.
+ */
+export type ServicePlatform = 'launchd' | 'systemd';
+/** Reverse-DNS on macOS, a plain unit name on Linux. */
+export declare const SERVICE_LABEL = "com.stratusagent.stratusd";
+export declare const SYSTEMD_UNIT = "stratusd.service";
+export interface ServiceCommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/** Runs a service-manager command. Injectable so tests never touch launchctl. */
+export type ServiceRunner = (command: string, args: string[]) => Promise<ServiceCommandResult>;
+export interface ServiceEnvironment {
+    platform?: NodeJS.Platform;
+    homeDir?: string;
+    /** Directory the install ran from; becomes the unit's working directory. */
+    cwd?: string;
+    /** Absolute path of the node binary that should run the daemon. */
+    execPath?: string;
+    /** Absolute path of the CLI entrypoint (bin.js). */
+    scriptPath?: string;
+    /** Node flags the entrypoint needs. Defaults to this process's own. */
+    execArgv?: string[];
+    /** User id, for launchctl's `gui/<uid>` domain. */
+    uid?: number;
+    run?: ServiceRunner;
+}
+export declare const servicePlatform: (env?: ServiceEnvironment) => ServicePlatform | undefined;
+export declare const serviceUnitPath: (env?: ServiceEnvironment) => string;
+export interface ServiceDefinition {
+    /** node, then the CLI entrypoint, then the subcommand. */
+    argv: string[];
+    logDir: string;
+    workingDirectory: string;
+    /** Start automatically when the user logs in. */
+    runAtLogin: boolean;
+}
+export interface ServiceInstallOptions {
+    runAtLogin?: boolean;
+    /**
+     * Config the daemon should load, absolute. The unit runs from the home
+     * directory, so a relative path — or none, when setup wrote somewhere
+     * other than the discovered location — would start the daemon on a
+     * different config than the one just saved, with a different roster.
+     */
+    configPath?: string;
+}
+export declare const launchdPlist: (definition: ServiceDefinition) => string;
+export declare const systemdUnit: (definition: ServiceDefinition) => string;
+export declare const serviceDefinition: (env: ServiceEnvironment, runAtLogin: boolean, configPath?: string) => ServiceDefinition;
+/** A service command that has not answered by now is not going to. */
+export declare const SERVICE_COMMAND_TIMEOUT_MS = 15000;
+export interface ServiceStatus {
+    platform: ServicePlatform;
+    /** A unit file exists on disk. */
+    installed: boolean;
+    /** The service manager reports it running. */
+    running: boolean;
+    /** Starts automatically at login; undefined when the manager could not say. */
+    runAtLogin: boolean | undefined;
+    unitPath: string;
+    /** Present when the platform's status command failed outright. */
+    detail?: string;
+}
+export declare const readServiceStatus: (env?: ServiceEnvironment) => Promise<ServiceStatus | undefined>;
+export interface ServiceActionResult {
+    ok: boolean;
+    /** Lines to show the user, in order. */
+    messages: string[];
+}
+export declare const installService: (env?: ServiceEnvironment, options?: ServiceInstallOptions) => Promise<ServiceActionResult>;
+export declare const uninstallService: (env?: ServiceEnvironment) => Promise<ServiceActionResult>;
+export declare const startService: (env?: ServiceEnvironment) => Promise<ServiceActionResult>;
+export declare const stopService: (env?: ServiceEnvironment) => Promise<ServiceActionResult>;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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