@qduc/term2 0.14.0 → 0.16.0

package/dist/gateway/safe-log.js

@@ -0,0 +1,108 @@
+import { createHmac, randomUUID } from 'node:crypto';
+const OPERATIONS = new Set([
+    'startup',
+    'workspace_list',
+    'workspace_candidate_validate',
+    'workspace_candidate_browse',
+    'workspace_candidate_select',
+    'settings_read',
+    'settings_write',
+    'credential_write',
+    'credential_delete',
+    'oauth_login',
+    'oauth_select',
+    'oauth_delete',
+    'session_update',
+    'session_list',
+    'model_list',
+    'session_create',
+    'session_read',
+    'message_submit',
+    'interaction_resolve',
+    'abort',
+    'events_connect',
+    'shutdown',
+]);
+const OUTCOMES = new Set(['allowed', 'denied', 'failed', 'interrupted']);
+const REASONS = new Set([
+    'disabled',
+    'invalid_assertion',
+    'replay',
+    'owner_mismatch',
+    'workspace_not_found',
+    'workspace_escape',
+    'model_unavailable',
+    'provider_unavailable',
+    'shutdown',
+    'startup_failed',
+    'accepted',
+    'completed',
+    'workspace_root_unavailable',
+    'workspace_root_not_canonical',
+    'workspace_path_escape',
+    'workspace_not_readable',
+    'candidate_registry_full',
+    'settings_conflict',
+    'settings_not_allowed',
+    'not_persisted',
+]);
+const ALLOWED_KEYS = new Set([
+    'schemaVersion',
+    'sessionId',
+    'workspaceId',
+    'grantVersion',
+    'access',
+    'principalRef',
+    'providerId',
+    'modelId',
+    'correlationId',
+    'operation',
+    'outcome',
+    'reasonCode',
+]);
+export class GatewayLogError extends Error {
+    constructor() {
+        super('gateway log metadata rejected');
+        this.name = 'GatewayLogError';
+    }
+}
+export function principalRef(ownerUserId, key) {
+    return createHmac('sha256', key).update(ownerUserId).digest('base64url').slice(0, 32);
+}
+export function createSafeLogMetadata(input) {
+    const value = { schemaVersion: 1, correlationId: input.correlationId ?? randomUUID(), ...input };
+    for (const key of Object.keys(value))
+        if (!ALLOWED_KEYS.has(key))
+            throw new GatewayLogError();
+    if (value.schemaVersion !== 1 || typeof value.correlationId !== 'string' || !value.correlationId)
+        throw new GatewayLogError();
+    if (!OPERATIONS.has(value.operation) ||
+        !OUTCOMES.has(value.outcome)) {
+        throw new GatewayLogError();
+    }
+    if (value.reasonCode !== undefined && (typeof value.reasonCode !== 'string' || !REASONS.has(value.reasonCode)))
+        throw new GatewayLogError();
+    if (value.grantVersion !== undefined && (!Number.isInteger(value.grantVersion) || value.grantVersion < 0))
+        throw new GatewayLogError();
+    if (value.access !== undefined && value.access !== 'read' && value.access !== 'read_write')
+        throw new GatewayLogError();
+    for (const key of ['sessionId', 'workspaceId', 'principalRef', 'providerId', 'modelId']) {
+        if (value[key] !== undefined &&
+            (typeof value[key] !== 'string' || value[key].length > 200 || /[\u0000\r\n]/.test(value[key])))
+            throw new GatewayLogError();
+    }
+    return Object.freeze(value);
+}
+export class GatewayAuditLog {
+    writer;
+    constructor(writer) {
+        this.writer = writer;
+    }
+    async write(record) {
+        const result = this.writer(record);
+        if (!result || typeof result.then !== 'function')
+            throw new GatewayLogError();
+        await result;
+    }
+}
+//# sourceMappingURL=safe-log.js.map

package/dist/gateway/safe-log.js.map

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

package/dist/gateway/server-session.d.ts

@@ -0,0 +1,65 @@
+import type { ConversationEvent } from '../services/conversation/conversation-events.js';
+import type { ConversationService } from '../services/conversation/conversation-service.js';
+import type { PendingInteractionResolution, ResolvePendingInteractionRequest } from '../services/session/pending-interaction-state.js';
+import type { UserTurn } from '../types/user-turn.js';
+import type { GatewaySessionComposition, SecretFreeWorkerSettings, SessionBinding } from './contracts.js';
+import type { RuntimeResourcePolicy } from './runtime-factory.js';
+import type { PreparedMessageResult, PreparedMessageIds } from '../services/conversation/conversation-adapter.js';
+export type ServerSessionStatus = 'idle' | 'running' | 'awaiting_interaction' | 'interrupted' | 'closed';
+export type AbortOutcome = {
+    readonly kind: 'aborted';
+    readonly turnId: string;
+    readonly discardedTurnIds: string[];
+} | {
+    readonly kind: 'already_settled';
+    readonly turnId: string;
+} | {
+    readonly kind: 'no_op';
+    readonly turnId: string;
+} | {
+    readonly kind: 'interrupted';
+    readonly turnId: string;
+    readonly reason: 'cancellation_timeout';
+};
+export declare class ServerSessionError extends Error {
+    readonly code: 'closed' | 'wrong_turn' | 'stale_interaction' | 'interrupted';
+    constructor(code: ServerSessionError['code']);
+}
+export type ServerSessionEventContext = {
+    readonly turnId?: string;
+    readonly discardedTurnIds: readonly string[];
+};
+export type ServerSessionOptions = {
+    binding: SessionBinding;
+    service: ConversationService;
+    composition: GatewaySessionComposition;
+    policy: RuntimeResourcePolicy;
+    eventSink?: (event: ConversationEvent, context: ServerSessionEventContext) => void | PromiseLike<void>;
+    onDispose?: () => void;
+};
+export declare class ServerSession {
+    #private;
+    readonly id: string;
+    readonly ownerUserId: string;
+    readonly workspaceId: string;
+    readonly binding: Readonly<SessionBinding>;
+    readonly service: ConversationService;
+    constructor(options: ServerSessionOptions);
+    get sessionId(): string;
+    get status(): ServerSessionStatus;
+    get activeTurnId(): string | null;
+    get abortGeneration(): number;
+    get lastAbortOutcome(): AbortOutcome | undefined;
+    get settings(): Readonly<SecretFreeWorkerSettings>;
+    get resources(): GatewaySessionComposition;
+    /** Register lifecycle ownership without replacing the class dispose method. */
+    addDisposeHook(hook: () => void | Promise<void>): void;
+    prepareMessage(input: UserTurn | string, ids: PreparedMessageIds): Promise<PreparedMessageResult>;
+    commitMessage(leaseId: string): Promise<void>;
+    cancelPreparedMessage(leaseId: string): Promise<void>;
+    resolvePendingInteraction(request: ResolvePendingInteractionRequest): PendingInteractionResolution;
+    abort(turnId: string): Promise<AbortOutcome>;
+    dispose(reason?: 'closed' | 'shutdown' | 'interrupted'): Promise<void>;
+    private assertOpen;
+}
+//# sourceMappingURL=server-session.d.ts.map

package/dist/gateway/server-session.d.ts.map

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

package/dist/gateway/server-session.js

@@ -0,0 +1,284 @@
+export class ServerSessionError extends Error {
+    code;
+    constructor(code) {
+        super('server session operation rejected');
+        this.name = 'ServerSessionError';
+        this.code = code;
+    }
+}
+function withTimeout(promise, timeoutMs) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve({ timedOut: true }), timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve({ timedOut: false, value });
+        }, () => {
+            clearTimeout(timer);
+            resolve({ timedOut: true });
+        });
+    });
+}
+export class ServerSession {
+    id;
+    ownerUserId;
+    workspaceId;
+    binding;
+    service;
+    #status = 'idle';
+    #activeTurnId = null;
+    #abortGeneration = 0;
+    #settledTurns = new Set();
+    #cancelledLeases = new Set();
+    #disposePromise = null;
+    #preparedTurns = new Map();
+    #composition;
+    #policy;
+    #eventSink;
+    #onDispose;
+    #disposeHooks = new Set();
+    #deadline;
+    #lastAbortOutcome;
+    constructor(options) {
+        this.id = options.binding.sessionId;
+        this.ownerUserId = options.binding.ownerUserId;
+        this.workspaceId = options.binding.workspaceId;
+        this.binding = Object.freeze({ ...options.binding });
+        this.service = options.service;
+        this.#composition = options.composition;
+        this.#policy = options.policy;
+        this.#eventSink = options.eventSink;
+        this.#onDispose = options.onDispose;
+        this.service.setQueuedTurnStartObserver((execution) => {
+            if (this.#status === 'interrupted' || this.#status === 'closed')
+                return;
+            this.#activeTurnId = execution.requestId;
+            this.#status = 'running';
+            this.#startDeadline(execution.requestId);
+        });
+        this.service.setEventSink(async (event) => {
+            if (event.type === 'approval_required')
+                this.#status = 'awaiting_interaction';
+            const discardedTurnIds = event.type === 'error' ? this.service.consumeFailureDiscardedTurnIds() : [];
+            for (const discardedTurnId of discardedTurnIds)
+                this.#settledTurns.add(discardedTurnId);
+            const turnId = this.#activeTurnId ?? undefined;
+            if (event.type === 'final' || event.type === 'error') {
+                if (this.#activeTurnId)
+                    this.#settledTurns.add(this.#activeTurnId);
+                this.#activeTurnId = null;
+                this.#clearDeadline();
+            }
+            if (this.#status !== 'interrupted' && this.#status !== 'closed') {
+                this.#status = this.#computePublicStatus();
+            }
+            try {
+                await this.#eventSink?.(event, { turnId, discardedTurnIds });
+            }
+            catch (error) {
+                this.#status = 'interrupted';
+                this.service.closeAdmission();
+                throw error;
+            }
+        });
+    }
+    get sessionId() {
+        return this.id;
+    }
+    #computePublicStatus() {
+        if (this.#status === 'interrupted' || this.#status === 'closed')
+            return this.#status;
+        if (this.#activeTurnId) {
+            if (this.#status === 'awaiting_interaction')
+                return 'awaiting_interaction';
+            return 'running';
+        }
+        const approvals = this.service.backgroundSubagentApprovals?.getSnapshot?.();
+        if (approvals && approvals.pendingCount > 0)
+            return 'awaiting_interaction';
+        const details = this.service.backgroundTaskControl?.listDetails?.() ?? [];
+        for (const d of details) {
+            if (d.kind === 'subagent') {
+                if (d.status === 'awaiting_approval' || d.status === 'waiting_for_answer') {
+                    return 'awaiting_interaction';
+                }
+                if (d.status === 'running' || d.status === 'cancelling') {
+                    return 'running';
+                }
+            }
+            else if (d.kind === 'shell') {
+                if (d.status === 'running' || d.status === 'cancelling') {
+                    return 'running';
+                }
+            }
+        }
+        return 'idle';
+    }
+    get status() {
+        if (this.#status === 'interrupted' || this.#status === 'closed')
+            return this.#status;
+        return this.#computePublicStatus();
+    }
+    get activeTurnId() {
+        return this.#activeTurnId;
+    }
+    get abortGeneration() {
+        return this.#abortGeneration;
+    }
+    get lastAbortOutcome() {
+        return this.#lastAbortOutcome;
+    }
+    get settings() {
+        return Object.freeze({ ...this.#composition.settings });
+    }
+    get resources() {
+        return this.#composition;
+    }
+    /** Register lifecycle ownership without replacing the class dispose method. */
+    addDisposeHook(hook) {
+        if (this.#disposePromise) {
+            hook();
+            return;
+        }
+        this.#disposeHooks.add(hook);
+    }
+    prepareMessage(input, ids) {
+        if (this.#status === 'closed' || this.#status === 'interrupted') {
+            return Promise.resolve({ kind: 'rejected', reason: 'closed' });
+        }
+        return this.service.prepareMessage(input, ids).then((result) => {
+            if (result.kind === 'prepared')
+                this.#preparedTurns.set(result.leaseId, result.turnId);
+            return result;
+        });
+    }
+    async commitMessage(leaseId) {
+        this.assertOpen();
+        const turnId = this.#preparedTurns.get(leaseId);
+        if (!turnId)
+            throw new ServerSessionError('wrong_turn');
+        const resetBudget = this.#composition.providerBroker.resetRequestBudget;
+        resetBudget?.();
+        try {
+            await this.service.commitMessage(leaseId);
+        }
+        catch (error) {
+            this.#preparedTurns.delete(leaseId);
+            throw error;
+        }
+        this.#preparedTurns.delete(leaseId);
+        if (!this.#activeTurnId) {
+            this.#activeTurnId = turnId;
+            this.#status = 'running';
+            this.#startDeadline(turnId);
+        }
+    }
+    async cancelPreparedMessage(leaseId) {
+        if (this.#status === 'closed')
+            throw new ServerSessionError('closed');
+        if (this.#cancelledLeases.has(leaseId))
+            return;
+        await this.service.cancelPreparedMessage(leaseId);
+        this.#preparedTurns.delete(leaseId);
+        this.#cancelledLeases.add(leaseId);
+    }
+    resolvePendingInteraction(request) {
+        this.assertOpen();
+        const result = this.service.resolvePendingInteraction(request);
+        if (result.kind === 'stale_interaction')
+            throw new ServerSessionError('stale_interaction');
+        return result;
+    }
+    async abort(turnId) {
+        if (this.#settledTurns.has(turnId))
+            return { kind: 'already_settled', turnId };
+        if (this.#status === 'closed')
+            return { kind: 'already_settled', turnId };
+        if (this.#status === 'interrupted') {
+            const outcome = { kind: 'interrupted', turnId, reason: 'cancellation_timeout' };
+            this.#lastAbortOutcome = outcome;
+            return outcome;
+        }
+        if (!this.#activeTurnId)
+            return { kind: 'no_op', turnId };
+        if (this.#activeTurnId !== turnId)
+            throw new ServerSessionError('wrong_turn');
+        // Close admission before awaiting the bounded barrier. This makes a
+        // cancellation race fail closed instead of letting fresh work auto-run.
+        this.#abortGeneration += 1;
+        this.service.closeAdmission();
+        try {
+            const result = await this.service.abortAndDiscard();
+            if (!result.proven) {
+                const outcome = { kind: 'interrupted', turnId, reason: 'cancellation_timeout' };
+                this.#status = 'interrupted';
+                this.#lastAbortOutcome = outcome;
+                return outcome;
+            }
+            this.#settledTurns.add(turnId);
+            for (const discardedTurnId of result.discardedTurnIds)
+                this.#settledTurns.add(discardedTurnId);
+            this.#preparedTurns.clear();
+            this.#activeTurnId = null;
+            this.#status = this.#computePublicStatus();
+            this.#clearDeadline();
+            this.service.reopenAdmission();
+            const outcome = { kind: 'aborted', turnId, discardedTurnIds: result.discardedTurnIds };
+            this.#lastAbortOutcome = outcome;
+            return outcome;
+        }
+        catch {
+            this.#status = 'interrupted';
+            const outcome = { kind: 'interrupted', turnId, reason: 'cancellation_timeout' };
+            this.#lastAbortOutcome = outcome;
+            return outcome;
+        }
+    }
+    async dispose(reason = 'closed') {
+        if (this.#disposePromise)
+            return this.#disposePromise;
+        this.#disposePromise = (async () => {
+            this.service.closeAdmission();
+            this.#preparedTurns.clear();
+            this.#clearDeadline();
+            let interrupted = reason === 'interrupted';
+            const cancellation = await withTimeout(this.service.abortAndDiscard(), this.#policy.shutdownGraceMs);
+            if (cancellation.timedOut || !cancellation.value?.proven)
+                interrupted = true;
+            const shutdown = await withTimeout(this.service.shutdown(), this.#policy.shutdownGraceMs);
+            if (shutdown.timedOut)
+                interrupted = true;
+            await Promise.resolve(this.#composition.dispose());
+            this.#activeTurnId = null;
+            this.#status = interrupted && reason === 'interrupted' ? 'interrupted' : 'closed';
+            for (const hook of this.#disposeHooks)
+                await hook();
+            this.#disposeHooks.clear();
+            this.#onDispose?.();
+        })();
+        return this.#disposePromise;
+    }
+    assertOpen() {
+        if (this.#status === 'closed')
+            throw new ServerSessionError('closed');
+        if (this.#status === 'interrupted')
+            throw new ServerSessionError('interrupted');
+    }
+    #startDeadline(turnId) {
+        this.#clearDeadline();
+        this.#deadline = setTimeout(() => {
+            void this.abort(turnId).then((outcome) => {
+                this.#lastAbortOutcome = outcome;
+            }, () => {
+                this.#status = 'interrupted';
+                this.#lastAbortOutcome = { kind: 'interrupted', turnId, reason: 'cancellation_timeout' };
+            });
+        }, this.#policy.maxActiveTurnMs);
+        this.#deadline.unref?.();
+    }
+    #clearDeadline() {
+        if (this.#deadline)
+            clearTimeout(this.#deadline);
+        this.#deadline = undefined;
+    }
+}
+//# sourceMappingURL=server-session.js.map

package/dist/gateway/server-session.js.map

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

package/dist/gateway/server.d.ts

@@ -0,0 +1,65 @@
+import { type Server, type IncomingMessage, type ServerResponse } from 'node:http';
+import type { AssertionVerifier } from './assertion.js';
+import type { GatewayAssertionClaims } from './contracts.js';
+import type { ReplayLiveSubscription } from './persistence/contracts.js';
+import { GatewayLifecycle } from './lifecycle.js';
+export declare const GATEWAY_EVENT_STREAM_CONTENT_TYPE = "text/event-stream";
+export declare const GATEWAY_EVENT_HEARTBEAT_INTERVAL_MS = 15000;
+export declare const GATEWAY_EVENT_STREAM_HEARTBEAT = ": heartbeat";
+export type GatewayEventStream = {
+    start(response: ServerResponse, request: IncomingMessage): Promise<void>;
+};
+export type GatewayRpcResult = {
+    status: number;
+    body: unknown;
+    headers?: Record<string, string>;
+    stream?: GatewayEventStream;
+};
+export type GatewayRpcHandler = (input: {
+    claims: GatewayAssertionClaims;
+    body: unknown;
+    request: IncomingMessage;
+    url: URL;
+    correlationId?: string;
+}) => Promise<GatewayRpcResult>;
+export type GatewayPairingHandler = (input: {
+    body: unknown;
+    request: IncomingMessage;
+    url: URL;
+}) => Promise<GatewayRpcResult>;
+export type GatewayTlsOptions = {
+    certPath: string;
+    keyPath: string;
+    caPath?: string;
+    requireClientCert: boolean;
+};
+type GatewayTransportOptions = {
+    socketPath: string;
+    host?: never;
+    port?: never;
+    tls?: never;
+} | {
+    socketPath?: never;
+    host?: string;
+    port: number;
+    tls: GatewayTlsOptions;
+};
+export type GatewayServerOptions = GatewayTransportOptions & {
+    verifier: AssertionVerifier;
+    handler: GatewayRpcHandler;
+    pairingHandler?: GatewayPairingHandler;
+    lifecycle?: GatewayLifecycle;
+};
+/** Private Unix-socket or TLS network control server. */
+export declare class GatewayServer {
+    #private;
+    constructor(options: GatewayServerOptions);
+    get lifecycle(): GatewayLifecycle;
+    get listening(): boolean;
+    get address(): ReturnType<Server['address']>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    shutdown(graceMs: number): Promise<void>;
+}
+export type { ReplayLiveSubscription };
+//# sourceMappingURL=server.d.ts.map

package/dist/gateway/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../source/gateway/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAKjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,iCAAiC,sBAAsB,CAAC;AACrE,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAC1D,eAAO,MAAM,8BAA8B,gBAAgB,CAAC;AAG5D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhC,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;CACV,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,uBAAuB,GACxB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/D;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,GAAG;IAC3D,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,yDAAyD;AACzD,qBAAa,aAAa;;IAYxB,YAAY,OAAO,EAAE,oBAAoB,EAyBxC;IAED,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IACD,IAAI,SAAS,IAAI,OAAO,CAEvB;IACD,IAAI,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAE3C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;IAEK,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7C;CA2GF;AAaD,YAAY,EAAE,sBAAsB,EAAE,CAAC"}