@zhixuan92/multi-model-agent-core 4.7.1 → 4.7.3

package/dist/events/stderr-log-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stderr-log-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/stderr-log-subscriber.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,qBAAa,mBAAoB,YAAW,UAAU;IAGxC,OAAO,CAAC,KAAK;IAFzB,QAAQ,CAAC,IAAI,gBAAgB;gBAET,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAgD;IAE7F,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;CAI/B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAe7D"}

package/dist/events/stderr-log-subscriber.js

@@ -0,0 +1,50 @@
+// packages/core/src/events/stderr-log-subscriber.ts
+//
+// EnvelopeBus subscriber that streams every plain log entry to the daemon's
+// stderr in `[mmagent] event=... ts=... key=val` snake_case format. Always-on
+// for `mmagent serve` — there is no quiet mode and no `--verbose` flag.
+// Replaces the 4.7.1 VerboseLogChannel after the 4.7.2 envelope-bus rewrite
+// dropped it; `verbose` as a separate concept is gone (4.7.3+).
+//
+// Filters: emits PlainLogEntry (provider events + lifecycle one-offs).
+// Envelope snapshots are intentionally NOT emitted — they're too noisy at
+// stderr (one per 5s heartbeat + per mutation). LogWriter handles the file
+// path for full envelope persistence.
+export class StderrLogSubscriber {
+    write;
+    name = 'stderr-log';
+    constructor(write = (line) => { process.stderr.write(line); }) {
+        this.write = write;
+    }
+    receive(msg) {
+        if (msg.type !== 'plain')
+            return;
+        this.write(formatStderrLine(msg.entry) + '\n');
+    }
+}
+/**
+ * Format a PlainLogEntry as a single `[mmagent] event=... ts=... key=val` line.
+ * Primitive values are emitted directly (snake-cased, quoted only when they
+ * contain whitespace or quotes). One line per event — operators can grep this
+ * stream the same way they'd grep the JSONL log.
+ */
+export function formatStderrLine(entry) {
+    const fields = entry.fields ?? {};
+    const eventName = typeof fields['event'] === 'string' ? fields['event'] : entry.kind;
+    const parts = [`event=${eventName}`, `ts=${entry.ts}`];
+    for (const [k, v] of Object.entries(fields)) {
+        if (k === 'event')
+            continue;
+        if (v === undefined || v === null)
+            continue;
+        const snake = k.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+        if (typeof v === 'string' && /[\s"\\]/.test(v)) {
+            parts.push(`${snake}=${JSON.stringify(v)}`);
+        }
+        else {
+            parts.push(`${snake}=${v}`);
+        }
+    }
+    return `[mmagent] ${parts.join(' ')}`;
+}
+//# sourceMappingURL=stderr-log-subscriber.js.map

package/dist/events/stderr-log-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stderr-log-subscriber.js","sourceRoot":"","sources":["../../src/events/stderr-log-subscriber.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,gEAAgE;AAChE,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,2EAA2E;AAC3E,sCAAsC;AAKtC,MAAM,OAAO,mBAAmB;IAGV;IAFX,IAAI,GAAG,YAAY,CAAC;IAE7B,YAAoB,QAAgC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAzE,UAAK,GAAL,KAAK,CAAoE;IAAG,CAAC;IAEjG,OAAO,CAAC,GAAe;QACrB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACrF,MAAM,KAAK,GAAa,CAAC,SAAS,SAAS,EAAE,EAAE,MAAM,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,OAAO;YAAE,SAAS;QAC5B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/events/task-envelope.d.ts

@@ -0,0 +1,174 @@
+import type { EnvelopeBus } from './envelope-bus.js';
+export interface StructuredError {
+    code: string;
+    message: string;
+    where?: string;
+}
+export interface Finding {
+    id: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    category: string;
+    claim: string;
+    evidence: string;
+    suggestion?: string;
+    source: 'implementer' | 'reviewer';
+}
+export interface EscalationEntry {
+    fromModel: string;
+    toModel: string;
+    reason: string;
+    atStage?: string;
+}
+export interface ValidationWarning {
+    rule: string;
+    path: string;
+}
+export type Route = 'delegate' | 'audit' | 'review' | 'debug' | 'investigate' | 'execute-plan' | 'retry' | 'research';
+export type EnvelopeStatus = 'running' | 'done' | 'done_with_concerns' | 'failed';
+export type StageName = 'implementing' | 'reviewing' | 'reworking' | 'annotating' | 'committing';
+export type AgentTier = 'standard' | 'complex';
+export interface StageRecord {
+    name: StageName;
+    round: number;
+    outcome: 'advance' | 'concern' | 'fail' | 'skipped' | null;
+    startedAt: string;
+    completedAt: string | null;
+    durationMs: number;
+    costUSD: number | null;
+    model: string;
+    tier: AgentTier;
+    turnsUsed: number;
+    toolCallCount: number;
+    filesReadCount: number;
+    filesWrittenCount: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedReadTokens: number | null;
+    cachedNonReadTokens: number | null;
+    filesCommittedCount?: number;
+    branchCreated?: boolean;
+    skipReason?: 'noop' | 'no_command' | 'not_applicable' | 'reviewPolicy_none';
+    verdict?: 'passed' | 'failed' | 'no_command' | 'annotated' | 'approved' | 'changes_required' | 'concerns' | 'error';
+    findingsBySeverity?: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    concernCategories?: string[];
+}
+export interface ToolCallRecord {
+    ts: string;
+    stage: string;
+    tool: string;
+    filesRead: string[];
+    filesWritten: string[];
+}
+export interface HeadlineSnapshot {
+    prefix: string;
+    stageLabel: string;
+    stageDone: number;
+    stageTotal: number;
+    toolReads: number;
+    toolWrites: number;
+    toolTotal: number;
+}
+export interface TaskEnvelope {
+    taskId: string;
+    batchId: string;
+    taskIndex: number;
+    route: Route;
+    agentType: AgentTier;
+    client: string;
+    mainModel: string;
+    cwd: string;
+    startedAt: string;
+    status: EnvelopeStatus;
+    terminalAt: string | null;
+    stopReason: string | null;
+    structuredError: StructuredError | null;
+    stages: StageRecord[];
+    toolCalls: ToolCallRecord[];
+    filesRead: string[];
+    filesWritten: string[];
+    realFilesChanged: string[];
+    totalCostUSD: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCachedReadTokens: number;
+    totalCachedNonReadTokens: number;
+    totalDurationMs: number;
+    turnsUsed: number;
+    stallCount: number;
+    sandboxViolationCount: number;
+    taskMaxIdleMs: number;
+    findings: Finding[];
+    escalationLog: EscalationEntry[];
+    validationWarnings: ValidationWarning[];
+    headline: HeadlineSnapshot;
+}
+export interface CreateSeed {
+    taskId: string;
+    batchId: string;
+    taskIndex: number;
+    route: Route;
+    agentType: AgentTier;
+    client: string;
+    mainModel: string;
+    cwd: string;
+}
+export declare class SealedEnvelopeError extends Error {
+    constructor(method: string);
+}
+type Notify = (reason: string) => void;
+export declare class TaskEnvelopeStore {
+    private env;
+    private sealed;
+    private notify;
+    private constructor();
+    static create(seed: CreateSeed, busOrNotify?: EnvelopeBus | Notify): TaskEnvelopeStore;
+    private guard;
+    startStage(name: StageName, init: {
+        model: string;
+        tier: AgentTier;
+        startedAt?: string;
+        round?: number;
+    }): void;
+    completeStage(name: StageName, round: number, result: Partial<StageRecord> & {
+        outcome: StageRecord['outcome'];
+        durationMs: number;
+    }): void;
+    recordToolCall(entry: {
+        stage: string;
+        tool: string;
+        filesRead?: string[];
+        filesWritten?: string[];
+    }): void;
+    recordEscalation(entry: EscalationEntry): void;
+    recordStall(entry: {
+        atMs: number;
+        idleMs: number;
+    }): void;
+    recordSandboxViolation(entry: {
+        kind: string;
+        path: string;
+    }): void;
+    recordFinding(f: Finding): void;
+    recordValidationWarning(w: ValidationWarning): void;
+    recordHeartbeat(_state: {
+        stallIdleMs: number;
+    }): void;
+    seal(terminal: {
+        status: 'done' | 'done_with_concerns' | 'failed';
+        terminalAt?: string;
+        stopReason: string | null;
+        structuredError?: StructuredError | null;
+        realFilesChanged: string[];
+    }): void;
+    isSealed(): boolean;
+    snapshot(): Readonly<TaskEnvelope>;
+    private recomputeTotals;
+    private recomputeHeadline;
+}
+export {};
+//# sourceMappingURL=task-envelope.d.ts.map

package/dist/events/task-envelope.d.ts.map

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

package/dist/events/task-envelope.js

@@ -0,0 +1,165 @@
+// packages/core/src/events/task-envelope.ts
+// StructuredError lives on RunResult — re-define inline here to decouple events from run-result.
+// Finding: existing in lifecycle/stage-io.ts but we keep a local minimal shape so events doesn't depend on lifecycle.
+// EscalationEntry: existing as EscalationRecord on RunResult — local re-shape here.
+// ValidationWarning: existing inline in TaskCompletedEventSchema — local re-shape here.
+export class SealedEnvelopeError extends Error {
+    constructor(method) { super(`TaskEnvelopeStore: cannot call ${method}() after seal()`); }
+}
+export class TaskEnvelopeStore {
+    env;
+    sealed = false;
+    notify;
+    constructor(env, notify) {
+        this.env = env;
+        this.notify = notify;
+    }
+    static create(seed, busOrNotify = () => { }) {
+        const notify = typeof busOrNotify === 'function'
+            ? busOrNotify
+            : (reason) => busOrNotify.emitEnvelopeSnapshot(store.snapshot(), reason);
+        let store;
+        const env = {
+            taskId: seed.taskId, batchId: seed.batchId, taskIndex: seed.taskIndex,
+            route: seed.route, agentType: seed.agentType,
+            client: seed.client, mainModel: seed.mainModel, cwd: seed.cwd,
+            startedAt: new Date().toISOString(),
+            status: 'running', terminalAt: null, stopReason: null, structuredError: null,
+            stages: [], toolCalls: [], filesRead: [], filesWritten: [], realFilesChanged: [],
+            totalCostUSD: 0, totalInputTokens: 0, totalOutputTokens: 0,
+            totalCachedReadTokens: 0, totalCachedNonReadTokens: 0,
+            totalDurationMs: 0, turnsUsed: 0, stallCount: 0, sandboxViolationCount: 0, taskMaxIdleMs: 0,
+            findings: [], escalationLog: [], validationWarnings: [],
+            headline: { prefix: '', stageLabel: 'queued', stageDone: 0, stageTotal: 0, toolReads: 0, toolWrites: 0, toolTotal: 0 },
+        };
+        store = new TaskEnvelopeStore(env, notify);
+        store.recomputeHeadline();
+        return store;
+    }
+    guard(method) { if (this.sealed)
+        throw new SealedEnvelopeError(method); }
+    startStage(name, init) {
+        this.guard('startStage');
+        this.env.stages.push({
+            name, round: init.round ?? 1, outcome: null,
+            startedAt: init.startedAt ?? new Date().toISOString(), completedAt: null,
+            durationMs: 0, costUSD: null, model: init.model, tier: init.tier,
+            turnsUsed: 0, toolCallCount: 0, filesReadCount: 0, filesWrittenCount: 0,
+            inputTokens: 0, outputTokens: 0, cachedReadTokens: null, cachedNonReadTokens: null,
+        });
+        this.recomputeHeadline();
+        this.notify('startStage');
+    }
+    completeStage(name, round, result) {
+        this.guard('completeStage');
+        const stage = this.env.stages.find(s => s.name === name && s.round === round);
+        if (!stage)
+            throw new Error(`completeStage: no started stage ${name}@${round}`);
+        Object.assign(stage, result, { completedAt: new Date().toISOString() });
+        this.recomputeTotals();
+        this.recomputeHeadline();
+        this.notify('completeStage');
+    }
+    recordToolCall(entry) {
+        this.guard('recordToolCall');
+        const rec = {
+            ts: new Date().toISOString(), stage: entry.stage, tool: entry.tool,
+            filesRead: entry.filesRead ?? [], filesWritten: entry.filesWritten ?? [],
+        };
+        this.env.toolCalls.push(rec);
+        for (const f of rec.filesRead)
+            if (!this.env.filesRead.includes(f))
+                this.env.filesRead.push(f);
+        for (const f of rec.filesWritten)
+            if (!this.env.filesWritten.includes(f))
+                this.env.filesWritten.push(f);
+        const last = this.env.stages[this.env.stages.length - 1];
+        if (last) {
+            last.toolCallCount++;
+            last.filesReadCount = this.env.filesRead.length;
+            last.filesWrittenCount = this.env.filesWritten.length;
+        }
+        this.recomputeHeadline();
+        this.notify('recordToolCall');
+    }
+    recordEscalation(entry) {
+        this.guard('recordEscalation');
+        this.env.escalationLog.push(entry);
+        this.notify('recordEscalation');
+    }
+    recordStall(entry) {
+        this.guard('recordStall');
+        this.env.stallCount++;
+        if (entry.idleMs > this.env.taskMaxIdleMs)
+            this.env.taskMaxIdleMs = entry.idleMs;
+        this.notify('recordStall');
+    }
+    recordSandboxViolation(entry) {
+        this.guard('recordSandboxViolation');
+        this.env.sandboxViolationCount++;
+        this.notify('recordSandboxViolation');
+    }
+    recordFinding(f) { this.guard('recordFinding'); this.env.findings.push(f); this.notify('recordFinding'); }
+    recordValidationWarning(w) { this.guard('recordValidationWarning'); this.env.validationWarnings.push(w); this.notify('recordValidationWarning'); }
+    recordHeartbeat(_state) {
+        // Heartbeats fire on a periodic timer that can race past seal(). Silently
+        // no-op once sealed — other mutations (startStage, completeStage, recordX)
+        // still throw because their callers should know they're operating on a
+        // finalized envelope, but a stray heartbeat tick is harmless.
+        if (this.sealed)
+            return;
+        this.recomputeHeadline();
+        this.notify('recordHeartbeat');
+    }
+    seal(terminal) {
+        this.guard('seal');
+        this.env.status = terminal.status;
+        this.env.terminalAt = terminal.terminalAt ?? new Date().toISOString();
+        this.env.stopReason = terminal.stopReason;
+        this.env.structuredError = terminal.structuredError ?? null;
+        this.env.realFilesChanged = [...terminal.realFilesChanged];
+        this.recomputeTotals();
+        this.recomputeHeadline();
+        this.sealed = true;
+        this.notify('seal');
+    }
+    isSealed() { return this.sealed; }
+    snapshot() { return structuredClone(this.env); }
+    recomputeTotals() {
+        let cost = 0, inT = 0, outT = 0, crT = 0, cnrT = 0, dur = 0, turns = 0;
+        for (const s of this.env.stages) {
+            cost += s.costUSD ?? 0;
+            inT += s.inputTokens;
+            outT += s.outputTokens;
+            crT += s.cachedReadTokens ?? 0;
+            cnrT += s.cachedNonReadTokens ?? 0;
+            dur += s.durationMs;
+            turns += s.turnsUsed;
+        }
+        this.env.totalCostUSD = cost;
+        this.env.totalInputTokens = inT;
+        this.env.totalOutputTokens = outT;
+        this.env.totalCachedReadTokens = crT;
+        this.env.totalCachedNonReadTokens = cnrT;
+        this.env.totalDurationMs = dur;
+        this.env.turnsUsed = turns;
+    }
+    recomputeHeadline() {
+        const stageNames = this.env.stages.map(s => s.name);
+        const lastStage = this.env.stages[this.env.stages.length - 1];
+        const reads = this.env.filesRead.length;
+        const writes = this.env.filesWritten.length;
+        // toolTotal is the count of recorded tool calls (run_shell, edit_file, …),
+        // NOT reads+writes. Codex's run_shell commands pass empty file lists so
+        // computing toolTotal from file counts only would report zero through an
+        // entire investigation where the worker ran many shell commands.
+        this.env.headline = {
+            prefix: '',
+            stageLabel: lastStage ? lastStage.name : 'queued',
+            stageDone: this.env.stages.filter(s => s.outcome !== null).length,
+            stageTotal: stageNames.length,
+            toolReads: reads, toolWrites: writes, toolTotal: this.env.toolCalls.length,
+        };
+    }
+}
+//# sourceMappingURL=task-envelope.js.map

package/dist/events/task-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-envelope.js","sourceRoot":"","sources":["../../src/events/task-envelope.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,iGAAiG;AACjG,sHAAsH;AACtH,oFAAoF;AACpF,wFAAwF;AA+GxF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,MAAc,IAAI,KAAK,CAAC,kCAAkC,MAAM,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAClG;AAID,MAAM,OAAO,iBAAiB;IACpB,GAAG,CAAe;IAClB,MAAM,GAAG,KAAK,CAAC;IACf,MAAM,CAAS;IAEvB,YAAoB,GAAiB,EAAE,MAAc;QACnD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAgB,EAAE,cAAoC,GAAG,EAAE,GAAE,CAAC;QAC1E,MAAM,MAAM,GAAW,OAAO,WAAW,KAAK,UAAU;YACtD,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3E,IAAI,KAAyB,CAAC;QAC9B,MAAM,GAAG,GAAiB;YACxB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS;YACrE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS;YAC5C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG;YAC7D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI;YAC5E,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE;YAChF,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;YAC1D,qBAAqB,EAAE,CAAC,EAAE,wBAAwB,EAAE,CAAC;YACrD,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC;YAC3F,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE;YACvD,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SACvH,CAAC;QACF,KAAK,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,MAAc,IAAI,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzF,UAAU,CAAC,IAAe,EAAE,IAA4E;QACtG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI;YAC3C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,IAAI;YACxE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI;YAChE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;YACvE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI;SACnF,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,IAAe,EAAE,KAAa,EAAE,MAAsF;QAClI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,KAAqF;QAClG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAmB;YAC1B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI;YAClE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;SACzE,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/F,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxG,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzD,IAAI,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC;YAAC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC;QAAC,CAAC;QAC3I,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,gBAAgB,CAAC,KAAsB;QACrC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,KAAuC;QACjD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IAED,sBAAsB,CAAC,KAAqC;QAC1D,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,CAAU,IAAU,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACzH,uBAAuB,CAAC,CAAoB,IAAU,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAC3K,eAAe,CAAC,MAA+B;QAC7C,0EAA0E;QAC1E,2EAA2E;QAC3E,uEAAuE;QACvE,8DAA8D;QAC9D,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,QAAoL;QACvL,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,IAAI,IAAI,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,KAAc,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,QAAQ,KAA6B,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEhE,eAAe;QACrB,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACvB,GAAG,IAAI,CAAC,CAAC,WAAW,CAAC;YAAC,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC;YAC7C,GAAG,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC;YAAC,IAAI,IAAI,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC;YACnE,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC;YAAC,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnE,IAAI,CAAC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,GAAG,IAAI,CAAC;QAC/E,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;IAC7D,CAAC;IAEO,iBAAiB;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC;QAC5C,2EAA2E;QAC3E,wEAAwE;QACxE,yEAAyE;QACzE,iEAAiE;QACjE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG;YAClB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;YACjD,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,MAAM;YACjE,UAAU,EAAE,UAAU,CAAC,MAAM;YAC7B,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM;SAC3E,CAAC;IACJ,CAAC;CACF"}

package/dist/events/telemetry-uploader.d.ts

@@ -0,0 +1,24 @@
+import type { Subscriber, BusMessage } from './envelope-bus.js';
+import type { TaskEnvelope } from './task-envelope.js';
+import { toWireRecord } from './to-wire-record.js';
+export interface RecorderLike {
+    enqueue(event: unknown): void;
+}
+export interface ConsentLike {
+    decide(): {
+        enabled: boolean;
+    };
+}
+export interface TelemetryUploaderOpts {
+    recorder: RecorderLike | null;
+    consent?: ConsentLike;
+    buildOpts: (env: TaskEnvelope) => Parameters<typeof toWireRecord>[1];
+}
+export declare class TelemetryUploader implements Subscriber {
+    private opts;
+    readonly name = "telemetry-uploader";
+    private uploaded;
+    constructor(opts: TelemetryUploaderOpts);
+    receive(msg: BusMessage): void;
+}
+//# sourceMappingURL=telemetry-uploader.d.ts.map

package/dist/events/telemetry-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-uploader.d.ts","sourceRoot":"","sources":["../../src/events/telemetry-uploader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAGtC,OAAO,CAAC,IAAI;IAFxB,QAAQ,CAAC,IAAI,wBAAwB;IACrC,OAAO,CAAC,QAAQ,CAAqB;gBACjB,IAAI,EAAE,qBAAqB;IAE/C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;CAe/B"}

package/dist/events/telemetry-uploader.js

@@ -0,0 +1,31 @@
+import { toWireRecord } from './to-wire-record.js';
+export class TelemetryUploader {
+    opts;
+    name = 'telemetry-uploader';
+    uploaded = new Set();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    receive(msg) {
+        if (msg.type === 'plain')
+            return;
+        const env = msg.envelope;
+        if (env.status === 'running')
+            return;
+        if (this.uploaded.has(env.taskId))
+            return;
+        if (!this.opts.recorder)
+            return;
+        if (this.opts.consent && !this.opts.consent.decide().enabled)
+            return;
+        try {
+            const record = toWireRecord(env, this.opts.buildOpts(env));
+            this.opts.recorder.enqueue(record);
+            this.uploaded.add(env.taskId);
+        }
+        catch (err) {
+            process.stderr.write(`[mmagent] telemetry_upload_error task=${env.taskId} err=${err.message}\n`);
+        }
+    }
+}
+//# sourceMappingURL=telemetry-uploader.js.map

package/dist/events/telemetry-uploader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-uploader.js","sourceRoot":"","sources":["../../src/events/telemetry-uploader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgBnD,MAAM,OAAO,iBAAiB;IAGR;IAFX,IAAI,GAAG,oBAAoB,CAAC;IAC7B,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,YAAoB,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAEnD,OAAO,CAAC,GAAe;QACrB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAChC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO;YAAE,OAAO;QACrE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,GAAG,CAAC,MAAM,QAAS,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;CACF"}

package/dist/events/to-wire-record.d.ts

@@ -0,0 +1,42 @@
+import type { ModelFamily } from '../config/model-profile-registry.js';
+import type { TaskEnvelope } from './task-envelope.js';
+import type { TaskCompletedEventType } from './wire-schema.js';
+export declare const clampStageCost: (n: number) => number;
+export declare const clampTaskCost: (n: number) => number;
+export declare const clampInputTokens: (n: number) => number;
+export declare const clampOutputTokens: (n: number) => number;
+export declare const clampCachedTokens: (n: number) => number;
+export declare const clampToolCallCount: (n: number) => number;
+export declare const clampFilesReadCount: (n: number) => number;
+export declare const clampFilesWrittenCount: (n: number) => number;
+export declare const clampTurnCount: (n: number) => number;
+export declare const clampDurationMsStage: (n: number) => number;
+export declare const clampDurationMsTotal: (n: number) => number;
+/**
+ * Normalize a raw model ID into its canonical name and family.
+ *
+ * Combines prefix stripping (extractCanonicalModelName) with profile
+ * lookup (findModelProfile) into a single call. Callers that need both
+ * the canonical form and the family without reaching into routing
+ * internals should use this entry point.
+ *
+ * Idempotent: the canonical output of normalizeModel, when fed back
+ * in as input, produces the same canonical output.
+ */
+export declare function normalizeModel(rawModelId: string): {
+    canonical: string;
+    family: ModelFamily;
+};
+export declare function mapStatusToWire(status: TaskEnvelope['status'], errCode: string | null): {
+    terminalStatus: string;
+    workerStatus: string;
+};
+export declare function toWireRecord(env: TaskEnvelope, opts: {
+    reviewPolicy: 'full' | 'quality_only' | 'diff_only' | 'none';
+    toolMode: 'none' | 'readonly' | 'no-shell' | 'full';
+    verifyCommandPresent: boolean;
+    implementerModel: string;
+    implementerTier: 'standard' | 'complex';
+    mainModelFamily: string;
+}): TaskCompletedEventType;
+//# sourceMappingURL=to-wire-record.d.ts.map

package/dist/events/to-wire-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-wire-record.d.ts","sourceRoot":"","sources":["../../src/events/to-wire-record.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAI/D,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,MACwB,CAAC;AAEpE,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,KAAG,MACT,CAAC;AAElC,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,KAAG,MACN,CAAC;AAExC,eAAO,MAAM,iBAAiB,GAAI,GAAG,MAAM,KAAG,MACT,CAAC;AAEtC,eAAO,MAAM,iBAAiB,GAAI,GAAG,MAAM,KAAG,MACP,CAAC;AAExC,eAAO,MAAM,kBAAkB,GAAI,GAAG,MAAM,KAAG,MACf,CAAC;AAEjC,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,KAAG,MAChB,CAAC;AAEjC,eAAO,MAAM,sBAAsB,GAAI,GAAG,MAAM,KAAG,MACnB,CAAC;AAEjC,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,MACZ,CAAC;AAEhC,eAAO,MAAM,oBAAoB,GAAI,GAAG,MAAM,KAAG,MACZ,CAAC;AAEtC,eAAO,MAAM,oBAAoB,GAAI,GAAG,MAAM,KAAG,MACX,CAAC;AAGvC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAI7F;AAGD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAuBlD;AAGD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACpD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC;CACzB,GACA,sBAAsB,CAsLxB"}