mixdog 0.9.89 → 0.9.91

package/src/runtime/channels/backends/discord.mjs

@@ -12,7 +12,9 @@ async function ensureDiscord() {
 import {
   mkdirSync,
   statSync,
-  realpathSync
+  realpathSync,
+  readdirSync,
+  unlinkSync
 } from "fs";
 import { join, sep } from "path";
 import { createHash } from "crypto";
@@ -83,8 +85,26 @@ class DiscordBackend {
   }
   // ── Lifecycle ──────────────────────────────────────────────────────
   async connect() {
+    this._sweepInboxOnce();
     return gateway.connect(this);
   }
+  // Voice/attachment inbox retention: downloaded .ogg/.wav payloads are
+  // consumed at transcription time and were never cleaned up (audit: 477
+  // files / 55 MB accumulated since July). Best-effort, once per process.
+  _sweepInboxOnce() {
+    if (this._inboxSweepDone) return;
+    this._inboxSweepDone = true;
+    try {
+      const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000;
+      for (const name of readdirSync(this.inboxDir)) {
+        const p = join(this.inboxDir, name);
+        try {
+          const st = statSync(p);
+          if (st.isFile() && st.mtimeMs < cutoff) unlinkSync(p);
+        } catch { /* per-file best-effort */ }
+      }
+    } catch { /* inbox may not exist yet */ }
+  }
   async disconnect() {
     for (const interval of this.typingIntervals.values()) {
       clearInterval(interval);

package/src/runtime/channels/tool-defs.mjs

@@ -32,7 +32,7 @@ export const TOOL_DEFS = [
     name: "fetch",
     title: "Fetch",
     annotations: { title: "Fetch", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
-    description: "Discord-only recent messages. NOT for URLs; use web_fetch.",
+    description: "Discord-only: read recent messages from a channel.",
     inputSchema: {
       type: "object",
       properties: {

package/src/runtime/memory/lib/trace-store.mjs

@@ -465,13 +465,18 @@ async function ensureCurrentAndNextMonthPartitions(client) {
 // Trace retention: drop named monthly partitions older than the configured
 // window. Trace is regenerable observability data, so aging out old months is
 // non-destructive to durable state. Config via MIXDOG_TRACE_RETENTION_MONTHS
-// (default 6); set to 0 to disable. Only DROPs partitions strictly older than
+// (default 1); set to 0 to disable. Only DROPs partitions strictly older than
 // the cutoff month; the default catch-all partition is never dropped.
+// Default rationale: a personal-machine audit found trace partitions at 76%
+// of the 1.5 GB memory DB (July alone 787 MB) while durable entries were
+// 207 MB. Monthly partitions mean retention 1 always keeps the current +
+// previous month (30-60 days of full-resolution diagnostics) while bounding
+// the DB to a rolling ceiling instead of unbounded growth.
 const TRACE_RETENTION_MONTHS = (() => {
   const raw = process.env.MIXDOG_TRACE_RETENTION_MONTHS
-  if (raw == null || raw === '') return 6
+  if (raw == null || raw === '') return 1
   const n = Number(raw)
-  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 6
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 1
 })()
 
 async function dropAgedTracePartitions(client) {
@@ -499,6 +504,22 @@ async function dropAgedTracePartitions(client) {
   `)
 }
 
+// Row-level ageing for the non-partitioned trace side tables. agent_calls and
+// agent_llm grew unbounded (284 MB observed) because only trace_events had a
+// retention path. Same window, same regenerable-diagnostics rationale; space
+// is reclaimed by autovacuum row reuse rather than immediate disk shrink.
+async function deleteAgedTraceRows(client) {
+  if (TRACE_RETENTION_MONTHS <= 0) return
+  const months = TRACE_RETENTION_MONTHS
+  for (const table of ['agent_calls', 'agent_llm', 'bridge_calls', 'bridge_llm']) {
+    try {
+      await client.query(`DELETE FROM ${table} WHERE ts < now() - interval '${months} months'`)
+    } catch (err) {
+      __mixdogMemoryLog(`[trace-store] aged-row delete skipped for ${table}: ${err?.message ?? err}\n`)
+    }
+  }
+}
+
 async function isBootstrapComplete(client) {
   try {
     // Harden the check: require (a) root is partitioned, (b) schema-version
@@ -624,6 +645,7 @@ export async function openTraceDatabase(dataDir) {
         await c.query(`SET search_path = trace, public`)
         await ensureCurrentAndNextMonthPartitions(c)
         await dropAgedTracePartitions(c)
+        await deleteAgedTraceRows(c)
       } catch (err) {
         __mixdogMemoryLog(`[trace-store] periodic partition ensure failed: ${err?.message ?? err}\n`)
       } finally {

package/src/runtime/memory/tool-defs.mjs

@@ -3,6 +3,8 @@
 // tool registrations) but are not advertised via ListTools / tools.json, so
 // they never reach an external LLM. `aiWrapped: true` routes dispatches
 // through ai-wrapped-dispatch.mjs instead of the module's handleToolCall.
+// Shared period grammar for recall/search_memories.
+const PERIOD_DESCRIPTION = "last (recent sessions; +query topic-filter; limit=session count), Nm/Nh/Nd, today/yesterday/this_week/last_week, all, YYYY-MM-DD, date~date, HH:MM~HH:MM, or 'YYYY-MM-DD HH:MM~HH:MM'.";
 export const TOOL_DEFS = [
   {
     name: 'memory',
@@ -46,24 +48,22 @@ export const TOOL_DEFS = [
     name: 'recall',
     title: 'Recall',
     annotations: { title: 'Recall', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-    description: 'Retrieve stored memory/session history for prior-work context (resumes, earlier decisions); not a reflexive pre-step. Query is topic/semantic, not regex; period selects the time window; id for exact follow-up.',
+    description: 'Retrieve stored memory/session history for prior-work context (resumes, earlier decisions). Query is topic/semantic, not regex; period selects the time window; id for exact follow-up.',
     inputSchema: {
       type: 'object',
       properties: {
         query: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Search text, or array for independent fan-out queries.' },
         id: { anyOf: [{ type: 'number' }, { type: 'array', items: { type: 'number' }, minItems: 1 }], description: 'Exact #id(s) from recall. Do not invent ids.' },
-        period: { type: 'string', description: "last (recent sessions; +query topic-filter; limit=session count), Nm/Nh/Nd, today/yesterday/this_week/last_week, all, YYYY-MM-DD, date~date, HH:MM~HH:MM, or 'YYYY-MM-DD HH:MM~HH:MM'." },
+        period: { type: 'string', description: PERIOD_DESCRIPTION },
         limit: { type: 'number', description: 'Max entries.' },
         offset: { type: 'number', description: 'Skip entries.' },
         sort: { type: 'string', enum: ['importance', 'date'], description: 'importance or date.' },
         category: { anyOf: [{ type: 'string', enum: ['rule','constraint','decision','fact','goal','preference','task','issue'] }, { type: 'array', items: { type: 'string', enum: ['rule','constraint','decision','fact','goal','preference','task','issue'] }, minItems: 1 }], description: 'Category filter.' },
         includeArchived: { type: 'boolean', description: 'Include archived entries.' },
-        sessionId: { type: 'string', description: 'Scoped session id.' },
         includeMembers: { type: 'boolean', description: 'Include chunk members in output; does not widen the search pool.' },
         includeRaw: { type: 'boolean', description: 'Include unchunked raw/episode rows.' },
         sessionOnly: { type: 'boolean', description: 'Search this session only.' },
         projectScope: { type: 'string', description: 'Project pool selector: inferred from cwd, common, all, or slug.' },
-        cwd: { type: 'string', description: 'Infer projectScope.' },
       },
       additionalProperties: false,
     },
@@ -78,7 +78,7 @@ export const TOOL_DEFS = [
       type: 'object',
       properties: {
         query: { type: 'string', description: 'Search text.' },
-        period: { type: 'string', description: "last (recent sessions; +query topic-filter), Nm/Nh/Nd, today/yesterday/this_week/last_week, all, YYYY-MM-DD, date range, HH:MM~HH:MM (today), or 'YYYY-MM-DD HH:MM~HH:MM'." },
+        period: { type: 'string', description: PERIOD_DESCRIPTION },
         sort: { type: 'string', enum: ['date', 'importance'], description: 'date or importance.' },
         category: { anyOf: [{ type: 'string', enum: ['rule','constraint','decision','fact','goal','preference','task','issue'] }, { type: 'array', items: { type: 'string', enum: ['rule','constraint','decision','fact','goal','preference','task','issue'] }, minItems: 1 }], description: 'Category filter.' },
         limit: { type: 'number', default: 30, description: 'Max entries.' },

package/src/runtime/search/tool-defs.mjs

@@ -8,7 +8,7 @@ export const TOOL_DEFS = [
   {
     name: 'search',
     title: 'Mixdog Web Search',
-    description: `Web/docs/current-info search. Not repo-local; use explore/code_graph/grep. ${TOOL_SYNC_EXECUTION_CONTRACT} Cached; query supports array fan-out.`,
+    description: `Web/docs/current-info search. ${TOOL_SYNC_EXECUTION_CONTRACT} Cached; query supports array fan-out.`,
     inputSchema: {
       type: 'object',
       properties: {
@@ -16,23 +16,7 @@ export const TOOL_DEFS = [
         site: { type: 'string', description: 'Site/domain filter.' },
         type: { type: 'string', enum: ['web', 'news', 'images'], description: 'Default web.' },
         maxResults: { type: 'number', minimum: 1, maximum: 20, description: 'Result count, 1-20.' },
-        locale: {
-          description: 'Optional locale hint.',
-          anyOf: [
-            { type: 'string' },
-            {
-              type: 'object',
-              properties: {
-                country: { type: 'string', description: 'Country.' },
-                language: { type: 'string', description: 'Language.' },
-                region: { type: 'string', description: 'Region.' },
-                city: { type: 'string', description: 'City.' },
-                timezone: { type: 'string', description: 'Timezone.' },
-              },
-              additionalProperties: false,
-            },
-          ],
-        },
+        locale: { type: 'string', description: 'Optional locale hint, e.g. ko-KR or a city/region name.' },
         contextSize: { type: 'string', enum: ['low', 'medium', 'high'], description: 'Default low.' },
       },
       required: [],

package/src/runtime/shared/tool-execution-contract.mjs

@@ -2,7 +2,7 @@ export const TOOL_SYNC_EXECUTION_CONTRACT =
   'Runs synchronously in this tool call.';
 
 export const TOOL_ASYNC_EXECUTION_CONTRACT =
-  'Runs sync inline; no default auto-background. async forces a background task_id + completion notification. status/read/wait are recovery/blocking only.';
+  'Runs sync inline by default; async returns a background task_id and delivers a completion notification.';
 
 export const TOOL_MANUAL_CONTROL_CONTRACT =
   'wait/read/status/cancel are for explicit blocking or recovery only.';

package/src/session-runtime/output-styles.mjs

@@ -5,10 +5,11 @@ import { readFileSync, readdirSync, statSync } from 'node:fs';
 import { clean } from './session-text.mjs';
 import { readJsonSafe } from './fs-utils.mjs';
 
-const OUTPUT_STYLE_ORDER = ['default', 'simple', 'minimal', 'extreme-minimal'];
+const OUTPUT_STYLE_ORDER = ['simple', 'detailed', 'minimal', 'extreme-minimal'];
 const OUTPUT_STYLE_ALIASES = new Map([
-  ['compact', 'default'],
-  ['normal', 'default'],
+  ['compact', 'simple'],
+  ['normal', 'simple'],
+  ['detail', 'detailed'],
   ['extreme', 'extreme-minimal'],
   ['extremesimple', 'extreme-minimal'],
   ['extreme-simple', 'extreme-minimal'],
@@ -146,15 +147,15 @@ export function findOutputStyle(value, styles) {
 
 function configuredOutputStyleValue(dataDir) {
   const unified = readJsonSafe(join(dataDir, 'mixdog-config.json')) || {};
-  return clean(unified.outputStyle || (unified.agent && unified.agent.outputStyle) || 'default') || 'default';
+  return clean(unified.outputStyle || (unified.agent && unified.agent.outputStyle) || 'simple') || 'simple';
 }
 
 export function outputStyleStatus(rootDir, dataDir, { fresh = false } = {}) {
   const styles = listOutputStyleCatalog(rootDir, dataDir, { fresh });
   const configured = configuredOutputStyleValue(dataDir);
   const current = findOutputStyle(configured, styles)
-    || findOutputStyle('default', styles)
+    || findOutputStyle('simple', styles)
     || styles[0]
-    || { id: 'default', label: 'Default', description: '', aliases: [], source: 'builtin' };
+    || { id: 'simple', label: 'Simple', description: '', aliases: [], source: 'builtin' };
   return { configured, current, styles };
 }

package/src/session-runtime/tool-defs.mjs

@@ -18,7 +18,6 @@ export const TOOL_SEARCH_TOOL = {
     type: 'object',
     properties: {
       names: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }], description: 'Exact deferred tool names/aliases to load.' },
-      select: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }], description: 'Legacy alias for names; accepts exact names/aliases and select:name syntax.' },
     },
     additionalProperties: false,
   },

package/src/session-runtime/tool-surface.mjs

@@ -26,8 +26,17 @@ export function createToolSurface({
 
   // A workflow that delegates to NOBODY must not advertise the agent tool: a
   // schema-visible tool policy always rejects is a guaranteed error turn.
+  // The SESSION's effective workflow wins over the config-active one: headless
+  // and per-session overrides (e.g. bench `workflow=solo`) never touch the
+  // config default, so keying off config alone left the agent tool visible in
+  // Solo sessions (observed across a full TB2.1 run: advertised, never used).
   function workflowAllowsAgents() {
     try {
+      const sessionWorkflow = getSession()?.workflow;
+      if (sessionWorkflow && typeof sessionWorkflow === 'object'
+          && sessionWorkflow.agentsConfigured === true) {
+        return Array.isArray(sessionWorkflow.agents) && sessionWorkflow.agents.length > 0;
+      }
       const pack = loadWorkflowPack(cfgMod.getPluginData?.() || dataDir, activeWorkflowId(getConfig()));
       if (!pack || pack.agentsConfigured !== true) return true;
       return Array.isArray(pack.agents) && pack.agents.length > 0;

package/src/session-runtime/workflow.mjs

@@ -229,6 +229,13 @@ export function createWorkflowHelpers({ rootDir, dataDir, readMarkdownDocument,
       name: clean(pack?.name) || (id === DEFAULT_WORKFLOW_ID ? 'Default' : id),
       description: clean(pack?.description),
       source: clean(pack?.source),
+      // Delegation surface fields: the session stores this summary as
+      // session.workflow, and the agent-tool gate (tool-surface.mjs
+      // workflowAllowsAgents) needs them to filter the agent tool for
+      // packs that delegate to nobody — including headless/bench sessions
+      // whose workflow never touches the config-active pack.
+      agentsConfigured: pack?.agentsConfigured === true,
+      agents: Array.isArray(pack?.agents) ? pack.agents.slice() : [],
     };
   }
 

package/src/standalone/explore-tool.mjs

@@ -18,11 +18,11 @@ export const EXPLORE_TOOL = {
   name: 'explore',
   title: 'Explore',
   annotations: { title: 'Explore', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-  description: 'Locator for broad/uncertain targets with no known path, repo or machine-wide (dot dirs included). Array = independent targets: query[] fans out facets (max 8), never rephrasings.',
+  description: 'Locator for broad/uncertain targets with no known path, repo or machine-wide (dot dirs included). query[] fans out up to 8 independent facets in parallel.',
   inputSchema: {
     type: 'object',
     properties: {
-        query: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Narrow locator query; array = independent facets of the task (not rephrasings), fanned out in parallel.' },
+        query: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Narrow locator query; array = independent facets fanned out in parallel.' },
       cwd: { type: 'string', description: 'Project/root directory.' },
     },
     required: [],

package/src/workflows/default/WORKFLOW.md

@@ -17,7 +17,8 @@ On approval, fan out at maximum width: one agent per independent scope, all
 spawned in one turn; only a scope that depends on another's output waits.
 Split the plan into as many scopes as possible: disjoint file/module sets
 are independent; merge only on a true output dependency. Prefer parallel
-scopes over sequential slices in one agent.
+scopes over sequential slices in one agent. Brief each agent per the Lead
+Brief contract.
 
 Route by complexity: simple, well-understood implementation goes to Worker;
 complex or investigative implementation goes to Heavy Worker; Lead itself

package/src/workflows/solo/WORKFLOW.md

@@ -15,11 +15,13 @@ changed request resets planning; a scope change requires fresh approval.
 On approval, Lead executes all work itself — never spawn, send, or delegate
 to agents. Complete in-scope fixes without reapproval.
 
-Verification is single-pass: run the one check that most directly proves the
-deliverable exactly once; a pass is final. Iterate only on a failing check,
-re-running just that check after each fix, or report the blocker.
+Verification is single-pass and risk-proportional: exactly one check that
+most directly proves the deliverable — a direct result check for trivial or
+read-only work, full test/build runs only for risky or behavior-changing
+work. A pass is final. Iterate only on a failing check, re-running just that
+check after each fix, or report the blocker.
 
-Report the result and its proving check against the approved plan. Build, deploy, commit,
-and push happen only on an explicit user request.
+Report the result against the approved plan. Build, deploy, commit, and push
+happen only on an explicit user request.
 
 On direction change, pause and re-consult the user.

package/src/output-styles/default.md

@@ -1,40 +0,0 @@
----
-name: default
-title: Default
-description: Concise engineering summaries
-keep-coding-instructions: true
----
-
-# Output Style
-
-Mixdog default — the most detailed style, but always summary-form, never
-essay-form. Depth comes from picking the right facts, not explaining more.
-
-Content
-- Lead with the outcome in one short sentence, then only the detail that
-  matters: what changed, key evidence (paths, commands, errors, verification).
-- Summarize at the concept level: name the problem/behavior and direction,
-  not the code path; cite a symbol/path only as an anchor.
-  State conclusions, not reasoning: no mechanism walkthroughs or chained
-  qualifiers unless asked.
-- Compress by cutting content (filler, hedging, restated facts), not grammar:
-  natural, complete sentences in the user's language; technical terms, paths,
-  commands, symbols, code, and exact errors stay verbatim.
-- Say each point once: problem and fix in ONE compact statement. Size budget:
-  roughly TWICE the Simple style — about 2 rendered lines per point, whole
-  report ~10–15 lines, spent on evidence Simple would drop.
-- Use labels such as `Changes`, `Verification`, and `Risks / next steps` in
-  final reports; skip labels on interim progress, and collapse trivial tasks
-  to a couple of sentences instead of forcing sections.
-- Synthesize agent or retrieval results; never forward raw reports, long file
-  lists, tool traces, or session metadata.
-- Do not hide blockers, failed verification, or required follow-up; surface them
-  in one short clause.
-
-Layout (hard rules)
-- One bullet or numbered item = one idea, at most 2 rendered lines, opened
-  with a short **bold key point**; if it needs more, cut the detail.
-- Blank line between numbered items and between any multi-line list items —
-  never a wall of consecutive multi-line items. Paragraphs ~3 lines max with
-  blank lines between blocks; nest at most one sub-level.
-- Never name this style unless asked.