@allin-ai/agent-client 0.1.0

package/dist/plugins/manager.js

@@ -0,0 +1,328 @@
+import { access, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import path from "node:path";
+import { PLATFORM_IDS } from "../runtime/types.js";
+import { validateCapabilityEntries } from "../capabilities/manifest.js";
+import { createGitClient, isAllowedGitOrigin } from "./git.js";
+import { isValidPluginId, parsePluginManifest } from "./manifest.js";
+function now() {
+    return new Date().toISOString();
+}
+function hasRuntime(value) {
+    return (typeof value === "string" && PLATFORM_IDS.includes(value));
+}
+function pluginRoot(pluginsRoot, id) {
+    return path.join(pluginsRoot, id);
+}
+function activePointerPath(pluginsRoot, id) {
+    return path.join(pluginRoot(pluginsRoot, id), "active.json");
+}
+function revisionPath(pluginsRoot, id, commit) {
+    return path.join(pluginRoot(pluginsRoot, id), "revisions", commit);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isKnownCommit(value) {
+    return /^[0-9a-f]{40}$/i.test(value);
+}
+function normalizeConfig(config) {
+    if (!isValidPluginId(config.id)) {
+        throw new TypeError(`Plugin id ${String(config.id)} is invalid`);
+    }
+    if (typeof config.gitUrl !== "string" || config.gitUrl.length === 0) {
+        throw new TypeError(`Plugin ${config.id} must declare a Git URL`);
+    }
+    if (config.ref !== undefined &&
+        (typeof config.ref !== "string" ||
+            !config.ref.trim() ||
+            config.ref.trim().startsWith("-") ||
+            config.ref.includes("\0"))) {
+        throw new TypeError(`Plugin ${config.id} ref must be a nonempty non-option string`);
+    }
+    if (typeof config.enabled !== "boolean") {
+        throw new TypeError(`Plugin ${config.id} enabled must be a boolean`);
+    }
+    if (config.runtimes !== undefined &&
+        (!Array.isArray(config.runtimes) ||
+            !config.runtimes.every(hasRuntime) ||
+            new Set(config.runtimes).size !== config.runtimes.length)) {
+        throw new TypeError(`Plugin ${config.id} has invalid runtimes`);
+    }
+    return {
+        ...config,
+        ref: config.ref?.trim(),
+        runtimes: config.runtimes ? [...config.runtimes] : undefined,
+    };
+}
+function assertManifestCompatibility(config, manifest) {
+    if (manifest.id !== config.id) {
+        throw new Error(`Plugin manifest id ${manifest.id} does not match configured id ${config.id}`);
+    }
+    if (config.runtimes &&
+        manifest.runtimes &&
+        config.runtimes.some((runtime) => !manifest.runtimes?.includes(runtime))) {
+        throw new Error(`Plugin ${config.id} requests runtimes not declared by its manifest`);
+    }
+}
+async function exists(file) {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reconciles Hub Git desired state into local, immutable plugin revisions.
+ * Activation changes a small same-directory pointer only after the complete
+ * checkout and its manifest have been validated.
+ */
+export class PluginManager {
+    options;
+    git;
+    validateGitUrl;
+    locks = new Map();
+    statuses = new Map();
+    activePlugins = new Map();
+    constructor(options) {
+        this.options = options;
+        this.git = options.git ?? createGitClient();
+        this.validateGitUrl =
+            options.validateGitUrl ??
+                ((gitUrl) => isAllowedGitOrigin(gitUrl, options.allowedGitOrigins ?? []));
+        for (const state of options.stateStore?.listPluginStates() ?? []) {
+            this.statuses.set(state.plugin.id, state.plugin);
+            if (state.active)
+                this.activePlugins.set(state.active.id, state.active);
+        }
+    }
+    async sync(desired) {
+        const ids = new Set();
+        for (const config of desired) {
+            if (ids.has(config.id)) {
+                throw new TypeError(`Duplicate plugin id in desired state: ${config.id}`);
+            }
+            ids.add(config.id);
+        }
+        const results = await Promise.all(desired.map((config) => this.withPluginLock(config.id, () => this.syncOne(config))));
+        for (const id of [...this.activePlugins.keys()]) {
+            if (!ids.has(id))
+                await this.withPluginLock(id, () => this.deactivate(id, "removed from desired state"));
+        }
+        return results;
+    }
+    active(runtime) {
+        return [...this.activePlugins.values()]
+            .filter((plugin) => plugin.status === "active" &&
+            plugin.enabled &&
+            (plugin.runtimes === undefined || plugin.runtimes.includes(runtime)))
+            .sort((left, right) => left.id.localeCompare(right.id));
+    }
+    status(id) {
+        return this.statuses.get(id) ?? null;
+    }
+    snapshotActivePlugins(runtime) {
+        const plugins = runtime
+            ? this.active(runtime)
+            : [...this.activePlugins.values()].filter((plugin) => plugin.status === "active" && plugin.enabled);
+        return plugins
+            .map(({ id, resolvedCommit }) => ({ id, resolvedCommit }))
+            .sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async syncOne(input) {
+        let config;
+        try {
+            config = normalizeConfig(input);
+            if (!this.validateGitUrl(config.gitUrl)) {
+                throw new TypeError("Plugin Git URL must use HTTPS or SSH and pass local origin policy");
+            }
+            if (!config.enabled) {
+                await this.deactivate(config.id, "disabled by desired state");
+                const prior = this.statuses.get(config.id);
+                if (prior)
+                    return prior;
+                const blocked = {
+                    ...config,
+                    resolvedCommit: "unresolved",
+                    installedAt: now(),
+                    status: "blocked",
+                    lastError: "disabled by desired state",
+                };
+                this.save({ plugin: blocked, active: null });
+                return blocked;
+            }
+            const staging = await this.createStagingDirectory();
+            try {
+                await this.checkout(staging, config);
+                const manifest = await this.readManifest(staging);
+                await validateCapabilityEntries(staging, manifest.capabilities ?? []);
+                assertManifestCompatibility(config, manifest);
+                const resolvedCommit = await this.resolveCommit(staging);
+                const active = await this.activate(config, resolvedCommit, staging);
+                this.save({ plugin: active, active });
+                return active;
+            }
+            catch (error) {
+                await rm(staging, { recursive: true, force: true });
+                throw error;
+            }
+        }
+        catch (error) {
+            const configForFailure = config ?? input;
+            const failed = this.failed(configForFailure, errorMessage(error));
+            this.save({
+                plugin: failed,
+                active: this.activePlugins.get(configForFailure.id) ?? null,
+            });
+            return failed;
+        }
+    }
+    async checkout(staging, config) {
+        await this.git.run([
+            "clone",
+            "--no-checkout",
+            "--",
+            config.gitUrl,
+            staging,
+        ]);
+        if (config.ref) {
+            await this.git.run([
+                "-C",
+                staging,
+                "fetch",
+                "--force",
+                "origin",
+                config.ref,
+            ]);
+            await this.git.run([
+                "-C",
+                staging,
+                "checkout",
+                "--detach",
+                "--force",
+                config.ref,
+            ]);
+        }
+        else {
+            await this.git.run([
+                "-C",
+                staging,
+                "checkout",
+                "--detach",
+                "--force",
+                "HEAD",
+            ]);
+        }
+    }
+    async resolveCommit(staging) {
+        const commit = await this.git.run([
+            "-C",
+            staging,
+            "rev-parse",
+            "--verify",
+            "--end-of-options",
+            "HEAD^{commit}",
+        ]);
+        if (!isKnownCommit(commit)) {
+            throw new Error("Git did not resolve the plugin revision to a full commit");
+        }
+        return commit.toLowerCase();
+    }
+    async readManifest(staging) {
+        let raw;
+        try {
+            raw = JSON.parse(await readFile(path.join(staging, "allinai-plugin.json"), "utf8"));
+        }
+        catch (error) {
+            throw new Error(`Plugin manifest could not be read: ${errorMessage(error)}`);
+        }
+        const manifest = parsePluginManifest(raw);
+        if (!manifest)
+            throw new Error("Plugin manifest is invalid");
+        return manifest;
+    }
+    async activate(config, resolvedCommit, staging) {
+        const root = pluginRoot(this.options.pluginsRoot, config.id);
+        const revision = revisionPath(this.options.pluginsRoot, config.id, resolvedCommit);
+        await mkdir(path.dirname(revision), { recursive: true });
+        if (await exists(revision)) {
+            await rm(staging, { recursive: true, force: true });
+        }
+        else {
+            await rename(staging, revision);
+        }
+        const plugin = {
+            ...config,
+            resolvedCommit,
+            installedAt: now(),
+            status: "active",
+        };
+        const pointer = activePointerPath(this.options.pluginsRoot, config.id);
+        const temporaryPointer = path.join(root, `.active-${process.pid}-${Date.now()}.json`);
+        await writeFile(temporaryPointer, JSON.stringify({ plugin }), {
+            encoding: "utf8",
+            mode: 0o600,
+        });
+        await rename(temporaryPointer, pointer);
+        this.activePlugins.set(config.id, plugin);
+        return plugin;
+    }
+    failed(config, lastError) {
+        const previous = this.activePlugins.get(config.id) ?? this.statuses.get(config.id);
+        return {
+            ...config,
+            resolvedCommit: previous?.resolvedCommit ?? "unresolved",
+            installedAt: previous?.installedAt ?? now(),
+            status: "failed",
+            lastError,
+        };
+    }
+    async deactivate(id, reason) {
+        const active = this.activePlugins.get(id);
+        if (!active)
+            return;
+        await rm(activePointerPath(this.options.pluginsRoot, id), { force: true });
+        this.activePlugins.delete(id);
+        this.save({
+            plugin: {
+                ...active,
+                enabled: false,
+                status: "blocked",
+                lastError: reason,
+            },
+            active: null,
+        });
+    }
+    save(state) {
+        this.statuses.set(state.plugin.id, state.plugin);
+        if (state.active)
+            this.activePlugins.set(state.active.id, state.active);
+        this.options.stateStore?.savePluginState(state);
+    }
+    async createStagingDirectory() {
+        await mkdir(this.options.pluginsRoot, { recursive: true });
+        const base = path.join(this.options.pluginsRoot, ".staging-");
+        const { mkdtemp } = await import("node:fs/promises");
+        return mkdtemp(base);
+    }
+    async withPluginLock(id, work) {
+        const previous = this.locks.get(id) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        const tail = previous.then(() => current);
+        this.locks.set(id, tail);
+        await previous;
+        try {
+            return await work();
+        }
+        finally {
+            release?.();
+            if (this.locks.get(id) === tail)
+                this.locks.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,EAAE,EACF,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAkB,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAuBrE,SAAS,GAAG;IACV,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAmB,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,EAAU;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB,EAAE,EAAU;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,YAAY,CAAC,WAAmB,EAAE,EAAU,EAAE,MAAc;IACnE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,CAAC,EAAE,yBAAyB,CAAC,CAAC;IACpE,CAAC;IACD,IACE,MAAM,CAAC,GAAG,KAAK,SAAS;QACxB,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC7B,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,UAAU,MAAM,CAAC,EAAE,2CAA2C,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,CAAC,EAAE,4BAA4B,CAAC,CAAC;IACvE,CAAC;IACD,IACE,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC7B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC9B,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;YAClC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3D,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAClE,CAAC;IACD,OAAO;QACL,GAAG,MAAM;QACT,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,MAAoB,EACpB,QAAwB;IAExB,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,CAAC,EAAE,iCAAiC,MAAM,CAAC,EAAE,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,QAAQ;QACf,QAAQ,CAAC,QAAQ;QACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,EACxE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,UAAU,MAAM,CAAC,EAAE,iDAAiD,CACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAOK;IANZ,GAAG,CAAY;IACf,cAAc,CAA8B;IAC5C,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC9C,aAAa,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEpE,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;QACxD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAC5C,IAAI,CAAC,cAAc;YACjB,OAAO,CAAC,cAAc;gBACtB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,MAAM;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CACjB,yCAAyC,MAAM,CAAC,EAAE,EAAE,CACrD,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAC3D,CACF,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,CACjC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAClD,CAAC;QACN,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,OAAmB;QACxB,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aACpC,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,MAAM,KAAK,QAAQ;YAC1B,MAAM,CAAC,OAAO;YACd,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CACvE;aACA,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,qBAAqB,CAAC,OAAoB;QACxC,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACtB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACrC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CACzD,CAAC;QACN,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;aACzD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAmB;QACvC,IAAI,MAAgC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,SAAS,CACjB,mEAAmE,CACpE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC3C,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAC;gBACxB,MAAM,OAAO,GAAoB;oBAC/B,GAAG,MAAM;oBACT,cAAc,EAAE,YAAY;oBAC5B,WAAW,EAAE,GAAG,EAAE;oBAClB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,2BAA2B;iBACvC,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7C,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;gBACtE,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC9C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;gBACpE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBACtC,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,gBAAgB,GAAG,MAAM,IAAI,KAAK,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC;gBACR,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,IAAI;aAC5D,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAoB;QAC1D,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACjB,OAAO;YACP,eAAe;YACf,IAAI;YACJ,MAAM,CAAC,MAAM;YACb,OAAO;SACR,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBACjB,IAAI;gBACJ,OAAO;gBACP,OAAO;gBACP,SAAS;gBACT,QAAQ;gBACR,MAAM,CAAC,GAAG;aACX,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBACjB,IAAI;gBACJ,OAAO;gBACP,UAAU;gBACV,UAAU;gBACV,SAAS;gBACT,MAAM,CAAC,GAAG;aACX,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBACjB,IAAI;gBACJ,OAAO;gBACP,UAAU;gBACV,UAAU;gBACV,SAAS;gBACT,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAe;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAChC,IAAI;YACJ,OAAO;YACP,WAAW;YACX,UAAU;YACV,kBAAkB;YAClB,eAAe;SAChB,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,OAAe;QACxC,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CACd,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,EAAE,MAAM,CAAC,CACvD,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sCAAsC,YAAY,CAAC,KAAK,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,MAAoB,EACpB,cAAsB,EACtB,OAAe;QAEf,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,YAAY,CAC3B,IAAI,CAAC,OAAO,CAAC,WAAW,EACxB,MAAM,CAAC,EAAE,EACT,cAAc,CACf,CAAC;QACF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAoB;YAC9B,GAAG,MAAM;YACT,cAAc;YACd,WAAW,EAAE,GAAG,EAAE;YAClB,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,IAAI,EACJ,WAAW,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAC5C,CAAC;QACF,MAAM,SAAS,CACb,gBAAgB,EAChB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAA0B,CAAC,EAClD;YACE,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,KAAK;SACZ,CACF,CAAC;QACF,MAAM,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,MAAoB,EAAE,SAAiB;QACpD,MAAM,QAAQ,GACZ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,GAAG,MAAM;YACT,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,YAAY;YACxD,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,GAAG,EAAE;YAC3C,MAAM,EAAE,QAAQ;YAChB,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,MAAc;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,MAAM;aAClB;YACD,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAEO,IAAI,CAAC,KAGZ;QACC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,EAAU,EACV,IAAsB;QAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACzD,IAAI,OAAiC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,9 @@
+import type { PluginManifest } from "./types.js";
+/**
+ * Parse the installation manifest before any revision can become active.
+ * Capability schema details become stricter in the capability layer, but an
+ * installer still checks that every declaration has a safe fixed entrypoint.
+ */
+export declare function parsePluginManifest(value: unknown): PluginManifest | null;
+export declare function isValidPluginId(value: unknown): value is string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugins/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,YAAY,CAAC;AAuC9E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAsBzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D"}

package/dist/plugins/manifest.js

@@ -0,0 +1,63 @@
+import { PLATFORM_IDS } from "../runtime/types.js";
+import { parseShellCapability } from "../capabilities/manifest.js";
+const PLUGIN_ID = /^[a-z0-9][a-z0-9._-]{0,127}$/;
+function isPlainObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function isPluginId(value) {
+    return typeof value === "string" && PLUGIN_ID.test(value);
+}
+function isRuntime(value) {
+    return (typeof value === "string" && PLATFORM_IDS.includes(value));
+}
+function parseCapabilities(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        return null;
+    const seen = new Set();
+    const parsed = [];
+    for (const capability of value) {
+        const parsedCapability = parseShellCapability(capability);
+        if (!parsedCapability || seen.has(parsedCapability.id)) {
+            return null;
+        }
+        seen.add(parsedCapability.id);
+        parsed.push(parsedCapability);
+    }
+    return parsed;
+}
+/**
+ * Parse the installation manifest before any revision can become active.
+ * Capability schema details become stricter in the capability layer, but an
+ * installer still checks that every declaration has a safe fixed entrypoint.
+ */
+export function parsePluginManifest(value) {
+    if (!isPlainObject(value) || !isPluginId(value.id))
+        return null;
+    let runtimes;
+    if (value.runtimes !== undefined) {
+        if (!Array.isArray(value.runtimes) ||
+            !value.runtimes.every(isRuntime) ||
+            new Set(value.runtimes).size !== value.runtimes.length) {
+            return null;
+        }
+        runtimes = [...value.runtimes];
+    }
+    const capabilities = parseCapabilities(value.capabilities);
+    if (capabilities === null)
+        return null;
+    const manifest = { id: value.id };
+    if (runtimes)
+        manifest.runtimes = runtimes;
+    if (value.capabilities !== undefined)
+        manifest.capabilities = capabilities;
+    return manifest;
+}
+export function isValidPluginId(value) {
+    return isPluginId(value);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,39 @@
+import type { PlatformId } from "../runtime/types.js";
+import type { ShellCapability } from "../capabilities/types.js";
+export type PluginConfig = {
+    id: string;
+    gitUrl: string;
+    ref?: string;
+    enabled: boolean;
+    runtimes?: PlatformId[];
+};
+export type PluginCapabilityDeclaration = ShellCapability;
+export type PluginManifest = {
+    id: string;
+    runtimes?: PlatformId[];
+    capabilities?: PluginCapabilityDeclaration[];
+};
+export type InstalledPlugin = PluginConfig & {
+    resolvedCommit: string;
+    installedAt: string;
+    status: "active" | "blocked" | "failed";
+    lastError?: string;
+};
+export type ActivePluginSnapshot = {
+    id: string;
+    resolvedCommit: string;
+};
+/**
+ * Durable plugin records are intentionally separate from an active pointer:
+ * a failed update must be visible while the last validated checkout remains
+ * runnable.
+ */
+export type StoredPluginState = {
+    plugin: InstalledPlugin;
+    active: InstalledPlugin | null;
+};
+export type PluginStateStore = {
+    listPluginStates(): StoredPluginState[];
+    savePluginState(state: StoredPluginState): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;IACxC,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjD,CAAC"}

package/dist/plugins/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":""}

package/dist/runtime/claude.d.ts

@@ -0,0 +1,30 @@
+import { type CanUseTool, type Options, type Query, type SDKMessage, type SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
+import type { PlatformEvent, PlatformProbe } from "./types.js";
+/** Re-exported so host wrappers can consume the opaque vendor payload safely. */
+export type ClaudeSdkMessage = SDKMessage;
+export type ClaudeAdapterRunInput = {
+    prompt: string | AsyncIterable<SDKUserMessage>;
+    /** Domain/host prepares provider and plugin settings before crossing this boundary. */
+    options: Omit<Options, "abortController" | "canUseTool">;
+    /** Host-owned tool decision bridge. The adapter never imports a host package. */
+    onAskUser?: CanUseTool;
+};
+export type ClaudeQueryFactory = (parameters: {
+    prompt: string | AsyncIterable<SDKUserMessage>;
+    options?: Options;
+}) => Query;
+export type ClaudeAdapter = {
+    readonly id: "claude";
+    probe(): Promise<PlatformProbe>;
+    start(input: ClaudeAdapterRunInput, signal: AbortSignal): AsyncIterable<PlatformEvent>;
+};
+export type CreateClaudeAdapterDeps = {
+    /** Test seam. Production invokes the installed official Claude Agent SDK. */
+    query?: ClaudeQueryFactory;
+};
+/**
+ * Official Claude Agent SDK adapter. SDK setup/iteration and process cleanup
+ * stay here; provider selection and host callbacks are explicit input.
+ */
+export declare function createClaudeAdapter(deps?: CreateClaudeAdapterDeps): ClaudeAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/runtime/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/runtime/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC/C,uFAAuF;IACvF,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC;IACzD,iFAAiF;IACjF,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE;IAC5C,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAK,KAAK,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,CACH,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,aAAa,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAuHF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,uBAA4B,GACjC,aAAa,CAkEf"}