mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
b7034e4a26
Four values complete the vocabulary, so the opaque body is reached only by producers that genuinely promise no shape. `snapshot` — current state a later snapshot supersedes. system-prompt now exposes `renderContextSections()`, the named contributions `renderContextSnapshot()` already joins for the model, so the body attributes each part to the subsystem that produced it instead of re-splitting joined prose. The runtime snapshot, time-context, and tmux-context declare it. `notice` — a one-off account of what just happened, declared by tool-tasks, goal state changes, tool-goal wrap-up, plan-mode switches, and repeat-tool-guard. Its `summary` rides the COLLAPSED row: these five are the majority of shipped producers and none of them needs expanding to be read. The task summary bounds itself because its inputs are unbounded caller text. `relay` — a message another agent addressed to this one; both subagent sources declare it and the body names the sender above what it said. `recall` — material lifted from another session's log. session-reference needed no new field: its references already record retained and omitted counts and the truncation flag, which the body shows first, because recalled context is bounded on the way in. `ContextFormed` is now discriminated by `form`, so a producer cannot declare a shape without the facts that shape is presented from — a notice without its summary, or a snapshot without its sections, fails to compile. Only the two hook bridges stay opaque, by design: their content is whatever an external program printed, so no shape can be promised for it. Unknown kinds and unreadable records land there too.
90 lines
4.5 KiB
TypeScript
90 lines
4.5 KiB
TypeScript
/**
|
||
* Context provenance projection: the role and producer name a transcript row
|
||
* shows for one logged non-user message, read from the durable source alone.
|
||
*/
|
||
|
||
import { describe, expect, it } from 'vitest'
|
||
import { contextForm, contextProvenance } from '../src/client/sessions/context-provenance.ts'
|
||
|
||
describe('contextProvenance', () => {
|
||
it('names a plugin producer by its logged plugin id', () => {
|
||
expect(contextProvenance({ kind: 'plugin', plugin: 'dsh-tool-skill' }))
|
||
.toEqual({ role: 'inject', label: 'dsh-tool-skill' })
|
||
})
|
||
|
||
it('names workspace instructions by the files they reconciled, deduplicated in first-seen order', () => {
|
||
expect(contextProvenance({
|
||
kind: 'workspace-instructions',
|
||
baseline: true,
|
||
changes: [
|
||
{ action: 'set', scope: '. AGENTS.md', path: 'AGENTS.md' },
|
||
{ action: 'set', scope: 'sub AGENTS.md', path: 'sub/AGENTS.md' },
|
||
{ action: 'replace', scope: '. AGENTS.md', path: 'AGENTS.md' },
|
||
],
|
||
})).toEqual({ role: 'inject', label: 'AGENTS.md, sub/AGENTS.md' })
|
||
})
|
||
|
||
it('marks a cross-session snapshot as recall and names the sessions it read', () => {
|
||
expect(contextProvenance({
|
||
kind: 'session-reference',
|
||
version: 1,
|
||
references: [{ sessionId: 's1', label: 'Refactor the loader' }, { sessionId: 's2', label: 'Fix CI' }],
|
||
})).toEqual({ role: 'recall', label: 'Refactor the loader, Fix CI' })
|
||
})
|
||
|
||
it('identifies a producer this UI version does not know by its own durable kind', () => {
|
||
expect(contextProvenance({ kind: 'subagent-report', senderSessionId: 'child' }))
|
||
.toEqual({ role: 'inject', label: 'subagent-report' })
|
||
})
|
||
|
||
it('falls back to the source kind when the expected name field is unusable', () => {
|
||
// Every arm keeps the kind as its last readable name: a missing, empty, or
|
||
// wrongly-typed name field must not blank the row header.
|
||
expect(contextProvenance({ kind: 'plugin' }).label).toBe('plugin')
|
||
expect(contextProvenance({ kind: 'plugin', plugin: '' }).label).toBe('plugin')
|
||
expect(contextProvenance({ kind: 'plugin', plugin: 7 }).label).toBe('plugin')
|
||
expect(contextProvenance({ kind: 'workspace-instructions', changes: [] }).label)
|
||
.toBe('workspace-instructions')
|
||
expect(contextProvenance({ kind: 'workspace-instructions', changes: 'AGENTS.md' }).label)
|
||
.toBe('workspace-instructions')
|
||
expect(contextProvenance({ kind: 'workspace-instructions', changes: [{ action: 'set' }, null] }).label)
|
||
.toBe('workspace-instructions')
|
||
expect(contextProvenance({ kind: 'session-reference', references: [] }))
|
||
.toEqual({ role: 'recall', label: 'session-reference' })
|
||
})
|
||
|
||
it('degrades to an unnamed injection for a source that carries no readable kind', () => {
|
||
const unnamed = { role: 'inject', label: null }
|
||
expect(contextProvenance(null)).toEqual(unnamed)
|
||
expect(contextProvenance(undefined)).toEqual(unnamed)
|
||
expect(contextProvenance('plugin')).toEqual(unnamed)
|
||
expect(contextProvenance([{ kind: 'plugin' }])).toEqual(unnamed)
|
||
expect(contextProvenance({ plugin: 'dsh-tool-skill' })).toEqual(unnamed)
|
||
expect(contextProvenance({ kind: 42 })).toEqual(unnamed)
|
||
})
|
||
})
|
||
|
||
describe('contextForm', () => {
|
||
it('reads the form a producer declared', () => {
|
||
expect(contextForm({ kind: 'workspace-instructions', form: 'instructions', changes: [] }))
|
||
.toBe('instructions')
|
||
expect(contextForm({ kind: 'skill-catalog', form: 'catalog', entries: [] })).toBe('catalog')
|
||
expect(contextForm({ kind: 'plugin', form: 'snapshot', sections: [] })).toBe('snapshot')
|
||
expect(contextForm({ kind: 'plugin', form: 'notice', summary: 'x' })).toBe('notice')
|
||
expect(contextForm({ kind: 'subagent-report', form: 'relay' })).toBe('relay')
|
||
expect(contextForm({ kind: 'session-reference', form: 'recall' })).toBe('recall')
|
||
})
|
||
|
||
it('degrades to the opaque presentation for anything this version does not present', () => {
|
||
// The durable vocabulary may already be wider than this UI version, and a
|
||
// source need not declare a form at all; neither may drop the row.
|
||
expect(contextForm({ kind: 'plugin', plugin: 'dsh-tool-skill' })).toBeNull()
|
||
// A durable vocabulary wider than this UI version still renders.
|
||
expect(contextForm({ kind: 'plugin', form: 'a-later-form' })).toBeNull()
|
||
expect(contextForm({ kind: 'plugin', form: '' })).toBeNull()
|
||
expect(contextForm({ kind: 'plugin', form: 7 })).toBeNull()
|
||
expect(contextForm(null)).toBeNull()
|
||
expect(contextForm('instructions')).toBeNull()
|
||
})
|
||
})
|