2026-07-16 16:01:06 +08:00
# context/ — request-context extensions
2026-07-14 16:04:34 +08:00
2026-07-26 05:03:53 +08:00
English | [中文 ](README.zh.md )
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:04 +08:00
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.
2026-07-14 16:04:34 +08:00
| Package | Role | ctx key |
|---|---|---|
2026-08-13 00:36:22 +08:00
| [`session-reference/` ](session-reference/README.md ) | Bounded snapshots of other sessions | `ctx.sessionReferenceResolver` |
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:04 +08:00
| [`file-reference/` ](file-reference/README.md ) | File-reference discovery seam and `@file` grammar | `ctx.fileReferences` |
| [`file-reference-local/` ](file-reference-local/README.md ) | Local-filesystem file-reference provider | — |
2026-08-04 00:54:19 +08:00
| [`time-context/` ](time-context/README.md ) | Current-time and elapsed-time context | — |
| [`tmux-context/` ](tmux-context/README.md ) | tmux location context | — |
2026-08-13 00:36:22 +08:00
| [`agent-instructions/` ](agent-instructions/README.md ) | Workspace-instruction context | — |
2026-07-16 16:01:06 +08:00
2026-08-13 00:36:22 +08:00
Session references are documented in [docs/subsystems/session-reference.md ](../../docs/subsystems/session-reference.md ); the [`agent-instructions` decision record ](../../.agents/notes/implemented/feature/2026-06-24-workspace-context.md ) owns its per-agent/session isolation and lifecycle split.
