wps-multitool-mcp 0.0.0-stage → 1.0.2
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 +3 -3
- package/dist/bridge/cancellable.d.ts +36 -0
- package/dist/bridge/cancellable.d.ts.map +1 -0
- package/dist/bridge/cancellable.js +155 -0
- package/dist/bridge/cancellable.js.map +1 -0
- package/dist/bridge/index.d.ts +37 -0
- package/dist/bridge/index.d.ts.map +1 -0
- package/dist/bridge/index.js +383 -0
- package/dist/bridge/index.js.map +1 -0
- package/dist/bridge/ps-child.d.ts +155 -0
- package/dist/bridge/ps-child.d.ts.map +1 -0
- package/dist/bridge/ps-child.js +578 -0
- package/dist/bridge/ps-child.js.map +1 -0
- package/dist/cli/install.d.ts +58 -0
- package/dist/cli/install.d.ts.map +1 -0
- package/dist/cli/install.js +301 -0
- package/dist/cli/install.js.map +1 -0
- package/dist/client/action-routes.d.ts +32 -0
- package/dist/client/action-routes.d.ts.map +1 -0
- package/dist/client/action-routes.generated.d.ts +10 -0
- package/dist/client/action-routes.generated.d.ts.map +1 -0
- package/dist/client/action-routes.generated.js +327 -0
- package/dist/client/action-routes.generated.js.map +1 -0
- package/dist/client/action-routes.js +57 -0
- package/dist/client/action-routes.js.map +1 -0
- package/dist/client/ps-daemon.d.ts +95 -0
- package/dist/client/ps-daemon.d.ts.map +1 -0
- package/dist/client/ps-daemon.js +424 -0
- package/dist/client/ps-daemon.js.map +1 -0
- package/dist/client/wps-client.d.ts +69 -0
- package/dist/client/wps-client.d.ts.map +1 -0
- package/dist/client/wps-client.js +442 -0
- package/dist/client/wps-client.js.map +1 -0
- package/dist/index.d.ts +29 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +173 -0
- package/dist/index.js.map +1 -0
- package/dist/runtime-identity.d.ts +23 -0
- package/dist/runtime-identity.d.ts.map +1 -0
- package/dist/runtime-identity.js +26 -0
- package/dist/runtime-identity.js.map +1 -0
- package/dist/server/auto-snapshot.d.ts +58 -0
- package/dist/server/auto-snapshot.d.ts.map +1 -0
- package/dist/server/auto-snapshot.js +150 -0
- package/dist/server/auto-snapshot.js.map +1 -0
- package/dist/server/cancel-context.d.ts +30 -0
- package/dist/server/cancel-context.d.ts.map +1 -0
- package/dist/server/cancel-context.js +38 -0
- package/dist/server/cancel-context.js.map +1 -0
- package/dist/server/mcp-server.d.ts +74 -0
- package/dist/server/mcp-server.d.ts.map +1 -0
- package/dist/server/mcp-server.js +592 -0
- package/dist/server/mcp-server.js.map +1 -0
- package/dist/server/server-info.d.ts +21 -0
- package/dist/server/server-info.d.ts.map +1 -0
- package/dist/server/server-info.js +56 -0
- package/dist/server/server-info.js.map +1 -0
- package/dist/server/tool-aliases.generated.d.ts +41 -0
- package/dist/server/tool-aliases.generated.d.ts.map +1 -0
- package/dist/server/tool-aliases.generated.js +88 -0
- package/dist/server/tool-aliases.generated.js.map +1 -0
- package/dist/server/tool-annotations.d.ts +55 -0
- package/dist/server/tool-annotations.d.ts.map +1 -0
- package/dist/server/tool-annotations.generated.d.ts +14 -0
- package/dist/server/tool-annotations.generated.d.ts.map +1 -0
- package/dist/server/tool-annotations.generated.js +302 -0
- package/dist/server/tool-annotations.generated.js.map +1 -0
- package/dist/server/tool-annotations.js +192 -0
- package/dist/server/tool-annotations.js.map +1 -0
- package/dist/server/tool-group-events.d.ts +23 -0
- package/dist/server/tool-group-events.d.ts.map +1 -0
- package/dist/server/tool-group-events.js +44 -0
- package/dist/server/tool-group-events.js.map +1 -0
- package/dist/server/tool-metadata.d.ts +68 -0
- package/dist/server/tool-metadata.d.ts.map +1 -0
- package/dist/server/tool-metadata.js +834 -0
- package/dist/server/tool-metadata.js.map +1 -0
- package/dist/server/tool-registry.d.ts +186 -0
- package/dist/server/tool-registry.d.ts.map +1 -0
- package/dist/server/tool-registry.js +615 -0
- package/dist/server/tool-registry.js.map +1 -0
- package/dist/server/tool-tiers.d.ts +58 -0
- package/dist/server/tool-tiers.d.ts.map +1 -0
- package/dist/server/tool-tiers.js +128 -0
- package/dist/server/tool-tiers.js.map +1 -0
- package/dist/server/tool-verification.d.ts +35 -0
- package/dist/server/tool-verification.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.d.ts +17 -0
- package/dist/server/tool-verification.generated.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.js +293 -0
- package/dist/server/tool-verification.generated.js.map +1 -0
- package/dist/server/tool-verification.js +43 -0
- package/dist/server/tool-verification.js.map +1 -0
- package/dist/tools/common/batch.d.ts +33 -0
- package/dist/tools/common/batch.d.ts.map +1 -0
- package/dist/tools/common/batch.js +273 -0
- package/dist/tools/common/batch.js.map +1 -0
- package/dist/tools/common/convert.d.ts +41 -0
- package/dist/tools/common/convert.d.ts.map +1 -0
- package/dist/tools/common/convert.js +299 -0
- package/dist/tools/common/convert.js.map +1 -0
- package/dist/tools/common/general.d.ts +36 -0
- package/dist/tools/common/general.d.ts.map +1 -0
- package/dist/tools/common/general.js +582 -0
- package/dist/tools/common/general.js.map +1 -0
- package/dist/tools/common/index.d.ts +38 -0
- package/dist/tools/common/index.d.ts.map +1 -0
- package/dist/tools/common/index.js +116 -0
- package/dist/tools/common/index.js.map +1 -0
- package/dist/tools/common/intent.d.ts +48 -0
- package/dist/tools/common/intent.d.ts.map +1 -0
- package/dist/tools/common/intent.js +221 -0
- package/dist/tools/common/intent.js.map +1 -0
- package/dist/tools/common/repair.d.ts +29 -0
- package/dist/tools/common/repair.d.ts.map +1 -0
- package/dist/tools/common/repair.js +140 -0
- package/dist/tools/common/repair.js.map +1 -0
- package/dist/tools/common/snapshot.d.ts +77 -0
- package/dist/tools/common/snapshot.d.ts.map +1 -0
- package/dist/tools/common/snapshot.js +497 -0
- package/dist/tools/common/snapshot.js.map +1 -0
- package/dist/tools/common/status.d.ts +27 -0
- package/dist/tools/common/status.d.ts.map +1 -0
- package/dist/tools/common/status.js +139 -0
- package/dist/tools/common/status.js.map +1 -0
- package/dist/tools/common/toolgroups.d.ts +38 -0
- package/dist/tools/common/toolgroups.d.ts.map +1 -0
- package/dist/tools/common/toolgroups.js +254 -0
- package/dist/tools/common/toolgroups.js.map +1 -0
- package/dist/tools/excel/chart.d.ts +86 -0
- package/dist/tools/excel/chart.d.ts.map +1 -0
- package/dist/tools/excel/chart.js +659 -0
- package/dist/tools/excel/chart.js.map +1 -0
- package/dist/tools/excel/comment-protect.d.ts +58 -0
- package/dist/tools/excel/comment-protect.d.ts.map +1 -0
- package/dist/tools/excel/comment-protect.js +274 -0
- package/dist/tools/excel/comment-protect.js.map +1 -0
- package/dist/tools/excel/data-advanced.d.ts +47 -0
- package/dist/tools/excel/data-advanced.d.ts.map +1 -0
- package/dist/tools/excel/data-advanced.js +263 -0
- package/dist/tools/excel/data-advanced.js.map +1 -0
- package/dist/tools/excel/data.d.ts +86 -0
- package/dist/tools/excel/data.d.ts.map +1 -0
- package/dist/tools/excel/data.js +606 -0
- package/dist/tools/excel/data.js.map +1 -0
- package/dist/tools/excel/format.d.ts +42 -0
- package/dist/tools/excel/format.d.ts.map +1 -0
- package/dist/tools/excel/format.js +717 -0
- package/dist/tools/excel/format.js.map +1 -0
- package/dist/tools/excel/formula.d.ts +55 -0
- package/dist/tools/excel/formula.d.ts.map +1 -0
- package/dist/tools/excel/formula.js +316 -0
- package/dist/tools/excel/formula.js.map +1 -0
- package/dist/tools/excel/index.d.ts +44 -0
- package/dist/tools/excel/index.d.ts.map +1 -0
- package/dist/tools/excel/index.js +241 -0
- package/dist/tools/excel/index.js.map +1 -0
- package/dist/tools/excel/pivot.d.ts +39 -0
- package/dist/tools/excel/pivot.d.ts.map +1 -0
- package/dist/tools/excel/pivot.js +455 -0
- package/dist/tools/excel/pivot.js.map +1 -0
- package/dist/tools/excel/row-column.d.ts +64 -0
- package/dist/tools/excel/row-column.d.ts.map +1 -0
- package/dist/tools/excel/row-column.js +299 -0
- package/dist/tools/excel/row-column.js.map +1 -0
- package/dist/tools/excel/sheet-gaps.d.ts +50 -0
- package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
- package/dist/tools/excel/sheet-gaps.js +373 -0
- package/dist/tools/excel/sheet-gaps.js.map +1 -0
- package/dist/tools/excel/sheet.d.ts +102 -0
- package/dist/tools/excel/sheet.d.ts.map +1 -0
- package/dist/tools/excel/sheet.js +827 -0
- package/dist/tools/excel/sheet.js.map +1 -0
- package/dist/tools/excel/workbook.d.ts +62 -0
- package/dist/tools/excel/workbook.d.ts.map +1 -0
- package/dist/tools/excel/workbook.js +371 -0
- package/dist/tools/excel/workbook.js.map +1 -0
- package/dist/tools/index.d.ts +48 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +113 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/ppt/animation.d.ts +36 -0
- package/dist/tools/ppt/animation.d.ts.map +1 -0
- package/dist/tools/ppt/animation.js +190 -0
- package/dist/tools/ppt/animation.js.map +1 -0
- package/dist/tools/ppt/background.d.ts +54 -0
- package/dist/tools/ppt/background.d.ts.map +1 -0
- package/dist/tools/ppt/background.js +389 -0
- package/dist/tools/ppt/background.js.map +1 -0
- package/dist/tools/ppt/beautify-advanced.d.ts +66 -0
- package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
- package/dist/tools/ppt/beautify-advanced.js +600 -0
- package/dist/tools/ppt/beautify-advanced.js.map +1 -0
- package/dist/tools/ppt/chart-flow.d.ts +58 -0
- package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
- package/dist/tools/ppt/chart-flow.js +523 -0
- package/dist/tools/ppt/chart-flow.js.map +1 -0
- package/dist/tools/ppt/data-viz.d.ts +64 -0
- package/dist/tools/ppt/data-viz.d.ts.map +1 -0
- package/dist/tools/ppt/data-viz.js +514 -0
- package/dist/tools/ppt/data-viz.js.map +1 -0
- package/dist/tools/ppt/image.d.ts +30 -0
- package/dist/tools/ppt/image.d.ts.map +1 -0
- package/dist/tools/ppt/image.js +447 -0
- package/dist/tools/ppt/image.js.map +1 -0
- package/dist/tools/ppt/index.d.ts +72 -0
- package/dist/tools/ppt/index.d.ts.map +1 -0
- package/dist/tools/ppt/index.js +320 -0
- package/dist/tools/ppt/index.js.map +1 -0
- package/dist/tools/ppt/misc.d.ts +93 -0
- package/dist/tools/ppt/misc.d.ts.map +1 -0
- package/dist/tools/ppt/misc.js +817 -0
- package/dist/tools/ppt/misc.js.map +1 -0
- package/dist/tools/ppt/presentation.d.ts +72 -0
- package/dist/tools/ppt/presentation.d.ts.map +1 -0
- package/dist/tools/ppt/presentation.js +694 -0
- package/dist/tools/ppt/presentation.js.map +1 -0
- package/dist/tools/ppt/shape-basic.d.ts +46 -0
- package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
- package/dist/tools/ppt/shape-basic.js +756 -0
- package/dist/tools/ppt/shape-basic.js.map +1 -0
- package/dist/tools/ppt/slide-ops.d.ts +73 -0
- package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
- package/dist/tools/ppt/slide-ops.js +1740 -0
- package/dist/tools/ppt/slide-ops.js.map +1 -0
- package/dist/tools/ppt/slide.d.ts +51 -0
- package/dist/tools/ppt/slide.d.ts.map +1 -0
- package/dist/tools/ppt/slide.js +484 -0
- package/dist/tools/ppt/slide.js.map +1 -0
- package/dist/tools/ppt/table.d.ts +58 -0
- package/dist/tools/ppt/table.d.ts.map +1 -0
- package/dist/tools/ppt/table.js +514 -0
- package/dist/tools/ppt/table.js.map +1 -0
- package/dist/tools/ppt/textbox.d.ts +47 -0
- package/dist/tools/ppt/textbox.d.ts.map +1 -0
- package/dist/tools/ppt/textbox.js +249 -0
- package/dist/tools/ppt/textbox.js.map +1 -0
- package/dist/tools/word/academic.d.ts +50 -0
- package/dist/tools/word/academic.d.ts.map +1 -0
- package/dist/tools/word/academic.js +500 -0
- package/dist/tools/word/academic.js.map +1 -0
- package/dist/tools/word/content.d.ts +97 -0
- package/dist/tools/word/content.d.ts.map +1 -0
- package/dist/tools/word/content.js +843 -0
- package/dist/tools/word/content.js.map +1 -0
- package/dist/tools/word/document.d.ts +65 -0
- package/dist/tools/word/document.d.ts.map +1 -0
- package/dist/tools/word/document.js +576 -0
- package/dist/tools/word/document.js.map +1 -0
- package/dist/tools/word/format.d.ts +50 -0
- package/dist/tools/word/format.d.ts.map +1 -0
- package/dist/tools/word/format.js +462 -0
- package/dist/tools/word/format.js.map +1 -0
- package/dist/tools/word/gaps.d.ts +58 -0
- package/dist/tools/word/gaps.d.ts.map +1 -0
- package/dist/tools/word/gaps.js +431 -0
- package/dist/tools/word/gaps.js.map +1 -0
- package/dist/tools/word/index.d.ts +34 -0
- package/dist/tools/word/index.d.ts.map +1 -0
- package/dist/tools/word/index.js +122 -0
- package/dist/tools/word/index.js.map +1 -0
- package/dist/tools/word/professional.d.ts +48 -0
- package/dist/tools/word/professional.d.ts.map +1 -0
- package/dist/tools/word/professional.js +657 -0
- package/dist/tools/word/professional.js.map +1 -0
- package/dist/tools/word/proofread.d.ts +25 -0
- package/dist/tools/word/proofread.d.ts.map +1 -0
- package/dist/tools/word/proofread.js +718 -0
- package/dist/tools/word/proofread.js.map +1 -0
- package/dist/types/index.d.ts +9 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +25 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/tools.d.ts +174 -0
- package/dist/types/tools.d.ts.map +1 -0
- package/dist/types/tools.js +45 -0
- package/dist/types/tools.js.map +1 -0
- package/dist/types/wps.d.ts +190 -0
- package/dist/types/wps.d.ts.map +1 -0
- package/dist/types/wps.js +23 -0
- package/dist/types/wps.js.map +1 -0
- package/dist/utils/error.d.ts +147 -0
- package/dist/utils/error.d.ts.map +1 -0
- package/dist/utils/error.js +417 -0
- package/dist/utils/error.js.map +1 -0
- package/dist/utils/logger.d.ts +56 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +155 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/version.d.ts +22 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +101 -0
- package/dist/version.js.map +1 -0
- package/package.json +66 -6
- package/scripts/wps-com.ps1 +8255 -0
- package/scripts/wps-comd.ps1 +123 -0
- package/skills/wps-multitool/SKILL.md +129 -0
- package/skills/wps-multitool/references/errors.md +62 -0
- package/skills/wps-multitool/references/recipes.md +83 -0
- package/skills/wps-multitool/references/routing.md +88 -0
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Input: 应用键(excel / word / ppt / common)与动作名、参数
|
|
3
|
+
* Output: 该动作的 COM 结果({ success, data?, error? })
|
|
4
|
+
* Pos: 桥进程内部的 PowerShell 子进程管理器 —— 一个应用一个实例。一旦我被修改,请更新我的头部注释,以及所属目录的md。
|
|
5
|
+
*
|
|
6
|
+
* 为什么按应用拆进程(per-app 隔离)
|
|
7
|
+
* ----------------------------------
|
|
8
|
+
* COM 是 STA:一个进程同一时刻只能跑一个动作。改造前所有应用共用一个 powershell,
|
|
9
|
+
* 于是"WPS 文字卡在一个慢动作上"会把"表格"的调用一起堵死。
|
|
10
|
+
* 拆成一应用一进程后,某一路卡死只影响它自己;桥还能【只杀那一路】并重建,
|
|
11
|
+
* 另外两路完全不受影响。对标 JulianPoleszczuk/office-mcp 的 per-app 连接模型。
|
|
12
|
+
*
|
|
13
|
+
* 超时语义
|
|
14
|
+
* --------
|
|
15
|
+
* 超时即判定【该应用的这一路已死】:杀掉该子进程、拒绝它在途的请求,下次调用重建。
|
|
16
|
+
* 绝不能"超时了还继续往这个进程塞请求"。
|
|
17
|
+
* 另外:超时后【不自动重放】—— 写动作(保存/导出)可能已经执行了一半,
|
|
18
|
+
* 重放会变成执行两次。由调用方决定怎么办。
|
|
19
|
+
*
|
|
20
|
+
* 子进程生命周期
|
|
21
|
+
* --------------
|
|
22
|
+
* wps-comd.ps1 自带父进程看门狗,本进程(桥)一死,子进程会自己走 —— 不需要额外清理。
|
|
23
|
+
*/
|
|
24
|
+
/**
|
|
25
|
+
* 每应用的排队上限。超了立刻回 busy —— 把"无声地等几分钟"换成"明确被拒"。
|
|
26
|
+
* 注意:这不等于并发度(COM 是 STA,在途恒为 1),它限的是"等待位"的数量。
|
|
27
|
+
*/
|
|
28
|
+
export declare function queueMax(): number;
|
|
29
|
+
/** 排队上限。排太久不如早拒 —— 与动作超时是两个独立维度。 */
|
|
30
|
+
export declare function queueTimeoutMs(): number;
|
|
31
|
+
export declare function exclusiveSet(): Set<string>;
|
|
32
|
+
/** 子进程压根没起来(请求从未送达)时抛这个,调用方可以安全重建。 */
|
|
33
|
+
export declare class ChildUnavailableError extends Error {
|
|
34
|
+
constructor(message: string);
|
|
35
|
+
}
|
|
36
|
+
/** 队列满 / 排队超时:请求【从未送达】PowerShell,属于可安全重试的基础设施问题。 */
|
|
37
|
+
export declare class QueueBusyError extends Error {
|
|
38
|
+
constructor(message: string);
|
|
39
|
+
}
|
|
40
|
+
/** call() 的可选参数 */
|
|
41
|
+
export interface CallOptions {
|
|
42
|
+
/** 取消信号:来自 MCP 客户端的 notifications/cancelled */
|
|
43
|
+
signal?: AbortSignal;
|
|
44
|
+
/** 桥侧的请求 id,用于后续按 id 取消 */
|
|
45
|
+
externalId?: string;
|
|
46
|
+
}
|
|
47
|
+
export interface ChildStats {
|
|
48
|
+
app: string;
|
|
49
|
+
ready: boolean;
|
|
50
|
+
pid: number | null;
|
|
51
|
+
uptimeMs: number;
|
|
52
|
+
restarts: number;
|
|
53
|
+
/** 在途(已送出、等 WPS 回话) */
|
|
54
|
+
pending: number;
|
|
55
|
+
/** 队列里等位的数量 */
|
|
56
|
+
queued: number;
|
|
57
|
+
/** 是否已有一个动作在途(STA:恒为 0 或 1) */
|
|
58
|
+
inFlight: boolean;
|
|
59
|
+
/** 队列上限 */
|
|
60
|
+
queueMax: number;
|
|
61
|
+
/** 排队时长上限 */
|
|
62
|
+
queueTimeoutMs: number;
|
|
63
|
+
/** 最近一次排队等待的毫秒数(无则 0) */
|
|
64
|
+
lastQueueWaitMs: number;
|
|
65
|
+
/** 累计因队列满/排队超时被拒的次数 */
|
|
66
|
+
rejected: number;
|
|
67
|
+
/** 累计被取消的次数(排队中出队 + 只读动作放弃等待) */
|
|
68
|
+
cancelled: number;
|
|
69
|
+
}
|
|
70
|
+
export declare class PsChildDaemon {
|
|
71
|
+
private readonly appKey;
|
|
72
|
+
private proc;
|
|
73
|
+
private stdoutBuf;
|
|
74
|
+
private pending;
|
|
75
|
+
private queue;
|
|
76
|
+
private starting;
|
|
77
|
+
private ready;
|
|
78
|
+
private disposed;
|
|
79
|
+
private startedAt;
|
|
80
|
+
private restarts;
|
|
81
|
+
private lastQueueWaitMs;
|
|
82
|
+
private rejected;
|
|
83
|
+
/**
|
|
84
|
+
* 是否已有一个动作被 drain 送出、还没回话。
|
|
85
|
+
*
|
|
86
|
+
* 不能用 pending.size 判断:pending 是【送出之后】才登记的,
|
|
87
|
+
* 而 ensureStarted() 是异步的 —— 冷启动那几秒里 pending 一直是 0,
|
|
88
|
+
* 结果一串并发请求会全部"穿过"队列被同时写进子进程(既破了并发上限,
|
|
89
|
+
* 也让 STA 约束失效)。所以这里用一个同步置位的标志位。
|
|
90
|
+
*/
|
|
91
|
+
private inFlight;
|
|
92
|
+
/** 在途请求的桥侧 id / 动作名 / 子进程侧 id —— 取消时要靠它们定位 */
|
|
93
|
+
private inFlightId;
|
|
94
|
+
private inFlightAction;
|
|
95
|
+
private inFlightPendingId;
|
|
96
|
+
/** 累计被取消的次数 */
|
|
97
|
+
private cancelled;
|
|
98
|
+
constructor(appKey: string);
|
|
99
|
+
get isReady(): boolean;
|
|
100
|
+
get stats(): ChildStats;
|
|
101
|
+
/**
|
|
102
|
+
* 调用一个动作。业务成功/失败都以响应对象 resolve;
|
|
103
|
+
* 只有【基础设施问题】(起不来、超时、进程退出、队列满)才 reject。
|
|
104
|
+
*
|
|
105
|
+
* 并发语义(重要)
|
|
106
|
+
* ----------------
|
|
107
|
+
* COM 是 STA:一个应用同一时刻【只能有一个动作在跑】。所以这里不是"提高并发度",
|
|
108
|
+
* 而是把"无声排队"变成"有界的、看得见的等待":
|
|
109
|
+
* - 队列上限 queueMax(默认 4),超了立刻回 QueueBusyError,不让调用方干等;
|
|
110
|
+
* - 排队超时 queueTimeoutMs(默认 10s),与动作超时独立;
|
|
111
|
+
* - 排他的动作(open/save/quit 等)插队,避免用户主动操作被一堆读操作压住。
|
|
112
|
+
*
|
|
113
|
+
* 取消语义(详见 bridge/cancellable.ts)
|
|
114
|
+
* --------------------------------------
|
|
115
|
+
* 排队中被取消 → 直接出队,请求从未送达,任何动作都安全
|
|
116
|
+
* 已在途中被取消 → 只有【只读动作】才放弃等待(回话到了丢弃,子进程继续跑完);
|
|
117
|
+
* 写入动作一律不放弃,老实等它跑完如实返回
|
|
118
|
+
*/
|
|
119
|
+
call(action: string, params?: Record<string, unknown>, opts?: CallOptions): Promise<Record<string, unknown>>;
|
|
120
|
+
/**
|
|
121
|
+
* 按桥侧 id 取消一个请求(跨进程取消入口)。
|
|
122
|
+
* @returns 是否真的取消了。false = 找不到 / 已送出且是写入动作(不许取消)
|
|
123
|
+
*/
|
|
124
|
+
cancelByExternalId(externalId: string): {
|
|
125
|
+
ok: boolean;
|
|
126
|
+
reason: string;
|
|
127
|
+
};
|
|
128
|
+
/**
|
|
129
|
+
* 放弃一个在途请求:只通知调用方"不等了",【不动 dispatch 的 promise】。
|
|
130
|
+
* dispatch 必须继续等到子进程真的回话,否则 inFlight 会提前释放 ——
|
|
131
|
+
* 那等于允许下一个请求闯进一个还在忙的 STA 进程。
|
|
132
|
+
*/
|
|
133
|
+
private abandonPending;
|
|
134
|
+
/**
|
|
135
|
+
* 队列泵:把队首送进子进程,回话后继续送下一个。
|
|
136
|
+
* 在途只允许 1 个 —— 这是 STA 的硬约束,不是策略选择。
|
|
137
|
+
*/
|
|
138
|
+
private drain;
|
|
139
|
+
/** 真正把一行 JSON 写进子进程并等它的响应 */
|
|
140
|
+
private dispatch;
|
|
141
|
+
/** 杀掉当前子进程并清理在途请求(下次调用重建)。reason 仅用于诊断。 */
|
|
142
|
+
kill(reason?: string): void;
|
|
143
|
+
dispose(): void;
|
|
144
|
+
private failAll;
|
|
145
|
+
/** 子进程没了,队列里等位的也没意义了 —— 立刻拒掉,不要让它们干等到排队超时 */
|
|
146
|
+
private failQueued;
|
|
147
|
+
private ensureStarted;
|
|
148
|
+
private start;
|
|
149
|
+
/** 按行切分 stdout,各自当一条响应处理 */
|
|
150
|
+
private onStdout;
|
|
151
|
+
private handleLine;
|
|
152
|
+
/** 桥是 detached 进程,stdio 被忽略 —— 落文件日志,出问题有据可查 */
|
|
153
|
+
private logStderr;
|
|
154
|
+
}
|
|
155
|
+
//# sourceMappingURL=ps-child.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ps-child.d.ts","sourceRoot":"","sources":["../../src/bridge/ps-child.ts"],"names":[],"mappings":"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"}
|