mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
2cde2a9032
Conflict resolution notes: - package.json/run-gates: both sides' new doc-sync gates kept (master's scoped-events/readme gates + this branch's website-api/website-yaml); js-yaml devDeps deduped (master added them independently). - pnpm-workspace/knip: website AND python/sdk-runtime entries kept. - doc-typecheck/verify-type-equiv: master's condensed headers kept, website glob retained in both scan scopes. - vendor/cordis/src/fiber.ts: master's lifecycle-hardening code taken; this branch's richer FiberState JSDoc reapplied on top. vendor/README.md logs both local modifications (hardening = 6, JSDoc enrichment = 7). - pnpm-lock: regenerated from master's side (pnpm install). Post-merge sync the gates forced (the system working as designed): - verify-website-yaml caught 4 stale plugin names from master's package reorg (dsh-stdio-agent -> dsh-stdio-demo, dsh-acp-agent -> dsh-acp-demo); 8 references fixed across guide/ and develop/. - gen-website-api picked up master's 6 new services automatically (ctx.approval/permission/sandbox/sessionQuery/skills/tasks -> 6 new pages + sidebar); api/index.md hub updated to list them. - AGENTS.md budget ceiling 1370 -> 1400: the website rows (layout line + two command lines) and master's own growth collided with the old ceiling; all three website rows are load-bearing (new top-level dir, new CI command).
67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
<!-- Generated by scripts/gen-website-api.ts — do not edit by hand. Run `pnpm run gen-website-api` to regenerate. -->
|
|
|
|
# ctx.systemPrompt
|
|
|
|
`SystemPrompt` — provided by `@deepseek-ai/dsh-system-prompt`.
|
|
|
|
Registry service for the prompt inputs assembled before each model step.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/core/system-prompt/src/index.ts#L209)
|
|
|
|
### ctx.systemPrompt.section(section)
|
|
|
|
```ts website-api
|
|
section(section: PromptSection): () => void
|
|
```
|
|
|
|
Register an ordered prompt section in the calling context's scope. A scoped section shadows a global section with the same name; duplicates within one layer and non-finite orders throw. Registration and disposal emit `system-prompt/change`.
|
|
|
|
- `section` — the section to register.
|
|
|
|
**Returns** the exact Cordis effect disposer.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/core/system-prompt/src/index.ts#L250)
|
|
|
|
### ctx.systemPrompt.tools(provider)
|
|
|
|
```ts website-api
|
|
tools(provider: (context: AssembleContext) => ToolProviderResult): () => void
|
|
```
|
|
|
|
Register a tool-schema provider in the calling context's scope. Global and matching scoped providers both contribute; returning the reserved TOOL_ORDER_REST name makes assembly fail.
|
|
|
|
- `provider` — evaluated for each assembly with its context.
|
|
|
|
**Returns** the exact Cordis effect disposer.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/core/system-prompt/src/index.ts#L291)
|
|
|
|
### ctx.systemPrompt.variable(name, provider)
|
|
|
|
```ts website-api
|
|
variable(name: string, provider: (context: AssembleContext) => string | undefined): () => void
|
|
```
|
|
|
|
Register a prompt variable in the calling context's scope. Scoped values shadow globals; invalid or duplicate names throw. A provider may return `undefined`, but rendering a section that references that value then fails.
|
|
|
|
- `name` — the `[a-z][a-z0-9_]*` reference name.
|
|
- `provider` — evaluated for each assembly.
|
|
|
|
**Returns** the exact Cordis effect disposer.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/core/system-prompt/src/index.ts#L325)
|
|
|
|
### ctx.systemPrompt.assemble(context?)
|
|
|
|
```ts website-api
|
|
async assemble(context: AssembleContext = {}): Promise<PromptAssembly>
|
|
```
|
|
|
|
Assemble global and scoped providers, detach tool parameters, apply canonical ordering, then run the assembly waterfall. Scoped sections and variables shadow globals; the returned waterfall value is authoritative.
|
|
|
|
- `context` — the optional scope and plugin-defined assembly fields.
|
|
|
|
**Returns** the authoritative post-waterfall assembly.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/core/system-prompt/src/index.ts#L365)
|