minicode-ai 0.9.26

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 (162) hide show
  1. package/CHANGELOG.md +935 -0
  2. package/LICENSE +21 -0
  3. package/README.md +200 -0
  4. package/cli/args.ts +195 -0
  5. package/cli/auto-update.ts +108 -0
  6. package/cli/commands/auth.ts +166 -0
  7. package/cli/commands/config.ts +382 -0
  8. package/cli/commands/doctor.ts +128 -0
  9. package/cli/commands/exec.ts +179 -0
  10. package/cli/commands/mcp.ts +35 -0
  11. package/cli/commands/memory.ts +107 -0
  12. package/cli/commands/pricing.ts +100 -0
  13. package/cli/commands/providers.ts +162 -0
  14. package/cli/commands/sessions.ts +128 -0
  15. package/cli/commands/skills.ts +61 -0
  16. package/cli/commands/stats.ts +82 -0
  17. package/cli/commands.ts +317 -0
  18. package/cli/index.ts +539 -0
  19. package/cli/model-manager.ts +112 -0
  20. package/cli/provider-manager.ts +111 -0
  21. package/cli/repl.ts +734 -0
  22. package/cli/router.ts +124 -0
  23. package/cli/setup.ts +780 -0
  24. package/cli/wizard.ts +21 -0
  25. package/docs/ARCHITECTURE.html +1222 -0
  26. package/docs/README.md +109 -0
  27. package/docs/architecture.md +44 -0
  28. package/docs/changelog.md +3 -0
  29. package/package.json +91 -0
  30. package/src/agents/pool.ts +43 -0
  31. package/src/app/mentions.ts +50 -0
  32. package/src/app/provider-layer.ts +118 -0
  33. package/src/app/rag-layer.ts +105 -0
  34. package/src/app/session.ts +154 -0
  35. package/src/app/tool-layer.ts +56 -0
  36. package/src/config.ts +372 -0
  37. package/src/constants.ts +119 -0
  38. package/src/hooks/run.ts +89 -0
  39. package/src/lib/atomic-write.ts +88 -0
  40. package/src/lib/db-path.ts +36 -0
  41. package/src/lib/git-hardening.ts +91 -0
  42. package/src/lib/ignore.ts +58 -0
  43. package/src/lib/keystore.ts +202 -0
  44. package/src/lib/net.ts +70 -0
  45. package/src/lib/safe-open.ts +138 -0
  46. package/src/lib/session-id.ts +23 -0
  47. package/src/lib/trash.ts +38 -0
  48. package/src/lib/trusted-exec.ts +81 -0
  49. package/src/lsp/client.ts +395 -0
  50. package/src/mcp/client.ts +400 -0
  51. package/src/mcp/http-transport.ts +344 -0
  52. package/src/mcp/server.ts +538 -0
  53. package/src/mcp/transport.ts +150 -0
  54. package/src/memory/files.ts +159 -0
  55. package/src/memory/vector.ts +775 -0
  56. package/src/policy/allowlist.ts +67 -0
  57. package/src/policy/bash-guard.ts +465 -0
  58. package/src/policy/compaction.ts +271 -0
  59. package/src/policy/context.ts +161 -0
  60. package/src/policy/executor.ts +199 -0
  61. package/src/policy/jail.ts +127 -0
  62. package/src/policy/permission.ts +517 -0
  63. package/src/policy/pricing.ts +336 -0
  64. package/src/policy/ratelimit.ts +54 -0
  65. package/src/policy/sandbox-policy.ts +157 -0
  66. package/src/policy/scrub.ts +138 -0
  67. package/src/policy/update-check.ts +200 -0
  68. package/src/policy/usage.ts +292 -0
  69. package/src/policy/verifier.ts +181 -0
  70. package/src/providers/anthropic.ts +401 -0
  71. package/src/providers/auth-store.ts +139 -0
  72. package/src/providers/build.ts +136 -0
  73. package/src/providers/detect.ts +126 -0
  74. package/src/providers/effort.ts +165 -0
  75. package/src/providers/guards.ts +107 -0
  76. package/src/providers/oauth.ts +326 -0
  77. package/src/providers/presets.ts +122 -0
  78. package/src/providers/provision.ts +298 -0
  79. package/src/providers/responses.ts +371 -0
  80. package/src/providers/router.ts +247 -0
  81. package/src/repo/repomap.ts +470 -0
  82. package/src/sandbox/docker.ts +129 -0
  83. package/src/sandbox/os.ts +193 -0
  84. package/src/session/checkpoint.ts +543 -0
  85. package/src/session/journal.ts +1347 -0
  86. package/src/session/persistence.ts +446 -0
  87. package/src/session/shadow-git.ts +351 -0
  88. package/src/session/turn-marker.ts +118 -0
  89. package/src/skills/loader.ts +117 -0
  90. package/src/telemetry/trace.ts +283 -0
  91. package/src/tools/ask_user.ts +54 -0
  92. package/src/tools/bash.ts +400 -0
  93. package/src/tools/code_run.ts +96 -0
  94. package/src/tools/delete_file.ts +31 -0
  95. package/src/tools/edit.ts +204 -0
  96. package/src/tools/git.ts +301 -0
  97. package/src/tools/glob.ts +90 -0
  98. package/src/tools/grep.ts +281 -0
  99. package/src/tools/hashline.ts +66 -0
  100. package/src/tools/index.ts +103 -0
  101. package/src/tools/lsp.ts +346 -0
  102. package/src/tools/mcp_call.ts +163 -0
  103. package/src/tools/memory.ts +144 -0
  104. package/src/tools/move_file.ts +47 -0
  105. package/src/tools/patch.ts +86 -0
  106. package/src/tools/read_file.ts +130 -0
  107. package/src/tools/read_image.ts +80 -0
  108. package/src/tools/submit_result.ts +49 -0
  109. package/src/tools/task.ts +346 -0
  110. package/src/tools/todo.ts +201 -0
  111. package/src/tools/web_fetch.ts +161 -0
  112. package/src/tools/web_search.ts +156 -0
  113. package/src/tools/write_file.ts +42 -0
  114. package/src/ui/approval/prompt.ts +76 -0
  115. package/src/ui/assistant/simple.ts +568 -0
  116. package/src/ui/assistant/turn-status.ts +303 -0
  117. package/src/ui/contract.ts +55 -0
  118. package/src/ui/footer.ts +105 -0
  119. package/src/ui/input/input.ts +805 -0
  120. package/src/ui/input/prompt-engine.ts +606 -0
  121. package/src/ui/render/collapse.ts +84 -0
  122. package/src/ui/render/detail.ts +24 -0
  123. package/src/ui/render/diff.ts +181 -0
  124. package/src/ui/render/errors.ts +239 -0
  125. package/src/ui/render/format.ts +54 -0
  126. package/src/ui/render/highlight.ts +294 -0
  127. package/src/ui/render/markdown.ts +120 -0
  128. package/src/ui/render/money.ts +12 -0
  129. package/src/ui/render/reasoning.ts +20 -0
  130. package/src/ui/render/sanitize.ts +80 -0
  131. package/src/ui/render/table.ts +88 -0
  132. package/src/ui/render/theme.ts +339 -0
  133. package/src/ui/render/width.ts +256 -0
  134. package/src/ui/render/wrap.ts +120 -0
  135. package/src/ui/runtime/bus-debug.ts +83 -0
  136. package/src/ui/runtime/chrome.ts +301 -0
  137. package/src/ui/runtime/spinner.ts +77 -0
  138. package/src/ui/runtime/statusline.ts +227 -0
  139. package/src/ui/screens/model-manager.ts +434 -0
  140. package/src/ui/screens/overlay.ts +61 -0
  141. package/src/ui/screens/picker.ts +307 -0
  142. package/src/ui/screens/provider-manager.ts +450 -0
  143. package/src/ui/screens/wizard.ts +132 -0
  144. package/vendor/minicore/VENDOR.md +29 -0
  145. package/vendor/minicore/package.json +21 -0
  146. package/vendor/minicore/src/core/budget.ts +26 -0
  147. package/vendor/minicore/src/core/compact.ts +76 -0
  148. package/vendor/minicore/src/core/errors.ts +60 -0
  149. package/vendor/minicore/src/core/events.ts +74 -0
  150. package/vendor/minicore/src/core/executor.ts +139 -0
  151. package/vendor/minicore/src/core/history.ts +32 -0
  152. package/vendor/minicore/src/core/index.ts +42 -0
  153. package/vendor/minicore/src/core/loop.ts +344 -0
  154. package/vendor/minicore/src/core/permission.ts +24 -0
  155. package/vendor/minicore/src/core/provider.ts +39 -0
  156. package/vendor/minicore/src/core/recovery.ts +34 -0
  157. package/vendor/minicore/src/core/session.ts +327 -0
  158. package/vendor/minicore/src/core/snapshot.ts +142 -0
  159. package/vendor/minicore/src/core/tokens.ts +111 -0
  160. package/vendor/minicore/src/core/tool.ts +118 -0
  161. package/vendor/minicore/src/core/types.ts +50 -0
  162. package/vendor/minicore/src/providers/openai-compat.ts +366 -0
@@ -0,0 +1,128 @@
1
+ import { Database } from "bun:sqlite"
2
+ import { existsSync, mkdirSync } from "node:fs"
3
+ import { homedir } from "node:os"
4
+ import { dirname, join, resolve } from "node:path"
5
+ import { homeDir } from "../../src/lib/db-path.ts"
6
+ import { deleteJournalFile, findOrphanJournals } from "../../src/session/journal.ts"
7
+ import {
8
+ getSessionTtlDays,
9
+ listSessions,
10
+ loadSession,
11
+ purgeExpired,
12
+ } from "../../src/session/persistence.ts"
13
+ import { renderTable } from "../../src/ui/render/table.ts"
14
+ import { c } from "../../src/ui/render/theme.ts"
15
+
16
+ const SESSIONS_HELP = `minicode sessions — session history
17
+
18
+ minicode sessions list list recent sessions
19
+ minicode sessions export <id> [--jsonl] export message history
20
+ minicode sessions purge remove expired sessions (TTL)`
21
+
22
+ export async function handleSessions(
23
+ args: string[],
24
+ getArg: (name: string) => string | undefined,
25
+ ): Promise<never> {
26
+ const sub = args[1]
27
+ if (sub === "list" || !sub) {
28
+ const cwdArg = getArg("--cwd")
29
+ const rows = listSessions(cwdArg)
30
+ if (rows.length === 0) console.log(c.dim("(no recorded sessions yet)"))
31
+ else {
32
+ const tableData = rows.map((r) => ({
33
+ id: c.cyan(r.id),
34
+ date: new Date(r.created_at).toLocaleString(),
35
+ cwd: c.dim(r.cwd),
36
+ }))
37
+ console.log(
38
+ `\n${c.bold("Recent Sessions")}\n` +
39
+ renderTable(
40
+ [
41
+ { header: "Session ID", key: "id", width: 14 },
42
+ { header: "Created", key: "date", width: 22 },
43
+ { header: "Workspace", key: "cwd", width: 40 },
44
+ ],
45
+ tableData,
46
+ ) +
47
+ "\n",
48
+ )
49
+ }
50
+ process.exit(0)
51
+ } else if (sub === "export") {
52
+ // args[2] bisa berupa flag bila user lupa id (`sessions export --cwd x`);
53
+ // memperlakukannya sebagai id menghasilkan pesan "sesi --cwd tidak ditemukan".
54
+ const id = args[2] && !args[2]!.startsWith("-") ? args[2] : undefined
55
+ const asJsonl = args.includes("--jsonl")
56
+ if (!id) {
57
+ console.error("usage: minicode sessions export <id> [--jsonl]")
58
+ process.exit(1)
59
+ }
60
+ const sess = loadSession(id, getArg("--cwd"))
61
+ if (!sess) {
62
+ console.error(`session "${id}" not found - see: minicode sessions list`)
63
+ process.exit(1)
64
+ }
65
+ if (asJsonl) for (const m of sess.messages) console.log(JSON.stringify(m))
66
+ else console.log(JSON.stringify(sess, null, 2))
67
+ process.exit(0)
68
+ } else if (sub === "purge") {
69
+ const cwdArg = getArg("--cwd")
70
+ const localPath = resolve(cwdArg ?? process.cwd(), ".minicode", "sessions.db")
71
+ const dbPath = existsSync(localPath)
72
+ ? localPath
73
+ : (() => {
74
+ const g = join(homedir(), ".minicode")
75
+ mkdirSync(g, { recursive: true })
76
+ return join(g, "sessions.db")
77
+ })()
78
+ const db = new Database(dbPath)
79
+ try {
80
+ // Jurnal mengikuti lifecycle sesi: hapus file jurnal milik sesi yang
81
+ // akan di-purge (best-effort) sebelum baris DB-nya hilang.
82
+ try {
83
+ const days = getSessionTtlDays()
84
+ if (days > 0) {
85
+ const cutoff = Date.now() - days * 24 * 60 * 60 * 1000
86
+ const stale = db
87
+ .prepare("SELECT id FROM sessions WHERE COALESCE(updated_at, created_at) < ?")
88
+ .all(cutoff) as { id: string }[]
89
+ const journalCwd = existsSync(localPath) ? (cwdArg ?? process.cwd()) : homeDir()
90
+ for (const s of stale) deleteJournalFile(s.id, journalCwd)
91
+ }
92
+ } catch {}
93
+ const removed = purgeExpired(db)
94
+ // Yatim: jurnal milik sesi yang sudah tak ada di tabel (termasuk anak
95
+ // yang tak pernah persist) + tak dirujuk parent hidup + lebih tua dari
96
+ // TTL. Unreadable tak pernah dihapus (tak terbukti yatim).
97
+ let orphans = 0
98
+ try {
99
+ const journalDir = join(dirname(dbPath), "")
100
+ const alive = new Set(
101
+ (
102
+ db.prepare("SELECT id FROM sessions").all() as {
103
+ id: string
104
+ }[]
105
+ ).map((r) => r.id),
106
+ )
107
+ const { unlinkSync } = await import("node:fs")
108
+ for (const f of await findOrphanJournals(journalDir, alive, getSessionTtlDays())) {
109
+ try {
110
+ unlinkSync(f)
111
+ orphans += 1
112
+ } catch {}
113
+ }
114
+ } catch {}
115
+ const ttl = getSessionTtlDays()
116
+ console.log(`[purge] removed ${removed} sessions (older than ${ttl} days)`)
117
+ if (orphans > 0) console.log(`[purge] removed ${orphans} orphan journals`)
118
+ } finally {
119
+ db.close()
120
+ }
121
+ process.exit(0)
122
+ } else {
123
+ const asked = sub === "--help" || sub === "-h"
124
+ if (!asked) console.error(`unknown sessions subcommand: ${sub}\n`)
125
+ console.log(SESSIONS_HELP)
126
+ process.exit(asked ? 0 : 1)
127
+ }
128
+ }
@@ -0,0 +1,61 @@
1
+ import { findSkill, loadSkills } from "../../src/skills/loader.ts"
2
+ import { renderTable } from "../../src/ui/render/table.ts"
3
+ import { c } from "../../src/ui/render/theme.ts"
4
+
5
+ const SKILLS_HELP = `minicode skills — markdown skills in .minicode/skills/*.md
6
+
7
+ minicode skills list list installed skills
8
+ minicode skills show <name> show one skill
9
+
10
+ In REPL, run a skill with /name [arguments].`
11
+
12
+ export async function handleSkills(
13
+ args: string[],
14
+ getArg: (name: string) => string | undefined,
15
+ ): Promise<never> {
16
+ const cwdArg = getArg("--cwd")
17
+ const sub = args[1]
18
+ if (sub === "list" || sub === undefined) {
19
+ const all = await loadSkills(cwdArg)
20
+ if (all.length === 0) {
21
+ console.log(c.dim("(no skills yet - add markdown files in .minicode/skills/*.md)"))
22
+ process.exit(0)
23
+ }
24
+ const tableData = all.map((s) => ({
25
+ skill: c.yellow(`/${s.name}`),
26
+ desc: s.description || "(no description)",
27
+ }))
28
+ console.log(
29
+ `\n${c.bold("Installed Skills")}\n` +
30
+ renderTable(
31
+ [
32
+ { header: "Command", key: "skill", width: 18 },
33
+ { header: "Description", key: "desc", width: 56 },
34
+ ],
35
+ tableData,
36
+ ) +
37
+ "\n",
38
+ )
39
+ process.exit(0)
40
+ }
41
+ if (sub === "show") {
42
+ // Tolak flag sebagai nama: `skills show --cwd x` adalah lupa argumen,
43
+ // bukan permintaan skill bernama "--cwd".
44
+ const name = args[2] && !args[2]!.startsWith("-") ? args[2] : undefined
45
+ if (!name) {
46
+ console.error("usage: minicode skills show <name>")
47
+ process.exit(1)
48
+ }
49
+ const s = await findSkill(name, cwdArg)
50
+ if (!s) {
51
+ console.error(`skill "${name}" not found - see: minicode skills list`)
52
+ process.exit(1)
53
+ }
54
+ console.log(`${c.bold(c.cyan(`/${s.name}`))} ${c.dim(`- ${s.description}`)}\n\n${s.body}`)
55
+ process.exit(0)
56
+ }
57
+ const asked = sub === "--help" || sub === "-h"
58
+ if (!asked) console.error(`unknown skills subcommand: ${sub}\n`)
59
+ console.log(SKILLS_HELP)
60
+ process.exit(asked ? 0 : 1)
61
+ }
@@ -0,0 +1,82 @@
1
+ import { readFileSync } from "node:fs"
2
+ import { resolve } from "node:path"
3
+ import { type StepTrace, summarizeStepTraces } from "../../src/telemetry/trace.ts"
4
+ import { c } from "../../src/ui/render/theme.ts"
5
+
6
+ interface TraceRow {
7
+ ok?: boolean
8
+ inputTokens?: number
9
+ outputTokens?: number
10
+ cost?: number
11
+ durationMs?: number
12
+ }
13
+
14
+ export async function handleStats(getArg: (name: string) => string | undefined): Promise<never> {
15
+ const cwdArg = getArg("--cwd")
16
+ const asJson = getArg("--json") !== undefined || process.argv.includes("--json")
17
+ const file = resolve(cwdArg ?? ".", ".minicode", "traces.jsonl")
18
+ let traces: TraceRow[] = []
19
+ try {
20
+ traces = readFileSync(file, "utf8")
21
+ .split("\n")
22
+ .filter(Boolean)
23
+ .flatMap((l) => {
24
+ try {
25
+ return [JSON.parse(l) as TraceRow]
26
+ } catch {
27
+ return []
28
+ }
29
+ })
30
+ } catch {}
31
+ const total = traces.length
32
+ const ok = traces.filter((t) => t.ok).length
33
+ const inputTokens = traces.reduce((s, t) => s + (t.inputTokens ?? 0), 0)
34
+ const outputTokens = traces.reduce((s, t) => s + (t.outputTokens ?? 0), 0)
35
+ const cost = traces.reduce((s, t) => s + (t.cost ?? 0), 0)
36
+ const avgMs = total ? Math.round(traces.reduce((s, t) => s + (t.durationMs ?? 0), 0) / total) : 0
37
+
38
+ // Harness-P3: agregat step-trace (P1.2) — deny-rate, tool bermasalah,
39
+ // mode sandbox. Berkas tak ada/rusak = nol, bukan crash.
40
+ let stepRows: StepTrace[] = []
41
+ try {
42
+ stepRows = readFileSync(resolve(cwdArg ?? ".", ".minicode", "step-traces.jsonl"), "utf8")
43
+ .split("\n")
44
+ .filter(Boolean)
45
+ .flatMap((l) => {
46
+ try {
47
+ return [JSON.parse(l) as StepTrace]
48
+ } catch {
49
+ return []
50
+ }
51
+ })
52
+ } catch {}
53
+ const steps = summarizeStepTraces(stepRows)
54
+
55
+ // --json dulu diterima tanpa keluhan lalu diabaikan; kini benar-benar bekerja.
56
+ if (asJson) {
57
+ console.log(
58
+ JSON.stringify({
59
+ runs: total,
60
+ resolved: ok,
61
+ inputTokens,
62
+ outputTokens,
63
+ cost,
64
+ avgMs,
65
+ steps,
66
+ }),
67
+ )
68
+ process.exit(0)
69
+ }
70
+ console.log(
71
+ `Runs: ${total} · Resolved: ${ok}/${total} · Tokens in=${inputTokens} out=${outputTokens} · Cost: $${cost.toFixed(4)} · Avg ${avgMs}ms`,
72
+ )
73
+ if (total === 0) console.log(c.dim(` (no traces yet in ${file})`))
74
+ if (steps.tools > 0) {
75
+ const topDeny = steps.topDenied.map((t) => `${t.tool}×${t.n}`).join(", ")
76
+ const topReason = steps.topDenyReasons.map((r) => `${r.reason}×${r.n}`).join(", ")
77
+ console.log(
78
+ `Tools: ${steps.tools} · Denied: ${steps.denied} (${(steps.denyRate * 100).toFixed(1)}%) · Errors: ${steps.errors}${topDeny ? ` · Top denied: ${topDeny}` : ""}${topReason ? ` · Reason: ${topReason}` : ""}${steps.sandboxes.length ? ` · Sandbox: ${steps.sandboxes.join(",")}` : ""}`,
79
+ )
80
+ }
81
+ process.exit(0)
82
+ }
@@ -0,0 +1,317 @@
1
+ import { resolve as resolvePath } from "node:path"
2
+ import { loadConfig } from "../src/config.ts"
3
+ import type { Usage } from "../src/policy/usage.ts"
4
+ import { refreshProviderModels } from "../src/providers/provision.ts"
5
+ import { listSessions, loadSession } from "../src/session/persistence.ts"
6
+ import type { Skill } from "../src/skills/loader.ts"
7
+ import { formatUsd } from "../src/ui/render/money.ts"
8
+ import { glyphs } from "../src/ui/render/theme.ts"
9
+ import { padToWidth } from "../src/ui/render/width.ts"
10
+
11
+ // SEMUA output = PLAIN TEXT tanpa ANSI.
12
+ // Readline + ANSI di Windows = karakter escape bocor jadi teks literal.
13
+
14
+ export interface CommandContext {
15
+ cwd?: string
16
+ sessionId: string
17
+ /** Flag --allow-local-config sesi ini — diteruskan ke manager/refresh agar
18
+ * konsisten dengan provider/tool yang aktif (default deny). */
19
+ allowLocalConfig?: boolean
20
+ currentModel?: string
21
+ usage: {
22
+ /** Pemakaian turn terakhir. */
23
+ get: (model?: string) => Usage
24
+ /** Pemakaian kumulatif seluruh sesi — yang dilaporkan `/status` (/cost = alias). */
25
+ getSession: (model?: string) => Usage
26
+ reset: () => void
27
+ modelUsed: () => { effective?: string; provider?: string }
28
+ }
29
+ skills: Skill[]
30
+ toolsCount: number
31
+ providerHint?: string
32
+ setModelOverride: (model: string) => void
33
+ /** Kontrak control-plane (Phase 6): angka konteks SAAT INI dari sumber
34
+ * kebenaran kernel (estimateSessionContext) — bukan usage kumulatif.
35
+ * Dibedakan dari Input/Output/Total (provider usage) di /status. */
36
+ getContextTokens: () => number
37
+ /** Status budget sesi (ok | over | unknown-strict) — keputusan terpusat
38
+ * budgetStatus; /status menampilkannya eksplisit, bukan menyimpulkan dari
39
+ * angka. */
40
+ budgetState: () => "ok" | "over" | "unknown-strict"
41
+ }
42
+
43
+ /**
44
+ * Slash commands exposed by the interactive CLI.
45
+ * Keep this list intentionally small: every entry is a command users can
46
+ * discover and use, not an alias for another command.
47
+ */
48
+ export interface BuiltinCommand {
49
+ name: string
50
+ args?: string
51
+ desc: string
52
+ hidden?: boolean
53
+ }
54
+
55
+ export const BUILTIN_COMMANDS: BuiltinCommand[] = [
56
+ { name: "help", desc: "Show commands" },
57
+ { name: "provider", desc: "Manage providers" },
58
+ { name: "model", desc: "Manage and select models" },
59
+ { name: "sync", desc: "Refresh provider models" },
60
+ { name: "status", desc: "Show session status and usage" },
61
+ { name: "sessions", desc: "List, inspect, and resume sessions" },
62
+ { name: "init", desc: "Create AGENTS.md" },
63
+ { name: "exit", desc: "Exit" },
64
+ ]
65
+
66
+ /** Perintah yang ditangani DRIVER REPL (bukan handleBuiltinCommand) —
67
+ * ditampilkan di /help agar bisa ditemukan, tapi sengaja TIDAK masuk dropdown
68
+ * completion (di dropdown cukup /compact + builtin; /mode tak perlu
69
+ * karena Tab/Shift+Tab sudah memutar mode tanpa baris baru).
70
+ * /thinking = toggle TAMPILAN reasoning (expand/minimize), bukan effort;
71
+ * effort diatur lewat picker /model (Enter).
72
+ * Opsi A audit UX: undo/redo/clear/copy/history tidak punya duplikat lain. */
73
+ export const DRIVER_HELP_COMMANDS: BuiltinCommand[] = [
74
+ { name: "mode", args: "[name]", desc: "Show or set permission mode" },
75
+ { name: "undo", desc: "Revert file changes from the last turn" },
76
+ { name: "redo", desc: "Re-apply reverted changes" },
77
+ { name: "clear", desc: "Mark a boundary (scrollback preserved)" },
78
+ { name: "copy", desc: "Copy last turn to clipboard (OSC 52)" },
79
+ { name: "history", desc: "Show recent prompt history" },
80
+ ]
81
+
82
+ /** Pintasan papan tombol — didokumentasikan di /help, bukan hanya di kode. */
83
+ const KEYBOARD_HELP: [string, string][] = [
84
+ ["enter", "submit"],
85
+ ["tab", "complete command (empty line: cycle mode)"],
86
+ ["shift+tab", "cycle permission mode"],
87
+ ["up / down", "history or picker navigation"],
88
+ ["left / right", "move cursor"],
89
+ ["home / end", "jump to line start / end"],
90
+ ["delete", "delete character at cursor"],
91
+ ["ctrl+a / ctrl+e", "line start / end"],
92
+ ["ctrl+r", "reverse-i-search prompt history"],
93
+ ["ctrl+j", "insert newline (multiline input)"],
94
+ ["ctrl+w", "delete previous word"],
95
+ ["ctrl+u", "clear line"],
96
+ ["ctrl+o", "toggle compact/expanded tool output"],
97
+ ["+ / -", "during turn: expand / minimize thinking & tool output"],
98
+ ["ctrl+t", "toggle expand/minimize thinking output"],
99
+ ["esc", "close dropdown / picker / cancel empty prompt"],
100
+ ["ctrl+c", "stop turn when busy; cancel prompt when idle (2x exit)"],
101
+ ["ctrl+d", "cancel prompt like ctrl+c"],
102
+ ["\\ at end of line", "continue input on the next line"],
103
+ ]
104
+
105
+ function pad(text: string, width: number): string {
106
+ return padToWidth(text, width)
107
+ }
108
+
109
+ /**
110
+ * Penanda hasil aksi yang seragam.
111
+ *
112
+ * Sebelumnya bercampur: `[OK]`/`[FAIL]` ASCII di /undo dan /model, kalimat biasa
113
+ * di /compact, tanpa penanda di /sync. `glyphs` sudah punya
114
+ * fallback ASCII untuk konsol legacy Windows, jadi memakainya aman di semua
115
+ * terminal.
116
+ */
117
+ // FUNGSI, bukan konstanta: `glyphs` adalah getter yang memeriksa dukungan UTF-8
118
+ // saat dipakai. Menyimpannya ke `const` di module scope membekukan nilai pada
119
+ // saat import — kesalahan yang sama seperti objek warna `c` dan glyph di TUI.
120
+ /** Petunjuk ke daftar pintasan lengkap, dipakai di /help. */
121
+
122
+ export async function handleBuiltinCommand(
123
+ rawInput: string,
124
+ ctx: CommandContext,
125
+ ): Promise<{ handled: boolean; shouldExit?: boolean }> {
126
+ const line = rawInput.trim()
127
+ if (!line.startsWith("/")) return { handled: false }
128
+
129
+ const spaceIdx = line.indexOf(" ")
130
+ const cmd = spaceIdx === -1 ? line.slice(1).toLowerCase() : line.slice(1, spaceIdx).toLowerCase()
131
+ const args = spaceIdx === -1 ? "" : line.slice(spaceIdx + 1).trim()
132
+
133
+ switch (cmd) {
134
+ case "help": {
135
+ // Ringkas: perintah utama + skill + pintasan yang paling sering dipakai.
136
+ // /help penuh 29 baris tidak muat di overlay terminal 24 baris, jadi
137
+ // pintasan lengkap dipindah ke `/help tombol`.
138
+ const wantKeys = /^(tombol|keys?|keyboard)$/i.test(args)
139
+ if (wantKeys) {
140
+ console.log("\nKeyboard:")
141
+ for (const [key, desc] of KEYBOARD_HELP) {
142
+ console.log(` ${pad(key, 22)}${desc}`)
143
+ }
144
+ console.log("")
145
+ return { handled: true }
146
+ }
147
+ console.log("\nCommands:")
148
+ for (const b of [...BUILTIN_COMMANDS, ...DRIVER_HELP_COMMANDS]) {
149
+ if (b.hidden) continue
150
+ const withArgs = b.args ? `${b.name} ${b.args}` : b.name
151
+ console.log(` /${pad(withArgs, 22)}${b.desc}`)
152
+ }
153
+ // Ringkas: perintah utama + skill + pintasan yang paling sering dipakai.
154
+ // Panjang baris di bawah ≤80 kolom (dijaga test) dan tak boleh menyebut
155
+ // /help tombol (juga dijaga test) — Ctrl+R satu-satunya yang paling
156
+ // sering dicari yang muat setelah Enter/Tab/Shift+Tab.
157
+ console.log("\nEnter · Tab(empty:mode) · Shift+Tab mode · Ctrl+R search · Ctrl+C 2x exit\n")
158
+ return { handled: true }
159
+ }
160
+
161
+ case "init": {
162
+ const target = resolvePath(ctx.cwd ?? process.cwd(), "AGENTS.md")
163
+ if (require("node:fs").existsSync(target)) {
164
+ console.log(`\nAGENTS.md already exists - not overwritten.\n`)
165
+ return { handled: true }
166
+ }
167
+ const { loadRepoMap } = await import("../src/repo/repomap.ts")
168
+ const map = await loadRepoMap(ctx.cwd ?? process.cwd())
169
+ const body = [
170
+ "# AGENTS.md",
171
+ "",
172
+ "Instructions for agents working in this repo.",
173
+ "",
174
+ "## Struktur (repo-map)",
175
+ "```",
176
+ map ?? "(repo-map empty)",
177
+ "```",
178
+ "",
179
+ "## Konvensi",
180
+ "- Ikuti gaya kode existing.",
181
+ "- Run typecheck/test before declaring done.",
182
+ "",
183
+ ].join("\n")
184
+ const { atomicWriteText } = await import("../src/lib/atomic-write.ts")
185
+ await atomicWriteText(target, body)
186
+ console.log(`\nAGENTS.md created: ${target}\n`)
187
+ return { handled: true }
188
+ }
189
+
190
+ case "exit":
191
+ console.log("Bye.")
192
+ return { handled: true, shouldExit: true }
193
+
194
+ case "model": {
195
+ const { runModelManager } = await import("./model-manager.ts")
196
+ // `/model mimo` = buka manager dengan filter awal (tanpa ini query
197
+ // diabaikan diam-diam).
198
+ await runModelManager({
199
+ cwd: ctx.cwd,
200
+ currentModel: ctx.currentModel,
201
+ setModelOverride: ctx.setModelOverride,
202
+ allowLocalConfig: ctx.allowLocalConfig,
203
+ ...(args ? { initialFilter: args } : {}),
204
+ })
205
+ return { handled: true }
206
+ }
207
+
208
+ case "provider": {
209
+ const { runProviderManager } = await import("./provider-manager.ts")
210
+ await runProviderManager({
211
+ cwd: ctx.cwd,
212
+ currentModel: ctx.currentModel,
213
+ setModelOverride: ctx.setModelOverride,
214
+ allowLocalConfig: ctx.allowLocalConfig,
215
+ })
216
+ return { handled: true }
217
+ }
218
+ case "status": {
219
+ // Kumulatif sesi, bukan turn terakhir — judulnya menjanjikan "biaya sesi".
220
+ const u = ctx.usage.getSession(ctx.currentModel)
221
+ // Kontrak control-plane (Phase 6): DUA angka berbeda, dua konsep —
222
+ // Context = ukuran jendela saat ini (kernel, estimateSessionContext);
223
+ // Total = pemakaian kumulatif provider (usage event). Dulu hanya Total
224
+ // yang tampil (label "konteks" di footer menyesatkan); kini /status
225
+ // membedakan Context vs Usage vs Cost vs Budget eksplisit.
226
+ const pinned = ctx.currentModel?.includes("::")
227
+ ? ctx.currentModel.slice(0, ctx.currentModel.indexOf("::"))
228
+ : undefined
229
+ const provider = ctx.usage.modelUsed().provider ?? pinned ?? ctx.providerHint ?? "-"
230
+ console.log(`\nSession ${ctx.sessionId}`)
231
+ console.log(` Model: ${ctx.currentModel ?? "default"}`)
232
+ console.log(` Provider: ${provider}`)
233
+ console.log(` Tools: ${ctx.toolsCount}`)
234
+ console.log(` Context: ~${ctx.getContextTokens().toLocaleString()} tok (window estimate)`)
235
+ console.log(` Input: ${u.inputTokens.toLocaleString()} (provider usage)`)
236
+ console.log(` Output: ${u.outputTokens.toLocaleString()} (provider usage)`)
237
+ console.log(` Total: ${u.totalTokens.toLocaleString()} (session cumulative)`)
238
+ console.log(
239
+ ` Cost: ${u.cost != null ? formatUsd(u.cost) : "N/A"} (estimated from price table)`,
240
+ )
241
+ console.log(
242
+ ` Budget: ${ctx.budgetState()}${u.cost == null ? " (cost unknown — model without pricing)" : ""}`,
243
+ )
244
+ console.log("")
245
+ return { handled: true }
246
+ }
247
+
248
+ case "sync": {
249
+ // Re-detect model dari semua provider -> config diperbarui otomatis.
250
+ // Meneruskan flag local sesi: tanpa opt-in /sync tak boleh menghubungi
251
+ // endpoint dari repo tak dikenal (audit #07 P0).
252
+ console.log("\nSyncing models…")
253
+ const { updated, failed } = await refreshProviderModels({
254
+ cwd: ctx.cwd,
255
+ allowLocal: ctx.allowLocalConfig,
256
+ })
257
+ if (!updated.length && !failed.length) {
258
+ // Bedakan "belum ada provider" dari "ada tapi deteksi kosong" —
259
+ // yang kedua jangan diklaim sebagai yang pertama.
260
+ const cfg = await loadConfig(ctx.cwd, { allowLocal: ctx.allowLocalConfig })
261
+ if (cfg.providers.length === 0) console.log(" No providers configured.")
262
+ else console.log(" No changes — check API key and network, then retry.")
263
+ } else {
264
+ for (const r of updated) {
265
+ console.log(` ${glyphs.check} ${r.id}: ${r.from} -> ${r.to} models`)
266
+ }
267
+ for (const f of failed) {
268
+ console.log(` ${glyphs.cross} ${f.id}: ${f.reason}`)
269
+ }
270
+ // "Restart" hanya jujur bila ADA model baru — tanpa updated, restart
271
+ // tak mengubah apa pun (sebelumnya selalu dicetak, menyesatkan saat
272
+ // semua provider gagal).
273
+ if (updated.length > 0) console.log(" Restart to use updated models.")
274
+ else console.log(" Nothing updated — check API keys and network above, then retry /sync.")
275
+ }
276
+ return { handled: true }
277
+ }
278
+
279
+ case "sessions": {
280
+ const rows = listSessions(ctx.cwd).slice(0, 25)
281
+ if (rows.length === 0) {
282
+ console.log("\nNo sessions.")
283
+ } else if (!args) {
284
+ console.log("\nSessions")
285
+ rows.forEach((r, i) => {
286
+ console.log(
287
+ ` [${i}] ${r.id.padEnd(14)} ${new Date(r.created_at).toLocaleString().padEnd(24)} ${r.cwd || "(cwd)"}`,
288
+ )
289
+ })
290
+ console.log(" Select a session to resume.")
291
+ }
292
+ if (rows.length > 0 && args) {
293
+ const target = args
294
+ const sess = loadSession(target, ctx.cwd)
295
+ if (!sess?.messages.length) {
296
+ console.log(`Session "${target}" not found or empty.`)
297
+ return { handled: true }
298
+ }
299
+ const { spawn } = await import("node:child_process")
300
+ const { waitChildExit } = await import("./auto-update.ts")
301
+ const entryPath = resolvePath(import.meta.dir, "index.ts")
302
+ const child = spawn(
303
+ process.execPath,
304
+ [entryPath, `--resume=${target}`, ...(ctx.cwd ? [`--cwd=${ctx.cwd}`] : [])],
305
+ { stdio: "inherit", env: { ...process.env, MINICODE_RESUME_NEW: "1" } },
306
+ )
307
+ void waitChildExit(child).then((code) => process.exit(code ?? 0))
308
+ process.stdin.pause()
309
+ }
310
+ console.log("")
311
+ return { handled: true }
312
+ }
313
+
314
+ default:
315
+ return { handled: false }
316
+ }
317
+ }