lorenz 0.1.0

package/extensions/local-tracker/dist/tools.js

@@ -0,0 +1,170 @@
+import { errorMessage, isRecord } from "@lorenz/domain";
+import { applyQuery, parseQuerySpec, parseSelect, pickFields, toolFailure, toolSuccess, unsupportedToolFailure, } from "@lorenz/tool-sdk";
+import { BoardStore } from "./boardStore.js";
+import { localToolPackOptions, validateLocalToolOptions } from "./options.js";
+import { resolveBoardDir } from "./resolveBoardDir.js";
+const TOOL_NAMES = [
+    "local_update_status",
+    "local_comment",
+    "local_create_issue",
+    "local_read_issue",
+    "local_query",
+];
+/** Default projection for `local_query` when `select` is omitted. */
+const DEFAULT_LOCAL_SELECT = ["id", "title", "state", "stateType", "labels"];
+export function localToolSpecs() {
+    return [
+        {
+            name: "local_update_status",
+            description: "Move a local board issue to a new status. Args: issueId, status.",
+            inputSchema: {
+                type: "object",
+                properties: { issueId: { type: "string" }, status: { type: "string" } },
+                required: ["issueId", "status"],
+            },
+        },
+        {
+            name: "local_comment",
+            description: "Append a comment to a local board issue. Args: issueId, body.",
+            inputSchema: {
+                type: "object",
+                properties: { issueId: { type: "string" }, body: { type: "string" } },
+                required: ["issueId", "body"],
+            },
+        },
+        {
+            name: "local_create_issue",
+            description: "Create a new local board issue. Args: title, body?, status?.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    title: { type: "string" },
+                    body: { type: "string" },
+                    status: { type: "string" },
+                },
+                required: ["title"],
+            },
+        },
+        {
+            name: "local_read_issue",
+            description: "Read a local board issue: its current status, title, description, and comments.",
+            inputSchema: {
+                type: "object",
+                properties: { issueId: { type: "string" } },
+                required: ["issueId"],
+            },
+        },
+        {
+            name: "local_query",
+            description: "Query local board issues (read-only). Filter with a JSON predicate DSL, project fields, " +
+                "order, and page. Row fields: id, identifier, title, description, state, stateType, labels, " +
+                "createdAt, updatedAt; add 'comments' to select to include each issue's comment lines. " +
+                "Args: where? (filter), select? (string[]), order_by? ([{field,dir}]), limit?, offset?.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    where: { type: "object" },
+                    select: { type: "array", items: { type: "string" } },
+                    order_by: { type: "array", items: { type: "object" } },
+                    limit: { type: "number" },
+                    offset: { type: "number" },
+                },
+            },
+        },
+    ];
+}
+export async function executeLocalTool(name, input, settings) {
+    const store = storeFor(settings);
+    const args = isRecord(input) ? input : {};
+    try {
+        switch (name) {
+            case "local_update_status": {
+                const issue = await store.updateStatus(requireStr(args, "issueId"), requireStr(args, "status"));
+                return toolSuccess({ issue });
+            }
+            case "local_comment": {
+                await store.appendComment(requireStr(args, "issueId"), requireStr(args, "body"));
+                return toolSuccess({ ok: true });
+            }
+            case "local_create_issue": {
+                const body = optStr(args.body);
+                const status = optStr(args.status);
+                const issue = await store.create({
+                    title: requireStr(args, "title"),
+                    ...(body !== undefined ? { body } : {}),
+                    ...(status !== undefined ? { status } : {}),
+                });
+                return toolSuccess({ issue });
+            }
+            case "local_read_issue": {
+                const { id, status, title, description, comments } = await store.readContent(requireStr(args, "issueId"));
+                return toolSuccess({ issue: { id, status, title, description }, comments });
+            }
+            case "local_query": {
+                const spec = parseQuerySpec(args);
+                const select = parseSelect(args.select) ?? DEFAULT_LOCAL_SELECT;
+                // Surface malformed board files instead of hiding them; a query never throws on a bad file.
+                const skipped = [];
+                const queryStore = storeFor(settings, {
+                    onSkip: ({ id, error }) => skipped.push({ id, error }),
+                });
+                const records = (await queryStore.list()).map(toLocalRecord);
+                const { rows, total } = applyQuery(records, spec);
+                const includeComments = select.includes("comments");
+                const out = [];
+                for (const row of rows) {
+                    const projected = pickFields(row, select);
+                    // `comments` is not on the base record (it costs an extra read); fetch it only when asked.
+                    if (includeComments) {
+                        projected.comments = (await queryStore.readContent(String(row.id))).comments;
+                    }
+                    out.push(projected);
+                }
+                return toolSuccess({ rows: out, total, skipped });
+            }
+            default:
+                return unsupportedToolFailure(name, TOOL_NAMES);
+        }
+    }
+    catch (error) {
+        return toolFailure(errorMessage(error));
+    }
+}
+/** The local board tool pack: read and write `<prefix><n>.md` issues in the board directory. */
+export const localToolProvider = {
+    name: "local",
+    validateOptions: (options) => validateLocalToolOptions(options),
+    toolSpecs: () => localToolSpecs(),
+    executeTool: async (name, input, context) => executeLocalTool(name, input, context.settings),
+};
+function storeFor(settings, options = {}) {
+    const { path: boardPath, idPrefix } = localToolPackOptions(settings);
+    return new BoardStore(resolveBoardDir(boardPath), {
+        ...(idPrefix !== undefined ? { idPrefix } : {}),
+        ...options,
+    });
+}
+/** Flat, filterable view of a board issue for `local_query` (comments are fetched on demand). */
+function toLocalRecord(issue) {
+    return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? null,
+        state: issue.state,
+        stateType: issue.stateType,
+        labels: issue.labels,
+        createdAt: issue.createdAt ?? null,
+        updatedAt: issue.updatedAt ?? null,
+    };
+}
+function requireStr(args, key) {
+    const value = args[key];
+    if (typeof value !== "string" || value.trim() === "")
+        throw new Error(`'${key}' is required`);
+    return value;
+}
+function optStr(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+//# sourceMappingURL=tools.js.map

package/extensions/local-tracker/dist/tools.js.map

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

package/extensions/local-tracker/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@lorenz/local-tracker",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "file:../../packages/domain",
+    "@lorenz/issue": "file:../../packages/issue",
+    "@lorenz/tool-sdk": "file:../../packages/tool-sdk",
+    "@lorenz/tracker-sdk": "file:../../packages/tracker-sdk",
+    "yaml": "^2.8.0"
+  }
+}

package/extensions/memory-tracker/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { type TrackerProvider, type TrackerRegistry } from "@lorenz/tracker-sdk";
+import { type Issue, type RuntimeTrackerClient } from "@lorenz/domain";
+export declare class MemoryTrackerClient implements RuntimeTrackerClient {
+    private readonly issues;
+    constructor(issues?: Array<Issue | Record<string, unknown>>);
+    fetchCandidateIssues(): Promise<Issue[]>;
+    fetchIssuesByIds(ids: string[]): Promise<Issue[]>;
+    updateIssue(id: string, fields: Partial<Pick<Issue, "state" | "stateType">>): void;
+    fetchIssuesByStates(states: string[]): Promise<Issue[]>;
+}
+export declare function memoryIssuesFromEnv(env?: NodeJS.ProcessEnv): Record<string, unknown>[];
+/**
+ * In-process tracker fixture: issues come from `SYMPHONY_MEMORY_TRACKER_ISSUES_JSON`.
+ * Used by tests and sandboxes; exposes no agent tools.
+ */
+export declare const memoryTrackerProvider: TrackerProvider;
+/**
+ * Register this extension's tracker provider. Idempotent; called by the composition root
+ * (or a test) against its registry, defaulting to the process-wide one.
+ */
+export declare function registerMemoryTracker(registries?: {
+    trackers?: TrackerRegistry;
+}): void;
+//# sourceMappingURL=index.d.ts.map

package/extensions/memory-tracker/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,KAAK,EAEV,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,MAAM,GAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAMzD,oBAAoB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIxC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAWvD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI;IAO5E,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAM9D;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAU3B;AAoDD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,eASnC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,GAAE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAO,GAAG,IAAI,CAK3F"}

package/extensions/memory-tracker/dist/index.js

@@ -0,0 +1,110 @@
+import { normalizeIssue } from "@lorenz/issue";
+import { defaultTrackerRegistry, rejectUnknownOptions, } from "@lorenz/tracker-sdk";
+import { ISSUE_STATE_TYPES, isRecord, } from "@lorenz/domain";
+export class MemoryTrackerClient {
+    issues;
+    constructor(issues = []) {
+        this.issues = issues.map((issue) => isIssue(issue) ? cloneIssue(issue) : normalizeIssue(issue));
+    }
+    async fetchCandidateIssues() {
+        return Promise.resolve(this.issues.map(cloneIssue));
+    }
+    async fetchIssuesByIds(ids) {
+        const wanted = new Set(ids);
+        // Workspace cleanup looks issues up by identifier (directory name); mirror the
+        // Jira and Linear clients, which accept both ids and identifiers.
+        return Promise.resolve(this.issues
+            .filter((issue) => wanted.has(issue.id) || wanted.has(issue.identifier))
+            .map(cloneIssue));
+    }
+    updateIssue(id, fields) {
+        const issue = this.issues.find((i) => i.id === id);
+        if (!issue)
+            return;
+        if (fields.state !== undefined)
+            issue.state = fields.state;
+        if (fields.stateType !== undefined)
+            issue.stateType = fields.stateType;
+    }
+    async fetchIssuesByStates(states) {
+        const wanted = new Set(states.map(normalizeState));
+        return Promise.resolve(this.issues.filter((issue) => wanted.has(normalizeState(issue.state))).map(cloneIssue));
+    }
+}
+export function memoryIssuesFromEnv(env = process.env) {
+    const json = env.SYMPHONY_MEMORY_TRACKER_ISSUES_JSON ?? env.SYMPHONY_MEMORY_TRACKER_ISSUES;
+    if (!json || json.trim() === "")
+        return [];
+    const parsed = JSON.parse(json);
+    if (!Array.isArray(parsed))
+        throw new Error("SYMPHONY_MEMORY_TRACKER_ISSUES_JSON must be a JSON array");
+    return parsed.map((entry, index) => {
+        if (!isRecord(entry))
+            throw new Error(`memory tracker issue ${index} must be an object`);
+        return entry;
+    });
+}
+function cloneIssue(issue) {
+    return {
+        ...issue,
+        labels: [...issue.labels],
+        blockers: issue.blockers.map((blocker) => ({ ...blocker })),
+    };
+}
+function isIssue(value) {
+    return (isRecord(value) &&
+        typeof value.id === "string" &&
+        typeof value.identifier === "string" &&
+        typeof value.title === "string" &&
+        typeof value.state === "string" &&
+        typeof value.stateType === "string" &&
+        isIssueStateType(value.stateType) &&
+        Array.isArray(value.labels) &&
+        value.labels.every((label) => typeof label === "string") &&
+        Array.isArray(value.blockers) &&
+        value.blockers.every(isIssueRef));
+}
+function isIssueRef(value) {
+    return (isRecord(value) &&
+        isOptionalString(value.id) &&
+        isOptionalString(value.identifier) &&
+        isOptionalString(value.state) &&
+        isOptionalIssueStateType(value.stateType));
+}
+function isOptionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+function isOptionalIssueStateType(value) {
+    return value === undefined || value === null || isIssueStateType(value);
+}
+function isIssueStateType(value) {
+    return typeof value === "string" && ISSUE_STATE_TYPES.includes(value);
+}
+function normalizeState(value) {
+    return value.trim().toLowerCase();
+}
+/**
+ * In-process tracker fixture: issues come from `SYMPHONY_MEMORY_TRACKER_ISSUES_JSON`.
+ * Used by tests and sandboxes; exposes no agent tools.
+ */
+export const memoryTrackerProvider = {
+    kind: "memory",
+    parseOptions(options) {
+        rejectUnknownOptions(options, [], "memory");
+        return {};
+    },
+    createClient(_settings, context) {
+        return new MemoryTrackerClient(memoryIssuesFromEnv(context.env));
+    },
+};
+/**
+ * Register this extension's tracker provider. Idempotent; called by the composition root
+ * (or a test) against its registry, defaulting to the process-wide one.
+ */
+export function registerMemoryTracker(registries = {}) {
+    const trackers = registries.trackers ?? defaultTrackerRegistry;
+    if (trackers.get(memoryTrackerProvider.kind) === undefined) {
+        trackers.register(memoryTrackerProvider);
+    }
+}
+//# sourceMappingURL=index.js.map

package/extensions/memory-tracker/dist/index.js.map

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

package/extensions/memory-tracker/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@lorenz/memory-tracker",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "file:../../packages/domain",
+    "@lorenz/issue": "file:../../packages/issue",
+    "@lorenz/tracker-sdk": "file:../../packages/tracker-sdk"
+  }
+}

package/extensions/slack-tracker/dist/client.d.ts

@@ -0,0 +1,88 @@
+import type { Issue, IssueStateType, RuntimeTrackerClient, Settings } from "@lorenz/domain";
+import { type ThreadState } from "./threadState.js";
+import type { SlackChannelScan, SlackMessage, SlackTransport } from "./transport.js";
+export declare function splitIssueId(id: string): [string, string] | null;
+/**
+ * A flat, agent-facing view of a Slack issue derived from its source message. Shared by the
+ * read tooling (`slack_query`) and the runtime client so the two never drift on how a message
+ * maps to a title/state/labels.
+ */
+export interface SlackIssueRow {
+    /** `<channel>:<ts>` - the canonical Slack issue id (always the thread ROOT). */
+    issueId: string;
+    channel: string;
+    ts: string;
+    /** First line of the request with the leading bot mention stripped (falls back to the ts). */
+    title: string;
+    /** Workflow state: thread-derived when known, else reaction-derived, else "Todo". */
+    state: string;
+    stateType: IssueStateType;
+    labels: string[];
+    /** Full root message text. */
+    text: string;
+    reactions: string[];
+    /** Permalink to the source message, when the workspace URL is known. */
+    url?: string | undefined;
+}
+/** Context a caller already resolved for the row: permalink base and thread-derived state. */
+export interface SlackIssueContext {
+    permalinkBase?: string | null | undefined;
+    /** Thread-derived state; when omitted the row falls back to the reaction-derived reading. */
+    state?: string | undefined;
+    /** The request reply for threads whose root does not mention the bot. */
+    request?: ThreadState["request"];
+}
+/**
+ * Permalink to a message: `<workspace base>/archives/<channel>/p<ts without the dot>` - the
+ * same shape Slack's own "copy link" produces.
+ */
+export declare function slackPermalink(base: string, channel: string, ts: string): string;
+/**
+ * Map a Slack root message onto the flat {@link SlackIssueRow} view. Pure; performs no IO -
+ * thread-derived state and the workspace base URL come in via {@link SlackIssueContext}.
+ */
+export declare function slackMessageToRow(message: SlackMessage, settings: Settings, context?: SlackIssueContext): SlackIssueRow;
+/**
+ * Map a Slack root message onto a normalized tracker {@link Issue}. Shared by the runtime
+ * client and the tracker tool operations so candidate discovery and agent tools never drift on
+ * how a message becomes an issue. The identifier keeps the channel: Slack ts values are only
+ * unique per channel, and workspace directories and cleanup are keyed by identifier downstream.
+ */
+export declare function slackMessageToIssue(message: SlackMessage, settings: Settings, context?: SlackIssueContext): Issue;
+/**
+ * Tracked roots of one scan: every bot-mention root, plus every threaded root the bot has
+ * marked with its own reaction (reply-tracked issues recognized across restarts without
+ * re-reading their threads).
+ */
+export declare function trackedRootsOf(scan: SlackChannelScan): SlackMessage[];
+export declare class SlackTrackerClient implements RuntimeTrackerClient {
+    private readonly settings;
+    private readonly transport;
+    private scanCache;
+    /** Last state the reaction mirror was reconciled to, per issue (see healStatusMirror). */
+    private readonly mirroredStates;
+    /**
+     * Oldest thread activity (epoch seconds) considered when hunting for NEW reply-mention
+     * requests in untracked threads. Once tracked, a thread is marked with the bot's reaction
+     * and recognized regardless of age; the floor only bounds first discovery, so a reply
+     * mention posted while the daemon was down longer than the lookback is not picked up.
+     */
+    private readonly replyFloor;
+    constructor(settings: Settings, transport: SlackTransport);
+    fetchCandidateIssues(): Promise<Issue[]>;
+    fetchIssuesByIds(ids: string[]): Promise<Issue[]>;
+    fetchIssuesByStates(states: string[]): Promise<Issue[]>;
+    private trackedIssues;
+    /**
+     * Self-healing reaction mirror: when a HUMAN transitions status (`@bot !done`, a bare
+     * re-mention re-open), the bot's reaction still shows the previous state until the bot acts
+     * again. Reconcile the mirror to the thread-derived state during the poll, attempted once
+     * per state change per issue - a stale HUMAN-authored reaction is not removable by the bot
+     * (reactions are per-author), so retrying every poll would only churn the API.
+     */
+    private healStatusMirror;
+    private scanCached;
+    private channels;
+    private markerEmoji;
+}
+//# sourceMappingURL=client.d.ts.map

package/extensions/slack-tracker/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU5F,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAIhE;AA2BD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yEAAyE;IACzE,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CA0Bf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,iBAAsB,GAC9B,KAAK,CAkBP;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAErE;AAYD,qBAAa,kBAAmB,YAAW,oBAAoB;IAa3D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,SAAS,CAAoE;IACrF,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc;IAOtC,oBAAoB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIxC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA2BjD,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAM/C,aAAa;IAiC3B;;;;;;OAMG;YACW,gBAAgB;YAehB,UAAU;IAexB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;CAGpB"}