@openscout/scout 0.2.73 → 0.2.75

package/dist/node/main.mjs

@@ -182,6 +182,13 @@ import { existsSync as existsSync2, mkdirSync, rmSync, writeFileSync } from "nod
 import { homedir } from "node:os";
 import { join } from "node:path";
 var OPENSCOUT_RPC_CUTOVER_MARKER = "rpc-runtime-cutover-v1";
+function assertTestIsolatedUserData(operation, isolationEnvKey) {
+  if (true)
+    return;
+  if (process.env[isolationEnvKey]?.trim())
+    return;
+  throw new Error(`Refusing to ${operation} while NODE_ENV=test without ${isolationEnvKey} set. ` + "Tests must isolate OpenScout user data in a temp directory (see prepareHome in onboarding.test.ts).");
+}
 function resolveOpenScoutSupportPaths() {
   const home = homedir();
   const supportDirectory = process.env.OPENSCOUT_SUPPORT_DIRECTORY ?? join(home, "Library", "Application Support", "OpenScout");
@@ -214,6 +221,7 @@ function resolveOpenScoutSupportPaths() {
   };
 }
 function ensureOpenScoutCleanSlateSync() {
+  assertTestIsolatedUserData("reset the OpenScout support directory", "OPENSCOUT_SUPPORT_DIRECTORY");
   const paths = resolveOpenScoutSupportPaths();
   if (existsSync2(paths.cutoverMarkerPath)) {
     return;
@@ -1701,6 +1709,7 @@ function resolveBrokerPort() {
   return resolveEffectiveLocalConfig().ports?.broker ?? DEFAULT_LOCAL_CONFIG.ports.broker;
 }
 function writeLocalConfig(config) {
+  assertTestIsolatedUserData("write the OpenScout local config", "OPENSCOUT_HOME");
   const configPath = localConfigPath();
   mkdirSync2(dirname(configPath), { recursive: true });
   const body = JSON.stringify({ ...config, version: LOCAL_CONFIG_VERSION }, null, 2) + `
@@ -2180,6 +2189,29 @@ function readNumber2(value) {
 function readHealthTransport(value) {
   return value === "unix_socket" || value === "http" || value === "in_process" ? value : undefined;
 }
+function readRuntimeFreshness(value) {
+  if (!isRecord3(value))
+    return;
+  const state = readString2(value.state);
+  const basis = readString2(value.basis);
+  const detail = readString2(value.detail);
+  if (!state || !basis || !detail)
+    return;
+  return {
+    state,
+    intentional: readBoolean(value.intentional) ?? false,
+    basis,
+    artifactCommit: readString2(value.artifactCommit) ?? null,
+    expectedCommit: readString2(value.expectedCommit) ?? null,
+    pin: readString2(value.pin) ?? null,
+    pinReason: readString2(value.pinReason) ?? null,
+    manifestPath: readString2(value.manifestPath) ?? null,
+    version: readString2(value.version) ?? null,
+    builtAt: readString2(value.builtAt) ?? null,
+    sourceDirty: readBoolean(value.sourceDirty) ?? null,
+    detail
+  };
+}
 function normalizeNativeServiceStatus(input, config) {
   const healthRecord = isRecord3(input.health) ? input.health : {};
   const healthReachable = readBoolean(healthRecord.reachable) ?? readBoolean(input.reachable) ?? false;
@@ -2195,6 +2227,7 @@ function normalizeNativeServiceStatus(input, config) {
   const stdoutLogPath = readString2(input.stdoutLogPath) ?? config.stdoutLogPath;
   const stderrLogPath = readString2(input.stderrLogPath) ?? config.stderrLogPath;
   const lastLogLine = readString2(input.lastLogLine) ?? (healthReachable ? readLastLogLine([stdoutLogPath, stderrLogPath]) : readLastLogLine([stderrLogPath, stdoutLogPath]));
+  const runtimeFreshness = readRuntimeFreshness(input.runtimeFreshness);
   return {
     label: readString2(input.label) ?? config.label,
     mode: readString2(input.mode) ?? config.mode,
@@ -2229,6 +2262,7 @@ function normalizeNativeServiceStatus(input, config) {
       ...isRecord3(healthRecord.services) ? { services: healthRecord.services } : {},
       error: healthError
     },
+    ...runtimeFreshness ? { runtimeFreshness } : {},
     lastLogLine
   };
 }
@@ -2533,8 +2567,12 @@ function formatBrokerServiceStatus(status) {
     `reachable: ${status.reachable ? "yes" : "no"}`,
     `health: ${status.health.ok ? "ok" : status.health.error ?? "unreachable"}`,
     `health transport: ${status.health.transport ?? "unknown"}`,
+    `runtime freshness: ${status.runtimeFreshness?.state ?? "unavailable"}`,
     `logs: ${status.stdoutLogPath}`
   ];
+  if (status.runtimeFreshness) {
+    lines.push(`runtime freshness detail: ${status.runtimeFreshness.detail}`);
+  }
   if (status.health.socketFallbackError) {
     lines.push(`socket fallback: ${status.health.socketFallbackError}`);
   }
@@ -2778,6 +2816,10 @@ var BUILT_IN_HARNESS_CATALOG = [
       command: "claude",
       sessionFlag: "--resume"
     },
+    sessionDefaults: {
+      defaultTransport: "tmux",
+      fallbackTransports: ["claude_stream_json"]
+    },
     capabilities: ["chat", "invoke", "deliver", "summarize", "review"]
   },
   {
@@ -2814,6 +2856,10 @@ var BUILT_IN_HARNESS_CATALOG = [
       command: "grok",
       sessionFlag: "--resume"
     },
+    sessionDefaults: {
+      defaultHarness: "grok-acp",
+      defaultTransport: "grok_acp"
+    },
     capabilities: ["chat", "invoke", "deliver", "summarize", "review"],
     metadata: {
       invocationModel: "tmux_interactive"
@@ -2853,6 +2899,9 @@ var BUILT_IN_HARNESS_CATALOG = [
       sessionFlag: "resume",
       cwdFlag: "-C"
     },
+    sessionDefaults: {
+      defaultTransport: "codex_app_server"
+    },
     capabilities: ["chat", "invoke", "deliver", "review", "execute"]
   },
   {
@@ -2885,12 +2934,53 @@ var BUILT_IN_HARNESS_CATALOG = [
       loginCommand: "grok login",
       notReadyMessage: "Grok ACP is installed but still needs a cached login or XAI_API_KEY."
     },
+    sessionDefaults: {
+      defaultTransport: "grok_acp"
+    },
     capabilities: ["chat", "invoke", "deliver", "review", "execute"],
     metadata: {
       adapterType: "grok-acp",
       transport: "acp_stdio"
     }
   },
+  {
+    name: "kimi",
+    harness: "kimi",
+    label: "Kimi Code",
+    description: "Kimi Code CLI coding agent over ACP",
+    homepage: "https://www.kimi.com/code/docs/en/",
+    tags: ["coding", "cli", "kimi", "moonshot", "acp"],
+    featured: true,
+    order: 4,
+    support: {
+      ...DEFAULT_SUPPORT,
+      workspace: true,
+      collaboration: true,
+      files: true
+    },
+    install: {
+      binary: "kimi",
+      requires: ["curl"],
+      macos: "curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash",
+      linux: "curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash",
+      windows: "irm https://code.kimi.com/kimi-code/install.ps1 | iex"
+    },
+    readiness: {
+      anyOf: [
+        { kind: "file", path: "~/.kimi-code/credentials", label: "~/.kimi-code/credentials", fileType: "directory" }
+      ],
+      loginCommand: "kimi login",
+      notReadyMessage: "Kimi Code is installed but still needs a cached login from kimi login."
+    },
+    sessionDefaults: {
+      defaultTransport: "kimi_acp"
+    },
+    capabilities: ["chat", "invoke", "deliver", "review", "execute"],
+    metadata: {
+      adapterType: "kimi-acp",
+      transport: "acp_stdio"
+    }
+  },
   {
     name: "cursor",
     harness: "cursor",
@@ -3081,6 +3171,17 @@ function mergeLaunch(base, override) {
     args: override?.args ?? base?.args ?? []
   };
 }
+function mergeSessionDefaults(base, override) {
+  const defaultTransport = override?.defaultTransport ?? base?.defaultTransport;
+  if (!defaultTransport)
+    return;
+  return {
+    ...base ?? {},
+    ...override ?? {},
+    defaultTransport,
+    fallbackTransports: override?.fallbackTransports ? [...override.fallbackTransports] : base?.fallbackTransports ? [...base.fallbackTransports] : undefined
+  };
+}
 function formatRequirement(requirement) {
   if (requirement.label?.trim())
     return requirement.label.trim();
@@ -3120,6 +3221,10 @@ function createBuiltInHarnessCatalog() {
     } : undefined,
     launch: entry.launch ? { ...entry.launch, args: [...entry.launch.args] } : undefined,
     resume: entry.resume ? { ...entry.resume } : undefined,
+    sessionDefaults: entry.sessionDefaults ? {
+      ...entry.sessionDefaults,
+      fallbackTransports: entry.sessionDefaults.fallbackTransports ? [...entry.sessionDefaults.fallbackTransports] : undefined
+    } : undefined,
     resolveEnv: entry.resolveEnv ? [...entry.resolveEnv] : undefined,
     capabilities: [...entry.capabilities],
     metadata: entry.metadata ? { ...entry.metadata } : undefined
@@ -3137,6 +3242,7 @@ function mergeHarnessCatalogEntries(baseEntries, overrides = {}) {
       install: mergeInstall(entry.install, override.install),
       readiness: mergeReadiness(entry.readiness, override.readiness),
       launch: mergeLaunch(entry.launch, override.launch),
+      sessionDefaults: mergeSessionDefaults(entry.sessionDefaults, override.sessionDefaults),
       resume: override.resume && entry.resume ? { ...entry.resume, ...override.resume } : entry.resume,
       tags: override.tags ? [...override.tags] : entry.tags,
       capabilities: override.capabilities ? [...override.capabilities] : entry.capabilities,
@@ -3167,6 +3273,7 @@ function mergeHarnessCatalogEntries(baseEntries, overrides = {}) {
       readiness: mergeReadiness(undefined, override.readiness),
       launch: mergeLaunch(undefined, override.launch),
       resume: override.resume?.command && override.resume?.sessionFlag ? { command: override.resume.command, sessionFlag: override.resume.sessionFlag, cwdFlag: override.resume.cwdFlag } : undefined,
+      sessionDefaults: mergeSessionDefaults(undefined, override.sessionDefaults),
       resolveEnv: override.resolveEnv ? [...override.resolveEnv] : undefined,
       capabilities: [...override.capabilities],
       metadata: override.metadata ? { ...override.metadata } : undefined
@@ -5838,6 +5945,7 @@ async function readOpenScoutSettings(options = {}) {
   });
 }
 async function writeOpenScoutSettings(settings, options = {}) {
+  assertTestIsolatedUserData("write OpenScout settings", "OPENSCOUT_SUPPORT_DIRECTORY");
   ensureOpenScoutCleanSlateSync();
   const current = await readOpenScoutSettings(options);
   const merged = {
@@ -7576,7 +7684,9 @@ function formatBrokerStatus(status) {
     `broker socket: ${status.brokerSocketPath}`,
     `loaded: ${status.loaded ? "yes" : "no"}`,
     `reachable: ${status.reachable ? "yes" : "no"}`,
-    `health: ${status.health.ok ? "ok" : status.health.error ?? "unreachable"}`
+    `health: ${status.health.ok ? "ok" : status.health.error ?? "unreachable"}`,
+    `runtime freshness: ${status.runtimeFreshness?.state ?? "unavailable"}`,
+    ...status.runtimeFreshness ? [`runtime detail: ${status.runtimeFreshness.detail}`] : []
   ].join(`
 `);
 }
@@ -7589,12 +7699,16 @@ function formatDoctor(report) {
     `Broker service adapter: ${report.broker.serviceAdapter ?? "unknown"}`,
     `Broker URL: ${report.broker.brokerUrl}`,
     `Broker reachable: ${report.broker.reachable ? "yes" : "no"}`,
+    `Runtime freshness: ${report.broker.runtimeFreshness?.state ?? "unavailable"}`,
     `Known runtimes: ${report.catalog.entries.length}`,
     `Onboarding needed: ${report.onboarding.needed ? "yes" : "no"}`
   ];
   if (report.nativeRepairs.requested) {
     lines.push(`Native repairs: ${report.nativeRepairs.detail}`);
   }
+  if (report.broker.runtimeFreshness) {
+    lines.push(`Runtime detail: ${report.broker.runtimeFreshness.detail}`);
+  }
   return lines.join(`
 `);
 }