@nervekit/orchestrator 0.1.0

package/dist/plan-service.js

@@ -0,0 +1,255 @@
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { createId, planReviewRecordSchema, } from "@nerve/shared";
+import { appendJsonLine, pathExists, readJsonLines, rewriteJsonLines, } from "./infrastructure/storage/index.js";
+import { isPathInsidePlanDir, planDirForStorageHome, planSlugFromPath, resolvePlanPath, } from "./plan-paths.js";
+const UNRESOLVED_PLAN_MARKER = /\[!(QUESTION|DECISION)\]/i;
+export class PlanService {
+    storage;
+    events;
+    getAgent;
+    setAgentMode;
+    planReviews = new Map();
+    waiters = new Map();
+    constructor(storage, events, getAgent, setAgentMode) {
+        this.storage = storage;
+        this.events = events;
+        this.getAgent = getAgent;
+        this.setAgentMode = setAgentMode;
+    }
+    async hydrate() {
+        for (const review of await this.readLatestPlanReviews()) {
+            this.planReviews.set(review.id, review);
+        }
+    }
+    listPlanReviews(status) {
+        return [...this.planReviews.values()]
+            .filter((review) => !status || review.status === status)
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+    async removeReviewsForConversations(conversationIds) {
+        const conversations = new Set(conversationIds);
+        if (conversations.size === 0)
+            return;
+        for (const [id, review] of this.planReviews) {
+            if (conversations.has(review.conversationId))
+                this.planReviews.delete(id);
+        }
+        await rewriteJsonLines(this.planReviewsPath(), this.listPlanReviews(), 0o600);
+    }
+    planDir(_agent) {
+        return planDirForStorageHome(this.storage.paths.home);
+    }
+    async listPlanFiles(agent) {
+        const dir = this.planDir(agent);
+        if (!(await pathExists(dir)))
+            return [];
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+        return entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+            .map((entry) => entry.name)
+            .sort();
+    }
+    async createPlanReview(toolCall, agent, args) {
+        const planPath = resolvePlanPath(toolCall.cwd, args.file_path);
+        const planDir = this.planDir(agent);
+        if (!isPathInsidePlanDir(planDir, planPath)) {
+            throw new Error(`Plan file must be inside ${planDir}. Attempted: ${planPath}`);
+        }
+        if (!(await pathExists(planPath))) {
+            throw new Error(`Could not read plan file: ${planPath}`);
+        }
+        const content = await readFile(planPath, "utf8");
+        if (!content.trim()) {
+            throw new Error("Plan file is empty. Write your plan first, then present it.");
+        }
+        if (UNRESOLVED_PLAN_MARKER.test(content)) {
+            throw new Error("Plan still contains unresolved question or decision callouts. Resolve them before presenting.");
+        }
+        const slug = planSlugFromPath(planPath);
+        const title = optionalStringArg(args.title) ?? basename(planPath);
+        const summary = optionalStringArg(args.summary);
+        const existingPending = this.listPlanReviews("pending").find((review) => review.agentId === agent.id && review.planPath === planPath);
+        if (existingPending) {
+            throw new Error(`Plan '${planPath}' is already pending user review.`);
+        }
+        const now = new Date().toISOString();
+        const review = {
+            id: createId("plan_review"),
+            toolCallId: toolCall.id,
+            agentId: agent.id,
+            conversationId: agent.conversationId,
+            projectId: agent.projectId,
+            slug,
+            title,
+            summary,
+            planPath,
+            content,
+            status: "pending",
+            requestedAt: now,
+            updatedAt: now,
+        };
+        await this.upsertPlanReview(review);
+        await this.events.publish("plan_review.requested", { planReview: review });
+        return review;
+    }
+    async presentPlan(toolCall, agent, args, signal) {
+        const review = await this.createPlanReview(toolCall, agent, args);
+        const resolved = await this.waitForPlanReview(review.id, signal);
+        return this.planReviewResult(resolved);
+    }
+    planReviewResult(review) {
+        return {
+            review,
+            outcome: review.status,
+            feedback: review.feedback,
+            mode: this.getAgent(review.agentId).mode,
+            contentBlocks: [
+                {
+                    type: "text",
+                    text: this.planReviewOutcomeMessage(review),
+                },
+            ],
+        };
+    }
+    async acceptPlanReview(reviewId, feedback) {
+        const review = this.getPendingPlanReview(reviewId);
+        await this.setAgentMode(review.agentId, "coding", "Plan accepted by user.");
+        const updated = await this.resolvePlanReview(review, "accepted", feedback);
+        await this.events.publish("plan_review.accepted", { planReview: updated });
+        return updated;
+    }
+    async requestPlanChanges(reviewId, feedback) {
+        const review = this.getPendingPlanReview(reviewId);
+        const updated = await this.resolvePlanReview(review, "changes_requested", feedback);
+        await this.events.publish("plan_review.changes_requested", {
+            planReview: updated,
+        });
+        return updated;
+    }
+    async rejectPlanReview(reviewId, feedback) {
+        const review = this.getPendingPlanReview(reviewId);
+        const updated = await this.resolvePlanReview(review, "changes_requested", feedback ?? "Plan rejected by user.");
+        await this.events.publish("plan_review.rejected", { planReview: updated });
+        return updated;
+    }
+    async discardPlanReview(reviewId, feedback) {
+        const review = this.getPendingPlanReview(reviewId);
+        const updated = await this.resolvePlanReview(review, "discarded", feedback);
+        await this.events.publish("plan_review.discarded", { planReview: updated });
+        return updated;
+    }
+    async forceExitAgentPlanning(agentId, reason) {
+        const updated = await this.setAgentMode(agentId, "coding", reason);
+        await this.events.publish("plan_review.force_exited", {
+            agentId,
+            conversationId: updated.conversationId,
+            projectId: updated.projectId,
+            reason,
+        });
+        return updated;
+    }
+    async waitForPlanReview(reviewId, signal) {
+        if (signal?.aborted) {
+            void this.discardPlanReview(reviewId, "Agent run aborted.").catch(() => undefined);
+        }
+        return new Promise((resolve) => {
+            const settle = (review) => {
+                if (review.status === "pending")
+                    return;
+                cleanup();
+                resolve(review);
+            };
+            const onAbort = () => {
+                void this.discardPlanReview(reviewId, "Agent run aborted.").catch(() => undefined);
+            };
+            const cleanup = () => {
+                const waiters = this.waiters.get(reviewId);
+                waiters?.delete(settle);
+                if (waiters && waiters.size === 0)
+                    this.waiters.delete(reviewId);
+                signal?.removeEventListener("abort", onAbort);
+            };
+            const current = this.planReviews.get(reviewId);
+            if (current && current.status !== "pending") {
+                resolve(current);
+                return;
+            }
+            let waiters = this.waiters.get(reviewId);
+            if (!waiters) {
+                waiters = new Set();
+                this.waiters.set(reviewId, waiters);
+            }
+            waiters.add(settle);
+            signal?.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    getPendingPlanReview(reviewId) {
+        const review = this.planReviews.get(reviewId);
+        if (!review)
+            throw new Error("Plan review not found.");
+        if (review.status !== "pending") {
+            throw new Error("Plan review is already resolved.");
+        }
+        return review;
+    }
+    async resolvePlanReview(review, status, feedback) {
+        const updated = {
+            ...review,
+            status,
+            feedback: optionalStringArg(feedback),
+            resolvedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        await this.upsertPlanReview(updated);
+        this.notifyWaiters(updated);
+        return updated;
+    }
+    notifyWaiters(review) {
+        const waiters = this.waiters.get(review.id);
+        if (!waiters)
+            return;
+        this.waiters.delete(review.id);
+        for (const waiter of waiters)
+            waiter(review);
+    }
+    async upsertPlanReview(review) {
+        this.planReviews.set(review.id, review);
+        await appendJsonLine(this.planReviewsPath(), review, 0o600);
+    }
+    async readLatestPlanReviews() {
+        const values = await readJsonLines(this.planReviewsPath()).catch(() => []);
+        const parsed = values
+            .map((value) => planReviewRecordSchema.safeParse(value))
+            .filter((result) => result.success)
+            .map((result) => result.data);
+        return latestById(parsed);
+    }
+    planReviewOutcomeMessage(review) {
+        if (review.status === "accepted") {
+            return `Plan accepted. Proceed with implementation using ${review.planPath} as the source of truth.`;
+        }
+        if (review.status === "changes_requested") {
+            return `Plan rejected. The current mode remains unchanged; wait for the user's follow-up instructions before presenting another plan.`;
+        }
+        if (review.status === "discarded") {
+            return `Plan review discarded. Plan mode remains active; continue planning or exit with plan_mode_force_exit.`;
+        }
+        return `Plan review status: ${review.status}.`;
+    }
+    planReviewsPath() {
+        return join(this.storage.paths.home, "plans", "plan-reviews.jsonl");
+    }
+}
+function optionalStringArg(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+function latestById(values) {
+    const byId = new Map();
+    for (const value of values)
+        byId.set(value.id, value);
+    return [...byId.values()];
+}
+//# sourceMappingURL=plan-service.js.map

package/dist/plan-service.js.map

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

package/dist/policy.d.ts

@@ -0,0 +1,14 @@
+import type { AgentRecord, ToolName, ToolRisk } from "@nerve/shared";
+export type PolicyDecision = "allow" | "approval" | "deny";
+export interface PolicyEvaluation {
+    decision: PolicyDecision;
+    risk: ToolRisk;
+    reason: string;
+    normalizedArgs: Record<string, unknown>;
+    cwd: string;
+}
+export interface PolicyContext {
+    dataDir: string;
+}
+export declare function evaluateToolPolicy(agent: AgentRecord, toolName: ToolName, args: Record<string, unknown>, context: PolicyContext): PolicyEvaluation;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAYrE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,aAAa,GACrB,gBAAgB,CA2ElB"}

package/dist/policy.js

@@ -0,0 +1,247 @@
+import { resolve } from "node:path";
+import { hasDangerousCommandPattern, isKnownReadOnlyCommand, toolRiskForName, } from "@nerve/tools";
+import { isPathInsidePlanDir, planDirForStorageHome, resolvePlanPath, } from "./plan-paths.js";
+export function evaluateToolPolicy(agent, toolName, args, context) {
+    const cwd = normalizeCwd(agent, args);
+    const normalizedArgs = { ...args };
+    const risk = classifyRisk(toolName, args);
+    if (agent.mode === "planning") {
+        const planningDecision = evaluatePlanningModePolicy(agent, toolName, args, risk, normalizedArgs, cwd, context);
+        if (planningDecision)
+            return planningDecision;
+    }
+    if (toolName === "plan_mode_present" || toolName === "plan_mode_force_exit") {
+        return {
+            decision: "deny",
+            risk,
+            reason: `${toolName} is only available after entering planning mode.`,
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (risk === "interaction") {
+        return {
+            decision: "allow",
+            risk,
+            reason: "User-interaction tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (risk === "read") {
+        return {
+            decision: "allow",
+            risk,
+            reason: "Read-only tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (agent.permissionLevel === "read_only") {
+        return {
+            decision: "deny",
+            risk,
+            reason: `Tool risk '${risk}' is not allowed for read_only agents.`,
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (agent.permissionLevel === "supervised") {
+        return {
+            decision: "approval",
+            risk,
+            reason: `Supervised agent requires approval for '${risk}' tool calls.`,
+            normalizedArgs,
+            cwd,
+        };
+    }
+    return {
+        decision: "allow",
+        risk,
+        reason: `Autonomous agent may run '${risk}' tool calls without approval.`,
+        normalizedArgs,
+        cwd,
+    };
+}
+function normalizeCwd(agent, args) {
+    const cwd = typeof args.cwd === "string" && args.cwd.trim().length > 0
+        ? resolve(agent.projectDir, args.cwd)
+        : resolve(agent.projectDir);
+    return cwd;
+}
+function evaluatePlanningModePolicy(agent, toolName, args, risk, normalizedArgs, cwd, context) {
+    const allowedInteractionTools = new Set([
+        "ask_user",
+        "todos_set",
+        "plan_mode_enter",
+        "plan_mode_present",
+        "plan_mode_force_exit",
+    ]);
+    if (allowedInteractionTools.has(toolName)) {
+        return {
+            decision: "allow",
+            risk,
+            reason: "Planning-mode interaction tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (risk === "read") {
+        return {
+            decision: "allow",
+            risk,
+            reason: "Planning-mode read-only tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (risk === "network") {
+        if (agent.permissionLevel === "read_only") {
+            return {
+                decision: "deny",
+                risk,
+                reason: "read_only agents cannot run network tool calls.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        if (agent.permissionLevel === "supervised") {
+            return {
+                decision: "approval",
+                risk,
+                reason: "Supervised agent requires approval for network tool calls.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        return {
+            decision: "allow",
+            risk,
+            reason: "Planning-mode network research tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (toolName === "edit" || toolName === "write") {
+        let targetPath;
+        try {
+            targetPath = resolvePlanPath(cwd, args.path);
+        }
+        catch (error) {
+            return {
+                decision: "deny",
+                risk,
+                reason: error instanceof Error ? error.message : String(error),
+                normalizedArgs,
+                cwd,
+            };
+        }
+        const planDir = planDirForStorageHome(context.dataDir);
+        if (!isPathInsidePlanDir(planDir, targetPath)) {
+            return {
+                decision: "deny",
+                risk,
+                reason: `Planning mode allows ${toolName} only for plan files inside ${planDir}. Attempted: ${targetPath}`,
+                normalizedArgs,
+                cwd,
+            };
+        }
+        normalizedArgs.path = targetPath;
+        if (agent.permissionLevel === "read_only") {
+            return {
+                decision: "deny",
+                risk,
+                reason: "read_only agents cannot write plan documents.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        if (agent.permissionLevel === "supervised") {
+            return {
+                decision: "approval",
+                risk,
+                reason: "Supervised agent requires approval for plan file write/edit tool calls.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        return {
+            decision: "allow",
+            risk,
+            reason: "Planning-mode plan file write/edit tool call is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    if (toolName === "subagent_run") {
+        if (args.mode === "coding") {
+            return {
+                decision: "deny",
+                risk,
+                reason: "Planning mode cannot spawn coding subagents.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        if (agent.permissionLevel === "read_only") {
+            return {
+                decision: "deny",
+                risk,
+                reason: "read_only agents cannot spawn subagents.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        if (agent.permissionLevel === "supervised") {
+            return {
+                decision: "approval",
+                risk,
+                reason: "Supervised agent requires approval for planning subagents.",
+                normalizedArgs,
+                cwd,
+            };
+        }
+        return {
+            decision: "allow",
+            risk,
+            reason: "Planning-mode subagent investigation is allowed.",
+            normalizedArgs,
+            cwd,
+        };
+    }
+    return {
+        decision: "deny",
+        risk,
+        reason: `Planning mode cannot run '${toolName}' because it may mutate workspace files, processes, or runtime state outside plan review.`,
+        normalizedArgs,
+        cwd,
+    };
+}
+function classifyRisk(toolName, args) {
+    if (toolName === "ask_user" ||
+        toolName === "todos_set" ||
+        toolName === "plan_mode_enter" ||
+        toolName === "plan_mode_present" ||
+        toolName === "plan_mode_force_exit") {
+        return "interaction";
+    }
+    if (toolName === "todos_get" ||
+        toolName === "process_list" ||
+        toolName === "process_logs") {
+        return "read";
+    }
+    if (toolName === "process_stop" || toolName === "process_restart") {
+        return "destructive";
+    }
+    if (toolName === "web_search" || toolName === "web_fetch") {
+        return "network";
+    }
+    if (toolName === "bash" && typeof args.command === "string") {
+        if (hasDangerousCommandPattern(args.command))
+            return "destructive";
+        if (isKnownReadOnlyCommand(args.command))
+            return "read";
+    }
+    return toolRiskForName(toolName);
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/process-manager.d.ts

@@ -0,0 +1,72 @@
+import { type ProcessLogQuery, type ProcessLogQueryResponse, type ProcessRecord, type StartProcessRequest, type StopProcessRequest } from "@nerve/shared";
+import type { EventBus } from "./infrastructure/events/index.js";
+import type { IndexStore } from "./infrastructure/index-store/index.js";
+import type { InitializedStorage } from "./infrastructure/storage/index.js";
+import type { ApplicationLogger } from "./logging.js";
+export declare class ProcessManager {
+    private readonly events;
+    private readonly index;
+    private readonly logger?;
+    readonly processes: Map<string, {
+        id: string;
+        cwd: string;
+        command: string;
+        status: "error" | "running" | "ready" | "starting" | "stopping" | "stopped" | "exited" | "orphaned";
+        readiness: {
+            outcome: "ready" | "exited" | "pending" | "timeout" | "none";
+            readyOnUrl?: boolean | undefined;
+            readyPattern?: string | undefined;
+            timeoutMs?: number | undefined;
+            matched?: string | undefined;
+            readyAt?: string | undefined;
+        };
+        stdoutPath: string;
+        stderrPath: string;
+        logsPath: string;
+        startedAt: string;
+        updatedAt: string;
+        name?: string | undefined;
+        workerId?: string | undefined;
+        projectId?: string | undefined;
+        conversationId?: string | undefined;
+        agentId?: string | undefined;
+        env?: Record<string, string> | undefined;
+        exitedAt?: string | undefined;
+        exitCode?: number | null | undefined;
+        signal?: string | null | undefined;
+        error?: string | undefined;
+        restartedFromProcessId?: string | undefined;
+    }>;
+    private readonly managed;
+    private readonly processRepository;
+    private readonly processLogs;
+    private readonly processReadiness;
+    constructor(storage: InitializedStorage, events: EventBus, index: IndexStore, logger?: ApplicationLogger | undefined);
+    hydrate(): Promise<void>;
+    listProcesses(): ProcessRecord[];
+    getProcess(processId: string): ProcessRecord;
+    findProcessByName(name: string): ProcessRecord | undefined;
+    startProcess(request: StartProcessRequest & {
+        restartedFromProcessId?: string;
+        workerId?: string;
+    }): Promise<ProcessRecord>;
+    stopProcess(processId: string, request?: StopProcessRequest): Promise<ProcessRecord>;
+    restartProcess(processId: string): Promise<ProcessRecord>;
+    removeProcess(processId: string): Promise<void>;
+    pruneProcesses(): Promise<string[]>;
+    activeProcessesForConversations(conversationIds: Iterable<string>): ProcessRecord[];
+    removeInactiveProcessesForConversations(conversationIds: Iterable<string>): Promise<string[]>;
+    queryLogs(processId: string, query?: ProcessLogQuery): Promise<ProcessLogQueryResponse>;
+    private captureOutput;
+    private checkReadiness;
+    private waitForReadiness;
+    private markReadinessTimeout;
+    private markProcessExited;
+    private markProcessError;
+    private updateProcess;
+    private upsertProcess;
+    private writeProcess;
+    private processDir;
+}
+export { isActiveProcessStatus } from "./domains/processes/index.js";
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AASvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAUtD,qBAAa,cAAc;IASvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAV1B,QAAQ,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;gBAGhE,OAAO,EAAE,kBAAkB,EACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,iBAAiB,YAAA;IAMvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,aAAa,IAAI,aAAa,EAAE;IAMhC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAM5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIpD,YAAY,CAChB,OAAO,EAAE,mBAAmB,GAAG;QAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,aAAa,CAAC;IAmFnB,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC;IA8BnB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBzD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/C,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAczC,+BAA+B,CAC7B,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,GAChC,aAAa,EAAE;IAWZ,uCAAuC,CAC3C,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBd,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;YAIrB,aAAa;YAiBb,cAAc;YAiCd,gBAAgB;YAyBhB,oBAAoB;YAgBpB,iBAAiB;YAuCjB,gBAAgB;YAoBhB,aAAa;YAcb,aAAa;YAMb,YAAY;IAI1B,OAAO,CAAC,UAAU;CAGnB;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}