minicode-ai 0.28.0 → 0.30.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 (41) hide show
  1. package/README.md +1 -1
  2. package/cli/args.ts +93 -70
  3. package/cli/bootstrap/presentation-bridge.ts +383 -0
  4. package/cli/commands/acp.ts +7 -1
  5. package/cli/commands/doctor.ts +7 -3
  6. package/cli/commands/exec.ts +6 -16
  7. package/cli/index.ts +3 -2
  8. package/cli/setup.ts +13 -380
  9. package/cli/tui.ts +3 -4
  10. package/docs/TERMINAL_CONTRACT.md +28 -21
  11. package/docs/UI_RENDER_PIPELINE.md +3 -3
  12. package/docs/architecture.md +14 -29
  13. package/docs/environment.md +1 -1
  14. package/package.json +1 -1
  15. package/src/app/session.ts +201 -53
  16. package/src/app/tool-layer.ts +27 -0
  17. package/src/lib/atomic-write.ts +31 -59
  18. package/src/policy/jail.ts +6 -8
  19. package/src/providers/anthropic.ts +16 -5
  20. package/src/providers/responses.ts +37 -7
  21. package/src/providers/sse-bounds.ts +6 -4
  22. package/src/session/db/runs.ts +397 -0
  23. package/src/session/db/schema.ts +358 -0
  24. package/src/session/persistence.ts +64 -955
  25. package/src/task/db/schema.ts +325 -0
  26. package/src/task/db/types.ts +269 -0
  27. package/src/task/store.ts +74 -986
  28. package/src/ui/assistant/simple.ts +25 -19
  29. package/src/ui/i18n/en.ts +0 -3
  30. package/src/ui/i18n/id.ts +0 -3
  31. package/src/ui/render/logo.ts +15 -18
  32. package/src/ui/render/markdown-layout.ts +293 -0
  33. package/src/ui/render/markdown.ts +36 -44
  34. package/src/ui/render/session-summary.ts +1 -1
  35. package/src/ui/render/table-grid.ts +16 -7
  36. package/src/ui/render/width.ts +71 -18
  37. package/src/ui/render/wrap.ts +39 -22
  38. package/src/ui/session-state.ts +4 -4
  39. package/src/ui/tui/app.ts +15 -36
  40. package/src/ui/tui/transcript.ts +111 -50
  41. package/vendor/minicore/src/providers/openai-compat.ts +7 -0
@@ -0,0 +1,358 @@
1
+ import { Database } from "bun:sqlite"
2
+ import { LIMITS } from "../../constants.ts"
3
+ import { resolveDbPath, resolveLocalDbPath, withSqliteBusyRetrySync } from "../../lib/db-path.ts"
4
+
5
+ export const dbPath = (cwd?: string, local = false): string =>
6
+ local ? resolveLocalDbPath("sessions.db", cwd) : resolveDbPath("sessions.db", cwd)
7
+
8
+ const initializedSessionPaths = new Set<string>()
9
+ const migratedSessionPaths = new Set<string>()
10
+
11
+ function daemonApprovalsMigrated(db: Database): boolean {
12
+ try {
13
+ const cols = db.prepare("PRAGMA table_info(daemon_approvals)").all() as { name: string }[]
14
+ if (!cols.some((c) => c.name === "invocation_id")) return false
15
+ const sessCols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
16
+ return sessCols.some((c) => c.name === "work_mode")
17
+ } catch {
18
+ return false
19
+ }
20
+ }
21
+
22
+ const DB_INIT_ATTEMPTS = 8
23
+
24
+ export function withBusyRetrySync<T>(fn: () => T, attempts = DB_INIT_ATTEMPTS): T | null {
25
+ return withSqliteBusyRetrySync(fn, {
26
+ attempts,
27
+ deterministicJitter: true,
28
+ onGiveUp: (last, n) => {
29
+ process.stderr.write(
30
+ `[warn] persistence: schema setup gave up after ${n} attempts: ${String((last as Error)?.message ?? last)}\n`,
31
+ )
32
+ },
33
+ })
34
+ }
35
+
36
+ function threadsTableNeedsP24Rebuild(db: Database): boolean {
37
+ try {
38
+ const cols = db.prepare("PRAGMA table_info(threads)").all() as { name: string; pk: number }[]
39
+ if (cols.length === 0) return false
40
+ const pk = cols
41
+ .filter((c) => c.pk > 0)
42
+ .sort((a, b) => a.pk - b.pk)
43
+ .map((c) => c.name)
44
+ return !(pk.length === 2 && pk[0] === "session_id" && pk[1] === "thread_id")
45
+ } catch {
46
+ return false
47
+ }
48
+ }
49
+
50
+ function projectionsTableNeedsP24Rebuild(db: Database): boolean {
51
+ try {
52
+ const cols = db.prepare("PRAGMA table_info(history_projections)").all() as { name: string }[]
53
+ if (cols.length === 0) return false
54
+ return !cols.some((c) => c.name === "session_id")
55
+ } catch {
56
+ return false
57
+ }
58
+ }
59
+
60
+ function assertEmptyTableForRebuild(db: Database, table: string): void {
61
+ let exists = false
62
+ try {
63
+ const row = db
64
+ .prepare("SELECT 1 AS ok FROM sqlite_master WHERE type = 'table' AND name = ?")
65
+ .get(table) as { ok: number } | null
66
+ exists = row !== null
67
+ } catch {
68
+ return
69
+ }
70
+ if (!exists) return
71
+ const n = (db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get() as { n: number }).n
72
+ if (n > 0) {
73
+ throw new Error(
74
+ `[persistence] refusing to rebuild non-empty table ${table} (${n} rows) — migrate, never destroy`,
75
+ )
76
+ }
77
+ }
78
+
79
+ export function openSessionHandle(cwd?: string, local = false): Database {
80
+ const p = dbPath(cwd, local)
81
+ const db = withBusyRetrySync(() => {
82
+ const d = new Database(p)
83
+ try {
84
+ d.exec(`PRAGMA busy_timeout=${LIMITS.SQLITE_BUSY_TIMEOUT_MS}`)
85
+ } catch {}
86
+ return d
87
+ })
88
+ if (!db) {
89
+ throw new Error(
90
+ `persistence: cannot open sessions.db after ${DB_INIT_ATTEMPTS} busy-retry attempts: ${p}`,
91
+ )
92
+ }
93
+ try {
94
+ if (!initializedSessionPaths.has(p)) {
95
+ const walOk = withBusyRetrySync(() => {
96
+ db.exec(
97
+ `PRAGMA journal_mode=WAL; PRAGMA busy_timeout=${LIMITS.SQLITE_BUSY_TIMEOUT_MS}; PRAGMA synchronous=NORMAL; PRAGMA journal_size_limit=${LIMITS.SQLITE_WAL_SIZE_LIMIT_BYTES}; PRAGMA wal_autocheckpoint=${LIMITS.SQLITE_WAL_AUTOCHECKPOINT_PAGES};`,
98
+ )
99
+ initializedSessionPaths.add(p)
100
+ return true
101
+ })
102
+ if (walOk === null) {
103
+ process.stderr.write(`[warn] persistence: wal setup deferred, retry next open: ${p}\n`)
104
+ }
105
+ try {
106
+ const { chmodSync } = require("node:fs") as typeof import("node:fs")
107
+ chmodSync(p, 0o600)
108
+ } catch {}
109
+ }
110
+ const needsDdl = !migratedSessionPaths.has(p) || !daemonApprovalsMigrated(db)
111
+ if (needsDdl) {
112
+ withBusyRetrySync(() => {
113
+ db.exec(`
114
+ CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, created_at INTEGER, cwd TEXT, system TEXT, writer_epoch INTEGER NOT NULL DEFAULT 0, default_thread_id TEXT NULL, work_mode TEXT NULL);
115
+ CREATE TABLE IF NOT EXISTS messages (session_id TEXT, seq INTEGER, role TEXT, content TEXT, toolCalls TEXT, toolCallId TEXT, name TEXT, reasoning TEXT, is_error INTEGER, ts INTEGER, thread_id TEXT NULL, event_id TEXT NULL, run_id TEXT NULL, migrated INTEGER NOT NULL DEFAULT 0, migrated_compacted INTEGER NOT NULL DEFAULT 0, projection_note TEXT NULL, PRIMARY KEY(session_id, seq));
116
+ CREATE TABLE IF NOT EXISTS turns (session_id TEXT, turn_idx INTEGER, usage TEXT, ts INTEGER, PRIMARY KEY(session_id, turn_idx));
117
+ CREATE TABLE IF NOT EXISTS presentation_events (
118
+ session_id TEXT NOT NULL,
119
+ event_seq INTEGER NOT NULL,
120
+ type TEXT NOT NULL,
121
+ turn_id INTEGER NOT NULL,
122
+ ts INTEGER NOT NULL,
123
+ payload TEXT NOT NULL,
124
+ PRIMARY KEY(session_id, event_seq)
125
+ );
126
+ CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id, seq);
127
+ CREATE INDEX IF NOT EXISTS idx_presentation_events_session ON presentation_events(session_id, event_seq);
128
+ `)
129
+ })
130
+ try {
131
+ const cols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
132
+ if (!cols.some((c) => c.name === "updated_at")) {
133
+ db.exec("ALTER TABLE sessions ADD COLUMN updated_at INTEGER")
134
+ db.exec("UPDATE sessions SET updated_at = created_at WHERE updated_at IS NULL")
135
+ }
136
+ db.exec(`CREATE INDEX IF NOT EXISTS idx_sessions_updated ON sessions(updated_at DESC)`)
137
+ if (!cols.some((c) => c.name === "parent_session_id")) {
138
+ db.exec("ALTER TABLE sessions ADD COLUMN parent_session_id TEXT NULL")
139
+ }
140
+ if (!cols.some((c) => c.name === "parent_run_id")) {
141
+ db.exec("ALTER TABLE sessions ADD COLUMN parent_run_id TEXT NULL")
142
+ }
143
+ if (!cols.some((c) => c.name === "work_mode")) {
144
+ db.exec("ALTER TABLE sessions ADD COLUMN work_mode TEXT NULL")
145
+ }
146
+ db.exec(`CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id)`)
147
+ } catch (e) {
148
+ process.stderr.write(
149
+ `[warn] persistence: sessions migration skipped: ${(e as Error).message}\n`,
150
+ )
151
+ }
152
+ try {
153
+ const msgCols = db.prepare("PRAGMA table_info(messages)").all() as { name: string }[]
154
+ if (!msgCols.some((c) => c.name === "toolCallId")) {
155
+ db.exec("ALTER TABLE messages ADD COLUMN toolCallId TEXT")
156
+ db.exec("ALTER TABLE messages ADD COLUMN name TEXT")
157
+ }
158
+ if (!msgCols.some((c) => c.name === "reasoning")) {
159
+ db.exec("ALTER TABLE messages ADD COLUMN reasoning TEXT")
160
+ }
161
+ if (!msgCols.some((c) => c.name === "is_error")) {
162
+ db.exec("ALTER TABLE messages ADD COLUMN is_error INTEGER")
163
+ }
164
+ } catch (e) {
165
+ process.stderr.write(
166
+ `[warn] persistence: messages migration skipped: ${(e as Error).message}\n`,
167
+ )
168
+ }
169
+ withBusyRetrySync(() => {
170
+ db.exec(`
171
+ CREATE TABLE IF NOT EXISTS session_aliases (alias TEXT PRIMARY KEY, fs_key TEXT NOT NULL, canonical TEXT NOT NULL, reason TEXT NOT NULL, created_at INTEGER NOT NULL);
172
+ CREATE INDEX IF NOT EXISTS idx_session_aliases_fs ON session_aliases(fs_key);
173
+ CREATE INDEX IF NOT EXISTS idx_session_aliases_canonical ON session_aliases(canonical);
174
+ `)
175
+ })
176
+ try {
177
+ const sessCols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
178
+ if (!sessCols.some((c) => c.name === "writer_epoch")) {
179
+ db.exec("ALTER TABLE sessions ADD COLUMN writer_epoch INTEGER NOT NULL DEFAULT 0")
180
+ }
181
+ if (!sessCols.some((c) => c.name === "default_thread_id")) {
182
+ db.exec("ALTER TABLE sessions ADD COLUMN default_thread_id TEXT NULL")
183
+ }
184
+ const msgCols2 = db.prepare("PRAGMA table_info(messages)").all() as { name: string }[]
185
+ const addMsgCol = (name: string, ddl: string): void => {
186
+ if (!msgCols2.some((c) => c.name === name))
187
+ db.exec(`ALTER TABLE messages ADD COLUMN ${ddl}`)
188
+ }
189
+ addMsgCol("thread_id", "thread_id TEXT NULL")
190
+ addMsgCol("event_id", "event_id TEXT NULL")
191
+ addMsgCol("run_id", "run_id TEXT NULL")
192
+ addMsgCol("migrated", "migrated INTEGER NOT NULL DEFAULT 0")
193
+ addMsgCol("migrated_compacted", "migrated_compacted INTEGER NOT NULL DEFAULT 0")
194
+ addMsgCol("projection_note", "projection_note TEXT NULL")
195
+ try {
196
+ const runCols = db.prepare("PRAGMA table_info(runs)").all() as { name: string }[]
197
+ if (runCols.length > 0 && !runCols.some((c) => c.name === "takeover_epoch")) {
198
+ db.exec("ALTER TABLE runs ADD COLUMN takeover_epoch INTEGER NULL")
199
+ }
200
+ } catch {}
201
+ try {
202
+ const projCols = db.prepare("PRAGMA table_info(history_projections)").all() as {
203
+ name: string
204
+ }[]
205
+ if (projCols.length > 0 && !projCols.some((c) => c.name === "anchor_event_id")) {
206
+ db.exec("ALTER TABLE history_projections ADD COLUMN anchor_event_id TEXT NULL")
207
+ }
208
+ } catch {}
209
+ db.exec("DROP INDEX IF EXISTS idx_messages_thread")
210
+ withBusyRetrySync(() => {
211
+ db.exec(`
212
+ CREATE UNIQUE INDEX IF NOT EXISTS udx_messages_thread_seq ON messages(session_id, thread_id, seq);
213
+ CREATE UNIQUE INDEX IF NOT EXISTS udx_messages_event_id ON messages(session_id, thread_id, event_id);
214
+ CREATE INDEX IF NOT EXISTS idx_messages_run ON messages(run_id);
215
+ `)
216
+ })
217
+ } catch (e) {
218
+ process.stderr.write(
219
+ `[warn] persistence: writer_epoch migration skipped: ${(e as Error).message}\n`,
220
+ )
221
+ }
222
+ withBusyRetrySync(() => {
223
+ db.exec(`
224
+ CREATE TABLE IF NOT EXISTS session_takeovers (session_id TEXT NOT NULL, prior_epoch INTEGER NOT NULL, new_epoch INTEGER NOT NULL, reason TEXT NOT NULL, boot TEXT NOT NULL, created_at INTEGER NOT NULL, PRIMARY KEY(session_id, prior_epoch));
225
+ CREATE INDEX IF NOT EXISTS idx_session_takeovers_session ON session_takeovers(session_id);
226
+ `)
227
+ })
228
+ if (threadsTableNeedsP24Rebuild(db)) {
229
+ assertEmptyTableForRebuild(db, "threads")
230
+ db.exec("DROP TABLE IF EXISTS threads")
231
+ }
232
+ if (projectionsTableNeedsP24Rebuild(db)) {
233
+ assertEmptyTableForRebuild(db, "history_projections")
234
+ db.exec("DROP TABLE IF EXISTS history_projections")
235
+ }
236
+ withBusyRetrySync(() => {
237
+ db.exec(`
238
+ CREATE TABLE IF NOT EXISTS threads (session_id TEXT NOT NULL, thread_id TEXT NOT NULL, parent_thread_id TEXT NULL, fork_event_seq INTEGER NULL, head_seq INTEGER NOT NULL DEFAULT -1, status TEXT NOT NULL DEFAULT 'active', read_only INTEGER NOT NULL DEFAULT 0, created_at INTEGER NOT NULL, PRIMARY KEY(session_id, thread_id), CHECK(head_seq >= -1), CHECK(fork_event_seq IS NULL OR fork_event_seq >= 0));
239
+ CREATE INDEX IF NOT EXISTS idx_threads_session ON threads(session_id);
240
+ CREATE TABLE IF NOT EXISTS runs (run_id TEXT PRIMARY KEY, session_id TEXT NOT NULL, thread_id TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'CREATED', started_at INTEGER NOT NULL, ended_at INTEGER NULL, last_persisted_seq INTEGER NOT NULL DEFAULT 0, pending_tool_ids TEXT NOT NULL DEFAULT '[]', recovery_status TEXT NULL, takeover_epoch INTEGER NULL, created_at INTEGER NOT NULL, CHECK(last_persisted_seq >= 0));
241
+ CREATE INDEX IF NOT EXISTS idx_runs_session ON runs(session_id, started_at);
242
+ CREATE INDEX IF NOT EXISTS idx_runs_thread ON runs(thread_id, started_at);
243
+ CREATE UNIQUE INDEX IF NOT EXISTS udx_runs_single_running ON runs(session_id) WHERE status = 'RUNNING';
244
+ CREATE TABLE IF NOT EXISTS history_projections (session_id TEXT NOT NULL, thread_id TEXT NOT NULL, projection_id TEXT NOT NULL, base_seq INTEGER NOT NULL DEFAULT 0, summary_text TEXT NOT NULL DEFAULT '', included_ranges TEXT NOT NULL DEFAULT '[]', built_at INTEGER NOT NULL, anchor_event_id TEXT NULL, PRIMARY KEY(session_id, thread_id, projection_id), CHECK(base_seq >= 0));
245
+ CREATE INDEX IF NOT EXISTS idx_projections_thread ON history_projections(session_id, thread_id);
246
+ `)
247
+ })
248
+ withBusyRetrySync(() => {
249
+ db.exec(`
250
+ CREATE TABLE IF NOT EXISTS consumer_offsets (
251
+ consumer_id TEXT NOT NULL,
252
+ session_id TEXT NOT NULL,
253
+ last_acked_seq INTEGER NOT NULL DEFAULT -1,
254
+ updated_at INTEGER NOT NULL,
255
+ PRIMARY KEY(consumer_id, session_id),
256
+ CHECK(last_acked_seq >= -1)
257
+ );
258
+ CREATE INDEX IF NOT EXISTS idx_consumer_offsets_session ON consumer_offsets(session_id);
259
+ CREATE TABLE IF NOT EXISTS daemon_approvals (
260
+ approval_id TEXT PRIMARY KEY,
261
+ session_id TEXT NOT NULL,
262
+ run_id TEXT NULL,
263
+ tool TEXT NOT NULL,
264
+ summary TEXT NOT NULL DEFAULT '',
265
+ state TEXT NOT NULL,
266
+ requested_at INTEGER NOT NULL,
267
+ expires_at INTEGER NULL,
268
+ decided_at INTEGER NULL,
269
+ decision TEXT NULL,
270
+ incarnation TEXT NOT NULL,
271
+ args_hash TEXT NULL,
272
+ invocation_id TEXT NULL
273
+ );
274
+ CREATE INDEX IF NOT EXISTS idx_daemon_approvals_session ON daemon_approvals(session_id, requested_at);
275
+ CREATE INDEX IF NOT EXISTS idx_daemon_approvals_state ON daemon_approvals(state);
276
+ `)
277
+ })
278
+ try {
279
+ const approvalCols = db.prepare("PRAGMA table_info(daemon_approvals)").all() as {
280
+ name: string
281
+ }[]
282
+ if (!approvalCols.some((c) => c.name === "args_hash")) {
283
+ db.exec("ALTER TABLE daemon_approvals ADD COLUMN args_hash TEXT NULL")
284
+ }
285
+ if (!approvalCols.some((c) => c.name === "invocation_id")) {
286
+ db.exec("ALTER TABLE daemon_approvals ADD COLUMN invocation_id TEXT NULL")
287
+ }
288
+ } catch (e) {
289
+ process.stderr.write(
290
+ `[warn] persistence: daemon_approvals migration skipped: ${(e as Error).message}\n`,
291
+ )
292
+ }
293
+ migratedSessionPaths.add(p)
294
+ }
295
+ return db
296
+ } catch (err) {
297
+ try {
298
+ db.close()
299
+ } catch {}
300
+ throw err
301
+ }
302
+ }
303
+
304
+ export function openSessionDb(cwd?: string): Database {
305
+ return openSessionHandle(cwd)
306
+ }
307
+
308
+ export function openWorkspaceSessionDb(cwd?: string): Database {
309
+ return openSessionHandle(cwd, true)
310
+ }
311
+
312
+ export class StaleWriterError extends Error {
313
+ readonly code = "REFUSED_STALE_EPOCH"
314
+ readonly sessionId: string
315
+ readonly expectedEpoch: number
316
+ readonly actualEpoch: number
317
+ constructor(sessionId: string, expectedEpoch: number, actualEpoch: number) {
318
+ super(
319
+ `[persist] REFUSED_STALE_EPOCH sid=${sessionId} expected=${expectedEpoch} actual=${actualEpoch} — authority moved; history NOT durable`,
320
+ )
321
+ this.name = "StaleWriterError"
322
+ this.sessionId = sessionId
323
+ this.expectedEpoch = expectedEpoch
324
+ this.actualEpoch = actualEpoch
325
+ }
326
+ }
327
+
328
+ export function readWriterEpoch(id: string, cwd?: string): number {
329
+ const db = openSessionHandle(cwd)
330
+ try {
331
+ const row = db.prepare("SELECT writer_epoch AS epoch FROM sessions WHERE id = ?").get(id) as {
332
+ epoch: number | null
333
+ } | null
334
+ return row?.epoch ?? 0
335
+ } finally {
336
+ db.close()
337
+ }
338
+ }
339
+
340
+ export function assertWriterEpochInTxn(db: Database, id: string, expectedEpoch: number): void {
341
+ const row = db.prepare("SELECT writer_epoch AS epoch FROM sessions WHERE id = ?").get(id) as {
342
+ epoch: number | null
343
+ } | null
344
+ const actual = row?.epoch ?? 0
345
+ if (row !== null && actual !== expectedEpoch) {
346
+ throw new StaleWriterError(id, expectedEpoch, actual)
347
+ }
348
+ if (row === null && expectedEpoch !== 0) {
349
+ throw new StaleWriterError(id, expectedEpoch, actual)
350
+ }
351
+ }
352
+
353
+ export function sessionRowExistsInTxn(db: Database, sessionId: string): boolean {
354
+ const row = db.prepare("SELECT 1 AS ok FROM sessions WHERE id = ?").get(sessionId) as {
355
+ ok: number
356
+ } | null
357
+ return row !== null
358
+ }