@zhixuan92/multi-model-agent-core 5.1.0 → 5.2.0

package/dist/lifecycle/handlers/review-fix-stage.js.map

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

package/dist/lifecycle/handlers/terminal-handlers.d.ts

@@ -1,61 +0,0 @@
-import type { LifecycleState } from '../stage-plan-types.js';
-import type { StageGate, TerminalPayload } from '../stage-io.js';
-/**
- * Terminal-stage handlers (#45 Step 6).
- *
- * Four StagePlan rows:
- *   - 5.3.5 register_terminal_block — registers a context block carrying
- *     the terminal RuntimeRunResult so /retry can reference the prior task's
- *     output.
- *   - 5.4   emit_task_terminal     — emits the per-task terminal event
- *     (task_done_summary) through ctx.bus.
- *   - 5.5   persist_to_batch_registry — marks the per-task state in the
- *     batch registry.
- *   - 6.1   flush_telemetry — drains the telemetry queue so failure
- *     events are persisted before the per-task terminal stage exits.
- *
- * Each handler is idempotent on its state-slot guard:
- *   - state.contextBlockId
- *   - state.taskTerminalEmitted
- *   - state.batchRegistryPersisted
- *   - state.telemetryFlushed
- *
- * Defensive no-ops on missing state.executionContext or
- * state.lastRunResult. All four rows are marked runOnTerminal in the
- * StagePlan, so they fire even on hard-fail paths.
- */
-export declare function registerTerminalBlockHandler(state: LifecycleState): void;
-export declare function emitTaskTerminalHandler(state: LifecycleState): void;
-export declare function persistToBatchRegistryHandler(state: LifecycleState): void;
-/**
- * Row 5.6 — record_task_completed → envelope.seal.
- *
- * Seals the per-task envelope to finalize all accumulated state and
- * trigger telemetry upload via TelemetryUploader subscriber. Idempotent on
- * state.taskCompletedRecorded. No-op when the server hasn't supplied an
- * envelope (CLI/test paths).
- */
-export declare function recordTaskCompletedHandler(state: LifecycleState): Promise<void>;
-export declare function flushTelemetryHandler(state: LifecycleState): Promise<void>;
-/**
- * v5 unified `terminalHandler` — single entry point that runs the five
- * terminal side effects in idempotency-safe order and returns the
- * `StageGate<TerminalPayload>` the v5 driver expects.
- *
- * The five sub-handlers above are this function's building blocks: one per
- * side effect, kept individually exported so each can be unit-tested in
- * isolation (tests/lifecycle/handlers/terminal-handlers.test.ts) and so
- * observability AC tests can exercise per-side-effect failures
- * (tests/acceptance/stage-io-observability.test.ts). The unified
- * `terminalHandler` is what STAGE_PLAN's `terminal` stage actually invokes;
- * it sequences the five sub-handlers in idempotency-safe order and folds
- * their state-slot guards into the TerminalPayload shape. Per spec §4.7 the side-effect map carries one
- * boolean per side effect — true = succeeded at least once for this state
- * instance; false = attempted-and-failed or never-attempted-because-context-
- * missing.
- *
- * Idempotency: re-invocation MUST be safe and return the same payload (each
- * sub-handler short-circuits on its state-slot guard, e.g. `state.contextBlockId`).
- */
-export declare function terminalHandler(state: LifecycleState): Promise<StageGate<TerminalPayload>>;
-//# sourceMappingURL=terminal-handlers.d.ts.map

package/dist/lifecycle/handlers/terminal-handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/terminal-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAyBxE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAUnE;AAMD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAkBzE;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwFrF;AAoED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAwDhG"}

package/dist/lifecycle/handlers/terminal-handlers.js

@@ -1,339 +0,0 @@
-import { findModelProfile } from '../../config/model-profile-registry.js';
-import { getRealFilesChanged } from '../../bounded-execution/real-diff.js';
-import { deriveCompletion, extractCompletionInputs } from '../derive-completion.js';
-import { TerminalBlockRegistrar } from '../../reporting/terminal-block-registrar.js';
-import { renderTerminalReportMarkdown } from '../../reporting/terminal-report-markdown.js';
-import { WRITE_ROUTES } from '../stage-io.js';
-import { findEscapedWrites } from '../file-confinement-check.js';
-/**
- * Terminal-stage handlers (#45 Step 6).
- *
- * Four StagePlan rows:
- *   - 5.3.5 register_terminal_block — registers a context block carrying
- *     the terminal RuntimeRunResult so /retry can reference the prior task's
- *     output.
- *   - 5.4   emit_task_terminal     — emits the per-task terminal event
- *     (task_done_summary) through ctx.bus.
- *   - 5.5   persist_to_batch_registry — marks the per-task state in the
- *     batch registry.
- *   - 6.1   flush_telemetry — drains the telemetry queue so failure
- *     events are persisted before the per-task terminal stage exits.
- *
- * Each handler is idempotent on its state-slot guard:
- *   - state.contextBlockId
- *   - state.taskTerminalEmitted
- *   - state.batchRegistryPersisted
- *   - state.telemetryFlushed
- *
- * Defensive no-ops on missing state.executionContext or
- * state.lastRunResult. All four rows are marked runOnTerminal in the
- * StagePlan, so they fire even on hard-fail paths.
- */
-export function registerTerminalBlockHandler(state) {
-    if (state.contextBlockId)
-        return;
-    const ctx = state.executionContext;
-    const envelope = ctx?.envelope;
-    const store = ctx?.contextBlockStore;
-    const registry = ctx?.batchRegistry;
-    if (!envelope || !store || !registry)
-        return;
-    const snap = envelope.snapshot();
-    // Write routes (delegate / execute-plan / retry) produce code + a commit;
-    // their durable record is the diff, not a prose block. No registration.
-    if (WRITE_ROUTES.includes(snap.route))
-        return;
-    try {
-        const markdown = renderTerminalReportMarkdown(snap);
-        const registrar = new TerminalBlockRegistrar(store, registry);
-        const id = registrar.register({
-            batchId: snap.batchId, taskIndex: snap.taskIndex, route: snap.route, markdown,
-        });
-        if (id)
-            state.contextBlockId = id;
-    }
-    catch {
-        // Best-effort: registration is advisory and must not block seal/flush/persist.
-        envelope.recordValidationWarning({
-            rule: 'TerminalBlockRegisterFailed',
-            path: `${snap.route}:${snap.batchId}:${snap.taskIndex}`,
-        });
-    }
-}
-export function emitTaskTerminalHandler(state) {
-    if (state.taskTerminalEmitted)
-        return;
-    const ctx = state.executionContext;
-    if (!ctx)
-        return;
-    // The old `task_completed` named event was replaced by the sealed-envelope
-    // snapshot push inside envelope.seal() (see recordTaskCompletedHandler); the
-    // TelemetryUploader subscriber picks up that snapshot and runs toWireRecord.
-    // No bus.emit happens here — the envelope IS the event. This handler now only
-    // marks the idempotency flag so re-runs are no-ops.
-    state.taskTerminalEmitted = true;
-}
-export function persistToBatchRegistryHandler(state) {
-    if (state.batchRegistryPersisted)
-        return;
-    const ctx = state.executionContext;
-    if (!ctx)
-        return;
-    const registry = ctx.batchRegistry;
-    if (!registry || typeof registry.complete !== 'function') {
-        state.batchRegistryPersisted = true; // structural ack
-        return;
-    }
-    try {
-        registry.complete(ctx.taskIndex, state.lastRunResult);
-    }
-    catch {
-        // Persistence failure is non-fatal at the per-task boundary; retention
-        // sweep (row 6.3) reconciles via timer.
-    }
-    state.batchRegistryPersisted = true;
-}
-/**
- * Row 5.6 — record_task_completed → envelope.seal.
- *
- * Seals the per-task envelope to finalize all accumulated state and
- * trigger telemetry upload via TelemetryUploader subscriber. Idempotent on
- * state.taskCompletedRecorded. No-op when the server hasn't supplied an
- * envelope (CLI/test paths).
- */
-export async function recordTaskCompletedHandler(state) {
-    if (state.taskCompletedRecorded)
-        return;
-    const ctx = state.executionContext;
-    if (!ctx)
-        return;
-    const envelope = ctx.envelope;
-    if (!envelope) {
-        state.taskCompletedRecorded = true;
-        return;
-    }
-    const real = await getRealFilesChanged(state);
-    const last = state.lastRunResult;
-    if (real.source === 'git_error') {
-        envelope.recordValidationWarning({ rule: 'GitDiffUnavailable', path: 'realFilesChanged' });
-    }
-    const completionInputs = extractCompletionInputs(state);
-    // Use deriveCompletion when implement gate is populated. commitKind being
-    // undefined is legitimate (read routes have no commit stage) — deriveCompletion
-    // handles those branches internally. Only fall back to workerStatus when the
-    // implement gate itself is missing (lifecycle never started, brief_too_vague paths).
-    const hasGateInputs = completionInputs.implementOutcome !== undefined;
-    let sealStatus;
-    if (hasGateInputs) {
-        const { completed } = deriveCompletion(completionInputs);
-        const hasConcerns = (state.executionContext?.envelope?.snapshot()?.findings ?? []).length > 0;
-        sealStatus = completed ? (hasConcerns ? 'done_with_concerns' : 'done') : 'failed';
-    }
-    else {
-        // Fallback only when implement gate is missing entirely (brief_too_vague etc.)
-        const ws = (state.workerStatus ?? last?.workerStatus);
-        sealStatus = ws === 'done' ? 'done' : ws === 'done_with_concerns' ? 'done_with_concerns' : 'failed';
-    }
-    // Commit outcome (authoritative, from the commit gate) — computed BEFORE the
-    // confinement guard so it can corroborate the worker's self-reported writes.
-    // Carried onto the envelope below so the response's structuredReport surfaces
-    // the real SHA/message (the response is built from envelope snapshots).
-    const commitGate = state.gates?.['commit'];
-    const commitPayload = (commitGate?.outcome === 'advance' ? commitGate.payload : null);
-    let didCommit = commitPayload?.kind === 'committed';
-    // Goal mode (no commit gate): the agent self-commits, so the commit SHA /
-    // message come from the goal report (git HEAD of baseSha..HEAD), surfaced via
-    // state.structuredReport by the annotate goal-branch.
-    const goalReport = state.structuredReport;
-    const isGoal = Boolean(state.task?.goal);
-    let goalCommitSha = null;
-    let goalCommitMessage = null;
-    if (isGoal && goalReport?.commitSha) {
-        didCommit = true;
-        goalCommitSha = goalReport.commitSha;
-        goalCommitMessage = goalReport.commitMessage ?? null;
-    }
-    // Confinement guard: a worker must only write under its dispatched cwd. A
-    // reported write that escaped (e.g. into a sibling git worktree / the daemon's
-    // startup cwd) is a real mislocation. BUT the worker-reported filesWritten
-    // string is unreliable — LLM workers routinely report normalized/relative/
-    // hallucinated absolute paths (e.g. "/repo/src/x.ts" or "/workspace/src/x.ts")
-    // for a file actually written under the dispatched cwd. So hard-fail ONLY when
-    // the worker claims an escaped write AND no commit landed in cwd (didCommit =
-    // false → the write is not in this repo → it genuinely wrote elsewhere). When a
-    // commit DID land in cwd, the self-reported path is a hallucination — record an
-    // advisory warning rather than failing a legitimate, committed task on an
-    // unreliable self-report string. (The git commit is the authoritative signal.)
-    let escapeErrorCode = null;
-    const escaped = findEscapedWrites(last?.filesWritten ?? [], ctx.cwd);
-    if (escaped.length > 0) {
-        envelope.recordValidationWarning({ rule: 'WorkerWriteEscapedCwd', path: escaped.join(', ') });
-        if (!didCommit) {
-            sealStatus = 'failed';
-            escapeErrorCode = 'tool_sandbox_cwd_violation';
-        }
-    }
-    envelope.seal({
-        status: sealStatus,
-        terminalAt: new Date().toISOString(),
-        stopReason: last?.terminationReason?.cause ?? null,
-        structuredError: last?.structuredError ?? null,
-        errorCode: escapeErrorCode ?? last?.errorCode ?? null,
-        realFilesChanged: real.files,
-        commitSha: didCommit ? (goalCommitSha ?? commitPayload?.commitSha ?? null) : null,
-        commitMessage: didCommit ? (goalCommitMessage ?? commitPayload?.commitMessage ?? null) : null,
-        commitSkipReason: commitPayload?.kind === 'no_op' ? (commitPayload?.reason ?? null) : null,
-        contextBlockId: state.contextBlockId ?? null,
-    });
-    state.taskCompletedRecorded = true;
-}
-/**
- * Synthesize an `implementing` stage entry from top-level RuntimeRunResult fields
- * when the per-stage tracker hasn't populated it. Without this, the wire
- * event ships with `stages: []` for every task, which violates the backend's
- * R2.1 invariant ("empty stages only allowed for brief_too_vague|error")
- * for any task that succeeded — every upload would 400.
- *
- * This is a fallback; it does not replace stats already populated by the
- * runner-shell or lifecycle stage tracker.
- */
-function ensureImplementingStage(rr, ctx) {
-    // Even when no LLM call ever fires (runner_crash, all_tiers_unavailable,
-    // dispatcher-no-result), the configured implementer model is known up
-    // front via ctx.implementerProvider.config. Stamp it into the synthesized
-    // stage and the top-level rr.models so the wire row reports the *intended*
-    // model instead of the literal 'custom' fallback in event-builder.
-    const fallbackModel = ctx.implementerProvider?.config?.model ?? null;
-    const fallbackFamily = fallbackModel ? findModelProfile(fallbackModel).family : null;
-    if (rr.models === undefined && fallbackModel !== null) {
-        rr.models = {
-            implementer: fallbackModel,
-            specReviewer: undefined,
-            qualityReviewer: undefined,
-        };
-    }
-    const existing = (rr.stageStats?.implementing);
-    if (existing?.entered)
-        return;
-    const usage = rr.usage ?? { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 };
-    const synthesized = {
-        stage: 'implementing',
-        entered: true,
-        durationMs: rr.durationMs ?? 0,
-        costUSD: rr.cost?.costUSD ?? null,
-        agentTier: ctx.assignedTier ?? 'standard',
-        modelFamily: fallbackFamily,
-        model: fallbackModel,
-        maxIdleMs: 0,
-        totalIdleMs: 0,
-        activityEvents: 0,
-        inputTokens: usage.inputTokens ?? 0,
-        outputTokens: usage.outputTokens ?? 0,
-        cachedReadTokens: usage.cachedReadTokens ?? 0,
-        cachedNonReadTokens: usage.cachedNonReadTokens ?? 0,
-        turnCount: rr.turns ?? 0,
-        filesWrittenCount: Array.isArray(rr.filesWritten) ? rr.filesWritten.length : 0,
-        directoriesListed: 0,
-    };
-    rr.stageStats = {
-        ...(rr.stageStats ?? {}),
-        implementing: synthesized,
-    };
-}
-export async function flushTelemetryHandler(state) {
-    if (state.telemetryFlushed)
-        return;
-    const ctx = state.executionContext;
-    if (!ctx)
-        return;
-    const recorder = ctx.recorder;
-    if (!recorder || typeof recorder.flush !== 'function') {
-        state.telemetryFlushed = true;
-        return;
-    }
-    try {
-        await recorder.flush();
-    }
-    catch {
-        // Telemetry flush is best-effort; the recorder retains in-memory queue
-        // for the next opportunity.
-    }
-    state.telemetryFlushed = true;
-}
-/**
- * v5 unified `terminalHandler` — single entry point that runs the five
- * terminal side effects in idempotency-safe order and returns the
- * `StageGate<TerminalPayload>` the v5 driver expects.
- *
- * The five sub-handlers above are this function's building blocks: one per
- * side effect, kept individually exported so each can be unit-tested in
- * isolation (tests/lifecycle/handlers/terminal-handlers.test.ts) and so
- * observability AC tests can exercise per-side-effect failures
- * (tests/acceptance/stage-io-observability.test.ts). The unified
- * `terminalHandler` is what STAGE_PLAN's `terminal` stage actually invokes;
- * it sequences the five sub-handlers in idempotency-safe order and folds
- * their state-slot guards into the TerminalPayload shape. Per spec §4.7 the side-effect map carries one
- * boolean per side effect — true = succeeded at least once for this state
- * instance; false = attempted-and-failed or never-attempted-because-context-
- * missing.
- *
- * Idempotency: re-invocation MUST be safe and return the same payload (each
- * sub-handler short-circuits on its state-slot guard, e.g. `state.contextBlockId`).
- */
-export async function terminalHandler(state) {
-    const t0 = Date.now();
-    const flags = {
-        contextBlockId: null,
-        telemetryFlushed: false,
-        batchRegistryPersisted: false,
-        taskTerminalEmitted: false,
-        projectCleanupTicked: false,
-    };
-    try {
-        registerTerminalBlockHandler(state);
-        flags.contextBlockId = state.contextBlockId ?? null;
-    }
-    catch {
-        /* leave null on failure */
-    }
-    try {
-        await flushTelemetryHandler(state);
-        flags.telemetryFlushed = state.telemetryFlushed === true;
-    }
-    catch {
-        /* leave false */
-    }
-    try {
-        persistToBatchRegistryHandler(state);
-        flags.batchRegistryPersisted = state.batchRegistryPersisted === true;
-    }
-    catch {
-        /* leave false */
-    }
-    try {
-        emitTaskTerminalHandler(state);
-        flags.taskTerminalEmitted = state.taskTerminalEmitted === true;
-    }
-    catch {
-        /* leave false */
-    }
-    try {
-        await recordTaskCompletedHandler(state);
-        flags.projectCleanupTicked = true; // record-completed doubles as project activity tick
-    }
-    catch {
-        /* leave false */
-    }
-    return {
-        outcome: 'advance',
-        payload: flags,
-        telemetry: {
-            stageLabel: 'terminal',
-            durationMs: Date.now() - t0,
-            costUSD: 0,
-            turnsUsed: 0,
-            stopReason: 'normal',
-        },
-    };
-}
-//# sourceMappingURL=terminal-handlers.js.map

package/dist/lifecycle/handlers/terminal-handlers.js.map

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

package/dist/lifecycle/lifecycle-context.d.ts

@@ -1,109 +0,0 @@
-import type { Provider, TaskSpec, MultiModelConfig, AgentType } from '../types.js';
-import type { Session } from '../types/run-result.js';
-import type { EnvelopeBus } from '../events/envelope-bus.js';
-import type { ActivityTracker, HeartbeatTickInfo } from '../bounded-execution/activity-tracker.js';
-import type { WallClockGuard } from '../bounded-execution/wall-clock-guard.js';
-import type { ProjectContext } from '../stores/project-context-registry.js';
-import type { ContextBlockStore } from '../stores/context-block-tool.js';
-import type { TaskEnvelopeStore } from '../events/task-envelope.js';
-/**
- * Spec C10 ExecutionContext — the typed shared state for a per-task run.
- * Populated by `prepare_execution_context` (row 2.5) and read by every
- * downstream handler.
- *
- * Inputs (Group A) are read-only after row 2.5 completes.
- * Bus + heartbeat (Group B) carry mutable runtime state for the watchdog.
- * Cost (Group C) is tracked via stateless priceTokens() in bounded-execution and aggregated inline in events/to-wire-record.ts; not held on ExecutionContext.
- *
- * Per-chain accumulators (Group D) live on `LifecycleState` itself, not
- * here, because each chain handler mutates them as it fires; ExecutionContext
- * is for stable per-task wiring.
- */
-export interface ExecutionContext {
-    task: TaskSpec;
-    taskIndex: number;
-    config: MultiModelConfig;
-    cwd: string;
-    route: string;
-    client: string;
-    mainModel: string | null;
-    /** Tier the dispatcher assigned to this task. Stays fixed; rotation lives in per-round handlers via pickReviewer/pickEscalation. */
-    assignedTier: AgentType;
-    implementerProvider: Provider;
-    /** Map of available tier → provider, keyed by AgentType. */
-    providers: Partial<Record<AgentType, Provider>>;
-    /**
-     * v4.4 session source-of-truth. Each call returns the (lazy-created)
-     * Session for the given tier — the SAME instance across stages within
-     * one task, so codex CLI's `codex exec resume` and claude-agent-sdk's
-     * `resume: sessionId` both reload the prior conversation. Throws if
-     * the tier has no configured provider.
-     *
-     * Cleanup: `closeSessions()` is invoked by task-runner.ts's finally
-     * block; handlers MUST NOT call session.close() themselves.
-     */
-    getSession(tier: AgentType): Session;
-    closeSessions(): Promise<void>;
-    /** Returns OS pids of every currently-open session's CLI subprocess (if any).
-     *  Used by shutdown drain to SIGKILL stragglers when closeSessions() exceeds
-     *  its grace window. Empty array when no sessions are open OR the providers
-     *  do not spawn subprocesses (e.g. in-process SDK clients). */
-    getActivePids(): number[];
-    timing: {
-        startMs: number;
-        timeoutMs: number;
-        deadlineMs: number;
-        stallTimeoutMs: number;
-    };
-    /** Wall-clock budget guard. Throws GuardError once budgetMs since task start
-     *  is exceeded. Stage entries + tool-call boundaries call checkOrThrow(). */
-    wallClockGuard: WallClockGuard;
-    stall: {
-        controller: AbortController;
-        /** ms timestamp of the most recent runner event; updated by markRunnerEvent. */
-        lastEventAtMs: number;
-        /** Set true when stall fires; prevents duplicate aborts. */
-        fired: boolean;
-    };
-    implementerToolMode: TaskSpec['tools'];
-    bus: EnvelopeBus | undefined;
-    heartbeat: ActivityTracker | undefined;
-    /** Logger sink — Step 6 (terminal handlers) will use this for final flush.
-     *  Minimal structural shape; the full HttpServerLog interface was removed in the
-     *  events unification refactor. Only `error(kind, err)` is consumed by callers. */
-    logger?: {
-        error: (kind: string, err: unknown) => void;
-    };
-    /** Per-task event envelope for recording lifecycle mutations. */
-    envelope: TaskEnvelopeStore;
-    /**
-     * Heartbeat tick recorder — server-supplied callback that turns
-     * HeartbeatTickInfo into BatchRegistry.updateRunningHeadlineSnapshot.
-     * Optional (CLI/local clients don't have a BatchRegistry).
-     */
-    recordHeartbeat?: (tick: HeartbeatTickInfo) => void;
-    /** Telemetry recorder — server-only, used at terminal to record task.completed. */
-    recorder?: {
-        recordTaskCompleted: (params: {
-            route: string;
-            taskSpec: TaskSpec;
-            runResult: import('../types.js').RuntimeRunResult;
-            realFilesChanged: string[];
-            client: string;
-            mainModel: string | null;
-            reviewPolicy?: 'full' | 'quality_only' | 'diff_only' | 'none';
-        }) => void;
-    };
-    outputTargets: string[];
-    /** Per-project runtime state — used by executor-layer consumers (delegate, etc.). */
-    projectContext?: ProjectContext;
-    /** Context block store — used by executor-layer consumers for intake expansion. */
-    contextBlockStore?: ContextBlockStore;
-    /** BatchId owning this execution — threaded so ActivityTracker can tag ticks. */
-    batchId?: string;
-    /** Optional BatchRegistry — when set, task-runner attaches this ctx onto
-     *  the entry so shutdown drain can close sessions across all in-flight
-     *  tasks. Server callers pass this through HandlerDeps; CLI callers omit. */
-    batchRegistry?: import('../stores/batch-registry.js').BatchRegistry;
-}
-//# sourceMappingURL=lifecycle-context.d.ts.map

package/dist/lifecycle/lifecycle-context.d.ts.map

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

package/dist/lifecycle/lifecycle-context.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=lifecycle-context.js.map

package/dist/lifecycle/lifecycle-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lifecycle-context.js","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-context.ts"],"names":[],"mappings":""}

package/dist/lifecycle/lifecycle-dispatcher.d.ts

@@ -1,35 +0,0 @@
-import type { LifecycleState } from './stage-plan-types.js';
-import type { ToolCategory } from './tool-category.js';
-import type { ComposePayload } from './stage-io.js';
-export interface DispatchInput {
-    route: string;
-    toolCategory: ToolCategory;
-    rawRequest: unknown;
-    /**
-     * Tool-specific extras the handlers may need. Plumbed via state spread so
-     * route-specific data (task, executionContext, projectContext) reaches
-     * stage handlers.
-     */
-    context?: Record<string, unknown>;
-}
-export interface DispatchOutput {
-    status: number;
-    /** ComposePayload on 200; a route error object on 4xx (e.g. missing_context_block). */
-    body: ComposePayload | {
-        error: string;
-        missing?: string[];
-        message?: string;
-    };
-    /**
-     * Final lifecycle state — exposed so task-runner.ts and other batch-level
-     * orchestrators can read `state.lastRunResult` (the RuntimeRunResult
-     * mirror) for downstream consumers (recorder, headline composer) that
-     * still expect the legacy fat shape.
-     */
-    finalState?: LifecycleState;
-}
-export declare class LifecycleDispatcher {
-    dispatch(input: DispatchInput): Promise<DispatchOutput>;
-    private initialState;
-}
-//# sourceMappingURL=lifecycle-dispatcher.d.ts.map

package/dist/lifecycle/lifecycle-dispatcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lifecycle-dispatcher.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-dispatcher.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,qBAAa,mBAAmB;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAqC7D,OAAO,CAAC,YAAY;CAYrB"}

package/dist/lifecycle/lifecycle-dispatcher.js

@@ -1,64 +0,0 @@
-// v5 lifecycle dispatcher.
-//
-// Single dispatch path: walk STAGE_PLAN via runStagePlan, return the v5
-// ComposePayload from gates['compose']. No more LifecycleDriver class, no
-// more StagePlan rows, no more handlerKey map, no more executor closure.
-import { runStagePlan } from './lifecycle-driver.js';
-import { STAGE_PLAN } from './stage-plan-builder.js';
-import { ContextBlockNotFoundError } from '../stores/context-block-tool.js';
-export class LifecycleDispatcher {
-    async dispatch(input) {
-        try {
-            const finalState = await runStagePlan(STAGE_PLAN, this.initialState(input));
-            const composeGate = finalState.gates?.['compose'];
-            let body;
-            if (input.route === 'register-context-block') {
-                // Register-context-block wire shape is the minimal { id } envelope,
-                // NOT the full ComposePayload. Lift it from the compose payload's
-                // blockId field (set by composeHandler from gates['register-block']).
-                const rawBody = (composeGate?.outcome === 'advance' && composeGate.payload)
-                    ? composeGate.payload
-                    : finalState.responseEnvelope;
-                const envelope = finalState.responseEnvelope;
-                if (envelope && typeof envelope === 'object' && 'id' in envelope) {
-                    body = envelope;
-                }
-                else if (envelope && typeof envelope === 'object' && 'error' in envelope) {
-                    body = envelope;
-                }
-                else if (rawBody?.blockId) {
-                    body = { error: '', message: '' }; // placeholder, overridden below
-                    body = { id: rawBody.blockId };
-                }
-                else {
-                    body = rawBody;
-                }
-            }
-            else {
-                body = (composeGate?.outcome === 'advance' && composeGate.payload)
-                    ? composeGate.payload
-                    : finalState.responseEnvelope;
-            }
-            return { status: 200, body, finalState };
-        }
-        catch (e) {
-            if (e instanceof ContextBlockNotFoundError) {
-                return { status: 400, body: { error: 'missing_context_block', missing: [e.id] } };
-            }
-            throw e;
-        }
-    }
-    initialState(input) {
-        return {
-            terminal: false,
-            reviewPolicy: input.rawRequest?.reviewPolicy ?? 'full',
-            shutdownInProgress: false,
-            route: input.route,
-            toolCategory: input.toolCategory,
-            request: input.rawRequest,
-            ...(input.context ?? {}),
-            projectContext: input.context?.projectContext,
-        };
-    }
-}
-//# sourceMappingURL=lifecycle-dispatcher.js.map