← Files Knowledge for AgentsARCHIVED FILE

scripts/companion/storage.mjs

1.27 KB · Nov 19, 2026 · 00:32 UTC

↓ Download file

See the change to this file →

import { chmodSync, existsSync, lstatSync, mkdirSync } from "node:fs";
import { homedir } from "node:os";
import { isAbsolute, join, resolve } from "node:path";

// State is private by default but injectable for isolated tests and sandboxes.
export function resolveStateDirectory(value, env = process.env) {
  const directory =
    value ?? env.KFA_COMPANION_STATE_DIR ?? join(homedir(), ".config", "kfa", "companion");
  if (!isAbsolute(directory)) throw Error("STATE_DIRECTORY_ABSOLUTE");
  return resolve(directory);
}

function assertPrivateDirectory(directory) {
  const stat = lstatSync(directory);
  const currentUid = typeof process.getuid === "function" ? process.getuid() : undefined;
  if (
    stat.isSymbolicLink() ||
    !stat.isDirectory() ||
    (currentUid !== undefined && stat.uid !== currentUid) ||
    (stat.mode & 0o077) !== 0
  )
    throw Error("UNSAFE_STATE_DIRECTORY");
}

export function prepareStateDirectory(root) {
  if (!existsSync(root)) {
    mkdirSync(root, { recursive: true, mode: 0o700 });
    chmodSync(root, 0o700);
  }
  assertPrivateDirectory(root);
  const sessions = join(root, "sessions");
  if (!existsSync(sessions)) {
    mkdirSync(sessions, { mode: 0o700 });
    chmodSync(sessions, 0o700);
  }
  assertPrivateDirectory(sessions);
  return sessions;
}

SHA-256: a62ac074e7c875737b3f1dbc97d063e9aa7be986fee41214052f426bd6d9fd77