mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
5c7dd6f8eb
`Config.roots` defaulted to `[]`, so a deployment that did not patch both roots in got a roster with none — `dsh run` once booted exactly that and failed resolving `standard`. The user root never needed an app: `<dshHome>/.agent-presets` is the same place in every deployment, resolvable here the way `dsh-skill-local` resolves `<dshHome>/skills`. The roster now derives that root itself unless `includeUserRoot` is false, and `apps/cli` supplies only the SHIPPED root, whose path an installed app alone can resolve. The derived root is appended after every configured root, so a shipped id still shadows a home directory claiming it and `writableRoot()` still prefers an explicitly configured `user` root; the set is resolved once at construction, because a root set that changed between a `list()` and the `copy()` acting on its answer would author into a directory the caller never saw. Every test that pins an exact roster now says `includeUserRoot: false` — the machine's real harness home must not decide what a golden or an assertion counts.
94 lines
3.5 KiB
TypeScript
94 lines
3.5 KiB
TypeScript
/** Agent-preset vocabulary shared by discovery, mounting, and consumers. */
|
|
|
|
/**
|
|
* Where a preset's composition came from. A `system` preset ships with the
|
|
* deployment; a `user` preset was authored locally, by a person or by an
|
|
* agent, and therefore carries the same trust as shell access.
|
|
*/
|
|
export type PresetTrust = 'system' | 'user'
|
|
|
|
/**
|
|
* Ids a preset directory may use.
|
|
*
|
|
* The id becomes a path segment, so this is a containment boundary rather than
|
|
* a style rule: `..`, a separator, or an absolute-looking name would place the
|
|
* composition outside the root the deployment authorised. Discovery shares it:
|
|
* a directory whose name no copy could ever claim is not a preset slot.
|
|
*/
|
|
export const PRESET_ID = /^[a-z0-9][a-z0-9-]*$/
|
|
|
|
/** One preset directory that carries a mountable agent composition. */
|
|
export interface AgentPreset {
|
|
/** Stable identifier; the preset directory's name. */
|
|
readonly id: string
|
|
/** Trust recorded from the root this preset was discovered under. */
|
|
readonly trust: PresetTrust
|
|
/** Absolute path of the preset's agent composition file. */
|
|
readonly path: string
|
|
/** Display name from the preset's own metadata; absent falls back to {@link id}. */
|
|
readonly name?: string
|
|
/** One sentence on what this preset is for, when it published one. */
|
|
readonly description?: string
|
|
/** Declared position within its group; absent sorts after those that declare one. */
|
|
readonly order?: number
|
|
/**
|
|
* Why this preset cannot compose a session, absent when it can. A broken
|
|
* preset stays on the roster — hiding it would leave its directory blocking
|
|
* the id with nothing to see or delete — but every mounting path refuses it
|
|
* up front with this reason instead of failing deep inside the loader.
|
|
*/
|
|
readonly broken?: string
|
|
}
|
|
|
|
/** One directory scanned for preset subdirectories. */
|
|
export interface PresetRoot {
|
|
/** Directory holding one subdirectory per preset; a leading `~` expands. */
|
|
path: string
|
|
/** Trust recorded on every preset discovered under this root. */
|
|
trust: PresetTrust
|
|
}
|
|
|
|
/** Plugin config: which preset is the default, and where presets live. */
|
|
export interface Config {
|
|
/** Preset id mounted when a caller names none. Missing at mount time fails loud. */
|
|
default: string
|
|
/** Scanned roots in precedence order; an earlier root wins a duplicate id. */
|
|
roots: PresetRoot[]
|
|
/**
|
|
* Append the harness home's `USER_PRESET_DIR` as a `user` root, after every
|
|
* configured root. False mounts a roster over `roots` alone.
|
|
*/
|
|
includeUserRoot: boolean
|
|
}
|
|
|
|
/**
|
|
* No configured root supplies the requested preset.
|
|
*
|
|
* Separate from a mount failure because the two mean different things to a
|
|
* caller: an unknown id is a bad request, while an unusable composition is a
|
|
* broken preset the deployment must fix.
|
|
*/
|
|
export class UnknownPresetError extends Error {
|
|
constructor(
|
|
/** The id that was requested. */
|
|
readonly presetId: string,
|
|
/** Ids the roster does supply, for the caller to offer instead. */
|
|
readonly available: readonly string[],
|
|
) {
|
|
super(`agent-presets: preset "${presetId}" not found (available: ${available.join(', ') || 'none'})`)
|
|
}
|
|
}
|
|
|
|
/** A preset exists but its composition cannot be installed. */
|
|
export class PresetMountError extends Error {
|
|
constructor(
|
|
/** The preset whose composition failed. */
|
|
readonly presetId: string,
|
|
/** Why it failed, without this package's own message prefix. */
|
|
readonly reason: string,
|
|
options?: ErrorOptions,
|
|
) {
|
|
super(`agent-presets: preset "${presetId}" failed to mount: ${reason}`, options)
|
|
}
|
|
}
|