@zixt/host 0.0.121 → 0.0.123

package/dist/index.js

@@ -28,7 +28,7 @@ import { homedir as homedir4 } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.121",
+  version: "0.0.123",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14605,6 +14605,8 @@ var ID_PREFIXES = {
   /** One bounded image owned by an AI teammate profile. */
   agentAvatar: "aav",
   host: "hst",
+  /** One-use browser-approved desktop-app pairing session. */
+  hostPairingSession: "hps",
   task: "tsk",
   attempt: "att",
   review: "rvw",
@@ -20454,6 +20456,23 @@ var CreateHostRequest = external_exports.object({
   /** Optional only for rolling compatibility; the current UI always asks. */
   operatingSystem: HostOperatingSystem.optional()
 });
+var HostPairingCode = external_exports.string().regex(/^zxp_[0-9a-f]{64}$/, "pairing code shape is zxp_<64 hex>");
+var Sha256Hex = external_exports.string().regex(/^[0-9a-f]{64}$/, "expected 64 lowercase hex characters");
+var CreateHostPairingSessionRequest = external_exports.object({
+  name: Host.shape.name,
+  operatingSystem: HostOperatingSystem.optional(),
+  /** SHA-256 hex of the verifier the desktop app keeps (PKCE-style). */
+  challenge: Sha256Hex
+});
+var CreateHostPairingSessionResponse = external_exports.object({
+  code: HostPairingCode,
+  expiresAt: external_exports.iso.datetime()
+});
+var RedeemHostPairingRequest = external_exports.object({
+  code: HostPairingCode,
+  /** Preimage of the session's challenge; possession proves the initiator. */
+  verifier: Sha256Hex
+});
 var RenameHostRequest = external_exports.object({
   name: Host.shape.name
 });
@@ -22429,6 +22448,17 @@ function sanitizedInstallerEnv(inherited) {
 }
 
 // src/runners/runner-install.ts
+var INSTALLABLE_RUNNERS = ["claude-code", "codex"];
+function parseRunnerAutoinstallSelection(value) {
+  const trimmed = value?.trim() ?? "";
+  if (trimmed === "" || trimmed === "on") return new Set(INSTALLABLE_RUNNERS);
+  if (trimmed === "off") return /* @__PURE__ */ new Set();
+  return new Set(
+    trimmed.split(",").map((token2) => token2.trim()).filter(
+      (token2) => INSTALLABLE_RUNNERS.includes(token2)
+    )
+  );
+}
 var CLAUDE_INSTALLER_URL_POSIX = "https://claude.ai/install.sh";
 var CLAUDE_INSTALLER_URL_WINDOWS = "https://claude.ai/install.ps1";
 var CODEX_PACKAGE = "@openai/codex";
@@ -22607,10 +22637,12 @@ function createRunnerAutoInstaller(options) {
   };
   const install = options.install ?? ((type) => type === "claude-code" ? installClaude() : installCodex());
   return {
-    ensureInstalled(type) {
+    ensureInstalled(type, ensureOptions) {
       if (inFlight.has(type)) return;
       const lastFailure = failedAt.get(type);
-      if (lastFailure !== void 0 && now() - lastFailure < FAILURE_COOLDOWN_MS) return;
+      if (!ensureOptions?.force && lastFailure !== void 0 && now() - lastFailure < FAILURE_COOLDOWN_MS) {
+        return;
+      }
       options.onEvent({ runner: type, state: "started" });
       const attempt = (async () => {
         try {
@@ -22644,6 +22676,9 @@ function createRunnerAutoInstaller(options) {
       })();
       inFlight.set(type, attempt);
     },
+    isInstalling(type) {
+      return inFlight.has(type);
+    },
     async settled() {
       while (inFlight.size > 0) await Promise.allSettled([...inFlight.values()]);
     }
@@ -43459,7 +43494,7 @@ async function forgetAcknowledgedAcceptedAssignments(assignments, root = default
 }
 
 // src/local-observability.ts
-import { appendFile, mkdir as mkdir19, open as open12, rename as rename11, rm as rm15, stat as stat3 } from "node:fs/promises";
+import { appendFile, mkdir as mkdir19, open as open12, readdir as readdir8, rename as rename11, rm as rm15, stat as stat3 } from "node:fs/promises";
 import { homedir as homedir15 } from "node:os";
 import { basename as basename7, dirname as dirname16, join as join26 } from "node:path";
 
@@ -43570,6 +43605,7 @@ function createHostLogger(options = {}) {
 var LOCAL_CONSOLE_FILE = "console.jsonl";
 var LOCAL_CONSOLE_PREVIOUS_FILE = "console.prev.jsonl";
 var LOCAL_STATUS_FILE = "status.json";
+var LOCAL_REQUESTS_DIR = "requests";
 var DEFAULT_CONSOLE_ROTATE_BYTES = 2 * 1024 * 1024;
 function defaultLocalObservabilityRoot() {
   return join26(homedir15(), ".zixt", "observability");
@@ -43625,6 +43661,26 @@ function createLocalConsoleSink(options = {}) {
     settled: () => queue
   };
 }
+async function consumeRunnerInstallRequests(root = defaultLocalObservabilityRoot()) {
+  const directory = join26(root, LOCAL_REQUESTS_DIR);
+  const requested = /* @__PURE__ */ new Set();
+  let names;
+  try {
+    names = await readdir8(directory);
+  } catch {
+    return requested;
+  }
+  for (const type of INSTALLABLE_RUNNERS) {
+    const name = `install-runner-${type}.json`;
+    if (!names.includes(name)) continue;
+    try {
+      await rm15(join26(directory, name), { force: true });
+      requested.add(type);
+    } catch {
+    }
+  }
+  return requested;
+}
 async function writeLocalStatus(status, root = defaultLocalObservabilityRoot()) {
   const destination = join26(root, LOCAL_STATUS_FILE);
   const temporary = join26(
@@ -43975,7 +44031,10 @@ if (!token) {
   process.exit(DO_NOT_RESTART_EXIT_CODE);
 }
 var demoPreflightScript = forceDemo ? process.env.ZIXT_DEMO_PREFLIGHT_SCRIPT : void 0;
-var runnerAutoInstaller = forceDemo || process.env.ZIXT_RUNNER_AUTOINSTALL === "off" ? null : createRunnerAutoInstaller({
+var runnerAutoinstallSelection = parseRunnerAutoinstallSelection(
+  process.env.ZIXT_RUNNER_AUTOINSTALL
+);
+var runnerAutoInstaller = forceDemo ? null : createRunnerAutoInstaller({
   onEvent: (event) => {
     const name = event.runner === "claude-code" ? "Claude Code" : "Codex";
     if (event.state === "started") {
@@ -44125,7 +44184,8 @@ async function currentBrowserCapability() {
   return measured;
 }
 async function telemetry() {
-  if (!cachedRunners || Date.now() - cachedRunnersAt > 4 * 6e4) {
+  const requestedInstalls = runnerAutoInstaller ? await consumeRunnerInstallRequests(localObservabilityRoot) : /* @__PURE__ */ new Set();
+  if (!cachedRunners || Date.now() - cachedRunnersAt > 4 * 6e4 || requestedInstalls.size > 0) {
     cachedRunners = await Promise.all([
       preflightClaudeCode(
         demoPreflightScript ? { command: process.execPath, commandPrefixArgs: [demoPreflightScript] } : {}
@@ -44137,7 +44197,22 @@ async function telemetry() {
     cachedRunnersAt = Date.now();
     for (const runner of cachedRunners) {
       reportRunnerReadiness(runner);
-      if (!runner.installed && (runner.type === "claude-code" || runner.type === "codex") && runnerAutoInstaller) {
+      if (!runnerAutoInstaller || runner.type !== "claude-code" && runner.type !== "codex") {
+        continue;
+      }
+      const requested = requestedInstalls.has(runner.type);
+      if (runner.installed) {
+        if (requested) {
+          log.info(
+            `${runner.type === "claude-code" ? "Claude Code" : "Codex"} is already installed on this Machine`,
+            { machine }
+          );
+        }
+        continue;
+      }
+      if (requested) {
+        runnerAutoInstaller.ensureInstalled(runner.type, { force: true });
+      } else if (runnerAutoinstallSelection.has(runner.type)) {
         runnerAutoInstaller.ensureInstalled(runner.type);
       }
     }
@@ -44253,7 +44328,9 @@ function publishLocalStatus() {
           ...localCloudConnectedAt ? { connectedAt: localCloudConnectedAt } : {}
         },
         activeSessions,
-        runners: cachedRunners ?? [],
+        runners: (cachedRunners ?? []).map(
+          (runner) => (runner.type === "claude-code" || runner.type === "codex") && runnerAutoInstaller?.isInstalling(runner.type) ? { ...runner, installing: true } : runner
+        ),
         browser: cachedBrowserCapability ?? { status: "unavailable" }
       },
       ...localObservabilityRoot ? [localObservabilityRoot] : []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.121",
+  "version": "0.0.123",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",