@parlor/agent-host 0.0.0-stage → 0.2.0

package/dist/service.d.ts

@@ -0,0 +1,97 @@
+import type { ProtocolRange } from "@parlor/chat";
+import type { HostPaths } from "./paths.js";
+import { type ReleaseSignature } from "./release.js";
+export interface HostRelease {
+    readonly version: string;
+    /** Host protocols it speaks with app backends. */
+    readonly protocols: ProtocolRange;
+    /** The control protocol it speaks with CLIs and desktop sidecars. */
+    readonly control: number;
+}
+export type ServiceClient = {
+    readonly kind: "cli";
+    readonly release: HostRelease;
+} | {
+    readonly kind: "desktop-sidecar";
+    readonly app: string;
+    readonly release: HostRelease;
+    /** The bundled binary, copied in when newer than what is installed. */
+    readonly binary: string;
+    /** Its `.sig`, `<binary>.sig` when the bundle keeps them together. */
+    readonly signature?: string;
+};
+export type AdoptOutcome = {
+    readonly kind: "using";
+    readonly running: HostRelease;
+} | {
+    readonly kind: "installed";
+    readonly release: HostRelease;
+}
+/** The old service handed its links over; its running turns finish under it. */
+ | {
+    readonly kind: "upgraded";
+    readonly from: HostRelease;
+    readonly to: HostRelease;
+} | {
+    readonly kind: "refused";
+    readonly reason: "unsigned" | "downgrade" | "legacy_service";
+    readonly running?: HostRelease;
+};
+export type Situation = {
+    readonly service: "absent";
+    readonly installed: boolean;
+} | {
+    readonly service: "legacy";
+} | {
+    readonly service: "running";
+    readonly running: HostRelease;
+};
+type Sidecar = Extract<ServiceClient, {
+    readonly kind: "desktop-sidecar";
+}>;
+export type Action = {
+    readonly do: "start_installed";
+} | {
+    readonly do: "spawn_self";
+} | {
+    readonly do: "install_bundled";
+    readonly client: Sidecar;
+} | {
+    readonly do: "refuse_legacy";
+} | {
+    readonly do: "use";
+    readonly running: HostRelease;
+} | {
+    readonly do: "refuse_downgrade";
+    readonly running: HostRelease;
+} | {
+    readonly do: "hand_over";
+    readonly client: Sidecar;
+    readonly running: HostRelease;
+};
+export declare function actionFor(situation: Situation, client: ServiceClient): Action;
+export interface ServiceDeps {
+    readonly releaseKey: string | undefined;
+    readonly readyMs: number;
+    readonly pollMs: number;
+    readonly start?: ((paths: HostPaths, command: string, args: readonly string[], lockToken: string) => Promise<void>) | undefined;
+}
+/**
+ * Copies a verified binary into `versions/<version>/` and repoints `current`, each step
+ * atomic and repeatable; false when the copy is not the binary the signature describes.
+ */
+export declare function installRelease(paths: HostPaths, source: {
+    readonly binary: string;
+    readonly signature: string;
+}, release: ReleaseSignature): Promise<boolean>;
+/** LaunchAgent, systemd user unit or Task Scheduler, pointing at `paths.current`. */
+export declare function installLoginItem(paths: HostPaths): Promise<void>;
+/**
+ * Leaves exactly one per-user service running, the newest: adopt, install or upgrade.
+ * Only binaries signed by the Parlor release key, never a downgrade; installs hold a lock
+ * under `paths.root`, so two apps can run it at once.
+ */
+export declare function ensureServiceWith(deps: ServiceDeps, paths: HostPaths, client: ServiceClient): Promise<AdoptOutcome>;
+export declare function ensureService(paths: HostPaths, client: ServiceClient): Promise<AdoptOutcome>;
+export {};
+//# 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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"}

package/dist/service.js

@@ -0,0 +1,205 @@
+import { spawn } from "node:child_process";
+import { access, chmod, copyFile, mkdir, open, rename, rm, symlink, writeFile, } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { connectControl } from "./control.js";
+import { LOCK_TOKEN_ENV, withFileLock } from "./lock.js";
+import { compareVersions, RELEASE_KEY, sha256File, signedRelease, } from "./release.js";
+import { selfInvocation } from "./self.js";
+export function actionFor(situation, client) {
+    switch (situation.service) {
+        case "legacy":
+            return { do: "refuse_legacy" };
+        case "absent":
+            if (situation.installed)
+                return { do: "start_installed" };
+            return client.kind === "cli"
+                ? { do: "spawn_self" }
+                : { do: "install_bundled", client };
+        case "running": {
+            const { running } = situation;
+            if (client.kind === "cli")
+                return { do: "use", running };
+            const order = compareVersions(client.release.version, running.version);
+            if (order > 0)
+                return { do: "hand_over", client, running };
+            return order === 0 ? { do: "use", running } : { do: "refuse_downgrade", running };
+        }
+    }
+}
+const DEFAULTS = { releaseKey: RELEASE_KEY, readyMs: 15_000, pollMs: 100 };
+const startWith = (deps) => deps.start ?? spawnService;
+const SERVICE_BINARY = "parlor-host";
+const SIGNATURE_FILE = "parlor-host.sig";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const exists = (path) => access(path).then(() => true, () => false);
+async function observe(paths, client) {
+    const control = await connectControl(paths.control);
+    if (!control) {
+        return {
+            service: "absent",
+            installed: await exists(join(paths.current, SERVICE_BINARY)),
+        };
+    }
+    const reply = await control.send({ op: "hello", client });
+    control.close();
+    return reply.ok
+        ? { service: "running", running: reply.release }
+        : { service: "legacy" };
+}
+async function spawnService(paths, command, args, lockToken) {
+    await mkdir(paths.logs, { recursive: true, mode: 0o700 });
+    const output = await open(join(paths.logs, "daemon.out"), "a", 0o600);
+    const child = spawn(command, args, {
+        cwd: paths.root,
+        detached: true,
+        stdio: ["ignore", output.fd, output.fd],
+        env: { ...process.env, [LOCK_TOKEN_ENV]: lockToken },
+    });
+    child.unref();
+    await output.close();
+}
+async function untilRunning(paths, client, deps, ready = () => true) {
+    for (const deadline = Date.now() + deps.readyMs; Date.now() < deadline;) {
+        const situation = await observe(paths, client);
+        if (situation.service === "running" && ready(situation.running)) {
+            return situation.running;
+        }
+        await sleep(deps.pollMs);
+    }
+    throw new Error(`Parlor Host did not start; see ${join(paths.logs, "daemon.out")}.`);
+}
+/**
+ * Copies a verified binary into `versions/<version>/` and repoints `current`, each step
+ * atomic and repeatable; false when the copy is not the binary the signature describes.
+ */
+export async function installRelease(paths, source, release) {
+    const target = join(paths.versions, release.version);
+    const installed = join(target, SERVICE_BINARY);
+    const present = (await sha256File(installed).catch(() => undefined)) === release.sha256;
+    if (!present) {
+        const staged = join(paths.versions, `.${release.version}.tmp-${process.pid}`);
+        await rm(staged, { recursive: true, force: true });
+        await mkdir(staged, { recursive: true, mode: 0o700 });
+        await copyFile(source.binary, join(staged, SERVICE_BINARY));
+        await chmod(join(staged, SERVICE_BINARY), 0o755);
+        await copyFile(source.signature, join(staged, SIGNATURE_FILE));
+        if ((await sha256File(join(staged, SERVICE_BINARY))) !== release.sha256) {
+            await rm(staged, { recursive: true, force: true });
+            return false;
+        }
+        await rm(target, { recursive: true, force: true });
+        await rename(staged, target);
+    }
+    const link = `${paths.current}.tmp-${process.pid}`;
+    await rm(link, { force: true });
+    await symlink(join("versions", release.version), link);
+    await rename(link, paths.current);
+    return true;
+}
+const escapeXml = (text) => text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+/** LaunchAgent, systemd user unit or Task Scheduler, pointing at `paths.current`. */
+export async function installLoginItem(paths) {
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>dev.parlor.host</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${escapeXml(join(paths.current, SERVICE_BINARY))}</string>
+    <string>daemon</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(join(paths.logs, "daemon.out"))}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(join(paths.logs, "daemon.out"))}</string>
+</dict>
+</plist>
+`;
+    await mkdir(dirname(paths.launchAgent), { recursive: true });
+    const staged = `${paths.launchAgent}.${process.pid}.tmp`;
+    await writeFile(staged, plist, { mode: 0o644 });
+    await rename(staged, paths.launchAgent);
+}
+async function installBundled(paths, client, deps, lockToken) {
+    const source = {
+        binary: client.binary,
+        signature: client.signature ?? `${client.binary}.sig`,
+    };
+    const release = await signedRelease(source.binary, source.signature, deps.releaseKey);
+    if (!release ||
+        release.version !== client.release.version ||
+        !(await installRelease(paths, source, release))) {
+        return { kind: "refused", reason: "unsigned" };
+    }
+    await installLoginItem(paths);
+    await startWith(deps)(paths, join(paths.current, SERVICE_BINARY), ["daemon"], lockToken);
+    return { kind: "installed", release: await untilRunning(paths, client, deps) };
+}
+async function handOver(paths, client, running, deps, lockToken) {
+    const control = await connectControl(paths.control);
+    if (!control)
+        throw new Error("Parlor Host stopped answering during the upgrade.");
+    const reply = await control.send({
+        op: "handover",
+        binary: client.binary,
+        signature: client.signature ?? `${client.binary}.sig`,
+    });
+    control.close();
+    if (!reply.ok) {
+        return reply.error === "unsigned" || reply.error === "downgrade"
+            ? { kind: "refused", reason: reply.error, running }
+            : (() => {
+                throw new Error(reply.error);
+            })();
+    }
+    await startWith(deps)(paths, join(paths.current, SERVICE_BINARY), ["daemon"], lockToken);
+    const to = await untilRunning(paths, client, deps, (release) => compareVersions(release.version, running.version) > 0);
+    return { kind: "upgraded", from: running, to };
+}
+/**
+ * Leaves exactly one per-user service running, the newest: adopt, install or upgrade.
+ * Only binaries signed by the Parlor release key, never a downgrade; installs hold a lock
+ * under `paths.root`, so two apps can run it at once.
+ */
+export async function ensureServiceWith(deps, paths, client) {
+    await mkdir(paths.root, { recursive: true, mode: 0o700 });
+    return withFileLock(paths.lock, async (lockToken) => {
+        for (;;) {
+            const action = actionFor(await observe(paths, client), client);
+            switch (action.do) {
+                case "refuse_legacy":
+                    return { kind: "refused", reason: "legacy_service" };
+                case "use":
+                    return { kind: "using", running: action.running };
+                case "refuse_downgrade":
+                    return { kind: "refused", reason: "downgrade", running: action.running };
+                case "hand_over":
+                    return handOver(paths, action.client, action.running, deps, lockToken);
+                case "install_bundled":
+                    return installBundled(paths, action.client, deps, lockToken);
+                case "start_installed":
+                    await startWith(deps)(paths, join(paths.current, SERVICE_BINARY), ["daemon"], lockToken);
+                    await untilRunning(paths, client, deps);
+                    continue;
+                case "spawn_self": {
+                    const self = selfInvocation(["daemon"]);
+                    await startWith(deps)(paths, self.command, self.args, lockToken);
+                    return { kind: "installed", release: await untilRunning(paths, client, deps) };
+                }
+            }
+        }
+    });
+}
+export function ensureService(paths, client) {
+    return ensureServiceWith(DEFAULTS, paths, client);
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport {\n  access,\n  chmod,\n  copyFile,\n  mkdir,\n  open,\n  rename,\n  rm,\n  symlink,\n  writeFile,\n} from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport type { ProtocolRange } from \"@parlor/chat\";\n\nimport { connectControl } from \"./control.js\";\nimport { LOCK_TOKEN_ENV, withFileLock } from \"./lock.js\";\nimport type { HostPaths } from \"./paths.js\";\nimport {\n  compareVersions,\n  RELEASE_KEY,\n  type ReleaseSignature,\n  sha256File,\n  signedRelease,\n} from \"./release.js\";\nimport { selfInvocation } from \"./self.js\";\n\nexport interface HostRelease {\n  readonly version: string;\n  /** Host protocols it speaks with app backends. */\n  readonly protocols: ProtocolRange;\n  /** The control protocol it speaks with CLIs and desktop sidecars. */\n  readonly control: number;\n}\n\nexport type ServiceClient =\n  | { readonly kind: \"cli\"; readonly release: HostRelease }\n  | {\n      readonly kind: \"desktop-sidecar\";\n      readonly app: string;\n      readonly release: HostRelease;\n      /** The bundled binary, copied in when newer than what is installed. */\n      readonly binary: string;\n      /** Its `.sig`, `<binary>.sig` when the bundle keeps them together. */\n      readonly signature?: string;\n    };\n\nexport type AdoptOutcome =\n  | { readonly kind: \"using\"; readonly running: HostRelease }\n  | { readonly kind: \"installed\"; readonly release: HostRelease }\n  /** The old service handed its links over; its running turns finish under it. */\n  | { readonly kind: \"upgraded\"; readonly from: HostRelease; readonly to: HostRelease }\n  | {\n      readonly kind: \"refused\";\n      readonly reason: \"unsigned\" | \"downgrade\" | \"legacy_service\";\n      readonly running?: HostRelease;\n    };\n\nexport type Situation =\n  | { readonly service: \"absent\"; readonly installed: boolean }\n  | { readonly service: \"legacy\" }\n  | { readonly service: \"running\"; readonly running: HostRelease };\n\ntype Sidecar = Extract<ServiceClient, { readonly kind: \"desktop-sidecar\" }>;\n\nexport type Action =\n  | { readonly do: \"start_installed\" }\n  | { readonly do: \"spawn_self\" }\n  | { readonly do: \"install_bundled\"; readonly client: Sidecar }\n  | { readonly do: \"refuse_legacy\" }\n  | { readonly do: \"use\"; readonly running: HostRelease }\n  | { readonly do: \"refuse_downgrade\"; readonly running: HostRelease }\n  | { readonly do: \"hand_over\"; readonly client: Sidecar; readonly running: HostRelease };\n\nexport function actionFor(situation: Situation, client: ServiceClient): Action {\n  switch (situation.service) {\n    case \"legacy\":\n      return { do: \"refuse_legacy\" };\n    case \"absent\":\n      if (situation.installed) return { do: \"start_installed\" };\n      return client.kind === \"cli\"\n        ? { do: \"spawn_self\" }\n        : { do: \"install_bundled\", client };\n    case \"running\": {\n      const { running } = situation;\n      if (client.kind === \"cli\") return { do: \"use\", running };\n      const order = compareVersions(client.release.version, running.version);\n      if (order > 0) return { do: \"hand_over\", client, running };\n      return order === 0 ? { do: \"use\", running } : { do: \"refuse_downgrade\", running };\n    }\n  }\n}\n\nexport interface ServiceDeps {\n  readonly releaseKey: string | undefined;\n  readonly readyMs: number;\n  readonly pollMs: number;\n  readonly start?:\n    | ((\n        paths: HostPaths,\n        command: string,\n        args: readonly string[],\n        lockToken: string,\n      ) => Promise<void>)\n    | undefined;\n}\n\nconst DEFAULTS: ServiceDeps = { releaseKey: RELEASE_KEY, readyMs: 15_000, pollMs: 100 };\n\nconst startWith = (deps: ServiceDeps) => deps.start ?? spawnService;\nconst SERVICE_BINARY = \"parlor-host\";\nconst SIGNATURE_FILE = \"parlor-host.sig\";\n\nconst sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst exists = (path: string) =>\n  access(path).then(\n    () => true,\n    () => false,\n  );\n\nasync function observe(paths: HostPaths, client: ServiceClient): Promise<Situation> {\n  const control = await connectControl(paths.control);\n  if (!control) {\n    return {\n      service: \"absent\",\n      installed: await exists(join(paths.current, SERVICE_BINARY)),\n    };\n  }\n  const reply = await control.send({ op: \"hello\", client });\n  control.close();\n  return reply.ok\n    ? { service: \"running\", running: reply.release }\n    : { service: \"legacy\" };\n}\n\nasync function spawnService(\n  paths: HostPaths,\n  command: string,\n  args: readonly string[],\n  lockToken: string,\n): Promise<void> {\n  await mkdir(paths.logs, { recursive: true, mode: 0o700 });\n  const output = await open(join(paths.logs, \"daemon.out\"), \"a\", 0o600);\n  const child = spawn(command, args, {\n    cwd: paths.root,\n    detached: true,\n    stdio: [\"ignore\", output.fd, output.fd],\n    env: { ...process.env, [LOCK_TOKEN_ENV]: lockToken },\n  });\n  child.unref();\n  await output.close();\n}\n\nasync function untilRunning(\n  paths: HostPaths,\n  client: ServiceClient,\n  deps: ServiceDeps,\n  ready: (running: HostRelease) => boolean = () => true,\n): Promise<HostRelease> {\n  for (const deadline = Date.now() + deps.readyMs; Date.now() < deadline;) {\n    const situation = await observe(paths, client);\n    if (situation.service === \"running\" && ready(situation.running)) {\n      return situation.running;\n    }\n    await sleep(deps.pollMs);\n  }\n  throw new Error(`Parlor Host did not start; see ${join(paths.logs, \"daemon.out\")}.`);\n}\n\n/**\n * Copies a verified binary into `versions/<version>/` and repoints `current`, each step\n * atomic and repeatable; false when the copy is not the binary the signature describes.\n */\nexport async function installRelease(\n  paths: HostPaths,\n  source: { readonly binary: string; readonly signature: string },\n  release: ReleaseSignature,\n): Promise<boolean> {\n  const target = join(paths.versions, release.version);\n  const installed = join(target, SERVICE_BINARY);\n  const present = (await sha256File(installed).catch(() => undefined)) === release.sha256;\n  if (!present) {\n    const staged = join(paths.versions, `.${release.version}.tmp-${process.pid}`);\n    await rm(staged, { recursive: true, force: true });\n    await mkdir(staged, { recursive: true, mode: 0o700 });\n    await copyFile(source.binary, join(staged, SERVICE_BINARY));\n    await chmod(join(staged, SERVICE_BINARY), 0o755);\n    await copyFile(source.signature, join(staged, SIGNATURE_FILE));\n    if ((await sha256File(join(staged, SERVICE_BINARY))) !== release.sha256) {\n      await rm(staged, { recursive: true, force: true });\n      return false;\n    }\n    await rm(target, { recursive: true, force: true });\n    await rename(staged, target);\n  }\n  const link = `${paths.current}.tmp-${process.pid}`;\n  await rm(link, { force: true });\n  await symlink(join(\"versions\", release.version), link);\n  await rename(link, paths.current);\n  return true;\n}\n\nconst escapeXml = (text: string) =>\n  text.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n\n/** LaunchAgent, systemd user unit or Task Scheduler, pointing at `paths.current`. */\nexport async function installLoginItem(paths: HostPaths): Promise<void> {\n  const plist = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>dev.parlor.host</string>\n  <key>ProgramArguments</key>\n  <array>\n    <string>${escapeXml(join(paths.current, SERVICE_BINARY))}</string>\n    <string>daemon</string>\n  </array>\n  <key>RunAtLoad</key>\n  <true/>\n  <key>KeepAlive</key>\n  <dict>\n    <key>SuccessfulExit</key>\n    <false/>\n  </dict>\n  <key>StandardOutPath</key>\n  <string>${escapeXml(join(paths.logs, \"daemon.out\"))}</string>\n  <key>StandardErrorPath</key>\n  <string>${escapeXml(join(paths.logs, \"daemon.out\"))}</string>\n</dict>\n</plist>\n`;\n  await mkdir(dirname(paths.launchAgent), { recursive: true });\n  const staged = `${paths.launchAgent}.${process.pid}.tmp`;\n  await writeFile(staged, plist, { mode: 0o644 });\n  await rename(staged, paths.launchAgent);\n}\n\nasync function installBundled(\n  paths: HostPaths,\n  client: Sidecar,\n  deps: ServiceDeps,\n  lockToken: string,\n): Promise<AdoptOutcome> {\n  const source = {\n    binary: client.binary,\n    signature: client.signature ?? `${client.binary}.sig`,\n  };\n  const release = await signedRelease(source.binary, source.signature, deps.releaseKey);\n  if (\n    !release ||\n    release.version !== client.release.version ||\n    !(await installRelease(paths, source, release))\n  ) {\n    return { kind: \"refused\", reason: \"unsigned\" };\n  }\n  await installLoginItem(paths);\n  await startWith(deps)(\n    paths,\n    join(paths.current, SERVICE_BINARY),\n    [\"daemon\"],\n    lockToken,\n  );\n  return { kind: \"installed\", release: await untilRunning(paths, client, deps) };\n}\n\nasync function handOver(\n  paths: HostPaths,\n  client: Sidecar,\n  running: HostRelease,\n  deps: ServiceDeps,\n  lockToken: string,\n): Promise<AdoptOutcome> {\n  const control = await connectControl(paths.control);\n  if (!control) throw new Error(\"Parlor Host stopped answering during the upgrade.\");\n  const reply = await control.send({\n    op: \"handover\",\n    binary: client.binary,\n    signature: client.signature ?? `${client.binary}.sig`,\n  });\n  control.close();\n  if (!reply.ok) {\n    return reply.error === \"unsigned\" || reply.error === \"downgrade\"\n      ? { kind: \"refused\", reason: reply.error, running }\n      : (() => {\n          throw new Error(reply.error);\n        })();\n  }\n  await startWith(deps)(\n    paths,\n    join(paths.current, SERVICE_BINARY),\n    [\"daemon\"],\n    lockToken,\n  );\n  const to = await untilRunning(\n    paths,\n    client,\n    deps,\n    (release) => compareVersions(release.version, running.version) > 0,\n  );\n  return { kind: \"upgraded\", from: running, to };\n}\n\n/**\n * Leaves exactly one per-user service running, the newest: adopt, install or upgrade.\n * Only binaries signed by the Parlor release key, never a downgrade; installs hold a lock\n * under `paths.root`, so two apps can run it at once.\n */\nexport async function ensureServiceWith(\n  deps: ServiceDeps,\n  paths: HostPaths,\n  client: ServiceClient,\n): Promise<AdoptOutcome> {\n  await mkdir(paths.root, { recursive: true, mode: 0o700 });\n  return withFileLock(paths.lock, async (lockToken) => {\n    for (;;) {\n      const action = actionFor(await observe(paths, client), client);\n      switch (action.do) {\n        case \"refuse_legacy\":\n          return { kind: \"refused\", reason: \"legacy_service\" };\n        case \"use\":\n          return { kind: \"using\", running: action.running };\n        case \"refuse_downgrade\":\n          return { kind: \"refused\", reason: \"downgrade\", running: action.running };\n        case \"hand_over\":\n          return handOver(paths, action.client, action.running, deps, lockToken);\n        case \"install_bundled\":\n          return installBundled(paths, action.client, deps, lockToken);\n        case \"start_installed\":\n          await startWith(deps)(\n            paths,\n            join(paths.current, SERVICE_BINARY),\n            [\"daemon\"],\n            lockToken,\n          );\n          await untilRunning(paths, client, deps);\n          continue;\n        case \"spawn_self\": {\n          const self = selfInvocation([\"daemon\"]);\n          await startWith(deps)(paths, self.command, self.args, lockToken);\n          return { kind: \"installed\", release: await untilRunning(paths, client, deps) };\n        }\n      }\n    }\n  });\n}\n\nexport function ensureService(\n  paths: HostPaths,\n  client: ServiceClient,\n): Promise<AdoptOutcome> {\n  return ensureServiceWith(DEFAULTS, paths, client);\n}\n"]}

package/dist/shell-path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The PATH agents are found on: this process's own first, then what the login shell adds,
+ * then the directories agent CLIs install into, since a LaunchAgent or a GUI app gets only
+ * launchd's system PATH.
+ */
+export declare function agentPath(): Promise<string>;
+/** The first executable `name` on `path`, as an absolute path. */
+export declare function resolveBinary(name: string, path: string): Promise<string | undefined>;
+export declare function agentEnvironment(): Promise<Record<string, string>>;
+//# sourceMappingURL=shell-path.d.ts.map

package/dist/shell-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-path.d.ts","sourceRoot":"","sources":["../src/shell-path.ts"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAY3C;AAED,kEAAkE;AAClE,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOxE"}

package/dist/shell-path.js

@@ -0,0 +1,64 @@
+import { spawn } from "node:child_process";
+import { access, constants } from "node:fs/promises";
+import { homedir } from "node:os";
+import { delimiter, join } from "node:path";
+const MARK = "__PARLOR_PATH__";
+const TIMEOUT_MS = 3_000;
+let resolved;
+const wellKnownDirectories = () => [
+    join(homedir(), ".local", "bin"),
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+];
+function fromLoginShell() {
+    return new Promise((resolve) => {
+        const shell = process.env.SHELL || "/bin/zsh";
+        const child = spawn(shell, ["-ilc", `printf '${MARK}%s${MARK}' "$PATH"`], {
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: TIMEOUT_MS,
+        });
+        let out = "";
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => (out += chunk));
+        child.once("error", () => resolve(undefined));
+        child.once("close", () => resolve(out.split(MARK)[1]));
+    });
+}
+/**
+ * The PATH agents are found on: this process's own first, then what the login shell adds,
+ * then the directories agent CLIs install into, since a LaunchAgent or a GUI app gets only
+ * launchd's system PATH.
+ */
+export function agentPath() {
+    resolved ??= fromLoginShell().then((login) => {
+        const own = (process.env.PATH ?? "").split(delimiter).filter(Boolean);
+        const known = (entry) => own.includes(entry);
+        const fromShell = (login ?? "")
+            .split(delimiter)
+            .filter((entry) => entry && !known(entry));
+        const rest = [...own, ...fromShell];
+        const installed = wellKnownDirectories().filter((entry) => !rest.includes(entry));
+        return [...rest, ...installed].join(delimiter);
+    });
+    return resolved;
+}
+/** The first executable `name` on `path`, as an absolute path. */
+export async function resolveBinary(name, path) {
+    for (const directory of path.split(delimiter).filter(Boolean)) {
+        const candidate = join(directory, name);
+        const found = await access(candidate, constants.X_OK).then(() => candidate, () => undefined);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+export async function agentEnvironment() {
+    const env = {};
+    for (const [name, value] of Object.entries(process.env)) {
+        if (value !== undefined && !name.startsWith("PARLOR_"))
+            env[name] = value;
+    }
+    env.PATH = await agentPath();
+    return env;
+}
+//# sourceMappingURL=shell-path.js.map

package/dist/shell-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-path.js","sourceRoot":"","sources":["../src/shell-path.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { access, constants } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { delimiter, join } from \"node:path\";\n\nconst MARK = \"__PARLOR_PATH__\";\nconst TIMEOUT_MS = 3_000;\n\nlet resolved: Promise<string> | undefined;\n\nconst wellKnownDirectories = () => [\n  join(homedir(), \".local\", \"bin\"),\n  \"/opt/homebrew/bin\",\n  \"/usr/local/bin\",\n];\n\nfunction fromLoginShell(): Promise<string | undefined> {\n  return new Promise((resolve) => {\n    const shell = process.env.SHELL || \"/bin/zsh\";\n    const child = spawn(shell, [\"-ilc\", `printf '${MARK}%s${MARK}' \"$PATH\"`], {\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      timeout: TIMEOUT_MS,\n    });\n    let out = \"\";\n    child.stdout.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => (out += chunk));\n    child.once(\"error\", () => resolve(undefined));\n    child.once(\"close\", () => resolve(out.split(MARK)[1]));\n  });\n}\n\n/**\n * The PATH agents are found on: this process's own first, then what the login shell adds,\n * then the directories agent CLIs install into, since a LaunchAgent or a GUI app gets only\n * launchd's system PATH.\n */\nexport function agentPath(): Promise<string> {\n  resolved ??= fromLoginShell().then((login) => {\n    const own = (process.env.PATH ?? \"\").split(delimiter).filter(Boolean);\n    const known = (entry: string) => own.includes(entry);\n    const fromShell = (login ?? \"\")\n      .split(delimiter)\n      .filter((entry) => entry && !known(entry));\n    const rest = [...own, ...fromShell];\n    const installed = wellKnownDirectories().filter((entry) => !rest.includes(entry));\n    return [...rest, ...installed].join(delimiter);\n  });\n  return resolved;\n}\n\n/** The first executable `name` on `path`, as an absolute path. */\nexport async function resolveBinary(\n  name: string,\n  path: string,\n): Promise<string | undefined> {\n  for (const directory of path.split(delimiter).filter(Boolean)) {\n    const candidate = join(directory, name);\n    const found = await access(candidate, constants.X_OK).then(\n      () => candidate,\n      () => undefined,\n    );\n    if (found !== undefined) return found;\n  }\n  return undefined;\n}\n\nexport async function agentEnvironment(): Promise<Record<string, string>> {\n  const env: Record<string, string> = {};\n  for (const [name, value] of Object.entries(process.env)) {\n    if (value !== undefined && !name.startsWith(\"PARLOR_\")) env[name] = value;\n  }\n  env.PATH = await agentPath();\n  return env;\n}\n"]}

package/dist/skeleton-kit.d.ts

@@ -0,0 +1,8 @@
+export declare const compact: (text: string) => string;
+export interface Difference {
+    readonly file: string;
+    readonly symbol: string;
+    readonly kind: "changed" | "missing" | "added";
+}
+export declare function differences(file: string, skeleton: string, actual: string, only?: readonly string[]): Difference[];
+//# sourceMappingURL=skeleton-kit.d.ts.map

package/dist/skeleton-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-kit.d.ts","sourceRoot":"","sources":["../src/skeleton-kit.ts"],"names":[],"mappings":"AA6DA,eAAO,MAAM,OAAO,SAAU,MAAM,WAIA,CAAC;AA8DrC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CAChD;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,EAAE,CAcd"}

package/dist/skeleton-kit.js

@@ -0,0 +1,143 @@
+const OPENING = "([{";
+const CLOSING = ")]}";
+function statementsOf(text) {
+    const statements = [];
+    let current = "";
+    let depth = 0;
+    const open = [];
+    for (let at = 0; at < text.length; at += 1) {
+        const char = text[at];
+        const next = text[at + 1];
+        if (char === "/" && next === "/") {
+            while (at < text.length && text[at] !== "\n")
+                at += 1;
+            continue;
+        }
+        if (char === "/" && next === "*") {
+            at = text.indexOf("*/", at + 2) + 1;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === "`") {
+            let end = at + 1;
+            while (end < text.length && text[end] !== char)
+                end += text[end] === "\\" ? 2 : 1;
+            current += text.slice(at, end + 1);
+            at = end;
+            continue;
+        }
+        if (CLOSING.includes(char) && depth === 0) {
+            current = "";
+            continue;
+        }
+        current += char;
+        if (OPENING.includes(char)) {
+            depth += 1;
+            open.push(CLOSING[OPENING.indexOf(char)]);
+        }
+        else if (CLOSING.includes(char)) {
+            depth -= 1;
+            open.pop();
+            const blockEnded = char === "}" && depth === 0;
+            const rest = text.slice(at + 1).match(/^\s*(\S)/)?.[1];
+            if (blockEnded && rest !== ";" && rest !== "," && rest !== "." && rest !== ")") {
+                const head = current.trim();
+                const isBlock = /^(export\s+)?(async\s+)?(function|interface|class|enum)\b/.test(head);
+                const hasBody = !/^(export\s+)?(async\s+)?function\b/.test(head) ||
+                    endOfSignature(head) < head.length;
+                if (isBlock && hasBody) {
+                    statements.push(current.trim());
+                    current = "";
+                }
+            }
+        }
+        else if (char === ";" && depth === 0) {
+            statements.push(current.trim());
+            current = "";
+        }
+    }
+    if (current.trim())
+        statements.push(`${current.trim()}${open.reverse().join("")}`);
+    return statements;
+}
+export const compact = (text) => text
+    .replace(/\s+/g, " ")
+    .replace(/\s*([(){}[\],;:<>|&=?])\s*/g, "$1")
+    .replace(/[,;](?=[)\]}>])/g, "");
+function endOfSignature(statement) {
+    let parens = 0;
+    let angles = 0;
+    let seenParams = false;
+    for (let at = 0; at < statement.length; at += 1) {
+        const char = statement[at];
+        if (char === "(")
+            parens += 1;
+        else if (char === ")") {
+            parens -= 1;
+            if (parens === 0)
+                seenParams = true;
+        }
+        else if (parens === 0 && seenParams) {
+            if (char === "<")
+                angles += 1;
+            else if (char === ">" && statement[at - 1] !== "=")
+                angles -= 1;
+            else if (char === "{" &&
+                angles === 0 &&
+                !/[:|&]\s*$/.test(statement.slice(0, at))) {
+                return at;
+            }
+        }
+    }
+    return statement.length;
+}
+function signaturesOf(text) {
+    const signatures = new Map();
+    const add = (name, signature) => signatures.set(name, [signatures.get(name), compact(signature)].filter(Boolean).join("\n"));
+    for (const statement of statementsOf(text)) {
+        if (!statement.startsWith("export"))
+            continue;
+        const declaration = statement.replace(/^export\s+(default\s+)?/, "");
+        const named = /^(?:async\s+)?(function|interface|type|class|enum)\s+(\w+)/.exec(declaration);
+        if (named) {
+            const [, kind, name] = named;
+            const keep = kind === "function"
+                ? declaration.slice(0, endOfSignature(declaration)).replace(/^async\s+/, "")
+                : declaration;
+            add(name, keep);
+        }
+        else if (/^(const|let)\s/.test(declaration)) {
+            const name = /^(?:const|let)\s+(\w+)/.exec(declaration)[1];
+            const [head] = declaration.split(/(?<![=!<>])=(?![=>])/);
+            const annotated = /^(?:const|let)\s+\w+\s*:/.test(declaration);
+            const callee = /=\s*([\w.]+(?:<[^(]*>)?)\(/.exec(declaration)?.[1];
+            add(name, annotated ? head : `${name} = ${callee ?? ""}`);
+        }
+        else if (/^(type\s+)?\{/.test(declaration) || declaration.startsWith("*")) {
+            for (const [, name] of declaration.matchAll(/(?:\btype\s+)?(\w+)(?=\s*[,}])/g)) {
+                if (name !== "type")
+                    add(name, "re-export");
+            }
+        }
+    }
+    return signatures;
+}
+export function differences(file, skeleton, actual, only) {
+    const wanted = signaturesOf(skeleton);
+    const found = signaturesOf(actual);
+    const names = new Set([...wanted.keys(), ...found.keys()]);
+    const out = [];
+    for (const symbol of [...names].sort()) {
+        if (only && !only.includes(symbol))
+            continue;
+        const before = wanted.get(symbol);
+        const after = found.get(symbol);
+        if (before === undefined)
+            out.push({ file, symbol, kind: "added" });
+        else if (after === undefined)
+            out.push({ file, symbol, kind: "missing" });
+        else if (before !== after)
+            out.push({ file, symbol, kind: "changed" });
+    }
+    return out;
+}
+//# sourceMappingURL=skeleton-kit.js.map

package/dist/skeleton-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-kit.js","sourceRoot":"","sources":["../src/skeleton-kit.ts"],"names":[],"mappings":"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","sourcesContent":["const OPENING = \"([{\";\nconst CLOSING = \")]}\";\n\nfunction statementsOf(text: string): string[] {\n  const statements: string[] = [];\n  let current = \"\";\n  let depth = 0;\n  const open: string[] = [];\n  for (let at = 0; at < text.length; at += 1) {\n    const char = text[at]!;\n    const next = text[at + 1];\n    if (char === \"/\" && next === \"/\") {\n      while (at < text.length && text[at] !== \"\\n\") at += 1;\n      continue;\n    }\n    if (char === \"/\" && next === \"*\") {\n      at = text.indexOf(\"*/\", at + 2) + 1;\n      continue;\n    }\n    if (char === '\"' || char === \"'\" || char === \"`\") {\n      let end = at + 1;\n      while (end < text.length && text[end] !== char) end += text[end] === \"\\\\\" ? 2 : 1;\n      current += text.slice(at, end + 1);\n      at = end;\n      continue;\n    }\n    if (CLOSING.includes(char) && depth === 0) {\n      current = \"\";\n      continue;\n    }\n    current += char;\n    if (OPENING.includes(char)) {\n      depth += 1;\n      open.push(CLOSING[OPENING.indexOf(char)]!);\n    } else if (CLOSING.includes(char)) {\n      depth -= 1;\n      open.pop();\n      const blockEnded = char === \"}\" && depth === 0;\n      const rest = text.slice(at + 1).match(/^\\s*(\\S)/)?.[1];\n      if (blockEnded && rest !== \";\" && rest !== \",\" && rest !== \".\" && rest !== \")\") {\n        const head = current.trim();\n        const isBlock = /^(export\\s+)?(async\\s+)?(function|interface|class|enum)\\b/.test(\n          head,\n        );\n        const hasBody =\n          !/^(export\\s+)?(async\\s+)?function\\b/.test(head) ||\n          endOfSignature(head) < head.length;\n        if (isBlock && hasBody) {\n          statements.push(current.trim());\n          current = \"\";\n        }\n      }\n    } else if (char === \";\" && depth === 0) {\n      statements.push(current.trim());\n      current = \"\";\n    }\n  }\n  if (current.trim()) statements.push(`${current.trim()}${open.reverse().join(\"\")}`);\n  return statements;\n}\n\nexport const compact = (text: string) =>\n  text\n    .replace(/\\s+/g, \" \")\n    .replace(/\\s*([(){}[\\],;:<>|&=?])\\s*/g, \"$1\")\n    .replace(/[,;](?=[)\\]}>])/g, \"\");\n\nfunction endOfSignature(statement: string): number {\n  let parens = 0;\n  let angles = 0;\n  let seenParams = false;\n  for (let at = 0; at < statement.length; at += 1) {\n    const char = statement[at]!;\n    if (char === \"(\") parens += 1;\n    else if (char === \")\") {\n      parens -= 1;\n      if (parens === 0) seenParams = true;\n    } else if (parens === 0 && seenParams) {\n      if (char === \"<\") angles += 1;\n      else if (char === \">\" && statement[at - 1] !== \"=\") angles -= 1;\n      else if (\n        char === \"{\" &&\n        angles === 0 &&\n        !/[:|&]\\s*$/.test(statement.slice(0, at))\n      ) {\n        return at;\n      }\n    }\n  }\n  return statement.length;\n}\n\nfunction signaturesOf(text: string): Map<string, string> {\n  const signatures = new Map<string, string>();\n  const add = (name: string, signature: string) =>\n    signatures.set(\n      name,\n      [signatures.get(name), compact(signature)].filter(Boolean).join(\"\\n\"),\n    );\n  for (const statement of statementsOf(text)) {\n    if (!statement.startsWith(\"export\")) continue;\n    const declaration = statement.replace(/^export\\s+(default\\s+)?/, \"\");\n    const named = /^(?:async\\s+)?(function|interface|type|class|enum)\\s+(\\w+)/.exec(\n      declaration,\n    );\n    if (named) {\n      const [, kind, name] = named;\n      const keep =\n        kind === \"function\"\n          ? declaration.slice(0, endOfSignature(declaration)).replace(/^async\\s+/, \"\")\n          : declaration;\n      add(name!, keep);\n    } else if (/^(const|let)\\s/.test(declaration)) {\n      const name = /^(?:const|let)\\s+(\\w+)/.exec(declaration)![1]!;\n      const [head] = declaration.split(/(?<![=!<>])=(?![=>])/);\n      const annotated = /^(?:const|let)\\s+\\w+\\s*:/.test(declaration);\n      const callee = /=\\s*([\\w.]+(?:<[^(]*>)?)\\(/.exec(declaration)?.[1];\n      add(name, annotated ? head! : `${name} = ${callee ?? \"\"}`);\n    } else if (/^(type\\s+)?\\{/.test(declaration) || declaration.startsWith(\"*\")) {\n      for (const [, name] of declaration.matchAll(/(?:\\btype\\s+)?(\\w+)(?=\\s*[,}])/g)) {\n        if (name !== \"type\") add(name!, \"re-export\");\n      }\n    }\n  }\n  return signatures;\n}\n\nexport interface Difference {\n  readonly file: string;\n  readonly symbol: string;\n  readonly kind: \"changed\" | \"missing\" | \"added\";\n}\n\nexport function differences(\n  file: string,\n  skeleton: string,\n  actual: string,\n  only?: readonly string[],\n): Difference[] {\n  const wanted = signaturesOf(skeleton);\n  const found = signaturesOf(actual);\n  const names = new Set([...wanted.keys(), ...found.keys()]);\n  const out: Difference[] = [];\n  for (const symbol of [...names].sort()) {\n    if (only && !only.includes(symbol)) continue;\n    const before = wanted.get(symbol);\n    const after = found.get(symbol);\n    if (before === undefined) out.push({ file, symbol, kind: \"added\" });\n    else if (after === undefined) out.push({ file, symbol, kind: \"missing\" });\n    else if (before !== after) out.push({ file, symbol, kind: \"changed\" });\n  }\n  return out;\n}\n"]}