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

package/dist/run-options.d.ts

@@ -0,0 +1,128 @@
+/**
+ * RunOptions interface and validation for @a5c-ai/agent-mux.
+ *
+ * Defines the full set of options accepted by `AgentMuxClient.run()`
+ * and the validation logic that enforces spec constraints.
+ */
+import type { AgentName, Attachment, InputRequiredEvent, ApprovalRequestEvent, McpServerConfig, RetryPolicy } from './types.js';
+import type { RuntimeHooks } from './runtime-hooks.js';
+import type { InvocationMode } from './invocation.js';
+export { PROHIBITED_PROFILE_FIELDS, validateProfileData, } from './run-options-validation.js';
+/**
+ * Full configuration for a single agent run.
+ *
+ * Only `agent` and `prompt` are required; all other fields are optional
+ * and fall back to profile, client, or global defaults.
+ */
+export interface RunOptions {
+    /** The agent to invoke. */
+    agent: AgentName;
+    /** The prompt to send to the agent. */
+    prompt: string | string[];
+    /** System prompt text to inject. */
+    systemPrompt?: string;
+    /** How to combine the system prompt with the agent's default. */
+    systemPromptMode?: 'prepend' | 'append' | 'replace';
+    /** File or data attachments to include with the prompt. */
+    attachments?: Attachment[];
+    /** Model identifier (agent-specific). */
+    model?: string;
+    /** Thinking effort level. */
+    thinkingEffort?: 'low' | 'medium' | 'high' | 'max';
+    /** Thinking budget in tokens. Must be >= 1024. */
+    thinkingBudgetTokens?: number;
+    /** Override thinking behavior entirely (agent-specific). */
+    thinkingOverride?: Record<string, unknown>;
+    /** Sampling temperature. Must be in [0, 2]. */
+    temperature?: number;
+    /** Top-P nucleus sampling. Must be in [0, 1]. */
+    topP?: number;
+    /** Top-K sampling. Must be an integer >= 1. */
+    topK?: number;
+    /** Maximum tokens for the response. Must be >= 1. */
+    maxTokens?: number;
+    /** Maximum output tokens (alias). Must be >= 1. */
+    maxOutputTokens?: number;
+    /** Resume an existing session by ID. Mutually exclusive with forkSessionId and noSession. */
+    sessionId?: string;
+    /** Fork from an existing session. Mutually exclusive with sessionId and noSession. */
+    forkSessionId?: string;
+    /** Start with no session context. Mutually exclusive with sessionId and forkSessionId. */
+    noSession?: boolean;
+    /** Enable streaming. */
+    stream?: boolean | 'auto';
+    /** Output format. */
+    outputFormat?: 'text' | 'json' | 'jsonl';
+    /** Force headless one-shot prompt delivery instead of stdin-driven interactive transport. */
+    nonInteractive?: boolean;
+    /**
+     * Spawn the harness with a real PTY (via node-pty) so it gets a TTY for
+     * interactive features (colors, prompt input, tool approval UIs).
+     * Output is tee'd through the event parser so hooks still fire.
+     */
+    interactive?: boolean;
+    /** Working directory for the agent process. Must be an absolute path. */
+    cwd?: string;
+    /** Additional environment variables for the agent process. */
+    env?: Record<string, string>;
+    /** Overall run timeout in milliseconds. Must be a non-negative integer. */
+    timeout?: number;
+    /** Inactivity timeout in milliseconds. Must be a non-negative integer. */
+    inactivityTimeout?: number;
+    /** Maximum number of agent turns. Must be >= 1. */
+    maxTurns?: number;
+    /** Approval mode for tool calls and file operations. */
+    approvalMode?: 'yolo' | 'prompt' | 'deny';
+    /** Callback invoked when the agent requires user input. Returns the input text. */
+    onInputRequired?: (event: InputRequiredEvent) => Promise<string>;
+    /** Callback invoked when the agent requests tool call approval. Returns the decision. */
+    onApprovalRequest?: (event: ApprovalRequestEvent) => Promise<'approve' | 'deny'>;
+    /** In-process runtime hooks for this run only. */
+    hooks?: RuntimeHooks;
+    /** Skills to load for this run. */
+    skills?: string[];
+    /** Path or content for the agents doc. */
+    agentsDoc?: string;
+    /** MCP server configurations for this run. */
+    mcpServers?: McpServerConfig[];
+    /** Retry policy for transient failures. */
+    retryPolicy?: RetryPolicy;
+    /** Explicit run ID (ULID format, 26 Crockford base32 chars). */
+    runId?: string;
+    /** Tags for run indexing and filtering. */
+    tags?: string[];
+    /** Project ID for multi-project setups. */
+    projectId?: string;
+    /** Named profile to apply as a base layer. Must match `^[a-zA-Z0-9_-]{1,64}$`. */
+    profile?: string;
+    /** Whether to collect all events in memory. */
+    collectEvents?: boolean;
+    /** Grace period in milliseconds for cleanup on abort. */
+    gracePeriodMs?: number;
+    /** Invocation mode — how to spawn the underlying process (local, docker, ssh, k8s). */
+    invocation?: InvocationMode;
+    /** Provider configuration for model/provider selection. */
+    providerConfig?: import('./provider-config.js').ProviderConfig;
+    /** Named provider profile from ~/.amux/providers.json. */
+    providerProfile?: string;
+}
+/**
+ * Handle returned by `AgentMuxClient.run()`.
+ *
+ * Full implementation lives in run-handle.ts. Re-exported here for
+ * backwards compatibility with imports from run-options.
+ */
+export type { RunHandle } from './run-handle.js';
+/**
+ * Validate RunOptions according to the spec validation order.
+ *
+ * Validation order:
+ * 1. Session mutual exclusivity
+ * 2. Required fields (agent, prompt non-empty)
+ * 3. Range validation for numeric/enum fields
+ * 4. Attachment validation
+ * 5. McpServerConfig validation
+ *
+ * @throws ValidationError if any fields are invalid.
+ */
+export declare function validateRunOptions(options: RunOptions): void;

package/dist/run-options.d.ts.map

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

package/dist/run-options.js

@@ -0,0 +1,329 @@
+/**
+ * RunOptions interface and validation for @a5c-ai/agent-mux.
+ *
+ * Defines the full set of options accepted by `AgentMuxClient.run()`
+ * and the validation logic that enforces spec constraints.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ValidationError } from './errors.js';
+import { VALID_ERROR_CODES, PROFILE_NAME_RE, MCP_NAME_RE, ULID_RE, } from './run-options-validation.js';
+export { PROHIBITED_PROFILE_FIELDS, validateProfileData, } from './run-options-validation.js';
+// ---------------------------------------------------------------------------
+// validateRunOptions (§6.4)
+// ---------------------------------------------------------------------------
+/**
+ * Validate RunOptions according to the spec validation order.
+ *
+ * Validation order:
+ * 1. Session mutual exclusivity
+ * 2. Required fields (agent, prompt non-empty)
+ * 3. Range validation for numeric/enum fields
+ * 4. Attachment validation
+ * 5. McpServerConfig validation
+ *
+ * @throws ValidationError if any fields are invalid.
+ */
+export function validateRunOptions(options) {
+    // §6.4: Validation stops at the first failure group.
+    // 1. Session mutual exclusivity (§6.1 — per-pair error messages)
+    {
+        const errors = [];
+        const hasSession = options.sessionId !== undefined;
+        const hasFork = options.forkSessionId !== undefined;
+        const hasNoSession = options.noSession === true;
+        if (hasSession && hasNoSession) {
+            errors.push({
+                field: 'sessionId',
+                message: 'sessionId and noSession are mutually exclusive',
+                received: { sessionId: options.sessionId, noSession: options.noSession },
+                expected: 'mutually exclusive',
+            });
+        }
+        if (hasSession && hasFork) {
+            errors.push({
+                field: 'sessionId',
+                message: 'sessionId and forkSessionId are mutually exclusive',
+                received: { sessionId: options.sessionId, forkSessionId: options.forkSessionId },
+                expected: 'mutually exclusive',
+            });
+        }
+        if (hasFork && hasNoSession) {
+            errors.push({
+                field: 'forkSessionId',
+                message: 'forkSessionId and noSession are mutually exclusive',
+                received: { forkSessionId: options.forkSessionId, noSession: options.noSession },
+                expected: 'mutually exclusive',
+            });
+        }
+        if (errors.length > 0)
+            throw new ValidationError(errors);
+    }
+    // 2. Required fields
+    {
+        const errors = [];
+        if (!options.agent || (typeof options.agent === 'string' && options.agent.trim() === '')) {
+            errors.push({
+                field: 'agent',
+                message: 'is required and must be a non-empty string',
+                received: options.agent,
+                expected: 'AgentName (non-empty string)',
+            });
+        }
+        if (options.prompt === undefined || options.prompt === null) {
+            errors.push({
+                field: 'prompt',
+                message: 'is required',
+                received: options.prompt,
+                expected: 'string | string[] (non-empty)',
+            });
+        }
+        else if (typeof options.prompt === 'string') {
+            if (options.prompt.trim() === '') {
+                errors.push({
+                    field: 'prompt',
+                    message: 'must not be empty',
+                    received: options.prompt,
+                    expected: 'non-empty string',
+                });
+            }
+        }
+        else if (Array.isArray(options.prompt)) {
+            if (options.prompt.length === 0 || options.prompt.every(s => s.trim() === '')) {
+                errors.push({
+                    field: 'prompt',
+                    message: 'must not be empty',
+                    received: options.prompt,
+                    expected: 'non-empty string[]',
+                });
+            }
+        }
+        if (errors.length > 0)
+            throw new ValidationError(errors);
+    }
+    // 3. Range validation for numeric/enum fields
+    const errors = [];
+    if (options.temperature !== undefined) {
+        if (typeof options.temperature !== 'number' || !Number.isFinite(options.temperature) || options.temperature < 0 || options.temperature > 2) {
+            errors.push({ field: 'temperature', message: 'must be a number in [0, 2]', received: options.temperature, expected: '[0, 2]' });
+        }
+    }
+    if (options.topP !== undefined) {
+        if (typeof options.topP !== 'number' || !Number.isFinite(options.topP) || options.topP < 0 || options.topP > 1) {
+            errors.push({ field: 'topP', message: 'must be a number in [0, 1]', received: options.topP, expected: '[0, 1]' });
+        }
+    }
+    if (options.topK !== undefined) {
+        if (typeof options.topK !== 'number' || !Number.isFinite(options.topK) || options.topK < 1 || !Number.isInteger(options.topK)) {
+            errors.push({ field: 'topK', message: 'must be an integer >= 1', received: options.topK, expected: '>= 1 (integer)' });
+        }
+    }
+    if (options.maxTokens !== undefined) {
+        if (typeof options.maxTokens !== 'number' || !Number.isFinite(options.maxTokens) || options.maxTokens < 1 || !Number.isInteger(options.maxTokens)) {
+            errors.push({ field: 'maxTokens', message: 'must be an integer >= 1', received: options.maxTokens, expected: '>= 1 (integer)' });
+        }
+    }
+    if (options.maxOutputTokens !== undefined) {
+        if (typeof options.maxOutputTokens !== 'number' || !Number.isFinite(options.maxOutputTokens) || options.maxOutputTokens < 1 || !Number.isInteger(options.maxOutputTokens)) {
+            errors.push({ field: 'maxOutputTokens', message: 'must be an integer >= 1', received: options.maxOutputTokens, expected: '>= 1 (integer)' });
+        }
+    }
+    if (options.thinkingBudgetTokens !== undefined) {
+        if (typeof options.thinkingBudgetTokens !== 'number' || !Number.isFinite(options.thinkingBudgetTokens) || options.thinkingBudgetTokens < 1024 || !Number.isInteger(options.thinkingBudgetTokens)) {
+            errors.push({ field: 'thinkingBudgetTokens', message: 'must be an integer >= 1024', received: options.thinkingBudgetTokens, expected: '>= 1024 (integer)' });
+        }
+    }
+    if (options.timeout !== undefined) {
+        if (typeof options.timeout !== 'number' || !Number.isFinite(options.timeout) || options.timeout < 0 || !Number.isInteger(options.timeout)) {
+            errors.push({ field: 'timeout', message: 'must be a non-negative integer', received: options.timeout, expected: '>= 0 (integer, ms)' });
+        }
+    }
+    if (options.inactivityTimeout !== undefined) {
+        if (typeof options.inactivityTimeout !== 'number' || !Number.isFinite(options.inactivityTimeout) || options.inactivityTimeout < 0 || !Number.isInteger(options.inactivityTimeout)) {
+            errors.push({ field: 'inactivityTimeout', message: 'must be a non-negative integer', received: options.inactivityTimeout, expected: '>= 0 (integer, ms)' });
+        }
+    }
+    if (options.maxTurns !== undefined) {
+        if (typeof options.maxTurns !== 'number' || !Number.isFinite(options.maxTurns) || options.maxTurns < 1 || !Number.isInteger(options.maxTurns)) {
+            errors.push({ field: 'maxTurns', message: 'must be an integer >= 1', received: options.maxTurns, expected: '>= 1 (integer)' });
+        }
+    }
+    // Enum validations
+    if (options.approvalMode !== undefined) {
+        const valid = ['yolo', 'prompt', 'deny'];
+        if (!valid.includes(options.approvalMode)) {
+            errors.push({ field: 'approvalMode', message: 'must be one of: yolo, prompt, deny', received: options.approvalMode, expected: "'yolo' | 'prompt' | 'deny'" });
+        }
+    }
+    if (options.stream !== undefined) {
+        if (options.stream !== true && options.stream !== false && options.stream !== 'auto') {
+            errors.push({ field: 'stream', message: "must be true, false, or 'auto'", received: options.stream, expected: "boolean | 'auto'" });
+        }
+    }
+    if (options.systemPromptMode !== undefined) {
+        const valid = ['prepend', 'append', 'replace'];
+        if (!valid.includes(options.systemPromptMode)) {
+            errors.push({ field: 'systemPromptMode', message: 'must be one of: prepend, append, replace', received: options.systemPromptMode, expected: "'prepend' | 'append' | 'replace'" });
+        }
+    }
+    if (options.outputFormat !== undefined) {
+        const valid = ['text', 'json', 'jsonl'];
+        if (!valid.includes(options.outputFormat)) {
+            errors.push({ field: 'outputFormat', message: 'must be one of: text, json, jsonl', received: options.outputFormat, expected: "'text' | 'json' | 'jsonl'" });
+        }
+    }
+    if (options.thinkingEffort !== undefined) {
+        const valid = ['low', 'medium', 'high', 'max'];
+        if (!valid.includes(options.thinkingEffort)) {
+            errors.push({ field: 'thinkingEffort', message: 'must be one of: low, medium, high, max', received: options.thinkingEffort, expected: "'low' | 'medium' | 'high' | 'max'" });
+        }
+    }
+    // env values must be strings
+    if (options.env !== undefined) {
+        for (const [key, val] of Object.entries(options.env)) {
+            if (typeof val !== 'string') {
+                errors.push({ field: `env.${key}`, message: 'values must be strings', received: val, expected: 'string' });
+            }
+        }
+    }
+    // cwd must be absolute and the directory must exist
+    if (options.cwd !== undefined) {
+        if (!path.isAbsolute(options.cwd)) {
+            errors.push({ field: 'cwd', message: 'must be an absolute path', received: options.cwd, expected: 'Absolute path' });
+        }
+        else {
+            try {
+                const stat = fs.statSync(options.cwd);
+                if (!stat.isDirectory()) {
+                    errors.push({ field: 'cwd', message: 'must be an existing directory', received: options.cwd, expected: 'existing directory' });
+                }
+            }
+            catch {
+                errors.push({ field: 'cwd', message: 'must be an existing directory', received: options.cwd, expected: 'existing directory' });
+            }
+        }
+    }
+    // profile name pattern
+    if (options.profile !== undefined) {
+        if (!PROFILE_NAME_RE.test(options.profile)) {
+            errors.push({ field: 'profile', message: 'must match ^[a-zA-Z0-9_-]{1,64}$', received: options.profile, expected: '^[a-zA-Z0-9_-]{1,64}$' });
+        }
+    }
+    // runId ULID format
+    if (options.runId !== undefined) {
+        if (!ULID_RE.test(options.runId)) {
+            errors.push({ field: 'runId', message: 'must be a valid ULID (26 Crockford base32 characters)', received: options.runId, expected: '26-char Crockford base32 ULID' });
+        }
+    }
+    // 4. Attachment validation
+    if (options.attachments !== undefined) {
+        if (!Array.isArray(options.attachments)) {
+            errors.push({ field: 'attachments', message: 'must be an array', received: options.attachments, expected: 'Attachment[]' });
+        }
+        else {
+            for (let i = 0; i < options.attachments.length; i++) {
+                const att = options.attachments[i];
+                const prefix = `attachments[${i}]`;
+                const sourceCount = [att.filePath, att.url, att.base64].filter((s) => s !== undefined).length;
+                if (sourceCount !== 1) {
+                    errors.push({ field: prefix, message: 'must have exactly one source (filePath, url, or base64)', received: att, expected: 'exactly one of filePath | url | base64' });
+                }
+                if (att.base64 !== undefined && !att.mimeType) {
+                    errors.push({ field: `${prefix}.mimeType`, message: 'is required when base64 is set', received: att.mimeType, expected: 'string (MIME type)' });
+                }
+                if (att.filePath !== undefined) {
+                    if (!path.isAbsolute(att.filePath)) {
+                        errors.push({ field: `${prefix}.filePath`, message: 'must be an absolute path', received: att.filePath, expected: 'Absolute path' });
+                    }
+                    else {
+                        try {
+                            fs.accessSync(att.filePath, fs.constants.R_OK);
+                        }
+                        catch {
+                            errors.push({ field: `${prefix}.filePath`, message: 'file must exist and be readable', received: att.filePath, expected: 'existing readable file' });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // 5. McpServerConfig validation
+    if (options.mcpServers !== undefined) {
+        if (!Array.isArray(options.mcpServers)) {
+            errors.push({ field: 'mcpServers', message: 'must be an array', received: options.mcpServers, expected: 'McpServerConfig[]' });
+        }
+        else {
+            for (let i = 0; i < options.mcpServers.length; i++) {
+                const srv = options.mcpServers[i];
+                const prefix = `mcpServers[${i}]`;
+                if (!MCP_NAME_RE.test(srv.name)) {
+                    errors.push({ field: `${prefix}.name`, message: 'must match ^[a-zA-Z0-9_-]{1,64}$', received: srv.name, expected: '^[a-zA-Z0-9_-]{1,64}$' });
+                }
+                const validTransports = ['stdio', 'sse', 'streamable-http'];
+                if (!validTransports.includes(srv.transport)) {
+                    errors.push({ field: `${prefix}.transport`, message: 'must be one of: stdio, sse, streamable-http', received: srv.transport, expected: "'stdio' | 'sse' | 'streamable-http'" });
+                }
+                if (srv.transport === 'stdio' && !srv.command) {
+                    errors.push({ field: `${prefix}.command`, message: 'is required for stdio transport', received: srv.command, expected: 'string' });
+                }
+                if ((srv.transport === 'sse' || srv.transport === 'streamable-http') && !srv.url) {
+                    errors.push({ field: `${prefix}.url`, message: `is required for ${srv.transport} transport`, received: srv.url, expected: 'string (URL)' });
+                }
+                // Validate env values are strings
+                if (srv.env !== undefined) {
+                    for (const [key, val] of Object.entries(srv.env)) {
+                        if (typeof val !== 'string') {
+                            errors.push({ field: `${prefix}.env.${key}`, message: 'values must be strings', received: val, expected: 'string' });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // gracePeriodMs validation
+    if (options.gracePeriodMs !== undefined) {
+        if (typeof options.gracePeriodMs !== 'number' || !Number.isFinite(options.gracePeriodMs) || options.gracePeriodMs < 0 || !Number.isInteger(options.gracePeriodMs)) {
+            errors.push({ field: 'gracePeriodMs', message: 'must be a non-negative integer', received: options.gracePeriodMs, expected: '>= 0 (integer, ms)' });
+        }
+    }
+    // retryPolicy validation
+    if (options.retryPolicy !== undefined) {
+        const rp = options.retryPolicy;
+        if (rp.maxAttempts !== undefined && (typeof rp.maxAttempts !== 'number' || !Number.isFinite(rp.maxAttempts) || rp.maxAttempts < 1 || !Number.isInteger(rp.maxAttempts))) {
+            errors.push({ field: 'retryPolicy.maxAttempts', message: 'must be an integer >= 1', received: rp.maxAttempts, expected: '>= 1 (integer)' });
+        }
+        if (rp.baseDelayMs !== undefined && (typeof rp.baseDelayMs !== 'number' || !Number.isFinite(rp.baseDelayMs) || rp.baseDelayMs < 0 || !Number.isInteger(rp.baseDelayMs))) {
+            errors.push({ field: 'retryPolicy.baseDelayMs', message: 'must be a non-negative integer', received: rp.baseDelayMs, expected: '>= 0 (integer)' });
+        }
+        if (rp.maxDelayMs !== undefined && (typeof rp.maxDelayMs !== 'number' || !Number.isFinite(rp.maxDelayMs) || rp.maxDelayMs < 0 || !Number.isInteger(rp.maxDelayMs))) {
+            errors.push({ field: 'retryPolicy.maxDelayMs', message: 'must be a non-negative integer', received: rp.maxDelayMs, expected: '>= 0 (integer)' });
+        }
+        // Cross-field: maxDelayMs >= baseDelayMs (using defaults)
+        {
+            const effectiveBase = rp.baseDelayMs ?? 1000;
+            const effectiveMax = rp.maxDelayMs ?? 30_000;
+            if (effectiveMax < effectiveBase) {
+                errors.push({ field: 'retryPolicy.maxDelayMs', message: 'must be >= baseDelayMs', received: rp.maxDelayMs ?? effectiveMax, expected: `>= ${effectiveBase}` });
+            }
+        }
+        if (rp.jitterFactor !== undefined && (typeof rp.jitterFactor !== 'number' || !Number.isFinite(rp.jitterFactor) || rp.jitterFactor < 0 || rp.jitterFactor > 1)) {
+            errors.push({ field: 'retryPolicy.jitterFactor', message: 'must be between 0.0 and 1.0', received: rp.jitterFactor, expected: '[0.0, 1.0]' });
+        }
+        if (rp.retryOn !== undefined) {
+            if (!Array.isArray(rp.retryOn)) {
+                errors.push({ field: 'retryPolicy.retryOn', message: 'must be an array of ErrorCode strings', received: rp.retryOn, expected: 'ErrorCode[]' });
+            }
+            else {
+                for (const code of rp.retryOn) {
+                    if (!VALID_ERROR_CODES.has(code)) {
+                        errors.push({ field: 'retryPolicy.retryOn', message: `invalid error code: ${String(code)}`, received: code, expected: 'ErrorCode' });
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new ValidationError(errors);
+    }
+}
+//# sourceMappingURL=run-options.js.map

package/dist/run-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-options.js","sourceRoot":"","sources":["../src/run-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAalC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,OAAO,GACR,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AA6LrC,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmB;IACpD,qDAAqD;IAErD,iEAAiE;IACjE,CAAC;QACC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC;QACpD,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;QAEhD,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,gDAAgD;gBACzD,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;gBACxE,QAAQ,EAAE,oBAAoB;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,oDAAoD;gBAC7D,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;gBAChF,QAAQ,EAAE,oBAAoB;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,eAAe;gBACtB,OAAO,EAAE,oDAAoD;gBAC7D,QAAQ,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;gBAChF,QAAQ,EAAE,oBAAoB;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,qBAAqB;IACrB,CAAC;QACC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACzF,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,4CAA4C;gBACrD,QAAQ,EAAE,OAAO,CAAC,KAAK;gBACvB,QAAQ,EAAE,8BAA8B;aACzC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,aAAa;gBACtB,QAAQ,EAAE,OAAO,CAAC,MAAM;gBACxB,QAAQ,EAAE,+BAA+B;aAC1C,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,mBAAmB;oBAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM;oBACxB,QAAQ,EAAE,kBAAkB;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC9E,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,mBAAmB;oBAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM;oBACxB,QAAQ,EAAE,oBAAoB;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,8CAA8C;IAC9C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YAC3I,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC/G,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9H,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACzH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAClJ,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnI,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YAC1K,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC/I,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC/C,IAAI,OAAO,OAAO,CAAC,oBAAoB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACjM,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,OAAO,CAAC,oBAAoB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC/J,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1I,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC5C,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAClL,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,OAAO,CAAC,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC9J,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9I,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACjI,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,oCAAoC,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAChK,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACrF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,0CAA0C,EAAE,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,QAAQ,EAAE,kCAAkC,EAAE,CAAC,CAAC;QACpL,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,mCAAmC,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAC9J,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,wCAAwC,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,mCAAmC,EAAE,CAAC,CAAC;QAC/K,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7G,CAAC;QACH,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;QACvH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBACjI,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACjI,CAAC;QACH,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,kCAAkC,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC/I,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,uDAAuD,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;QACxK,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;QAC9H,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC;gBACnC,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;gBAC9F,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yDAAyD,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBACxK,CAAC;gBACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBAClJ,CAAC;gBACD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;oBACvI,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC;4BACH,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBACjD,CAAC;wBAAC,MAAM,CAAC;4BACP,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,EAAE,CAAC,CAAC;wBACvJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACjI,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC;gBAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,EAAE,OAAO,EAAE,kCAAkC,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC,CAAC;gBAC/I,CAAC;gBACD,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;gBAC5D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,EAAE,OAAO,EAAE,6CAA6C,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,qCAAqC,EAAE,CAAC,CAAC;gBAClL,CAAC;gBACD,IAAI,GAAG,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,EAAE,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACrI,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,KAAK,IAAI,GAAG,CAAC,SAAS,KAAK,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACjF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC9I,CAAC;gBACD,kCAAkC;gBAClC,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;oBAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;4BAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,GAAG,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;wBACvH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClK,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACtJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACxK,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC9I,CAAC;QACD,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACxK,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACrJ,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACnK,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnJ,CAAC;QACD,0DAA0D;QAC1D,CAAC;YACC,MAAM,aAAa,GAAG,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC;YAC7C,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC;YAC7C,IAAI,YAAY,GAAG,aAAa,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,EAAE,CAAC,UAAU,IAAI,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;YAChK,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9J,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,6BAA6B,EAAE,QAAQ,EAAE,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAChJ,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,uCAAuC,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;YACjJ,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;oBAC9B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAiB,CAAC,EAAE,CAAC;wBAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,uBAAuB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;oBACvI,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/runtime-hook-dispatcher.d.ts

@@ -0,0 +1,19 @@
+import type { AgentEvent } from './events.js';
+import type { HookDecision, RuntimeHookKind, RuntimeHookMode, RuntimeHooks } from './runtime-hooks.js';
+export interface RuntimeHookDispatcherOptions {
+    hooks?: RuntimeHooks;
+    runId: string;
+    agent: string;
+    emit(event: AgentEvent): void | Promise<void>;
+}
+/**
+ * Dispatches per-run runtime hooks and lets them inject synthetic run events.
+ */
+export declare class RuntimeHookDispatcher {
+    private readonly hooks?;
+    readonly runId: string;
+    readonly agent: string;
+    private readonly emitEvent;
+    constructor(options: RuntimeHookDispatcherOptions);
+    dispatch(kind: RuntimeHookKind, payload: unknown, signal: AbortSignal, mode: Exclude<RuntimeHookMode, 'unsupported'>): Promise<HookDecision | void>;
+}

package/dist/runtime-hook-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hook-dispatcher.d.ts","sourceRoot":"","sources":["../src/runtime-hook-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAID;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAe;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;gBAErD,OAAO,EAAE,4BAA4B;IAO3C,QAAQ,CACZ,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC,GAC5C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAqChC"}

package/dist/runtime-hook-dispatcher.js

@@ -0,0 +1,50 @@
+const ALLOW = { decision: 'allow' };
+/**
+ * Dispatches per-run runtime hooks and lets them inject synthetic run events.
+ */
+export class RuntimeHookDispatcher {
+    hooks;
+    runId;
+    agent;
+    emitEvent;
+    constructor(options) {
+        this.hooks = options.hooks;
+        this.runId = options.runId;
+        this.agent = options.agent;
+        this.emitEvent = options.emit;
+    }
+    async dispatch(kind, payload, signal, mode) {
+        const handler = this.hooks?.[kind];
+        if (!handler) {
+            return mode === 'blocking' ? ALLOW : undefined;
+        }
+        const context = {
+            signal,
+            emit: async (event) => {
+                await this.emitEvent({ ...event, source: 'hook' });
+            },
+        };
+        if (mode === 'blocking') {
+            try {
+                return await handler(payload, context);
+            }
+            catch (error) {
+                return {
+                    decision: 'deny',
+                    reason: error instanceof Error ? error.message : String(error),
+                };
+            }
+        }
+        void Promise.resolve(handler(payload, context)).catch(async (error) => {
+            await context.emit({
+                type: 'debug',
+                runId: this.runId,
+                agent: this.agent,
+                timestamp: Date.now(),
+                level: 'warn',
+                message: `runtime hook ${kind} failed: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        });
+    }
+}
+//# sourceMappingURL=runtime-hook-dispatcher.js.map

package/dist/runtime-hook-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hook-dispatcher.js","sourceRoot":"","sources":["../src/runtime-hook-dispatcher.ts"],"names":[],"mappings":"AAeA,MAAM,KAAK,GAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,KAAK,CAAgB;IAC7B,KAAK,CAAS;IACd,KAAK,CAAS;IACN,SAAS,CAAuC;IAEjE,YAAY,OAAqC;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAqB,EACrB,OAAgB,EAChB,MAAmB,EACnB,IAA6C;QAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAEpB,CAAC;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAG;YACd,MAAM;YACN,IAAI,EAAE,KAAK,EAAE,KAAiB,EAAiB,EAAE;gBAC/C,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAgB,CAAC,CAAC;YACnE,CAAC;SACF,CAAC;QAEF,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAiB,CAAC;YACzD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,QAAQ,EAAE,MAAM;oBAChB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACpE,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAA4B;gBACxC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,gBAAgB,IAAI,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACpF,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runtime-hooks.d.ts

@@ -0,0 +1,47 @@
+import type { AgentEvent } from './events.js';
+/** Runtime hook kinds supported by agent-mux. */
+export type RuntimeHookKind = 'preToolUse' | 'postToolUse' | 'sessionStart' | 'sessionEnd' | 'stop' | 'userPromptSubmit';
+/** How an adapter supports a given runtime hook kind. */
+export type RuntimeHookMode = 'unsupported' | 'nonblocking' | 'blocking';
+/** Adapter capability declaration for runtime hooks. */
+export interface RuntimeHookCapabilities {
+    preToolUse: RuntimeHookMode;
+    postToolUse: RuntimeHookMode;
+    sessionStart: RuntimeHookMode;
+    sessionEnd: RuntimeHookMode;
+    stop: RuntimeHookMode;
+    userPromptSubmit: RuntimeHookMode;
+}
+/** Context passed to runtime hook handlers. */
+export interface HookContext {
+    signal: AbortSignal;
+    emit(event: AgentEvent): void | Promise<void>;
+}
+/** Decision returned by blocking runtime hooks. */
+export type HookDecision = {
+    decision: 'allow';
+} | {
+    decision: 'deny';
+    reason?: string;
+};
+/** Handler invoked before a tool executes. */
+export type PreToolUseHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<HookDecision> | HookDecision;
+/** Handler invoked when the user submits a prompt. */
+export type UserPromptSubmitHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<HookDecision> | HookDecision;
+/** Handler invoked for non-blocking runtime hook notifications. */
+export type NotificationHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<void> | void;
+/** Per-run runtime hooks attached through RunOptions. */
+export interface RuntimeHooks {
+    preToolUse?: PreToolUseHook;
+    postToolUse?: NotificationHook;
+    sessionStart?: NotificationHook;
+    sessionEnd?: NotificationHook;
+    stop?: NotificationHook;
+    userPromptSubmit?: UserPromptSubmitHook;
+}
+/** Optional native harness bridge returned by adapters that support runtime hooks. */
+export interface RuntimeHookSetup {
+    env?: Record<string, string>;
+    cleanup?: () => Promise<void> | void;
+}
+export type { RuntimeHookDispatcher } from './runtime-hook-dispatcher.js';

package/dist/runtime-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hooks.d.ts","sourceRoot":"","sources":["../src/runtime-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,aAAa,GACb,cAAc,GACd,YAAY,GACZ,MAAM,GACN,kBAAkB,CAAC;AAEvB,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;AAEzE,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EAAE,eAAe,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,mDAAmD;AACnD,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,EAAE,OAAO,CAAC;CACnB,GACD;IACE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,8CAA8C;AAC9C,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,IAAI,CAC/C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,CAAC,QAAQ,GAAG,OAAO,IAAI,CACrD,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,CAAC,QAAQ,GAAG,OAAO,IAAI,CACjD,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtC;AAED,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/runtime-hooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-hooks.js.map

package/dist/runtime-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hooks.js","sourceRoot":"","sources":["../src/runtime-hooks.ts"],"names":[],"mappings":""}

package/dist/schema/__tests__/event-schema.test.d.ts

@@ -0,0 +1 @@
+export {};