@mallocbaal/agent-framework 1.0.0

package/README.md

@@ -0,0 +1,137 @@
+# @mallocbaal/agent-framework (TypeScript)
+
+TypeScript-библиотека с функционалом, аналогичным Go [agent-framework](../agent-framework): event-driven агенты с RabbitMQ и saga-логированием.
+
+**Требования:** Node.js >= 20
+
+## Установка
+
+```bash
+npm install @mallocbaal/agent-framework
+# или из монорепо
+pnpm add @mallocbaal/agent-framework
+```
+
+## Быстрый старт
+
+```typescript
+import { loadConfig, App, type EventHandler, type Event } from '@mallocbaal/agent-framework';
+
+class MyAgent implements EventHandler {
+  async handle(_ctx: AbortSignal | undefined, event: Event): Promise<void> {
+    switch (event.eventType) {
+      case 'CLI_FLOW_INIT':
+        return this.handleInit(event);
+      case 'CLI_FLOW_CONTINUE':
+        return this.handleContinue(event);
+      case 'CLI_FLOW_END':
+        return;
+    }
+  }
+
+  private async handleInit(_event: Event): Promise<void> {
+    // инициализация диалога
+  }
+
+  private async handleContinue(_event: Event): Promise<void> {
+    // обработка сообщения или action
+  }
+}
+
+async function main() {
+  const config = loadConfig();
+  const handler = new MyAgent();
+  const app = await App.create({ config, handler });
+  await app.run(); // до Ctrl+C или abort
+}
+main().catch(console.error);
+```
+
+## Структура (аналог Go)
+
+| Модуль        | Назначение                          |
+|---------------|-------------------------------------|
+| `events`      | Типы событий CLI_FLOW_*             |
+| `config`      | Загрузка конфигурации из env        |
+| `dispatcher`  | Маршрутизация INIT/CONTINUE/END    |
+| `rabbitmq`    | Consumer с retry                    |
+| `saga`        | SagaLogger, MinIO, типы событий саги|
+| `communicator`| Клиент Communicator (GraphQL)       |
+| `pipeline`    | Processing + PostProcessing stages   |
+| `app`         | Жизненный цикл, health, bot register|
+
+## Конфигурация (env)
+
+- `PORT` — порт health (по умолчанию 8091)
+- `COMMUNICATOR_URL` — URL сервиса communicator
+- `RABBITMQ_URL`, `RABBITMQ_EXCHANGE`, `RABBITMQ_QUEUE`, `RABBITMQ_BINDINGS`, `RABBITMQ_PREFETCH`, `RABBITMQ_MAX_RETRIES`
+- `MINIO_ENDPOINT`, `MINIO_ACCESS_KEY`, `MINIO_SECRET_KEY`, `MINIO_BUCKET`, `MINIO_USE_SSL`
+- `BOT_KEY`, `BOT_NAME`, `BOT_EVENT_STREAM`, `BOT_STREAMING_ENABLED`
+
+## EventProcessor + Dispatcher
+
+Вместо одного `EventHandler` можно реализовать `EventProcessor` и обернуть в `Dispatcher`:
+
+```typescript
+import { Dispatcher, type EventProcessor, type Event } from '@mallocbaal/agent-framework';
+
+class MyProcessor implements EventProcessor {
+  async handleInit(_ctx, ev: Event) { /* ... */ }
+  async handleContinue(_ctx, ev: Event) { /* ... */ }
+}
+
+const processor = new MyProcessor();
+const dispatcher = new Dispatcher(processor);
+const app = await App.create({ config, handler: dispatcher });
+```
+
+## Pipeline
+
+Использование паттерна Processing → Communicator → PostProcessing:
+
+```typescript
+import {
+  Pipeline,
+  createProcessingFunc,
+  createPostProcessingFunc,
+  createCommunicatorClient,
+  loadConfig,
+  App,
+  type ProcessingStage,
+  type PostProcessingStage,
+  type Event,
+} from '@mallocbaal/agent-framework';
+
+class MyStage implements ProcessingStage, PostProcessingStage {
+  async processInit(_, ev) {
+    return { contents: [{ type: 'text', order: 0, data: { text: 'Hello!' } }] };
+  }
+  async processContinue(_, ev) {
+    return { contents: [{ type: 'text', order: 0, data: { text: 'You said: ' + (ev.message ?? '') } }] };
+  }
+  async postProcessInit() {}
+  async postProcessContinue() {}
+}
+
+const config = loadConfig();
+const comm = createCommunicatorClient(config.communicator.baseURL);
+const pipeline = new Pipeline(comm, {
+  processing: createProcessingFunc(new MyStage()),
+  postProcessing: createPostProcessingFunc(new MyStage()),
+}, 'my-agent');
+const app = await App.create({ config, handler: pipeline });
+await app.run();
+```
+
+## Health
+
+- `GET /healthz` — 200 OK
+- `GET /readyz` — 200 если RabbitMQ доступен, иначе 503
+
+## Сборка
+
+```bash
+npm run build
+```
+
+Генерируется `dist/` с ESM и декларациями.

package/dist/app/app.d.ts

@@ -0,0 +1,33 @@
+import type { Config } from '../config/config.js';
+import type { Event } from '../events/types.js';
+import type { SagaLogger } from '../saga/logger.js';
+export interface EventHandler {
+    handle(ctx: AbortSignal | undefined, event: Event): Promise<void>;
+}
+export interface AppOptions {
+    config: Config;
+    handler: EventHandler;
+    /** If true, MinIO saga logger is created from config; otherwise no-op saga. Default true. */
+    sagaEnabled?: boolean;
+}
+export declare class App {
+    private readonly cfg;
+    private handler;
+    private readonly consumer;
+    private readonly sagaLogger;
+    private readonly communicator;
+    private ready;
+    private server;
+    constructor(cfg: Config, handler: EventHandler, sagaEnabled?: boolean);
+    static create(options: AppOptions): Promise<App>;
+    setHandler(handler: EventHandler): void;
+    getSagaLogger(): SagaLogger;
+    private setAiRespondingStatus;
+    /**
+     * Run the agent: start health server, then consume RabbitMQ until signal aborted.
+     */
+    run(signal?: AbortSignal): Promise<void>;
+    private startHealthServer;
+    close(): void;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app/app.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAgBD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,GAAG;IAOF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,OAAO,CAAC,OAAO;IANzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqD;IAClF,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAA4B;gBAEb,GAAG,EAAE,MAAM,EAAU,OAAO,EAAE,YAAY,EAAE,WAAW,UAAO;WA0B9E,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAOtD,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIvC,aAAa,IAAI,UAAU;YAIb,qBAAqB;IASnC;;OAEG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC9C,OAAO,CAAC,iBAAiB;IAkCzB,KAAK,IAAI,IAAI;CAOd"}

package/dist/app/app.js

@@ -0,0 +1,143 @@
+import http from 'node:http';
+import { CliFlowContinue } from '../events/types.js';
+import { createConsumer } from '../rabbitmq/consumer.js';
+import { createMinIOSagaLogger, createNoopSagaLogger } from '../saga/minio.js';
+import { createCommunicatorClient } from '../communicator/client.js';
+async function ensureBotRegistered(communicator, cfg) {
+    const check = await communicator.checkBot(cfg.bot.key);
+    if (check.exists)
+        return;
+    await communicator.registerBot({
+        key: cfg.bot.key,
+        name: cfg.bot.name,
+        eventStream: cfg.bot.eventStream,
+        streamingEnabled: cfg.bot.streamingEnabled,
+    });
+}
+export class App {
+    cfg;
+    handler;
+    consumer;
+    sagaLogger;
+    communicator;
+    ready = false;
+    server = null;
+    constructor(cfg, handler, sagaEnabled = true) {
+        this.cfg = cfg;
+        this.handler = handler;
+        this.sagaLogger =
+            sagaEnabled && cfg.minIO.endpoint && cfg.minIO.accessKey && cfg.minIO.secretKey
+                ? createMinIOSagaLogger(cfg.minIO.endpoint, cfg.minIO.accessKey, cfg.minIO.secretKey, cfg.minIO.bucket, cfg.minIO.useSSL)
+                : createNoopSagaLogger();
+        this.communicator = cfg.communicator.baseURL
+            ? createCommunicatorClient(cfg.communicator.baseURL, '')
+            : null;
+        this.consumer = createConsumer(cfg.rabbitMQ.url, cfg.rabbitMQ.exchange, cfg.rabbitMQ.queue, cfg.rabbitMQ.bindings, cfg.rabbitMQ.prefetch, cfg.rabbitMQ.maxRetries);
+    }
+    static async create(options) {
+        const { config, handler, sagaEnabled = true } = options;
+        const app = new App(config, handler, sagaEnabled);
+        if (app.communicator)
+            await ensureBotRegistered(app.communicator, config);
+        return app;
+    }
+    setHandler(handler) {
+        this.handler = handler;
+    }
+    getSagaLogger() {
+        return this.sagaLogger;
+    }
+    async setAiRespondingStatus(chatId, participantId, status) {
+        if (!this.communicator)
+            return;
+        await this.communicator.setAiRespondingStatus(chatId, participantId, status);
+    }
+    /**
+     * Run the agent: start health server, then consume RabbitMQ until signal aborted.
+     */
+    async run(signal) {
+        this.startHealthServer();
+        this.ready = true;
+        const controller = new AbortController();
+        const effectiveSignal = signal ?? controller.signal;
+        const handlerWrapper = async (ctx, ev) => {
+            const timeout = AbortSignal.timeout ? AbortSignal.timeout(30_000) : undefined;
+            const c = timeout ? mergeSignals(ctx, timeout) : ctx;
+            if (ev.eventType === CliFlowContinue) {
+                try {
+                    await this.setAiRespondingStatus(ev.chatId, ev.participantId, 'PROCESSING');
+                }
+                catch (e) {
+                    console.warn('[FRAMEWORK] Failed to set AI responding status to PROCESSING:', e);
+                }
+            }
+            try {
+                await this.handler.handle(c, ev);
+            }
+            finally {
+                if (ev.eventType === CliFlowContinue) {
+                    try {
+                        await this.setAiRespondingStatus(ev.chatId, ev.participantId, 'DONE');
+                    }
+                    catch (e) {
+                        console.warn('[FRAMEWORK] Failed to set AI responding status to DONE:', e);
+                    }
+                }
+            }
+        };
+        try {
+            await this.consumer.consume(effectiveSignal, handlerWrapper);
+        }
+        finally {
+            this.consumer.close();
+        }
+    }
+    startHealthServer() {
+        const port = parseInt(this.cfg.port, 10) || 8091;
+        this.server = http.createServer((req, res) => {
+            if (req.url === '/healthz') {
+                res.writeHead(200, { 'Content-Type': 'text/plain' });
+                res.end('ok');
+                return;
+            }
+            if (req.url === '/readyz') {
+                if (!this.ready) {
+                    res.writeHead(503, { 'Content-Type': 'text/plain' });
+                    res.end('not ready');
+                    return;
+                }
+                this.consumer
+                    .ping()
+                    .then(() => {
+                    res.writeHead(200, { 'Content-Type': 'text/plain' });
+                    res.end('ready');
+                })
+                    .catch(() => {
+                    res.writeHead(503, { 'Content-Type': 'text/plain' });
+                    res.end('rabbitmq not ready');
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end();
+        });
+        this.server.listen(port, () => {
+            console.log(`[FRAMEWORK] Health server listening on port ${port}`);
+        });
+    }
+    close() {
+        this.consumer.close();
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+    }
+}
+function mergeSignals(a, b) {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    a?.addEventListener('abort', abort);
+    b?.addEventListener('abort', abort);
+    return controller.signal;
+}
+//# sourceMappingURL=app.js.map

package/dist/app/app.js.map

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

package/dist/communicator/client.d.ts

@@ -0,0 +1,36 @@
+import type { SendChatActionInput, RegisterBotInput, BotCheckResponse, AiRespondingStatus } from './models.js';
+export type { SendChatActionInput, RegisterBotInput, BotCheckResponse, SetAiRespondingStatusInput, CliFlowActionInput, ContentType, AiRespondingStatus, ChatMessage, MessageResponse, SuccessResponse, Bot, BotResponse, ChatMessagesResponse, Chat, ChatFilters, CreateChatInput, UpdateChatSummaryInput, PatchChatMetadataInput, HealthStatus, } from './models.js';
+export interface AgentMessageInputFramework {
+    chatId: string;
+    contents: MessageContentItemInputFramework[];
+    metadata?: Record<string, unknown>;
+    source?: string;
+    eventType?: string;
+    botId?: string | null;
+    messageId?: string | null;
+    visibleForUser?: string | null;
+    broadcastedForAllExcept?: string | null;
+}
+export interface MessageContentItemInputFramework {
+    type: string;
+    content?: string;
+    order?: number;
+    data?: Record<string, unknown>;
+}
+/** Convenience type for addAgentMessage and pipeline (flexible content items). */
+export type AgentMessageInput = AgentMessageInputFramework;
+/** Convenience type for pipeline content items (type can be string or ContentType). */
+export type MessageContentItemInput = MessageContentItemInputFramework;
+export declare class CommunicatorClient {
+    private readonly baseURL;
+    private readonly apiKey;
+    constructor(baseURL: string, apiKey?: string);
+    private graphql;
+    addAgentMessage(input: AgentMessageInputFramework): Promise<void>;
+    sendChatAction(input: SendChatActionInput): Promise<void>;
+    checkBot(key: string): Promise<BotCheckResponse>;
+    registerBot(input: RegisterBotInput): Promise<string>;
+    setAiRespondingStatus(chatId: string, participantId: string, status: AiRespondingStatus): Promise<void>;
+}
+export declare function createCommunicatorClient(baseURL: string, apiKey?: string): CommunicatorClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/communicator/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/communicator/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,mBAAmB,EAEnB,gBAAgB,EAChB,gBAAgB,EAGhB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,eAAe,EACf,GAAG,EACH,WAAW,EACX,oBAAoB,EACpB,IAAI,EACJ,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gCAAgC,EAAE,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC3D,uFAAuF;AACvF,MAAM,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAsCvE,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAW;YAGxB,OAAO;IA0Bf,eAAe,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQhD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcrD,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC;CAYjB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAE7F"}

package/dist/communicator/client.js

@@ -0,0 +1,129 @@
+function toSchemaContentType(type) {
+    const allowed = [
+        'ACTIVITY', 'TEXT', 'IMAGE', 'FILE', 'SELECTOR', 'TICKET', 'CARDS', 'IMAGE_INPUT', 'POLICY',
+    ];
+    const u = type?.toUpperCase();
+    return (allowed.includes(u) ? u : 'TEXT');
+}
+function toSchemaContents(items) {
+    return items.map((c) => {
+        const data = { ...(c.data ?? {}) };
+        const text = c.content ?? data['text'] ?? data['content'];
+        if (text != null)
+            data['content'] = text;
+        return {
+            type: toSchemaContentType(c.type),
+            order: c.order ?? 0,
+            data,
+        };
+    });
+}
+function toSchemaAgentInput(input) {
+    const metadata = { ...(input.metadata ?? {}) };
+    if (input.source != null)
+        metadata['source'] = input.source;
+    if (input.eventType != null)
+        metadata['eventType'] = input.eventType;
+    return {
+        chatId: input.chatId,
+        botId: input.botId ?? undefined,
+        metadata: Object.keys(metadata).length ? metadata : undefined,
+        contents: toSchemaContents(input.contents),
+        messageId: input.messageId ?? undefined,
+        visibleForUser: input.visibleForUser ?? undefined,
+        broadcastedForAllExcept: input.broadcastedForAllExcept ?? undefined,
+    };
+}
+export class CommunicatorClient {
+    baseURL;
+    apiKey;
+    constructor(baseURL, apiKey = '') {
+        this.baseURL = baseURL;
+        this.apiKey = apiKey;
+    }
+    async graphql(query, variables) {
+        const url = this.baseURL.replace(/\/$/, '') + '/graphql';
+        const body = JSON.stringify({ query, variables });
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.apiKey)
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body,
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}: ${await res.text()}`);
+        const json = (await res.json());
+        if (json.errors?.length)
+            throw new Error(`GraphQL: ${json.errors.map((e) => e.message).join(', ')}`);
+        if (!json.data)
+            throw new Error('GraphQL: no data');
+        return json.data;
+    }
+    async addAgentMessage(input) {
+        if (!input.chatId)
+            throw new Error('chatId is required');
+        if (!input.contents?.length)
+            throw new Error('at least one content item is required');
+        const schemaInput = toSchemaAgentInput(input);
+        const result = await this.graphql(`mutation AddAgentMessage($input: AgentMessageInput!) {
+        addAgentMessage(input: $input) {
+          success
+          message { id chatId }
+          error
+        }
+      }`, { input: schemaInput });
+        const r = result.addAgentMessage;
+        if (!r?.success)
+            throw new Error(r?.error ?? 'addAgentMessage failed');
+    }
+    async sendChatAction(input) {
+        if (!input.chatId || !input.participantId || !input.action)
+            throw new Error('chatId, participantId, action are required');
+        const result = await this.graphql(`mutation SendChatAction($input: SendChatActionInput!) {
+        sendChatAction(input: $input) { success error }
+      }`, {
+            input: {
+                chatId: input.chatId,
+                participantId: input.participantId,
+                action: input.action,
+                data: input.data ?? null,
+            },
+        });
+        const r = result.sendChatAction;
+        if (!r?.success)
+            throw new Error(r?.error ?? 'sendChatAction failed');
+    }
+    async checkBot(key) {
+        const result = await this.graphql(`query CheckBot($key: String!) { checkBot(key: $key) { success exists id error } }`, { key });
+        return result.checkBot;
+    }
+    async registerBot(input) {
+        const result = await this.graphql(`mutation RegisterBot($input: RegisterBotInput!) {
+        registerBot(input: $input) { success error bot { id key name } }
+      }`, { input });
+        const r = result.registerBot;
+        if (!r?.success)
+            throw new Error(r?.error ?? 'registerBot failed');
+        if (!r.bot?.id)
+            throw new Error('registerBot: no bot id');
+        return r.bot.id;
+    }
+    async setAiRespondingStatus(chatId, participantId, status) {
+        const input = { chatId, participantId, status };
+        const result = await this.graphql(`mutation SetAiRespondingStatus($input: SetAiRespondingStatusInput!) {
+        setAiRespondingStatus(input: $input) { success error }
+      }`, { input });
+        const r = result.setAiRespondingStatus;
+        if (!r?.success)
+            throw new Error(r?.error ?? 'setAiRespondingStatus failed');
+    }
+}
+export function createCommunicatorClient(baseURL, apiKey) {
+    return new CommunicatorClient(baseURL, apiKey ?? '');
+}
+//# sourceMappingURL=client.js.map

package/dist/communicator/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/communicator/client.ts"],"names":[],"mappings":"AA6DA,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAkB;QAC7B,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ;KAC5F,CAAC;IACF,MAAM,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAgB,CAAC;AAC1E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyC;IACjE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,IAAK,IAAI,CAAC,MAAM,CAAY,IAAK,IAAI,CAAC,SAAS,CAAY,CAAC;QAClF,IAAI,IAAI,IAAI,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;YACnB,IAAI;SACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAiC;IAC3D,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5D,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI;QAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACrE,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;QAC/B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC7D,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC1C,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,SAAS;QACjD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,SAAS;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,kBAAkB;IAEV;IACA;IAFnB,YACmB,OAAe,EACf,SAAiB,EAAE;QADnB,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAa;IACnC,CAAC;IAEI,KAAK,CAAC,OAAO,CAAI,KAAa,EAAE,SAAkC;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QAEpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI;YACJ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAExE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,IAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAiC;QACrD,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAEtF,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B;;;;;;QAME,EACF,EAAE,KAAK,EAAE,WAAW,EAAE,CACvB,CAAC;QAEF,MAAM,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;QACjC,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,wBAAwB,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM;YACxD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B;;QAEE,EACF;YACE,KAAK,EAAE;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;aACzB;SACF,CACF,CAAC;QAEF,MAAM,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;QAChC,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,uBAAuB,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B,mFAAmF,EACnF,EAAE,GAAG,EAAE,CACR,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B;;QAEE,EACF,EAAE,KAAK,EAAE,CACV,CAAC;QAEF,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAC7B,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,oBAAoB,CAAC,CAAC;QACnE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,MAAc,EACd,aAAqB,EACrB,MAA0B;QAE1B,MAAM,KAAK,GAA+B,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B;;QAEE,EACF,EAAE,KAAK,EAAE,CACV,CAAC;QAEF,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,CAAC;QACvC,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,8BAA8B,CAAC,CAAC;IAC/E,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,MAAe;IACvE,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC"}