dsh-brain/src/config.ts

98 lines
4.0 KiB
TypeScript

/**
* Settings model: the cordis row config supplies defaults, the user-editable
* sidecar (`$DSH_HOME/cloud-memory.json`) overrides them, and secrets live ONLY
* in the sidecar. Nothing here ever reaches the conversation or a model context.
*/
/** Defaults written into cordis.patch.yml; also the fallback for missing keys. */
export const DEFAULT_SETTINGS: Settings = {
enabled: true,
baseUrl: 'https://your-memory-host/api/longmemory',
clientId: 'dsh-desktop',
requestTimeoutMs: 5000,
defaultK: 10,
summaryEnabled: true,
summaryMaxChars: 6000,
skillsSyncEnabled: true,
skillsDir: '',
}
/** Effective, fully-resolved settings. */
export interface Settings {
/** Master switch for turn reporting AND memory tools. */
enabled: boolean
/** Base URL of the cloud memory service, without a trailing slash. */
baseUrl: string
/** Stable client identifier sent with every activity turn. */
clientId: string
/** Per-request HTTP timeout in milliseconds. */
requestTimeoutMs: number
/** Default result count for `memory_search`. */
defaultK: number
/** Stage a turn summary as pending proposals after each completed round. */
summaryEnabled: boolean
/** Maximum transcript characters sent for one summary (privacy/cost cap). */
summaryMaxChars: number
/** Bidirectional skill sync between the cloud skill center and the local skills directory. */
skillsSyncEnabled: boolean
/** Local skills directory override; empty means `$DSH_HOME/skills`. */
skillsDir: string
}
/** Raw row config as it comes out of the cordis loader. */
export type RawConfig = Partial<Record<keyof Settings, unknown>>
const MIN_TIMEOUT_MS = 1000
const MAX_TIMEOUT_MS = 60_000
/** Trim truncation guard for the free-form identifiers. */
function shortString(value: unknown): string | undefined {
if (typeof value !== 'string') return undefined
const trimmed = value.trim()
if (trimmed === '') return undefined
return trimmed.slice(0, 128)
}
/**
* Normalize a base URL: require http(s), drop trailing slashes and any query.
* Returns undefined when the input is unusable, so callers can fall back.
*/
export function normalizeBaseUrl(value: unknown): string | undefined {
if (typeof value !== 'string' || value.trim() === '') return undefined
try {
const url = new URL(value.trim())
if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined
return `${url.origin}${url.pathname.replace(/\/+$/, '')}`
} catch {
return undefined
}
}
/** Clamp a numeric config value into an integer range, else undefined. */
function boundedInt(value: unknown, min: number, max: number): number | undefined {
if (typeof value !== 'number' || !Number.isFinite(value)) return undefined
return Math.min(max, Math.max(min, Math.round(value)))
}
/** Extract the recognized settings from an untrusted row config object. */
export function settingsFromConfig(raw: unknown): Partial<Settings> {
if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return {}
const source = raw as RawConfig
const result: Partial<Settings> = {}
if (typeof source.enabled === 'boolean') result.enabled = source.enabled
const baseUrl = normalizeBaseUrl(source.baseUrl)
if (baseUrl !== undefined) result.baseUrl = baseUrl
const clientId = shortString(source.clientId)
if (clientId !== undefined) result.clientId = clientId
const timeout = boundedInt(source.requestTimeoutMs, MIN_TIMEOUT_MS, MAX_TIMEOUT_MS)
if (timeout !== undefined) result.requestTimeoutMs = timeout
const defaultK = boundedInt(source.defaultK, 1, 100)
if (defaultK !== undefined) result.defaultK = defaultK
if (typeof source.summaryEnabled === 'boolean') result.summaryEnabled = source.summaryEnabled
const summaryMaxChars = boundedInt(source.summaryMaxChars, 1000, 16_000)
if (summaryMaxChars !== undefined) result.summaryMaxChars = summaryMaxChars
if (typeof source.skillsSyncEnabled === 'boolean') result.skillsSyncEnabled = source.skillsSyncEnabled
if (typeof source.skillsDir === 'string') result.skillsDir = source.skillsDir.trim().slice(0, 512)
return result
}