sessionpipe-core 0.9.0 → 0.10.0

package/dist/src/launched-by.d.ts

@@ -0,0 +1,12 @@
+import type { Adapter, HookInput, HookResult } from "./adapters/types.js";
+/** PROTOCOL.md §3 `launched_by`: a launcher that starts a session for another one (a
+ *  script running `claude -p`) names itself here as `<harness>:<id>`, and the hook
+ *  carries it along. */
+export declare const LAUNCHED_BY_ENV = "SESSIONPIPE_LAUNCHED_BY";
+/** The launcher the environment names, or nothing when it is absent or malformed. */
+export declare function launchedBy(env: Record<string, string | undefined>): string | undefined;
+/** An adapter's reading of a hook, plus what every harness shares: the launcher, unless
+ *  the harness gave the session a parent of its own (a subagent's launcher is its parent)
+ *  or the value names the session itself (a launcher that forgot to reset it). */
+export declare function readHook(adapter: Adapter, input: HookInput): HookResult | null;
+//# sourceMappingURL=launched-by.d.ts.map

package/dist/src/launched-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launched-by.d.ts","sourceRoot":"","sources":["../../src/launched-by.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;wBAEwB;AACxB,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAGzD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED;;kFAEkF;AAClF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAO9E"}

package/dist/src/paths.d.ts

@@ -5,6 +5,10 @@ export declare function configFile(env?: NodeJS.ProcessEnv): string;
 export declare function stateDir(env?: NodeJS.ProcessEnv): string;
 /** `~` for the home directory, as the session block writes paths. */
 export declare function tilde(p: string, home?: string): string;
+/** The other way: `~`, `~/…` (or `~\…`) under the home directory, as a control `start`'s
+ *  `cwd` may name a folder an event reported (CONTROL.md §3.1). Anything else, `~user`
+ *  included, is returned as it is. */
+export declare function untilde(p: string, home?: string): string;
 /** A file-name-safe id. */
 export declare const safeId: (s: string) => string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/src/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAQA;oFACoF;AACpF,eAAO,MAAM,OAAO,QAAO,MAAsB,CAAC;AAElD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKvE;AAED,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKrE;AAED,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAIjE;AAED,2BAA2B;AAC3B,eAAO,MAAM,MAAM,MAAO,MAAM,KAAG,MAGjB,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAQA;oFACoF;AACpF,eAAO,MAAM,OAAO,QAAO,MAAsB,CAAC;AAElD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKvE;AAED,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKrE;AAED,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAIjE;AAED;;sCAEsC;AACtC,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAGnE;AAED,2BAA2B;AAC3B,eAAO,MAAM,MAAM,MAAO,MAAM,KAAG,MAGjB,CAAC"}

package/dist/src/privacy/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/privacy/filter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAI/C,qFAAqF;AACrF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAmB1C,CAAC;AAyDF,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,KAAK,GAAG,IAAI,CAqC1G"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/privacy/filter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAI/C,qFAAqF;AACrF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAmB1C,CAAC;AA2DF,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,KAAK,GAAG,IAAI,CAqC1G"}

package/dist/src/service/index.d.ts

@@ -0,0 +1,83 @@
+/** One service, as both managers need it. */
+export interface ServiceSpec {
+    /** The launchd label, also the plist's name: `org.sessionpipe.control`. */
+    label: string;
+    /** The systemd user unit's file name: `sessionpipe-control.service`. */
+    unit: string;
+    /** The unit's Description line. */
+    description: string;
+    /** The program and its arguments, each one argument (never through a shell). */
+    argv: string[];
+    /** More environment for the process, beside SESSIONPIPE_SERVICE. */
+    env?: Record<string, string>;
+    /** Where launchd writes its stdout and stderr (journald keeps a unit's). */
+    logPath: string;
+    /** The home the files go under; the user's own by default. */
+    home?: string;
+}
+/** A file the service writes, and what is in it. */
+export interface ServiceFile {
+    path: string;
+    text: string;
+}
+/** Runs one command and answers its stdout; throws when it fails. */
+export type Exec = (cmd: string, args: string[]) => string;
+/** The plist and the unit for a service, and where each goes. */
+export declare function serviceFiles(s: ServiceSpec): {
+    plist: ServiceFile;
+    unit: ServiceFile;
+};
+/** A systemd user service stops when its person's last login ends — closing the ssh
+ *  session to a lab workstation or a cloud machine stopped the daemon with it — unless
+ *  the user lingers. `loginctl enable-linger` for yourself needs no root on systemd's
+ *  default policy; where it does, say the one command that does it. */
+export declare function ensureLinger(user: string, exec?: Exec): {
+    on: boolean;
+    note: string;
+};
+/** What an install did, or would do in a dry run. */
+export interface ServicePlan {
+    /** The files written (or that would be). */
+    files: ServiceFile[];
+    /** The commands run (or that would be), one string each, in order. */
+    commands: string[];
+    /** Which manager runs it now: null on a platform with none, or where it isn't reachable. */
+    manager: "launchd" | "systemd" | null;
+    /** launchd: `gui` when someone is at the screen, else `user` (it starts again at the next login there). */
+    domain?: "gui" | "user";
+    /** systemd: whether it outlives the login, in words. */
+    linger?: {
+        on: boolean;
+        note: string;
+    };
+    /** The file that was written for a manager that couldn't be reached. */
+    unreachable?: string;
+}
+export interface InstallOptions extends ServiceSpec {
+    /** Answer the plan and touch nothing. */
+    dryRun?: boolean;
+    exec?: Exec;
+    platform?: NodeJS.Platform;
+    /** The user's id (launchd's domains) and name (linger); this process's by default. */
+    uid?: string;
+    user?: string;
+}
+/** Write the service for this platform and start it now; a service already there is
+ *  replaced (launchd: booted out first). */
+export declare function installService(o: InstallOptions): ServicePlan;
+export interface UninstallOptions {
+    label: string;
+    unit: string;
+    home?: string;
+    dryRun?: boolean;
+    exec?: Exec;
+    platform?: NodeJS.Platform;
+    uid?: string;
+}
+/** Stop the service and remove its file, where this platform has one; nothing where
+ *  there is none. A manager that says it wasn't loaded is no failure. */
+export declare function uninstallService(o: UninstallOptions): {
+    files: string[];
+    commands: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/service/index.ts"],"names":[],"mappings":"AAkBA,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAS3D,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CA2CtF;AAED;;;uEAGuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiBhG;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4FAA4F;IAC5F,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,2GAA2G;IAC3G,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;4CAC4C;AAC5C,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,WAAW,CA+C7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;yEACyE;AACzE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6B7F"}

package/dist/src/version.d.ts

@@ -0,0 +1,39 @@
+/** sessionpipe-core/version — versions, and restarting onto a new one: how two
+ *  versions order, whether one is a release newer than another, the exit code that
+ *  asks a service manager to start a process again on the code now on disk, and the
+ *  parent that does so where no manager will. The control daemon updates itself with
+ *  these, and a receiver of the person's own can do the same. Node only (the parent
+ *  spawns its child), so never part of the root export. */
+import { spawn } from "node:child_process";
+/** EX_TEMPFAIL: "start me again, on the code now on disk". Every plist and unit
+ *  sessionpipe-core/service writes restarts on it. */
+export declare const UPDATE_EXIT = 75;
+export interface Parsed {
+    n: [number, number, number];
+    pre: string | null;
+}
+/** A version's numbers and its prerelease tag, or null when it isn't one. */
+export declare function parseVersion(v: string): Parsed | null;
+/** Order two versions: <0, 0, >0, or null if either isn't one. A release sorts above
+ *  its own prereleases; prereleases compare by their tag. */
+export declare function compareVersions(a: string, b: string): number | null;
+/** `a` is a release newer than `b`. A prerelease is never offered as an update: the
+ *  `latest` dist-tag is a release, and anything else is someone's experiment.
+ *  Setup opts into prereleases when checking whether an installed build is newer. */
+export declare function isNewer(a: string, b: string, includePrereleases?: boolean): boolean;
+/** The parent left behind when no service manager will restart the daemon: runs
+ *  `control run` as a child with the same env and output, starts it again when it exits
+ *  UPDATE_EXIT (an update) or fails (after 5 s, like the service files), and exits
+ *  with it when it exits cleanly or is told to stop. */
+export declare function supervise(o: {
+    node: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    log: (line: string) => void;
+    spawn?: typeof spawn;
+    exit?: (code: number) => void;
+    failDelayMs?: number;
+}): {
+    stop: (sig?: NodeJS.Signals) => void;
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AACA;;;;;2DAK2D;AAC3D,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE9D;sDACsD;AACtD,eAAO,MAAM,WAAW,KAAK,CAAC;AAI9B,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AACD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED;6DAC6D;AAC7D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASnE;AAED;;qFAEqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,UAAQ,GAAG,OAAO,CAKjF;AAED;;;wDAGwD;AACxD,wBAAgB,SAAS,CAAC,CAAC,EAAE;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG;IAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAA;CAAE,CAuC3C"}

package/dist/version.js

@@ -0,0 +1,75 @@
+// sessionpipe-core 0.10.0 · Apache-2.0 · https://sessionpipe.org
+
+// src/version.ts
+import { spawn } from "node:child_process";
+var UPDATE_EXIT = 75;
+var VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseVersion(v) {
+  const m = VERSION_RE.exec(String(v).trim());
+  if (!m) return null;
+  return { n: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ?? null };
+}
+function compareVersions(a, b) {
+  const x = parseVersion(a);
+  const y = parseVersion(b);
+  if (!x || !y) return null;
+  for (let i = 0; i < 3; i++) if (x.n[i] !== y.n[i]) return x.n[i] - y.n[i];
+  if (x.pre === y.pre) return 0;
+  if (x.pre === null) return 1;
+  if (y.pre === null) return -1;
+  return x.pre.localeCompare(y.pre, "en", { numeric: true });
+}
+function isNewer(a, b, includePrereleases = false) {
+  const x = parseVersion(a);
+  if (!x || !includePrereleases && x.pre !== null) return false;
+  const c = compareVersions(a, b);
+  return c !== null && c > 0;
+}
+function supervise(o) {
+  const run = o.spawn ?? spawn;
+  const exit = o.exit ?? ((c) => process.exit(c));
+  const env = { ...o.env, SESSIONPIPE_SERVICE: `supervisor:${process.pid}` };
+  let child = null;
+  let stopping = false;
+  let later = null;
+  const start = () => {
+    later = null;
+    const c = run(o.node, o.args, { env, stdio: "inherit", windowsHide: true });
+    child = c;
+    let done = false;
+    const ended = (code, signal) => {
+      if (done) return;
+      done = true;
+      child = null;
+      if (stopping) return exit(code ?? 0);
+      if (code === UPDATE_EXIT) {
+        o.log("the daemon is restarting onto its new version");
+        return start();
+      }
+      if (code === 0) return exit(0);
+      o.log(`the daemon exited (${signal ?? `code ${code}`}); starting it again in 5 s`);
+      later = setTimeout(start, o.failDelayMs ?? 5e3);
+    };
+    c.on("exit", ended);
+    c.on("error", (e) => {
+      o.log(`couldn't start the daemon: ${e.message}`);
+      ended(1, null);
+    });
+  };
+  const stop = (sig = "SIGTERM") => {
+    stopping = true;
+    if (later) clearTimeout(later);
+    if (child) child.kill(sig);
+    else exit(0);
+  };
+  start();
+  return { stop };
+}
+export {
+  UPDATE_EXIT,
+  compareVersions,
+  isNewer,
+  parseVersion,
+  supervise
+};
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/version.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: Apache-2.0\n/** sessionpipe-core/version \u2014 versions, and restarting onto a new one: how two\n *  versions order, whether one is a release newer than another, the exit code that\n *  asks a service manager to start a process again on the code now on disk, and the\n *  parent that does so where no manager will. The control daemon updates itself with\n *  these, and a receiver of the person's own can do the same. Node only (the parent\n *  spawns its child), so never part of the root export. */\nimport { type ChildProcess, spawn } from \"node:child_process\";\n\n/** EX_TEMPFAIL: \"start me again, on the code now on disk\". Every plist and unit\n *  sessionpipe-core/service writes restarts on it. */\nexport const UPDATE_EXIT = 75;\n\nconst VERSION_RE = /^v?(\\d+)\\.(\\d+)\\.(\\d+)(?:-([0-9A-Za-z.-]+))?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nexport interface Parsed {\n  n: [number, number, number];\n  pre: string | null;\n}\n/** A version's numbers and its prerelease tag, or null when it isn't one. */\nexport function parseVersion(v: string): Parsed | null {\n  const m = VERSION_RE.exec(String(v).trim());\n  if (!m) return null;\n  return { n: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ?? null };\n}\n\n/** Order two versions: <0, 0, >0, or null if either isn't one. A release sorts above\n *  its own prereleases; prereleases compare by their tag. */\nexport function compareVersions(a: string, b: string): number | null {\n  const x = parseVersion(a);\n  const y = parseVersion(b);\n  if (!x || !y) return null;\n  for (let i = 0; i < 3; i++) if (x.n[i] !== y.n[i]) return (x.n[i] as number) - (y.n[i] as number);\n  if (x.pre === y.pre) return 0;\n  if (x.pre === null) return 1;\n  if (y.pre === null) return -1;\n  return x.pre.localeCompare(y.pre, \"en\", { numeric: true });\n}\n\n/** `a` is a release newer than `b`. A prerelease is never offered as an update: the\n *  `latest` dist-tag is a release, and anything else is someone's experiment.\n *  Setup opts into prereleases when checking whether an installed build is newer. */\nexport function isNewer(a: string, b: string, includePrereleases = false): boolean {\n  const x = parseVersion(a);\n  if (!x || (!includePrereleases && x.pre !== null)) return false;\n  const c = compareVersions(a, b);\n  return c !== null && c > 0;\n}\n\n/** The parent left behind when no service manager will restart the daemon: runs\n *  `control run` as a child with the same env and output, starts it again when it exits\n *  UPDATE_EXIT (an update) or fails (after 5 s, like the service files), and exits\n *  with it when it exits cleanly or is told to stop. */\nexport function supervise(o: {\n  node: string;\n  args: string[];\n  env: NodeJS.ProcessEnv;\n  log: (line: string) => void;\n  spawn?: typeof spawn;\n  exit?: (code: number) => void;\n  failDelayMs?: number;\n}): { stop: (sig?: NodeJS.Signals) => void } {\n  const run = o.spawn ?? spawn;\n  const exit = o.exit ?? ((c: number) => process.exit(c));\n  const env = { ...o.env, SESSIONPIPE_SERVICE: `supervisor:${process.pid}` };\n  let child: ChildProcess | null = null;\n  let stopping = false;\n  let later: NodeJS.Timeout | null = null;\n  const start = () => {\n    later = null;\n    const c = run(o.node, o.args, { env, stdio: \"inherit\", windowsHide: true });\n    child = c;\n    let done = false;\n    const ended = (code: number | null, signal: NodeJS.Signals | null) => {\n      if (done) return;\n      done = true;\n      child = null;\n      if (stopping) return exit(code ?? 0);\n      if (code === UPDATE_EXIT) {\n        o.log(\"the daemon is restarting onto its new version\");\n        return start();\n      }\n      if (code === 0) return exit(0);\n      o.log(`the daemon exited (${signal ?? `code ${code}`}); starting it again in 5 s`);\n      later = setTimeout(start, o.failDelayMs ?? 5000);\n    };\n    c.on(\"exit\", ended);\n    c.on(\"error\", (e) => {\n      o.log(`couldn't start the daemon: ${e.message}`);\n      ended(1, null);\n    });\n  };\n  const stop = (sig: NodeJS.Signals = \"SIGTERM\") => {\n    stopping = true;\n    if (later) clearTimeout(later);\n    if (child) child.kill(sig);\n    else exit(0);\n  };\n  start();\n  return { stop };\n}\n"],
+  "mappings": ";;;AAOA,SAA4B,aAAa;AAIlC,IAAM,cAAc;AAE3B,IAAM,aAAa;AAOZ,SAAS,aAAa,GAA0B;AACrD,QAAM,IAAI,WAAW,KAAK,OAAO,CAAC,EAAE,KAAK,CAAC;AAC1C,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,KAAK,KAAK;AAC5E;AAIO,SAAS,gBAAgB,GAAW,GAA0B;AACnE,QAAM,IAAI,aAAa,CAAC;AACxB,QAAM,IAAI,aAAa,CAAC;AACxB,MAAI,CAAC,KAAK,CAAC,EAAG,QAAO;AACrB,WAAS,IAAI,GAAG,IAAI,GAAG,IAAK,KAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,EAAG,QAAQ,EAAE,EAAE,CAAC,IAAgB,EAAE,EAAE,CAAC;AACrF,MAAI,EAAE,QAAQ,EAAE,IAAK,QAAO;AAC5B,MAAI,EAAE,QAAQ,KAAM,QAAO;AAC3B,MAAI,EAAE,QAAQ,KAAM,QAAO;AAC3B,SAAO,EAAE,IAAI,cAAc,EAAE,KAAK,MAAM,EAAE,SAAS,KAAK,CAAC;AAC3D;AAKO,SAAS,QAAQ,GAAW,GAAW,qBAAqB,OAAgB;AACjF,QAAM,IAAI,aAAa,CAAC;AACxB,MAAI,CAAC,KAAM,CAAC,sBAAsB,EAAE,QAAQ,KAAO,QAAO;AAC1D,QAAM,IAAI,gBAAgB,GAAG,CAAC;AAC9B,SAAO,MAAM,QAAQ,IAAI;AAC3B;AAMO,SAAS,UAAU,GAQmB;AAC3C,QAAM,MAAM,EAAE,SAAS;AACvB,QAAM,OAAO,EAAE,SAAS,CAAC,MAAc,QAAQ,KAAK,CAAC;AACrD,QAAM,MAAM,EAAE,GAAG,EAAE,KAAK,qBAAqB,cAAc,QAAQ,GAAG,GAAG;AACzE,MAAI,QAA6B;AACjC,MAAI,WAAW;AACf,MAAI,QAA+B;AACnC,QAAM,QAAQ,MAAM;AAClB,YAAQ;AACR,UAAM,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,WAAW,aAAa,KAAK,CAAC;AAC1E,YAAQ;AACR,QAAI,OAAO;AACX,UAAM,QAAQ,CAAC,MAAqB,WAAkC;AACpE,UAAI,KAAM;AACV,aAAO;AACP,cAAQ;AACR,UAAI,SAAU,QAAO,KAAK,QAAQ,CAAC;AACnC,UAAI,SAAS,aAAa;AACxB,UAAE,IAAI,+CAA+C;AACrD,eAAO,MAAM;AAAA,MACf;AACA,UAAI,SAAS,EAAG,QAAO,KAAK,CAAC;AAC7B,QAAE,IAAI,sBAAsB,UAAU,QAAQ,IAAI,EAAE,6BAA6B;AACjF,cAAQ,WAAW,OAAO,EAAE,eAAe,GAAI;AAAA,IACjD;AACA,MAAE,GAAG,QAAQ,KAAK;AAClB,MAAE,GAAG,SAAS,CAAC,MAAM;AACnB,QAAE,IAAI,8BAA8B,EAAE,OAAO,EAAE;AAC/C,YAAM,GAAG,IAAI;AAAA,IACf,CAAC;AAAA,EACH;AACA,QAAM,OAAO,CAAC,MAAsB,cAAc;AAChD,eAAW;AACX,QAAI,MAAO,cAAa,KAAK;AAC7B,QAAI,MAAO,OAAM,KAAK,GAAG;AAAA,QACpB,MAAK,CAAC;AAAA,EACb;AACA,QAAM;AACN,SAAO,EAAE,KAAK;AAChB;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessionpipe-core",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "sessionpipe core: protocol types, harness adapters, privacy filter and redaction rulesets, outbox and sinks. Zero runtime dependencies. (published unscoped until the @sessionpipe npm org exists; the code is the same)",
   "license": "Apache-2.0",
   "type": "module",
@@ -43,6 +43,14 @@
     "./control": {
       "types": "./dist/src/control/index.d.ts",
       "import": "./dist/control.js"
+    },
+    "./service": {
+      "types": "./dist/src/service/index.d.ts",
+      "import": "./dist/service.js"
+    },
+    "./version": {
+      "types": "./dist/src/version.d.ts",
+      "import": "./dist/version.js"
     }
   },
   "types": "./dist/src/index.d.ts",