mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
65 lines
2.4 KiB
TypeScript
65 lines
2.4 KiB
TypeScript
/**
|
|
* A per-agent persona as a composable row.
|
|
*
|
|
* `dsh-system-prompt` owns the global persona as its own config, and registers
|
|
* that section unconditionally — so this row is **scope-only**. Mounted inside
|
|
* an agent preset it shadows the deployment persona for that one session,
|
|
* exactly like the per-child persona `dsh-subagent` installs; mounted globally
|
|
* it collides with the registry's own registration and fails loud.
|
|
*
|
|
* That constraint is the reason the row exists. An agent preset cannot mount
|
|
* the prompt registry itself, so without a row of its own a preset could
|
|
* change an agent's tools but never its identity.
|
|
* @module @deepseek-ai/dsh-persona
|
|
*/
|
|
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
import z from '@deepseek-ai/schemastery'
|
|
import type {} from '@deepseek-ai/dsh-system-prompt'
|
|
|
|
// Imported rather than restated: the registry declares the slot this row
|
|
// replaces, and two hardcoded copies would drift into a preset whose persona
|
|
// silently lands beside the deployment's instead of shadowing it.
|
|
import { PERSONA_ORDER, PERSONA_SECTION } from '@deepseek-ai/dsh-system-prompt'
|
|
|
|
export { PERSONA_ORDER, PERSONA_SECTION }
|
|
|
|
/** Cordis plugin name. */
|
|
export const name = 'persona'
|
|
|
|
/** The prompt registry this row contributes to. */
|
|
export const inject = ['systemPrompt']
|
|
|
|
/** Plugin config: the persona text this composition contributes. */
|
|
export interface Config {
|
|
/**
|
|
* Persona prose rendered as the `deployment:persona` section. A template:
|
|
* complete `{{…}}` groups interpolate strictly against registered prompt
|
|
* variables. Empty text drops the section at render, matching the registry.
|
|
*/
|
|
text: string
|
|
/** Make this persona the complete system prompt, suppressing every other section. */
|
|
complete?: boolean
|
|
}
|
|
|
|
/** Runtime schema for the persona row. */
|
|
export const Config: z<Config> = z.object({
|
|
text: z.string().required(),
|
|
complete: z.boolean().default(false),
|
|
})
|
|
|
|
/**
|
|
* Register the persona section for the mounting context's scope.
|
|
* @param ctx - an agent scope context; an unscoped context collides with the
|
|
* prompt registry's own persona registration and rejects.
|
|
* @param config - the persona text and complete-prompt policy.
|
|
*/
|
|
export function apply(ctx: Context, config: Config): void {
|
|
ctx.effect(() => ctx.systemPrompt.section({
|
|
name: PERSONA_SECTION,
|
|
order: PERSONA_ORDER,
|
|
text: config.text,
|
|
...(config.complete ? { complete: true } : {}),
|
|
}), 'persona.section()')
|
|
}
|