skyloom 1.13.5 → 1.13.7

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 (195) hide show
  1. package/.github/workflows/ci.yml +36 -36
  2. package/README.md +220 -159
  3. package/config/providers.yaml +39 -39
  4. package/config/skills/api_integrator/SKILL.md +15 -15
  5. package/config/skills/arch_designer/SKILL.md +13 -13
  6. package/config/skills/ci_cd_manager/SKILL.md +14 -14
  7. package/config/skills/code_analysis/SKILL.md +13 -13
  8. package/config/skills/code_generator/SKILL.md +12 -12
  9. package/config/skills/code_reviewer/SKILL.md +13 -13
  10. package/config/skills/content_writer/SKILL.md +14 -14
  11. package/config/skills/data_transformer/SKILL.md +15 -15
  12. package/config/skills/document_analysis/SKILL.md +13 -13
  13. package/config/skills/emotional_companion/SKILL.md +15 -15
  14. package/config/skills/performance_checker/SKILL.md +14 -14
  15. package/config/skills/security_auditor/SKILL.md +14 -14
  16. package/config/skills/self_evolve/SKILL.md +13 -13
  17. package/config/skills/sys_operator/SKILL.md +15 -15
  18. package/config/skills/task_planner/SKILL.md +14 -14
  19. package/config/skills/web_research/SKILL.md +14 -14
  20. package/config/skills/workflow_designer/SKILL.md +13 -13
  21. package/dist/agents/dew.js +52 -52
  22. package/dist/agents/fair.js +84 -84
  23. package/dist/agents/fog.js +30 -30
  24. package/dist/agents/frost.js +32 -32
  25. package/dist/agents/rain.js +32 -32
  26. package/dist/agents/snow.js +68 -68
  27. package/dist/cli/commands_md.d.ts +41 -0
  28. package/dist/cli/commands_md.d.ts.map +1 -0
  29. package/dist/cli/commands_md.js +140 -0
  30. package/dist/cli/commands_md.js.map +1 -0
  31. package/dist/cli/input_macros.d.ts +28 -0
  32. package/dist/cli/input_macros.d.ts.map +1 -0
  33. package/dist/cli/input_macros.js +120 -0
  34. package/dist/cli/input_macros.js.map +1 -0
  35. package/dist/cli/loom.d.ts +220 -0
  36. package/dist/cli/loom.d.ts.map +1 -0
  37. package/dist/cli/loom.js +1094 -0
  38. package/dist/cli/loom.js.map +1 -0
  39. package/dist/cli/loom_chat.d.ts +20 -0
  40. package/dist/cli/loom_chat.d.ts.map +1 -0
  41. package/dist/cli/loom_chat.js +685 -0
  42. package/dist/cli/loom_chat.js.map +1 -0
  43. package/dist/cli/main.js +310 -14
  44. package/dist/cli/main.js.map +1 -1
  45. package/dist/cli/tui.d.ts.map +1 -1
  46. package/dist/cli/tui.js +7 -1
  47. package/dist/cli/tui.js.map +1 -1
  48. package/dist/core/agent/guard.d.ts +45 -0
  49. package/dist/core/agent/guard.d.ts.map +1 -0
  50. package/dist/core/agent/guard.js +113 -0
  51. package/dist/core/agent/guard.js.map +1 -0
  52. package/dist/core/agent.d.ts +17 -0
  53. package/dist/core/agent.d.ts.map +1 -1
  54. package/dist/core/agent.js +182 -93
  55. package/dist/core/agent.js.map +1 -1
  56. package/dist/core/factory.d.ts.map +1 -1
  57. package/dist/core/factory.js +34 -2
  58. package/dist/core/factory.js.map +1 -1
  59. package/dist/core/file_checkpoint.d.ts +57 -0
  60. package/dist/core/file_checkpoint.d.ts.map +1 -0
  61. package/dist/core/file_checkpoint.js +162 -0
  62. package/dist/core/file_checkpoint.js.map +1 -0
  63. package/dist/core/hooks.d.ts +43 -0
  64. package/dist/core/hooks.d.ts.map +1 -0
  65. package/dist/core/hooks.js +110 -0
  66. package/dist/core/hooks.js.map +1 -0
  67. package/dist/core/llm.d.ts.map +1 -1
  68. package/dist/core/llm.js +15 -9
  69. package/dist/core/llm.js.map +1 -1
  70. package/dist/core/longdoc.js +5 -5
  71. package/dist/core/mcp.d.ts +16 -0
  72. package/dist/core/mcp.d.ts.map +1 -1
  73. package/dist/core/mcp.js +55 -0
  74. package/dist/core/mcp.js.map +1 -1
  75. package/dist/core/model_config.d.ts +40 -0
  76. package/dist/core/model_config.d.ts.map +1 -0
  77. package/dist/core/model_config.js +191 -0
  78. package/dist/core/model_config.js.map +1 -0
  79. package/dist/core/skill.d.ts +7 -0
  80. package/dist/core/skill.d.ts.map +1 -1
  81. package/dist/core/skill.js +47 -0
  82. package/dist/core/skill.js.map +1 -1
  83. package/dist/core/skymd.d.ts +39 -0
  84. package/dist/core/skymd.d.ts.map +1 -0
  85. package/dist/core/skymd.js +177 -0
  86. package/dist/core/skymd.js.map +1 -0
  87. package/dist/core/tool.d.ts +12 -0
  88. package/dist/core/tool.d.ts.map +1 -1
  89. package/dist/core/tool.js +30 -0
  90. package/dist/core/tool.js.map +1 -1
  91. package/dist/core/verify.d.ts +27 -0
  92. package/dist/core/verify.d.ts.map +1 -0
  93. package/dist/core/verify.js +62 -0
  94. package/dist/core/verify.js.map +1 -0
  95. package/dist/skills/loader.d.ts +22 -2
  96. package/dist/skills/loader.d.ts.map +1 -1
  97. package/dist/skills/loader.js +45 -15
  98. package/dist/skills/loader.js.map +1 -1
  99. package/dist/tools/builtin.d.ts.map +1 -1
  100. package/dist/tools/builtin.js +13 -3
  101. package/dist/tools/builtin.js.map +1 -1
  102. package/dist/tools/model_tool.d.ts +11 -0
  103. package/dist/tools/model_tool.d.ts.map +1 -0
  104. package/dist/tools/model_tool.js +71 -0
  105. package/dist/tools/model_tool.js.map +1 -0
  106. package/dist/tools/todo.d.ts +30 -0
  107. package/dist/tools/todo.d.ts.map +1 -0
  108. package/dist/tools/todo.js +78 -0
  109. package/dist/tools/todo.js.map +1 -0
  110. package/docs/AESTHETIC_DESIGN.md +152 -144
  111. package/docs/OPTIMIZATION_PLAN.md +178 -178
  112. package/package.json +1 -1
  113. package/scripts/install.js +48 -48
  114. package/scripts/link.js +10 -10
  115. package/setup.bat +79 -79
  116. package/skill-test-ty2fOA/test.md +10 -10
  117. package/src/agents/dew.ts +70 -70
  118. package/src/agents/fair.ts +102 -102
  119. package/src/agents/fog.ts +48 -48
  120. package/src/agents/frost.ts +50 -50
  121. package/src/agents/rain.ts +50 -50
  122. package/src/agents/snow.ts +239 -239
  123. package/src/cli/commands_md.ts +112 -0
  124. package/src/cli/input_macros.ts +83 -0
  125. package/src/cli/loom.ts +982 -0
  126. package/src/cli/loom_chat.ts +598 -0
  127. package/src/cli/main.ts +255 -9
  128. package/src/cli/mode.ts +58 -58
  129. package/src/cli/tui.ts +228 -222
  130. package/src/core/agent/guard.ts +134 -0
  131. package/src/core/agent/task.ts +100 -100
  132. package/src/core/agent.ts +177 -95
  133. package/src/core/arbitrate.ts +162 -162
  134. package/src/core/catalog.ts +178 -178
  135. package/src/core/checkpoint.ts +94 -94
  136. package/src/core/estimate.ts +104 -104
  137. package/src/core/evolve.ts +191 -191
  138. package/src/core/factory.ts +31 -2
  139. package/src/core/file_checkpoint.ts +136 -0
  140. package/src/core/filter.ts +103 -103
  141. package/src/core/graph.ts +156 -156
  142. package/src/core/hooks.ts +126 -0
  143. package/src/core/icons.ts +53 -53
  144. package/src/core/index.ts +37 -37
  145. package/src/core/learn.ts +146 -146
  146. package/src/core/llm.ts +15 -9
  147. package/src/core/longdoc.ts +155 -155
  148. package/src/core/mcp.ts +48 -0
  149. package/src/core/mcp_server.ts +176 -176
  150. package/src/core/model_config.ts +157 -0
  151. package/src/core/profile.ts +255 -255
  152. package/src/core/router.ts +124 -124
  153. package/src/core/sandbox.ts +142 -142
  154. package/src/core/security.ts +243 -243
  155. package/src/core/skill.ts +42 -0
  156. package/src/core/skymd.ts +143 -0
  157. package/src/core/theme.ts +65 -65
  158. package/src/core/tool.ts +30 -0
  159. package/src/core/tool_router.ts +193 -193
  160. package/src/core/vector.ts +152 -152
  161. package/src/core/verify.ts +71 -0
  162. package/src/core/workspace.ts +150 -150
  163. package/src/plugins/loader.ts +66 -66
  164. package/src/skills/loader.ts +45 -16
  165. package/src/sql.js.d.ts +29 -29
  166. package/src/tools/builtin.ts +13 -3
  167. package/src/tools/computer.ts +269 -269
  168. package/src/tools/delegate.ts +49 -49
  169. package/src/tools/model_tool.ts +74 -0
  170. package/src/tools/todo.ts +76 -0
  171. package/src/web/tts.ts +93 -93
  172. package/tests/agent.test.ts +159 -159
  173. package/tests/agent_helpers.test.ts +48 -48
  174. package/tests/bus.test.ts +121 -121
  175. package/tests/catalog.test.ts +86 -86
  176. package/tests/checkpoint_commands.test.ts +124 -0
  177. package/tests/claude_compat.test.ts +110 -0
  178. package/tests/config.test.ts +41 -41
  179. package/tests/guard.test.ts +75 -0
  180. package/tests/icons.test.ts +45 -45
  181. package/tests/loom.test.ts +248 -0
  182. package/tests/memory.test.ts +170 -170
  183. package/tests/model_config.test.ts +109 -0
  184. package/tests/router.test.ts +86 -86
  185. package/tests/schemas.test.ts +51 -51
  186. package/tests/semantic.test.ts +83 -83
  187. package/tests/setup.ts +10 -10
  188. package/tests/skill.test.ts +172 -172
  189. package/tests/skymd.test.ts +146 -0
  190. package/tests/task.test.ts +60 -60
  191. package/tests/todo_toolstats.test.ts +94 -0
  192. package/tests/tool.test.ts +108 -108
  193. package/tests/tool_router.test.ts +71 -71
  194. package/tests/tui.test.ts +67 -67
  195. package/vitest.config.ts +17 -17
@@ -1,269 +1,269 @@
1
- /**
2
- * Computer-operation tools — cross-platform OS control for Skyloom.
3
- *
4
- * Launch apps, open files/URLs, inspect and diagnose the system, manage
5
- * processes and services, and install/uninstall software.
6
- */
7
-
8
- import { execSync, spawn } from 'child_process';
9
- import * as os from 'os';
10
- import * as fs from 'fs';
11
- import * as path from 'path';
12
- import type { ToolRegistry, ToolDefinition } from '../core/tool';
13
-
14
- const MAX_OUT = 8000;
15
-
16
- function truncate(text: string, limit = MAX_OUT): string {
17
- if (text.length <= limit) return text;
18
- return text.slice(0, limit) + `\n…(truncated, ${text.length - limit} more chars)`;
19
- }
20
-
21
- /**
22
- * Register computer-operation tools into the given registry.
23
- */
24
- export function registerComputerTools(registry: ToolRegistry): void {
25
- const platform = os.platform();
26
-
27
- // ── Launch App ──
28
- registry.register({
29
- name: 'launch_app',
30
- description: 'Launch a desktop application by name or path.',
31
- parameters: [
32
- { name: 'name', type: 'string', description: 'Application name or path', required: true },
33
- ],
34
- handler: async (params) => {
35
- const name = String(params.name || '').trim();
36
- if (!name) return 'Error: app name is required';
37
-
38
- try {
39
- if (platform === 'win32') {
40
- execSync(`start "" "${name}"`, { timeout: 10000 });
41
- return `Launched ${name}`;
42
- } else if (platform === 'darwin') {
43
- execSync(`open -a "${name.replace(/"/g, '\\"')}"`, { timeout: 10000 });
44
- return `Launched ${name}`;
45
- } else {
46
- // Linux - try xdg-open or direct exec
47
- try {
48
- execSync(`${name} &`, { timeout: 5000, shell: true as any });
49
- } catch {
50
- execSync(`xdg-open "${name}" 2>/dev/null || ${name}`, { timeout: 5000, shell: true as any });
51
- }
52
- return `Launched ${name}`;
53
- }
54
- } catch (e: any) {
55
- return `Error launching ${name}: ${e.message || e}`;
56
- }
57
- },
58
- });
59
-
60
- // ── Open Path ──
61
- registry.register({
62
- name: 'open_path',
63
- description: 'Open a file or folder in the default application.',
64
- parameters: [
65
- { name: 'target', type: 'string', description: 'File or folder path', required: true },
66
- ],
67
- handler: async (params) => {
68
- const target = String(params.target || '').trim();
69
- if (!target) return 'Error: target is required';
70
- const resolved = path.resolve(target);
71
- if (!fs.existsSync(resolved)) return `Error: path not found: ${resolved}`;
72
-
73
- try {
74
- if (platform === 'win32') {
75
- execSync(`explorer "${resolved}"`, { timeout: 5000 });
76
- } else if (platform === 'darwin') {
77
- execSync(`open "${resolved}"`, { timeout: 5000 });
78
- } else {
79
- execSync(`xdg-open "${resolved}"`, { timeout: 5000 });
80
- }
81
- return `Opened ${resolved}`;
82
- } catch (e: any) {
83
- return `Error opening ${resolved}: ${e.message || e}`;
84
- }
85
- },
86
- });
87
-
88
- // ── Browser Open ──
89
- registry.register({
90
- name: 'browser_open',
91
- description: 'Open a URL in the default web browser.',
92
- parameters: [
93
- { name: 'url', type: 'string', description: 'URL to open', required: true },
94
- ],
95
- handler: async (params) => {
96
- const url = String(params.url || '').trim();
97
- if (!url) return 'Error: url is required';
98
- try {
99
- if (platform === 'win32') {
100
- execSync(`start "" "${url}"`, { timeout: 10000 });
101
- } else if (platform === 'darwin') {
102
- execSync(`open "${url}"`, { timeout: 10000 });
103
- } else {
104
- execSync(`xdg-open "${url}"`, { timeout: 10000 });
105
- }
106
- return `Opened ${url} in browser`;
107
- } catch (e: any) {
108
- return `Error opening browser: ${e.message || e}`;
109
- }
110
- },
111
- });
112
-
113
- // ── System Info ──
114
- registry.register({
115
- name: 'system_info',
116
- description: 'Get system information (OS, CPU, memory, disk).',
117
- parameters: [],
118
- handler: async () => {
119
- const lines = [
120
- `OS: ${os.type()} ${os.release()}`,
121
- `Hostname: ${os.hostname()}`,
122
- `Platform: ${os.platform()} ${os.arch()}`,
123
- `CPUs: ${os.cpus().length} × ${os.cpus()[0]?.model || 'unknown'}`,
124
- `Memory: ${(os.totalmem() / 1024 / 1024 / 1024).toFixed(1)} GB total, ${(os.freemem() / 1024 / 1024 / 1024).toFixed(1)} GB free`,
125
- `Uptime: ${(os.uptime() / 3600).toFixed(1)} hours`,
126
- `Loadavg: ${os.loadavg().map(n => n.toFixed(2)).join(', ')}`,
127
- `User: ${os.userInfo().username}`,
128
- `Home: ${os.homedir()}`,
129
- `Temp: ${os.tmpdir()}`,
130
- ];
131
- return lines.join('\n');
132
- },
133
- });
134
-
135
- // ── List Processes ──
136
- registry.register({
137
- name: 'list_processes',
138
- description: 'List running processes.',
139
- parameters: [],
140
- handler: async () => {
141
- try {
142
- if (platform === 'win32') {
143
- const out = execSync('tasklist /FO CSV /NH', { encoding: 'utf-8', timeout: 10000 });
144
- return truncate(out, MAX_OUT);
145
- } else {
146
- const out = execSync('ps aux --no-headers 2>/dev/null || ps aux', { encoding: 'utf-8', timeout: 10000 });
147
- return truncate(out, MAX_OUT);
148
- }
149
- } catch (e: any) {
150
- return `Error listing processes: ${e.message || e}`;
151
- }
152
- },
153
- });
154
-
155
- // ── Kill Process ──
156
- registry.register({
157
- name: 'kill_process',
158
- description: 'Kill a process by PID or name.',
159
- parameters: [
160
- { name: 'target', type: 'string', description: 'PID number or process name', required: true },
161
- ],
162
- handler: async (params) => {
163
- const target = String(params.target || '').trim();
164
- if (!target) return 'Error: target is required';
165
-
166
- try {
167
- if (/^\d+$/.test(target)) {
168
- process.kill(parseInt(target), 'SIGTERM');
169
- return `Killed process ${target}`;
170
- } else {
171
- if (platform === 'win32') {
172
- execSync(`taskkill /F /IM "${target}" /T`, { timeout: 10000 });
173
- } else {
174
- execSync(`pkill -f "${target}"`, { timeout: 10000 });
175
- }
176
- return `Killed process ${target}`;
177
- }
178
- } catch (e: any) {
179
- return `Error killing ${target}: ${e.message || e}`;
180
- }
181
- },
182
- dangerous: true,
183
- });
184
-
185
- // ── Package Manager ──
186
- registry.register({
187
- name: 'package_manager',
188
- description: 'Install, uninstall, or upgrade software packages.',
189
- parameters: [
190
- { name: 'action', type: 'string', description: 'Action: install, uninstall, upgrade, search', required: true },
191
- { name: 'name', type: 'string', description: 'Package name', required: true },
192
- ],
193
- handler: async (params) => {
194
- const action = String(params.action || '').trim().toLowerCase();
195
- const name = String(params.name || '').trim();
196
- if (!action || !name) return 'Error: action and name are required';
197
-
198
- // Auto-detect package manager
199
- let pm: string;
200
- const has = (cmd: string) => {
201
- try { execSync(`${cmd} --version`, { stdio: 'ignore' }); return true; }
202
- catch { return false; }
203
- };
204
-
205
- if (platform === 'win32') {
206
- if (has('winget')) pm = 'winget';
207
- else if (has('scoop')) pm = 'scoop';
208
- else if (has('choco')) pm = 'choco';
209
- else return 'No package manager found (winget/scoop/choco)';
210
- } else if (platform === 'darwin') {
211
- pm = has('brew') ? 'brew' : 'No package manager found';
212
- } else {
213
- if (has('apt')) pm = 'apt';
214
- else if (has('dnf')) pm = 'dnf';
215
- else if (has('pacman')) pm = 'pacman';
216
- else return 'No package manager found (apt/dnf/pacman)';
217
- }
218
-
219
- const commands: Record<string, Record<string, string>> = {
220
- winget: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
221
- scoop: { install: 'install', uninstall: 'uninstall', upgrade: 'update', search: 'search' },
222
- choco: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
223
- brew: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
224
- apt: { install: 'install -y', uninstall: 'remove -y', upgrade: 'upgrade -y', search: 'search' },
225
- dnf: { install: 'install -y', uninstall: 'remove -y', upgrade: 'upgrade -y', search: 'search' },
226
- pacman: { install: '-S --noconfirm', uninstall: '-R --noconfirm', upgrade: '-Syu --noconfirm', search: '-Ss' },
227
- };
228
-
229
- const cmdMap = commands[pm];
230
- if (!cmdMap || !cmdMap[action]) return `Unsupported action '${action}' for ${pm}`;
231
-
232
- try {
233
- const out = execSync(`${pm} ${cmdMap[action]} "${name}"`, { encoding: 'utf-8', timeout: 120000 });
234
- return truncate(out, MAX_OUT);
235
- } catch (e: any) {
236
- return `Error: ${e.message || e}`;
237
- }
238
- },
239
- dangerous: true,
240
- });
241
-
242
- // ── Service Control ──
243
- registry.register({
244
- name: 'service_control',
245
- description: 'Start, stop, restart, or check status of a system service.',
246
- parameters: [
247
- { name: 'action', type: 'string', description: 'Action: start, stop, restart, status', required: true },
248
- { name: 'name', type: 'string', description: 'Service name', required: true },
249
- ],
250
- handler: async (params) => {
251
- const action = String(params.action || '').trim().toLowerCase();
252
- const name = String(params.name || '').trim();
253
- if (!action || !name) return 'Error: action and name are required';
254
-
255
- try {
256
- if (platform === 'win32') {
257
- const out = execSync(`sc ${action} "${name}"`, { encoding: 'utf-8', timeout: 30000 });
258
- return truncate(out, MAX_OUT);
259
- } else {
260
- const out = execSync(`systemctl ${action} "${name}" 2>/dev/null || service "${name}" ${action}`, { encoding: 'utf-8', timeout: 30000 });
261
- return truncate(out, MAX_OUT);
262
- }
263
- } catch (e: any) {
264
- return `Error: ${e.message || e}`;
265
- }
266
- },
267
- dangerous: true,
268
- });
269
- }
1
+ /**
2
+ * Computer-operation tools — cross-platform OS control for Skyloom.
3
+ *
4
+ * Launch apps, open files/URLs, inspect and diagnose the system, manage
5
+ * processes and services, and install/uninstall software.
6
+ */
7
+
8
+ import { execSync, spawn } from 'child_process';
9
+ import * as os from 'os';
10
+ import * as fs from 'fs';
11
+ import * as path from 'path';
12
+ import type { ToolRegistry, ToolDefinition } from '../core/tool';
13
+
14
+ const MAX_OUT = 8000;
15
+
16
+ function truncate(text: string, limit = MAX_OUT): string {
17
+ if (text.length <= limit) return text;
18
+ return text.slice(0, limit) + `\n…(truncated, ${text.length - limit} more chars)`;
19
+ }
20
+
21
+ /**
22
+ * Register computer-operation tools into the given registry.
23
+ */
24
+ export function registerComputerTools(registry: ToolRegistry): void {
25
+ const platform = os.platform();
26
+
27
+ // ── Launch App ──
28
+ registry.register({
29
+ name: 'launch_app',
30
+ description: 'Launch a desktop application by name or path.',
31
+ parameters: [
32
+ { name: 'name', type: 'string', description: 'Application name or path', required: true },
33
+ ],
34
+ handler: async (params) => {
35
+ const name = String(params.name || '').trim();
36
+ if (!name) return 'Error: app name is required';
37
+
38
+ try {
39
+ if (platform === 'win32') {
40
+ execSync(`start "" "${name}"`, { timeout: 10000 });
41
+ return `Launched ${name}`;
42
+ } else if (platform === 'darwin') {
43
+ execSync(`open -a "${name.replace(/"/g, '\\"')}"`, { timeout: 10000 });
44
+ return `Launched ${name}`;
45
+ } else {
46
+ // Linux - try xdg-open or direct exec
47
+ try {
48
+ execSync(`${name} &`, { timeout: 5000, shell: true as any });
49
+ } catch {
50
+ execSync(`xdg-open "${name}" 2>/dev/null || ${name}`, { timeout: 5000, shell: true as any });
51
+ }
52
+ return `Launched ${name}`;
53
+ }
54
+ } catch (e: any) {
55
+ return `Error launching ${name}: ${e.message || e}`;
56
+ }
57
+ },
58
+ });
59
+
60
+ // ── Open Path ──
61
+ registry.register({
62
+ name: 'open_path',
63
+ description: 'Open a file or folder in the default application.',
64
+ parameters: [
65
+ { name: 'target', type: 'string', description: 'File or folder path', required: true },
66
+ ],
67
+ handler: async (params) => {
68
+ const target = String(params.target || '').trim();
69
+ if (!target) return 'Error: target is required';
70
+ const resolved = path.resolve(target);
71
+ if (!fs.existsSync(resolved)) return `Error: path not found: ${resolved}`;
72
+
73
+ try {
74
+ if (platform === 'win32') {
75
+ execSync(`explorer "${resolved}"`, { timeout: 5000 });
76
+ } else if (platform === 'darwin') {
77
+ execSync(`open "${resolved}"`, { timeout: 5000 });
78
+ } else {
79
+ execSync(`xdg-open "${resolved}"`, { timeout: 5000 });
80
+ }
81
+ return `Opened ${resolved}`;
82
+ } catch (e: any) {
83
+ return `Error opening ${resolved}: ${e.message || e}`;
84
+ }
85
+ },
86
+ });
87
+
88
+ // ── Browser Open ──
89
+ registry.register({
90
+ name: 'browser_open',
91
+ description: 'Open a URL in the default web browser.',
92
+ parameters: [
93
+ { name: 'url', type: 'string', description: 'URL to open', required: true },
94
+ ],
95
+ handler: async (params) => {
96
+ const url = String(params.url || '').trim();
97
+ if (!url) return 'Error: url is required';
98
+ try {
99
+ if (platform === 'win32') {
100
+ execSync(`start "" "${url}"`, { timeout: 10000 });
101
+ } else if (platform === 'darwin') {
102
+ execSync(`open "${url}"`, { timeout: 10000 });
103
+ } else {
104
+ execSync(`xdg-open "${url}"`, { timeout: 10000 });
105
+ }
106
+ return `Opened ${url} in browser`;
107
+ } catch (e: any) {
108
+ return `Error opening browser: ${e.message || e}`;
109
+ }
110
+ },
111
+ });
112
+
113
+ // ── System Info ──
114
+ registry.register({
115
+ name: 'system_info',
116
+ description: 'Get system information (OS, CPU, memory, disk).',
117
+ parameters: [],
118
+ handler: async () => {
119
+ const lines = [
120
+ `OS: ${os.type()} ${os.release()}`,
121
+ `Hostname: ${os.hostname()}`,
122
+ `Platform: ${os.platform()} ${os.arch()}`,
123
+ `CPUs: ${os.cpus().length} × ${os.cpus()[0]?.model || 'unknown'}`,
124
+ `Memory: ${(os.totalmem() / 1024 / 1024 / 1024).toFixed(1)} GB total, ${(os.freemem() / 1024 / 1024 / 1024).toFixed(1)} GB free`,
125
+ `Uptime: ${(os.uptime() / 3600).toFixed(1)} hours`,
126
+ `Loadavg: ${os.loadavg().map(n => n.toFixed(2)).join(', ')}`,
127
+ `User: ${os.userInfo().username}`,
128
+ `Home: ${os.homedir()}`,
129
+ `Temp: ${os.tmpdir()}`,
130
+ ];
131
+ return lines.join('\n');
132
+ },
133
+ });
134
+
135
+ // ── List Processes ──
136
+ registry.register({
137
+ name: 'list_processes',
138
+ description: 'List running processes.',
139
+ parameters: [],
140
+ handler: async () => {
141
+ try {
142
+ if (platform === 'win32') {
143
+ const out = execSync('tasklist /FO CSV /NH', { encoding: 'utf-8', timeout: 10000 });
144
+ return truncate(out, MAX_OUT);
145
+ } else {
146
+ const out = execSync('ps aux --no-headers 2>/dev/null || ps aux', { encoding: 'utf-8', timeout: 10000 });
147
+ return truncate(out, MAX_OUT);
148
+ }
149
+ } catch (e: any) {
150
+ return `Error listing processes: ${e.message || e}`;
151
+ }
152
+ },
153
+ });
154
+
155
+ // ── Kill Process ──
156
+ registry.register({
157
+ name: 'kill_process',
158
+ description: 'Kill a process by PID or name.',
159
+ parameters: [
160
+ { name: 'target', type: 'string', description: 'PID number or process name', required: true },
161
+ ],
162
+ handler: async (params) => {
163
+ const target = String(params.target || '').trim();
164
+ if (!target) return 'Error: target is required';
165
+
166
+ try {
167
+ if (/^\d+$/.test(target)) {
168
+ process.kill(parseInt(target), 'SIGTERM');
169
+ return `Killed process ${target}`;
170
+ } else {
171
+ if (platform === 'win32') {
172
+ execSync(`taskkill /F /IM "${target}" /T`, { timeout: 10000 });
173
+ } else {
174
+ execSync(`pkill -f "${target}"`, { timeout: 10000 });
175
+ }
176
+ return `Killed process ${target}`;
177
+ }
178
+ } catch (e: any) {
179
+ return `Error killing ${target}: ${e.message || e}`;
180
+ }
181
+ },
182
+ dangerous: true,
183
+ });
184
+
185
+ // ── Package Manager ──
186
+ registry.register({
187
+ name: 'package_manager',
188
+ description: 'Install, uninstall, or upgrade software packages.',
189
+ parameters: [
190
+ { name: 'action', type: 'string', description: 'Action: install, uninstall, upgrade, search', required: true },
191
+ { name: 'name', type: 'string', description: 'Package name', required: true },
192
+ ],
193
+ handler: async (params) => {
194
+ const action = String(params.action || '').trim().toLowerCase();
195
+ const name = String(params.name || '').trim();
196
+ if (!action || !name) return 'Error: action and name are required';
197
+
198
+ // Auto-detect package manager
199
+ let pm: string;
200
+ const has = (cmd: string) => {
201
+ try { execSync(`${cmd} --version`, { stdio: 'ignore' }); return true; }
202
+ catch { return false; }
203
+ };
204
+
205
+ if (platform === 'win32') {
206
+ if (has('winget')) pm = 'winget';
207
+ else if (has('scoop')) pm = 'scoop';
208
+ else if (has('choco')) pm = 'choco';
209
+ else return 'No package manager found (winget/scoop/choco)';
210
+ } else if (platform === 'darwin') {
211
+ pm = has('brew') ? 'brew' : 'No package manager found';
212
+ } else {
213
+ if (has('apt')) pm = 'apt';
214
+ else if (has('dnf')) pm = 'dnf';
215
+ else if (has('pacman')) pm = 'pacman';
216
+ else return 'No package manager found (apt/dnf/pacman)';
217
+ }
218
+
219
+ const commands: Record<string, Record<string, string>> = {
220
+ winget: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
221
+ scoop: { install: 'install', uninstall: 'uninstall', upgrade: 'update', search: 'search' },
222
+ choco: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
223
+ brew: { install: 'install', uninstall: 'uninstall', upgrade: 'upgrade', search: 'search' },
224
+ apt: { install: 'install -y', uninstall: 'remove -y', upgrade: 'upgrade -y', search: 'search' },
225
+ dnf: { install: 'install -y', uninstall: 'remove -y', upgrade: 'upgrade -y', search: 'search' },
226
+ pacman: { install: '-S --noconfirm', uninstall: '-R --noconfirm', upgrade: '-Syu --noconfirm', search: '-Ss' },
227
+ };
228
+
229
+ const cmdMap = commands[pm];
230
+ if (!cmdMap || !cmdMap[action]) return `Unsupported action '${action}' for ${pm}`;
231
+
232
+ try {
233
+ const out = execSync(`${pm} ${cmdMap[action]} "${name}"`, { encoding: 'utf-8', timeout: 120000 });
234
+ return truncate(out, MAX_OUT);
235
+ } catch (e: any) {
236
+ return `Error: ${e.message || e}`;
237
+ }
238
+ },
239
+ dangerous: true,
240
+ });
241
+
242
+ // ── Service Control ──
243
+ registry.register({
244
+ name: 'service_control',
245
+ description: 'Start, stop, restart, or check status of a system service.',
246
+ parameters: [
247
+ { name: 'action', type: 'string', description: 'Action: start, stop, restart, status', required: true },
248
+ { name: 'name', type: 'string', description: 'Service name', required: true },
249
+ ],
250
+ handler: async (params) => {
251
+ const action = String(params.action || '').trim().toLowerCase();
252
+ const name = String(params.name || '').trim();
253
+ if (!action || !name) return 'Error: action and name are required';
254
+
255
+ try {
256
+ if (platform === 'win32') {
257
+ const out = execSync(`sc ${action} "${name}"`, { encoding: 'utf-8', timeout: 30000 });
258
+ return truncate(out, MAX_OUT);
259
+ } else {
260
+ const out = execSync(`systemctl ${action} "${name}" 2>/dev/null || service "${name}" ${action}`, { encoding: 'utf-8', timeout: 30000 });
261
+ return truncate(out, MAX_OUT);
262
+ }
263
+ } catch (e: any) {
264
+ return `Error: ${e.message || e}`;
265
+ }
266
+ },
267
+ dangerous: true,
268
+ });
269
+ }
@@ -1,49 +1,49 @@
1
- /**
2
- * Delegate tool — allows agents to delegate tasks to other agents.
3
- */
4
-
5
- import type { ToolDefinition } from '../core/tool';
6
- import type { BaseAgent } from '../core/agent';
7
-
8
- /**
9
- * Create a delegate_to tool for an agent to delegate tasks to other agents.
10
- */
11
- export function createDelegateTool(
12
- agentMap: Map<string, BaseAgent>,
13
- callingAgent: BaseAgent
14
- ): ToolDefinition {
15
- return {
16
- name: 'delegate_to',
17
- description: 'Delegate a task to another agent. Use this when the task requires a different specialty or when context is overflowing.',
18
- parameters: [
19
- {
20
- name: 'agent',
21
- type: 'string',
22
- description: 'Target agent name: fog (research), rain (code/writing), frost (review), dew (ops/deploy), snow (planning)',
23
- required: true,
24
- },
25
- {
26
- name: 'task',
27
- type: 'string',
28
- description: 'Clear, self-contained task description for the target agent',
29
- required: true,
30
- },
31
- ],
32
- handler: async (params) => {
33
- const targetName = params.agent as string;
34
- const taskDesc = params.task as string;
35
-
36
- const targetAgent = agentMap.get(targetName);
37
- if (!targetAgent) {
38
- return `Error: Agent '${targetName}' not found. Available agents: ${[...agentMap.keys()].join(', ')}`;
39
- }
40
-
41
- try {
42
- const result = await callingAgent.requestHelp(targetName, taskDesc, 120);
43
- return result;
44
- } catch (e) {
45
- return `Error delegating to ${targetName}: ${e}`;
46
- }
47
- },
48
- };
49
- }
1
+ /**
2
+ * Delegate tool — allows agents to delegate tasks to other agents.
3
+ */
4
+
5
+ import type { ToolDefinition } from '../core/tool';
6
+ import type { BaseAgent } from '../core/agent';
7
+
8
+ /**
9
+ * Create a delegate_to tool for an agent to delegate tasks to other agents.
10
+ */
11
+ export function createDelegateTool(
12
+ agentMap: Map<string, BaseAgent>,
13
+ callingAgent: BaseAgent
14
+ ): ToolDefinition {
15
+ return {
16
+ name: 'delegate_to',
17
+ description: 'Delegate a task to another agent. Use this when the task requires a different specialty or when context is overflowing.',
18
+ parameters: [
19
+ {
20
+ name: 'agent',
21
+ type: 'string',
22
+ description: 'Target agent name: fog (research), rain (code/writing), frost (review), dew (ops/deploy), snow (planning)',
23
+ required: true,
24
+ },
25
+ {
26
+ name: 'task',
27
+ type: 'string',
28
+ description: 'Clear, self-contained task description for the target agent',
29
+ required: true,
30
+ },
31
+ ],
32
+ handler: async (params) => {
33
+ const targetName = params.agent as string;
34
+ const taskDesc = params.task as string;
35
+
36
+ const targetAgent = agentMap.get(targetName);
37
+ if (!targetAgent) {
38
+ return `Error: Agent '${targetName}' not found. Available agents: ${[...agentMap.keys()].join(', ')}`;
39
+ }
40
+
41
+ try {
42
+ const result = await callingAgent.requestHelp(targetName, taskDesc, 120);
43
+ return result;
44
+ } catch (e) {
45
+ return `Error delegating to ${targetName}: ${e}`;
46
+ }
47
+ },
48
+ };
49
+ }