@framers/agentos-ext-meeting-browser 0.0.0-stage → 0.1.1

package/dist/protocol.d.ts

@@ -0,0 +1,294 @@
+import { z } from 'zod';
+/** The platforms the browser bot joins. */
+export declare const PLATFORMS: readonly ["google_meet", "microsoft_teams"];
+/** The job the scheduler sends a container as the channel's first message. */
+export declare const JobMessage: z.ZodObject<{
+    type: z.ZodLiteral<"job">;
+    runId: z.ZodString;
+    platform: z.ZodEnum<{
+        google_meet: "google_meet";
+        microsoft_teams: "microsoft_teams";
+    }>;
+    meetingUrl: z.ZodString;
+    botName: z.ZodString;
+    notice: z.ZodObject<{
+        text: z.ZodString;
+        version: z.ZodString;
+        lateArrivalText: z.ZodString;
+    }, z.core.$strip>;
+    stopPhrase: z.ZodString;
+    limits: z.ZodObject<{
+        waitingRoomMs: z.ZodNumber;
+        aloneMs: z.ZodNumber;
+        totalMs: z.ZodNumber;
+    }, z.core.$strip>;
+    livekit: z.ZodObject<{
+        url: z.ZodString;
+        token: z.ZodString;
+        identity: z.ZodString;
+    }, z.core.$strip>;
+    profileDir: z.ZodOptional<z.ZodString>;
+    adapter: z.ZodOptional<z.ZodLiteral<"fixture">>;
+}, z.core.$strip>;
+/** A job, as {@link JobMessage} parses it. */
+export type JobMessage = z.infer<typeof JobMessage>;
+/** The commands the scheduler relays to a container. */
+export declare const CommandName: z.ZodEnum<{
+    startCapture: "startCapture";
+    suspendCapture: "suspendCapture";
+    postChat: "postChat";
+    leave: "leave";
+    kill: "kill";
+}>;
+/** A command down the channel, with the id its acknowledgement names. */
+export declare const CommandMessage: z.ZodObject<{
+    type: z.ZodLiteral<"command">;
+    id: z.ZodString;
+    name: z.ZodEnum<{
+        startCapture: "startCapture";
+        suspendCapture: "suspendCapture";
+        postChat: "postChat";
+        leave: "leave";
+        kill: "kill";
+    }>;
+    text: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A command, as {@link CommandMessage} parses it. */
+export type CommandMessage = z.infer<typeof CommandMessage>;
+/** A container's answer to one command, by the command's id. */
+export declare const AckMessage: z.ZodObject<{
+    type: z.ZodLiteral<"ack">;
+    id: z.ZodString;
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** An acknowledgement, as {@link AckMessage} parses it. */
+export type AckMessage = z.infer<typeof AckMessage>;
+/** The lifecycle events a container reports: the channel's provider event types. */
+export declare const ReportEvent: z.ZodEnum<{
+    error: "error";
+    joining: "joining";
+    waiting_room: "waiting_room";
+    in_call: "in_call";
+    notice_posted: "notice_posted";
+    monitor_heartbeat: "monitor_heartbeat";
+    participant_joined: "participant_joined";
+    participant_left: "participant_left";
+    chat_message: "chat_message";
+    stop_command: "stop_command";
+    capture_started: "capture_started";
+    capture_suspended: "capture_suspended";
+    left: "left";
+    done: "done";
+    crashed: "crashed";
+    usage: "usage";
+}>;
+/** One report up the channel, numbered by the container's sequence. */
+export declare const ReportMessage: z.ZodObject<{
+    type: z.ZodLiteral<"report">;
+    seq: z.ZodNumber;
+    event: z.ZodEnum<{
+        error: "error";
+        joining: "joining";
+        waiting_room: "waiting_room";
+        in_call: "in_call";
+        notice_posted: "notice_posted";
+        monitor_heartbeat: "monitor_heartbeat";
+        participant_joined: "participant_joined";
+        participant_left: "participant_left";
+        chat_message: "chat_message";
+        stop_command: "stop_command";
+        capture_started: "capture_started";
+        capture_suspended: "capture_suspended";
+        left: "left";
+        done: "done";
+        crashed: "crashed";
+        usage: "usage";
+    }>;
+    at: z.ZodNumber;
+    data: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodString>;
+        sender: z.ZodOptional<z.ZodString>;
+        participantRef: z.ZodOptional<z.ZodString>;
+        participantCount: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** A report, as {@link ReportMessage} parses it. */
+export type ReportMessage = z.infer<typeof ReportMessage>;
+/** What the container sends the scheduler, or the scheduler the container. */
+export declare const ChannelMessage: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"job">;
+    runId: z.ZodString;
+    platform: z.ZodEnum<{
+        google_meet: "google_meet";
+        microsoft_teams: "microsoft_teams";
+    }>;
+    meetingUrl: z.ZodString;
+    botName: z.ZodString;
+    notice: z.ZodObject<{
+        text: z.ZodString;
+        version: z.ZodString;
+        lateArrivalText: z.ZodString;
+    }, z.core.$strip>;
+    stopPhrase: z.ZodString;
+    limits: z.ZodObject<{
+        waitingRoomMs: z.ZodNumber;
+        aloneMs: z.ZodNumber;
+        totalMs: z.ZodNumber;
+    }, z.core.$strip>;
+    livekit: z.ZodObject<{
+        url: z.ZodString;
+        token: z.ZodString;
+        identity: z.ZodString;
+    }, z.core.$strip>;
+    profileDir: z.ZodOptional<z.ZodString>;
+    adapter: z.ZodOptional<z.ZodLiteral<"fixture">>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"command">;
+    id: z.ZodString;
+    name: z.ZodEnum<{
+        startCapture: "startCapture";
+        suspendCapture: "suspendCapture";
+        postChat: "postChat";
+        leave: "leave";
+        kill: "kill";
+    }>;
+    text: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ack">;
+    id: z.ZodString;
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"report">;
+    seq: z.ZodNumber;
+    event: z.ZodEnum<{
+        error: "error";
+        joining: "joining";
+        waiting_room: "waiting_room";
+        in_call: "in_call";
+        notice_posted: "notice_posted";
+        monitor_heartbeat: "monitor_heartbeat";
+        participant_joined: "participant_joined";
+        participant_left: "participant_left";
+        chat_message: "chat_message";
+        stop_command: "stop_command";
+        capture_started: "capture_started";
+        capture_suspended: "capture_suspended";
+        left: "left";
+        done: "done";
+        crashed: "crashed";
+        usage: "usage";
+    }>;
+    at: z.ZodNumber;
+    data: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodString>;
+        sender: z.ZodOptional<z.ZodString>;
+        participantRef: z.ZodOptional<z.ZodString>;
+        participantCount: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+/** A channel message, as {@link ChannelMessage} parses it. */
+export type ChannelMessage = z.infer<typeof ChannelMessage>;
+/** The scheduler's `POST /runs` body, from the provider. */
+export declare const StartRunRequest: z.ZodObject<{
+    runId: z.ZodString;
+    platform: z.ZodEnum<{
+        google_meet: "google_meet";
+        microsoft_teams: "microsoft_teams";
+    }>;
+    meetingUrl: z.ZodString;
+    botName: z.ZodString;
+    notice: z.ZodObject<{
+        text: z.ZodString;
+        version: z.ZodString;
+        lateArrivalText: z.ZodString;
+    }, z.core.$strip>;
+    stopPhrase: z.ZodString;
+    limits: z.ZodObject<{
+        waitingRoomMs: z.ZodNumber;
+        aloneMs: z.ZodNumber;
+        totalMs: z.ZodNumber;
+    }, z.core.$strip>;
+    livekit: z.ZodObject<{
+        url: z.ZodString;
+        token: z.ZodString;
+        identity: z.ZodString;
+    }, z.core.$strip>;
+    workerToken: z.ZodString;
+    reportUrl: z.ZodString;
+}, z.core.$strip>;
+/** A start request, as {@link StartRunRequest} parses it. */
+export type StartRunRequest = z.infer<typeof StartRunRequest>;
+/** What the scheduler posts to `reportUrl`: one report, with the run id, under `Authorization: Bearer <workerToken>`. */
+export declare const ReportPost: z.ZodObject<{
+    type: z.ZodLiteral<"report">;
+    seq: z.ZodNumber;
+    event: z.ZodEnum<{
+        error: "error";
+        joining: "joining";
+        waiting_room: "waiting_room";
+        in_call: "in_call";
+        notice_posted: "notice_posted";
+        monitor_heartbeat: "monitor_heartbeat";
+        participant_joined: "participant_joined";
+        participant_left: "participant_left";
+        chat_message: "chat_message";
+        stop_command: "stop_command";
+        capture_started: "capture_started";
+        capture_suspended: "capture_suspended";
+        left: "left";
+        done: "done";
+        crashed: "crashed";
+        usage: "usage";
+    }>;
+    at: z.ZodNumber;
+    data: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodString>;
+        sender: z.ZodOptional<z.ZodString>;
+        participantRef: z.ZodOptional<z.ZodString>;
+        participantCount: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    runId: z.ZodString;
+    workerId: z.ZodString;
+}, z.core.$strip>;
+/** A forwarded report, as {@link ReportPost} parses it. */
+export type ReportPost = z.infer<typeof ReportPost>;
+/** One run as the scheduler's `GET /runs` lists it, and as `POST /runs` answers. */
+export declare const RunStatus: z.ZodObject<{
+    runId: z.ZodString;
+    state: z.ZodEnum<{
+        starting: "starting";
+        running: "running";
+        leaving: "leaving";
+        exited: "exited";
+    }>;
+    startedAt: z.ZodNumber;
+    seconds: z.ZodNumber;
+    containerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A run's status, as {@link RunStatus} parses it. */
+export type RunStatus = z.infer<typeof RunStatus>;
+/** The scheduler's `GET /capacity` answer: the worker's slots, how many are busy, and whether it takes new runs. */
+export declare const Capacity: z.ZodObject<{
+    workerId: z.ZodString;
+    slots: z.ZodNumber;
+    busy: z.ZodNumber;
+    paused: z.ZodBoolean;
+}, z.core.$strip>;
+/** A worker's capacity, as {@link Capacity} parses it. */
+export type Capacity = z.infer<typeof Capacity>;
+/** A stable event id for a report: the run, the worker's sequence number and the event. */
+export declare function reportEventId(runId: string, seq: number, event: string): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,eAAO,MAAM,SAAS,6CAA8C,CAAC;AAErE,8EAA8E;AAC9E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBrB,CAAC;AACH,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,WAAW;;;;;;EAA0E,CAAC;AACnG,yEAAyE;AACzE,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAMzB,CAAC;AACH,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;iBAAsG,CAAC;AAC9H,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,oFAAoF;AACpF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;EAAsP,CAAC;AAC/Q,uEAAuE;AACvE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcxB,CAAC;AACH,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,8EAA8E;AAC9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAwF,CAAC;AACpH,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa1B,CAAC;AACH,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,yHAAyH;AACzH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAkF,CAAC;AAC1G,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,oFAAoF;AACpF,eAAO,MAAM,SAAS;;;;;;;;;;;iBAA+K,CAAC;AACtM,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAClD,oHAAoH;AACpH,eAAO,MAAM,QAAQ;;;;;iBAA2G,CAAC;AACjI,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/dist/protocol.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/** The platforms the browser bot joins. */
+export const PLATFORMS = ['google_meet', 'microsoft_teams'];
+/** The job the scheduler sends a container as the channel's first message. */
+export const JobMessage = z.object({
+    type: z.literal('job'),
+    runId: z.string().min(1),
+    platform: z.enum(PLATFORMS),
+    meetingUrl: z.string().url(),
+    botName: z.string().min(1).max(80),
+    notice: z.object({ text: z.string().min(1).max(2000), version: z.string(), lateArrivalText: z.string().min(1).max(500) }),
+    stopPhrase: z.string().min(2).max(80),
+    limits: z.object({ waitingRoomMs: z.number().int().positive(), aloneMs: z.number().int().positive(), totalMs: z.number().int().positive() }),
+    livekit: z.object({ url: z.string().url(), token: z.string().min(1), identity: z.string().min(1) }),
+    /** The profile directory inside the container (Meet), absent for a guest join (Teams). */
+    profileDir: z.string().optional(),
+    /**
+     * `fixture` when the scheduler took the link's host from its test allowlist (`MEETING_RESOLVE_ALLOW`): the bot drives
+     * the fixture page's adapter, whose network policy admits that host. A production scheduler's allowlist is empty, so
+     * no production job carries it, and the product's `StartRunRequest` has no way to ask for it.
+     */
+    adapter: z.literal('fixture').optional(),
+});
+/** The commands the scheduler relays to a container. */
+export const CommandName = z.enum(['startCapture', 'suspendCapture', 'postChat', 'leave', 'kill']);
+/** A command down the channel, with the id its acknowledgement names. */
+export const CommandMessage = z.object({
+    type: z.literal('command'),
+    id: z.string().min(1),
+    name: CommandName,
+    text: z.string().max(2000).optional(),
+    reason: z.string().optional(),
+});
+/** A container's answer to one command, by the command's id. */
+export const AckMessage = z.object({ type: z.literal('ack'), id: z.string(), ok: z.boolean(), error: z.string().optional() });
+/** The lifecycle events a container reports: the channel's provider event types. */
+export const ReportEvent = z.enum(['joining', 'waiting_room', 'in_call', 'notice_posted', 'monitor_heartbeat', 'participant_joined', 'participant_left', 'chat_message', 'stop_command', 'capture_started', 'capture_suspended', 'left', 'done', 'crashed', 'usage', 'error']);
+/** One report up the channel, numbered by the container's sequence. */
+export const ReportMessage = z.object({
+    type: z.literal('report'),
+    seq: z.number().int().nonnegative(),
+    event: ReportEvent,
+    at: z.number().int().nonnegative(),
+    data: z.object({
+        reason: z.string().optional(),
+        seconds: z.number().nonnegative().optional(),
+        text: z.string().max(4000).optional(),
+        sender: z.string().max(200).optional(),
+        participantRef: z.string().max(200).optional(),
+        participantCount: z.number().int().nonnegative().optional(),
+        message: z.string().max(2000).optional(),
+    }).optional(),
+});
+/** What the container sends the scheduler, or the scheduler the container. */
+export const ChannelMessage = z.discriminatedUnion('type', [JobMessage, CommandMessage, AckMessage, ReportMessage]);
+/** The scheduler's `POST /runs` body, from the provider. */
+export const StartRunRequest = z.object({
+    runId: z.string().min(1),
+    platform: z.enum(PLATFORMS),
+    meetingUrl: z.string().url(),
+    botName: z.string().min(1).max(80),
+    notice: JobMessage.shape.notice,
+    stopPhrase: z.string().min(2).max(80),
+    limits: JobMessage.shape.limits,
+    livekit: JobMessage.shape.livekit,
+    /** The per-run bearer the container presents and the scheduler forwards on every report. */
+    workerToken: z.string().min(16),
+    /** Where the scheduler posts the run's reports. */
+    reportUrl: z.string().url(),
+});
+/** What the scheduler posts to `reportUrl`: one report, with the run id, under `Authorization: Bearer <workerToken>`. */
+export const ReportPost = ReportMessage.extend({ runId: z.string().min(1), workerId: z.string().min(1) });
+/** One run as the scheduler's `GET /runs` lists it, and as `POST /runs` answers. */
+export const RunStatus = z.object({ runId: z.string(), state: z.enum(['starting', 'running', 'leaving', 'exited']), startedAt: z.number(), seconds: z.number(), containerId: z.string().optional() });
+/** The scheduler's `GET /capacity` answer: the worker's slots, how many are busy, and whether it takes new runs. */
+export const Capacity = z.object({ workerId: z.string(), slots: z.number().int(), busy: z.number().int(), paused: z.boolean() });
+/** A stable event id for a report: the run, the worker's sequence number and the event. */
+export function reportEventId(runId, seq, event) {
+    return `browser:${runId}:${seq}:${event}`;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAU,CAAC;AAErE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IACzH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC5I,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,0FAA0F;IAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAIH,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACnG,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAIH,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAI9H,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/Q,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnC,KAAK,EAAE,WAAW;IAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACtC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC9C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;KACzC,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC;AAIH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAIpH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM;IAC/B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;IACjC,4FAA4F;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,mDAAmD;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC5B,CAAC,CAAC;AAIH,yHAAyH;AACzH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAI1G,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAGtM,oHAAoH;AACpH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAIjI,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,GAAW,EAAE,KAAa;IACrE,OAAO,WAAW,KAAK,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;AAC5C,CAAC"}

package/dist/scheduler/channel.d.ts

@@ -0,0 +1,45 @@
+import type { WebSocket } from 'ws';
+import { type AckMessage, type CommandMessage, type JobMessage, type ReportMessage } from '../protocol.js';
+/** How long a command waits for the container's acknowledgement. */
+export declare const ACK_TIMEOUT_MS = 10000;
+/** How often the scheduler pings a channel; a channel that has not answered the last ping by the next is cut. */
+export declare const HEARTBEAT_MS = 15000;
+/**
+ * The scheduler's end of one run's command channel: it sends the job, sends commands and waits for their
+ * acknowledgements, and hands the container's reports on. A message that does not parse, or that is not the container's
+ * to send (a job, a command), is dropped. A socket that stops answering pings is cut, so a link that broke without a
+ * close never holds the run's one channel against the bot's reconnect.
+ */
+export declare class ChannelPeer {
+    private readonly ws;
+    private readonly ackTimeoutMs;
+    private readonly pending;
+    private reportHandler;
+    private readonly closeHandlers;
+    private readonly heartbeat;
+    private answered;
+    private closed;
+    /**
+     * @param ws - The container's socket, after the handshake the scheduler authenticated.
+     * @param ackTimeoutMs - How long {@link ChannelPeer.command} waits for an acknowledgement.
+     * @param heartbeatMs - How often the socket is pinged.
+     */
+    constructor(ws: WebSocket, ackTimeoutMs?: number, heartbeatMs?: number);
+    /** Sends the run's job: the channel's first message, and again on every channel a reconnecting bot opens. */
+    sendJob(job: JobMessage): void;
+    /**
+     * Sends a command and resolves with the container's acknowledgement. No acknowledgement within the timeout, or a
+     * channel that closes first, resolves with `ok: false`; it never rejects.
+     */
+    command(command: CommandMessage): Promise<AckMessage>;
+    /** Sets the handler each of the container's reports goes to. */
+    onReport(handler: (report: ReportMessage) => void): void;
+    /** Adds a handler called once when the channel closes, whichever side closed it. */
+    onClose(handler: () => void): void;
+    /** Closes the channel with a WebSocket close code and a reason. */
+    close(code: number, reason: string): void;
+    private ping;
+    private receive;
+    private ended;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/scheduler/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/scheduler/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3H,oEAAoE;AACpE,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,iHAAiH;AACjH,eAAO,MAAM,YAAY,QAAS,CAAC;AAEnC;;;;;GAKG;AACH,qBAAa,WAAW;IAaV,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAa,OAAO,CAAC,QAAQ,CAAC,YAAY;IAZzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+F;IACvH,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBAC0B,EAAE,EAAE,SAAS,EAAmB,YAAY,SAAiB,EAAE,WAAW,SAAe;IAWtH,6GAA6G;IAC7G,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAI9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAarD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAIxD,oFAAoF;IACpF,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIlC,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzC,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,KAAK;CAWd"}

package/dist/scheduler/channel.js

@@ -0,0 +1,122 @@
+import { ChannelMessage } from '../protocol.js';
+/** How long a command waits for the container's acknowledgement. */
+export const ACK_TIMEOUT_MS = 10_000;
+/** How often the scheduler pings a channel; a channel that has not answered the last ping by the next is cut. */
+export const HEARTBEAT_MS = 15_000;
+/**
+ * The scheduler's end of one run's command channel: it sends the job, sends commands and waits for their
+ * acknowledgements, and hands the container's reports on. A message that does not parse, or that is not the container's
+ * to send (a job, a command), is dropped. A socket that stops answering pings is cut, so a link that broke without a
+ * close never holds the run's one channel against the bot's reconnect.
+ */
+export class ChannelPeer {
+    ws;
+    ackTimeoutMs;
+    pending = new Map();
+    reportHandler;
+    closeHandlers = [];
+    heartbeat;
+    answered = true;
+    closed = false;
+    /**
+     * @param ws - The container's socket, after the handshake the scheduler authenticated.
+     * @param ackTimeoutMs - How long {@link ChannelPeer.command} waits for an acknowledgement.
+     * @param heartbeatMs - How often the socket is pinged.
+     */
+    constructor(ws, ackTimeoutMs = ACK_TIMEOUT_MS, heartbeatMs = HEARTBEAT_MS) {
+        this.ws = ws;
+        this.ackTimeoutMs = ackTimeoutMs;
+        ws.on('message', (raw) => this.receive(raw));
+        ws.on('close', () => this.ended());
+        ws.on('error', () => undefined); // a socket error is followed by its close, which ends the peer
+        ws.on('pong', () => {
+            this.answered = true;
+        });
+        this.heartbeat = setInterval(() => this.ping(), heartbeatMs);
+        this.heartbeat.unref?.();
+    }
+    /** Sends the run's job: the channel's first message, and again on every channel a reconnecting bot opens. */
+    sendJob(job) {
+        this.ws.send(JSON.stringify(job));
+    }
+    /**
+     * Sends a command and resolves with the container's acknowledgement. No acknowledgement within the timeout, or a
+     * channel that closes first, resolves with `ok: false`; it never rejects.
+     */
+    command(command) {
+        if (this.closed)
+            return Promise.resolve({ type: 'ack', id: command.id, ok: false, error: 'the channel is closed' });
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(command.id);
+                resolve({ type: 'ack', id: command.id, ok: false, error: `no acknowledgement within ${this.ackTimeoutMs} ms` });
+            }, this.ackTimeoutMs);
+            timer.unref?.();
+            this.pending.set(command.id, { resolve, timer });
+            this.ws.send(JSON.stringify(command));
+        });
+    }
+    /** Sets the handler each of the container's reports goes to. */
+    onReport(handler) {
+        this.reportHandler = handler;
+    }
+    /** Adds a handler called once when the channel closes, whichever side closed it. */
+    onClose(handler) {
+        this.closeHandlers.push(handler);
+    }
+    /** Closes the channel with a WebSocket close code and a reason. */
+    close(code, reason) {
+        this.ws.close(code, reason);
+    }
+    ping() {
+        if (!this.answered) {
+            this.ws.terminate(); // the close that follows ends the peer
+            return;
+        }
+        this.answered = false;
+        try {
+            this.ws.ping();
+        }
+        catch {
+            this.ws.terminate();
+        }
+    }
+    receive(raw) {
+        let data;
+        try {
+            data = JSON.parse(raw.toString());
+        }
+        catch {
+            return;
+        }
+        const parsed = ChannelMessage.safeParse(data);
+        if (!parsed.success)
+            return;
+        const message = parsed.data;
+        if (message.type === 'ack') {
+            const waiting = this.pending.get(message.id);
+            if (!waiting)
+                return;
+            clearTimeout(waiting.timer);
+            this.pending.delete(message.id);
+            waiting.resolve(message);
+            return;
+        }
+        if (message.type === 'report')
+            this.reportHandler?.(message);
+    }
+    ended() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        clearInterval(this.heartbeat);
+        for (const [id, waiting] of this.pending) {
+            clearTimeout(waiting.timer);
+            waiting.resolve({ type: 'ack', id, ok: false, error: 'the channel closed' });
+        }
+        this.pending.clear();
+        for (const handler of this.closeHandlers)
+            handler();
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/scheduler/channel.js.map

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

package/dist/scheduler/docker.d.ts

@@ -0,0 +1,86 @@
+import type Dockerode from 'dockerode';
+/** A container as the scheduler commands it after its start; `dockerode`'s `Container` is one. */
+export interface ContainerLike {
+    /** Stops the container, killing it after `t` seconds. */
+    stop(opts?: {
+        t?: number;
+    }): Promise<void>;
+    /** Removes the container; `force` kills a running one first. */
+    remove(opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** Resolves with the exit code once the container stops. */
+    wait(): Promise<{
+        StatusCode: number;
+    }>;
+    /** With `hijack`, the stream is the container's stdin: what is written reaches the bot, and ending it closes its stdin. */
+    attach(opts: {
+        stream: boolean;
+        stdin: boolean;
+        hijack: boolean;
+    }): Promise<NodeJS.WritableStream>;
+}
+/** The part of a Docker client the scheduler uses; `dockerode`'s `Docker` is one, and the tests pass a fake. */
+export interface DockerLike {
+    /** Creates a container from the options and answers a handle to start and watch it. */
+    createContainer(options: Dockerode.ContainerCreateOptions): Promise<{
+        id: string;
+        start(): Promise<void>;
+        stop(opts?: {
+            t?: number;
+        }): Promise<void>;
+        remove(opts?: {
+            force?: boolean;
+        }): Promise<void>;
+        wait(): Promise<{
+            StatusCode: number;
+        }>;
+    }>;
+    /** Lists containers, the stopped ones too with `all`, by label filters (`key=value`). */
+    listContainers(options: {
+        all: boolean;
+        filters: Record<string, string[]>;
+    }): Promise<Array<{
+        Id: string;
+        State: string;
+        Labels: Record<string, string>;
+    }>>;
+    /** A handle on an existing container by its id. */
+    getContainer(id: string): ContainerLike;
+}
+/** The scheduler's fixed container policy: the image and the limits come from its configuration, never from a request. */
+export interface ContainerPolicy {
+    /** The bot image, by tag or digest. */
+    image: string;
+    /** The Docker network the containers join (the bots' bridge, never the host's network). */
+    network: string;
+    /** The memory limit per container, in bytes. */
+    memoryBytes: number;
+    /** The CPU limit per container, in billionths of a CPU. */
+    nanoCpus: number;
+    /** The most processes a container may hold. */
+    pidsLimit: number;
+    /** The size of `/dev/shm`, in bytes (Chromium's shared memory). */
+    shmBytes: number;
+    /**
+     * The seccomp profile as its JSON text. The Engine API takes the profile itself in `SecurityOpt` (the `docker` command
+     * reads a file and sends its contents), so the scheduler's entry point reads `MEETING_SECCOMP_PROFILE` once at start.
+     */
+    seccompProfile?: string;
+    /** The encrypted profile volume's mount point on the host; a run's profile is `<root>/<identity>`. */
+    profilesRoot?: string;
+    /** The channel's url as the containers reach it. */
+    channelUrl: string;
+}
+/** The label that names a container's run. */
+export declare const LABEL_RUN = "dev.frame.meeting.run";
+/** The label that names the worker a container belongs to. */
+export declare const LABEL_WORKER = "dev.frame.meeting.worker";
+/** Where an identity's profile is mounted inside the container. */
+export declare const PROFILE_MOUNT = "/home/bot/profile";
+/**
+ * The container's create options: nothing customer-supplied, only the run id and the channel's address. Its stdin stays
+ * open for one attached writer, which is how the run's token reaches the bot without appearing in `docker inspect`.
+ */
+export declare function containerOptions(policy: ContainerPolicy, runId: string, workerId: string, profileDir: string | undefined): Dockerode.ContainerCreateOptions;
+//# sourceMappingURL=docker.d.ts.map

package/dist/scheduler/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/scheduler/docker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,WAAW,CAAC;AAEvC,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,gEAAgE;IAChE,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,4DAA4D;IAC5D,IAAI,IAAI,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,2HAA2H;IAC3H,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;CACpG;AAED,gHAAgH;AAChH,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,sBAAsB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACpP,yFAAyF;IACzF,cAAc,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5J,mDAAmD;IACnD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC;CACzC;AAED,0HAA0H;AAC1H,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8CAA8C;AAC9C,eAAO,MAAM,SAAS,0BAA0B,CAAC;AACjD,8DAA8D;AAC9D,eAAO,MAAM,YAAY,6BAA6B,CAAC;AACvD,mEAAmE;AACnE,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,sBAAsB,CAuB3J"}