@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/server/daemon/kernel/settings-files.js

@@ -0,0 +1,189 @@
+/**
+ * Skill folders and bot markdown written from Settings.
+ * Names cannot leave the root they were given.
+ */
+import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, sep } from "node:path";
+import { asSystemPrompt } from "@inhuman.tools/harness-commons";
+import { discoverProjectSkills } from "@inhuman.tools/project-skills";
+import { parse as parseYaml, stringify } from "yaml";
+import { botDefinitionSchema } from "../../../extensions/schemas/index.js";
+import { RpcInvalidParams } from "../../contract.js";
+import { formatBotMarkdown } from "../bots/parse-bot-markdown.js";
+/** Same gate as project-skills: tests do not touch the real home. */
+export function skillsHome() {
+    const override = process.env.INHUMAN_HOME?.trim();
+    if (override !== undefined && override !== "")
+        return override;
+    if (process.env.VITEST)
+        return null;
+    return homedir();
+}
+const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const BOT_NAME = /^[\da-z][\w.-]*$/i;
+const HOME_DRAWERS = [
+    ".agents/skills",
+    ".config/agents/skills",
+    ".claude/skills",
+    ".cursor/skills",
+    ".codex/skills",
+    ".copilot/skills",
+    ".gemini/skills",
+    ".grok/skills",
+    ".config/opencode/skills",
+    ".pi/agent/skills",
+];
+export function listSkillFiles(project, home) {
+    const start = project ?? home;
+    if (start == null || start === "")
+        return [];
+    return discoverProjectSkills(start, home).map((row) => ({
+        ...row,
+        scope: underHome(row.location, home) ? "home" : "project",
+    }));
+}
+function underHome(location, home) {
+    if (home == null || home === "")
+        return false;
+    return HOME_DRAWERS.some((drawer) => {
+        const root = join(home, ...drawer.split("/"));
+        return location.startsWith(root.endsWith(sep) ? root : root + sep);
+    });
+}
+export function writeSkillFile(root, name, description, body) {
+    const dir = containedDir(root, skillFolder(name));
+    mkdirSync(dir, { recursive: true });
+    const file = join(realpathSync(dir), "SKILL.md");
+    const head = stringify({ name, description }).trimEnd();
+    writeFileSync(file, `---\n${head}\n---\n\n${body.replace(/\s+$/, "")}\n`);
+    return file;
+}
+/** Markdown under the frontmatter. The list row does not carry this. */
+export function skillBody(location) {
+    const text = readFileSync(location, "utf8").replace(/^\uFEFF/, "");
+    if (!text.startsWith("---"))
+        return text.replace(/\s+$/, "");
+    const close = text.indexOf("\n---", 3);
+    if (close === -1)
+        return text.replace(/\s+$/, "");
+    return text
+        .slice(close + 4)
+        .replace(/^\n+/, "")
+        .replace(/\s+$/, "");
+}
+export function removeSkillFile(root, name) {
+    if (!SKILL_NAME.test(name) || name.length > 64)
+        throw new RpcInvalidParams("invalid skill name");
+    mkdirSync(root, { recursive: true });
+    const base = realpathSync(root);
+    const dir = join(base, ".agents", "skills", name);
+    if (!existsSync(dir))
+        return;
+    const placed = realpathSync(dir);
+    if (placed !== base && !placed.startsWith(base.endsWith(sep) ? base : base + sep)) {
+        throw new RpcInvalidParams("path escaped its root");
+    }
+    rmSync(placed, { recursive: true, force: true });
+}
+/** Admitted fields a later save must keep when the caller omits them. Null when the file is missing or will not admit. */
+export function readBotAuthoring(dir, name) {
+    let stem;
+    try {
+        stem = botStem(name);
+    }
+    catch {
+        return null;
+    }
+    const file = join(dir, `${stem}.md`);
+    if (!existsSync(file))
+        return null;
+    const text = readFileSync(file, "utf8").replace(/^\uFEFF/, "");
+    if (!text.startsWith("---"))
+        return null;
+    const close = text.indexOf("\n---", 3);
+    if (close === -1)
+        return null;
+    let bag;
+    try {
+        const parsed = parseYaml(text.slice(3, close).replace(/^\n/, ""));
+        if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        bag = {};
+        for (const [key, value] of Object.entries(parsed))
+            bag[key] = value;
+    }
+    catch {
+        return null;
+    }
+    const named = bag.name;
+    if (typeof named === "string" && named.trim() !== "" && named.trim() !== stem)
+        return null;
+    const admitted = botDefinitionSchema.safeParse({
+        ...bag,
+        name: stem,
+        instructions: text.slice(close + 4).replace(/^\n/, ""),
+    });
+    if (!admitted.success)
+        return null;
+    const behavior = admitted.data.behavior;
+    return {
+        invokes: admitted.data.invokes,
+        reasoningEffort: admitted.data.reasoningEffort ?? null,
+        modelPreferences: admitted.data.modelPreferences,
+        behavior: behavior == null ? null : recordOf(behavior),
+        mcp: admitted.data.mcp,
+    };
+}
+export function writeBotFile(dir, bot) {
+    const file = join(containedDir(dir, "."), `${botStem(bot.name)}.md`);
+    const recipeScope = bot.recipeScope === "project" ? "workspace" : bot.recipeScope;
+    writeFileSync(file, formatBotMarkdown({
+        name: bot.name,
+        recipeScope,
+        instructions: asSystemPrompt(bot.instructions),
+        description: bot.description,
+        tools: bot.tools,
+        skills: bot.skills,
+        keepAlive: bot.keepAlive,
+        ...(bot.invokes == null ? {} : { invokes: bot.invokes }),
+        ...(bot.reasoningEffort == null ? {} : { reasoningEffort: bot.reasoningEffort }),
+        ...(bot.modelPreferences == null ? {} : { modelPreferences: bot.modelPreferences }),
+        ...(bot.behavior == null ? {} : { behavior: bot.behavior }),
+        ...(bot.mcp == null || bot.mcp.length === 0 ? {} : { mcp: bot.mcp }),
+    }));
+    return file;
+}
+export function removeBotFile(dir, name) {
+    rmSync(join(containedDir(dir, "."), `${botStem(name)}.md`), { force: true });
+}
+function recordOf(value) {
+    const out = {};
+    for (const [key, entry] of Object.entries(value))
+        out[key] = entry;
+    return out;
+}
+function skillFolder(name) {
+    if (!SKILL_NAME.test(name) || name.length > 64) {
+        throw new RpcInvalidParams("invalid skill name");
+    }
+    return join(".agents", "skills", name);
+}
+function botStem(name) {
+    if (!BOT_NAME.test(name) || name.includes(".."))
+        throw new RpcInvalidParams("invalid bot name");
+    return name;
+}
+/** `rel` stays inside `root` after the directory is created. */
+function containedDir(root, rel) {
+    mkdirSync(root, { recursive: true });
+    const base = realpathSync(root);
+    const dir = join(base, rel);
+    mkdirSync(dir, { recursive: true });
+    const placed = realpathSync(dir);
+    if (placed !== base && !placed.startsWith(base.endsWith(sep) ? base : base + sep)) {
+        throw new RpcInvalidParams("path escaped its root");
+    }
+    return placed;
+}
+//# sourceMappingURL=settings-files.js.map

package/dist/server/daemon/kernel/settings-files.js.map

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

package/dist/server/daemon/kernel/workflow-feeds.d.ts

@@ -0,0 +1,27 @@
+import type { ServerResponse } from "node:http";
+import { EvalTrace } from "@here.build/arrival-provenance";
+import { type WorkflowFrame } from "@inhuman.tools/harness-model/session";
+export declare class WorkflowFeeds {
+    #private;
+    private readonly dir;
+    constructor(dir: string);
+    /**
+     * One run of a program: the whole of a one-shot, or one period tick. Each run is a new
+     * generation, so its subscribers start over from a snapshot. The trace is the run's own and
+     * is dropped with it.
+     */
+    observe<T>(sessionId: string, jobUuid: string, run: (trace: EvalTrace) => Promise<T>): Promise<T>;
+    /** The job is over. Write the final graph, tell the subscribers, forget the feed. */
+    settle(sessionId: string, jobUuid: string): Promise<void>;
+    /**
+     * A live feed sends its current snapshot, then every frame after it; a finished job's graph comes
+     * as one snapshot, done. Returns undefined for a job nothing is known of, else the way to stop.
+     */
+    subscribe(sessionId: string, jobUuid: string, send: (frame: WorkflowFrame) => void): Promise<(() => void) | undefined>;
+}
+/** One SSE event: `id` is the frame's seq, so a client can name where it stopped. */
+export declare function frameEvent(frame: WorkflowFrame): string;
+export declare const HEARTBEAT = ": keepalive\n\n";
+/** Serve one job's frames as `text/event-stream` until it is done or the client leaves. */
+export declare function streamWorkflow(feeds: WorkflowFeeds, sessionId: string, jobUuid: string, response: ServerResponse): Promise<void>;
+//# sourceMappingURL=workflow-feeds.d.ts.map

package/dist/server/daemon/kernel/workflow-feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-feeds.d.ts","sourceRoot":"","sources":["../../../../src/server/daemon/kernel/workflow-feeds.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,OAAO,EAAE,SAAS,EAAmB,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAoCxG,qBAAa,aAAa;;IAGZ,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAmCxC;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6DvG,qFAAqF;IAC/E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB/D;;;OAGG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACnC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAkBrC;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEvD;AAED,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAE3C,2FAA2F;AAC3F,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/server/daemon/kernel/workflow-feeds.js

@@ -0,0 +1,230 @@
+/**
+ * The daemon's side of the workflow graph. A program's trace is folded into a
+ * region graph as it grows, each tick's graph is diffed against the last one sent,
+ * and the patches go out to whoever subscribed. A finished job's final graph is
+ * written beside the kernel's state, so a late reader gets it as one snapshot.
+ *
+ * Leaves that carry a `jobId` drop their value: the inner job already holds the
+ * outcome on the session document, and the graph reads it from there.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isSchemeValue, toJS } from "@here.build/arrival";
+import { AValue } from "@here.build/arrival/reflect-internals";
+import { EvalTrace, TraceRegionFold } from "@here.build/arrival-provenance";
+import { diffJson, isWorkflowLeafMeta } from "@inhuman.tools/harness-model/session";
+import { reaction } from "mobx";
+import { fail } from "../../../diagnostics/index.js";
+/** Runs that ended without the job ending (a watch between ticks, a parked program) keep only their last graph. */
+const IDLE_CAP = 32;
+const HEARTBEAT_MS = 15_000;
+const SAFE_ID = /^[\w-]+$/;
+/** The graph as plain JSON: scheme boxes unwrapped, and no value a job already carries. */
+function plain(graph) {
+    return JSON.parse(JSON.stringify(graph, function (key, value) {
+        if (key === "value" && isWorkflowLeafMeta(this.meta) && typeof this.meta.jobId === "string")
+            return undefined;
+        if (typeof value === "bigint")
+            return value.toString();
+        return value instanceof AValue || isSchemeValue(value) ? toJS(value) : value;
+    }));
+}
+export class WorkflowFeeds {
+    dir;
+    #feeds = new Map();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    #file(sessionId, jobUuid) {
+        return join(this.dir, sessionId, `${jobUuid}.json`);
+    }
+    #send(feed, frame) {
+        for (const send of feed.subscribers) {
+            try {
+                send(frame);
+            }
+            catch (error) {
+                feed.subscribers.delete(send);
+                fail("workflow subscriber", error);
+            }
+        }
+    }
+    /** Fold what the trace has gained, diff it, send what changed. */
+    #flush(feed, fold, done) {
+        fold.applyDelta();
+        const next = plain(fold.current());
+        if (!feed.opened) {
+            feed.opened = true;
+            feed.graph = next;
+            feed.seq += 1;
+            this.#send(feed, { kind: "snapshot", gen: feed.gen, seq: feed.seq, graph: next, done });
+            return;
+        }
+        const ops = diffJson(feed.graph, next);
+        feed.graph = next;
+        if (ops.length === 0)
+            return;
+        feed.seq += 1;
+        this.#send(feed, { kind: "patch", gen: feed.gen, seq: feed.seq, ops, done });
+    }
+    /**
+     * One run of a program: the whole of a one-shot, or one period tick. Each run is a new
+     * generation, so its subscribers start over from a snapshot. The trace is the run's own and
+     * is dropped with it.
+     */
+    async observe(sessionId, jobUuid, run) {
+        const key = `${sessionId}/${jobUuid}`;
+        const feed = this.#feeds.get(key);
+        const live = feed ?? { gen: 0, seq: 0, graph: undefined, opened: false, done: false, subscribers: new Set() };
+        this.#feeds.set(key, live);
+        live.gen += 1;
+        live.opened = false;
+        const trace = new EvalTrace();
+        trace.withAutoBindings();
+        const fold = new TraceRegionFold(trace);
+        // The studio's adaptive throttle: no sooner than the last build took, at least a frame.
+        let timer;
+        let lastBuildMs = 0;
+        const flush = (done) => {
+            timer = undefined;
+            const began = performance.now();
+            try {
+                this.#flush(live, fold, done);
+            }
+            catch (error) {
+                fail(`workflow ${key}`, error);
+            }
+            lastBuildMs = performance.now() - began;
+        };
+        const stopWatching = reaction(() => trace.entries, () => {
+            timer ??= setTimeout(() => flush(false), Math.min(2000, Math.max(16, Math.round(lastBuildMs)))).unref();
+        });
+        live.run = {
+            stop: () => {
+                stopWatching();
+                clearTimeout(timer);
+                timer = undefined;
+            },
+        };
+        flush(false);
+        try {
+            return await run(trace);
+        }
+        finally {
+            live.run.stop();
+            flush(false);
+            live.run = undefined;
+            try {
+                trace.clear();
+            }
+            catch {
+                /* mid-eval abort — the trace is dropped anyway */
+            }
+            this.#park(key, live);
+        }
+    }
+    /** A run ended with the job still open: it is idle until the next run, and idle feeds are bounded. */
+    #park(key, feed) {
+        this.#feeds.delete(key);
+        this.#feeds.set(key, feed);
+        const idle = [...this.#feeds].filter(([, other]) => other.run === undefined && !other.done);
+        for (const [name] of idle.slice(0, Math.max(0, idle.length - IDLE_CAP)))
+            this.#feeds.delete(name);
+    }
+    /** The job is over. Write the final graph, tell the subscribers, forget the feed. */
+    async settle(sessionId, jobUuid) {
+        const key = `${sessionId}/${jobUuid}`;
+        const feed = this.#feeds.get(key);
+        if (feed === undefined)
+            return;
+        feed.seq += 1;
+        try {
+            const file = this.#file(sessionId, jobUuid);
+            await mkdir(join(this.dir, sessionId), { recursive: true });
+            const written = `${file}.${process.pid}.tmp`;
+            await writeFile(written, JSON.stringify({ gen: feed.gen, seq: feed.seq, graph: feed.graph }));
+            await rename(written, file);
+        }
+        catch (error) {
+            fail(`workflow persist ${key}`, error);
+        }
+        finally {
+            feed.done = true;
+            this.#send(feed, { kind: "patch", gen: feed.gen, seq: feed.seq, ops: [], done: true });
+            feed.subscribers.clear();
+            this.#feeds.delete(key);
+        }
+    }
+    /**
+     * A live feed sends its current snapshot, then every frame after it; a finished job's graph comes
+     * as one snapshot, done. Returns undefined for a job nothing is known of, else the way to stop.
+     */
+    async subscribe(sessionId, jobUuid, send) {
+        if (!SAFE_ID.test(sessionId) || !SAFE_ID.test(jobUuid))
+            return undefined;
+        const feed = this.#feeds.get(`${sessionId}/${jobUuid}`);
+        if (feed !== undefined) {
+            if (feed.graph !== undefined)
+                send({ kind: "snapshot", gen: feed.gen, seq: feed.seq, graph: feed.graph, done: feed.done });
+            if (feed.done)
+                return () => { };
+            feed.subscribers.add(send);
+            return () => feed.subscribers.delete(send);
+        }
+        try {
+            const saved = JSON.parse(await readFile(this.#file(sessionId, jobUuid), "utf8"));
+            send({ kind: "snapshot", gen: saved.gen, seq: saved.seq, graph: saved.graph, done: true });
+            return () => { };
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** One SSE event: `id` is the frame's seq, so a client can name where it stopped. */
+export function frameEvent(frame) {
+    return `id: ${frame.seq}\ndata: ${JSON.stringify(frame)}\n\n`;
+}
+export const HEARTBEAT = ": keepalive\n\n";
+/** Serve one job's frames as `text/event-stream` until it is done or the client leaves. */
+export async function streamWorkflow(feeds, sessionId, jobUuid, response) {
+    let opened = false;
+    const open = () => {
+        if (opened)
+            return;
+        opened = true;
+        response.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-cache",
+            "x-accel-buffering": "no",
+        });
+    };
+    let stop;
+    let heartbeat;
+    const close = () => {
+        stop?.();
+        clearInterval(heartbeat);
+        if (!response.writableEnded)
+            response.end();
+    };
+    response.once("close", close);
+    stop = await feeds.subscribe(sessionId, jobUuid, (frame) => {
+        open();
+        response.write(frameEvent(frame));
+        if (frame.done)
+            setImmediate(close);
+    });
+    if (stop === undefined) {
+        response.writeHead(404, { "content-type": "text/plain" });
+        response.end("not found");
+        return;
+    }
+    open();
+    response.flushHeaders();
+    if (response.writableEnded || response.destroyed) {
+        close();
+        return;
+    }
+    heartbeat = setInterval(() => response.write(HEARTBEAT), HEARTBEAT_MS).unref();
+}
+//# sourceMappingURL=workflow-feeds.js.map

package/dist/server/daemon/kernel/workflow-feeds.js.map

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

package/dist/server/daemon/project/ProjectDaemon.d.ts

@@ -0,0 +1,30 @@
+import { ProjectPlexus } from "@inhuman.tools/harness-model";
+import { ToolCallHandler } from "../../../tool-runtime/index.js";
+import { type PlaneSocket } from "../../../yjs/index.js";
+import { RequestHost } from "../../contract.js";
+import type { KernelDaemon } from "../kernel/KernelDaemon.js";
+import { SessionDaemon } from "../session/SessionDaemon.js";
+export declare class ProjectDaemon extends RequestHost implements Disposable {
+    #private;
+    readonly kernel: KernelDaemon;
+    readonly globalHost: boolean;
+    readonly path: string;
+    plexus: ProjectPlexus;
+    readonly toolCalls: ToolCallHandler;
+    readonly ready: Promise<void>;
+    accessor sessions: Record<string, SessionDaemon>;
+    constructor(kernel: KernelDaemon, workspacePath: string, globalHost?: boolean);
+    get root(): import("@inhuman.tools/harness-model").ProjectRoot;
+    session(id?: string): Promise<SessionDaemon>;
+    /** Occupancy/eligibility wrap: honor only if the session is graph-eligible. */
+    attachEligible(id: string): Promise<SessionDaemon>;
+    /**
+     * Kernel/project reload: wrap interned mid-motion SessionRoots only.
+     * Idle roster names stay on the document, not bootstrapped.
+     */
+    bootstrapMidMotionNamed(): Promise<void>;
+    protected get parent(): KernelDaemon;
+    protected attach(socket: PlaneSocket): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=ProjectDaemon.d.ts.map

package/dist/server/daemon/project/ProjectDaemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectDaemon.d.ts","sourceRoot":"","sources":["../../../../src/server/daemon/project/ProjectDaemon.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,aAAa,EAAsB,MAAM,8BAA8B,CAAC;AAOlG,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,qBAAa,aAAc,SAAQ,WAAY,YAAW,UAAU;;IAahE,QAAQ,CAAC,MAAM,EAAE,YAAY;IAE7B,QAAQ,CAAC,UAAU;IAdrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAG,aAAa,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACV,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAM;gBAQ/D,MAAM,EAAE,YAAY,EAC7B,aAAa,EAAE,MAAM,EACZ,UAAU,UAAQ;IAsC7B,IAAI,IAAI,uDAEP;IAEK,OAAO,CAAC,EAAE,GAAE,MAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAKhE,+EAA+E;IACzE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKxD;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyH9C,cAAuB,MAAM,iBAE5B;cAEkB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAmBpD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAezB"}