antpath 0.1.0

package/dist/providers/types.d.ts

@@ -0,0 +1,42 @@
+import type { CleanupResult, CredentialInput, ProviderEvent, ProviderFile, ProviderResourceIds, UsageSummary } from "../types.js";
+import type { ResolvedTemplate } from "../template/compiler.js";
+export interface UploadFileInput {
+    filename: string;
+    data: Uint8Array;
+    mimeType?: string | undefined;
+}
+export interface SessionResourceInput {
+    type: "file";
+    fileId: string;
+    mountPath?: string | undefined;
+}
+export interface CreatedCredential {
+    id: string;
+}
+export interface ManagedAgentProvider {
+    createEnvironment(template: ResolvedTemplate): Promise<string>;
+    uploadFile(input: UploadFileInput): Promise<string>;
+    createAgent(template: ResolvedTemplate, providerSkillRefs: ProviderSkillRef[]): Promise<string>;
+    createVault(displayName: string, metadata?: Record<string, string>): Promise<string>;
+    createCredential(vaultId: string, serverUrl: string, credential: CredentialInput): Promise<CreatedCredential>;
+    createSession(agentId: string, environmentId: string, vaultIds: string[], resources: SessionResourceInput[]): Promise<string>;
+    sendUserMessage(sessionId: string, message: string): Promise<void>;
+    streamEvents(sessionId: string, signal?: AbortSignal): AsyncIterable<ProviderEvent>;
+    getSession(sessionId: string): Promise<{
+        status?: string | undefined;
+        usage?: UsageSummary | undefined;
+    }>;
+    listFiles(sessionId: string): Promise<ProviderFile[]>;
+    downloadFile(fileId: string): Promise<Uint8Array>;
+    terminateSession(sessionId: string, reason?: string): Promise<void>;
+    cleanup(ids: ProviderResourceIds, policy?: string): Promise<CleanupResult>;
+}
+export type ProviderSkillRef = {
+    type: "anthropic";
+    skill_id: string;
+    version?: string | undefined;
+} | {
+    type: "custom";
+    skill_id: string;
+    version?: string | undefined;
+};

package/dist/providers/types.js

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

package/dist/providers/types.js.map

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

package/dist/run/controller.d.ts

@@ -0,0 +1,27 @@
+import type { ManagedAgentProvider } from "../providers/types.js";
+import type { ResolvedTemplate } from "../template/compiler.js";
+import type { CleanupPolicy, CleanupResult, CredentialInput, DownloadOutputsOptions, DownloadOutputsResult, Logger, ProviderFile, RunEvent, RunResult, RunStatus, UsageSummary } from "../types.js";
+export interface RunControllerOptions {
+    provider: ManagedAgentProvider;
+    template: ResolvedTemplate;
+    credentials: Record<string, CredentialInput>;
+    cleanupPolicy: CleanupPolicy;
+    timeoutMs?: number | undefined;
+    signal?: AbortSignal | undefined;
+    logger?: Logger | undefined;
+}
+export declare class RunController {
+    #private;
+    constructor(options: RunControllerOptions);
+    start(): Promise<void>;
+    status(): RunStatus;
+    streamEvents(): AsyncIterable<RunEvent>;
+    wait(): Promise<RunResult>;
+    listFiles(): Promise<ProviderFile[]>;
+    downloadFile(fileId: string, destination: string): Promise<void>;
+    downloadOutputs(options: DownloadOutputsOptions | string): Promise<DownloadOutputsResult>;
+    cleanup(policy?: CleanupPolicy): Promise<CleanupResult>;
+    terminate(reason?: string): Promise<void>;
+    usage(): Promise<UsageSummary | undefined>;
+    result(): Promise<RunResult>;
+}

package/dist/run/controller.js

@@ -0,0 +1,224 @@
+import { CleanupError, RunStateError } from "../errors.js";
+import { downloadOutputs as downloadAllOutputs } from "../files/downloader.js";
+import { prepareSkills, toSessionResources } from "../skills/packager.js";
+import { AsyncEventBus } from "../utils/events.js";
+import { redactSecrets } from "../utils/secrets.js";
+export class RunController {
+    #provider;
+    #template;
+    #credentials;
+    #cleanupPolicy;
+    #timeoutMs;
+    #signal;
+    #logger;
+    #events = new AsyncEventBus();
+    #startedAt = new Date().toISOString();
+    #ids = { credentialIds: [], uploadedFileIds: [] };
+    #status = "initializing";
+    #messageIndex = 0;
+    #resultPromise;
+    #resolveResult;
+    #rejectResult;
+    #finalResult;
+    #outputManifest;
+    #cleanupState = "not_started";
+    #userTerminated = false;
+    constructor(options) {
+        this.#provider = options.provider;
+        this.#template = options.template;
+        this.#credentials = options.credentials;
+        this.#cleanupPolicy = options.cleanupPolicy;
+        this.#timeoutMs = options.timeoutMs;
+        this.#signal = options.signal;
+        this.#logger = options.logger;
+        this.#resultPromise = new Promise((resolve, reject) => {
+            this.#resolveResult = resolve;
+            this.#rejectResult = reject;
+        });
+    }
+    async start() {
+        this.#consume().catch((error) => {
+            this.#fail(error instanceof Error ? error : new RunStateError(String(error)));
+        });
+    }
+    status() {
+        return this.#status;
+    }
+    streamEvents() {
+        return this.#events.stream();
+    }
+    wait() {
+        return this.#resultPromise;
+    }
+    async listFiles() {
+        if (!this.#ids.sessionId) {
+            throw new RunStateError("Cannot list files before session is created");
+        }
+        return this.#provider.listFiles(this.#ids.sessionId);
+    }
+    async downloadFile(fileId, destination) {
+        const { dirname, basename } = await import("node:path");
+        const { writeFileSafe } = await import("../utils/paths.js");
+        const content = await this.#provider.downloadFile(fileId);
+        await writeFileSafe(dirname(destination), basename(destination), content);
+    }
+    async downloadOutputs(options) {
+        if (!this.#ids.sessionId) {
+            throw new RunStateError("Cannot download outputs before session is created");
+        }
+        this.#setStatus("downloading_outputs");
+        const result = await downloadAllOutputs(this.#provider, this.#ids.sessionId, typeof options === "string" ? { directory: options } : options);
+        this.#outputManifest = result.manifest;
+        return result;
+    }
+    async cleanup(policy = this.#cleanupPolicy) {
+        this.#cleanupState = "pending";
+        const result = await this.#provider.cleanup(this.#ids, policy);
+        this.#cleanupState = result.state;
+        for (const operation of result.operations) {
+            this.#emit({ type: "sdk.cleanup", operation: operation.operation, status: operation.status, error: operation.error, at: new Date().toISOString() });
+        }
+        if (result.state === "cleaned_up") {
+            this.#setStatus("cleaned_up");
+        }
+        if (result.state === "partial") {
+            throw new CleanupError("Cleanup partially failed", result.operations);
+        }
+        return result;
+    }
+    async terminate(reason) {
+        if (!this.#ids.sessionId) {
+            return;
+        }
+        this.#userTerminated = true;
+        this.#setStatus("terminating");
+        await this.#provider.terminateSession(this.#ids.sessionId, reason);
+        this.#finish("terminated");
+    }
+    async usage() {
+        if (!this.#ids.sessionId) {
+            return undefined;
+        }
+        return (await this.#provider.getSession(this.#ids.sessionId)).usage;
+    }
+    result() {
+        return this.wait();
+    }
+    async #consume() {
+        this.#setStatus("creating_provider_resources");
+        const prepared = await prepareSkills(this.#template);
+        this.#ids.environmentId = await this.#provider.createEnvironment(this.#template);
+        for (const upload of prepared.uploads) {
+            this.#ids.uploadedFileIds.push(await this.#provider.uploadFile(upload.input));
+        }
+        this.#ids.agentId = await this.#provider.createAgent(this.#template, prepared.providerSkillRefs);
+        if (Object.keys(this.#credentials).length > 0) {
+            this.#ids.vaultId = await this.#provider.createVault(`${this.#template.name}-${this.#template.hash.slice(0, 8)}`, {
+                antpath_template_hash: this.#template.hash
+            });
+            for (const server of this.#template.mcpServers) {
+                const credential = this.#credentials[server.key];
+                if (credential && this.#ids.vaultId) {
+                    const created = await this.#provider.createCredential(this.#ids.vaultId, server.url, credential);
+                    this.#ids.credentialIds.push(created.id);
+                }
+            }
+        }
+        this.#ids.sessionId = await this.#provider.createSession(this.#ids.agentId, this.#ids.environmentId, this.#ids.vaultId ? [this.#ids.vaultId] : [], toSessionResources(this.#ids.uploadedFileIds, prepared));
+        const abort = new AbortController();
+        this.#signal?.addEventListener("abort", () => abort.abort(this.#signal?.reason), { once: true });
+        const timeout = this.#timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => {
+                void this.terminate("timeout");
+            }, this.#timeoutMs);
+        try {
+            const stream = this.#provider.streamEvents(this.#ids.sessionId, abort.signal);
+            await this.#sendNextMessage();
+            for await (const event of stream) {
+                this.#emit({ type: "provider.event", event, at: new Date().toISOString() });
+                if (event.type === "session.error") {
+                    this.#fail(new RunStateError("Provider session.error event received", event));
+                    return;
+                }
+                if (event.type === "session.status_terminated") {
+                    this.#finish(this.#userTerminated ? "terminated" : "failed", this.#userTerminated ? undefined : "Provider session terminated");
+                    return;
+                }
+                if (event.type === "session.status_idle") {
+                    if (this.#messageIndex < this.#template.messages.length) {
+                        this.#setStatus("idle_waiting_to_send_next_message");
+                        await this.#sendNextMessage();
+                    }
+                    else {
+                        this.#finish("succeeded");
+                        return;
+                    }
+                }
+            }
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            abort.abort();
+            this.#events.close();
+        }
+    }
+    async #sendNextMessage() {
+        if (!this.#ids.sessionId) {
+            throw new RunStateError("Cannot send message before session is created");
+        }
+        const message = this.#template.messages[this.#messageIndex];
+        if (message === undefined) {
+            return;
+        }
+        this.#setStatus("running");
+        await this.#provider.sendUserMessage(this.#ids.sessionId, message);
+        this.#emit({ type: "sdk.message_sent", index: this.#messageIndex, at: new Date().toISOString() });
+        this.#messageIndex++;
+    }
+    async #buildResult(status, error) {
+        const session = this.#ids.sessionId ? await this.#provider.getSession(this.#ids.sessionId).catch(() => undefined) : undefined;
+        const result = {
+            status,
+            templateHash: this.#template.hash,
+            providerIds: { ...this.#ids, credentialIds: [...this.#ids.credentialIds], uploadedFileIds: [...this.#ids.uploadedFileIds] },
+            cleanupState: this.#cleanupState,
+            startedAt: this.#startedAt,
+            endedAt: new Date().toISOString()
+        };
+        if (session?.usage)
+            result.usage = session.usage;
+        if (error)
+            result.error = redactSecrets(error);
+        if (this.#outputManifest)
+            result.outputManifest = this.#outputManifest;
+        return result;
+    }
+    #setStatus(status) {
+        this.#status = status;
+        const event = { type: "sdk.status", status, at: new Date().toISOString() };
+        this.#emit(event);
+    }
+    #emit(event) {
+        this.#logger?.debug?.("antpath event", redactSecrets({ event }));
+        this.#events.emit(redactSecrets(event));
+    }
+    #finish(status, error) {
+        this.#setStatus(status);
+        this.#buildResult(status, error).then((result) => {
+            this.#finalResult = result;
+            this.#resolveResult(result);
+            this.#events.close();
+        }, this.#rejectResult);
+    }
+    #fail(error) {
+        this.#setStatus("failed");
+        this.#buildResult("failed", error.message).then((result) => {
+            this.#finalResult = result;
+            this.#resolveResult(result);
+            this.#events.close();
+        }, this.#rejectResult);
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/run/controller.js.map

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

package/dist/skills/packager.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedTemplate } from "../template/compiler.js";
+import type { SessionResourceInput, UploadFileInput, ProviderSkillRef } from "../providers/types.js";
+export interface PreparedSkills {
+    providerSkillRefs: ProviderSkillRef[];
+    uploads: Array<{
+        input: UploadFileInput;
+        mountPath: string;
+    }>;
+}
+export declare function prepareSkills(template: ResolvedTemplate): Promise<PreparedSkills>;
+export declare function toSessionResources(uploadedFileIds: string[], prepared: PreparedSkills): SessionResourceInput[];

package/dist/skills/packager.js

@@ -0,0 +1,76 @@
+import { readFile, stat, readdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { zipSync, strToU8 } from "fflate";
+export async function prepareSkills(template) {
+    const providerSkillRefs = [];
+    const uploads = [];
+    for (const skill of template.skills) {
+        if (skill.type === "anthropic") {
+            providerSkillRefs.push(skill.version ? { type: "anthropic", skill_id: skill.skillId, version: skill.version } : { type: "anthropic", skill_id: skill.skillId });
+        }
+        else if (skill.type === "custom") {
+            providerSkillRefs.push(skill.version ? { type: "custom", skill_id: skill.skillId, version: skill.version } : { type: "custom", skill_id: skill.skillId });
+        }
+        else if (skill.type === "inline") {
+            const filename = `${skill.name}.md`;
+            uploads.push({
+                mountPath: skill.mountPath ?? `/antpath/skills/${filename}`,
+                input: {
+                    filename,
+                    mimeType: "text/markdown",
+                    data: strToU8(skill.content)
+                }
+            });
+        }
+        else {
+            uploads.push({
+                mountPath: skill.mountPath ?? `/antpath/skills/${skill.name}.zip`,
+                input: await packageLocalSkill(skill)
+            });
+        }
+    }
+    return { providerSkillRefs, uploads };
+}
+export function toSessionResources(uploadedFileIds, prepared) {
+    return uploadedFileIds.map((fileId, index) => {
+        const resource = { type: "file", fileId };
+        const mountPath = prepared.uploads[index]?.mountPath;
+        if (mountPath)
+            resource.mountPath = mountPath;
+        return resource;
+    });
+}
+async function packageLocalSkill(skill) {
+    const pathStat = await stat(skill.path);
+    if (pathStat.isFile()) {
+        return {
+            filename: basename(skill.path),
+            data: await readFile(skill.path)
+        };
+    }
+    const entries = await collectFiles(skill.path);
+    const zipped = {};
+    for (const [relativePath, absolutePath] of entries) {
+        zipped[relativePath] = await readFile(absolutePath);
+    }
+    return {
+        filename: `${skill.name}.zip`,
+        mimeType: "application/zip",
+        data: zipSync(zipped)
+    };
+}
+async function collectFiles(root, current = root) {
+    const entries = await readdir(current, { withFileTypes: true });
+    const result = [];
+    for (const entry of entries) {
+        const absolute = join(current, entry.name);
+        if (entry.isDirectory()) {
+            result.push(...await collectFiles(root, absolute));
+        }
+        else if (entry.isFile()) {
+            result.push([absolute.slice(root.length + 1).replace(/\\/g, "/"), absolute]);
+        }
+    }
+    return result.sort(([a], [b]) => a.localeCompare(b));
+}
+//# sourceMappingURL=packager.js.map

package/dist/skills/packager.js.map

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

package/dist/template/compiler.d.ts

@@ -0,0 +1,28 @@
+import type { CredentialRequirement, EnvironmentDefinition, OutputDefinition, SkillDefinition, TemplateDefinition } from "./types.js";
+export interface ResolvedMcpServer {
+    key: string;
+    name: string;
+    url: string;
+    auth?: CredentialRequirement | undefined;
+    tools?: {
+        allow?: string[] | undefined;
+        deny?: string[] | undefined;
+    } | undefined;
+}
+export interface ResolvedTemplate {
+    name: string;
+    hash: string;
+    model: string | {
+        id: string;
+        speed?: "standard" | "fast";
+    };
+    system?: string | undefined;
+    messages: string[];
+    mcpServers: ResolvedMcpServer[];
+    environment: EnvironmentDefinition;
+    skills: SkillDefinition[];
+    outputs: Required<Pick<OutputDefinition, "recommendedPath">> & Omit<OutputDefinition, "recommendedPath">;
+    metadata: Record<string, string>;
+    credentialRequirements: Record<string, CredentialRequirement>;
+}
+export declare function compileTemplate(template: TemplateDefinition, variables?: Record<string, string>): ResolvedTemplate;

package/dist/template/compiler.js

@@ -0,0 +1,116 @@
+import { TemplateValidationError } from "../errors.js";
+import { containsSecretLikeValue } from "../utils/secrets.js";
+import { sha256, stableStringify } from "../utils/stable.js";
+const ESCAPED_OPEN = "\u0000ANTPATH_ESCAPED_OPEN\u0000";
+const VARIABLE_PATTERN = /{{\s*([A-Za-z_][A-Za-z0-9_]*)\s*}}/g;
+export function compileTemplate(template, variables = {}) {
+    assertTemplateShape(template);
+    const values = resolveVariableValues(template, variables);
+    const resolved = {
+        name: template.name,
+        model: resolveValue(template.model, values, template.variables ?? {}),
+        system: template.system === undefined ? undefined : resolveValue(template.system, values, template.variables ?? {}),
+        messages: template.messages.map((message) => resolveValue(message, values, template.variables ?? {})),
+        mcpServers: resolveMcpServers(template.mcpServers ?? {}, values, template.variables ?? {}),
+        environment: resolveValue(template.environment ?? {}, values, template.variables ?? {}),
+        skills: resolveValue(template.skills ?? [], values, template.variables ?? {}),
+        outputs: {
+            recommendedPath: "/antpath/outputs",
+            ...resolveValue(template.outputs ?? {}, values, template.variables ?? {})
+        },
+        metadata: resolveValue(template.metadata ?? {}, values, template.variables ?? {}),
+        credentialRequirements: {}
+    };
+    resolved.credentialRequirements = Object.fromEntries(resolved.mcpServers.filter((server) => server.auth).map((server) => [server.key, server.auth]));
+    scanForSecrets(resolved);
+    return {
+        ...resolved,
+        hash: sha256(stableStringify(resolved))
+    };
+}
+function assertTemplateShape(template) {
+    if (!template.name?.trim()) {
+        throw new TemplateValidationError("Template name is required");
+    }
+    if (!template.model) {
+        throw new TemplateValidationError("Template model is required");
+    }
+    if (!Array.isArray(template.messages) || template.messages.length === 0) {
+        throw new TemplateValidationError("Template must define at least one user message");
+    }
+    for (const [key, server] of Object.entries(template.mcpServers ?? {})) {
+        if (!/^[A-Za-z0-9_-]+$/.test(key)) {
+            throw new TemplateValidationError(`MCP server key '${key}' must use letters, numbers, underscores, or hyphens`);
+        }
+        if (server.tools?.allow && server.tools.deny) {
+            throw new TemplateValidationError(`MCP server '${key}' cannot define both allow and deny tool policies`);
+        }
+    }
+}
+function resolveVariableValues(template, variables) {
+    const definitions = template.variables ?? {};
+    const resolved = {};
+    for (const [key, definition] of Object.entries(definitions)) {
+        const value = variables[key] ?? definition.default;
+        if (value === undefined) {
+            continue;
+        }
+        if (typeof value !== "string") {
+            throw new TemplateValidationError(`Variable '${key}' must resolve to a string`);
+        }
+        resolved[key] = value;
+    }
+    for (const key of Object.keys(variables)) {
+        if (!definitions[key]) {
+            throw new TemplateValidationError(`Unknown Template variable '${key}'`);
+        }
+    }
+    return resolved;
+}
+function resolveMcpServers(servers, values, definitions) {
+    return Object.entries(servers).map(([key, server]) => {
+        const resolved = {
+            key,
+            name: key,
+            url: resolveValue(server.url, values, definitions ?? {})
+        };
+        if (server.auth)
+            resolved.auth = server.auth;
+        if (server.tools)
+            resolved.tools = resolveValue(server.tools, values, definitions ?? {});
+        return resolved;
+    });
+}
+function resolveValue(value, variables, definitions) {
+    if (typeof value === "string") {
+        return resolveString(value, variables, definitions);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => resolveValue(item, variables, definitions));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, resolveValue(item, variables, definitions)]));
+    }
+    return value;
+}
+function resolveString(input, variables, definitions) {
+    const protectedInput = input.replace(/\\{{/g, ESCAPED_OPEN);
+    const resolved = protectedInput.replace(VARIABLE_PATTERN, (_match, name) => {
+        if (!definitions[name]) {
+            throw new TemplateValidationError(`Unresolved Template variable '${name}'`);
+        }
+        const value = variables[name];
+        if (value === undefined) {
+            throw new TemplateValidationError(`Missing value for Template variable '${name}'`);
+        }
+        return value;
+    });
+    return resolved.replace(new RegExp(ESCAPED_OPEN, "g"), "{{");
+}
+function scanForSecrets(value) {
+    const serialized = stableStringify(value);
+    if (containsSecretLikeValue(serialized)) {
+        throw new TemplateValidationError("Template contains a secret-like value; pass secrets through typed credentials instead");
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/template/compiler.js.map

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

package/dist/template/index.d.ts

@@ -0,0 +1,10 @@
+import type { CredentialRequirement, TemplateDefinition, TemplateVariableDefinition } from "./types.js";
+export type { TemplateDefinition, TemplateVariableDefinition } from "./types.js";
+export { compileTemplate, type ResolvedTemplate } from "./compiler.js";
+export declare function defineTemplate<TVariables extends Record<string, TemplateVariableDefinition> = Record<string, never>>(definition: TemplateDefinition<TVariables>): TemplateDefinition<TVariables>;
+export declare function string(options?: {
+    default?: string;
+    description?: string;
+}): TemplateVariableDefinition;
+export declare function requiredStaticBearer(): CredentialRequirement;
+export declare function requiredOAuthAccessToken(): CredentialRequirement;

package/dist/template/index.js

@@ -0,0 +1,14 @@
+export { compileTemplate } from "./compiler.js";
+export function defineTemplate(definition) {
+    return Object.freeze(definition);
+}
+export function string(options = {}) {
+    return { type: "string", ...options };
+}
+export function requiredStaticBearer() {
+    return { type: "static_bearer", required: true };
+}
+export function requiredOAuthAccessToken() {
+    return { type: "oauth_access_token", required: true };
+}
+//# sourceMappingURL=index.js.map

package/dist/template/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAyB,MAAM,eAAe,CAAC;AAEvE,MAAM,UAAU,cAAc,CAC5B,UAA0C;IAE1C,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,UAAsD,EAAE;IAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}