@winmatrix/agent-sdk 1.0.3 → 1.0.5

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.
Files changed (102) hide show
  1. package/dist/adapters/claude/ClaudeAdapter.d.ts +60 -1
  2. package/dist/adapters/claude/ClaudeAdapter.d.ts.map +1 -1
  3. package/dist/adapters/claude/ClaudeAdapter.js +404 -84
  4. package/dist/adapters/claude/ClaudeAdapter.js.map +1 -1
  5. package/dist/adapters/claude/ClaudeInvocationUsageTracker.d.ts +17 -0
  6. package/dist/adapters/claude/ClaudeInvocationUsageTracker.d.ts.map +1 -0
  7. package/dist/adapters/claude/ClaudeInvocationUsageTracker.js +79 -0
  8. package/dist/adapters/claude/ClaudeInvocationUsageTracker.js.map +1 -0
  9. package/dist/adapters/claude/ClaudeStreamParser.d.ts +19 -0
  10. package/dist/adapters/claude/ClaudeStreamParser.d.ts.map +1 -1
  11. package/dist/adapters/claude/ClaudeStreamParser.js +92 -0
  12. package/dist/adapters/claude/ClaudeStreamParser.js.map +1 -1
  13. package/dist/adapters/claude/claudeCommand.js +1 -1
  14. package/dist/adapters/claude/claudeCommand.js.map +1 -1
  15. package/dist/adapters/codex/CodexAdapter.d.ts +20 -0
  16. package/dist/adapters/codex/CodexAdapter.d.ts.map +1 -0
  17. package/dist/adapters/codex/CodexAdapter.js +313 -0
  18. package/dist/adapters/codex/CodexAdapter.js.map +1 -0
  19. package/dist/adapters/hermes/HermesAdapter.d.ts +10 -1
  20. package/dist/adapters/hermes/HermesAdapter.d.ts.map +1 -1
  21. package/dist/adapters/hermes/HermesAdapter.js +225 -21
  22. package/dist/adapters/hermes/HermesAdapter.js.map +1 -1
  23. package/dist/adapters/hermes/HermesInvocationUsageReader.d.ts +26 -0
  24. package/dist/adapters/hermes/HermesInvocationUsageReader.d.ts.map +1 -0
  25. package/dist/adapters/hermes/HermesInvocationUsageReader.js +128 -0
  26. package/dist/adapters/hermes/HermesInvocationUsageReader.js.map +1 -0
  27. package/dist/adapters/openclaw/OpenClawAdapter.d.ts +12 -37
  28. package/dist/adapters/openclaw/OpenClawAdapter.d.ts.map +1 -1
  29. package/dist/adapters/openclaw/OpenClawAdapter.js +191 -635
  30. package/dist/adapters/openclaw/OpenClawAdapter.js.map +1 -1
  31. package/dist/core/AgentAdapter.d.ts +75 -1
  32. package/dist/core/AgentAdapter.d.ts.map +1 -1
  33. package/dist/core/AgentAdapter.js +25 -0
  34. package/dist/core/AgentAdapter.js.map +1 -1
  35. package/dist/core/RuntimeDetector.d.ts.map +1 -1
  36. package/dist/core/RuntimeDetector.js +52 -19
  37. package/dist/core/RuntimeDetector.js.map +1 -1
  38. package/dist/core/WinMatrixAgentClient.d.ts +30 -4
  39. package/dist/core/WinMatrixAgentClient.d.ts.map +1 -1
  40. package/dist/core/WinMatrixAgentClient.js +122 -12
  41. package/dist/core/WinMatrixAgentClient.js.map +1 -1
  42. package/dist/index.d.ts +15 -20
  43. package/dist/index.d.ts.map +1 -1
  44. package/dist/index.js +8 -19
  45. package/dist/index.js.map +1 -1
  46. package/dist/observability/WorkstationTokenUsageRecorder.d.ts +54 -0
  47. package/dist/observability/WorkstationTokenUsageRecorder.d.ts.map +1 -0
  48. package/dist/observability/WorkstationTokenUsageRecorder.js +264 -0
  49. package/dist/observability/WorkstationTokenUsageRecorder.js.map +1 -0
  50. package/dist/utils/envSanitizer.d.ts +38 -0
  51. package/dist/utils/envSanitizer.d.ts.map +1 -0
  52. package/dist/utils/envSanitizer.js +94 -0
  53. package/dist/utils/envSanitizer.js.map +1 -0
  54. package/dist/utils/errorClassification.d.ts +26 -0
  55. package/dist/utils/errorClassification.d.ts.map +1 -0
  56. package/dist/utils/errorClassification.js +52 -0
  57. package/dist/utils/errorClassification.js.map +1 -0
  58. package/dist/utils/processUtils.d.ts +10 -0
  59. package/dist/utils/processUtils.d.ts.map +1 -1
  60. package/dist/utils/processUtils.js +42 -9
  61. package/dist/utils/processUtils.js.map +1 -1
  62. package/dist/utils/resumeFallback.d.ts +4 -0
  63. package/dist/utils/resumeFallback.d.ts.map +1 -0
  64. package/dist/utils/resumeFallback.js +65 -0
  65. package/dist/utils/resumeFallback.js.map +1 -0
  66. package/package.json +8 -4
  67. package/dist/adapters/openclaw/unwrapOpenClawPayloads.d.ts +0 -6
  68. package/dist/adapters/openclaw/unwrapOpenClawPayloads.d.ts.map +0 -1
  69. package/dist/adapters/openclaw/unwrapOpenClawPayloads.js +0 -24
  70. package/dist/adapters/openclaw/unwrapOpenClawPayloads.js.map +0 -1
  71. package/dist/runtime/DualRuntimeBridge.d.ts +0 -38
  72. package/dist/runtime/DualRuntimeBridge.d.ts.map +0 -1
  73. package/dist/runtime/DualRuntimeBridge.js +0 -321
  74. package/dist/runtime/DualRuntimeBridge.js.map +0 -1
  75. package/dist/runtime/bridgeConfigLoader.d.ts +0 -14
  76. package/dist/runtime/bridgeConfigLoader.d.ts.map +0 -1
  77. package/dist/runtime/bridgeConfigLoader.js +0 -133
  78. package/dist/runtime/bridgeConfigLoader.js.map +0 -1
  79. package/dist/runtime/bridgeConfigTypes.d.ts +0 -26
  80. package/dist/runtime/bridgeConfigTypes.d.ts.map +0 -1
  81. package/dist/runtime/bridgeConfigTypes.js +0 -6
  82. package/dist/runtime/bridgeConfigTypes.js.map +0 -1
  83. package/dist/runtime/bridgeHome.d.ts +0 -19
  84. package/dist/runtime/bridgeHome.d.ts.map +0 -1
  85. package/dist/runtime/bridgeHome.js +0 -61
  86. package/dist/runtime/bridgeHome.js.map +0 -1
  87. package/dist/runtime/bridgeReconnectPolicy.d.ts +0 -8
  88. package/dist/runtime/bridgeReconnectPolicy.d.ts.map +0 -1
  89. package/dist/runtime/bridgeReconnectPolicy.js +0 -16
  90. package/dist/runtime/bridgeReconnectPolicy.js.map +0 -1
  91. package/dist/runtime/bridgeTaskJournal.d.ts +0 -7
  92. package/dist/runtime/bridgeTaskJournal.d.ts.map +0 -1
  93. package/dist/runtime/bridgeTaskJournal.js +0 -66
  94. package/dist/runtime/bridgeTaskJournal.js.map +0 -1
  95. package/dist/runtime/localRuntimeAvailabilityMonitor.d.ts +0 -22
  96. package/dist/runtime/localRuntimeAvailabilityMonitor.d.ts.map +0 -1
  97. package/dist/runtime/localRuntimeAvailabilityMonitor.js +0 -81
  98. package/dist/runtime/localRuntimeAvailabilityMonitor.js.map +0 -1
  99. package/dist/runtime/runDualRuntimeBridge.d.ts +0 -2
  100. package/dist/runtime/runDualRuntimeBridge.d.ts.map +0 -1
  101. package/dist/runtime/runDualRuntimeBridge.js +0 -32
  102. package/dist/runtime/runDualRuntimeBridge.js.map +0 -1
@@ -1,46 +1,31 @@
1
1
  /**
2
- * OpenClawAdapter — 通过 WebSocket-RPC 连接本地 OpenClaw Gateway (port 18789)
2
+ * OpenClawAdapter — spawn `openclaw agent --json` CLI,通过 Gateway 执行 agent turn。
3
3
  *
4
- * OpenClaw 是 Gateway 架构的智能体运行时,通过 WS-RPC 协议通信。
5
- * 协议:connect.challenge connect 握手 chat.send 发消息 chat/agent 事件流
4
+ * WS-RPC gateway 模式改为 CLI spawn 模式(对齐 CodexAdapter/HermesAdapter):
5
+ * - 绕过 gateway protocol mismatch + operator scope 问题(CLI 内部处理 auth)
6
+ * - `--json` 结构化输出(精确解析,不猜正则)
7
+ * - 非流式(一次性 JSON,等进程退出后 yield result)
6
8
  *
7
- * 使用 client.id: 'gateway-client' + client.mode: 'backend' 作为 loopback backend 客户端,
8
- * 无需 device identity 签名。
9
+ * CLI 命令:`openclaw agent --json --agent <id> [--session-id <sid>] -m <prompt>`
9
10
  */
10
11
  import type { AgentAdapter, AdapterEvent, AdapterMeta, AgentTaskContext, HealthStatus, SessionListOptions, SessionListResult, SessionDetailOptions, SessionDetailResult } from '../../core/AgentAdapter.js';
11
- /**
12
- * 从 agent assistant 事件 data 提取文本。
13
- * 参照 server 端 extractAgentAssistantText — 覆盖 text/delta/content/chunk/messages/message/payload/result/response/output。
14
- */
15
- export declare function extractAgentAssistantText(data: Record<string, unknown>): string;
16
- export declare function extractTextFromMessages(messages: unknown): string;
17
- export declare function extractTextDeep(obj: unknown, depth?: number): string;
18
- /**
19
- * sessionKey 编码: agent:<agentId>:direct:<sessionKey>(参照 server toAgentSessionKey)。
20
- * 若 sessionKey 已是 agent: 格式则不重复编码,避免双重包装。
21
- */
22
- export declare function toAgentSessionKey(sessionKey: string, agentId: string): string;
23
12
  export interface OpenClawAdapterOptions {
24
- gatewayHost?: string;
25
- gatewayPort?: number;
26
- token?: string;
13
+ /** openclaw CLI 可执行路径(默认 'openclaw',对齐 CodexAdapter.codexPath / HermesAdapter.hermesPath) */
14
+ openclawPath?: string;
27
15
  /** WinMatrix MCP Bridge URL */
28
16
  mcpBridgeUrl?: string;
29
17
  /** MCP Bridge 认证 token(Agent 级长期凭证) */
30
18
  mcpApiKey?: string;
31
- /** Agent ID,用于 sessionKey 路由 */
19
+ /** Agent ID,用于 --agent 参数和 sessionKey 编码 */
32
20
  agentId?: string;
33
21
  }
34
22
  export declare class OpenClawAdapter implements AgentAdapter {
35
23
  readonly meta: AdapterMeta;
36
- private gatewayHost;
37
- private gatewayPort;
38
- private token?;
24
+ private openclawPath;
39
25
  private mcpBridgeUrl?;
40
26
  private mcpApiKey?;
41
27
  private agentId?;
42
28
  constructor(config?: Record<string, unknown>);
43
- private get gatewayUrl();
44
29
  /**
45
30
  * Write MCP server config to openclaw.json, merge with existing keys.
46
31
  *
@@ -50,6 +35,7 @@ export declare class OpenClawAdapter implements AgentAdapter {
50
35
  */
51
36
  private writeMCPConfig;
52
37
  execute(task: AgentTaskContext, signal?: AbortSignal): AsyncGenerator<AdapterEvent>;
38
+ private executeOnce;
53
39
  discoverSkills(context: {
54
40
  workDir?: string;
55
41
  }): Promise<Array<{
@@ -59,19 +45,8 @@ export declare class OpenClawAdapter implements AgentAdapter {
59
45
  category?: string;
60
46
  }>>;
61
47
  private scanSkillDir;
62
- private authenticatedConnect;
63
- /**
64
- * Generic sendRequest — temporary onMessage handler pattern.
65
- * Used by healthCheck/listSessions/getSession (short-lived connections).
66
- */
67
- private sendRequest;
68
- /**
69
- * Send a request using a pendingRequests map (persistent handler multiplexing).
70
- * Used by execute() to multiplex req/res with event streaming on the same ws.
71
- */
72
- private sendRequestViaMap;
73
48
  healthCheck(): Promise<HealthStatus>;
74
49
  listSessions(options: SessionListOptions): Promise<SessionListResult>;
75
- getSession(sessionId: string, options?: SessionDetailOptions): Promise<SessionDetailResult>;
50
+ getSession(sessionId: string, options: SessionDetailOptions): Promise<SessionDetailResult>;
76
51
  }
77
52
  //# sourceMappingURL=OpenClawAdapter.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"OpenClawAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/openclaw/OpenClawAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAwGpC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA2B/E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAYjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAY/D;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7E;AAID,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAYxB;IAEF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAU5C,OAAO,KAAK,UAAU,GAErB;IAID;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAiCf,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC;IAgPpF,cAAc,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA4B/I,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,oBAAoB;IA2F5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAwCnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqBnB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAiBpC,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiCrE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAkEtG"}
1
+ {"version":3,"file":"OpenClawAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/openclaw/OpenClawAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAmDpC,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAgBxB;IAEF,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAU5C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAiCf,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC;YAI3E,WAAW;IA6HpB,cAAc,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA4B/I,OAAO,CAAC,YAAY;IAsBd,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAwBpC,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyCrE,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAgBhC"}