mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
567 lines
25 KiB
TypeScript
567 lines
25 KiB
TypeScript
/**
|
|
* Consumer-surface tests over a fake provider and the real policy collaborator: schemas,
|
|
* validation, formatting, typed errors, intent dispatch, and observation-driven authorization.
|
|
*/
|
|
|
|
import { describe, expect, it, vi } from 'vitest'
|
|
import { Context } from 'cordis'
|
|
import { CallId } from '@deepseek-ai/dsh-llm'
|
|
import SystemPrompt, { renderPrompt } from '@deepseek-ai/dsh-system-prompt'
|
|
import ToolRegistry from '@deepseek-ai/dsh-tools'
|
|
import { FileSystem, FsError, FsTargetKey, FsVersion } from '@deepseek-ai/dsh-fs'
|
|
import type {
|
|
FsDirEntry,
|
|
FsEditOutcome,
|
|
FsEditRequest,
|
|
FsInfo,
|
|
FsTarget,
|
|
FsWriteIntent,
|
|
FsWriteOutcome,
|
|
} from '@deepseek-ai/dsh-fs'
|
|
import * as FsPolicy from '@deepseek-ai/dsh-fs-policy'
|
|
import * as ToolFs from '@deepseek-ai/dsh-tool-fs'
|
|
import { STREAM_MIN_SIZE } from '../src/read.ts'
|
|
import { formatReadOutput } from '../src/read-render.ts'
|
|
import type { FileReadOutcome } from '../src/read-render.ts'
|
|
|
|
/** An in-memory fake provider; a test can arm a rejection on any primitive. */
|
|
class FakeFs extends FileSystem {
|
|
files = new Map<string, string>()
|
|
rejectWith?: FsError
|
|
writeIntents: (FsWriteIntent | undefined)[] = []
|
|
editIntents: ({ version: FsVersion } | undefined)[] = []
|
|
|
|
private throwIfArmed(): void {
|
|
if (this.rejectWith) throw this.rejectWith
|
|
}
|
|
|
|
override async resolve(path: string): Promise<FsTarget> {
|
|
return { targetKey: FsTargetKey(`key:${path}`), displayPath: `/abs/${path}` }
|
|
}
|
|
override async stat(target: FsTarget): Promise<FsInfo | undefined> {
|
|
this.throwIfArmed()
|
|
const content = this.files.get(target.targetKey)
|
|
if (content === undefined) return undefined
|
|
return { version: FsVersion('v1'), type: 'file', size: content.length }
|
|
}
|
|
override async readText(target: FsTarget): Promise<string> {
|
|
return this.files.get(target.targetKey) ?? ''
|
|
}
|
|
override async streamText(target: FsTarget): Promise<AsyncIterable<string>> {
|
|
const content = this.files.get(target.targetKey) ?? ''
|
|
return (async function* () { yield content })()
|
|
}
|
|
override async listDir(_target: FsTarget): Promise<FsDirEntry[]> {
|
|
return []
|
|
}
|
|
override async writeText(target: FsTarget, content: string, expected?: FsWriteIntent): Promise<FsWriteOutcome> {
|
|
this.throwIfArmed()
|
|
this.writeIntents.push(expected)
|
|
const before = this.files.get(target.targetKey) ?? null
|
|
this.files.set(target.targetKey, content)
|
|
return { operation: before !== null ? 'update' : 'create', version: FsVersion('v2'), before, after: content }
|
|
}
|
|
override async editText(target: FsTarget, edit: FsEditRequest, expected?: { version: FsVersion }): Promise<FsEditOutcome> {
|
|
this.throwIfArmed()
|
|
this.editIntents.push(expected)
|
|
const content = this.files.get(target.targetKey) ?? ''
|
|
const after = content.split(edit.oldString).join(edit.newString)
|
|
this.files.set(target.targetKey, after)
|
|
return { version: FsVersion('v3'), before: content, after }
|
|
}
|
|
}
|
|
|
|
async function setup() {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(FakeFs)
|
|
await ctx.plugin(FsPolicy)
|
|
await ctx.plugin(ToolFs)
|
|
const fs = ctx.fs as FakeFs
|
|
return { ctx, fs }
|
|
}
|
|
|
|
let callCounter = 0
|
|
function call(ctx: Context, name: string, args: unknown, agent?: object) {
|
|
return ctx.tools.execute({
|
|
callId: CallId(`call-${++callCounter}`),
|
|
name,
|
|
arguments: args,
|
|
...agent ? { agent: agent as never } : {},
|
|
})
|
|
}
|
|
|
|
function text(result: { content: { type: string; text?: string }[] }): string {
|
|
return result.content.filter(b => b.type === 'text').map(b => b.text).join('')
|
|
}
|
|
|
|
describe('registration', () => {
|
|
it('registers read, write, and edit', async () => {
|
|
const { ctx } = await setup()
|
|
expect(ctx.tools.schemas().map(s => s.name).sort()).toEqual(['edit', 'read', 'write'])
|
|
})
|
|
|
|
it('registers prompt sections for each tool', async () => {
|
|
const { ctx } = await setup()
|
|
const prompt = renderPrompt(await ctx.systemPrompt.assemble())
|
|
expect(prompt).toContain('Use the read tool')
|
|
expect(prompt).toContain('Use the write tool')
|
|
expect(prompt).toContain('Use the edit tool')
|
|
})
|
|
|
|
it('stays pending until ctx.fs exists (inject)', async () => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(ToolFs) // no fs provider
|
|
expect(ctx.tools.schemas()).toHaveLength(0)
|
|
})
|
|
|
|
it('unregisters everything on fiber disposal (HMR safety)', async () => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(FakeFs)
|
|
await ctx.plugin(FsPolicy)
|
|
const fiber = await ctx.plugin(ToolFs)
|
|
// Each tool contributes BOTH a schema and a prompt section; disposal must
|
|
// withdraw both, not just the schemas.
|
|
expect(ctx.tools.schemas()).toHaveLength(3)
|
|
const sectionNames = (a: { sections: { name: string }[] }) => a.sections.map(s => s.name).sort()
|
|
expect(sectionNames(await ctx.systemPrompt.assemble())).toEqual(['deployment:persona', 'harness:identity', 'tool:edit', 'tool:read', 'tool:write'])
|
|
await fiber.dispose()
|
|
expect(ctx.tools.schemas()).toHaveLength(0)
|
|
// Only the system-prompt plugin's own built-in sections remain.
|
|
expect(sectionNames(await ctx.systemPrompt.assemble())).toEqual(['deployment:persona', 'harness:identity'])
|
|
})
|
|
})
|
|
|
|
describe('read tool', () => {
|
|
it('formats line-numbered content with a footer', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.files.set('key:a.txt', 'hello\nworld')
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(result.isError).toBe(false)
|
|
expect(text(result)).toBe(`<path>/abs/a.txt</path>
|
|
<type>file</type>
|
|
<content>
|
|
1: hello
|
|
2: world
|
|
|
|
(End of file - total 2 lines)
|
|
</content>`)
|
|
})
|
|
|
|
it('rejects a non-positive offset via arg validation', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt', offset: 0 })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('offset must be a positive integer')
|
|
})
|
|
|
|
it('rejects a fractional offset and a zero/negative limit', async () => {
|
|
const { ctx } = await setup()
|
|
for (const args of [
|
|
{ file_path: 'a.txt', offset: 1.5 },
|
|
{ file_path: 'a.txt', limit: 0 },
|
|
{ file_path: 'a.txt', limit: -3 },
|
|
]) {
|
|
const result = await call(ctx, 'read', args)
|
|
expect(result.isError, JSON.stringify(args)).toBe(true)
|
|
expect(text(result)).toMatch(/must be a positive integer/)
|
|
}
|
|
})
|
|
|
|
it('rejects a non-JSON numeric offset before tool-specific validation', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt', offset: Number.NaN })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('tool execution arguments must be losslessly JSON-serializable')
|
|
})
|
|
|
|
it('rejects a limit above the cap', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt', limit: 99999 })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('less than or equal to 2000')
|
|
})
|
|
|
|
it('rejects a blank file_path', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'read', { file_path: ' ' })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('file_path must be a non-empty string')
|
|
})
|
|
|
|
it('records observed state so a follow-up edit by the same session is authorized', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', 'hello')
|
|
expect((await call(ctx, 'read', { file_path: 'a.txt' }, { session })).isError).toBe(false)
|
|
const edited = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'hello', new_string: 'bye' }, { session })
|
|
expect(edited.isError).toBe(false)
|
|
expect(fs.editIntents).toEqual([{ version: 'v1' }])
|
|
})
|
|
|
|
it('propagates FS_NOT_FOUND for an absent file', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'read', { file_path: 'missing.txt' })
|
|
expect(result.isError).toBe(true)
|
|
expect(result.error).toMatchObject({ code: 'FS_NOT_FOUND' })
|
|
})
|
|
|
|
it('rejects a non-regular target', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.files.set('key:d', '')
|
|
fs.stat = async () => ({ version: FsVersion('v1'), type: 'directory' })
|
|
const result = await call(ctx, 'read', { file_path: 'd' })
|
|
expect(result.isError).toBe(true)
|
|
expect(result.error).toMatchObject({ code: 'FS_NOT_REGULAR_FILE' })
|
|
})
|
|
|
|
it('streams a large file (size at/above the cap) instead of reading whole', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.files.set('key:big.txt', 'alpha\nbeta')
|
|
const readSpy = vi.spyOn(fs, 'readText')
|
|
const streamSpy = vi.spyOn(fs, 'streamText')
|
|
fs.stat = async () => ({ version: FsVersion('v1'), type: 'file', size: STREAM_MIN_SIZE })
|
|
const result = await call(ctx, 'read', { file_path: 'big.txt' })
|
|
expect(result.isError).toBe(false)
|
|
expect(text(result)).toContain('1: alpha')
|
|
expect(streamSpy).toHaveBeenCalled()
|
|
expect(readSpy).not.toHaveBeenCalled()
|
|
})
|
|
|
|
it('streams when the backend reports no size (never buffers a size-less file)', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.files.set('key:a.txt', 'alpha')
|
|
const streamSpy = vi.spyOn(fs, 'streamText')
|
|
fs.stat = async () => ({ version: FsVersion('v1'), type: 'file' }) // no size
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(result.isError).toBe(false)
|
|
expect(streamSpy).toHaveBeenCalled()
|
|
})
|
|
|
|
it('surfaces a byte-capped read as a truncated footer', async () => {
|
|
const { ctx, fs } = await setup()
|
|
// Many long lines so the window hits the byte cap before EOF.
|
|
fs.files.set('key:big.txt', Array.from({ length: 2000 }, () => 'y'.repeat(100)).join('\n'))
|
|
const result = await call(ctx, 'read', { file_path: 'big.txt' })
|
|
expect(result.isError).toBe(false)
|
|
expect(text(result)).toContain('Output capped.')
|
|
})
|
|
|
|
})
|
|
|
|
describe('formatReadOutput footer variants', () => {
|
|
const base: FileReadOutcome = { offset: 1, lines: [{ number: 1, text: 'x' }], totalLines: 1 }
|
|
|
|
it('reports a byte-capped read', () => {
|
|
const out = formatReadOutput('/f', { ...base, totalLines: 99, truncatedByBytes: true })
|
|
expect(out).toContain('(Output capped. Showing lines 1-1. Use offset=2 to continue.)')
|
|
})
|
|
|
|
it('reports a more-remaining page', () => {
|
|
const out = formatReadOutput('/f', { ...base, totalLines: 99 })
|
|
expect(out).toContain('(Showing lines 1-1 of 99. Use offset=2 to continue.)')
|
|
})
|
|
|
|
it('reports end-of-file', () => {
|
|
expect(formatReadOutput('/f', base)).toContain('(End of file - total 1 lines)')
|
|
})
|
|
|
|
it('renders an empty file as just the footer', () => {
|
|
const out = formatReadOutput('/f', { ...base, lines: [], totalLines: 0 })
|
|
expect(out).toContain('(End of file - total 0 lines)')
|
|
expect(out).not.toContain(': ')
|
|
})
|
|
})
|
|
|
|
describe('write tool', () => {
|
|
it('formats a create result and uses createIfAbsent (unobserved, with the gate)', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const result = await call(ctx, 'write', { file_path: 'a.txt', content: 'hi' }, { session: { header: {} } })
|
|
expect(result.isError).toBe(false)
|
|
expect(text(result)).toContain('Created file')
|
|
expect(fs.writeIntents).toEqual([{ kind: 'createIfAbsent' }])
|
|
})
|
|
|
|
it('rejects a blank file_path', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'write', { file_path: ' ', content: 'hi' })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('file_path must be a non-empty string')
|
|
})
|
|
|
|
it('propagates a backend FsError as an isError result carrying its code', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.rejectWith = new FsError('blocked', 'FS_STALE_VERSION')
|
|
const result = await call(ctx, 'write', { file_path: 'a.txt', content: 'hi' })
|
|
expect(result.isError).toBe(true)
|
|
expect(result.error).toMatchObject({ name: 'FsError', code: 'FS_STALE_VERSION' })
|
|
})
|
|
})
|
|
|
|
describe('edit tool', () => {
|
|
it('formats a single-replacement success after a read', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', 'a')
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'a', new_string: 'b' }, { session })
|
|
expect(text(result)).toBe('The file /abs/a.txt has been updated successfully.')
|
|
})
|
|
|
|
it('formats the replace_all success message distinctly', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', 'a a a')
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'a', new_string: 'b', replace_all: true }, { session })
|
|
expect(text(result)).toBe('The file /abs/a.txt has been updated. All occurrences were successfully replaced.')
|
|
})
|
|
|
|
it('rejects identical old/new strings', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'x', new_string: 'x' })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('must differ')
|
|
})
|
|
|
|
it('rejects an empty old_string', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: '', new_string: 'x' })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('old_string must be a non-empty string')
|
|
})
|
|
|
|
it('rejects a blank file_path', async () => {
|
|
const { ctx } = await setup()
|
|
const result = await call(ctx, 'edit', { file_path: ' ', old_string: 'a', new_string: 'b' })
|
|
expect(result.isError).toBe(true)
|
|
expect(text(result)).toContain('file_path must be a non-empty string')
|
|
})
|
|
|
|
it('propagates FS_NOT_OBSERVED when the file was never read (the gate decides)', async () => {
|
|
const { ctx, fs } = await setup()
|
|
fs.files.set('key:a.txt', 'hello')
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'a', new_string: 'b' }, { session: { header: {} } })
|
|
expect(result.isError).toBe(true)
|
|
expect(result.error).toMatchObject({ code: 'FS_NOT_OBSERVED' })
|
|
})
|
|
})
|
|
|
|
describe('tool-owned presentation (pure presentCall)', () => {
|
|
// presentCall is a pure display function of args (no I/O); it drives the ACP
|
|
// card's title/kind and the `locations` an editor follows along to.
|
|
const presentCall = async (name: string, args: unknown) => {
|
|
const { ctx } = await setup()
|
|
return ctx.tools.get(name)?.presentCall?.(args)
|
|
}
|
|
|
|
it('read: generic card titled by file with the read window, read kind, location with the offset line', async () => {
|
|
expect(await presentCall('read', { file_path: 'src/a.ts', offset: 12, limit: 40 })).toEqual({
|
|
card: 'generic', title: 'Read src/a.ts (12 - 51)', kind: 'read',
|
|
locations: [{ path: 'src/a.ts', line: 12 }],
|
|
})
|
|
})
|
|
|
|
it('read: bare title and line-1 location when offset/limit are unset', async () => {
|
|
expect(await presentCall('read', { file_path: 'a.txt' })).toEqual({
|
|
card: 'generic', title: 'Read a.txt', kind: 'read', locations: [{ path: 'a.txt', line: 1 }],
|
|
})
|
|
})
|
|
|
|
it('read: "from line N" window when only offset is set', async () => {
|
|
expect(await presentCall('read', { file_path: 'a.txt', offset: 5 })).toEqual({
|
|
card: 'generic', title: 'Read a.txt (from line 5)', kind: 'read', locations: [{ path: 'a.txt', line: 5 }],
|
|
})
|
|
})
|
|
|
|
it('write: diff card (new-file style, oldText null), location', async () => {
|
|
expect(await presentCall('write', { file_path: 'out.txt', content: 'hello' })).toEqual({
|
|
card: 'diff', title: 'Write out.txt',
|
|
diffs: [{ path: 'out.txt', oldText: null, newText: 'hello' }],
|
|
locations: [{ path: 'out.txt' }],
|
|
})
|
|
})
|
|
|
|
it('read: a limit with no offset windows from line 1', async () => {
|
|
expect(await presentCall('read', { file_path: 'a.txt', limit: 10 })).toEqual({
|
|
card: 'generic', title: 'Read a.txt (1 - 10)', kind: 'read', locations: [{ path: 'a.txt', line: 1 }],
|
|
})
|
|
})
|
|
|
|
it('edit: an empty old_string maps to oldText null (a whole-file replace diff)', async () => {
|
|
// presentCall runs on replay of raw logged args, which parseEditArgs does not
|
|
// gate — an empty old_string must still produce a valid diff (oldText null).
|
|
expect(await presentCall('edit', { file_path: 'a.txt', old_string: '', new_string: 'seed' })).toEqual({
|
|
card: 'diff', title: 'Edit a.txt',
|
|
diffs: [{ path: 'a.txt', oldText: null, newText: 'seed' }],
|
|
locations: [{ path: 'a.txt' }],
|
|
})
|
|
})
|
|
})
|
|
|
|
describe('result-time contextual diff (meta + presentResult)', () => {
|
|
// An edit records the applied contextual hunk on `tool/result` meta, and the tool's
|
|
// presentResult narrows it back into a `diff` result card the bridge renders.
|
|
const withContext = 'a\nb\nc\nOLD\nd\ne\nf\n'
|
|
|
|
it('edit: execute attaches the applied hunk as meta { diffs }', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', withContext)
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'OLD', new_string: 'NEW' }, { session })
|
|
expect(result.isError).toBe(false)
|
|
expect(result.meta).toEqual({
|
|
diffs: [{ path: 'a.txt', oldText: 'a\nb\nc\nOLD\nd\ne\nf', newText: 'a\nb\nc\nNEW\nd\ne\nf' }],
|
|
})
|
|
})
|
|
|
|
it('edit: presentResult turns the meta into a diff result card', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', withContext)
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'edit', { file_path: 'a.txt', old_string: 'OLD', new_string: 'NEW' }, { session })
|
|
const view = ctx.tools.get('edit')?.presentResult?.({ file_path: 'a.txt', old_string: 'OLD', new_string: 'NEW' }, result)
|
|
expect(view).toEqual({
|
|
card: 'diff', title: 'Edit a.txt',
|
|
diffs: [{ path: 'a.txt', oldText: 'a\nb\nc\nOLD\nd\ne\nf', newText: 'a\nb\nc\nNEW\nd\ne\nf' }],
|
|
})
|
|
})
|
|
|
|
it('write OVERWRITE: execute attaches a contextual hunk; presentResult renders a diff card', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', withContext)
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'write', { file_path: 'a.txt', content: 'a\nb\nc\nNEW\nd\ne\nf\n' }, { session })
|
|
expect(result.isError).toBe(false)
|
|
expect(result.meta).toEqual({ diffs: [{ path: 'a.txt', oldText: 'a\nb\nc\nOLD\nd\ne\nf', newText: 'a\nb\nc\nNEW\nd\ne\nf' }] })
|
|
const view = ctx.tools.get('write')?.presentResult?.({ file_path: 'a.txt', content: 'x' }, result)
|
|
expect(view).toEqual({ card: 'diff', title: 'Write a.txt', diffs: [{ path: 'a.txt', oldText: 'a\nb\nc\nOLD\nd\ne\nf', newText: 'a\nb\nc\nNEW\nd\ne\nf' }] })
|
|
})
|
|
|
|
it('write CREATE: no before-version → no meta, but presentResult still renders a whole-file diff card', async () => {
|
|
// A create has no prior content (no `meta`), yet the completed card must be a `diff` — an
|
|
// ACP tool_call_update.content REPLACES the call's content, so a non-diff result would
|
|
// clobber the pending new-file diff.
|
|
const { ctx } = await setup()
|
|
const session = { header: {} }
|
|
const result = await call(ctx, 'write', { file_path: 'new.txt', content: 'fresh\n' }, { session })
|
|
expect(result.isError).toBe(false)
|
|
expect(result.meta).toBeUndefined()
|
|
const view = ctx.tools.get('write')?.presentResult?.({ file_path: 'new.txt', content: 'fresh\n' }, result)
|
|
expect(view).toEqual({ card: 'diff', title: 'Write new.txt', diffs: [{ path: 'new.txt', oldText: null, newText: 'fresh\n' }] })
|
|
})
|
|
|
|
it('write OVERWRITE with identical content: a before exists but yields no hunk → no meta, presentResult falls back to a whole-file diff', async () => {
|
|
const { ctx, fs } = await setup()
|
|
const session = { header: {} }
|
|
fs.files.set('key:a.txt', 'same\n')
|
|
await call(ctx, 'read', { file_path: 'a.txt' }, { session })
|
|
const result = await call(ctx, 'write', { file_path: 'a.txt', content: 'same\n' }, { session })
|
|
expect(result.isError).toBe(false)
|
|
expect(result.meta).toBeUndefined()
|
|
const view = ctx.tools.get('write')?.presentResult?.({ file_path: 'a.txt', content: 'same\n' }, result)
|
|
expect(view).toEqual({ card: 'diff', title: 'Write a.txt', diffs: [{ path: 'a.txt', oldText: null, newText: 'same\n' }] })
|
|
})
|
|
|
|
it('presentResult returns undefined on an error result (nothing applied)', async () => {
|
|
const { ctx } = await setup()
|
|
const errorResult = { content: [{ type: 'text' as const, text: 'Error: boom' }], isError: true }
|
|
expect(ctx.tools.get('edit')?.presentResult?.({ file_path: 'a.txt', old_string: 'x', new_string: 'y' }, errorResult)).toBeUndefined()
|
|
expect(ctx.tools.get('write')?.presentResult?.({ file_path: 'a.txt', content: 'y' }, errorResult)).toBeUndefined()
|
|
})
|
|
|
|
it('edit presentResult returns undefined on malformed meta (defensive narrowing)', async () => {
|
|
// edit has no whole-file fallback (only a literal replacement), so a malformed
|
|
// meta yields the generic "updated successfully" rendering.
|
|
const { ctx } = await setup()
|
|
const badMeta = { content: [{ type: 'text' as const, text: 'ok' }], isError: false, meta: { diffs: 'nope' } }
|
|
expect(ctx.tools.get('edit')?.presentResult?.({ file_path: 'a.txt', old_string: 'x', new_string: 'y' }, badMeta)).toBeUndefined()
|
|
})
|
|
|
|
it('write presentResult falls back to a whole-file diff on malformed meta (never leaks the result text)', async () => {
|
|
// write always renders a diff card so the completed update can't clobber the
|
|
// pending diff with the model-facing text; a malformed meta falls back to the
|
|
// args-derived whole-file diff, same as a create.
|
|
const { ctx } = await setup()
|
|
const badMeta = { content: [{ type: 'text' as const, text: 'ok' }], isError: false, meta: { diffs: 'nope' } }
|
|
const view = ctx.tools.get('write')?.presentResult?.({ file_path: 'a.txt', content: 'y' }, badMeta)
|
|
expect(view).toEqual({ card: 'diff', title: 'Write a.txt', diffs: [{ path: 'a.txt', oldText: null, newText: 'y' }] })
|
|
})
|
|
})
|
|
|
|
describe('read caps are plugin config', () => {
|
|
async function setupWith(config: ToolFs.Config) {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(FakeFs)
|
|
await ctx.plugin(FsPolicy)
|
|
await ctx.plugin(ToolFs, config)
|
|
return { ctx, fs: ctx.fs as FakeFs }
|
|
}
|
|
|
|
it('a configured readLimit is both the default and the cap, and the schema names it', async () => {
|
|
const { ctx, fs } = await setupWith({ readLimit: 2 })
|
|
fs.files.set('key:a.txt', 'one\ntwo\nthree\nfour')
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(text(result)).toContain('(Showing lines 1-2 of 4. Use offset=3 to continue.)')
|
|
const overCap = await call(ctx, 'read', { file_path: 'a.txt', limit: 3 })
|
|
expect(overCap.isError).toBe(true)
|
|
expect(text(overCap)).toContain('less than or equal to 2')
|
|
const readSchema = ctx.tools.schemas().find(s => s.name === 'read')
|
|
expect(JSON.stringify(readSchema)).toContain('Defaults to 2.')
|
|
})
|
|
|
|
it('a configured readMaxLineLength truncates lines at the configured length', async () => {
|
|
const { ctx, fs } = await setupWith({ readMaxLineLength: 4 })
|
|
fs.files.set('key:a.txt', 'abcdefgh')
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(text(result)).toContain('1: abcd... (line truncated to 4 chars)')
|
|
})
|
|
|
|
it('a configured readMaxBytes caps the window at the configured bytes', async () => {
|
|
const { ctx, fs } = await setupWith({ readMaxBytes: 9 })
|
|
fs.files.set('key:a.txt', 'aaaa\nbbbb\ncccc')
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(text(result)).toContain('Output capped.')
|
|
expect(text(result)).not.toContain('cccc')
|
|
})
|
|
|
|
it('a configured readStreamMinSize routes smaller files to the streaming path', async () => {
|
|
const { ctx, fs } = await setupWith({ readStreamMinSize: 5 })
|
|
fs.files.set('key:a.txt', 'alpha\nbeta')
|
|
const readSpy = vi.spyOn(fs, 'readText')
|
|
const streamSpy = vi.spyOn(fs, 'streamText')
|
|
const result = await call(ctx, 'read', { file_path: 'a.txt' })
|
|
expect(result.isError).toBe(false)
|
|
expect(streamSpy).toHaveBeenCalled()
|
|
expect(readSpy).not.toHaveBeenCalled()
|
|
})
|
|
|
|
it.each([
|
|
['readLimit', { readLimit: 0 }],
|
|
['readLimit', { readLimit: 2.5 }],
|
|
['readMaxLineLength', { readMaxLineLength: -1 }],
|
|
['readMaxBytes', { readMaxBytes: Number.NaN }],
|
|
['readStreamMinSize', { readStreamMinSize: 0 }],
|
|
] as const)('rejects a non-positive or fractional %s at load', async (name, config) => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(FakeFs)
|
|
await expect(ctx.plugin(ToolFs, config)).rejects.toThrow(new RegExp(`tool-fs: ${name} must be a positive integer`))
|
|
})
|
|
|
|
it('has no default export (namespace plugin export shape)', () => {
|
|
expect('default' in ToolFs).toBe(false)
|
|
})
|
|
})
|