uxnan-bridge 0.0.1-alpha.20260621

package/dist/src/agents/agent-manager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Orchestrates agent turns: routes `turn/send` to the right adapter, persists the
+ * streamed output to the {@link ThreadStore}, and pushes streaming notifications
+ * to connected phones.
+ *
+ * Source: architecture/02a-system-architecture.md §5.2 / §5.8.
+ *
+ * FOR-DEV: the agent is currently chosen by a single `defaultAgent`; resolve it
+ * per project/thread from the project's AgentConfig once project management lands
+ * (src/agents/agent-manager.ts).
+ */
+import { type AccessMode, type AgentDescriptor, type AgentId, type AgentModel, type ApprovalDecision, type IAgentAdapter, type TurnAttachment } from '@uxnan/shared';
+import type { ThreadStore } from '../conversation/thread-store.js';
+import type { Logger } from '../logger.js';
+/** Display metadata + availability for a registered adapter, surfaced by `agent/list`. */
+export interface AgentMeta {
+    displayName: string;
+    available: boolean;
+    defaultModel?: string;
+}
+export interface TurnEndInfo {
+    threadId: string;
+    turnId: string;
+    status: 'completed' | 'error';
+    text?: string;
+}
+export interface AgentManagerOptions {
+    store: ThreadStore;
+    /** Broadcast a JSON-RPC notification to connected phones. */
+    notify: (message: unknown) => void;
+    now: () => number;
+    logger: Logger;
+    defaultAgent: AgentId;
+    /** Optional hook fired when a turn completes or errors (e.g. push notifications). */
+    onTurnEnd?: (info: TurnEndInfo) => void;
+}
+export interface SendTurnOptions {
+    agentId?: AgentId;
+    service?: string;
+    effort?: string;
+    /** Chosen per-model run-option values keyed by `AgentModelOption.key`. */
+    options?: Record<string, string | boolean>;
+    /** Inline image attachments delivered to the agent for this turn. */
+    attachments?: TurnAttachment[];
+    cwd?: string;
+    /** The thread's persisted access (approval) mode, applied to this turn. */
+    accessMode?: AccessMode;
+}
+export declare class AgentManager {
+    #private;
+    constructor(options: AgentManagerOptions);
+    register(adapter: IAgentAdapter, meta?: Partial<AgentMeta>): void;
+    hasAdapter(agentId: AgentId): boolean;
+    /** Whether the agent's binary resolved (its CLI is installed/usable). */
+    isAvailable(agentId: AgentId): boolean;
+    /** Registered agents the phone can pick, with capabilities + availability. */
+    listAgents(): AgentDescriptor[];
+    /** The bridge's configured default agent. */
+    get defaultAgent(): AgentId;
+    /** Models the given agent's CLI reports (empty if it can't enumerate them). */
+    getModels(agentId: AgentId): Promise<AgentModel[]>;
+    /** Start a turn: persist the user message, drive the adapter, return the turn id. */
+    sendTurn(threadId: string, userText: string, options?: SendTurnOptions): Promise<{
+        turnId: string;
+    }>;
+    /**
+     * Ask the user (via the phone) whether an agent tool may run. Emits an
+     * `approval` content block on the thread's in-flight turn and resolves once
+     * {@link respondApproval} arrives (or after {@link APPROVAL_TIMEOUT_MS} →
+     * `reject`).
+     *
+     * The return type is the full {@link ApprovalDecision}: callers translate it
+     * into the wire shape their protocol expects — the Claude `PreToolUse` hook
+     * uses `allow`/`deny`, the Codex app-server uses the `ReviewDecision` oneOf
+     * (`approved` / `approved_for_session` / `denied` / `abort` / `timed_out`).
+     * A common pending map + common resolver keeps the phone's reply path
+     * (`turn/send { approvalResponse }`) uniform for both backends.
+     */
+    requestApproval(threadId: string, info: {
+        toolName: string;
+        input: Record<string, unknown>;
+    }): Promise<ApprovalDecision>;
+    /**
+     * Route a user's approval decision. Resolves a pending approval (shared by
+     * the Claude `PreToolUse` hook round-trip AND the Codex app-server
+     * elicitations) with the user's {@link ApprovalDecision}; the caller that
+     * started the request translates that into its protocol's wire shape.
+     * Otherwise, when no hook/app-server approval is pending, forwards to the
+     * agent adapter's `respondApproval` (e.g. the Echo demo) — no new turn is
+     * created. Returns the in-flight turn id (or `''`) so the `turn/send` reply
+     * still carries a `turnId`.
+     */
+    respondApproval(threadId: string, approvalId: string, decision: ApprovalDecision): Promise<{
+        turnId: string;
+    }>;
+    cancelTurn(threadId: string, turnId: string, agentId?: AgentId): Promise<void>;
+    stopAll(): Promise<void>;
+}

package/dist/src/agents/agent-manager.js

@@ -0,0 +1,433 @@
+/**
+ * Orchestrates agent turns: routes `turn/send` to the right adapter, persists the
+ * streamed output to the {@link ThreadStore}, and pushes streaming notifications
+ * to connected phones.
+ *
+ * Source: architecture/02a-system-architecture.md §5.2 / §5.8.
+ *
+ * FOR-DEV: the agent is currently chosen by a single `defaultAgent`; resolve it
+ * per project/thread from the project's AgentConfig once project management lands
+ * (src/agents/agent-manager.ts).
+ */
+import { JsonRpcErrorCode, RpcError, StreamNotification, makeNotification, } from '@uxnan/shared';
+import { rm } from 'node:fs/promises';
+import { materializeAttachments } from './attachments.js';
+import { approvalBlock } from '../adapters/content-blocks.js';
+/** How long a tool approval waits for the user before defaulting to deny. */
+const APPROVAL_TIMEOUT_MS = 5 * 60 * 1000;
+/** Build the `approval` content block for a tool the agent wants to run. */
+function approvalContent(approvalId, toolName, input) {
+    const detail = approvalDetail(input);
+    const action = detail ? `Allow ${toolName}: ${detail}` : `Allow ${toolName}`;
+    const t = toolName.toLowerCase();
+    const risk = t === 'bash' || t === 'write' || t === 'edit' || t.includes('delete') ? 'high' : 'medium';
+    return approvalBlock(approvalId, action, { risk, ...(detail ? { detail } : {}) });
+}
+/** Short human description of a tool's input (command / path) for the card. */
+function approvalDetail(input) {
+    if (!input || typeof input !== 'object')
+        return '';
+    for (const key of ['command', 'file_path', 'path', 'url', 'pattern']) {
+        const value = input[key];
+        if (typeof value === 'string' && value.length > 0) {
+            return value.length > 200 ? `${value.slice(0, 200)}…` : value;
+        }
+    }
+    return '';
+}
+export class AgentManager {
+    #adapters = new Map();
+    #meta = new Map();
+    #started = new Set();
+    #assistantByTurn = new Map();
+    /** threadId → agent driving it, so we can read its native session id on completion. */
+    #agentByThread = new Map();
+    /** threadId → in-flight turn id, so an approval reply can name the turn it answers. */
+    #activeTurnByThread = new Map();
+    /** turnId → temp attachment dir to remove once the turn ends (best-effort). */
+    #attachmentDirByTurn = new Map();
+    /** approvalId → resolver for a pending approval (covers the Claude `PreToolUse`
+     * hook round-trip AND the Codex app-server approval elicitations; the pending
+     * map is shared so a single `respondApproval` call resolves both). The
+     * resolver takes the user's `ApprovalDecision`; the caller (the hook server
+     * or the Codex adapter) translates that into the wire shape its protocol
+     * expects (`'allow' | 'deny'` for the Claude hook, `ReviewDecision` for
+     * Codex). */
+    #pendingHookApprovals = new Map();
+    #approvalSeq = 0;
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    register(adapter, meta) {
+        this.#adapters.set(adapter.agentId, adapter);
+        this.#meta.set(adapter.agentId, {
+            displayName: meta?.displayName ?? adapter.agentId,
+            available: meta?.available ?? true,
+            ...(meta?.defaultModel !== undefined ? { defaultModel: meta.defaultModel } : {}),
+        });
+        adapter.onEvent((event) => {
+            void this.#onEvent(event);
+        });
+    }
+    hasAdapter(agentId) {
+        return this.#adapters.has(agentId);
+    }
+    /** Whether the agent's binary resolved (its CLI is installed/usable). */
+    isAvailable(agentId) {
+        return this.#meta.get(agentId)?.available ?? false;
+    }
+    /** Registered agents the phone can pick, with capabilities + availability. */
+    listAgents() {
+        return [...this.#adapters.values()].map((adapter) => {
+            const meta = this.#meta.get(adapter.agentId);
+            return {
+                agentId: adapter.agentId,
+                displayName: meta?.displayName ?? adapter.agentId,
+                available: meta?.available ?? true,
+                capabilities: adapter.capabilities,
+                ...(meta?.defaultModel !== undefined ? { defaultModel: meta.defaultModel } : {}),
+            };
+        });
+    }
+    /** The bridge's configured default agent. */
+    get defaultAgent() {
+        return this.#options.defaultAgent;
+    }
+    /** Models the given agent's CLI reports (empty if it can't enumerate them). */
+    async getModels(agentId) {
+        const adapter = this.#adapters.get(agentId);
+        if (!adapter?.listModels)
+            return [];
+        try {
+            return await adapter.listModels();
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Start a turn: persist the user message, drive the adapter, return the turn id. */
+    async sendTurn(threadId, userText, options = {}) {
+        const agentId = options.agentId ?? this.#options.defaultAgent;
+        const adapter = this.#adapters.get(agentId);
+        if (!adapter) {
+            throw new RpcError(JsonRpcErrorCode.AgentNotRunning, `no adapter registered for agent '${agentId}'`);
+        }
+        const attachments = options.attachments ?? [];
+        // Persist a faithful user message (no temp paths): the original text, or a
+        // short placeholder for an image-only turn so history isn't a blank bubble.
+        const persistText = userText.length > 0
+            ? userText
+            : attachments.length > 0
+                ? `[${attachments.length} image attachment${attachments.length > 1 ? 's' : ''}]`
+                : userText;
+        const started = await this.#options.store.startTurn(threadId, persistText, this.#options.now());
+        this.#assistantByTurn.set(started.turnId, started.assistantMessageId);
+        this.#agentByThread.set(threadId, agentId);
+        this.#activeTurnByThread.set(threadId, started.turnId);
+        if (!this.#started.has(agentId)) {
+            await adapter.start({ agentId, ...(options.cwd !== undefined ? { cwd: options.cwd } : {}) });
+            this.#started.add(agentId);
+        }
+        // Materialize image attachments to temp files and reference them in the
+        // prompt so any file/vision-capable agent CLI can open them. Best-effort:
+        // a failure to write degrades to a text-only turn, never aborts it.
+        let agentText = userText;
+        if (attachments.length > 0) {
+            try {
+                const materialized = await materializeAttachments(attachments, started.turnId, {
+                    ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+                });
+                if (materialized.note) {
+                    agentText =
+                        userText.length > 0 ? `${userText}\n\n${materialized.note}` : materialized.note;
+                }
+                if (materialized.dir)
+                    this.#attachmentDirByTurn.set(started.turnId, materialized.dir);
+            }
+            catch (err) {
+                this.#options.logger.warn(`attachment materialization failed: ${String(err)}`);
+            }
+        }
+        await adapter.sendTurn({
+            threadId,
+            turnId: started.turnId,
+            text: agentText,
+            ...(options.service !== undefined ? { service: options.service } : {}),
+            ...(options.effort !== undefined ? { effort: options.effort } : {}),
+            ...(options.options !== undefined ? { options: options.options } : {}),
+            ...(attachments.length > 0 ? { attachments } : {}),
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+            ...(options.accessMode !== undefined ? { accessMode: options.accessMode } : {}),
+        });
+        return { turnId: started.turnId };
+    }
+    /**
+     * Ask the user (via the phone) whether an agent tool may run. Emits an
+     * `approval` content block on the thread's in-flight turn and resolves once
+     * {@link respondApproval} arrives (or after {@link APPROVAL_TIMEOUT_MS} →
+     * `reject`).
+     *
+     * The return type is the full {@link ApprovalDecision}: callers translate it
+     * into the wire shape their protocol expects — the Claude `PreToolUse` hook
+     * uses `allow`/`deny`, the Codex app-server uses the `ReviewDecision` oneOf
+     * (`approved` / `approved_for_session` / `denied` / `abort` / `timed_out`).
+     * A common pending map + common resolver keeps the phone's reply path
+     * (`turn/send { approvalResponse }`) uniform for both backends.
+     */
+    async requestApproval(threadId, info) {
+        const turnId = this.#activeTurnByThread.get(threadId);
+        if (!turnId)
+            return 'reject'; // no in-flight turn to attach the approval to
+        const approvalId = `appr-${turnId}-${(this.#approvalSeq += 1)}`;
+        const messageId = this.#assistantByTurn.get(turnId) ?? '';
+        const content = approvalContent(approvalId, info.toolName, info.input);
+        try {
+            await this.#options.store.appendBlock(threadId, turnId, content, this.#options.now());
+        }
+        catch {
+            /* best-effort persistence */
+        }
+        this.#options.notify(makeNotification(StreamNotification.ContentBlock, { threadId, turnId, messageId, content }));
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.#pendingHookApprovals.delete(approvalId);
+                resolve('reject');
+            }, APPROVAL_TIMEOUT_MS);
+            this.#pendingHookApprovals.set(approvalId, { resolve, timer });
+        });
+    }
+    /**
+     * Route a user's approval decision. Resolves a pending approval (shared by
+     * the Claude `PreToolUse` hook round-trip AND the Codex app-server
+     * elicitations) with the user's {@link ApprovalDecision}; the caller that
+     * started the request translates that into its protocol's wire shape.
+     * Otherwise, when no hook/app-server approval is pending, forwards to the
+     * agent adapter's `respondApproval` (e.g. the Echo demo) — no new turn is
+     * created. Returns the in-flight turn id (or `''`) so the `turn/send` reply
+     * still carries a `turnId`.
+     */
+    async respondApproval(threadId, approvalId, decision) {
+        const pending = this.#pendingHookApprovals.get(approvalId);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this.#pendingHookApprovals.delete(approvalId);
+            pending.resolve(decision);
+            return { turnId: this.#activeTurnByThread.get(threadId) ?? '' };
+        }
+        const agentId = this.#agentByThread.get(threadId);
+        const adapter = agentId ? this.#adapters.get(agentId) : undefined;
+        if (!adapter) {
+            throw new RpcError(JsonRpcErrorCode.AgentNotRunning, `no active agent for thread '${threadId}'`);
+        }
+        if (!adapter.respondApproval) {
+            throw new RpcError(JsonRpcErrorCode.InvalidParams, `agent '${agentId}' does not support approvals`);
+        }
+        await adapter.respondApproval(threadId, approvalId, decision);
+        return { turnId: this.#activeTurnByThread.get(threadId) ?? '' };
+    }
+    async cancelTurn(threadId, turnId, agentId) {
+        const adapter = this.#adapters.get(agentId ?? this.#options.defaultAgent);
+        if (adapter) {
+            await adapter.cancelTurn(threadId, turnId);
+        }
+    }
+    async stopAll() {
+        for (const [agentId, adapter] of this.#adapters) {
+            if (this.#started.has(agentId)) {
+                await adapter.stop().catch(() => undefined);
+            }
+        }
+        this.#started.clear();
+    }
+    async #onEvent(event) {
+        const { threadId, turnId } = event;
+        const messageId = this.#assistantByTurn.get(turnId) ?? '';
+        const now = this.#options.now();
+        try {
+            switch (event.type) {
+                case 'turn_started':
+                    this.#options.notify(makeNotification(StreamNotification.TurnStarted, { threadId, turnId }));
+                    break;
+                case 'model_resolved': {
+                    const model = readText(event.data);
+                    if (model) {
+                        this.#options.notify(makeNotification(StreamNotification.ModelResolved, { threadId, turnId, model }));
+                    }
+                    break;
+                }
+                case 'delta': {
+                    const delta = readText(event.data);
+                    await this.#options.store.appendDelta(threadId, turnId, delta, now);
+                    this.#options.notify(makeNotification(StreamNotification.MessageDelta, {
+                        threadId,
+                        turnId,
+                        messageId,
+                        delta,
+                    }));
+                    break;
+                }
+                case 'thinking': {
+                    const delta = readText(event.data);
+                    await this.#options.store.appendThinking(threadId, turnId, delta, now);
+                    this.#options.notify(makeNotification(StreamNotification.ThinkingDelta, {
+                        threadId,
+                        turnId,
+                        messageId,
+                        delta,
+                    }));
+                    break;
+                }
+                case 'block': {
+                    const content = readContent(event.data);
+                    if (content !== undefined) {
+                        await this.#options.store.appendBlock(threadId, turnId, content, now);
+                        this.#options.notify(makeNotification(StreamNotification.ContentBlock, {
+                            threadId,
+                            turnId,
+                            messageId,
+                            content,
+                        }));
+                    }
+                    break;
+                }
+                case 'turn_completed': {
+                    const provided = readOptionalText(event.data);
+                    await this.#options.store.completeTurn(threadId, turnId, provided, now);
+                    const text = await this.#assistantText(turnId, provided);
+                    const usage = readUsage(event.data);
+                    if (usage)
+                        await this.#options.store.setUsage(threadId, turnId, usage, now);
+                    this.#options.notify(makeNotification(StreamNotification.TurnCompleted, {
+                        threadId,
+                        turnId,
+                        messageId,
+                        text,
+                        ...(usage !== undefined ? { usage } : {}),
+                    }));
+                    this.#assistantByTurn.delete(turnId);
+                    this.#activeTurnByThread.delete(threadId);
+                    void this.#cleanupAttachments(turnId);
+                    await this.#persistAgentSession(threadId, now);
+                    this.#options.onTurnEnd?.({ threadId, turnId, status: 'completed', text });
+                    break;
+                }
+                case 'turn_error': {
+                    const message = readOptionalText(event.data) ?? 'agent error';
+                    await this.#options.store.failTurn(threadId, turnId, now);
+                    this.#options.notify(makeNotification(StreamNotification.TurnError, {
+                        threadId,
+                        turnId,
+                        error: { code: JsonRpcErrorCode.BridgeError, message },
+                    }));
+                    this.#assistantByTurn.delete(turnId);
+                    this.#activeTurnByThread.delete(threadId);
+                    void this.#cleanupAttachments(turnId);
+                    await this.#persistAgentSession(threadId, now);
+                    this.#options.onTurnEnd?.({ threadId, turnId, status: 'error', text: message });
+                    break;
+                }
+                case 'turn_aborted':
+                    await this.#options.store.abortTurn(threadId, turnId, now);
+                    this.#options.notify(makeNotification(StreamNotification.TurnAborted, { threadId, turnId }));
+                    this.#assistantByTurn.delete(turnId);
+                    this.#activeTurnByThread.delete(threadId);
+                    void this.#cleanupAttachments(turnId);
+                    break;
+            }
+        }
+        catch (err) {
+            this.#options.logger.warn(`agent event handling failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Remove a turn's temp attachment directory once the turn ends. Best-effort:
+     * the agent has already read the files by completion, and a failure to delete
+     * (e.g. the dir vanished) is non-fatal.
+     */
+    async #cleanupAttachments(turnId) {
+        const dir = this.#attachmentDirByTurn.get(turnId);
+        if (!dir)
+            return;
+        this.#attachmentDirByTurn.delete(turnId);
+        try {
+            await rm(dir, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    /**
+     * Persist the agent's native session id for a thread so the on-disk history
+     * fallback can locate its session log after a restart. Best-effort + idempotent.
+     */
+    async #persistAgentSession(threadId, now) {
+        const agentId = this.#agentByThread.get(threadId);
+        if (!agentId)
+            return;
+        // `nativeSessionId` is an optional adapter capability (not in the shared
+        // interface), so read it through a structural type rather than a hard dep.
+        const adapter = this.#adapters.get(agentId);
+        const sessionId = adapter?.nativeSessionId?.(threadId);
+        if (!sessionId)
+            return;
+        try {
+            await this.#options.store.setAgentSession(threadId, sessionId, now);
+        }
+        catch (err) {
+            this.#options.logger.warn(`persist agent session failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async #assistantText(turnId, provided) {
+        if (provided !== undefined)
+            return provided;
+        try {
+            const turn = await this.#options.store.getTurn(turnId);
+            const assistant = turn.messages.find((m) => m.role === 'assistant');
+            return typeof assistant?.content === 'string' ? assistant.content : '';
+        }
+        catch {
+            return '';
+        }
+    }
+}
+function readText(data) {
+    if (data && typeof data === 'object' && 'text' in data) {
+        const text = data.text;
+        if (typeof text === 'string')
+            return text;
+    }
+    return '';
+}
+/** Extract a structured `content` block (MessageContent JSON) from a block event. */
+function readContent(data) {
+    if (data && typeof data === 'object' && 'content' in data) {
+        return data.content;
+    }
+    return undefined;
+}
+function readOptionalText(data) {
+    if (data && typeof data === 'object' && 'text' in data) {
+        const text = data.text;
+        if (typeof text === 'string')
+            return text;
+    }
+    return undefined;
+}
+/** Extract `{ tokens, contextWindow? }` from a turn_completed event's data. */
+function readUsage(data) {
+    if (!data || typeof data !== 'object' || !('usage' in data))
+        return undefined;
+    const usage = data.usage;
+    if (!usage || typeof usage !== 'object')
+        return undefined;
+    const tokens = usage.tokens;
+    if (typeof tokens !== 'number')
+        return undefined;
+    const window = usage.contextWindow;
+    return {
+        tokens,
+        ...(typeof window === 'number' ? { contextWindow: window } : {}),
+    };
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/src/agents/agent-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.js","sourceRoot":"","sources":["../../../src/agents/agent-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,GAUjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C,4EAA4E;AAC5E,SAAS,eAAe,CACtB,UAAkB,EAClB,QAAgB,EAChB,KAA8B;IAE9B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC;IAC7E,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,IAAI,GACR,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5F,OAAO,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,+EAA+E;AAC/E,SAAS,cAAc,CAAC,KAA8B;IACpD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAwCD,MAAM,OAAO,YAAY;IACd,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IAC9B,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtD,uFAAuF;IAC9E,cAAc,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrD,uFAAuF;IAC9E,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzD,+EAA+E;IACtE,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1D;;;;;;iBAMa;IACJ,qBAAqB,GAAG,IAAI,GAAG,EAGrC,CAAC;IACJ,YAAY,GAAG,CAAC,CAAC;IACR,QAAQ,CAAsB;IAEvC,YAAY,OAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,OAAsB,EAAE,IAAyB;QACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE;YAC9B,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,OAAO,CAAC,OAAO;YACjD,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;YAClC,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjF,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACxB,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,yEAAyE;IACzE,WAAW,CAAC,OAAgB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,KAAK,CAAC;IACrD,CAAC;IAED,8EAA8E;IAC9E,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,OAAO,CAAC,OAAO;gBACjD,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,SAAS,CAAC,OAAgB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,UAAU;YAAE,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,QAAgB,EAChB,UAA2B,EAAE;QAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,eAAe,EAChC,oCAAoC,OAAO,GAAG,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC9C,2EAA2E;QAC3E,4EAA4E;QAC5E,MAAM,WAAW,GACf,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;gBACtB,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,oBAAoB,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;gBAChF,CAAC,CAAC,QAAQ,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACtE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEvD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7F,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,wEAAwE;QACxE,0EAA0E;QAC1E,oEAAoE;QACpE,IAAI,SAAS,GAAG,QAAQ,CAAC;QACzB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;oBAC7E,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC3D,CAAC,CAAC;gBACH,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;oBACtB,SAAS;wBACP,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;gBACpF,CAAC;gBACD,IAAI,YAAY,CAAC,GAAG;oBAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;YACxF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,CAAC;YACrB,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,eAAe,CACnB,QAAgB,EAChB,IAA0D;QAE1D,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,CAAC,8CAA8C;QAC5E,MAAM,UAAU,GAAG,QAAQ,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAC5F,CAAC;QACF,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,EAAE;YAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC9C,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACxB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,eAAe,CACnB,QAAgB,EAChB,UAAkB,EAClB,QAA0B;QAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC9C,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,eAAe,EAChC,+BAA+B,QAAQ,GAAG,CAC3C,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,UAAU,OAAO,8BAA8B,CAChD,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAiB;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC1E,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAuB;QACpC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,cAAc;oBACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CACvE,CAAC;oBACF,MAAM;gBACR,KAAK,gBAAgB,CAAC,CAAC,CAAC;oBACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACnC,IAAI,KAAK,EAAE,CAAC;wBACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAChF,CAAC;oBACJ,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;oBACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,EAAE;wBAChD,QAAQ;wBACR,MAAM;wBACN,SAAS;wBACT,KAAK;qBACN,CAAC,CACH,CAAC;oBACF,MAAM;gBACR,CAAC;gBACD,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;oBACvE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,aAAa,EAAE;wBACjD,QAAQ;wBACR,MAAM;wBACN,SAAS;wBACT,KAAK;qBACN,CAAC,CACH,CAAC;oBACF,MAAM;gBACR,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;wBACtE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,EAAE;4BAChD,QAAQ;4BACR,MAAM;4BACN,SAAS;4BACT,OAAO;yBACR,CAAC,CACH,CAAC;oBACJ,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;oBACtB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC9C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;oBACxE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBACzD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACpC,IAAI,KAAK;wBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC5E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,aAAa,EAAE;wBACjD,QAAQ;wBACR,MAAM;wBACN,SAAS;wBACT,IAAI;wBACJ,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC1C,CAAC,CACH,CAAC;oBACF,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC1C,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBACtC,MAAM,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;oBAC/C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3E,MAAM;gBACR,CAAC;gBACD,KAAK,YAAY,CAAC,CAAC,CAAC;oBAClB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;oBAC9D,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;oBAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,SAAS,EAAE;wBAC7C,QAAQ;wBACR,MAAM;wBACN,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,WAAW,EAAE,OAAO,EAAE;qBACvD,CAAC,CACH,CAAC;oBACF,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC1C,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBACtC,MAAM,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;oBAC/C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBAChF,MAAM;gBACR,CAAC;gBACD,KAAK,cAAc;oBACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;oBAC3D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,gBAAgB,CAAC,kBAAkB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CACvE,CAAC;oBACF,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC1C,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBACtC,MAAM;YACV,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CACvB,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,GAAW;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,yEAAyE;QACzE,2EAA2E;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAE7B,CAAC;QACd,MAAM,SAAS,GAAG,OAAO,EAAE,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CACvB,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,QAA4B;QAC/D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YACpE,OAAO,OAAO,SAAS,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAa;IAC7B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,GAAI,IAA0B,CAAC,IAAI,CAAC;QAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,qFAAqF;AACrF,SAAS,WAAW,CAAC,IAAa;IAChC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QAC1D,OAAQ,IAA6B,CAAC,OAAO,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,GAAI,IAA0B,CAAC,IAAI,CAAC;QAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9E,MAAM,KAAK,GAAI,IAA2B,CAAC,KAAK,CAAC;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;IACtD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,MAAM,GAAI,KAAqC,CAAC,aAAa,CAAC;IACpE,OAAO;QACL,MAAM;QACN,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/src/agents/attachments.d.ts

@@ -0,0 +1,28 @@
+import type { TurnAttachment } from '@uxnan/shared';
+/** Sub-directory (under the thread cwd) the bridge drops turn attachments into. */
+export declare const ATTACHMENTS_DIRNAME = ".uxnan-attachments";
+export interface MaterializedAttachments {
+    /** Absolute paths of the files written to disk (for the turn-end cleanup). */
+    paths: string[];
+    /** Absolute directory the files were written under (removed on turn end). */
+    dir?: string;
+    /** A prompt note referencing the paths, or `''` when nothing was written. */
+    note: string;
+}
+export interface MaterializeOptions {
+    /**
+     * The agent's working directory. When set, files are written under
+     * `<cwd>/.uxnan-attachments/<turnId>/` and referenced by a cwd-relative path
+     * so sandboxed agents can open them. When unset, falls back to the OS temp
+     * dir with an absolute reference.
+     */
+    cwd?: string;
+}
+/**
+ * Writes each inline attachment to a file under the thread's working directory
+ * and returns the absolute paths plus a ready-to-append prompt note (which
+ * references the files by a cwd-relative path). Tolerant: attachments without
+ * usable `base64Data` are skipped (an attachment that is only a workspace
+ * `path` is referenced by that path). Never throws on a single bad attachment.
+ */
+export declare function materializeAttachments(attachments: readonly TurnAttachment[], turnId: string, options?: MaterializeOptions): Promise<MaterializedAttachments>;