@agi-fans/dsh-tui 0.21.0 → 0.23.0

package/lib/runtime/startup-notices.js

@@ -1,10 +1,12 @@
+import { choosePrompt } from "../prompt-intents.js";
+import { readReference } from "./reference-reader.js";
 /** Startup release notes and update-notification Cordis plugin. */
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { registerCommands } from "../commands/registration.js";
-import { changelogText, resolveStartupChangelog } from "../session/release-notes.js";
+import { changelogText, parseChangelog, resolveStartupChangelog } from "../session/release-notes.js";
 import { APP_VERSION, PACKAGE_NAME } from "../session/package-metadata.js";
 import { checkForUpdate } from "../session/update-check.js";
 export const name = 'omdsh-startup-notices';
@@ -109,13 +111,42 @@ class StartupNotices {
         }
     }
 }
-async function showChangelog(config, invocation) {
+async function showChangelog(tui, config, invocation) {
     const input = invocation.rawInput.trim().toLowerCase();
     if (input !== '' && input !== 'full')
         return { kind: 'error', text: 'Usage: /changelog [full]' };
     try {
         const changelog = await readFile(config.changelogPath, 'utf8');
-        return { kind: 'success', text: changelogText(changelog, input === 'full') };
+        if (tui.interactive !== true)
+            return { kind: 'success', text: changelogText(changelog, input === 'full') };
+        const abort = new AbortController();
+        const signal = AbortSignal.any([invocation.signal, abort.signal]);
+        const surface = {
+            prompt: (request) => tui.prompt({ ...request, signal, onSuperseded: () => { abort.abort(); } }),
+            ...(tui.copyText === undefined ? {} : { copyText: (text, label) => tui.copyText(text, label) }),
+        };
+        const entries = parseChangelog(changelog);
+        if (input === 'full' || entries.length === 0) {
+            await readReference(surface, 'Changelog', changelogText(changelog, true), signal);
+            return { kind: 'success' };
+        }
+        let selected = entries[0].version;
+        while (!signal.aborted) {
+            const answer = await surface.prompt(choosePrompt({ localize: ['title', 'question'], title: 'Changelog', question: 'Choose a release', filterable: true, initialValue: selected,
+                options: entries.map(entry => ({ label: `v${entry.version}`, value: entry.version,
+                    description: [entry.markdown.split('\n')[0]?.match(/\d{4}-\d{2}-\d{2}/u)?.[0],
+                        ...Object.entries(entry.categoryCounts).map(([category, count]) => `${count} ${category.toLowerCase()}`)].filter(Boolean).join(' · '),
+                })),
+            }));
+            if (answer === null || signal.aborted)
+                break;
+            const entry = entries.find(item => item.version === answer);
+            if (entry === undefined)
+                break;
+            selected = entry.version;
+            await readReference(surface, `Changelog · v${entry.version}`, entry.markdown, signal);
+        }
+        return { kind: 'success' };
     }
     catch (error) {
         return { kind: 'error', text: 'Changelog unavailable: ' + (error instanceof Error ? error.message : String(error)) };
@@ -135,7 +166,7 @@ export function apply(ctx, config = {}) {
             name: 'changelog',
             description: 'Show recent release notes',
             input: { hint: '[full]' },
-            handler: invocation => showChangelog(resolved, invocation),
+            handler: invocation => showChangelog(tui, resolved, invocation),
         }], 'omdsh changelog command');
     ctx.provide('omdshStartup', new StartupNotices(tui, resolved));
 }

package/lib/runtime/startup-notices.js.map

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

package/lib/runtime/subagent-model-selection.js

@@ -9,7 +9,8 @@ export function apply(ctx) {
         throw new Error('Subagent model selection requires the product tool-subagent entry.');
     // The global tool stays available for deployment restrictions. The Harness
     // installs the sampled variant in each Agent's scope and owns its teardown.
+    // Discovery is its own opt-in since 0.2.2 and does not follow model selection.
     const inherited = Config(interpolate(ctx, entry.options.config));
-    applyDelegation(ctx, { ...inherited, modelSelectionSettings: true });
+    applyDelegation(ctx, { ...inherited, modelSelection: true, modelDiscovery: true });
 }
 //# sourceMappingURL=subagent-model-selection.js.map

package/lib/runtime/subagent-model-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-model-selection.js","sourceRoot":"","sources":["../../src/runtime/subagent-model-selection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAG7G,MAAM,CAAC,MAAM,IAAI,GAAG,gCAAgC,CAAA;AACpD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAA;AAE/E,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,eAAe;WACjF,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,gCAAgC,CAAC,CAAA;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IAC9G,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,eAAe,CAAC,GAAG,EAAE,EAAE,GAAG,SAAS,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAA;AACtE,CAAC"}
+{"version":3,"file":"subagent-model-selection.js","sourceRoot":"","sources":["../../src/runtime/subagent-model-selection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAG7G,MAAM,CAAC,MAAM,IAAI,GAAG,gCAAgC,CAAA;AACpD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAA;AAE/E,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,eAAe;WACjF,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,gCAAgC,CAAC,CAAA;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IAC9G,2EAA2E;IAC3E,4EAA4E;IAC5E,+EAA+E;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,eAAe,CAAC,GAAG,EAAE,EAAE,GAAG,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAA;AACpF,CAAC"}

package/lib/runtime/subagent-settings.d.ts

@@ -0,0 +1,14 @@
+/** Delegation preferences remain Harness-owned; this editor only stages their fields. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const SUBAGENT_SETTINGS_FIELDS: Record<string, readonly string[]>;
+export declare function subagentSettingsEntry(ctx: Context): {
+    id: string;
+    label: string;
+    section: "agent";
+    fields: never[];
+    summary: string;
+    behavior: string;
+    keywords: string[];
+    description: string;
+}[];
+export declare function openSubagentSettings(ctx: Context, signal: AbortSignal, resetOnly?: boolean): Promise<void>;

package/lib/runtime/subagent-settings.js

@@ -0,0 +1,288 @@
+import { settingsDraftSummary } from "./settings-draft.js";
+import z from '@deepseek-ai/schemastery';
+import { askPrompt } from "../prompt-intents.js";
+import { resolveUiLanguage, uiText } from "../locale/index.js";
+const LIMITS = 'subagent', MODELS = 'subagent-model-selection-settings';
+export const SUBAGENT_SETTINGS_FIELDS = {
+    [LIMITS]: ['maxDepth', 'maxActiveSubagents'], [MODELS]: ['enabled', 'allowedModels'],
+};
+const labels = { maxDepth: 'Delegation depth', maxActiveSubagents: 'Concurrent subagents', enabled: 'Model selection', allowedModels: 'Allowed models' };
+const help = {
+    maxDepth: 'Main agent: depth 0; its children: depth 1; their children: depth 2. A tool’s own depth limit takes precedence. Applies to future delegations.',
+    maxActiveSubagents: 'Counts live subagents at every depth under one main agent, excluding the main agent. Lowering this limit does not stop existing children.',
+    enabled: 'Applies to new sessions only. Existing sessions keep their model policy; forked children inherit the parent route. Disabling keeps the model list.',
+    allowedModels: 'Choose exact provider and model routes for new sessions. Enabling model selection requires at least one route.',
+};
+const list = { allowCustom: false, notify: false, localize: ['title', 'question', 'actions'] };
+const object = (value) => typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+const text = (ctx, source) => uiText(resolveUiLanguage(ctx.tui.prefs().uiLanguage), source);
+const describe = (ctx, ns) => ctx.settings.describe({ redactSecrets: true }).find(section => section.ns === ns);
+const routes = (value) => Array.isArray(value) ? value.filter((row) => typeof row?.provider === 'string' && typeof row?.model === 'string') : [];
+const routeKey = (route) => encodeURIComponent(JSON.stringify([route.provider, route.model]));
+export function subagentSettingsEntry(ctx) {
+    if (![LIMITS, MODELS].some(ns => describe(ctx, ns) !== undefined))
+        return [];
+    return [{ id: 'subagents:settings', label: 'Subagents', section: 'agent', fields: [], summary: 'Configure', behavior: ctx.settings.writable ? 'Profile · Apply to save' : 'Profile · Read only',
+            keywords: ['Subagent models', ...Object.values(labels)], description: 'Edit delegation limits and model choices together, then Apply to save.' }];
+}
+export async function openSubagentSettings(ctx, signal, resetOnly = false) {
+    const drafts = new Map();
+    const sync = () => {
+        for (const ns of [LIMITS, MODELS]) {
+            const section = describe(ctx, ns), draft = drafts.get(ns);
+            if (draft?.changes.size)
+                continue;
+            if (section === undefined)
+                drafts.delete(ns);
+            else
+                drafts.set(ns, { section, changes: new Map(), error: '' });
+        }
+    };
+    sync();
+    if (!drafts.size || signal.aborted)
+        return;
+    const schema = (draft, field) => new z(draft.section.schema).dict?.[field];
+    const fields = () => [...drafts].flatMap(([ns, draft]) => (SUBAGENT_SETTINGS_FIELDS[ns] ?? [])
+        .filter(field => { const item = schema(draft, field); return item !== undefined && !item.meta.hidden && !item.meta.disabled; })
+        .map(field => ({ ns, field, draft })));
+    const inherited = (draft, field) => object(draft.section.base)[field] ?? schema(draft, field)?.meta.default;
+    const value = (ns, field) => {
+        const draft = drafts.get(ns);
+        if (draft === undefined)
+            return undefined;
+        return draft.changes.has(field) ? draft.changes.get(field) ?? inherited(draft, field) : object(draft.section.value)[field] ?? schema(draft, field)?.meta.default;
+    };
+    const summary = (ns, field, draft) => {
+        const current = value(ns, field);
+        const shown = field === 'enabled' ? text(ctx, current ? 'Enabled' : 'Disabled') : field === 'allowedModels' ? String(routes(current).length) : String(current ?? '');
+        return shown + ' · ' + text(ctx, draft.changes.has(field) ? 'Draft' : Object.hasOwn(object(draft.section.user), field) ? 'Profile override' : 'Inherited');
+    };
+    // Generation fences prevent late catalog responses from replacing a newer refresh
+    // or retaining this editor after dismissal. Providers settle independently.
+    let active = true, generation = 0, catalogRevision = 0, loaded = false, pending = 0;
+    let catalogError = '';
+    const catalogs = new Map(), failures = new Set();
+    const reload = () => {
+        const epoch = ++generation;
+        if (!active || signal.aborted)
+            return;
+        loaded = true;
+        pending = 0;
+        catalogError = '';
+        failures.clear();
+        catalogRevision++;
+        try {
+            const llm = ctx.get('llm');
+            if (llm === undefined)
+                throw new Error('Model catalog unavailable');
+            const providers = llm.listProviders();
+            for (const id of catalogs.keys())
+                if (!providers.some(provider => provider.id === id))
+                    catalogs.delete(id);
+            pending = providers.length;
+            for (const provider of providers) {
+                void Promise.resolve().then(() => llm.listModels(provider.id)).then(models => {
+                    if (!active || signal.aborted || epoch !== generation)
+                        return;
+                    catalogs.set(provider.id, models.map(model => ({ route: { provider: provider.id, model: model.id }, label: `${model.name ?? model.id} · ${provider.id}` })));
+                }, () => {
+                    if (active && !signal.aborted && epoch === generation)
+                        failures.add(provider.id);
+                }).finally(() => {
+                    if (active && !signal.aborted && epoch === generation) {
+                        pending--;
+                        catalogRevision++;
+                    }
+                });
+            }
+        }
+        catch {
+            catalogError = 'Model catalog could not be loaded. Use Refresh models to retry.';
+        }
+    };
+    const catalogChanged = () => { if (loaded)
+        reload(); };
+    const off = [ctx.on('llm/adapters-updated', catalogChanged), ctx.on('settings/document-updated', catalogChanged)];
+    const catalogStatus = () => [
+        ...(pending ? [text(ctx, 'Loading models…')] : []), ...(catalogError ? [text(ctx, catalogError)] : []),
+        ...(failures.size ? [text(ctx, 'Some model providers could not be loaded. Use Refresh models to retry.') + ' ' + [...failures].join(', ')] : []),
+    ].join('\n');
+    const pickModels = async () => {
+        if (!loaded)
+            reload();
+        const seen = new Map();
+        const current = routes(value(MODELS, 'allowedModels'));
+        for (const route of current)
+            seen.set(routeKey(route), { route, label: `${route.model} · ${route.provider}` });
+        let revision = -1, rows = [];
+        const options = () => {
+            if (revision === catalogRevision)
+                return rows;
+            revision = catalogRevision;
+            const available = new Set();
+            for (const [provider, entries] of catalogs)
+                for (const entry of entries) {
+                    const key = routeKey(entry.route);
+                    seen.set(key, entry);
+                    if (!catalogError && !failures.has(provider))
+                        available.add(key);
+                }
+            // Keep every displayed route until this picker closes, so a refresh cannot
+            // silently drop a checkbox that the user has already toggled.
+            rows = [...seen].map(([key, entry]) => ({ label: entry.label, value: key, description: entry.route.model,
+                ...(!available.has(key) ? { badge: { label: text(ctx, 'Currently unavailable'), tone: 'muted' } } : {}) }));
+            const status = catalogStatus();
+            if (status)
+                rows = [...rows, { label: status, value: '@catalog-status', disabled: true }];
+            return rows;
+        };
+        const answer = await ctx.tui.prompt({ ...list, title: 'Allowed subagent models', question: 'Choose models for the draft',
+            detail: text(ctx, 'Space toggles a model; Enter keeps the selection in the draft. Return to Subagents and use Refresh models to retry a failed catalog.'),
+            filterable: true, multiSelect: true, allowEmptySelection: true, initialValues: current.map(routeKey),
+            emptyText: text(ctx, 'No models are available. Configure a provider or use Refresh models.'), options: options(), refreshOptions: options, signal });
+        if (answer === null || signal.aborted)
+            return;
+        const selected = answer === '' ? [] : answer.split(', ').map(key => {
+            const entry = seen.get(key);
+            if (entry === undefined)
+                throw new Error('Model selection changed. Refresh and retry.');
+            return { ...entry.route };
+        });
+        drafts.get(MODELS).changes.set('allowedModels', selected);
+    };
+    const editNumber = async (ns, field) => {
+        const draft = drafts.get(ns);
+        let input = String(value(ns, field) ?? ''), error = '';
+        while (!signal.aborted) {
+            const raw = await ctx.tui.prompt(askPrompt({ ...list, title: 'Subagents', question: labels[field],
+                detail: [text(ctx, help[field]), text(ctx, error || 'Leave empty to restore inheritance.')].join('\n'), initialInput: input, signal }));
+            if (raw === null)
+                return;
+            input = raw;
+            try {
+                let parsed;
+                if (raw.trim()) {
+                    parsed = Number(raw.trim());
+                    if (!/^\d+$/u.test(raw.trim()) || !Number.isSafeInteger(parsed) || parsed < (field === 'maxDepth' ? 0 : 1))
+                        throw new Error(field === 'maxDepth' ? 'Enter a non-negative whole number.' : 'Enter a positive whole number.');
+                    schema(draft, field)?.(parsed);
+                }
+                draft.changes.set(field, parsed);
+                draft.error = '';
+                return;
+            }
+            catch (cause) {
+                error = cause instanceof Error ? cause.message : String(cause);
+            }
+        }
+    };
+    const restore = async () => {
+        const entries = fields();
+        const selected = await ctx.tui.prompt({ ...list, title: 'Subagents', question: 'Choose a setting to restore',
+            detail: text(ctx, 'Restoring inheritance changes the draft. Apply saves it.'),
+            options: entries.map(({ ns, field, draft }) => ({ label: text(ctx, labels[field]), value: field, description: summary(ns, field, draft) })), signal });
+        const entry = entries.find(entry => entry.field === selected);
+        if (entry !== undefined && !signal.aborted) {
+            entry.draft.changes.set(entry.field, undefined);
+            entry.draft.error = '';
+        }
+    };
+    const save = async () => {
+        // Validate the combined model policy before writing either section.
+        const modelDraft = drafts.get(MODELS);
+        if (modelDraft?.changes.size && value(MODELS, 'enabled') === true && !routes(value(MODELS, 'allowedModels')).length) {
+            modelDraft.error = 'Choose at least one allowed model before enabling subagent model selection.';
+            return false;
+        }
+        let ok = true;
+        for (const [ns, draft] of drafts) {
+            if (!draft.changes.size)
+                continue;
+            try {
+                signal.throwIfAborted();
+                if (!ctx.settings.writable)
+                    throw new Error('This profile is read-only.');
+                if (describe(ctx, ns)?.revision !== draft.section.revision)
+                    throw new Error('Configuration changed. Your draft is kept. Cancel and reopen to load the latest settings.');
+                for (const field of draft.changes.keys())
+                    schema(draft, field)?.(value(ns, field));
+                const ops = [...draft.changes].map(([field, next]) => next === undefined ? { op: 'unset', path: [field] } : { op: 'set', path: [field], value: next });
+                await ctx.settings.mutate(ns, ops, draft.section.revision);
+                draft.changes.clear();
+                draft.error = '';
+                const next = describe(ctx, ns);
+                if (next === undefined)
+                    drafts.delete(ns);
+                else
+                    draft.section = next;
+            }
+            catch (cause) {
+                if (signal.aborted)
+                    return false;
+                ok = false;
+                draft.error = cause instanceof Error ? cause.message : String(cause);
+            }
+        }
+        return ok;
+    };
+    const detail = () => [settingsDraftSummary(ctx, [...drafts.values()].reduce((count, draft) => count + draft.changes.size, 0)), ...[...drafts.values()].filter(draft => draft.error)
+            .map(draft => text(ctx, draft.section.ns === LIMITS ? 'Delegation limits' : 'Subagent models') + ': ' + text(ctx, draft.error))
+            .concat(catalogStatus())].filter(Boolean).join('\n');
+    try {
+        if (resetOnly && ctx.settings.writable)
+            await restore();
+        while (!signal.aborted) {
+            sync();
+            const writable = ctx.settings.writable;
+            const answer = await ctx.tui.prompt({ ...list, title: 'Subagents', question: 'Edit the draft, then Apply to save',
+                detail: detail(), refreshDocument: detail,
+                options: [...fields().map(({ ns, field, draft }) => ({ label: text(ctx, labels[field]), value: field, description: summary(ns, field, draft), preview: text(ctx, help[field]), disabled: !writable })),
+                    { label: text(ctx, 'Restore inherited setting…'), value: 'restore', disabled: !writable },
+                    ...(drafts.has(MODELS) ? [{ label: text(ctx, 'Refresh models'), value: 'refresh' }] : []),
+                    { label: text(ctx, 'Apply'), value: 'apply', disabled: !writable || !drafts.size }, { label: text(ctx, 'Cancel'), value: 'cancel' }], signal });
+            if (answer === null || answer === 'cancel' || signal.aborted)
+                return;
+            if (answer === 'refresh') {
+                reload();
+                continue;
+            }
+            if (!ctx.settings.writable)
+                continue;
+            try {
+                const entry = fields().find(entry => entry.field === answer);
+                if (answer === 'restore')
+                    await restore();
+                else if (answer === 'apply') {
+                    if (await save()) {
+                        ctx.tui.notice('Subagent settings saved.');
+                        return;
+                    }
+                }
+                else if (entry !== undefined) {
+                    if (answer === 'allowedModels')
+                        await pickModels();
+                    else if (answer === 'enabled') {
+                        const choice = await ctx.tui.prompt({ ...list, title: 'Subagents', question: 'Model selection', detail: text(ctx, help.enabled),
+                            initialValue: value(MODELS, 'enabled') ? 'on' : 'off', options: [{ label: text(ctx, 'Enabled'), value: 'on' }, { label: text(ctx, 'Disabled'), value: 'off' }], signal });
+                        if (choice !== null && !signal.aborted)
+                            entry.draft.changes.set('enabled', choice === 'on');
+                    }
+                    else
+                        await editNumber(entry.ns, answer);
+                }
+            }
+            catch (cause) {
+                if (signal.aborted)
+                    return;
+                ctx.tui.notice(cause instanceof Error ? text(ctx, cause.message) : String(cause), { level: 'error' });
+            }
+        }
+    }
+    finally {
+        active = false;
+        generation++;
+        for (const dispose of off)
+            dispose();
+    }
+}
+//# sourceMappingURL=subagent-settings.js.map

package/lib/runtime/subagent-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-settings.js","sourceRoot":"","sources":["../../src/runtime/subagent-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAK1D,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE9D,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,GAAG,mCAAmC,CAAA;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAsC;IACzE,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;CACrF,CAAA;AACD,MAAM,MAAM,GAA2B,EAAE,QAAQ,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAA;AAChL,MAAM,IAAI,GAA2B;IACnC,QAAQ,EAAE,gJAAgJ;IAC1J,kBAAkB,EAAE,2IAA2I;IAC/J,OAAO,EAAE,oJAAoJ;IAC7J,aAAa,EAAE,gHAAgH;CAChI,CAAA;AACD,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,EAAW,CAAA;AACvG,MAAM,MAAM,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;AACxK,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;AACpH,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAE,EAAU,EAAkC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAEhK,MAAM,MAAM,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAgB,EAAE,CAAC,OAAO,GAAG,EAAE,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAChL,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAU,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAG5G,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,EAAE,CAAA;IAC5E,OAAO,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,qBAAqB;YACtM,QAAQ,EAAE,CAAC,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,wEAAwE,EAAE,CAAC,CAAA;AACrJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAY,EAAE,MAAmB,EAAE,SAAS,GAAG,KAAK;IAC7F,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;IACvC,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,KAAK,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACzD,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI;gBAAE,SAAQ;YACjC,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;;gBACvC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC,CAAA;IACD,IAAI,EAAE,CAAA;IACN,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO;QAAE,OAAM;IAC1C,MAAM,MAAM,GAAG,CAAC,KAAY,EAAE,KAAa,EAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAoB,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAA;IACtH,MAAM,MAAM,GAAG,GAAkD,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;SAC1I,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAA,CAAC,CAAC,CAAC;SAC7H,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,KAAa,EAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;IACnI,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,KAAa,EAAW,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;IAClK,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,KAAY,EAAU,EAAE;QAClE,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACpK,OAAO,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAC5J,CAAC,CAAA;IAED,kFAAkF;IAClF,4EAA4E;IAC5E,IAAI,MAAM,GAAG,IAAI,EAAE,UAAU,GAAG,CAAC,EAAE,eAAe,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,CAAC,CAAA;IACnF,IAAI,YAAY,GAAG,EAAE,CAAA;IACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6C,EAAE,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IACnG,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,MAAM,KAAK,GAAG,EAAE,UAAU,CAAA;QAC1B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO;YAAE,OAAM;QACrC,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,GAAG,CAAC,CAAC;QAAC,YAAY,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAAC,eAAe,EAAE,CAAA;QAClF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC1B,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;YACnE,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,EAAE,CAAA;YACrC,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE;gBAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC1G,OAAO,GAAG,SAAS,CAAC,MAAM,CAAA;YAC1B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBAC3E,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,KAAK,UAAU;wBAAE,OAAM;oBAC7D,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,MAAM,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;gBAC9J,CAAC,EAAE,GAAG,EAAE;oBACN,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,KAAK,UAAU;wBAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;gBAClF,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;oBACd,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;wBAAC,OAAO,EAAE,CAAC;wBAAC,eAAe,EAAE,CAAA;oBAAC,CAAC;gBACzF,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YAAC,YAAY,GAAG,iEAAiE,CAAA;QAAC,CAAC;IAC9F,CAAC,CAAA;IACD,MAAM,cAAc,GAAG,GAAS,EAAE,GAAG,IAAI,MAAM;QAAE,MAAM,EAAE,CAAA,CAAC,CAAC,CAAA;IAC3D,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,sBAAsB,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC,CAAA;IACjH,MAAM,aAAa,GAAG,GAAW,EAAE,CAAC;QAClC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,wEAAwE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QAC3C,IAAI,CAAC,MAAM;YAAE,MAAM,EAAE,CAAA;QACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2C,CAAA;QAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC9G,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,IAAI,GAAsC,EAAE,CAAA;QAC/D,MAAM,OAAO,GAAG,GAAsC,EAAE;YACtD,IAAI,QAAQ,KAAK,eAAe;gBAAE,OAAO,IAAI,CAAA;YAC7C,QAAQ,GAAG,eAAe,CAAA;YAC1B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;YACnC,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,QAAQ;gBAAE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;oBACjC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;oBACpB,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBAClE,CAAC;YACD,2EAA2E;YAC3E,8DAA8D;YAC9D,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;gBACtG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtH,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;YAC9B,IAAI,MAAM;gBAAE,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YACzF,OAAO,IAAI,CAAA;QACb,CAAC,CAAA;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,6BAA6B;YACtH,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,sIAAsI,CAAC;YACzJ,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YACpG,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,sEAAsE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QACtJ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO;YAAE,OAAM;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACjE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC3B,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;YACvF,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;QAC3B,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IAC5D,CAAC,CAAA;IACD,MAAM,UAAU,GAAG,KAAK,EAAE,EAAU,EAAE,KAAa,EAAiB,EAAE;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,CAAA;QAC7B,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,CAAA;QACtD,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAE;gBAChG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YAC1I,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,KAAK,GAAG,GAAG,CAAA;YACX,IAAI,CAAC;gBACH,IAAI,MAA0B,CAAA;gBAC9B,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;oBACf,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;oBAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAA;oBAC3N,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;gBAChC,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;gBAAC,OAAM;YAC5D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;QACpF,CAAC;IACH,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAA;QACxB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,6BAA6B;YAC1G,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,0DAA0D,CAAC;YAC7E,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACzJ,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAA;QAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;QAAC,CAAC;IACzH,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,KAAK,IAAsB,EAAE;QACxC,oEAAoE;QACpE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACpH,UAAU,CAAC,KAAK,GAAG,6EAA6E,CAAA;YAChG,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,EAAE,GAAG,IAAI,CAAA;QACb,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI;gBAAE,SAAQ;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,cAAc,EAAE,CAAA;gBACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;gBACzE,IAAI,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,QAAQ,KAAK,KAAK,CAAC,OAAO,CAAC,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAA;gBACxK,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;oBAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAA;gBAClF,MAAM,GAAG,GAAqB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;gBACxK,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;gBACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;gBAC9B,IAAI,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;;oBACpC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,KAAK,CAAA;gBAChC,EAAE,GAAG,KAAK,CAAC;gBAAC,KAAK,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAClF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;aACxL,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;aAC9H,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtD,IAAI,CAAC;QACH,IAAI,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ;YAAE,MAAM,OAAO,EAAE,CAAA;QACvD,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,EAAE,CAAA;YACN,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAA;YACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,oCAAoC;gBAC/G,MAAM,EAAE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM;gBACzC,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACtM,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE;oBACzF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzF,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACnJ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAM;YACpE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC;gBAAC,SAAQ;YAAC,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ;gBAAE,SAAQ;YACpC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;gBAC5D,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,OAAO,EAAE,CAAA;qBACpC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC5B,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;wBAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;wBAAC,OAAM;oBAAC,CAAC;gBAC1E,CAAC;qBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,MAAM,KAAK,eAAe;wBAAE,MAAM,UAAU,EAAE,CAAA;yBAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;wBAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAQ,CAAC;4BAC9H,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;wBAC3K,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;4BAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,CAAA;oBAC7F,CAAC;;wBAAM,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAM;gBAC1B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;YACvG,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,MAAM,GAAG,KAAK,CAAC;QAAC,UAAU,EAAE,CAAC;QAAC,KAAK,MAAM,OAAO,IAAI,GAAG;YAAE,OAAO,EAAE,CAAA;IAAC,CAAC;AAClF,CAAC"}

package/lib/runtime/terminal-modes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Terminal modes the TUI turns on, owned in one place so they are always
+ * given back.
+ *
+ * Every mode is a pair of sequences. The controller remembers which modes are
+ * on, in the order they were turned on, and gives them all back — in reverse —
+ * when the terminal is handed to someone else (`Ctrl+Z`, an external editor),
+ * when the session ends, or when the process exits without disposing. Taking
+ * the terminal back re-enables the same set. A mode added or removed while the
+ * terminal is handed off is recorded and applied on the way back, so no caller
+ * has to know whether the terminal is currently ours.
+ * @module @agi-fans/dsh-tui/terminal-modes
+ */
+/** One reversible terminal mode. */
+export interface TerminalMode {
+    readonly enable: string;
+    readonly disable: string;
+}
+/** Bracketed paste (DEC 2004). */
+export declare const BRACKETED_PASTE: TerminalMode;
+/** Focus in/out reports (DEC 1004). */
+export declare const FOCUS_REPORTING: TerminalMode;
+/** Button, drag and wheel reports in SGR encoding (DEC 1000, 1002, 1006). */
+export declare const MOUSE_TRACKING: TerminalMode;
+/** One entry on the Kitty keyboard stack with the disambiguate flag. */
+export declare const KITTY_KEYBOARD: TerminalMode;
+/** Named modes, applied in insertion order and given back in reverse. */
+export declare class TerminalModes {
+    #private;
+    constructor(write: (bytes: string) => void);
+    /** Whether the terminal is currently handed to another program. */
+    get handedOff(): boolean;
+    /** Whether `name` is on (or will be on once the terminal is taken back). */
+    has(name: string): boolean;
+    /** Turn one mode on; a mode that is already on is left alone. */
+    enable(name: string, mode: TerminalMode): void;
+    /** Record a mode as on without writing, for a push deferred to another screen. */
+    adopt(name: string, mode: TerminalMode): void;
+    /** Turn one mode off; a mode that is not on is left alone. */
+    disable(name: string): void;
+    /** Give every mode back, keeping the set, before another program owns the terminal. */
+    handOff(): void;
+    /** Re-enable the recorded set once the terminal is ours again. */
+    takeBack(): void;
+    /** Give every mode back for good. Safe to call more than once. */
+    release(): void;
+}

package/lib/runtime/terminal-modes.js

@@ -0,0 +1,86 @@
+/**
+ * Terminal modes the TUI turns on, owned in one place so they are always
+ * given back.
+ *
+ * Every mode is a pair of sequences. The controller remembers which modes are
+ * on, in the order they were turned on, and gives them all back — in reverse —
+ * when the terminal is handed to someone else (`Ctrl+Z`, an external editor),
+ * when the session ends, or when the process exits without disposing. Taking
+ * the terminal back re-enables the same set. A mode added or removed while the
+ * terminal is handed off is recorded and applied on the way back, so no caller
+ * has to know whether the terminal is currently ours.
+ * @module @agi-fans/dsh-tui/terminal-modes
+ */
+import { KITTY_PROTOCOL_OFF, KITTY_PROTOCOL_ON } from "./terminal-probe.js";
+/** Bracketed paste (DEC 2004). */
+export const BRACKETED_PASTE = { enable: '\x1b[?2004h', disable: '\x1b[?2004l' };
+/** Focus in/out reports (DEC 1004). */
+export const FOCUS_REPORTING = { enable: '\x1b[?1004h', disable: '\x1b[?1004l' };
+/** Button, drag and wheel reports in SGR encoding (DEC 1000, 1002, 1006). */
+export const MOUSE_TRACKING = {
+    enable: '\x1b[?1000h\x1b[?1002h\x1b[?1006h',
+    disable: '\x1b[?1006l\x1b[?1002l\x1b[?1000l',
+};
+/** One entry on the Kitty keyboard stack with the disambiguate flag. */
+export const KITTY_KEYBOARD = { enable: KITTY_PROTOCOL_ON, disable: KITTY_PROTOCOL_OFF };
+/** Named modes, applied in insertion order and given back in reverse. */
+export class TerminalModes {
+    #write;
+    #active = new Map();
+    #handedOff = false;
+    constructor(write) {
+        this.#write = write;
+    }
+    /** Whether the terminal is currently handed to another program. */
+    get handedOff() { return this.#handedOff; }
+    /** Whether `name` is on (or will be on once the terminal is taken back). */
+    has(name) { return this.#active.has(name); }
+    /** Turn one mode on; a mode that is already on is left alone. */
+    enable(name, mode) {
+        if (this.#active.has(name))
+            return;
+        this.#active.set(name, mode);
+        if (!this.#handedOff)
+            this.#write(mode.enable);
+    }
+    /** Record a mode as on without writing, for a push deferred to another screen. */
+    adopt(name, mode) {
+        if (!this.#active.has(name))
+            this.#active.set(name, mode);
+    }
+    /** Turn one mode off; a mode that is not on is left alone. */
+    disable(name) {
+        const mode = this.#active.get(name);
+        if (mode === undefined)
+            return;
+        this.#active.delete(name);
+        if (!this.#handedOff)
+            this.#write(mode.disable);
+    }
+    /** Give every mode back, keeping the set, before another program owns the terminal. */
+    handOff() {
+        if (this.#handedOff)
+            return;
+        this.#handedOff = true;
+        this.#write(this.#disableAll());
+    }
+    /** Re-enable the recorded set once the terminal is ours again. */
+    takeBack() {
+        if (!this.#handedOff)
+            return;
+        this.#handedOff = false;
+        this.#write([...this.#active.values()].map(mode => mode.enable).join(''));
+    }
+    /** Give every mode back for good. Safe to call more than once. */
+    release() {
+        const bytes = this.#handedOff ? '' : this.#disableAll();
+        this.#active.clear();
+        this.#handedOff = false;
+        if (bytes !== '')
+            this.#write(bytes);
+    }
+    #disableAll() {
+        return [...this.#active.values()].reverse().map(mode => mode.disable).join('');
+    }
+}
+//# sourceMappingURL=terminal-modes.js.map

package/lib/runtime/terminal-modes.js.map

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

package/lib/runtime/terminal-notifications.d.ts

@@ -1,10 +1,13 @@
+import { type UiLanguage } from '../locale/index.ts';
 /** Opt-in terminal notifications kept outside the transcript renderer. */
-export type TerminalNotificationPolicy = 'off' | 'long-running' | 'always';
+export type TerminalNotificationPolicy = 'off' | 'unfocused' | 'always';
 export interface TerminalNotificationOptions {
+    readonly language?: UiLanguage;
     readonly policy: TerminalNotificationPolicy;
     readonly thresholdMs: number;
 }
 export interface TerminalNotification {
+    readonly attention?: boolean;
     readonly title: string;
     readonly body: string;
 }
@@ -20,15 +23,13 @@ export declare class TerminalNotificationController {
     event(event: NotificationEvent, now?: number): TerminalNotification | undefined;
     humanPrompt(label?: string): TerminalNotification | undefined;
 }
-export type NotificationFocus = 'always' | 'unfocused';
 /** Keep one notification per event burst, with input requests and failures first. */
 export declare class TerminalNotificationQueue {
     #private;
     offer(notification: TerminalNotification): void;
     clear(): void;
-    take(condition: NotificationFocus, focused: boolean | undefined): TerminalNotification | undefined;
+    /** Drain the coalesced event. Whether it should be delivered is the caller's policy. */
+    take(): TerminalNotification | undefined;
 }
 /** OSC 9 is supported by common terminal emulators and never enters screen text. */
 export declare function terminalNotificationSequence(notification: TerminalNotification): string;
-/** Windows Terminal-compatible native taskbar/tab progress sequences. */
-export declare function terminalProgressSequence(active: boolean): string;