@duke-dsh-plugins/dsh-remote-control 1.1.8 → 1.1.9
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/lib/host-bridge.mjs +170 -46
- package/market/index.json +10 -0
- package/package.json +1 -1
package/lib/host-bridge.mjs
CHANGED
|
@@ -788,6 +788,32 @@ export function mapModelSelection(data) {
|
|
|
788
788
|
return parseModelSelection(data);
|
|
789
789
|
}
|
|
790
790
|
|
|
791
|
+
/**
|
|
792
|
+
* 契约 §5.1:会话历史读取地址(宿主 0.2.2+ 的 durable address)。
|
|
793
|
+
*
|
|
794
|
+
* 宿主对**普通会话**与**子代理会话**用两种地址:
|
|
795
|
+
* - 普通会话:{kind:'session', sessionId}
|
|
796
|
+
* - 子代理:{kind:'subagent', parentSessionId, childSessionId, mode:'unknown'}
|
|
797
|
+
* (子代理会话用 kind:'session' 会被宿主拒为 session/agent-busy)
|
|
798
|
+
*
|
|
799
|
+
* mode 固定 'unknown':宿主在 mode==='unknown' 时跳过 mode 比对,
|
|
800
|
+
* 免得我们还得额外读一次子代理目录去确认 one-shot/continuable。
|
|
801
|
+
* @param {string} sessionId
|
|
802
|
+
* @param {string} [parentSessionId] 子代理的父会话 id(普通会话留空)
|
|
803
|
+
* @returns {{kind:string,sessionId?:string,parentSessionId?:string,childSessionId?:string,mode?:string}}
|
|
804
|
+
*/
|
|
805
|
+
export function historyAddress(sessionId, parentSessionId = "") {
|
|
806
|
+
if (parentSessionId !== "") {
|
|
807
|
+
return {
|
|
808
|
+
kind: "subagent",
|
|
809
|
+
parentSessionId,
|
|
810
|
+
childSessionId: sessionId,
|
|
811
|
+
mode: "unknown",
|
|
812
|
+
};
|
|
813
|
+
}
|
|
814
|
+
return { kind: "session", sessionId };
|
|
815
|
+
}
|
|
816
|
+
|
|
791
817
|
/**
|
|
792
818
|
* 契约 §5.9 归档:宿主错误的「原样」回传。
|
|
793
819
|
* 优先用宿主的错误码(RemoteError.code,如 "workspace/active-session"),
|
|
@@ -1973,9 +1999,14 @@ export class HostBridge {
|
|
|
1973
1999
|
}
|
|
1974
2000
|
|
|
1975
2001
|
/** 契约 §5.1 session.history:向后翻页的历史消息页(v1.0.4)。
|
|
1976
|
-
*
|
|
1977
|
-
*
|
|
1978
|
-
*
|
|
2002
|
+
*
|
|
2003
|
+
* 宿主 API 分代(DSH 0.2.2-rc.1 起换了历史入口):
|
|
2004
|
+
* - 新宿主:sessionController.events({address, throughSeq?, beforeSeq?, maxMessages?})。
|
|
2005
|
+
* **省略 throughSeq 即取当前日志末尾**(宿主自己算 observation.cursor),
|
|
2006
|
+
* 所以不再需要先 inspect() 拿尾 seq——旧宿主那套 inspect()+page() 在新宿主上
|
|
2007
|
+
* 会直接抛 "sc.inspect is not a function",手机端表现为「历史消息加载不了」。
|
|
2008
|
+
* - 旧宿主:只有 inspect()(拿日志尾 seq + subagent 身份)与 page(),保留原路径。
|
|
2009
|
+
*
|
|
1979
2010
|
* 向前翻页:客户端回传上一页的 oldestSeq 作 beforeSeq(开区间)。 */
|
|
1980
2011
|
async #rSessionHistory(m) {
|
|
1981
2012
|
const p = m.payload ?? {};
|
|
@@ -1994,34 +2025,7 @@ export class HostBridge {
|
|
|
1994
2025
|
const sc = this.#sc();
|
|
1995
2026
|
// v1.1.1(§5.10.2):交付物图片作为**独立**的历史消息(两条回包路径都要带上)
|
|
1996
2027
|
const delivered = await this.#deliveredHistoryMessages(sessionId);
|
|
1997
|
-
|
|
1998
|
-
let address = { kind: "session", sessionId };
|
|
1999
|
-
try {
|
|
2000
|
-
const inspected = await sc.inspect(sessionId, signal);
|
|
2001
|
-
const events = inspected?.events;
|
|
2002
|
-
if (Array.isArray(events) && events.length > 0) {
|
|
2003
|
-
const lastSeq = Number(events[events.length - 1]?.seq);
|
|
2004
|
-
if (Number.isSafeInteger(lastSeq) && lastSeq >= 0) cursor = lastSeq;
|
|
2005
|
-
}
|
|
2006
|
-
// subagent 会话必须走 durable subagent 地址(宿主校验:kind:'session' 会被拒)
|
|
2007
|
-
const header = inspected?.meta;
|
|
2008
|
-
const parent = typeof header?.parentSession === "string" ? header.parentSession : "";
|
|
2009
|
-
if (header?.origin === "subagent" && parent !== "") {
|
|
2010
|
-
address = { kind: "subagent", parentSessionId: parent, childSessionId: sessionId, mode: "unknown" };
|
|
2011
|
-
}
|
|
2012
|
-
} catch (e) {
|
|
2013
|
-
// inspect 失败(会话不存在等)→ 直接把错误回给手机端
|
|
2014
|
-
throw e;
|
|
2015
|
-
}
|
|
2016
|
-
if (cursor < 0) {
|
|
2017
|
-
// 空会话(无任何事件):直接回空页,不折腾 page
|
|
2018
|
-
// (交付物图片仍要带上——它们不在宿主的会话日志里)
|
|
2019
|
-
this.#reply(m, resultOf(m, { messages: delivered, steps: [], hasMore: false, oldestSeq: 0 }));
|
|
2020
|
-
return;
|
|
2021
|
-
}
|
|
2022
|
-
const request = { address, throughSeq: cursor, maxMessages };
|
|
2023
|
-
if (beforeSeq !== undefined) request.beforeSeq = beforeSeq;
|
|
2024
|
-
const page = await sc.page(request, signal);
|
|
2028
|
+
const page = await this.#readHistoryPage(sc, sessionId, maxMessages, beforeSeq, signal);
|
|
2025
2029
|
const messages = [];
|
|
2026
2030
|
let oldestSeq = Number.MAX_SAFE_INTEGER;
|
|
2027
2031
|
let oldestEventSeq = Number.MAX_SAFE_INTEGER;
|
|
@@ -2079,6 +2083,137 @@ export class HostBridge {
|
|
|
2079
2083
|
}
|
|
2080
2084
|
}
|
|
2081
2085
|
|
|
2086
|
+
/**
|
|
2087
|
+
* 读一页会话历史(宿主 API 分代适配层)。
|
|
2088
|
+
*
|
|
2089
|
+
* 新宿主(DSH 0.2.2-rc.1+):走 events()。
|
|
2090
|
+
* - **不传 throughSeq**:宿主会自己取当前日志末尾作为切点
|
|
2091
|
+
* (resolveHistoryRequest 允许省略;history() 用 observation.cursor,
|
|
2092
|
+
* 它就是日志最后一条事件的 seq —— 与旧路径 inspect() 算出的 cursor 等价)。
|
|
2093
|
+
* - 向前翻页只传 beforeSeq(开区间),宿主自己与末尾取交集。
|
|
2094
|
+
* 旧宿主(0.2.1 及更早):先 inspect() 冷读拿日志尾 seq(throughSeq 必须是真实
|
|
2095
|
+
* 存在的 seq,传 MAX_SAFE_INTEGER 会被 bad-request 拒为 past cursor),再 page()。
|
|
2096
|
+
*
|
|
2097
|
+
* 版本判据(实测 0.2.1-rc.5 无 events()、有 inspect();0.2.2-rc.1 有 events()、
|
|
2098
|
+
* 无 inspect()):**以 events() 的存在与否分流**,不靠版本号猜。
|
|
2099
|
+
*
|
|
2100
|
+
* @param {any} sc sessionController
|
|
2101
|
+
* @param {string} sessionId
|
|
2102
|
+
* @param {number} maxMessages
|
|
2103
|
+
* @param {number|undefined} beforeSeq
|
|
2104
|
+
* @param {AbortSignal} signal
|
|
2105
|
+
* @returns {Promise<{records:any[],hasMore:boolean}>}
|
|
2106
|
+
*/
|
|
2107
|
+
async #readHistoryPage(sc, sessionId, maxMessages, beforeSeq, signal) {
|
|
2108
|
+
if (typeof sc.events === "function") {
|
|
2109
|
+
const address = await this.#historyAddress(sc, sessionId, signal);
|
|
2110
|
+
const request = { address, maxMessages };
|
|
2111
|
+
if (beforeSeq !== undefined) request.beforeSeq = beforeSeq;
|
|
2112
|
+
const page = await sc.events(request, signal);
|
|
2113
|
+
return { records: page?.records ?? [], hasMore: page?.hasMore === true };
|
|
2114
|
+
}
|
|
2115
|
+
// 旧宿主:inspect + page。
|
|
2116
|
+
const inspected = await sc.inspect(sessionId, signal);
|
|
2117
|
+
const events = inspected?.events;
|
|
2118
|
+
let cursor = -1;
|
|
2119
|
+
let address = historyAddress(sessionId);
|
|
2120
|
+
if (Array.isArray(events) && events.length > 0) {
|
|
2121
|
+
const lastSeq = Number(events[events.length - 1]?.seq);
|
|
2122
|
+
if (Number.isSafeInteger(lastSeq) && lastSeq >= 0) cursor = lastSeq;
|
|
2123
|
+
}
|
|
2124
|
+
// subagent 会话必须走 durable subagent 地址(宿主校验:kind:'session' 会被拒)
|
|
2125
|
+
const header = inspected?.meta;
|
|
2126
|
+
const parent = typeof header?.parentSession === "string" ? header.parentSession : "";
|
|
2127
|
+
if (header?.origin === "subagent" && parent !== "") {
|
|
2128
|
+
address = historyAddress(sessionId, parent);
|
|
2129
|
+
}
|
|
2130
|
+
if (cursor < 0) {
|
|
2131
|
+
// 空会话(无任何事件):直接回空页,不折腾 page
|
|
2132
|
+
// (交付物图片仍要带上——它们不在宿主的会话日志里)
|
|
2133
|
+
return { records: [], hasMore: false };
|
|
2134
|
+
}
|
|
2135
|
+
const request = { address, throughSeq: cursor, maxMessages };
|
|
2136
|
+
if (beforeSeq !== undefined) request.beforeSeq = beforeSeq;
|
|
2137
|
+
const page = await sc.page(request, signal);
|
|
2138
|
+
return { records: page?.records ?? [], hasMore: page?.hasMore === true };
|
|
2139
|
+
}
|
|
2140
|
+
|
|
2141
|
+
/**
|
|
2142
|
+
* 解析会话历史的宿主地址(新宿主路径)。
|
|
2143
|
+
*
|
|
2144
|
+
* 子代理会话必须用 durable subagent 地址;它的父会话 id 从**冷读**的
|
|
2145
|
+
* sessionController.list() 里取(list 不激活 Agent)。
|
|
2146
|
+
* list() 拿不到(例如会话已不在可见列表里)→ 退回普通会话地址,
|
|
2147
|
+
* 由宿主自己判定(子代理用 kind:'session' 会被拒为 session/agent-busy,
|
|
2148
|
+
* 错误原样回给手机端,不静默吞掉)。
|
|
2149
|
+
* @param {any} sc sessionController
|
|
2150
|
+
* @param {string} sessionId
|
|
2151
|
+
* @param {AbortSignal} signal
|
|
2152
|
+
* @returns {Promise<{kind:string,sessionId?:string,parentSessionId?:string,childSessionId?:string,mode?:string}>}
|
|
2153
|
+
*/
|
|
2154
|
+
async #historyAddress(sc, sessionId, signal) {
|
|
2155
|
+
try {
|
|
2156
|
+
const listed = await sc.list({}, signal);
|
|
2157
|
+
for (const raw of listed?.items ?? []) {
|
|
2158
|
+
if (String(raw?.sessionId ?? "") !== sessionId) continue;
|
|
2159
|
+
const parent = typeof raw?.parentSessionId === "string" ? raw.parentSessionId : "";
|
|
2160
|
+
if (raw?.origin === "subagent" && parent !== "") {
|
|
2161
|
+
return historyAddress(sessionId, parent);
|
|
2162
|
+
}
|
|
2163
|
+
return historyAddress(sessionId);
|
|
2164
|
+
}
|
|
2165
|
+
} catch (e) {
|
|
2166
|
+
this.#log("warn", "history address lookup failed; using plain session address", {
|
|
2167
|
+
sessionId,
|
|
2168
|
+
error: errText(e),
|
|
2169
|
+
});
|
|
2170
|
+
}
|
|
2171
|
+
return historyAddress(sessionId);
|
|
2172
|
+
}
|
|
2173
|
+
|
|
2174
|
+
/**
|
|
2175
|
+
* 冷读判定一个会话是不是子代理(**绝不激活 Agent**)。
|
|
2176
|
+
*
|
|
2177
|
+
* 新宿主没有 inspect() 了 → 用 list() 的 origin/parentSessionId 字段
|
|
2178
|
+
* (宿主 listFields(header) 直接带出这两个字段,与旧宿主 inspect().meta 同源)。
|
|
2179
|
+
* 旧宿主仍走 inspect()(更快,且不必列举全部会话)。
|
|
2180
|
+
*
|
|
2181
|
+
* 用途:权限查询的 live 降级前必须先判身份——子代理绝不能为了显示权限
|
|
2182
|
+
* 而 resolveAgent 激活它(v1.1.7 规则)。
|
|
2183
|
+
* @param {any} sc sessionController
|
|
2184
|
+
* @param {string} sessionId
|
|
2185
|
+
* @param {AbortSignal} signal
|
|
2186
|
+
* @returns {Promise<boolean>}
|
|
2187
|
+
*/
|
|
2188
|
+
async #isSubagentSession(sc, sessionId, signal) {
|
|
2189
|
+
try {
|
|
2190
|
+
if (typeof sc.inspect === "function") {
|
|
2191
|
+
const inspected = await sc.inspect(sessionId, signal);
|
|
2192
|
+
const meta = inspected?.meta;
|
|
2193
|
+
return (
|
|
2194
|
+
meta?.origin === "subagent" ||
|
|
2195
|
+
(typeof meta?.parentSession === "string" && meta.parentSession !== "") ||
|
|
2196
|
+
(typeof meta?.parentSessionId === "string" && meta.parentSessionId !== "")
|
|
2197
|
+
);
|
|
2198
|
+
}
|
|
2199
|
+
const listed = await sc.list({}, signal);
|
|
2200
|
+
for (const raw of listed?.items ?? []) {
|
|
2201
|
+
if (String(raw?.sessionId ?? "") !== sessionId) continue;
|
|
2202
|
+
if (raw?.origin === "subagent") return true;
|
|
2203
|
+
return typeof raw?.parentSessionId === "string" && raw.parentSessionId !== "";
|
|
2204
|
+
}
|
|
2205
|
+
return false;
|
|
2206
|
+
} catch (e) {
|
|
2207
|
+
this.#log("warn", "subagent identity cold read unavailable", {
|
|
2208
|
+
sessionId,
|
|
2209
|
+
error: errText(e),
|
|
2210
|
+
});
|
|
2211
|
+
// 判不出来 → 按“不是子代理”处理(宿主对普通会话的权限查询是安全的);
|
|
2212
|
+
// 真子代理会走 resolveAgent 路径,但那是宿主的既有行为,不是我们引入的。
|
|
2213
|
+
return false;
|
|
2214
|
+
}
|
|
2215
|
+
}
|
|
2216
|
+
|
|
2082
2217
|
/** 契约 §5.1 session.subagents(v1.0.5):父会话直接子代理目录。
|
|
2083
2218
|
* 数据组合:父会话 subagentCatalog 持久投影(mode/label/createdAt/顺序,
|
|
2084
2219
|
* 经 sessionController.projections 冷读,无 Agent 激活)+ list 全量行
|
|
@@ -2611,24 +2746,13 @@ export class HostBridge {
|
|
|
2611
2746
|
}
|
|
2612
2747
|
|
|
2613
2748
|
// 旧宿主没有 permissions 投影时,live Session 的 current() 仍是有效值权威来源。
|
|
2614
|
-
// 但 subagent 查询绝不能为了兜底而激活 Agent
|
|
2749
|
+
// 但 subagent 查询绝不能为了兜底而激活 Agent:先冷读身份,命中即只回内存态。
|
|
2750
|
+
// 新宿主(0.2.2-rc.1+)没有 inspect() 了 → 冷读改走 list() 的 origin/parentSessionId
|
|
2751
|
+
// (同样不激活 Agent),否则会误把子代理 resolveAgent 起来(违反 v1.1.7)。
|
|
2615
2752
|
try {
|
|
2616
2753
|
const svc = this.#service("permissionPresets");
|
|
2617
2754
|
const sc = this.#sc();
|
|
2618
|
-
|
|
2619
|
-
if (typeof sc.inspect === "function") {
|
|
2620
|
-
try {
|
|
2621
|
-
const inspected = await sc.inspect(sessionId, this.#signal(10_000));
|
|
2622
|
-
const meta = inspected?.meta;
|
|
2623
|
-
coldSubagent = meta?.origin === "subagent" ||
|
|
2624
|
-
(typeof meta?.parentSessionId === "string" && meta.parentSessionId !== "");
|
|
2625
|
-
} catch (e) {
|
|
2626
|
-
this.#log("warn", "permission subagent identity inspect unavailable", {
|
|
2627
|
-
sessionId,
|
|
2628
|
-
error: errText(e),
|
|
2629
|
-
});
|
|
2630
|
-
}
|
|
2631
|
-
}
|
|
2755
|
+
const coldSubagent = await this.#isSubagentSession(sc, sessionId, this.#signal(10_000));
|
|
2632
2756
|
if (!coldSubagent && svc && typeof svc.current === "function" && typeof sc.resolveAgent === "function") {
|
|
2633
2757
|
const agentRes = await sc.resolveAgent(sessionId);
|
|
2634
2758
|
const session = agentRes?.agent?.session ?? agentRes?.session ?? null;
|
package/market/index.json
CHANGED
|
@@ -69,6 +69,16 @@
|
|
|
69
69
|
"sortKeys": {}
|
|
70
70
|
},
|
|
71
71
|
"versions": [
|
|
72
|
+
{
|
|
73
|
+
"version": "1.1.9",
|
|
74
|
+
"publishTimestamp": 1793924339,
|
|
75
|
+
"source": {
|
|
76
|
+
"type": "npm"
|
|
77
|
+
},
|
|
78
|
+
"engines": {
|
|
79
|
+
"dsh": "^0.1.5-rc.3 || ^0.2.0-rc.1 || ^0.2.1-rc.0"
|
|
80
|
+
}
|
|
81
|
+
},
|
|
72
82
|
{
|
|
73
83
|
"version": "1.1.8",
|
|
74
84
|
"publishTimestamp": 1793807705,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@duke-dsh-plugins/dsh-remote-control",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.9",
|
|
4
4
|
"description": "Remote-control bridge for DeepSeek Harness: pairs a HarmonyOS phone app with the desktop Host over an end-to-end-encrypted public relay (WebSocket). Lets the phone list/create/switch sessions, send prompts, watch streamed replies, cancel turns, and answer approval and ask-user-question requests from anywhere; pushes Huawei Push Kit notifications (gracefully disabled when AGC is unconfigured) for approvals, questions, and turn completion. The pairing QR lives in the DSH settings panel (\"DSH Pocket\"). Fail-open by design: any relay timeout or fault hands the request back to the desktop answerer.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|