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

Files

Tianyi Cui df4b7d3d9a feat(session-persistence): abstract seam + JSONL backend + wiring

Add the durable session-persistence capability seam (ADR 0016): an
abstract SessionPersistence service (dsh-session-persistence,
ctx.sessionPersistence) defining create/append/load/list/has/delete/
update over the existing SessionEvent — no parallel persisted type — and
a first implementation (dsh-session-persistence-jsonl): an append-only
JSONL log per session with crash-safe atomic writes, truncation-repair
of a never-committed crash tail, and a read/replay path. SessionMeta
(format version, cwd, lineage) travels out-of-log via session.header.

A shared runPersistenceContract suite holds every backend to the same
append-only / contiguous-seq / lazy-materialization / serializability
semantics.

Config-driven create() now uses a per-run ${id}-session-<uuid> session
id so a fixed name no longer collides with an on-disk log once a durable
backend is loaded; each run is a new session (a demo simplification). The
examples drop their hand-rolled session-jsonl.ts and load the JSONL
backend via cordis.yml; CI smoke-loads it too.

The agent-facing create/resume factory that consumes load() is a
separate seam, deferred to a follow-up; this change stops at the load
primitive and does not reach into the loop.

2026-06-15 21:05:46 +08:00

1.9 KiB

Raw Blame History

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
@deepseek-ai/dsh-session-persistence-jsonl — the durable JSONL persistence backend (loaded from cordis.yml, root: ./.sessions): append-only event log per session with crash-safe atomic writes, replacing the old write-only example plugin
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[]`
`stdio-chat.ts`	UI	`agent/stream-chunk`, `session/event` (tool/*), stdin→send/steer
`start.ts`	Bootstrap	`Context` + `Loader` + `plugin-include` wired to `cordis.yml`

Persistence is the shared @deepseek-ai/dsh-session-persistence-jsonl plugin (not a per-example file).

Run

yarn demo:echo
# 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 under examples/echo-agent/.sessions/ (per-cwd subdirectory, one .jsonl log per session). Clean up with: rm -rf examples/echo-agent/.sessions

1.9 KiB Raw Blame History

echo-agent

What it shows

Plugin files

Run

1.9 KiB

Raw Blame History