@beeos-ai/bma-executor-sdk 0.0.0-stage → 0.4.0

package/dist/agent.js

@@ -0,0 +1,478 @@
+// Agent capability, executor side: a complete local agent served over the
+// executor protocol. The SDK owns turn.start/input/cancel, session.close,
+// event ids and sequences, ACK tracking and resend after reconnect,
+// interactions, and the session.status_running / status_idle events that
+// frame every turn. Mirrors go/executor agent.go.
+import { JsonRpcErrorCode, } from './generated/executor.js';
+import { AgentSessionClosedError, ClientStoppedError, deferred, RpcError } from './errors.js';
+const RESEND_DELAY_MS = 200;
+const CLOSE_FLUSH_WAIT_MS = 30_000;
+class DeadlineExceeded extends Error {
+    constructor() {
+        super('turn deadline_ms exceeded');
+    }
+}
+/** An unbounded async queue with one consumer. */
+class InputQueue {
+    items = [];
+    waiter;
+    ended = false;
+    push(item) {
+        if (this.waiter) {
+            const waiter = this.waiter;
+            this.waiter = undefined;
+            waiter.resolve({ value: item, done: false });
+        }
+        else
+            this.items.push(item);
+    }
+    end() {
+        this.ended = true;
+        this.waiter?.resolve({ value: undefined, done: true });
+        this.waiter = undefined;
+    }
+    next() {
+        const item = this.items.shift();
+        if (item !== undefined)
+            return Promise.resolve({ value: item, done: false });
+        if (this.ended)
+            return Promise.resolve({ value: undefined, done: true });
+        this.waiter = deferred();
+        return this.waiter.promise;
+    }
+    [Symbol.asyncIterator]() {
+        return { next: () => this.next() };
+    }
+}
+/** The handle runTurn uses to talk to the platform. */
+export class AgentTurn {
+    session;
+    params;
+    ended = false;
+    abort = new AbortController();
+    done = deferred();
+    seen = new Set();
+    queue = new InputQueue();
+    constructor(session, params) {
+        this.session = session;
+        this.params = params;
+        this.seen.add(params.input_id);
+    }
+    get sessionId() {
+        return this.session.id;
+    }
+    get turnId() {
+        return this.params.turn_id;
+    }
+    /** turn.input messages in arrival order; the iteration ends with the turn. */
+    get inputs() {
+        return this.queue;
+    }
+    /** @internal */
+    pushInput(input) {
+        this.queue.push(input);
+    }
+    /** @internal */
+    finish() {
+        this.ended = true;
+        this.queue.end();
+    }
+    /** A fresh event id, for a message streamed with delta before emitWithId. */
+    newEventId() {
+        return this.session.newEventId();
+    }
+    /**
+     * Queues one durable event and returns its id. Delivery is asynchronous,
+     * ordered and at-least-once; the platform deduplicates by event id.
+     */
+    emit(event) {
+        return this.emitWithId(this.newEventId(), event);
+    }
+    emitWithId(eventId, event) {
+        if (this.ended)
+            throw new Error('turn already ended');
+        this.session.enqueue(this.params.turn_id, eventId, event);
+        return eventId;
+    }
+    /** Streams a transient preview of the durable event eventId; dropped while disconnected, never resent. */
+    delta(eventId, eventType, index, text) {
+        const params = {
+            session_id: this.session.id,
+            turn_id: this.params.turn_id,
+            event_id: eventId,
+            event_type: eventType,
+            index,
+            text,
+        };
+        try {
+            this.session.host.notify('session.event_delta', params);
+        }
+        catch (error) {
+            this.session.host.log('debug', 'session.event_delta dropped', error);
+        }
+    }
+    /** Resolves once every event emitted so far is acknowledged. */
+    flush(signal) {
+        return this.session.flush(signal);
+    }
+    /**
+     * Asks the platform for an approval or an answer and waits for
+     * interaction.response. It flushes first so the platform already has the
+     * agent.tool_use the request references. When signal aborts or expires_at
+     * passes, it withdraws the interaction with interaction.cancel; an expiry
+     * resolves with outcome expired, which the agent must treat as a deny.
+     */
+    async requestInteraction(request, signal) {
+        const session = this.session;
+        const params = {
+            ...request,
+            session_id: session.id,
+            turn_id: this.params.turn_id,
+            interaction_id: request.interaction_id || `int_${this.newEventId().slice(4)}`,
+        };
+        const answer = deferred();
+        session.pending.set(params.interaction_id, answer);
+        try {
+            await this.flush(signal);
+            await session.callUntilConnected(() => session.host.call('interaction.request', params), signal);
+            const waits = [answer.promise];
+            let timer;
+            if (params.expires_at) {
+                const at = Date.parse(params.expires_at);
+                if (Number.isNaN(at))
+                    throw new Error(`invalid expires_at ${params.expires_at}`);
+                waits.push(new Promise((resolve) => {
+                    timer = setTimeout(() => {
+                        void session.withdraw(params.interaction_id, 'expired');
+                        resolve({ session_id: session.id, interaction_id: params.interaction_id, outcome: 'expired' });
+                    }, at - Date.now());
+                }));
+            }
+            if (signal) {
+                waits.push(new Promise((_resolve, reject) => {
+                    const onAbort = () => {
+                        void session.withdraw(params.interaction_id, 'turn_canceled');
+                        reject(signal.reason);
+                    };
+                    if (signal.aborted)
+                        onAbort();
+                    else
+                        signal.addEventListener('abort', onAbort, { once: true });
+                }));
+            }
+            try {
+                return await Promise.race(waits);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        finally {
+            session.pending.delete(params.interaction_id);
+        }
+    }
+    /** Withdraws an open interaction, for example one the user answered locally (resolved_locally). */
+    cancelInteraction(interactionId, reason) {
+        return this.session.withdraw(interactionId, reason);
+    }
+}
+/** One platform session on this executor: its outbox of durable events and at most one running turn. */
+class AgentSession {
+    host;
+    id;
+    nextSequence = 1;
+    nextId = 0;
+    outbox = [];
+    wake = deferred();
+    drained = deferred();
+    closed = false;
+    turn;
+    results = new Map();
+    pending = new Map();
+    answered = new Set();
+    constructor(host, id) {
+        this.host = host;
+        this.id = id;
+        this.drained.resolve();
+        void this.sendLoop();
+    }
+    newEventId() {
+        return `evt_${this.id}_${++this.nextId}`;
+    }
+    enqueue(turnId, eventId, event) {
+        if (this.closed)
+            throw new AgentSessionClosedError();
+        const params = {
+            session_id: this.id,
+            turn_id: turnId,
+            event_id: eventId,
+            sequence: this.nextSequence++,
+            event: event,
+        };
+        if (this.outbox.length === 0)
+            this.drained = deferred();
+        this.outbox.push({ params });
+        this.signal();
+    }
+    signal() {
+        this.wake.resolve();
+    }
+    async flush(signal) {
+        if (!signal)
+            return this.drained.promise;
+        await Promise.race([
+            this.drained.promise,
+            new Promise((_resolve, reject) => {
+                if (signal.aborted)
+                    reject(signal.reason);
+                signal.addEventListener('abort', () => reject(signal.reason), { once: true });
+            }),
+        ]);
+    }
+    /**
+     * Delivers the outbox head first, one event at a time, so the platform sees
+     * every session in sequence order. A transport failure keeps the event and
+     * waits for the next registration: the resend after reconnect.
+     */
+    async sendLoop() {
+        for (;;) {
+            const head = this.outbox[0];
+            if (!head) {
+                if (this.closed || this.host.stopSignal.aborted)
+                    return;
+                this.wake = deferred();
+                await this.wake.promise;
+                continue;
+            }
+            try {
+                await this.callUntilConnected(() => this.host.call('session.event', head.params));
+            }
+            catch (error) {
+                if (this.host.stopSignal.aborted)
+                    return;
+                // A permanent rejection cannot be fixed by resending; surface it instead of blocking the session.
+                this.host.log('error', `session.event ${head.params.event_id} rejected`, error);
+            }
+            this.outbox.shift();
+            if (this.outbox.length === 0)
+                this.drained.resolve();
+        }
+    }
+    /** Retries call across disconnects; only transport failures, executor_busy and retryable errors are retried. */
+    async callUntilConnected(call, signal) {
+        for (;;) {
+            const registered = this.host.nextRegistration();
+            try {
+                return await call();
+            }
+            catch (error) {
+                if (error instanceof RpcError && error.data?.retryable !== true && error.code !== JsonRpcErrorCode.ExecutorBusy)
+                    throw error;
+                if (error instanceof ClientStoppedError || this.host.stopSignal.aborted)
+                    throw error;
+            }
+            const waits = [registered];
+            if (this.host.connected())
+                waits.push(new Promise((resolve) => setTimeout(resolve, RESEND_DELAY_MS)));
+            const stop = signal ?? this.host.stopSignal;
+            waits.push(new Promise((_resolve, reject) => {
+                if (stop.aborted)
+                    reject(stop.reason);
+                stop.addEventListener('abort', () => reject(stop.reason), { once: true });
+            }));
+            if (signal) {
+                const stopped = this.host.stopSignal;
+                waits.push(new Promise((_resolve, reject) => stopped.addEventListener('abort', () => reject(stopped.reason), { once: true })));
+            }
+            await Promise.race(waits);
+        }
+    }
+    async withdraw(interactionId, reason) {
+        this.answered.add(interactionId);
+        const params = { session_id: this.id, interaction_id: interactionId, reason };
+        try {
+            await this.callUntilConnected(() => this.host.call('interaction.cancel', params), AbortSignal.timeout(CLOSE_FLUSH_WAIT_MS));
+        }
+        catch (error) {
+            this.host.log('warn', `interaction.cancel for ${interactionId} failed`, error);
+        }
+    }
+}
+/** @internal Routes agent methods for one ExecutorClient. */
+export class AgentRuntime {
+    host;
+    handler;
+    capability;
+    sessions = new Map();
+    constructor(host, handler, capability) {
+        this.host = host;
+        this.handler = handler;
+        this.capability = capability;
+    }
+    /** Handles an agent method; undefined for every other method. */
+    dispatch(method, params) {
+        switch (method) {
+            case 'turn.start':
+                return this.turnStart(params);
+            case 'turn.input':
+                return this.turnInput(params);
+            case 'turn.cancel':
+                return Promise.resolve(this.turnCancel(params));
+            case 'session.close':
+                return this.sessionClose(params);
+            case 'interaction.response':
+                return Promise.resolve(this.interactionResponse(params));
+            default:
+                return undefined;
+        }
+    }
+    session(id, create) {
+        const existing = this.sessions.get(id);
+        if (existing || !create)
+            return existing;
+        const max = this.capability.max_sessions ?? 0;
+        if (max > 0 && this.sessions.size >= max)
+            throw new RpcError(JsonRpcErrorCode.ExecutorBusy, 'executor_busy');
+        const session = new AgentSession(this.host, id);
+        this.sessions.set(id, session);
+        this.host.addSession(id);
+        return session;
+    }
+    async turnStart(params) {
+        if (!params?.session_id || !params.turn_id || !params.input?.length) {
+            throw new RpcError(JsonRpcErrorCode.InvalidParams, 'session_id, turn_id and input are required');
+        }
+        const session = this.session(params.session_id, true);
+        const recorded = session.results.get(params.turn_id);
+        if (recorded)
+            return recorded;
+        if (session.turn)
+            throw new RpcError(JsonRpcErrorCode.Conflict, 'a turn is already running; use turn.input');
+        const turn = new AgentTurn(session, params);
+        session.turn = turn; // reserve the session before openTurn
+        let result;
+        try {
+            result = await this.handler.openTurn(params);
+            if (!result.accepted)
+                throw new RpcError(JsonRpcErrorCode.ExecutorBusy, 'turn not accepted');
+        }
+        catch (error) {
+            session.turn = undefined;
+            throw error;
+        }
+        result = { ...result, turn_id: params.turn_id };
+        session.results.set(params.turn_id, result);
+        setImmediate(() => void this.runTurn(session, turn));
+        return result;
+    }
+    async runTurn(session, turn) {
+        const turnId = turn.params.turn_id;
+        const onStop = () => turn.abort.abort(new ClientStoppedError());
+        this.host.stopSignal.addEventListener('abort', onStop, { once: true });
+        const deadline = turn.params.deadline_ms && turn.params.deadline_ms > 0
+            ? setTimeout(() => turn.abort.abort(new DeadlineExceeded()), turn.params.deadline_ms)
+            : undefined;
+        try {
+            session.enqueue(turnId, session.newEventId(), { type: 'session.status_running' });
+            let failure;
+            try {
+                await this.handler.runTurn(turn, turn.abort.signal);
+            }
+            catch (error) {
+                failure = error;
+            }
+            turn.finish();
+            let outcome = 'completed';
+            if (turn.abort.signal.reason instanceof DeadlineExceeded) {
+                outcome = 'failed';
+                session.enqueue(turnId, session.newEventId(), {
+                    type: 'session.error',
+                    error: { type: 'timeout', message: 'turn deadline_ms exceeded' },
+                });
+            }
+            else if (turn.abort.signal.aborted) {
+                outcome = 'canceled';
+            }
+            else if (failure !== undefined) {
+                outcome = 'failed';
+                session.enqueue(turnId, session.newEventId(), {
+                    type: 'session.error',
+                    error: { type: 'agent_error', message: failure instanceof Error ? failure.message : String(failure) },
+                });
+            }
+            session.enqueue(turnId, session.newEventId(), {
+                type: 'session.status_idle',
+                stop_reason: { type: 'end_turn' },
+                turn_outcome: outcome,
+            });
+        }
+        catch (error) {
+            this.host.log('warn', `turn ${turnId} ended after session.close`, error);
+        }
+        finally {
+            clearTimeout(deadline);
+            this.host.stopSignal.removeEventListener('abort', onStop);
+            if (session.turn === turn)
+                session.turn = undefined;
+            turn.done.resolve();
+        }
+    }
+    async turnInput(params) {
+        const session = this.session(params.session_id, false);
+        if (!session)
+            throw new RpcError(JsonRpcErrorCode.SessionNotActive, 'session_not_active');
+        const turn = session.turn;
+        if (!turn || turn.params.turn_id !== params.turn_id || turn.ended) {
+            throw new RpcError(JsonRpcErrorCode.Conflict, 'turn is not running; start a new turn');
+        }
+        if (turn.seen.has(params.input_id))
+            return { accepted: true };
+        turn.seen.add(params.input_id);
+        turn.pushInput(params);
+        return { accepted: true };
+    }
+    turnCancel(params) {
+        const turn = this.session(params.session_id, false)?.turn;
+        if (!turn || turn.params.turn_id !== params.turn_id || turn.ended)
+            return { canceled: false };
+        turn.abort.abort(new Error('turn.cancel'));
+        return { canceled: true };
+    }
+    async sessionClose(params) {
+        const session = this.session(params.session_id, false);
+        if (!session)
+            return { closed: false };
+        const turn = session.turn;
+        if (turn) {
+            turn.abort.abort(new Error('session.close'));
+            await turn.done.promise;
+        }
+        try {
+            await session.flush(AbortSignal.timeout(CLOSE_FLUSH_WAIT_MS));
+        }
+        catch (error) {
+            this.host.log('warn', `session.close: events of ${session.id} still unacknowledged`, error);
+        }
+        await this.handler.closeSession(session.id, params.reason);
+        session.closed = true;
+        session.signal();
+        this.sessions.delete(session.id);
+        this.host.removeSession(session.id);
+        void session
+            .callUntilConnected(() => this.host.sessionEnded({ session_id: session.id, reason: params.reason }), AbortSignal.timeout(CLOSE_FLUSH_WAIT_MS))
+            .catch((error) => this.host.log('warn', `session.ended for ${session.id} failed`, error));
+        return { closed: true };
+    }
+    interactionResponse(params) {
+        const session = this.session(params.session_id, false);
+        if (!session)
+            return { accepted: false };
+        const waiter = session.pending.get(params.interaction_id);
+        if (!waiter || session.answered.has(params.interaction_id))
+            return { accepted: false };
+        session.answered.add(params.interaction_id);
+        waiter.resolve(params);
+        return { accepted: true };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,oEAAoE;AACpE,yEAAyE;AACzE,kDAAkD;AAElD,OAAO,EACL,gBAAgB,GAwBjB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAA;AAG5G,MAAM,eAAe,GAAG,GAAG,CAAA;AAC3B,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAqClC,MAAM,gBAAiB,SAAQ,KAAK;IAClC;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACpC,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,UAAU;IACG,KAAK,GAAQ,EAAE,CAAA;IACxB,MAAM,CAA8B;IACpC,KAAK,GAAG,KAAK,CAAA;IAErB,IAAI,CAAC,IAAO;QACV,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;YACvB,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9C,CAAC;;YAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,GAAG;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;IACzB,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAC/B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5E,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAqB,CAAA;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAA;IACpC,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,OAAO,SAAS;IAQD;IACR;IARX,KAAK,GAAG,KAAK,CAAA;IACJ,KAAK,GAAG,IAAI,eAAe,EAAE,CAAA;IAC7B,IAAI,GAAG,QAAQ,EAAE,CAAA;IACjB,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAChB,KAAK,GAAG,IAAI,UAAU,EAAmB,CAAA;IAE1D,YACmB,OAAqB,EAC7B,MAAuB;QADf,YAAO,GAAP,OAAO,CAAc;QAC7B,WAAM,GAAN,MAAM,CAAiB;QAEhC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA;IACxB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED,8EAA8E;IAC9E,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,gBAAgB;IAChB,SAAS,CAAC,KAAsB;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,6EAA6E;IAC7E,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAiB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAA;IAClD,CAAC;IAED,UAAU,CAAC,OAAe,EAAE,KAAiB;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QACrD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,OAAe,EAAE,SAAyB,EAAE,KAAa,EAAE,IAAY;QAC3E,MAAM,MAAM,GAA4B;YACtC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC3B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,QAAQ,EAAE,OAAO;YACjB,UAAU,EAAE,SAAS;YACrB,KAAK;YACL,IAAI;SACL,CAAA;QACD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,6BAA6B,EAAE,KAAK,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,MAAoB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAkH,EAClH,MAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,MAAM,MAAM,GAA6B;YACvC,GAAG,OAAO;YACV,UAAU,EAAE,OAAO,CAAC,EAAE;YACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAC9E,CAAA;QACD,MAAM,MAAM,GAAG,QAAQ,EAA6B,CAAA;QACpD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACxB,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAA2B,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;YAC1H,MAAM,KAAK,GAA8C,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACzE,IAAI,KAAgD,CAAA;YACpD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;gBACxC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;gBAChF,KAAK,CAAC,IAAI,CACR,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBACtB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;wBACtB,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;wBACvD,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAA;oBAChG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;gBACrB,CAAC,CAAC,CACH,CAAA;YACH,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,CACR,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;oBAC/B,MAAM,OAAO,GAAG,GAAG,EAAE;wBACnB,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;wBAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;oBACvB,CAAC,CAAA;oBACD,IAAI,MAAM,CAAC,OAAO;wBAAE,OAAO,EAAE,CAAA;;wBACxB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBAChE,CAAC,CAAC,CACH,CAAA;YACH,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAClC,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,mGAAmG;IACnG,iBAAiB,CAAC,aAAqB,EAAE,MAA+B;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IACrD,CAAC;CACF;AAMD,wGAAwG;AACxG,MAAM,YAAY;IAaL;IACA;IAbH,YAAY,GAAG,CAAC,CAAA;IAChB,MAAM,GAAG,CAAC,CAAA;IACD,MAAM,GAAkB,EAAE,CAAA;IACnC,IAAI,GAAG,QAAQ,EAAE,CAAA;IACjB,OAAO,GAAG,QAAQ,EAAE,CAAA;IAC5B,MAAM,GAAG,KAAK,CAAA;IACd,IAAI,CAAY;IACP,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;IAC5C,OAAO,GAAG,IAAI,GAAG,EAA+C,CAAA;IAChE,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAErC,YACW,IAAe,EACf,EAAU;QADV,SAAI,GAAJ,IAAI,CAAW;QACf,OAAE,GAAF,EAAE,CAAQ;QAEnB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QACtB,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;IACtB,CAAC;IAED,UAAU;QACR,OAAO,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAe,EAAE,KAAiB;QACxD,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,uBAAuB,EAAE,CAAA;QACpD,MAAM,MAAM,GAAuB;YACjC,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE;YAC7B,KAAK,EAAE,KAAgC;SACxC,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAA;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC9B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAA;QACxC,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,OAAO;YACpB,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACtC,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBACzC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC/E,CAAC,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,QAAQ;QACpB,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;oBAAE,OAAM;gBACvD,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAA;gBACtB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAA;gBACvB,SAAQ;YACV,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAqB,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;YACvG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;oBAAE,OAAM;gBACxC,kGAAkG;gBAClG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,IAAI,CAAC,MAAM,CAAC,QAAQ,WAAW,EAAE,KAAK,CAAC,CAAA;YACjF,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;YACnB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QACtD,CAAC;IACH,CAAC;IAED,gHAAgH;IAChH,KAAK,CAAC,kBAAkB,CAAI,IAAsB,EAAE,MAAoB;QACtE,SAAS,CAAC;YACR,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAA;YAC/C,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,EAAE,CAAA;YACrB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,YAAY;oBAAE,MAAM,KAAK,CAAA;gBAC5H,IAAI,KAAK,YAAY,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;oBAAE,MAAM,KAAK,CAAA;YACtF,CAAC;YACD,MAAM,KAAK,GAA4B,CAAC,UAAU,CAAC,CAAA;YACnD,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;YACrG,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAA;YAC3C,KAAK,CAAC,IAAI,CACR,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAC/B,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACrC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3E,CAAC,CAAC,CACH,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAA;gBACpC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;YAChI,CAAC;YACD,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,aAAqB,EAAE,MAA+B;QACnE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAChC,MAAM,MAAM,GAA4B,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,CAAA;QACtG,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,kBAAkB,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAM,oBAAoB,EAAE,MAAM,CAAC,EACvD,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CACzC,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,aAAa,SAAS,EAAE,KAAK,CAAC,CAAA;QAChF,CAAC;IACH,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,YAAY;IAIJ;IACA;IACR;IALM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE3D,YACmB,IAAe,EACf,OAAqB,EAC7B,UAA2B;QAFnB,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAAc;QAC7B,eAAU,GAAV,UAAU,CAAiB;IACnC,CAAC;IAEJ,iEAAiE;IACjE,QAAQ,CAAC,MAAc,EAAE,MAAe;QACtC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAyB,CAAC,CAAA;YAClD,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAyB,CAAC,CAAA;YAClD,KAAK,aAAa;gBAChB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAA0B,CAAC,CAAC,CAAA;YACrE,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,YAAY,CAAC,MAA4B,CAAC,CAAA;YACxD,KAAK,sBAAsB;gBACzB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAmC,CAAC,CAAC,CAAA;YACvF;gBACE,OAAO,SAAS,CAAA;QACpB,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,EAAU,EAAE,MAAe;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACtC,IAAI,QAAQ,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAA;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,CAAC,CAAA;QAC7C,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG;YAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAA;QAC5G,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACxB,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,MAAuB;QAC7C,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACpE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,4CAA4C,CAAC,CAAA;QAClG,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAE,CAAA;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACpD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAC7B,IAAI,OAAO,CAAC,IAAI;YAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,2CAA2C,CAAC,CAAA;QAC5G,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA,CAAC,sCAAsC;QAC1D,IAAI,MAAuB,CAAA;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAA;QAC9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,GAAG,SAAS,CAAA;YACxB,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;QAC/C,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3C,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;QACpD,OAAO,MAAM,CAAA;IACf,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAqB,EAAE,IAAe;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;QAClC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAA;QAC/D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACtE,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC;YACpD,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YACrF,CAAC,CAAC,SAAS,CAAA;QACf,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAA;YACjF,IAAI,OAAgB,CAAA;YACpB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,KAAK,CAAA;YACjB,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAA;YACb,IAAI,OAAO,GAAwC,WAAW,CAAA;YAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,YAAY,gBAAgB,EAAE,CAAC;gBACzD,OAAO,GAAG,QAAQ,CAAA;gBAClB,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE;oBAC5C,IAAI,EAAE,eAAe;oBACrB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE;iBACjE,CAAC,CAAA;YACJ,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,GAAG,UAAU,CAAA;YACtB,CAAC;iBAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,GAAG,QAAQ,CAAA;gBAClB,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE;oBAC5C,IAAI,EAAE,eAAe;oBACrB,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;iBACtG,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE;gBAC5C,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;gBACjC,YAAY,EAAE,OAAO;aACtB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,4BAA4B,EAAE,KAAK,CAAC,CAAA;QAC1E,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,QAAQ,CAAC,CAAA;YACtB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACzD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,GAAG,SAAS,CAAA;YACnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,MAAuB;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAA;QACzF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAA;QACxF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC7D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACtB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC3B,CAAC;IAEO,UAAU,CAAC,MAAwB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,IAAI,CAAA;QACzD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QAC7F,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAA;QAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC3B,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAA0B;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACzB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;YAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAA;QACzB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAA;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,OAAO,CAAC,EAAE,uBAAuB,EAAE,KAAK,CAAC,CAAA;QAC7F,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC1D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAA;QACrB,OAAO,CAAC,MAAM,EAAE,CAAA;QAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACnC,KAAK,OAAO;aACT,kBAAkB,CACjB,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAC/E,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CACzC;aACA,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;QAC3F,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAEO,mBAAmB,CAAC,MAAiC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QACzD,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QACtF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC3B,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,170 @@
+import { ChannelScope, ConnectionState, type Ack, type Capabilities, type ExecutorDrainParams, type ExecutorDrainResult, type ExecutorInfo, type ExecutorLoad, type ExecutorRegisterResult, type ExecutorTokenResponse, type SessionAssignParams, type SessionAssignResult, type SessionEndedParams, type SessionEventParams, type SessionEventResult, type SessionReadyParams, type SessionStatusParams, type SessionStopParams, type SessionStopResult, type ToolCallParams, type ToolProgressParams, type ToolResultParams, type AgentCapability } from './generated/executor.js';
+import { type AgentHandler } from './agent.js';
+import { type Logger } from './rpc.js';
+import { FrameChannel, type Conn } from './transport.js';
+export declare const DEFAULT_BASE_URL = "https://api.bma.beeos.ai";
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+export declare const DEFAULT_RECONNECT_BASE_DELAY_MS = 500;
+export declare const DEFAULT_TOOL_RESULT_RETRY_ATTEMPTS = 5;
+export declare const DEFAULT_TOOL_RESULT_RETRY_BASE_DELAY_MS = 250;
+/** Close codes after which the executor must not reconnect (1008 policy, 4002 revoked, 4003 protocol, 4004 replaced, 4005 drained). */
+export declare function isTerminalCloseCode(code: number): boolean;
+/** Which channel to open: the control channel, or one MCP channel of a session. */
+export interface ChannelTarget {
+    channel: ChannelScope;
+    sessionId?: string;
+    serverKey?: string;
+}
+/** Opens a channel. Called again for every reconnect and every MCP channel. */
+export type Dialer = (target: ChannelTarget) => Promise<Conn>;
+export type TokenSource = () => Promise<Pick<ExecutorTokenResponse, 'token' | 'ws_url'> & Partial<ExecutorTokenResponse>>;
+/** A TokenSource for a harness reached directly: ws://127.0.0.1, unix:///path.sock or npipe:////./pipe/<name>. */
+export declare function staticToken(wsUrl: string, token?: string): TokenSource;
+export interface WebSocketDialerOptions {
+    environmentId: string;
+    executor: ExecutorInfo;
+    /** POST {baseUrl}/v1/executors/token with environmentKey, unless tokenSource is set. */
+    baseUrl?: string;
+    environmentKey?: string;
+    tokenSource?: TokenSource;
+    /** Overrides the ws_url of the token response. */
+    wsUrl?: string;
+    protocols?: string[];
+    fetch?: typeof fetch;
+}
+export declare function channelUrl(rawUrl: string, target: ChannelTarget): string;
+/** The cloud dialer: token bootstrap, then an outbound WebSocket with the bearer token. */
+export declare function webSocketDialer(options: WebSocketDialerOptions): Dialer;
+/** What a tool handler returns; the client fills in session_id and tool_call_id. */
+export type ToolResult = Omit<ToolResultParams, 'session_id' | 'tool_call_id'>;
+export interface ToolContext {
+    /** Aborted by tool.cancel, deadline_ms, or stop(). */
+    signal: AbortSignal;
+    /** Sends tool.progress for this call (best-effort). */
+    progress(message: string): void;
+}
+export type ToolCallHandler = (call: ToolCallParams, context: ToolContext) => Promise<ToolResult>;
+export type SessionAssignHandler = (params: SessionAssignParams) => Promise<SessionAssignResult>;
+export type SessionStopHandler = (params: SessionStopParams) => Promise<SessionStopResult>;
+export type DrainHandler = (params: ExecutorDrainParams) => Promise<ExecutorDrainResult>;
+export type RequestHandler = (params: unknown) => unknown;
+export interface ExecutorClientOptions extends Omit<WebSocketDialerOptions, 'environmentKey' | 'tokenSource'> {
+    environmentKey?: string;
+    tokenSource?: TokenSource;
+    capabilities?: Capabilities;
+    /** Replaces the WebSocket dialer, for example listenExecutor().dialer or Harness.inProcessDialer. */
+    dialer?: Dialer;
+    /** false for a connection that cannot be redialed (an accepted local connection). */
+    reconnect?: boolean;
+    requestTimeoutMs?: number;
+    /** Overrides the interval returned by executor.register. */
+    heartbeatIntervalMs?: number;
+    heartbeatLoad?: () => ExecutorLoad | undefined;
+    maxReconnectAttempts?: number;
+    reconnectBaseDelayMs?: number;
+    random?: () => number;
+    /** Total tool.result attempts including the first; 1 disables retries. */
+    toolResultRetryAttempts?: number;
+    toolResultRetryBaseDelayMs?: number;
+    /**
+     * Called when a tool result was not accepted after all retries or the error
+     * is not retryable. Persist it and replay it with the same tool_call_id.
+     */
+    onToolResultLost?: (result: ToolResultParams, error: unknown) => void;
+    onLog?: Logger;
+}
+/** An executor client. One client is one logical executor connection to one harness. */
+export declare class ExecutorClient {
+    private readonly options;
+    private readonly dialer;
+    private peer?;
+    private currentState;
+    private stopped;
+    private readonly stopController;
+    private registerResult?;
+    private currentConnectionId;
+    private currentExecutorId;
+    private heartbeatIntervalMs;
+    private heartbeatTimer?;
+    private reconnectAttempts;
+    private readonly sessions;
+    private readonly completedToolResults;
+    private readonly seenToolCalls;
+    private readonly running;
+    private readonly tools;
+    private toolCallHandler?;
+    private sessionAssignHandler?;
+    private sessionStopHandler?;
+    private drainHandler?;
+    private readonly requestHandlers;
+    private readonly notificationHandlers;
+    private registration;
+    private agent?;
+    constructor(options: ExecutorClientOptions);
+    get state(): ConnectionState;
+    get executorId(): string;
+    get connectionId(): string;
+    /** The negotiated protocol of the current connection. */
+    get protocol(): string | undefined;
+    get activeSessions(): string[];
+    /** Registers the handler for every tool without a handleTool handler. */
+    onToolCall(handler: ToolCallHandler): void;
+    /** Registers the handler for one tool name (bash, read, ..., or a custom name). */
+    handleTool(name: string, handler: ToolCallHandler): void;
+    onSessionAssign(handler: SessionAssignHandler): void;
+    onSessionStop(handler: SessionStopHandler): void;
+    onDrain(handler: DrainHandler): void;
+    /** Registers a handler for another harness-to-executor request (process.*, terminal.*, skill.install). */
+    onRequest(method: string, handler: RequestHandler): void;
+    onNotification(method: string, handler: (params: unknown) => void): void;
+    /** Advertises the agent capability and serves turn.*, session.close and interaction.response. Call before start. */
+    serveAgent(handler: AgentHandler, capability?: Omit<AgentCapability, 'enabled'>): void;
+    /** Dials, registers and starts heartbeats. */
+    start(): Promise<ExecutorRegisterResult>;
+    /** Sends executor.close, closes the channel and stops reconnecting. */
+    stop(reason?: string): void;
+    /** Sends a request on the control channel. */
+    call<T = unknown>(method: string, params: unknown): Promise<T>;
+    /** Sends a notification on the control channel. */
+    notify(method: string, params: unknown): void;
+    /** Reports that the session is prepared; call after workspace and MCP setup. */
+    sessionReady(params: SessionReadyParams): Promise<Ack>;
+    /** Reports that every process and MCP server of the session stopped. */
+    sessionEnded(params: SessionEndedParams): Promise<Ack>;
+    /** session.event for a tool executor (v1 shape, without agent fields). */
+    sessionEvent(params: SessionEventParams): Promise<SessionEventResult>;
+    sessionStatus(params: SessionStatusParams): void;
+    toolProgress(params: ToolProgressParams): void;
+    /** Replaces the advertised capabilities; they are also sent on every re-register. */
+    updateCapabilities(capabilities: Capabilities): void;
+    /**
+     * Sends tool.result once per tool_call_id, retrying retryable failures with
+     * exponential backoff. A repeat for an accepted id resolves without a frame.
+     */
+    reportToolResult(params: ToolResultParams): Promise<Ack>;
+    /** Opens the raw MCP channel for one session.assign mcp_servers entry. */
+    openMcpChannel(sessionId: string, serverKey: string): Promise<FrameChannel>;
+    private registeredCapabilities;
+    private resumeState;
+    private connect;
+    private disconnected;
+    private scheduleReconnect;
+    private reconnect;
+    private scheduleHeartbeat;
+    private heartbeat;
+    private dispatchRequest;
+    private dispatchNotification;
+    private assignSession;
+    private stopSession;
+    private drain;
+    /** Accepts a tool.call at most once per tool_call_id; a resent call is acknowledged and ignored. */
+    private acceptToolCall;
+    private cancelToolCall;
+    private runToolCall;
+    private toolResultRetryDelay;
+    private random;
+    private log;
+    private agentHost;
+}
+export declare function retryableToolResultError(error: unknown): boolean;