micro-models-agent 0.56.5 → 0.57.1

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 (233) hide show
  1. package/CHANGELOG.md +481 -463
  2. package/README.md +358 -358
  3. package/dist/certification/certifications.json +493 -493
  4. package/dist/cli/commands.js +447 -0
  5. package/dist/cli/completer.js +167 -0
  6. package/dist/cli/index.js +2 -0
  7. package/dist/cli/main.js +153 -0
  8. package/dist/cli/plugin-commands.js +36 -0
  9. package/dist/cli/repl-commands.js +761 -0
  10. package/dist/cli/repl.js +702 -0
  11. package/dist/cli/run-result.js +33 -0
  12. package/dist/cli/security-commands.js +164 -0
  13. package/dist/cli/setup.js +237 -0
  14. package/dist/config/config.js +276 -0
  15. package/dist/config/defaults.js +141 -0
  16. package/dist/config/domains.js +179 -0
  17. package/dist/config/experts.js +15 -0
  18. package/dist/config/index.js +4 -0
  19. package/dist/config/security.js +213 -0
  20. package/dist/config/types.js +1 -0
  21. package/dist/core/agent-moe.js +102 -0
  22. package/dist/core/agent.js +1018 -0
  23. package/dist/core/bootstrap.js +481 -0
  24. package/dist/core/crash-handler.js +51 -0
  25. package/dist/core/environment.js +199 -0
  26. package/dist/core/index.js +2 -0
  27. package/dist/core/prompt-builder.js +76 -0
  28. package/dist/core/session-logger.js +251 -0
  29. package/dist/core/types.js +1 -0
  30. package/dist/core/version.js +26 -0
  31. package/dist/core/workspace.js +76 -0
  32. package/dist/i18n/en.json +679 -0
  33. package/dist/i18n/index.js +46 -0
  34. package/dist/i18n/ru.json +679 -0
  35. package/dist/index.js +22 -0
  36. package/dist/llm/image-utils.js +143 -0
  37. package/dist/llm/index.js +4 -0
  38. package/dist/llm/model-loader.js +78 -0
  39. package/dist/llm/openai-compat.js +497 -0
  40. package/dist/llm/orchestrator.js +200 -0
  41. package/dist/llm/provider.js +10 -0
  42. package/dist/llm/response.js +39 -0
  43. package/dist/llm/token-counter.js +39 -0
  44. package/dist/llm/types.js +1 -0
  45. package/dist/logger/app-logger.js +189 -0
  46. package/dist/logger/file-log.js +151 -0
  47. package/dist/logger/index.js +1 -0
  48. package/dist/main.js +457 -324
  49. package/dist/migration/backup.js +45 -0
  50. package/dist/migration/detect.js +50 -0
  51. package/dist/migration/index.js +2 -0
  52. package/dist/modules/artifacts/store.js +61 -0
  53. package/dist/modules/browser/actions.js +76 -0
  54. package/dist/modules/browser/bridge-client.js +199 -0
  55. package/dist/modules/browser/bridge-path.js +10 -0
  56. package/dist/modules/browser/bridge-server.mjs +219 -219
  57. package/dist/modules/browser/cookie-store.js +24 -0
  58. package/dist/modules/browser/driver.js +136 -0
  59. package/dist/modules/browser/index.js +7 -0
  60. package/dist/modules/browser/module.js +29 -0
  61. package/dist/modules/browser/session.js +342 -0
  62. package/dist/modules/browser/snapshot.js +148 -0
  63. package/dist/modules/browser/types.js +12 -0
  64. package/dist/modules/certification/cli.js +213 -0
  65. package/dist/modules/certification/fact-checker.js +82 -0
  66. package/dist/modules/certification/loader.js +106 -0
  67. package/dist/modules/certification/manifest.js +58 -0
  68. package/dist/modules/certification/runner.js +245 -0
  69. package/dist/modules/certification/scenarios.js +407 -0
  70. package/dist/modules/certification/types.js +1 -0
  71. package/dist/modules/context/chunk-query.js +100 -0
  72. package/dist/modules/context/fact-extractor.js +168 -0
  73. package/dist/modules/context/history.js +15 -0
  74. package/dist/modules/context/index.js +1 -0
  75. package/dist/modules/context/manager.js +440 -0
  76. package/dist/modules/execution/audit-runners.js +206 -0
  77. package/dist/modules/execution/auditor.js +218 -0
  78. package/dist/modules/execution/execution-plugin.js +431 -0
  79. package/dist/modules/execution/index.js +8 -0
  80. package/dist/modules/execution/module.js +625 -0
  81. package/dist/modules/execution/moe-executor.js +304 -0
  82. package/dist/modules/execution/plan-coverage.js +68 -0
  83. package/dist/modules/execution/plan-persister.js +46 -0
  84. package/dist/modules/execution/plan-store.js +196 -0
  85. package/dist/modules/execution/plan-tool.js +677 -0
  86. package/dist/modules/execution/plan-validator.js +153 -0
  87. package/dist/modules/execution/planner.js +94 -0
  88. package/dist/modules/execution/stuck-detector.js +746 -0
  89. package/dist/modules/execution/tracker.js +69 -0
  90. package/dist/modules/execution/types.js +1 -0
  91. package/dist/modules/execution/verifier.js +235 -0
  92. package/dist/modules/execution/windows-commands.js +41 -0
  93. package/dist/modules/hallucination/confidence.js +66 -0
  94. package/dist/modules/hallucination/consistency.js +26 -0
  95. package/dist/modules/hallucination/detector.js +47 -0
  96. package/dist/modules/hallucination/factual.js +169 -0
  97. package/dist/modules/hallucination/index.js +5 -0
  98. package/dist/modules/hallucination/js-identifiers.js +262 -0
  99. package/dist/modules/hallucination/llm-judge.js +101 -0
  100. package/dist/modules/index.js +5 -0
  101. package/dist/modules/indexer/cache.js +40 -0
  102. package/dist/modules/indexer/index.js +3 -0
  103. package/dist/modules/indexer/module.js +246 -0
  104. package/dist/modules/indexer/project-profile.js +183 -0
  105. package/dist/modules/indexer/walker.js +101 -0
  106. package/dist/modules/lsp/check-tool.js +58 -0
  107. package/dist/modules/lsp/client.js +389 -0
  108. package/dist/modules/lsp/command.js +60 -0
  109. package/dist/modules/lsp/config.js +135 -0
  110. package/dist/modules/lsp/index.js +3 -0
  111. package/dist/modules/lsp/module.js +260 -0
  112. package/dist/modules/lsp/probe.js +86 -0
  113. package/dist/modules/lsp/project-root.js +32 -0
  114. package/dist/modules/lsp/startup-check.js +144 -0
  115. package/dist/modules/lsp/types.js +1 -0
  116. package/dist/modules/mcp/client.js +399 -0
  117. package/dist/modules/mcp/index.js +3 -0
  118. package/dist/modules/mcp/module.js +142 -0
  119. package/dist/modules/mcp/registry.js +15 -0
  120. package/dist/modules/memory/index.js +1 -0
  121. package/dist/modules/memory/module.js +96 -0
  122. package/dist/modules/memory/search.js +42 -0
  123. package/dist/modules/memory/store.js +69 -0
  124. package/dist/modules/pipelines/engine.js +60 -0
  125. package/dist/modules/pipelines/index.js +3 -0
  126. package/dist/modules/pipelines/parser.js +56 -0
  127. package/dist/modules/pipelines/template.js +14 -0
  128. package/dist/modules/plugins/builtin/lint-on-write.js +334 -0
  129. package/dist/modules/plugins/builtin/notify.js +9 -0
  130. package/dist/modules/plugins/index.js +1 -0
  131. package/dist/modules/plugins/loader.js +70 -0
  132. package/dist/modules/plugins/manager.js +261 -0
  133. package/dist/modules/plugins/types.js +1 -0
  134. package/dist/modules/pricing/index.js +61 -0
  135. package/dist/modules/pricing/prices.js +129 -0
  136. package/dist/modules/processes/detect.js +34 -0
  137. package/dist/modules/processes/index.js +2 -0
  138. package/dist/modules/processes/registry.js +327 -0
  139. package/dist/modules/processes/runner.js +23 -0
  140. package/dist/modules/providers/create.js +22 -0
  141. package/dist/modules/providers/fallback.js +79 -0
  142. package/dist/modules/providers/health.js +46 -0
  143. package/dist/modules/providers/index.js +5 -0
  144. package/dist/modules/providers/manager.js +161 -0
  145. package/dist/modules/providers/presets.js +128 -0
  146. package/dist/modules/providers/registry.js +22 -0
  147. package/dist/modules/providers/types.js +1 -0
  148. package/dist/modules/registry.js +48 -0
  149. package/dist/modules/security/audit-log.js +136 -0
  150. package/dist/modules/security/audit-notifier.js +292 -0
  151. package/dist/modules/security/command-validator.js +219 -0
  152. package/dist/modules/security/content-scanner.js +53 -0
  153. package/dist/modules/security/data-sanitizer.js +89 -0
  154. package/dist/modules/security/encryption.js +242 -0
  155. package/dist/modules/security/index.js +14 -0
  156. package/dist/modules/security/network-validator.js +88 -0
  157. package/dist/modules/security/path-validator.js +203 -0
  158. package/dist/modules/security/rate-limiter.js +119 -0
  159. package/dist/modules/security/security-policies.js +531 -0
  160. package/dist/modules/security/session-encryption.js +210 -0
  161. package/dist/modules/security/session-isolation.js +95 -0
  162. package/dist/modules/session/index.js +3 -0
  163. package/dist/modules/session/manager.js +172 -0
  164. package/dist/modules/session/module.js +24 -0
  165. package/dist/modules/session/store.js +222 -0
  166. package/dist/modules/session/types.js +1 -0
  167. package/dist/modules/skills/index.js +2 -0
  168. package/dist/modules/skills/loader.js +72 -0
  169. package/dist/modules/skills/matcher.js +27 -0
  170. package/dist/modules/skills/module.js +129 -0
  171. package/dist/modules/types.js +1 -0
  172. package/dist/modules/updater/checker.js +96 -0
  173. package/dist/modules/updater/index.js +2 -0
  174. package/dist/modules/updater/module.js +116 -0
  175. package/dist/modules/user-profile/compressor.js +16 -0
  176. package/dist/modules/user-profile/index.js +1 -0
  177. package/dist/modules/user-profile/profile.js +68 -0
  178. package/dist/skills/builtin/git.md +36 -36
  179. package/dist/skills/builtin/typescript.md +35 -35
  180. package/dist/tools/approve.js +33 -0
  181. package/dist/tools/attach-image.js +101 -0
  182. package/dist/tools/bash.js +519 -0
  183. package/dist/tools/browser.js +115 -0
  184. package/dist/tools/chunk-query.js +100 -0
  185. package/dist/tools/create-dir.js +56 -0
  186. package/dist/tools/delete-file.js +63 -0
  187. package/dist/tools/download-file.js +117 -0
  188. package/dist/tools/edit-file.js +80 -0
  189. package/dist/tools/enable-tools.js +59 -0
  190. package/dist/tools/executor.js +154 -0
  191. package/dist/tools/file-info.js +47 -0
  192. package/dist/tools/filter-tools.js +17 -0
  193. package/dist/tools/glob-tool.js +27 -0
  194. package/dist/tools/grep-tool.js +125 -0
  195. package/dist/tools/hidden-tools-block.js +37 -0
  196. package/dist/tools/index.js +78 -0
  197. package/dist/tools/list-dir.js +49 -0
  198. package/dist/tools/load-skill.js +43 -0
  199. package/dist/tools/mcp-call.js +69 -0
  200. package/dist/tools/move-file.js +86 -0
  201. package/dist/tools/path-utils.js +101 -0
  202. package/dist/tools/pipeline-run.js +145 -0
  203. package/dist/tools/preview.js +2 -0
  204. package/dist/tools/process-kill.js +40 -0
  205. package/dist/tools/process-list.js +37 -0
  206. package/dist/tools/process-log.js +54 -0
  207. package/dist/tools/question.js +141 -0
  208. package/dist/tools/read-file.js +179 -0
  209. package/dist/tools/recall.js +118 -0
  210. package/dist/tools/registry.js +47 -0
  211. package/dist/tools/remember.js +68 -0
  212. package/dist/tools/scope-check.js +32 -0
  213. package/dist/tools/search-history.js +85 -0
  214. package/dist/tools/subagent.js +196 -0
  215. package/dist/tools/types.js +1 -0
  216. package/dist/tools/user-input.js +123 -0
  217. package/dist/tools/web-browse.js +87 -0
  218. package/dist/tools/web-fetch.js +119 -0
  219. package/dist/tools/web-search.js +105 -0
  220. package/dist/tools/write-file.js +82 -0
  221. package/dist/ui/box.js +77 -0
  222. package/dist/ui/colors.js +4 -0
  223. package/dist/ui/diff.js +178 -0
  224. package/dist/ui/index.js +6 -0
  225. package/dist/ui/line-editor.js +822 -0
  226. package/dist/ui/line-math.js +73 -0
  227. package/dist/ui/md-formatter.js +212 -0
  228. package/dist/ui/output.js +13 -0
  229. package/dist/ui/plan-view.js +103 -0
  230. package/dist/ui/renderer.js +259 -0
  231. package/dist/ui/spinner.js +70 -0
  232. package/dist/ui/table.js +144 -0
  233. package/package.json +51 -51
@@ -0,0 +1,153 @@
1
+ import { createProgram } from "./commands";
2
+ import { bootstrap } from "../core/bootstrap";
3
+ import { Repl } from "./repl";
4
+ import { Renderer } from "../ui/renderer";
5
+ import { printRunResult } from "./run-result";
6
+ import { runSetup } from "./setup";
7
+ import { saveConfig } from "../config/config";
8
+ import { t } from "../i18n/index";
9
+ import { pc } from "../ui/colors";
10
+ import { existsSync } from "fs";
11
+ import { join, dirname } from "path";
12
+ import { homedir } from "os";
13
+ import { UpdaterModule } from "../modules/updater/index";
14
+ import { installCrashHandlers } from "../core/crash-handler";
15
+ import { readMmaVersion } from "../core/version";
16
+ /** Fire-and-forget self-update in the background (never blocks startup). */
17
+ function startAutoUpdate(config) {
18
+ try {
19
+ const module = new UpdaterModule(config.updater, readMmaVersion(), "micro-models-agent", {
20
+ info: (m) => process.stderr.write(pc.dim(m) + "\n"),
21
+ warn: (m) => process.stderr.write(pc.yellow(m) + "\n"),
22
+ error: (m) => process.stderr.write(pc.red(m) + "\n"),
23
+ });
24
+ module.start();
25
+ return module;
26
+ }
27
+ catch {
28
+ // Auto-update is best-effort; never let it crash startup.
29
+ return undefined;
30
+ }
31
+ }
32
+ async function main() {
33
+ // Install global crash handlers first — every crash lands in
34
+ // ~/.mma/logs/crash.jsonl (with env report) instead of a bare stderr stack.
35
+ installCrashHandlers();
36
+ const program = createProgram();
37
+ program.parse(process.argv);
38
+ const cmdNames = new Set(program.commands.map((c) => c.name()));
39
+ const opts = program.opts();
40
+ const noAgentsMd = opts.noAgentsMd === true;
41
+ const projectDir = opts.dir;
42
+ const exitOnComplete = opts.exitOnComplete === true;
43
+ const jsonMode = opts.json === true;
44
+ const isSubcommand = program.args.length > 0 && cmdNames.has(program.args[0]);
45
+ if (isSubcommand) {
46
+ return;
47
+ }
48
+ if (program.args.length > 0) {
49
+ const prompt = program.args.join(" ");
50
+ const { agent, config, baseDir, legacyDetected } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
51
+ if (legacyDetected) {
52
+ console.error(pc.yellow(` ${t("config.legacy_hint")}`));
53
+ }
54
+ const updater = exitOnComplete ? undefined : startAutoUpdate(config);
55
+ if (jsonMode) {
56
+ const result = await agent.run(prompt);
57
+ agent.shutdown();
58
+ process.stdout.write(JSON.stringify({
59
+ success: result.success,
60
+ text: result.text,
61
+ error: result.error ?? null,
62
+ iterationCount: result.iterationCount,
63
+ contextUsed: result.contextUsed ?? null,
64
+ contextLimit: result.contextLimit ?? null,
65
+ promptTokens: result.promptTokens ?? null,
66
+ completionTokens: result.completionTokens ?? null,
67
+ totalTokens: result.totalTokens ?? null,
68
+ totalCost: result.totalCost ?? null,
69
+ costBreakdown: result.costBreakdown ?? [],
70
+ }, null, 2));
71
+ process.stdout.write("\n");
72
+ await updater?.waitForIdle();
73
+ process.exit(result.success ? 0 : 1);
74
+ }
75
+ const renderer = new Renderer({
76
+ spinner: config.ui?.spinner ?? true,
77
+ toolStyle: config.ui?.toolStyle ?? "inline",
78
+ baseDir,
79
+ });
80
+ const result = await agent.run(prompt, (chunk) => renderer.text(chunk), (meta) => renderer.meta(meta), (ev) => {
81
+ if (ev.type === "start") {
82
+ renderer.toolStart(ev.tool, ev.args, undefined, ev.icon);
83
+ }
84
+ else {
85
+ renderer.toolEnd(ev.tool, ev.duration ?? 0, ev.error, ev.ctxDelta, ev.costUsd);
86
+ }
87
+ }, (phase) => {
88
+ if (phase === "thinking") {
89
+ renderer.thinkingStart();
90
+ }
91
+ else {
92
+ renderer.thinkingEnd();
93
+ }
94
+ });
95
+ renderer.flush();
96
+ const exitCode = printRunResult(result, () => renderer.flush());
97
+ agent.shutdown();
98
+ await updater?.waitForIdle();
99
+ process.exit(exitCode);
100
+ }
101
+ else {
102
+ const mmaDir = join(homedir(), ".mma");
103
+ const legacyConfigPath = join(mmaDir, "config.json");
104
+ let hasAnyConfig = existsSync(legacyConfigPath);
105
+ if (!hasAnyConfig) {
106
+ try {
107
+ const { hasDomainFiles } = await import("../config/domains");
108
+ hasAnyConfig = hasDomainFiles(mmaDir);
109
+ }
110
+ catch { }
111
+ }
112
+ const { agent, config, sessionManager, skillsModule, pluginManager, execModule, configDir, baseDir, logger, envReport, } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
113
+ const repl = new Repl(agent, config, sessionManager, skillsModule, pluginManager, configDir, baseDir, noAgentsMd, logger, true, envReport, undefined, execModule);
114
+ if (!hasAnyConfig) {
115
+ // First run: wizard via the REPL's LineEditor (avoids Bun stdin conflict
116
+ // from creating a second readline on process.stdin).
117
+ console.log(pc.yellow("\n " + t("cli.first_run") + "\n"));
118
+ const answers = await runSetup(repl.rl);
119
+ config.provider.type = answers.provider;
120
+ config.provider.baseUrl = answers.apiBase;
121
+ config.provider.apiKey = answers.apiKey;
122
+ config.model = answers.model;
123
+ config.contextWindow = answers.contextWindow;
124
+ config.maxToolIterations = answers.maxToolIterations;
125
+ config.locale = answers.locale;
126
+ if (config.security) {
127
+ config.security.enabled = true;
128
+ config.security.bash.enabled = true;
129
+ config.security.bash.blockDangerousFlags =
130
+ answers.securityFlagsBlock || config.security.bash.blockDangerousFlags;
131
+ if (answers.securityBashBlock) {
132
+ config.security.bash.blacklist = [
133
+ ...new Set([
134
+ ...config.security.bash.blacklist,
135
+ "rm", "dd", "chmod", "wget", "curl", "scp", "ssh",
136
+ "nc", "netcat", "sudo", "su", "kill", "pkill",
137
+ "killall", "shutdown", "reboot",
138
+ ]),
139
+ ];
140
+ }
141
+ if (!answers.securityPathsDeny) {
142
+ config.security.paths.denied = [];
143
+ }
144
+ }
145
+ saveConfig(config, legacyConfigPath, dirname(legacyConfigPath));
146
+ await agent.reconfigure(config);
147
+ }
148
+ startAutoUpdate(config);
149
+ await repl.start();
150
+ }
151
+ }
152
+ main();
153
+ export { main };
@@ -0,0 +1,36 @@
1
+ import { bootstrap } from "../core/bootstrap";
2
+ import { readMmaVersion } from "../core/version";
3
+ import { t } from "../i18n/index";
4
+ /**
5
+ * Create the `mma plugins` subcommand group.
6
+ */
7
+ export function createPluginCommand(program) {
8
+ const pluginsCmd = program.command("plugins").description(t("cli.plugins.description"));
9
+ pluginsCmd
10
+ .command("list")
11
+ .description(t("cli.plugins.list"))
12
+ .option("-a, --all", t("cli.plugins.all"))
13
+ .action(async (cmdOpts) => {
14
+ const { pluginManager } = await bootstrap();
15
+ const all = cmdOpts.all === true;
16
+ let infos = pluginManager.getPluginInfos();
17
+ if (!all) {
18
+ infos = infos.filter(({ plugin }) => !plugin.isBuiltin);
19
+ }
20
+ if (infos.length === 0) {
21
+ console.log(t("cli.plugins.none"));
22
+ return;
23
+ }
24
+ const mmaVersion = readMmaVersion();
25
+ console.log(t("cli.plugins.header", { count: String(infos.length), mma: mmaVersion }));
26
+ for (const { plugin, source } of infos) {
27
+ const version = plugin.version || "-";
28
+ const origin = source || "builtin";
29
+ const builtin = plugin.isBuiltin ? t("cli.plugins.builtin_mark") : " ";
30
+ console.log(` ${builtin} ${plugin.name} v${version} [${origin}]`);
31
+ }
32
+ if (!all) {
33
+ console.log(t("cli.plugins.only_external"));
34
+ }
35
+ });
36
+ }