@slaw-ai/server 2026.611.0

package/dist/services/goals.d.ts

@@ -0,0 +1,433 @@
+import type { Db } from "@slaw-ai/db";
+import { goals } from "@slaw-ai/db";
+type GoalReader = Pick<Db, "select">;
+export declare function getDefaultSquadGoal(db: GoalReader, squadId: string): Promise<{
+    id: string;
+    squadId: string;
+    title: string;
+    description: string | null;
+    level: string;
+    status: string;
+    parentId: string | null;
+    ownerAgentId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}>;
+export declare function goalService(db: Db): {
+    list: (squadId: string) => Omit<import("drizzle-orm/pg-core").PgSelectBase<"goals", {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        squadId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "squad_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        level: import("drizzle-orm/pg-core").PgColumn<{
+            name: "level";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        parentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "parent_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        ownerAgentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "owner_agent_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "goals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "goals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    }, "single", Record<"goals", "not-null">, false, "where", {
+        id: string;
+        squadId: string;
+        title: string;
+        description: string | null;
+        level: string;
+        status: string;
+        parentId: string | null;
+        ownerAgentId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[], {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        squadId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "squad_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        level: import("drizzle-orm/pg-core").PgColumn<{
+            name: "level";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        parentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "parent_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        ownerAgentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "owner_agent_id";
+            tableName: "goals";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "goals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "goals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    }>, "where">;
+    getById: (id: string) => Promise<{
+        id: string;
+        squadId: string;
+        title: string;
+        description: string | null;
+        level: string;
+        status: string;
+        parentId: string | null;
+        ownerAgentId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    getDefaultSquadGoal: (squadId: string) => Promise<{
+        id: string;
+        squadId: string;
+        title: string;
+        description: string | null;
+        level: string;
+        status: string;
+        parentId: string | null;
+        ownerAgentId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    create: (squadId: string, data: Omit<typeof goals.$inferInsert, "squadId">) => Promise<{
+        id: string;
+        description: string | null;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        squadId: string;
+        title: string;
+        ownerAgentId: string | null;
+        parentId: string | null;
+        level: string;
+    }>;
+    update: (id: string, data: Partial<typeof goals.$inferInsert>) => Promise<{
+        id: string;
+        squadId: string;
+        title: string;
+        description: string | null;
+        level: string;
+        status: string;
+        parentId: string | null;
+        ownerAgentId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    remove: (id: string) => Promise<{
+        id: string;
+        description: string | null;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        squadId: string;
+        title: string;
+        ownerAgentId: string | null;
+        parentId: string | null;
+        level: string;
+    }>;
+};
+export {};
+//# sourceMappingURL=goals.d.ts.map

package/dist/services/goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../src/services/goals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,KAAK,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AAErC,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;GAoCxE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,EAAE;oBAEd,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAER,MAAM;;;;;;;;;;;;mCAOW,MAAM;;;;;;;;;;;;sBAEnB,MAAM,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC;;;;;;;;;;;;iBAO7D,MAAM,QAAQ,OAAO,CAAC,OAAO,KAAK,CAAC,YAAY,CAAC;;;;;;;;;;;;iBAQhD,MAAM;;;;;;;;;;;;EAOtB"}

package/dist/services/goals.js

@@ -0,0 +1,54 @@
+import { and, asc, eq, isNull } from "drizzle-orm";
+import { goals } from "@slaw-ai/db";
+export async function getDefaultSquadGoal(db, squadId) {
+    const activeRootGoal = await db
+        .select()
+        .from(goals)
+        .where(and(eq(goals.squadId, squadId), eq(goals.level, "squad"), eq(goals.status, "active"), isNull(goals.parentId)))
+        .orderBy(asc(goals.createdAt))
+        .then((rows) => rows[0] ?? null);
+    if (activeRootGoal)
+        return activeRootGoal;
+    const anyRootGoal = await db
+        .select()
+        .from(goals)
+        .where(and(eq(goals.squadId, squadId), eq(goals.level, "squad"), isNull(goals.parentId)))
+        .orderBy(asc(goals.createdAt))
+        .then((rows) => rows[0] ?? null);
+    if (anyRootGoal)
+        return anyRootGoal;
+    return db
+        .select()
+        .from(goals)
+        .where(and(eq(goals.squadId, squadId), eq(goals.level, "squad")))
+        .orderBy(asc(goals.createdAt))
+        .then((rows) => rows[0] ?? null);
+}
+export function goalService(db) {
+    return {
+        list: (squadId) => db.select().from(goals).where(eq(goals.squadId, squadId)),
+        getById: (id) => db
+            .select()
+            .from(goals)
+            .where(eq(goals.id, id))
+            .then((rows) => rows[0] ?? null),
+        getDefaultSquadGoal: (squadId) => getDefaultSquadGoal(db, squadId),
+        create: (squadId, data) => db
+            .insert(goals)
+            .values({ ...data, squadId })
+            .returning()
+            .then((rows) => rows[0]),
+        update: (id, data) => db
+            .update(goals)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(goals.id, id))
+            .returning()
+            .then((rows) => rows[0] ?? null),
+        remove: (id) => db
+            .delete(goals)
+            .where(eq(goals.id, id))
+            .returning()
+            .then((rows) => rows[0] ?? null),
+    };
+}
+//# sourceMappingURL=goals.js.map

package/dist/services/goals.js.map

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

package/dist/services/heartbeat-circuit-breaker.d.ts

@@ -0,0 +1,89 @@
+/**
+ * F1 — Instance-wide heartbeat circuit breaker.
+ *
+ * Problem this solves: when the shared Claude account hits a usage / rate /
+ * overload limit, every agent's heartbeat fails with the SAME systemic error.
+ * The old behaviour retried each run independently on a 2m/10m/30m/2h backoff
+ * while the 30s scheduler kept spawning fresh chains — so a single account-level
+ * limit produced hundreds of failing runs and burned quota for days (see
+ * DESIGN-reliability-and-cost-control.md, RC-1).
+ *
+ * The breaker is an INSTANCE-level gate. When a shared-account-exhaustion error
+ * is observed, it "opens" until a computed resume time, and while open the
+ * scheduler skips ALL automation wakeups (logging once, not once-per-agent).
+ * A separate failure-rate backstop trips the breaker even if classification is
+ * wrong, so no future misclassification can reproduce the runaway.
+ *
+ * State is process-local and intentionally simple: the scheduler runs in a
+ * single server process, and the breaker only needs to survive between ticks.
+ * It is reset on restart (a restart already implies a human is present).
+ */
+/** Default cool-off when the upstream gives no explicit reset hint. */
+export declare const CIRCUIT_BREAKER_DEFAULT_COOLOFF_MS: number;
+/** Cap on any single open window, so a bogus reset hint can't park us for days. */
+export declare const CIRCUIT_BREAKER_MAX_COOLOFF_MS: number;
+/**
+ * Failure-rate backstop: if this many heartbeat runs fail inside the rolling
+ * window — regardless of error classification — trip the breaker anyway.
+ */
+export declare const CIRCUIT_BREAKER_FAILURE_THRESHOLD = 8;
+export declare const CIRCUIT_BREAKER_FAILURE_WINDOW_MS: number;
+export type CircuitBreakerTripReason = "shared_account_exhaustion" | "failure_rate_backstop";
+export interface CircuitBreakerState {
+    openUntil: Date | null;
+    reason: CircuitBreakerTripReason | null;
+    /** Human-readable detail for the UI banner / logs. */
+    detail: string | null;
+    trippedAt: Date | null;
+}
+export declare function isSharedAccountExhaustion(input: {
+    errorFamily?: string | null;
+    errorCode?: string | null;
+}): boolean;
+/**
+ * Clamp a resume hint into a sane window. `resetHint` is the upstream's
+ * "resets at <time>" if we parsed one; otherwise we fall back to the default
+ * cool-off. Either way we never park longer than the max.
+ */
+export declare function computeOpenUntil(now: Date, resetHint: Date | null): Date;
+/**
+ * The breaker instance. One per server process; created in the heartbeat
+ * service and shared by the scheduler gate and the failure-recording path.
+ */
+export declare class HeartbeatCircuitBreaker {
+    private openUntil;
+    private reason;
+    private detail;
+    private trippedAt;
+    private failures;
+    /** Is the breaker open (scheduler should skip automation wakeups)? */
+    isOpen(now?: Date): boolean;
+    state(): CircuitBreakerState;
+    /** Force the breaker open until `until` for an explicit reason. */
+    trip(input: {
+        now?: Date;
+        until: Date;
+        reason: CircuitBreakerTripReason;
+        detail?: string | null;
+    }): void;
+    reset(): void;
+    /**
+     * Record a failed heartbeat run. Returns whether the breaker tripped as a
+     * result (so the caller can log a single line). Two paths:
+     *  1. shared-account exhaustion → open immediately using the reset hint.
+     *  2. otherwise → count toward the failure-rate backstop.
+     */
+    recordFailure(input: {
+        now?: Date;
+        errorFamily?: string | null;
+        errorCode?: string | null;
+        resetHint?: Date | null;
+        detail?: string | null;
+    }): {
+        tripped: boolean;
+        reason: CircuitBreakerTripReason | null;
+    };
+    /** A successful run is evidence the upstream is healthy; clear backstop count. */
+    recordSuccess(): void;
+}
+//# sourceMappingURL=heartbeat-circuit-breaker.d.ts.map

package/dist/services/heartbeat-circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/services/heartbeat-circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,uEAAuE;AACvE,eAAO,MAAM,kCAAkC,QAAgB,CAAC;AAChE,mFAAmF;AACnF,eAAO,MAAM,8BAA8B,QAAiB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,iCAAiC,QAAiB,CAAC;AAEhE,MAAM,MAAM,wBAAwB,GAChC,2BAA2B,GAC3B,uBAAuB,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACxC,sDAAsD;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAoBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,OAAO,CAQV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,IAAI,EACT,SAAS,EAAE,IAAI,GAAG,IAAI,GACrB,IAAI,CAON;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAqB;IAErC,sEAAsE;IACtE,MAAM,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO;IAUvC,KAAK,IAAI,mBAAmB;IAS5B,mEAAmE;IACnE,IAAI,CAAC,KAAK,EAAE;QACV,GAAG,CAAC,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,IAAI,CAAC;QACZ,MAAM,EAAE,wBAAwB,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI;IAYR,KAAK,IAAI,IAAI;IAQb;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE;QACnB,GAAG,CAAC,EAAE,IAAI,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAA;KAAE;IAwCjE,kFAAkF;IAClF,aAAa,IAAI,IAAI;CAGtB"}