daemora 1.0.0-alpha.0

package/dist/mcp/MCPStore.js

@@ -0,0 +1,102 @@
+/**
+ * MCPStore — config persistence for MCP server connections.
+ *
+ * MCP servers are stored in a JSON file (config/mcp.json) just like
+ * the JS version. Each server entry declares how to connect (stdio
+ * command or HTTP URL) plus optional env vars and headers.
+ *
+ * The actual MCP client connection lives in MCPManager — this module
+ * only handles config CRUD.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createLogger } from "../util/logger.js";
+import { BUILTIN_MCP_SERVERS } from "./defaults.js";
+const log = createLogger("mcp.store");
+export class MCPStore {
+    configPath;
+    data;
+    constructor(dataDir) {
+        this.configPath = join(dataDir, "mcp.json");
+        this.data = this.load();
+    }
+    load() {
+        // First boot: seed the mcp.json with the built-in server catalog
+        // (all disabled). The user enables whatever they want from the
+        // manage_mcp tool or the Settings UI.
+        if (!existsSync(this.configPath)) {
+            const seeded = { mcpServers: { ...BUILTIN_MCP_SERVERS } };
+            try {
+                const dir = dirname(this.configPath);
+                if (!existsSync(dir))
+                    mkdirSync(dir, { recursive: true });
+                writeFileSync(this.configPath, JSON.stringify(seeded, null, 2), "utf-8");
+                log.info({ path: this.configPath, seeded: Object.keys(seeded.mcpServers).length }, "mcp.json seeded with defaults");
+            }
+            catch (e) {
+                log.warn({ err: e.message }, "mcp.json seed write failed");
+            }
+            return seeded;
+        }
+        try {
+            const raw = readFileSync(this.configPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            return { mcpServers: parsed.mcpServers ?? {} };
+        }
+        catch (e) {
+            log.warn({ path: this.configPath, err: e.message }, "mcp.json parse failed, starting fresh");
+            return { mcpServers: {} };
+        }
+    }
+    save() {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.configPath, JSON.stringify(this.data, null, 2), "utf-8");
+    }
+    list() {
+        return Object.entries(this.data.mcpServers)
+            .filter(([name]) => !name.startsWith("_comment"))
+            .map(([name, cfg]) => ({ name, ...cfg }));
+    }
+    get(name) {
+        const cfg = this.data.mcpServers[name];
+        if (!cfg)
+            return null;
+        return { name, ...cfg };
+    }
+    add(name, config) {
+        if (this.data.mcpServers[name]) {
+            throw new Error(`MCP server "${name}" already exists`);
+        }
+        this.data.mcpServers[name] = { ...config, enabled: config.enabled ?? true };
+        this.save();
+        log.info({ name, transport: config.command ? "stdio" : "http" }, "MCP server added");
+        return { name, ...this.data.mcpServers[name] };
+    }
+    update(name, updates) {
+        const existing = this.data.mcpServers[name];
+        if (!existing)
+            return null;
+        Object.assign(existing, updates);
+        this.save();
+        return { name, ...existing };
+    }
+    remove(name) {
+        if (!this.data.mcpServers[name])
+            return false;
+        delete this.data.mcpServers[name];
+        this.save();
+        log.info({ name }, "MCP server removed");
+        return true;
+    }
+    setEnabled(name, enabled) {
+        const existing = this.data.mcpServers[name];
+        if (!existing)
+            return false;
+        existing.enabled = enabled;
+        this.save();
+        return true;
+    }
+}
+//# sourceMappingURL=MCPStore.js.map

package/dist/mcp/MCPStore.js.map

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

package/dist/mcp/defaults.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Built-in MCP server catalog.
+ *
+ * Seeded into the user's `mcp.json` on first boot when the file doesn't
+ * exist. Everything ships **disabled** — the user enables individual
+ * servers via the `manage_mcp` tool or the Settings / MCP UI once the
+ * required credentials are filled in.
+ *
+ * Each entry also declares:
+ *   • `description` — one-line summary shown in the UI.
+ *   • `requiredEnv` — env-var names that must be non-empty before the
+ *     server can be activated. Lets the MCP page show a friendly
+ *     "Needs config" state and prompt for values before enabling.
+ */
+import type { MCPServerConfig } from "./MCPStore.js";
+export interface MCPArgField {
+    /** Positional index into `config.args` that this field occupies. */
+    readonly index: number;
+    /** Human label shown in the UI. */
+    readonly label: string;
+    /** One-line hint rendered below the input. */
+    readonly hint?: string;
+    /** "path" = directory picker, "text" = plain string. */
+    readonly kind?: "path" | "text";
+}
+export interface MCPDefault {
+    readonly description: string;
+    readonly config: MCPServerConfig;
+    /** Env vars that must be non-empty before the server can be activated. */
+    readonly requiredEnv?: readonly string[];
+    /**
+     * Positional args the user can customise (path, DB URL, etc.). The UI
+     * uses these to render inputs alongside the env form — the server
+     * is still activatable when the inline args default is reasonable,
+     * so `requiredArgs` doesn't gate activation, just surfaces an edit
+     * affordance.
+     */
+    readonly argFields?: readonly MCPArgField[];
+    /** URL of the project page — for UI "learn more" links. */
+    readonly docsUrl?: string;
+}
+export declare const MCP_DEFAULTS: Readonly<Record<string, MCPDefault>>;
+/** Backwards-compat export — the plain config map used by MCPStore seeding. */
+export declare const BUILTIN_MCP_SERVERS: Readonly<Record<string, MCPServerConfig>>;
+/** Look up required env keys for a built-in server. Returns empty array for unknown servers. */
+export declare function requiredEnvFor(name: string): readonly string[];
+/** Look up arg-field metadata (path / text positional args the user can edit). */
+export declare function argFieldsFor(name: string): readonly MCPArgField[];
+/** One-line description lookup. */
+export declare function descriptionFor(name: string): string | undefined;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/mcp/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/mcp/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA2M7D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAEzE,CAAC;AAEF,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE9D;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAEjE;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D"}

package/dist/mcp/defaults.js

@@ -0,0 +1,243 @@
+/**
+ * Built-in MCP server catalog.
+ *
+ * Seeded into the user's `mcp.json` on first boot when the file doesn't
+ * exist. Everything ships **disabled** — the user enables individual
+ * servers via the `manage_mcp` tool or the Settings / MCP UI once the
+ * required credentials are filled in.
+ *
+ * Each entry also declares:
+ *   • `description` — one-line summary shown in the UI.
+ *   • `requiredEnv` — env-var names that must be non-empty before the
+ *     server can be activated. Lets the MCP page show a friendly
+ *     "Needs config" state and prompt for values before enabling.
+ */
+import { homedir } from "node:os";
+/**
+ * Default filesystem path the agent's filesystem MCP server mounts.
+ * We prefer the user's home directory over the JS seed's
+ * `/Users/you/Projects` placeholder — that path doesn't exist on real
+ * machines and caused the server to crash on first activate. The user
+ * can narrow this via the UI (`argFields` below) once we land the
+ * activation dialog.
+ */
+const DEFAULT_FS_PATH = homedir();
+export const MCP_DEFAULTS = {
+    memory: {
+        description: "Persistent memory via knowledge graph. No API key needed.",
+        config: { command: "npx", args: ["-y", "@modelcontextprotocol/server-memory"], enabled: false },
+    },
+    filesystem: {
+        description: "Secure file access — set allowed directory paths in args.",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-filesystem", DEFAULT_FS_PATH],
+            enabled: false,
+        },
+        argFields: [
+            { index: 2, label: "Allowed directory", kind: "path", hint: "Absolute path the MCP server is allowed to read/write." },
+        ],
+    },
+    postgres: {
+        description: "PostgreSQL database access (read-only SQL).",
+        config: {
+            command: "npx",
+            args: [
+                "-y",
+                "@modelcontextprotocol/server-postgres",
+                "postgresql://user:pass@localhost:5432/mydb",
+            ],
+            enabled: false,
+        },
+        argFields: [
+            { index: 2, label: "Connection string", kind: "text", hint: "e.g. postgresql://user:pass@host:5432/db" },
+        ],
+    },
+    github: {
+        description: "GitHub — repos, PRs, issues, Actions, code search (OAuth, remote).",
+        docsUrl: "https://github.com/github/github-mcp-server",
+        config: {
+            // Remote HTTP MCP hosted by GitHub. The bearer is injected by
+            // MCPIntegrationBridge whenever a GitHub account is connected in
+            // Integrations, so users don't edit this entry by hand.
+            url: "https://api.githubcopilot.com/mcp",
+            headers: { Authorization: "Bearer ${INTEGRATION:github}" },
+            enabled: false,
+        },
+    },
+    "brave-search": {
+        description: "Brave Search — web, news, image search.",
+        docsUrl: "https://brave.com/search/api/",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-brave-search"],
+            env: { BRAVE_API_KEY: "" },
+            enabled: false,
+        },
+        requiredEnv: ["BRAVE_API_KEY"],
+    },
+    slack: {
+        description: "Slack workspace integration.",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-slack"],
+            env: { SLACK_BOT_TOKEN: "", SLACK_TEAM_ID: "" },
+            enabled: false,
+        },
+        requiredEnv: ["SLACK_BOT_TOKEN", "SLACK_TEAM_ID"],
+    },
+    puppeteer: {
+        description: "Browser automation, screenshots, web interaction.",
+        config: { command: "npx", args: ["-y", "@modelcontextprotocol/server-puppeteer"], enabled: false },
+    },
+    sentry: {
+        description: "Sentry error tracking — query issues, generate patches.",
+        config: {
+            command: "npx",
+            args: ["-y", "@sentry/mcp-server@latest"],
+            env: { SENTRY_AUTH_TOKEN: "" },
+            enabled: false,
+        },
+        requiredEnv: ["SENTRY_AUTH_TOKEN"],
+    },
+    "sequential-thinking": {
+        description: "Structured problem solving — step-by-step reasoning chains.",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-sequential-thinking"],
+            enabled: false,
+        },
+    },
+    notion: {
+        description: "Notion — pages, databases, search, comments (OAuth, remote).",
+        docsUrl: "https://developers.notion.com/docs/get-started-with-mcp",
+        config: {
+            // Remote HTTP MCP hosted by Notion. Bearer is injected by
+            // MCPIntegrationBridge after a Notion workspace is connected.
+            url: "https://mcp.notion.com/mcp",
+            headers: { Authorization: "Bearer ${INTEGRATION:notion}" },
+            enabled: false,
+        },
+    },
+    linear: {
+        description: "Linear — issues, projects, teams, sprints.",
+        config: { command: "npx", args: ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], enabled: false },
+    },
+    hubspot: {
+        description: "HubSpot CRM — contacts, deals, companies, tickets.",
+        config: {
+            command: "npx",
+            args: ["-y", "@hubspot/mcp-server"],
+            env: { PRIVATE_APP_ACCESS_TOKEN: "" },
+            enabled: false,
+        },
+        requiredEnv: ["PRIVATE_APP_ACCESS_TOKEN"],
+    },
+    stripe: {
+        description: "Stripe — payments, invoices, subscriptions, customers.",
+        config: {
+            command: "npx",
+            args: ["-y", "@stripe/mcp", "--tools=all"],
+            env: { STRIPE_SECRET_KEY: "" },
+            enabled: false,
+        },
+        requiredEnv: ["STRIPE_SECRET_KEY"],
+    },
+    jira: {
+        description: "Jira — issues, projects, sprints, JQL search.",
+        config: {
+            command: "npx",
+            args: ["-y", "@aashari/mcp-server-atlassian-jira"],
+            env: { ATLASSIAN_SITE_NAME: "", ATLASSIAN_USER_EMAIL: "", ATLASSIAN_API_TOKEN: "" },
+            enabled: false,
+        },
+        requiredEnv: ["ATLASSIAN_SITE_NAME", "ATLASSIAN_USER_EMAIL", "ATLASSIAN_API_TOKEN"],
+    },
+    confluence: {
+        description: "Confluence — spaces, pages, search, content.",
+        config: {
+            command: "npx",
+            args: ["-y", "@aashari/mcp-server-atlassian-confluence"],
+            env: { ATLASSIAN_SITE_NAME: "", ATLASSIAN_USER_EMAIL: "", ATLASSIAN_API_TOKEN: "" },
+            enabled: false,
+        },
+        requiredEnv: ["ATLASSIAN_SITE_NAME", "ATLASSIAN_USER_EMAIL", "ATLASSIAN_API_TOKEN"],
+    },
+    figma: {
+        description: "Figma — design data, layouts, styles, components.",
+        config: {
+            command: "npx",
+            args: ["-y", "figma-developer-mcp", "--figma-api-key=YOUR_FIGMA_TOKEN", "--stdio"],
+            enabled: false,
+        },
+    },
+    gdrive: {
+        description: "Google Drive — files, folders, search.",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-gdrive"],
+            env: { GDRIVE_CREDENTIALS_PATH: "" },
+            enabled: false,
+        },
+        requiredEnv: ["GDRIVE_CREDENTIALS_PATH"],
+    },
+    "google-maps": {
+        description: "Google Maps — geocoding, directions, places, elevation.",
+        config: {
+            command: "npx",
+            args: ["-y", "@modelcontextprotocol/server-google-maps"],
+            env: { GOOGLE_MAPS_API_KEY: "" },
+            enabled: false,
+        },
+        requiredEnv: ["GOOGLE_MAPS_API_KEY"],
+    },
+    firecrawl: {
+        description: "Firecrawl — web scraping, crawling, content extraction.",
+        config: {
+            command: "npx",
+            args: ["-y", "firecrawl-mcp"],
+            env: { FIRECRAWL_API_KEY: "" },
+            enabled: false,
+        },
+        requiredEnv: ["FIRECRAWL_API_KEY"],
+    },
+    tavily: {
+        description: "Tavily — real-time web search, data extraction.",
+        config: {
+            command: "npx",
+            args: ["-y", "tavily-mcp@latest"],
+            env: { TAVILY_API_KEY: "" },
+            enabled: false,
+        },
+        requiredEnv: ["TAVILY_API_KEY"],
+    },
+    cloudflare: {
+        description: "Cloudflare — Workers, KV, R2, D1 management.",
+        config: { command: "npx", args: ["-y", "@cloudflare/mcp-server-cloudflare"], enabled: false },
+    },
+    upstash: {
+        description: "Upstash — serverless Redis and message queues.",
+        config: {
+            command: "npx",
+            args: ["-y", "@upstash/mcp-server"],
+            env: { UPSTASH_REDIS_REST_URL: "", UPSTASH_REDIS_REST_TOKEN: "" },
+            enabled: false,
+        },
+        requiredEnv: ["UPSTASH_REDIS_REST_URL", "UPSTASH_REDIS_REST_TOKEN"],
+    },
+};
+/** Backwards-compat export — the plain config map used by MCPStore seeding. */
+export const BUILTIN_MCP_SERVERS = Object.fromEntries(Object.entries(MCP_DEFAULTS).map(([name, def]) => [name, def.config]));
+/** Look up required env keys for a built-in server. Returns empty array for unknown servers. */
+export function requiredEnvFor(name) {
+    return MCP_DEFAULTS[name]?.requiredEnv ?? [];
+}
+/** Look up arg-field metadata (path / text positional args the user can edit). */
+export function argFieldsFor(name) {
+    return MCP_DEFAULTS[name]?.argFields ?? [];
+}
+/** One-line description lookup. */
+export function descriptionFor(name) {
+    return MCP_DEFAULTS[name]?.description;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/mcp/defaults.js.map

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

package/dist/memory/DeclarativeMemoryStore.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DeclarativeMemoryStore — hermes-pattern two-file declarative memory.
+ *
+ *   data/memory/MEMORY.md   — your notes about the environment / project
+ *   data/memory/USER.md     — facts about the user
+ *
+ * Why two files, not one table:
+ *   - Human-editable. The user can open MEMORY.md and read it, fix it.
+ *   - Declarative format (one fact per entry, §-separated) discourages
+ *     task/TODO pollution.
+ *   - Char-bounded per target (USER: 1375, MEMORY: 2200). Full files
+ *     force the agent to prioritise what really matters — old items get
+ *     replaced rather than appended.
+ *   - Frozen snapshot at load() → mid-session writes DO touch disk but
+ *     the system-prompt copy doesn't change. Preserves the prefix cache
+ *     across an entire session.
+ *
+ * API mirrors hermes: add / replace / remove × target ∈ {memory, user}.
+ */
+export type MemoryTarget = "memory" | "user";
+export declare const CHAR_LIMITS: Readonly<Record<MemoryTarget, number>>;
+export declare const FILENAMES: Readonly<Record<MemoryTarget, string>>;
+export interface MemoryWriteResult {
+    readonly success: boolean;
+    readonly message: string;
+    readonly entryCount?: number;
+    readonly chars?: number;
+    readonly limit?: number;
+}
+export declare class DeclarativeMemoryStore {
+    private readonly memoryDir;
+    private entries;
+    private snapshot;
+    constructor(memoryDir: string);
+    /**
+     * Load from disk and capture a frozen system-prompt snapshot.
+     * Must be called before `formatForSystemPrompt`.
+     */
+    load(): Promise<void>;
+    /** Frozen system-prompt block. Empty string if the target is empty. */
+    formatForSystemPrompt(target: MemoryTarget): string;
+    add(target: MemoryTarget, content: string): Promise<MemoryWriteResult>;
+    replace(target: MemoryTarget, oldText: string, newContent: string): Promise<MemoryWriteResult>;
+    remove(target: MemoryTarget, oldText: string): Promise<MemoryWriteResult>;
+    listEntries(target: MemoryTarget): readonly string[];
+    private path;
+    private readFileEntries;
+    /** Atomic write via temp file + rename (safe under concurrent readers). */
+    private writeFileEntries;
+    private renderBlock;
+    private checkLimit;
+    private okResult;
+}
+//# sourceMappingURL=DeclarativeMemoryStore.d.ts.map

package/dist/memory/DeclarativeMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclarativeMemoryStore.d.ts","sourceRoot":"","sources":["../../src/memory/DeclarativeMemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAG9D,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAG5D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,OAAO,CAA4D;IAC3E,OAAO,CAAC,QAAQ,CAA0D;gBAE7C,SAAS,EAAE,MAAM;IAE9C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,uEAAuE;IACvE,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAI7C,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyBtE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqB9F,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc/E,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE;IAMpD,OAAO,CAAC,IAAI;YAIE,eAAe;IAc7B,2EAA2E;YAC7D,gBAAgB;IAe9B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;CAWjB"}