@openma/common 0.0.0-stage → 0.9.0

package/dist/managed-runtime/acp-subagents.js.map

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

package/dist/managed-runtime/claimed-environment-work.d.ts

@@ -0,0 +1,61 @@
+export interface ClaimedEnvironmentWorkHeartbeat {
+    last_heartbeat: string;
+    lease_extended: boolean;
+    state: string;
+    ttl_seconds: number;
+}
+export interface ClaimedEnvironmentWorkLifecycleClient {
+    ack(workId: string, params: {
+        environment_id: string;
+    }, options?: {
+        signal?: AbortSignal;
+    }): PromiseLike<unknown>;
+    heartbeat(workId: string, params: {
+        environment_id: string;
+        desired_ttl_seconds?: number;
+        expected_last_heartbeat?: string;
+    }, options?: {
+        signal?: AbortSignal;
+    }): PromiseLike<ClaimedEnvironmentWorkHeartbeat>;
+    stop(workId: string, params: {
+        environment_id: string;
+        force?: boolean;
+    }, options?: {
+        signal?: AbortSignal;
+    }): PromiseLike<unknown>;
+}
+export interface ClaimedEnvironmentWorkScheduler {
+    sleep(milliseconds: number, signal: AbortSignal): Promise<void>;
+}
+export interface ClaimedEnvironmentWorkRunnerOptions {
+    client: ClaimedEnvironmentWorkLifecycleClient;
+    heartbeatIntervalMs?: number;
+    heartbeatTtlSeconds?: number;
+    scheduler?: ClaimedEnvironmentWorkScheduler;
+    now?: () => number;
+    onError?(error: unknown): void | Promise<void>;
+}
+export interface ClaimedEnvironmentWorkRunInput<T> {
+    environmentId: string;
+    sessionId: string;
+    workId: string;
+    signal?: AbortSignal;
+    execute(signal: AbortSignal): Promise<T>;
+}
+export interface ClaimedEnvironmentWorkRunner {
+    run<T>(input: ClaimedEnvironmentWorkRunInput<T>): Promise<T>;
+}
+export declare class ClaimedEnvironmentWorkLeaseLostError extends Error {
+    readonly name = "ClaimedEnvironmentWorkLeaseLostError";
+}
+/**
+ * Own one already-reserved Managed Agents Work item from inside its sandbox.
+ *
+ * The dispatcher deliberately leaves the item unacknowledged. This runner is
+ * therefore the single owner of ACK, the optimistic-concurrency heartbeat,
+ * execution cancellation, and terminal stop. A 412 fences the local process
+ * immediately and suppresses stop because the Work may already belong to a
+ * replacement.
+ */
+export declare function createClaimedEnvironmentWorkRunner(options: ClaimedEnvironmentWorkRunnerOptions): ClaimedEnvironmentWorkRunner;
+//# sourceMappingURL=claimed-environment-work.d.ts.map

package/dist/managed-runtime/claimed-environment-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimed-environment-work.d.ts","sourceRoot":"","sources":["../../src/managed-runtime/claimed-environment-work.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IACpD,GAAG,CACD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,EAClC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxB,SAAS,CACP,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,EACD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,WAAW,CAAC,+BAA+B,CAAC,CAAC;IAChD,IAAI,CACF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EACnD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,WAAW,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,qCAAqC,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,IAAI,0CAA0C;CACxD;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,mCAAmC,GAC3C,4BAA4B,CA0I9B"}

package/dist/managed-runtime/claimed-environment-work.js

@@ -0,0 +1,170 @@
+export class ClaimedEnvironmentWorkLeaseLostError extends Error {
+    name = "ClaimedEnvironmentWorkLeaseLostError";
+}
+const defaultScheduler = {
+    sleep(milliseconds, signal) {
+        signal.throwIfAborted();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                signal.removeEventListener("abort", onAbort);
+                resolve();
+            }, milliseconds);
+            const onAbort = () => {
+                clearTimeout(timeout);
+                reject(signal.reason);
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        });
+    },
+};
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive integer`);
+    }
+    return value;
+}
+function nonEmpty(value, name) {
+    if (value.trim() === "")
+        throw new TypeError(`${name} must not be empty`);
+    return value;
+}
+function statusOf(error) {
+    if (typeof error !== "object" || error === null || !("status" in error))
+        return undefined;
+    return typeof error.status === "number" ? error.status : undefined;
+}
+function isAbort(error, signal) {
+    return signal.aborted || (error instanceof DOMException && error.name === "AbortError");
+}
+/**
+ * Own one already-reserved Managed Agents Work item from inside its sandbox.
+ *
+ * The dispatcher deliberately leaves the item unacknowledged. This runner is
+ * therefore the single owner of ACK, the optimistic-concurrency heartbeat,
+ * execution cancellation, and terminal stop. A 412 fences the local process
+ * immediately and suppresses stop because the Work may already belong to a
+ * replacement.
+ */
+export function createClaimedEnvironmentWorkRunner(options) {
+    if (typeof options?.client?.ack !== "function"
+        || typeof options.client.heartbeat !== "function"
+        || typeof options.client.stop !== "function") {
+        throw new TypeError("Claimed Work runner requires a lifecycle client");
+    }
+    const heartbeatIntervalMs = positiveInteger(options.heartbeatIntervalMs ?? 30_000, "heartbeatIntervalMs");
+    const heartbeatTtlSeconds = positiveInteger(options.heartbeatTtlSeconds ?? 90, "heartbeatTtlSeconds");
+    const scheduler = options.scheduler ?? defaultScheduler;
+    const now = options.now ?? Date.now;
+    return {
+        async run(input) {
+            const environmentId = nonEmpty(input.environmentId, "environmentId");
+            nonEmpty(input.sessionId, "sessionId");
+            const workId = nonEmpty(input.workId, "workId");
+            input.signal?.throwIfAborted();
+            const execution = new AbortController();
+            const heartbeat = new AbortController();
+            const onExternalAbort = () => {
+                execution.abort(input.signal?.reason);
+                heartbeat.abort(input.signal?.reason);
+            };
+            input.signal?.addEventListener("abort", onExternalAbort, { once: true });
+            let ownership = "unacknowledged";
+            let lastHeartbeat = "NO_HEARTBEAT";
+            let lastSuccessAt = now();
+            let ttlMs = heartbeatTtlSeconds * 1_000;
+            let leaseFailure = null;
+            const loseLease = (message, cause) => {
+                if (ownership === "lost")
+                    return;
+                ownership = "lost";
+                leaseFailure = new ClaimedEnvironmentWorkLeaseLostError(message, { cause });
+                execution.abort(leaseFailure);
+                heartbeat.abort(leaseFailure);
+            };
+            const beat = async (initial) => {
+                try {
+                    const response = await options.client.heartbeat(workId, {
+                        environment_id: environmentId,
+                        desired_ttl_seconds: heartbeatTtlSeconds,
+                        expected_last_heartbeat: lastHeartbeat,
+                    }, { signal: heartbeat.signal });
+                    if (!Number.isFinite(response.ttl_seconds) || response.ttl_seconds <= 0) {
+                        loseLease("Managed Environment Work heartbeat returned an invalid lease TTL");
+                        return;
+                    }
+                    lastHeartbeat = response.last_heartbeat;
+                    lastSuccessAt = now();
+                    ttlMs = response.ttl_seconds * 1_000;
+                    ownership = "held";
+                    if (!response.lease_extended
+                        || response.state === "stopping"
+                        || response.state === "stopped") {
+                        execution.abort(new Error(`Managed Environment Work entered ${response.state}`));
+                        heartbeat.abort(execution.signal.reason);
+                    }
+                }
+                catch (error) {
+                    if (statusOf(error) === 412) {
+                        loseLease("Managed Environment Work lease was lost", error);
+                        return;
+                    }
+                    if (isAbort(error, heartbeat.signal))
+                        return;
+                    if (initial || now() - lastSuccessAt >= ttlMs) {
+                        loseLease("Managed Environment Work lease could not be established or renewed", error);
+                        return;
+                    }
+                    await options.onError?.(error);
+                }
+            };
+            let monitor = null;
+            try {
+                await options.client.ack(workId, { environment_id: environmentId }, { signal: execution.signal });
+                await beat(true);
+                if (leaseFailure !== null)
+                    throw leaseFailure;
+                execution.signal.throwIfAborted();
+                monitor = (async () => {
+                    while (!heartbeat.signal.aborted) {
+                        try {
+                            await scheduler.sleep(heartbeatIntervalMs, heartbeat.signal);
+                        }
+                        catch (error) {
+                            if (heartbeat.signal.aborted)
+                                return;
+                            throw error;
+                        }
+                        if (heartbeat.signal.aborted)
+                            return;
+                        await beat(false);
+                    }
+                })();
+                void monitor.catch((error) => {
+                    loseLease("Managed Environment Work heartbeat loop failed", error);
+                });
+                let result;
+                try {
+                    result = await input.execute(execution.signal);
+                }
+                catch (error) {
+                    if (leaseFailure !== null)
+                        throw leaseFailure;
+                    throw error;
+                }
+                if (leaseFailure !== null)
+                    throw leaseFailure;
+                execution.signal.throwIfAborted();
+                return result;
+            }
+            finally {
+                heartbeat.abort(new Error("Managed Environment Work execution finished"));
+                await monitor?.catch(() => undefined);
+                input.signal?.removeEventListener("abort", onExternalAbort);
+                if (ownership === "held") {
+                    await Promise.resolve(options.client.stop(workId, { environment_id: environmentId, force: true }, { signal: new AbortController().signal })).catch(options.onError);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=claimed-environment-work.js.map

package/dist/managed-runtime/claimed-environment-work.js.map

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

package/dist/managed-runtime/contracts.d.ts

@@ -0,0 +1,31 @@
+/** Stable identity of one Managed Agents work item and its Session. */
+export interface RuntimeResourceScope {
+    workspaceId: string;
+    environmentId: string;
+    sessionId: string;
+    workId: string;
+}
+export interface HarnessSupervisorRun {
+    completed: Promise<{
+        exitCode: number;
+    }>;
+    drain(): Promise<void>;
+    stop(reason: "aborted" | "failed"): Promise<void>;
+}
+export interface HarnessSupervisorHarness {
+    start(input: {
+        scope: RuntimeResourceScope;
+        harness: {
+            id: string;
+            version: string;
+        };
+        workspacePath: "/workspace";
+        outputPath: "/mnt/session/outputs" | null;
+        checkpoint(input: {
+            sessionId: string;
+            turnId?: string;
+        }): Promise<void>;
+        signal: AbortSignal;
+    }): Promise<HarnessSupervisorRun>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/managed-runtime/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/managed-runtime/contracts.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,KAAK,EAAE;QACX,KAAK,EAAE,oBAAoB,CAAC;QAC5B,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,aAAa,EAAE,YAAY,CAAC;QAC5B,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;QAC1C,UAAU,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,EAAE,WAAW,CAAC;KACrB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnC"}

package/dist/managed-runtime/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/managed-runtime/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/managed-runtime/contracts.ts"],"names":[],"mappings":""}

package/dist/managed-runtime/http-control.d.ts

@@ -0,0 +1,67 @@
+import type { RuntimeResourceScope } from "./contracts.js";
+import type { ManagedHarnessControlChannel } from "./index.js";
+import type { ManagedHarnessRecoveryHistoryPort } from "./semantic-recovery.js";
+export interface ManagedHarnessHttpScheduler {
+    sleep(milliseconds: number, signal: AbortSignal): Promise<void>;
+}
+/** The official Session response is intentionally kept in its wire shape.
+ * The control channel validates ownership; the sandbox composition root may
+ * then decode the Agent snapshot it needs before ACP is allowed to start. */
+export type ManagedHarnessWireSession = Readonly<Record<string, unknown>> & {
+    readonly id: string;
+    readonly environment_id: string;
+};
+export interface ManagedHarnessHttpControlOptions {
+    scope: RuntimeResourceScope;
+    harness: {
+        id: string;
+        version: string;
+    };
+    workspacePath: string;
+    apiBaseUrl: string;
+    sessionsToken: string;
+    fetch?: typeof globalThis.fetch;
+    pollIntervalMs?: number;
+    scheduler?: ManagedHarnessHttpScheduler;
+    retry?: {
+        maxAttempts?: number;
+    };
+    eventIds?: {
+        next(): string;
+    };
+    clock?: {
+        now(): Date;
+    };
+    onSessionLoaded?(session: ManagedHarnessWireSession): void | Promise<void>;
+}
+export interface ManagedHarnessHttpRecoveryHistoryOptions {
+    apiBaseUrl: string;
+    sessionsToken: string;
+    fetch?: typeof globalThis.fetch;
+    retry?: {
+        maxAttempts?: number;
+    };
+    scheduler?: ManagedHarnessHttpScheduler;
+    signal?: AbortSignal;
+}
+export interface ManagedHarnessHttpSkillSource {
+    download(input: {
+        skillId: string;
+        version: string;
+    }): Promise<Uint8Array>;
+}
+export declare class ManagedHarnessHttpError extends Error {
+    readonly status: number | null;
+    readonly name = "ManagedHarnessHttpError";
+    constructor(message: string, status: number | null);
+}
+/** Canonical Managed Events are the only semantic fallback when a native ACP
+ * checkpoint is unavailable. The reader is paginated and deliberately drops
+ * lifecycle/telemetry events rather than synthesizing an agent-native log. */
+export declare function createManagedHarnessHttpRecoveryHistory(options: ManagedHarnessHttpRecoveryHistoryOptions): ManagedHarnessRecoveryHistoryPort;
+/** Downloads a concrete Session-attached skill version with the same scoped
+ * Work bearer used by the official Environment Worker. Archive extraction is
+ * intentionally owned by the sandbox runner, not this transport adapter. */
+export declare function createManagedHarnessHttpSkillSource(options: ManagedHarnessHttpRecoveryHistoryOptions): ManagedHarnessHttpSkillSource;
+export declare function createManagedHarnessHttpControlChannel(options: ManagedHarnessHttpControlOptions): ManagedHarnessControlChannel;
+//# sourceMappingURL=http-control.d.ts.map

package/dist/managed-runtime/http-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-control.d.ts","sourceRoot":"","sources":["../../src/managed-runtime/http-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EACV,4BAA4B,EAG7B,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,iCAAiC,EAElC,MAAM,wBAAwB,CAAC;AAMhC,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;6EAE6E;AAC7E,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,QAAQ,CAAC,EAAE;QAAE,IAAI,IAAI,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,IAAI,CAAA;KAAE,CAAC;IACxB,eAAe,CAAC,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,wCAAwC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5E;AAcD,qBAAa,uBAAwB,SAAQ,KAAK;IAK9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAJhC,QAAQ,CAAC,IAAI,6BAA6B;gBAGxC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,GAAG,IAAI;CAIjC;AAwND;;8EAE8E;AAC9E,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,wCAAwC,GAChD,iCAAiC,CAqCnC;AAED;;4EAE4E;AAC5E,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,wCAAwC,GAChD,6BAA6B,CAwB/B;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,gCAAgC,GACxC,4BAA4B,CA+N9B"}