straylight-ai 0.1.0

package/bin/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+"use strict";
+
+const path = require("path");
+
+const command = process.argv[2] || "setup";
+
+const validCommands = ["setup", "start", "stop", "status", "mcp"];
+
+if (!validCommands.includes(command)) {
+  console.error(`Unknown command: ${command}`);
+  console.error(`Valid commands: ${validCommands.join(", ")}`);
+  process.exit(1);
+}
+
+// The MCP command proxies to the mcp-shim
+if (command === "mcp") {
+  require(path.join(__dirname, "mcp-shim.js"));
+  return;
+}
+
+// Dynamically require compiled TypeScript output from dist/
+const commandModule = require(path.join(__dirname, "..", "dist", "commands", command + ".js"));
+
+let runner;
+if (command === "setup") runner = commandModule.runSetup;
+else if (command === "start") runner = commandModule.runStart;
+else if (command === "stop") runner = commandModule.runStop;
+else if (command === "status") runner = commandModule.runStatus;
+
+if (typeof runner !== "function") {
+  console.error(`Internal error: could not find runner for command "${command}"`);
+  process.exit(1);
+}
+
+runner().catch((err) => {
+  console.error(`Error: ${err.message}`);
+  process.exit(1);
+});

package/bin/mcp-shim.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * MCP binary launcher for Straylight-AI.
+ *
+ * Resolution order:
+ *   1. Platform-specific binary from optionalDependencies
+ *      (@straylight-ai/bin-<platform>-<arch>)
+ *   2. Docker exec fallback: `docker exec -i straylight-ai straylight-mcp`
+ *
+ * stdin/stdout/stderr are passed through so the MCP host can communicate
+ * over stdio as required by the MCP protocol.
+ */
+
+const { spawn } = require("child_process");
+const path = require("path");
+const os = require("os");
+
+const CONTAINER_NAME = "straylight-ai";
+const BIN_NAME = os.platform() === "win32" ? "straylight-mcp.exe" : "straylight-mcp";
+
+function tryLocalBinary() {
+  const platform = os.platform();
+  // Map Node's os.arch() to the arch strings used in package names
+  const archMap = { x64: "x64", arm64: "arm64" };
+  const arch = archMap[os.arch()];
+  if (!arch) return null;
+
+  const pkgName = `@straylight-ai/bin-${platform}-${arch}`;
+
+  try {
+    const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+    const binPath = path.join(path.dirname(pkgJsonPath), BIN_NAME);
+    return binPath;
+  } catch {
+    return null;
+  }
+}
+
+function execBinary(binPath, args) {
+  const child = spawn(binPath, args, { stdio: "inherit" });
+  child.on("error", (err) => {
+    console.error(`Failed to launch ${binPath}: ${err.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    process.exit(code ?? 1);
+  });
+}
+
+function execDockerFallback(args) {
+  // Check that docker (or podman) is available
+  const { execSync } = require("child_process");
+  let runtime = null;
+  for (const rt of ["docker", "podman"]) {
+    try {
+      execSync(`${rt} --version`, { stdio: "pipe" });
+      runtime = rt;
+      break;
+    } catch {
+      // continue
+    }
+  }
+
+  if (!runtime) {
+    console.error(
+      "straylight-mcp: no local binary and no container runtime found.\n" +
+        "Install Docker: https://docs.docker.com/get-docker/\n" +
+        "or run `npx straylight-ai setup` first."
+    );
+    process.exit(1);
+  }
+
+  execBinary(runtime, ["exec", "-i", CONTAINER_NAME, "straylight-mcp", ...args]);
+}
+
+const localBin = tryLocalBinary();
+const extraArgs = process.argv.slice(2);
+
+if (localBin) {
+  execBinary(localBin, extraArgs);
+} else {
+  execDockerFallback(extraArgs);
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Full bootstrap: pull image if needed, create/start container, wait for
+ * health check, register MCP server, and open the browser.
+ *
+ * This operation is idempotent: calling it when the container is already
+ * running will skip the create/start steps and go straight to health + open.
+ */
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD9C"}

package/dist/commands/setup.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSetup = runSetup;
+const child_process_1 = require("child_process");
+const docker_js_1 = require("../docker.js");
+const health_js_1 = require("../health.js");
+const mcp_register_js_1 = require("../mcp-register.js");
+const open_js_1 = require("../open.js");
+const HEALTH_URL = "http://localhost:9470/api/v1/health";
+const HEALTH_TIMEOUT_MS = 30_000;
+const UI_URL = "http://localhost:9470";
+/**
+ * Full bootstrap: pull image if needed, create/start container, wait for
+ * health check, register MCP server, and open the browser.
+ *
+ * This operation is idempotent: calling it when the container is already
+ * running will skip the create/start steps and go straight to health + open.
+ */
+async function runSetup() {
+    const runtime = (0, docker_js_1.detectRuntime)();
+    if (!runtime) {
+        throw new Error("Neither Docker nor Podman was found on your PATH.\n" +
+            "Install Docker Desktop: https://docs.docker.com/get-docker/\n" +
+            "or Podman: https://podman.io/getting-started/installation");
+    }
+    console.log(`Using container runtime: ${runtime}`);
+    const status = await (0, docker_js_1.getContainerStatus)(runtime);
+    if (status === "not_found") {
+        console.log("Creating and starting Straylight-AI container...");
+        (0, child_process_1.execSync)((0, docker_js_1.buildRunCommand)(runtime), { stdio: "inherit" });
+    }
+    else if (status === "stopped") {
+        console.log("Starting existing Straylight-AI container...");
+        (0, child_process_1.execSync)((0, docker_js_1.buildStartCommand)(runtime), { stdio: "inherit" });
+    }
+    else {
+        console.log("Straylight-AI container is already running.");
+    }
+    console.log("Waiting for Straylight-AI to be ready...");
+    await (0, health_js_1.waitForHealth)(HEALTH_URL, HEALTH_TIMEOUT_MS);
+    console.log("Straylight-AI is ready.");
+    const registered = await (0, mcp_register_js_1.registerMCP)();
+    if (registered) {
+        console.log("MCP server registered with Claude Code.");
+    }
+    else {
+        console.log((0, mcp_register_js_1.manualRegistrationInstructions)());
+    }
+    await (0, open_js_1.openBrowser)(UI_URL);
+    console.log([
+        "",
+        "Straylight-AI is running at http://localhost:9470",
+        "",
+        "Next steps:",
+        "  1. Open http://localhost:9470 in your browser",
+        "  2. Add your service credentials via the Web UI",
+        "  3. Use Claude Code with the straylight-ai MCP server",
+        "",
+    ].join("\n"));
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":";;AAsBA,4BAiDC;AAvED,iDAAyC;AACzC,4CAKsB;AACtB,4CAA6C;AAC7C,wDAAiF;AACjF,wCAAyC;AAEzC,MAAM,UAAU,GAAG,qCAAqC,CAAC;AACzD,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,GAAG,uBAAuB,CAAC;AAEvC;;;;;;GAMG;AACI,KAAK,UAAU,QAAQ;IAC5B,MAAM,OAAO,GAAG,IAAA,yBAAa,GAAE,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,+DAA+D;YAC/D,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAkB,EAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,IAAA,wBAAQ,EAAC,IAAA,2BAAe,EAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,IAAA,wBAAQ,EAAC,IAAA,6BAAiB,EAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,MAAM,IAAA,yBAAa,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAG,MAAM,IAAA,6BAAW,GAAE,CAAC;IACvC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAA,gDAA8B,GAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,IAAA,qBAAW,EAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,CAAC,GAAG,CACT;QACE,EAAE;QACF,mDAAmD;QACnD,EAAE;QACF,aAAa;QACb,iDAAiD;QACjD,kDAAkD;QAClD,wDAAwD;QACxD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

package/dist/commands/start.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Start an existing stopped container and wait for health.
+ * Errors if the container does not exist (use `setup` instead).
+ */
+export declare function runStart(): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B9C"}

package/dist/commands/start.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStart = runStart;
+const child_process_1 = require("child_process");
+const docker_js_1 = require("../docker.js");
+const health_js_1 = require("../health.js");
+const HEALTH_URL = "http://localhost:9470/api/v1/health";
+const HEALTH_TIMEOUT_MS = 30_000;
+/**
+ * Start an existing stopped container and wait for health.
+ * Errors if the container does not exist (use `setup` instead).
+ */
+async function runStart() {
+    const runtime = (0, docker_js_1.detectRuntime)();
+    if (!runtime) {
+        throw new Error("Neither Docker nor Podman was found on your PATH.\n" +
+            "Install Docker Desktop: https://docs.docker.com/get-docker/");
+    }
+    const status = await (0, docker_js_1.getContainerStatus)(runtime);
+    if (status === "not_found") {
+        throw new Error("Straylight-AI container not found. Run `npx straylight-ai setup` first.");
+    }
+    if (status === "running") {
+        console.log("Straylight-AI is already running.");
+        return;
+    }
+    console.log("Starting Straylight-AI...");
+    (0, child_process_1.execSync)((0, docker_js_1.buildStartCommand)(runtime), { stdio: "inherit" });
+    console.log("Waiting for Straylight-AI to be ready...");
+    await (0, health_js_1.waitForHealth)(HEALTH_URL, HEALTH_TIMEOUT_MS);
+    console.log("Straylight-AI is ready at http://localhost:9470");
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":";;AAeA,4BA4BC;AA3CD,iDAAyC;AACzC,4CAIsB;AACtB,4CAA6C;AAE7C,MAAM,UAAU,GAAG,qCAAqC,CAAC;AACzD,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC;;;GAGG;AACI,KAAK,UAAU,QAAQ;IAC5B,MAAM,OAAO,GAAG,IAAA,yBAAa,GAAE,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,6DAA6D,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAkB,EAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,IAAA,wBAAQ,EAAC,IAAA,6BAAiB,EAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE3D,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,MAAM,IAAA,yBAAa,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;AACjE,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,11 @@
+import { HealthResponse } from "../health.js";
+/** Result returned by runStatus */
+export interface StatusResult {
+    containerStatus: "running" | "stopped" | "not_found";
+    health?: HealthResponse;
+}
+/**
+ * Check the container status and, if running, fetch and display health info.
+ */
+export declare function runStatus(): Promise<StatusResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,cAAc,EAAE,MAAM,cAAc,CAAC;AAI3D,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IACrD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAoCvD"}

package/dist/commands/status.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStatus = runStatus;
+const docker_js_1 = require("../docker.js");
+const health_js_1 = require("../health.js");
+const HEALTH_URL = "http://localhost:9470/api/v1/health";
+/**
+ * Check the container status and, if running, fetch and display health info.
+ */
+async function runStatus() {
+    const runtime = (0, docker_js_1.detectRuntime)();
+    if (!runtime) {
+        throw new Error("Neither Docker nor Podman was found on your PATH.\n" +
+            "Install Docker Desktop: https://docs.docker.com/get-docker/");
+    }
+    const containerStatus = await (0, docker_js_1.getContainerStatus)(runtime);
+    const result = { containerStatus };
+    if (containerStatus === "running") {
+        try {
+            result.health = await (0, health_js_1.checkHealth)(HEALTH_URL);
+            console.log("Straylight-AI is running.");
+            console.log(`  Status: ${result.health.status}`);
+            if (result.health.version) {
+                console.log(`  Version: ${result.health.version}`);
+            }
+            console.log("  URL: http://localhost:9470");
+        }
+        catch {
+            console.log("Straylight-AI container is running but not yet healthy.");
+        }
+    }
+    else if (containerStatus === "stopped") {
+        console.log('Straylight-AI container is stopped. Run `npx straylight-ai start` to start it.');
+    }
+    else {
+        console.log('Straylight-AI is not installed. Run `npx straylight-ai setup` to get started.');
+    }
+    return result;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":";;AAcA,8BAoCC;AAlDD,4CAAiE;AACjE,4CAA2D;AAE3D,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAQzD;;GAEG;AACI,KAAK,UAAU,SAAS;IAC7B,MAAM,OAAO,GAAG,IAAA,yBAAa,GAAE,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,6DAA6D,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,IAAA,8BAAkB,EAAC,OAAO,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAiB,EAAE,eAAe,EAAE,CAAC;IAEjD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,GAAG,MAAM,IAAA,uBAAW,EAAC,UAAU,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CACT,gFAAgF,CACjF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/stop.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Stop the running Straylight-AI container.
+ * No-op if the container is not currently running.
+ */
+export declare function runStop(): Promise<void>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB7C"}

package/dist/commands/stop.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStop = runStop;
+const child_process_1 = require("child_process");
+const docker_js_1 = require("../docker.js");
+/**
+ * Stop the running Straylight-AI container.
+ * No-op if the container is not currently running.
+ */
+async function runStop() {
+    const runtime = (0, docker_js_1.detectRuntime)();
+    if (!runtime) {
+        throw new Error("Neither Docker nor Podman was found on your PATH.\n" +
+            "Install Docker Desktop: https://docs.docker.com/get-docker/");
+    }
+    const running = await (0, docker_js_1.isContainerRunning)(runtime);
+    if (!running) {
+        console.log("Straylight-AI is not currently running.");
+        return;
+    }
+    console.log("Stopping Straylight-AI...");
+    (0, child_process_1.execSync)((0, docker_js_1.buildStopCommand)(runtime), { stdio: "inherit" });
+    console.log("Straylight-AI stopped.");
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":";;AAWA,0BAmBC;AA9BD,iDAAyC;AACzC,4CAIsB;AAEtB;;;GAGG;AACI,KAAK,UAAU,OAAO;IAC3B,MAAM,OAAO,GAAG,IAAA,yBAAa,GAAE,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,6DAA6D,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,IAAA,8BAAkB,EAAC,OAAO,CAAC,CAAC;IAElD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,IAAA,wBAAQ,EAAC,IAAA,4BAAgB,EAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AACxC,CAAC"}

package/dist/docker.d.ts

@@ -0,0 +1,42 @@
+/** Name of the managed container */
+export declare const CONTAINER_NAME = "straylight-ai";
+/** Docker image to pull and run */
+export declare const CONTAINER_IMAGE = "ghcr.io/aj-geddes/straylight-ai:latest";
+/** Host port mapped to container port 9470 */
+export declare const CONTAINER_PORT = 9470;
+/** Host data directory mounted at /data inside the container */
+export declare const DATA_DIR: string;
+/** Container status values */
+export type ContainerStatus = "running" | "stopped" | "not_found";
+/** Supported container runtimes */
+export type Runtime = "docker" | "podman";
+/**
+ * Detect whether docker or podman is available on the host.
+ * Returns the first available runtime, or null if neither is found.
+ */
+export declare function detectRuntime(): Runtime | null;
+/**
+ * Get the status of the straylight-ai container.
+ */
+export declare function getContainerStatus(runtime: string): Promise<ContainerStatus>;
+/**
+ * Returns true when the container is currently running.
+ */
+export declare function isContainerRunning(runtime: string): Promise<boolean>;
+/**
+ * Build the docker/podman run command string.
+ */
+export declare function buildRunCommand(runtime: string): string;
+/**
+ * Build the docker/podman start command string.
+ */
+export declare function buildStartCommand(runtime: string): string;
+/**
+ * Build the docker/podman stop command string.
+ */
+export declare function buildStopCommand(runtime: string): string;
+/**
+ * Pull the container image.
+ */
+export declare function pullImage(runtime: string): void;
+//# sourceMappingURL=docker.d.ts.map

package/dist/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../src/docker.ts"],"names":[],"mappings":"AAIA,oCAAoC;AACpC,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,mCAAmC;AACnC,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAExE,8CAA8C;AAC9C,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,gEAAgE;AAChE,eAAO,MAAM,QAAQ,QAAoD,CAAC;AAE1E,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAElE,mCAAmC;AACnC,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,GAAG,IAAI,CAU9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/docker.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_DIR = exports.CONTAINER_PORT = exports.CONTAINER_IMAGE = exports.CONTAINER_NAME = void 0;
+exports.detectRuntime = detectRuntime;
+exports.getContainerStatus = getContainerStatus;
+exports.isContainerRunning = isContainerRunning;
+exports.buildRunCommand = buildRunCommand;
+exports.buildStartCommand = buildStartCommand;
+exports.buildStopCommand = buildStopCommand;
+exports.pullImage = pullImage;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** Name of the managed container */
+exports.CONTAINER_NAME = "straylight-ai";
+/** Docker image to pull and run */
+exports.CONTAINER_IMAGE = "ghcr.io/aj-geddes/straylight-ai:latest";
+/** Host port mapped to container port 9470 */
+exports.CONTAINER_PORT = 9470;
+/** Host data directory mounted at /data inside the container */
+exports.DATA_DIR = path.join(os.homedir(), ".straylight-ai", "data");
+/**
+ * Detect whether docker or podman is available on the host.
+ * Returns the first available runtime, or null if neither is found.
+ */
+function detectRuntime() {
+    for (const runtime of ["docker", "podman"]) {
+        try {
+            (0, child_process_1.execSync)(`${runtime} --version`, { stdio: "pipe" });
+            return runtime;
+        }
+        catch {
+            // try the next one
+        }
+    }
+    return null;
+}
+/**
+ * Get the status of the straylight-ai container.
+ */
+async function getContainerStatus(runtime) {
+    try {
+        const output = (0, child_process_1.execSync)(`${runtime} inspect --format "{{.State.Status}}" ${exports.CONTAINER_NAME}`, { stdio: "pipe" })
+            .toString()
+            .trim()
+            .replace(/^"|"$/g, ""); // strip surrounding quotes if present
+        if (output === "running")
+            return "running";
+        return "stopped";
+    }
+    catch {
+        return "not_found";
+    }
+}
+/**
+ * Returns true when the container is currently running.
+ */
+async function isContainerRunning(runtime) {
+    return (await getContainerStatus(runtime)) === "running";
+}
+/**
+ * Build the docker/podman run command string.
+ */
+function buildRunCommand(runtime) {
+    return [
+        `${runtime} run`,
+        "-d",
+        `--name ${exports.CONTAINER_NAME}`,
+        `-p ${exports.CONTAINER_PORT}:${exports.CONTAINER_PORT}`,
+        `-v ${exports.DATA_DIR}:/data`,
+        "--restart unless-stopped",
+        exports.CONTAINER_IMAGE,
+    ].join(" ");
+}
+/**
+ * Build the docker/podman start command string.
+ */
+function buildStartCommand(runtime) {
+    return `${runtime} start ${exports.CONTAINER_NAME}`;
+}
+/**
+ * Build the docker/podman stop command string.
+ */
+function buildStopCommand(runtime) {
+    return `${runtime} stop ${exports.CONTAINER_NAME}`;
+}
+/**
+ * Pull the container image.
+ */
+function pullImage(runtime) {
+    (0, child_process_1.execSync)(`${runtime} pull ${exports.CONTAINER_IMAGE}`, { stdio: "inherit" });
+}
+//# sourceMappingURL=docker.js.map

package/dist/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../src/docker.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,sCAUC;AAKD,gDAiBC;AAKD,gDAEC;AAKD,0CAUC;AAKD,8CAEC;AAKD,4CAEC;AAKD,8BAEC;AArGD,iDAAyC;AACzC,uCAAyB;AACzB,2CAA6B;AAE7B,oCAAoC;AACvB,QAAA,cAAc,GAAG,eAAe,CAAC;AAE9C,mCAAmC;AACtB,QAAA,eAAe,GAAG,wCAAwC,CAAC;AAExE,8CAA8C;AACjC,QAAA,cAAc,GAAG,IAAI,CAAC;AAEnC,gEAAgE;AACnD,QAAA,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAQ1E;;;GAGG;AACH,SAAgB,aAAa;IAC3B,KAAK,MAAM,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAc,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,IAAA,wBAAQ,EAAC,GAAG,OAAO,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EACrB,GAAG,OAAO,yCAAyC,sBAAc,EAAE,EACnE,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB;aACE,QAAQ,EAAE;aACV,IAAI,EAAE;aACN,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,sCAAsC;QAEhE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,OAAO,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO;QACL,GAAG,OAAO,MAAM;QAChB,IAAI;QACJ,UAAU,sBAAc,EAAE;QAC1B,MAAM,sBAAc,IAAI,sBAAc,EAAE;QACxC,MAAM,gBAAQ,QAAQ;QACtB,0BAA0B;QAC1B,uBAAe;KAChB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,GAAG,OAAO,UAAU,sBAAc,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,GAAG,OAAO,SAAS,sBAAc,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,IAAA,wBAAQ,EAAC,GAAG,OAAO,SAAS,uBAAe,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,22 @@
+/** Response shape from the health endpoint */
+export interface HealthResponse {
+    status: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/**
+ * Perform a single health check against the given URL.
+ * Throws if the endpoint is unreachable or returns a non-ok HTTP status.
+ */
+export declare function checkHealth(url: string): Promise<HealthResponse>;
+/**
+ * Poll the health endpoint until it returns a successful response or the
+ * timeout elapses.
+ *
+ * @param url       Full URL of the health endpoint.
+ * @param timeoutMs Maximum time to wait in milliseconds.
+ * @returns The first successful HealthResponse.
+ * @throws  Error when the timeout is reached without a successful response.
+ */
+export declare function waitForHealth(url: string, timeoutMs: number): Promise<HealthResponse>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAKD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/health.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkHealth = checkHealth;
+exports.waitForHealth = waitForHealth;
+/** Interval between health-check attempts in milliseconds */
+const POLL_INTERVAL_MS = 1_000;
+/**
+ * Perform a single health check against the given URL.
+ * Throws if the endpoint is unreachable or returns a non-ok HTTP status.
+ */
+async function checkHealth(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Health check failed with HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+/**
+ * Poll the health endpoint until it returns a successful response or the
+ * timeout elapses.
+ *
+ * @param url       Full URL of the health endpoint.
+ * @param timeoutMs Maximum time to wait in milliseconds.
+ * @returns The first successful HealthResponse.
+ * @throws  Error when the timeout is reached without a successful response.
+ */
+async function waitForHealth(url, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            return await checkHealth(url);
+        }
+        catch {
+            // Not ready yet — wait before retrying
+            await sleep(POLL_INTERVAL_MS);
+        }
+    }
+    throw new Error(`Health check timed out after ${timeoutMs}ms. ` +
+        `Is the container running at ${url}?`);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":";;AAcA,kCAMC;AAWD,sCAmBC;AA3CD,6DAA6D;AAC7D,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;;GAGG;AACI,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;AACnD,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;YACvC,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,gCAAgC,SAAS,MAAM;QAC7C,+BAA+B,GAAG,GAAG,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/mcp-register.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check whether the Claude Code CLI is available on PATH.
+ */
+export declare function isClaudeAvailable(): boolean;
+/**
+ * Register the Straylight-AI MCP server with Claude Code.
+ *
+ * Runs:
+ *   claude mcp add straylight-ai --transport stdio -- npx straylight-ai mcp
+ *
+ * @returns true on success, false if claude is unavailable or the command fails.
+ */
+export declare function registerMCP(): Promise<boolean>;
+/**
+ * Build the manual registration instructions string for users who do not have
+ * Claude Code installed.
+ */
+export declare function manualRegistrationInstructions(): string;
+//# sourceMappingURL=mcp-register.d.ts.map

package/dist/mcp-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-register.d.ts","sourceRoot":"","sources":["../src/mcp-register.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAsBpD;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAQvD"}