Files
deepseek-harness/packages/context/README.md
T
creatixchu 6bb79911ba refactor(reference): serve discovery through typert Remote faces
Replace the legacy reference.* API Proxy domain with @Remote methods on the
owning services, following the typert gateway design master adopted on
2026-08-02 (message-feedback and plugin-inventory precedents):

- FileReferenceService and SessionReferenceResolver extend TypertRemoteService;
  fileReferences/list and sessionReferenceResolver/candidates are unary Remote
  methods cancelled through the reserved trailing signal, and the candidates
  face attaches each candidate's canonical mention under the configured limit
- move the wire types to type-only ./types subpaths (FileReferenceCandidate,
  SessionReferenceMentionCandidate) and export ./typert plus ./remote artifacts
- mount both contributions in the api-remotes client assembly; ui-reference
  consumes ctx.remote instead of connection.api.references and registers zh/en
  locale dictionaries for its sections and labels
- delete the reference.* routes, schemas, map rows, client stubs, and fixtures;
  the connection fixture serves the Remote endpoints instead
- release deliverPrompt admission listeners when the agent is disposed with the
  prepared prompt still pending, and cover the reference-* RpcError codes in
  the schema spec
- add the missing tsconfig paths for the /grammar and /types subpaths (clean-
  tree vitest could not resolve @deepseek-ai/dsh-file-reference/grammar)
- regenerate the cordis catalog, capability seams, and event matrix; update the
  owning bilingual READMEs, Agent Notes, and the reference-composer golden
2026-08-17 18:35:30 +08:00

1.3 KiB

context/ — request-context extensions

English | 中文

Product plugins that add model-visible request context without defining a tool. agent-instructions is included by the default dsh-agent-spine-demo bundle and can be disabled through bundle config; time-context, tmux-context, session-reference, file-reference, and file-reference-local are opt-in.

Package Role ctx key
session-reference/ Bounded snapshots of other sessions ctx.sessionReferenceResolver
file-reference/ File-reference discovery seam and @file grammar ctx.fileReferences
file-reference-local/ Local-filesystem file-reference provider
time-context/ Current-time and elapsed-time context
tmux-context/ tmux location context
agent-instructions/ Workspace-instruction context

Session references are documented in docs/subsystems/session-reference.md; the agent-instructions decision record owns its per-agent/session isolation and lifecycle split.