Tianyi Cui
a2d0f7f411
Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.
85 lines
2.9 KiB
TypeScript
85 lines
2.9 KiB
TypeScript
import { describe, expect, it } from 'vitest'
|
|
import { Context } from '@deepseek-ai/cordis'
|
|
import { ShellExecutor } from '@deepseek-ai/dsh-shell'
|
|
import type { ShellExecRequest, ShellExecSpec, ShellProcess, ShellProcessRead, ShellRunResult } from '@deepseek-ai/dsh-shell'
|
|
|
|
/**
|
|
* Minimal concrete executor: canned foreground results, a hand-built process
|
|
* handle. The seam is TASK-FREE (start returns a {@link ShellProcess} handle;
|
|
* task semantics live in `ctx.jobs`), so this stub is all an implementation
|
|
* owes the abstract class.
|
|
*/
|
|
class StubExecutor extends ShellExecutor {
|
|
resolve(request: ShellExecRequest): ShellExecSpec {
|
|
return {
|
|
command: request.command,
|
|
workdir: request.workdir ?? '/stub',
|
|
timeoutMs: request.timeoutMs ?? 1000,
|
|
stdoutMaxBytes: request.stdoutMaxBytes ?? 64_000,
|
|
...request.signal ? { signal: request.signal } : {},
|
|
sandboxPolicy: request.sandboxPolicy,
|
|
}
|
|
}
|
|
|
|
async run(spec: ShellExecSpec): Promise<ShellRunResult> {
|
|
return {
|
|
exitCode: 0,
|
|
signal: null,
|
|
timedOut: false,
|
|
aborted: false,
|
|
timeoutMs: spec.timeoutMs,
|
|
stdout: { text: 'ok', truncated: false },
|
|
stderr: { text: '', truncated: false },
|
|
}
|
|
}
|
|
|
|
start(): ShellProcess {
|
|
const proc: ShellProcess = {
|
|
status: 'running',
|
|
exitCode: null,
|
|
signal: null,
|
|
done: Promise.resolve(),
|
|
readOutput: (): ShellProcessRead => ({ delta: '', lossy: false }),
|
|
kill: (): boolean => {
|
|
if (proc.status !== 'running') return false
|
|
proc.status = 'killed'
|
|
return true
|
|
},
|
|
}
|
|
return proc
|
|
}
|
|
}
|
|
|
|
describe('ShellExecutor service seam', () => {
|
|
it('a concrete subclass registers as ctx.shell and serves the abstract API', async () => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(StubExecutor)
|
|
const spec = ctx.shell.resolve({ command: 'echo hi' })
|
|
expect(spec).toEqual({ command: 'echo hi', workdir: '/stub', timeoutMs: 1000, stdoutMaxBytes: 64_000, sandboxPolicy: undefined })
|
|
|
|
const result = await ctx.shell.run(spec)
|
|
expect(result.exitCode).toBe(0)
|
|
expect(result.stdout.text).toBe('ok')
|
|
|
|
const proc = ctx.shell.start(spec)
|
|
expect(proc.status).toBe('running')
|
|
expect(proc.readOutput()).toEqual({ delta: '', lossy: false })
|
|
expect(proc.kill()).toBe(true)
|
|
expect(proc.kill()).toBe(false) // already settled → no-op
|
|
await proc.done
|
|
})
|
|
|
|
it('reports no default sandbox mode from the task-free base seam', async () => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(StubExecutor)
|
|
expect(ctx.shell.sandboxMode).toBeUndefined()
|
|
})
|
|
|
|
it('loading a second implementation throws (one bash service per context — cordis standard)', async () => {
|
|
const ctx = new Context()
|
|
await ctx.plugin(StubExecutor)
|
|
class SecondExecutor extends StubExecutor {}
|
|
await expect(ctx.plugin(SecondExecutor)).rejects.toThrow(/service "shell" has been registered/)
|
|
})
|
|
})
|