@sympoies/dsh-telegram 0.0.0-bootstrap.0 → 0.6.0

package/lib/harness/model-selection.js

@@ -0,0 +1,103 @@
+/**
+ * Changing which model a live agent's next step runs on.
+ *
+ * The harness holds one mutable selection object per agent, installed while
+ * the agent is still unpublished, and reads `current` each time it assembles a
+ * prompt. Mutating that object is how the web UI's model picker changes a
+ * running session's model, and it is what lets a conversation carrying an
+ * image run somewhere its neighbours do not.
+ *
+ * `current: undefined` means "no override", so the agent falls back to the
+ * route it was created with. That is what makes reverting free: there is
+ * nothing to restore, only an override to drop.
+ *
+ * ## Why this is reproduced rather than imported
+ *
+ * The harness exports `installModelSelection` from `@deepseek-ai/dsh-agent`,
+ * and importing it would be the obvious thing to do. It cannot be done: under
+ * pnpm's isolated layout a plugin resolves only its own declared dependencies,
+ * and the harness packages are the host's, not ours. A dynamic import of them
+ * fails with `ERR_MODULE_NOT_FOUND` every time — which is exactly how this
+ * feature came to do nothing at all while looking like it worked.
+ *
+ * What it does is two listener registrations on the agent's own context, so
+ * that is what this does. The coupling is to two event names and their
+ * payloads; `test/model-selection.test.ts` pins both.
+ */
+/**
+ * Make an agent follow a mutable selection.
+ *
+ * @param agentCtx - the agent's scoped context, during unpublished setup.
+ * @param selection - the object whose `current` decides each step's route.
+ * @returns a disposer removing both listeners.
+ */
+export function installModelSelection(agentCtx, selection) {
+    const disposeAssembly = agentCtx.on('system-prompt/assemble', async (_assembly, _context, next) => {
+        const selected = selection.current;
+        const assembled = await next();
+        // Recorded even when absent: the request half reads this, and a stale
+        // value would route one step on a selection another step assembled.
+        selection.assembled = selected;
+        if (selected === undefined)
+            return assembled;
+        return {
+            ...assembled,
+            variables: {
+                ...assembled.variables,
+                provider: selected.provider,
+                model: selected.model,
+            },
+        };
+    });
+    const disposeRequest = agentCtx.on('agent/request', async (_payload, next) => {
+        const resolved = await next();
+        const selected = selection.assembled;
+        if (selected === undefined)
+            return resolved;
+        // The inherited effort is dropped rather than kept: it belongs to the
+        // model being replaced, and a effort one model offers another may not.
+        const { reasoningEffort: _inherited, ...withoutInheritedEffort } = resolved;
+        return {
+            ...withoutInheritedEffort,
+            provider: selected.provider,
+            model: selected.model,
+            ...(selected.reasoningEffort === undefined
+                ? {}
+                : { reasoningEffort: selected.reasoningEffort }),
+        };
+    });
+    return () => {
+        disposeAssembly();
+        disposeRequest();
+    };
+}
+/** Whether two routes name the same model and reasoning effort. */
+export function sameRoute(a, b) {
+    if (a === undefined || b === undefined)
+        return a === b;
+    return (a.provider === b.provider &&
+        a.model === b.model &&
+        a.reasoningEffort === b.reasoningEffort);
+}
+/**
+ * Parse a `provider/model` setting.
+ *
+ * A model id may itself contain slashes — `openai/gpt-5` on a router-style
+ * provider is ordinary — so only the first separator divides them.
+ *
+ * @param value - the configured string; empty means no vision model.
+ * @returns the route, or undefined when unset or malformed.
+ */
+export function parseRoute(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    const separator = trimmed.indexOf('/');
+    if (separator <= 0 || separator === trimmed.length - 1)
+        return undefined;
+    return {
+        provider: trimmed.slice(0, separator),
+        model: trimmed.slice(separator + 1),
+    };
+}
+//# sourceMappingURL=model-selection.js.map

package/lib/harness/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../src/harness/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAmDH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA0B,EAC1B,SAA2B;IAE3B,MAAM,eAAe,GAAG,QAAQ,CAAC,EAAE,CACjC,wBAAwB,EACxB,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAA;QAClC,MAAM,SAAS,GAAG,MAAM,IAAI,EAAE,CAAA;QAE9B,sEAAsE;QACtE,oEAAoE;QACpE,SAAS,CAAC,SAAS,GAAG,QAAQ,CAAA;QAC9B,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAE5C,OAAO;YACL,GAAG,SAAS;YACZ,SAAS,EAAE;gBACT,GAAG,SAAS,CAAC,SAAS;gBACtB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB;SACF,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAC3E,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAA;QACpC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAA;QAE3C,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,sBAAsB,EAAE,GAAG,QAAQ,CAAA;QAE3E,OAAO;YACL,GAAG,sBAAsB;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,GAAG,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC;SACnD,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,EAAE;QACV,eAAe,EAAE,CAAA;QACjB,cAAc,EAAE,CAAA;IAClB,CAAC,CAAA;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,SAAS,CAAC,CAAyB,EAAE,CAAyB;IAC5E,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACtD,OAAO,CACL,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QACnB,CAAC,CAAC,eAAe,KAAK,CAAC,CAAC,eAAe,CACxC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IAExE,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QACrC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;KACpC,CAAA;AACH,CAAC"}

package/lib/harness/questions-seam.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Taking over the single user-questions provider without stealing it.
+ *
+ * `ctx.userQuestions` accepts exactly one provider and throws
+ * `DUPLICATE_PROVIDER` on a second registration. In a profile that also runs
+ * the web app, the browser has already claimed that slot — so a naive
+ * registration here would either fail to load or, worse, silently take every
+ * question away from the browser.
+ *
+ * Instead this seam swaps itself in and keeps the displaced provider as a
+ * fallback, so a question belonging to a browser session is forwarded straight
+ * back to it. Both surfaces keep working, and whichever one the user is
+ * actually looking at is the one that answers.
+ *
+ * On unload the previous provider is put back, so unloading this plugin
+ * restores exactly the arrangement that existed before it loaded.
+ */
+import type { Logger, UserQuestionProvider, UserQuestionService } from './types.js';
+/** What was installed, and how to undo it. */
+export interface QuestionSeam {
+    /** The provider that was registered before, if any. */
+    readonly previous: UserQuestionProvider | undefined;
+    /** Restore the previous arrangement. */
+    restore(): void;
+}
+/**
+ * Install a provider as the active one, chaining any incumbent.
+ *
+ * @param service - the live `ctx.userQuestions` service.
+ * @param build - builds the provider, given the incumbent to delegate to.
+ * @param logger - records which arrangement was chosen.
+ */
+export declare function installQuestionProvider(service: UserQuestionService, build: (previous: UserQuestionProvider | undefined) => UserQuestionProvider, logger?: Logger): QuestionSeam;
+//# sourceMappingURL=questions-seam.d.ts.map

package/lib/harness/questions-seam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions-seam.d.ts","sourceRoot":"","sources":["../../src/harness/questions-seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEnF,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,CAAA;IACnD,wCAAwC;IACxC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,KAAK,oBAAoB,EAC3E,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAwBd"}

package/lib/harness/questions-seam.js

@@ -0,0 +1,45 @@
+/**
+ * Taking over the single user-questions provider without stealing it.
+ *
+ * `ctx.userQuestions` accepts exactly one provider and throws
+ * `DUPLICATE_PROVIDER` on a second registration. In a profile that also runs
+ * the web app, the browser has already claimed that slot — so a naive
+ * registration here would either fail to load or, worse, silently take every
+ * question away from the browser.
+ *
+ * Instead this seam swaps itself in and keeps the displaced provider as a
+ * fallback, so a question belonging to a browser session is forwarded straight
+ * back to it. Both surfaces keep working, and whichever one the user is
+ * actually looking at is the one that answers.
+ *
+ * On unload the previous provider is put back, so unloading this plugin
+ * restores exactly the arrangement that existed before it loaded.
+ */
+/**
+ * Install a provider as the active one, chaining any incumbent.
+ *
+ * @param service - the live `ctx.userQuestions` service.
+ * @param build - builds the provider, given the incumbent to delegate to.
+ * @param logger - records which arrangement was chosen.
+ */
+export function installQuestionProvider(service, build, logger) {
+    const previous = service.provider;
+    if (previous === undefined) {
+        const dispose = service.registerProvider(build(undefined));
+        logger?.info('[dsh-telegram] answering the agent\'s questions in Telegram');
+        return { previous: undefined, restore: dispose };
+    }
+    // Clearing the slot before re-registering is what makes the takeover
+    // possible; registerProvider refuses while one is present.
+    service.provider = undefined;
+    const dispose = service.registerProvider(build(previous));
+    logger?.info('[dsh-telegram] answering questions in Telegram, forwarding other sessions to the existing UI');
+    return {
+        previous,
+        restore() {
+            dispose();
+            service.provider = previous;
+        },
+    };
+}
+//# sourceMappingURL=questions-seam.js.map

package/lib/harness/questions-seam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions-seam.js","sourceRoot":"","sources":["../../src/harness/questions-seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA4B,EAC5B,KAA2E,EAC3E,MAAe;IAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAEjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;QAC1D,MAAM,EAAE,IAAI,CAAC,6DAA6D,CAAC,CAAA;QAC3E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAClD,CAAC;IAED,qEAAqE;IACrE,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAA;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,MAAM,EAAE,IAAI,CACV,8FAA8F,CAC/F,CAAA;IAED,OAAO;QACL,QAAQ;QACR,OAAO;YACL,OAAO,EAAE,CAAA;YACT,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/harness/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Structural mirrors of the DeepSeek Harness seams this plugin plugs into.
+ *
+ * These are declared rather than imported so the package builds and tests on
+ * its own, without a harness checkout. They are structural types: the plugin
+ * entry casts the live `ctx` services to them at the single boundary where the
+ * harness is actually present, so a drift in the real contract shows up there
+ * instead of spreading through every module.
+ *
+ * Sources mirrored:
+ * - `@deepseek-ai/dsh-user-questions` — `ctx.userQuestions`
+ * - `@deepseek-ai/dsh-user-approval`  — the `approval/request` waterfall
+ * - `@deepseek-ai/dsh-agent`          — `ctx.agents`
+ * - `@deepseek-ai/dsh-session`        — the `session/event` feed
+ */
+/** One selectable answer offered to the user. */
+export interface AskUserQuestionOption {
+    readonly label: string;
+    readonly description?: string;
+}
+/**
+ * A caller-declared presentation intent. `plan-review` means the question IS a
+ * plan approval, and `detail` carries the plan itself.
+ */
+export interface AskUserQuestionIntent {
+    readonly kind: 'plan-review';
+    /** The option label that approves; every other option declines. */
+    readonly approve: string;
+}
+/** One question in a user-questions request. */
+export interface AskUserQuestionItem {
+    readonly id: string;
+    readonly question: string;
+    readonly detail?: string;
+    readonly header?: string;
+    readonly options?: readonly AskUserQuestionOption[];
+    readonly multiSelect?: boolean;
+    readonly intent?: AskUserQuestionIntent;
+}
+/** Answer to one question. */
+export interface AskUserQuestionAnswerItem {
+    readonly id: string;
+    readonly selected: string[];
+    readonly custom?: string;
+}
+/** The human's answer to a whole request. */
+export interface AskUserQuestionAnswer {
+    readonly answers: AskUserQuestionAnswerItem[];
+}
+/** A live agent, as far as this plugin needs to know. */
+export interface HarnessAgent {
+    readonly id: string;
+    readonly session: {
+        readonly id: string;
+    };
+}
+/** One `ctx.userQuestions.ask()` request. */
+export interface UserQuestionRequest {
+    readonly questions: readonly AskUserQuestionItem[];
+    readonly agent?: HarnessAgent;
+    readonly signal?: AbortSignal;
+}
+/** The single UI provider registered on `ctx.userQuestions`. */
+export interface UserQuestionProvider {
+    ask(request: UserQuestionRequest): Promise<AskUserQuestionAnswer>;
+}
+/** `ctx.userQuestions` — the seam we register against, and take over. */
+export interface UserQuestionService {
+    /** Explicitly clearable: taking the slot over requires emptying it first. */
+    provider?: UserQuestionProvider | undefined;
+    registerProvider(provider: UserQuestionProvider): () => void;
+}
+/** Every outcome the approval waterfall may produce; only one is a grant. */
+export type ApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable';
+/** One pending approval decision. */
+export interface ApprovalRequest {
+    readonly agent: HarnessAgent;
+    readonly toolName: string;
+    readonly callId?: string;
+    readonly reason?: string;
+    readonly signal?: AbortSignal;
+}
+/** The minimal logger surface the harness hands a plugin. */
+export interface Logger {
+    info(message: string, ...rest: unknown[]): void;
+    warn(message: string, ...rest: unknown[]): void;
+    error(message: string, ...rest: unknown[]): void;
+    debug(message: string, ...rest: unknown[]): void;
+}
+/** A no-op logger, so every module can take a logger without a null check. */
+export declare const SILENT_LOGGER: Logger;
+/** One registered settings namespace, from the owner's side. */
+export interface SettingsScope<T> {
+    /** The resolved value: schema defaults, then composition base, then user document. */
+    get(): T;
+    /** Observe committed changes; returns a disposer. */
+    watch(callback: (next: T, previous: T) => void): () => void;
+    /** Merge a patch into the user layer. */
+    update(patch: Partial<T>): Promise<void>;
+}
+/** `ctx.settings` — the seam a configuration UI reads and writes through. */
+export interface SettingsService {
+    register<T>(namespace: string, schema: unknown, options?: {
+        base?: unknown;
+        applies?: string;
+    }): SettingsScope<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/harness/types.d.ts.map

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

package/lib/harness/types.js

@@ -0,0 +1,23 @@
+/**
+ * Structural mirrors of the DeepSeek Harness seams this plugin plugs into.
+ *
+ * These are declared rather than imported so the package builds and tests on
+ * its own, without a harness checkout. They are structural types: the plugin
+ * entry casts the live `ctx` services to them at the single boundary where the
+ * harness is actually present, so a drift in the real contract shows up there
+ * instead of spreading through every module.
+ *
+ * Sources mirrored:
+ * - `@deepseek-ai/dsh-user-questions` — `ctx.userQuestions`
+ * - `@deepseek-ai/dsh-user-approval`  — the `approval/request` waterfall
+ * - `@deepseek-ai/dsh-agent`          — `ctx.agents`
+ * - `@deepseek-ai/dsh-session`        — the `session/event` feed
+ */
+/** A no-op logger, so every module can take a logger without a null check. */
+export const SILENT_LOGGER = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+    debug: () => undefined,
+};
+//# sourceMappingURL=types.js.map

package/lib/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsFH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA"}

package/lib/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * dsh-telegram — a Telegram front end for DeepSeek Harness.
+ *
+ * Two things this plugin does that a plain channel bridge does not:
+ *
+ * 1. **The agent's markdown arrives as markdown.** Replies are rendered to
+ *    Telegram HTML and sent with `parse_mode`, so bold is bold and a code
+ *    block is a code block — including while the answer is still streaming.
+ * 2. **Questions and approvals can be answered from the chat.** The plugin
+ *    registers a `ctx.userQuestions` provider and answers the
+ *    `approval/request` waterfall, so `ask_user_question` and a tool that
+ *    needs consent both become buttons in Telegram instead of a stall that
+ *    only a browser can clear.
+ *
+ * Everything here is wiring. The behaviour lives in the modules below, each
+ * testable without a harness; this file is the single place that touches the
+ * live `ctx`.
+ */
+import { Config } from './config.js';
+import type { AgentRegistryLike } from './harness/host.js';
+import type { Logger } from './harness/types.js';
+import type { TelegramConfig } from './config.js';
+export { Config };
+export type { TelegramConfig };
+/** Cordis plugin name; the package name, which is also the module id. */
+export declare const name = "@sympoies/dsh-telegram";
+/**
+ * Settings namespace this plugin owns. The browser half binds the same string,
+ * which is the only thing pairing the two halves together.
+ */
+export declare const SETTINGS_NAMESPACE = "telegram";
+/**
+ * Hard requirements only. Cordis reads this as a flat list of service names —
+ * an object form would be read as services literally named after its keys — so
+ * the interactive seams are bound inside `apply` with `ctx.inject()` instead.
+ * That is what lets the plugin load on a profile that provides neither.
+ */
+export declare const inject: string[];
+/** The slice of the cordis context this plugin uses. */
+interface PluginContext {
+    agents: AgentRegistryLike;
+    credentials: {
+        resolve(ref: unknown): Promise<{
+            value?: string;
+        } | undefined>;
+    };
+    logger(name: string): Logger;
+    get(key: string): unknown;
+    on(name: string, listener: (...args: never[]) => unknown, prepend?: boolean): () => void;
+    effect(callback: () => (() => void) | Promise<() => void>, label?: string): () => void;
+    /** Run `callback` once every named service is available; never, if one is not. */
+    inject(names: readonly string[], callback: (scope: PluginContext) => void): Disposable;
+}
+/** What `ctx.inject` hands back: a fiber whose disposal unwinds the callback. */
+interface Disposable {
+    dispose(): unknown;
+}
+/**
+ * Load the plugin.
+ *
+ * @param ctx - the cordis context.
+ * @param config - resolved plugin configuration.
+ */
+export declare function apply(ctx: PluginContext, config: TelegramConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAqCpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAGV,MAAM,EAGP,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B,yEAAyE;AACzE,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,MAAM,UAA4B,CAAA;AAE/C,wDAAwD;AACxD,UAAU,aAAa;IACrB,MAAM,EAAE,iBAAiB,CAAA;IACzB,WAAW,EAAE;QAAE,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC,CAAA;KAAE,CAAA;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI,CAAA;IACxF,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAA;IACtF,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,UAAU,CAAA;CACvF;AAED,iFAAiF;AACjF,UAAU,UAAU;IAClB,OAAO,IAAI,OAAO,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAuFtE"}