@cicctencent/agent-core 0.1.70 → 0.1.73

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 (151) hide show
  1. package/dist/cjs/a2a/client.d.ts +39 -11
  2. package/dist/cjs/a2a/client.d.ts.map +1 -1
  3. package/dist/cjs/a2a/client.js +69 -22
  4. package/dist/cjs/a2a/client.js.map +1 -1
  5. package/dist/cjs/a2a/rest-client.d.ts +35 -9
  6. package/dist/cjs/a2a/rest-client.d.ts.map +1 -1
  7. package/dist/cjs/a2a/rest-client.js +65 -18
  8. package/dist/cjs/a2a/rest-client.js.map +1 -1
  9. package/dist/cjs/a2a/rest-runner.d.ts +6 -0
  10. package/dist/cjs/a2a/rest-runner.d.ts.map +1 -1
  11. package/dist/cjs/a2a/rest-runner.js +19 -7
  12. package/dist/cjs/a2a/rest-runner.js.map +1 -1
  13. package/dist/cjs/a2a/runner.d.ts +6 -0
  14. package/dist/cjs/a2a/runner.d.ts.map +1 -1
  15. package/dist/cjs/a2a/runner.js +24 -7
  16. package/dist/cjs/a2a/runner.js.map +1 -1
  17. package/dist/cjs/index.d.ts +5 -2
  18. package/dist/cjs/index.d.ts.map +1 -1
  19. package/dist/cjs/index.js +15 -10
  20. package/dist/cjs/index.js.map +1 -1
  21. package/dist/cjs/interaction/service.d.ts +14 -0
  22. package/dist/cjs/interaction/service.d.ts.map +1 -1
  23. package/dist/cjs/interaction/service.js +114 -31
  24. package/dist/cjs/interaction/service.js.map +1 -1
  25. package/dist/cjs/interaction/store.d.ts +1 -0
  26. package/dist/cjs/interaction/store.d.ts.map +1 -1
  27. package/dist/cjs/interaction/store.js +10 -0
  28. package/dist/cjs/interaction/store.js.map +1 -1
  29. package/dist/cjs/interaction/types.d.ts +5 -1
  30. package/dist/cjs/interaction/types.d.ts.map +1 -1
  31. package/dist/cjs/interaction/types.js.map +1 -1
  32. package/dist/cjs/llm/debug.d.ts.map +1 -1
  33. package/dist/cjs/llm/debug.js +4 -1
  34. package/dist/cjs/llm/debug.js.map +1 -1
  35. package/dist/cjs/mcp/base-client.d.ts +19 -4
  36. package/dist/cjs/mcp/base-client.d.ts.map +1 -1
  37. package/dist/cjs/mcp/base-client.js +28 -8
  38. package/dist/cjs/mcp/base-client.js.map +1 -1
  39. package/dist/cjs/mcp/http-client.d.ts +5 -5
  40. package/dist/cjs/mcp/http-client.d.ts.map +1 -1
  41. package/dist/cjs/mcp/http-client.js +26 -21
  42. package/dist/cjs/mcp/http-client.js.map +1 -1
  43. package/dist/cjs/mcp/proxy-agent.d.ts +2 -50
  44. package/dist/cjs/mcp/proxy-agent.d.ts.map +1 -1
  45. package/dist/cjs/mcp/proxy-agent.js +12 -174
  46. package/dist/cjs/mcp/proxy-agent.js.map +1 -1
  47. package/dist/cjs/mcp/stdio-client.d.ts +1 -1
  48. package/dist/cjs/mcp/stdio-client.d.ts.map +1 -1
  49. package/dist/cjs/mcp/stdio-client.js +1 -1
  50. package/dist/cjs/mcp/stdio-client.js.map +1 -1
  51. package/dist/cjs/mcp/types.d.ts +8 -2
  52. package/dist/cjs/mcp/types.d.ts.map +1 -1
  53. package/dist/cjs/tool/ask-user.d.ts.map +1 -1
  54. package/dist/cjs/tool/ask-user.js +2 -0
  55. package/dist/cjs/tool/ask-user.js.map +1 -1
  56. package/dist/cjs/tool/delegate.d.ts +12 -1
  57. package/dist/cjs/tool/delegate.d.ts.map +1 -1
  58. package/dist/cjs/tool/delegate.js +21 -5
  59. package/dist/cjs/tool/delegate.js.map +1 -1
  60. package/dist/cjs/utils/header-vars.d.ts +18 -0
  61. package/dist/cjs/utils/header-vars.d.ts.map +1 -0
  62. package/dist/cjs/utils/header-vars.js +71 -0
  63. package/dist/cjs/utils/header-vars.js.map +1 -0
  64. package/dist/cjs/utils/proxy-agent.d.ts +53 -0
  65. package/dist/cjs/utils/proxy-agent.d.ts.map +1 -0
  66. package/dist/cjs/utils/proxy-agent.js +154 -0
  67. package/dist/cjs/utils/proxy-agent.js.map +1 -0
  68. package/dist/cjs/utils/proxy.d.ts +53 -0
  69. package/dist/cjs/utils/proxy.d.ts.map +1 -0
  70. package/dist/cjs/utils/proxy.js +148 -0
  71. package/dist/cjs/utils/proxy.js.map +1 -0
  72. package/dist/cjs/utils/system-proxy.d.ts +15 -0
  73. package/dist/cjs/utils/system-proxy.d.ts.map +1 -0
  74. package/dist/cjs/utils/system-proxy.js +133 -0
  75. package/dist/cjs/utils/system-proxy.js.map +1 -0
  76. package/dist/esm/a2a/client.d.ts +39 -11
  77. package/dist/esm/a2a/client.d.ts.map +1 -1
  78. package/dist/esm/a2a/client.js +69 -22
  79. package/dist/esm/a2a/client.js.map +1 -1
  80. package/dist/esm/a2a/rest-client.d.ts +35 -9
  81. package/dist/esm/a2a/rest-client.d.ts.map +1 -1
  82. package/dist/esm/a2a/rest-client.js +65 -18
  83. package/dist/esm/a2a/rest-client.js.map +1 -1
  84. package/dist/esm/a2a/rest-runner.d.ts +6 -0
  85. package/dist/esm/a2a/rest-runner.d.ts.map +1 -1
  86. package/dist/esm/a2a/rest-runner.js +19 -7
  87. package/dist/esm/a2a/rest-runner.js.map +1 -1
  88. package/dist/esm/a2a/runner.d.ts +6 -0
  89. package/dist/esm/a2a/runner.d.ts.map +1 -1
  90. package/dist/esm/a2a/runner.js +24 -7
  91. package/dist/esm/a2a/runner.js.map +1 -1
  92. package/dist/esm/index.d.ts +5 -2
  93. package/dist/esm/index.d.ts.map +1 -1
  94. package/dist/esm/index.js +3 -1
  95. package/dist/esm/index.js.map +1 -1
  96. package/dist/esm/interaction/service.d.ts +14 -0
  97. package/dist/esm/interaction/service.d.ts.map +1 -1
  98. package/dist/esm/interaction/service.js +114 -31
  99. package/dist/esm/interaction/service.js.map +1 -1
  100. package/dist/esm/interaction/store.d.ts +1 -0
  101. package/dist/esm/interaction/store.d.ts.map +1 -1
  102. package/dist/esm/interaction/store.js +10 -0
  103. package/dist/esm/interaction/store.js.map +1 -1
  104. package/dist/esm/interaction/types.d.ts +5 -1
  105. package/dist/esm/interaction/types.d.ts.map +1 -1
  106. package/dist/esm/interaction/types.js.map +1 -1
  107. package/dist/esm/llm/debug.d.ts.map +1 -1
  108. package/dist/esm/llm/debug.js +4 -1
  109. package/dist/esm/llm/debug.js.map +1 -1
  110. package/dist/esm/mcp/base-client.d.ts +19 -4
  111. package/dist/esm/mcp/base-client.d.ts.map +1 -1
  112. package/dist/esm/mcp/base-client.js +28 -8
  113. package/dist/esm/mcp/base-client.js.map +1 -1
  114. package/dist/esm/mcp/http-client.d.ts +5 -5
  115. package/dist/esm/mcp/http-client.d.ts.map +1 -1
  116. package/dist/esm/mcp/http-client.js +25 -20
  117. package/dist/esm/mcp/http-client.js.map +1 -1
  118. package/dist/esm/mcp/proxy-agent.d.ts +2 -50
  119. package/dist/esm/mcp/proxy-agent.d.ts.map +1 -1
  120. package/dist/esm/mcp/proxy-agent.js +7 -168
  121. package/dist/esm/mcp/proxy-agent.js.map +1 -1
  122. package/dist/esm/mcp/stdio-client.d.ts +1 -1
  123. package/dist/esm/mcp/stdio-client.d.ts.map +1 -1
  124. package/dist/esm/mcp/stdio-client.js +1 -1
  125. package/dist/esm/mcp/stdio-client.js.map +1 -1
  126. package/dist/esm/mcp/types.d.ts +8 -2
  127. package/dist/esm/mcp/types.d.ts.map +1 -1
  128. package/dist/esm/tool/ask-user.d.ts.map +1 -1
  129. package/dist/esm/tool/ask-user.js +2 -0
  130. package/dist/esm/tool/ask-user.js.map +1 -1
  131. package/dist/esm/tool/delegate.d.ts +12 -1
  132. package/dist/esm/tool/delegate.d.ts.map +1 -1
  133. package/dist/esm/tool/delegate.js +21 -5
  134. package/dist/esm/tool/delegate.js.map +1 -1
  135. package/dist/esm/utils/header-vars.d.ts +18 -0
  136. package/dist/esm/utils/header-vars.d.ts.map +1 -0
  137. package/dist/esm/utils/header-vars.js +65 -0
  138. package/dist/esm/utils/header-vars.js.map +1 -0
  139. package/dist/esm/utils/proxy-agent.d.ts +53 -0
  140. package/dist/esm/utils/proxy-agent.d.ts.map +1 -0
  141. package/dist/esm/utils/proxy-agent.js +115 -0
  142. package/dist/esm/utils/proxy-agent.js.map +1 -0
  143. package/dist/esm/utils/proxy.d.ts +53 -0
  144. package/dist/esm/utils/proxy.d.ts.map +1 -0
  145. package/dist/esm/utils/proxy.js +109 -0
  146. package/dist/esm/utils/proxy.js.map +1 -0
  147. package/dist/esm/utils/system-proxy.d.ts +15 -0
  148. package/dist/esm/utils/system-proxy.d.ts.map +1 -0
  149. package/dist/esm/utils/system-proxy.js +128 -0
  150. package/dist/esm/utils/system-proxy.js.map +1 -0
  151. package/package.json +1 -1
@@ -0,0 +1,53 @@
1
+ /** ProxyAgent 类型(undici 内置,Node 18+ 可直接 import;用 any 避免未声明依赖的 TS 错误) */
2
+ export type ProxyAgentType = any;
3
+ /** 代理模式:system=系统代理, custom=自定义, direct=直连 */
4
+ export type ProxyMode = 'system' | 'custom' | 'direct';
5
+ /** 单分类代理配置 */
6
+ export interface ProxyCategoryConfig {
7
+ mode: ProxyMode;
8
+ /** mode='custom' 时的代理 URL */
9
+ url?: string;
10
+ }
11
+ /** 分类代理设置(LLM / MCP / Fetch 各自独立) */
12
+ export interface ProxySettings {
13
+ llm: ProxyCategoryConfig;
14
+ mcp: ProxyCategoryConfig;
15
+ fetch: ProxyCategoryConfig;
16
+ }
17
+ /** 默认代理设置:全部分类走系统代理 */
18
+ export declare const DEFAULT_PROXY_SETTINGS: ProxySettings;
19
+ /**
20
+ * 根据分类代理配置解析代理 URL
21
+ *
22
+ * - `mode='system'`:自动检测系统代理(环境变量 + macOS scutil + Windows 注册表)
23
+ * - `mode='custom'`:使用用户指定的代理 URL
24
+ * - `mode='direct'`:不走代理,返回 undefined
25
+ *
26
+ * 返回代理 URL 字符串,需配合 createProxyDispatcher() 使用。
27
+ * 支持 http://、https://、socks4://、socks5:// 协议。
28
+ *
29
+ * @param category 分类代理配置
30
+ * @param label 日志标签(如 'LLM', 'MCP', 'Fetch')
31
+ * @returns 代理 URL 字符串,无代理时返回 undefined
32
+ */
33
+ export declare function resolveProxyAgentForCategory(category?: ProxyCategoryConfig, label?: string): string | undefined;
34
+ /**
35
+ * 根据代理 URL 创建 undici ProxyAgent dispatcher
36
+ *
37
+ * Node.js 原生 fetch() 不支持 RequestInit.proxy 选项,
38
+ * 需通过 dispatcher 传入 undici 的 ProxyAgent 来正确使用代理。
39
+ *
40
+ * 使用动态 import('undici') 避免浏览器环境静态解析失败。
41
+ * 仅在传入 proxyUrl 时才创建 ProxyAgent,无代理时返回 undefined。
42
+ *
43
+ * @param proxyUrl 代理 URL(如 http://127.0.0.1:7890),undefined 时不创建
44
+ * @returns ProxyAgent dispatcher 或 undefined
45
+ */
46
+ export declare function createProxyDispatcher(proxyUrl?: string): Promise<ProxyAgentType | undefined>;
47
+ /**
48
+ * 获取分类代理的有效 URL(用于 axios 等 HTTP 客户端)
49
+ *
50
+ * @returns 代理 URL 字符串,无代理时返回 undefined
51
+ */
52
+ export declare function resolveProxyUrlForCategory(category?: ProxyCategoryConfig): string | undefined;
53
+ //# sourceMappingURL=proxy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../src/utils/proxy.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC;AAIjC,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,mBAAmB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,uBAAuB;AACvB,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAQF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,CAAC,EAAE,mBAAmB,EAC9B,KAAK,SAAU,GACd,MAAM,GAAG,SAAS,CA8BpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAYlG;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAY7F"}
@@ -0,0 +1,148 @@
1
+ "use strict";
2
+ // ============================================================
3
+ // Proxy — 通用 HTTP/HTTPS/SOCKS 代理解析工具(跨 MCP / A2A / LLM 的基础能力)
4
+ // ============================================================
5
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ var desc = Object.getOwnPropertyDescriptor(m, k);
8
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
+ desc = { enumerable: true, get: function() { return m[k]; } };
10
+ }
11
+ Object.defineProperty(o, k2, desc);
12
+ }) : (function(o, m, k, k2) {
13
+ if (k2 === undefined) k2 = k;
14
+ o[k2] = m[k];
15
+ }));
16
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
17
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
18
+ }) : function(o, v) {
19
+ o["default"] = v;
20
+ });
21
+ var __importStar = (this && this.__importStar) || (function () {
22
+ var ownKeys = function(o) {
23
+ ownKeys = Object.getOwnPropertyNames || function (o) {
24
+ var ar = [];
25
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
26
+ return ar;
27
+ };
28
+ return ownKeys(o);
29
+ };
30
+ return function (mod) {
31
+ if (mod && mod.__esModule) return mod;
32
+ var result = {};
33
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
34
+ __setModuleDefault(result, mod);
35
+ return result;
36
+ };
37
+ })();
38
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
39
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
40
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
41
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
42
+ });
43
+ }
44
+ return path;
45
+ };
46
+ Object.defineProperty(exports, "__esModule", { value: true });
47
+ exports.DEFAULT_PROXY_SETTINGS = void 0;
48
+ exports.resolveProxyAgentForCategory = resolveProxyAgentForCategory;
49
+ exports.createProxyDispatcher = createProxyDispatcher;
50
+ exports.resolveProxyUrlForCategory = resolveProxyUrlForCategory;
51
+ /** 默认代理设置:全部分类走系统代理 */
52
+ exports.DEFAULT_PROXY_SETTINGS = {
53
+ llm: { mode: 'system' },
54
+ mcp: { mode: 'system' },
55
+ fetch: { mode: 'system' },
56
+ };
57
+ // ---- Proxy URL 解析 ----
58
+ // 系统代理检测(环境变量 + macOS scutil + Windows 注册表)为通用基础能力,
59
+ // 统一放在 utils/system-proxy 中,供 LLM / MCP / Fetch 各分类复用。
60
+ const system_proxy_ts_1 = require("./system-proxy.js");
61
+ /**
62
+ * 根据分类代理配置解析代理 URL
63
+ *
64
+ * - `mode='system'`:自动检测系统代理(环境变量 + macOS scutil + Windows 注册表)
65
+ * - `mode='custom'`:使用用户指定的代理 URL
66
+ * - `mode='direct'`:不走代理,返回 undefined
67
+ *
68
+ * 返回代理 URL 字符串,需配合 createProxyDispatcher() 使用。
69
+ * 支持 http://、https://、socks4://、socks5:// 协议。
70
+ *
71
+ * @param category 分类代理配置
72
+ * @param label 日志标签(如 'LLM', 'MCP', 'Fetch')
73
+ * @returns 代理 URL 字符串,无代理时返回 undefined
74
+ */
75
+ function resolveProxyAgentForCategory(category, label = 'Proxy') {
76
+ if (!category)
77
+ return undefined;
78
+ let proxyUrl;
79
+ switch (category.mode) {
80
+ case 'direct':
81
+ console.debug(`[${label}] proxy mode: direct (no proxy)`);
82
+ return undefined;
83
+ case 'custom':
84
+ if (!category.url) {
85
+ console.debug(`[${label}] proxy mode: custom but no URL configured, falling back to direct`);
86
+ return undefined;
87
+ }
88
+ proxyUrl = category.url;
89
+ break;
90
+ case 'system':
91
+ default:
92
+ proxyUrl = (0, system_proxy_ts_1.getSystemProxyUrl)();
93
+ if (!proxyUrl) {
94
+ console.debug(`[${label}] proxy mode: system, no system proxy detected`);
95
+ return undefined;
96
+ }
97
+ break;
98
+ }
99
+ console.debug(`[${label}] using proxy: ${proxyUrl}`);
100
+ return proxyUrl;
101
+ }
102
+ /**
103
+ * 根据代理 URL 创建 undici ProxyAgent dispatcher
104
+ *
105
+ * Node.js 原生 fetch() 不支持 RequestInit.proxy 选项,
106
+ * 需通过 dispatcher 传入 undici 的 ProxyAgent 来正确使用代理。
107
+ *
108
+ * 使用动态 import('undici') 避免浏览器环境静态解析失败。
109
+ * 仅在传入 proxyUrl 时才创建 ProxyAgent,无代理时返回 undefined。
110
+ *
111
+ * @param proxyUrl 代理 URL(如 http://127.0.0.1:7890),undefined 时不创建
112
+ * @returns ProxyAgent dispatcher 或 undefined
113
+ */
114
+ async function createProxyDispatcher(proxyUrl) {
115
+ if (!proxyUrl)
116
+ return undefined;
117
+ try {
118
+ // 动态 import undici(Node 18+ 内置),用变量规避静态模块解析错误
119
+ const modName = 'undici';
120
+ const { ProxyAgent } = await Promise.resolve(`${__rewriteRelativeImportExtension(modName)}`).then(s => __importStar(require(s)));
121
+ if (!ProxyAgent)
122
+ return undefined;
123
+ return new ProxyAgent({ uri: proxyUrl });
124
+ }
125
+ catch {
126
+ console.warn(`[Proxy] Failed to create ProxyAgent for ${proxyUrl}, falling back to direct`);
127
+ return undefined;
128
+ }
129
+ }
130
+ /**
131
+ * 获取分类代理的有效 URL(用于 axios 等 HTTP 客户端)
132
+ *
133
+ * @returns 代理 URL 字符串,无代理时返回 undefined
134
+ */
135
+ function resolveProxyUrlForCategory(category) {
136
+ if (!category)
137
+ return undefined;
138
+ switch (category.mode) {
139
+ case 'direct':
140
+ return undefined;
141
+ case 'custom':
142
+ return category.url || undefined;
143
+ case 'system':
144
+ default:
145
+ return (0, system_proxy_ts_1.getSystemProxyUrl)();
146
+ }
147
+ }
148
+ //# sourceMappingURL=proxy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../../src/utils/proxy.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmD/D,oEAiCC;AAcD,sDAYC;AAOD,gEAYC;AAzGD,uBAAuB;AACV,QAAA,sBAAsB,GAAkB;IACnD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;CAC1B,CAAC;AAEF,yBAAyB;AAEzB,oDAAoD;AACpD,uDAAuD;AACvD,uDAAsD;AAEtD;;;;;;;;;;;;;GAaG;AACH,SAAgB,4BAA4B,CAC1C,QAA8B,EAC9B,KAAK,GAAG,OAAO;IAEf,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,QAA4B,CAAC;IAEjC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,iCAAiC,CAAC,CAAC;YAC1D,OAAO,SAAS,CAAC;QAEnB,KAAK,QAAQ;YACX,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,oEAAoE,CAAC,CAAC;gBAC7F,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC;YACxB,MAAM;QAER,KAAK,QAAQ,CAAC;QACd;YACE,QAAQ,GAAG,IAAA,mCAAiB,GAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,gDAAgD,CAAC,CAAC;gBACzE,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM;IACV,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,qBAAqB,CAAC,QAAiB;IAC3D,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,8CAA8C;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC;QACzB,MAAM,EAAE,UAAU,EAAE,GAAG,0DAAa,OAAO,wCAAQ,CAAC;QACpD,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,2CAA2C,QAAQ,0BAA0B,CAAC,CAAC;QAC5F,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,0BAA0B,CAAC,QAA8B;IACvE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,GAAG,IAAI,SAAS,CAAC;QACnC,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,IAAA,mCAAiB,GAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * 从 Windows 注册表读取系统代理配置
3
+ * 仅 Windows 平台生效,其他平台返回 undefined。
4
+ * 结果带 TTL 缓存,避免重复查询注册表,同时保证系统设置变更后生效。
5
+ */
6
+ export declare function getWindowsSystemProxy(): string | undefined;
7
+ /** 清除系统代理缓存(应用内修改代理设置、或希望强制重新探测时调用) */
8
+ export declare function clearSystemProxyCache(): void;
9
+ /**
10
+ * 获取系统代理 URL
11
+ * 优先级:环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
12
+ * 环境变量每次实时读取(即时生效、零成本);OS 探测结果带 TTL 缓存 + 显式失效。
13
+ */
14
+ export declare function getSystemProxyUrl(): string | undefined;
15
+ //# sourceMappingURL=system-proxy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system-proxy.d.ts","sourceRoot":"","sources":["../../../src/utils/system-proxy.ts"],"names":[],"mappings":"AAwEA;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CA8B1D;AAED,uCAAuC;AACvC,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAStD"}
@@ -0,0 +1,133 @@
1
+ "use strict";
2
+ // ============================================================
3
+ // System Proxy — 通用系统代理检测工具(跨平台,与业务模块无关的基础方法)
4
+ // ============================================================
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.getWindowsSystemProxy = getWindowsSystemProxy;
7
+ exports.clearSystemProxyCache = clearSystemProxyCache;
8
+ exports.getSystemProxyUrl = getSystemProxyUrl;
9
+ const child_process_1 = require("child_process");
10
+ // ---- 缓存策略 ----
11
+ // macOS scutil / Windows 注册表探测都比较重(spawn 进程 / 读注册表),不能每次调用都执行;
12
+ // 但「永久缓存」又会导致系统级代理被直接修改后无法生效。
13
+ // 因此采用「TTL 缓存 + 显式失效」:
14
+ // - 性能:TTL 内复用结果,不重复探测;
15
+ // - 时效:超过 TTL 自动重新探测,确保系统设置变更(非经本应用)后最终生效;
16
+ // - 即时:应用内修改代理设置会调用 clearSystemProxyCache() 立即失效。
17
+ // 环境变量始终实时读取(零成本、即时生效),不参与缓存。
18
+ const OS_PROXY_TTL_MS = 30_000;
19
+ // ---- macOS 系统代理检测 ----
20
+ let _macProxy = null;
21
+ let _macProbed = false;
22
+ let _macTs = 0;
23
+ /**
24
+ * 从 macOS 系统偏好设置读取代理配置
25
+ * 通过 scutil --proxy 查询,仅 macOS 平台生效。
26
+ * 结果带 TTL 缓存,兼顾性能与「系统设置变更后生效」。
27
+ */
28
+ function getMacOSSystemProxy() {
29
+ if (_macProbed && Date.now() - _macTs < OS_PROXY_TTL_MS)
30
+ return _macProxy ?? undefined;
31
+ let url;
32
+ if (process.platform === 'darwin') {
33
+ try {
34
+ const output = (0, child_process_1.execSync)('scutil --proxy', { encoding: 'utf-8', timeout: 3000 });
35
+ const parsed = {};
36
+ // scutil 输出格式: " Key : Value"
37
+ for (const line of output.split('\n')) {
38
+ const m = line.trim().match(/^(\w+)\s*:\s*(.+)$/);
39
+ if (m)
40
+ parsed[m[1]] = m[2].trim();
41
+ }
42
+ // 优先 HTTPS 代理,其次 HTTP 代理,最后 SOCKS 代理
43
+ if (parsed['HTTPSEnable'] === '1' && parsed['HTTPSProxy']) {
44
+ const port = parsed['HTTPSPort'] || '443';
45
+ url = `http://${parsed['HTTPSProxy']}:${port}`;
46
+ console.debug(`[Proxy] macOS system HTTPS proxy detected: ${url}`);
47
+ }
48
+ else if (parsed['HTTPEnable'] === '1' && parsed['HTTPProxy']) {
49
+ const port = parsed['HTTPPort'] || '80';
50
+ url = `http://${parsed['HTTPProxy']}:${port}`;
51
+ console.debug(`[Proxy] macOS system HTTP proxy detected: ${url}`);
52
+ }
53
+ else if (parsed['SOCKSEnable'] === '1' && parsed['SOCKSProxy']) {
54
+ const port = parsed['SOCKSPort'] || '1080';
55
+ url = `socks5://${parsed['SOCKSProxy']}:${port}`;
56
+ console.debug(`[Proxy] macOS system SOCKS proxy detected: ${url}`);
57
+ }
58
+ }
59
+ catch {
60
+ url = undefined;
61
+ }
62
+ }
63
+ _macProxy = url ?? null;
64
+ _macProbed = true;
65
+ _macTs = Date.now();
66
+ return _macProxy ?? undefined;
67
+ }
68
+ // ---- Windows 系统代理检测 ----
69
+ let _winProxy = null;
70
+ let _winProbed = false;
71
+ let _winTs = 0;
72
+ /**
73
+ * 从 Windows 注册表读取系统代理配置
74
+ * 仅 Windows 平台生效,其他平台返回 undefined。
75
+ * 结果带 TTL 缓存,避免重复查询注册表,同时保证系统设置变更后生效。
76
+ */
77
+ function getWindowsSystemProxy() {
78
+ if (_winProbed && Date.now() - _winTs < OS_PROXY_TTL_MS)
79
+ return _winProxy ?? undefined;
80
+ let url;
81
+ if (process.platform === 'win32') {
82
+ try {
83
+ const regPath = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
84
+ const output = (0, child_process_1.execSync)(`reg query "${regPath}" /v ProxyEnable`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
85
+ const enabledMatch = output.match(/ProxyEnable\s+REG_DWORD\s+0x(\d+)/i);
86
+ if (!enabledMatch || enabledMatch[1] === '0') {
87
+ url = undefined;
88
+ }
89
+ else {
90
+ const serverOutput = (0, child_process_1.execSync)(`reg query "${regPath}" /v ProxyServer`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
91
+ const serverMatch = serverOutput.match(/ProxyServer\s+REG_SZ\s+(.+)/i);
92
+ if (serverMatch) {
93
+ const proxyServer = serverMatch[1].trim();
94
+ // Windows 代理可能是 ip:port 格式,需要补全协议
95
+ url = proxyServer.includes('://') ? proxyServer : `http://${proxyServer}`;
96
+ console.debug(`[Proxy] Windows system proxy detected: ${url}`);
97
+ }
98
+ }
99
+ }
100
+ catch {
101
+ url = undefined;
102
+ }
103
+ }
104
+ _winProxy = url ?? null;
105
+ _winProbed = true;
106
+ _winTs = Date.now();
107
+ return _winProxy ?? undefined;
108
+ }
109
+ /** 清除系统代理缓存(应用内修改代理设置、或希望强制重新探测时调用) */
110
+ function clearSystemProxyCache() {
111
+ _macProxy = null;
112
+ _macProbed = false;
113
+ _macTs = 0;
114
+ _winProxy = null;
115
+ _winProbed = false;
116
+ _winTs = 0;
117
+ }
118
+ /**
119
+ * 获取系统代理 URL
120
+ * 优先级:环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
121
+ * 环境变量每次实时读取(即时生效、零成本);OS 探测结果带 TTL 缓存 + 显式失效。
122
+ */
123
+ function getSystemProxyUrl() {
124
+ return process.env.HTTPS_PROXY
125
+ || process.env.https_proxy
126
+ || process.env.HTTP_PROXY
127
+ || process.env.http_proxy
128
+ || process.env.ALL_PROXY
129
+ || process.env.all_proxy
130
+ || getMacOSSystemProxy()
131
+ || getWindowsSystemProxy();
132
+ }
133
+ //# sourceMappingURL=system-proxy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system-proxy.js","sourceRoot":"","sources":["../../../src/utils/system-proxy.ts"],"names":[],"mappings":"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"}
@@ -12,8 +12,8 @@ export interface AuthConfig {
12
12
  /** apiKey/custom 模式下的 header 名称(如 X-API-Key) */
13
13
  name?: string;
14
14
  }
15
- /** 将 AuthConfig 转为 HTTP 请求头 */
16
- export declare function buildAuthHeaders(auth?: AuthConfig | null): Record<string, string>;
15
+ /** 将 AuthConfig 转为 HTTP 请求头(value 支持 ${vars.x} / ${env.x} 模板) */
16
+ export declare function buildAuthHeaders(auth?: AuthConfig | null, vars?: Record<string, unknown>): Record<string, string>;
17
17
  export interface AgentDebugTrace {
18
18
  step: string;
19
19
  title: string;
@@ -42,6 +42,8 @@ export interface AgentDebugTrace {
42
42
  code?: string;
43
43
  cause?: unknown;
44
44
  };
45
+ /** 实际使用的代理地址(由客户端注入;system 模式解析后为具体 URL,direct/none 为 undefined) */
46
+ proxy?: string;
45
47
  }
46
48
  export type AgentDebugTraceHandler = (trace: AgentDebugTrace) => void;
47
49
  /** A2A 客户端配置 */
@@ -54,12 +56,20 @@ export interface A2AClientOptions {
54
56
  chunkTimeout?: number;
55
57
  /** 自定义 fetch 实现(默认使用 globalThis.fetch) */
56
58
  fetch?: typeof fetch;
57
- /** 自定义请求头(如认证 token */
59
+ /** 自定义请求头(如认证 token);值支持 ${vars.x} / ${env.x} 模板 */
58
60
  headers?: Record<string, string>;
59
- /** 认证配置(自动转为 headers,与 headers 合并) */
61
+ /** 认证配置(自动转为 headers,与 headers 合并);value 支持 ${vars.x} / ${env.x} 模板 */
60
62
  auth?: AuthConfig;
63
+ /**
64
+ * 运行时变量(如 { userId, userMail })。
65
+ * 用于解析 headers / auth 中的 ${vars.x} 占位符。
66
+ * 也可在每次调用(sendTask / sendTaskStreaming / getTask / cancelTask / discoverAgent)时按需覆盖。
67
+ */
68
+ vars?: Record<string, unknown>;
61
69
  /** 调试 trace 回调;未传时保持原始执行流程 */
62
70
  onDebugTrace?: AgentDebugTraceHandler;
71
+ /** 代理 URL(如 http://127.0.0.1:7890),传入后通过 undici ProxyAgent 走代理,不传则直连 */
72
+ proxy?: string;
63
73
  }
64
74
  /**
65
75
  * 轻量 A2A 协议客户端
@@ -74,16 +84,34 @@ export declare class A2AClient {
74
84
  private connectTimeout;
75
85
  private chunkTimeout;
76
86
  private fetchFn;
77
- private headers;
87
+ /** 鉴权配置(构造时保存,发送时结合运行时变量解析) */
88
+ private authConfig?;
89
+ /** 自定义请求头模板(值可含 ${vars.x} / ${env.x} 占位符,发送时解析) */
90
+ private headerTemplates;
91
+ /** 默认运行时变量 */
92
+ private contextVars?;
78
93
  private onDebugTrace?;
94
+ private proxyUrl?;
95
+ private proxyDispatcher?;
79
96
  constructor(options?: A2AClientOptions);
97
+ /**
98
+ * 更新运行时变量(如 userId / userMail)。
99
+ * 后续请求将使用更新后的值解析 ${vars.x} 占位符。
100
+ */
101
+ setContextVars(vars: Record<string, unknown>): void;
102
+ /** 合并运行时变量:构造时默认 vars + 本次调用传入的 vars(后者优先) */
103
+ private mergeVars;
104
+ /** 解析本次请求生效的请求头(合并 auth + 自定义头,并应用 ${vars.x}/${env.x} 模板) */
105
+ private resolveHeaders;
106
+ /** 对请求体参数进行变量插值(${vars.x}/${env.x}/${x}),深拷贝不改原对象 */
107
+ private resolveBody;
80
108
  /**
81
109
  * 通过 base URL 发现远程 Agent
82
110
  * 自动请求 /.well-known/agent.json 并返回 AgentCard
83
111
  */
84
- discoverAgent(baseUrl: string): Promise<A2AAgentCard>;
112
+ discoverAgent(baseUrl: string, vars?: Record<string, unknown>): Promise<A2AAgentCard>;
85
113
  /** 同步发送任务(tasks/send),等待完成后返回完整 Task */
86
- sendTask(agentUrl: string, params: A2ASendTaskParams): Promise<A2ATask>;
114
+ sendTask(agentUrl: string, params: A2ASendTaskParams, vars?: Record<string, unknown>): Promise<A2ATask>;
87
115
  /**
88
116
  * 流式发送任务(tasks/sendSubscribe),通过回调逐步接收事件
89
117
  * 返回最后一个 status-update 事件(通常为 final 事件),用于提取最终结果
@@ -96,18 +124,18 @@ export declare class A2AClient {
96
124
  *
97
125
  * @param abortSignal 外部中止信号(前端断开时中止 SSE 读取)
98
126
  */
99
- sendTaskStreaming(agentUrl: string, params: A2ASendTaskParams, onEvent?: (event: A2ATaskEvent) => void, abortSignal?: AbortSignal): Promise<A2ATaskEvent | null>;
127
+ sendTaskStreaming(agentUrl: string, params: A2ASendTaskParams, onEvent?: (event: A2ATaskEvent) => void, abortSignal?: AbortSignal, vars?: Record<string, unknown>): Promise<A2ATaskEvent | null>;
100
128
  /** 查询任务状态(tasks/get) */
101
- getTask(agentUrl: string, taskId: string, historyLength?: number): Promise<A2ATask>;
129
+ getTask(agentUrl: string, taskId: string, historyLength?: number, vars?: Record<string, unknown>): Promise<A2ATask>;
102
130
  /** 取消任务(tasks/cancel) */
103
- cancelTask(agentUrl: string, taskId: string): Promise<A2ATask>;
131
+ cancelTask(agentUrl: string, taskId: string, vars?: Record<string, unknown>): Promise<A2ATask>;
104
132
  /** 解析 Agent Card URL */
105
133
  private resolveAgentCardUrl;
106
134
  /** 发送 JSON-RPC 请求 */
107
135
  private jsonRpcCall;
108
136
  /** 带 chunkTimeout 的 reader.read()(每次读取单独计时,收到数据即重置) */
109
137
  private readChunkWithTimeout;
110
- /** 带超时的 fetch */
138
+ /** 带超时的 fetch(自动应用代理 dispatcher,无代理时直连) */
111
139
  private fetchWithTimeout;
112
140
  private emitDebugTrace;
113
141
  private headersToObject;
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAGZ,iBAAiB,EACjB,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/C,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3F,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5J,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9E,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEtE,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uEAAuE;IACvE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAe;IAC9B,+BAA+B;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAyB;IAChD,cAAc;IACd,OAAO,CAAC,WAAW,CAAC,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAE7B,OAAO,GAAE,gBAAqB;IAY1C;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInD,8CAA8C;IAC9C,OAAO,CAAC,SAAS;IAIjB,6DAA6D;IAC7D,OAAO,CAAC,cAAc;IAQtB,qDAAqD;IACrD,OAAO,CAAC,WAAW;IAMnB;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB3F,wCAAwC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7G;;;;;;;;;;;OAWG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,WAAW,EACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyJ/B,wBAAwB;IAClB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzH,yBAAyB;IACnB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpG,wBAAwB;IACxB,OAAO,CAAC,mBAAmB;IAM3B,qBAAqB;YACP,WAAW;IAoEzB,uDAAuD;YACzC,oBAAoB;IAgBlC,2CAA2C;YAC7B,gBAAgB;IAmB9B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;CAe3B"}