@nac3/forge-cli 0.2.0-alpha.1

package/dist/chat/tools/reader.js

@@ -0,0 +1,471 @@
+/**
+ * Reader chat tools (V1.28 of HITO 1).
+ *
+ * Exposes the reader subsystem (V1.14+) to the chat catalog.
+ * Single shared session map at module scope so the user can
+ * open a doc in one chat turn and continue navigating it in
+ * the next.
+ *
+ * Tools:
+ *   forge.reader.open(path)
+ *   forge.reader.list_documents()
+ *   forge.reader.read_section(doc_id, index?)
+ *   forge.reader.next_block(doc_id)
+ *   forge.reader.search(doc_id, query, max?)
+ *   forge.reader.bookmark_set(doc_id, name)
+ *   forge.reader.bookmark_jump(doc_id, name)
+ *   forge.reader.recap(doc_id, window?)
+ *
+ * All read-only (requires_approval=false). The reader does
+ * not write to the project; it parses + remembers state +
+ * answers queries.
+ *
+ * Loud failures per ROADMAP sec 12.2.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { parseDocument } from '../../reader/registry.js';
+import { startSession, advanceCursor, setBookmark, jumpToBookmark, getBlock, seekSectionByIndex, recordSpoken, } from '../../reader/state.js';
+import { searchDocument } from '../../reader/search.js';
+import { isText } from '../../reader/state.js';
+/** Shared session map at module scope. */
+const SESSIONS = new Map();
+let _recapSummarizer = null;
+export function setRecapSummarizer(impl) {
+    _recapSummarizer = impl;
+}
+/** Test seam. */
+export function _resetReaderForTests() {
+    SESSIONS.clear();
+    _recapSummarizer = null;
+}
+/* ============================================================
+ * Specs
+ * ============================================================ */
+export const READER_OPEN_SPEC = {
+    name: 'forge.reader.open',
+    description: 'Open a document for reading. Auto-detects format (txt / md / source / ...). Returns the doc_id + title + section count + first block.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the document. Relative to projectRoot or absolute.' },
+        },
+        required: ['path'],
+    },
+    requires_approval: false,
+};
+export const READER_LIST_DOCS_SPEC = {
+    name: 'forge.reader.list_documents',
+    description: 'List all documents currently open in this chat session.',
+    input_schema: { type: 'object', properties: {}, required: [] },
+    requires_approval: false,
+};
+export const READER_READ_SECTION_SPEC = {
+    name: 'forge.reader.read_section',
+    description: 'Return the blocks of a section. With no index, returns the current section under the cursor.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string', description: 'Document id returned by forge.reader.open.' },
+            index: { type: 'number', description: 'Optional 0-based section index. Default: current section.' },
+        },
+        required: ['doc_id'],
+    },
+    requires_approval: false,
+};
+export const READER_NEXT_BLOCK_SPEC = {
+    name: 'forge.reader.next_block',
+    description: 'Advance the reader cursor one block forward. Returns the new block contents.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string' },
+        },
+        required: ['doc_id'],
+    },
+    requires_approval: false,
+};
+export const READER_SEARCH_SPEC = {
+    name: 'forge.reader.search',
+    description: 'Full-text search across a document. Returns top hits sorted by match count.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string' },
+            query: { type: 'string' },
+            max: { type: 'number', description: 'Max hits. Default 20, max 100.' },
+        },
+        required: ['doc_id', 'query'],
+    },
+    requires_approval: false,
+};
+export const READER_BOOKMARK_SET_SPEC = {
+    name: 'forge.reader.bookmark_set',
+    description: 'Set a named bookmark at the current cursor position.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string' },
+            name: { type: 'string', description: 'Bookmark name (lowercase + digits + _ -). Must start with a letter.' },
+        },
+        required: ['doc_id', 'name'],
+    },
+    requires_approval: false,
+};
+export const READER_BOOKMARK_JUMP_SPEC = {
+    name: 'forge.reader.bookmark_jump',
+    description: 'Jump the cursor to a previously-set bookmark.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string' },
+            name: { type: 'string' },
+        },
+        required: ['doc_id', 'name'],
+    },
+    requires_approval: false,
+};
+export const READER_RECAP_SPEC = {
+    name: 'forge.reader.recap',
+    description: 'Return the last N spoken blocks from the reader playback buffer. Default window 10. mode="summary" returns a Claude-generated 1-2 sentence summary instead of literal blocks (charges tokens; gated by env YF_ENABLE_CLAUDE_RECAP=1).',
+    input_schema: {
+        type: 'object',
+        properties: {
+            doc_id: { type: 'string' },
+            window: { type: 'number', description: 'How many recent blocks to include. Default 10, max 60.' },
+            mode: { type: 'string', enum: ['literal', 'summary'], description: 'literal (default) returns the blocks verbatim; summary calls Claude to compress into 1-2 sentences. summary costs tokens.' },
+        },
+        required: ['doc_id'],
+    },
+    requires_approval: false,
+};
+/* ============================================================
+ * Implementations
+ * ============================================================ */
+function getSession(docId) {
+    const s = SESSIONS.get(docId);
+    if (!s)
+        throw new Error('reader: no open document with id ' + docId + ' -- call forge.reader.open first');
+    return s;
+}
+export async function runReaderOpen(args, ctx) {
+    if (typeof args.path !== 'string' || args.path.trim() === '') {
+        return { tool: READER_OPEN_SPEC.name, result: { error: 'path is required and must be a non-empty string' }, is_error: true, display: 'no path' };
+    }
+    const abs = path.isAbsolute(args.path) ? args.path : path.join(ctx.projectRoot, args.path);
+    let buffer;
+    try {
+        buffer = await fs.readFile(abs);
+    }
+    catch (err) {
+        return { tool: READER_OPEN_SPEC.name, result: { error: 'could not read file: ' + (err instanceof Error ? err.message : String(err)) }, is_error: true, display: 'read failed' };
+    }
+    const filename = path.basename(abs);
+    let doc;
+    try {
+        doc = await parseDocument({ filename, buffer });
+    }
+    catch (err) {
+        return { tool: READER_OPEN_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'parse failed' };
+    }
+    const session = startSession(doc);
+    SESSIONS.set(doc.id, session);
+    /* First text block contents for immediate playback by the
+       caller. */
+    let firstText = '';
+    if (session.cursor_block_id) {
+        try {
+            const b = getBlock(doc, session.cursor_block_id);
+            if (isText(b))
+                firstText = b.text;
+        }
+        catch { /* empty doc */ }
+    }
+    return {
+        tool: READER_OPEN_SPEC.name,
+        result: {
+            doc_id: doc.id,
+            filename: doc.filename,
+            format: doc.format,
+            title: doc.title,
+            sections: doc.sections.length,
+            cursor_block_id: session.cursor_block_id,
+            first_text: firstText,
+        },
+        display: 'opened ' + doc.filename + ' (' + doc.sections.length + ' section(s))',
+    };
+}
+export async function runReaderListDocuments() {
+    const entries = Array.from(SESSIONS.values()).map((s) => ({
+        doc_id: s.doc.id,
+        filename: s.doc.filename,
+        format: s.doc.format,
+        title: s.doc.title,
+        sections: s.doc.sections.length,
+        cursor_block_id: s.cursor_block_id,
+        state: s.state,
+    }));
+    return {
+        tool: READER_LIST_DOCS_SPEC.name,
+        result: { documents: entries },
+        display: entries.length + ' document(s) open',
+    };
+}
+export async function runReaderReadSection(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_READ_SECTION_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    let sectionIndex;
+    if (typeof args.index === 'number') {
+        if (args.index < 0 || args.index >= session.doc.sections.length) {
+            return { tool: READER_READ_SECTION_SPEC.name, result: { error: 'section index out of range: ' + args.index }, is_error: true, display: 'bad index' };
+        }
+        sectionIndex = args.index;
+        seekSectionByIndex(session, sectionIndex);
+    }
+    else {
+        /* Find the section that contains the current cursor. */
+        const cursorBlock = session.cursor_block_id;
+        sectionIndex = session.doc.sections.findIndex((sec) => sec.blocks.some((b) => b.id === cursorBlock));
+        if (sectionIndex < 0)
+            sectionIndex = 0;
+    }
+    const sec = session.doc.sections[sectionIndex];
+    return {
+        tool: READER_READ_SECTION_SPEC.name,
+        result: {
+            doc_id: args.doc_id,
+            section_index: sectionIndex,
+            heading: sec.heading,
+            level: sec.level,
+            blocks: sec.blocks.map((b) => ({
+                id: b.id,
+                kind: b.kind,
+                ...(isText(b) ? { text: b.text } : { summary: b.summary, content: b.content }),
+            })),
+        },
+        display: 'read section ' + sectionIndex + ': ' + (sec.heading || '(no heading)'),
+    };
+}
+export async function runReaderNextBlock(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_NEXT_BLOCK_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    const next = advanceCursor(session);
+    if (!next) {
+        return {
+            tool: READER_NEXT_BLOCK_SPEC.name,
+            result: { doc_id: args.doc_id, at_end: true },
+            display: 'end of document',
+        };
+    }
+    const block = getBlock(session.doc, next);
+    if (isText(block)) {
+        recordSpoken(session, block.text);
+        return {
+            tool: READER_NEXT_BLOCK_SPEC.name,
+            result: {
+                doc_id: args.doc_id,
+                block_id: block.id,
+                kind: block.kind,
+                text: block.text,
+                at_end: false,
+            },
+            display: 'next: ' + block.text.slice(0, 60),
+        };
+    }
+    return {
+        tool: READER_NEXT_BLOCK_SPEC.name,
+        result: {
+            doc_id: args.doc_id,
+            block_id: block.id,
+            kind: block.kind,
+            summary: block.summary,
+            at_end: false,
+        },
+        display: 'next (non-text): ' + block.summary,
+    };
+}
+export async function runReaderSearch(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_SEARCH_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    if (typeof args.query !== 'string' || args.query.trim() === '') {
+        return { tool: READER_SEARCH_SPEC.name, result: { error: 'query is required and must be non-empty' }, is_error: true, display: 'no query' };
+    }
+    const hits = searchDocument(session.doc, args.query, args.max !== undefined ? { max: args.max } : {});
+    return {
+        tool: READER_SEARCH_SPEC.name,
+        result: { doc_id: args.doc_id, query: args.query, hits },
+        display: 'found ' + hits.length + ' hit(s) for "' + args.query.slice(0, 40) + '"',
+    };
+}
+export async function runReaderBookmarkSet(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_BOOKMARK_SET_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    try {
+        setBookmark(session, args.name);
+    }
+    catch (err) {
+        return { tool: READER_BOOKMARK_SET_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'bad name' };
+    }
+    return {
+        tool: READER_BOOKMARK_SET_SPEC.name,
+        result: { doc_id: args.doc_id, name: args.name, at_block: session.cursor_block_id },
+        display: 'bookmarked ' + args.name + ' at ' + session.cursor_block_id,
+    };
+}
+export async function runReaderBookmarkJump(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_BOOKMARK_JUMP_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    const r = jumpToBookmark(session, args.name);
+    if (!r.ok) {
+        return { tool: READER_BOOKMARK_JUMP_SPEC.name, result: { error: r.reason ?? 'unknown' }, is_error: true, display: 'no bookmark' };
+    }
+    return {
+        tool: READER_BOOKMARK_JUMP_SPEC.name,
+        result: { doc_id: args.doc_id, name: args.name, cursor_block_id: r.new_cursor },
+        display: 'jumped to ' + args.name,
+    };
+}
+/** V1.26 polish -- join recap blocks into a single TTS-friendly
+ *  narrative string. Each block ends with a sentence terminator
+ *  so the chunker (V1.24) splits cleanly at block boundaries.
+ *  Blocks already ending in terminal punctuation are left
+ *  alone; bare blocks get a trailing period. */
+function _buildRecapNarrative(blocks) {
+    if (blocks.length === 0)
+        return '';
+    return blocks
+        .map((b) => {
+        const t = b.trim();
+        if (!t)
+            return '';
+        if (/[.!?;:]$/.test(t))
+            return t;
+        return t + '.';
+    })
+        .filter((s) => s)
+        .join(' ');
+}
+export async function runReaderRecap(args) {
+    let session;
+    try {
+        session = getSession(args.doc_id);
+    }
+    catch (err) {
+        return { tool: READER_RECAP_SPEC.name, result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'no doc' };
+    }
+    let window = args.window;
+    if (typeof window !== 'number' || !Number.isFinite(window) || window < 1)
+        window = 10;
+    if (window > 60)
+        window = 60;
+    const tail = session.recent_spoken.slice(-window);
+    const narrative = _buildRecapNarrative(tail);
+    const mode = args.mode === 'summary' ? 'summary' : 'literal';
+    /* V1.26b -- Claude-summarised recap (opt-in, costs tokens).
+       Two gates:
+       1. env var YF_ENABLE_CLAUDE_RECAP must be set to '1'.
+       2. A summariser must be installed via setRecapSummarizer
+          (the chat server installs it at boot when a Claude
+          client is available).
+       Either gate failing returns a loud error explaining how
+       to enable -- no silent degradation. */
+    if (mode === 'summary') {
+        if (process.env['YF_ENABLE_CLAUDE_RECAP'] !== '1') {
+            return {
+                tool: READER_RECAP_SPEC.name,
+                result: {
+                    error: 'summary mode requires YF_ENABLE_CLAUDE_RECAP=1 in env. This mode calls Claude on every recap and charges tokens; see docs/RECAP_CLAUDE_COSTS.md before enabling.',
+                },
+                is_error: true,
+                display: 'summary disabled by env',
+            };
+        }
+        if (!_recapSummarizer) {
+            return {
+                tool: READER_RECAP_SPEC.name,
+                result: {
+                    error: 'summary mode requires a Claude summariser installed via setRecapSummarizer. The chat server installs it when CLAUDE_API_KEY is in the vault.',
+                },
+                is_error: true,
+                display: 'summary not installed',
+            };
+        }
+        if (tail.length === 0) {
+            return {
+                tool: READER_RECAP_SPEC.name,
+                result: { doc_id: args.doc_id, window, blocks: [], text: '', narrative: '', summary: '', mode },
+                display: 'recap: nothing to summarise',
+            };
+        }
+        let summary;
+        try {
+            const langOpt = session.doc.language ? { language: session.doc.language } : {};
+            summary = await _recapSummarizer(tail, langOpt);
+        }
+        catch (err) {
+            return {
+                tool: READER_RECAP_SPEC.name,
+                result: { error: 'summary call failed: ' + (err instanceof Error ? err.message : String(err)) },
+                is_error: true,
+                display: 'summary failed',
+            };
+        }
+        return {
+            tool: READER_RECAP_SPEC.name,
+            result: {
+                doc_id: args.doc_id,
+                window,
+                blocks: tail,
+                text: summary,
+                narrative,
+                summary,
+                mode,
+            },
+            display: 'recap (summary): ' + tail.length + ' block(s)',
+        };
+    }
+    return {
+        tool: READER_RECAP_SPEC.name,
+        result: {
+            doc_id: args.doc_id,
+            window,
+            blocks: tail,
+            /* V1.26 -- joined narrative for voice playback. Clients
+               that read .text first (V1.32 dispatcher) get a single
+               smooth read of the recent context. Clients that prefer
+               the structured list still have .blocks. */
+            text: narrative,
+            narrative,
+            mode,
+        },
+        display: 'recap: ' + tail.length + ' recent block(s)',
+    };
+}
+//# sourceMappingURL=reader.js.map

package/dist/chat/tools/reader.js.map

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

package/dist/chat/tools.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Yujin Forge -- chat tool catalog.
+ *
+ * The chat panel exposes a set of `forge.*` tools that Claude can
+ * call via Anthropic's tool_use protocol. Each tool has:
+ *
+ *   - A JSON-schema description Claude consumes.
+ *   - A pure implementation that takes the tool args + the chat
+ *     context (project root + license state) and returns a
+ *     serialisable result.
+ *   - A `requires_approval` flag. Read-only tools auto-execute;
+ *     write-class tools queue an approval request in the chat UI.
+ *
+ * Tonight's slice (v0.3.0 differentiator, foundation only):
+ *
+ *   - `forge.read_manifest` -- read manifest.json from the project
+ *     root and return the elements array (or a slice when the LLM
+ *     asks for a specific plugin slug).
+ *
+ * Pending slices (not in this commit):
+ *   - `forge.write_component(path, source)` -- write-class, approval
+ *     gated.
+ *   - `forge.run_tests(pattern)` -- exec `npm test -- <pattern>`.
+ *   - `forge.run_migration_step(step_id)` -- atomic AST mutation.
+ *   - `forge.consult_nac_spec(query)` -- RAG over docs/SPEC.md.
+ *   - Wire into ClaudeClient's chat() via tool_use payload.
+ *   - Approval-flow UI in src/chat/panel.ts.
+ *
+ * Pure: no Anthropic call, no UI dependency. Easy to unit-test.
+ *
+ * ASCII-only.
+ */
+/** JSON schema shape Anthropic expects for tool_use. */
+export interface ToolSpec {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description?: string;
+            enum?: readonly string[] | string[];
+        }>;
+        required: string[];
+    };
+    /** Forge-internal flag the chat UI consults before invoking. */
+    requires_approval: boolean;
+}
+export interface ToolContext {
+    /** Absolute project root the chat is anchored at. */
+    projectRoot: string;
+}
+export interface ToolResult {
+    /** Tool name that produced this result (kept for the audit log). */
+    tool: string;
+    /** Either parsed structured data or a free-text fallback. */
+    result: unknown;
+    /** True when the tool ran but failed gracefully (e.g. manifest
+        not found). The chat surfaces these to the model as
+        structured errors instead of crashes. */
+    is_error?: boolean;
+    /** Human-readable message for the action trace. */
+    display?: string;
+}
+export declare const READ_MANIFEST_SPEC: ToolSpec;
+export declare function runReadManifest(args: {
+    plugin_slug?: string;
+}, ctx: ToolContext): Promise<ToolResult>;
+export declare const CONSULT_NAC_SPEC: ToolSpec;
+export interface SpecHit {
+    /** Nearest H1/H2/H3 heading above the matched paragraph. */
+    heading: string;
+    /** First ~240 chars of the matched paragraph. */
+    snippet: string;
+    /** Position score (higher = better lexical match). */
+    score: number;
+}
+export declare function runConsultNacSpec(args: {
+    query: string;
+    max_results?: number;
+}, ctx: ToolContext): Promise<ToolResult>;
+/** Split markdown body into (heading, paragraph) pairs, score
+ *  each paragraph against the query, return top-N hits. Pure +
+ *  exported for tests. */
+export declare function searchSpec(body: string, query: string, max?: number): SpecHit[];
+export declare const LIST_FILES_SPEC: ToolSpec;
+export declare function runListFiles(args: {
+    subdir?: string;
+    glob?: string;
+    max_files?: number;
+}, ctx: ToolContext): Promise<ToolResult>;
+/** Compile a glob like "*.tsx" / "App.*" into a basename matcher.
+ *  Only handles "*" and "?" -- enough for the common adopter case
+ *  and keeps the implementation dependency-free.
+ *  Exported for tests. */
+export declare function compileBasenameGlob(glob: string | undefined): ((name: string) => boolean) | null;
+export declare const READ_FILE_SPEC: ToolSpec;
+export declare function runReadFile(args: {
+    path: string;
+    max_bytes?: number;
+}, ctx: ToolContext): Promise<ToolResult>;
+export declare const FORGE_TOOL_SPECS: ToolSpec[];
+/** Dispatch a tool by name with the args Anthropic returned. Returns
+ *  a ToolResult ready to be serialised into a tool_result block. */
+export declare function runForgeTool(name: string, args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/chat/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/chat/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAqDH,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACxG,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB;;gDAE4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,kBAAkB,EAAE,QAchC,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C3G;AAMD,eAAO,MAAM,gBAAgB,EAAE,QAkB9B,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAmDrB;AAED;;0BAE0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,EAAE,CAkClF;AAoBD,eAAO,MAAM,eAAe,EAAE,QAsB7B,CAAC;AAOF,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAkErB;AASD;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAUhG;AAMD,eAAO,MAAM,cAAc,EAAE,QAkB5B,CAAC;AAKF,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAiGrB;AAaD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,EAqCtC,CAAC;AAEF;oEACoE;AACpE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAwDrB"}