opensquid 0.5.441 → 0.5.449

package/dist/chat/gateway.d.ts

@@ -1,176 +0,0 @@
-/**
- * Chat gateway — unified surface for bot-style chat connections (v0.7).
- *
- * Three concrete adapters plug into this interface: Telegram, Discord,
- * Slack. Each is independently activatable via a token in
- * `~/.opensquid/config.json` `chat_connections.<platform>.bot_token`.
- * Adapters that don't have a token configured are skipped at startup —
- * opensquid works fine with zero, one, or all three chat platforms wired.
- *
- * Scope decisions (per [[find-simple-solutions]]):
- * - Single bot owner per platform (no multi-tenancy, no OAuth flows).
- *   The user runs their OWN bot with their OWN token.
- * - Bot owner is the only authorized chat participant by default.
- *   Allowlist of additional chat/channel/user ids in config.
- * - Outbound-only connection mechanism (long-poll, WebSocket, Socket
- *   Mode) — no inbound HTTP server, no webhook URL, no public
- *   ingress required. Works behind any NAT.
- * - Text-only messages in v0.7. Images / files / inline buttons
- *   deferred until concrete user-need surfaces.
- *
- * Why a gateway abstraction at all (vs per-platform code paths):
- * the opensquid-side MCP tool surface (`chat.send`, `chat.list_channels`,
- * the inbound-message → MCP-context bridge) should NOT care which
- * platform a message came from. The gateway normalizes incoming events
- * to a single `ChatMessage` shape and routes outgoing sends by
- * channel id.
- *
- * What is NOT in this file:
- * - Token storage / config loading (lives in `chat/config.ts`).
- * - The actual SDK calls (live in `chat/adapters/<platform>.ts`).
- * - The MCP tool wiring (lives in `chat/mcp-tools.ts`).
- *
- * What IS in this file: types + the `ChatGateway` orchestrator that
- * holds N adapters and presents a single send/subscribe API.
- */
-/** Stable platform identifier. */
-export type ChatPlatform = "telegram" | "discord" | "slack";
-/**
- * A logical destination for outbound messages. The shape varies by
- * platform but always normalizes to a single string id from opensquid's
- * point of view. Adapters parse the id back to platform-native form
- * (Telegram chat_id, Discord channel snowflake, Slack channel id).
- *
- * Format: `<platform>:<native_id>`, e.g. `telegram:8075471258`.
- */
-export type ChannelId = string;
-/** Normalized inbound message (platform-agnostic shape). */
-export interface ChatMessage {
-    /** Stable id from the platform (snowflake / message_id / ts). */
-    id: string;
-    /**
-     * Optional thread / topic id for platforms that support sub-threads
-     * within a single channel (Telegram forum topics, Discord threads).
-     * Preserved on inbound so the daemon can route to per-topic projects;
-     * preserved on outbound so replies thread correctly. v0.7.2.
-     */
-    threadId?: string;
-    /** Which platform delivered this. */
-    platform: ChatPlatform;
-    /** Channel the message was posted in (DM, group, server channel). */
-    channel: ChannelId;
-    /** Display name of the sender (best-effort; falls back to user id). */
-    sender: string;
-    /** Native sender id (preserved for allowlist checks + replies). */
-    senderId: string;
-    /** Message body, text only in v0.7. */
-    text: string;
-    /** Wall-clock the platform stamped the message with. */
-    receivedAt: Date;
-    /** True when the message contains @-mention or trigger-word for the bot. */
-    mentionsBot: boolean;
-}
-/**
- * Outbound message payload — text-only in v0.7. `replyTo` populates
- * platform-specific threading metadata where it's free (Telegram
- * `reply_to_message_id`, Slack `thread_ts`, Discord `message_reference`).
- */
-export interface OutboundMessage {
-    channel: ChannelId;
-    text: string;
-    /** Source message id to reply-thread under (best-effort per platform). */
-    replyTo?: string;
-    /**
-     * Optional thread / topic id for platforms that support sub-threads
-     * within a single channel:
-     *
-     * - **Telegram**: `message_thread_id` for forum topics (a supergroup
-     *   with Topics enabled has multiple topic threads, each one a
-     *   separate logical channel within the same chat_id). v0.7.2.
-     * - **Discord**: thread id for thread messages.
-     * - **Slack**: not used (Slack threading is via `replyTo` only).
-     *
-     * Adapters that don't support thread_id ignore it.
-     */
-    threadId?: string;
-}
-/** Result of a single send. Adapter-defined fields preserved opaquely. */
-export interface SendResult {
-    platform: ChatPlatform;
-    /** Native id of the delivered message — for future edit / delete / react. */
-    messageId: string;
-    /** Wall-clock the platform stamped the delivered message with. */
-    deliveredAt: Date;
-}
-/** Inbound message handler. Async return for await-based pipelines. */
-export type MessageHandler = (msg: ChatMessage) => Promise<void> | void;
-/**
- * What every chat adapter must implement. Adapter authors hold the
- * platform-specific SDK / WebSocket / long-poll loop; this interface
- * is the only surface opensquid touches.
- *
- * Lifecycle:
- *   1. `start()` — open the connection (login, attach handlers).
- *      Resolves when ready to receive + send. Throws on auth failure.
- *   2. `onMessage(handler)` — subscribe to inbound events. Multiple
- *      subscriptions stack; all fire per message in registration order.
- *   3. `send(message)` — push outbound. Throws on permanent failures
- *      (channel doesn't exist, bot kicked); transient errors are
- *      retried internally per the adapter's policy.
- *   4. `shutdown()` — close the connection cleanly. Idempotent.
- *
- * `identity()` returns the bot's own user info (username + native id) —
- * used by the gateway to recognize self-authored messages and to
- * resolve @-mention tokens to bot identity.
- */
-export interface ChatAdapter {
-    /** Platform identifier this adapter handles. */
-    readonly platform: ChatPlatform;
-    start(): Promise<void>;
-    shutdown(): Promise<void>;
-    onMessage(handler: MessageHandler): void;
-    send(message: OutboundMessage): Promise<SendResult>;
-    identity(): Promise<{
-        username: string;
-        nativeId: string;
-    }>;
-}
-/**
- * Holds N adapters and presents the unified API. Construct with the
- * adapter array you want active for this opensquid process. Pre-wired
- * tokens live in config; the factory at `chat/factory.ts` builds the
- * adapter array based on which tokens are present.
- */
-export declare class ChatGateway {
-    private readonly adapters;
-    private readonly handlers;
-    private started;
-    constructor(adapters: ChatAdapter[]);
-    /** Open all adapter connections in parallel. First failure surfaces. */
-    start(): Promise<void>;
-    /** Close all adapter connections. Errors are logged and swallowed
-     * so shutdown is always best-effort. */
-    shutdown(): Promise<void>;
-    /** Subscribe to inbound messages from any platform. */
-    onMessage(handler: MessageHandler): void;
-    /** Route an outbound message to the right adapter by `channel` prefix. */
-    send(message: OutboundMessage): Promise<SendResult>;
-    /** List the platforms currently wired up. Used by `chat.list_channels`. */
-    activePlatforms(): ChatPlatform[];
-    /**
-     * v0.7.2 — get the active adapter for a platform so daemon-internal
-     * code paths (e.g. `chat-daemon-worker` RPC dispatch) can reach
-     * platform-specific methods like Telegram's `createTopic`. Returns
-     * undefined when the platform isn't activated.
-     */
-    getAdapter(platform: ChatPlatform): ChatAdapter | undefined;
-    private dispatch;
-}
-export declare class ChatGatewayError extends Error {
-    readonly hint?: string | undefined;
-    constructor(message: string, hint?: string | undefined);
-}
-export declare function formatChannelId(platform: ChatPlatform, nativeId: string): ChannelId;
-export declare function platformFromChannel(channel: ChannelId): ChatPlatform;
-export declare function nativeIdFromChannel(channel: ChannelId): string;
-//# sourceMappingURL=gateway.d.ts.map

package/dist/chat/gateway.d.ts.map

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

package/dist/chat/gateway.js

@@ -1,146 +0,0 @@
-/**
- * Chat gateway — unified surface for bot-style chat connections (v0.7).
- *
- * Three concrete adapters plug into this interface: Telegram, Discord,
- * Slack. Each is independently activatable via a token in
- * `~/.opensquid/config.json` `chat_connections.<platform>.bot_token`.
- * Adapters that don't have a token configured are skipped at startup —
- * opensquid works fine with zero, one, or all three chat platforms wired.
- *
- * Scope decisions (per [[find-simple-solutions]]):
- * - Single bot owner per platform (no multi-tenancy, no OAuth flows).
- *   The user runs their OWN bot with their OWN token.
- * - Bot owner is the only authorized chat participant by default.
- *   Allowlist of additional chat/channel/user ids in config.
- * - Outbound-only connection mechanism (long-poll, WebSocket, Socket
- *   Mode) — no inbound HTTP server, no webhook URL, no public
- *   ingress required. Works behind any NAT.
- * - Text-only messages in v0.7. Images / files / inline buttons
- *   deferred until concrete user-need surfaces.
- *
- * Why a gateway abstraction at all (vs per-platform code paths):
- * the opensquid-side MCP tool surface (`chat.send`, `chat.list_channels`,
- * the inbound-message → MCP-context bridge) should NOT care which
- * platform a message came from. The gateway normalizes incoming events
- * to a single `ChatMessage` shape and routes outgoing sends by
- * channel id.
- *
- * What is NOT in this file:
- * - Token storage / config loading (lives in `chat/config.ts`).
- * - The actual SDK calls (live in `chat/adapters/<platform>.ts`).
- * - The MCP tool wiring (lives in `chat/mcp-tools.ts`).
- *
- * What IS in this file: types + the `ChatGateway` orchestrator that
- * holds N adapters and presents a single send/subscribe API.
- */
-// ---------------------------------------------------------------------
-// Gateway orchestrator
-// ---------------------------------------------------------------------
-/**
- * Holds N adapters and presents the unified API. Construct with the
- * adapter array you want active for this opensquid process. Pre-wired
- * tokens live in config; the factory at `chat/factory.ts` builds the
- * adapter array based on which tokens are present.
- */
-export class ChatGateway {
-    adapters;
-    handlers = [];
-    started = false;
-    constructor(adapters) {
-        this.adapters = new Map(adapters.map((a) => [a.platform, a]));
-    }
-    /** Open all adapter connections in parallel. First failure surfaces. */
-    async start() {
-        if (this.started)
-            return;
-        // Wire incoming handler dispatch BEFORE starting connections so we
-        // don't drop early messages.
-        for (const adapter of this.adapters.values()) {
-            adapter.onMessage((msg) => this.dispatch(msg));
-        }
-        await Promise.all([...this.adapters.values()].map((a) => a.start()));
-        this.started = true;
-    }
-    /** Close all adapter connections. Errors are logged and swallowed
-     * so shutdown is always best-effort. */
-    async shutdown() {
-        if (!this.started)
-            return;
-        await Promise.allSettled([...this.adapters.values()].map((a) => a.shutdown()));
-        this.started = false;
-    }
-    /** Subscribe to inbound messages from any platform. */
-    onMessage(handler) {
-        this.handlers.push(handler);
-    }
-    /** Route an outbound message to the right adapter by `channel` prefix. */
-    async send(message) {
-        const platform = platformFromChannel(message.channel);
-        const adapter = this.adapters.get(platform);
-        if (!adapter) {
-            throw new ChatGatewayError(`no adapter active for platform '${platform}' (channel '${message.channel}')`, "ensure the corresponding bot_token is set in ~/.opensquid/config.json chat_connections");
-        }
-        return adapter.send(message);
-    }
-    /** List the platforms currently wired up. Used by `chat.list_channels`. */
-    activePlatforms() {
-        return [...this.adapters.keys()];
-    }
-    /**
-     * v0.7.2 — get the active adapter for a platform so daemon-internal
-     * code paths (e.g. `chat-daemon-worker` RPC dispatch) can reach
-     * platform-specific methods like Telegram's `createTopic`. Returns
-     * undefined when the platform isn't activated.
-     */
-    getAdapter(platform) {
-        return this.adapters.get(platform);
-    }
-    async dispatch(msg) {
-        for (const handler of this.handlers) {
-            try {
-                await handler(msg);
-            }
-            catch (err) {
-                const e = err instanceof Error ? err.message : String(err);
-                // Don't let one handler break the dispatch chain.
-                // eslint-disable-next-line no-console
-                console.error(`[chat-gateway] handler error on ${msg.platform}: ${e}`);
-            }
-        }
-    }
-}
-// ---------------------------------------------------------------------
-// Errors
-// ---------------------------------------------------------------------
-export class ChatGatewayError extends Error {
-    hint;
-    constructor(message, hint) {
-        super(message);
-        this.hint = hint;
-        this.name = "ChatGatewayError";
-    }
-}
-// ---------------------------------------------------------------------
-// ChannelId helpers
-// ---------------------------------------------------------------------
-export function formatChannelId(platform, nativeId) {
-    return `${platform}:${nativeId}`;
-}
-export function platformFromChannel(channel) {
-    const idx = channel.indexOf(":");
-    if (idx === -1) {
-        throw new ChatGatewayError(`malformed channel id '${channel}'`, "channel ids must be '<platform>:<native_id>', e.g. 'telegram:8075471258'");
-    }
-    const candidate = channel.slice(0, idx);
-    if (candidate !== "telegram" && candidate !== "discord" && candidate !== "slack") {
-        throw new ChatGatewayError(`unknown platform '${candidate}' in channel id '${channel}'`, "supported platforms: telegram, discord, slack");
-    }
-    return candidate;
-}
-export function nativeIdFromChannel(channel) {
-    const idx = channel.indexOf(":");
-    if (idx === -1) {
-        throw new ChatGatewayError(`malformed channel id '${channel}'`);
-    }
-    return channel.slice(idx + 1);
-}

package/dist/chat/gateway.js.map

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

package/dist/chat/gateway.test.js

@@ -1,192 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { ChatGateway, ChatGatewayError, formatChannelId, nativeIdFromChannel, platformFromChannel, } from "./gateway.js";
-// ---------------------------------------------------------------------
-// Mock adapter
-// ---------------------------------------------------------------------
-class MockAdapter {
-    platform;
-    started = false;
-    shutdownCalls = 0;
-    sends = [];
-    handlers = [];
-    constructor(platform) {
-        this.platform = platform;
-    }
-    async start() {
-        this.started = true;
-    }
-    async shutdown() {
-        this.shutdownCalls++;
-        this.started = false;
-    }
-    onMessage(handler) {
-        this.handlers.push(handler);
-    }
-    async send(message) {
-        this.sends.push(message);
-        return {
-            platform: this.platform,
-            messageId: `mock-${this.sends.length}`,
-            deliveredAt: new Date("2026-05-16T00:00:00Z"),
-        };
-    }
-    async identity() {
-        return { username: `mock-${this.platform}-bot`, nativeId: "bot-1" };
-    }
-    // Test helper: simulate an inbound message.
-    async simulateMessage(text, sender = "user-1") {
-        const msg = {
-            id: `m-${Date.now()}`,
-            platform: this.platform,
-            channel: formatChannelId(this.platform, "channel-1"),
-            sender,
-            senderId: sender,
-            text,
-            receivedAt: new Date("2026-05-16T00:00:00Z"),
-            mentionsBot: false,
-        };
-        for (const h of this.handlers)
-            await h(msg);
-    }
-}
-// ---------------------------------------------------------------------
-// channel id helpers
-// ---------------------------------------------------------------------
-describe("channel id helpers", () => {
-    it("formatChannelId joins with colon", () => {
-        expect(formatChannelId("telegram", "8075471258")).toBe("telegram:8075471258");
-    });
-    it("platformFromChannel parses telegram", () => {
-        expect(platformFromChannel("telegram:8075471258")).toBe("telegram");
-    });
-    it("platformFromChannel parses discord", () => {
-        expect(platformFromChannel("discord:1234567890")).toBe("discord");
-    });
-    it("platformFromChannel parses slack", () => {
-        expect(platformFromChannel("slack:C012345")).toBe("slack");
-    });
-    it("platformFromChannel rejects unknown platform", () => {
-        expect(() => platformFromChannel("hipchat:xyz")).toThrow(ChatGatewayError);
-    });
-    it("platformFromChannel rejects malformed", () => {
-        expect(() => platformFromChannel("telegram-no-colon")).toThrow(ChatGatewayError);
-    });
-    it("nativeIdFromChannel strips the prefix", () => {
-        expect(nativeIdFromChannel("telegram:8075471258")).toBe("8075471258");
-    });
-    it("nativeIdFromChannel preserves colons in native id (slack thread_ts)", () => {
-        expect(nativeIdFromChannel("slack:C012345:1234.5678")).toBe("C012345:1234.5678");
-    });
-});
-// ---------------------------------------------------------------------
-// ChatGateway lifecycle
-// ---------------------------------------------------------------------
-describe("ChatGateway lifecycle", () => {
-    it("start() calls start on every adapter", async () => {
-        const tg = new MockAdapter("telegram");
-        const dc = new MockAdapter("discord");
-        const gw = new ChatGateway([tg, dc]);
-        expect(tg.started).toBe(false);
-        expect(dc.started).toBe(false);
-        await gw.start();
-        expect(tg.started).toBe(true);
-        expect(dc.started).toBe(true);
-    });
-    it("start() is idempotent", async () => {
-        const tg = new MockAdapter("telegram");
-        const startSpy = vi.spyOn(tg, "start");
-        const gw = new ChatGateway([tg]);
-        await gw.start();
-        await gw.start();
-        expect(startSpy).toHaveBeenCalledTimes(1);
-    });
-    it("shutdown() closes every adapter", async () => {
-        const tg = new MockAdapter("telegram");
-        const dc = new MockAdapter("discord");
-        const gw = new ChatGateway([tg, dc]);
-        await gw.start();
-        await gw.shutdown();
-        expect(tg.shutdownCalls).toBe(1);
-        expect(dc.shutdownCalls).toBe(1);
-    });
-    it("shutdown() before start is a no-op", async () => {
-        const tg = new MockAdapter("telegram");
-        const gw = new ChatGateway([tg]);
-        await gw.shutdown();
-        expect(tg.shutdownCalls).toBe(0);
-    });
-    it("activePlatforms reports configured set", () => {
-        const tg = new MockAdapter("telegram");
-        const sl = new MockAdapter("slack");
-        const gw = new ChatGateway([tg, sl]);
-        expect(gw.activePlatforms().sort()).toEqual(["slack", "telegram"]);
-    });
-});
-// ---------------------------------------------------------------------
-// Routing
-// ---------------------------------------------------------------------
-describe("ChatGateway routing", () => {
-    it("send() routes to the adapter matching the channel prefix", async () => {
-        const tg = new MockAdapter("telegram");
-        const dc = new MockAdapter("discord");
-        const gw = new ChatGateway([tg, dc]);
-        await gw.start();
-        await gw.send({ channel: "telegram:8075471258", text: "hi tg" });
-        await gw.send({ channel: "discord:1234", text: "hi dc" });
-        expect(tg.sends.map((s) => s.text)).toEqual(["hi tg"]);
-        expect(dc.sends.map((s) => s.text)).toEqual(["hi dc"]);
-    });
-    it("send() throws when no adapter is configured for the platform", async () => {
-        const tg = new MockAdapter("telegram");
-        const gw = new ChatGateway([tg]);
-        await gw.start();
-        await expect(gw.send({ channel: "slack:C012", text: "hi" })).rejects.toThrow(ChatGatewayError);
-    });
-});
-// ---------------------------------------------------------------------
-// Inbound dispatch
-// ---------------------------------------------------------------------
-describe("ChatGateway inbound dispatch", () => {
-    it("forwards inbound messages to all registered handlers", async () => {
-        const tg = new MockAdapter("telegram");
-        const gw = new ChatGateway([tg]);
-        await gw.start();
-        const h1 = vi.fn();
-        const h2 = vi.fn();
-        gw.onMessage(h1);
-        gw.onMessage(h2);
-        await tg.simulateMessage("hello");
-        expect(h1).toHaveBeenCalledOnce();
-        expect(h2).toHaveBeenCalledOnce();
-        expect(h1.mock.calls[0][0].text).toBe("hello");
-    });
-    it("one handler throwing doesn't block the others", async () => {
-        const tg = new MockAdapter("telegram");
-        const gw = new ChatGateway([tg]);
-        await gw.start();
-        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const failing = vi.fn(() => {
-            throw new Error("boom");
-        });
-        const ok = vi.fn();
-        gw.onMessage(failing);
-        gw.onMessage(ok);
-        await tg.simulateMessage("test");
-        expect(failing).toHaveBeenCalledOnce();
-        expect(ok).toHaveBeenCalledOnce();
-        errorSpy.mockRestore();
-    });
-    it("messages route through with correct platform tag", async () => {
-        const dc = new MockAdapter("discord");
-        const gw = new ChatGateway([dc]);
-        await gw.start();
-        const captured = [];
-        gw.onMessage((m) => {
-            captured.push(m);
-        });
-        await dc.simulateMessage("from discord");
-        expect(captured).toHaveLength(1);
-        expect(captured[0].platform).toBe("discord");
-        expect(captured[0].channel).toBe("discord:channel-1");
-    });
-});

package/dist/claude-md.d.ts

@@ -1,39 +0,0 @@
-/** Resolved path to the user's global CLAUDE.md. */
-export declare function defaultClaudeMdPath(): string;
-export interface PromotedLessonEntry {
-    /** Engine lesson id (e.g. "les-abc12345"). */
-    id: string;
-    /** One-line description (trigger phrase + concise summary). */
-    description: string;
-    /** ISO timestamp the promotion happened. */
-    promoted_at: string;
-}
-/**
- * Append a one-line entry for a newly promoted lesson into the
- * CLAUDE.md rules sub-block. Idempotent — if an entry for `id` already
- * exists, the line is left untouched. Returns the path written + the
- * new content of the rules block (without sentinels).
- *
- * No-op (silent) when:
- *   - CLAUDE.md doesn't exist
- *   - The rules sub-block isn't installed yet (user hasn't run
- *     `opensquid install` against this CLAUDE.md)
- *
- * Failure is intentionally non-fatal: lesson promotion is the
- * authoritative event; CLAUDE.md is downstream display. We never block
- * the promote on a CLAUDE.md write failure.
- */
-export declare function appendPromotedLessonToClaudeMd(entry: PromotedLessonEntry, options?: {
-    target?: string;
-}): Promise<{
-    target: string;
-    appended: boolean;
-} | null>;
-/**
- * For tests + diagnostics: list the lesson ids currently appearing in
- * the rules sub-block of a given CLAUDE.md.
- */
-export declare function listRulesBlockLessonIds(options?: {
-    target?: string;
-}): Promise<string[]>;
-//# sourceMappingURL=claude-md.d.ts.map

package/dist/claude-md.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../src.legacy/claude-md.ts"],"names":[],"mappings":"AA6BA,oDAAoD;AACpD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CA4BvD;AA4BD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}