dsh-narra-channel

English | 简体中文

dsh-narra-channel is an independent, third-party DeepSeek Harness Profile Bundle that connects a Harness Agent Preset to Narra Messenger. It does not modify DeepSeek Harness or the Narra frontend/backend.

[!IMPORTANT] DeepSeek Harness is in developer preview. This plugin version targets Harness 0.1.0-rc.8 and may need an update for other release trains.

Capabilities

• Select an Agent Preset in Harness Settings → Narra and paste the complete binding instruction supplied by Narra.
• Extract only the setup-guide URL; the plugin never executes scripts or commands from the guide.
• Submit a contact-facing name and bio derived from the selected preset, with an optional identity editor before binding.
• Store binding URLs and Gateway bearer tokens in Harness Credentials instead of ordinary settings or logs.
• Run one independent Channel Worker per binding. Messages are serialized within a binding while different bindings can work concurrently.
• Map each Narra room to a deterministic, recoverable Harness Session and avoid rerunning completed duplicate invocations.
• Stream text replies through the Narra Gateway.
• Recognize voice_instructions and use short, fast, speech-friendly replies for that turn.

Voice mode transports transcribed text and streamed response text. This plugin does not transmit raw audio.

Requirements

• Node.js ^22.19.0 || >=24.0.0
• pnpm 11.7.0
• DeepSeek Harness 0.1.0-rc.8
• A configured model provider in Harness
• A fresh Narra agent binding instruction

Build and install from source

The npm package has not been published yet. Build a tarball from a trusted checkout:

git clone https://github.com/NetMind-AI/dsh-narra-channel.git
cd dsh-narra-channel
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm pack
dsh plugin --profile web add ./narra-dsh-narra-channel-0.1.5.tgz

Restart the web profile, then open Harness Settings → Narra:

1. Select an Agent Preset.
2. Paste the full binding instruction or its setup-guide URL.
3. Review the proposed Narra identity and edit it if needed.
4. Select Bind and start listening and wait for the status to become connected.

Repeat the process to create additional Narra agents. Removing a binding stops its worker and deletes its Harness credential; version 0.1.5 does not remotely delete the agent from Narra.

Docker-isolated deployment

The docker/ directory contains an isolated deployment that does not mount the host home directory, host Harness state, the Docker socket, or the source workspace. See the Docker guide for the security boundary and startup commands.

Security and data handling

• The setup guide parser accepts only the binding status, guide revision, Gateway URL, and Gateway token fields required by the protocol.
• The plugin calls the fixed profile-report, guide-acknowledgement, and Gateway endpoints derived from the supplied setup-guide URL.
• Gateway credentials are never intentionally exposed to the model.
• Narra message text, sender/room metadata, recent context, and streamed agent replies cross the Narra Gateway as part of normal operation.
• Harness Credentials are not a strong secret vault against another trusted process running as the same operating-system user. Use Docker or a dedicated OS account when stronger isolation is required.
• Third-party Harness plugins run in the Harness process. Review source and install only versions you trust.

Please report vulnerabilities according to SECURITY.md.

Current limitations

• A binding processes only one message at a time. Multiple rooms for the same agent may queue behind a long task.
• Attachments are preserved only as source metadata; version 0.1.5 does not download or return files.
• The plugin uses recent context supplied by the Gateway and does not expose the Gateway token to model tools for separate history retrieval.
• Runtime update-guide instructions are not executed automatically. Upgrade the package and restart the profile explicitly.
• Harness is a developer preview. Compatibility is currently pinned to 0.1.0-rc.8 rather than promised across preview releases.

Development

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm pack:check

License

MIT © NetMind AI.