@sema-ai/core 1.275.1

package/dist/orchestration/workflow-meta.js

@@ -0,0 +1,426 @@
+/**
+ * design/98 §2.4 (S8b) — STATIC, NON-EVAL extraction of a workflow script's `export const meta = {...}`.
+ *
+ * 🔴 The meta block is parsed as PURE DATA by a small recursive-descent reader that NEVER executes the
+ * script (no `vm`, no `eval`, no `Function`) — evaluating untrusted source to read its metadata would itself
+ * be the injection surface. The reader accepts ONLY literal values (string / number / boolean / null / array
+ * / plain object) and REJECTS anything that could carry behavior or pollute a prototype:
+ *   - identifier values (a variable reference), function calls, template literals, spreads, computed keys,
+ *     method shorthand, getters/setters;
+ *   - the dangerous keys `__proto__` / `constructor` / `prototype` (prototype-pollution guard).
+ * Any violation throws {@link WorkflowScriptError} so the `run_workflow` tool can hand the LLM a structured
+ * "fix your meta" error BEFORE the (hard) sandbox ever runs the body.
+ */
+/** Thrown when an LLM-authored workflow script is malformed at the static layer (bad meta, oversized source,
+ *  a forbidden construct). Carries a `code` so the tool can return a structured error the model can act on. */
+export class WorkflowScriptError extends Error {
+    code = "workflow.script_error";
+    constructor(message) {
+        super(message);
+        this.name = "WorkflowScriptError";
+    }
+}
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+// ── Locate `export const meta = { ... }` and slice the balanced object text ──────────────────────────────
+/**
+ * Find `export const meta =` and return the span of its object literal: the object text, the index where the
+ * `export const meta` declaration STARTS, and the index just past the object's closing `}`. Brace-balances
+ * while tracking string/template/comment state so a `{` inside a string or comment does not miscount.
+ */
+function sliceMetaObject(source) {
+    // Match `export const meta` then `=` (tolerate whitespace), landing just before the value.
+    const decl = /export\s+const\s+meta\s*=\s*/.exec(source);
+    if (!decl) {
+        throw new WorkflowScriptError("workflow script must declare `export const meta = { name, description }`");
+    }
+    let i = decl.index + decl[0].length;
+    if (source[i] !== "{") {
+        throw new WorkflowScriptError("`export const meta` must be assigned a literal object `{ ... }`");
+    }
+    const start = i;
+    let depth = 0;
+    for (; i < source.length; i++) {
+        const c = source[i];
+        if (c === '"' || c === "'" || c === "`") {
+            i = skipString(source, i, c);
+            continue;
+        }
+        if (c === "/" && source[i + 1] === "/") {
+            i = source.indexOf("\n", i);
+            if (i === -1)
+                i = source.length;
+            continue;
+        }
+        if (c === "/" && source[i + 1] === "*") {
+            const end = source.indexOf("*/", i + 2);
+            i = end === -1 ? source.length : end + 1;
+            continue;
+        }
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return { objText: source.slice(start, i + 1), declStart: decl.index, objEnd: i + 1 };
+        }
+    }
+    throw new WorkflowScriptError("`export const meta` object literal is not closed (unbalanced braces)");
+}
+/** Skip a string/template starting at `start` (the opening quote). Returns the index of the closing quote.
+ *  A template literal containing `${` is rejected at parse time; here we only need to balance it for slicing. */
+function skipString(source, start, quote) {
+    for (let i = start + 1; i < source.length; i++) {
+        const c = source[i];
+        if (c === "\\") {
+            i++;
+            continue;
+        }
+        if (c === quote)
+            return i;
+    }
+    throw new WorkflowScriptError("unterminated string literal in `meta`");
+}
+function tokenize(src) {
+    const toks = [];
+    let i = 0;
+    while (i < src.length) {
+        const c = src[i];
+        if (c === " " || c === "\t" || c === "\n" || c === "\r") {
+            i++;
+            continue;
+        }
+        if (c === "/" && src[i + 1] === "/") {
+            i = src.indexOf("\n", i);
+            if (i === -1)
+                i = src.length;
+            continue;
+        }
+        if (c === "/" && src[i + 1] === "*") {
+            const end = src.indexOf("*/", i + 2);
+            i = end === -1 ? src.length : end + 2;
+            continue;
+        }
+        if (c === "{" || c === "}" || c === "[" || c === "]" || c === ":" || c === ",") {
+            toks.push({ t: c });
+            i++;
+            continue;
+        }
+        if (c === "`") {
+            // Template literal — rejected as a value (could carry interpolation). Surface a clear error.
+            throw new WorkflowScriptError("`meta` may not contain template literals — use a plain string");
+        }
+        if (c === '"' || c === "'") {
+            const end = skipString(src, i, c);
+            toks.push({ t: "str", v: decodeStringLiteral(src.slice(i, end + 1)) });
+            i = end + 1;
+            continue;
+        }
+        if (c === "-" || (c >= "0" && c <= "9")) {
+            const m = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/.exec(src.slice(i));
+            if (!m)
+                throw new WorkflowScriptError("invalid number literal in `meta`");
+            toks.push({ t: "num", v: Number(m[0]) });
+            i += m[0].length;
+            continue;
+        }
+        // Identifier (a bare key, or one of the literals true/false/null). Also catches a `.`/`(`/`...` start,
+        // which is NOT a valid identifier char → falls through to the error below (rejects calls/spreads).
+        const im = /^[A-Za-z_$][A-Za-z0-9_$]*/.exec(src.slice(i));
+        if (!im) {
+            throw new WorkflowScriptError(`unexpected character in \`meta\`: ${JSON.stringify(c)} (only literal values are allowed)`);
+        }
+        toks.push({ t: "ident", v: im[0] });
+        i += im[0].length;
+    }
+    return toks;
+}
+/** Decode a quoted string literal (single or double) to its value — handles the common JS escapes. */
+function decodeStringLiteral(raw) {
+    const body = raw.slice(1, -1);
+    return body.replace(/\\(u\{[0-9a-fA-F]+\}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{2}|[\s\S])/g, (_m, esc) => {
+        switch (esc[0]) {
+            case "n": return "\n";
+            case "t": return "\t";
+            case "r": return "\r";
+            case "b": return "\b";
+            case "f": return "\f";
+            case "v": return "\v";
+            case "0": return "\0";
+            case "x": return String.fromCodePoint(parseInt(esc.slice(1), 16));
+            case "u":
+                return esc[1] === "{"
+                    ? String.fromCodePoint(parseInt(esc.slice(2, -1), 16))
+                    : String.fromCodePoint(parseInt(esc.slice(1), 16));
+            default: return esc; // \\ \" \' \` \/ and any other escaped char → the char itself
+        }
+    });
+}
+// ── Recursive-descent parser (literal data only) ────────────────────────────────────────────────────────
+/** Max object/array nesting in a `meta` literal — a real meta is shallow; this bounds the recursive-descent
+ *  parser so deeply-nested input throws a structured {@link WorkflowScriptError} (the documented contract)
+ *  instead of a raw `RangeError: Maximum call stack size exceeded` (workflow review, caps/meta-ast). */
+const MAX_META_DEPTH = 64;
+function parseTokens(toks) {
+    let p = 0;
+    let depth = 0;
+    const peek = () => toks[p];
+    const next = () => {
+        const t = toks[p++];
+        if (!t)
+            throw new WorkflowScriptError("unexpected end of `meta` object");
+        return t;
+    };
+    const parseValue = () => {
+        const t = next();
+        switch (t.t) {
+            case "{": return parseObject();
+            case "[": return parseArray();
+            case "str": return t.v;
+            case "num": return t.v;
+            case "ident":
+                if (t.v === "true")
+                    return true;
+                if (t.v === "false")
+                    return false;
+                if (t.v === "null")
+                    return null;
+                // identifier value = a variable reference (or `undefined`/a call's callee) → forbidden.
+                throw new WorkflowScriptError(`\`meta\` may only contain literal values — \`${t.v}\` is an identifier reference (not allowed)`);
+            default:
+                throw new WorkflowScriptError(`unexpected token "${t.t}" while reading a \`meta\` value`);
+        }
+    };
+    const parseObject = () => {
+        depth++;
+        try {
+            // codex final council FIX-1: the check is INSIDE the try so the over-depth throw still hits `finally`
+            // and the increment stays balanced (no +1 counter drift on the throw path).
+            if (depth > MAX_META_DEPTH)
+                throw new WorkflowScriptError(`\`meta\` nests too deeply (max ${MAX_META_DEPTH})`);
+            return parseObjectBody();
+        }
+        finally {
+            depth--;
+        }
+    };
+    const parseObjectBody = () => {
+        const obj = {};
+        if (peek()?.t === "}") {
+            p++;
+            return obj;
+        }
+        for (;;) {
+            const keyTok = next();
+            let key;
+            if (keyTok.t === "ident")
+                key = keyTok.v;
+            else if (keyTok.t === "str")
+                key = keyTok.v;
+            else if (keyTok.t === "[") {
+                throw new WorkflowScriptError("`meta` may not use computed keys `[ ... ]`");
+            }
+            else {
+                throw new WorkflowScriptError(`invalid \`meta\` object key (token "${keyTok.t}")`);
+            }
+            if (FORBIDDEN_KEYS.has(key)) {
+                throw new WorkflowScriptError(`forbidden key in \`meta\`: ${JSON.stringify(key)}`);
+            }
+            const sep = next();
+            if (sep.t !== ":") {
+                // A method shorthand `foo() {}`, getter `get x() {}`, or value shorthand `{ x }` all land here
+                // (the token after the key is not `:`). Reject uniformly — meta must be explicit `key: literal`.
+                throw new WorkflowScriptError(`\`meta\` keys must be \`key: value\` literals (no shorthand / methods / getters) — near "${key}"`);
+            }
+            const value = parseValue();
+            // Assign without touching the prototype chain (key is already not __proto__/constructor/prototype).
+            Object.defineProperty(obj, key, { value, enumerable: true, writable: true, configurable: true });
+            const after = next();
+            if (after.t === "}")
+                return obj;
+            if (after.t !== ",")
+                throw new WorkflowScriptError('expected "," or "}" in `meta` object');
+            if (peek()?.t === "}") {
+                p++;
+                return obj; // trailing comma
+            }
+        }
+    };
+    const parseArray = () => {
+        depth++;
+        try {
+            if (depth > MAX_META_DEPTH)
+                throw new WorkflowScriptError(`\`meta\` nests too deeply (max ${MAX_META_DEPTH})`);
+            return parseArrayBody();
+        }
+        finally {
+            depth--;
+        }
+    };
+    const parseArrayBody = () => {
+        const arr = [];
+        if (peek()?.t === "]") {
+            p++;
+            return arr;
+        }
+        for (;;) {
+            arr.push(parseValue());
+            const after = next();
+            if (after.t === "]")
+                return arr;
+            if (after.t !== ",")
+                throw new WorkflowScriptError('expected "," or "]" in `meta` array');
+            if (peek()?.t === "]") {
+                p++;
+                return arr; // trailing comma
+            }
+        }
+    };
+    const root = parseValue();
+    if (p !== toks.length) {
+        throw new WorkflowScriptError("trailing tokens after the `meta` object literal");
+    }
+    return root;
+}
+// ── Public entry ────────────────────────────────────────────────────────────────────────────────────────
+/**
+ * Statically extract + validate a workflow script's `export const meta`. Returns a typed {@link WorkflowMeta}
+ * (name + description required, both strings; `phases`/`whenToUse` optional). NEVER executes the script.
+ * @throws {WorkflowScriptError} on a missing/malformed/non-literal meta.
+ */
+export function parseWorkflowMeta(source) {
+    const { objText } = sliceMetaObject(source);
+    const data = parseTokens(tokenize(objText));
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new WorkflowScriptError("`meta` must be an object literal");
+    }
+    const m = data;
+    if (typeof m.name !== "string" || m.name.length === 0) {
+        throw new WorkflowScriptError("`meta.name` is required and must be a non-empty string");
+    }
+    if (typeof m.description !== "string" || m.description.length === 0) {
+        throw new WorkflowScriptError("`meta.description` is required and must be a non-empty string");
+    }
+    const meta = { name: m.name, description: m.description };
+    if (m.whenToUse !== undefined) {
+        if (typeof m.whenToUse !== "string")
+            throw new WorkflowScriptError("`meta.whenToUse` must be a string");
+        meta.whenToUse = m.whenToUse;
+    }
+    if (m.phases !== undefined) {
+        if (!Array.isArray(m.phases))
+            throw new WorkflowScriptError("`meta.phases` must be an array");
+        meta.phases = m.phases.map((ph, idx) => {
+            if (typeof ph !== "object" || ph === null || Array.isArray(ph)) {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}]\` must be an object`);
+            }
+            const phase = ph;
+            if (typeof phase.title !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].title\` must be a string`);
+            }
+            if (phase.detail !== undefined && typeof phase.detail !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].detail\` must be a string`);
+            }
+            // B7 (CC card pretty.js:448042): `model` is a documented phase-entry key — previously silently
+            // dropped here; now parsed + stored (display-only on the pre-registered phase).
+            if (phase.model !== undefined && typeof phase.model !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].model\` must be a string`);
+            }
+            return {
+                title: phase.title,
+                ...(phase.detail !== undefined ? { detail: phase.detail } : {}),
+                ...(phase.model !== undefined ? { model: phase.model } : {}),
+            };
+        });
+    }
+    return meta;
+}
+// ── B2/F3 (PARITY-SPOT-WORKFLOW): static determinism check — CC `wxl` parity (pretty.js:446005) ─────────
+// CC walks a real AST; we have no parser dependency, so this lexes strings/comments OUT first (a prompt that
+// merely MENTIONS "Date.now()" must not trip it) and regexes the remaining code. Known limitation (documented,
+// accepted): a regex literal containing a quote/backtick can mis-lex the tail — the runtime shim (dev runner /
+// hard-runner conformance) is the backstop that always fires.
+/** Replace every string literal (incl. template text, recursing into `${…}` code) and comment with spaces. */
+export function stripStringsAndComments(src) {
+    let out = "";
+    let i = 0;
+    const n = src.length;
+    while (i < n) {
+        const c = src[i];
+        const d = i + 1 < n ? src[i + 1] : "";
+        if (c === "/" && d === "/") {
+            while (i < n && src[i] !== "\n")
+                i++;
+            continue;
+        }
+        if (c === "/" && d === "*") {
+            i += 2;
+            while (i < n && !(src[i] === "*" && src[i + 1] === "/"))
+                i++;
+            i += 2;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            i++;
+            while (i < n && src[i] !== c) {
+                if (src[i] === "\\")
+                    i++;
+                i++;
+            }
+            i++;
+            out += " ";
+            continue;
+        }
+        if (c === "`") {
+            i++;
+            while (i < n && src[i] !== "`") {
+                if (src[i] === "\\") {
+                    i += 2;
+                    continue;
+                }
+                if (src[i] === "$" && src[i + 1] === "{") {
+                    i += 2;
+                    let depth = 1;
+                    const start = i;
+                    while (i < n && depth > 0) {
+                        if (src[i] === "{")
+                            depth++;
+                        else if (src[i] === "}")
+                            depth--;
+                        if (depth > 0)
+                            i++;
+                    }
+                    out += ` ${stripStringsAndComments(src.slice(start, i))} `;
+                    i++;
+                    continue;
+                }
+                i++;
+            }
+            i++;
+            out += " ";
+            continue;
+        }
+        out += c;
+        i++;
+    }
+    return out;
+}
+/** CC `wxl` semantics: a `Date.now` / `Math.random` member access, or an ARGLESS `new Date()`, anywhere in the
+ *  body's CODE (strings/comments stripped) — each silently busts the resume prefix cache. */
+export function workflowScriptReadsClockOrRandom(body) {
+    const code = stripStringsAndComments(body);
+    return /\bDate\s*\.\s*now\b/.test(code) || /\bMath\s*\.\s*random\b/.test(code) || /\bnew\s+Date\s*\(\s*\)/.test(code);
+}
+/**
+ * Parse the meta AND return the script BODY with the `export const meta = {...}` declaration removed — for a
+ * runner that compiles the remaining body as an async function (the meta is DATA, parsed statically; only the
+ * body is ever executed). An optional trailing `;` after the declaration is trimmed.
+ */
+export function splitWorkflowMeta(source) {
+    const meta = parseWorkflowMeta(source);
+    const { declStart, objEnd } = sliceMetaObject(source);
+    let end = objEnd;
+    while (end < source.length && (source[end] === ";" || source[end] === " " || source[end] === "\t"))
+        end++;
+    return { meta, body: source.slice(0, declStart) + source.slice(end) };
+}
+//# sourceMappingURL=workflow-meta.js.map

package/dist/orchestration/workflow-meta.js.map

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

package/dist/orchestration/workflow-observe.d.ts

@@ -0,0 +1,77 @@
+import type { WorkflowRunStore, WorkflowRunSummary } from "../core/workflow-run-store.js";
+import type { WorkflowEvent, WorkflowItemStatus, WorkflowRun, WorkflowRunStatus } from "./workflow.js";
+/** design/97 S1c: mark a run RUNNING (called by `runWorkflow` before it emits `run_start`). */
+export declare function markWorkflowActive(runId: string): void;
+/** T2A-9 (2026-07-05 soak): is this runId currently ACTIVE in-process? Used by `startWorkflow` to reject an
+ *  explicit duplicate `opts.runId` up front — two runs sharing one observation channel let the first finisher
+ *  close the second's event stream (and best-effort-swallow its store writes). Synchronous, race-free with
+ *  markWorkflowActive/closeWorkflowChannel (same tick). */
+export declare function isWorkflowRunActive(runId: string): boolean;
+/**
+ * design/97 S1c: fan one {@link WorkflowEvent} to every live subscriber of `runId`. Called by `runWorkflow`
+ * for EVERY emitted event. BEST-EFFORT — a `push` never throws (the {@link PushQueue} just buffers), and a
+ * missing channel (no subscriber) is a no-op; nothing here can break the workflow. A subscriber that
+ * registered AFTER the run started receives only events from that point on (live progress, not a replay).
+ */
+export declare function publishWorkflowEvent(runId: string, event: WorkflowEvent): void;
+/**
+ * design/97 S1c: close the live channel for `runId` (called by `runWorkflow` at `run_end`). Closes every
+ * subscriber's queue so their `for await` loops END cleanly, and drops the channel entry (no leak). A
+ * subscriber's queue is also pruned individually if it stops iterating before the run ends (see
+ * {@link subscribeWorkflow}). Idempotent — closing a missing/already-closed channel is a no-op.
+ */
+export declare function closeWorkflowChannel(runId: string): void;
+/**
+ * design/97 S1c: subscribe to a RUNNING workflow's live {@link WorkflowEvent} progress (the `/workflows` live
+ * view). Returns an `AsyncIterable<WorkflowEvent>` that yields every event emitted AFTER subscription and ends
+ * when the run finishes (its channel closes at `run_end`). **In-process + opt-in**: subscribing registers a
+ * queue in the module registry; `runWorkflow` only fans events to a runId that HAS a subscriber, so this is
+ * pay-for-what-you-use.
+ *
+ * Subscribe BEFORE or DURING the run: a queue registered before `run_start` catches the whole stream; one
+ * registered mid-run catches the rest (no replay of past events — the historical view is {@link getWorkflowRun}).
+ * If the run already ended (or never ran in this process), the returned iterable simply yields nothing and ends.
+ *
+ * The queue is pruned from the registry when the consumer's iteration ENDS (loop completes, `break`, or throw)
+ * — so a consumer that stops early does not leak a buffer (the `finally` removes it).
+ */
+export declare function subscribeWorkflow(runId: string): AsyncIterable<WorkflowEvent>;
+/**
+ * design/97 S1c: list a scope's workflow runs (newest first) as lightweight {@link WorkflowRunSummary}
+ * projections — **history included** (completed / failed, not just running), the "看之前的" query. A thin
+ * pass-through to {@link WorkflowRunStore.listByScope}; `opts.status` filters to one lifecycle state and
+ * `opts.limit` caps the count (newest N).
+ */
+export declare function listWorkflowRuns(store: WorkflowRunStore, scope: string, opts?: {
+    status?: WorkflowRunStatus;
+    limit?: number;
+}): Promise<WorkflowRunSummary[]>;
+/**
+ * design/97 S1c: fetch ONE full {@link WorkflowRun} (phases / agents / stats) by id — the `/workflows` detail
+ * view. 🔐 SCOPED (CORE-1~9 audit BLOCKER): returns the run ONLY when its `scope` equals the caller's `scope`
+ * (the tenant) — else `null`, just like {@link listWorkflowRuns}/the journal load. A run id is unguessable, but
+ * without this check a cross-tenant id leaks the run's metadata / groups / redacted prompts+outputs / stats; the
+ * store's lower-level `get(id)` carries no scope, so the isolation MUST be enforced here at the observe layer.
+ */
+export declare function getWorkflowRun(store: WorkflowRunStore, id: string, scope: string): Promise<WorkflowRun | null>;
+/** design/99 MF-W display status. */
+export type AgentDisplayStatus = "queued" | "running" | "done" | "failed" | "interrupted";
+/**
+ * design/99 MF-W (design-review DoR ⑤+⑥): the SHARED, anti-drift projection of a workflow agent's record-level
+ * status → a CC-style display status, derived PURELY from the persisted record (the agent's `status` + `startedAt`
+ * + the run's status), so the shell + service render IDENTICALLY (no per-shell drift — the WPe port lives once,
+ * here, not copied N times). Covers 5 of the 8 contract states from the durable record:
+ *   - `completed` → `done`; `failed` → `failed`.
+ *   - `running` but `startedAt` ABSENT → `queued` (enqueued, still waiting for a concurrency slot — the DoR ⑥ fix:
+ *     a queued agent no longer lies as `running`).
+ *   - `running` + started, while the RUN still runs → `running`; started but the RUN terminated (the agent never
+ *     finished) → `interrupted`.
+ * The other contract states are intentionally NOT here: `idle` (last-activity age) is a SERVICE live aggregation
+ * (core's `ToolActivity` has no timestamp); `skipped`/`paused`/`stopped` are not core states (no engine producer —
+ * see the DoR "don't model an enum arm the engine never emits").
+ */
+export declare function deriveAgentDisplayStatus(agent: {
+    status: WorkflowItemStatus;
+    startedAt?: number;
+}, runStatus: WorkflowRunStatus): AgentDisplayStatus;
+//# sourceMappingURL=workflow-observe.d.ts.map

package/dist/orchestration/workflow-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-observe.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-observe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAyCvG,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;2DAG2D;AAC3D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAI9E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,aAAa,CAAC,CAiC7E;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGpH;AAED,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,iBAAiB,GAAG,kBAAkB,CASpJ"}