human-to-code 0.1.12 → 0.1.13

package/dist/pipeline/agent-tui.js

@@ -0,0 +1,133 @@
+/** ANSI terminal dashboard for live deep-agent todos, activity, and diffs. */
+const ANSI = /\u001b\[[0-9;?]*[ -/]*[@-~]/gu;
+function visibleLength(value) {
+    return value.replace(ANSI, "").length;
+}
+function truncate(value, width) {
+    if (width < 2)
+        return "";
+    const plain = value.replace(ANSI, "");
+    if (plain.length <= width)
+        return value;
+    return `${plain.slice(0, width - 1)}…`;
+}
+function pad(value, width) {
+    const clipped = truncate(value, width);
+    return `${clipped}${" ".repeat(Math.max(0, width - visibleLength(clipped)))}`;
+}
+function wrap(value, width) {
+    if (width < 2)
+        return [""];
+    const clean = value.replaceAll("\t", "  ");
+    if (clean.length === 0)
+        return [""];
+    const result = [];
+    for (let offset = 0; offset < clean.length; offset += width)
+        result.push(clean.slice(offset, offset + width));
+    return result;
+}
+function todoLine(todo) {
+    const icon = todo.status === "completed" ? "✓" : todo.status === "in_progress" ? "●" : "○";
+    return `${icon} ${todo.content}`;
+}
+function colorActivity(line, color) {
+    if (!color)
+        return line;
+    if (line.startsWith("+"))
+        return `\u001b[32m${line}\u001b[0m`;
+    if (line.startsWith("-"))
+        return `\u001b[31m${line}\u001b[0m`;
+    if (line.startsWith("→") || line.startsWith("$"))
+        return `\u001b[36m${line}\u001b[0m`;
+    if (line.startsWith("!"))
+        return `\u001b[33m${line}\u001b[0m`;
+    return line;
+}
+export function renderAgentTui(state, width = 100, height = 30, color = true) {
+    const safeWidth = Math.max(50, width);
+    const safeHeight = Math.max(12, height);
+    const leftWidth = Math.max(22, Math.min(38, Math.floor(safeWidth * 0.34)));
+    const rightWidth = safeWidth - leftWidth - 3;
+    const bodyHeight = safeHeight - 4;
+    const todoRows = state.todos.length > 0 ? state.todos.flatMap((todo) => wrap(todoLine(todo), leftWidth)) : ["○ Waiting for plan"];
+    const activityRows = state.activity.flatMap((line) => wrap(line, rightWidth)).slice(-bodyHeight);
+    const top = `┌${"─".repeat(leftWidth + 1)}┬${"─".repeat(rightWidth + 1)}┐`;
+    const heading = `│ ${pad("TODOS", leftWidth)}│ ${pad("ACTIVITY / DIFF", rightWidth)}│`;
+    const divider = `├${"─".repeat(leftWidth + 1)}┼${"─".repeat(rightWidth + 1)}┤`;
+    const rows = [truncate(state.title, safeWidth), top, heading, divider];
+    for (let index = 0; index < bodyHeight; index++) {
+        const left = todoRows[index] ?? "";
+        const right = colorActivity(activityRows[index] ?? "", color);
+        rows.push(`│ ${pad(left, leftWidth)}│ ${pad(right, rightWidth)}│`);
+    }
+    rows.push(`└${"─".repeat(leftWidth + 1)}┴${"─".repeat(rightWidth + 1)}┘`);
+    return rows.join("\n");
+}
+function compactProgress(event) {
+    if (event.kind === "plan") {
+        const current = event.todos.find((todo) => todo.status === "in_progress");
+        if (current)
+            console.log(`  [~] ${current.content}`);
+        return;
+    }
+    if (event.kind === "tool")
+        console.log(`  → ${event.name}${event.detail ? ` ${event.detail}` : ""}`);
+    else if (event.kind === "output")
+        console.log(`  ${event.name}: ${event.text.split("\n")[0] ?? ""}`);
+    else if (event.kind === "diff") {
+        console.log(`  Δ ${event.path}`);
+        for (const line of event.lines.slice(0, 20))
+            console.log(`  ${line.kind === "add" ? "+" : line.kind === "remove" ? "-" : " "} ${line.text}`);
+    }
+}
+export function createAgentTerminal(title, stream = process.stdout) {
+    const interactive = stream.isTTY === true;
+    const state = { todos: [], activity: [], title };
+    let closed = false;
+    const render = () => {
+        if (!interactive || closed)
+            return;
+        stream.write(`\u001b[H\u001b[2J${renderAgentTui(state, stream.columns ?? 100, stream.rows ?? 30, true)}`);
+    };
+    const onResize = () => render();
+    if (interactive) {
+        stream.write("\u001b[?1049h\u001b[?25l");
+        stream.on("resize", onResize);
+        render();
+    }
+    return {
+        progress(event) {
+            if (!interactive) {
+                compactProgress(event);
+                return;
+            }
+            if (event.kind === "plan")
+                state.todos = event.todos.map((todo) => ({ ...todo }));
+            else if (event.kind === "tool")
+                state.activity.push(`→ ${event.name}${event.detail ? `  ${event.detail}` : ""}`);
+            else if (event.kind === "output") {
+                state.activity.push(`${event.name}:`);
+                state.activity.push(...event.text.split("\n").slice(-12).map((line) => `  ${line}`));
+            }
+            else if (event.kind === "diff") {
+                state.activity.push(`Δ ${event.path}`);
+                state.activity.push(...event.lines.map((line) => `${line.kind === "add" ? "+" : line.kind === "remove" ? "-" : " "} ${line.text}`));
+            }
+            else if (event.kind === "assistant")
+                state.activity.push(`✓ ${event.text}`);
+            if (state.activity.length > 500)
+                state.activity.splice(0, state.activity.length - 500);
+            render();
+        },
+        stop() {
+            if (closed)
+                return;
+            closed = true;
+            if (interactive) {
+                stream.off("resize", onResize);
+                stream.write(`\u001b[?25h\u001b[?1049l${renderAgentTui(state, stream.columns ?? 100, stream.rows ?? 30, true)}\n`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=agent-tui.js.map

package/dist/pipeline/agent-tui.js.map

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

package/dist/pipeline/deep-agent.d.ts

@@ -1,27 +1,7 @@
-/**
- * Deep-agent orchestration for the direct `npx human-to-code .` flow.
- *
- * This path runs a LangChain/LangGraph "deep agent" (via the `deepagents`
- * harness) with the four batteries-included pillars:
- *
- *   1. Planning     — the built-in `write_todos` tool decomposes the run.
- *   2. File System  — a real-disk `FilesystemBackend` rooted at the project
- *                     gives the agent `ls`/`read_file`/`write_file`/`edit_file`/
- *                     `glob`/`grep` over the working tree.
- *   3. Sub Agents   — a `planner`, `implementer`, and `reviewer` subagent are
- *                     reachable through the built-in `task` tool.
- *   4. Prompts      — a task-specific system prompt for the main agent and one
- *                     per subagent role.
- *
- * Unlike the deterministic guided pipeline, the model drives scope, file
- * reads/writes, and delegation here. The blast radius is bounded to the project
- * root by the backend and by deny-write filesystem permissions on sensitive
- * paths, but this is an autonomous agent, not a hash-verified patch pipeline.
- */
-import { type SubAgent } from "deepagents";
+/** Tool-rich, bounded agent orchestration for the direct conversion flow. */
 import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
-import type { ConversionUnit } from "./simple.ts";
-/** Provider identity and connection details for building a chat model. */
+import { type AgentDiffLine } from "./agent-tools.ts";
+import { type ConversionUnit } from "./simple.ts";
 export interface DeepAgentModelOptions {
     provider: string;
     model: string;
@@ -29,25 +9,19 @@ export interface DeepAgentModelOptions {
     apiKey?: string;
 }
 export interface DeepAgentRunOptions extends DeepAgentModelOptions {
-    /** Absolute project root; becomes the agent filesystem root. */
     root: string;
-    /** Operator-declared output language. */
     language: string;
-    /** Deterministically discovered worklist, seeded into the task prompt. */
     units: readonly ConversionUnit[];
-    /** Test/embedding seam: skip provider construction and use this model. */
     model_override?: BaseChatModel;
-    /** Hard cap on agent graph steps so a loop cannot run unbounded. */
     recursionLimit?: number;
-    /** Live progress sink for interactive output (planning, tool calls, delegation). */
     onProgress?: (event: DeepAgentProgress) => void;
     signal?: AbortSignal;
 }
 export interface DeepAgentTodo {
+    id?: string;
     content: string;
     status: string;
 }
-/** A live event emitted while the agent runs, for interactive rendering. */
 export type DeepAgentProgress = {
     kind: "plan";
     todos: DeepAgentTodo[];
@@ -55,188 +29,33 @@ export type DeepAgentProgress = {
     kind: "tool";
     name: string;
     detail?: string;
+} | {
+    kind: "output";
+    name: string;
+    text: string;
+} | {
+    kind: "diff";
+    path: string;
+    lines: AgentDiffLine[];
 } | {
     kind: "assistant";
     text: string;
 };
+export type DeepAgentStopReason = "model" | "worklist_complete";
 export interface DeepAgentRunResult {
-    /** Final plan the agent produced (the Planning pillar's output). */
     todos: DeepAgentTodo[];
-    /** Number of messages exchanged in the run. */
     messageCount: number;
-    /** The agent's final natural-language summary, if any. */
+    toolCount: number;
     summary: string;
+    stopReason: DeepAgentStopReason;
+}
+export declare class DeepAgentIncompleteError extends Error {
+    readonly code: "INCOMPLETE" | "TOOL_LOOP" | "STEP_LIMIT";
+    constructor(code: DeepAgentIncompleteError["code"], message: string);
 }
-/**
- * Construct a LangChain chat model for the configured provider.
- *
- * Both providers use the OpenAI-compatible chat client. Ollama is reached
- * through its `/v1` endpoint rather than `@langchain/ollama`'s native
- * `/api/chat`: the deep-agent harness emits tool messages with structured
- * (array) content, which the native Ollama adapter rejects, whereas the
- * OpenAI-compatible surface serializes them correctly.
- */
+export declare const AGENT_TOOL_NAMES: readonly string[];
+export declare function agentSystemPrompt(languageLabel: string): string;
 export declare function buildDeepAgentModel(options: DeepAgentModelOptions): Promise<BaseChatModel>;
-/**
- * Build (but do not run) the deep agent. Exposed so callers and tests can
- * inspect wiring without a live provider.
- */
-export declare function buildDeepAgent(options: DeepAgentRunOptions): Promise<import("deepagents").DeepAgent<import("deepagents").DeepAgentTypeConfig<import("langchain").ResponseFormatUndefined, undefined, import("@langchain/core/utils/types").InteropZodObject, readonly [import("langchain").AgentMiddleware<import("zod/v3").ZodObject<{
-    todos: import("zod/v3").ZodDefault<import("zod/v3").ZodArray<import("zod/v3").ZodObject<{
-        content: import("zod/v3").ZodString;
-        status: import("zod/v3").ZodEnum<["pending", "in_progress", "completed"]>;
-    }, "strip", import("zod/v3").ZodTypeAny, {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }, {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }>, "many">>;
-}, "strip", import("zod/v3").ZodTypeAny, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-}, {
-    todos?: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[] | undefined;
-}>, undefined, unknown, readonly [import("langchain").DynamicStructuredTool<import("zod/v3").ZodObject<{
-    todos: import("zod/v3").ZodArray<import("zod/v3").ZodObject<{
-        content: import("zod/v3").ZodString;
-        status: import("zod/v3").ZodEnum<["pending", "in_progress", "completed"]>;
-    }, "strip", import("zod/v3").ZodTypeAny, {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }, {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }>, "many">;
-}, "strip", import("zod/v3").ZodTypeAny, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-}, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-}>, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-}, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-}, import("@langchain/langgraph").Command<unknown, {
-    todos: {
-        content: string;
-        status: "completed" | "in_progress" | "pending";
-    }[];
-    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
-}, string>, unknown, "write_todos">], readonly []>, import("langchain").AgentMiddleware<import("@langchain/langgraph").StateSchema<{
-    files: import("@langchain/langgraph").ReducedValue<{
-        [x: string]: import("deepagents").FileData;
-    } | undefined, {
-        [x: string]: import("deepagents").FileData | null;
-    } | undefined>;
-}>, undefined, unknown, (import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
-    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
-}, import("zod/v4/core").$strip>, {
-    path: string;
-}, {
-    path?: string | undefined;
-}, string, unknown, "ls"> | import("langchain").DynamicStructuredTool<import("zod").ZodPreprocess<import("zod").ZodObject<{
-    file_path: import("zod").ZodString;
-    offset: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodCoercedNumber<unknown>>>;
-    limit: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodCoercedNumber<unknown>>>;
-}, import("zod/v4/core").$strip>>, {
-    file_path: string;
-    offset: number;
-    limit: number;
-}, unknown, {
-    type: string;
-    text: string;
-}[] | {
-    type: string;
-    mimeType: string;
-    data: string;
-}[], unknown, "read_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodPreprocess<import("zod").ZodObject<{
-    file_path: import("zod").ZodString;
-    content: import("zod").ZodDefault<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>>, {
-    file_path: string;
-    content: string;
-}, unknown, string | import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>> | import("@langchain/langgraph").Command<unknown, {
-    files: Record<string, import("deepagents").FileData>;
-    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
-}, string>, unknown, "write_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodPreprocess<import("zod").ZodObject<{
-    file_path: import("zod").ZodString;
-    old_string: import("zod").ZodString;
-    new_string: import("zod").ZodString;
-    replace_all: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
-}, import("zod/v4/core").$strip>>, {
-    file_path: string;
-    old_string: string;
-    new_string: string;
-    replace_all: boolean;
-}, unknown, string | import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>> | import("@langchain/langgraph").Command<unknown, {
-    files: Record<string, import("deepagents").FileData>;
-    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
-}, string>, unknown, "edit_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
-    pattern: import("zod").ZodString;
-    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
-}, import("zod/v4/core").$strip>, {
-    pattern: string;
-    path: string;
-}, {
-    pattern: string;
-    path?: string | undefined;
-}, string, unknown, "glob"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
-    pattern: import("zod").ZodString;
-    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
-    glob: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>>;
-}, import("zod/v4/core").$strip>, {
-    pattern: string;
-    path: string;
-    glob: string | null;
-}, {
-    pattern: string;
-    path?: string | undefined;
-    glob?: string | null | undefined;
-}, string, unknown, "grep"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
-    command: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, {
-    command: string;
-}, {
-    command: string;
-}, string, unknown, "execute">)[], readonly []>, import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly [import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
-    description: import("zod").ZodString;
-    subagent_type: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, {
-    description: string;
-    subagent_type: string;
-}, {
-    description: string;
-    subagent_type: string;
-}, string | import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>, unknown, "task">], readonly []>, import("langchain").AgentMiddleware<import("zod").ZodObject<{
-    _summarizationSessionId: import("zod").ZodOptional<import("zod").ZodString>;
-    _summarizationEvent: import("zod").ZodOptional<import("zod").ZodObject<{
-        cutoffIndex: import("zod").ZodNumber;
-        summaryMessage: import("zod").ZodCustom<import("langchain").HumanMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>, import("langchain").HumanMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>>;
-        filePath: import("zod").ZodNullable<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly []>, import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly []>, ...import("langchain").AgentMiddleware<any, any, any, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly (() => import("@langchain/langgraph").StreamTransformer<any>)[]>[]], readonly [], readonly [SubAgent, SubAgent, SubAgent], readonly []>>>;
-/**
- * Run the deep agent against the discovered worklist, streaming live progress
- * (planning, tool calls, delegation) through `onProgress`. The agent edits
- * files on disk through its filesystem backend; this returns the final plan and
- * summary it produced for the report.
- */
+export declare function buildDeepAgent(options: DeepAgentRunOptions): Promise<import("langchain").ReactAgent<import("langchain").AgentTypeConfig<Record<string, any>, import("@langchain/langgraph").StateDefinitionInit | undefined, import("@langchain/core/utils/types").InteropZodObject | import("langchain").AnyAnnotationRoot, readonly import("langchain").AnyAgentMiddleware[], readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly (() => import("@langchain/langgraph").StreamTransformer<any>)[]>>>;
 export declare function runDeepAgentConversion(options: DeepAgentRunOptions): Promise<DeepAgentRunResult>;
 //# sourceMappingURL=deep-agent.d.ts.map

package/dist/pipeline/deep-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-agent.d.ts","sourceRoot":"","sources":["../../src/pipeline/deep-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAmHD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBhG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gpBAchE;AAoCD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2DtG"}
+{"version":3,"file":"deep-agent.d.ts","sourceRoot":"","sources":["../../src/pipeline/deep-agent.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAK7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;gBAE7C,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAKpE;AAED,eAAO,MAAM,gBAAgB,mBAAiD,CAAC;AAE/E,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA8B/D;AA+BD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAsBhG;AAkGD,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB,weAEhE;AAgGD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8GtG"}