← Files Knowledge for AgentsARCHIVED FILE
scripts/companion/storage.mjs
1.27 KB · Nov 19, 2026 · 00:32 UTC
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