agenticros 0.1.12 → 0.1.14

package/dist/util/openclaw-config.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Safe read/write helper for the OpenClaw gateway config file.
+ *
+ * The OpenClaw config (default: `~/.openclaw/openclaw.json`) is the source of
+ * truth for the AgenticROS *plugin*'s skill configuration —
+ * `plugins.entries.agenticros.config.skillPaths` and `.skillPackages` decide
+ * which skill packages the plugin loads at gateway start. The MCP server and
+ * the Gemini CLI read their config from `~/.agenticros/config.json` instead;
+ * neither currently loads skills.
+ *
+ * This module exists so the rest of the CLI can mutate that nested
+ * `plugins.entries.agenticros.config` slice without round-tripping the entire
+ * JSON document or accidentally clobbering unrelated keys (gateway auth,
+ * other plugins, etc). Every write goes through the full JSON parse → mutate
+ * → stringify cycle to keep the file valid; comments are not supported in the
+ * source JSON either way.
+ */
+/** Default location of the OpenClaw config. Overridable via `$OPENCLAW_CONFIG`. */
+export declare function openclawConfigPath(): string;
+export declare function openclawConfigExists(): boolean;
+/**
+ * Read the OpenClaw config or return `undefined` if it doesn't exist / is
+ * not valid JSON. We never throw — callers can decide how loudly to fail.
+ */
+export declare function readOpenclawConfig(): Record<string, unknown> | undefined;
+/** Write the config back, pretty-printed (2-space indent), with a trailing newline. */
+export declare function writeOpenclawConfig(cfg: Record<string, unknown>): void;
+/**
+ * Locate (and lazily create) the `plugins.entries.agenticros.config` subtree.
+ * Mutates `cfg` in place and returns the inner config object so callers can
+ * read/modify its `skillPaths`, `skillPackages`, `skills`, etc.
+ */
+export declare function getAgenticrosPluginConfig(cfg: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Ensure `obj[key]` is an array of strings and return it (creating an empty
+ * array if needed). Non-string entries in an existing array are preserved so
+ * we don't silently drop opaque values, but lookups still operate on strings.
+ */
+export declare function ensureStringArray(obj: Record<string, unknown>, key: string): unknown[];
+/**
+ * Locate the AgenticROS plugin manifest whose `contracts.tools` the CLI
+ * should treat as canonical.
+ *
+ * Order:
+ *   1. The in-repo source manifest at
+ *      `<installRoot>/packages/agenticros/openclaw.plugin.json`. This is
+ *      the "future-proof" list — anything `sync-skill-tools.mjs` adds for
+ *      a new skill lands here first, and the next `setup_gateway_plugin.sh`
+ *      run propagates it into the deploy. Stamping `alsoAllow` from this
+ *      file means the chat agent picks up the new tools the moment the
+ *      gateway restarts, with no second sync round-trip.
+ *   2. The deploy dir produced by `setup_gateway_plugin.sh`
+ *      (`~/.agenticros/plugin-deploy/openclaw.plugin.json`) — used when
+ *      the CLI runs without a workspace checkout (npx-from-tarball).
+ *
+ * `installRoot` is the agenticros workspace root (`getCliPaths().repoRoot`).
+ * Returns `undefined` if neither file exists yet — callers should treat that
+ * as "plugin not installed yet, skip the sync step".
+ */
+export declare function findAgenticrosPluginManifest(installRoot?: string): string | undefined;
+/**
+ * Read `contracts.tools` from the AgenticROS plugin manifest, or `undefined`
+ * if we can't find / parse it. This is the canonical list the CLI uses when
+ * stamping `tools.alsoAllow` in the OpenClaw config.
+ */
+export declare function readAgenticrosContractTools(installRoot?: string): string[] | undefined;
+export interface AlsoAllowSyncResult {
+    /** Tools that were already in `alsoAllow` before we ran. */
+    preExisting: string[];
+    /** Tools we appended this run (anything from `tools` that wasn't already allowed). */
+    added: string[];
+    /** Full `alsoAllow` after the update — useful for logging. */
+    final: string[];
+    /** True when the on-disk config was modified. */
+    changed: boolean;
+}
+/**
+ * Make sure every tool id in `tools` is reachable from the chat agent's tool
+ * picker by appending missing entries to `cfg.tools.alsoAllow`.
+ *
+ * Why this exists: OpenClaw 2026.6+ ships a `tools.profile` ("coding",
+ * "standard", …) that is a *strict* allowlist applied before plugin-registered
+ * tools are merged in. Plugins like AgenticROS can register tools all day, but
+ * the chat agent will never see them unless the user opts each one in via
+ * `tools.alsoAllow`. The gateway logs this as "Browser is configured, but the
+ * current tool profile does not include the browser tool…" for built-ins; for
+ * plugin tools you instead just see the agent claim "I don't have those tools"
+ * in chat. We keep the user out of that footgun by syncing `alsoAllow` to the
+ * plugin's `contracts.tools` whenever the CLI knows the canonical list.
+ *
+ * Idempotent. Never removes entries (other plugins may have added their own).
+ * Returns a result rather than mutating cfg in-place + writing, because
+ * callers sometimes want to combine this with other config mutations and
+ * write once at the end. This function still writes when run standalone
+ * (when `write` is true, the default) so simple callers stay one-liners.
+ */
+export declare function ensureToolsAlsoAllow(tools: string[], opts?: {
+    write?: boolean;
+    cfg?: Record<string, unknown>;
+}): AlsoAllowSyncResult | undefined;
+//# sourceMappingURL=openclaw-config.d.ts.map

package/dist/util/openclaw-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-config.d.ts","sourceRoot":"","sources":["../../src/util/openclaw-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYxE;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAItE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK/F;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,EAAE,CAMX;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAatF;AAED,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sFAAsF;IACtF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO,GAC5D,mBAAmB,GAAG,SAAS,CAiBjC"}

package/dist/util/openclaw-config.js

@@ -0,0 +1,182 @@
+/**
+ * Safe read/write helper for the OpenClaw gateway config file.
+ *
+ * The OpenClaw config (default: `~/.openclaw/openclaw.json`) is the source of
+ * truth for the AgenticROS *plugin*'s skill configuration —
+ * `plugins.entries.agenticros.config.skillPaths` and `.skillPackages` decide
+ * which skill packages the plugin loads at gateway start. The MCP server and
+ * the Gemini CLI read their config from `~/.agenticros/config.json` instead;
+ * neither currently loads skills.
+ *
+ * This module exists so the rest of the CLI can mutate that nested
+ * `plugins.entries.agenticros.config` slice without round-tripping the entire
+ * JSON document or accidentally clobbering unrelated keys (gateway auth,
+ * other plugins, etc). Every write goes through the full JSON parse → mutate
+ * → stringify cycle to keep the file valid; comments are not supported in the
+ * source JSON either way.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+/** Default location of the OpenClaw config. Overridable via `$OPENCLAW_CONFIG`. */
+export function openclawConfigPath() {
+    const env = process.env["OPENCLAW_CONFIG"];
+    if (env && env.trim().length > 0)
+        return env;
+    return join(homedir(), ".openclaw", "openclaw.json");
+}
+export function openclawConfigExists() {
+    return existsSync(openclawConfigPath());
+}
+/**
+ * Read the OpenClaw config or return `undefined` if it doesn't exist / is
+ * not valid JSON. We never throw — callers can decide how loudly to fail.
+ */
+export function readOpenclawConfig() {
+    const p = openclawConfigPath();
+    if (!existsSync(p))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(p, "utf8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Write the config back, pretty-printed (2-space indent), with a trailing newline. */
+export function writeOpenclawConfig(cfg) {
+    const p = openclawConfigPath();
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, `${JSON.stringify(cfg, null, 2)}\n`);
+}
+/**
+ * Locate (and lazily create) the `plugins.entries.agenticros.config` subtree.
+ * Mutates `cfg` in place and returns the inner config object so callers can
+ * read/modify its `skillPaths`, `skillPackages`, `skills`, etc.
+ */
+export function getAgenticrosPluginConfig(cfg) {
+    const plugins = asObject(cfg, "plugins");
+    const entries = asObject(plugins, "entries");
+    const agenticros = asObject(entries, "agenticros");
+    return asObject(agenticros, "config");
+}
+function asObject(parent, key) {
+    const cur = parent[key];
+    if (cur && typeof cur === "object" && !Array.isArray(cur)) {
+        return cur;
+    }
+    const fresh = {};
+    parent[key] = fresh;
+    return fresh;
+}
+/**
+ * Ensure `obj[key]` is an array of strings and return it (creating an empty
+ * array if needed). Non-string entries in an existing array are preserved so
+ * we don't silently drop opaque values, but lookups still operate on strings.
+ */
+export function ensureStringArray(obj, key) {
+    const cur = obj[key];
+    if (Array.isArray(cur))
+        return cur;
+    const fresh = [];
+    obj[key] = fresh;
+    return fresh;
+}
+/**
+ * Locate the AgenticROS plugin manifest whose `contracts.tools` the CLI
+ * should treat as canonical.
+ *
+ * Order:
+ *   1. The in-repo source manifest at
+ *      `<installRoot>/packages/agenticros/openclaw.plugin.json`. This is
+ *      the "future-proof" list — anything `sync-skill-tools.mjs` adds for
+ *      a new skill lands here first, and the next `setup_gateway_plugin.sh`
+ *      run propagates it into the deploy. Stamping `alsoAllow` from this
+ *      file means the chat agent picks up the new tools the moment the
+ *      gateway restarts, with no second sync round-trip.
+ *   2. The deploy dir produced by `setup_gateway_plugin.sh`
+ *      (`~/.agenticros/plugin-deploy/openclaw.plugin.json`) — used when
+ *      the CLI runs without a workspace checkout (npx-from-tarball).
+ *
+ * `installRoot` is the agenticros workspace root (`getCliPaths().repoRoot`).
+ * Returns `undefined` if neither file exists yet — callers should treat that
+ * as "plugin not installed yet, skip the sync step".
+ */
+export function findAgenticrosPluginManifest(installRoot) {
+    if (installRoot) {
+        const inRepo = join(installRoot, "packages", "agenticros", "openclaw.plugin.json");
+        if (existsSync(inRepo))
+            return inRepo;
+    }
+    const deployed = join(homedir(), ".agenticros", "plugin-deploy", "openclaw.plugin.json");
+    if (existsSync(deployed))
+        return deployed;
+    return undefined;
+}
+/**
+ * Read `contracts.tools` from the AgenticROS plugin manifest, or `undefined`
+ * if we can't find / parse it. This is the canonical list the CLI uses when
+ * stamping `tools.alsoAllow` in the OpenClaw config.
+ */
+export function readAgenticrosContractTools(installRoot) {
+    const manifestPath = findAgenticrosPluginManifest(installRoot);
+    if (!manifestPath)
+        return undefined;
+    try {
+        const m = JSON.parse(readFileSync(manifestPath, "utf8"));
+        const tools = m.contracts?.tools;
+        if (!Array.isArray(tools))
+            return undefined;
+        return tools.filter((t) => typeof t === "string");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Make sure every tool id in `tools` is reachable from the chat agent's tool
+ * picker by appending missing entries to `cfg.tools.alsoAllow`.
+ *
+ * Why this exists: OpenClaw 2026.6+ ships a `tools.profile` ("coding",
+ * "standard", …) that is a *strict* allowlist applied before plugin-registered
+ * tools are merged in. Plugins like AgenticROS can register tools all day, but
+ * the chat agent will never see them unless the user opts each one in via
+ * `tools.alsoAllow`. The gateway logs this as "Browser is configured, but the
+ * current tool profile does not include the browser tool…" for built-ins; for
+ * plugin tools you instead just see the agent claim "I don't have those tools"
+ * in chat. We keep the user out of that footgun by syncing `alsoAllow` to the
+ * plugin's `contracts.tools` whenever the CLI knows the canonical list.
+ *
+ * Idempotent. Never removes entries (other plugins may have added their own).
+ * Returns a result rather than mutating cfg in-place + writing, because
+ * callers sometimes want to combine this with other config mutations and
+ * write once at the end. This function still writes when run standalone
+ * (when `write` is true, the default) so simple callers stay one-liners.
+ */
+export function ensureToolsAlsoAllow(tools, opts = {}) {
+    const cfg = opts.cfg ?? readOpenclawConfig();
+    if (!cfg)
+        return undefined;
+    const toolsBlock = asObject(cfg, "tools");
+    const rawAlso = ensureStringArray(toolsBlock, "alsoAllow");
+    const preExisting = rawAlso.filter((x) => typeof x === "string");
+    const added = [];
+    for (const t of tools) {
+        if (typeof t !== "string" || t.length === 0)
+            continue;
+        if (preExisting.includes(t) || added.includes(t))
+            continue;
+        rawAlso.push(t);
+        added.push(t);
+    }
+    const final = [...preExisting, ...added];
+    const changed = added.length > 0;
+    if (opts.write !== false && changed)
+        writeOpenclawConfig(cfg);
+    return { preExisting, added, final, changed };
+}
+//# sourceMappingURL=openclaw-config.js.map

package/dist/util/openclaw-config.js.map

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

package/dist/util/skills.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Skill discovery, validation, and config-file mutation primitives.
+ *
+ * An AgenticROS skill is a Node package whose `package.json` carries
+ * `"agenticrosSkill": true` and exports a `registerSkill(api, config, context)`
+ * function from its `main` entry. The OpenClaw AgenticROS plugin loads them
+ * at gateway start by walking two arrays in its config:
+ *
+ *   - `skillPaths[]`     — absolute directories to scan (validate `package.json`)
+ *   - `skillPackages[]`  — npm-resolvable names (e.g. `agenticros-skill-find`)
+ *
+ * This module is the single place the CLI talks to those arrays. It also
+ * encapsulates discovery (where on disk users typically clone skill repos)
+ * and the `deriveSkillId` convention shared with `@agenticros/agenticros`'s
+ * skill-loader so menu / list output uses the same short ids the plugin
+ * surfaces (e.g. `followme`, `find`).
+ */
+export interface SkillRef {
+    /** Short id (matches what the OpenClaw plugin uses for `config.skills.<id>`). */
+    id: string;
+    /** npm package name (from `package.json.name`). */
+    packageName: string;
+    /** Absolute directory containing `package.json`, when known. */
+    dir?: string;
+    /** Where the skill is currently registered with the gateway. */
+    registeredAs: ("path" | "package")[];
+    /**
+     * Absolute path the skill's `package.json` declares as its entry (`main`),
+     * resolved against `dir`. Only set when we inspected the directory.
+     */
+    entry?: string;
+    /** True when `entry` exists on disk; false when the skill needs `pnpm build`. */
+    built?: boolean;
+}
+/**
+ * Apply the same short-id transform the OpenClaw plugin's skill-loader uses,
+ * so menu output and the plugin's `config.skills.<id>` keys line up exactly.
+ * `agenticros-skill-followme` → `followme`; scoped packages drop the scope.
+ */
+export declare function deriveSkillId(packageName: string): string;
+/**
+ * Inspect a directory and decide whether it's a valid AgenticROS skill clone.
+ * Returns a partial `SkillRef` (no `registeredAs`) or `undefined` when the
+ * directory is missing, lacks `package.json`, or doesn't opt in via the
+ * `agenticrosSkill: true` flag.
+ */
+export declare function inspectSkillDir(dir: string): Omit<SkillRef, "registeredAs"> | undefined;
+/**
+ * Return a deduped list of "places we should look for skill clones" — the
+ * directories whose children the CLI scans on `agenticros skills discover`.
+ *
+ * We include both the parent of the active repo / install dir (so siblings
+ * of `agenticros/` work, e.g. `../agenticros-skill-find`) and `$HOME` /
+ * `$HOME/Projects/` / `$HOME/Code/` so a vanilla clone-into-Projects flow
+ * is found without configuration.
+ */
+export declare function discoveryRoots(extra?: string[]): string[];
+/**
+ * Walk every directory in `roots`, returning a `SkillRef` for each child
+ * directory that passes `inspectSkillDir`. Used by both `discover` and
+ * `list` (which uses it to render orphaned-but-cloned skills).
+ */
+export declare function scanForSkills(extra?: string[]): SkillRef[];
+export interface SkillsListing {
+    /** Skills currently registered in the OpenClaw config (path-loaded or package-loaded). */
+    registered: SkillRef[];
+    /** Skill clones that exist on disk in known discovery roots but aren't registered. */
+    available: SkillRef[];
+    /** `skillPaths` entries that refer to a directory that no longer exists. */
+    brokenPaths: string[];
+}
+/**
+ * Build a snapshot of the user's current skill state: what's registered,
+ * what's available-but-not-registered, and what registrations are broken.
+ * The single source of truth for the `agenticros skills` (list) view.
+ */
+export declare function listSkills(): SkillsListing;
+export interface AddResult {
+    ok: boolean;
+    /** Human-readable summary of what changed (or why nothing changed). */
+    message: string;
+    skill?: SkillRef;
+}
+/**
+ * Add a skill to the OpenClaw plugin config by absolute directory path.
+ * Idempotent: re-adding an existing entry is a no-op and returns `ok: true`
+ * with an explanatory message. The directory must contain a valid
+ * `package.json` with `agenticrosSkill: true`.
+ */
+export declare function addSkillByPath(dir: string): AddResult;
+/**
+ * Add a skill by npm package name (must be resolvable on the gateway's
+ * Node search path). Mainly intended for skills published to a registry —
+ * for local clones, prefer `addSkillByPath` so the absolute directory is
+ * recorded.
+ */
+export declare function addSkillByPackage(name: string): AddResult;
+export interface RemoveResult {
+    ok: boolean;
+    message: string;
+    removedPaths: string[];
+    removedPackages: string[];
+}
+/**
+ * Remove every registration that matches `idOrName` — either a derived skill
+ * id (e.g. `find`), a full package name (e.g. `agenticros-skill-find`), or an
+ * absolute path that appears in `skillPaths`. Both `skillPaths` (matched by
+ * resolving each path back through `inspectSkillDir`) and `skillPackages`
+ * are cleaned in a single pass.
+ */
+export declare function removeSkill(idOrName: string): RemoveResult;
+//# sourceMappingURL=skills.d.ts.map

package/dist/util/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/util/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgBH,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,SAAS,CA6BvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAuB7D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,QAAQ,EAAE,CAqB9D;AA0BD,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,sFAAsF;IACtF,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAyC1C;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAuCrD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA6BzD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA+D1D"}