@parlor/agent-host 0.0.0-stage → 0.1.0

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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"}

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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAC/B,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,IAAI,QAAqC,CAAC;AAE1C,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC;IAChC,mBAAmB;IACnB,gBAAgB;CACjB,CAAC;AAEF,SAAS,cAAc;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,UAAU,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,EAAE;YACxE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QACH,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,QAAQ,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;aAC5B,KAAK,CAAC,SAAS,CAAC;aAChB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAAY;IAEZ,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CACxD,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC5E,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;IAC7B,OAAO,GAAG,CAAC;AACb,CAAC"}

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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"}

package/dist/spec-kit.d.ts

@@ -0,0 +1,102 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+import { type AnswerToSign, type ItemSignature, type PromptToSign } from "@parlor/chat";
+import { type DeviceKeys, type DeviceVouch, type FrameworkServer } from "@parlor/server";
+import type { AppGrant, HostKeys } from "./grants.js";
+import type { TrustedDevice, TrustStore } from "./trust.js";
+export declare const PASSWORD = "correct horse battery staple";
+export declare class Browser {
+    #private;
+    readonly origin: string;
+    constructor(origin: string);
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    consent(url: string, decision: "connect" | "cancel"): Promise<{
+        readonly page: string;
+        readonly answer: Response;
+    }>;
+}
+export interface SpecApp {
+    readonly origin: string;
+    readonly server: FrameworkServer;
+    signUp(name: string): Promise<Browser>;
+    close(): Promise<void>;
+}
+export declare function startSpecApp(): Promise<SpecApp>;
+export declare function memoryHostKeys(): HostKeys & {
+    readonly origins: () => readonly string[];
+};
+export declare function memoryTrust(): TrustStore & {
+    readonly pins: () => TrustedDevice[];
+};
+export declare class TestDevice {
+    readonly keys: DeviceKeys;
+    private readonly signing;
+    private readonly presence;
+    private constructor();
+    static create(id?: string, name?: string, platform?: string): Promise<TestDevice>;
+    get id(): import("@parlor/core").DeviceId;
+    private sign;
+    signPrompt(app: string, prompt: PromptToSign, at: number, presence?: boolean): Promise<ItemSignature>;
+    signAnswer(app: string, answer: AnswerToSign, at: number, presence: boolean): Promise<ItemSignature>;
+    /** This device's vouch for `device`, signed with its presence key unless `presence` is false. */
+    vouchFor(app: string, device: DeviceKeys, at: number, options?: {
+        readonly presence?: boolean;
+        readonly commitment?: string;
+    }): Promise<DeviceVouch>;
+}
+export interface StubApp {
+    readonly origin: string;
+    readonly seen: {
+        readonly method: string;
+        readonly path: string;
+        readonly body: string;
+    }[];
+    close(): Promise<void>;
+}
+export type Route = (request: IncomingMessage, body: string, response: ServerResponse) => boolean;
+export declare function stubApp(route: Route): Promise<StubApp>;
+export declare const json: (response: ServerResponse, value: unknown, status?: number) => ServerResponse<IncomingMessage>;
+export declare const welcome: {
+    id: string;
+    accepted: boolean;
+    protocol: number;
+    leaseMs: number;
+    heartbeatMs: number;
+};
+export declare function hostRoutes(options: {
+    readonly wake: boolean;
+    readonly turn?: () => unknown;
+}): Route;
+export declare const claimedTurn: (turnId: string, agentId: string, context: string, text: string) => {
+    id: string;
+    turnId: string;
+    agent: {
+        hostId: string;
+        agentId: string;
+    };
+    clientId: string;
+    prompt: {
+        id: string;
+        threadId: string;
+        turnId: string;
+        seq: number;
+        at: number;
+        author: string;
+        kind: string;
+        body: {
+            text: string;
+            agent: {
+                hostId: string;
+                agentId: string;
+            };
+        };
+    };
+    device: undefined;
+    context: string;
+    token: {
+        token: string;
+        expiresAt: number;
+    };
+    leaseUntil: number;
+};
+export declare const grantFor: (origin: string, name: string, workspace: string) => AppGrant;
+//# sourceMappingURL=spec-kit.d.ts.map

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

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