@agent-link/agent 0.1.204 → 0.1.207

package/dist/backends/claude.d.ts

@@ -0,0 +1,90 @@
+/**
+ * ClaudeBackend — adapter implementing AgentBackend over the existing
+ * agent/src/claude.ts subprocess driver and agent/src/history.ts JSONL reader.
+ *
+ * Design (locked decisions, see docs/2026-05-09-pr3-claude-backend.md):
+ *   - claude.ts is unchanged; this class wraps it.
+ *   - For Claude, `backendThreadId === backendSessionId` (single-thread sessions).
+ *   - Emits NormalizedEvents only via on(listener). In PR3 the runtime
+ *     facade does NOT yet subscribe to these events or translate them back
+ *     to legacy wire frames — connection.ts still uses the re-exported
+ *     claude.ts surface directly. PR4 wires the runtime to call
+ *     getBackend().on(...) and routes outbound traffic through the
+ *     translation pipeline; the NormalizedEvents emitted here are currently
+ *     consumed only by the contract tests.
+ *   - listSessions / readSession / deleteSession / renameSession delegate
+ *     to history.ts directly.
+ *
+ * The class subscribes to claude.ts's outbound traffic via the multi-listener
+ * `addSendFn` / `addOnSessionStarted` hooks (returning unsubscribe handles
+ * stored on the instance). Because these hooks support fanout, multiple
+ * ClaudeBackend instances can coexist with the legacy connection.ts
+ * subscribers without clobbering each other; shutdown() detaches cleanly.
+ */
+import { type AgentBackend, type ApprovalAnswer, type BackendCapabilities, type BackendHistoryMessage, type BackendRestartResult, type BackendSessionInfo, type BackendSessionRef, type EnsureSessionOpts, type EventListener, type RestartOpts, type StartOpts, type UserInputAnswer, type UserTurnInput } from './types.js';
+export declare class ClaudeBackend implements AgentBackend {
+    readonly type: "claude";
+    readonly capabilities: BackendCapabilities;
+    private readonly listeners;
+    /** Map from conversationId → most-recent backendSessionId we've observed.
+     *  Lets us tag events that don't carry a session id (e.g. turn_completed). */
+    private readonly convToSession;
+    /** Map from placeholder ref id (e.g. 'pending:c1') → conversationId. Used
+     *  to resolve startTurn() before session_started has populated convToSession. */
+    private readonly pendingRefToConv;
+    /** Map from conversationId → workDir provided to ensureSession(). Used as a
+     *  fallback in startTurn() when claude.ts has no live ConversationState yet
+     *  (e.g. first turn before session_started). */
+    private readonly convToWorkDir;
+    /** Unsubscribe handles for the multi-subscriber claude.ts hooks. */
+    private readonly unsubSend;
+    private readonly unsubSessionStarted;
+    readonly compact?: undefined;
+    readonly fork?: undefined;
+    readonly listModels?: undefined;
+    readonly renameSession: (workDir: string, session: BackendSessionRef, title: string) => Promise<boolean>;
+    readonly deleteSession: (workDir: string, session: BackendSessionRef) => Promise<boolean>;
+    constructor(_opts?: StartOpts);
+    on(listener: EventListener): () => void;
+    private emit;
+    start(_opts: StartOpts): Promise<void>;
+    shutdown(): Promise<void>;
+    ensureSession(opts: EnsureSessionOpts): Promise<BackendSessionRef>;
+    startTurn(session: BackendSessionRef, input: UserTurnInput): Promise<void>;
+    interruptTurn(session: BackendSessionRef): Promise<void>;
+    answerUserInput(answer: UserInputAnswer): void;
+    answerApproval(answer: ApprovalAnswer): void;
+    setModel(conversationId: string | null, model: string | null): void;
+    getEffectiveModel(conversationId?: string): string | null;
+    isCompacting(conversationId?: string): boolean;
+    hasConversation(conversationId: string): boolean;
+    restartSession(conversationId: string, opts?: RestartOpts): BackendRestartResult | null;
+    createPlaceholderSession(conversationId: string, _workDir: string, opts?: RestartOpts): void;
+    listSessions(workDir: string): Promise<BackendSessionInfo[]>;
+    readSession(workDir: string, session: BackendSessionRef): Promise<BackendHistoryMessage[]>;
+    /** Reverse-lookup: find the conversationId we associated with a session ref. */
+    private findConvId;
+    /**
+     * Translate a legacy outbound wire frame (as produced by claude.ts via the
+     * SendFn closure) into a NormalizedEvent and fan out to listeners.
+     *
+     * In PR3 the runtime facade does NOT yet perform the reverse translation
+     * back to legacy frames — connection.ts still uses the re-exported claude.ts
+     * surface directly (see runtime.ts header comment). The NormalizedEvents
+     * emitted here are currently consumed only by the contract tests; the raw
+     * frame fanout below preserves wire fidelity for when PR4 wires the runtime
+     * to translate. The `runtime.test.ts` suite verifies only that runtime.ts
+     * re-exports the expected surface, not round-trip correctness.
+     *
+     * For frames that don't have a NormalizedEvent equivalent (or that the
+     * runtime should pass through unchanged), we emit a `process_output`-shaped
+     * event carrying the raw frame so the runtime can forward it verbatim.
+     */
+    private onClaudeSend;
+    /**
+     * Special-purpose event used internally to ferry untranslated/raw frames
+     * through to the runtime facade without losing fidelity. Encoded as a
+     * `process_output` NormalizedEvent for now; PR4+ may add a dedicated kind.
+     */
+    private emitRawFrame;
+}

package/dist/backends/claude.js

@@ -0,0 +1,356 @@
+/**
+ * ClaudeBackend — adapter implementing AgentBackend over the existing
+ * agent/src/claude.ts subprocess driver and agent/src/history.ts JSONL reader.
+ *
+ * Design (locked decisions, see docs/2026-05-09-pr3-claude-backend.md):
+ *   - claude.ts is unchanged; this class wraps it.
+ *   - For Claude, `backendThreadId === backendSessionId` (single-thread sessions).
+ *   - Emits NormalizedEvents only via on(listener). In PR3 the runtime
+ *     facade does NOT yet subscribe to these events or translate them back
+ *     to legacy wire frames — connection.ts still uses the re-exported
+ *     claude.ts surface directly. PR4 wires the runtime to call
+ *     getBackend().on(...) and routes outbound traffic through the
+ *     translation pipeline; the NormalizedEvents emitted here are currently
+ *     consumed only by the contract tests.
+ *   - listSessions / readSession / deleteSession / renameSession delegate
+ *     to history.ts directly.
+ *
+ * The class subscribes to claude.ts's outbound traffic via the multi-listener
+ * `addSendFn` / `addOnSessionStarted` hooks (returning unsubscribe handles
+ * stored on the instance). Because these hooks support fanout, multiple
+ * ClaudeBackend instances can coexist with the legacy connection.ts
+ * subscribers without clobbering each other; shutdown() detaches cleanly.
+ */
+import * as claude from '../claude.js';
+import * as history from '../history.js';
+import { claudeCapabilities, } from './types.js';
+/** Internal: wrap a claudeSessionId into a BackendSessionRef. */
+function refFor(sessionId) {
+    const id = sessionId ?? '';
+    return {
+        backendType: 'claude',
+        backendSessionId: id,
+        backendThreadId: id,
+        providerSessionId: id || null,
+    };
+}
+export class ClaudeBackend {
+    type = 'claude';
+    // claudeCapabilities() now reflects this adapter's actual surface (fork &
+    // compaction = false, since claude.ts has no programmatic compact API and
+    // restartConversation's signature doesn't match AgentBackend.fork). No need
+    // to override the capability flags here.
+    capabilities = claudeCapabilities();
+    listeners = new Set();
+    /** Map from conversationId → most-recent backendSessionId we've observed.
+     *  Lets us tag events that don't carry a session id (e.g. turn_completed). */
+    convToSession = new Map();
+    /** Map from placeholder ref id (e.g. 'pending:c1') → conversationId. Used
+     *  to resolve startTurn() before session_started has populated convToSession. */
+    pendingRefToConv = new Map();
+    /** Map from conversationId → workDir provided to ensureSession(). Used as a
+     *  fallback in startTurn() when claude.ts has no live ConversationState yet
+     *  (e.g. first turn before session_started). */
+    convToWorkDir = new Map();
+    /** Unsubscribe handles for the multi-subscriber claude.ts hooks. */
+    unsubSend;
+    unsubSessionStarted;
+    // Optional methods from AgentBackend — only present if capability declares it.
+    compact; // claude.ts has no programmatic compact API
+    fork; // restartConversation acts as fork but signature differs
+    listModels; // capability says no
+    renameSession;
+    deleteSession;
+    constructor(_opts) {
+        // Wire interceptors. claude.ts now supports multi-subscriber fanout; we
+        // capture the unsubscribe handles so shutdown() can detach cleanly without
+        // racing the legacy connection.ts subscribers.
+        this.unsubSend = claude.addSendFn((msg) => this.onClaudeSend(msg));
+        this.unsubSessionStarted = claude.addOnSessionStarted((conversationId, claudeSessionId) => {
+            if (conversationId) {
+                this.convToSession.set(conversationId, claudeSessionId);
+                // Keep pendingRefToConv entry alive until shutdown so callers that
+                // still hold the original placeholder ref can resolve it later.
+            }
+            this.emit({ type: 'session_started', session: refFor(claudeSessionId) });
+        });
+        // Bind capability-gated methods.
+        this.renameSession = async (workDir, session, title) => {
+            // PR4-D: forward history.renameSession's boolean so AgentRuntime /
+            // connection.ts can drive the BRAIN_DATA_DIR fallback + retry on false.
+            return history.renameSession(workDir, session.backendSessionId, title);
+        };
+        this.deleteSession = async (workDir, session) => {
+            return history.deleteSession(workDir, session.backendSessionId);
+        };
+    }
+    // ── Event subscription ─────────────────────────────────────────────────
+    on(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    emit(event) {
+        for (const fn of this.listeners) {
+            try {
+                fn(event);
+            }
+            catch (e) {
+                console.error('[ClaudeBackend] listener threw', e);
+            }
+        }
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+    async start(_opts) {
+        // claude.ts has no global start step — process spawn is lazy per-conversation.
+    }
+    async shutdown() {
+        claude.abortAll();
+        try {
+            this.unsubSend();
+        }
+        catch { /* ignore */ }
+        try {
+            this.unsubSessionStarted();
+        }
+        catch { /* ignore */ }
+        this.listeners.clear();
+        this.convToSession.clear();
+        this.pendingRefToConv.clear();
+        this.convToWorkDir.clear();
+    }
+    // ── Session lifecycle ──────────────────────────────────────────────────
+    async ensureSession(opts) {
+        // Remember workDir so startTurn() can spawn Claude in the right directory
+        // even before claude.ts has a live ConversationState for this conversation.
+        if (opts.workDir) {
+            this.convToWorkDir.set(opts.conversationId, opts.workDir);
+        }
+        // Claude's session is established lazily on the first chat message via
+        // handleChat → startQuery. We can return a placeholder ref that carries
+        // the resumeSessionId if provided; otherwise an empty ref that gets
+        // filled in by the session_started event.
+        const existing = claude.getConversation(opts.conversationId);
+        const sid = opts.resumeSessionId ?? existing?.claudeSessionId ?? existing?.lastClaudeSessionId ?? '';
+        if (sid) {
+            this.convToSession.set(opts.conversationId, sid);
+            return refFor(sid);
+        }
+        // No real session yet — emit a placeholder ref and remember the mapping
+        // so startTurn() can recover the original conversationId from it.
+        const placeholder = `pending:${opts.conversationId}`;
+        this.pendingRefToConv.set(placeholder, opts.conversationId);
+        return refFor(placeholder);
+    }
+    async startTurn(session, input) {
+        // The conversationId is the AgentLink convId; we don't have it on
+        // BackendSessionRef directly. For backwards compat we use backendSessionId
+        // as the conversationId fallback when the runtime didn't supply a mapping.
+        // (The runtime facade will pass a richer call signature in PR3 follow-up;
+        // for the contract test the placeholder ref convention is sufficient.)
+        const convId = this.findConvId(session) ?? session.backendSessionId;
+        // Plumb resumeSessionId when the ref carries a real (non-placeholder) session
+        // id and claude.ts has no live ConversationState yet — that's the only
+        // scenario where we actually need to ask the CLI to resume. If a live
+        // ConversationState already exists, claude.ts will reuse it and the
+        // resumeSessionId would be ignored anyway. Placeholder ids ('pending:*')
+        // are explicitly excluded so we never pass them to the CLI as a resume target.
+        const sid = session.backendSessionId;
+        const isPlaceholder = !sid || sid.startsWith('pending:');
+        const hasLive = !!claude.getConversation(convId);
+        const baseOptions = !isPlaceholder && !hasLive
+            ? { resumeSessionId: sid }
+            : undefined;
+        // Merge per-turn metadata (brainMode, recapId, briefingDate, devops*,
+        // projectName, icmId, extraArgs) into HandleChatOptions. The runtime
+        // passes these through opaquely; only ClaudeBackend interprets them.
+        const meta = input.metadata;
+        const options = (baseOptions || meta)
+            ? { ...(meta ?? {}), ...(baseOptions ?? {}) }
+            : undefined;
+        claude.handleChat(convId, input.text, 
+        // workDir must come from existing conversation state; if absent, claude.ts
+        // will throw when it tries to spawn — caller must ensureSession first.
+        claude.getConversation(convId)?.workDir ?? this.convToWorkDir.get(convId) ?? process.cwd(), options, input.files);
+        this.emit({ type: 'turn_started', session });
+    }
+    async interruptTurn(session) {
+        const convId = this.findConvId(session) ?? session.backendSessionId;
+        claude.cancelExecution(convId);
+    }
+    // ── User input / approval ──────────────────────────────────────────────
+    answerUserInput(answer) {
+        claude.handleUserAnswer(answer.requestId, answer.answers);
+    }
+    answerApproval(answer) {
+        claude.handleToolPermissionResponse(answer.requestId, answer.decision);
+    }
+    // ── PR4-C user-action surface (keyed by conversationId) ────────────────
+    setModel(conversationId, model) {
+        // claude.setModel takes (conversationId | undefined, model). null convId
+        // means "global default"; null model means clear/default — claude.setModel
+        // expects a string for model, so coerce null to '' (claude.ts treats empty
+        // as "no override").
+        claude.setModel(conversationId ?? undefined, model ?? '');
+    }
+    getEffectiveModel(conversationId) {
+        return claude.getEffectiveModel(conversationId);
+    }
+    isCompacting(conversationId) {
+        return claude.getIsCompacting(conversationId);
+    }
+    hasConversation(conversationId) {
+        return claude.getConversation(conversationId) != null;
+    }
+    restartSession(conversationId, opts) {
+        // claude.restartConversation returns { claudeSessionId: null, wasTurnActive: false }
+        // when there's no live conversation. Map that to null per AgentBackend
+        // contract (caller falls back to createPlaceholderSession).
+        if (!claude.getConversation(conversationId))
+            return null;
+        const result = claude.restartConversation(conversationId, opts);
+        return {
+            claudeSessionId: result.claudeSessionId,
+            wasTurnActive: result.wasTurnActive,
+            history: result.history,
+        };
+    }
+    createPlaceholderSession(conversationId, _workDir, opts) {
+        // Claude ignores workDir — claude.ts:898 sets workDir: '' and the next
+        // handleChat overrides it. The param is kept in the AgentBackend API for
+        // future backends that need it (e.g. CodexBackend).
+        claude.createPlaceholderConversation(conversationId, opts);
+    }
+    // ── History ────────────────────────────────────────────────────────────
+    async listSessions(workDir) {
+        const items = history.listSessions(workDir);
+        return items.map((s) => ({
+            session: refFor(s.sessionId),
+            title: s.title,
+            customTitle: s.customTitle,
+            preview: s.preview,
+            lastModified: s.lastModified,
+        }));
+    }
+    async readSession(workDir, session) {
+        const msgs = history.readSessionMessages(workDir, session.backendSessionId);
+        return msgs;
+    }
+    // ── Internals ──────────────────────────────────────────────────────────
+    /** Reverse-lookup: find the conversationId we associated with a session ref. */
+    findConvId(session) {
+        const sid = session.backendSessionId;
+        if (!sid)
+            return null;
+        // Placeholder refs (returned by ensureSession before session_started) carry
+        // the conversationId in pendingRefToConv. Resolve them first so we don't
+        // accidentally pass 'pending:c1' as a conversationId to claude.handleChat.
+        if (sid.startsWith('pending:')) {
+            return this.pendingRefToConv.get(sid) ?? null;
+        }
+        for (const [conv, observedSid] of this.convToSession) {
+            if (observedSid === sid)
+                return conv;
+        }
+        return null;
+    }
+    /**
+     * Translate a legacy outbound wire frame (as produced by claude.ts via the
+     * SendFn closure) into a NormalizedEvent and fan out to listeners.
+     *
+     * In PR3 the runtime facade does NOT yet perform the reverse translation
+     * back to legacy frames — connection.ts still uses the re-exported claude.ts
+     * surface directly (see runtime.ts header comment). The NormalizedEvents
+     * emitted here are currently consumed only by the contract tests; the raw
+     * frame fanout below preserves wire fidelity for when PR4 wires the runtime
+     * to translate. The `runtime.test.ts` suite verifies only that runtime.ts
+     * re-exports the expected surface, not round-trip correctness.
+     *
+     * For frames that don't have a NormalizedEvent equivalent (or that the
+     * runtime should pass through unchanged), we emit a `process_output`-shaped
+     * event carrying the raw frame so the runtime can forward it verbatim.
+     */
+    onClaudeSend(msg) {
+        const t = String(msg.type ?? '');
+        const convId = typeof msg.conversationId === 'string' ? msg.conversationId : undefined;
+        const sid = (convId && this.convToSession.get(convId)) || '';
+        const session = refFor(sid);
+        switch (t) {
+            case 'session_started':
+                // Already emitted via setOnSessionStarted callback; skip to avoid double-fire.
+                return;
+            case 'turn_completed':
+                this.emit({ type: 'turn_completed', session });
+                // Also forward the raw frame so the runtime can preserve fields like
+                // conversationId / usage that connection.ts expects on the wire.
+                this.emitRawFrame(msg);
+                return;
+            case 'execution_cancelled':
+                this.emit({ type: 'turn_cancelled', session });
+                this.emitRawFrame(msg);
+                return;
+            case 'context_compaction': {
+                const status = msg.status === 'started' ? 'compact_started' : 'compact_completed';
+                this.emit({ type: status, session });
+                this.emitRawFrame(msg);
+                return;
+            }
+            case 'ask_user_question': {
+                const requestId = String(msg.requestId ?? '');
+                const questions = msg.questions ?? [];
+                this.emit({
+                    type: 'user_input_requested',
+                    session,
+                    requestId,
+                    request: {
+                        source: 'ask_user_question',
+                        questions: questions.map((q) => ({
+                            question: String(q.question ?? ''),
+                            header: q.header ? String(q.header) : undefined,
+                            options: q.options ?? [],
+                            multiSelect: Boolean(q.multiSelect),
+                        })),
+                    },
+                });
+                this.emitRawFrame(msg);
+                return;
+            }
+            case 'tool_permission_request': {
+                const requestId = String(msg.requestId ?? '');
+                const toolName = String(msg.toolName ?? '');
+                this.emit({
+                    type: 'approval_requested',
+                    session,
+                    requestId,
+                    request: { kind: 'tool', toolName, input: msg.input },
+                });
+                this.emitRawFrame(msg);
+                return;
+            }
+            case 'error':
+                this.emit({ type: 'error', session, message: String(msg.message ?? '') });
+                this.emitRawFrame(msg);
+                return;
+            default:
+                // Pass-through for everything else (claude_output, plan_mode_changed,
+                // permission_mode_changed, btw_answer, etc). The runtime forwards raw.
+                this.emitRawFrame(msg);
+                return;
+        }
+    }
+    /**
+     * Special-purpose event used internally to ferry untranslated/raw frames
+     * through to the runtime facade without losing fidelity. Encoded as a
+     * `process_output` NormalizedEvent for now; PR4+ may add a dedicated kind.
+     */
+    emitRawFrame(msg) {
+        const convId = typeof msg.conversationId === 'string' ? msg.conversationId : undefined;
+        const sid = (convId && this.convToSession.get(convId)) || '';
+        this.emit({
+            type: 'process_output',
+            session: refFor(sid),
+            processId: '__raw__',
+            chunk: JSON.stringify(msg),
+        });
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/backends/claude.js.map

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

package/dist/backends/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Backend factory.
+ *
+ * `'claude'` is wired to `ClaudeBackend` (a thin adapter over the existing
+ * `agent/src/claude.ts` driver). `'codex'` is recognized but not implemented
+ * yet (PR4).
+ */
+import { type BackendType, type AgentBackend, type StartOpts } from './types.js';
+export * from './types.js';
+export { ClaudeBackend } from './claude.js';
+export declare class UnknownBackendError extends Error {
+    constructor(type: string);
+}
+export declare class BackendNotImplementedError extends Error {
+    constructor(type: BackendType);
+}
+/**
+ * Validate that a string is a known BackendType.
+ * Throws UnknownBackendError for unknown values.
+ */
+export declare function assertKnownBackendType(type: string): asserts type is BackendType;
+/**
+ * Factory entry point. For recognized-but-not-yet-implemented backends
+ * (currently: codex), throws BackendNotImplementedError. Throws
+ * UnknownBackendError for unknown types.
+ */
+export declare function createBackend(type: string, _opts?: StartOpts): AgentBackend;

package/dist/backends/index.js

@@ -0,0 +1,52 @@
+/**
+ * Backend factory.
+ *
+ * `'claude'` is wired to `ClaudeBackend` (a thin adapter over the existing
+ * `agent/src/claude.ts` driver). `'codex'` is recognized but not implemented
+ * yet (PR4).
+ */
+import { KNOWN_BACKEND_TYPES } from './types.js';
+import { ClaudeBackend } from './claude.js';
+export * from './types.js';
+export { ClaudeBackend } from './claude.js';
+export class UnknownBackendError extends Error {
+    constructor(type) {
+        super(`Unknown backend type: "${type}". Known types: ${KNOWN_BACKEND_TYPES.join(', ')}.`);
+        this.name = 'UnknownBackendError';
+    }
+}
+export class BackendNotImplementedError extends Error {
+    constructor(type) {
+        super(`Backend "${type}" is recognized but not yet implemented in this version.`);
+        this.name = 'BackendNotImplementedError';
+    }
+}
+/**
+ * Validate that a string is a known BackendType.
+ * Throws UnknownBackendError for unknown values.
+ */
+export function assertKnownBackendType(type) {
+    if (!KNOWN_BACKEND_TYPES.includes(type)) {
+        throw new UnknownBackendError(type);
+    }
+}
+/**
+ * Factory entry point. For recognized-but-not-yet-implemented backends
+ * (currently: codex), throws BackendNotImplementedError. Throws
+ * UnknownBackendError for unknown types.
+ */
+export function createBackend(type, _opts) {
+    assertKnownBackendType(type);
+    switch (type) {
+        case 'claude':
+            return new ClaudeBackend(_opts);
+        case 'codex':
+            throw new BackendNotImplementedError('codex');
+        default: {
+            // exhaustiveness guard
+            const _exhaustive = type;
+            throw new UnknownBackendError(_exhaustive);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAuD,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,IAAY;QACtB,KAAK,CACH,0BAA0B,IAAI,mBAAmB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,IAAiB;QAC3B,KAAK,CACH,YAAY,IAAI,0DAA0D,CAC3E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAE,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAiB;IAC3D,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,KAAK,OAAO;YACV,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC,CAAC;YACR,uBAAuB;YACvB,MAAM,WAAW,GAAU,IAAI,CAAC;YAChC,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;AACH,CAAC"}