t3-discord-presence 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 f3tch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# t3-discord-presence
+
+`t3-discord-presence` is a small background daemon that shows current T3 Code agent activity as Discord Rich Presence. It starts at user login, waits quietly while T3 Code or Discord is closed, and reconnects when either application returns.
+
+It does not modify or inject into T3 Code, inspect the screen, or read process memory. It discovers T3 Code's loopback server, authenticates through T3's supported pairing flow with read-only access, subscribes to the local state API, reduces that state to privacy-safe labels, and sends the result to the Discord desktop application's local RPC interface.
+
+## Requirements
+
+- Node.js 22 or newer. The Node.js 22 and 24 LTS lines are tested in CI.
+- T3 Code Desktop. For first-time authorization, the app automatically uses the CLI bundled with the verified Desktop installation, then falls back to a supported global `t3` command.
+- Discord Desktop running whenever you want Rich Presence to appear. Discord in a browser is not sufficient.
+- Windows, macOS, or Linux. Startup is installed for the current user and does not require root or administrator access under normal conditions.
+
+## Install
+
+Install the package globally, then run it once:
+
+```sh
+npm install -g t3-discord-presence
+t3-discord-presence
+```
+
+That is the complete setup. The package includes the public Discord Application ID `1539247632227246150`, so there is no Discord Developer Portal setup, client-ID environment variable, bot token, or client secret to configure.
+
+Running `t3-discord-presence` without a command is idempotent. It installs or repairs startup for the current user, attempts initial authorization when T3 Code is open, and ensures the daemon is running. Repeating it does not create another startup registration or daemon process. The explicit `t3-discord-presence install` command performs the same setup and remains available for scripts.
+
+If T3 Code is closed during setup, the command still succeeds. The daemon starts in the background, waits quietly, and automatically connects when T3 Code and Discord Desktop become available. Open T3 Code and run `t3-discord-presence auth` later if authorization is still pending.
+
+After the first run, it starts automatically when you log in, waits quietly for T3 Code, updates Discord Rich Presence when T3 is active, clears the presence when T3 closes, and reconnects whenever T3 Code or Discord Desktop returns.
+
+The generated `config.json` contains optional privacy and image settings only. For example, project names and thread titles can be hidden or shown without changing the built-in Discord application:
+
+```json
+{
+    "presence": {
+        "showProject": true,
+        "showThread": false,
+        "showModel": true,
+        "showProvider": true,
+        "showElapsedTime": true
+    },
+    "discord": {}
+}
+```
+
+## Authentication
+
+To authorize explicitly, open T3 Code and run:
+
+```sh
+t3-discord-presence auth
+```
+
+The command asks the official local T3 CLI for a short-lived pairing credential, preferring the verified T3 Desktop installation and falling back to a supported global CLI. It exchanges that credential with the verified local T3 server and requests only the `orchestration:read` scope. The resulting access credential is stored per T3 environment in the operating-system credential store when available. A current-user-only app state file is used as a restrictive fallback.
+
+If automatic pairing is unavailable, `auth` can prompt in an interactive terminal for the `Token` produced by `t3 pair --label "t3 discord presence"`. Input is hidden. That one-time pairing value is exchanged immediately and is never persisted; only the scoped bearer credential is stored. The login daemon never prompts for input.
+
+Pairing credentials and WebSocket tickets are short-lived and are not persisted. Access credentials are never printed, logged, or sent to Discord. When a credential expires or is rejected, run `auth` again.
+
+## Daily use
+
+The login daemon should require no attention. These commands are available when needed:
+
+```sh
+t3-discord-presence status
+t3-discord-presence start
+t3-discord-presence stop
+t3-discord-presence restart
+t3-discord-presence doctor
+t3-discord-presence logs
+```
+
+`status` reports startup registration, daemon, T3, Discord, and authorization state without revealing secrets. `doctor` checks the local prerequisites and explains common setup failures. `logs` prints the path to the bounded, rotated JSONL daemon log.
+
+Running in the foreground is useful while diagnosing a changing T3 protocol:
+
+```sh
+t3-discord-presence run --debug
+```
+
+Debug logging includes safe event classifications and connection state, not raw payloads or private content.
+
+## Background startup
+
+- **Windows:** installs a current-user Task Scheduler task triggered at logon. It launches the exact Node executable and installed CLI through a hidden launcher. If Task Scheduler registration is unavailable, it falls back to a launcher in the current user's Startup folder.
+- **macOS:** installs `~/Library/LaunchAgents/com.f3tchcodes.t3-discord-presence.plist` and loads it with modern `launchctl` user-domain commands. Recent macOS versions may show it under Login Items / Allow in the Background; allow it there if macOS disables it.
+- **Linux:** installs and enables a `systemd --user` service. If a user systemd manager is unavailable, it falls back to an XDG autostart desktop entry.
+
+All mechanisms run the actual globally installed Node executable and compiled entry point rather than relying on an interactive shell's `PATH`.
+
+After updating the global package, run the command again so it can repair a registration whose installed path changed:
+
+```sh
+npm update -g t3-discord-presence
+t3-discord-presence
+```
+
+## Privacy
+
+The default Discord activity can include the project name, model, provider, elapsed time, a coarse activity label, and a deterministic active-agent count. Thread titles are hidden by default. Set any of the five `presence` options in the config example to `false` to hide that field; in particular, set `showProject` to `false` to hide project names.
+
+The daemon never persists or publishes to Discord:
+
+- raw prompts, chat messages, or response text;
+- raw commands, terminal output, or tool arguments;
+- file contents, patches, or diffs;
+- workspace roots, current working directories, or other absolute paths;
+- full T3 activities, thread objects, or raw RPC payloads.
+
+Activities are mapped to a small allowlist such as `editing code`, `thinking`, `running commands`, or `waiting for input`; unknown activities become a generic label. Authentication secrets are the one intentional private value retained for reconnects: access credentials are kept in the OS credential store or restricted fallback file, but never included in presence, status output, or logs. Logs are size-bounded, rotated, and redact secret-shaped values and sensitive metadata.
+
+There is no screen capture, process-memory inspection, T3 database scraping, or intermediary service operated by this project. Network communication is limited to T3's authenticated loopback backend and the local Discord RPC client; Discord itself receives only the filtered presence fields described above.
+
+## Uninstall
+
+Stop the daemon and remove only this application's startup registration:
+
+```sh
+t3-discord-presence uninstall
+```
+
+Normal uninstall preserves this app's config and stored authorization so reinstalling does not require setup again. To also remove this app's config, credentials, logs, and transient state, use:
+
+```sh
+t3-discord-presence uninstall --purge
+```
+
+Neither form removes or changes T3 Code data. `--purge` applies only to `t3-discord-presence` files and credentials. It removes fallback-file credentials plus operating-system credential entries for currently known T3 environments. Because operating-system keyrings do not provide a portable way to enumerate a service's historical entries, an entry for an old environment that is no longer present in app state or discoverable may need to be removed through the OS credential manager.
+
+## Troubleshooting
+
+Start with:
+
+```sh
+t3-discord-presence status
+t3-discord-presence doctor
+t3-discord-presence logs
+```
+
+- **Discord is waiting or disconnected:** start Discord Desktop and sign in. The daemon retries automatically. Optional invalid image keys are retried without images, so they cannot prevent presence updates.
+- **T3 is waiting:** open T3 Code. Stale runtime files and servers whose PID, origin, or environment descriptor cannot be verified are deliberately ignored. For a nonstandard development installation, set `T3CODE_HOME` to the relevant T3 base directory before starting the daemon.
+- **Authorization is required:** ensure T3 Code is open, then run `t3-discord-presence auth`. It checks T3 Desktop's bundled CLI and then a supported global `t3` command automatically. If neither can pair automatically, run `t3 pair --label "t3 discord presence"` and paste its `Token` into the hidden prompt. Run `restart` afterward if the daemon does not reconnect immediately.
+- **Presence looks stale:** `restart` safely replaces the one daemon instance and republishes current state. Rapid T3 events are deliberately debounced.
+- **Startup does not run after login:** rerun `t3-discord-presence`, inspect `doctor`, and check the platform-specific login mechanism described above. On macOS, also check Allow in the Background.
+
+Do not post the contents of credential files when opening an issue. Status and redacted logs are the appropriate diagnostics.
+
+## Development
+
+```sh
+npm ci
+npm run check
+npm run build
+npm run dev
+```
+
+`npm run check` runs ESLint, TypeScript type checking, and the unit test suite. Unit tests use mocks and pure startup renderers; they do not install login services or require T3 Code or Discord.
+
+Read-only integration tests are explicitly gated because they connect to a real local T3 environment. They never send agent commands or modify projects or threads. On macOS/Linux:
+
+```sh
+T3_DISCORD_PRESENCE_INTEGRATION=1 npm run test:integration
+```
+
+In PowerShell:
+
+```powershell
+$env:T3_DISCORD_PRESENCE_INTEGRATION="1"; npm run test:integration
+```
+
+Normal CI runs only `npm ci`, `npm run check`, and `npm run build`; it needs neither T3 Code nor Discord and does not publish packages.
+
+## License
+
+MIT

package/dist/cli/diagnostics.d.ts

@@ -0,0 +1,10 @@
+export interface DiscordIpcDependencies {
+    readonly isSocket: (filePath: string) => Promise<boolean>;
+}
+export declare function discordIpcAvailable(options?: {
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly platform?: NodeJS.Platform;
+    readonly dependencies?: Partial<DiscordIpcDependencies>;
+}): Promise<boolean | undefined>;
+export declare function supportedNodeVersion(version: string): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/cli/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAgCD,wBAAsB,mBAAmB,CACrC,OAAO,GAAE;IACL,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtD,GACP,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAkB9B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D"}

package/dist/cli/diagnostics.js

@@ -0,0 +1,52 @@
+import { stat } from "node:fs/promises";
+import { posix } from "node:path";
+const nodeDependencies = {
+    async isSocket(filePath) {
+        try {
+            return (await stat(filePath)).isSocket();
+        }
+        catch {
+            return false;
+        }
+    },
+};
+function nonEmpty(value) {
+    const trimmed = value?.trim();
+    return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;
+}
+function unixSocketRoots(environment, platform) {
+    const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
+    return [...new Set([
+            nonEmpty(environment.XDG_RUNTIME_DIR),
+            nonEmpty(environment.TMPDIR),
+            nonEmpty(environment.TMP),
+            nonEmpty(environment.TEMP),
+            platform === "linux" && uid !== undefined ? `/run/user/${String(uid)}` : undefined,
+            "/tmp",
+        ].filter((value) => value !== undefined && posix.isAbsolute(value)))];
+}
+export async function discordIpcAvailable(options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform === "win32") {
+        // probing a windows named pipe requires connecting to it, which would interfere with discord rpc.
+        return undefined;
+    }
+    const environment = options.environment ?? process.env;
+    const dependencies = { ...nodeDependencies, ...options.dependencies };
+    const subdirectories = ["", "app/com.discordapp.Discord", "snap.discord"];
+    for (const root of unixSocketRoots(environment, platform)) {
+        for (const subdirectory of subdirectories) {
+            for (let index = 0; index < 10; index += 1) {
+                const socket = posix.join(root, subdirectory, `discord-ipc-${String(index)}`);
+                if (await dependencies.isSocket(socket))
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+export function supportedNodeVersion(version) {
+    const match = /^v?(\d+)\./.exec(version);
+    return match !== null && Number(match[1]) >= 22;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/cli/diagnostics.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+export declare const commandNames: readonly ["install", "uninstall", "start", "stop", "restart", "status", "auth", "doctor", "logs", "run"];
+export declare const helpText = "t3-discord-presence\n\nDiscord Rich Presence for T3 Code agent activity.\n\nusage:\n  t3-discord-presence [command] [options]\n\nRun without a command for first-time setup or to repair login startup and ensure the daemon is running.\n\ncommands:\n  install      explicitly run the same idempotent first-time setup\n  uninstall    stop the daemon and remove login startup\n  start        start the background daemon\n  stop         stop the background daemon\n  restart      restart the background daemon\n  status       show daemon and connection status\n  auth         authorize against the local T3 environment\n  doctor       check the local setup\n  logs         print the log file location\n  run          run in the foreground (add --debug for diagnostics)\n\ninternal:\n  daemon       login-service entrypoint; not needed for normal use\n\noptions:\n  --purge      with uninstall, also remove this app's config and credentials\n  --debug      with run, enable privacy-safe debug logging\n  -h, --help   show help\n  -v, --version show the installed version\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,0GAWf,CAAC;AAEX,eAAO,MAAM,QAAQ,8iCA6BpB,CAAC"}

package/dist/cli/help.js

@@ -0,0 +1,43 @@
+export const commandNames = [
+    "install",
+    "uninstall",
+    "start",
+    "stop",
+    "restart",
+    "status",
+    "auth",
+    "doctor",
+    "logs",
+    "run",
+];
+export const helpText = `t3-discord-presence
+
+Discord Rich Presence for T3 Code agent activity.
+
+usage:
+  t3-discord-presence [command] [options]
+
+Run without a command for first-time setup or to repair login startup and ensure the daemon is running.
+
+commands:
+  install      explicitly run the same idempotent first-time setup
+  uninstall    stop the daemon and remove login startup
+  start        start the background daemon
+  stop         stop the background daemon
+  restart      restart the background daemon
+  status       show daemon and connection status
+  auth         authorize against the local T3 environment
+  doctor       check the local setup
+  logs         print the log file location
+  run          run in the foreground (add --debug for diagnostics)
+
+internal:
+  daemon       login-service entrypoint; not needed for normal use
+
+options:
+  --purge      with uninstall, also remove this app's config and credentials
+  --debug      with run, enable privacy-safe debug logging
+  -h, --help   show help
+  -v, --version show the installed version
+`;
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,SAAS;IACT,WAAW;IACX,OAAO;IACP,MAAM;IACN,SAAS;IACT,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,MAAM;IACN,KAAK;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvB,CAAC"}

package/dist/cli/lifecycle.d.ts

@@ -0,0 +1,64 @@
+import type { AppPaths } from "../config/paths.js";
+import { type DaemonLockRecord } from "../daemon/lock.js";
+export interface DetachedSpawnOptions {
+    readonly detached: true;
+    readonly env: NodeJS.ProcessEnv;
+    readonly shell: false;
+    readonly stdio: "ignore";
+    readonly windowsHide: true;
+}
+export interface SpawnedDaemon {
+    readonly pid: number;
+}
+export interface DaemonProcessAdapter {
+    spawn(executable: string, arguments_: ReadonlyArray<string>, options: DetachedSpawnOptions): Promise<SpawnedDaemon>;
+}
+export declare const nodeDaemonProcessAdapter: DaemonProcessAdapter;
+export interface DaemonLifecycleDependencies {
+    readonly readLock: (filePath: string) => Promise<DaemonLockRecord | undefined>;
+    readonly requestStop: (lockFile: string, stopFile: string) => Promise<DaemonLockRecord | undefined>;
+    readonly isProcessRunning: (pid: number) => boolean;
+    readonly process: DaemonProcessAdapter;
+    readonly delay: (milliseconds: number) => Promise<void>;
+}
+export interface StartDaemonOptions {
+    readonly paths: AppPaths;
+    readonly cliEntrypoint: string;
+    readonly nodeExecutable?: string;
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly timeoutMs?: number;
+    readonly pollMs?: number;
+    readonly dependencies?: Partial<DaemonLifecycleDependencies>;
+}
+export interface StopDaemonOptions {
+    readonly paths: AppPaths;
+    readonly timeoutMs?: number;
+    readonly pollMs?: number;
+    readonly dependencies?: Partial<DaemonLifecycleDependencies>;
+}
+export interface DaemonInspection {
+    readonly running: boolean;
+    readonly record?: DaemonLockRecord;
+}
+export type StartDaemonResult = {
+    readonly outcome: "started";
+    readonly pid: number;
+} | {
+    readonly outcome: "already-running";
+    readonly pid: number;
+};
+export type StopDaemonResult = {
+    readonly outcome: "stopped";
+    readonly pid: number;
+} | {
+    readonly outcome: "already-stopped";
+} | {
+    readonly outcome: "timed-out";
+    readonly pid: number;
+};
+export declare function inspectDaemon(paths: Pick<AppPaths, "lockFile">, options?: {
+    readonly dependencies?: Partial<DaemonLifecycleDependencies>;
+}): Promise<DaemonInspection>;
+export declare function startDaemon(options: StartDaemonOptions): Promise<StartDaemonResult>;
+export declare function stopDaemon(options: StopDaemonOptions): Promise<StopDaemonResult>;
+//# sourceMappingURL=lifecycle.d.ts.map

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

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

package/dist/cli/lifecycle.js

@@ -0,0 +1,118 @@
+import { spawn } from "node:child_process";
+import { processIsRunning, readDaemonLock, requestDaemonStop, } from "../daemon/lock.js";
+const DEFAULT_POLL_MS = 100;
+const DEFAULT_START_TIMEOUT_MS = 10_000;
+const DEFAULT_STOP_TIMEOUT_MS = 20_000;
+export const nodeDaemonProcessAdapter = {
+    async spawn(executable, arguments_, options) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(executable, [...arguments_], options);
+            let settled = false;
+            child.once("error", error => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(error);
+            });
+            child.once("spawn", () => {
+                if (settled)
+                    return;
+                settled = true;
+                const { pid } = child;
+                if (pid === undefined) {
+                    reject(new Error("the daemon process did not receive a process id"));
+                    return;
+                }
+                child.unref();
+                resolve({ pid });
+            });
+        });
+    },
+};
+const defaultDependencies = {
+    readLock: readDaemonLock,
+    requestStop: requestDaemonStop,
+    isProcessRunning: processIsRunning,
+    process: nodeDaemonProcessAdapter,
+    delay: async (milliseconds) => new Promise(resolve => {
+        setTimeout(resolve, milliseconds);
+    }),
+};
+function dependenciesWithDefaults(dependencies) {
+    return { ...defaultDependencies, ...dependencies };
+}
+function positiveInteger(value, fallback, name) {
+    const resolved = value ?? fallback;
+    if (!Number.isSafeInteger(resolved) || resolved < 1) {
+        throw new RangeError(`${name} must be a positive safe integer`);
+    }
+    return resolved;
+}
+export async function inspectDaemon(paths, options = {}) {
+    const dependencies = dependenciesWithDefaults(options.dependencies);
+    const record = await dependencies.readLock(paths.lockFile);
+    if (record === undefined)
+        return { running: false };
+    // a stale heartbeat can be caused by sleep, suspension, or a debugger. a
+    // live owner is safer than briefly running two presence daemons at once.
+    const running = dependencies.isProcessRunning(record.pid);
+    return { running, record };
+}
+function pollCount(timeoutMs, pollMs) {
+    return Math.ceil(timeoutMs / pollMs) + 1;
+}
+export async function startDaemon(options) {
+    const dependencies = dependenciesWithDefaults(options.dependencies);
+    const timeoutMs = positiveInteger(options.timeoutMs, DEFAULT_START_TIMEOUT_MS, "timeoutMs");
+    const pollMs = positiveInteger(options.pollMs, DEFAULT_POLL_MS, "pollMs");
+    const existing = await inspectDaemon(options.paths, {
+        dependencies,
+    });
+    if (existing.running && existing.record !== undefined) {
+        return { outcome: "already-running", pid: existing.record.pid };
+    }
+    const child = await dependencies.process.spawn(options.nodeExecutable ?? process.execPath, [options.cliEntrypoint, "daemon"], {
+        detached: true,
+        env: { ...(options.environment ?? process.env) },
+        shell: false,
+        stdio: "ignore",
+        windowsHide: true,
+    });
+    for (let attempt = 0; attempt < pollCount(timeoutMs, pollMs); attempt += 1) {
+        const inspection = await inspectDaemon(options.paths, {
+            dependencies,
+        });
+        if (inspection.running && inspection.record !== undefined) {
+            return inspection.record.pid === child.pid
+                ? { outcome: "started", pid: child.pid }
+                : { outcome: "already-running", pid: inspection.record.pid };
+        }
+        if (attempt + 1 < pollCount(timeoutMs, pollMs)) {
+            await dependencies.delay(pollMs);
+        }
+    }
+    throw new Error("the daemon did not become ready before the startup timeout");
+}
+export async function stopDaemon(options) {
+    const dependencies = dependenciesWithDefaults(options.dependencies);
+    const timeoutMs = positiveInteger(options.timeoutMs, DEFAULT_STOP_TIMEOUT_MS, "timeoutMs");
+    const pollMs = positiveInteger(options.pollMs, DEFAULT_POLL_MS, "pollMs");
+    const existing = await dependencies.readLock(options.paths.lockFile);
+    if (existing === undefined || !dependencies.isProcessRunning(existing.pid)) {
+        return { outcome: "already-stopped" };
+    }
+    const target = await dependencies.requestStop(options.paths.lockFile, options.paths.stopFile);
+    if (target === undefined)
+        return { outcome: "already-stopped" };
+    const attempts = pollCount(timeoutMs, pollMs);
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        const current = await dependencies.readLock(options.paths.lockFile);
+        if (current === undefined || current.nonce !== target.nonce) {
+            return { outcome: "stopped", pid: target.pid };
+        }
+        if (attempt + 1 < attempts)
+            await dependencies.delay(pollMs);
+    }
+    return { outcome: "timed-out", pid: target.pid };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/cli/lifecycle.js.map

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

package/dist/cli/prompt.d.ts

@@ -0,0 +1,7 @@
+export interface SecretPromptOptions {
+    readonly prompt: string;
+    readonly input?: NodeJS.ReadStream;
+    readonly output?: NodeJS.WriteStream;
+}
+export declare function promptForSecret(options: SecretPromptOptions): Promise<string | undefined>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/cli/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CACxC;AAED,wBAAsB,eAAe,CACjC,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC7B"}

package/dist/cli/prompt.js

@@ -0,0 +1,37 @@
+import { createInterface } from "node:readline";
+import { Writable } from "node:stream";
+export async function promptForSecret(options) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stderr;
+    if (!input.isTTY || !output.isTTY)
+        return undefined;
+    output.write(options.prompt);
+    const mutedOutput = new Writable({
+        write(_chunk, _encoding, callback) {
+            callback();
+        },
+    });
+    const readline = createInterface({
+        input,
+        output: mutedOutput,
+        terminal: true,
+    });
+    return new Promise(resolve => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            readline.close();
+            output.write("\n");
+            resolve(value);
+        };
+        readline.once("SIGINT", () => finish(undefined));
+        readline.once("close", () => finish(undefined));
+        readline.question("", answer => {
+            const trimmed = answer.trim();
+            finish(trimmed === "" ? undefined : trimmed);
+        });
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,OAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAEpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,IAAI,QAAQ,CAAC;QAC7B,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ;YAC7B,QAAQ,EAAE,CAAC;QACf,CAAC;KACJ,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC7B,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,IAAI;KACjB,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAyB,EAAE,EAAE;YACzC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE;YAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/purge.d.ts

@@ -0,0 +1,28 @@
+import type { CredentialStore } from "../config/credentials.js";
+import { type AppPaths } from "../config/paths.js";
+export interface PurgeFileSystem {
+    readonly readTextFile: (filePath: string) => Promise<string | undefined>;
+    readonly remove: (target: string, options: {
+        readonly force: true;
+        readonly recursive: boolean;
+    }) => Promise<void>;
+}
+export interface PurgeAppDataOptions {
+    readonly paths: AppPaths;
+    readonly credentials: CredentialStore;
+    readonly platform?: NodeJS.Platform;
+    readonly environmentIds?: ReadonlyArray<string>;
+    readonly fileSystem?: PurgeFileSystem;
+}
+export interface PurgeAppDataResult {
+    readonly credentialsRemoved: number;
+    readonly directoriesRemoved: number;
+}
+export declare function environmentIdsFromCredentialFile(contents: string | undefined): ReadonlyArray<string>;
+export declare function assertAppOwnedPaths(paths: AppPaths, platform?: NodeJS.Platform): void;
+export declare function removeTransientDaemonData(paths: AppPaths, options?: {
+    readonly platform?: NodeJS.Platform;
+    readonly fileSystem?: PurgeFileSystem;
+}): Promise<void>;
+export declare function purgeAppData(options: PurgeAppDataOptions): Promise<PurgeAppDataResult>;
+//# sourceMappingURL=purge.d.ts.map

package/dist/cli/purge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.d.ts","sourceRoot":"","sources":["../../src/cli/purge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,KAC7D,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACvC;AAuBD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAcpG;AAMD,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC7C,IAAI,CAqCN;AAED,wBAAsB,yBAAyB,CAC3C,KAAK,EAAE,QAAQ,EACf,OAAO,GAAE;IACL,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACpC,GACP,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwB5F"}