@zhixuan92/multi-model-agent 5.0.2 → 5.0.3

package/dist/cli/telemetry.js

@@ -0,0 +1,161 @@
+/**
+ * telemetry.ts — `mmagent telemetry` subcommands.
+ *
+ * Usage:
+ *   mmagent telemetry status
+ *   mmagent telemetry enable
+ *   mmagent telemetry disable
+ *   mmagent telemetry reset-id
+ *   mmagent telemetry dump-queue
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { decide } from '../telemetry/consent.js';
+import { deleteInstallId } from '../telemetry/install-id.js';
+import { bumpGeneration } from '../telemetry/generation.js';
+import { Queue } from '../telemetry/queue.js';
+/**
+ * Read the raw MMAGENT_TELEMETRY env value (not the parsed decision).
+ */
+function readRawEnv() {
+    return process.env.MMAGENT_TELEMETRY;
+}
+/**
+ * Read the existing config.json as a parsed object, or null if it doesn't exist.
+ */
+function readConfigObj(homeDir) {
+    const cfgPath = join(homeDir, 'config.json');
+    if (!existsSync(cfgPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(cfgPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write config.json, ensuring parent directory exists.
+ */
+function writeConfigObj(homeDir, obj) {
+    const cfgPath = join(homeDir, 'config.json');
+    const parent = dirname(cfgPath);
+    if (!existsSync(parent))
+        mkdirSync(parent, { recursive: true });
+    writeFileSync(cfgPath, JSON.stringify(obj, null, 2) + '\n', { mode: 0o600 });
+}
+async function revokeIdentity(homeDir) {
+    await bumpGeneration(homeDir);
+    const queuePath = join(homeDir, 'telemetry-queue.ndjson');
+    if (existsSync(queuePath))
+        unlinkSync(queuePath);
+}
+// ─── status ──────────────────────────────────────────────────────────────────
+async function runStatus(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const d = decide(deps.homeDir);
+    const envRaw = readRawEnv();
+    const lines = [];
+    lines.push(`Telemetry: ${d.enabled ? 'enabled' : 'disabled'}`);
+    lines.push(`Source:    ${d.source}`);
+    if (d.source === 'env_invalid') {
+        lines.push(`Warning:   MMAGENT_TELEMETRY="${envRaw ?? ''}" is not a recognized value (use 1/true/on/yes or 0/false/off/no)`);
+    }
+    // Surface set-but-empty env distinction
+    if (envRaw !== undefined && envRaw.trim().length === 0) {
+        lines.push(`Note:      MMAGENT_TELEMETRY is set to '' (no effect — falls through to ${d.source})`);
+    }
+    stdout(lines.join('\n') + '\n');
+    return 0;
+}
+// ─── enable ──────────────────────────────────────────────────────────────────
+async function runEnable(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    let cfg = readConfigObj(deps.homeDir) ?? {};
+    // Remove bare top-level `enabled` if present — canonical shape is `telemetry.enabled`
+    if (typeof cfg.enabled === 'boolean') {
+        delete cfg.enabled;
+    }
+    const telemetry = (cfg.telemetry ?? {});
+    telemetry.enabled = true;
+    delete telemetry.consentSchemaVersion;
+    cfg.telemetry = telemetry;
+    try {
+        writeConfigObj(deps.homeDir, cfg);
+        stdout('Telemetry enabled (config.telemetry.enabled = true)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry enable: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── disable ──────────────────────────────────────────────────────────────────
+async function runDisable(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    let cfg = readConfigObj(deps.homeDir) ?? {};
+    if (typeof cfg.enabled === 'boolean') {
+        delete cfg.enabled;
+    }
+    const telemetry = (cfg.telemetry ?? {});
+    telemetry.enabled = false;
+    cfg.telemetry = telemetry;
+    try {
+        writeConfigObj(deps.homeDir, cfg);
+        await revokeIdentity(deps.homeDir);
+        stdout('Telemetry disabled (config.telemetry.enabled = false, identity revoked)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry disable: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── reset-id ─────────────────────────────────────────────────────────────────
+async function runResetId(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    try {
+        await revokeIdentity(deps.homeDir);
+        deleteInstallId(deps.homeDir);
+        stdout('Identity reset (generation bumped, queue deleted, install-id deleted)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry reset-id: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── dump-queue ───────────────────────────────────────────────────────────────
+async function runDumpQueue(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    try {
+        const queue = new Queue(deps.homeDir);
+        const batch = await queue.readBatch();
+        stdout(JSON.stringify(batch.records, null, 2) + '\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry dump-queue: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── dispatch ─────────────────────────────────────────────────────────────────
+export async function runTelemetry(deps) {
+    switch (deps.subcommand) {
+        case 'status': return runStatus(deps);
+        case 'enable': return runEnable(deps);
+        case 'disable': return runDisable(deps);
+        case 'reset-id': return runResetId(deps);
+        case 'dump-queue': return runDumpQueue(deps);
+        default: {
+            const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+            stderr(`mmagent telemetry: unknown subcommand '${deps.subcommand}'\n`);
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/cli/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/cli/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/cli/toggle.d.ts

@@ -0,0 +1,26 @@
+export declare const ToggleExitCode: Readonly<{
+    SUCCESS: 0;
+    ERR_PARTIAL: 1;
+    ERR_UNKNOWN_TARGET: 3;
+}>;
+export interface ToggleDeps {
+    argv?: string[];
+    homeDir?: string;
+    /** Override skills root — threaded into runSyncSkills for `enable` in tests. */
+    skillsRoot?: string;
+    /** Recorded in the sentinel for diagnostics; defaults to 'unknown'. */
+    cliVersion?: string;
+    stdout?: (s: string) => boolean;
+    stderr?: (s: string) => boolean;
+}
+/**
+ * `mmagent disable` — remove all MMA skills from the resolved clients and
+ * record the sticky sentinel.
+ */
+export declare function runDisable(deps?: ToggleDeps): Promise<number>;
+/**
+ * `mmagent enable` — clear the sentinel for the resolved clients, then
+ * delegate to sync-skills' idempotent upsert to reinstall the skills.
+ */
+export declare function runEnable(deps?: ToggleDeps): Promise<number>;
+//# sourceMappingURL=toggle.d.ts.map

package/dist/cli/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/cli/toggle.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AA4BD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyEvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDtE"}

package/dist/cli/toggle.js

@@ -0,0 +1,185 @@
+/**
+ * toggle.ts — `mmagent disable` / `mmagent enable` subcommands.
+ *
+ * disable: remove every shipped skill from the resolved clients, drop their
+ *   manifest entries, and record a sticky sentinel so a later `npm install`
+ *   postinstall (which shells out to `sync-skills`) does not silently
+ *   reinstall them. This is the only "off switch" that survives an upgrade.
+ * enable: clear the sentinel for the resolved clients, then run the normal
+ *   sync-skills upsert to reinstall the skills.
+ *
+ * Both reuse sync-skills' target resolution so `--target` / `--all-targets`
+ * behave identically across all three commands.
+ *
+ * Usage:
+ *   mmagent disable [--target=<client>] [--all-targets] [--dry-run] [--json]
+ *   mmagent enable  [--target=<client>] [--all-targets] [--dry-run] [--json]
+ *
+ * Exit codes:
+ *   0 — success (or no clients detected)
+ *   1 — one or more skills failed to remove
+ *   3 — explicit --target was not a known client
+ */
+import * as os from 'node:os';
+import minimist from 'minimist';
+import { removeEntry, ALL_CLIENTS } from '../skill-install/manifest.js';
+import { SUPPORTED_SKILLS } from '../skill-install/discover.js';
+import { removeSkillFromClient, UnknownTargetError, } from '../skill-install/skill-installer-common.js';
+import { addDisabledTargets, clearDisabledTargets, disabledTargets, } from '../skill-install/disabled-state.js';
+import { resolveTargets, runSyncSkills } from './sync-skills.js';
+export const ToggleExitCode = Object.freeze({
+    SUCCESS: 0,
+    ERR_PARTIAL: 1,
+    ERR_UNKNOWN_TARGET: 3,
+});
+function parseToggleArgs(argv) {
+    const args = minimist(argv, {
+        string: ['target'],
+        boolean: ['dry-run', 'json', 'all-targets'],
+        alias: { t: 'target', j: 'json' },
+    });
+    let targets = null;
+    if (args.target) {
+        const t = Array.isArray(args.target) ? args.target : [args.target];
+        targets = t.map((s) => s);
+    }
+    return {
+        targets,
+        allTargets: args['all-targets'] === true,
+        dryRun: args['dry-run'] === true,
+        json: args['json'] === true,
+    };
+}
+/**
+ * `mmagent disable` — remove all MMA skills from the resolved clients and
+ * record the sticky sentinel.
+ */
+export async function runDisable(deps = {}) {
+    const argv = deps.argv ?? process.argv.slice(2);
+    const homeDir = deps.homeDir ?? os.homedir();
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const cliVersion = deps.cliVersion ?? 'unknown';
+    const parsed = parseToggleArgs(argv);
+    let targets;
+    try {
+        targets = resolveTargets(parsed.targets, parsed.allTargets, homeDir);
+    }
+    catch (err) {
+        if (err instanceof UnknownTargetError) {
+            stderr(`mmagent disable: ${err.message}\n`);
+            return ToggleExitCode.ERR_UNKNOWN_TARGET;
+        }
+        throw err;
+    }
+    if (targets.length === 0) {
+        if (parsed.json) {
+            stdout(JSON.stringify({ action: 'disable', targets: [], outcome: 'no-clients-detected' }) + '\n');
+        }
+        else {
+            stdout('No clients detected. Use --target=<client> or --all-targets.\n');
+        }
+        return ToggleExitCode.SUCCESS;
+    }
+    const removed = [];
+    const errors = [];
+    if (parsed.dryRun) {
+        for (const target of targets) {
+            for (const skill of SUPPORTED_SKILLS)
+                removed.push({ skill, target });
+        }
+    }
+    else {
+        for (const target of targets) {
+            for (const skill of SUPPORTED_SKILLS) {
+                try {
+                    removeSkillFromClient(skill, target, homeDir);
+                    removed.push({ skill, target });
+                }
+                catch (err) {
+                    errors.push({
+                        skill,
+                        target,
+                        reason: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        for (const skill of SUPPORTED_SKILLS)
+            removeEntry(skill, targets, homeDir);
+        addDisabledTargets(homeDir, targets, cliVersion);
+    }
+    if (parsed.json) {
+        stdout(JSON.stringify({
+            action: 'disable',
+            dryRun: parsed.dryRun,
+            targets,
+            removed: removed.length,
+            errors,
+        }) + '\n');
+    }
+    else {
+        const verb = parsed.dryRun ? 'Would disable' : 'Disabled';
+        const errClause = errors.length > 0 ? `, ${errors.length} errors` : '';
+        stdout(`${verb} MMA skills → ${targets.join(', ')} (${removed.length} removed${errClause}).\n`);
+        if (!parsed.dryRun)
+            stdout('Run `mmagent enable` to restore.\n');
+        for (const e of errors)
+            stderr(`error: ${e.skill} → ${e.target}: ${e.reason}\n`);
+    }
+    return errors.length > 0 ? ToggleExitCode.ERR_PARTIAL : ToggleExitCode.SUCCESS;
+}
+/**
+ * `mmagent enable` — clear the sentinel for the resolved clients, then
+ * delegate to sync-skills' idempotent upsert to reinstall the skills.
+ */
+export async function runEnable(deps = {}) {
+    const argv = deps.argv ?? process.argv.slice(2);
+    const homeDir = deps.homeDir ?? os.homedir();
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const parsed = parseToggleArgs(argv);
+    let targets;
+    try {
+        targets = resolveTargets(parsed.targets, parsed.allTargets, homeDir);
+    }
+    catch (err) {
+        if (err instanceof UnknownTargetError) {
+            stderr(`mmagent enable: ${err.message}\n`);
+            return ToggleExitCode.ERR_UNKNOWN_TARGET;
+        }
+        throw err;
+    }
+    const wasDisabled = disabledTargets(homeDir);
+    const bare = parsed.targets === null && !parsed.allTargets;
+    // Clear the sentinel BEFORE syncing — otherwise sync-skills would see the
+    // targets as still-disabled and skip them. On --dry-run, leave it intact.
+    if (!parsed.dryRun) {
+        // No explicit --target means "re-enable everything", so clear the whole set.
+        const toClear = bare ? [...ALL_CLIENTS] : targets;
+        clearDisabledTargets(homeDir, toClear);
+    }
+    if (wasDisabled.length === 0) {
+        stdout('MMA skills were not disabled; syncing to ensure they are installed.\n');
+    }
+    // Reinstall via the canonical upsert. For a bare `enable`, sync-skills would
+    // otherwise touch only auto-detected clients (claude-code / codex) and skip
+    // a previously `disable --target=cursor` — un-pinning it without restoring
+    // it. So when no explicit target is given, sync the union of detected
+    // clients and whatever was pinned off, making `enable` actually restore what
+    // `disable` removed. Explicit --target / --all-targets pass straight through.
+    let syncArgv = argv;
+    if (bare && wasDisabled.length > 0) {
+        const detected = resolveTargets(null, false, homeDir);
+        const union = ALL_CLIENTS.filter((c) => detected.includes(c) || wasDisabled.includes(c));
+        syncArgv = [...argv, ...union.map((c) => `--target=${c}`)];
+    }
+    return runSyncSkills({
+        argv: syncArgv,
+        homeDir,
+        skillsRoot: deps.skillsRoot,
+        stdout: deps.stdout,
+        stderr: deps.stderr,
+    });
+}
+//# sourceMappingURL=toggle.js.map

package/dist/cli/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/cli/toggle.ts"],"names":[],"mappings":"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"}

package/dist/http/async-dispatch.d.ts

@@ -0,0 +1,44 @@
+import type { BatchRegistry, ProjectContext } from '@zhixuan92/multi-model-agent-core';
+import type { ExecutionContext } from '@zhixuan92/multi-model-agent-core';
+import type { HandlerDeps } from './handler-deps.js';
+export interface AsyncDispatchOptions<TResult> {
+    tool: string;
+    projectCwd: string;
+    blockIds: string[];
+    batchRegistry: BatchRegistry;
+    projectContext: ProjectContext;
+    deps: HandlerDeps;
+    /**
+     * Caller identity from the x-mma-client request header. Threaded into
+     * ExecutionContext so the cloud `task.completed` event carries the client.
+     * Without this the wire event has an empty string and the backend rejects
+     * the upload (STRICT_ID_REGEX). triggeringSkill was dropped because it's
+     * implied by `route` for the 99% case (mma-<route> → /<route>).
+     */
+    caller?: {
+        client: string;
+        mainModel?: string | null;
+    };
+    reviewPolicy?: 'full' | 'quality_only' | 'diff_only' | 'none';
+    /**
+     * The async function that does the real work. Receives the ExecutionContext
+     * and the pre-allocated batchId.
+     */
+    executor: (ctx: ExecutionContext, batchId: string) => Promise<TResult>;
+}
+export interface AsyncDispatchResult {
+    batchId: string;
+    statusUrl: string;
+}
+/**
+ * Registers a new batch as 'pending', schedules the executor via setImmediate,
+ * and returns immediately with { batchId, statusUrl }.
+ *
+ * On success: calls batchRegistry.complete(batchId, result).
+ * On failure: calls batchRegistry.fail(batchId, { code, message, stack }).
+ *
+ * IMPORTANT: Does NOT maintain a manual activeBatches counter.
+ * Use BatchRegistry.countActiveForProject(cwd) as the truth source.
+ */
+export declare function asyncDispatch<TResult>(opts: AsyncDispatchOptions<TResult>): AsyncDispatchResult;
+//# sourceMappingURL=async-dispatch.d.ts.map

package/dist/http/async-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-dispatch.d.ts","sourceRoot":"","sources":["../../src/http/async-dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvD,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9D;;;OAGG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EACnC,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAClC,mBAAmB,CA8HrB"}

package/dist/http/async-dispatch.js

@@ -0,0 +1,175 @@
+// packages/server/src/http/async-dispatch.ts
+import { randomUUID } from 'node:crypto';
+import { TaskEnvelopeStore } from '@zhixuan92/multi-model-agent-core/events/task-envelope';
+import { buildExecutionContext } from './execution-context.js';
+/**
+ * Registers a new batch as 'pending', schedules the executor via setImmediate,
+ * and returns immediately with { batchId, statusUrl }.
+ *
+ * On success: calls batchRegistry.complete(batchId, result).
+ * On failure: calls batchRegistry.fail(batchId, { code, message, stack }).
+ *
+ * IMPORTANT: Does NOT maintain a manual activeBatches counter.
+ * Use BatchRegistry.countActiveForProject(cwd) as the truth source.
+ */
+export function asyncDispatch(opts) {
+    const batchId = randomUUID();
+    const { batchRegistry, projectContext, deps, tool, projectCwd, blockIds } = opts;
+    // Register entry as 'pending' before scheduling executor
+    batchRegistry.register({
+        batchId,
+        projectCwd,
+        tool,
+        state: 'pending',
+        startedAt: Date.now(),
+        stateChangedAt: Date.now(),
+        blockIds,
+        blocksReleased: false,
+    });
+    // Create and attach envelope to registry
+    const envelope = TaskEnvelopeStore.create({
+        taskId: batchId + ':' + 0,
+        batchId: batchId, taskIndex: 0,
+        route: tool, agentType: 'standard',
+        client: opts.caller?.client ?? '', mainModel: opts.caller?.mainModel ?? '', cwd: projectCwd,
+        reviewPolicy: opts.reviewPolicy ?? 'full',
+    }, deps.bus);
+    batchRegistry.attachEnvelope(batchId, 0, envelope);
+    // Build execution context for this batch
+    const ctx = buildExecutionContext(deps, projectContext, batchId, envelope, tool, opts.caller);
+    // Schedule executor asynchronously — do not await here
+    const startedAtMs = Date.now();
+    setImmediate(() => {
+        void (async () => {
+            try {
+                // Mark the batch as running so /batch/:id polling reports
+                // "1/1 running, Xs elapsed" the instant the executor begins.
+                // Without bumping the headline snapshot here, the polling endpoint
+                // returns the initial "0/N queued" fallback until the runner's first
+                // heartbeat arrives — which can be many seconds (or minutes) later
+                // because heartbeats fire from inside provider.run. That gap is what
+                // made 4.0.1 audits look like the daemon was deadlocked when the
+                // only thing actually slow was the LLM call.
+                const entry = batchRegistry.get(batchId);
+                if (entry) {
+                    entry.tasksTotal = 1;
+                    entry.tasksStarted = 1;
+                    entry.tasksCompleted = 0;
+                    // Use the route's stage-order denominator (3 for audit, 7 for
+                    // delegate, etc.) so polling shows "Implementing (1/3)" the
+                    // instant the executor starts — instead of an opaque
+                    // "1/1 running" that doesn't tell the main agent how far along
+                    // the lifecycle has progressed.
+                    // Headline seeding moved to envelope creation in T7-T11 migration —
+                    // each TaskEnvelope's headline is derived on every mutation, and
+                    // BatchRegistry no longer caches snapshot objects.
+                }
+                // 4.6.0+: always-on verbose breadcrumb so operators tailing the daemon
+                // see the executor lifecycle past request_received without grepping the
+                // JSONL log.
+                process.stderr.write(`[mmagent] event=executor_started ts=${new Date().toISOString()} batch=${batchId} route=${tool}\n`);
+                const result = await opts.executor(ctx, batchId);
+                const resultObj = result;
+                const entryAfter = batchRegistry.get(batchId);
+                if (entryAfter) {
+                    // For multi-task batches the executor bumped tasksTotal from the
+                    // placeholder of 1 to the real fan-out width. Mark every task as
+                    // completed so the live/terminal headline reports n/n complete.
+                    entryAfter.tasksCompleted = Math.max(entryAfter.tasksTotal ?? 1, 1);
+                }
+                const taskCount = Array.isArray(resultObj?.results) ? resultObj.results.length : 0;
+                const durationMs = Date.now() - startedAtMs;
+                // Gap 5 fix (4.0.3+): inspect the envelope for structured failure
+                // signals. The executor may catch errors and package them into a
+                // result envelope (with structuredError or status='error') instead
+                // of throwing — without this check, batch_completed fires
+                // misleadingly while the verbose log gives operators no signal
+                // that anything went wrong. Detection uses STRUCTURED FIELDS ONLY,
+                // never string comparisons.
+                //
+                // Order matters: detect failure FIRST, then call complete() or
+                // fail() exactly once. Pre-fix, complete() ran unconditionally
+                // before fail() — the fail() then no-op'd because the registry
+                // entry was already terminal, leaving the wire error field stuck
+                // at "not_applicable" even when detectFailure returned a real
+                // failure. Probe I (multi-task /delegate) hit this every time.
+                const failure = detectFailure(resultObj);
+                if (failure) {
+                    batchRegistry.fail(batchId, failure);
+                    deps.bus.emitPlainEntry({ ts: new Date().toISOString(), kind: 'batch_failed', fields: { batch_id: batchId, tool, duration_ms: durationMs, error_code: failure.code, error_message: failure.message } });
+                    process.stderr.write(`[mmagent] event=batch_failed ts=${new Date().toISOString()} batch=${batchId} route=${tool} duration_ms=${durationMs} error_code=${failure.code} error="${failure.message.replace(/"/g, '\\"')}"\n`);
+                }
+                else {
+                    batchRegistry.complete(batchId);
+                    const dispatchMode = resultObj?.dispatchMode;
+                    deps.bus.emitPlainEntry({ ts: new Date().toISOString(), kind: 'batch_completed', fields: { batch_id: batchId, tool, duration_ms: durationMs, task_count: taskCount, ...(dispatchMode !== undefined ? { dispatch_mode: dispatchMode } : {}) } });
+                    process.stderr.write(`[mmagent] event=batch_completed ts=${new Date().toISOString()} batch=${batchId} route=${tool} duration_ms=${durationMs}\n`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const stack = err instanceof Error ? err.stack : undefined;
+                const errObj = {
+                    code: 'runner_crash',
+                    message,
+                    ...(stack !== undefined && { stack }),
+                };
+                batchRegistry.fail(batchId, errObj);
+                const durationMs = Date.now() - startedAtMs;
+                deps.bus.emitPlainEntry({ ts: new Date().toISOString(), kind: 'batch_failed', fields: { batch_id: batchId, tool, duration_ms: durationMs, error_code: errObj.code, error_message: errObj.message } });
+                process.stderr.write(`[mmagent] event=batch_failed ts=${new Date().toISOString()} batch=${batchId} route=${tool} duration_ms=${durationMs} error="${message.replace(/"/g, '\\"')}"\n`);
+            }
+        })();
+    });
+    return {
+        batchId,
+        statusUrl: `/batch/${batchId}`,
+    };
+}
+/**
+ * Inspect an executor return envelope for structured failure signals.
+ * Returns { code, message } when the envelope indicates failure, null
+ * otherwise.
+ *
+ * Per the Gap 5 fix design (wire-telemetry-gaps plan): NO string
+ * comparison to "batch succeeded". Use only:
+ *   1. Any task result with `structuredError` (most authoritative)
+ *   2. Any task result with `status` other than 'ok'
+ *   3. Envelope-level `error` object whose `kind` is not 'not_applicable'
+ *      (notApplicable() is the structured "no error" sentinel)
+ */
+function detectFailure(envelope) {
+    if (!envelope)
+        return null;
+    const results = Array.isArray(envelope.results) ? envelope.results : [];
+    // Source 1: explicit structuredError on any task result
+    for (const r of results) {
+        const se = r.structuredError;
+        if (se && typeof se.code === 'string') {
+            return { code: se.code, message: typeof se.message === 'string' ? se.message : se.code };
+        }
+    }
+    // Source 2: any task result with status === 'error'.
+    // 'incomplete' is intentionally NOT treated as failure — review-rework
+    // paths can transit through 'incomplete' on intermediate rounds while
+    // the eventual envelope still represents a valid (if imperfect) batch.
+    // Only 'error' and 'failed' are categorical batch-level failures.
+    for (const r of results) {
+        const status = r.status;
+        if (typeof status === 'string' && (status === 'error' || status === 'failed')) {
+            const code = (typeof r.errorCode === 'string' && r.errorCode.length > 0) ? r.errorCode : status;
+            const msg = (typeof r.error === 'string' && r.error.length > 0) ? r.error : status;
+            return { code, message: msg };
+        }
+    }
+    // Source 3: envelope-level error object with kind != 'not_applicable'
+    const env = envelope.error;
+    if (env && typeof env.kind === 'string' && env.kind !== 'not_applicable') {
+        return {
+            code: typeof env.code === 'string' ? env.code : 'envelope_error',
+            message: typeof env.message === 'string' ? env.message : 'envelope error',
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=async-dispatch.js.map

package/dist/http/async-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-dispatch.js","sourceRoot":"","sources":["../../src/http/async-dispatch.ts"],"names":[],"mappings":"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"}