@glows777/vela-channels 0.0.0-stage → 0.5.0

package/dist/commands.js

@@ -0,0 +1,130 @@
+/** Match only a complete normalized topic message, before history or sender decoration. */
+function topicCommand(msg) {
+    const text = msg.text.trim();
+    if (text === '!routines')
+        return 'routines';
+    if (!msg.topic)
+        return;
+    if (text === '!stop')
+        return 'stop';
+    if (text === '!restart')
+        return 'restart';
+    if (text === '!status')
+        return 'status';
+}
+/** Topic command barriers and preparation cancellation; the gateway owns normal message queues. */
+export class TopicCommands {
+    options;
+    commands = new Map();
+    processing = new Map();
+    active = new Set();
+    constructor(options) {
+        this.options = options;
+    }
+    begin(key) {
+        const state = { stopped: false };
+        this.processing.set(key, state);
+        return state;
+    }
+    end(key, state) {
+        if (this.processing.get(key) === state)
+            this.processing.delete(key);
+    }
+    receive(key, name, msg, admit, previous) {
+        const command = topicCommand(msg);
+        const barrier = this.commands.get(key);
+        // Only Stop/Restart cancel preparation; read-only commands leave live work alone.
+        const processing = !barrier &&
+            command &&
+            (command === 'stop' || command === 'restart') &&
+            this.processing.get(key);
+        if (processing && !this.options.stopped())
+            processing.stopped = true;
+        const stopping = processing ? this.options.feedback.stop(key) : undefined;
+        void stopping?.catch(() => { });
+        const admitted = admit();
+        if (command) {
+            const next = this.handleCommand(key, name, msg, command, admitted, previous, barrier, stopping);
+            const blocks = command === 'stop' || command === 'restart';
+            this.commands.set(key, next);
+            this.active.add(next);
+            void next.then(() => {
+                this.active.delete(next);
+                if (this.commands.get(key) === next)
+                    this.commands.delete(key);
+            });
+            return { command: next, blocks, blocked: !!barrier, available: admitted };
+        }
+        // Later messages must not steer the generation being archived.
+        const available = barrier
+            ? admitted.then(async (accepted) => {
+                await barrier;
+                return accepted;
+            })
+            : admitted;
+        return { blocked: !!barrier, available };
+    }
+    async handleCommand(key, name, msg, command, admitted, previous, barrier, stopping) {
+        const o = this.options;
+        try {
+            if (!(await admitted))
+                return;
+            await barrier;
+            if (o.stopped())
+                return;
+            let stopped = false;
+            if (command === 'stop' || command === 'restart') {
+                const processing = this.processing.get(key);
+                if (processing)
+                    processing.stopped = true;
+                stopped = (await (stopping ?? o.feedback.stop(key))) || !!processing;
+                await previous;
+            }
+            await o.closing(key);
+            if (o.stopped())
+                return;
+            const channel = o.channel(name);
+            if (!channel)
+                return;
+            const session = command === 'status'
+                ? (o.find(key) ?? (await o.admission.admit(key, channel, msg)))
+                : o.find(key);
+            await this.finish(command, key, channel, msg, stopped, session);
+        }
+        catch (error) {
+            await o.feedback.feedbackError(name, msg, error);
+        }
+    }
+    /** Stop/Restart arrive after the old run's normal delivery and finish path has drained. */
+    async finish(command, key, channel, msg, stopped, session) {
+        const { directory, feedback, usage } = this.options;
+        const inputs = feedback.acknowledge(channel, msg);
+        let outcome = 'failed';
+        try {
+            await Promise.all(inputs.map((input) => input.ready));
+            let text = stopped ? '' : 'No run is currently active.';
+            if (command === 'restart') {
+                // Save before closing: a save failure must retain the old live session.
+                await session?.save();
+                await session?.close();
+                directory.observe(key, channel.name, msg);
+                await directory.restart(key);
+                text = 'Restarted with a fresh session';
+            }
+            else if (command === 'routines') {
+                text = this.options.routines(channel.name, msg.channelId);
+            }
+            else if (command === 'status' && session) {
+                text = usage.status(key, channel.name, msg.channelId, session);
+            }
+            if (text)
+                await channel.send({ ...msg, recipientId: msg.senderId, text });
+            await directory.forget(key, msg.replyToId ? [msg.replyToId] : []);
+            outcome = 'done';
+        }
+        finally {
+            await Promise.all(inputs.map((input) => input.finish(outcome)));
+        }
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/directory.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import type { ChannelTopic, IncomingMessage } from './types.ts';
+declare const recordSchema: z.ZodObject<{
+    key: z.ZodString;
+    channel: z.ZodString;
+    legacyKey: z.ZodOptional<z.ZodString>;
+    storageKey: z.ZodOptional<z.ZodString>;
+    chatId: z.ZodString;
+    chatKind: z.ZodEnum<{
+        group: "group";
+        direct: "direct";
+    }>;
+    rootId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    requester: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    replyTarget: z.ZodOptional<z.ZodString>;
+    task: z.ZodString;
+    activeSessionId: z.ZodString;
+    previousSessionIds: z.ZodArray<z.ZodString>;
+    state: z.ZodEnum<{
+        running: "running";
+        waiting: "waiting";
+        done: "done";
+        stopped: "stopped";
+    }>;
+    waitingReason: z.ZodOptional<z.ZodString>;
+    passive: z.ZodOptional<z.ZodBoolean>;
+    handoff: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodString;
+        depth: z.ZodNumber;
+    }, z.core.$strip>>;
+    routine: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        scheduledAt: z.ZodString;
+        creator: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pendingMessageIds: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        passive: z.ZodLiteral<true>;
+    }, z.core.$strip>]>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const channelIndexSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    createdAt: z.ZodString;
+    records: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        channel: z.ZodString;
+        legacyKey: z.ZodOptional<z.ZodString>;
+        storageKey: z.ZodOptional<z.ZodString>;
+        chatId: z.ZodString;
+        chatKind: z.ZodEnum<{
+            group: "group";
+            direct: "direct";
+        }>;
+        rootId: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        requester: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        replyTarget: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        activeSessionId: z.ZodString;
+        previousSessionIds: z.ZodArray<z.ZodString>;
+        state: z.ZodEnum<{
+            running: "running";
+            waiting: "waiting";
+            done: "done";
+            stopped: "stopped";
+        }>;
+        waitingReason: z.ZodOptional<z.ZodString>;
+        passive: z.ZodOptional<z.ZodBoolean>;
+        handoff: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            from: z.ZodString;
+            depth: z.ZodNumber;
+        }, z.core.$strip>>;
+        routine: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            scheduledAt: z.ZodString;
+            creator: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        pendingMessageIds: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            passive: z.ZodLiteral<true>;
+        }, z.core.$strip>]>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    notes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+export type ChannelRecord = z.infer<typeof recordSchema>;
+/** Hand-off notes exist only in groups and address the group session without a service message. */
+export declare function isGroupInput(msg: IncomingMessage): boolean;
+/** Passive metadata travels with the existing pending ID, never in a second ID registry. */
+export declare function pendingMessageId(input: ChannelRecord['pendingMessageIds'][number]): string;
+/** One directory for recovery and topic discovery. No input text is copied here except the task label. */
+export declare class ChannelDirectory {
+    private records;
+    private notes;
+    private loaded?;
+    private writing;
+    private readonly path?;
+    private createdAt;
+    constructor(dataDir?: string);
+    load(): Promise<void>;
+    private read;
+    get(key: string): ChannelRecord | undefined;
+    storageKey(channel: string, chatId: string): string | undefined;
+    sessionId(key: string): string;
+    keyForSession(id: string): string;
+    restart(key: string): Promise<void>;
+    entries(channel: string): ChannelRecord[];
+    get coverage(): string;
+    observe(key: string, channel: string, msg: IncomingMessage, task?: string): ChannelRecord;
+    admit(key: string, channel: string, msg: IncomingMessage): Promise<void>;
+    begin(key: string, msg: IncomingMessage): Promise<void>;
+    forget(key: string, ids: string[]): Promise<void>;
+    waitForInput(key: string, reason: string): Promise<void>;
+    finish(key: string, state: ChannelRecord['state'], answered?: boolean): Promise<void>;
+    list(channel: string, chatId: string, state: (id: string) => ChannelTopic['state']): ChannelTopic[];
+    /** Status lines for a group session's next run, oldest first. */
+    pendingNotes(key: string): readonly string[];
+    addNote(key: string, line: string): Promise<void>;
+    /** Drops these delivered notes once a session has saved them; newer ones stay. */
+    dropNotes(key: string, delivered: readonly string[]): Promise<void>;
+    flush(): Promise<void>;
+    private save;
+    private write;
+}
+export {};
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

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

package/dist/directory.js

@@ -0,0 +1,309 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { writeAtomicJson } from "./atomic-json.js";
+const recordSchema = z
+    .object({
+    key: z.string(),
+    channel: z.string(),
+    legacyKey: z.string().optional(),
+    storageKey: z
+        .string()
+        .regex(/^[A-Za-z0-9_.-]+$/)
+        .refine((key) => key !== '.' && key !== '..')
+        .optional(),
+    chatId: z.string(),
+    chatKind: z.enum(['group', 'direct']),
+    rootId: z.string().optional(),
+    threadId: z.string().optional(),
+    requester: z.object({ id: z.string(), name: z.string() }),
+    replyTarget: z.string().optional(),
+    task: z.string(),
+    activeSessionId: z.string(),
+    previousSessionIds: z.array(z.string()),
+    state: z.enum(['running', 'waiting', 'done', 'stopped']),
+    waitingReason: z.string().optional(),
+    passive: z.boolean().optional(),
+    handoff: z
+        .object({ id: z.string(), from: z.string(), depth: z.number() })
+        .optional(),
+    routine: z
+        .object({
+        id: z.string(),
+        scheduledAt: z.string(),
+        creator: z.object({ id: z.string(), name: z.string() }).optional(),
+    })
+        .optional(),
+    pendingMessageIds: z.array(z.union([
+        z.string(),
+        z.object({ id: z.string(), passive: z.literal(true) }),
+    ])),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+})
+    .refine((record) => !!record.rootId === !!record.threadId, 'Incomplete topic address');
+export const channelIndexSchema = z.object({
+    version: z.literal(1),
+    createdAt: z.string(),
+    records: z.array(recordSchema),
+    /** Status lines waiting for a group session's next run, by group key. */
+    notes: z.record(z.string(), z.array(z.string())).optional(),
+});
+/** Hand-off notes exist only in groups and address the group session without a service message. */
+export function isGroupInput(msg) {
+    return !!(msg.topic || msg.replyToId || msg.handoff);
+}
+const MAX_NOTES = 20;
+const MAX_NOTE_CHARS = 300;
+/** Passive metadata travels with the existing pending ID, never in a second ID registry. */
+export function pendingMessageId(input) {
+    return typeof input === 'string' ? input : input.id;
+}
+/** One directory for recovery and topic discovery. No input text is copied here except the task label. */
+export class ChannelDirectory {
+    records = new Map();
+    notes = new Map();
+    loaded;
+    writing = Promise.resolve();
+    path;
+    createdAt = new Date().toISOString();
+    constructor(dataDir) {
+        this.path = dataDir ? join(dataDir, 'channels', 'index.json') : undefined;
+    }
+    load() {
+        this.loaded ??= this.read();
+        return this.loaded;
+    }
+    async read() {
+        if (!this.path)
+            return;
+        const marker = join(this.path, '..', 'migration.json');
+        if (existsSync(marker)) {
+            const migration = JSON.parse(await readFile(marker, 'utf8'));
+            if (migration.version !== 1 || migration.status !== 'complete')
+                throw new Error('Channel migration is incomplete; rerun the migration utility before starting transports');
+        }
+        let text;
+        try {
+            text = await readFile(this.path, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw new Error(`Cannot read channel directory ${this.path}`, {
+                cause: error,
+            });
+        }
+        try {
+            const data = channelIndexSchema.parse(JSON.parse(text));
+            if (new Set(data.records.map((r) => r.key)).size !== data.records.length)
+                throw new Error('Duplicate channel key');
+            const keys = new Set(data.records.map((record) => record.key));
+            const legacy = data.records.flatMap((record) => record.legacyKey ? [record.legacyKey] : []);
+            if (new Set(legacy).size !== legacy.length ||
+                legacy.some((key) => keys.has(key)))
+                throw new Error('Conflicting legacy channel key');
+            const stores = new Map();
+            for (const record of data.records) {
+                const chat = JSON.stringify([record.channel, record.chatId]);
+                if (stores.has(chat) && stores.get(chat) !== record.storageKey)
+                    throw new Error('Conflicting channel storage keys');
+                stores.set(chat, record.storageKey);
+            }
+            this.createdAt = data.createdAt;
+            this.records = new Map(data.records.map((record) => [record.key, record]));
+            this.notes = new Map(Object.entries(data.notes ?? {}));
+        }
+        catch (error) {
+            throw new Error(`Invalid channel directory ${this.path}: ${String(error)}`, { cause: error });
+        }
+    }
+    get(key) {
+        return (this.records.get(key) ??
+            [...this.records.values()].find((record) => record.legacyKey === key));
+    }
+    storageKey(channel, chatId) {
+        return this.entries(channel).find((record) => record.chatId === chatId)
+            ?.storageKey;
+    }
+    sessionId(key) {
+        return this.get(key)?.activeSessionId ?? key;
+    }
+    keyForSession(id) {
+        return ([...this.records.values()].find((record) => record.activeSessionId === id)
+            ?.key ?? id);
+    }
+    async restart(key) {
+        const record = this.records.get(key);
+        if (!record)
+            throw new Error(`Unknown channel session ${key}`);
+        const next = {
+            ...record,
+            activeSessionId: `channel-${crypto.randomUUID()}`,
+            previousSessionIds: [
+                ...record.previousSessionIds,
+                record.activeSessionId,
+            ],
+            state: 'done',
+            waitingReason: undefined,
+        };
+        await this.save(next, true);
+    }
+    entries(channel) {
+        return [...this.records.values()].filter((record) => record.channel === channel);
+    }
+    get coverage() {
+        return `Topics recorded since M2 directory creation at ${this.createdAt}; earlier topics may exist until they receive a new message. An empty list does not mean there are no tasks.`;
+    }
+    observe(key, channel, msg, task = msg.text) {
+        let record = this.records.get(key);
+        if (!record) {
+            const now = new Date().toISOString();
+            record = {
+                key,
+                channel,
+                chatId: msg.channelId,
+                chatKind: isGroupInput(msg) ? 'group' : 'direct',
+                rootId: msg.topic?.rootId,
+                threadId: msg.topic?.threadId,
+                requester: { id: msg.senderId, name: msg.senderName },
+                replyTarget: msg.replyToId,
+                task: task.slice(0, 120),
+                activeSessionId: key,
+                storageKey: this.storageKey(channel, msg.channelId),
+                previousSessionIds: [],
+                state: 'done',
+                pendingMessageIds: [],
+                createdAt: now,
+                updatedAt: now,
+            };
+            this.records.set(key, record);
+        }
+        return record;
+    }
+    async admit(key, channel, msg) {
+        const record = this.observe(key, channel, msg);
+        // A note from another session never answers a person's pending decision.
+        if (!msg.handoff) {
+            record.waitingReason = undefined;
+            if (record.state === 'waiting')
+                record.state = 'done';
+        }
+        // A note has no service message of its own: its reply target is the topic root.
+        if (msg.replyToId &&
+            !msg.routine &&
+            !msg.handoff &&
+            !record.pendingMessageIds.some((input) => pendingMessageId(input) === msg.replyToId))
+            record.pendingMessageIds.push(msg.passive ? { id: msg.replyToId, passive: true } : msg.replyToId);
+        await this.save(record);
+    }
+    async begin(key, msg) {
+        const record = this.records.get(key);
+        if (!record)
+            return;
+        record.state = 'running';
+        record.passive = msg.passive;
+        record.handoff = msg.handoff;
+        record.routine = msg.routine
+            ? { ...msg.routine, creator: { id: msg.senderId, name: msg.senderName } }
+            : undefined;
+        if (!record.rootId || record.requester.id === msg.senderId)
+            record.requester = { id: msg.senderId, name: msg.senderName };
+        record.replyTarget = msg.replyToId;
+        await this.save(record);
+    }
+    async forget(key, ids) {
+        const record = this.records.get(key);
+        if (!record?.pendingMessageIds.some((input) => ids.includes(pendingMessageId(input))))
+            return;
+        record.pendingMessageIds = record.pendingMessageIds.filter((input) => !ids.includes(pendingMessageId(input)));
+        await this.save(record);
+    }
+    async waitForInput(key, reason) {
+        const record = this.records.get(key);
+        if (!record?.rootId)
+            throw new Error('Waiting requires a topic');
+        record.waitingReason = reason;
+        await this.save(record);
+    }
+    async finish(key, state, answered = false) {
+        const record = this.records.get(key);
+        if (!record)
+            return;
+        record.state =
+            state === 'done' && answered && record.waitingReason ? 'waiting' : state;
+        if (record.state !== 'waiting')
+            record.waitingReason = undefined;
+        await this.save(record);
+    }
+    list(channel, chatId, state) {
+        return this.entries(channel).flatMap((record) => record.chatId === chatId && record.rootId && record.threadId
+            ? [
+                {
+                    rootId: record.rootId,
+                    threadId: record.threadId,
+                    task: record.task,
+                    state: state(record.key),
+                    requester: record.requester,
+                    updatedAt: record.updatedAt,
+                    waitingReason: record.waitingReason,
+                },
+            ]
+            : []);
+    }
+    /** Status lines for a group session's next run, oldest first. */
+    pendingNotes(key) {
+        return this.notes.get(key) ?? [];
+    }
+    addNote(key, line) {
+        const note = line.length > MAX_NOTE_CHARS ? `${line.slice(0, MAX_NOTE_CHARS)}…` : line;
+        this.notes.set(key, [...this.pendingNotes(key), note].slice(-MAX_NOTES));
+        return this.write();
+    }
+    /** Drops these delivered notes once a session has saved them; newer ones stay. */
+    dropNotes(key, delivered) {
+        const rest = [...this.pendingNotes(key)];
+        for (const note of delivered) {
+            const index = rest.indexOf(note);
+            if (index >= 0)
+                rest.splice(index, 1);
+        }
+        if (rest.length)
+            this.notes.set(key, rest);
+        else
+            this.notes.delete(key);
+        return this.write();
+    }
+    flush() {
+        return this.writing;
+    }
+    save(record, replace = false) {
+        record.updatedAt = new Date().toISOString();
+        return this.write(replace ? record : undefined);
+    }
+    write(replacement) {
+        const path = this.path;
+        if (!path) {
+            if (replacement)
+                this.records.set(replacement.key, replacement);
+            return Promise.resolve();
+        }
+        const write = this.writing
+            .catch(() => { })
+            .then(async () => {
+            // Later saves see only generations whose index write succeeded.
+            await writeAtomicJson(path, {
+                version: 1,
+                createdAt: this.createdAt,
+                records: [...this.records.values()].map((current) => current.key === replacement?.key ? replacement : current),
+                ...(this.notes.size ? { notes: Object.fromEntries(this.notes) } : {}),
+            });
+            if (replacement)
+                this.records.set(replacement.key, replacement);
+        });
+        this.writing = write;
+        return write;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

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

package/dist/event-receiver.d.ts

@@ -0,0 +1,19 @@
+import type { VelaLogger } from '@glows777/vela-core/extension-api';
+import type { ChannelEvent } from './types.ts';
+/** Optional ingress owned by the channel assembly; no daemon, persisted cache or provider access. */
+export declare class EventReceiver {
+    private publish;
+    private logger;
+    private readonly options;
+    private server?;
+    private starting?;
+    private readonly active;
+    private readonly seen;
+    private accepting;
+    constructor(config: unknown, publish: (event: ChannelEvent) => Promise<void>, logger: VelaLogger);
+    start(): Promise<void>;
+    private listen;
+    stop(): Promise<void>;
+    private handle;
+}
+//# sourceMappingURL=event-receiver.d.ts.map

package/dist/event-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-receiver.d.ts","sourceRoot":"","sources":["../src/event-receiver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAKnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAmE9C,qGAAqG;AACrG,qBAAa,aAAa;IAUtB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IAVhB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAQ;gBAGvB,MAAM,EAAE,OAAO,EACP,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,MAAM,EAAE,UAAU;IAU5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKR,MAAM;IAwBd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAeb,MAAM;CAiFrB"}