@lordierclaw/bluenote 0.4.1

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { CommandIo } from "../types";
+export declare function runDoctor(args?: string[], io?: CommandIo): Promise<number>;

package/dist/commands/doctor.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const child_process_1 = require("child_process");
+const os_1 = __importDefault(require("os"));
+const paths_1 = require("../daemon/paths");
+const command_discovery_1 = require("../utils/command-discovery");
+const daemon_state_1 = require("../utils/daemon-state");
+const package_info_1 = require("../utils/package-info");
+const runtime_requirements_1 = require("../utils/runtime-requirements");
+const write_1 = require("../utils/write");
+const OPTIONAL_CLIENTS = ["bluenote-webui", "bluenote-term"];
+function isWindowsShellCommand(commandPath, platform) {
+    return platform === "win32" && /\.(cmd|bat)$/i.test(commandPath);
+}
+function runClientCheck(commandPath, args, io, platform, env) {
+    const spawnSync = io.spawnSync || child_process_1.spawnSync;
+    const result = spawnSync(commandPath, args, {
+        encoding: "utf8",
+        env,
+        shell: isWindowsShellCommand(commandPath, platform),
+        timeout: 5000,
+    });
+    return {
+        ok: !result.error && result.status === 0,
+        stdout: String(result.stdout || ""),
+        stderr: String(result.stderr || ""),
+    };
+}
+function firstLine(value) {
+    return value.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+}
+function checkBun(io) {
+    const spawnSync = io.spawnSync || child_process_1.spawnSync;
+    const result = spawnSync("bun", ["--version"], { encoding: "utf8", env: io.env || process.env });
+    if (result.error || result.status !== 0)
+        return { available: false };
+    return { available: true, version: String(result.stdout || "").trim() };
+}
+async function runDoctor(args = [], io = {}) {
+    const stdout = io.stdout || process.stdout;
+    const stderr = io.stderr || process.stderr;
+    const env = io.env || process.env;
+    const parsedClientMode = (0, command_discovery_1.parseClientModeArgs)(args, env);
+    if (!parsedClientMode.ok) {
+        (0, write_1.write)(stderr, parsedClientMode.message);
+        return 1;
+    }
+    const nodeVersion = io.nodeVersion || process.versions.node;
+    const platform = io.platform || process.platform;
+    const supportedNode = (0, runtime_requirements_1.isSupportedNodeVersion)(nodeVersion);
+    const ownPackage = (0, package_info_1.readOwnPackageInfo)();
+    (0, write_1.write)(stdout, "BlueNote doctor\n\n");
+    (0, write_1.write)(stdout, "Distribution\n");
+    (0, write_1.write)(stdout, "  command: ok\n");
+    (0, write_1.write)(stdout, `  version: ${ownPackage.version}\n`);
+    (0, write_1.write)(stdout, `  platform: ${platform} (${os_1.default.arch()})\n`);
+    (0, write_1.write)(stdout, `  node: ${supportedNode ? "ok" : "unsupported"} (${nodeVersion}; requires ${(0, runtime_requirements_1.nodeRequirementText)()})\n`);
+    (0, write_1.write)(stdout, `Node status: ${supportedNode ? "ok" : "unsupported"}\n`);
+    const daemon = await (0, daemon_state_1.readDaemonStatus)(env);
+    (0, write_1.write)(stdout, "\nDaemon\n");
+    (0, write_1.write)(stdout, `  status: ${daemon.state}\n`);
+    (0, write_1.write)(stdout, `  endpoint: ${daemon.metadata ? daemon.metadata.url : "unavailable"}\n`);
+    (0, write_1.write)(stdout, `  pid: ${daemon.metadata?.pid || "unavailable"}\n`);
+    (0, write_1.write)(stdout, `  token: ${daemon.metadata?.token ? "present" : "missing"}\n`);
+    (0, write_1.write)(stdout, `  health: ${daemon.healthOk ? "ok" : daemon.state === "stopped" ? "not checked" : "failed"}\n`);
+    (0, write_1.write)(stdout, "\nClients\n");
+    let builtTuiAvailable = false;
+    for (const client of OPTIONAL_CLIENTS) {
+        const resolution = (0, command_discovery_1.resolveClientCommand)(client, { env, clientMode: parsedClientMode.mode, platform, pathext: env.PATHEXT });
+        if (!resolution) {
+            (0, write_1.write)(stdout, `  ${client}: missing\n`);
+            (0, write_1.write)(stdout, "    version: unavailable\n");
+            (0, write_1.write)(stdout, "    daemon handshake: not checked\n");
+            continue;
+        }
+        const clientEnv = { ...env };
+        if (daemon.state === "running" && daemon.metadata) {
+            clientEnv.BLUENOTE_DAEMON_URL = daemon.metadata.url;
+            clientEnv.BLUENOTE_DAEMON_TOKEN = daemon.metadata.token;
+        }
+        const version = runClientCheck(resolution.path, ["--version"], io, platform, clientEnv);
+        const handshake = daemon.state === "running" && daemon.metadata
+            ? runClientCheck(resolution.path, ["--check-daemon"], io, platform, clientEnv)
+            : undefined;
+        const status = version.ok && (!handshake || handshake.ok) ? resolution.mode : "broken";
+        if (client === "bluenote-term" && resolution.mode === "built" && status === "built")
+            builtTuiAvailable = true;
+        (0, write_1.write)(stdout, `  ${client}: ${status}\n`);
+        (0, write_1.write)(stdout, `    path: ${resolution.path}\n`);
+        (0, write_1.write)(stdout, `    version: ${version.ok ? firstLine(version.stdout) || "available" : "unavailable"}\n`);
+        (0, write_1.write)(stdout, `    daemon handshake: ${handshake ? handshake.ok ? "ok" : "failed" : "not checked"}\n`);
+    }
+    if (builtTuiAvailable) {
+        (0, write_1.write)(stdout, "  Bun for source TUI: not required for built TUI\n");
+    }
+    else {
+        const bun = checkBun(io);
+        (0, write_1.write)(stdout, `  Bun for source TUI: ${bun.available ? `available${bun.version ? ` (${bun.version})` : ""}` : "not found; install Bun for source/development TUI usage"}\n`);
+    }
+    (0, write_1.write)(stdout, "\nConfig\n");
+    (0, write_1.write)(stdout, `  config dir: ${(0, paths_1.getBluenoteStateDir)(env)}\n`);
+    (0, write_1.write)(stdout, `  daemon state: ${(0, paths_1.getDaemonStatePath)(env)}\n`);
+    (0, write_1.write)(stdout, `  daemon endpoint: ${daemon.metadata ? daemon.metadata.url : "unavailable"}\n`);
+    (0, write_1.write)(stdout, "\nAI\n");
+    (0, write_1.write)(stdout, "  provider: not configured\n");
+    (0, write_1.write)(stdout, "  secrets: not printed\n");
+    return supportedNode ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandIo } from "../types";
+export declare const HELP_TEXT = "BlueNote distribution CLI\n\nUsage: bluenote <command> [options]\n       bn <command> [options]\n\nCommands:\n  tui [...args]             Launch the terminal interface via bluenote-term\n  web [...args]             Launch the local WebUI via bluenote-webui\n  daemon start|status|stop  Manage the local BlueNote daemon\n  doctor                    Check runtime, daemon, and optional clients\n  version                   Print package versions\n\nOptions:\n  -h, --help                Show this help message\n";
+export declare function runHelp(_args?: string[], io?: CommandIo): number;

package/dist/commands/help.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP_TEXT = void 0;
+exports.runHelp = runHelp;
+const write_1 = require("../utils/write");
+exports.HELP_TEXT = `BlueNote distribution CLI
+
+Usage: bluenote <command> [options]
+       bn <command> [options]
+
+Commands:
+  tui [...args]             Launch the terminal interface via bluenote-term
+  web [...args]             Launch the local WebUI via bluenote-webui
+  daemon start|status|stop  Manage the local BlueNote daemon
+  doctor                    Check runtime, daemon, and optional clients
+  version                   Print package versions
+
+Options:
+  -h, --help                Show this help message
+`;
+function runHelp(_args = [], io = {}) {
+    (0, write_1.write)(io.stdout || process.stdout, exports.HELP_TEXT);
+    return 0;
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":";;;AAmBA,0BAGC;AAtBD,0CAAsC;AAGzB,QAAA,SAAS,GAAG;;;;;;;;;;;;;;CAcxB,CAAA;AAED,SAAgB,OAAO,CAAC,QAAkB,EAAE,EAAE,KAAgB,EAAE;IAC9D,IAAA,aAAK,EAAC,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,iBAAS,CAAC,CAAA;IAC7C,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/commands/tui.d.ts

@@ -0,0 +1,2 @@
+import type { CommandIo } from "../types";
+export declare function runTui(args?: string[], io?: CommandIo): Promise<number>;

package/dist/commands/tui.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTui = runTui;
+const child_process_1 = require("child_process");
+const command_discovery_1 = require("../utils/command-discovery");
+const daemon_state_1 = require("../utils/daemon-state");
+const write_1 = require("../utils/write");
+function daemonNotRunning(io) {
+    (0, write_1.write)(io.stderr || process.stderr, "BlueNote daemon is not running.\nRun: bluenote daemon start\n");
+    return 1;
+}
+function missingClient(io, command, mode) {
+    if (mode === "built") {
+        (0, write_1.write)(io.stderr || process.stderr, `Built client ${command} was not found in BLUENOTE_BUILT_CLIENT_DIR. Install the BlueNote built client artifact, set BLUENOTE_BUILT_CLIENT_DIR to its directory, or retry with --client-mode path for PATH discovery.\n`);
+        return 1;
+    }
+    (0, write_1.write)(io.stderr || process.stderr, `Optional client ${command} was not found on PATH. Install it with npm install -g ${command} and retry.\n`);
+    return 1;
+}
+async function runTui(args = [], io = {}) {
+    const env = io.env || process.env;
+    const daemon = await (0, daemon_state_1.readDaemonStatus)(env);
+    if (daemon.state !== "running" || !daemon.metadata)
+        return daemonNotRunning(io);
+    const metadata = daemon.metadata;
+    const parsed = (0, command_discovery_1.parseClientModeArgs)(args, env);
+    if (!parsed.ok) {
+        (0, write_1.write)(io.stderr || process.stderr, parsed.message);
+        return 1;
+    }
+    const resolution = (0, command_discovery_1.resolveClientCommand)("bluenote-term", { env, clientMode: parsed.mode, platform: io.platform || process.platform, pathext: env.PATHEXT });
+    if (!resolution)
+        return missingClient(io, "bluenote-term", parsed.mode);
+    const spawn = io.spawn || child_process_1.spawn;
+    return await new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(resolution.path, parsed.args, {
+                stdio: ["inherit", "inherit", "inherit"],
+                shell: (io.platform || process.platform) === "win32" && /\.(cmd|bat)$/i.test(resolution.path),
+                env: {
+                    ...env,
+                    BLUENOTE_DAEMON_URL: metadata.url,
+                    BLUENOTE_DAEMON_TOKEN: metadata.token,
+                },
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            (0, write_1.write)(io.stderr || process.stderr, `Unable to launch bluenote-term: ${message}\n`);
+            resolve(1);
+            return;
+        }
+        child.on("error", (error) => {
+            (0, write_1.write)(io.stderr || process.stderr, `Unable to launch bluenote-term: ${error.message}\n`);
+            resolve(1);
+        });
+        child.on("exit", (code) => {
+            resolve(code === null ? 1 : code);
+        });
+    });
+}
+//# sourceMappingURL=tui.js.map

package/dist/commands/tui.js.map

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

package/dist/commands/version.d.ts

@@ -0,0 +1,2 @@
+import type { CommandIo } from "../types";
+export declare function runVersion(_args?: string[], io?: CommandIo): number;

package/dist/commands/version.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVersion = runVersion;
+const package_info_1 = require("../utils/package-info");
+const write_1 = require("../utils/write");
+const RUNTIME_PACKAGES = ["@lordierclaw/bluenote-core"];
+function runVersion(_args = [], io = {}) {
+    const own = (0, package_info_1.readOwnPackageInfo)();
+    const lines = [`${own.name} ${own.version}`];
+    for (const packageName of RUNTIME_PACKAGES) {
+        const resolution = (0, package_info_1.resolvePackageJson)(packageName);
+        lines.push(`${packageName} ${resolution.version || (resolution.resolved ? "version unavailable" : "not installed")}`);
+    }
+    (0, write_1.write)(io.stdout || process.stdout, `${lines.join("\n")}\n`);
+    return 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":";;AAMA,gCAWC;AAhBD,wDAA8E;AAC9E,0CAAsC;AAEtC,MAAM,gBAAgB,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAEvD,SAAgB,UAAU,CAAC,QAAkB,EAAE,EAAE,KAAgB,EAAE;IACjE,MAAM,GAAG,GAAG,IAAA,iCAAkB,GAAE,CAAA;IAChC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IAE5C,KAAK,MAAM,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,WAAW,CAAC,CAAA;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,IAAI,UAAU,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACvH,CAAC;IAED,IAAA,aAAK,EAAC,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3D,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/commands/web.d.ts

@@ -0,0 +1,2 @@
+import type { CommandIo } from "../types";
+export declare function runWeb(args?: string[], io?: CommandIo): Promise<number>;

package/dist/commands/web.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWeb = runWeb;
+const child_process_1 = require("child_process");
+const command_discovery_1 = require("../utils/command-discovery");
+const daemon_state_1 = require("../utils/daemon-state");
+const write_1 = require("../utils/write");
+function daemonNotRunning(io) {
+    (0, write_1.write)(io.stderr || process.stderr, "BlueNote daemon is not running.\nRun: bluenote daemon start\n");
+    return 1;
+}
+function missingClient(io, command, mode) {
+    if (mode === "built") {
+        (0, write_1.write)(io.stderr || process.stderr, `Built client ${command} was not found in BLUENOTE_BUILT_CLIENT_DIR. Install the BlueNote built client artifact, set BLUENOTE_BUILT_CLIENT_DIR to its directory, or retry with --client-mode path for PATH discovery.\n`);
+        return 1;
+    }
+    (0, write_1.write)(io.stderr || process.stderr, `Optional client ${command} was not found on PATH. Install it with npm install -g ${command} and retry.\n`);
+    return 1;
+}
+async function runWeb(args = [], io = {}) {
+    const env = io.env || process.env;
+    const daemon = await (0, daemon_state_1.readDaemonStatus)(env);
+    if (daemon.state !== "running" || !daemon.metadata)
+        return daemonNotRunning(io);
+    const metadata = daemon.metadata;
+    const parsed = (0, command_discovery_1.parseClientModeArgs)(args, env);
+    if (!parsed.ok) {
+        (0, write_1.write)(io.stderr || process.stderr, parsed.message);
+        return 1;
+    }
+    const resolution = (0, command_discovery_1.resolveClientCommand)("bluenote-webui", { env, clientMode: parsed.mode, platform: io.platform || process.platform, pathext: env.PATHEXT });
+    if (!resolution)
+        return missingClient(io, "bluenote-webui", parsed.mode);
+    const spawn = io.spawn || child_process_1.spawn;
+    return await new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(resolution.path, parsed.args, {
+                stdio: ["inherit", "inherit", "inherit"],
+                shell: (io.platform || process.platform) === "win32" && /\.(cmd|bat)$/i.test(resolution.path),
+                env: {
+                    ...env,
+                    BLUENOTE_DAEMON_URL: metadata.url,
+                    BLUENOTE_DAEMON_TOKEN: metadata.token,
+                },
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            (0, write_1.write)(io.stderr || process.stderr, `Unable to launch bluenote-webui: ${message}\n`);
+            resolve(1);
+            return;
+        }
+        child.on("error", (error) => {
+            (0, write_1.write)(io.stderr || process.stderr, `Unable to launch bluenote-webui: ${error.message}\n`);
+            resolve(1);
+        });
+        child.on("exit", (code) => {
+            resolve(code === null ? 1 : code);
+        });
+    });
+}
+//# sourceMappingURL=web.js.map

package/dist/commands/web.js.map

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

package/dist/daemon/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getBluenoteStateDir(env?: NodeJS.ProcessEnv): string;
+export declare function getDaemonStatePath(env?: NodeJS.ProcessEnv): string;
+export declare function ensureParentDir(filePath: string): void;

package/dist/daemon/paths.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBluenoteStateDir = getBluenoteStateDir;
+exports.getDaemonStatePath = getDaemonStatePath;
+exports.ensureParentDir = ensureParentDir;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+function getBluenoteStateDir(env = process.env) {
+    if (env.BLUENOTE_DAEMON_STATE)
+        return path_1.default.dirname(env.BLUENOTE_DAEMON_STATE);
+    if (env.BLUENOTE_CONFIG_HOME)
+        return path_1.default.join(env.BLUENOTE_CONFIG_HOME, "bluenote");
+    if (env.XDG_CONFIG_HOME)
+        return path_1.default.join(env.XDG_CONFIG_HOME, "bluenote");
+    return path_1.default.join(os_1.default.homedir(), ".config", "bluenote");
+}
+function getDaemonStatePath(env = process.env) {
+    if (env.BLUENOTE_DAEMON_STATE)
+        return env.BLUENOTE_DAEMON_STATE;
+    return path_1.default.join(getBluenoteStateDir(env), "daemon.json");
+}
+function ensureParentDir(filePath) {
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/daemon/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/daemon/paths.ts"],"names":[],"mappings":";;;;;AAIA,kDAKC;AAED,gDAGC;AAED,0CAEC;AAlBD,4CAAmB;AACnB,4CAAmB;AACnB,gDAAuB;AAEvB,SAAgB,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,IAAI,GAAG,CAAC,qBAAqB;QAAE,OAAO,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IAC7E,IAAI,GAAG,CAAC,oBAAoB;QAAE,OAAO,cAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAA;IACpF,IAAI,GAAG,CAAC,eAAe;QAAE,OAAO,cAAI,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;IAC1E,OAAO,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AACvD,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,IAAI,GAAG,CAAC,qBAAqB;QAAE,OAAO,GAAG,CAAC,qBAAqB,CAAA;IAC/D,OAAO,cAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAA;AAC3D,CAAC;AAED,SAAgB,eAAe,CAAC,QAAgB;IAC9C,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3D,CAAC"}

package/dist/daemon/router.d.ts

@@ -0,0 +1,38 @@
+import http from "http";
+export type ApiErrorBody = {
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+};
+export type DaemonRequestContext = {
+    request: http.IncomingMessage;
+    response: http.ServerResponse;
+    url: URL;
+};
+export type DaemonRouteHandler = (context: DaemonRequestContext) => void | Promise<void>;
+export type DaemonRouteOptions = {
+    auth?: boolean;
+};
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly hint?: string;
+    constructor(statusCode: number, code: string, message: string, hint?: string);
+}
+export declare function writeJson(response: http.ServerResponse, statusCode: number, body: unknown): void;
+export declare function toApiErrorBody(error: unknown): {
+    statusCode: number;
+    body: ApiErrorBody;
+};
+export declare function isBearerAuthorized(request: http.IncomingMessage, token: string): boolean;
+export declare function requireBearerAuth(request: http.IncomingMessage, token: string): void;
+export declare function readRequestBody(request: http.IncomingMessage, limitBytes?: number): Promise<string>;
+export type DaemonRouter = {
+    get(path: string, handler: DaemonRouteHandler, options?: DaemonRouteOptions): void;
+    post(path: string, handler: DaemonRouteHandler, options?: DaemonRouteOptions): void;
+    register(method: string, path: string, handler: DaemonRouteHandler, options?: DaemonRouteOptions): void;
+    handle(request: http.IncomingMessage, response: http.ServerResponse): void;
+};
+export declare function createDaemonRouter(token: string): DaemonRouter;

package/dist/daemon/router.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = void 0;
+exports.writeJson = writeJson;
+exports.toApiErrorBody = toApiErrorBody;
+exports.isBearerAuthorized = isBearerAuthorized;
+exports.requireBearerAuth = requireBearerAuth;
+exports.readRequestBody = readRequestBody;
+exports.createDaemonRouter = createDaemonRouter;
+class HttpError extends Error {
+    constructor(statusCode, code, message, hint) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.hint = hint;
+    }
+}
+exports.HttpError = HttpError;
+function writeJson(response, statusCode, body) {
+    const text = JSON.stringify(body);
+    response.writeHead(statusCode, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(text),
+    });
+    response.end(text);
+}
+function toApiErrorBody(error) {
+    if (error instanceof HttpError) {
+        return {
+            statusCode: error.statusCode,
+            body: {
+                error: {
+                    code: error.code,
+                    message: error.message,
+                    ...(error.hint ? { hint: error.hint } : {}),
+                },
+            },
+        };
+    }
+    return {
+        statusCode: 500,
+        body: { error: { code: "internal_error", message: "Unexpected daemon error" } },
+    };
+}
+function isBearerAuthorized(request, token) {
+    const authorization = request.headers.authorization || "";
+    return authorization === `Bearer ${token}`;
+}
+function requireBearerAuth(request, token) {
+    if (!isBearerAuthorized(request, token)) {
+        throw new HttpError(401, "unauthorized", "Missing or invalid daemon token");
+    }
+}
+async function readRequestBody(request, limitBytes = 1024 * 1024) {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+        totalBytes += buffer.byteLength;
+        if (totalBytes > limitBytes) {
+            throw new HttpError(400, "request_too_large", "Request body is too large");
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function createDaemonRouter(token) {
+    const routes = [];
+    function register(method, path, handler, options = {}) {
+        routes.push({ method: method.toUpperCase(), path, handler, auth: options.auth !== false });
+    }
+    function handle(request, response) {
+        const url = new URL(request.url || "/", "http://127.0.0.1");
+        const method = request.method || "GET";
+        const route = routes.find((candidate) => candidate.method === method && candidate.path === url.pathname);
+        Promise.resolve()
+            .then(async () => {
+            if (!route) {
+                requireBearerAuth(request, token);
+                throw new HttpError(404, "not_found", "Route not found");
+            }
+            if (route.auth) {
+                requireBearerAuth(request, token);
+            }
+            await route.handler({ request, response, url });
+        })
+            .catch((error) => {
+            if (response.headersSent || response.writableEnded) {
+                response.end();
+                return;
+            }
+            const { statusCode, body } = toApiErrorBody(error);
+            writeJson(response, statusCode, body);
+        });
+    }
+    return {
+        get(path, handler, options) {
+            register("GET", path, handler, options);
+        },
+        post(path, handler, options) {
+            register("POST", path, handler, options);
+        },
+        register,
+        handle,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/daemon/router.js.map

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

package/dist/daemon/server.d.ts

@@ -0,0 +1,13 @@
+export type DaemonMetadata = {
+    pid: number;
+    url: string;
+    token: string;
+    startedAt: string;
+    version: string;
+};
+export type DaemonServerOptions = {
+    statePath: string;
+    token: string;
+    version: string;
+};
+export declare function startDaemonServer(options: DaemonServerOptions): Promise<void>;

package/dist/daemon/server.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDaemonServer = startDaemonServer;
+const fs_1 = __importDefault(require("fs"));
+const http_1 = __importDefault(require("http"));
+const paths_1 = require("./paths");
+const router_1 = require("./router");
+const BLUENOTE_DAEMON_API_VERSION = "1";
+async function startDaemonServer(options) {
+    const router = (0, router_1.createDaemonRouter)(options.token);
+    const server = http_1.default.createServer((request, response) => router.handle(request, response));
+    router.get("/health", ({ response }) => {
+        (0, router_1.writeJson)(response, 200, { ok: true, name: "bluenote-daemon", version: options.version });
+    }, { auth: false });
+    router.get("/capabilities", ({ response }) => {
+        (0, router_1.writeJson)(response, 200, {
+            ok: true,
+            name: "bluenote-daemon",
+            version: options.version,
+            mode: "local-only",
+            apiVersion: BLUENOTE_DAEMON_API_VERSION,
+            workspaceApi: true,
+            notesApi: false,
+            aiApi: false,
+            clients: {
+                web: { daemonEnvironment: true },
+                tui: { daemonEnvironment: true },
+            },
+        });
+    });
+    router.post("/shutdown", ({ response }) => {
+        (0, router_1.writeJson)(response, 200, { ok: true });
+        server.close(() => {
+            try {
+                fs_1.default.rmSync(options.statePath, { force: true });
+            }
+            finally {
+                process.exit(0);
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => resolve());
+    });
+    const address = server.address();
+    const metadata = {
+        pid: process.pid,
+        url: `http://127.0.0.1:${address.port}`,
+        token: options.token,
+        startedAt: new Date().toISOString(),
+        version: options.version,
+    };
+    (0, paths_1.ensureParentDir)(options.statePath);
+    fs_1.default.rmSync(options.statePath, { force: true });
+    fs_1.default.writeFileSync(options.statePath, `${JSON.stringify(metadata, null, 2)}\n`, { mode: 0o600 });
+    fs_1.default.chmodSync(options.statePath, 0o600);
+    const cleanup = () => {
+        try {
+            fs_1.default.rmSync(options.statePath, { force: true });
+        }
+        catch {
+            // best effort
+        }
+    };
+    process.once("SIGTERM", () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.once("SIGINT", () => {
+        cleanup();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/daemon/server.js.map

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

package/dist/daemon/token.d.ts

@@ -0,0 +1 @@
+export declare function createDaemonToken(): string;