@atel-ai/runtime-core 0.1.0

package/dist/adapters/util.js

@@ -0,0 +1,86 @@
+/**
+ * 适配器共用工具:探可执行文件、读写 JSON/TOML 配置(浅合并,保留用户其他配置)。
+ */
+import { execFile } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+/** which/where 解析 bin 绝对路径;找不到返回 null。 */
+export function which(bin) {
+    const finder = process.platform === 'win32' ? 'where' : 'which';
+    return new Promise((resolve) => {
+        execFile(finder, [bin], { timeout: 5000 }, (err, stdout) => {
+            if (err)
+                return resolve(null);
+            const first = (stdout || '').split(/\r?\n/).map((s) => s.trim()).filter(Boolean)[0];
+            resolve(first || null);
+        });
+    });
+}
+/** 跑 `bin <args>` 取首行(探版本用);失败返回 null。 */
+export function runText(bin, args, timeoutMs = 8000) {
+    return new Promise((resolve) => {
+        execFile(bin, args, { timeout: timeoutMs }, (err, stdout, stderr) => {
+            if (err && !stdout && !stderr)
+                return resolve(null);
+            const out = ((stdout || '') + (stderr || '')).trim();
+            resolve(out || null);
+        });
+    });
+}
+export function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** 浅合并写回 JSON,保留文件已有的其他键。 */
+export function mergeJson(file, patch) {
+    const existing = readJson(file) || {};
+    const merged = deepMerge(existing, patch);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(merged, null, 2));
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) {
+        if (v && typeof v === 'object' && !Array.isArray(v) &&
+            out[k] && typeof out[k] === 'object' && !Array.isArray(out[k])) {
+            out[k] = deepMerge(out[k], v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+/** 极简 TOML 段写入:替换/追加 [section] 下的 key=value 块(够 codex mcp_servers 用)。 */
+export function writeTomlSection(file, section, body) {
+    let content = '';
+    try {
+        content = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        content = '';
+    }
+    const header = `[${section}]`;
+    const block = `${header}\n${body.trim()}\n`;
+    // 删除已存在的同名段(到下一个顶层 [ 或文件尾)
+    const lines = content.split(/\r?\n/);
+    const out = [];
+    let skip = false;
+    for (const line of lines) {
+        const isHeader = /^\[.+\]\s*$/.test(line.trim());
+        if (isHeader) {
+            skip = line.trim() === header;
+        }
+        if (!skip)
+            out.push(line);
+    }
+    let result = out.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+    result = (result ? result + '\n\n' : '') + block;
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, result);
+}
+//# sourceMappingURL=util.js.map

package/dist/adapters/util.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AuthManager —— JWT 生命周期(会真炸的坑,见 6.5 §6-1)。
+ *
+ * Claude/Codex/Hermes/Gemini 的 JWT 是写死在各自 MCP 配置文件里的,7 天到期即 401;
+ * A2A 单 deadline 也能 7 天。companion 持私钥:
+ *   到期前自动重签 → 换新 JWT → 重写该 runtime 的 MCP 配置 → 热重载/下次唤醒生效。
+ *
+ * 这里只管"拿 token + 到点重签 + 回调让适配器落配置";具体怎么写各家 MCP 配置
+ * 由适配器的 writeMcpConfig(token) 实现(格式各异)。
+ */
+import type { Identity } from './identity.js';
+export interface AuthHooks {
+    /** 拿到新 JWT 后写进该 runtime 的 MCP 配置(各家格式不同)。 */
+    onToken?: (token: string, expiresAt: number) => void | Promise<void>;
+    /** 写完配置后热重载(若 runtime 需要;CLI 类通常下次唤醒自动生效)。 */
+    reload?: () => void | Promise<void>;
+    /** 日志 */
+    log?: (msg: string) => void;
+}
+export declare class AuthManager {
+    private readonly identity;
+    private readonly spineBaseUrl;
+    private readonly hooks;
+    private readonly refreshLeadMs;
+    private current?;
+    private timer?;
+    private refreshing;
+    constructor(identity: Identity, spineBaseUrl: string, hooks?: AuthHooks, refreshLeadMs?: number);
+    /** 当前有效 JWT(可能为空,未 start 或刚失败)。 */
+    get token(): string | undefined;
+    get expiresAt(): number | undefined;
+    /** 首次换 token 并安排自动续期。返回首个 token。 */
+    start(): Promise<string>;
+    /** 立即重签换新 JWT,落配置,排下一次续期。 */
+    refresh(): Promise<string>;
+    /** 确保 token 有效(未到期);若已过/将过期则刷新。 */
+    ensureFresh(): Promise<string>;
+    private schedule;
+    stop(): void;
+    private log;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS;IACT,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IARhC,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAGR,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,SAAc,EACrB,aAAa,SAAiB;IAGjD,mCAAmC;IACnC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,oCAAoC;IAC9B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B,6BAA6B;IACvB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBhC,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAQpC,OAAO,CAAC,QAAQ;IAchB,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,GAAG;CAGZ"}

package/dist/auth.js

@@ -0,0 +1,91 @@
+import { spineIdentityVerify } from './client.js';
+export class AuthManager {
+    identity;
+    spineBaseUrl;
+    hooks;
+    refreshLeadMs;
+    current;
+    timer;
+    refreshing = false;
+    constructor(identity, spineBaseUrl, hooks = {}, refreshLeadMs = 60 * 60 * 1000) {
+        this.identity = identity;
+        this.spineBaseUrl = spineBaseUrl;
+        this.hooks = hooks;
+        this.refreshLeadMs = refreshLeadMs;
+    }
+    /** 当前有效 JWT(可能为空,未 start 或刚失败)。 */
+    get token() {
+        return this.current?.token;
+    }
+    get expiresAt() {
+        return this.current?.expiresAt;
+    }
+    /** 首次换 token 并安排自动续期。返回首个 token。 */
+    async start() {
+        const token = await this.refresh();
+        return token;
+    }
+    /** 立即重签换新 JWT,落配置,排下一次续期。 */
+    async refresh() {
+        if (this.refreshing) {
+            // 合并并发刷新
+            while (this.refreshing)
+                await sleep(50);
+            if (this.current)
+                return this.current.token;
+        }
+        this.refreshing = true;
+        try {
+            const res = await spineIdentityVerify(this.spineBaseUrl, this.identity);
+            this.current = res;
+            this.log(`JWT refreshed, expiresAt=${new Date(res.expiresAt).toISOString()}`);
+            if (this.hooks.onToken)
+                await this.hooks.onToken(res.token, res.expiresAt);
+            if (this.hooks.reload)
+                await this.hooks.reload();
+            this.schedule();
+            return res.token;
+        }
+        finally {
+            this.refreshing = false;
+        }
+    }
+    /** 确保 token 有效(未到期);若已过/将过期则刷新。 */
+    async ensureFresh() {
+        if (!this.current)
+            return this.refresh();
+        if (Date.now() >= this.current.expiresAt - this.refreshLeadMs) {
+            return this.refresh();
+        }
+        return this.current.token;
+    }
+    schedule() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        if (!this.current)
+            return;
+        const delay = Math.max(60_000, this.current.expiresAt - this.refreshLeadMs - Date.now());
+        this.timer = setTimeout(() => {
+            this.refresh().catch((e) => this.log(`refresh failed: ${e.message}; retry in 5m`));
+            if (!this.current || Date.now() >= this.current.expiresAt - this.refreshLeadMs) {
+                // 失败后兜底 5 分钟重试
+                this.timer = setTimeout(() => this.refresh().catch(() => { }), 5 * 60 * 1000);
+            }
+        }, delay);
+        if (this.timer.unref)
+            this.timer.unref();
+    }
+    stop() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+    log(msg) {
+        if (this.hooks.log)
+            this.hooks.log(`[atel/auth] ${msg}`);
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+import type { Identity } from './identity.js';
+export interface HttpResult {
+    ok: boolean;
+    status: number;
+    body: string;
+    json: unknown;
+}
+/** 带退避重试的 fetch(沿用 poll-loop fetchWithRetry:409 视为成功不重试)。 */
+export declare function fetchWithRetry(url: string, options: RequestInit, label: string, maxAttempts?: number): Promise<HttpResult>;
+/** POST 一个已签名的 SignedRequest 信封。 */
+export declare function postSigned<T>(baseUrl: string, pathname: string, identity: Identity, payload: T, label: string, extraHeaders?: Record<string, string>): Promise<HttpResult>;
+/** 带 Bearer JWT 的 POST(platform registry 用 JWT,不是签名信封)。 */
+export declare function postBearer<T>(baseUrl: string, pathname: string, jwt: string, payload: T, label: string): Promise<HttpResult>;
+/** POST /registry/v1/remote/register → 注册/更新本 agent(name + capabilities + discoverable)。 */
+export declare function registryRemoteRegister(platformBaseUrl: string, jwt: string, input: {
+    name: string;
+    description?: string;
+    capabilities: string[];
+    discoverable: boolean;
+}): Promise<HttpResult>;
+export interface VerifyResult {
+    token: string;
+    did: string;
+    expiresAt: number;
+}
+/** POST /identity/verify → JWT。 */
+export declare function spineIdentityVerify(spineBaseUrl: string, identity: Identity): Promise<VerifyResult>;
+/** POST /wallet/balance → 余额(DID-Sig)。 */
+export declare function spineWalletBalance(spineBaseUrl: string, identity: Identity): Promise<HttpResult>;
+/** POST /events/subscribe → 订阅点号领域事件(通道甲)。 */
+export declare function spineSubscribe(spineBaseUrl: string, identity: Identity, topics: string[], deliveryMode: 'sse' | 'webhook', callbackUrl?: string): Promise<HttpResult>;
+/**
+ * POST /events/stream-token → 取一次性 SSE 连接 token(DID-Sig)。
+ * 然后 GET /events/stream?token=<tok> 在 30s 内连上(spine stream_token.go)。
+ * 比把签名信封塞进 URL 更干净(避免进 nginx 日志/CDN 缓存)。
+ */
+export declare function spineStreamToken(spineBaseUrl: string, identity: Identity): Promise<{
+    token: string;
+    expiresAt?: string;
+}>;
+/** POST /relay/notify → 给某 DID 推消息(用于死信报警给 agent 主人)。 */
+export declare function spineRelayNotify(spineBaseUrl: string, identity: Identity, targetDid: string, message: unknown, kind?: string): Promise<HttpResult>;
+/** JWT 过期时间归一:服务端可能给秒级,这里统一成毫秒 epoch。 */
+export declare function normalizeExpiry(expiresAt: number | undefined): number;
+export interface RelayMessage {
+    id: string;
+    message: {
+        body?: unknown;
+    } & Record<string, unknown>;
+}
+/** POST /relay/v1/poll → 取下划线通知(通道乙)。 */
+export declare function relayPoll(platformBaseUrl: string, identity: Identity): Promise<RelayMessage[]>;
+/** POST /relay/v1/ack → 确认已消费(漏签会 401 循环,见 project_sdk_relay_ack_signing)。 */
+export declare function relayAck(platformBaseUrl: string, identity: Identity, ids: string[]): Promise<HttpResult>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,139 @@
+/**
+ * 签名 HTTP 客户端 —— 对 Spine 公开面 + platform relay 发 DID-Sig 请求。
+ * 只走公开面(MCP + Spine + relay),不 import platform internal、不连 DB、
+ * 不设 X-Internal-Secret(遵 START-HERE 三纪律)。
+ */
+import { signEnvelope } from './envelope.js';
+function trimSlash(u) {
+    return u.replace(/\/+$/, '');
+}
+/** 带退避重试的 fetch(沿用 poll-loop fetchWithRetry:409 视为成功不重试)。 */
+export async function fetchWithRetry(url, options, label, maxAttempts = 3) {
+    let lastErr = null;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const res = await fetch(url, options);
+            const body = await res.text().catch(() => '');
+            if (res.ok || res.status === 409) {
+                return { ok: res.ok, status: res.status, body, json: safeJson(body) };
+            }
+            if (attempt < maxAttempts - 1) {
+                await sleep((attempt + 1) * 2000);
+                continue;
+            }
+            return { ok: false, status: res.status, body, json: safeJson(body) };
+        }
+        catch (err) {
+            lastErr = err;
+            if (attempt < maxAttempts - 1) {
+                await sleep((attempt + 1) * 2000);
+                continue;
+            }
+        }
+    }
+    throw lastErr || new Error(`${label}: request failed`);
+}
+function safeJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** POST 一个已签名的 SignedRequest 信封。 */
+export async function postSigned(baseUrl, pathname, identity, payload, label, extraHeaders) {
+    const env = signEnvelope(identity, payload);
+    return fetchWithRetry(`${trimSlash(baseUrl)}${pathname}`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', ...(extraHeaders || {}) },
+        body: JSON.stringify(env),
+    }, label);
+}
+/** 带 Bearer JWT 的 POST(platform registry 用 JWT,不是签名信封)。 */
+export async function postBearer(baseUrl, pathname, jwt, payload, label) {
+    return fetchWithRetry(`${trimSlash(baseUrl)}${pathname}`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', Authorization: `Bearer ${jwt}` },
+        body: JSON.stringify(payload),
+    }, label);
+}
+/** POST /registry/v1/remote/register → 注册/更新本 agent(name + capabilities + discoverable)。 */
+export async function registryRemoteRegister(platformBaseUrl, jwt, input) {
+    return postBearer(platformBaseUrl, '/registry/v1/remote/register', jwt, input, 'registry/remote/register');
+}
+/** POST /identity/verify → JWT。 */
+export async function spineIdentityVerify(spineBaseUrl, identity) {
+    const r = await postSigned(spineBaseUrl, '/identity/verify', identity, {}, 'identity/verify');
+    if (!r.ok)
+        throw new Error(`identity/verify HTTP ${r.status}: ${r.body.slice(0, 200)}`);
+    const j = r.json;
+    if (!j?.token)
+        throw new Error(`identity/verify: no token in response: ${r.body.slice(0, 200)}`);
+    return { token: j.token, did: j.did || identity.did, expiresAt: normalizeExpiry(j.expiresAt) };
+}
+/** POST /wallet/balance → 余额(DID-Sig)。 */
+export async function spineWalletBalance(spineBaseUrl, identity) {
+    return postSigned(spineBaseUrl, '/wallet/balance', identity, {}, 'wallet/balance');
+}
+/** POST /events/subscribe → 订阅点号领域事件(通道甲)。 */
+export async function spineSubscribe(spineBaseUrl, identity, topics, deliveryMode, callbackUrl) {
+    const payload = { topics, deliveryMode };
+    if (deliveryMode === 'webhook') {
+        if (!callbackUrl)
+            throw new Error('webhook deliveryMode requires callbackUrl');
+        payload.callbackUrl = callbackUrl;
+    }
+    return postSigned(spineBaseUrl, '/events/subscribe', identity, payload, 'events/subscribe');
+}
+/**
+ * POST /events/stream-token → 取一次性 SSE 连接 token(DID-Sig)。
+ * 然后 GET /events/stream?token=<tok> 在 30s 内连上(spine stream_token.go)。
+ * 比把签名信封塞进 URL 更干净(避免进 nginx 日志/CDN 缓存)。
+ */
+export async function spineStreamToken(spineBaseUrl, identity) {
+    const r = await postSigned(spineBaseUrl, '/events/stream-token', identity, {}, 'events/stream-token');
+    if (!r.ok)
+        throw new Error(`events/stream-token HTTP ${r.status}: ${r.body.slice(0, 200)}`);
+    const j = r.json;
+    if (!j?.token)
+        throw new Error(`events/stream-token: no token: ${r.body.slice(0, 160)}`);
+    return { token: j.token, expiresAt: j.expiresAt };
+}
+/** POST /relay/notify → 给某 DID 推消息(用于死信报警给 agent 主人)。 */
+export async function spineRelayNotify(spineBaseUrl, identity, targetDid, message, kind = 'notify') {
+    // openapi: payload 必填 targetDid + message(不是 toDid)
+    return postSigned(spineBaseUrl, '/relay/notify', identity, { targetDid, message, kind }, 'relay/notify');
+}
+/** JWT 过期时间归一:服务端可能给秒级,这里统一成毫秒 epoch。 */
+export function normalizeExpiry(expiresAt) {
+    if (!expiresAt || typeof expiresAt !== 'number') {
+        return Date.now() + 7 * 24 * 60 * 60 * 1000; // 缺省按 7 天
+    }
+    // < 1e12 视为秒级
+    return expiresAt < 1e12 ? expiresAt * 1000 : expiresAt;
+}
+/** POST /relay/v1/poll → 取下划线通知(通道乙)。 */
+export async function relayPoll(platformBaseUrl, identity) {
+    const nonce = cryptoNonce();
+    const r = await postSigned(platformBaseUrl, '/relay/v1/poll', identity, { nonce }, 'relay/poll');
+    if (!r.ok)
+        throw new Error(`relay/poll HTTP ${r.status}: ${r.body.slice(0, 200)}`);
+    const data = r.json;
+    return Array.isArray(data?.messages) ? data.messages : [];
+}
+/** POST /relay/v1/ack → 确认已消费(漏签会 401 循环,见 project_sdk_relay_ack_signing)。 */
+export async function relayAck(platformBaseUrl, identity, ids) {
+    return postSigned(platformBaseUrl, '/relay/v1/ack', identity, { ids }, 'relay/ack');
+}
+function cryptoNonce() {
+    // 16 随机字节 hex,无需强随机(只防同窗口重放)
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < bytes.length; i++)
+        bytes[i] = Math.floor(Math.random() * 256);
+    return Buffer.from(bytes).toString('hex');
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/companion.d.ts

@@ -0,0 +1,45 @@
+import type { Identity } from './identity.js';
+import type { RuntimeConfig } from './config.js';
+import type { Waker } from './wakers/types.js';
+import { type AuthHooks } from './auth.js';
+export interface CompanionOpts {
+    identity: Identity;
+    config: RuntimeConfig;
+    waker: Waker;
+    /** 适配器写 MCP 配置(JWT 续期后调用) */
+    authHooks?: AuthHooks;
+    log?: (msg: string) => void;
+}
+export interface CompanionStats {
+    received: number;
+    deduped: number;
+    woken: number;
+    wakeOk: number;
+    wakeFail: number;
+    deadLetters: number;
+    activeOrders: number;
+}
+export declare class Companion {
+    private readonly opts;
+    private readonly auth;
+    private readonly dedup;
+    private readonly roles;
+    private readonly tracker;
+    private readonly queue;
+    private readonly dlq;
+    private relay;
+    private spine;
+    private autonomyTimer?;
+    private readonly stats;
+    constructor(opts: CompanionOpts);
+    start(): Promise<void>;
+    stop(): void;
+    /** webhook 模式入口:外部 HTTP 服务把回调事件喂进来。 */
+    ingestWebhook(raw: unknown): Promise<void>;
+    getStats(): CompanionStats;
+    private onEvent;
+    private executePlan;
+    private runAutonomy;
+    private log;
+}
+//# sourceMappingURL=companion.d.ts.map

package/dist/companion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../src/companion.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAWxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,6BAA6B;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,SAAS;IAoBR,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAQpB;gBAE2B,IAAI,EAAE,aAAa;IAa1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B,IAAI,IAAI,IAAI;IAOZ,uCAAuC;IACjC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,QAAQ,IAAI,cAAc;YAKZ,OAAO;YA+BP,WAAW;IA8BzB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,GAAG;CAGZ"}