mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Tianyi Cui d2fb352f3e Enable maximum-strict TypeScript across our packages

tsconfig.base.json adds noUncheckedIndexedAccess,
exactOptionalPropertyTypes, noImplicitOverride,
noFallthroughCasesInSwitch, noUnusedLocals, and noUnusedParameters on
top of strict. Vendored packages opt out of the new flags locally
(their tsconfigs are ours to regenerate; their source is not), keeping
upstream-sync friendliness.

Our code fixed accordingly: index accesses acknowledge undefined
(assembler flush cursors, lastTurnNumber); optional properties are
omitted instead of set-to-undefined (GenerateResult.usage,
ToolDefinition.strict, GenerateOptions.system/tools, error payloads
via an errorData helper); Session.onAppend is explicitly
`(…) => void | undefined`; tests and examples updated for unused
parameters and indexed access.

2026-06-11 14:02:47 +08:00

src

Enable maximum-strict TypeScript across our packages

2026-06-11 14:02:47 +08:00

cordis.yml

Add runnable echo-agent example

2026-06-11 10:55:05 +08:00

package.json

Add runnable echo-agent example

2026-06-11 10:55:05 +08:00

README.md

Sync docs with the defineTool DSL and actual demo code

2026-06-11 13:48:22 +08:00

start.ts

Add runnable echo-agent example

2026-06-11 10:55:05 +08:00

README.md

echo-agent

Runnable demo: stdin chat with a scripted mock model and an echo tool.

What it shows

A complete Cordis app loaded from cordis.yml — the standard "stack of plugins" pattern
mock-llm.ts — a mock LlmAdapter that streams scripted responses and calls the echo tool when the user types "echo "
echo-tool.ts — a tool registered via ctx.tools.register() that echoes text back uppercased
session-jsonl.ts — a minimal persistence plugin: write-behind buffering of session/event notifications, drained to a JSONL file at session/flush
stdio-chat.ts — a minimal UI plugin: reads stdin lines and send/steers the agent, renders stream deltas, tool calls, and tool results

Plugin files

File	Role	Key patterns demonstrated
`mock-llm.ts`	`LlmAdapter` registration	`ctx.llm.registerAdapter(['mock-echo'], …)`, streaming chunks with proper `block-start`/`block-end` protocol
`echo-tool.ts`	Tool registration	`ctx.tools.register(defineTool(…))` with typed `execute` args, tool execution returning `ContentBlock[]`
`session-jsonl.ts`	Persistence	`session/event` listener + `session/flush` drain, fiber-dispose cleanup
`stdio-chat.ts`	UI	`agent/stream-chunk`, `session/event` (tool/*), stdin→send/steer
`start.ts`	Bootstrap	`Context` + `Loader` + `plugin-include` wired to `cordis.yml`

Run

yarn demo
# or:
node --expose-internals --import tsx examples/echo-agent/start.ts

Type a message and press Enter. "echo " triggers a tool call round-trip (the mock model requests the echo tool, which echoes the text uppercased, and the next model step acknowledges it).

The session is persisted to <session-id>.jsonl in the examples/echo-agent/ directory. Clean up with: rm -f examples/echo-agent/*.jsonl