@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/envelope.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Every Agent Connect event is an envelope plus a payload. The envelope is the part Chips
+ * itself reads: who acted, in which workspace, on which run, and — for anything a client
+ * sends — the key that makes replaying it safe.
+ *
+ * The shape is fixed by Appendix C of the technical plan.
+ */
+import { z } from "zod";
+/** The protocol version this build speaks. Breaking changes only at a major, after 1.0. */
+export declare const PROTOCOL_VERSION: 1;
+export declare const envelope: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodString;
+    id: z.ZodString;
+    ts: z.ZodISODateTime;
+    workspace_id: z.ZodString;
+    space_id: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodInt>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    actor: z.ZodObject<{
+        kind: z.ZodEnum<{
+            person: "person";
+            harness: "harness";
+            agent: "agent";
+            system: "system";
+        }>;
+        id: z.ZodString;
+        harness_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Envelope = z.infer<typeof envelope>;
+/**
+ * Which way an event travels. `workspace` events never leave Chips: they record a human action
+ * on the workspace itself, so the read models that depend on them can be replayed (ADR 0018).
+ */
+export type Direction = "harness_to_chips" | "chips_to_harness" | "workspace";
+/**
+ * Who writes an event (agents review, finding 1): a harness with its token, a person with a device
+ * key, either, or Chips alone. `chips` is refused from every client: Chips writes it itself, as it
+ * delivers or from what it already knows. Said for every event, so a new one cannot default to
+ * "anybody may".
+ */
+export type EventSender = "harness" | "person" | "either" | "chips";
+/** The description of one event type: everything the schema, the docs and the tests need. */
+export interface EventDefinition<TType extends string = string> {
+    /** The wire value of `type`. */
+    readonly type: TType;
+    readonly direction: Direction;
+    /** Who may send it through the door. The direction says who hears it; this says who writes it. */
+    readonly sender: EventSender;
+    /**
+     * The fields of its payload that are Chips's to write and not derived again at the door: a value
+     * a sender wrote is dropped before the schema sees the event (agents review, finding 2).
+     */
+    readonly chipsWrites?: readonly string[];
+    /** One sentence, in the product voice. Becomes the reference page's opening line. */
+    readonly summary: string;
+    /** The fields this event adds to the envelope. */
+    readonly payload: z.ZodObject;
+    /** Whether a harness may send this without a `run_id`. */
+    readonly requiresRun: boolean;
+}
+/** Build the full schema for an event: the envelope, its `type` narrowed, and its payload. */
+export declare function eventSchema<TType extends string>(definition: EventDefinition<TType>): z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+/** Helper for declaring a definition without losing the literal type of `type`. */
+export declare function defineEvent<TType extends string>(definition: EventDefinition<TType>): EventDefinition<TType>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/src/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;iBA0BuC,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,WAAW,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,6FAA6F;AAC7F,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC5D,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC;;kBAKnF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAC9C,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,GACjC,eAAe,CAAC,KAAK,CAAC,CAExB"}

package/dist/src/envelope.js

@@ -0,0 +1,46 @@
+/**
+ * Every Agent Connect event is an envelope plus a payload. The envelope is the part Chips
+ * itself reads: who acted, in which workspace, on which run, and — for anything a client
+ * sends — the key that makes replaying it safe.
+ *
+ * The shape is fixed by Appendix C of the technical plan.
+ */
+import { z } from "zod";
+import { actor, id, isoTimestamp } from "./primitives.js";
+/** The protocol version this build speaks. Breaking changes only at a major, after 1.0. */
+export const PROTOCOL_VERSION = 1;
+export const envelope = z
+    .object({
+    v: z.literal(PROTOCOL_VERSION).describe("Protocol major version."),
+    type: z.string().min(1).describe("The event type, for example `approval.request`."),
+    id: id("event").describe("The event's own id. Stable across a retry of the same event."),
+    ts: isoTimestamp.describe("When it happened, by Chips' clock. Stamped on the way in; a value the sender writes is replaced."),
+    workspace_id: id("workspace"),
+    space_id: id("space").optional().describe("The space, when the event belongs to one."),
+    run_id: id("run").optional().describe("The run, when the event belongs to one."),
+    seq: z
+        .int()
+        .positive()
+        .optional()
+        .describe("Assigned by the server on append, monotonic per workspace. Absent on the way in."),
+    idempotency_key: z
+        .string()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe("Required on every client-originated write. Sending the same key twice is a no-op."),
+    actor,
+})
+    .describe("The fields every Agent Connect event carries.");
+/** Build the full schema for an event: the envelope, its `type` narrowed, and its payload. */
+export function eventSchema(definition) {
+    return envelope
+        .extend({ type: z.literal(definition.type) })
+        .extend(definition.payload.shape)
+        .describe(definition.summary);
+}
+/** Helper for declaring a definition without losing the literal type of `type`. */
+export function defineEvent(definition) {
+    return definition;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/src/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACnF,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACxF,EAAE,EAAE,YAAY,CAAC,QAAQ,CACvB,kGAAkG,CACnG;IACD,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC;IAC7B,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACtF,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAChF,GAAG,EAAE,CAAC;SACH,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;IACH,KAAK;CACN,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAsC7D,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CAAuB,UAAkC;IAClF,OAAO,QAAQ;SACZ,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CACzB,UAAkC;IAElC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/events/catalogue.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The catalogue is the single list of every Agent Connect event. The schemas, the generated
+ * JSON Schema, the generated types, the reference pages and the fixture tests are all reads
+ * of this one array, so an event cannot exist in one of them and not the others.
+ */
+import type { z } from "zod";
+import { type EventDefinition } from "../envelope.js";
+import { CHIPS_TO_HARNESS } from "./chips-to-harness.js";
+import { HARNESS_TO_CHIPS } from "./harness-to-chips.js";
+import { WORKSPACE_EVENTS } from "./workspace.js";
+/** Every event in the log: Agent Connect in both directions, then Chips' own (ADR 0018). */
+export declare const EVENTS: readonly EventDefinition[];
+/** Every event type, as a plain list of strings. */
+export declare const EVENT_TYPES: readonly string[];
+export type HarnessToChipsType = (typeof HARNESS_TO_CHIPS)[number]["type"];
+export type ChipsToHarnessType = (typeof CHIPS_TO_HARNESS)[number]["type"];
+export type WorkspaceEventType = (typeof WORKSPACE_EVENTS)[number]["type"];
+export type EventType = HarnessToChipsType | ChipsToHarnessType | WorkspaceEventType;
+/** The definition for one event type, or undefined when nothing declares it. */
+export declare function eventDefinition(type: string): EventDefinition | undefined;
+export declare function schemaFor(type: string): z.ZodObject | undefined;
+/** Every schema, keyed by event type. Used by the generators. */
+export declare const EVENT_SCHEMAS: ReadonlyMap<string, z.ZodObject>;
+export declare class UnknownEventTypeError extends Error {
+    readonly type: string;
+    readonly name = "UnknownEventTypeError";
+    constructor(type: string);
+}
+export interface ParseFailure {
+    readonly type: "unknown_type" | "invalid";
+    readonly message: string;
+    readonly issues?: readonly {
+        path: string;
+        message: string;
+    }[];
+}
+/**
+ * Validate one event from the wire. This is the edge: everything inside trusts the result and
+ * does not re-validate (technical-plan 6.1). A field the schema does not declare is dropped, and
+ * `dropped` names those at the top level, so whoever sent them can be told (ADR 0162).
+ */
+export declare function parseEvent(input: unknown): {
+    ok: true;
+    value: Record<string, unknown>;
+    dropped: readonly string[];
+} | {
+    ok: false;
+    error: ParseFailure;
+};
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/src/events/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../../src/events/catalogue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,4FAA4F;AAC5F,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAI5C,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAAsC,CAAC;AAEhF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAIrF,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,SAAS,CAE/D;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAW,CAAC;AAEvE,qBAAa,qBAAsB,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADjC,SAAkB,IAAI,2BAA2B;gBAC5B,IAAI,EAAE,MAAM;CAGlC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,GAEZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA4BrC"}

package/dist/src/events/catalogue.js

@@ -0,0 +1,70 @@
+/**
+ * The catalogue is the single list of every Agent Connect event. The schemas, the generated
+ * JSON Schema, the generated types, the reference pages and the fixture tests are all reads
+ * of this one array, so an event cannot exist in one of them and not the others.
+ */
+import { eventSchema } from "../envelope.js";
+import { CHIPS_TO_HARNESS } from "./chips-to-harness.js";
+import { HARNESS_TO_CHIPS } from "./harness-to-chips.js";
+import { WORKSPACE_EVENTS } from "./workspace.js";
+/** Every event in the log: Agent Connect in both directions, then Chips' own (ADR 0018). */
+export const EVENTS = [
+    ...HARNESS_TO_CHIPS,
+    ...CHIPS_TO_HARNESS,
+    ...WORKSPACE_EVENTS,
+];
+/** Every event type, as a plain list of strings. */
+export const EVENT_TYPES = EVENTS.map((event) => event.type);
+const byType = new Map(EVENTS.map((event) => [event.type, event]));
+/** The definition for one event type, or undefined when nothing declares it. */
+export function eventDefinition(type) {
+    return byType.get(type);
+}
+/** The full schema — envelope plus payload — for one event type. */
+const schemas = new Map(EVENTS.map((event) => [event.type, eventSchema(event)]));
+export function schemaFor(type) {
+    return schemas.get(type);
+}
+/** Every schema, keyed by event type. Used by the generators. */
+export const EVENT_SCHEMAS = schemas;
+export class UnknownEventTypeError extends Error {
+    type;
+    name = "UnknownEventTypeError";
+    constructor(type) {
+        super(`no schema is declared for event type ${JSON.stringify(type)}`);
+        this.type = type;
+    }
+}
+/**
+ * Validate one event from the wire. This is the edge: everything inside trusts the result and
+ * does not re-validate (technical-plan 6.1). A field the schema does not declare is dropped, and
+ * `dropped` names those at the top level, so whoever sent them can be told (ADR 0162).
+ */
+export function parseEvent(input) {
+    const type = input?.type;
+    if (typeof type !== "string") {
+        return { ok: false, error: { type: "unknown_type", message: "event has no `type`" } };
+    }
+    const schema = schemas.get(type);
+    if (schema === undefined) {
+        return { ok: false, error: { type: "unknown_type", message: `unknown event type ${type}` } };
+    }
+    const parsed = schema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            error: {
+                type: "invalid",
+                message: `${type} is not valid`,
+                issues: parsed.error.issues.map((issue) => ({
+                    path: issue.path.join(".") || "(root)",
+                    message: issue.message,
+                })),
+            },
+        };
+    }
+    const value = parsed.data;
+    const dropped = Object.keys(input).filter((key) => !Object.hasOwn(value, key));
+    return { ok: true, value, dropped };
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/src/events/catalogue.js.map

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

package/dist/src/events/chips-to-harness.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Events Chips sends to a harness.
+ *
+ * The harness keeps its own loop, memory and tools. What it gains is structured asks and a
+ * stable multi-user story: it sees a sender id and a role, and treats Chips as one trusted
+ * account (blueprint, Connect).
+ */
+export declare const hello: import("../envelope.js").EventDefinition<"hello">;
+export declare const messageNew: import("../envelope.js").EventDefinition<"message.new">;
+export declare const messageOverheard: import("../envelope.js").EventDefinition<"message.overheard">;
+export declare const runRequested: import("../envelope.js").EventDefinition<"run.requested">;
+export declare const approvalResolved: import("../envelope.js").EventDefinition<"approval.resolved">;
+export declare const questionAnswered: import("../envelope.js").EventDefinition<"question.answered">;
+export declare const runSteer: import("../envelope.js").EventDefinition<"run.steer">;
+export declare const runPause: import("../envelope.js").EventDefinition<"run.pause">;
+export declare const runResume: import("../envelope.js").EventDefinition<"run.resume">;
+export declare const runCancel: import("../envelope.js").EventDefinition<"run.cancel">;
+export declare const policyUpdated: import("../envelope.js").EventDefinition<"policy.updated">;
+/**
+ * Eighty percent of a ceiling spent, or all of it. For a harness's budget, or since ADR 0118 for a
+ * room's job (`scope: "job"`): the room's harnesses are told once per job at each, in the room
+ * (`space_id`), and at a hundred Chips has paused the agents there (`exchange.set` with `why:
+ * "spend"`) until a person acts. A harness that chains turns itself starts no new one in that
+ * room until then; one that runs a turn per message needs do nothing, since the room holds what
+ * its agents say to each other.
+ */
+export declare const budgetWarning: import("../envelope.js").EventDefinition<"budget.warning">;
+export declare const laneUpdated: import("../envelope.js").EventDefinition<"lane.updated">;
+/**
+ * Sent by a person, like a steer: the direction says who hears it. Chips fills in `from` and
+ * delivers it to the harness whose message it is, and to everyone in the space.
+ */
+export declare const feedback: import("../envelope.js").EventDefinition<"feedback">;
+export declare const receipt: import("../envelope.js").EventDefinition<"receipt">;
+/** Every event Chips may send, in the order the reference lists them. */
+export declare const CHIPS_TO_HARNESS: readonly [import("../envelope.js").EventDefinition<"hello">, import("../envelope.js").EventDefinition<"message.new">, import("../envelope.js").EventDefinition<"message.overheard">, import("../envelope.js").EventDefinition<"run.requested">, import("../envelope.js").EventDefinition<"approval.resolved">, import("../envelope.js").EventDefinition<"question.answered">, import("../envelope.js").EventDefinition<"run.steer">, import("../envelope.js").EventDefinition<"run.pause">, import("../envelope.js").EventDefinition<"run.resume">, import("../envelope.js").EventDefinition<"run.cancel">, import("../envelope.js").EventDefinition<"policy.updated">, import("../envelope.js").EventDefinition<"budget.warning">, import("../envelope.js").EventDefinition<"lane.updated">, import("../envelope.js").EventDefinition<"feedback">, import("../envelope.js").EventDefinition<"receipt">];
+//# sourceMappingURL=chips-to-harness.d.ts.map

package/dist/src/events/chips-to-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chips-to-harness.d.ts","sourceRoot":"","sources":["../../../src/events/chips-to-harness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiEH,eAAO,MAAM,KAAK,mDAwDhB,CAAC;AA+DH,eAAO,MAAM,UAAU,yDAmCrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DAe3B,CAAC;AAEH,eAAO,MAAM,YAAY,2DA0DvB,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DA+C3B,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DAgC3B,CAAC;AAEH,eAAO,MAAM,QAAQ,uDAanB,CAAC;AAEH,eAAO,MAAM,QAAQ,uDAenB,CAAC;AAEH,eAAO,MAAM,SAAS,wDAkBpB,CAAC;AAEH,eAAO,MAAM,SAAS,wDAgBpB,CAAC;AAEH,eAAO,MAAM,aAAa,4DA2BxB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,4DA6BxB,CAAC;AAEH,eAAO,MAAM,WAAW,0DAqCtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,sDA2BnB,CAAC;AAEH,eAAO,MAAM,OAAO,qDAYlB,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,02BAgBnB,CAAC"}