@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/process-tracker.js

@@ -0,0 +1,96 @@
+/**
+ * ProcessTracker singleton for zombie prevention.
+ *
+ * Maintains a set of all active subprocess PIDs and their metadata.
+ * On Node.js exit, all tracked processes are forcefully terminated.
+ *
+ * Per spec §6.4: handlers are installed once, on first register() call.
+ */
+// ---------------------------------------------------------------------------
+// ProcessTrackerImpl
+// ---------------------------------------------------------------------------
+class ProcessTrackerImpl {
+    _tracked = new Map();
+    _handlersInstalled = false;
+    get activeCount() {
+        return this._tracked.size;
+    }
+    register(pid, groupId, runId) {
+        this._tracked.set(pid, { pid, groupId, runId });
+        if (!this._handlersInstalled) {
+            this._installHandlers();
+            this._handlersInstalled = true;
+        }
+    }
+    unregister(pid) {
+        this._tracked.delete(pid);
+    }
+    killAll() {
+        const isUnix = process.platform !== 'win32';
+        // Phase 1: send SIGINT to each process group (Unix) or SIGTERM to PID (Windows).
+        for (const proc of this._tracked.values()) {
+            try {
+                if (isUnix && proc.groupId > 0) {
+                    // Kill the entire process group on Unix (negative PID).
+                    process.kill(-proc.groupId, 'SIGINT');
+                }
+                else {
+                    process.kill(proc.pid, 'SIGTERM');
+                }
+            }
+            catch {
+                // Process may have already exited — ignore.
+            }
+        }
+        // Phase 2: synchronous grace wait then SIGKILL.
+        // In the `exit` handler context this is synchronous — we cannot
+        // use setTimeout. We do a best-effort busy-wait then SIGKILL.
+        // Real async two-phase shutdown is handled by RunHandleImpl.abort().
+        // Here we are in the "process is dying" path — be aggressive.
+        for (const proc of this._tracked.values()) {
+            try {
+                if (isUnix && proc.groupId > 0) {
+                    process.kill(-proc.groupId, 'SIGKILL');
+                }
+                else {
+                    process.kill(proc.pid, 'SIGKILL');
+                }
+            }
+            catch {
+                // Already exited — fine.
+            }
+        }
+        this._tracked.clear();
+    }
+    _installHandlers() {
+        // Synchronous kill on exit
+        process.on('exit', () => {
+            this.killAll();
+        });
+        // Signal handlers — per spec §6.4, installed for SIGTERM and SIGINT.
+        // On Windows, Node.js emits these for Ctrl+C and taskkill.
+        const signalHandler = () => {
+            this.killAll();
+            process.exit(1);
+        };
+        process.on('SIGTERM', signalHandler);
+        process.on('SIGINT', signalHandler);
+        // Uncaught errors: cleanup then rethrow
+        process.on('uncaughtException', (err) => {
+            this.killAll();
+            throw err;
+        });
+        process.on('unhandledRejection', (reason) => {
+            this.killAll();
+            if (reason instanceof Error)
+                throw reason;
+            throw new Error(String(reason));
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Module-level singleton
+// ---------------------------------------------------------------------------
+/** Global ProcessTracker singleton. */
+export const processTracker = new ProcessTrackerImpl();
+//# sourceMappingURL=process-tracker.js.map

package/dist/process-tracker.js.map

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

package/dist/profiles.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Profile management for @a5c-ai/agent-mux.
+ *
+ * Profiles are named RunOptions presets stored as JSON files in the
+ * global config directory (`~/.agent-mux/profiles/`) or the project
+ * config directory (`.agent-mux/profiles/`).
+ *
+ * @see 02-run-options-and-profiles.md §10
+ */
+import type { AgentName, ProfileData } from './types.js';
+import type { StoragePaths } from './storage.js';
+import type { RunOptions } from './run-options.js';
+/** Options for filtering profile listings. */
+export interface ProfileListOptions {
+    /** Filter by scope. If omitted, both global and project profiles are listed. */
+    scope?: 'global' | 'project';
+}
+/** Metadata for a single profile entry in a listing. */
+export interface ProfileEntry {
+    /** Profile name (filename without `.json` extension). */
+    name: string;
+    /** Where this profile is stored. `'project'` if present in both. */
+    scope: 'global' | 'project';
+    /** Whether a global profile is also present (only relevant for project scope). */
+    hasGlobalOverride: boolean;
+    /** The agent specified in this profile, if any. */
+    agent?: AgentName;
+    /** The model specified in this profile, if any. */
+    model?: string;
+    /** `true` if the profile file exists but could not be parsed. */
+    corrupt?: boolean;
+}
+/** A resolved profile: the merged result of global + project data. */
+export interface ResolvedProfile {
+    /** Profile name. */
+    name: string;
+    /** The resolved profile data after merging global and project layers. */
+    data: ProfileData;
+    /** Source scope of the resolved profile. */
+    scope: 'global' | 'project';
+    /** Absolute path to the global profile file, if it exists. */
+    globalPath?: string;
+    /** Absolute path to the project profile file, if it exists. */
+    projectPath?: string;
+}
+/** Options for writing a profile. */
+export interface ProfileSetOptions {
+    /**
+     * Target scope for the profile file.
+     * @default 'project' (if a project directory exists, else 'global')
+     */
+    scope?: 'global' | 'project';
+}
+/** Options for deleting a profile. */
+export interface ProfileDeleteOptions {
+    /**
+     * Target scope to delete from.
+     * If undefined, prefers project scope: deletes from project if found there,
+     * else falls back to global.
+     */
+    scope?: 'global' | 'project';
+}
+/**
+ * Manages named RunOptions presets (profiles).
+ *
+ * @see 02-run-options-and-profiles.md §10
+ */
+export interface ProfileManager {
+    /** List all available profiles, sorted by name. */
+    list(options?: ProfileListOptions): Promise<ProfileEntry[]>;
+    /** Show the resolved contents of a named profile. */
+    show(name: string): Promise<ResolvedProfile>;
+    /** Create or update a named profile. */
+    set(name: string, data: ProfileData, options?: ProfileSetOptions): Promise<void>;
+    /** Delete a named profile. */
+    delete(name: string, options?: ProfileDeleteOptions): Promise<void>;
+    /** Apply a profile to partial RunOptions, returning the merged result. */
+    apply(name: string, overrides?: Partial<RunOptions>): Promise<Partial<RunOptions>>;
+}
+/** Implementation of the ProfileManager interface. */
+export declare class ProfileManagerImpl implements ProfileManager {
+    private readonly globalProfilesDir;
+    private readonly projectProfilesDir;
+    constructor(storagePaths: StoragePaths);
+    list(options?: ProfileListOptions): Promise<ProfileEntry[]>;
+    show(name: string): Promise<ResolvedProfile>;
+    set(name: string, data: ProfileData, options?: ProfileSetOptions): Promise<void>;
+    delete(name: string, options?: ProfileDeleteOptions): Promise<void>;
+    apply(name: string, overrides?: Partial<RunOptions>): Promise<Partial<RunOptions>>;
+    private resolveDefaultScope;
+    private deleteFile;
+    private listDir;
+    /**
+     * Read and parse a profile JSON file.
+     * Returns null if the file does not exist.
+     * Returns { corrupt: true } for unparseable files (§12.5).
+     */
+    private readProfileFile;
+}

package/dist/profiles.d.ts.map

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

package/dist/profiles.js

@@ -0,0 +1,231 @@
+/**
+ * Profile management for @a5c-ai/agent-mux.
+ *
+ * Profiles are named RunOptions presets stored as JSON files in the
+ * global config directory (`~/.agent-mux/profiles/`) or the project
+ * config directory (`.agent-mux/profiles/`).
+ *
+ * @see 02-run-options-and-profiles.md §10
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { AgentMuxError, ValidationError } from './errors.js';
+import { validateProfileData } from './run-options.js';
+import { deepMerge } from './merge.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Profile name validation pattern. */
+const PROFILE_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+// ---------------------------------------------------------------------------
+// ProfileManagerImpl
+// ---------------------------------------------------------------------------
+/** Implementation of the ProfileManager interface. */
+export class ProfileManagerImpl {
+    globalProfilesDir;
+    projectProfilesDir;
+    constructor(storagePaths) {
+        this.globalProfilesDir = storagePaths.globalProfilesDir;
+        this.projectProfilesDir = storagePaths.projectProfilesDir;
+    }
+    async list(options) {
+        const globalEntries = (!options?.scope || options.scope === 'global')
+            ? this.listDir(this.globalProfilesDir, 'global')
+            : [];
+        const projectEntries = (!options?.scope || options.scope === 'project')
+            ? this.listDir(this.projectProfilesDir, 'project')
+            : [];
+        // Build map: global first, project overrides
+        const byName = new Map();
+        const globalNames = new Set();
+        for (const entry of globalEntries) {
+            globalNames.add(entry.name);
+            byName.set(entry.name, entry);
+        }
+        for (const entry of projectEntries) {
+            const hasGlobal = globalNames.has(entry.name);
+            entry.hasGlobalOverride = hasGlobal;
+            if (hasGlobal && !entry.corrupt) {
+                // Merge global data into the project entry for agent/model display
+                const globalEntry = byName.get(entry.name);
+                if (!globalEntry.corrupt) {
+                    // agent/model: project wins if set, else falls back to global
+                    entry.agent = entry.agent ?? globalEntry.agent;
+                    entry.model = entry.model ?? globalEntry.model;
+                }
+            }
+            byName.set(entry.name, entry);
+        }
+        // Sort by name
+        return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    async show(name) {
+        validateProfileName(name);
+        const globalPath = path.join(this.globalProfilesDir, `${name}.json`);
+        const projectPath = path.join(this.projectProfilesDir, `${name}.json`);
+        const globalResult = this.readProfileFile(globalPath);
+        const projectResult = this.readProfileFile(projectPath);
+        if (globalResult === null && projectResult === null) {
+            throw new AgentMuxError('PROFILE_NOT_FOUND', `Profile "${name}" not found`);
+        }
+        // Throw CONFIG_ERROR for corrupt files (§12.5)
+        if (globalResult?.corrupt) {
+            throw new AgentMuxError('CONFIG_ERROR', `Profile "${name}" at ${globalPath} is corrupt: invalid JSON`);
+        }
+        if (projectResult?.corrupt) {
+            throw new AgentMuxError('CONFIG_ERROR', `Profile "${name}" at ${projectPath} is corrupt: invalid JSON`);
+        }
+        let merged = {};
+        let scope = 'global';
+        if (globalResult?.data) {
+            merged = globalResult.data;
+        }
+        if (projectResult?.data) {
+            merged = deepMerge(merged, projectResult.data);
+            scope = 'project';
+        }
+        return {
+            name,
+            data: merged,
+            scope,
+            globalPath: globalResult ? globalPath : undefined,
+            projectPath: projectResult ? projectPath : undefined,
+        };
+    }
+    async set(name, data, options) {
+        validateProfileName(name);
+        validateProfileData(data);
+        const scope = options?.scope ?? this.resolveDefaultScope();
+        const dir = scope === 'global' ? this.globalProfilesDir : this.projectProfilesDir;
+        const filePath = path.join(dir, `${name}.json`);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    async delete(name, options) {
+        validateProfileName(name);
+        if (options?.scope) {
+            // Explicit scope
+            const dir = options.scope === 'global' ? this.globalProfilesDir : this.projectProfilesDir;
+            this.deleteFile(path.join(dir, `${name}.json`), name, options.scope);
+        }
+        else {
+            // Prefer project scope
+            const projectPath = path.join(this.projectProfilesDir, `${name}.json`);
+            if (fs.existsSync(projectPath)) {
+                this.deleteFile(projectPath, name, 'project');
+            }
+            else {
+                const globalPath = path.join(this.globalProfilesDir, `${name}.json`);
+                this.deleteFile(globalPath, name, 'global');
+            }
+        }
+    }
+    async apply(name, overrides) {
+        const resolved = await this.show(name);
+        if (overrides) {
+            return deepMerge(resolved.data, overrides);
+        }
+        return resolved.data;
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    resolveDefaultScope() {
+        try {
+            fs.statSync(this.projectProfilesDir);
+            return 'project';
+        }
+        catch {
+            // If project dir doesn't exist, check parent
+            try {
+                const parent = path.dirname(this.projectProfilesDir);
+                fs.statSync(parent);
+                return 'project';
+            }
+            catch {
+                return 'global';
+            }
+        }
+    }
+    deleteFile(filePath, name, scope) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new AgentMuxError('PROFILE_NOT_FOUND', `Profile "${name}" not found in ${scope} scope`);
+            }
+            throw err;
+        }
+    }
+    listDir(dir, scope) {
+        const entries = [];
+        try {
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                if (file.endsWith('.json')) {
+                    const name = file.slice(0, -5);
+                    if (PROFILE_NAME_RE.test(name)) {
+                        const filePath = path.join(dir, file);
+                        const result = this.readProfileFile(filePath);
+                        if (result?.corrupt) {
+                            entries.push({ name, scope, hasGlobalOverride: false, corrupt: true });
+                        }
+                        else {
+                            const data = result?.data;
+                            entries.push({
+                                name,
+                                scope,
+                                hasGlobalOverride: false,
+                                agent: data?.agent,
+                                model: data?.model,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory does not exist — no profiles in this scope
+        }
+        return entries;
+    }
+    /**
+     * Read and parse a profile JSON file.
+     * Returns null if the file does not exist.
+     * Returns { corrupt: true } for unparseable files (§12.5).
+     */
+    readProfileFile(filePath) {
+        let raw;
+        try {
+            raw = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null; // File does not exist
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                return { corrupt: true };
+            }
+            return { data: parsed };
+        }
+        catch {
+            return { corrupt: true };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function validateProfileName(name) {
+    if (!PROFILE_NAME_RE.test(name)) {
+        throw new ValidationError([{
+                field: 'name',
+                message: 'must match ^[a-zA-Z0-9_-]{1,64}$',
+                received: name,
+                expected: 'string matching ^[a-zA-Z0-9_-]{1,64}$',
+            }]);
+    }
+}
+//# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

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

package/dist/programmatic-runner.d.ts

@@ -0,0 +1,4 @@
+import type { ProgrammaticAdapter } from './adapter-types.js';
+import type { RunOptions } from './run-options.js';
+import { RunHandleImpl } from './run-handle-impl.js';
+export declare function startProgrammaticLoop(handle: RunHandleImpl, adapter: ProgrammaticAdapter, options: RunOptions): void;

package/dist/programmatic-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmatic-runner.d.ts","sourceRoot":"","sources":["../src/programmatic-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,UAAU,GAClB,IAAI,CAIN"}

package/dist/programmatic-runner.js

@@ -0,0 +1,110 @@
+import { AgentMuxError } from './errors.js';
+export function startProgrammaticLoop(handle, adapter, options) {
+    queueMicrotask(() => {
+        void runProgrammatic(handle, adapter, options);
+    });
+}
+async function runProgrammatic(handle, adapter, options) {
+    let aborted = false;
+    let runTimeout = null;
+    let inactivityTimeout = null;
+    let stream = null;
+    const clearTimers = () => {
+        if (runTimeout)
+            clearTimeout(runTimeout);
+        if (inactivityTimeout)
+            clearTimeout(inactivityTimeout);
+    };
+    const resetInactivity = () => {
+        if (!options.inactivityTimeout || options.inactivityTimeout <= 0)
+            return;
+        if (inactivityTimeout)
+            clearTimeout(inactivityTimeout);
+        inactivityTimeout = setTimeout(() => {
+            aborted = true;
+            void handle.abort();
+        }, options.inactivityTimeout);
+    };
+    if (options.timeout && options.timeout > 0) {
+        runTimeout = setTimeout(() => {
+            aborted = true;
+            void handle.abort();
+        }, options.timeout);
+    }
+    const originalAbort = handle.abort.bind(handle);
+    handle.abort = async () => {
+        aborted = true;
+        clearTimers();
+        if (stream && typeof stream.close === 'function') {
+            try {
+                await stream.close();
+            }
+            catch {
+                // Ignore cleanup errors.
+            }
+        }
+        try {
+            await originalAbort();
+        }
+        catch {
+            // Ignore double-finalization races.
+        }
+    };
+    const originalInterrupt = handle.interrupt.bind(handle);
+    handle.interrupt = async () => {
+        if (stream && typeof stream.interrupt === 'function') {
+            await stream.interrupt();
+        }
+        await originalInterrupt();
+    };
+    try {
+        handle.transitionTo('running');
+    }
+    catch {
+        // Ignore if already transitioned.
+    }
+    try {
+        resetInactivity();
+        stream = adapter.execute(options);
+        handle.bindInputTransport(async (text) => {
+            if (!adapter.capabilities.supportsStdinInjection || typeof stream?.send !== 'function') {
+                throw new AgentMuxError('STDIN_NOT_AVAILABLE', `${adapter.agent} does not support live prompt injection in the current agent-mux transport`, false);
+            }
+            await stream.send(text);
+        });
+        handle.bindInteractionTransport(async (interactionId, response) => {
+            if (typeof stream?.respond !== 'function') {
+                throw new AgentMuxError('STDIN_NOT_AVAILABLE', `${adapter.agent} does not support live interaction responses in the current agent-mux transport`, false);
+            }
+            await stream.respond(interactionId, response);
+        });
+        for await (const event of stream) {
+            resetInactivity();
+            handle.emit(event);
+        }
+        clearTimers();
+        handle.complete(aborted ? 'aborted' : 'completed', aborted ? 1 : 0, null);
+    }
+    catch (err) {
+        clearTimers();
+        if (stream && typeof stream.close === 'function') {
+            try {
+                await stream.close();
+            }
+            catch {
+                // Ignore cleanup errors after failures.
+            }
+        }
+        handle.emit({
+            type: 'error',
+            runId: handle.runId,
+            agent: handle.agent,
+            timestamp: Date.now(),
+            code: 'INTERNAL',
+            message: err instanceof Error ? err.message : String(err),
+            recoverable: false,
+        });
+        handle.complete(aborted ? 'aborted' : 'crashed', null, null);
+    }
+}
+//# sourceMappingURL=programmatic-runner.js.map

package/dist/programmatic-runner.js.map

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

package/dist/provider-config.d.ts

@@ -0,0 +1,40 @@
+export type ProviderId = 'anthropic' | 'openai' | 'google' | 'bedrock' | 'vertex' | 'azure' | 'foundry' | 'ollama' | 'local' | 'openrouter' | 'groq' | 'fireworks' | 'together' | 'deepseek' | 'mistral' | 'cerebras' | 'sambanova' | 'custom' | 'lmstudio' | 'vllm' | 'nvidia-nim' | 'perplexity' | 'cohere';
+export type TransportId = 'anthropic' | 'openai-chat' | 'openai-responses' | 'google' | 'passthrough' | 'bedrock-converse' | 'vertex-native' | 'azure-foundry';
+export interface ProviderAuth {
+    type: 'api_key' | 'oauth' | 'iam' | 'adc' | 'service_account' | 'spn' | 'bearer' | 'none' | 'command';
+    apiKey?: string;
+    token?: string;
+    command?: string;
+    awsProfile?: string;
+    awsRoleArn?: string;
+    awsSessionToken?: string;
+    gcpCredentialsFile?: string;
+    azureTenantId?: string;
+    azureClientId?: string;
+    azureClientSecret?: string;
+}
+export interface ProviderConfig {
+    provider: ProviderId;
+    model: string;
+    transport: TransportId;
+    auth: ProviderAuth;
+    params: Record<string, unknown>;
+}
+export interface ProviderDefaults {
+    transport: TransportId;
+    authType: ProviderAuth['type'];
+    apiBase: string;
+    defaultModel: string;
+    envKey?: string;
+}
+export declare const PROVIDER_DEFAULTS: Record<ProviderId, ProviderDefaults>;
+/**
+ * Maps canonical model IDs to provider-specific formats.
+ * Keys are canonical model IDs, values map ProviderId → provider-specific ID.
+ */
+export declare const MODEL_TRANSLATION_TABLE: Record<string, Partial<Record<ProviderId, string>>>;
+/**
+ * Translate a canonical model ID to the provider-specific format.
+ * Returns the original model ID if no translation exists.
+ */
+export declare function translateModelId(canonical: string, provider: ProviderId): string;

package/dist/provider-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.d.ts","sourceRoot":"","sources":["../src/provider-config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GACxD,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GACvD,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAC1D,UAAU,GAAG,WAAW,GAAG,QAAQ,GACnC,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,WAAW,GACnB,WAAW,GAAG,aAAa,GAAG,kBAAkB,GAAG,QAAQ,GAC3D,aAAa,GAAG,kBAAkB,GAAG,eAAe,GAAG,eAAe,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,WAAW,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAwBlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CA0BvF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAIhF"}