@nervekit/orchestrator 0.1.0

package/dist/domains/agents/run/subagent-runner.js

@@ -0,0 +1,374 @@
+import { copyFile, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { AgentHarness, Conversation, JsonlConversationStorage, NodeExecutionEnv, resolveAgentModel, } from "@nervekit/agent";
+import { createId } from "@nervekit/shared";
+import { pathExists, } from "../../../infrastructure/storage/index.js";
+import { loadHarnessResources } from "../../../resource-loader.js";
+import { activeToolNamesForExploreAgent, createAgentToolsForAgent, } from "../../tools/agent-tool-adapter.js";
+export { exploreRunPlanArg, exploreSystemPrompt, } from "./explore-helpers.js";
+import { abortError, addExploreUsage, asRecord, assistantMessageText, emptyExploreUsage, exploreAssistantMetadata, exploreModelLabel, exploreProgressFromHarnessEvent, exploreRunPlanArg, exploreSystemPrompt, exploreUserPrompt, formatExploreFailureReport, formatExploreReportFile, formatExploreReports, messageRole, publishExploreProgress, pushExploreStep, safeReportFileName, summaryPreview, throwIfAborted, toolNameFromHarnessEvent, } from "./explore-helpers.js";
+export class SubagentRunner {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async runExplore(parent, args, options = {}) {
+        const plan = exploreRunPlanArg(args);
+        const tasks = plan.tasks;
+        const batchId = createId("run");
+        throwIfAborted(options.signal);
+        publishExploreProgress(options.onProgress, {
+            taskCount: tasks.length,
+            phase: "queued",
+            message: plan.mode === "single"
+                ? "Starting 1 explore agent."
+                : `Starting ${tasks.length} parallel explore agents.`,
+        });
+        const settledReports = await Promise.allSettled(tasks.map(async (task, index) => {
+            throwIfAborted(options.signal);
+            publishExploreProgress(options.onProgress, {
+                taskIndex: index,
+                taskCount: tasks.length,
+                label: task.label,
+                phase: "started",
+                message: `Explore ${index + 1}/${tasks.length} started: ${task.label ?? task.task}`,
+            });
+            const output = await this.runSubagent({
+                kind: "explore",
+                parent,
+                projectId: parent.projectId,
+                projectDir: parent.projectDir,
+                workerId: parent.workerId,
+                mode: "coding",
+                permissionLevel: "read_only",
+                prompt: exploreUserPrompt(task, plan),
+                systemPrompt: exploreSystemPrompt(),
+                historyMode: "fresh",
+                model: this.deps.storage.settings.exploreAgent.model,
+                thinkingLevel: this.deps.storage.settings.exploreAgent.thinkingLevel,
+                workspaceScope: parent.workspaceScope,
+                task: task.task,
+                label: task.label,
+                taskIndex: index,
+                taskCount: tasks.length,
+                onProgress: options.onProgress,
+                signal: options.signal,
+            });
+            const reportPath = await this.writeExploreReport({
+                batchId,
+                task,
+                index,
+                plan,
+                output,
+            });
+            publishExploreProgress(options.onProgress, {
+                agentId: output.agent.id,
+                taskIndex: index,
+                taskCount: tasks.length,
+                label: task.label,
+                phase: output.status === "completed" ? "completed" : "failed",
+                message: output.status === "completed"
+                    ? `Report written: ${reportPath}`
+                    : `Failure report written: ${reportPath}`,
+            });
+            return {
+                agentId: output.agent.id,
+                task: task.task,
+                label: task.label,
+                status: output.status,
+                report: output.report,
+                reportPath,
+                summaryPreview: summaryPreview(output.report),
+                usage: output.usage,
+                model: output.model,
+                stopReason: output.stopReason,
+                errorMessage: output.errorMessage,
+                steps: output.steps,
+            };
+        }));
+        const reports = [];
+        for (const result of settledReports) {
+            if (result.status === "rejected") {
+                if (options.signal?.aborted)
+                    throw abortError();
+                throw result.reason;
+            }
+            reports.push(result.value);
+        }
+        if (options.signal?.aborted)
+            throw abortError();
+        const summary = formatExploreReports(reports);
+        await this.deps.events.publish("agent.explore_completed", {
+            parentAgentId: parent.id,
+            reports,
+        });
+        return {
+            reports,
+            contentBlocks: [{ type: "text", text: summary }],
+        };
+    }
+    async runSubagent(spec) {
+        const child = await this.deps.createAgent({
+            conversationId: spec.parent.conversationId,
+            projectId: spec.projectId,
+            projectDir: spec.projectDir,
+            workerId: spec.workerId,
+            parentAgentId: spec.parent.id,
+            task: spec.task ?? spec.prompt,
+            mode: spec.mode,
+            permissionLevel: spec.permissionLevel,
+            workspaceScope: spec.workspaceScope,
+            model: spec.model,
+            thinkingLevel: spec.thinkingLevel,
+            systemPrompt: spec.systemPrompt,
+        }, { allowChildAuthorityExceed: true });
+        await this.deps.events.publish("agent.subagent_started", {
+            parentAgentId: spec.parent.id,
+            childAgentId: child.id,
+            kind: spec.kind,
+            task: spec.task ?? spec.prompt,
+        });
+        publishExploreProgress(spec.onProgress, {
+            agentId: child.id,
+            taskIndex: spec.taskIndex,
+            taskCount: spec.taskCount,
+            label: spec.label,
+            model: exploreModelLabel(child.model),
+            phase: "started",
+            message: `Agent ${child.id} started.`,
+        });
+        const runId = createId("run");
+        const steps = [];
+        let usage = emptyExploreUsage();
+        let modelId;
+        let stopReason;
+        let errorMessage;
+        let abortRequested = false;
+        let removeSignalListener;
+        let resolveStopped = () => undefined;
+        const stopped = new Promise((resolve) => {
+            resolveStopped = resolve;
+        });
+        try {
+            throwIfAborted(spec.signal);
+            await this.deps.setAgentStatus(child, "running");
+            const storage = await this.openChildStorage(child, spec.historyMode);
+            const conversation = new Conversation(storage);
+            const model = resolveAgentModel(child.model);
+            this.deps.subscriptionUsage.touchProvider(model.provider);
+            const env = new NodeExecutionEnv({ cwd: child.projectDir });
+            const resources = await loadHarnessResources(child.projectDir);
+            const activeToolNames = activeToolNamesForExploreAgent();
+            const harness = new AgentHarness({
+                env,
+                conversation,
+                resources: { skills: resources.skills },
+                tools: createAgentToolsForAgent(child, this.deps.tools, {
+                    runId,
+                    hidden: true,
+                    allowedToolNames: activeToolNames,
+                }),
+                activeToolNames,
+                model,
+                thinkingLevel: child.thinkingLevel,
+                getApiKeyAndHeaders: async (requestModel) => {
+                    if (requestModel.provider === "nerve-faux")
+                        return undefined;
+                    const apiKey = await this.deps.auth.getApiKey(requestModel.provider);
+                    return apiKey ? { apiKey } : undefined;
+                },
+                systemPrompt: () => spec.systemPrompt,
+            });
+            harness.subscribe((event) => {
+                const update = exploreProgressFromHarnessEvent(event, child, spec);
+                if (update) {
+                    // Only stream `tool_call` deltas live (the meaningful "what it's
+                    // doing" signal); publishing tool_result/assistant too would 2-3x the
+                    // per-event transcript re-render churn. Steps below keep full detail.
+                    if (update.phase === "tool_call") {
+                        publishExploreProgress(spec.onProgress, update);
+                    }
+                    if (update.phase === "tool_call" ||
+                        update.phase === "tool_result" ||
+                        update.phase === "assistant") {
+                        pushExploreStep(steps, {
+                            type: update.phase === "assistant" ? "assistant" : update.phase,
+                            toolName: toolNameFromHarnessEvent(event),
+                            message: update.message,
+                            timestamp: new Date().toISOString(),
+                        });
+                    }
+                }
+                const record = asRecord(event);
+                if (record?.type === "message_end" &&
+                    messageRole(record.message) === "assistant") {
+                    const metadata = exploreAssistantMetadata(record.message);
+                    if (metadata.usage)
+                        usage = addExploreUsage(usage, metadata.usage);
+                    if (metadata.model)
+                        modelId = metadata.model;
+                    if (metadata.stopReason)
+                        stopReason = metadata.stopReason;
+                    if (metadata.errorMessage)
+                        errorMessage = metadata.errorMessage;
+                }
+            });
+            let abortPromise;
+            const abortRun = async () => {
+                abortRequested = true;
+                abortPromise ??= harness.abort();
+                await abortPromise;
+            };
+            const onSignalAbort = () => {
+                void abortRun();
+            };
+            if (spec.signal) {
+                spec.signal.addEventListener("abort", onSignalAbort, { once: true });
+                removeSignalListener = () => spec.signal?.removeEventListener("abort", onSignalAbort);
+            }
+            this.deps.state.runs.set(child.id, {
+                runId,
+                abort: async () => {
+                    try {
+                        await abortRun();
+                    }
+                    finally {
+                        await stopped;
+                    }
+                },
+                messages: [],
+            });
+            throwIfAborted(spec.signal);
+            const assistant = await harness.prompt(spec.prompt);
+            if (usage.turns === 0) {
+                const metadata = exploreAssistantMetadata(assistant);
+                if (metadata.usage)
+                    usage = addExploreUsage(usage, metadata.usage);
+                if (metadata.model)
+                    modelId = metadata.model;
+                if (metadata.stopReason)
+                    stopReason = metadata.stopReason;
+                if (metadata.errorMessage)
+                    errorMessage = metadata.errorMessage;
+            }
+            if (abortRequested || assistant.stopReason === "aborted") {
+                throw abortError();
+            }
+            const report = assistantMessageText(assistant).trim();
+            if (assistant.stopReason === "error") {
+                throw new Error(errorMessage ?? report ?? "Explore agent stopped with an error.");
+            }
+            if (!report)
+                throw new Error("Explore agent completed without a report.");
+            await this.deps.setAgentStatus(child, "idle");
+            await this.deps.events.publish("agent.subagent_completed", {
+                parentAgentId: spec.parent.id,
+                childAgentId: child.id,
+                kind: spec.kind,
+                summary: report,
+            });
+            return {
+                agent: child,
+                status: "completed",
+                report,
+                usage: usage.turns > 0 ? usage : undefined,
+                model: modelId,
+                stopReason,
+                errorMessage,
+                steps,
+            };
+        }
+        catch (error) {
+            const aborted = abortRequested || spec.signal?.aborted === true;
+            const latest = this.deps.state.agents.get(child.id) ?? child;
+            await this.deps
+                .setAgentStatus(latest, aborted ? "aborted" : "error")
+                .catch(() => undefined);
+            publishExploreProgress(spec.onProgress, {
+                agentId: child.id,
+                taskIndex: spec.taskIndex,
+                taskCount: spec.taskCount,
+                label: spec.label,
+                phase: "failed",
+                message: aborted
+                    ? "Agent run aborted."
+                    : error instanceof Error
+                        ? error.message
+                        : String(error),
+            });
+            await this.deps.logger.warn("Subagent run failed", {
+                agentId: child.id,
+                conversationId: child.conversationId,
+                projectId: child.projectId,
+                runId,
+                context: {
+                    kind: spec.kind,
+                    aborted,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+            if (aborted)
+                throw abortError();
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                agent: child,
+                status: "failed",
+                report: formatExploreFailureReport(message),
+                usage: usage.turns > 0 ? usage : undefined,
+                model: modelId,
+                stopReason,
+                errorMessage: errorMessage ?? message,
+                steps,
+            };
+        }
+        finally {
+            removeSignalListener?.();
+            const currentRun = this.deps.state.runs.get(child.id);
+            if (currentRun?.runId === runId)
+                this.deps.state.runs.delete(child.id);
+            try {
+                await this.deps.updateConversation({
+                    ...this.deps.getConversation(spec.parent.conversationId),
+                    activeAgentId: spec.parent.id,
+                    updatedAt: new Date().toISOString(),
+                });
+            }
+            finally {
+                resolveStopped();
+            }
+        }
+    }
+    async writeExploreReport(input) {
+        const dir = join(this.deps.storage.paths.home, "explore-reports", input.output.agent.conversationId, input.batchId);
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+        const fileName = safeReportFileName(input.task.label ?? input.task.task, input.index, input.output.agent.id);
+        const reportPath = join(dir, fileName);
+        await writeFile(reportPath, formatExploreReportFile(input.task, input.plan, input.output), {
+            encoding: "utf8",
+            mode: 0o600,
+        });
+        return reportPath;
+    }
+    async openChildStorage(child, historyMode) {
+        const childDir = join(this.deps.storage.paths.home, "agents", child.id);
+        await mkdir(childDir, { recursive: true, mode: 0o700 });
+        const childPath = join(childDir, "conversation.jsonl");
+        const env = new NodeExecutionEnv({ cwd: child.projectDir });
+        if (historyMode === "copy_parent") {
+            const parentPath = this.deps.harnessManager.conversationPath(child.conversationId);
+            if ((await pathExists(parentPath)) && !(await pathExists(childPath))) {
+                await copyFile(parentPath, childPath);
+                return JsonlConversationStorage.open(env, childPath);
+            }
+        }
+        if (!(await pathExists(childPath))) {
+            return JsonlConversationStorage.create(env, childPath, {
+                cwd: child.projectDir,
+                conversationId: child.conversationId,
+                parentConversationPath: this.deps.harnessManager.conversationPath(child.conversationId),
+            });
+        }
+        return JsonlConversationStorage.open(env, childPath);
+    }
+}
+//# sourceMappingURL=subagent-runner.js.map

package/dist/domains/agents/run/subagent-runner.js.map

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

package/dist/domains/agents/run/system-prompt-builder.d.ts

@@ -0,0 +1,19 @@
+import type { AgentRecord } from "@nervekit/shared";
+import { loadHarnessResources } from "../../../resource-loader.js";
+import { activeToolNamesForAgent, toolPromptMetadata } from "../../tools/agent-tool-adapter.js";
+/**
+ * Rebuild the system prompt for an agent using the exact same inputs the
+ * agent runner uses at run time. Deterministic given the agent config and the
+ * project resources, so it reflects the prompt used for the agent's messages.
+ */
+export declare function buildAgentSystemPrompt(agent: AgentRecord, options?: {
+    storageHome?: string;
+}): Promise<string>;
+/**
+ * Synchronous prompt composition shared by the runner (which preloads
+ * resources/metadata in its hot path) and {@link buildAgentSystemPrompt}.
+ */
+export declare function composeAgentSystemPrompt(agent: AgentRecord, activeToolNames: ReturnType<typeof activeToolNamesForAgent>, promptMetadata: ReturnType<typeof toolPromptMetadata>, resources: Awaited<ReturnType<typeof loadHarnessResources>>, options?: {
+    planDir?: string;
+}): string;
+//# sourceMappingURL=system-prompt-builder.d.ts.map

package/dist/domains/agents/run/system-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-builder.d.ts","sourceRoot":"","sources":["../../../../src/domains/agents/run/system-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAE3C;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,eAAe,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,EAC3D,cAAc,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EACrD,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,EAC3D,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,MAAM,CAaR"}

package/dist/domains/agents/run/system-prompt-builder.js

@@ -0,0 +1,39 @@
+import { buildNerveSystemPrompt } from "../../../nerve-system-prompt.js";
+import { loadHarnessResources } from "../../../resource-loader.js";
+import { planDirForStorageHome } from "../../plans/plan-paths.js";
+import { activeToolNamesForAgent, toolPromptMetadata, } from "../../tools/agent-tool-adapter.js";
+/**
+ * Rebuild the system prompt for an agent using the exact same inputs the
+ * agent runner uses at run time. Deterministic given the agent config and the
+ * project resources, so it reflects the prompt used for the agent's messages.
+ */
+export async function buildAgentSystemPrompt(agent, options = {}) {
+    const activeToolNames = activeToolNamesForAgent(agent);
+    const promptMetadata = toolPromptMetadata(activeToolNames);
+    const resources = await loadHarnessResources(agent.projectDir, {
+        storageHome: options.storageHome,
+    });
+    return composeAgentSystemPrompt(agent, activeToolNames, promptMetadata, resources, options.storageHome
+        ? { planDir: planDirForStorageHome(options.storageHome) }
+        : undefined);
+}
+/**
+ * Synchronous prompt composition shared by the runner (which preloads
+ * resources/metadata in its hot path) and {@link buildAgentSystemPrompt}.
+ */
+export function composeAgentSystemPrompt(agent, activeToolNames, promptMetadata, resources, options = {}) {
+    if (agent.systemPrompt)
+        return agent.systemPrompt;
+    return buildNerveSystemPrompt({
+        cwd: agent.projectDir,
+        mode: agent.mode,
+        selectedTools: activeToolNames,
+        promptGuidelines: promptMetadata.guidelines,
+        contextFiles: resources.contextFiles,
+        skills: resources.skills,
+        customPrompt: resources.systemPrompt,
+        appendSystemPrompt: resources.appendSystemPrompt,
+        planDir: options.planDir,
+    });
+}
+//# sourceMappingURL=system-prompt-builder.js.map

package/dist/domains/agents/run/system-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-builder.js","sourceRoot":"","sources":["../../../../src/domains/agents/run/system-prompt-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAkB,EAClB,UAAoC,EAAE;IAEtC,MAAM,eAAe,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE;QAC7D,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC;IACH,OAAO,wBAAwB,CAC7B,KAAK,EACL,eAAe,EACf,cAAc,EACd,SAAS,EACT,OAAO,CAAC,WAAW;QACjB,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;QACzD,CAAC,CAAC,SAAS,CACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAkB,EAClB,eAA2D,EAC3D,cAAqD,EACrD,SAA2D,EAC3D,UAAgC,EAAE;IAElC,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC,YAAY,CAAC;IAClD,OAAO,sBAAsB,CAAC;QAC5B,GAAG,EAAE,KAAK,CAAC,UAAU;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,eAAe;QAC9B,gBAAgB,EAAE,cAAc,CAAC,UAAU;QAC3C,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/domains/agents/run/tool-draft-progress.d.ts

@@ -0,0 +1,47 @@
+import type { ConversationLiveToolDraftProgressSnapshot } from "@nervekit/shared";
+export type ToolDraftProgressToolName = "write" | "edit";
+/**
+ * Best-effort streaming scanner for write/edit JSON arguments. It deliberately
+ * tracks only metadata and counters; generated file contents and replacement
+ * text are never retained in full by this helper.
+ */
+export declare class ToolDraftProgressAccumulator {
+    private readonly toolName;
+    private inGenericString;
+    private genericString;
+    private genericEscaping;
+    private pendingString;
+    private awaitingValueFor;
+    private activeValue;
+    private closedPath;
+    private activePath;
+    private closedContentLineCount;
+    private activeContentMetric;
+    private oldTextCount;
+    private newTextCount;
+    private insertedTextCount;
+    private patchCount;
+    private closedOldTextLines;
+    private closedNewTextLines;
+    private closedInsertedTextLines;
+    private closedPatchAdditions;
+    private closedPatchDeletions;
+    private activeOldTextMetric;
+    private activeNewTextMetric;
+    private activeInsertedTextMetric;
+    private activePatchMetric;
+    private lastSignature;
+    constructor(toolName: ToolDraftProgressToolName);
+    push(delta: string): ConversationLiveToolDraftProgressSnapshot | undefined;
+    snapshot(): ConversationLiveToolDraftProgressSnapshot;
+    private processChar;
+    private processGenericStringChar;
+    private appendGenericStringChar;
+    private startTargetValue;
+    private processActiveValueChar;
+    private addActiveValueChar;
+    private finishActiveValue;
+}
+export declare function createToolDraftProgressAccumulator(toolName: string | undefined): ToolDraftProgressAccumulator | undefined;
+export declare function finalToolDraftProgress(toolName: string, args: Record<string, unknown>): ConversationLiveToolDraftProgressSnapshot | undefined;
+//# sourceMappingURL=tool-draft-progress.d.ts.map

package/dist/domains/agents/run/tool-draft-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-draft-progress.d.ts","sourceRoot":"","sources":["../../../../src/domains/agents/run/tool-draft-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,kBAAkB,CAAC;AAElF,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,MAAM,CAAC;AAgIzD;;;;GAIG;AACH,qBAAa,4BAA4B;IA2B3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA1BrC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,WAAW,CAA0B;IAE7C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,sBAAsB,CAAqB;IACnD,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,wBAAwB,CAAyB;IACzD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,aAAa,CAAqB;gBAEb,QAAQ,EAAE,yBAAyB;IAEhE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,yCAAyC,GAAG,SAAS;IAU1E,QAAQ,IAAI,yCAAyC;IA0CrD,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,wBAAwB;IAmBhC,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,iBAAiB;CAiC1B;AASD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,4BAA4B,GAAG,SAAS,CAK1C;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,yCAAyC,GAAG,SAAS,CA0BvD"}