@paperclipai/hermes-paperclip-adapter 0.3.0

package/dist/server/skills.js

@@ -0,0 +1,177 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { readPaperclipRuntimeSkillEntries, resolvePaperclipDesiredSkillNames, } from "@paperclipai/adapter-utils/server-utils";
+import { fileURLToPath } from "node:url";
+const __moduleDir = path.dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function resolveHermesHome(config) {
+    const env = typeof config.env === "object" && config.env !== null && !Array.isArray(config.env)
+        ? config.env
+        : {};
+    const configuredHome = asString(env.HOME);
+    return configuredHome ? path.resolve(configuredHome) : os.homedir();
+}
+function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const frontmatter = {};
+    for (const line of match[1].split("\n")) {
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim();
+        let val = line.slice(idx + 1).trim();
+        // Strip quotes
+        if (typeof val === "string" && ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'")))) {
+            val = val.slice(1, -1);
+        }
+        frontmatter[key] = val;
+    }
+    return frontmatter;
+}
+async function scanHermesSkills(skillsHome) {
+    const entries = [];
+    try {
+        const categories = await fs.readdir(skillsHome, { withFileTypes: true });
+        for (const cat of categories) {
+            if (!cat.isDirectory())
+                continue;
+            const catPath = path.join(skillsHome, cat.name);
+            // Check if the category directory itself has a SKILL.md (top-level skill)
+            const topLevelSkillMd = path.join(catPath, "SKILL.md");
+            if (await fs.stat(topLevelSkillMd).catch(() => null)) {
+                entries.push(await buildSkillEntry(cat.name, topLevelSkillMd, cat.name));
+            }
+            // Scan for sub-skills
+            const items = await fs.readdir(catPath, { withFileTypes: true }).catch(() => []);
+            for (const item of items) {
+                if (!item.isDirectory())
+                    continue;
+                const skillMd = path.join(catPath, item.name, "SKILL.md");
+                if (await fs.stat(skillMd).catch(() => null)) {
+                    const key = item.name;
+                    entries.push(await buildSkillEntry(key, skillMd, `${cat.name}/${item.name}`));
+                }
+            }
+        }
+    }
+    catch {
+        // ~/.hermes/skills/ doesn't exist — no skills available
+    }
+    return entries.sort((a, b) => a.key.localeCompare(b.key));
+}
+async function buildSkillEntry(key, skillMdPath, categoryPath) {
+    let description = null;
+    try {
+        const content = await fs.readFile(skillMdPath, "utf8");
+        const fm = parseSkillFrontmatter(content);
+        description = fm.description ?? null;
+    }
+    catch {
+        // ignore
+    }
+    return {
+        key,
+        runtimeName: key,
+        desired: true, // Hermes loads all available skills
+        managed: false,
+        state: "installed",
+        origin: "user_installed",
+        originLabel: "Hermes skill",
+        locationLabel: `~/.hermes/skills/${categoryPath}`,
+        readOnly: true, // Hermes manages its own skills — Paperclip can't toggle them
+        sourcePath: skillMdPath,
+        targetPath: null,
+        detail: description,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+async function buildHermesSkillSnapshot(config) {
+    const home = resolveHermesHome(config);
+    const hermesSkillsHome = path.join(home, ".hermes", "skills");
+    // 1. Scan Paperclip-managed skills (bundled with the adapter)
+    const paperclipEntries = await readPaperclipRuntimeSkillEntries(config, __moduleDir);
+    const desiredSkills = resolvePaperclipDesiredSkillNames(config, paperclipEntries);
+    const desiredSet = new Set(desiredSkills);
+    const availableByKey = new Map(paperclipEntries.map((e) => [e.key, e]));
+    // 2. Scan Hermes's own skills from ~/.hermes/skills/
+    const hermesSkillEntries = await scanHermesSkills(hermesSkillsHome);
+    const hermesKeys = new Set(hermesSkillEntries.map((e) => e.key));
+    // 3. Merge: Paperclip skills first (ephemeral), then Hermes skills
+    const entries = [];
+    const warnings = [];
+    // Paperclip-managed skills
+    for (const entry of paperclipEntries) {
+        const desired = desiredSet.has(entry.key);
+        entries.push({
+            key: entry.key,
+            runtimeName: entry.runtimeName,
+            desired,
+            managed: true,
+            state: desired ? "configured" : "available",
+            origin: "company_managed",
+            originLabel: "Managed by Paperclip",
+            readOnly: false,
+            sourcePath: entry.source,
+            targetPath: null,
+            detail: desired
+                ? "Will be available on the next run via Hermes skill loading."
+                : null,
+        });
+    }
+    // Hermes-installed skills (read-only, always loaded)
+    for (const entry of hermesSkillEntries) {
+        // Skip if Paperclip already manages a skill with the same key
+        if (availableByKey.has(entry.key))
+            continue;
+        entries.push(entry);
+    }
+    // Check for desired skills that don't exist
+    for (const desiredSkill of desiredSkills) {
+        if (availableByKey.has(desiredSkill) || hermesKeys.has(desiredSkill))
+            continue;
+        warnings.push(`Desired skill "${desiredSkill}" is not available in Paperclip or Hermes skills.`);
+        entries.push({
+            key: desiredSkill,
+            runtimeName: null,
+            desired: true,
+            managed: true,
+            state: "missing",
+            origin: "external_unknown",
+            originLabel: "External or unavailable",
+            readOnly: false,
+            sourcePath: null,
+            targetPath: null,
+            detail: "Cannot find this skill in Paperclip or ~/.hermes/skills/.",
+        });
+    }
+    return {
+        adapterType: "hermes_local",
+        supported: true,
+        mode: "persistent",
+        desiredSkills,
+        entries,
+        warnings,
+    };
+}
+export async function listHermesSkills(ctx) {
+    return buildHermesSkillSnapshot(ctx.config);
+}
+export async function syncHermesSkills(ctx, _desiredSkills) {
+    // Hermes manages its own skill loading — sync is a no-op.
+    // Return the current snapshot so the UI stays in sync.
+    return buildHermesSkillSnapshot(ctx.config);
+}
+export function resolveHermesDesiredSkillNames(config, availableEntries) {
+    return resolvePaperclipDesiredSkillNames(config, availableEntries);
+}
+//# sourceMappingURL=skills.js.map

package/dist/server/skills.js.map

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

package/dist/server/test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Environment test for the Hermes Agent adapter.
+ *
+ * Verifies that Hermes Agent is installed, accessible, and configured
+ * before allowing the adapter to be used.
+ */
+import type { AdapterEnvironmentTestContext, AdapterEnvironmentTestResult } from "@paperclipai/adapter-utils";
+export declare function testEnvironment(ctx: AdapterEnvironmentTestContext): Promise<AdapterEnvironmentTestResult>;
+//# sourceMappingURL=test.d.ts.map

package/dist/server/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/server/test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAE7B,MAAM,4BAA4B,CAAC;AA4TpC,wBAAsB,eAAe,CACnC,GAAG,EAAE,6BAA6B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAyDvC"}

package/dist/server/test.js

@@ -0,0 +1,341 @@
+/**
+ * Environment test for the Hermes Agent adapter.
+ *
+ * Verifies that Hermes Agent is installed, accessible, and configured
+ * before allowing the adapter to be used.
+ */
+import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { promisify } from "node:util";
+import { ADAPTER_TYPE, VALID_PROVIDERS } from "../shared/constants.js";
+import { detectModel, resolveProvider } from "./detect-model.js";
+import { resolveHermesCommand } from "./execute.js";
+const execFileAsync = promisify(execFile);
+function asString(v) {
+    return typeof v === "string" ? v : undefined;
+}
+// ---------------------------------------------------------------------------
+// Checks
+// ---------------------------------------------------------------------------
+async function checkCliInstalled(command) {
+    try {
+        // Try to run the command to see if it exists
+        await execFileAsync(command, ["--version"], { timeout: 10_000 });
+        return null; // OK — it ran successfully
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            return {
+                level: "error",
+                message: `Hermes CLI "${command}" not found in PATH`,
+                hint: "Install Hermes Agent: pip install hermes-agent",
+                code: "hermes_cli_not_found",
+            };
+        }
+        // Command exists but --version might have failed for some reason
+        // Still consider it installed
+        return null;
+    }
+}
+async function checkCliVersion(command) {
+    try {
+        const { stdout } = await execFileAsync(command, ["--version"], {
+            timeout: 10_000,
+        });
+        const version = stdout.trim();
+        if (version) {
+            return {
+                level: "info",
+                message: `Hermes Agent version: ${version}`,
+                code: "hermes_version",
+            };
+        }
+        return {
+            level: "warn",
+            message: "Could not determine Hermes Agent version",
+            code: "hermes_version_unknown",
+        };
+    }
+    catch {
+        return {
+            level: "warn",
+            message: "Could not determine Hermes Agent version (hermes --version failed)",
+            hint: "Make sure the hermes CLI is properly installed and functional",
+            code: "hermes_version_failed",
+        };
+    }
+}
+async function checkPython() {
+    try {
+        const { stdout } = await execFileAsync("python3", ["--version"], {
+            timeout: 5_000,
+        });
+        const version = stdout.trim();
+        const match = version.match(/(\d+)\.(\d+)/);
+        if (match) {
+            const major = parseInt(match[1], 10);
+            const minor = parseInt(match[2], 10);
+            if (major < 3 || (major === 3 && minor < 10)) {
+                return {
+                    level: "error",
+                    message: `Python ${version} found — Hermes requires Python 3.10+`,
+                    hint: "Upgrade Python to 3.10 or later",
+                    code: "hermes_python_old",
+                };
+            }
+        }
+        return null; // OK
+    }
+    catch {
+        return {
+            level: "warn",
+            message: "python3 not found in PATH",
+            hint: "Hermes Agent requires Python 3.10+. Install it from python.org",
+            code: "hermes_python_missing",
+        };
+    }
+}
+function checkModel(config) {
+    const model = asString(config.model);
+    if (!model) {
+        return {
+            level: "info",
+            message: "No model specified — Hermes will use its configured default model",
+            hint: "Set a model explicitly in Paperclip only if you want to override your local Hermes configuration.",
+            code: "hermes_configured_default_model",
+        };
+    }
+    return {
+        level: "info",
+        message: `Model: ${model}`,
+        code: "hermes_model_configured",
+    };
+}
+async function checkApiKeys(config, detectedConfig) {
+    // The server resolves secret refs into config.env before calling testEnvironment,
+    // so we check config.env first (adapter-configured secrets), then fall back to
+    // process.env (server/host environment), then ~/.hermes/.env (Hermes local config).
+    const envConfig = (config.env ?? {});
+    const resolvedEnv = {};
+    for (const [key, value] of Object.entries(envConfig)) {
+        if (typeof value === "string" && value.length > 0)
+            resolvedEnv[key] = value;
+    }
+    // Also read ~/.hermes/.env — Hermes stores API keys there by default and does
+    // not export them to the parent process, so Paperclip's process.env won't
+    // contain them.  Parsing this file ensures the environment test reports
+    // accurate results for keys that Hermes already knows about.
+    const hermesEnvKeys = {};
+    try {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || "/root";
+        const hermesEnvPath = `${homeDir}/.hermes/.env`;
+        const content = readFileSync(hermesEnvPath, "utf-8");
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eqIdx = trimmed.indexOf("=");
+            if (eqIdx > 0) {
+                const key = trimmed.substring(0, eqIdx).trim();
+                const value = trimmed.substring(eqIdx + 1).trim();
+                if (value.length > 0)
+                    hermesEnvKeys[key] = value;
+            }
+        }
+    }
+    catch {
+        // ~/.hermes/.env may not exist — that's fine
+    }
+    const has = (key) => !!(resolvedEnv[key] ?? process.env[key] ?? hermesEnvKeys[key]);
+    const hasAnthropic = has("ANTHROPIC_API_KEY");
+    const hasOpenRouter = has("OPENROUTER_API_KEY");
+    const hasOpenAI = has("OPENAI_API_KEY");
+    const hasZai = has("ZAI_API_KEY");
+    const hasKimi = has("KIMI_API_KEY");
+    const hasMiniMax = has("MINIMAX_API_KEY");
+    const providers = [];
+    if (hasAnthropic)
+        providers.push("Anthropic");
+    if (hasOpenRouter)
+        providers.push("OpenRouter");
+    if (hasOpenAI)
+        providers.push("OpenAI");
+    if (hasZai)
+        providers.push("Z.AI");
+    if (hasKimi)
+        providers.push("Kimi");
+    if (hasMiniMax)
+        providers.push("MiniMax");
+    if (providers.length > 0) {
+        return {
+            level: "info",
+            message: `API keys found: ${providers.join(", ")}`,
+            code: "hermes_api_keys_found",
+        };
+    }
+    const requestedModel = asString(config.model);
+    const supportedProviders = VALID_PROVIDERS;
+    const modelMatchesRequested = !!detectedConfig?.model &&
+        (!requestedModel || detectedConfig.model.toLowerCase() === requestedModel.toLowerCase());
+    const matchingHermesConfigApiKey = !!detectedConfig?.hasApiKey &&
+        modelMatchesRequested;
+    if (matchingHermesConfigApiKey && detectedConfig) {
+        const providerLabel = detectedConfig.provider.trim();
+        if (!providerLabel) {
+            return {
+                level: "info",
+                message: "Hermes config includes an API key for the requested model via ~/.hermes/config.yaml without an explicit provider",
+                hint: "Skipping the built-in API-key warning because Hermes can use model.api_key from the local Hermes config.",
+                code: "hermes_api_key_in_config",
+            };
+        }
+        if (!supportedProviders.includes(providerLabel)) {
+            return {
+                level: "info",
+                message: `Hermes config includes runtime settings for unsupported adapter provider "${providerLabel}" via ~/.hermes/config.yaml`,
+                hint: "Skipping the built-in API-key warning because Hermes can resolve this provider at runtime.",
+                code: "hermes_custom_provider_config",
+            };
+        }
+        return {
+            level: "info",
+            message: `Hermes config includes an API key for provider "${providerLabel}" via ~/.hermes/config.yaml`,
+            hint: "Skipping the built-in API-key warning because Hermes can use model.api_key from the local Hermes config.",
+            code: "hermes_api_key_in_config",
+        };
+    }
+    return {
+        level: "warn",
+        message: "No LLM API keys found in environment",
+        hint: "Set API keys in the agent's env secrets or ~/.hermes/.env. Hermes supports: ANTHROPIC_API_KEY, OPENROUTER_API_KEY, OPENAI_API_KEY, ZAI_API_KEY, KIMI_API_KEY, MINIMAX_API_KEY",
+        code: "hermes_no_api_keys",
+    };
+}
+/**
+ * Check provider/model consistency.
+ * Warns if the configured provider might be wrong for the model.
+ */
+async function checkProviderConsistency(config, detectedConfig) {
+    const model = asString(config.model);
+    if (!model)
+        return null;
+    const explicitProvider = asString(config.provider);
+    const { provider: resolved, resolvedFrom } = resolveProvider({
+        explicitProvider,
+        detectedProvider: detectedConfig?.provider,
+        detectedModel: detectedConfig?.model,
+        detectedBaseUrl: detectedConfig?.baseUrl,
+        detectedHasApiKey: detectedConfig?.hasApiKey,
+        detectedApiMode: detectedConfig?.apiMode,
+        model,
+    });
+    // If provider was explicitly set but doesn't match what Hermes config says,
+    // that's worth flagging.
+    if (explicitProvider && detectedConfig?.provider && explicitProvider !== detectedConfig.provider) {
+        return {
+            level: "warn",
+            message: `Provider mismatch: adapterConfig has "${explicitProvider}" but ~/.hermes/config.yaml has "${detectedConfig.provider}". Using adapterConfig value.`,
+            hint: `Model "${model}" may not work correctly with provider "${explicitProvider}". Consider aligning with your Hermes config or removing the explicit provider to use auto-detection.`,
+            code: "hermes_provider_mismatch",
+        };
+    }
+    // If Hermes config matches the requested model but uses an adapter-unsupported
+    // provider such as "custom", do not report a false provider inference.
+    if (!explicitProvider && resolvedFrom.startsWith("hermesConfigUnsupported:")) {
+        const unsupportedProvider = resolvedFrom.split(":", 2)[1] || detectedConfig?.provider || "unknown";
+        return {
+            level: "info",
+            message: `Hermes config uses unsupported adapter provider "${unsupportedProvider}" for model "${model}" — deferring to Hermes auto-detection`,
+            hint: "Paperclip will avoid model-name provider inference here and let Hermes resolve the provider from ~/.hermes/config.yaml at runtime.",
+            code: "hermes_provider_unsupported",
+        };
+    }
+    // If matching Hermes config provides runtime signals without an explicit provider,
+    // also defer to Hermes rather than inventing a provider from the model name.
+    if (!explicitProvider && resolvedFrom === "hermesConfigRuntime") {
+        return {
+            level: "info",
+            message: `Hermes config provides runtime settings for model "${model}" without an explicit adapter provider — deferring to Hermes auto-detection`,
+            hint: "Paperclip will avoid model-name provider inference here and let Hermes resolve the provider from ~/.hermes/config.yaml at runtime.",
+            code: "hermes_provider_runtime_config",
+        };
+    }
+    // If provider was auto-detected (not explicitly set), log what was resolved
+    if (!explicitProvider && resolvedFrom !== "auto") {
+        return {
+            level: "info",
+            message: `Provider auto-detected as "${resolved}" (from ${resolvedFrom}) for model "${model}"`,
+            code: "hermes_provider_detected",
+        };
+    }
+    // If we couldn't resolve any provider, warn
+    if (resolvedFrom === "auto" && !explicitProvider) {
+        return {
+            level: "warn",
+            message: `Could not determine provider for model "${model}" — will use Hermes auto-detection`,
+            hint: "Set an explicit provider in the agent config or ensure ~/.hermes/config.yaml has a matching provider for this model.",
+            code: "hermes_provider_unknown",
+        };
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Main test
+// ---------------------------------------------------------------------------
+export async function testEnvironment(ctx) {
+    const config = (ctx.config ?? {});
+    const command = resolveHermesCommand(config);
+    const checks = [];
+    // 1. CLI installed?
+    const cliCheck = await checkCliInstalled(command);
+    if (cliCheck) {
+        checks.push(cliCheck);
+        if (cliCheck.level === "error") {
+            return {
+                adapterType: ADAPTER_TYPE,
+                status: "fail",
+                checks,
+                testedAt: new Date().toISOString(),
+            };
+        }
+    }
+    // 2. CLI version
+    const versionCheck = await checkCliVersion(command);
+    if (versionCheck)
+        checks.push(versionCheck);
+    // 3. Python available?
+    const pythonCheck = await checkPython();
+    if (pythonCheck)
+        checks.push(pythonCheck);
+    // 4. Model config
+    const modelCheck = checkModel(config);
+    if (modelCheck)
+        checks.push(modelCheck);
+    // 5. Detect Hermes config once for the remaining checks.
+    let detectedConfig = null;
+    try {
+        detectedConfig = await detectModel();
+    }
+    catch {
+        // Non-fatal
+    }
+    // 6. API keys (check config.env — server resolves secrets before calling us)
+    const apiKeyCheck = await checkApiKeys(config, detectedConfig);
+    if (apiKeyCheck)
+        checks.push(apiKeyCheck);
+    // 7. Provider/model consistency
+    const providerCheck = await checkProviderConsistency(config, detectedConfig);
+    if (providerCheck)
+        checks.push(providerCheck);
+    // Determine overall status
+    const hasErrors = checks.some((c) => c.level === "error");
+    const hasWarnings = checks.some((c) => c.level === "warn");
+    return {
+        adapterType: ADAPTER_TYPE,
+        status: hasErrors ? "fail" : hasWarnings ? "warn" : "pass",
+        checks,
+        testedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=test.js.map

package/dist/server/test.js.map

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

package/dist/shared/constants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shared constants for the Hermes Agent adapter.
+ */
+/** Adapter type identifier registered with Paperclip. */
+export declare const ADAPTER_TYPE = "hermes_local";
+/** Human-readable label shown in the Paperclip UI. */
+export declare const ADAPTER_LABEL = "Hermes Agent";
+/** Default CLI binary name. */
+export declare const HERMES_CLI = "hermes";
+/** Default timeout for a single execution run (seconds). */
+export declare const DEFAULT_TIMEOUT_SEC = 1800;
+/** Grace period after SIGTERM before SIGKILL (seconds). */
+export declare const DEFAULT_GRACE_SEC = 10;
+/**
+ * Default model to use if none specified.
+ *
+ * Use "auto" so that Hermes resolves the model from the user's local
+ * ~/.hermes/config.yaml — preventing the adapter from overriding a
+ * user's configured default (e.g. MiniMax, OpenRouter, etc.) with a
+ * hardcoded Anthropic model during Paperclip onboarding.
+ */
+export declare const DEFAULT_MODEL = "auto";
+/**
+ * Valid --provider choices for the hermes CLI.
+ * Must stay in sync with `hermes chat --help`.
+ */
+export declare const VALID_PROVIDERS: readonly ["auto", "openrouter", "nous", "openai-codex", "copilot", "copilot-acp", "anthropic", "huggingface", "zai", "kimi-coding", "minimax", "minimax-cn", "kilocode"];
+/**
+ * Model-name prefix → provider hint mapping.
+ * Used when no explicit provider is configured and we need to infer
+ * the correct provider from the model string alone.
+ *
+ * Keys are lowercased prefix patterns; values must be valid provider names.
+ * Longer prefixes are matched first (order matters).
+ */
+export declare const MODEL_PREFIX_PROVIDER_HINTS: [string, string][];
+/** Regex to extract session ID from Hermes CLI output. */
+export declare const SESSION_ID_REGEX: RegExp;
+/** Regex to extract token usage from Hermes output. */
+export declare const TOKEN_USAGE_REGEX: RegExp;
+/** Regex to extract cost from Hermes output. */
+export declare const COST_REGEX: RegExp;
+/** Prefix used by Hermes for tool output lines. */
+export declare const TOOL_OUTPUT_PREFIX = "\u250A";
+/** Prefix for Hermes thinking blocks. */
+export declare const THINKING_PREFIX = "\uD83D\uDCAD";
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,sDAAsD;AACtD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,+BAA+B;AAC/B,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,eAAe,0KAclB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EA8BzD,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,QAAmD,CAAC;AAEjF,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,QACqC,CAAC;AAEpE,gDAAgD;AAChD,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAM,CAAC;AAEtC,yCAAyC;AACzC,eAAO,MAAM,eAAe,iBAAO,CAAC"}