@easynet/agent-runtime 1.0.2 → 1.0.4

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 (205) hide show
  1. package/.github/workflows/ci.yml +9 -24
  2. package/.github/workflows/release.yml +38 -26
  3. package/agent-runtime/.github/workflows/ci.yml +69 -0
  4. package/agent-runtime/.github/workflows/release.yml +118 -0
  5. package/agent-runtime/.releaserc.cjs +26 -0
  6. package/agent-runtime/config/agent.deep.yaml +25 -0
  7. package/agent-runtime/config/agent.react.yaml +24 -0
  8. package/agent-runtime/example/basic-usage.ts +49 -0
  9. package/agent-runtime/package-lock.json +7740 -0
  10. package/agent-runtime/package.json +49 -0
  11. package/agent-runtime/pnpm-lock.yaml +3712 -0
  12. package/agent-runtime/scripts/resolve-deps.js +54 -0
  13. package/agent-runtime/src/agents/deep-agent.ts +165 -0
  14. package/agent-runtime/src/agents/react-agent.helpers.ts +227 -0
  15. package/agent-runtime/src/agents/react-agent.ts +584 -0
  16. package/{src → agent-runtime/src/agents}/sub-agent.ts +2 -2
  17. package/agent-runtime/src/cli/args.ts +15 -0
  18. package/agent-runtime/src/cli/event-listener.ts +162 -0
  19. package/agent-runtime/src/cli/interactive.ts +144 -0
  20. package/agent-runtime/src/cli/runtime.ts +31 -0
  21. package/agent-runtime/src/cli/spinner.ts +23 -0
  22. package/agent-runtime/src/cli/terminal-render.ts +322 -0
  23. package/agent-runtime/src/cli/types.ts +33 -0
  24. package/agent-runtime/src/cli.ts +134 -0
  25. package/agent-runtime/src/config/helpers.ts +179 -0
  26. package/agent-runtime/src/config/index.ts +245 -0
  27. package/agent-runtime/src/config/types.ts +62 -0
  28. package/agent-runtime/src/core/context.ts +266 -0
  29. package/agent-runtime/src/index.ts +55 -0
  30. package/agent-runtime/tsconfig.json +18 -0
  31. package/apps/imessagebot/README.md +38 -0
  32. package/apps/imessagebot/config/.agent/cache/easynet/agent-tool-buildin/0.0.45/README.md +33 -0
  33. package/apps/imessagebot/config/.agent/cache/easynet/agent-tool-buildin/0.0.45/package-lock.json +15257 -0
  34. package/apps/imessagebot/config/.agent/cache/easynet/agent-tool-buildin/0.0.45/package.json +55 -0
  35. package/apps/imessagebot/config/agents/deep/agent.yaml +31 -0
  36. package/apps/imessagebot/config/agents/react/agent.yaml +58 -0
  37. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.43/README.md +33 -0
  38. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.43/package-lock.json +15457 -0
  39. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.43/package.json +55 -0
  40. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.46/README.md +33 -0
  41. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.46/package-lock.json +15257 -0
  42. package/apps/imessagebot/config/agents/shared/.agent/cache/easynet/agent-tool-buildin/0.0.46/package.json +62 -0
  43. package/apps/imessagebot/config/agents/shared/memory.yaml +31 -0
  44. package/apps/imessagebot/config/agents/shared/model.yaml +23 -0
  45. package/apps/imessagebot/config/agents/shared/tool.yaml +13 -0
  46. package/apps/imessagebot/config/app.yaml +14 -0
  47. package/apps/imessagebot/package-lock.json +53695 -0
  48. package/apps/imessagebot/package.json +41 -0
  49. package/apps/imessagebot/pnpm-lock.yaml +1589 -0
  50. package/apps/imessagebot/scripts/resolve-deps.js +41 -0
  51. package/apps/imessagebot/scripts/test-llm.mjs +27 -0
  52. package/apps/imessagebot/scripts/validate-tools-config.mjs +174 -0
  53. package/apps/imessagebot/src/config.ts +76 -0
  54. package/apps/imessagebot/src/context.ts +35 -0
  55. package/apps/imessagebot/src/index.ts +17 -0
  56. package/apps/imessagebot/tsconfig.json +18 -0
  57. package/apps/itermbot/.github/workflows/ci.yml +61 -0
  58. package/apps/itermbot/.github/workflows/release.yml +80 -0
  59. package/apps/itermbot/.releaserc.cjs +26 -0
  60. package/apps/itermbot/README.md +82 -0
  61. package/apps/itermbot/config/app.yaml +29 -0
  62. package/apps/itermbot/config/tsconfig.json +18 -0
  63. package/apps/itermbot/macos_disk_usage_agent_plan.md +244 -0
  64. package/apps/itermbot/package-lock.json +53697 -0
  65. package/apps/itermbot/package.json +57 -0
  66. package/apps/itermbot/pnpm-lock.yaml +3966 -0
  67. package/apps/itermbot/scripts/patch-buildin-cache.sh +25 -0
  68. package/apps/itermbot/scripts/resolve-deps.js +41 -0
  69. package/apps/itermbot/scripts/test-llm.mjs +32 -0
  70. package/apps/itermbot/skills/command-explain-and-guard/SKILL.md +39 -0
  71. package/apps/itermbot/skills/command-explain-and-guard/handler.js +86 -0
  72. package/apps/itermbot/skills/disk-usage-investigate/SKILL.md +44 -0
  73. package/apps/itermbot/skills/disk-usage-investigate/handler.js +12 -0
  74. package/apps/itermbot/skills/gpu-ssh-monitor/SKILL.md +64 -0
  75. package/apps/itermbot/skills/repo-triage/SKILL.md +40 -0
  76. package/apps/itermbot/skills/repo-triage/handler.js +56 -0
  77. package/apps/itermbot/skills/test-failure-diagnose/SKILL.md +43 -0
  78. package/apps/itermbot/skills/test-failure-diagnose/handler.js +107 -0
  79. package/apps/itermbot/src/config.ts +95 -0
  80. package/apps/itermbot/src/context.ts +35 -0
  81. package/apps/itermbot/src/index.ts +223 -0
  82. package/apps/itermbot/src/iterm/session-hint.ts +40 -0
  83. package/apps/itermbot/src/iterm/target-routing.ts +419 -0
  84. package/apps/itermbot/src/startup/colors.ts +317 -0
  85. package/apps/itermbot/src/startup/diagnostics.ts +97 -0
  86. package/apps/itermbot/src/startup/ui.ts +141 -0
  87. package/config/agent.deep.yaml +25 -0
  88. package/config/agent.react.yaml +24 -0
  89. package/dist/agents/deep-agent.d.ts +37 -0
  90. package/dist/agents/deep-agent.d.ts.map +1 -0
  91. package/dist/agents/deep-agent.js +115 -0
  92. package/dist/agents/deep-agent.js.map +1 -0
  93. package/dist/agents/react-agent.d.ts +40 -0
  94. package/dist/agents/react-agent.d.ts.map +1 -0
  95. package/dist/agents/react-agent.helpers.d.ts +40 -0
  96. package/dist/agents/react-agent.helpers.d.ts.map +1 -0
  97. package/dist/agents/react-agent.helpers.js +196 -0
  98. package/dist/agents/react-agent.helpers.js.map +1 -0
  99. package/dist/agents/react-agent.js +400 -0
  100. package/dist/agents/react-agent.js.map +1 -0
  101. package/dist/agents/sub-agent.d.ts +34 -0
  102. package/dist/agents/sub-agent.d.ts.map +1 -0
  103. package/dist/agents/sub-agent.js +53 -0
  104. package/dist/agents/sub-agent.js.map +1 -0
  105. package/dist/cli/args.d.ts +8 -0
  106. package/dist/cli/args.d.ts.map +1 -0
  107. package/dist/cli/args.js +9 -0
  108. package/dist/cli/args.js.map +1 -0
  109. package/dist/cli/event-listener.d.ts +3 -0
  110. package/dist/cli/event-listener.d.ts.map +1 -0
  111. package/dist/cli/event-listener.js +131 -0
  112. package/dist/cli/event-listener.js.map +1 -0
  113. package/dist/cli/interactive.d.ts +4 -0
  114. package/dist/cli/interactive.d.ts.map +1 -0
  115. package/dist/cli/interactive.js +118 -0
  116. package/dist/cli/interactive.js.map +1 -0
  117. package/dist/cli/runtime.d.ts +8 -0
  118. package/dist/cli/runtime.d.ts.map +1 -0
  119. package/dist/cli/runtime.js +27 -0
  120. package/dist/cli/runtime.js.map +1 -0
  121. package/dist/cli/spinner.d.ts +2 -0
  122. package/dist/cli/spinner.d.ts.map +1 -0
  123. package/dist/cli/spinner.js +22 -0
  124. package/dist/cli/spinner.js.map +1 -0
  125. package/dist/cli/terminal-render.d.ts +7 -0
  126. package/dist/cli/terminal-render.d.ts.map +1 -0
  127. package/dist/cli/terminal-render.js +282 -0
  128. package/dist/cli/terminal-render.js.map +1 -0
  129. package/dist/cli/types.d.ts +29 -0
  130. package/dist/cli/types.d.ts.map +1 -0
  131. package/dist/cli/types.js +3 -0
  132. package/dist/cli/types.js.map +1 -0
  133. package/dist/cli.d.ts +4 -41
  134. package/dist/cli.d.ts.map +1 -1
  135. package/dist/cli.js +84 -588
  136. package/dist/cli.js.map +1 -1
  137. package/dist/config/helpers.d.ts +6 -0
  138. package/dist/config/helpers.d.ts.map +1 -0
  139. package/dist/config/helpers.js +164 -0
  140. package/dist/config/helpers.js.map +1 -0
  141. package/dist/config/index.d.ts +15 -0
  142. package/dist/config/index.d.ts.map +1 -0
  143. package/dist/config/index.js +160 -0
  144. package/dist/config/index.js.map +1 -0
  145. package/dist/config/types.d.ts +57 -0
  146. package/dist/config/types.d.ts.map +1 -0
  147. package/dist/config/types.js +2 -0
  148. package/dist/config/types.js.map +1 -0
  149. package/dist/context.d.ts +8 -69
  150. package/dist/context.d.ts.map +1 -1
  151. package/dist/context.js +44 -24
  152. package/dist/context.js.map +1 -1
  153. package/dist/core/context.d.ts +66 -0
  154. package/dist/core/context.d.ts.map +1 -0
  155. package/dist/core/context.js +149 -0
  156. package/dist/core/context.js.map +1 -0
  157. package/dist/deep-agent.d.ts +5 -2
  158. package/dist/deep-agent.d.ts.map +1 -1
  159. package/dist/deep-agent.js +44 -11
  160. package/dist/deep-agent.js.map +1 -1
  161. package/dist/index.d.ts +6 -6
  162. package/dist/index.d.ts.map +1 -1
  163. package/dist/index.js +6 -6
  164. package/dist/index.js.map +1 -1
  165. package/dist/middleware/malformed-tool-call-middleware.d.ts +8 -0
  166. package/dist/middleware/malformed-tool-call-middleware.d.ts.map +1 -0
  167. package/dist/middleware/malformed-tool-call-middleware.js +191 -0
  168. package/dist/middleware/malformed-tool-call-middleware.js.map +1 -0
  169. package/dist/react-agent.d.ts +2 -2
  170. package/dist/react-agent.d.ts.map +1 -1
  171. package/dist/react-agent.js +28 -9
  172. package/dist/react-agent.js.map +1 -1
  173. package/package.json +1 -1
  174. package/scripts/resolve-deps.js +54 -0
  175. package/src/agents/deep-agent.ts +165 -0
  176. package/src/agents/react-agent.helpers.ts +227 -0
  177. package/src/agents/react-agent.ts +584 -0
  178. package/src/agents/sub-agent.ts +82 -0
  179. package/src/cli/args.ts +15 -0
  180. package/src/cli/event-listener.ts +162 -0
  181. package/src/cli/interactive.ts +144 -0
  182. package/src/cli/runtime.ts +31 -0
  183. package/src/cli/spinner.ts +23 -0
  184. package/src/cli/terminal-render.ts +322 -0
  185. package/src/cli/types.ts +33 -0
  186. package/src/cli.ts +91 -702
  187. package/src/config/helpers.ts +179 -0
  188. package/src/config/index.ts +245 -0
  189. package/src/config/types.ts +62 -0
  190. package/src/core/context.ts +266 -0
  191. package/src/index.ts +13 -11
  192. package/src/middleware/malformed-tool-call-middleware.ts +239 -0
  193. package/src/types/markdown-it-terminal.d.ts +4 -0
  194. package/src/types/marked-terminal.d.ts +16 -0
  195. package/dist/config.d.ts +0 -86
  196. package/dist/config.d.ts.map +0 -1
  197. package/dist/config.js +0 -84
  198. package/dist/config.js.map +0 -1
  199. package/src/config.ts +0 -177
  200. package/src/context.ts +0 -247
  201. package/src/deep-agent.ts +0 -104
  202. package/src/react-agent.ts +0 -576
  203. /package/{src → agent-runtime/src/middleware}/malformed-tool-call-middleware.ts +0 -0
  204. /package/{src → agent-runtime/src/types}/markdown-it-terminal.d.ts +0 -0
  205. /package/{src → agent-runtime/src/types}/marked-terminal.d.ts +0 -0
@@ -0,0 +1,115 @@
1
+ import { createDeepAgent as createDeepAgentRuntime, StateBackend, } from "deepagents";
2
+ import { asObject, extractLastMessageText } from "@easynet/agent-common";
3
+ function readAppString(appConfig, key) {
4
+ const app = asObject(appConfig);
5
+ const value = app?.[key];
6
+ return typeof value === "string" ? value : undefined;
7
+ }
8
+ function readAppBoolean(appConfig, key) {
9
+ const app = asObject(appConfig);
10
+ const value = app?.[key];
11
+ return typeof value === "boolean" ? value : undefined;
12
+ }
13
+ function pickFirstAgentName(config) {
14
+ return Object.keys(config?.app?.agent ?? {})[0];
15
+ }
16
+ function pickAgentConfig(config, agentName) {
17
+ if (!agentName)
18
+ return undefined;
19
+ return config?.app?.agent?.[agentName];
20
+ }
21
+ function resolveConfig(ctx, options) {
22
+ const agentName = options.agentName ?? pickFirstAgentName(ctx.config);
23
+ const configDeep = pickAgentConfig(ctx.config, agentName);
24
+ const appConfig = ctx.config.app;
25
+ return {
26
+ recursionLimit: options.recursionLimit ?? configDeep?.recursionLimit,
27
+ printSteps: options.printSteps ?? configDeep?.printSteps ?? readAppBoolean(appConfig, "printSteps") ?? false,
28
+ fallbackText: options.fallbackText ?? configDeep?.fallbackText ?? readAppString(appConfig, "fallbackText") ?? "",
29
+ commandWindowLabel: options.commandWindowLabel ?? configDeep?.commandWindowLabel ?? readAppString(appConfig, "commandWindowLabel"),
30
+ namespace: configDeep?.memory?.namespace,
31
+ autoWriteMemory: options.autoWriteMemory ?? (configDeep?.memory?.auto_write ?? true),
32
+ autoWriteScope: configDeep?.memory?.auto_write_scope ?? "thread",
33
+ autoWriteMaxChars: configDeep?.memory?.auto_write_max_chars ?? 2400,
34
+ autoWriteUser: configDeep?.memory?.auto_write_user ?? true,
35
+ autoWriteAssistant: configDeep?.memory?.auto_write_assistant ?? true,
36
+ systemPrompt: options.systemPrompt ?? configDeep?.systemPrompt,
37
+ };
38
+ }
39
+ function resolveFinalText(text, fallbackText, commandWindowLabel) {
40
+ if (text.trim().length > 0)
41
+ return text;
42
+ if (fallbackText.trim().length > 0)
43
+ return fallbackText;
44
+ return commandWindowLabel ? `Command sent to ${commandWindowLabel}.` : text;
45
+ }
46
+ async function autoWriteIfNeeded(ctx, config, userMessage, finalText, publish) {
47
+ if (!config.namespace || !config.autoWriteMemory)
48
+ return;
49
+ const scope = config.autoWriteScope === "auto" ? "thread" : config.autoWriteScope;
50
+ const writeItems = [];
51
+ if (config.autoWriteUser && userMessage.trim().length > 0)
52
+ writeItems.push(`[user]\n${userMessage.trim()}`);
53
+ if (config.autoWriteAssistant && finalText.trim().length > 0)
54
+ writeItems.push(`[assistant]\n${finalText.trim()}`);
55
+ const content = writeItems.join("\n\n").slice(0, Math.max(0, config.autoWriteMaxChars));
56
+ if (!content.length)
57
+ return;
58
+ try {
59
+ publish("agent.deep.memory.write.start", "deep-agent", "memory", { type: scope, auto: true });
60
+ await ctx.memory.memorize(config.namespace, scope, content);
61
+ publish("agent.deep.memory.write.done", "memory", "deep-agent", { type: scope, auto: true });
62
+ }
63
+ catch (err) {
64
+ publish("agent.deep.memory.write.error", "memory", "deep-agent", {
65
+ auto: true,
66
+ error: err instanceof Error ? err.message : String(err),
67
+ });
68
+ }
69
+ }
70
+ function updateConversation(history, userMessage, finalText) {
71
+ history.push({ role: "user", content: userMessage });
72
+ if (finalText.trim().length > 0)
73
+ history.push({ role: "assistant", content: finalText });
74
+ if (history.length > 24)
75
+ history.splice(0, history.length - 24);
76
+ }
77
+ function createAgent(ctx, systemPrompt) {
78
+ return createDeepAgentRuntime({
79
+ model: ctx.llm,
80
+ tools: ctx.tools,
81
+ backend: (config) => new StateBackend(config),
82
+ systemPrompt,
83
+ });
84
+ }
85
+ export async function createDeepAgent(ctx, options = {}) {
86
+ const publish = (name, from, to, payload) => {
87
+ ctx.events.publish({ name, from, to, payload });
88
+ };
89
+ publish("agent.deep.init.start", "app", "deep-agent");
90
+ const config = resolveConfig(ctx, options);
91
+ const agent = createAgent(ctx, config.systemPrompt);
92
+ const conversationHistory = [];
93
+ publish("agent.deep.init.done", "deep-agent", "app");
94
+ return {
95
+ agent,
96
+ async run(userMessage) {
97
+ publish("agent.deep.run.start", "user", "deep-agent", { userMessage });
98
+ if (config.printSteps)
99
+ console.error(`[deep] user: ${userMessage}`);
100
+ const runnable = typeof config.recursionLimit === "number"
101
+ ? (agent.withConfig?.({ recursionLimit: config.recursionLimit }) ?? agent)
102
+ : agent;
103
+ const result = await runnable.invoke({ messages: [...conversationHistory, { role: "user", content: userMessage }] });
104
+ const messages = result?.messages ?? result;
105
+ const finalText = resolveFinalText(extractLastMessageText(result), config.fallbackText, config.commandWindowLabel);
106
+ updateConversation(conversationHistory, userMessage, finalText);
107
+ await autoWriteIfNeeded(ctx, config, userMessage, finalText, publish);
108
+ if (config.printSteps)
109
+ console.error(`[deep] assistant: ${finalText}`);
110
+ publish("agent.deep.run.done", "deep-agent", "user", { text: finalText });
111
+ return { text: finalText, messages };
112
+ },
113
+ };
114
+ }
115
+ //# sourceMappingURL=deep-agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deep-agent.js","sourceRoot":"","sources":["../../src/agents/deep-agent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { BaseAgentConfig, BotContext } from "../core/context.js";
2
+ export interface ReactAgentRuntime {
3
+ agent: unknown;
4
+ run: (userMessage: string) => Promise<{
5
+ text: string;
6
+ messages?: unknown;
7
+ }>;
8
+ remember: (content: string, type?: "thread" | "cross_thread" | "knowledge" | "auto") => Promise<void>;
9
+ }
10
+ export interface ReactAgentOptions {
11
+ agentName?: string;
12
+ systemPrompt?: string;
13
+ namespace?: string;
14
+ topK?: number;
15
+ budgetTokens?: number;
16
+ maxSteps?: number;
17
+ printSteps?: boolean;
18
+ fallbackText?: string;
19
+ commandWindowLabel?: string;
20
+ middleware?: unknown[];
21
+ autoWriteMemory?: boolean;
22
+ ptc?: {
23
+ enabled?: boolean;
24
+ maxRetries?: number;
25
+ };
26
+ }
27
+ export { printReactSteps } from "./react-agent.helpers.js";
28
+ export declare function createReactAgent<TConfig extends BaseAgentConfig>(ctx: BotContext<TConfig>, options?: ReactAgentOptions): {
29
+ agent: {
30
+ invoke: (input: unknown, cfg?: {
31
+ recursionLimit?: number;
32
+ }) => Promise<unknown>;
33
+ };
34
+ run(userMessage: string): Promise<{
35
+ text: string;
36
+ messages?: unknown;
37
+ }>;
38
+ remember(content: string, type?: "thread" | "cross_thread" | "knowledge" | "auto"): Promise<void>;
39
+ };
40
+ //# sourceMappingURL=react-agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react-agent.d.ts","sourceRoot":"","sources":["../../src/agents/react-agent.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAgBtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5E,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvG;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AA0cD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,eAAe,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,iBAAsB;;gBAwBvF,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;YAAE,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC;;qBAMhF,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;sBAmCrD,MAAM,SAAQ,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM;EAazF"}
@@ -0,0 +1,40 @@
1
+ import type { BaseMessageLike } from "@langchain/core/messages";
2
+ import type { LanguageModelLike } from "@langchain/core/language_models/base";
3
+ import type { BaseAgentConfig } from "../core/context.js";
4
+ export interface MessageLike {
5
+ type?: string;
6
+ role?: string;
7
+ content?: string | unknown;
8
+ tool_calls?: Array<{
9
+ name?: string;
10
+ args?: unknown;
11
+ id?: string;
12
+ }>;
13
+ name?: string;
14
+ tool_call_id?: string;
15
+ }
16
+ export interface ToolRunStats {
17
+ invoked: number;
18
+ succeeded: number;
19
+ failed: number;
20
+ lastError?: string;
21
+ }
22
+ export declare function inferMemoryTypeByStructure(content: string): "thread" | "cross_thread";
23
+ export declare function inferMemoryTypeWithModel(llm: LanguageModelLike, content: string): Promise<"thread" | "cross_thread" | null>;
24
+ export declare function deriveFallbackTextFromMessages(messages: BaseMessageLike[], opts: {
25
+ fallbackText: string;
26
+ commandWindowLabel?: string;
27
+ }): string;
28
+ export declare function hasToolMessages(messages: unknown): boolean;
29
+ export declare function extractSchemaKeys(schema: unknown): string[];
30
+ export declare function buildPtcHint(input: {
31
+ taskIntent: string;
32
+ stats: ToolRunStats;
33
+ toolSignatures: string[];
34
+ }): string;
35
+ export declare function readAppString(appConfig: unknown, key: string): string | undefined;
36
+ export declare function readAppBoolean(appConfig: unknown, key: string): boolean | undefined;
37
+ export declare function pickFirstAgentName(config: BaseAgentConfig | undefined): string | undefined;
38
+ export declare function pickAgentConfig(config: BaseAgentConfig | undefined, agentName?: string): import("../index.js").AgentProfileConfig | undefined;
39
+ export declare function printReactSteps(messages: unknown): void;
40
+ //# sourceMappingURL=react-agent.helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react-agent.helpers.d.ts","sourceRoot":"","sources":["../../src/agents/react-agent.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAcrF;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,GAAG,cAAc,GAAG,IAAI,CAAC,CAwB3C;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,eAAe,EAAE,EAC3B,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,MAAM,CAuCR;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAQ1D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAY3D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAWjH;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAInF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE1F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,wDAGtF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA2CvD"}
@@ -0,0 +1,196 @@
1
+ import { asObject } from "@easynet/agent-common";
2
+ function toMessageText(content) {
3
+ if (typeof content === "string")
4
+ return content;
5
+ if (!Array.isArray(content))
6
+ return "";
7
+ return content
8
+ .map((block) => {
9
+ if (typeof block === "string")
10
+ return block;
11
+ if (typeof block === "object" && block !== null && "text" in block) {
12
+ const text = block.text;
13
+ return typeof text === "string" ? text : "";
14
+ }
15
+ return "";
16
+ })
17
+ .join("");
18
+ }
19
+ export function inferMemoryTypeByStructure(content) {
20
+ const text = content.trim();
21
+ if (!text)
22
+ return "thread";
23
+ const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
24
+ const duplicateRatio = lines.length > 0 ? 1 - new Set(lines).size / lines.length : 0;
25
+ const symbolCount = (text.match(/[^\p{L}\p{N}\s]/gu) ?? []).length;
26
+ const symbolRatio = symbolCount / Math.max(1, text.length);
27
+ if (text.length > 1200)
28
+ return "thread";
29
+ if (lines.length > 18)
30
+ return "thread";
31
+ if (duplicateRatio > 0.35)
32
+ return "thread";
33
+ if (symbolRatio > 0.22)
34
+ return "thread";
35
+ return "cross_thread";
36
+ }
37
+ export async function inferMemoryTypeWithModel(llm, content) {
38
+ const classifierPrompt = [
39
+ "Classify memory scope for an AI agent.",
40
+ "Return strict JSON only: {\"type\":\"thread|cross_thread\",\"confidence\":0..1}.",
41
+ "Decision policy:",
42
+ "- thread: temporary session context, command output, logs, transient task state, step-by-step investigation details.",
43
+ "- cross_thread: stable user preferences, durable profile facts, long-lived constraints reusable in future sessions.",
44
+ "Use semantic judgment, not keyword matching.",
45
+ ].join("\n");
46
+ try {
47
+ const response = await llm.invoke([
48
+ { role: "system", content: classifierPrompt },
49
+ { role: "user", content },
50
+ ]);
51
+ const text = toMessageText(response.content).trim();
52
+ const jsonBlob = text.match(/\{[\s\S]*\}/)?.[0] ?? text;
53
+ const parsed = JSON.parse(jsonBlob);
54
+ const type = parsed.type === "thread" || parsed.type === "cross_thread" ? parsed.type : null;
55
+ const confidence = typeof parsed.confidence === "number" ? parsed.confidence : 0;
56
+ return type && confidence >= 0.6 ? type : null;
57
+ }
58
+ catch {
59
+ return null;
60
+ }
61
+ }
62
+ export function deriveFallbackTextFromMessages(messages, opts) {
63
+ for (let i = messages.length - 1; i >= 0; i -= 1) {
64
+ const msg = messages[i];
65
+ const type = msg?.type ?? msg?.role ?? "";
66
+ if (type !== "tool" && !msg?.tool_call_id)
67
+ continue;
68
+ const raw = typeof msg.content === "string"
69
+ ? msg.content
70
+ : msg.content != null
71
+ ? String(msg.content)
72
+ : "";
73
+ if (!raw.trim())
74
+ continue;
75
+ try {
76
+ const parsed = JSON.parse(raw);
77
+ const summary = parsed.evidence?.find((item) => item?.summary)?.summary;
78
+ if (typeof summary === "string" && summary.trim())
79
+ return summary.trim();
80
+ const to = parsed.result?.to?.trim();
81
+ const serviceType = parsed.result?.serviceType?.trim();
82
+ if (to)
83
+ return serviceType ? `Sent ${serviceType} message to ${to}.` : `Sent message to ${to}.`;
84
+ const command = parsed.result?.command?.trim();
85
+ if (!command)
86
+ continue;
87
+ const windowId = parsed.result?.windowId;
88
+ const tabIndex = parsed.result?.tabIndex;
89
+ if (typeof windowId === "number" && typeof tabIndex === "number") {
90
+ return `Executed command in ${opts.commandWindowLabel ?? "window"} ${windowId}, tab ${tabIndex}: ${command}`;
91
+ }
92
+ return `Executed command: ${command}`;
93
+ }
94
+ catch {
95
+ return raw.length > 200 ? `${raw.slice(0, 200)}...` : raw;
96
+ }
97
+ }
98
+ return opts.fallbackText;
99
+ }
100
+ export function hasToolMessages(messages) {
101
+ const list = Array.isArray(messages) ? messages : [];
102
+ for (const item of list) {
103
+ const msg = item;
104
+ const type = msg?.type ?? msg?.role ?? "";
105
+ if (type === "tool" || Boolean(msg?.tool_call_id) || (msg?.tool_calls?.length ?? 0) > 0)
106
+ return true;
107
+ }
108
+ return false;
109
+ }
110
+ export function extractSchemaKeys(schema) {
111
+ if (!schema || typeof schema !== "object")
112
+ return [];
113
+ const rec = schema;
114
+ const properties = rec.properties;
115
+ if (properties && typeof properties === "object" && !Array.isArray(properties)) {
116
+ return Object.keys(properties);
117
+ }
118
+ const shape = rec.shape;
119
+ if (shape && typeof shape === "object" && !Array.isArray(shape)) {
120
+ return Object.keys(shape);
121
+ }
122
+ return [];
123
+ }
124
+ export function buildPtcHint(input) {
125
+ return [
126
+ "[PTC_FEEDBACK]",
127
+ `TaskIntent: ${input.taskIntent}`,
128
+ `ToolStats: invoked=${input.stats.invoked}, succeeded=${input.stats.succeeded}, failed=${input.stats.failed}`,
129
+ input.stats.lastError ? `LastToolError: ${input.stats.lastError}` : "",
130
+ "Action: Retry using available tools. Do not claim tools are unavailable.",
131
+ "Action: If previous tool args were invalid, correct arguments strictly by schema.",
132
+ "Action: If a tool is needed, emit a valid tool call instead of plain explanation.",
133
+ `AvailableTools: ${input.toolSignatures.join("; ")}`,
134
+ ].filter((line) => line.length > 0).join("\n");
135
+ }
136
+ export function readAppString(appConfig, key) {
137
+ const app = asObject(appConfig);
138
+ const value = app?.[key];
139
+ return typeof value === "string" ? value : undefined;
140
+ }
141
+ export function readAppBoolean(appConfig, key) {
142
+ const app = asObject(appConfig);
143
+ const value = app?.[key];
144
+ return typeof value === "boolean" ? value : undefined;
145
+ }
146
+ export function pickFirstAgentName(config) {
147
+ return Object.keys(config?.app?.agent ?? {})[0];
148
+ }
149
+ export function pickAgentConfig(config, agentName) {
150
+ if (!agentName)
151
+ return undefined;
152
+ return config?.app?.agent?.[agentName];
153
+ }
154
+ export function printReactSteps(messages) {
155
+ const list = Array.isArray(messages) ? messages : [];
156
+ let stepIndex = 0;
157
+ for (let i = 0; i < list.length; i += 1) {
158
+ const msg = list[i];
159
+ const type = msg?.type ?? msg?.role ?? "";
160
+ const content = msg?.content;
161
+ const contentStr = typeof content === "string"
162
+ ? content
163
+ : typeof content === "object" && content !== null && Array.isArray(content)
164
+ ? content.map((block) => block.text ?? JSON.stringify(block)).join("")
165
+ : content != null
166
+ ? String(content)
167
+ : "";
168
+ if (type === "human" || (type === "user" && !msg.tool_calls)) {
169
+ if (contentStr.trim())
170
+ console.error(`\n--- Step (user) ---\n${contentStr.trim()}`);
171
+ continue;
172
+ }
173
+ if (type === "ai" || type === "assistant") {
174
+ if (!msg.tool_calls?.length)
175
+ continue;
176
+ stepIndex += 1;
177
+ if (contentStr.trim())
178
+ console.error(`\n--- ReAct Step ${stepIndex}: Thought ---\n${contentStr.trim()}`);
179
+ for (const toolCall of msg.tool_calls) {
180
+ const name = toolCall?.name ?? "?";
181
+ const args = typeof toolCall?.args === "object" && toolCall?.args !== null
182
+ ? JSON.stringify(toolCall.args)
183
+ : String(toolCall?.args ?? "");
184
+ console.error(`--- ReAct Step ${stepIndex}: Action ---\n${name}(${args})`);
185
+ }
186
+ continue;
187
+ }
188
+ if (type === "tool" || msg?.tool_call_id) {
189
+ const toolName = msg?.name ?? "tool";
190
+ const observation = contentStr.length > 200 ? `${contentStr.slice(0, 200)}...` : contentStr;
191
+ console.error(`--- ReAct Step ${stepIndex}: Observation (${toolName}) ---\n${observation || "(empty)"}`);
192
+ }
193
+ }
194
+ console.error("");
195
+ }
196
+ //# sourceMappingURL=react-agent.helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react-agent.helpers.js","sourceRoot":"","sources":["../../src/agents/react-agent.helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAmBjD,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACnE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;YAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAE3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,cAAc,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,WAAW,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IACxC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAsB,EACtB,OAAe;IAEf,MAAM,gBAAgB,GAAG;QACvB,wCAAwC;QACxC,kFAAkF;QAClF,kBAAkB;QAClB,sHAAsH;QACtH,qHAAqH;QACrH,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE;YAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;SAC1B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,aAAa,CAAE,QAAkC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA6C,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,IAAI,IAAI,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAA2B,EAC3B,IAA2D;IAE3D,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAgB,CAAC;QACvC,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;QAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,EAAE,YAAY;YAAE,SAAS;QAEpD,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YACzC,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI;gBACnB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAAE,SAAS;QAE1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG5B,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC;YACxE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;YAEzE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACvD,IAAI,EAAE;gBAAE,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,WAAW,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,GAAG,CAAC;YAEhG,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;YACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjE,OAAO,uBAAuB,IAAI,CAAC,kBAAkB,IAAI,QAAQ,IAAI,QAAQ,SAAS,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC/G,CAAC;YACD,OAAO,qBAAqB,OAAO,EAAE,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,YAAY,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAmB,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;QAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,UAAqC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA4E;IACvG,OAAO;QACL,gBAAgB;QAChB,eAAe,KAAK,CAAC,UAAU,EAAE;QACjC,sBAAsB,KAAK,CAAC,KAAK,CAAC,OAAO,eAAe,KAAK,CAAC,KAAK,CAAC,SAAS,YAAY,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;QAC7G,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;QACtE,0EAA0E;QAC1E,mFAAmF;QACnF,mFAAmF;QACnF,mBAAmB,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACrD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAkB,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAkB,EAAE,GAAW;IAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAmC;IACpE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmC,EAAE,SAAkB;IACrF,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAgB,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAC;QAC7B,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ;YAC5C,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBACzE,CAAC,CAAE,OAA+B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/F,CAAC,CAAC,OAAO,IAAI,IAAI;oBACf,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACjB,CAAC,CAAC,EAAE,CAAC;QAEX,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,IAAI,UAAU,CAAC,IAAI,EAAE;gBAAE,OAAO,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM;gBAAE,SAAS;YACtC,SAAS,IAAI,CAAC,CAAC;YACf,IAAI,UAAU,CAAC,IAAI,EAAE;gBAAE,OAAO,CAAC,KAAK,CAAC,oBAAoB,SAAS,kBAAkB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzG,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,GAAG,CAAC;gBACnC,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ,IAAI,QAAQ,EAAE,IAAI,KAAK,IAAI;oBACxE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBACjC,OAAO,CAAC,KAAK,CAAC,kBAAkB,SAAS,iBAAiB,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;YAC7E,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,IAAI,MAAM,CAAC;YACrC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5F,OAAO,CAAC,KAAK,CAAC,kBAAkB,SAAS,kBAAkB,QAAQ,UAAU,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC"}