imsg-mcp 1.10.0 → 1.12.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and follows [Semantic Versioning](https://semver.org/).
 
+# [1.12.0](https://github.com/george43g/imsg-mcp/compare/v1.11.0...v1.12.0) (2026-07-22)
+
+
+### Features
+
+* **cli:** interactive setup wizard for media interpretation ([0ad7507](https://github.com/george43g/imsg-mcp/commit/0ad75075e08e6cc9db7900a15ba7469b4e91314c))
+
+# [1.11.0](https://github.com/george43g/imsg-mcp/compare/v1.10.0...v1.11.0) (2026-07-21)
+
+
+### Features
+
+* **db+tui:** parse message edit history and show it in the drawer ([e4df935](https://github.com/george43g/imsg-mcp/commit/e4df93552f96419bebe50acd241b7d0b74854c9b))
+
 # [1.10.0](https://github.com/george43g/imsg-mcp/compare/v1.9.0...v1.10.0) (2026-07-21)
 
 

package/dist/app-config-CVixby2Z.js

@@ -0,0 +1,211 @@
+import { existsSync, mkdirSync, writeFileSync, readFileSync, chmodSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { z } from "zod";
+const HEX6 = /^#[0-9a-fA-F]{6}$/;
+const PROVIDER_PRESET_NAMES = [
+  "openai",
+  "groq",
+  "openrouter",
+  "cloudflare",
+  "huggingface",
+  "ollama"
+];
+const ProviderModelsSchema = z.object({ transcribe: z.string().optional(), vision: z.string().optional() }).optional();
+const ProviderConfigSchema = z.object({
+  name: z.string().min(1),
+  preset: z.enum(PROVIDER_PRESET_NAMES).optional(),
+  baseUrl: z.string().url().optional(),
+  accountId: z.string().optional(),
+  models: ProviderModelsSchema
+}).refine((p) => Boolean(p.preset) || Boolean(p.baseUrl), {
+  message: "provider needs either a preset or a baseUrl"
+});
+const ChainsSchema = z.object({
+  audio: z.array(z.string()).default(["apple", "local"]),
+  image: z.array(z.string()).default([]),
+  video: z.array(z.string()).default([])
+}).default({});
+const NudgeSchema = z.object({
+  enabled: z.boolean().default(true),
+  tier2SyncNow: z.boolean().default(false),
+  timeoutSeconds: z.number().int().positive().default(30)
+}).default({});
+const InterpretConfigSchema = z.object({
+  /** Auto-interpretation gate. "free" (default) never makes a paid call without
+   *  an explicit force; "all" runs the full chain incl. cloud; "off" disables. */
+  auto: z.enum(["all", "free", "off"]).default("free"),
+  /** Inline cached transcripts/captions in read surfaces (get_messages, TUI). */
+  inlineTranscripts: z.boolean().default(true),
+  /** Confirm before an export triggers more than this many uncached cloud calls. */
+  exportConfirmThreshold: z.number().int().nonnegative().default(25),
+  chains: ChainsSchema,
+  providers: z.array(ProviderConfigSchema).default([]),
+  nudge: NudgeSchema
+});
+const AppConfigSchema = z.object({
+  /** Glyph preset. "safe" is the universally-renderable default. */
+  theme: z.enum(["safe", "powerline"]).default("safe"),
+  /** 6-digit hex color used to derive the whole UI palette. */
+  accentColor: z.string().regex(HEX6, "must be a 6-digit hex like #RRGGBB").default("#1982FC"),
+  /** Media-interpretation config (optional — absent on TUI-only configs). */
+  interpret: InterpretConfigSchema.optional()
+});
+const DEFAULT_TUI_CONFIG = {
+  theme: "safe",
+  accentColor: "#1982FC"
+};
+InterpretConfigSchema.parse({});
+function candidatePaths() {
+  const home = homedir();
+  const out = [];
+  if (process.env.XDG_CONFIG_HOME) {
+    out.push(join(process.env.XDG_CONFIG_HOME, "imsg-mcp", "config.json"));
+  }
+  out.push(join(home, ".config", "imsg-mcp", "config.json"));
+  out.push(join(home, ".imsg-mcp", "config.json"));
+  return out;
+}
+function findTuiConfigPath() {
+  for (const p of candidatePaths()) {
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+function defaultTuiConfigPath() {
+  return candidatePaths()[0] ?? candidatePaths()[1];
+}
+function loadTuiConfig() {
+  const warnings = [];
+  const path = findTuiConfigPath();
+  if (!path) return { config: { ...DEFAULT_TUI_CONFIG }, source: null, warnings };
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8"));
+  } catch (err) {
+    warnings.push(
+      `config: failed to read ${path} (${err instanceof Error ? err.message : String(err)}); using defaults`
+    );
+    return { config: { ...DEFAULT_TUI_CONFIG }, source: path, warnings };
+  }
+  const result = AppConfigSchema.safeParse(parsed);
+  if (result.success) return { config: result.data, source: path, warnings };
+  const tuiOnly = AppConfigSchema.pick({ theme: true, accentColor: true }).safeParse(parsed);
+  const issues = result.error.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`).join("; ");
+  if (tuiOnly.success) {
+    warnings.push(`config: ${path} has invalid fields (${issues}); ignoring them`);
+    return { config: { ...tuiOnly.data }, source: path, warnings };
+  }
+  warnings.push(`config: ${path} has invalid fields (${issues}); using defaults`);
+  return { config: { ...DEFAULT_TUI_CONFIG }, source: path, warnings };
+}
+function writeTuiConfig(config, path = defaultTuiConfigPath()) {
+  const validated = AppConfigSchema.parse(config);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(validated, null, 2)}
+`);
+  return path;
+}
+function credentialsPath() {
+  return join(homedir(), ".imsg-mcp", "credentials.json");
+}
+function readCredentials() {
+  const path = credentialsPath();
+  if (!existsSync(path)) return {};
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const out = {};
+      for (const [k, v] of Object.entries(parsed)) {
+        if (typeof v === "string") out[k] = v;
+      }
+      return out;
+    }
+  } catch {
+  }
+  return {};
+}
+function writeCredentials(creds) {
+  const path = credentialsPath();
+  const dir = dirname(path);
+  mkdirSync(dir, { recursive: true });
+  try {
+    chmodSync(dir, 448);
+  } catch {
+  }
+  writeFileSync(path, `${JSON.stringify(creds, null, 2)}
+`, { mode: 384 });
+  chmodSync(path, 384);
+  return path;
+}
+function setCredential(name, key) {
+  const creds = readCredentials();
+  if (key) creds[name] = key;
+  else delete creds[name];
+  writeCredentials(creds);
+}
+function resolveTuiConfig(overrides = {}) {
+  const loaded = loadTuiConfig();
+  const warnings = [...loaded.warnings];
+  let theme = loaded.config.theme;
+  let themeOrigin = loaded.source ? "config" : "default";
+  if (process.env.IMSG_TUI_THEME) {
+    const t = process.env.IMSG_TUI_THEME;
+    if (t === "safe" || t === "powerline") {
+      theme = t;
+      themeOrigin = "env";
+    } else {
+      warnings.push(`IMSG_TUI_THEME="${t}" is not "safe" or "powerline"; ignoring`);
+    }
+  }
+  if (overrides.cliTheme !== void 0) {
+    if (overrides.cliTheme === "safe" || overrides.cliTheme === "powerline") {
+      theme = overrides.cliTheme;
+      themeOrigin = "cli";
+    } else {
+      warnings.push(`--theme="${overrides.cliTheme}" is not "safe" or "powerline"; ignoring`);
+    }
+  }
+  let accentColor = loaded.config.accentColor;
+  let accentOrigin = loaded.source ? "config" : "default";
+  if (process.env.IMSG_TUI_ACCENT) {
+    if (HEX6.test(process.env.IMSG_TUI_ACCENT)) {
+      accentColor = process.env.IMSG_TUI_ACCENT;
+      accentOrigin = "env";
+    } else {
+      warnings.push(
+        `IMSG_TUI_ACCENT="${process.env.IMSG_TUI_ACCENT}" is not a 6-digit hex; ignoring`
+      );
+    }
+  }
+  if (overrides.cliAccent !== void 0) {
+    if (HEX6.test(overrides.cliAccent)) {
+      accentColor = overrides.cliAccent;
+      accentOrigin = "cli";
+    } else {
+      warnings.push(`--accent="${overrides.cliAccent}" is not a 6-digit hex; ignoring`);
+    }
+  }
+  return {
+    theme,
+    accentColor,
+    origin: { theme: themeOrigin, accentColor: accentOrigin },
+    configPath: loaded.source,
+    warnings
+  };
+}
+export {
+  AppConfigSchema as A,
+  DEFAULT_TUI_CONFIG as D,
+  InterpretConfigSchema as I,
+  readCredentials as a,
+  writeCredentials as b,
+  credentialsPath as c,
+  defaultTuiConfigPath as d,
+  findTuiConfigPath as f,
+  loadTuiConfig as l,
+  resolveTuiConfig as r,
+  setCredential as s,
+  writeTuiConfig as w
+};
+//# sourceMappingURL=app-config-CVixby2Z.js.map

package/dist/app-config-CVixby2Z.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config-CVixby2Z.js","sources":["../src/app-config.ts"],"sourcesContent":["/**\n * Canonical persistent configuration for imsg-mcp — one JSON file that carries\n * both the flat TUI keys (theme / accentColor) AND the `interpret` block that\n * configures media interpretation (Stage 2 core: chains, providers, toggles).\n *\n * Resolution order (first one found wins) — unchanged from the original\n * tui-config module so existing files keep loading:\n *   1. $XDG_CONFIG_HOME/imsg-mcp/config.json\n *   2. $HOME/.config/imsg-mcp/config.json\n *   3. $HOME/.imsg-mcp/config.json     (matches the slugs.db location)\n *\n * `src/tui-config.ts` re-exports this module verbatim for back-compat.\n *\n * API keys are NEVER stored in config.json. They live in\n * `~/.imsg-mcp/credentials.json` (chmod 600, `{ \"<providerName>\": \"sk-…\" }`)\n * or the legacy `IMSG_TRANSCRIBE_*` env vars, and are merged into providers only\n * at resolution time (`resolveInterpretConfig`).\n */\n\nimport { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { z } from \"zod\";\nimport { getTranscribeCloudConfig } from \"./config.js\";\nimport type { AutoMode, InterpretChains, InterpretConfig } from \"./media-intel.js\";\nimport type { ProviderConfig, ProviderPreset } from \"./media-providers.js\";\n\n// ── Schema ────────────────────────────────────────────────────────────────\n\nconst HEX6 = /^#[0-9a-fA-F]{6}$/;\n\n/** Preset names accepted in the `interpret.providers[].preset` field. Kept as a\n *  literal tuple so Zod can build an enum without a runtime import of the\n *  providers module (and asserted to stay in sync with `ProviderPreset`). */\nconst PROVIDER_PRESET_NAMES = [\n  \"openai\",\n  \"groq\",\n  \"openrouter\",\n  \"cloudflare\",\n  \"huggingface\",\n  \"ollama\",\n] as const satisfies readonly ProviderPreset[];\n\nconst ProviderModelsSchema = z\n  .object({ transcribe: z.string().optional(), vision: z.string().optional() })\n  .optional();\n\n/** A provider profile as stored in config.json — NO apiKey (that lives in\n *  credentials.json / env and is merged in at resolution time). */\nconst ProviderConfigSchema = z\n  .object({\n    name: z.string().min(1),\n    preset: z.enum(PROVIDER_PRESET_NAMES).optional(),\n    baseUrl: z.string().url().optional(),\n    accountId: z.string().optional(),\n    models: ProviderModelsSchema,\n  })\n  .refine((p) => Boolean(p.preset) || Boolean(p.baseUrl), {\n    message: \"provider needs either a preset or a baseUrl\",\n  });\n\nconst ChainsSchema = z\n  .object({\n    audio: z.array(z.string()).default([\"apple\", \"local\"]),\n    image: z.array(z.string()).default([]),\n    video: z.array(z.string()).default([]),\n  })\n  .default({});\n\nconst NudgeSchema = z\n  .object({\n    enabled: z.boolean().default(true),\n    tier2SyncNow: z.boolean().default(false),\n    timeoutSeconds: z.number().int().positive().default(30),\n  })\n  .default({});\n\nexport const InterpretConfigSchema = z.object({\n  /** Auto-interpretation gate. \"free\" (default) never makes a paid call without\n   *  an explicit force; \"all\" runs the full chain incl. cloud; \"off\" disables. */\n  auto: z.enum([\"all\", \"free\", \"off\"]).default(\"free\"),\n  /** Inline cached transcripts/captions in read surfaces (get_messages, TUI). */\n  inlineTranscripts: z.boolean().default(true),\n  /** Confirm before an export triggers more than this many uncached cloud calls. */\n  exportConfirmThreshold: z.number().int().nonnegative().default(25),\n  chains: ChainsSchema,\n  providers: z.array(ProviderConfigSchema).default([]),\n  nudge: NudgeSchema,\n});\n\nexport const AppConfigSchema = z.object({\n  /** Glyph preset. \"safe\" is the universally-renderable default. */\n  theme: z.enum([\"safe\", \"powerline\"]).default(\"safe\"),\n  /** 6-digit hex color used to derive the whole UI palette. */\n  accentColor: z.string().regex(HEX6, \"must be a 6-digit hex like #RRGGBB\").default(\"#1982FC\"),\n  /** Media-interpretation config (optional — absent on TUI-only configs). */\n  interpret: InterpretConfigSchema.optional(),\n});\n\nexport type AppConfig = z.infer<typeof AppConfigSchema>;\nexport type InterpretConfigInput = z.infer<typeof InterpretConfigSchema>;\n\n/** Back-compat alias — the TUI only ever reads theme/accentColor. */\nexport const TuiConfigSchema = AppConfigSchema;\nexport type TuiConfig = AppConfig;\n\nexport const DEFAULT_TUI_CONFIG: TuiConfig = {\n  theme: \"safe\",\n  accentColor: \"#1982FC\",\n};\n\n/** Free-first interpret defaults used when the block is absent from config. */\nexport const DEFAULT_INTERPRET_CONFIG: InterpretConfigInput = InterpretConfigSchema.parse({});\n\n// ── Path resolution ───────────────────────────────────────────────────────\n\n/** Candidate paths we try to read from, in order. */\nfunction candidatePaths(): string[] {\n  const home = homedir();\n  const out: string[] = [];\n  if (process.env.XDG_CONFIG_HOME) {\n    out.push(join(process.env.XDG_CONFIG_HOME, \"imsg-mcp\", \"config.json\"));\n  }\n  out.push(join(home, \".config\", \"imsg-mcp\", \"config.json\"));\n  out.push(join(home, \".imsg-mcp\", \"config.json\"));\n  return out;\n}\n\n/** Where the file actually lives (first existing candidate), or null. */\nexport function findTuiConfigPath(): string | null {\n  for (const p of candidatePaths()) {\n    if (existsSync(p)) return p;\n  }\n  return null;\n}\n\n/** Where to write a fresh config file. Returns the *first* candidate so\n *  XDG-style wins on a clean machine. */\nexport function defaultTuiConfigPath(): string {\n  return candidatePaths()[0] ?? candidatePaths()[1];\n}\n\n// ── Loader ────────────────────────────────────────────────────────────────\n\nexport interface LoadedTuiConfig {\n  config: AppConfig;\n  /** Path of the file we read from, or `null` if defaults were used. */\n  source: string | null;\n  /** Human-readable warnings (parse errors, schema errors). Empty when clean. */\n  warnings: string[];\n}\n\nexport function loadTuiConfig(): LoadedTuiConfig {\n  const warnings: string[] = [];\n  const path = findTuiConfigPath();\n  if (!path) return { config: { ...DEFAULT_TUI_CONFIG }, source: null, warnings };\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(readFileSync(path, \"utf8\"));\n  } catch (err) {\n    warnings.push(\n      `config: failed to read ${path} (${err instanceof Error ? err.message : String(err)}); using defaults`,\n    );\n    return { config: { ...DEFAULT_TUI_CONFIG }, source: path, warnings };\n  }\n\n  const result = AppConfigSchema.safeParse(parsed);\n  if (result.success) return { config: result.data, source: path, warnings };\n\n  // Full parse failed. Degrade gracefully: if the flat TUI keys alone are valid,\n  // keep them (a malformed `interpret` block should not blow away the theme).\n  const tuiOnly = AppConfigSchema.pick({ theme: true, accentColor: true }).safeParse(parsed);\n  const issues = result.error.issues\n    .map((i) => `${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n    .join(\"; \");\n  if (tuiOnly.success) {\n    warnings.push(`config: ${path} has invalid fields (${issues}); ignoring them`);\n    return { config: { ...tuiOnly.data }, source: path, warnings };\n  }\n  warnings.push(`config: ${path} has invalid fields (${issues}); using defaults`);\n  return { config: { ...DEFAULT_TUI_CONFIG }, source: path, warnings };\n}\n\n// ── Writer (used by `imsg config edit` + `imsg setup`) ────────────────────\n\nexport function writeTuiConfig(config: AppConfig, path = defaultTuiConfigPath()): string {\n  // Validate before writing so we never persist garbage.\n  const validated = AppConfigSchema.parse(config);\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, `${JSON.stringify(validated, null, 2)}\\n`);\n  return path;\n}\n\n// ── Credentials (chmod 600) ───────────────────────────────────────────────\n\n/** `~/.imsg-mcp/credentials.json` — `{ \"<providerName>\": \"<apiKey>\" }`. */\nexport function credentialsPath(): string {\n  return join(homedir(), \".imsg-mcp\", \"credentials.json\");\n}\n\nexport function readCredentials(): Record<string, string> {\n  const path = credentialsPath();\n  if (!existsSync(path)) return {};\n  try {\n    const parsed = JSON.parse(readFileSync(path, \"utf8\"));\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      const out: Record<string, string> = {};\n      for (const [k, v] of Object.entries(parsed)) {\n        if (typeof v === \"string\") out[k] = v;\n      }\n      return out;\n    }\n  } catch {\n    // Corrupt credentials file — treat as empty (never throw on read).\n  }\n  return {};\n}\n\n/** Write the whole credentials map, enforcing 0600 on the file (and 0700 dir). */\nexport function writeCredentials(creds: Record<string, string>): string {\n  const path = credentialsPath();\n  const dir = dirname(path);\n  mkdirSync(dir, { recursive: true });\n  try {\n    chmodSync(dir, 0o700);\n  } catch {\n    // Best-effort — a shared dir may already exist with other perms.\n  }\n  writeFileSync(path, `${JSON.stringify(creds, null, 2)}\\n`, { mode: 0o600 });\n  // writeFileSync's `mode` is masked by umask on CREATE and ignored when the\n  // file already exists — chmod unconditionally so 0600 is guaranteed.\n  chmodSync(path, 0o600);\n  return path;\n}\n\n/** Set (or clear, when key is empty) one provider's credential. */\nexport function setCredential(name: string, key: string): void {\n  const creds = readCredentials();\n  if (key) creds[name] = key;\n  else delete creds[name];\n  writeCredentials(creds);\n}\n\n// ── Interpret-config resolution (config + credentials + env → service) ─────\n\n/** The env-mapped implicit provider name (legacy IMSG_TRANSCRIBE_* path). */\nexport const ENV_PROVIDER_NAME = \"env\";\n\n/** Interpret config ready for `MediaIntelService`, plus the surfacing toggles\n *  that frontends (Stage 4/6/7) read. Providers carry their merged apiKey. */\nexport interface ResolvedInterpretConfig extends InterpretConfig {\n  inlineTranscripts: boolean;\n  exportConfirmThreshold: number;\n  nudge: { enabled: boolean; tier2SyncNow: boolean; timeoutSeconds: number };\n  /** Where the config was read from (null = defaults). */\n  configPath: string | null;\n  warnings: string[];\n}\n\n/**\n * Resolve the full interpret configuration:\n *   - start from the config file's `interpret` block (or free-first defaults),\n *   - merge API keys from credentials.json into each named provider,\n *   - map the legacy `IMSG_TRANSCRIBE_*` env vars to an implicit `env` provider\n *     (and append `provider:env` to the audio chain if it has no provider yet),\n *     preserving the shipped v1.7.0 cloud-transcription fallback.\n */\nexport function resolveInterpretConfig(): ResolvedInterpretConfig {\n  const loaded = loadTuiConfig();\n  const warnings = [...loaded.warnings];\n  const block = InterpretConfigSchema.parse(loaded.config.interpret ?? {});\n  const creds = readCredentials();\n\n  const providers: ProviderConfig[] = block.providers.map((p) => ({\n    ...p,\n    apiKey: creds[p.name],\n  }));\n  const chains: InterpretChains = {\n    audio: [...block.chains.audio],\n    image: [...block.chains.image],\n    video: [...block.chains.video],\n  };\n\n  // Legacy env fallback → implicit provider, if not already configured by name.\n  const envCloud = getTranscribeCloudConfig();\n  if (envCloud && !providers.some((p) => p.name === ENV_PROVIDER_NAME)) {\n    providers.push({\n      name: ENV_PROVIDER_NAME,\n      baseUrl: envCloud.baseUrl,\n      apiKey: envCloud.apiKey,\n      models: { transcribe: envCloud.model },\n    });\n    if (!chains.audio.some((l) => l.startsWith(\"provider:\"))) {\n      chains.audio.push(`provider:${ENV_PROVIDER_NAME}`);\n    }\n  }\n\n  const auto: AutoMode = block.auto;\n  return {\n    auto,\n    chains,\n    providers,\n    inlineTranscripts: block.inlineTranscripts,\n    exportConfirmThreshold: block.exportConfirmThreshold,\n    nudge: block.nudge,\n    configPath: loaded.source,\n    warnings,\n  };\n}\n\n// ── Layered resolution (CLI > env > config > defaults) — TUI theme/accent ──\n\nexport interface TuiConfigOverrides {\n  /** From `imsg --theme=...` */\n  cliTheme?: string;\n  /** From `imsg --accent=...` */\n  cliAccent?: string;\n}\n\nexport interface ResolvedTuiConfig {\n  theme: TuiConfig[\"theme\"];\n  accentColor: string;\n  /** Where each value came from, useful for `imsg config show`. */\n  origin: {\n    theme: \"cli\" | \"env\" | \"config\" | \"default\";\n    accentColor: \"cli\" | \"env\" | \"config\" | \"default\";\n  };\n  /** The on-disk file path that contributed (or `null` if no file). */\n  configPath: string | null;\n  /** Any warnings raised during loading (malformed file, invalid env, etc). */\n  warnings: string[];\n}\n\nexport function resolveTuiConfig(overrides: TuiConfigOverrides = {}): ResolvedTuiConfig {\n  const loaded = loadTuiConfig();\n  const warnings = [...loaded.warnings];\n\n  // Theme precedence: CLI > env > config > default\n  let theme: TuiConfig[\"theme\"] = loaded.config.theme;\n  let themeOrigin: ResolvedTuiConfig[\"origin\"][\"theme\"] = loaded.source ? \"config\" : \"default\";\n\n  if (process.env.IMSG_TUI_THEME) {\n    const t = process.env.IMSG_TUI_THEME;\n    if (t === \"safe\" || t === \"powerline\") {\n      theme = t;\n      themeOrigin = \"env\";\n    } else {\n      warnings.push(`IMSG_TUI_THEME=\"${t}\" is not \"safe\" or \"powerline\"; ignoring`);\n    }\n  }\n  if (overrides.cliTheme !== undefined) {\n    if (overrides.cliTheme === \"safe\" || overrides.cliTheme === \"powerline\") {\n      theme = overrides.cliTheme;\n      themeOrigin = \"cli\";\n    } else {\n      warnings.push(`--theme=\"${overrides.cliTheme}\" is not \"safe\" or \"powerline\"; ignoring`);\n    }\n  }\n\n  // Accent precedence: CLI > env > config > default\n  let accentColor = loaded.config.accentColor;\n  let accentOrigin: ResolvedTuiConfig[\"origin\"][\"accentColor\"] = loaded.source\n    ? \"config\"\n    : \"default\";\n\n  if (process.env.IMSG_TUI_ACCENT) {\n    if (HEX6.test(process.env.IMSG_TUI_ACCENT)) {\n      accentColor = process.env.IMSG_TUI_ACCENT;\n      accentOrigin = \"env\";\n    } else {\n      warnings.push(\n        `IMSG_TUI_ACCENT=\"${process.env.IMSG_TUI_ACCENT}\" is not a 6-digit hex; ignoring`,\n      );\n    }\n  }\n  if (overrides.cliAccent !== undefined) {\n    if (HEX6.test(overrides.cliAccent)) {\n      accentColor = overrides.cliAccent;\n      accentOrigin = \"cli\";\n    } else {\n      warnings.push(`--accent=\"${overrides.cliAccent}\" is not a 6-digit hex; ignoring`);\n    }\n  }\n\n  return {\n    theme,\n    accentColor,\n    origin: { theme: themeOrigin, accentColor: accentOrigin },\n    configPath: loaded.source,\n    warnings,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -3,8 +3,8 @@ import { existsSync, realpathSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
-import { c as checkLocalAccess, f as formatAccessReport, J as IMPLEMENTED_TYPES, K as ANALYTIC_INFO, w as installShutdownHandlers, x as registerCleanup, L as looksLikeThreadSlug } from "./shutdown-CQ9wzrxA.js";
-import { A as APP_VERSION, t as toYaml } from "./meta-D6ZUMB_B.js";
+import { c as checkLocalAccess, f as formatAccessReport, I as IMPLEMENTED_TYPES, A as ANALYTIC_INFO, i as installShutdownHandlers, r as registerCleanup, l as looksLikeThreadSlug } from "./shutdown-CjDoFsTF.js";
+import { A as APP_VERSION, t as toYaml } from "./meta-BA-d51LM.js";
 import { spawn } from "node:child_process";
 import { join, dirname } from "node:path";
 function distRoot() {
@@ -446,9 +446,9 @@ async function runExportCommand(target, opts) {
   const { existsSync: existsSync2, mkdirSync, copyFileSync, statSync } = await import("node:fs");
   const { homedir } = await import("node:os");
   const { dirname: dirname2, join: join2, isAbsolute, resolve } = await import("node:path");
-  const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-CQ9wzrxA.js").then((n) => n.a0);
-  const { IMessageDB } = await import("./imessage-db-vrzopRGT.js").then((n) => n.i);
-  const { streamExport } = await import("./exportStream-DgPVRZTZ.js");
+  const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-CjDoFsTF.js").then((n) => n.a0);
+  const { IMessageDB } = await import("./imessage-db-CbI0AYGw.js").then((n) => n.i);
+  const { streamExport } = await import("./exportStream-Dp5KKwtE.js");
   const { parseUserDate } = await import("./date-parse-DJXMfq3a.js");
   const format = normalizeFormat(opts.format ?? "md");
   const ext = extForFormat(format);
@@ -694,49 +694,65 @@ program.command("tui").description("Launch the read-only terminal UI").option("-
   await runTui();
 });
 program.command("export <target>").description("Export a conversation to a file (md/csv/json/ndjson)").option("-f, --format <fmt>", "Output format: md (default), csv, json, ndjson", "md").option("--since <date>", "Earliest date (ISO or relative, e.g. '3 months ago')").option("--until <date>", "Latest date (ISO or relative)").option("-o, --output <path>", "Output path (default: ~/imsg-export-<target>-<YYYY-MM-DD>.<ext>)").option("--include-attachments", "Copy attachments next to the export").option("--attachments-dir <path>", "Where to copy attachments (default: <output>.attachments/)").option("--page-size <n>", "Messages per DB page (100-5000)", "1000").action(runExportCommand);
-program.command("setup").description("Autodetect DB paths and emit an MCP host config snippet").option("-w, --write <host>", 'Write into a host config: "claude" or "cursor"').option("-r, --runtime <runtime>", 'Runtime command: "npx" (default), "bunx", or "global"').option("--print-only", "Just print the snippet (default behaviour)").action(async (opts) => {
-  const { probeMachine, buildMcpSnippet, writeHostConfig } = await import("./setup-CgLVaoGu.js");
-  const report = probeMachine();
-  if (!report.imsgDb.readable) {
-    log(`✗ Messages DB is not readable: ${report.imsgDb.path}`, "err");
-    log(`  ${report.imsgDb.error ?? ""}`, "err");
-    log(
-      "  Grant Full Disk Access to the running app: System Settings → Privacy & Security → Full Disk Access",
-      "warn"
-    );
-    process.exitCode = 1;
-    return;
-  }
-  log(`✓ Messages DB readable: ${report.imsgDb.path}`, "ok");
-  log(
-    `✓ Address Book: ${report.contactsDbs.length} source(s), ${report.contactsDbs.filter((p) => p.readable).length} readable`,
-    "ok"
-  );
-  log(
-    `  slugs.db: ${report.slugsDb.path} ${report.slugsDb.exists ? "(exists)" : "(will be created on first run)"}`
-  );
-  const runtime = opts.runtime === "bunx" || opts.runtime === "global" ? opts.runtime : "npx";
-  const snippet = buildMcpSnippet(report, { runtime });
-  if (opts.write) {
-    if (opts.write !== "claude" && opts.write !== "cursor") {
-      log(`✗ unknown host: ${opts.write} (expected "claude" or "cursor")`, "err");
+program.command("setup").description("Autodetect DB paths and emit an MCP host config snippet").option("-w, --write <host>", 'Write into a host config: "claude" or "cursor"').option("-r, --runtime <runtime>", 'Runtime command: "npx" (default), "bunx", or "global"').option("--print-only", "Just print the snippet (default behaviour)").option("-i, --interactive", "Configure media interpretation (providers, chains, keys)").action(
+  async (opts) => {
+    if (opts.interactive) {
+      const { runSetupWizard } = await import("./setup-wizard-Z6_0P-yc.js");
+      try {
+        await runSetupWizard();
+      } catch (err) {
+        if (err instanceof Error && err.name === "ExitPromptError") {
+          log("setup cancelled", "warn");
+          return;
+        }
+        throw err;
+      }
+      return;
+    }
+    const { probeMachine, buildMcpSnippet, writeHostConfig } = await import("./setup-Tpk356yq.js");
+    const report = probeMachine();
+    if (!report.imsgDb.readable) {
+      log(`✗ Messages DB is not readable: ${report.imsgDb.path}`, "err");
+      log(`  ${report.imsgDb.error ?? ""}`, "err");
+      log(
+        "  Grant Full Disk Access to the running app: System Settings → Privacy & Security → Full Disk Access",
+        "warn"
+      );
       process.exitCode = 1;
       return;
     }
-    const result = writeHostConfig(opts.write, report, { runtime });
+    log(`✓ Messages DB readable: ${report.imsgDb.path}`, "ok");
     log(
-      `✓ wrote ${opts.write} config to ${result.path}${result.replaced ? " (replaced existing imessage entry)" : ""}`,
+      `✓ Address Book: ${report.contactsDbs.length} source(s), ${report.contactsDbs.filter((p) => p.readable).length} readable`,
       "ok"
     );
-    log(`  backup of any prior file at ${result.path}.bak`);
-    return;
+    log(
+      `  slugs.db: ${report.slugsDb.path} ${report.slugsDb.exists ? "(exists)" : "(will be created on first run)"}`
+    );
+    const runtime = opts.runtime === "bunx" || opts.runtime === "global" ? opts.runtime : "npx";
+    const snippet = buildMcpSnippet(report, { runtime });
+    if (opts.write) {
+      if (opts.write !== "claude" && opts.write !== "cursor") {
+        log(`✗ unknown host: ${opts.write} (expected "claude" or "cursor")`, "err");
+        process.exitCode = 1;
+        return;
+      }
+      const result = writeHostConfig(opts.write, report, { runtime });
+      log(
+        `✓ wrote ${opts.write} config to ${result.path}${result.replaced ? " (replaced existing imessage entry)" : ""}`,
+        "ok"
+      );
+      log(`  backup of any prior file at ${result.path}.bak`);
+      return;
+    }
+    log("--- snippet ---", "dim");
+    process.stdout.write(snippet);
+    log("tip: run `imsg setup --interactive` to configure media interpretation", "dim");
   }
-  log("--- snippet ---", "dim");
-  process.stdout.write(snippet);
-});
+);
 const configCmd = program.command("config").description("Manage TUI settings (theme, accent color)");
 configCmd.command("show").description("Print resolved TUI settings and where each value came from").action(async () => {
-  const { resolveTuiConfig, defaultTuiConfigPath } = await import("./tui-config-Crn6TZPg.js");
+  const { resolveTuiConfig, defaultTuiConfigPath } = await import("./tui-config-DWD0O2SW.js");
   const cfg = resolveTuiConfig();
   log(
     `config file : ${cfg.configPath ?? `(none — defaults; would write to ${defaultTuiConfigPath()})`}`
@@ -749,7 +765,7 @@ configCmd.command("show").description("Print resolved TUI settings and where eac
   for (const w of cfg.warnings) log(w, "warn");
 });
 configCmd.command("edit").description("Open the TUI config file in $EDITOR (creates it if missing)").action(async () => {
-  const { defaultTuiConfigPath, findTuiConfigPath, writeTuiConfig, DEFAULT_TUI_CONFIG } = await import("./tui-config-Crn6TZPg.js");
+  const { defaultTuiConfigPath, findTuiConfigPath, writeTuiConfig, DEFAULT_TUI_CONFIG } = await import("./tui-config-DWD0O2SW.js");
   const path = findTuiConfigPath() ?? defaultTuiConfigPath();
   const { existsSync: existsSync2 } = await import("node:fs");
   if (!existsSync2(path)) {