@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/tui/ack-prompt.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The acknowledgement prompt, as data. A flag (`needsAcknowledgement`) makes a call wait for a person
+ * even when the license would let it run. Three shapes:
+ *
+ *  - `ack`           the call is allowed; only the acknowledgement is asked.
+ *  - `ask+ack`       an ask, also flagged: one prompt, a human yes settles both.
+ *  - `soft-deny+ack` a soft-deny, also flagged: the soft-deny is never remembered, the ack may be.
+ *
+ * Pure: no job, no RPC. Tea feeds it the job's stamps and sends what the chords say.
+ */
+import type { AckOption, GrantSubject, MatchedAck } from "@inhuman.tools/harness-model";
+export type AckScope = "session" | "project" | "bot" | "global";
+export type AckVariant = "ack" | "ask+ack" | "soft-deny+ack";
+/** What a prompt-created ack lasts in the daemon (`ack/pending` storeOptions[].defaultTtlMs): session ends with the session. */
+export declare const ACK_PROMPT_TTL_DAYS = 7;
+export type AckChoice = {
+    readonly scope: AckScope;
+    readonly subject: GrantSubject;
+    readonly label: string;
+    /** "this session" or "7 days". */
+    readonly ttl: string;
+    /** "<label> · <scope> · <ttl>" (session scope drops the ttl), as the chord shows it. */
+    readonly text: string;
+};
+export type AckPromptModel = {
+    readonly variant: AckVariant;
+    /** "✉ Acknowledge · gmail · send_email" (ack-only) or "Also flagged · ..." (combined). */
+    readonly header: string;
+    /** Quoted `why` of each flag that gave one. */
+    readonly whys: readonly string[];
+    readonly copy: string;
+    readonly choices: readonly AckChoice[];
+};
+/** Each offered subject at each scope the session can store to. */
+export declare function ackChoices(options: readonly AckOption[], session: {
+    readonly bot: boolean;
+}): AckChoice[];
+export declare function ackVariant(input: {
+    readonly ackPending: boolean;
+    readonly policyResult: "policyApprove" | "ask" | "deny" | "block" | null;
+    /** `baseLicenseDetail.decision`: true when the license alone would let the call run. */
+    readonly baseDecision: boolean | null;
+}): AckVariant | null;
+export declare function ackPromptModel(input: {
+    readonly variant: AckVariant;
+    readonly flags: readonly MatchedAck[];
+    readonly options: readonly AckOption[];
+    readonly bot: boolean;
+}): AckPromptModel;
+/** The text the prompt pins over the box. */
+export declare function ackAnnotation(model: AckPromptModel): string;
+export declare function cycleAck(index: number, size: number, step: 1 | -1): number;
+//# sourceMappingURL=ack-prompt.d.ts.map

package/dist/tui/ack-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack-prompt.d.ts","sourceRoot":"","sources":["../../src/tui/ack-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAExF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,eAAe,CAAC;AAE7D,gIAAgI;AAChI,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC,CAAC;AASF,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAAE,CAiBzG;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACzE,wFAAwF;IACxF,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC,GAAG,UAAU,GAAG,IAAI,CAIpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,GAAG,cAAc,CAejB;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAI3D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAE1E"}

package/dist/tui/ack-prompt.js

@@ -0,0 +1,59 @@
+/** What a prompt-created ack lasts in the daemon (`ack/pending` storeOptions[].defaultTtlMs): session ends with the session. */
+export const ACK_PROMPT_TTL_DAYS = 7;
+const SCOPE_PHRASE = {
+    session: "this session",
+    project: "this project",
+    bot: "this bot",
+    global: "everywhere",
+};
+/** Each offered subject at each scope the session can store to. */
+export function ackChoices(options, session) {
+    const scopes = session.bot ? ["session", "project", "bot", "global"] : ["session", "project", "global"];
+    const out = [];
+    for (const option of options) {
+        for (const scope of scopes) {
+            const ttl = scope === "session" ? "this session" : `${ACK_PROMPT_TTL_DAYS} days`;
+            out.push({
+                scope,
+                subject: option.subject,
+                label: option.label,
+                ttl,
+                // The session's own life is both scope and expiry: say it once.
+                text: scope === "session" ? `${option.label} · ${SCOPE_PHRASE[scope]}` : `${option.label} · ${SCOPE_PHRASE[scope]} · ${ttl}`,
+            });
+        }
+    }
+    return out;
+}
+export function ackVariant(input) {
+    if (!input.ackPending || input.policyResult === "block" || input.policyResult === null)
+        return null;
+    if (input.baseDecision === true)
+        return "ack";
+    return input.policyResult === "deny" ? "soft-deny+ack" : "ask+ack";
+}
+export function ackPromptModel(input) {
+    const labels = [...new Set(input.flags.map((flag) => flag.label))];
+    const whys = input.flags.flatMap((flag) => (flag.why === undefined || flag.why === "" ? [] : [flag.why]));
+    const what = labels.join(", ");
+    const head = input.variant === "ack" ? "✉ Acknowledge" : "✉ Also flagged";
+    return {
+        variant: input.variant,
+        header: what === "" ? head : `${head} · ${what}`,
+        whys: [...new Set(whys)].map((why) => `"${why}"`),
+        copy: input.variant === "ack"
+            ? "Allowed by policy; you asked to confirm this first."
+            : "You asked to confirm this call too: your answer settles both.",
+        choices: ackChoices(input.options, { bot: input.bot }),
+    };
+}
+/** The text the prompt pins over the box. */
+export function ackAnnotation(model) {
+    return [model.header, model.whys.length === 0 ? undefined : model.whys.join(" "), model.copy]
+        .filter((part) => part !== undefined && part !== "")
+        .join(" · ");
+}
+export function cycleAck(index, size, step) {
+    return size <= 0 ? 0 : (index + step + size) % size;
+}
+//# sourceMappingURL=ack-prompt.js.map

package/dist/tui/ack-prompt.js.map

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

package/dist/tui/agent-cover.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Ask-cover copy for agent send/ask/message. Rim is dim verb + bright
+ * `{model} {Spec} agent`. Prompt (and spec one-liner) ride the composer
+ * stack — same T-join as MCP options / shell command. Not a pin.
+ *
+ * Stdlib one-liners match the named-agent bot table
+ * (`packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts`). User recipes
+ * in `KernelRoot.bots` win on the same name.
+ */
+import { CallJob, AgentMessageJob } from "@inhuman.tools/harness-model";
+/** CHANGE ONLY with packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts one-liners. */
+export declare const STDLIB_AGENT_DESCRIPTIONS: Readonly<Record<string, string>>;
+export type AgentCoverVerb = "ask" | "send" | "message";
+export type CoverAskContext = {
+    /** Session `kvs.model` — the worker inherits this at mint. */
+    readonly model?: string;
+};
+export declare function agentCoverVerb(work: CallJob | AgentMessageJob): AgentCoverVerb;
+export declare function agentSpecKey(work: object | null | undefined): string;
+/** `quick-search` → `Quick Search`. Sentinel `agent` is anonymous, not a spec. */
+export declare function titleAgentSpec(spec: string): string;
+export declare function formatAskAgentWho(spec: string): string;
+/**
+ * Occupancy pin list. Oxford comma comes from `Intl.ListFormat` (`en-US`).
+ * Noun is English v1 — one `agent` / many `agents` on the whole list.
+ */
+export declare function formatWaitingForAgents(specs: readonly string[], locale?: string): string;
+/**
+ * Isolated-cover rim. Markdown: furniture verb + `**bright**` who.
+ * Message does not spawn — no model. Empty spec is still `… agent`.
+ */
+export declare function formatAgentCoverAnnotation(opts: {
+    readonly verb: AgentCoverVerb;
+    readonly model: string;
+    readonly spec: string;
+}): string;
+export declare function agentCoverPrompt(work: CallJob | AgentMessageJob): string;
+export declare function agentAskStackedBody(prompt: string, description: string): string;
+export declare function agentExpandBlock(prompt: string, model: string): string;
+export declare function agentRecipeDescription(bots: Readonly<Record<string, {
+    readonly description?: string;
+}>>, spec: string): string;
+//# sourceMappingURL=agent-cover.d.ts.map

package/dist/tui/agent-cover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cover.d.ts","sourceRoot":"","sources":["../../src/tui/agent-cover.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgB,OAAO,EAAE,eAAe,EAAc,MAAM,8BAA8B,CAAC;AAKlG,2GAA2G;AAC3G,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,cAAc,CAG9E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAcpE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,SAAU,GAAG,MAAM,CASzF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAKT;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,MAAM,CAExE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EACjE,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}

package/dist/tui/agent-cover.js

@@ -0,0 +1,123 @@
+/**
+ * Ask-cover copy for agent send/ask/message. Rim is dim verb + bright
+ * `{model} {Spec} agent`. Prompt (and spec one-liner) ride the composer
+ * stack — same T-join as MCP options / shell command. Not a pin.
+ *
+ * Stdlib one-liners match the named-agent bot table
+ * (`packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts`). User recipes
+ * in `KernelRoot.bots` win on the same name.
+ */
+import { AgentCallJob, CallJob, AgentMessageJob, BotCallJob } from "@inhuman.tools/harness-model";
+/** Wire name. Ask stamps `voidLegal` false; send and bot-call stay send. */
+const AGENT_ASK_NAME = "agent__ask";
+/** CHANGE ONLY with packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts one-liners. */
+export const STDLIB_AGENT_DESCRIPTIONS = {
+    "quick-search": "cite matching paths; agent/ask for map",
+    explore: "thorough read-only repo investigation",
+    "web-research": "search and extract the public web; cite sources",
+    implementer: "isolated change from a brief; agent/ask for no history",
+    "test-writer": "write and run tests for a named surface",
+    "security-auditor": "find exploitable issues; do not patch",
+    "design-writer": "write a design doc from a brief",
+    "design-reviewer": "stress-test a design; do not rewrite it",
+    reviewer: "persistent reviewer for this session; later requests continue the same conversation",
+};
+export function agentCoverVerb(work) {
+    if (work instanceof AgentMessageJob)
+        return "message";
+    return !work.voidLegal || work.name === AGENT_ASK_NAME || work.name === "bot__ask" ? "ask" : "send";
+}
+export function agentSpecKey(work) {
+    if (work instanceof CallJob) {
+        const spec = stringArg(work.args, "spec")?.trim() ?? "";
+        if (spec !== "")
+            return spec;
+        const bot = work instanceof BotCallJob ? work.botName.trim() || work.contributionBotName.trim() : "";
+        if (bot !== "")
+            return bot;
+        const face = work instanceof AgentCallJob ? (work.faceName ?? "").trim() : "";
+        if (face !== "" && face !== "anonymous")
+            return face;
+        return "";
+    }
+    if (work instanceof AgentMessageJob) {
+        return stringArg(work.args, "targetName")?.trim() ?? "";
+    }
+    return "";
+}
+/** `quick-search` → `Quick Search`. Sentinel `agent` is anonymous, not a spec. */
+export function titleAgentSpec(spec) {
+    const raw = (typeof spec === "string" ? spec : "").trim();
+    if (raw === "" || raw === "agent")
+        return "";
+    return raw
+        .split(/[-_]+/)
+        .filter((part) => part !== "")
+        .map((part) => (part.length <= 3 ? part.toUpperCase() : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()))
+        .join(" ");
+}
+export function formatAskAgentWho(spec) {
+    const titled = titleAgentSpec(spec);
+    return titled === "" ? "agent" : `${titled} agent`;
+}
+/**
+ * Occupancy pin list. Oxford comma comes from `Intl.ListFormat` (`en-US`).
+ * Noun is English v1 — one `agent` / many `agents` on the whole list.
+ */
+export function formatWaitingForAgents(specs, locale = "en-US") {
+    const names = [...specs].map((spec) => titleAgentSpec(spec)).filter((name) => name !== "");
+    if (names.length === 0) {
+        if (specs.length === 0)
+            return "";
+        return specs.length === 1 ? "waiting for an agent" : "waiting for agents";
+    }
+    const who = new Intl.ListFormat(locale, { style: "long", type: "conjunction" }).format(names);
+    const noun = names.length === 1 ? "agent" : "agents";
+    return `waiting for ${who} ${noun}`;
+}
+/**
+ * Isolated-cover rim. Markdown: furniture verb + `**bright**` who.
+ * Message does not spawn — no model. Empty spec is still `… agent`.
+ */
+export function formatAgentCoverAnnotation(opts) {
+    const model = opts.verb === "message" ? "" : opts.model.trim();
+    const spec = titleAgentSpec(opts.spec);
+    const who = [model, spec, "agent"].filter((part) => part !== "").join(" ");
+    return `${opts.verb} **${who}**`;
+}
+export function agentCoverPrompt(work) {
+    return stringArg(work.args, "message") ?? "";
+}
+export function agentAskStackedBody(prompt, description) {
+    const desc = description.trim();
+    if (desc === "")
+        return prompt;
+    if (prompt === "")
+        return desc;
+    return `${desc}\n\n${prompt}`;
+}
+export function agentExpandBlock(prompt, model) {
+    const body = prompt.trim();
+    const who = model.trim();
+    if (who === "")
+        return body;
+    if (body === "")
+        return who;
+    return `${body}\n${who}`;
+}
+export function agentRecipeDescription(bots, spec) {
+    const key = spec.trim();
+    if (key === "")
+        return "";
+    const fromFile = (bots[key]?.description ?? "").trim();
+    if (fromFile !== "")
+        return fromFile;
+    return STDLIB_AGENT_DESCRIPTIONS[key] ?? "";
+}
+function stringArg(args, key) {
+    if (args === null)
+        return undefined;
+    const value = args[key];
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+//# sourceMappingURL=agent-cover.js.map

package/dist/tui/agent-cover.js.map

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

package/dist/tui/agents-drawer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Agents drawer paint. Compact meter is a 0/1 composer-adjacent row.
+ * Drawer body is the overlay list — not a nested tape.
+ */
+import { type Client } from "@inhuman.tools/harness-sdk";
+import { type LayoutNode } from "@inhuman.tools/quickdraw/layout";
+export type AgentsReplicaRow = {
+    readonly key: string;
+    readonly kind: "call" | "bot" | "session";
+    readonly name: string;
+    readonly recap: string;
+    readonly indent: number;
+    readonly prompt: string;
+    readonly notifies: readonly string[];
+    readonly result: string;
+    readonly mark: string;
+    readonly model: string;
+    readonly lastPrompt: string;
+    readonly askLine: string;
+    readonly unfinished: string;
+    readonly current: boolean;
+    readonly sessionId: string;
+};
+export type AgentsReplicaFace = {
+    readonly meterLeft: string;
+    readonly meterRight: string;
+    readonly open: boolean;
+    readonly focusKey: string;
+    readonly scroll: number;
+    readonly rows: readonly AgentsReplicaRow[];
+    /** Call key whose sneak-peek modal is open. Empty hides the modal. */
+    readonly previewKey: string;
+};
+export type AgentsDrawerChrome = {
+    readonly open: boolean;
+    readonly focusKey: string | null;
+    readonly scroll: number;
+    readonly previewKey?: string | null;
+};
+export declare function agentsPaintFace(client: Client, chrome: AgentsDrawerChrome): AgentsReplicaFace | null;
+/** Left of the top overview row. The arrow is the empty-prompt chord, not a name. */
+export declare const AGENTS_OVERVIEW_LABEL = "\u2190: overview";
+export declare function prepareAgentsMeter(calls: string, bots: string, width: number): LayoutNode;
+export declare function prepareAgentsDrawer(face: AgentsReplicaFace, width: number): LayoutNode;
+export declare function agentsPreviewTitle(face: Pick<AgentsReplicaFace, "previewKey" | "rows">): string;
+export declare function prepareAgentsPeek(face: AgentsReplicaFace): LayoutNode | null;
+//# sourceMappingURL=agents-drawer.d.ts.map

package/dist/tui/agents-drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-drawer.d.ts","sourceRoot":"","sources":["../../src/tui/agents-drawer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAgBzF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CAwCpG;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,qBAAgB,CAAC;AAEnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAqCzF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAkBtF;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,MAAM,CAAC,GAAG,MAAM,CAG/F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,GAAG,IAAI,CAoF5E"}