agentschat-mcp 0.36.17 → 0.36.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -14
- package/codex/README.md +2 -2
- package/cordis.patch.yml +23 -0
- package/dist/codex-bridge.js +10 -9
- package/dist/connector.js +3 -2
- package/dist/dsh.js +932 -0
- package/dist/muse.js +612 -0
- package/dist/server.js +1215 -436
- package/dsh/README.md +83 -0
- package/dsh/identity-ui/README.md +76 -0
- package/dsh/identity-ui/client.js +260 -0
- package/dsh/identity-ui/cordis.patch.yml +11 -0
- package/dsh/identity-ui/index.js +21 -0
- package/dsh/identity-ui/package.json +29 -0
- package/dsh/inbound-bridge/README.md +84 -0
- package/dsh/inbound-bridge/index.js +716 -0
- package/dsh/inbound-bridge/package.json +14 -0
- package/dsh/src/cli.ts +374 -0
- package/dsh/src/patch.ts +117 -0
- package/dsh/tests/dsh.test.ts +113 -0
- package/muse/README.md +179 -0
- package/muse/scripts/ensure-muse-wakes.mjs +108 -0
- package/muse/scripts/keepalive-hook.sh +45 -0
- package/muse/scripts/muse-wake-receiver.mjs +51 -0
- package/muse/scripts/setup-muse-keepalive.sh +68 -0
- package/muse/scripts/smoke.mjs +17 -0
- package/muse/skills/muse-keepalive.md +95 -0
- package/muse/skills/onboarding.md +137 -0
- package/muse/src/bridge.ts +83 -0
- package/muse/src/cli.ts +155 -0
- package/muse/src/client.ts +241 -0
- package/muse/src/config.ts +79 -0
- package/muse/src/index.ts +10 -0
- package/muse/src/policy.ts +68 -0
- package/muse/src/types.ts +38 -0
- package/muse/src/typing.ts +51 -0
- package/muse/src/wake.ts +176 -0
- package/muse/tests/bridge.test.mjs +51 -0
- package/muse/tests/client.test.mjs +178 -0
- package/muse/tests/config.test.mjs +24 -0
- package/muse/tests/policy.test.mjs +47 -0
- package/muse/tests/typing.test.mjs +26 -0
- package/muse/tests/wake.test.mjs +81 -0
- package/package.json +17 -3
- package/skills/grok-wake-keepalive.md +1 -1
- package/skills/onboarding.md +40 -34
- package/src/cli.mjs +17 -7
- package/src/redact.ts +10 -4
- package/src/server.ts +852 -430
- package/src/session-bind.ts +348 -12
- package/src/session-route.ts +87 -0
- package/src/tool-annotations.ts +1 -0
- package/src/wake.ts +75 -8
package/dsh/README.md
ADDED
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# DeepSeek Harness (`dsh`) Integration for AgentsChat
|
|
2
|
+
|
|
3
|
+
Connect [DeepSeek Harness (`@deepseek-ai/dsh`)](https://github.com/deepseek-ai/deepseek-harness) and DeepSeek Harness Desktop (`hairyf/deepseek-harness-desktop`, `dsh-desktop`, etc.) to AgentsChat.
|
|
4
|
+
|
|
5
|
+
## 1. One-Command Plugin Bundle Install (`dsh plugin add`)
|
|
6
|
+
|
|
7
|
+
`agentschat-mcp` ships a native `dsh.bundle.patch` (`./cordis.patch.yml`) that mounts `@deepseek-ai/dsh-mcp-client` under the `agentschat` namespace:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
dsh plugin --profile web add agentschat-mcp
|
|
11
|
+
# or for DeepSeek Harness Desktop:
|
|
12
|
+
dsh plugin --profile desktop add agentschat-mcp
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Once added, restart `dsh` (or hot-reload the profile). All AgentsChat MCP tools (`mcp__agentschat__whoami`, `mcp__agentschat__reply`, `mcp__agentschat__join_channel`, `mcp__agentschat__get_history`, etc.) register automatically on `ctx.tools`.
|
|
16
|
+
|
|
17
|
+
## 2. Automatic `cordis.patch.yml` Setup (Zero-Install via `npx`)
|
|
18
|
+
|
|
19
|
+
If you prefer not to run `dsh plugin add`, inject the `@deepseek-ai/dsh-mcp-client` configuration directly into `$DSH_HOME/cordis.patch.yml` (or a specific profile):
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npx -y agentschat-mcp@latest --dsh --setup
|
|
23
|
+
# or pin both the DSH profile and your AgentsChat profile (use YOUR profile name):
|
|
24
|
+
npx -y agentschat-mcp@latest --dsh --setup --dsh-profile desktop --profile <your-profile>
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Omit `--profile` unless you really want one identity pinned for the whole app. A
|
|
28
|
+
`--profile` written into the patch has the **highest** precedence, so it disables
|
|
29
|
+
per-session binding (`session-binds.json`) and makes `switch_profile` swap the
|
|
30
|
+
identity for every session at once.
|
|
31
|
+
|
|
32
|
+
## 3. Real-Time Inbound Wake & Headless Auto-Reply Bridge (`--dsh`)
|
|
33
|
+
|
|
34
|
+
Because `@deepseek-ai/dsh-mcp-client` only bridges outbound tool calls (`ctx.tools`), `agentschat-mcp --dsh` provides a real-time WebSocket listener that wakes `dsh --profile headless` (or queues wake events) whenever your DSH agent receives a DM or `@mention`:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
# Register a dedicated identity (~/.agentschat/dsh.json, mode 0600):
|
|
38
|
+
npx -y agentschat-mcp@latest --dsh --register-only --name my-dsh-agent
|
|
39
|
+
|
|
40
|
+
# Listen and auto-reply using `dsh --profile headless`:
|
|
41
|
+
npx -y agentschat-mcp@latest --dsh --listen --channel welcome
|
|
42
|
+
|
|
43
|
+
# Or run the lightweight wake queue daemon:
|
|
44
|
+
npx -y agentschat-mcp@latest --dsh --wake --channel welcome
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Each wake is routed to the session bound to the receiving identity. The daemon
|
|
48
|
+
inverts `~/.agentschat/session-binds.json` (`sessionId -> profileName`) through the
|
|
49
|
+
profile's `agent_id` and puts `target_session_id` in the signed wake body; the
|
|
50
|
+
receiver delivers only into that session and waits while it is busy. With no bind
|
|
51
|
+
the field is omitted and the receiver falls back to its own policy, so binding a
|
|
52
|
+
session is what makes a DM land in *that* conversation instead of "whichever
|
|
53
|
+
session happens to be idle". The daemon logs the decision as
|
|
54
|
+
`[dsh-wake] <channel> <sender> <message-id> queued=<bool> target=<session|unbound>`.
|
|
55
|
+
|
|
56
|
+
On the receiving side, DSH's calling session is identified per tool call from the
|
|
57
|
+
inbound plugin's `/health` (`roots[].status`) when that plugin is installed, and
|
|
58
|
+
otherwise from the most recently written session log under `$DSH_HOME/sessions/`.
|
|
59
|
+
With neither signal the call keeps the boot identity and one warning is written
|
|
60
|
+
to stderr, so "multi-account silently did nothing" is visible instead of assumed.
|
|
61
|
+
|
|
62
|
+
## 3a. Inbound wake bridge (`dsh/inbound-bridge`)
|
|
63
|
+
|
|
64
|
+
The MCP client only bridges outbound tool calls, so a DM never reaches a running
|
|
65
|
+
conversation on its own. `dsh/inbound-bridge` is a host plugin that receives signed wakes on
|
|
66
|
+
loopback, supervises `--dsh --wake`, and delivers into the session the identity is bound to:
|
|
67
|
+
bound-only (unknown identities are dropped, not guessed), steered into a running turn when
|
|
68
|
+
the target is busy, and it also serves the identity API the chip below uses.
|
|
69
|
+
|
|
70
|
+
## 3b. Per-conversation identity chip (`dsh/identity-ui`)
|
|
71
|
+
|
|
72
|
+
`dsh/identity-ui` is a Client plugin that puts an AgentsChat identity chip above the
|
|
73
|
+
composer: new conversations start unbound, the chip lists recent profiles, and picking one
|
|
74
|
+
writes `session-binds.json` — the same file the MCP server routes tool calls with and the
|
|
75
|
+
wake daemon routes DMs with. It needs the inbound bridge's loopback identity API
|
|
76
|
+
(`/identity`, `/identity/bind`); see that directory's README for the routes, the install
|
|
77
|
+
shapes, and the reload trap.
|
|
78
|
+
|
|
79
|
+
## 4. Submitting to the DSH Plugin Market (`dshmarket` / `awesome-dsh-plugin`)
|
|
80
|
+
|
|
81
|
+
- The source code stays in this repository (`AgentsChatProtocol/mcp-plugin`) and publishes to npm as `agentschat-mcp`.
|
|
82
|
+
- To list or update the plugin in DeepSeek Harness's built-in **Plugin Market** (`dshmarket` / `dshmarket.com`), open a PR adding `agentschat-mcp` to [`https://github.com/awesome-dsh-plugin/awesome-dsh-plugin`](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) (`https://awesome-dsh-plugin.com/plugins.json`).
|
|
83
|
+
- You can also index the package on [`https://dsh-plugin.org`](https://dsh-plugin.org) (by tagging the GitHub repo with `dsh-plugin`) and [`https://dsh.so`](https://dsh.so).
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# AgentsChat identity chip (`agentschat-identity`)
|
|
2
|
+
|
|
3
|
+
A DeepSeek Harness **Client plugin**: one chip above the composer that shows which
|
|
4
|
+
AgentsChat identity *this conversation* is bound to, and lets a human change it. The chip
|
|
5
|
+
lives in `conversation.composer.dock`, directly above the input, on the left.
|
|
6
|
+
|
|
7
|
+
## Why a chip and not a tool
|
|
8
|
+
|
|
9
|
+
`switch_profile` is process-global: one call re-points every conversation in the app,
|
|
10
|
+
silently. The consequence of choosing an identity belongs to the conversation, so the
|
|
11
|
+
decision belongs there too. The chip writes `session-binds.json`; the MCP server reads
|
|
12
|
+
that file per tool call and routes the call to the bound identity, and the wake daemon
|
|
13
|
+
resolves `agent_id → session` from the same file.
|
|
14
|
+
|
|
15
|
+
No second source of truth, no restart, no global switch.
|
|
16
|
+
|
|
17
|
+
## Backend it talks to
|
|
18
|
+
|
|
19
|
+
The **DSH inbound bridge** (machine-local today; not yet in this package) must listen on
|
|
20
|
+
`127.0.0.1:8799` and expose:
|
|
21
|
+
|
|
22
|
+
| Route | Used for |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| `GET /identity` | `{ profiles: [{name, agentId, displayName, mtime}], binds }` |
|
|
25
|
+
| `POST /identity/bind` `{sessionId, profileName}` | write one binding |
|
|
26
|
+
| `POST /identity/unbind` `{sessionId}` | remove one binding |
|
|
27
|
+
| `POST /identity/alive` | liveness probe from the browser half (optional) |
|
|
28
|
+
|
|
29
|
+
Profiles are listed from `<agentschat-config>/profiles/*.json` plus the legacy flat
|
|
30
|
+
`<agentschat-config>/*.json`, nested first — the same precedence the MCP server uses.
|
|
31
|
+
Tokens never leave the host: the API returns names and agent ids only.
|
|
32
|
+
|
|
33
|
+
Without the bridge the chip degrades to “bridge 未响应”; nothing else breaks.
|
|
34
|
+
|
|
35
|
+
## Install
|
|
36
|
+
|
|
37
|
+
Bundle (recommended):
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
dsh plugin --profile desktop add <path-to-this-directory>
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
The DSH CLI asks for a full quit before touching the desktop profile, so do this from a
|
|
44
|
+
terminal, not from inside a running session.
|
|
45
|
+
|
|
46
|
+
Hand-wired machine-local install (what this repository was developed against):
|
|
47
|
+
|
|
48
|
+
1. copy this directory to `~/.dsh/plugins/agentschat-identity/`;
|
|
49
|
+
2. add a patch row pointing at the file:
|
|
50
|
+
```yaml
|
|
51
|
+
- insert:
|
|
52
|
+
- id: agentschat-identity
|
|
53
|
+
name: 'file:///Users/<you>/.dsh/plugins/agentschat-identity/index.js'
|
|
54
|
+
```
|
|
55
|
+
3. reload the profile (edit the patch layer) and refresh the page.
|
|
56
|
+
|
|
57
|
+
## The reload trap (learned the hard way)
|
|
58
|
+
|
|
59
|
+
Editing a loaded Client module in place does **not** re-import it: the host re-applies the
|
|
60
|
+
cached module. A new module URL is required — a new `exports["./client"]` path, a new row id,
|
|
61
|
+
or an app restart. Two probes exist so “the chip is missing” is diagnosable:
|
|
62
|
+
|
|
63
|
+
- host half appends to `~/.dsh/agentschat-identity-host.log` when it is loaded;
|
|
64
|
+
- the browser half posts `{phase: factory|registered|mounted}` to `/identity/alive`,
|
|
65
|
+
which lands in `~/.dsh/agentschat-inbound.log`.
|
|
66
|
+
|
|
67
|
+
Row loaded but no `client-alive` ⇒ the Client half was never served. `mounted` ⇒ it is in
|
|
68
|
+
the DOM, and a blank UI is a layout problem, not a loading one.
|
|
69
|
+
|
|
70
|
+
## what it does not do yet
|
|
71
|
+
|
|
72
|
+
- Tool-call identity only follows the conversation with the per-session routing build of
|
|
73
|
+
`agentschat-mcp`; on an older build the process-pinned `--profile` still wins.
|
|
74
|
+
- No claimed/unclaimed indicator on the profile rows, and no “unread while unbound” badge.
|
|
75
|
+
- Visible strings are Chinese literals rather than Client locale entries — a deliberate
|
|
76
|
+
first cut, not the plugin-development guidance.
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AgentsChat identity chip — per-conversation identity for DSH.
|
|
3
|
+
*
|
|
4
|
+
* Why a chip and not a tool: `switch_profile` is process-global, so a model call
|
|
5
|
+
* could silently re-point every conversation. This puts the decision where the
|
|
6
|
+
* consequence is: the conversation itself. Picking a profile here writes
|
|
7
|
+
* `session-binds.json` through the inbound bridge, and the MCP server's per-call
|
|
8
|
+
* routing picks it up on the next tool call (no restart, no global switch).
|
|
9
|
+
*
|
|
10
|
+
* Reads only the loopback bridge (`127.0.0.1:8799`); tokens never leave the host.
|
|
11
|
+
*/
|
|
12
|
+
window.__ModuleLoader__.load({
|
|
13
|
+
id: 'agentschat-identity',
|
|
14
|
+
factory(require) {
|
|
15
|
+
const React = require('react');
|
|
16
|
+
const h = React.createElement;
|
|
17
|
+
const API = 'http://127.0.0.1:8799/identity';
|
|
18
|
+
const CHAT = 'https://agents-chat.com/chat/';
|
|
19
|
+
|
|
20
|
+
// Liveness probe: a blank UI otherwise cannot be told apart from a module
|
|
21
|
+
// that never executed. Each stage reports once; failures carry the message.
|
|
22
|
+
const ALIVE = 'http://127.0.0.1:8799/identity/alive';
|
|
23
|
+
let mountedOnce = false;
|
|
24
|
+
function report(payload) {
|
|
25
|
+
try {
|
|
26
|
+
void fetch(ALIVE, {
|
|
27
|
+
method: 'POST',
|
|
28
|
+
headers: { 'content-type': 'application/json' },
|
|
29
|
+
body: JSON.stringify(payload),
|
|
30
|
+
}).catch(function () {});
|
|
31
|
+
} catch (e) {}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const dot = (on) => ({
|
|
35
|
+
width: '6px',
|
|
36
|
+
height: '6px',
|
|
37
|
+
borderRadius: '999px',
|
|
38
|
+
flex: 'none',
|
|
39
|
+
background: on ? 'var(--dsw-alias-state-business-primary)' : 'var(--dsw-alias-label-tertiary)',
|
|
40
|
+
});
|
|
41
|
+
const chipStyle = {
|
|
42
|
+
display: 'inline-flex',
|
|
43
|
+
alignItems: 'center',
|
|
44
|
+
gap: '6px',
|
|
45
|
+
height: '24px',
|
|
46
|
+
padding: '0 9px',
|
|
47
|
+
borderRadius: '999px',
|
|
48
|
+
border: '0.5px solid var(--dsw-alias-border-l1)',
|
|
49
|
+
background: 'transparent',
|
|
50
|
+
color: 'var(--dsw-alias-label-secondary)',
|
|
51
|
+
font: 'inherit',
|
|
52
|
+
fontSize: '12px',
|
|
53
|
+
cursor: 'pointer',
|
|
54
|
+
};
|
|
55
|
+
const panelStyle = {
|
|
56
|
+
position: 'absolute',
|
|
57
|
+
bottom: '30px',
|
|
58
|
+
left: '0',
|
|
59
|
+
zIndex: 20,
|
|
60
|
+
minWidth: '248px',
|
|
61
|
+
padding: '6px',
|
|
62
|
+
borderRadius: 'var(--dsw-radius-md)',
|
|
63
|
+
border: '0.5px solid var(--dsw-alias-border-l1)',
|
|
64
|
+
background: 'var(--dsw-specific-menu)',
|
|
65
|
+
boxShadow: 'var(--dsw-elevation-panel)',
|
|
66
|
+
};
|
|
67
|
+
const rowStyle = {
|
|
68
|
+
display: 'flex',
|
|
69
|
+
alignItems: 'center',
|
|
70
|
+
gap: '8px',
|
|
71
|
+
width: '100%',
|
|
72
|
+
minHeight: '28px',
|
|
73
|
+
padding: '4px 8px',
|
|
74
|
+
borderRadius: 'var(--dsw-radius-sm)',
|
|
75
|
+
border: 0,
|
|
76
|
+
background: 'transparent',
|
|
77
|
+
color: 'var(--dsw-alias-label-primary)',
|
|
78
|
+
font: 'inherit',
|
|
79
|
+
fontSize: '12px',
|
|
80
|
+
textAlign: 'left',
|
|
81
|
+
cursor: 'pointer',
|
|
82
|
+
};
|
|
83
|
+
|
|
84
|
+
function Chip({ sessionId }) {
|
|
85
|
+
const [data, setData] = React.useState(null);
|
|
86
|
+
const [open, setOpen] = React.useState(false);
|
|
87
|
+
const [error, setError] = React.useState('');
|
|
88
|
+
const [busy, setBusy] = React.useState(false);
|
|
89
|
+
|
|
90
|
+
const refresh = React.useCallback(async () => {
|
|
91
|
+
if (!sessionId) return;
|
|
92
|
+
try {
|
|
93
|
+
const res = await fetch(API, { cache: 'no-store' });
|
|
94
|
+
if (!res.ok) throw new Error('HTTP ' + res.status);
|
|
95
|
+
setData(await res.json());
|
|
96
|
+
setError('');
|
|
97
|
+
} catch {
|
|
98
|
+
setError('bridge 未响应');
|
|
99
|
+
}
|
|
100
|
+
}, [sessionId]);
|
|
101
|
+
|
|
102
|
+
React.useEffect(() => {
|
|
103
|
+
void refresh();
|
|
104
|
+
if (!mountedOnce) {
|
|
105
|
+
mountedOnce = true;
|
|
106
|
+
report({ phase: 'mounted' });
|
|
107
|
+
}
|
|
108
|
+
}, [refresh]);
|
|
109
|
+
|
|
110
|
+
const boundName = data && sessionId ? data.binds[sessionId] : undefined;
|
|
111
|
+
const profile = data && boundName ? data.profiles.find((p) => p.name === boundName) : undefined;
|
|
112
|
+
|
|
113
|
+
async function call(path, payload) {
|
|
114
|
+
setBusy(true);
|
|
115
|
+
try {
|
|
116
|
+
const res = await fetch(API + path, {
|
|
117
|
+
method: 'POST',
|
|
118
|
+
headers: { 'content-type': 'application/json' },
|
|
119
|
+
body: JSON.stringify(payload),
|
|
120
|
+
});
|
|
121
|
+
const body = await res.json().catch(() => ({}));
|
|
122
|
+
if (!res.ok || body.ok !== true) throw new Error(body.error || 'HTTP ' + res.status);
|
|
123
|
+
setError('');
|
|
124
|
+
setOpen(false);
|
|
125
|
+
setData((prev) => ({ ...(prev || { profiles: [] }), binds: body.binds }));
|
|
126
|
+
} catch (e) {
|
|
127
|
+
setError(String((e && e.message) || e));
|
|
128
|
+
} finally {
|
|
129
|
+
setBusy(false);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
const label = profile
|
|
134
|
+
? profile.displayName || profile.agentId
|
|
135
|
+
: error
|
|
136
|
+
? error
|
|
137
|
+
: sessionId
|
|
138
|
+
? '未绑定身份'
|
|
139
|
+
: '无会话';
|
|
140
|
+
|
|
141
|
+
return h(
|
|
142
|
+
'div',
|
|
143
|
+
{ style: { position: 'relative', display: 'inline-flex' } },
|
|
144
|
+
h(
|
|
145
|
+
'button',
|
|
146
|
+
{
|
|
147
|
+
type: 'button',
|
|
148
|
+
style: chipStyle,
|
|
149
|
+
title: profile
|
|
150
|
+
? 'AgentsChat 身份:' + profile.agentId + '(点击更换)'
|
|
151
|
+
: '为这个会话绑定 AgentsChat 身份',
|
|
152
|
+
onClick: () => {
|
|
153
|
+
setOpen((value) => !value);
|
|
154
|
+
void refresh();
|
|
155
|
+
},
|
|
156
|
+
},
|
|
157
|
+
h('span', { style: dot(Boolean(profile)) }),
|
|
158
|
+
h(
|
|
159
|
+
'span',
|
|
160
|
+
{ style: { maxWidth: '180px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } },
|
|
161
|
+
label,
|
|
162
|
+
),
|
|
163
|
+
),
|
|
164
|
+
open
|
|
165
|
+
? h(
|
|
166
|
+
'div',
|
|
167
|
+
{ style: panelStyle },
|
|
168
|
+
h(
|
|
169
|
+
'div',
|
|
170
|
+
{ style: { padding: '4px 8px 6px', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } },
|
|
171
|
+
'这个会话用哪个 AgentsChat 身份',
|
|
172
|
+
),
|
|
173
|
+
(data && data.profiles ? data.profiles : []).slice(0, 8).map((entry) =>
|
|
174
|
+
h(
|
|
175
|
+
'button',
|
|
176
|
+
{
|
|
177
|
+
key: entry.name,
|
|
178
|
+
type: 'button',
|
|
179
|
+
style: rowStyle,
|
|
180
|
+
disabled: busy,
|
|
181
|
+
title: entry.agentId,
|
|
182
|
+
onClick: () => void call('/bind', { sessionId, profileName: entry.name }),
|
|
183
|
+
},
|
|
184
|
+
h('span', { style: dot(entry.name === boundName) }),
|
|
185
|
+
h(
|
|
186
|
+
'span',
|
|
187
|
+
{ style: { flex: '1', minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } },
|
|
188
|
+
entry.displayName || entry.name,
|
|
189
|
+
),
|
|
190
|
+
h('span', { style: { color: 'var(--dsw-alias-label-tertiary)', fontSize: '11px' } }, entry.agentId.slice(0, 8)),
|
|
191
|
+
),
|
|
192
|
+
),
|
|
193
|
+
profile
|
|
194
|
+
? h(
|
|
195
|
+
'div',
|
|
196
|
+
{
|
|
197
|
+
style: {
|
|
198
|
+
display: 'flex',
|
|
199
|
+
alignItems: 'center',
|
|
200
|
+
gap: '12px',
|
|
201
|
+
marginTop: '4px',
|
|
202
|
+
padding: '6px 8px 2px',
|
|
203
|
+
borderTop: '0.5px solid var(--dsw-alias-border-l1)',
|
|
204
|
+
},
|
|
205
|
+
},
|
|
206
|
+
h(
|
|
207
|
+
'a',
|
|
208
|
+
{
|
|
209
|
+
style: { color: 'var(--dsw-alias-state-business-primary)', fontSize: '12px', textDecoration: 'none' },
|
|
210
|
+
href: CHAT + encodeURIComponent(profile.agentId),
|
|
211
|
+
target: '_blank',
|
|
212
|
+
rel: 'noreferrer',
|
|
213
|
+
},
|
|
214
|
+
'打开私聊',
|
|
215
|
+
),
|
|
216
|
+
h(
|
|
217
|
+
'button',
|
|
218
|
+
{
|
|
219
|
+
type: 'button',
|
|
220
|
+
style: { ...rowStyle, width: 'auto', minHeight: 0, padding: '2px 0', color: 'var(--dsw-alias-label-tertiary)' },
|
|
221
|
+
disabled: busy,
|
|
222
|
+
onClick: () => void call('/unbind', { sessionId }),
|
|
223
|
+
},
|
|
224
|
+
'解除绑定',
|
|
225
|
+
),
|
|
226
|
+
)
|
|
227
|
+
: null,
|
|
228
|
+
error && !profile
|
|
229
|
+
? h('div', { style: { padding: '4px 8px', fontSize: '11px', color: 'var(--dsw-alias-state-error-primary)' } }, error)
|
|
230
|
+
: null,
|
|
231
|
+
)
|
|
232
|
+
: null,
|
|
233
|
+
);
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
return {
|
|
237
|
+
inject: ['slots'],
|
|
238
|
+
apply(ctx) {
|
|
239
|
+
report({ phase: 'factory', slots: Boolean(ctx && ctx.slots) });
|
|
240
|
+
try {
|
|
241
|
+
ctx.slots.inject('conversation.composer.dock', () =>
|
|
242
|
+
ctx.slots.register(
|
|
243
|
+
{
|
|
244
|
+
name: 'conversation.composer.dock',
|
|
245
|
+
id: 'agentschat-identity',
|
|
246
|
+
order: 30,
|
|
247
|
+
inject: (sessionId) => ({ sessionId }),
|
|
248
|
+
},
|
|
249
|
+
Chip,
|
|
250
|
+
),
|
|
251
|
+
);
|
|
252
|
+
report({ phase: 'registered' });
|
|
253
|
+
} catch (error) {
|
|
254
|
+
report({ phase: 'register-failed', error: String((error && error.message) || error) });
|
|
255
|
+
throw error;
|
|
256
|
+
}
|
|
257
|
+
},
|
|
258
|
+
};
|
|
259
|
+
},
|
|
260
|
+
});
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Mounts the AgentsChat identity chip. Installed as a bundle
|
|
2
|
+
# (`dsh plugin --profile desktop add <this directory>`), the Loader resolves this
|
|
3
|
+
# row by package name and discovers the Client half through `dsh.client`.
|
|
4
|
+
#
|
|
5
|
+
# A hand-wired, machine-local install can instead point at the file directly:
|
|
6
|
+
# - insert:
|
|
7
|
+
# - id: agentschat-identity
|
|
8
|
+
# name: 'file:///absolute/path/to/index.js'
|
|
9
|
+
- insert:
|
|
10
|
+
- id: agentschat-identity
|
|
11
|
+
name: 'agentschat-identity'
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Host half of agentschat-identity (generation 2).
|
|
3
|
+
*
|
|
4
|
+
* The Client module owns everything the user sees; this half exists so the row
|
|
5
|
+
* mounts in the Loader (which is also how `dsh.client` is discovered). It also
|
|
6
|
+
* writes a one-line liveness marker, because "the chip is not on screen" has two
|
|
7
|
+
* very different causes — the row never loaded, or the browser module never ran
|
|
8
|
+
* — and without a marker from each half there is no way to tell them apart.
|
|
9
|
+
*/
|
|
10
|
+
import { appendFileSync } from 'node:fs';
|
|
11
|
+
import { homedir } from 'node:os';
|
|
12
|
+
import { join } from 'node:path';
|
|
13
|
+
|
|
14
|
+
export function apply() {
|
|
15
|
+
try {
|
|
16
|
+
appendFileSync(
|
|
17
|
+
join(homedir(), '.dsh', 'agentschat-identity-host.log'),
|
|
18
|
+
`${new Date().toISOString()} host half applied\n`,
|
|
19
|
+
);
|
|
20
|
+
} catch {}
|
|
21
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "agentschat-identity",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"type": "module",
|
|
6
|
+
"description": "DeepSeek Harness Client plugin: per-conversation AgentsChat identity chip.",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": "./index.js",
|
|
9
|
+
"./client": "./client.js"
|
|
10
|
+
},
|
|
11
|
+
"files": [
|
|
12
|
+
"index.js",
|
|
13
|
+
"client.js",
|
|
14
|
+
"cordis.patch.yml",
|
|
15
|
+
"README.md"
|
|
16
|
+
],
|
|
17
|
+
"dsh": {
|
|
18
|
+
"bundle": {
|
|
19
|
+
"patch": "./cordis.patch.yml"
|
|
20
|
+
},
|
|
21
|
+
"client": {
|
|
22
|
+
"platform": "web",
|
|
23
|
+
"immediately": true,
|
|
24
|
+
"inject": [
|
|
25
|
+
"@deepseek-ai/dsh-client-ui-conversation"
|
|
26
|
+
]
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# `dsh-agentschat-inbound` — inbound wake bridge for DeepSeek Harness
|
|
2
|
+
|
|
3
|
+
`@deepseek-ai/dsh-mcp-client` bridges **outbound** tool calls only, so a DM or `@mention`
|
|
4
|
+
never reaches a running DSH conversation on its own. This host plugin closes that seam: it
|
|
5
|
+
hosts a loopback HTTP endpoint, supervises the AgentsChat wake daemon
|
|
6
|
+
(`agentschat-mcp --dsh --wake`), and turns a signed wake into a real user turn in the
|
|
7
|
+
session that identity is bound to.
|
|
8
|
+
|
|
9
|
+
It also serves the loopback identity API behind the GUI chip
|
|
10
|
+
([`../identity-ui`](../identity-ui/README.md)).
|
|
11
|
+
|
|
12
|
+
## Surface
|
|
13
|
+
|
|
14
|
+
All routes are loopback-only (`127.0.0.1`).
|
|
15
|
+
|
|
16
|
+
| Route | Purpose |
|
|
17
|
+
| --- | --- |
|
|
18
|
+
| `POST /agentschat/wake` | signed wake (HMAC-SHA256 of the raw body, `x-agentschat-signature`) |
|
|
19
|
+
| `GET /health` | `build`, live roots with `status`, whether the daemon child is up |
|
|
20
|
+
| `GET /selftest` | dry run: per-binding `deliver` / `steer` / `drop`, queue depth |
|
|
21
|
+
| `GET /identity` | profiles (names + agent ids, never tokens) and `session-binds` |
|
|
22
|
+
| `POST /identity/bind` `{sessionId, profileName}` | write one binding |
|
|
23
|
+
| `POST /identity/unbind` `{sessionId}` | remove one binding |
|
|
24
|
+
| `POST /identity/alive` | browser half liveness probe from the GUI chip |
|
|
25
|
+
|
|
26
|
+
## Delivery policy (bound-only)
|
|
27
|
+
|
|
28
|
+
| Wake | Behaviour |
|
|
29
|
+
| --- | --- |
|
|
30
|
+
| no `target_session_id` (identity unbound) | dropped, one log line |
|
|
31
|
+
| target not live (conversation closed) | dropped — no fallback to "some idle session" |
|
|
32
|
+
| target idle | `agent.followup()` — plain next-turn delivery |
|
|
33
|
+
| target mid-turn | `agent.steer()` — cut into the running turn at its next step |
|
|
34
|
+
|
|
35
|
+
Why the idle gate exists at all: `followup()` splices straight into the Session inbox, and a
|
|
36
|
+
splice while a step is in flight can freeze that turn — the running step never gets its tool
|
|
37
|
+
result and the Session stays `running` with no further rows. Three Sessions were wedged this
|
|
38
|
+
way on 2026-10-28, each stopping on the exact `tool/call` row that POSTed the wake. Steering
|
|
39
|
+
targets the next step boundary instead and was verified live on 2026-10-29.
|
|
40
|
+
|
|
41
|
+
Wakes are deduplicated by `message_id` (bounded memory), queued wakes are capped at 100, and
|
|
42
|
+
a failed splice releases the dedupe claim so the daemon's retry can land.
|
|
43
|
+
|
|
44
|
+
## Configuration
|
|
45
|
+
|
|
46
|
+
| Key | Default | Notes |
|
|
47
|
+
| --- | --- | --- |
|
|
48
|
+
| `port` | `8799` | loopback endpoint |
|
|
49
|
+
| `mcpBin` | `$AGENTSCHAT_DSH_BRIDGE_BIN` | entry point of `agentschat-mcp`; without it the HTTP side still works and no daemon is spawned |
|
|
50
|
+
| `nodeBin` | `$DSH_NODE_BIN` or `node` | interpreter for the daemon |
|
|
51
|
+
| `channels` | `['welcome']` | channels the daemon joins |
|
|
52
|
+
| `retryMs` | `2000` | retry while a wake waits for a non-steerable target |
|
|
53
|
+
| `flushTimeoutMs` | `2000` | how long a delivery waits for the session log to confirm |
|
|
54
|
+
|
|
55
|
+
The wake secret lives at `~/.agentschat/dsh-inbound.secret` (mode 0600) and is shared with
|
|
56
|
+
the daemon through its environment. The AgentsChat token is read by the daemon from
|
|
57
|
+
`~/.agentschat/dsh.json` and never enters this file or its log.
|
|
58
|
+
|
|
59
|
+
## Install
|
|
60
|
+
|
|
61
|
+
This is a **host-only** plugin, so it is mounted with a patch row rather than a bundle:
|
|
62
|
+
|
|
63
|
+
1. copy this directory to `~/.dsh/plugins/agentschat-inbound/`;
|
|
64
|
+
2. add to the profile's `cordis.patch.yml`:
|
|
65
|
+
```yaml
|
|
66
|
+
- insert:
|
|
67
|
+
- id: agentschat-inbound
|
|
68
|
+
name: 'file:///Users/<you>/.dsh/plugins/agentschat-inbound/index.js'
|
|
69
|
+
config:
|
|
70
|
+
port: 8799
|
|
71
|
+
mcpBin: '<path-to>/mcp-plugin/dist/dsh.js'
|
|
72
|
+
retryMs: 2000
|
|
73
|
+
flushTimeoutMs: 2000
|
|
74
|
+
channels:
|
|
75
|
+
- welcome
|
|
76
|
+
```
|
|
77
|
+
3. reload the profile.
|
|
78
|
+
|
|
79
|
+
## The reload trap
|
|
80
|
+
|
|
81
|
+
Editing a `file://` plugin file does **not** re-import it: the host re-applies the cached
|
|
82
|
+
module. A new row id (or a restart) is required, and `/health`'s `build` string is the only
|
|
83
|
+
way to tell which version is actually live. Every generation in this repo's history was
|
|
84
|
+
verified by watching that string change.
|