Introduction

The plugin mechanism of DSH allows extending agent tools, slash commands, and session-related capabilities built upon the host capabilities. The community directory is an independent site with no official affiliation to DeepSeek/Huafang and should not be mistaken for an official app store.

For those using DSH for agent development or session management, a specific problem arises: agents within the current session sometimes need to access context generated in another session, such as user/assistant messages, tool calls and results, reasoning processes, or raw event streams prior to compression.

Artificialwhale/session-reader-plugin provides such a plugin: it reads content from other sessions within a DSH session. It can be invoked as an agent tool or output results directly via the /sessions slash command. All reads are read-only and bounded.

Plugin Positioning

  • Repository: Artificialwhale/session-reader-plugin
  • Maintainer: Artificialwhale
  • License: MIT
  • Verified Version: DSH 0.1.0-rc.6
  • Core Value: Reading messages, tool calls/results, thinking and raw event streams from other sessions within a DSH session

Core Features

session_list

session_list is used to list unarchived sessions.

The return content includes:

  • id
  • Title
  • Workspace
  • Created At
  • Preset

Supported filtering and control parameters include:

  • Filter by id
  • Filter by workspace
  • limit
  • includeArchived

session_read

session_read is used to read content by session id.

Four modes are supported:

  • io: User/assistant messages and tool calls/results, default mode
  • thinking: Reasoning chunks
  • surface: Compressed messages visible to the current model
  • raw: Raw log events, including events before compression

Slash Commands

The plugin provides two slash commands:

/sessions list [query] [--limit N] [--archived]
/sessions read <id> [io|thinking|surface|raw] [--query text] [--limit N]

Slash commands do not require a model turn and output results directly.

Read-only and Bounded Output

All reads are read-only and bounded.

Output has truncation protection: both individual items and the total count are capped to avoid polluting the context.

Installation and Enablement

The verified GitHub installation command is:

dsh plugin --profile web add github:Artificialwhale/session-reader-plugin

This package declares dsh.bundle. After installation, it is automatically appended to the dsh.profile.bundles layer stack and activated.

Takes effect after restarting dsh.

Typical Usage

Discovering Session IDs

The following two examples are used to find sessions:

/sessions list
/sessions list Alice --limit 5

The first command lists sessions. The second command uses “Alice” as a query condition and limits the returned count to 5.

Reading a Session

In the examples below, session-xxxx-xxxx is a session ID placeholder:

/sessions read session-xxxx-xxxx io

Reading the default io mode, which is user/assistant messages and tool calls/results.

/sessions read session-xxxx-xxxx thinking --limit 20

Reading the thinking mode, limiting the returned count to 20.

/sessions read session-xxxx-xxxx raw --query "step/start"

Reading the raw mode, using step/start as the query text.

Dependencies and Compatibility

  • Pure JS
  • No build steps
  • No native dependencies
  • No runtime dependencies
  • Relies on the sessionQuery service provided by the host
  • Uses @deepseek-ai/dsh-tools and @deepseek-ai/dsh-llm included with the dsh release, no separate installation required
  • Verified on DSH 0.1.0-rc.6

Use Cases and Notes

Suitable for the following use cases:

  • Viewing context generated in another session within the current DSH session
  • Troubleshooting agent messages, tool calls/results, and reasoning processes across different sessions
  • Reading raw event streams before compression to understand earlier session states
  • Continuing a discussion or development based on the existing context of another session

Notes:

  • The plugin runs with the permissions of the current dsh process
  • You should check the source code and the MIT license before installing
  • Output has truncation protection, but this does not mean unrestricted reading of the entire session content
  • Do not interpret the community directory as an official app store; this document does not provide a confirmed directory page URL

Links

This document does not provide a confirmed directory page URL, so no directory page link is listed.

GitHub Repository:

https://github.com/Artificialwhale/session-reader-plugin.git