@excitedjs/agent-runtime-claude-code 0.2.0-alpha.g0ddd418597ca

package/dist/runtime.js

@@ -0,0 +1,464 @@
+/**
+ * `builtin:claude-code` AgentRuntime (issue #110 PR6, resident stream-json
+ * transport since issue #120; extracted into `@excitedjs/agent-runtime-claude-code`
+ * in issue #209).
+ *
+ * A real second agent runtime that proves the AgentRuntimeProvider abstraction
+ * is not "Codex renamed". Like Codex it runs a **resident child process**
+ * supervised for the runtime's lifetime — but it differs in every
+ * runtime-specific dimension:
+ *
+ * - **Stream-json over stdio, not an app-server WebSocket.** The resident child
+ *   is `claude --print --input-format stream-json --output-format stream-json`
+ *   (see `./args.ts`); turns are NDJSON `user` lines on stdin and
+ *   `init`/`assistant`/`result` envelopes on stdout (see `./stream.ts`). There
+ *   is no `initialize` handshake — the child emits `init` lazily with the first
+ *   turn — so readiness is "child spawned", not "handshake completed".
+ * - **MCP injection is a JSON config document** (`--mcp-config <file>`), not
+ *   Codex's `-c mcp_servers.*` TOML CLI flags.
+ * - **Runtime-owned config** is `DispatcherClaudeCodeConfig` (bin / model /
+ *   permission_mode / remote_control / extra_args / extra_env), distinct from
+ *   the Codex config.
+ * - **Completion delivery** is a plain user turn (no fake task-notification),
+ *   not the Codex inbox-then-trigger path.
+ *
+ * Process spawning goes through an injectable {@link ClaudeCodeSessionFactory}
+ * seam (mirroring Codex's process-factory seam), so the lifecycle contract is
+ * fully unit-testable with a fake session. A live `claude` binary is exercised
+ * only by the opt-in live test.
+ *
+ * Failure contract (unchanged by #120): a turn failure (spawn error, child
+ * exit, error `result`) is never swallowed. For inbound/restart turns it drives
+ * the runtime to `degraded` with a persisted `last_error` (observable via
+ * status/doctor). For `completionInput` it surfaces as a `failed`
+ * result the caller can act on (PR8 delivery retry). `channelInput` still
+ * returns after accept (submit != completion) so the channel can ack promptly.
+ *
+ * Restart: an unexpected child exit marks the runtime `degraded`; the next turn
+ * re-spawns the resident child with `--resume <session_id>`, restoring the
+ * conversation. There is no background backoff timer — re-spawn is lazy and
+ * bound to the (serialized) turn queue, so it stays deterministic.
+ *
+ * Per-turn idle deadline: a turn whose still-alive child goes silent — never
+ * emitting another stream line (a stall, or a wait on input the runtime cannot
+ * satisfy) — would otherwise pend forever and wedge the serial queue, and behind
+ * it TeamMate completion delivery, which awaits this runtime. `turn_timeout_ms`
+ * is a *max-idle* window (issue #156): it is reset on every inbound stream line,
+ * so a long but continuously-streaming turn (e.g. a deep audit running many
+ * tool calls for far longer than the window) is never reaped, while a child that
+ * emits nothing for the whole window still is — turning an infinite hang into a
+ * normal degraded + `last_error` (inbound) or `failed` delivery result.
+ *
+ * Reference: the resident stream-json protocol model and process-supervision
+ * shape are adapted from the Claudemux `next` implementation; the AgentRuntime /
+ * Channel / DispatcherService boundaries (provider seam, runtime-owned MCP
+ * injection, degraded/last_error status, TeamMate delivery result contract) are
+ * Dreamux's own, per `.agents/decisions/agent-runtime-provider.md`.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { BUILTIN_CLAUDE_CODE_PROVIDER_REF } from './provider-ref.js';
+import { claudeCodeResidentArgs } from './args.js';
+import { stringifyClaudeCodeMcpConfig } from './mcp-config.js';
+import { renderChannelInput, resolveCompletionBody } from '@excitedjs/dreamux-utils';
+import { CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES } from './provider.js';
+let nextRuntimeInstanceId = 0;
+/**
+ * Status line opening a TeamMate completion turn. Plain English, status-varied —
+ * NOT claude-code's native `<task-notification>` XML. The old XML mimicked
+ * claude-code's real task-notification system, so the model could mistake the
+ * fabricated task-id / output-file for a live background task and act on them
+ * (hallucination / harness collision). A plain user turn avoids that entirely.
+ */
+function completionStatusLine(completion) {
+    switch (completion.status) {
+        case 'completed':
+            return `TeamMate ${completion.source} has finished its task.`;
+        case 'failed':
+            return `TeamMate ${completion.source}'s task failed.`;
+        case 'stopped':
+            return `TeamMate ${completion.source}'s task was stopped.`;
+    }
+}
+/**
+ * Build the plain-text completion turn. The result is inlined when short; when
+ * it overflows the inline budget the full result is spilled to a file (see
+ * {@link resolveCompletionBody}) and only the path is inlined.
+ */
+async function buildCompletionTurnText(completion, spillDir) {
+    const line = completionStatusLine(completion);
+    const body = await resolveCompletionBody(completion, spillDir);
+    return body.kind === 'inline'
+        ? `${line} Output below:\n\n${body.text}`
+        : `${line} The output is too long, so the full result was saved to a file:\n\n${body.path}`;
+}
+function errMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * The Claude Code agent runtime for one dispatcher. A single resident
+ * stream-json child serves every turn. Turns run serially (one at a time) and
+ * `channelInput` returns after the message is accepted — not after the turn
+ * completes — matching the Codex runtime's submit-then-serialize contract.
+ */
+export class ClaudeCodeRuntime {
+    deps;
+    providerRef = BUILTIN_CLAUDE_CODE_PROVIDER_REF;
+    dispatcherId;
+    config;
+    bin;
+    cwd;
+    mcpConfigPath;
+    mcpConfigDoc;
+    stderrLogPath;
+    completionSpillDir;
+    logger;
+    status = 'declared';
+    threadId;
+    resumed;
+    stopped = false;
+    seen = new Set();
+    queue = Promise.resolve();
+    runtimeInstanceId = ++nextRuntimeInstanceId;
+    turnCounter = 0;
+    session = null;
+    lastResult = null;
+    activeChannelTurn = null;
+    constructor(identity, deps) {
+        this.deps = deps;
+        this.dispatcherId = identity.runtime_id;
+        this.config = deps.config;
+        this.bin = deps.resolveBinPath(this.config.bin);
+        this.cwd = deps.cwd;
+        this.mcpConfigPath = join(deps.paths.dispatcherDir(this.dispatcherId), 'mcp.json');
+        this.mcpConfigDoc = stringifyClaudeCodeMcpConfig(deps.mcpServers);
+        // Compose the resident stream-json child's stderr log under the neutral
+        // central logs root (B2): core no longer names a per-runtime log file. The
+        // host supplies a unique, filesystem-safe `runtime_id`.
+        this.stderrLogPath = join(deps.paths.logsDir(), 'claude-code', `${this.dispatcherId}.stderr.log`);
+        this.completionSpillDir = deps.paths.completionSpillDir(this.dispatcherId);
+        this.threadId = identity.checkpoint_id ?? null;
+        this.resumed = (identity.checkpoint_id ?? null) !== null;
+        this.logger = deps.logger ?? consoleFallbackLogger(this.dispatcherId);
+    }
+    getStatus() {
+        return this.status;
+    }
+    getCapabilities() {
+        return CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES;
+    }
+    getThreadId() {
+        return this.threadId;
+    }
+    wasThreadResumed() {
+        return this.resumed;
+    }
+    async getLast() {
+        return this.lastResult;
+    }
+    async getContext() {
+        return null;
+    }
+    async resume(input = {}) {
+        if (input.checkpoint !== undefined && input.checkpoint !== null) {
+            if (input.checkpoint.kind !== 'claudeCodeSession') {
+                throw new Error(`unsupported resume checkpoint for Claude Code runtime: ${input.checkpoint.kind}`);
+            }
+            this.threadId = input.checkpoint.id;
+            this.resumed = true;
+        }
+        await this.start();
+    }
+    async start() {
+        await this.setStatus('starting');
+        try {
+            await mkdir(dirname(this.mcpConfigPath), { recursive: true });
+            await writeFile(this.mcpConfigPath, this.mcpConfigDoc, { mode: 0o600 });
+            // Spawn the resident child up front so the runtime is truly resident
+            // (Codex-aligned). A missing/broken `claude` binary fails here and drives
+            // the runtime to degraded + throws, rather than a silent no-op.
+            await this.ensureSession();
+        }
+        catch (err) {
+            await this.setStatus('degraded', err);
+            throw err;
+        }
+        await this.setStatus('ready');
+    }
+    async stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        await this.setStatus('stopping');
+        const session = this.session;
+        this.session = null;
+        if (session !== null) {
+            try {
+                await session.stop();
+            }
+            catch (err) {
+                this.log('warn', 'claude-code session stop errored', err);
+            }
+        }
+        await this.setStatus('stopped');
+    }
+    async systemInput(notice) {
+        if (this.stopped)
+            return { status: 'stopped' };
+        const turnId = this.nextTurnId('system');
+        void this.runTurnOnQueue(notice.text, turnId).then(() => this.markTurnSucceeded(turnId), (err) => this.markTurnFailed(turnId, err));
+        return { status: 'submitted', turnId };
+    }
+    async channelInput(input, hooks = {}) {
+        if (this.stopped)
+            return { status: 'stopped' };
+        const key = input.sourceId;
+        if (key !== '' && this.seen.has(key))
+            return { status: 'duplicate' };
+        if (key !== '')
+            this.seen.add(key);
+        try {
+            await hooks.onAccepted?.(input);
+        }
+        catch (err) {
+            // onAccepted is a best-effort side effect (e.g. a channel reaction); a
+            // failure there must not drop the turn.
+            this.log('warn', 'claude-code onAccepted hook failed', err);
+        }
+        // This runtime owns wrapping the channel input into its delivery shape: a
+        // structured channel turn becomes the native `<channel source="…">` block;
+        // a plain turn passes through unchanged.
+        const text = renderChannelInput(input);
+        const active = this.activeChannelTurn;
+        if (active !== null) {
+            try {
+                await this.steerChannelTurn(active, text);
+                return { status: 'submitted', turnId: active.turnId };
+            }
+            catch (err) {
+                return {
+                    status: 'failed',
+                    error: err instanceof Error ? err : new Error(String(err)),
+                };
+            }
+        }
+        const turnId = this.nextTurnId('turn');
+        const channelTurn = {
+            turnId,
+            pendingSteers: [],
+            session: null,
+            steerQueue: Promise.resolve(),
+        };
+        this.activeChannelTurn = channelTurn;
+        // Submit-then-serialize: return after accept (so the channel can ack
+        // promptly), run the turn on the serial queue. A turn failure cannot be
+        // returned to this caller without blocking the channel ack on full turn
+        // completion. Instead, a failed turn drives the runtime to `degraded` with a
+        // persisted `last_error` (visible via status/doctor) — never swallowed.
+        void this.runChannelTurnOnQueue(text, channelTurn).then(() => this.markTurnSucceeded(turnId), (err) => this.markTurnFailed(turnId, err));
+        return { status: 'submitted', turnId };
+    }
+    async completionInput(completion) {
+        if (this.stopped) {
+            return { status: 'unsupported', reason: 'runtime stopped' };
+        }
+        // Plain user-turn delivery: a stream-json user message marked
+        // `isSynthetic: false`, so claude-code treats it as ordinary human input
+        // rather than routing it through its native task-notification harness path.
+        // Submit-then-serialize: return accepted at enqueue so delivery acceptance
+        // is decoupled from model thinking time.
+        let text;
+        try {
+            text = await buildCompletionTurnText(completion, this.completionSpillDir);
+        }
+        catch (err) {
+            return {
+                status: 'failed',
+                error: err instanceof Error ? err : new Error(String(err)),
+            };
+        }
+        const turnId = `claude-teammate-${completion.id}`;
+        void this.runTurnOnQueue(text, turnId, { isSynthetic: false }).then(() => this.markTurnSucceeded(turnId), (err) => this.markTurnFailed(turnId, err));
+        return { status: 'accepted' };
+    }
+    /**
+     * Chain a turn onto the serial queue. Returns a promise that resolves when
+     * this turn completes and rejects when it fails, so awaiting callers (delivery)
+     * see the real outcome. The queue itself continues regardless of outcome so a
+     * failed turn does not wedge later turns.
+     */
+    runTurnOnQueue(prompt, turnId, options) {
+        const run = this.queue.then(() => this.runTurn(prompt, turnId, options));
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    runChannelTurnOnQueue(prompt, active) {
+        const run = this.queue.then(() => this.runChannelTurn(prompt, active));
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    async runChannelTurn(prompt, active) {
+        const session = await this.ensureSession();
+        const steers = active.pendingSteers.splice(0);
+        const fullPrompt = steers.length === 0 ? prompt : [prompt, ...steers].join('\n\n');
+        const outcome = session.submitTurn(fullPrompt);
+        active.session = session;
+        try {
+            await this.applyTurnOutcome(await outcome, active.turnId);
+        }
+        finally {
+            active.session = null;
+            if (this.activeChannelTurn === active)
+                this.activeChannelTurn = null;
+            active.pendingSteers = [];
+        }
+    }
+    async steerChannelTurn(active, prompt) {
+        const session = active.session;
+        if (session === null) {
+            active.pendingSteers.push(prompt);
+            return;
+        }
+        const steer = active.steerQueue.then(() => session.steerTurn(prompt, { priority: 'next' }));
+        active.steerQueue = steer.then(() => undefined, () => undefined);
+        await steer;
+    }
+    async markTurnSucceeded(turnId) {
+        this.deps.onTurnSettled?.({ turnId, status: 'completed' });
+        if (this.stopped)
+            return;
+        if (this.status !== 'ready')
+            await this.setStatus('ready');
+    }
+    async markTurnFailed(turnId, err) {
+        this.log('error', `claude-code turn ${turnId} failed`, err);
+        // A turn that fails after stop() was requested (the resident child is being
+        // torn down) is a `stopped` settlement; otherwise it is a genuine `failed`.
+        // Fire before the stopped early-return so an interrupted teammate turn is
+        // never lost.
+        this.deps.onTurnSettled?.({
+            turnId,
+            status: this.stopped ? 'stopped' : 'failed',
+            error: err instanceof Error ? err : new Error(String(err)),
+        });
+        if (this.stopped)
+            return;
+        // Surface the failure as durable runtime state rather than swallowing it.
+        await this.setStatus('degraded', err);
+    }
+    /**
+     * Ensure a live resident session exists, spawning (or re-spawning after an
+     * unexpected exit) as needed. Re-spawn resumes the persisted session id so the
+     * conversation survives a crash.
+     */
+    async ensureSession() {
+        if (this.session !== null && this.session.isAlive())
+            return this.session;
+        const args = claudeCodeResidentArgs({
+            config: this.config,
+            mcpConfigPath: this.mcpConfigPath,
+            resumeSessionId: this.threadId,
+            systemPromptContent: this.deps.systemPromptContent,
+            skillSources: this.deps.skillSources,
+        });
+        const session = this.deps.sessionFactory({
+            bin: this.bin,
+            args,
+            cwd: this.cwd,
+            env: this.buildProcessEnv(this.config.extra_env),
+            stderrLogPath: this.stderrLogPath,
+            turnTimeoutMs: this.config.turn_timeout_ms,
+            remoteControl: this.config.remote_control,
+            onRemoteControlUrl: this.config.remote_control
+                ? (url) => {
+                    this.log('info', `claude-code remote control URL: ${url}`);
+                }
+                : undefined,
+            log: (level, msg, err) => this.log(level, msg, err),
+        });
+        session.setOnExit(() => {
+            void this.onSessionExit(session);
+        });
+        await session.start();
+        this.session = session;
+        return session;
+    }
+    /** React to an unexpected resident-child exit: degrade and drop the session. */
+    async onSessionExit(session) {
+        if (this.session !== session)
+            return; // already replaced/stopped
+        this.session = null;
+        if (this.stopped)
+            return;
+        this.log('error', 'claude-code resident child exited unexpectedly');
+        await this.setStatus('degraded', new Error('claude resident child exited'));
+    }
+    async runTurn(prompt, turnId, options) {
+        const session = await this.ensureSession();
+        await this.runTurnWithSession(session, prompt, turnId, options);
+    }
+    async runTurnWithSession(session, prompt, turnId, options) {
+        const outcome = await session.submitTurn(prompt, options);
+        await this.applyTurnOutcome(outcome, turnId);
+    }
+    async applyTurnOutcome(outcome, turnId) {
+        if (outcome.sessionId !== null &&
+            outcome.sessionId !== '' &&
+            outcome.sessionId !== this.threadId) {
+            this.threadId = outcome.sessionId;
+            await this.deps.state.setThreadId(this.dispatcherId, outcome.sessionId);
+        }
+        if (!outcome.isError)
+            this.lastResult = { text: outcome.text };
+        if (outcome.isError) {
+            const detail = outcome.errors.length > 0
+                ? outcome.errors.join('; ')
+                : (outcome.subtype ?? 'unknown error');
+            throw new Error(`claude turn ${turnId} returned an error result: ${detail}`);
+        }
+        this.log('info', `claude-code turn ${turnId} completed`);
+    }
+    nextTurnId(kind) {
+        return `claude-${kind}-${this.runtimeInstanceId}-${++this.turnCounter}`;
+    }
+    buildProcessEnv(extraEnv) {
+        // Neutral env boundary: { ...process.env, ...injectEnv, ...extra_env }.
+        // `injectEnv` is the host's optional injection seam (empty today); `extraEnv`
+        // is this provider's own `config.extra_env`, merged last so it can override.
+        return {
+            ...globalThis.process.env,
+            ...(this.deps.injectEnv ?? {}),
+            ...extraEnv,
+        };
+    }
+    async setStatus(status, err) {
+        this.status = status;
+        await this.deps.state.setStatus(this.dispatcherId, status, err !== undefined ? { last_error: errMessage(err) } : {});
+    }
+    log(level, msg, err) {
+        this.logger[level](msg, err !== undefined ? { err } : undefined);
+    }
+}
+/**
+ * Minimal `console.error`-backed logger the runtime falls back to when the host
+ * passes none (the bare generic-loader / standalone path). Owned here, never in
+ * `@excitedjs/dreamux-types` (which is declaration-only).
+ */
+function consoleFallbackLogger(dispatcherId) {
+    const sink = (level) => (message, fields) => {
+        const prefix = `[claude-code ${dispatcherId}] ${level}`;
+        const err = fields?.['err'];
+        if (err !== undefined)
+            console.error(prefix, message, err);
+        else
+            console.error(prefix, message);
+    };
+    return {
+        error: sink('error'),
+        warn: sink('warn'),
+        info: sink('info'),
+        debug: () => { },
+        trace: () => { },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/stream.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The Claude Code stream-json wire protocol (issue #120).
+ *
+ * A clean-room model of the NDJSON envelopes the `claude` CLI emits and accepts
+ * on stdio under `--input-format stream-json --output-format stream-json`. This
+ * is what makes the `builtin:claude-code` runtime *resident*: one long-lived
+ * `claude --print` process consumes user-message lines on stdin and streams
+ * `init` / `assistant` / `result` envelopes on stdout, instead of a fresh
+ * one-shot process per turn.
+ *
+ * Two design rules, both load-bearing:
+ *
+ *  - **Forward-tolerant by construction.** The CLI's real envelope set is much
+ *    wider than anything Dreamux consumes (extra `system` subtypes, rate-limit
+ *    events, hook lifecycle, streamlined variants, and extra `result` fields).
+ *    This parser never validates a closed schema and never throws on an unknown
+ *    `type` / `subtype`; it reads only the fields the runtime needs and ignores
+ *    the rest. A wider or newer CLI build cannot break a turn.
+ *
+ *  - **Pure, no IO.** No process, no clock, no filesystem — so the line framer,
+ *    the line parser, and the turn aggregator are unit-tested against synthetic
+ *    envelope sequences (hand-authored to the real wire shapes) with no live
+ *    `claude` binary.
+ *
+ * Public-safety note: this module is a generic protocol model. It carries no
+ * Feishu identifiers, tokens, private paths, or environment-specific details.
+ */
+import type { JsonObject, ParsedLine, TurnOutcome, TurnSubmitOptions } from './types.js';
+export type { JsonObject, ParsedLine, ResultEnvelope, TurnOutcome, } from './types.js';
+/**
+ * Incremental newline framer. The child's stdout is NDJSON but arrives in
+ * arbitrary chunks; `push` returns the complete lines so far and buffers a
+ * trailing partial line until its newline lands. Blank lines are dropped.
+ */
+export declare class LineBuffer {
+    private buf;
+    push(chunk: string): string[];
+    /** Any buffered bytes with no trailing newline (e.g. at stream end). */
+    flush(): string | null;
+}
+/**
+ * Join the text blocks of an Anthropic assistant `message.content` array.
+ * `thinking` and `tool_use` blocks contribute no visible text and are skipped.
+ */
+export declare function assistantText(message: unknown): string;
+/**
+ * Decode one stdout line. Never throws: a non-JSON line becomes `parse_error`,
+ * and a JSON object of an unmodelled type becomes `other`.
+ */
+export declare function parseLine(line: string): ParsedLine;
+/**
+ * One user turn as a stream-json `user` message line (no trailing newline).
+ *
+ * `isSynthetic` / `priority` are siblings of `message` on the stdin envelope
+ * (claude-code SDKUserMessage schema), not part of the message body. They are
+ * only set for the native completion-notification idiom; a plain channel turn
+ * omits them entirely and reads as a normal human user turn.
+ */
+export declare function buildUserMessage(text: string, options?: TurnSubmitOptions): string;
+/** Enable Claude Code Remote Control via a stream-json control request. */
+export declare function buildRemoteControlEnable(requestId: string): string;
+/**
+ * Answer a `can_use_tool` control request with `allow`. A Dreamux dispatcher
+ * runs unattended, so the answer for a runtime that has no human to consult is
+ * "allow"; `updatedInput` echoes the tool's original input back unchanged.
+ *
+ * This is a defensive path: under a bypassing permission mode the CLI does not
+ * gate tools, so `can_use_tool` is not normally emitted. It is wired so that if
+ * a build or mode does emit one, the runtime answers it rather than leaving the
+ * turn waiting on an unanswered control request.
+ */
+export declare function buildCanUseToolAllow(requestId: string, input: JsonObject): string;
+/** Acknowledge any other control request with a bare success so the CLI proceeds. */
+export declare function buildControlAck(requestId: string): string;
+/**
+ * Accumulates the envelopes of a single turn and resolves a `TurnOutcome` when
+ * the `result` lands. One aggregator per turn: feed every `ParsedLine`, then
+ * read `outcome()` once `done` is true.
+ *
+ * The final text prefers the `result.result` (the CLI's own canonical answer)
+ * and falls back to the latest `assistant` snapshot — so a turn that ends
+ * tool-only or whose result text is empty still surfaces whatever the model
+ * last said.
+ */
+export declare class TurnAggregator {
+    private lastAssistantText;
+    private result;
+    private initSessionId;
+    /** Returns `true` once the terminal `result` has been seen. */
+    get done(): boolean;
+    /** The session id from `init` (or the result), once known. */
+    get sessionId(): string | null;
+    accept(line: ParsedLine): void;
+    outcome(): TurnOutcome | null;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAEV,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AAYpB;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAM;IAEjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAc7B,wEAAwE;IACxE,KAAK,IAAI,MAAM,GAAG,IAAI;CAKvB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CActD;AAuBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAkElD;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAQR;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CASjF;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKzD;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,aAAa,CAAuB;IAE5C,+DAA+D;IAC/D,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,8DAA8D;IAC9D,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAgB9B,OAAO,IAAI,WAAW,GAAG,IAAI;CAa9B"}