@event4u/agent-config 2.26.0 → 3.1.0

package/dist/server/routes/settings.js

@@ -0,0 +1,236 @@
+import { promises as fs } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { settingsSchema } from '../schemas/settings.js';
+import { parseYaml, mergeIntoTemplate, diffValues, deepMerge } from '../io/yamlIO.js';
+import { writeAtomic } from '../io/atomicWrite.js';
+import { PACKAGE_ROOT } from '../../cli/paths.js';
+/**
+ * Cost-profile placeholder default. Mirrors `scripts/install.py::DEFAULT_PROFILE`
+ * so the TypeScript defaults layer renders the same `cost_profile: 'balanced'`
+ * scalar the Python installer would substitute.
+ */
+const COST_PROFILE_PLACEHOLDER = '__COST_PROFILE__';
+const USER_TYPE_PLACEHOLDER = '__USER_TYPE__';
+const DEFAULT_COST_PROFILE = 'balanced';
+// Computed once — Zod → JSON Schema conversion is pure and the schema is static.
+const SETTINGS_JSON_SCHEMA = zodToJsonSchema(settingsSchema, {
+    name: 'AgentSettings',
+    $refStrategy: 'none',
+    target: 'jsonSchema7',
+});
+const SETTINGS_RELATIVE = join('settings', '.agent-settings.yml');
+/** Pre-typed-subdir flat-root location. Read as fallback for migration. */
+const LEGACY_FLAT_RELATIVE = '.agent-settings.yml';
+function settingsPath(root) {
+    return join(root, SETTINGS_RELATIVE);
+}
+function legacyFlatPath(root) {
+    return join(root, LEGACY_FLAT_RELATIVE);
+}
+/**
+ * Parse the package settings template with `__COST_PROFILE__` /
+ * `__USER_TYPE__` substituted for their permissive defaults. Returns
+ * `{}` if the template is missing or YAML-invalid — callers treat this
+ * as "no defaults available" rather than erroring, matching the Python
+ * `_load_default_settings` shape.
+ */
+async function loadDefaultSettings(packageRoot) {
+    try {
+        const text = await fs.readFile(join(packageRoot, 'config', 'agent-settings.template.yml'), 'utf8');
+        const rendered = text
+            .replaceAll(COST_PROFILE_PLACEHOLDER, DEFAULT_COST_PROFILE)
+            .replaceAll(USER_TYPE_PLACEHOLDER, '');
+        const parsed = parseYaml(rendered);
+        return parsed ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function extractLegacyHints(values) {
+    const hints = {};
+    const personal = values.personal;
+    if (personal !== null && typeof personal === 'object' && !Array.isArray(personal)) {
+        const userName = personal.user_name;
+        if (typeof userName === 'string' && userName.trim() !== '') {
+            hints.user_name = userName;
+        }
+    }
+    return hints;
+}
+async function readYamlFile(path) {
+    let stat;
+    let raw;
+    try {
+        [stat, raw] = await Promise.all([fs.stat(path), fs.readFile(path, 'utf8')]);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+    const values = parseYaml(raw);
+    return { raw, values, mtimeMs: Math.trunc(stat.mtimeMs) };
+}
+async function readSettingsFrom(root) {
+    return readYamlFile(settingsPath(root));
+}
+/**
+ * Read the highest-priority real on-disk file at `<root>/settings/...`
+ * (typed subdir) or `<root>/.agent-settings.yml` (pre-typed-subdir
+ * flat-root). Used as the per-layer reader inside `readLayeredSettings`.
+ */
+async function readSingleLayer(root) {
+    const typed = await readSettingsFrom(root);
+    if (typed !== null)
+        return typed;
+    return readYamlFile(legacyFlatPath(root));
+}
+/**
+ * Three-layer settings merge — `defaults < global < project`.
+ *
+ *   - Defaults: package template with placeholders substituted.
+ *   - Global: `writeRoot/settings/.agent-settings.yml` (flat fallback).
+ *   - Project: `legacyReadRoot/settings/.agent-settings.yml` (flat
+ *     fallback) — only consulted when `legacyReadRoot` differs from
+ *     `writeRoot`.
+ *
+ * If neither global nor project exists, returns `hasRealFile: false`
+ * so the route can emit 404 (ADR-020 § "Installed" semantic).
+ *
+ * Mirrors `scripts/install.py::read_layered_settings`.
+ */
+async function readLayeredSettings(packageRoot, writeRoot, legacyReadRoot) {
+    const defaults = await loadDefaultSettings(packageRoot);
+    const globalLayer = await readSingleLayer(writeRoot);
+    const projectLayer = legacyReadRoot && legacyReadRoot !== writeRoot
+        ? await readSingleLayer(legacyReadRoot)
+        : null;
+    let merged = defaults;
+    if (globalLayer !== null)
+        merged = deepMerge(merged, globalLayer.values);
+    if (projectLayer !== null)
+        merged = deepMerge(merged, projectLayer.values);
+    const scaffold = projectLayer ?? globalLayer;
+    const mtimeMs = Math.max(globalLayer?.mtimeMs ?? 0, projectLayer?.mtimeMs ?? 0);
+    return {
+        raw: scaffold?.raw ?? '',
+        values: merged,
+        mtimeMs,
+        hasRealFile: scaffold !== null,
+    };
+}
+function zodIssuesToFields(issues) {
+    return issues.map((issue) => ({ path: issue.path.join('.'), message: issue.message }));
+}
+function readIfUnmodified(header) {
+    if (typeof header !== 'string')
+        return null;
+    const n = Number.parseInt(header, 10);
+    return Number.isFinite(n) ? n : null;
+}
+export function settingsRoute(opts) {
+    const packageRoot = opts.packageRoot ?? PACKAGE_ROOT;
+    const plugin = async (app) => {
+        app.get('/api/v1/settings', async (_request, reply) => {
+            try {
+                const state = await readLayeredSettings(packageRoot, opts.writeRoot, opts.legacyReadRoot);
+                if (!state.hasRealFile) {
+                    await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'settings file missing' } });
+                    return reply;
+                }
+                const legacyHints = extractLegacyHints(state.values);
+                return {
+                    values: state.values,
+                    lastModified: state.mtimeMs,
+                    path: SETTINGS_RELATIVE,
+                    schema: SETTINGS_JSON_SCHEMA,
+                    legacyHints,
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'YAML parse failed';
+                await reply.code(500).send({ error: { code: 'YAML_PARSE', message } });
+                return reply;
+            }
+        });
+        app.post('/api/v1/settings/diff', async (request, reply) => {
+            const body = (request.body ?? {});
+            const parsed = settingsSchema.safeParse(body.values);
+            if (!parsed.success) {
+                await reply.code(422).send({
+                    error: { code: 'VALIDATION', message: 'invalid settings', fields: zodIssuesToFields(parsed.error.issues) },
+                });
+                return reply;
+            }
+            const current = await readLayeredSettings(packageRoot, opts.writeRoot, opts.legacyReadRoot);
+            if (!current.hasRealFile) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'settings file missing' } });
+                return reply;
+            }
+            const ius = typeof body.ifUnmodifiedSince === 'number' ? body.ifUnmodifiedSince : null;
+            if (ius !== null && ius < current.mtimeMs) {
+                await reply.code(409).send({
+                    error: { code: 'CONFLICT', message: 'on-disk file has been modified' },
+                    current: { values: current.values, lastModified: current.mtimeMs },
+                });
+                return reply;
+            }
+            const changes = diffValues(current.values, parsed.data);
+            return { changes };
+        });
+        app.put('/api/v1/settings', async (request, reply) => {
+            const ius = readIfUnmodified(request.headers['if-unmodified-since']);
+            if (ius === null) {
+                await reply.code(412).send({ error: { code: 'PRECONDITION_REQUIRED', message: 'If-Unmodified-Since header required' } });
+                return reply;
+            }
+            const body = (request.body ?? {});
+            const parsed = settingsSchema.safeParse(body.values);
+            if (!parsed.success) {
+                await reply.code(422).send({
+                    error: { code: 'VALIDATION', message: 'invalid settings', fields: zodIssuesToFields(parsed.error.issues) },
+                });
+                return reply;
+            }
+            const current = await readLayeredSettings(packageRoot, opts.writeRoot, opts.legacyReadRoot);
+            if (!current.hasRealFile) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'settings file missing' } });
+                return reply;
+            }
+            if (ius < current.mtimeMs) {
+                await reply.code(409).send({
+                    error: { code: 'CONFLICT', message: 'on-disk file has been modified' },
+                    current: { values: current.values, lastModified: current.mtimeMs },
+                });
+                return reply;
+            }
+            try {
+                const merged = mergeIntoTemplate(current.raw, parsed.data);
+                if (opts.dryRun === true) {
+                    // No disk write, no Last-Modified bump — surface the
+                    // rendered body so the maintainer sees what a real
+                    // PUT would have written.
+                    return {
+                        dryRun: true,
+                        lastModified: current.mtimeMs,
+                        preview: { path: SETTINGS_RELATIVE, body: merged },
+                    };
+                }
+                const path = settingsPath(opts.writeRoot);
+                await fs.mkdir(dirname(path), { recursive: true, mode: 0o700 });
+                await writeAtomic(path, merged, { mode: 0o600 });
+                const stat = await fs.stat(path);
+                return { lastModified: Math.trunc(stat.mtimeMs), writtenPaths: [SETTINGS_RELATIVE] };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'atomic write failed';
+                await reply.code(500).send({ error: { code: 'ATOMIC_WRITE', message } });
+                return reply;
+            }
+        });
+    };
+    return plugin;
+}
+//# sourceMappingURL=settings.js.map

package/dist/server/routes/settings.js.map

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

package/dist/server/routes/userMd.js

@@ -0,0 +1,127 @@
+import { promises as fs } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { userIdentitySchema } from '../../shared/userMd/schema.js';
+import { composeUserIdentity, parseLegacyUserMd, parseUserIdentity, } from '../../shared/userMd/utils.js';
+import { writeAtomic } from '../io/atomicWrite.js';
+import { PACKAGE_ROOT } from '../../cli/paths.js';
+/** New canonical on-disk path, relative to writeRoot. */
+export const USER_IDENTITY_RELATIVE = join('settings', '.agent-user.yml');
+/** Legacy markdown path, relative to writeRoot or legacyReadRoot. */
+const LEGACY_USER_MD_RELATIVE = '.agent-user.md';
+const DEFAULT_TEMPLATE = join(PACKAGE_ROOT, 'templates', 'agent-user.yml');
+async function readFromPath(path, legacy) {
+    try {
+        const [stat, body] = await Promise.all([fs.stat(path), fs.readFile(path, 'utf8')]);
+        const identity = legacy ? parseLegacyUserMd(body) : parseUserIdentity(body);
+        return { identity, mtimeMs: Math.trunc(stat.mtimeMs) };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Try the new path, then the legacy paths in priority order:
+ *   1. `<writeRoot>/settings/.agent-user.yml`     (canonical)
+ *   2. `<writeRoot>/.agent-user.md`               (in-repo legacy)
+ *   3. `<legacyReadRoot>/.agent-user.md`          (CWD legacy)
+ */
+async function readUserMd(writeRoot, legacyReadRoot) {
+    const candidates = [
+        { path: join(writeRoot, USER_IDENTITY_RELATIVE), legacy: false },
+        { path: join(writeRoot, LEGACY_USER_MD_RELATIVE), legacy: true },
+    ];
+    if (legacyReadRoot && legacyReadRoot !== writeRoot) {
+        candidates.push({ path: join(legacyReadRoot, LEGACY_USER_MD_RELATIVE), legacy: true });
+    }
+    for (const c of candidates) {
+        const state = await readFromPath(c.path, c.legacy);
+        if (state !== null)
+            return state;
+    }
+    return null;
+}
+function readIfUnmodified(header) {
+    if (typeof header !== 'string')
+        return null;
+    const n = Number.parseInt(header, 10);
+    return Number.isFinite(n) ? n : null;
+}
+function zodIssuesToFields(issues) {
+    return issues.map((issue) => ({ path: issue.path.join('.'), message: issue.message }));
+}
+export function userMdRoute(opts) {
+    const templatePath = opts.templatePath ?? DEFAULT_TEMPLATE;
+    const plugin = async (app) => {
+        app.get('/api/v1/user-md', async () => {
+            const state = await readUserMd(opts.writeRoot, opts.legacyReadRoot);
+            if (state === null) {
+                return { identity: null, exists: false, lastModified: null };
+            }
+            return { identity: state.identity, exists: true, lastModified: state.mtimeMs };
+        });
+        app.get('/api/v1/user-md/template', async (_request, reply) => {
+            try {
+                const body = await fs.readFile(templatePath, 'utf8');
+                return { body };
+            }
+            catch (err) {
+                if (err.code === 'ENOENT') {
+                    await reply.code(204).send();
+                    return reply;
+                }
+                throw err;
+            }
+        });
+        app.put('/api/v1/user-md', async (request, reply) => {
+            const body = (request.body ?? {});
+            const parsed = userIdentitySchema.safeParse(body.identity);
+            if (!parsed.success) {
+                await reply.code(422).send({
+                    error: { code: 'VALIDATION', message: 'invalid user identity', fields: zodIssuesToFields(parsed.error.issues) },
+                });
+                return reply;
+            }
+            const ius = readIfUnmodified(request.headers['if-unmodified-since']);
+            const current = await readUserMd(opts.writeRoot, opts.legacyReadRoot);
+            if (current !== null) {
+                if (ius === null) {
+                    await reply.code(412).send({
+                        error: { code: 'PRECONDITION_REQUIRED', message: 'If-Unmodified-Since header required for existing file' },
+                    });
+                    return reply;
+                }
+                if (ius < current.mtimeMs) {
+                    await reply.code(409).send({
+                        error: { code: 'CONFLICT', message: 'on-disk file has been modified' },
+                        current: { identity: current.identity, lastModified: current.mtimeMs },
+                    });
+                    return reply;
+                }
+            }
+            try {
+                const yamlBody = composeUserIdentity(parsed.data);
+                if (opts.dryRun === true) {
+                    return {
+                        dryRun: true,
+                        lastModified: current?.mtimeMs ?? null,
+                        preview: { path: USER_IDENTITY_RELATIVE, identity: parsed.data, body: yamlBody },
+                    };
+                }
+                const path = join(opts.writeRoot, USER_IDENTITY_RELATIVE);
+                await fs.mkdir(dirname(path), { recursive: true, mode: 0o700 });
+                await writeAtomic(path, yamlBody, { mode: 0o600 });
+                const stat = await fs.stat(path);
+                return { lastModified: Math.trunc(stat.mtimeMs), writtenPaths: [USER_IDENTITY_RELATIVE] };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'atomic write failed';
+                await reply.code(500).send({ error: { code: 'ATOMIC_WRITE', message } });
+                return reply;
+            }
+        });
+    };
+    return plugin;
+}
+//# sourceMappingURL=userMd.js.map

package/dist/server/routes/userMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userMd.js","sourceRoot":"","sources":["../../../src/server/routes/userMd.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAuBlD,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;AAC1E,qEAAqE;AACrE,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAQ3E,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,MAAe;IACrD,IAAI,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CACrB,SAAiB,EACjB,cAAyC;IAEzC,MAAM,UAAU,GAA6C;QACzD,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QAChE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;KACnE,CAAC;IACF,IAAI,cAAc,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAkB;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAwB;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,gBAAgB,CAAC;IAE3D,MAAM,MAAM,GAAuB,KAAK,EAAE,GAAoB,EAAE,EAAE;QAC9D,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;YAClC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YACpE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YAC1D,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACrD,OAAO,EAAE,IAAI,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7B,OAAO,KAAK,CAAC;gBACjB,CAAC;gBACD,MAAM,GAAG,CAAC;YACd,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAA2B,CAAC;YAC5D,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;iBAClH,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YACtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACf,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,uDAAuD,EAAE;qBAC7G,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC;gBACjB,CAAC;gBACD,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;oBACxB,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gCAAgC,EAAE;wBACtE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE;qBACzE,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC;gBACjB,CAAC;YACL,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAA+B,CAAC,CAAC;gBAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBACvB,OAAO;wBACH,MAAM,EAAE,IAAI;wBACZ,YAAY,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;wBACtC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACnF,CAAC;gBACN,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;gBAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChE,MAAM,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC9F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC;gBAC3E,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;gBACzE,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAClB,CAAC"}