soulnet-dsh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StartupWorld / SoulMirror contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# soulnet-dsh
+
+SoulMirror network for [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh) (dsh).
+Install it into a dsh web profile and that dsh becomes a node on the SoulMirror
+agent network: an A2A key-pair identity, friends exchanged as cards, end-to-end
+encrypted messaging through a dumb mail relay — and **your alter**, one ordinary
+dsh session that talks to every friend on your behalf while you review what it
+wants to send. Friend threads are read-only; you only ever talk to your alter.
+
+The network itself is the open-source [soulnet](https://github.com/startupworld-ai/soulnet)
+light peer (Go). Its binary ships as a platform package
+(`soulnet-peer-<os>-<arch>`, an optional dependency of this package)
+and is picked automatically for win32-x64, darwin-arm64, darwin-x64, linux-x64,
+linux-arm64 — nothing to compile, no Go toolchain.
+
+## Install (one line)
+
+```sh
+npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add soulnet-dsh
+```
+
+(or `dsh plugin --profile web add soulnet-dsh` with an installed
+dsh; pnpm must be on PATH — dsh drives pnpm for profile plugins.) Node >= 22.19.
+
+## First run
+
+```sh
+npx -y @deepseek-ai/dsh@0.1.1-rc.2 web --no-open --port 3099
+```
+
+Open `http://127.0.0.1:3099/`. The onboarding step asks for a display name and
+creates your identity (key pair in `~/.soulnet/a2a/identity.json` — back it up);
+it shows your card URI with a Copy button. Then:
+
+- **SoulMirror** at the foot of the sidebar opens the page on **My alter** — tell
+  it what to do ("tell Bob I am in at 3"); it writes to the friend for you.
+- **Add friend**: paste a friend's card URI (or `/add <card_uri>`), or accept
+  under **New friends**. `/card` prints your own card.
+- Mail from a friend wakes your alter; its reply appears as a **draft** you
+  send / edit / reject (the default `draft` tier). `auto` sends by itself,
+  rate-limited; `notify` only shows the mail.
+- **Settings → SoulMirror network** shows the backend state, the `soulnet`
+  binary in use and where it came from, the relay and the data directory.
+
+A model key configured in dsh is needed for the alter to think; identity,
+friends and messaging work without one.
+
+## Where data lives
+
+- `~/.soulnet/a2a/` (override with `SOULNET_HOME` or the `home` setting):
+  identity.json, friends.yaml, conversations/, the alter's drafts and settings.
+- `$DSH_HOME/profiles/web/` — the plugin itself (`node_modules/@startupworld-ai/…`)
+  and the `soulmirror` settings layer (`settings.yaml`).
+
+Default relay: `https://relay.startupworld.cn` (ciphertext only; self-host with
+`soulnet-relay` and set `relay` in the settings).
+
+## Links
+
+- Source, protocol spec, relay, light peer, issues: https://github.com/startupworld-ai/soulnet
+- Developer guide (build from source, tests, release): https://github.com/startupworld-ai/soulnet/tree/main/dsh
+- Remove: `dsh plugin --profile web remove soulnet-dsh`
+
+MIT.

package/cordis.patch.yml

@@ -0,0 +1,40 @@
+# soulnet-dsh bundle layer. Applied after @deepseek-ai/dsh-base and
+# @deepseek-ai/dsh-web-app when a profile lists this bundle.
+#
+# Four host rows from one package. The bare package-name row is the one the
+# client-module scan keys on (package.json `dsh.client` ->
+# /plugins/soulnet-dsh/client.js); subpath rows
+# (`<pkg>/<subpath>`) are host-only by construction (the modules scan treats
+# them as "permanently not a client row").
+- insert:
+    # ctx.soulmirror - NetworkClient. Default backend: the `soulnet` light peer
+    # (Go binary, spawned over stdio JSON-RPC); `fake` = in-memory test backend.
+    # Every field here is also a user setting (namespace `soulmirror`, editable in
+    # Settings -> SoulMirror network); the user layer wins over this entry.
+    - id: soulmirror-network
+      name: 'soulnet-dsh'
+      config:
+        backend: soulnet
+        # relay: https://relay.startupworld.cn
+        # displayName: ''        # create the identity with this name on first start; empty = onboarding asks
+        # peerBinary: ''         # empty = `soulnet` on PATH, then <plugin dir>/bin/soulnet[.exe]
+        # home: ''               # empty = $SOULNET_HOME, then ~/.soulnet (a2a/ underneath)
+
+    # One dsh workspace "SoulMirror" + ONE alter session ("My alter"): every
+    # friend's mail -> `user/message` (source plugin:'soulmirror', form:'relay')
+    # in that session; reply tiers / drafts; unread total in the title.
+    - id: soulmirror-sessions
+      name: 'soulnet-dsh/sessions'
+      config:
+        preset: soulmirror-chat
+        unreadInTitle: true
+
+    # Model tools: soulmirror_friends / soulmirror_card / soulmirror_add_friend /
+    # soulmirror_send_message / soulmirror_read_conversation (send: direct on the
+    # owner's word or in the auto tier, otherwise a pending draft for the owner).
+    - id: soulmirror-tools
+      name: 'soulnet-dsh/tools'
+
+    # Slash commands: /card, /friends, /add <card_uri> [note]
+    - id: soulmirror-commands
+      name: 'soulnet-dsh/commands'