blun-king-cli 9.1.602 → 9.1.604

package/bin/launcher-mode.js

@@ -1,93 +1,93 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const LAUNCHER_MODES = Object.freeze({
-  BLUN: 'blun',
-  KING: 'king',
-});
-
-const LAUNCHER_HELP_TEXT = [
-  '',
-  'Launchers:',
-  '  blun  Starts the CLI without automatically attaching Telegram.',
-  '  king  Starts the same CLI and automatically attaches the configured Telegram channel.',
-  '  Both use the same version, account, model, and commands.',
-  '  blun tools list shows optional tools; enable writes only explicit choices.',
-  '',
-].join('\n');
-
-function launcherModeFromArgv(argv) {
-  const entry = argv[1] || '';
-  const filename = entry.replaceAll('\\', '/').split('/').pop() || '';
-  const command = filename.replace(/\.(?:c|m)?js$/i, '').toLowerCase();
-  return command === LAUNCHER_MODES.KING ? LAUNCHER_MODES.KING : LAUNCHER_MODES.BLUN;
-}
-
-function runtimePolicyEnvironment(blunDir) {
-  if (blunDir === undefined) return {};
-  let policy;
-  try {
-    if (!path.isAbsolute(blunDir)) throw new Error('Invalid home');
-    const file = path.join(blunDir, 'runtime-policy.json');
-    const stat = fs.lstatSync(file);
-    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) throw new Error('Invalid file');
-    policy = JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch (error) {
-    if (error.code === 'ENOENT') return {};
-    throw new Error('Invalid BLUN runtime policy');
-  }
-  const review = policy?.responseReview;
-  if (policy?.schema !== 'blun.runtime-policy/v1'
-    || Object.keys(policy).sort().join(',') !== 'responseReview,schema'
-    || !review || Object.keys(review).sort().join(',') !== 'guardVersion,language,required'
-    || review.required !== true || typeof review.language !== 'string'
-    || !/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(review.language)
-    || /^(auto|all)$/i.test(review.language)
-    || typeof review.guardVersion !== 'string' || !/^\d+\.\d+\.\d+$/.test(review.guardVersion)) {
-    throw new Error('Invalid BLUN runtime policy');
-  }
-  return {
-    BLUN_LANGUAGE_GUARD_MANDATORY: '1',
-    BLUN_LANGUAGE_GUARD_LANGUAGE: review.language,
-    BLUN_LANGUAGE_GUARD_VERSION: review.guardVersion,
-    BLUN_TELEGRAM_LANGUAGE_GATE: 'required',
-    BLUN_TELEGRAM_OUTPUT_LOCALE: review.language,
-    AGENTSPINE_STATE_DIR: path.join(blunDir, 'state', 'agent-spine'),
-  };
-}
-
-function createLauncherEnvironment(sourceEnv, mode, publicPackageVersion, blunDir) {
-  return {
-    ...sourceEnv,
-    ...runtimePolicyEnvironment(blunDir),
-    BLUN_NO_AUTO_UPDATE: '1',
-    BLUN_PUBLIC_PACKAGE_VERSION: publicPackageVersion,
-    BLUN_TELEGRAM_ATTACH: mode === LAUNCHER_MODES.KING ? 'on' : 'off',
-    BLUN_TELEGRAM_HEADLESS: 'off',
-  };
-}
-
-function isNpmPackageUpdateRequest(args) {
-  if (!Array.isArray(args) || args.length !== 1) return false;
-  const command = String(args[0] || '').toLowerCase();
-  return command === 'update' || command === 'upgrade';
-}
-
-function isStandaloneHelpRequest(args) {
-  return Array.isArray(args) && args.length === 1 && (args[0] === '--help' || args[0] === '-h');
-}
-
-function launcherHelpText() {
-  return LAUNCHER_HELP_TEXT;
-}
-
-module.exports = {
-  LAUNCHER_MODES,
-  createLauncherEnvironment,
-  isNpmPackageUpdateRequest,
-  isStandaloneHelpRequest,
-  launcherHelpText,
-  launcherModeFromArgv,
-};
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const LAUNCHER_MODES = Object.freeze({
+  BLUN: 'blun',
+  KING: 'king',
+});
+
+const LAUNCHER_HELP_TEXT = [
+  '',
+  'Launchers:',
+  '  blun  Starts the CLI without automatically attaching Telegram.',
+  '  king  Starts the same CLI and automatically attaches the configured Telegram channel.',
+  '  Both use the same version, account, model, and commands.',
+  '  blun tools list shows optional tools; enable writes only explicit choices.',
+  '',
+].join('\n');
+
+function launcherModeFromArgv(argv) {
+  const entry = argv[1] || '';
+  const filename = entry.replaceAll('\\', '/').split('/').pop() || '';
+  const command = filename.replace(/\.(?:c|m)?js$/i, '').toLowerCase();
+  return command === LAUNCHER_MODES.KING ? LAUNCHER_MODES.KING : LAUNCHER_MODES.BLUN;
+}
+
+function runtimePolicyEnvironment(blunDir) {
+  if (blunDir === undefined) return {};
+  let policy;
+  try {
+    if (!path.isAbsolute(blunDir)) throw new Error('Invalid home');
+    const file = path.join(blunDir, 'runtime-policy.json');
+    const stat = fs.lstatSync(file);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) throw new Error('Invalid file');
+    policy = JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch (error) {
+    if (error.code === 'ENOENT') return {};
+    throw new Error('Invalid BLUN runtime policy');
+  }
+  const review = policy?.responseReview;
+  if (policy?.schema !== 'blun.runtime-policy/v1'
+    || Object.keys(policy).sort().join(',') !== 'responseReview,schema'
+    || !review || Object.keys(review).sort().join(',') !== 'guardVersion,language,required'
+    || review.required !== true || typeof review.language !== 'string'
+    || !/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(review.language)
+    || /^(auto|all)$/i.test(review.language)
+    || typeof review.guardVersion !== 'string' || !/^\d+\.\d+\.\d+$/.test(review.guardVersion)) {
+    throw new Error('Invalid BLUN runtime policy');
+  }
+  return {
+    BLUN_LANGUAGE_GUARD_MANDATORY: '1',
+    BLUN_LANGUAGE_GUARD_LANGUAGE: review.language,
+    BLUN_LANGUAGE_GUARD_VERSION: review.guardVersion,
+    BLUN_TELEGRAM_LANGUAGE_GATE: 'required',
+    BLUN_TELEGRAM_OUTPUT_LOCALE: review.language,
+    AGENTSPINE_STATE_DIR: path.join(blunDir, 'state', 'agent-spine'),
+  };
+}
+
+function createLauncherEnvironment(sourceEnv, mode, publicPackageVersion, blunDir) {
+  return {
+    ...sourceEnv,
+    ...runtimePolicyEnvironment(blunDir),
+    BLUN_NO_AUTO_UPDATE: '1',
+    BLUN_PUBLIC_PACKAGE_VERSION: publicPackageVersion,
+    BLUN_TELEGRAM_ATTACH: mode === LAUNCHER_MODES.KING ? 'on' : 'off',
+    BLUN_TELEGRAM_HEADLESS: 'off',
+  };
+}
+
+function isNpmPackageUpdateRequest(args) {
+  if (!Array.isArray(args) || args.length !== 1) return false;
+  const command = String(args[0] || '').toLowerCase();
+  return command === 'update' || command === 'upgrade';
+}
+
+function isStandaloneHelpRequest(args) {
+  return Array.isArray(args) && args.length === 1 && (args[0] === '--help' || args[0] === '-h');
+}
+
+function launcherHelpText() {
+  return LAUNCHER_HELP_TEXT;
+}
+
+module.exports = {
+  LAUNCHER_MODES,
+  createLauncherEnvironment,
+  isNpmPackageUpdateRequest,
+  isStandaloneHelpRequest,
+  launcherHelpText,
+  launcherModeFromArgv,
+};

package/bin/launcher-restart-policy.cjs

@@ -1,131 +1,131 @@
-'use strict';
-
-const crypto = require('node:crypto');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const RESTART_WINDOW_MS = 60 * 60 * 1000;
-const MAX_RESTARTS_PER_WINDOW = 3;
-const RESTART_DELAYS_MS = Object.freeze([1000, 3000, 5000]);
-const INTENTIONAL_STOP_TTL_MS = 2 * 60 * 1000;
-const OPERATOR_SIGNALS = new Set(['SIGHUP', 'SIGINT', 'SIGTERM']);
-
-function restartBudgetPath(homeDir) {
-  return path.join(path.resolve(homeDir), 'diagnostics', 'launcher-restart-budget.json');
-}
-
-function intentionalStopMarkerPath(homeDir) {
-  return path.join(path.resolve(homeDir), 'diagnostics', 'intentional-core-stop.json');
-}
-
-function launcherStatusQueuePath(homeDir, stateDir) {
-  return path.join(stateDir ? path.resolve(stateDir) : path.join(path.resolve(homeDir), 'channels', 'telegram'),
-    'launcher-status-queue.jsonl');
-}
-
-function atomicWriteJson(file, value, fsImpl = fs) {
-  fsImpl.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
-  const temporary = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
-  try {
-    fsImpl.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
-    fsImpl.renameSync(temporary, file);
-  } finally {
-    try { fsImpl.rmSync(temporary, { force: true }); } catch {}
-  }
-}
-
-function claimLauncherRestart(options) {
-  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
-  const fsImpl = options.fsImpl || fs;
-  const file = restartBudgetPath(options.homeDir);
-  const denied = { allowed: false, attempt: MAX_RESTARTS_PER_WINDOW, limit: MAX_RESTARTS_PER_WINDOW, windowMs: RESTART_WINDOW_MS };
-  let attempts = [];
-  try {
-    const stat = fsImpl.lstatSync(file);
-    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) return denied;
-    const saved = JSON.parse(fsImpl.readFileSync(file, 'utf8'));
-    if (saved?.schema !== 'blun.launcher-restart-budget/v1' || !Array.isArray(saved.attempts)
-      || saved.attempts.some((value) => !Number.isFinite(value) || value > nowMs)) return denied;
-    attempts = saved.attempts.filter((value) => value > nowMs - RESTART_WINDOW_MS);
-  } catch (error) {
-    if (error.code !== 'ENOENT') return denied;
-  }
-  if (attempts.length >= MAX_RESTARTS_PER_WINDOW) return { ...denied, attempt: attempts.length };
-  attempts.push(nowMs);
-  try {
-    atomicWriteJson(file, {
-      schema: 'blun.launcher-restart-budget/v1', updatedAt: new Date(nowMs).toISOString(), attempts,
-    }, fsImpl);
-  } catch {
-    // Never restart without a durable budget claim.
-    return denied;
-  }
-  return { allowed: true, attempt: attempts.length, limit: MAX_RESTARTS_PER_WINDOW, windowMs: RESTART_WINDOW_MS };
-}
-
-function isWindowsFailFastExitCode(code) {
-  if (!Number.isInteger(code)) return false;
-  const unsigned = code >>> 0;
-  return unsigned >= 0xC0000000 && unsigned !== 0xC000013A;
-}
-
-function isAbnormalCoreExit(result, loaded) {
-  if (OPERATOR_SIGNALS.has(result?.signal)) return false;
-  return Boolean(result?.error) || (loaded === true && isWindowsFailFastExitCode(result?.code));
-}
-
-function writeIntentionalStopMarker(options) {
-  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
-  const file = intentionalStopMarkerPath(options.homeDir);
-  atomicWriteJson(file, {
-    schema: 'blun.intentional-core-stop/v1', pid: options.pid,
-    createdAtMs: nowMs, expiresAtMs: nowMs + INTENTIONAL_STOP_TTL_MS,
-  }, options.fsImpl);
-  return file;
-}
-
-function consumeIntentionalStopMarker(options) {
-  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
-  const file = intentionalStopMarkerPath(options.homeDir);
-  const fsImpl = options.fsImpl || fs;
-  let marker;
-  try {
-    const stat = fsImpl.lstatSync(file);
-    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) return false;
-    marker = JSON.parse(fsImpl.readFileSync(file, 'utf8'));
-    fsImpl.rmSync(file);
-  } catch { return false; }
-  return marker?.schema === 'blun.intentional-core-stop/v1'
-    && Number.isInteger(marker.pid) && marker.pid === options.childPid
-    && Number.isFinite(marker.createdAtMs) && Number.isFinite(marker.expiresAtMs)
-    && marker.createdAtMs <= nowMs && marker.expiresAtMs >= nowMs
-    && marker.expiresAtMs - marker.createdAtMs <= INTENTIONAL_STOP_TTL_MS;
-}
-
-function restartDelayMs(attempt) {
-  return RESTART_DELAYS_MS[Math.max(0, Math.min(RESTART_DELAYS_MS.length - 1, attempt - 1))];
-}
-
-function appendLauncherStatus(options) {
-  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
-  const exhausted = options.kind === 'launcher-restart-exhausted';
-  const signal = options.signal ? ` signal=${options.signal}` : '';
-  const event = {
-    schema: 'blun.launcher-status/v1', id: crypto.randomUUID(), createdAt: new Date(nowMs).toISOString(),
-    kind: options.kind, attempt: options.attempt, limit: options.limit,
-    exitCode: options.exitCode, signal: options.signal,
-    text: `[launcher.restart] ${exhausted ? 'stopped ' : ''}${options.attempt}/${options.limit} exit=${options.exitCode}${signal}`,
-  };
-  const file = launcherStatusQueuePath(options.homeDir, options.stateDir);
-  const fsImpl = options.fsImpl || fs;
-  fsImpl.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
-  fsImpl.appendFileSync(file, `${JSON.stringify(event)}\n`, { encoding: 'utf8', mode: 0o600 });
-  return event;
-}
-
-module.exports = {
-  INTENTIONAL_STOP_TTL_MS, MAX_RESTARTS_PER_WINDOW, RESTART_DELAYS_MS, RESTART_WINDOW_MS,
-  appendLauncherStatus, claimLauncherRestart, consumeIntentionalStopMarker, intentionalStopMarkerPath,
-  isAbnormalCoreExit, isWindowsFailFastExitCode, launcherStatusQueuePath, restartBudgetPath,
-  restartDelayMs, writeIntentionalStopMarker,
-};
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const RESTART_WINDOW_MS = 60 * 60 * 1000;
+const MAX_RESTARTS_PER_WINDOW = 3;
+const RESTART_DELAYS_MS = Object.freeze([1000, 3000, 5000]);
+const INTENTIONAL_STOP_TTL_MS = 2 * 60 * 1000;
+const OPERATOR_SIGNALS = new Set(['SIGHUP', 'SIGINT', 'SIGTERM']);
+
+function restartBudgetPath(homeDir) {
+  return path.join(path.resolve(homeDir), 'diagnostics', 'launcher-restart-budget.json');
+}
+
+function intentionalStopMarkerPath(homeDir) {
+  return path.join(path.resolve(homeDir), 'diagnostics', 'intentional-core-stop.json');
+}
+
+function launcherStatusQueuePath(homeDir, stateDir) {
+  return path.join(stateDir ? path.resolve(stateDir) : path.join(path.resolve(homeDir), 'channels', 'telegram'),
+    'launcher-status-queue.jsonl');
+}
+
+function atomicWriteJson(file, value, fsImpl = fs) {
+  fsImpl.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+  const temporary = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+  try {
+    fsImpl.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
+    fsImpl.renameSync(temporary, file);
+  } finally {
+    try { fsImpl.rmSync(temporary, { force: true }); } catch {}
+  }
+}
+
+function claimLauncherRestart(options) {
+  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
+  const fsImpl = options.fsImpl || fs;
+  const file = restartBudgetPath(options.homeDir);
+  const denied = { allowed: false, attempt: MAX_RESTARTS_PER_WINDOW, limit: MAX_RESTARTS_PER_WINDOW, windowMs: RESTART_WINDOW_MS };
+  let attempts = [];
+  try {
+    const stat = fsImpl.lstatSync(file);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) return denied;
+    const saved = JSON.parse(fsImpl.readFileSync(file, 'utf8'));
+    if (saved?.schema !== 'blun.launcher-restart-budget/v1' || !Array.isArray(saved.attempts)
+      || saved.attempts.some((value) => !Number.isFinite(value) || value > nowMs)) return denied;
+    attempts = saved.attempts.filter((value) => value > nowMs - RESTART_WINDOW_MS);
+  } catch (error) {
+    if (error.code !== 'ENOENT') return denied;
+  }
+  if (attempts.length >= MAX_RESTARTS_PER_WINDOW) return { ...denied, attempt: attempts.length };
+  attempts.push(nowMs);
+  try {
+    atomicWriteJson(file, {
+      schema: 'blun.launcher-restart-budget/v1', updatedAt: new Date(nowMs).toISOString(), attempts,
+    }, fsImpl);
+  } catch {
+    // Never restart without a durable budget claim.
+    return denied;
+  }
+  return { allowed: true, attempt: attempts.length, limit: MAX_RESTARTS_PER_WINDOW, windowMs: RESTART_WINDOW_MS };
+}
+
+function isWindowsFailFastExitCode(code) {
+  if (!Number.isInteger(code)) return false;
+  const unsigned = code >>> 0;
+  return unsigned >= 0xC0000000 && unsigned !== 0xC000013A;
+}
+
+function isAbnormalCoreExit(result, loaded) {
+  if (OPERATOR_SIGNALS.has(result?.signal)) return false;
+  return Boolean(result?.error) || (loaded === true && isWindowsFailFastExitCode(result?.code));
+}
+
+function writeIntentionalStopMarker(options) {
+  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
+  const file = intentionalStopMarkerPath(options.homeDir);
+  atomicWriteJson(file, {
+    schema: 'blun.intentional-core-stop/v1', pid: options.pid,
+    createdAtMs: nowMs, expiresAtMs: nowMs + INTENTIONAL_STOP_TTL_MS,
+  }, options.fsImpl);
+  return file;
+}
+
+function consumeIntentionalStopMarker(options) {
+  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
+  const file = intentionalStopMarkerPath(options.homeDir);
+  const fsImpl = options.fsImpl || fs;
+  let marker;
+  try {
+    const stat = fsImpl.lstatSync(file);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 4096) return false;
+    marker = JSON.parse(fsImpl.readFileSync(file, 'utf8'));
+    fsImpl.rmSync(file);
+  } catch { return false; }
+  return marker?.schema === 'blun.intentional-core-stop/v1'
+    && Number.isInteger(marker.pid) && marker.pid === options.childPid
+    && Number.isFinite(marker.createdAtMs) && Number.isFinite(marker.expiresAtMs)
+    && marker.createdAtMs <= nowMs && marker.expiresAtMs >= nowMs
+    && marker.expiresAtMs - marker.createdAtMs <= INTENTIONAL_STOP_TTL_MS;
+}
+
+function restartDelayMs(attempt) {
+  return RESTART_DELAYS_MS[Math.max(0, Math.min(RESTART_DELAYS_MS.length - 1, attempt - 1))];
+}
+
+function appendLauncherStatus(options) {
+  const nowMs = Number.isFinite(options.nowMs) ? options.nowMs : Date.now();
+  const exhausted = options.kind === 'launcher-restart-exhausted';
+  const signal = options.signal ? ` signal=${options.signal}` : '';
+  const event = {
+    schema: 'blun.launcher-status/v1', id: crypto.randomUUID(), createdAt: new Date(nowMs).toISOString(),
+    kind: options.kind, attempt: options.attempt, limit: options.limit,
+    exitCode: options.exitCode, signal: options.signal,
+    text: `[launcher.restart] ${exhausted ? 'stopped ' : ''}${options.attempt}/${options.limit} exit=${options.exitCode}${signal}`,
+  };
+  const file = launcherStatusQueuePath(options.homeDir, options.stateDir);
+  const fsImpl = options.fsImpl || fs;
+  fsImpl.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+  fsImpl.appendFileSync(file, `${JSON.stringify(event)}\n`, { encoding: 'utf8', mode: 0o600 });
+  return event;
+}
+
+module.exports = {
+  INTENTIONAL_STOP_TTL_MS, MAX_RESTARTS_PER_WINDOW, RESTART_DELAYS_MS, RESTART_WINDOW_MS,
+  appendLauncherStatus, claimLauncherRestart, consumeIntentionalStopMarker, intentionalStopMarkerPath,
+  isAbnormalCoreExit, isWindowsFailFastExitCode, launcherStatusQueuePath, restartBudgetPath,
+  restartDelayMs, writeIntentionalStopMarker,
+};