@nexus-code/remote-protocol 0.0.0-stage → 0.1.0

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAU/D,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/rpc.js

@@ -0,0 +1,225 @@
+/**
+ * What one device asks another, sealed: JSON-RPC 2.0 requests, their
+ * answers, and the notifications a watch sends. The device that runs the
+ * sessions serves; the one that shows them asks.
+ *
+ * A session is named by the serving device's own ids: its workspace's and
+ * its tab's. The same folder has other ids on another device.
+ */
+import { z } from "zod";
+import { AssistantItemSchema, ChatStatusSchema, ViewItemSchema, ViewTaskSchema, ViewToolCallSchema, } from "./view.js";
+// ---------------------------------------------------------------------------
+// JSON-RPC 2.0 shapes
+// ---------------------------------------------------------------------------
+export const RpcIdSchema = z.union([z.number().int(), z.string()]);
+export const RpcRequestSchema = z.object({
+    jsonrpc: z.literal("2.0"),
+    id: RpcIdSchema,
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+export const RpcErrorSchema = z.object({
+    code: z.number().int(),
+    message: z.string(),
+    data: z.unknown().optional(),
+});
+// The error first: `result: z.unknown()` takes an object without one too,
+// and would strip an error answer's `error`.
+export const RpcResponseSchema = z.union([
+    z.object({ jsonrpc: z.literal("2.0"), id: RpcIdSchema, error: RpcErrorSchema }),
+    z.object({ jsonrpc: z.literal("2.0"), id: RpcIdSchema, result: z.unknown() }),
+]);
+export const RpcNotificationSchema = z.object({
+    jsonrpc: z.literal("2.0"),
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+export const RpcMessageSchema = z.union([
+    RpcRequestSchema,
+    RpcResponseSchema,
+    RpcNotificationSchema,
+]);
+/** The error codes: JSON-RPC's own, and the protocol's from 1000. */
+export const RpcErrorCode = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    /** No such workspace, tab or watch on the serving device. */
+    NotFound: 1001,
+    /** The serving device does not let this device do it. */
+    Forbidden: 1002,
+    /** The session cannot do it now: a chat with no request waiting, one whose program is gone. */
+    Unavailable: 1003,
+};
+// ---------------------------------------------------------------------------
+// Sessions
+// ---------------------------------------------------------------------------
+/** A workspace of the serving device. */
+export const RemoteWorkspaceSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    /** Its folder, on the serving device. */
+    path: z.string(),
+});
+/** Where a session stands, as the agent lists show it. */
+export const SessionStateSchema = z.enum(["needs-you", "running", "new-result", "idle", "ended"]);
+/** An agent session or terminal of the serving device. */
+export const RemoteSessionSchema = z.object({
+    workspaceId: z.string(),
+    tabId: z.string(),
+    kind: z.enum(["claude", "codex", "terminal"]),
+    title: z.string(),
+    state: SessionStateSchema,
+    /** When it came to that state, in Unix milliseconds. */
+    since: z.number().optional(),
+    /** The last thing it said, a line. */
+    last: z.string().optional(),
+    /** The agent profile it runs with. */
+    profile: z.string().optional(),
+    /** What it waits on the user for, when it does. */
+    waiting: z
+        .object({
+        kind: z.enum(["permission", "question", "plan"]),
+        text: z.string(),
+    })
+        .optional(),
+});
+const SessionsSchema = z.object({
+    workspaces: z.array(RemoteWorkspaceSchema),
+    sessions: z.array(RemoteSessionSchema),
+});
+/** A session of the serving device, by its ids there. */
+const TabRef = { workspaceId: z.string(), tabId: z.string() };
+// ---------------------------------------------------------------------------
+// Chats
+// ---------------------------------------------------------------------------
+/** Most items one chat.read gives; earlier ones come by `before`. */
+export const MAX_READ_ITEMS = 500;
+/**
+ * A page of a chat: its status, the items from `start` (before `total`),
+ * and the tool calls, tasks and subagents' messages they name.
+ */
+export const ChatPageSchema = z.object({
+    status: ChatStatusSchema,
+    start: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+    items: z.array(ViewItemSchema),
+    tools: z.record(ViewToolCallSchema),
+    tasks: z.record(ViewTaskSchema),
+    agentItems: z.record(z.array(AssistantItemSchema)),
+});
+/**
+ * What changed in a watched chat since its last update (or its watch
+ * began). Items are put at their index; `total` cuts the list when it got
+ * shorter. Tool calls, tasks and subagents' messages are put by id.
+ */
+export const ChatUpdateSchema = z.object({
+    watchId: z.string(),
+    /** Counts the watch's updates from 1, so one lost shows. */
+    rev: z.number().int().positive(),
+    status: ChatStatusSchema.optional(),
+    total: z.number().int().nonnegative(),
+    items: z.array(z.object({ index: z.number().int().nonnegative(), item: ViewItemSchema })),
+    tools: z.record(ViewToolCallSchema),
+    tasks: z.record(ViewTaskSchema),
+    agentItems: z.record(z.array(AssistantItemSchema)),
+});
+/** The sessions' list as it is now, sent whenever it changes during a sessions.watch. */
+export const SessionsUpdateSchema = SessionsSchema.extend({ watchId: z.string() });
+const Ok = z.object({});
+// ---------------------------------------------------------------------------
+// The methods
+// ---------------------------------------------------------------------------
+/**
+ * Each method's params and result, and the capability (see ./sealed.ts)
+ * the serving device lists for it.
+ */
+export const RPC_METHODS = {
+    "sessions.list": { capability: "sessions", params: Ok, result: SessionsSchema },
+    /** The list now; then a sessions.update each time it changes, until sessions.unwatch. */
+    "sessions.watch": {
+        capability: "sessions",
+        params: Ok,
+        result: SessionsSchema.extend({ watchId: z.string() }),
+    },
+    "sessions.unwatch": {
+        capability: "sessions",
+        params: z.object({ watchId: z.string() }),
+        result: Ok,
+    },
+    /** The chat's last `limit` items, or those before `before`. */
+    "chat.read": {
+        capability: "chat.read",
+        params: z.object({
+            ...TabRef,
+            before: z.number().int().nonnegative().optional(),
+            limit: z.number().int().positive().max(MAX_READ_ITEMS).optional(),
+        }),
+        result: ChatPageSchema,
+    },
+    /** The chat's last page now; then a chat.update each time it changes, until chat.unwatch. */
+    "chat.watch": {
+        capability: "chat.read",
+        params: z.object({
+            ...TabRef,
+            limit: z.number().int().positive().max(MAX_READ_ITEMS).optional(),
+        }),
+        result: ChatPageSchema.extend({ watchId: z.string() }),
+    },
+    "chat.unwatch": {
+        capability: "chat.read",
+        params: z.object({ watchId: z.string() }),
+        result: Ok,
+    },
+    /** Sends a message, as its composer does: during a turn, the turn reads it next. */
+    "chat.send": {
+        capability: "chat.control",
+        params: z.object({ ...TabRef, text: z.string().min(1) }),
+        result: Ok,
+    },
+    /** Answers the permission request `requestId`, as its card's buttons do. */
+    "chat.answer": {
+        capability: "chat.control",
+        params: z.object({
+            ...TabRef,
+            requestId: z.string(),
+            decision: z.enum(["allow", "deny"]),
+            /** Why, for a denial: the program reads it. */
+            message: z.string().optional(),
+            /** With allow: the input the tool runs with, as the user filled it (a question's answers). */
+            updatedInput: z.record(z.unknown()).optional(),
+            /** With deny: the turn stops too, as the card's "No, and stop" does. */
+            stop: z.boolean().optional(),
+        }),
+        result: Ok,
+    },
+    "chat.interrupt": { capability: "chat.control", params: z.object(TabRef), result: Ok },
+    /** Opens a chat in one of the serving device's workspaces, sending it `prompt` if given. */
+    "chat.new": {
+        capability: "chat.control",
+        params: z.object({
+            workspaceId: z.string(),
+            agent: z.enum(["claude", "codex"]),
+            prompt: z.string().optional(),
+        }),
+        result: z.object({ tabId: z.string() }),
+    },
+    "chat.close": { capability: "chat.control", params: z.object(TabRef), result: Ok },
+    /** A terminal's screen and the lines above it, as text. Nothing can be typed into it. */
+    "terminal.read": {
+        capability: "terminal.read",
+        params: z.object({ ...TabRef, lines: z.number().int().positive().max(5000).optional() }),
+        result: z.object({ text: z.string() }),
+    },
+};
+/** The notifications a serving device sends, by method. */
+export const RPC_NOTIFICATIONS = {
+    "sessions.update": SessionsUpdateSchema,
+    "chat.update": ChatUpdateSchema,
+};
+export function isRpcMethod(method) {
+    return Object.hasOwn(RPC_METHODS, method);
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/sealed.d.ts

@@ -0,0 +1,230 @@
+/**
+ * What a sealed message carries, which only the account's devices can open.
+ *
+ * Sealing (v1): XChaCha20-Poly1305 with the room key, a fresh random 24-byte
+ * nonce per message, and the frame's routing as associated data (aadOf), so
+ * the relay can neither read a message nor pass it off as another's. The
+ * room key comes from the account key (see the account key design); every
+ * device of the account holds it. The bytes sealed are the message's JSON
+ * in UTF-8.
+ */
+import { z } from "zod";
+import { type DeviceId } from "./relay.js";
+/** The version of what is sealed; a device tells it in its hello. */
+export declare const PROTOCOL_VERSION = 1;
+/** The HKDF info that makes the room key from the account key. */
+export declare const ROOM_KEY_INFO = "nexus-remote/room-key/v1";
+/**
+ * The associated data a message is sealed with: its routing, as the relay
+ * delivers it. A message the relay sends on to another device, or with
+ * another seq, does not open.
+ */
+export declare function aadOf(frame: {
+    from: DeviceId;
+    to: string;
+    seq: number;
+    kid: number;
+}): string;
+/**
+ * What a device can do for another, as it says in its hello. The other
+ * side asks only for what is listed; a newer device lists more.
+ */
+export declare const CAPABILITIES: readonly ["sessions", "chat.read", "chat.control", "terminal.read"];
+export declare const CapabilitySchema: z.ZodString;
+export type Capability = (typeof CAPABILITIES)[number];
+/**
+ * A device introduces itself: to all the room as it joins, and to one that
+ * just joined. What it serves of its own sessions is `serves`; a device
+ * that only watches others (a phone) serves nothing.
+ */
+export declare const HelloSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    protocol: z.ZodNumber;
+    device: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        platform: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        platform: string;
+    }, {
+        id: string;
+        name: string;
+        platform: string;
+    }>;
+    app: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+    }, {
+        name: string;
+        version: string;
+    }>;
+    serves: z.ZodArray<z.ZodString, "many">;
+    /** Whether it wants the hello of devices already there: true as it joins. */
+    reply: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    type: "hello";
+    protocol: number;
+    device: {
+        id: string;
+        name: string;
+        platform: string;
+    };
+    app: {
+        name: string;
+        version: string;
+    };
+    serves: string[];
+    reply: boolean;
+}, {
+    type: "hello";
+    protocol: number;
+    device: {
+        id: string;
+        name: string;
+        platform: string;
+    };
+    app: {
+        name: string;
+        version: string;
+    };
+    serves: string[];
+    reply: boolean;
+}>;
+export type Hello = z.infer<typeof HelloSchema>;
+/** A sealed message's content. */
+export declare const SealedMessageSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    protocol: z.ZodNumber;
+    device: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        platform: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        platform: string;
+    }, {
+        id: string;
+        name: string;
+        platform: string;
+    }>;
+    app: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+    }, {
+        name: string;
+        version: string;
+    }>;
+    serves: z.ZodArray<z.ZodString, "many">;
+    /** Whether it wants the hello of devices already there: true as it joins. */
+    reply: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    type: "hello";
+    protocol: number;
+    device: {
+        id: string;
+        name: string;
+        platform: string;
+    };
+    app: {
+        name: string;
+        version: string;
+    };
+    serves: string[];
+    reply: boolean;
+}, {
+    type: "hello";
+    protocol: number;
+    device: {
+        id: string;
+        name: string;
+        platform: string;
+    };
+    app: {
+        name: string;
+        version: string;
+    };
+    serves: string[];
+    reply: boolean;
+}>, z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}, {
+    id: string | number;
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}>, z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: unknown;
+    }, {
+        code: number;
+        message: string;
+        data?: unknown;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    jsonrpc: "2.0";
+}, {
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    jsonrpc: "2.0";
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    result: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}>]>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}, {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}>]>]>;
+export type SealedMessage = z.infer<typeof SealedMessageSchema>;
+//# sourceMappingURL=sealed.d.ts.map

package/dist/sealed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealed.d.ts","sourceRoot":"","sources":["../src/sealed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAG3D,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,kEAAkE;AAClE,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7F;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,qEASf,CAAC;AACX,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUtB,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7E,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,kCAAkC;AAClC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;IAN9B,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAMJ,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/sealed.js

@@ -0,0 +1,61 @@
+/**
+ * What a sealed message carries, which only the account's devices can open.
+ *
+ * Sealing (v1): XChaCha20-Poly1305 with the room key, a fresh random 24-byte
+ * nonce per message, and the frame's routing as associated data (aadOf), so
+ * the relay can neither read a message nor pass it off as another's. The
+ * room key comes from the account key (see the account key design); every
+ * device of the account holds it. The bytes sealed are the message's JSON
+ * in UTF-8.
+ */
+import { z } from "zod";
+import { DeviceIdSchema } from "./relay.js";
+import { RpcMessageSchema } from "./rpc.js";
+/** The version of what is sealed; a device tells it in its hello. */
+export const PROTOCOL_VERSION = 1;
+/** The HKDF info that makes the room key from the account key. */
+export const ROOM_KEY_INFO = "nexus-remote/room-key/v1";
+/**
+ * The associated data a message is sealed with: its routing, as the relay
+ * delivers it. A message the relay sends on to another device, or with
+ * another seq, does not open.
+ */
+export function aadOf(frame) {
+    return `nexus-remote/v${PROTOCOL_VERSION}|${frame.from}|${frame.to}|${frame.seq}|${frame.kid}`;
+}
+/**
+ * What a device can do for another, as it says in its hello. The other
+ * side asks only for what is listed; a newer device lists more.
+ */
+export const CAPABILITIES = [
+    /** sessions.list and the session events. */
+    "sessions",
+    /** chat.read and chat.watch. */
+    "chat.read",
+    /** chat.send, chat.answer, chat.interrupt, chat.new and chat.close. */
+    "chat.control",
+    /** terminal.read: a terminal's screen, as text. */
+    "terminal.read",
+];
+export const CapabilitySchema = z.string();
+/**
+ * A device introduces itself: to all the room as it joins, and to one that
+ * just joined. What it serves of its own sessions is `serves`; a device
+ * that only watches others (a phone) serves nothing.
+ */
+export const HelloSchema = z.object({
+    type: z.literal("hello"),
+    protocol: z.number().int().positive(),
+    device: z.object({
+        id: DeviceIdSchema,
+        name: z.string(),
+        platform: z.string(),
+    }),
+    app: z.object({ name: z.string(), version: z.string() }),
+    serves: z.array(CapabilitySchema),
+    /** Whether it wants the hello of devices already there: true as it joins. */
+    reply: z.boolean(),
+});
+/** A sealed message's content. */
+export const SealedMessageSchema = z.union([HelloSchema, RpcMessageSchema]);
+//# sourceMappingURL=sealed.js.map

package/dist/sealed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealed.js","sourceRoot":"","sources":["../src/sealed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAA+D;IACnF,OAAO,iBAAiB,gBAAgB,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;AACjG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,4CAA4C;IAC5C,UAAU;IACV,gCAAgC;IAChC,WAAW;IACX,uEAAuE;IACvE,cAAc;IACd,mDAAmD;IACnD,eAAe;CACP,CAAC;AACX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAG3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACjC,6EAA6E;IAC7E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAGH,kCAAkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC"}