@miaws/miaw 1.18.3 → 1.18.5

package/src/config/agent-preset.ts

@@ -0,0 +1,175 @@
+export * as ConfigAgentPreset from "./agent-preset"
+
+import path from "path"
+import fs from "fs/promises"
+import { Schema } from "effect"
+import { ConfigAgentV1 } from "@miaw/core/v1/config/agent"
+import { ConfigParse } from "./parse"
+
+const Entry = Schema.Struct({
+  model: Schema.optional(Schema.String),
+  fallback: Schema.optional(Schema.String),
+  prompt_append: Schema.optional(Schema.String),
+})
+
+const Preset = Schema.Struct({
+  agents: Schema.optional(Schema.Record(Schema.String, Entry)),
+  categories: Schema.optional(Schema.Record(Schema.String, Entry)),
+})
+
+const PRIMARY_PRESET_AGENTS = new Set(["hephaestus", "sisyphus"])
+
+const DEFAULT_PRESET = {
+  agents: {
+    hephaestus: {
+      model: "opencode/gpt-5.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append:
+        "Hephaestus: implement only. Read context→edit surgically→self-verify (compiles? breaks?)→never stop mid-task. Output: what changed. Zero explanations.",
+    },
+    oracle: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Oracle: arch decisions. Real problem→ranked solutions (correct>maintain>perf)→flag risks. Direct. No fluff.",
+    },
+    librarian: {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "xiaomi/mimo-v2.5-pro",
+      prompt_append:
+        "Librarian: code search. Exhaustive scan→exact path+line+snippet (never paraphrase)→implicit deps. Not found? Say so+next location.",
+    },
+    explore: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "xiaomi/mimo-v2.5",
+      prompt_append: "Explore: scout fast. Map dirs/entry/config→actual stack+conventions→flag anomalies. Output: exists|important|broken|missing.",
+    },
+    "multimodal-looker": {
+      model: "xiaomi/mimo-v2-omni",
+      fallback: "xiaomi/mimo-v2-omni",
+      prompt_append:
+        "Multimodal Looker: parse visuals directly. Extract text/layout/errors/UI state. Errors→exact msg+origin+cause. UI→hierarchy+impl implications. No preamble.",
+    },
+    prometheus: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append:
+        "Prometheus: max parallelism. Decompose→delegate (Librarian=search, Explore=map, Hephaestus=impl, Oracle=arch)→detect failure early→synthesize one output.",
+    },
+    metis: {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append:
+        "Metis: plan only. Goal→ordered verifiable steps (who+inputs+success criteria)→blockers upfront→track done/progress/blocked/pending→replan on diverge.",
+    },
+    momus: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append:
+        "Momus: QA. Trust nothing. Check logic/edge/error-handling/security/perf. Output: file+line+why. P0=fatal P1=case-breaks P2=bad-practice P3=nitpick. Block P0/P1 only.",
+    },
+    atlas: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Atlas: orchestrate long tasks. Hold full context→route optimally→absorb failures silently→deliver one coherent result.",
+    },
+    "sisyphus-junior": {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "xiaomi/mimo-v2.5-pro",
+      prompt_append:
+        "Sisyphus Junior: volume executor. Read spec fully→do exactly what's asked (no creep)→finish or report specific blocker→ambiguous? assume+state+proceed. Output: what changed only.",
+    },
+    sisyphus: {
+      model: "opencode/claude-sonnet-4-6",
+      fallback: "xiaomi/mimo-v2.5",
+      prompt_append:
+        "Sisyphus: primary orchestrator. (1) INTENT: true goal first. One question if critical ambiguity only. (2) PLAN: todo list→parallel always over serial. (3) DELEGATE: Hephaestus=impl, Oracle=arch, Librarian=search, Explore=map, Momus=QA, Prometheus=parallel, Atlas=long-horizon, Metis=plan, Sisyphus-Junior=volume. (4) PERSIST: blocked→reroute. User only if truly stuck+specific blocker. (5) VERIFY: works? breaks anything? (6) REPORT: changed+attention items. No padding.",
+    },
+    "mimo-coder": {
+      model: "xiaomi/mimo-v2.5-pro",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "MiMo Coder: fast code tasks. Read→implement→verify. Output: diff only. No explanations.",
+    },
+    "mimo-searcher": {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "xiaomi/mimo-v2.5",
+      prompt_append: "MiMo Searcher: scan codebase fast. Find exact locations→return path+line+snippet. Direct.",
+    },
+  },
+  categories: {
+    "visual-engineering": {
+      model: "xiaomi/mimo-v2-omni",
+      fallback: "xiaomi/mimo-v2-omni",
+      prompt_append: "Visual task. Analyze design/screenshot first→implement→verify pixel+a11y+responsive match spec.",
+    },
+    ultrabrain: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Max reasoning. Full budget. Multi-path→verify step-by-step→challenge assumptions. No shortcuts.",
+    },
+    deep: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Deep work. Full analysis before acting. Second-order effects. Correct>fast. Document complex decisions.",
+    },
+    artistry: {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Craft task. Elegant+clear+readable. Senior-quality. No cleverness over maintainability.",
+    },
+    quick: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "xiaomi/mimo-v2.5",
+      prompt_append: "Speed. Right+simple. Done.",
+    },
+    "unspecified-low": {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "xiaomi/mimo-v2.5-pro",
+      prompt_append: "Standard. Complete+correct. Report changes only.",
+    },
+    "unspecified-high": {
+      model: "opencode/gemini-3.1-pro",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "High-stakes. Senior judgment. Edge cases. Robust over clever.",
+    },
+    writing: {
+      model: "xiaomi/mimo-v2.5",
+      fallback: "opencode/gemini-3.1-pro",
+      prompt_append: "Writing. Clarity>verbosity. Precise. Active voice. No filler. Audience-appropriate.",
+    },
+  },
+} satisfies typeof Preset.Type
+
+export async function load(dir: string) {
+  const file = path.join(dir, "agent.json")
+  if (!Bun.file(file).size) {
+    await fs.mkdir(dir, { recursive: true })
+    await Bun.write(file, JSON.stringify(DEFAULT_PRESET, null, 2))
+  }
+
+  const preset = ConfigParse.schema(Preset, ConfigParse.jsonc(await Bun.file(file).text(), file), file)
+  return {
+    agent: {
+      ...Object.fromEntries(
+        Object.entries(preset.agents ?? {}).map(([name, entry]) => [
+          name,
+          toAgent(entry, PRIMARY_PRESET_AGENTS.has(name) ? "all" : "subagent"),
+        ]),
+      ),
+      ...Object.fromEntries(
+        Object.entries(preset.categories ?? {}).map(([name, entry]) => [name, toAgent(entry, "subagent")]),
+      ),
+    },
+  }
+}
+
+function toAgent(entry: typeof Entry.Type, mode: "all" | "subagent") {
+  return {
+    model: entry.model,
+    mode,
+    description: entry.prompt_append,
+    options: {
+      fallback: entry.fallback,
+      prompt_append: entry.prompt_append,
+    },
+  } satisfies ConfigAgentV1.Info
+}

package/src/config/agent.ts

@@ -0,0 +1,59 @@
+export * as ConfigAgent from "./agent"
+
+import path from "path"
+import { Exit, Schema } from "effect"
+import { Glob } from "@miaw/core/util/glob"
+import { ConfigAgentV1 } from "@miaw/core/v1/config/agent"
+import { configEntryNameFromPath } from "./entry-name"
+import * as ConfigMarkdown from "./markdown"
+import { ConfigParse } from "./parse"
+
+export async function load(dir: string) {
+  const result: Record<string, ConfigAgentV1.Info> = {}
+  for (const item of await Glob.scan("{agent,agents}/**/*.md", {
+    cwd: dir,
+    absolute: true,
+    dot: true,
+    symlink: true,
+  })) {
+    const md = await ConfigMarkdown.parse(item).catch(() => undefined)
+    if (!md) continue
+
+    const name = configEntryNameFromPath(path.relative(dir, item), ["agent/", "agents/"])
+
+    const config = {
+      name,
+      ...md.data,
+      prompt: md.content.trim(),
+    }
+    result[config.name] = ConfigParse.schema(ConfigAgentV1.Info, config, item)
+  }
+  return result
+}
+
+export async function loadMode(dir: string) {
+  const result: Record<string, ConfigAgentV1.Info> = {}
+  for (const item of await Glob.scan("{mode,modes}/*.md", {
+    cwd: dir,
+    absolute: true,
+    dot: true,
+    symlink: true,
+  })) {
+    const md = await ConfigMarkdown.parse(item).catch(() => undefined)
+    if (!md) continue
+
+    const config = {
+      name: configEntryNameFromPath(path.relative(dir, item), ["mode/", "modes/"]),
+      ...md.data,
+      prompt: md.content.trim(),
+    }
+    const parsed = Schema.decodeUnknownExit(ConfigAgentV1.Info)(config, { errors: "all", propertyOrder: "original" })
+    if (Exit.isSuccess(parsed)) {
+      result[config.name] = {
+        ...parsed.value,
+        mode: "primary" as const,
+      }
+    }
+  }
+  return result
+}

package/src/config/command.ts

@@ -0,0 +1,39 @@
+export * as ConfigCommand from "./command"
+
+import path from "path"
+import { Cause, Exit, Schema } from "effect"
+import { Glob } from "@miaw/core/util/glob"
+import { ConfigCommandV1 } from "@miaw/core/v1/config/command"
+import { configEntryNameFromPath } from "./entry-name"
+import { InvalidError } from "@miaw/core/v1/config/error"
+import * as ConfigMarkdown from "./markdown"
+
+const decodeInfo = Schema.decodeUnknownExit(ConfigCommandV1.Info)
+
+export async function load(dir: string) {
+  const result: Record<string, ConfigCommandV1.Info> = {}
+  for (const item of await Glob.scan("{command,commands}/**/*.md", {
+    cwd: dir,
+    absolute: true,
+    dot: true,
+    symlink: true,
+  })) {
+    const md = await ConfigMarkdown.parse(item).catch(() => undefined)
+    if (!md) continue
+
+    const name = configEntryNameFromPath(path.relative(dir, item), ["command/", "commands/"])
+
+    const config = {
+      name,
+      ...md.data,
+      template: md.content.trim(),
+    }
+    const parsed = decodeInfo(config, { errors: "all", propertyOrder: "original" })
+    if (Exit.isSuccess(parsed)) {
+      result[config.name] = parsed.value
+      continue
+    }
+    throw new InvalidError({ path: item, message: Cause.pretty(parsed.cause) }, { cause: Cause.squash(parsed.cause) })
+  }
+  return result
+}