Import vendor/dsh-brain/lib/store.js
This commit is contained in:
parent
8d833f4041
commit
9c64f89e5a
|
|
@ -0,0 +1,321 @@
|
|||
/**
|
||||
* Settings sidecar: `$DSH_HOME/dsh-brain.json` (pre-rename `cloud-memory.json` is migrated on first load).
|
||||
*
|
||||
* Why a file and not the DSH credentials service: the desktop profile has no
|
||||
* stable host-side credentials face this plugin can depend on (the client-side
|
||||
* `remote.credentials` proxy is a browser service), and a missed dependency
|
||||
* would silently disable reporting. A 0600-ish file under the user's DSH home
|
||||
* directory is the smallest thing that always works; Windows ACLs on
|
||||
* `C:\Users\<user>` already restrict it to that account.
|
||||
*
|
||||
* The file holds the two bearer tokens and the UI-editable overrides. It is
|
||||
* NEVER uploaded, never printed, and `describe()` only exposes a mask.
|
||||
*/
|
||||
import { existsSync, copyFileSync, mkdirSync, readFileSync, renameSync, statSync, writeFileSync, chmodSync } from 'node:fs';
|
||||
import { dirname, resolve } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import { DEFAULT_SETTINGS, isPlaceholderBaseUrl, normalizeBaseUrl, originOf, settingsFromConfig } from "./config.js";
|
||||
/** `$DSH_HOME` (or `~/.dsh`) — the same resolution DSH core uses. */
|
||||
export function dshHome() {
|
||||
const fromEnv = process.env.DSH_HOME;
|
||||
if (fromEnv !== undefined && fromEnv.trim() !== '')
|
||||
return fromEnv;
|
||||
return resolve(homedir(), '.dsh');
|
||||
}
|
||||
/** Absolute path of the settings sidecar. */
|
||||
export function settingsPath() {
|
||||
return resolve(dshHome(), 'dsh-brain.json');
|
||||
}
|
||||
/** Pre-rename (<=0.7.x) settings sidecar name. */
|
||||
export function legacySettingsPath() {
|
||||
return resolve(dshHome(), 'cloud-memory.json');
|
||||
}
|
||||
/**
|
||||
* One-time rename carry-over: when `target` does not exist yet but the
|
||||
* pre-rename `legacy` file does, copy it over so settings and tokens survive
|
||||
* the dsh-cloud-memory -> dsh-brain rename. The legacy file is left in place
|
||||
* (never deleted automatically). Returns true when a copy happened.
|
||||
*/
|
||||
export function migrateLegacyFile(target, legacy) {
|
||||
try {
|
||||
if (target === legacy || existsSync(target) || !existsSync(legacy))
|
||||
return false;
|
||||
copyFileSync(legacy, target);
|
||||
return true;
|
||||
}
|
||||
catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
/** Read a token from an env var (an alternative to the sidecar for CI use). */
|
||||
function envToken(name) {
|
||||
const value = process.env[name];
|
||||
if (value === undefined || value.trim() === '')
|
||||
return undefined;
|
||||
return value.trim();
|
||||
}
|
||||
/** Mask a secret for display: `cmt_abc…9f2c`. */
|
||||
export function maskToken(token) {
|
||||
if (token.length <= 12)
|
||||
return `${token.slice(0, 3)}…`;
|
||||
return `${token.slice(0, 7)}…${token.slice(-4)}`;
|
||||
}
|
||||
/** Validate one sidecar field; returns the normalized value or undefined. */
|
||||
function cleanString(value) {
|
||||
if (typeof value !== 'string')
|
||||
return undefined;
|
||||
const trimmed = value.trim();
|
||||
return trimmed === '' ? undefined : trimmed;
|
||||
}
|
||||
/** Coerce one numeric field into a clamped integer. */
|
||||
function clampInt(value, min, max) {
|
||||
const numeric = typeof value === 'string' ? Number(value) : value;
|
||||
if (typeof numeric !== 'number' || !Number.isFinite(numeric))
|
||||
return undefined;
|
||||
return Math.min(max, Math.max(min, Math.trunc(numeric)));
|
||||
}
|
||||
/** Parse an on-disk document defensively (a torn file must not break boot). */
|
||||
function parseState(raw) {
|
||||
try {
|
||||
const value = JSON.parse(raw);
|
||||
if (value === null || typeof value !== 'object' || Array.isArray(value))
|
||||
return { version: 1 };
|
||||
const source = value;
|
||||
const state = { version: 1 };
|
||||
if (typeof source.enabled === 'boolean')
|
||||
state.enabled = source.enabled;
|
||||
const baseUrl = normalizeBaseUrl(source.baseUrl);
|
||||
if (baseUrl !== undefined)
|
||||
state.baseUrl = baseUrl;
|
||||
const clientId = cleanString(source.clientId);
|
||||
if (clientId !== undefined)
|
||||
state.clientId = clientId.slice(0, 128);
|
||||
const requestTimeoutMs = clampInt(source.requestTimeoutMs, 1000, 60_000);
|
||||
if (requestTimeoutMs !== undefined)
|
||||
state.requestTimeoutMs = requestTimeoutMs;
|
||||
const defaultK = clampInt(source.defaultK, 1, 100);
|
||||
if (defaultK !== undefined)
|
||||
state.defaultK = defaultK;
|
||||
const activityToken = cleanString(source.activityToken);
|
||||
if (activityToken !== undefined)
|
||||
state.activityToken = activityToken;
|
||||
const memoryToken = cleanString(source.memoryToken);
|
||||
if (memoryToken !== undefined)
|
||||
state.memoryToken = memoryToken;
|
||||
if (typeof source.summaryEnabled === 'boolean')
|
||||
state.summaryEnabled = source.summaryEnabled;
|
||||
const summaryMaxChars = clampInt(source.summaryMaxChars, 1000, 16_000);
|
||||
if (summaryMaxChars !== undefined)
|
||||
state.summaryMaxChars = summaryMaxChars;
|
||||
const summaryToken = cleanString(source.summaryToken);
|
||||
if (summaryToken !== undefined)
|
||||
state.summaryToken = summaryToken;
|
||||
return state;
|
||||
}
|
||||
catch {
|
||||
return { version: 1 };
|
||||
}
|
||||
}
|
||||
/**
|
||||
* In-memory + on-disk settings holder.
|
||||
*
|
||||
* Writes are atomic (tmp file + rename) and best-effort chmod 0600; the reader
|
||||
* is tolerant, so one corrupt document degrades to defaults instead of
|
||||
* failing the whole plugin activation.
|
||||
*/
|
||||
export class SettingsStore {
|
||||
state;
|
||||
file;
|
||||
configDefaults;
|
||||
constructor(rawConfig, file = settingsPath()) {
|
||||
this.file = file;
|
||||
if (file === settingsPath())
|
||||
migrateLegacyFile(file, legacySettingsPath());
|
||||
this.configDefaults = { ...DEFAULT_SETTINGS, ...settingsFromConfig(rawConfig) };
|
||||
this.state = this.read();
|
||||
}
|
||||
/** Absolute sidecar path (exposed for the status card). */
|
||||
get path() {
|
||||
return this.file;
|
||||
}
|
||||
read() {
|
||||
try {
|
||||
return parseState(readFileSync(this.file, 'utf8'));
|
||||
}
|
||||
catch {
|
||||
return { version: 1 };
|
||||
}
|
||||
}
|
||||
write(next) {
|
||||
const directory = dirname(this.file);
|
||||
mkdirSync(directory, { recursive: true });
|
||||
const temporary = `${this.file}.tmp`;
|
||||
writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
|
||||
renameSync(temporary, this.file);
|
||||
try {
|
||||
chmodSync(this.file, 0o600);
|
||||
}
|
||||
catch {
|
||||
// Windows has no POSIX mode bits; the profile ACL is the real boundary.
|
||||
}
|
||||
}
|
||||
/** Effective settings: config defaults, overridden by sidecar values. */
|
||||
settings() {
|
||||
const resolved = { ...this.configDefaults };
|
||||
if (this.state.enabled !== undefined)
|
||||
resolved.enabled = this.state.enabled;
|
||||
if (this.state.baseUrl !== undefined)
|
||||
resolved.baseUrl = this.state.baseUrl;
|
||||
if (this.state.clientId !== undefined)
|
||||
resolved.clientId = this.state.clientId;
|
||||
if (this.state.requestTimeoutMs !== undefined)
|
||||
resolved.requestTimeoutMs = this.state.requestTimeoutMs;
|
||||
if (this.state.defaultK !== undefined)
|
||||
resolved.defaultK = this.state.defaultK;
|
||||
if (this.state.summaryEnabled !== undefined)
|
||||
resolved.summaryEnabled = this.state.summaryEnabled;
|
||||
if (this.state.summaryMaxChars !== undefined)
|
||||
resolved.summaryMaxChars = this.state.summaryMaxChars;
|
||||
return resolved;
|
||||
}
|
||||
/** The activity:write bearer token (sidecar first, env fallback). */
|
||||
activityToken() {
|
||||
return this.state.activityToken ?? envToken('DSH_BRAIN_ACTIVITY_TOKEN') ?? envToken('DSH_CLOUD_MEMORY_ACTIVITY_TOKEN') ?? '';
|
||||
}
|
||||
/** The memory:read / memory:write bearer token. */
|
||||
memoryToken() {
|
||||
return this.state.memoryToken ?? envToken('DSH_BRAIN_MEMORY_TOKEN') ?? envToken('DSH_CLOUD_MEMORY_MEMORY_TOKEN') ?? '';
|
||||
}
|
||||
/** The summary:write bearer token (optional; absent disables summaries). */
|
||||
summaryToken() {
|
||||
return this.state.summaryToken ?? envToken('DSH_BRAIN_SUMMARY_TOKEN') ?? envToken('DSH_CLOUD_MEMORY_SUMMARY_TOKEN') ?? '';
|
||||
}
|
||||
/** Masked snapshot for the browser card. */
|
||||
describe() {
|
||||
const settings = this.settings();
|
||||
const activity = this.activityToken();
|
||||
const memory = this.memoryToken();
|
||||
const summary = this.summaryToken();
|
||||
return {
|
||||
...settings,
|
||||
activityToken: { configured: activity !== '', masked: activity === '' ? '' : maskToken(activity) },
|
||||
memoryToken: { configured: memory !== '', masked: memory === '' ? '' : maskToken(memory) },
|
||||
summaryToken: { configured: summary !== '', masked: summary === '' ? '' : maskToken(summary) },
|
||||
statePath: this.file,
|
||||
baseUrlConfigured: !isPlaceholderBaseUrl(settings.baseUrl),
|
||||
baseUrlOrigin: originOf(settings.baseUrl),
|
||||
};
|
||||
}
|
||||
/**
|
||||
* Apply a partial patch from the settings card.
|
||||
*
|
||||
* Token fields follow "absent means keep": only a non-empty string replaces a
|
||||
* stored token, and an explicit boolean `clear*` flag removes one. That way
|
||||
* the browser never has to round-trip a secret it cannot read.
|
||||
*/
|
||||
patch(patch) {
|
||||
const next = { ...this.state };
|
||||
const beforeOrigin = originOf(this.settings().baseUrl);
|
||||
/** Tokens this very request supplied; they survive an address change. */
|
||||
const provided = [];
|
||||
if (patch.enabled !== undefined) {
|
||||
if (typeof patch.enabled !== 'boolean')
|
||||
return { ok: false, error: 'enabled must be a boolean' };
|
||||
next.enabled = patch.enabled;
|
||||
}
|
||||
if (patch.baseUrl !== undefined) {
|
||||
const baseUrl = normalizeBaseUrl(patch.baseUrl);
|
||||
if (baseUrl === undefined)
|
||||
return { ok: false, error: 'baseUrl must be an http(s) URL' };
|
||||
next.baseUrl = baseUrl;
|
||||
}
|
||||
if (patch.clientId !== undefined) {
|
||||
const clientId = cleanString(patch.clientId);
|
||||
if (clientId === undefined)
|
||||
return { ok: false, error: 'clientId must be a non-empty string' };
|
||||
next.clientId = clientId.slice(0, 128);
|
||||
}
|
||||
const activityToken = cleanString(patch.activityToken);
|
||||
if (activityToken !== undefined) {
|
||||
if (!activityToken.startsWith('cmt_'))
|
||||
return { ok: false, error: 'activity token must start with cmt_' };
|
||||
next.activityToken = activityToken;
|
||||
provided.push('activity');
|
||||
}
|
||||
const memoryToken = cleanString(patch.memoryToken);
|
||||
if (memoryToken !== undefined) {
|
||||
if (!memoryToken.startsWith('cmt_'))
|
||||
return { ok: false, error: 'memory token must start with cmt_' };
|
||||
next.memoryToken = memoryToken;
|
||||
provided.push('memory');
|
||||
}
|
||||
if (patch.requestTimeoutMs !== undefined) {
|
||||
const requestTimeoutMs = clampInt(patch.requestTimeoutMs, 1000, 60_000);
|
||||
if (requestTimeoutMs === undefined)
|
||||
return { ok: false, error: 'requestTimeoutMs must be a number' };
|
||||
next.requestTimeoutMs = requestTimeoutMs;
|
||||
}
|
||||
if (patch.defaultK !== undefined) {
|
||||
const defaultK = clampInt(patch.defaultK, 1, 100);
|
||||
if (defaultK === undefined)
|
||||
return { ok: false, error: 'defaultK must be a number' };
|
||||
next.defaultK = defaultK;
|
||||
}
|
||||
if (patch.summaryEnabled !== undefined) {
|
||||
if (typeof patch.summaryEnabled !== 'boolean')
|
||||
return { ok: false, error: 'summaryEnabled must be a boolean' };
|
||||
next.summaryEnabled = patch.summaryEnabled;
|
||||
}
|
||||
if (patch.summaryMaxChars !== undefined) {
|
||||
const summaryMaxChars = clampInt(patch.summaryMaxChars, 1000, 16_000);
|
||||
if (summaryMaxChars === undefined)
|
||||
return { ok: false, error: 'summaryMaxChars must be a number' };
|
||||
next.summaryMaxChars = summaryMaxChars;
|
||||
}
|
||||
const summaryToken = cleanString(patch.summaryToken);
|
||||
if (summaryToken !== undefined) {
|
||||
if (!summaryToken.startsWith('cmt_'))
|
||||
return { ok: false, error: 'summary token must start with cmt_' };
|
||||
next.summaryToken = summaryToken;
|
||||
provided.push('summary');
|
||||
}
|
||||
if (patch.clearSummaryToken === true)
|
||||
delete next.summaryToken;
|
||||
if (patch.clearActivityToken === true)
|
||||
delete next.activityToken;
|
||||
if (patch.clearMemoryToken === true)
|
||||
delete next.memoryToken;
|
||||
// Switching the service origin must not hand the previous service's
|
||||
// bearer tokens to the new one: everything this request did not explicitly
|
||||
// replace is dropped, and the caller is told so it can ask to re-authenticate.
|
||||
const afterOrigin = originOf(next.baseUrl ?? this.configDefaults.baseUrl);
|
||||
const clearedTokens = [];
|
||||
if (beforeOrigin !== '' && afterOrigin !== '' && beforeOrigin !== afterOrigin) {
|
||||
const credentials = [
|
||||
['activity', 'activityToken'],
|
||||
['memory', 'memoryToken'],
|
||||
['summary', 'summaryToken'],
|
||||
];
|
||||
for (const [label, key] of credentials) {
|
||||
if (next[key] === undefined)
|
||||
continue;
|
||||
if (provided.includes(label))
|
||||
continue;
|
||||
delete next[key];
|
||||
clearedTokens.push(label);
|
||||
}
|
||||
}
|
||||
this.write(next);
|
||||
this.state = next;
|
||||
return clearedTokens.length === 0 ? { ok: true } : { ok: true, clearedTokens };
|
||||
}
|
||||
/** File size in bytes, for a "sidecar exists" hint in the card. */
|
||||
size() {
|
||||
try {
|
||||
return statSync(this.file).size;
|
||||
}
|
||||
catch {
|
||||
return undefined;
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue