ace-swarm 2.1.2 → 2.3.0

package/dist/orchestrator-supervisor.d.ts

@@ -0,0 +1,100 @@
+import type { BridgeResult } from "./model-bridge.js";
+export type TaskStepStatus = "planned" | "running" | "done" | "failed" | "skipped" | "blocked";
+export type TaskPlanStatus = "planning" | "executing" | "reviewing" | "blocked" | "done" | "failed";
+export interface TaskStep {
+    step_id: string;
+    role: string;
+    task: string;
+    depends_on?: string[];
+    parallel_group?: string;
+    status: TaskStepStatus;
+    result_summary?: string;
+    evidence_refs?: string[];
+    tool_scope?: string[];
+    job_id?: string;
+    handoff_id?: string;
+    blocked_reason?: string;
+}
+export interface TaskPlan {
+    plan_id: string;
+    task: string;
+    steps: TaskStep[];
+    status: TaskPlanStatus;
+    execution_mode: "sequential" | "scheduled";
+    vcx_cursor?: string;
+}
+export interface TaskPlanAmendment {
+    steps_to_add?: Array<Omit<TaskStep, "step_id" | "status">>;
+    add_after_step_id?: string;
+    append_steps?: Array<Omit<TaskStep, "step_id" | "status">>;
+    prepend_steps?: Array<Omit<TaskStep, "step_id" | "status">>;
+    remove_step_ids?: string[];
+    update_steps?: Array<{
+        step_id: string;
+        patch: Partial<Omit<TaskStep, "step_id">>;
+    }>;
+    reorder_step_ids?: string[];
+    execution_mode?: TaskPlan["execution_mode"];
+    vcx_cursor?: string;
+}
+export interface SupervisorHooks {
+    spawnStep: (step: TaskStep, plan: TaskPlan) => Promise<BridgeResult>;
+    createHandoff?: (input: {
+        step: TaskStep;
+        plan: TaskPlan;
+    }) => Promise<{
+        handoff_id: string;
+    }>;
+    ackHandoff?: (handoffId: string, status: "accepted" | "blocked" | "completed", note?: string) => Promise<void>;
+    getVericifyContext?: (plan: TaskPlan) => Promise<unknown>;
+    getVericifyDelta?: (since: string, context: {
+        plan: TaskPlan;
+        step: TaskStep;
+        result: BridgeResult;
+    }) => Promise<unknown>;
+    amendPlan?: (input: {
+        plan: TaskPlan;
+        step: TaskStep;
+        result: BridgeResult;
+        vericify_delta?: unknown;
+    }) => Promise<TaskPlan | TaskPlanAmendment | undefined> | TaskPlan | TaskPlanAmendment | undefined;
+    openCircuitBreaker?: (reason: string, context: {
+        plan: TaskPlan;
+        step: TaskStep;
+        result: BridgeResult;
+    }) => Promise<void>;
+    closeCircuitBreaker?: (reason: string, context: {
+        plan: TaskPlan;
+    }) => Promise<void>;
+    executeGates?: (plan: TaskPlan) => Promise<unknown>;
+    contextSnapshot?: (plan: TaskPlan) => Promise<void>;
+    emitStatusEvent?: (input: {
+        status: string;
+        summary: string;
+        step_id?: string;
+    }) => Promise<void>;
+}
+export interface SupervisorRunResult {
+    plan: TaskPlan;
+    handoff_ids: string[];
+    job_ids: string[];
+    circuit_opened: boolean;
+    final_gate?: unknown;
+}
+export declare function deriveTaskPlanStatus(plan: TaskPlan): TaskPlanStatus;
+export declare function createTaskPlan(input: {
+    task: string;
+    steps: Array<Omit<TaskStep, "step_id" | "status">>;
+    execution_mode?: TaskPlan["execution_mode"];
+    vcx_cursor?: string;
+}): TaskPlan;
+export declare function getReadyTaskSteps(plan: TaskPlan): TaskStep[];
+export declare function markTaskStepStatus(plan: TaskPlan, stepId: string, status: TaskStepStatus, patch?: Partial<Omit<TaskStep, "step_id" | "status">>): TaskPlan;
+export declare function applyBridgeResultToStep(plan: TaskPlan, stepId: string, result: BridgeResult): TaskPlan;
+export declare function amendTaskPlan(plan: TaskPlan, amendment: TaskPlanAmendment): TaskPlan;
+export declare function promoteParallelGroupToScheduler(plan: TaskPlan, parallelGroup: string, owner?: string): Promise<{
+    plan: TaskPlan;
+    job_ids: string[];
+}>;
+export declare function superviseTaskPlan(inputPlan: TaskPlan, hooks: SupervisorHooks): Promise<SupervisorRunResult>;
+//# sourceMappingURL=orchestrator-supervisor.d.ts.map

package/dist/orchestrator-supervisor.d.ts.map

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

package/dist/orchestrator-supervisor.js

@@ -0,0 +1,399 @@
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+import { dispatchJobs, enqueueJob, getJobQueuePath } from "./job-scheduler.js";
+import { appendVericifyProcessPostSafe, deriveWorkspaceVericifyRunRef, } from "./vericify-bridge.js";
+function parseNumericStepId(stepId) {
+    const numeric = Number(stepId.replace(/^step-/, ""));
+    return Number.isFinite(numeric) && numeric > 0 ? numeric : 0;
+}
+function cloneSteps(steps) {
+    return steps.map((step) => ({ ...step }));
+}
+function nextStepId(steps) {
+    const max = steps.reduce((best, step) => Math.max(best, parseNumericStepId(step.step_id)), 0);
+    return `step-${max + 1}`;
+}
+function appendNewSteps(steps, additions) {
+    const next = [...steps];
+    for (const addition of additions) {
+        next.push({
+            ...addition,
+            step_id: nextStepId(next),
+            status: "planned",
+        });
+    }
+    return next;
+}
+function deriveStepEvidence(result) {
+    return Array.from(new Set(result.tool_calls.map((tool) => tool.tool)));
+}
+function isTaskPlan(value) {
+    return Boolean(value) && typeof value === "object" && Array.isArray(value.steps);
+}
+function extractVcxCursor(payload) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    const candidate = payload;
+    const direct = candidate.vcx_cursor ?? candidate.cursor ?? candidate.next_cursor;
+    if (typeof direct === "string" && direct.trim()) {
+        return direct.trim();
+    }
+    const liveSignal = candidate.live_signal;
+    if (liveSignal && typeof liveSignal === "object") {
+        const nested = liveSignal.vcx_cursor;
+        if (typeof nested === "string" && nested.trim()) {
+            return nested.trim();
+        }
+    }
+    return undefined;
+}
+export function deriveTaskPlanStatus(plan) {
+    if (plan.steps.some((step) => step.status === "failed")) {
+        return "failed";
+    }
+    if (plan.steps.some((step) => step.status === "blocked")) {
+        return "blocked";
+    }
+    if (plan.steps.length > 0 && plan.steps.every((step) => step.status === "done" || step.status === "skipped")) {
+        return "done";
+    }
+    if (plan.steps.some((step) => step.status === "running")) {
+        return "executing";
+    }
+    if (plan.steps.every((step) => step.status === "planned")) {
+        return "planning";
+    }
+    if (plan.steps.some((step) => step.status === "done")) {
+        return "reviewing";
+    }
+    return plan.status;
+}
+function withDerivedStatus(plan) {
+    return {
+        ...plan,
+        steps: cloneSteps(plan.steps),
+        status: deriveTaskPlanStatus(plan),
+    };
+}
+export function createTaskPlan(input) {
+    return withDerivedStatus({
+        plan_id: `plan-${randomUUID()}`,
+        task: input.task,
+        steps: input.steps.map((step, index) => ({
+            ...step,
+            step_id: `step-${index + 1}`,
+            status: "planned",
+        })),
+        status: "planning",
+        execution_mode: input.execution_mode ?? "sequential",
+        vcx_cursor: input.vcx_cursor,
+    });
+}
+export function getReadyTaskSteps(plan) {
+    const completed = new Set(plan.steps
+        .filter((step) => step.status === "done" || step.status === "skipped")
+        .map((step) => step.step_id));
+    return plan.steps.filter((step) => {
+        if (step.status !== "planned")
+            return false;
+        const dependencies = step.depends_on ?? [];
+        return dependencies.every((dependency) => completed.has(dependency));
+    });
+}
+export function markTaskStepStatus(plan, stepId, status, patch = {}) {
+    return withDerivedStatus({
+        ...plan,
+        steps: plan.steps.map((step) => step.step_id === stepId
+            ? {
+                ...step,
+                ...patch,
+                status,
+            }
+            : step),
+    });
+}
+export function applyBridgeResultToStep(plan, stepId, result) {
+    const nextStatus = result.status === "completed"
+        ? "done"
+        : result.status === "needs_input" || result.status === "max_turns"
+            ? "blocked"
+            : "failed";
+    return withDerivedStatus({
+        ...plan,
+        steps: plan.steps.map((step) => step.step_id === stepId
+            ? {
+                ...step,
+                status: nextStatus,
+                result_summary: result.summary,
+                evidence_refs: deriveStepEvidence(result),
+                blocked_reason: nextStatus === "blocked" ? result.summary : undefined,
+            }
+            : step),
+    });
+}
+export function amendTaskPlan(plan, amendment) {
+    let steps = cloneSteps(plan.steps);
+    if (Array.isArray(amendment.remove_step_ids) && amendment.remove_step_ids.length > 0) {
+        const removeSet = new Set(amendment.remove_step_ids);
+        steps = steps.filter((step) => !removeSet.has(step.step_id));
+    }
+    if (Array.isArray(amendment.update_steps)) {
+        for (const update of amendment.update_steps) {
+            steps = steps.map((step) => step.step_id === update.step_id
+                ? {
+                    ...step,
+                    ...update.patch,
+                }
+                : step);
+        }
+    }
+    if (Array.isArray(amendment.prepend_steps) && amendment.prepend_steps.length > 0) {
+        const prepended = [];
+        for (const addition of amendment.prepend_steps) {
+            prepended.push({
+                ...addition,
+                step_id: nextStepId([...prepended, ...steps]),
+                status: "planned",
+            });
+        }
+        steps = [...prepended, ...steps];
+    }
+    if (Array.isArray(amendment.steps_to_add) && amendment.steps_to_add.length > 0) {
+        if (amendment.add_after_step_id) {
+            const insertionIndex = steps.findIndex((step) => step.step_id === amendment.add_after_step_id);
+            const injected = [];
+            for (const addition of amendment.steps_to_add) {
+                injected.push({
+                    ...addition,
+                    step_id: nextStepId([...steps, ...injected]),
+                    status: "planned",
+                });
+            }
+            if (insertionIndex >= 0) {
+                steps = [
+                    ...steps.slice(0, insertionIndex + 1),
+                    ...injected,
+                    ...steps.slice(insertionIndex + 1),
+                ];
+            }
+            else {
+                steps = [...steps, ...injected];
+            }
+        }
+        else {
+            steps = appendNewSteps(steps, amendment.steps_to_add);
+        }
+    }
+    if (Array.isArray(amendment.append_steps) && amendment.append_steps.length > 0) {
+        steps = appendNewSteps(steps, amendment.append_steps);
+    }
+    if (Array.isArray(amendment.reorder_step_ids) && amendment.reorder_step_ids.length > 0) {
+        const order = new Map(amendment.reorder_step_ids.map((stepId, index) => [stepId, index]));
+        steps = steps
+            .slice()
+            .sort((left, right) => {
+            const leftRank = order.get(left.step_id);
+            const rightRank = order.get(right.step_id);
+            if (leftRank === undefined && rightRank === undefined) {
+                return parseNumericStepId(left.step_id) - parseNumericStepId(right.step_id);
+            }
+            if (leftRank === undefined)
+                return 1;
+            if (rightRank === undefined)
+                return -1;
+            return leftRank - rightRank;
+        });
+    }
+    return withDerivedStatus({
+        ...plan,
+        steps,
+        execution_mode: amendment.execution_mode ?? plan.execution_mode,
+        vcx_cursor: amendment.vcx_cursor ?? plan.vcx_cursor,
+    });
+}
+export async function promoteParallelGroupToScheduler(plan, parallelGroup, owner = "capability-ops") {
+    const readySteps = getReadyTaskSteps(plan).filter((step) => step.parallel_group === parallelGroup);
+    if (readySteps.length === 0) {
+        return { plan, job_ids: [] };
+    }
+    if (!existsSync(dirname(getJobQueuePath()))) {
+        console.warn(`[orchestrator-supervisor] Scheduler state is not ready under ${dirname(getJobQueuePath())}; skipping promotion for parallel group '${parallelGroup}'.`);
+        return { plan, job_ids: [] };
+    }
+    const jobIds = [];
+    const nextSteps = cloneSteps(plan.steps);
+    for (const step of readySteps) {
+        const enqueued = await enqueueJob({
+            kind: step.role,
+            payload: {
+                task: step.task,
+                tool_scope: step.tool_scope ?? [],
+                plan_id: plan.plan_id,
+                step_id: step.step_id,
+            },
+            priority: "P1",
+            dependencies: step.depends_on?.map((dependency) => ({
+                kind: "handoff",
+                ref: dependency,
+            })) ?? [],
+        });
+        const jobId = enqueued.ack?.job_id;
+        if (!jobId)
+            continue;
+        jobIds.push(jobId);
+        const stepIndex = nextSteps.findIndex((candidate) => candidate.step_id === step.step_id);
+        if (stepIndex >= 0) {
+            nextSteps[stepIndex] = {
+                ...nextSteps[stepIndex],
+                status: "running",
+                job_id: jobId,
+            };
+        }
+    }
+    if (jobIds.length > 0) {
+        const refs = deriveWorkspaceVericifyRunRef({
+            session_id: plan.plan_id,
+            role: "orchestrator",
+        });
+        await dispatchJobs({ owner });
+        await appendVericifyProcessPostSafe({
+            run_id: refs.run_id,
+            branch_id: refs.branch_id,
+            lane_id: refs.lane_id,
+            agent_id: "agent-orchestrator",
+            kind: "progress",
+            summary: `Promoted parallel group '${parallelGroup}' to scheduler: ${jobIds.join(", ")}`,
+            tool_refs: ["enqueue_job", "dispatch_jobs"],
+            evidence_refs: jobIds,
+        });
+    }
+    return {
+        plan: withDerivedStatus({
+            ...plan,
+            execution_mode: "scheduled",
+            steps: nextSteps,
+            status: "executing",
+        }),
+        job_ids: jobIds,
+    };
+}
+export async function superviseTaskPlan(inputPlan, hooks) {
+    let plan = withDerivedStatus({
+        ...inputPlan,
+        steps: cloneSteps(inputPlan.steps),
+    });
+    const handoffIds = [];
+    const jobIds = [];
+    if (!plan.vcx_cursor && hooks.getVericifyContext) {
+        const contextPacket = await hooks.getVericifyContext(plan);
+        const vcxCursor = extractVcxCursor(contextPacket);
+        if (vcxCursor) {
+            plan = {
+                ...plan,
+                vcx_cursor: vcxCursor,
+            };
+        }
+    }
+    const maxIterations = Math.max(1, plan.steps.length * 4);
+    for (let iteration = 0; iteration < maxIterations; iteration += 1) {
+        const readySteps = getReadyTaskSteps(plan);
+        if (readySteps.length === 0) {
+            break;
+        }
+        if (plan.execution_mode === "scheduled") {
+            const readyGroup = readySteps.find((step) => step.parallel_group)?.parallel_group;
+            if (readyGroup) {
+                const promoted = await promoteParallelGroupToScheduler(plan, readyGroup);
+                jobIds.push(...promoted.job_ids);
+                plan = promoted.plan;
+                break;
+            }
+        }
+        const currentStep = readySteps[0];
+        plan = markTaskStepStatus(plan, currentStep.step_id, "running");
+        await hooks.emitStatusEvent?.({
+            status: "in_progress",
+            summary: `Running ${currentStep.step_id}: ${currentStep.task}`,
+            step_id: currentStep.step_id,
+        });
+        let handoffId;
+        if (hooks.createHandoff) {
+            const created = await hooks.createHandoff({ step: currentStep, plan });
+            handoffId = created.handoff_id;
+            handoffIds.push(handoffId);
+            plan = amendTaskPlan(plan, {
+                update_steps: [{ step_id: currentStep.step_id, patch: { handoff_id: handoffId } }],
+            });
+            await hooks.ackHandoff?.(handoffId, "accepted", `Started ${currentStep.step_id}`);
+        }
+        const result = await hooks.spawnStep(currentStep, plan);
+        plan = applyBridgeResultToStep(plan, currentStep.step_id, result);
+        if (handoffId) {
+            await hooks.ackHandoff?.(handoffId, result.status === "completed" ? "completed" : "blocked", result.summary);
+        }
+        let vericifyDelta;
+        if (plan.vcx_cursor && hooks.getVericifyDelta) {
+            vericifyDelta = await hooks.getVericifyDelta(plan.vcx_cursor, {
+                plan,
+                step: currentStep,
+                result,
+            });
+            const nextCursor = extractVcxCursor(vericifyDelta);
+            if (nextCursor) {
+                plan = {
+                    ...plan,
+                    vcx_cursor: nextCursor,
+                };
+            }
+        }
+        const amended = await hooks.amendPlan?.({
+            plan,
+            step: plan.steps.find((step) => step.step_id === currentStep.step_id) ?? currentStep,
+            result,
+            vericify_delta: vericifyDelta,
+        });
+        if (amended) {
+            plan = isTaskPlan(amended) ? withDerivedStatus(amended) : amendTaskPlan(plan, amended);
+        }
+        if (result.status === "failed" || result.status === "needs_input" || result.status === "max_turns") {
+            await hooks.openCircuitBreaker?.(result.summary, {
+                plan,
+                step: plan.steps.find((step) => step.step_id === currentStep.step_id) ?? currentStep,
+                result,
+            });
+            return {
+                plan: withDerivedStatus(plan),
+                handoff_ids: handoffIds,
+                job_ids: jobIds,
+                circuit_opened: true,
+            };
+        }
+    }
+    if (plan.steps.length > 0 && plan.steps.every((step) => step.status === "done" || step.status === "skipped")) {
+        const finalGate = await hooks.executeGates?.(plan);
+        await hooks.contextSnapshot?.(plan);
+        await hooks.emitStatusEvent?.({
+            status: "done",
+            summary: `Task plan ${plan.plan_id} completed`,
+        });
+        await hooks.closeCircuitBreaker?.("Task plan completed.", { plan });
+        return {
+            plan: {
+                ...plan,
+                status: "done",
+            },
+            handoff_ids: handoffIds,
+            job_ids: jobIds,
+            circuit_opened: false,
+            final_gate: finalGate,
+        };
+    }
+    return {
+        plan: withDerivedStatus(plan),
+        handoff_ids: handoffIds,
+        job_ids: jobIds,
+        circuit_opened: false,
+    };
+}
+//# sourceMappingURL=orchestrator-supervisor.js.map

package/dist/orchestrator-supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-supervisor.js","sourceRoot":"","sources":["../src/orchestrator-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAmG9B,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,OAAO,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CACrB,KAAiB,EACjB,SAAsD;IAEtD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACxB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,QAAQ;YACX,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;YACzB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAoB;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,KAAkB,CAAC,KAAK,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,SAAS,GAAG,OAAkC,CAAC;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC;IACjF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC;IACzC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,MAAM,GAAI,UAAsC,CAAC,UAAU,CAAC;QAClE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAc;IACjD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QAC7G,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QAC1D,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;QACtD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAc;IACvC,OAAO;QACL,GAAG,IAAI;QACP,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7B,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAK9B;IACC,OAAO,iBAAiB,CAAC;QACvB,OAAO,EAAE,QAAQ,UAAU,EAAE,EAAE;QAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,GAAG,IAAI;YACP,OAAO,EAAE,QAAQ,KAAK,GAAG,CAAC,EAAE;YAC5B,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,MAAM,EAAE,UAAU;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,YAAY;QACpD,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,IAAI,CAAC,KAAK;SACP,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;SACrE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAC/B,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QAC3C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAc,EACd,MAAc,EACd,MAAsB,EACtB,QAAuD,EAAE;IAEzD,OAAO,iBAAiB,CAAC;QACvB,GAAG,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,OAAO,KAAK,MAAM;YACrB,CAAC,CAAC;gBACE,GAAG,IAAI;gBACP,GAAG,KAAK;gBACR,MAAM;aACP;YACH,CAAC,CAAC,IAAI,CACT;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAc,EACd,MAAc,EACd,MAAoB;IAEpB,MAAM,UAAU,GACd,MAAM,CAAC,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,aAAa,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAChE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ,CAAC;IACjB,OAAO,iBAAiB,CAAC;QACvB,GAAG,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,OAAO,KAAK,MAAM;YACrB,CAAC,CAAC;gBACE,GAAG,IAAI;gBACP,MAAM,EAAE,UAAU;gBAClB,cAAc,EAAE,MAAM,CAAC,OAAO;gBAC9B,aAAa,EAAE,kBAAkB,CAAC,MAAM,CAAC;gBACzC,cAAc,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aACtE;YACH,CAAC,CAAC,IAAI,CACT;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,SAA4B;IACxE,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACrD,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;YAC5C,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;gBAC7B,CAAC,CAAC;oBACE,GAAG,IAAI;oBACP,GAAG,MAAM,CAAC,KAAK;iBAChB;gBACH,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjF,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;YAC/C,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,QAAQ;gBACX,OAAO,EAAE,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;gBAC7C,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;YAChC,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC/F,MAAM,QAAQ,GAAe,EAAE,CAAC;YAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,QAAQ;oBACX,OAAO,EAAE,UAAU,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;oBAC5C,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,GAAG;oBACN,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC;oBACrC,GAAG,QAAQ;oBACX,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;iBACnC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1F,KAAK,GAAG,KAAK;aACV,KAAK,EAAE;aACP,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBACtD,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YACrC,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC,CAAC;YACvC,OAAO,QAAQ,GAAG,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,iBAAiB,CAAC;QACvB,GAAG,IAAI;QACP,KAAK;QACL,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc;QAC/D,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;KACpD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,IAAc,EACd,aAAqB,EACrB,KAAK,GAAG,gBAAgB;IAExB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,CAC/C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,KAAK,aAAa,CAChD,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CACV,gEAAgE,OAAO,CAAC,eAAe,EAAE,CAAC,4CAA4C,aAAa,IAAI,CACxJ,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;gBACjC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;YACD,QAAQ,EAAE,IAAI;YACd,YAAY,EACV,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,SAAS;gBACf,GAAG,EAAE,UAAU;aAChB,CAAC,CAAC,IAAI,EAAE;SACZ,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;QACzF,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,SAAS,CAAC,SAAS,CAAC,GAAG;gBACrB,GAAG,SAAS,CAAC,SAAS,CAAC;gBACvB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,6BAA6B,CAAC;YACzC,UAAU,EAAE,IAAI,CAAC,OAAO;YACxB,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9B,MAAM,6BAA6B,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,oBAAoB;YAC9B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,4BAA4B,aAAa,mBAAmB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxF,SAAS,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;YAC3C,aAAa,EAAE,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC;YACtB,GAAG,IAAI;YACP,cAAc,EAAE,WAAW;YAC3B,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmB,EACnB,KAAsB;IAEtB,IAAI,IAAI,GAAG,iBAAiB,CAAC;QAC3B,GAAG,SAAS;QACZ,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IACH,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QACjD,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,UAAU,EAAE,SAAS;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM;QACR,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;YAClF,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACzE,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACjC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;gBACrB,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAChE,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,WAAW,WAAW,CAAC,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE;YAC9D,OAAO,EAAE,WAAW,CAAC,OAAO;SAC7B,CAAC,CAAC;QAEH,IAAI,SAA6B,CAAC;QAClC,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE;gBACzB,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC;aACnF,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAElE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,CAAC,UAAU,EAAE,CACtB,SAAS,EACT,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EACvD,MAAM,CAAC,OAAO,CACf,CAAC;QACJ,CAAC;QAED,IAAI,aAAsB,CAAC;QAC3B,IAAI,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC9C,aAAa,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE;gBAC5D,IAAI;gBACJ,IAAI,EAAE,WAAW;gBACjB,MAAM;aACP,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;YACnD,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,GAAG;oBACL,GAAG,IAAI;oBACP,UAAU,EAAE,UAAU;iBACvB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI;YACJ,IAAI,EACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW;YAChF,MAAM;YACN,cAAc,EAAE,aAAa;SAC9B,CAAC,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACnG,MAAM,KAAK,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC/C,IAAI;gBACJ,IAAI,EACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW;gBAChF,MAAM;aACP,CAAC,CAAC;YACH,OAAO;gBACL,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;gBAC7B,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,MAAM;gBACf,cAAc,EAAE,IAAI;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QAC7G,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,aAAa,IAAI,CAAC,OAAO,YAAY;SAC/C,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,mBAAmB,EAAE,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,MAAM,EAAE,MAAM;aACf;YACD,WAAW,EAAE,UAAU;YACvB,OAAO,EAAE,MAAM;YACf,cAAc,EAAE,KAAK;YACrB,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAC7B,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8nBvD"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6GpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkpBvD"}

package/dist/prompts.js

@@ -5,6 +5,87 @@
 import { z } from "zod";
 import { readKernelArtifact, listAvailableSkills, readAgentInstructions, readSkillInstructions, readTaskArtifact, } from "./helpers.js";
 import { readRuntimeProfileState, renderRuntimePrompt } from "./runtime-profile.js";
+import { buildAceContinuityPacket, buildAceRecallContext, formatAceContinuityPacketMarkdown, formatAceRecallMarkdown, normalizeAutonomyPolicy, normalizeContinuityPolicy, } from "./ace-autonomy.js";
+function formatRecallSlices(task) {
+    const recall = buildAceRecallContext();
+    const slices = recall.state_slices
+        .filter((entry) => entry.present)
+        .slice(0, 5)
+        .flatMap((entry) => [
+        `### ${entry.path}`,
+        "```text",
+        entry.excerpt,
+        "```",
+    ]);
+    return [
+        "## ACE Preflight",
+        "ACE-Orchestrator owns preflight before any substantial dispatch.",
+        formatAceRecallMarkdown(recall),
+        task ? `- Requested task: ${task}` : "",
+        "",
+        "## ACE Recall",
+        ...(slices.length > 0 ? slices : ["(no current ACE state slices found)"]),
+        ...(recall.snapshot
+            ? [
+                "",
+                "## Latest Context Snapshot",
+                `Name: ${recall.snapshot.name}`,
+                `Timestamp: ${recall.snapshot.timestamp}`,
+                `Summary: ${recall.snapshot.summary}`,
+                "```json",
+                recall.snapshot.content,
+                "```",
+            ]
+            : []),
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function resolveSnapshotName(context) {
+    const candidates = [context.context_snapshot_name, context.snapshot_name];
+    for (const candidate of candidates) {
+        if (typeof candidate === "string" && candidate.trim().length > 0) {
+            return candidate.trim();
+        }
+    }
+    return undefined;
+}
+function renderRuntimeRecallSections(input) {
+    const recall = buildAceRecallContext({
+        state_sources: input.stateSources,
+        snapshot_name: input.snapshotName,
+    });
+    const slices = input.includeSlices
+        ? recall.state_slices
+            .filter((entry) => entry.present)
+            .slice(0, 5)
+            .flatMap((entry) => [
+            `### ${entry.path}`,
+            "```text",
+            entry.excerpt,
+            "```",
+        ])
+        : [];
+    return {
+        recallMd: [
+            formatAceRecallMarkdown(recall),
+            input.task ? `- Requested task: ${input.task}` : "",
+            ...(slices.length > 0 ? ["", ...slices] : []),
+        ]
+            .filter(Boolean)
+            .join("\n"),
+        snapshotMd: recall.snapshot
+            ? [
+                `Name: ${recall.snapshot.name}`,
+                `Timestamp: ${recall.snapshot.timestamp}`,
+                `Summary: ${recall.snapshot.summary}`,
+                "```json",
+                recall.snapshot.content,
+                "```",
+            ].join("\n")
+            : "",
+    };
+}
 export function registerPrompts(server) {
     // ── Token-budget mode ─────────────────────────────────────────────
     const BRIEF_SCHEMA = z
@@ -35,8 +116,26 @@ export function registerPrompts(server) {
             }
         }
         const active = readRuntimeProfileState();
+        const autonomy = normalizeAutonomyPolicy(active.profile.autonomy);
+        const continuity = normalizeContinuityPolicy(active.profile.continuity);
+        const snapshotName = resolveSnapshotName(extraContext);
+        const recallSections = renderRuntimeRecallSections({
+            task,
+            snapshotName,
+            stateSources: autonomy.state_sources,
+            includeSlices: !continuity.enabled,
+        });
+        const continuityPacket = buildAceContinuityPacket({
+            snapshot_name: snapshotName,
+            policy: continuity,
+        });
         const rendered = renderRuntimePrompt({
             task: task ?? "No task provided.",
+            autonomy,
+            continuity,
+            ace_state_recall_md: recallSections.recallMd,
+            ace_context_snapshot_md: recallSections.snapshotMd,
+            ace_continuity_packet_md: formatAceContinuityPacketMarkdown(continuityPacket),
             ...extraContext,
         });
         return {
@@ -73,6 +172,8 @@ export function registerPrompts(server) {
                         "",
                         "## Orchestrator Instructions",
                         readAgentInstructions("orchestrator"),
+                        "",
+                        ...(brief ? ["## ACE Preflight", formatAceRecallMarkdown(buildAceRecallContext())] : [formatRecallSlices(task)]),
                         ...(brief
                             ? []
                             : [