dsh-brain/src/config.ts

125 lines
4.8 KiB
TypeScript

/**
* Settings model: the cordis row config supplies defaults, the user-editable
* sidecar (`$DSH_HOME/dsh-brain.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
}
}
/**
* A packaged default that was never replaced by a real service.
*
* `cordis.patch.yml` ships `https://your-memory-host/...` so a fresh profile
* boots without touching a production endpoint. Such an address must be shown
* as "未配置服务" — never as a healthy connection.
*/
export function isPlaceholderBaseUrl(value: string): boolean {
const normalized = normalizeBaseUrl(value)
if (normalized === undefined) return true
try {
const host = new URL(normalized).hostname.toLowerCase()
return host === 'your-memory-host' || host === 'example.com'
} catch {
return true
}
}
/** Service origin of one base URL, or '' when it cannot be parsed. */
export function originOf(value: string): string {
try {
return new URL(value).origin
} catch {
return ''
}
}
/** 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
}