@tenphi/akno 0.1.0

package/dist/commands/serve-cmd.js

@@ -0,0 +1,415 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { open } from '@tenphi/akno-core';
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, kv, line, ms, style, warn } from "../output.js";
+import { serveSocket } from "../serve/socket.js";
+import { serveHttp } from "../serve/http.js";
+import { serveMcp } from "../serve/mcp.js";
+import { resolveOps } from "../ops-handle.js";
+import { AknoError } from '@tenphi/akno-protocol';
+import { DREAM_HEALTH_LABEL, DREAM_SCHEDULE_LABEL } from "./dream-schedule.js";
+const SERVE_HELP = `akno serve [options]
+
+  Hold the index, the watcher and the model connections in one long-lived
+  process. Spawning a process per memory call costs 33ms against 0.04ms for a
+  long-lived handle — an 800x difference, and none of it is the database.
+
+  --mcp                     stdio MCP, for any agent that speaks it. Logs go to
+                            stderr because stdout is the protocol.
+  --http <host:port>        Loopback HTTP, for agents in containers or on another
+                            host. No auth of its own — put it behind one.
+  --socket <path>           Override the unix socket path.
+  --no-watch                Do not watch the knowledge base.
+  --index-on-start          Reconcile before accepting connections.
+  --allow <op,...>          Restrict which ops this door exposes.`;
+export async function serveCommand(argv) {
+    const { values } = parse(argv, {
+        mcp: { type: 'boolean', default: false },
+        http: { type: 'string' },
+        socket: { type: 'string' },
+        watch: { type: 'boolean', default: true },
+        'index-on-start': { type: 'boolean', default: false },
+        allow: { type: 'string' },
+    });
+    if (values.help) {
+        line(SERVE_HELP);
+        return 0;
+    }
+    // stdout belongs to the MCP protocol. Anything written there corrupts the
+    // stream, so every log line goes to stderr in that mode.
+    const isMcp = values.mcp;
+    const log = (message) => {
+        const stamp = new Date().toISOString().slice(11, 19);
+        process.stderr.write(`${style.grey(stamp)} ${message}\n`);
+    };
+    // A second door in front of the service that already holds the write handle, rather than a
+    // second Akno. Opening the index here would give this process a read-only handle — the MCP
+    // tools would all be present and every write would fail, which is the worst of both. The
+    // service owns the index, the watcher and the models; this is stdio translated onto its socket.
+    //
+    // Only for `--mcp`: the socket door *is* the service, so serving it this way would be a
+    // process forwarding to itself.
+    if (isMcp) {
+        const forwarded = await serveMcpThroughService(values, log);
+        if (forwarded !== null)
+            return forwarded;
+    }
+    const mem = await open({
+        ...openOptionsFrom(values),
+        // A service start is nearly always a restart, and the outgoing process is usually still closing
+        // its database when this one opens. Without a wait, the replacement comes up read-only and stays
+        // that way — refusing every write for its whole life, naming a pid that has already exited.
+        writeLockWaitMs: 10_000,
+        watch: values.watch,
+        watchEvents: {
+            onIndexed: (report, changed) => {
+                if (report.pagesIndexed === 0 && report.pagesRemoved === 0 && report.pagesRenamed === 0)
+                    return;
+                const what = changed.length > 0 && changed.length <= 3 ? changed.join(', ') : `${report.pagesIndexed} pages`;
+                log(`indexed ${what} in ${ms(report.durationMs)}` +
+                    `${report.pagesRenamed > 0 ? ` (${report.pagesRenamed} renamed)` : ''}` +
+                    `${report.pagesRemoved > 0 ? ` (${report.pagesRemoved} removed)` : ''}`);
+                for (const warning of report.warnings.slice(0, 3))
+                    log(style.yellow(`  ${warning}`));
+            },
+            onError: (error) => log(style.red(`watcher: ${error.message}`)),
+        },
+    });
+    if (!mem.writable) {
+        warn(`pid ${mem.lockHeldBy} holds the write handle. This instance is read-only: it will serve ` +
+            'reads but will not index or watch. Do not run two Aknos against one knowledge base.');
+        // Read-only is decided once, when the database is opened, and the connection itself is opened
+        // that way — so a service that lost the race cannot promote itself in place. It can notice that
+        // the holder is gone and stand down, which under a supervisor means coming straight back with
+        // the handle. Without that, losing a restart race by a second costs every write until somebody
+        // notices, which on this install was hours of refusals naming a pid that had long exited.
+        watchForAReleasedHandle(mem.lockHeldBy, log);
+    }
+    const allow = values.allow
+        ? values.allow.split(',').map((op) => op.trim())
+        : isMcp
+            ? mem.config.server.mcpAllow
+            : undefined;
+    if (values['index-on-start'] && mem.writable) {
+        const report = await mem.index({});
+        log(`startup index: ${report.pagesIndexed} indexed, ${report.pagesUnchanged} unchanged in ${ms(report.durationMs)}`);
+    }
+    const closers = [];
+    try {
+        if (isMcp) {
+            const server = await serveMcp(mem, { ...(allow ? { allow } : {}), log });
+            closers.push(() => server.close());
+            log(`MCP ready over stdio — ${(allow ?? []).length || 'all'} ops, ${mem.config.aknoPath}`);
+        }
+        else {
+            const socketPath = values.socket ? path.resolve(values.socket) : mem.config.socketPath;
+            const socket = await serveSocket(mem, socketPath, { ...(allow ? { allow } : {}), log });
+            closers.push(() => socket.close());
+            heading('Akno serving');
+            kv([
+                ['knowledge base', mem.config.aknoPath],
+                ['socket', socket.path],
+                ['watching', values.watch && mem.writable ? 'yes' : 'no'],
+                ['writable', mem.writable ? 'yes' : `no (pid ${mem.lockHeldBy})`],
+            ]);
+        }
+        const httpAddress = values.http ?? mem.config.server.http;
+        if (httpAddress) {
+            const server = await serveHttp(mem, httpAddress, { ...(allow ? { allow } : {}), log });
+            closers.push(() => server.close());
+            const [host] = server.address.split(':');
+            if (host !== '127.0.0.1' && host !== 'localhost') {
+                warn(`the HTTP door is bound to ${server.address}, not loopback. It has no authentication of ` +
+                    'its own — anything that can reach that address can read your knowledge base.');
+            }
+            log(`HTTP ready on ${server.address}`);
+        }
+        // `KeepAlive` under launchd means the service outlives every host that
+        // talks to it, which is the whole point of running it separately. Shutting
+        // down cleanly is what makes a restart cost 3ms instead of a WAL replay.
+        await waitForShutdown(log, { onStdinEnd: isMcp });
+        return 0;
+    }
+    finally {
+        for (const close of closers)
+            await close().catch(() => { });
+        await mem.close();
+    }
+}
+/**
+ * Serves MCP over an existing service, or returns null when there is none to serve over.
+ *
+ * `--connect` turns "there is no service" into an error instead, for a host that would rather
+ * fail loudly at spawn than quietly get a second Akno it did not ask for.
+ */
+async function serveMcpThroughService(values, log) {
+    const handle = await resolveOps({ ...values, json: true }, openOptionsFrom(values));
+    if (handle.via !== 'socket') {
+        await handle.close();
+        return null;
+    }
+    // The service's own `mcp_allow` cannot be read through the socket, so an explicit `--allow`
+    // is the only narrowing available here. Saying so beats a door that is quietly wider than
+    // the operator believes: the socket door they connected to has its own allow list, and this
+    // one inherits nothing from it.
+    const allow = values.allow?.split(',').map((op) => op.trim());
+    const server = await serveMcp(handle.ops, { ...(allow ? { allow } : {}), log });
+    log(`MCP ready over stdio — ${allow ? `${allow.length} ops` : 'all ops'}, through the running service`);
+    try {
+        await waitForShutdown(log, { onStdinEnd: true });
+        return 0;
+    }
+    finally {
+        await server.close();
+        await handle.close();
+    }
+}
+function waitForShutdown(log, options = {}) {
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = (signal) => {
+            if (done)
+                return;
+            done = true;
+            log(`${signal} — shutting down`);
+            resolve();
+        };
+        process.once('SIGINT', () => finish('SIGINT'));
+        process.once('SIGTERM', () => finish('SIGTERM'));
+        // launchd sends SIGHUP on a `launchctl kickstart -k`.
+        process.once('SIGHUP', () => finish('SIGHUP'));
+        // An MCP server is a child of the agent that spawned it, and stdio is the whole
+        // relationship: when that pipe closes the client is gone and there is nobody left to serve.
+        // Waiting for a signal instead leaves a process per spawn holding a socket connection.
+        if (options.onStdinEnd) {
+            process.stdin.once('end', () => finish('stdin closed'));
+            process.stdin.once('close', () => finish('stdin closed'));
+            process.stdin.resume();
+        }
+    });
+}
+const SERVICE_HELP = `akno service <install | uninstall | status> [options]
+
+  Manage the macOS launchd user agents, so nobody hand-edits XML.
+
+    dev.akno        KeepAlive — the index, watcher and models in one process, which
+                      is why it outlives every host that talks to it.
+    dev.akno.dream  Nightly — the maintenance cycle. Observe runs on a schedule,
+                      and this is that schedule. It resolves maintenance.profile at
+                      run time, so changing authority does not require reinstalling it.
+    dev.akno.dream-health
+                      Daily — after the two-hour grace window, reports a missed cycle
+                      when local maintenance notifications are enabled.
+
+  --http <addr>       Serve loopback HTTP as well as the socket.
+  --dream-hour <0-23> When the nightly cycle runs. Default 3.
+  --no-dream          Do not install the nightly agent.`;
+const PLIST_LABEL = 'dev.akno';
+export async function serviceCommand(argv) {
+    const { values, positionals } = parse(argv, {
+        http: { type: 'string' },
+        'dream-hour': { type: 'string' },
+        dream: { type: 'boolean', default: true },
+    });
+    if (values.help || positionals.length === 0) {
+        line(SERVICE_HELP);
+        return values.help ? 0 : 1;
+    }
+    if (process.platform !== 'darwin') {
+        warn('`akno service` manages a macOS launchd agent; v1 targets macOS only.');
+        return 1;
+    }
+    const agents = path.join(process.env.HOME ?? '', 'Library', 'LaunchAgents');
+    const plistPath = path.join(agents, `${PLIST_LABEL}.plist`);
+    const dreamPath = path.join(agents, `${DREAM_SCHEDULE_LABEL}.plist`);
+    const dreamHealthPath = path.join(agents, `${DREAM_HEALTH_LABEL}.plist`);
+    const action = positionals[0];
+    if (action === 'status') {
+        let installed = false;
+        for (const [label, target] of [
+            [PLIST_LABEL, plistPath],
+            [DREAM_SCHEDULE_LABEL, dreamPath],
+            [DREAM_HEALTH_LABEL, dreamHealthPath],
+        ]) {
+            if (fs.existsSync(target)) {
+                installed = true;
+                line(`${style.green('installed')}  ${target}`);
+                line(style.grey(`  launchctl print gui/$(id -u)/${label}   # live state`));
+            }
+            else {
+                line(`${style.grey('not installed')}  ${target}`);
+            }
+        }
+        return installed ? 0 : 1;
+    }
+    if (action === 'uninstall') {
+        const removed = [plistPath, dreamPath, dreamHealthPath].filter((target) => fs.existsSync(target));
+        if (removed.length === 0) {
+            line(style.grey('not installed'));
+            return 0;
+        }
+        for (const target of removed) {
+            fs.rmSync(target);
+            line(`removed ${target}`);
+        }
+        line(style.grey(`run: launchctl bootout gui/$(id -u)/${PLIST_LABEL}`));
+        if (removed.includes(dreamPath)) {
+            line(style.grey(`run: launchctl bootout gui/$(id -u)/${DREAM_SCHEDULE_LABEL}`));
+        }
+        if (removed.includes(dreamHealthPath)) {
+            line(style.grey(`run: launchctl bootout gui/$(id -u)/${DREAM_HEALTH_LABEL}`));
+        }
+        return 0;
+    }
+    if (action !== 'install') {
+        line(SERVICE_HELP);
+        return 1;
+    }
+    // Before anything is written. A bad hour used to abort between the two agents, leaving the
+    // service installed, the nightly cycle not, and an error message about neither.
+    const hour = dreamHour(values['dream-hour']);
+    const { loadConfig } = await import('@tenphi/akno-core');
+    const config = loadConfig(openOptionsFrom(values));
+    const binary = process.argv[1] ?? 'akno';
+    // An installer reached through guided setup carries the exact target the user confirmed.
+    // Persist those flags in every agent; otherwise launchd would later resolve whichever
+    // checkout config happens to be visible from its working directory.
+    const targetArgs = serviceTargetArgs(values);
+    const args = ['serve', ...targetArgs, ...(values.http ? ['--http', values.http] : [])];
+    fs.mkdirSync(agents, { recursive: true });
+    fs.mkdirSync(config.logDir, { recursive: true });
+    fs.writeFileSync(plistPath, plist({
+        label: PLIST_LABEL,
+        node: process.execPath,
+        script: binary,
+        args,
+        logDir: config.logDir,
+        keepAlive: true,
+    }), 'utf8');
+    line(`wrote ${plistPath}`);
+    line(style.grey(`run: launchctl bootstrap gui/$(id -u) ${plistPath}`));
+    if (values.dream) {
+        // Observe runs on a schedule. A second agent rather than a timer inside `serve`,
+        // because the cycle is a *pass* with an exit code and a log — something a person can run
+        // by hand, read the output of, and undo — not a background thread nobody can address.
+        fs.writeFileSync(dreamPath, plist({
+            label: DREAM_SCHEDULE_LABEL,
+            node: process.execPath,
+            script: binary,
+            // Keep authority unqualified: `dream` resolves the current named profile every night.
+            // The marker enables local notification delivery; it does not change dream behaviour.
+            args: ['dream', '--scheduled', ...targetArgs],
+            logDir: config.logDir,
+            logName: 'dream',
+            calendarHour: hour,
+        }), 'utf8');
+        line(`wrote ${dreamPath}  ${style.grey(`(daily at ${String(hour).padStart(2, '0')}:00)`)}`);
+        line(style.grey(`  maintenance profile: ${config.maintenance.profile} (resolved at run time)`));
+        line(style.grey(`run: launchctl bootstrap gui/$(id -u) ${dreamPath}`));
+        const healthHour = (hour + 2) % 24;
+        fs.writeFileSync(dreamHealthPath, plist({
+            label: DREAM_HEALTH_LABEL,
+            node: process.execPath,
+            script: binary,
+            args: ['dream', 'notify', '--schedule-health', ...targetArgs],
+            logDir: config.logDir,
+            logName: 'dream-health',
+            calendarHour: healthHour,
+            calendarMinute: 5,
+        }), 'utf8');
+        line(`wrote ${dreamHealthPath}  ${style.grey(`(daily at ${String(healthHour).padStart(2, '0')}:05; notification policy resolved at run time)`)}`);
+        line(style.grey(`run: launchctl bootstrap gui/$(id -u) ${dreamHealthPath}`));
+    }
+    line(style.grey(`logs: ${config.logDir}`));
+    return 0;
+}
+export function serviceTargetArgs(values) {
+    return [
+        ...(values['akno-path'] ? ['--akno-path', values['akno-path']] : []),
+        ...(values['state-dir'] ? ['--state-dir', values['state-dir']] : []),
+    ];
+}
+/** An hour outside 0-23 is a typo, and a nightly job at "25:00" would silently never run. */
+function dreamHour(raw) {
+    if (raw === undefined)
+        return 3;
+    const hour = Number(raw);
+    if (!Number.isInteger(hour) || hour < 0 || hour > 23) {
+        throw new AknoError('invalid', `--dream-hour wants 0-23, not '${raw}'`);
+    }
+    return hour;
+}
+/** Exported for exact scheduler fixture tests; service installation is the only production caller. */
+export function plist(options) {
+    const { label, node, script, args, logDir } = options;
+    const logName = options.logName ?? 'akno';
+    const programArgs = [node, script, ...args]
+        .map((arg) => `    <string>${escapeXml(arg)}</string>`)
+        .join('\n');
+    const schedule = options.calendarHour === undefined
+        ? `  <key>RunAtLoad</key><true/>\n  <key>KeepAlive</key>${options.keepAlive ? '<true/>' : '<false/>'}`
+        : `  <key>StartCalendarInterval</key>\n  <dict><key>Hour</key><integer>${options.calendarHour}</integer><key>Minute</key><integer>${options.calendarMinute ?? 0}</integer></dict>`;
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArgs}
+  </array>
+${schedule}
+  <key>ProcessType</key><string>Background</string>
+  <key>StandardOutPath</key><string>${escapeXml(path.join(logDir, `${logName}.log`))}</string>
+  <key>StandardErrorPath</key><string>${escapeXml(path.join(logDir, `${logName}.err.log`))}</string>
+</dict>
+</plist>
+`;
+}
+function escapeXml(value) {
+    return value.replace(/[<>&'"]/g, (char) => {
+        switch (char) {
+            case '<':
+                return '&lt;';
+            case '>':
+                return '&gt;';
+            case '&':
+                return '&amp;';
+            case "'":
+                return '&apos;';
+            default:
+                return '&quot;';
+        }
+    });
+}
+/**
+ * Wait for the process holding the write handle to exit, then stand down so a supervisor can
+ * restart this one with the handle.
+ *
+ * Exit code 0 on purpose: nothing failed. Under launchd's `KeepAlive` the replacement is up in a
+ * second, and under no supervisor at all the operator gets a line saying exactly what happened and
+ * what to do.
+ */
+function watchForAReleasedHandle(heldBy, log) {
+    if (heldBy === null)
+        return;
+    const timer = setInterval(() => {
+        if (isAlive(heldBy))
+            return;
+        clearInterval(timer);
+        log(`pid ${heldBy} has exited and the write handle is free — restarting to take it`);
+        process.exit(0);
+    }, 15_000);
+    timer.unref();
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=serve-cmd.js.map

package/dist/commands/serve-cmd.js.map

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

package/dist/commands/timeline-cmd.d.ts

@@ -0,0 +1,2 @@
+export declare function timelineCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=timeline-cmd.d.ts.map

package/dist/commands/timeline-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/timeline-cmd.ts"],"names":[],"mappings":"AAkBA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DrE"}

package/dist/commands/timeline-cmd.js

@@ -0,0 +1,67 @@
+import { openOptionsFrom, parse } from "../args.js";
+import { json, line, statusLabel, style, truncate } from "../output.js";
+import { resolveOps } from "../ops-handle.js";
+const TIMELINE_HELP = `akno timeline [options]
+
+  When things happened. Authored events remain distinct from dated orphan
+  document evidence, whose date basis and source citation are shown explicitly.
+
+  --since <YYYY[-MM[-DD]]>
+  --until <YYYY[-MM[-DD]]>
+  --match <text>      Substring match on the summary.
+  --subject <id>      Page slug or orphan document id/path.
+  --source <kind>     event | document | both (default)
+  --order <o>         newest | oldest
+  --limit <n>
+  --json`;
+export async function timelineCommand(argv) {
+    const { values } = parse(argv, {
+        since: { type: 'string' },
+        until: { type: 'string' },
+        match: { type: 'string' },
+        subject: { type: 'string' },
+        order: { type: 'string' },
+        limit: { type: 'string' },
+        source: { type: 'string' },
+    });
+    if (values.help) {
+        line(TIMELINE_HELP);
+        return 0;
+    }
+    const handle = await resolveOps(values, openOptionsFrom(values));
+    try {
+        const result = await handle.ops.timeline({
+            ...(values.since ? { since: values.since } : {}),
+            ...(values.until ? { until: values.until } : {}),
+            ...(values.match ? { match: values.match } : {}),
+            ...(values.subject ? { subject: values.subject } : {}),
+            ...(values.order ? { order: values.order } : {}),
+            ...(values.limit ? { limit: Number(values.limit) } : {}),
+            ...(values.source ? { source: values.source } : {}),
+        });
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        line(`${statusLabel(result.status)} ${style.grey(`${result.total} result${result.total === 1 ? '' : 's'}`)}` +
+            `${result.results.length < result.total ? style.grey(` (showing ${result.results.length})`) : ''}`);
+        for (const entry of result.results) {
+            if (entry.type === 'document_evidence') {
+                const page = entry.matched_page ? ` p${entry.matched_page}` : '';
+                line(`  ${style.bold(entry.date)}  ${truncate(entry.label, 80)} ` +
+                    style.grey(`[${entry.date_basis}; ${entry.path}${page}]`));
+                if (entry.quote)
+                    line(`    ${truncate(entry.quote.replaceAll('\n', ' '), 100)}`);
+                continue;
+            }
+            const target = entry.slug ? style.cyan(` → ${entry.slug}`) : '';
+            const source = style.grey(` [${entry.source}${entry.line ? `:${entry.line}` : ''}]`);
+            line(`  ${style.bold(entry.date)}  ${truncate(entry.summary, 80)}${target}${source}`);
+        }
+        return 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=timeline-cmd.js.map

package/dist/commands/timeline-cmd.js.map

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

package/dist/commands/write-cmd.d.ts

@@ -0,0 +1,49 @@
+export declare function writeCommand(argv: string[]): Promise<number>;
+/**
+ * `conflict`, `requires_approval` and `requires_folder` are not failures — they are the layer
+ * doing its job, and they must reach the caller as distinguishable results. Exit code 2 marks
+ * "needs a decision", separate from 1.
+ *
+ * The three are not the same kind of thing, and the output says which. A conflict and an
+ * approval want a person; `requires_folder` wants a sentence from whoever is writing, and
+ * printing it under a heading that says "approval" is how a caller learns to wait for
+ * somebody who is never coming.
+ */
+export declare function printWriteOutcome(result: {
+    outcome: string;
+    status: string;
+    change_id?: string;
+    wrote?: {
+        slug: string;
+        line?: number;
+        action: string;
+    }[];
+    facts?: {
+        retired: number;
+        added: number;
+    };
+    documents?: {
+        id: string;
+        rel_path: string;
+        text_from?: string;
+    }[];
+    conflict?: {
+        slug: string;
+        line: number;
+        existing: string;
+        incoming: string;
+        token: string;
+    };
+    approval?: {
+        proposal_id: string;
+        reason: string;
+        nearest: string[];
+    };
+    requires_folder?: {
+        folder: string;
+        nearest: string[];
+    };
+    note?: string;
+}): number;
+export declare function rememberCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=write-cmd.d.ts.map

package/dist/commands/write-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/write-cmd.ts"],"names":[],"mappings":"AAiCA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,QAAQ,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtE,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAgET;AAqCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsFrE"}