mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
ee1da1ce5b
New top-level packages/cordis/ group with the self-referential toolset: cordis_inspect (services / plugin tree / tools / dynamic mounts / api / events, the api section intersecting the generated catalog with the live service store), cordis_mount (model-written code evaluated in a node:vm sandbox, mounted under one cordis-dynamic group fiber as dyn-<n>), cordis_unmount (awaited disposal to quiescence). Boundary mechanisms: dual-realm instanceof, JSON realm normalization of dynamic tool results, marker-guarded registration, SchemaSpec teaching errors, parse failures surfaced with the offending line + caret and a line-scoped TypeScript hint, and the unmount-first recipe on tool-name collisions. Config: vmTimeoutMs (schemastery, default 5000). Design record: docs/rfc/implemented/feature/2026-07-08-self-referential-cordis-toolset.md. The tool-catalog boot manifest, its regenerated output, and the pinned tool-name list land here rather than with the other repo registration: the completeness guard globs packages/*/tool-* and fails the generator (and the core/tools spec) the moment the package directory exists.
105 lines
3.3 KiB
TypeScript
105 lines
3.3 KiB
TypeScript
import { Context } from 'cordis'
|
|
import Timer from '@cordisjs/plugin-timer'
|
|
import { CallId } from '@deepseek-ai/dsh-llm'
|
|
import SystemPrompt from '@deepseek-ai/dsh-system-prompt'
|
|
import ToolRegistry from '@deepseek-ai/dsh-tools'
|
|
import type { ToolDefinition, ToolExecutionResult } from '@deepseek-ai/dsh-tools'
|
|
import * as tool from '../src/index.ts'
|
|
|
|
/**
|
|
* Shared spec helpers: a real `SystemPrompt` + `ToolRegistry` + timer +
|
|
* tool-cordis tree (only the model is absent — the code strings below stand in
|
|
* for what it would write), plus the canonical mount-code fixtures the suites
|
|
* share.
|
|
*/
|
|
|
|
/** Mount the plugin on a fresh context with a real ToolRegistry and the timer service. */
|
|
export async function setup(config?: tool.Config): Promise<Context> {
|
|
const ctx = new Context()
|
|
await ctx.plugin(Timer)
|
|
await ctx.plugin(SystemPrompt)
|
|
await ctx.plugin(ToolRegistry)
|
|
await ctx.plugin(tool, config)
|
|
return ctx
|
|
}
|
|
|
|
let callCounter = 0
|
|
|
|
/** Execute a registered tool through the real registry pipeline. */
|
|
export function call(ctx: Context, name: string, args: unknown): Promise<ToolExecutionResult> {
|
|
return ctx.tools.execute({ callId: CallId(`call-${++callCounter}`), name, arguments: args })
|
|
}
|
|
|
|
/** Concatenated text blocks of one tool result. */
|
|
export function text(result: ToolExecutionResult): string {
|
|
return result.content.filter(block => block.type === 'text').map(block => block.text).join('')
|
|
}
|
|
|
|
/** Mount code for a listener plugin: logs on every `tools/change`. */
|
|
export const LISTENER_CODE = `
|
|
return {
|
|
name: 'change-logger',
|
|
apply(ctx) {
|
|
ctx.on('tools/change', () => console.log('tools changed'))
|
|
},
|
|
}
|
|
`
|
|
|
|
/** Mount code for a self-made tool: registers `reverse_text` via the sandbox's harness helpers. */
|
|
export const REVERSE_TOOL_CODE = `
|
|
return {
|
|
name: 'reverse-text',
|
|
inject: ['tools'],
|
|
apply(ctx) {
|
|
harness.registerTool(ctx, harness.defineTool({
|
|
name: 'reverse_text',
|
|
description: 'Reverse a string.',
|
|
parameters: { text: { type: 'string', required: true } },
|
|
async execute(args) {
|
|
return [{ type: 'text', text: args.text.split('').reverse().join('') }]
|
|
},
|
|
}))
|
|
},
|
|
}
|
|
`
|
|
|
|
/** Mount code providing a `greeter` service other mounts can inject. */
|
|
export const PROVIDER_CODE = `
|
|
return {
|
|
name: 'greeter-provider',
|
|
apply(ctx) {
|
|
ctx.provide('greeter', { greet: (name) => 'hi ' + name })
|
|
},
|
|
}
|
|
`
|
|
|
|
/** Mount code consuming the `greeter` service through inject, exposing it as a tool. */
|
|
export const CONSUMER_CODE = `
|
|
return {
|
|
name: 'greeter-consumer',
|
|
inject: ['greeter', 'tools'],
|
|
apply(ctx) {
|
|
harness.registerTool(ctx, harness.defineTool({
|
|
name: 'greet',
|
|
description: 'Greet someone via the greeter service.',
|
|
parameters: { name: { type: 'string', required: true } },
|
|
async execute(args) {
|
|
return [{ type: 'text', text: ctx.greeter.greet(args.name) }]
|
|
},
|
|
}))
|
|
},
|
|
}
|
|
`
|
|
|
|
/** A registrable no-op tool the tests use to trigger a real `tools/change`. */
|
|
export function dummyTool(name: string): ToolDefinition {
|
|
return {
|
|
name,
|
|
description: 'test trigger',
|
|
parameters: { type: 'object' as const, properties: {} },
|
|
async execute(): Promise<[]> {
|
|
return []
|
|
},
|
|
}
|
|
}
|