charness 0.0.0-stage → 3.1.0

package/dist/connectors/jira/unconfirmedPosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unconfirmedPosts.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/unconfirmedPosts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;GAQG;AAEH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAG3E,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAE3D,QAAA,MAAM,yBAAyB;;;;;;;;iBAO7B,CAAC;AAEH,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,kHAAkH;AAClH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEjE;AAMD,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAA0C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAH/F,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;gBAEnC,IAAI,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,EAAmB,GAAG,EAAE,MAAM,MAAM;IAE7G,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,oBAAoB;IAIlF;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,KAAK;IAMb,8HAA8H;IAC9H,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/D;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9E,wGAAwG;IACxG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjD,OAAO,CAAC,KAAK;CAId"}

package/dist/connectors/jira/unconfirmedPosts.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JiraUnconfirmedPosts = exports.unconfirmedPostMaxAgeMs = exports.jiraUnconfirmedPostsFileName = void 0;
+exports.getCommentBodyHash = getCommentBodyHash;
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const rotatingJsonlFile_1 = require("../../utils/rotatingJsonlFile");
+/**
+ * @description The comments of a request the answer sink posted without Jira
+ * confirming them (plan R29): `DATA_DIR/jira-unconfirmed-posts.jsonl`, one line
+ * per post that ended unconfirmed and one per entry settled later. When the
+ * agent sends the same text again for the same request, the sink reads the
+ * issue first and skips a comment that did land — after a restart too — so an
+ * answer is posted at most once. An entry older than a day is forgotten: the
+ * agent resends within minutes, not days.
+ */
+exports.jiraUnconfirmedPostsFileName = 'jira-unconfirmed-posts.jsonl';
+/** Unconfirmed posts are rare; ample for a long time, the one `.1` backup is read too. */
+const unconfirmedPostsMaxBytes = 1024 * 1024;
+exports.unconfirmedPostMaxAgeMs = 24 * 60 * 60 * 1000;
+const unconfirmedPostLineSchema = zod_1.z.object({
+    requestId: zod_1.z.string().min(1),
+    bodyHash: zod_1.z.string().min(1),
+    /** `unconfirmed` — the post's outcome is unknown; `settled` — it no longer needs a check. */
+    state: zod_1.z.enum(['unconfirmed', 'settled']),
+    /** Epoch ms: when the post started (`unconfirmed`) or when it settled. */
+    at: zod_1.z.number(),
+});
+/** @description The hash a comment's comparable text is remembered by — the text itself stays out of the file. */
+function getCommentBodyHash(comparableText) {
+    return (0, node_crypto_1.createHash)('sha256').update(comparableText).digest('hex');
+}
+function getPostIdentity(requestId, bodyHash) {
+    return `${requestId}\u0000${bodyHash}`;
+}
+class JiraUnconfirmedPosts {
+    file;
+    now;
+    /** Post start time of every open entry, by request and body hash. */
+    postedAtByIdentity = new Map();
+    constructor(file, now) {
+        this.file = file;
+        this.now = now;
+    }
+    static createForDataDir(filePath, now) {
+        return new JiraUnconfirmedPosts(new rotatingJsonlFile_1.RotatingJsonlFile(filePath, unconfirmedPostsMaxBytes), now);
+    }
+    /**
+     * @description Replay the file, keeping only the entries still young enough to
+     * matter. A line that does not parse is skipped with a warning (never fatal).
+     */
+    async load() {
+        const { records, skippedCount } = await this.file.readRecords(unconfirmedPostLineSchema);
+        for (const line of records)
+            this.apply(line);
+        this.forgetExpired();
+        if (skippedCount > 0)
+            console.warn(`[jira] unconfirmed posts: ${skippedCount} unreadable line(s) skipped`);
+    }
+    apply(line) {
+        const identity = getPostIdentity(line.requestId, line.bodyHash);
+        if (line.state === 'unconfirmed')
+            this.postedAtByIdentity.set(identity, line.at);
+        else
+            this.postedAtByIdentity.delete(identity);
+    }
+    /** @description When the unconfirmed post of this body started, or `null` when there is none (or it is too old to matter). */
+    getPostedAt(requestId, bodyHash) {
+        this.forgetExpired();
+        return this.postedAtByIdentity.get(getPostIdentity(requestId, bodyHash)) ?? null;
+    }
+    /**
+     * An entry past {@link unconfirmedPostMaxAgeMs} is dropped: most are never
+     * resent (the request closed, the agent sent other text), and kept they would
+     * only grow the map for the life of the process.
+     */
+    forgetExpired() {
+        const nowMs = this.now();
+        for (const [identity, postedAt] of this.postedAtByIdentity) {
+            if (nowMs - postedAt >= exports.unconfirmedPostMaxAgeMs)
+                this.postedAtByIdentity.delete(identity);
+        }
+    }
+    /**
+     * @description Remember a post Jira did not confirm. A line that cannot be
+     * written is still remembered for this process (a warning): the resend right
+     * after it is the one that matters most.
+     */
+    recordUnconfirmed(requestId, bodyHash, postedAt) {
+        this.write({ requestId, bodyHash, state: 'unconfirmed', at: postedAt });
+    }
+    /** @description The post landed, or a check found it did not: nothing to check on a resend any more. */
+    settle(requestId, bodyHash) {
+        if (!this.postedAtByIdentity.has(getPostIdentity(requestId, bodyHash)))
+            return;
+        this.write({ requestId, bodyHash, state: 'settled', at: this.now() });
+    }
+    write(line) {
+        if (!this.file.append(line))
+            console.warn(`[jira] unconfirmed posts: request ${line.requestId}: the ${line.state} line could not be written`);
+        this.apply(line);
+    }
+}
+exports.JiraUnconfirmedPosts = JiraUnconfirmedPosts;
+//# sourceMappingURL=unconfirmedPosts.js.map

package/dist/connectors/jira/unconfirmedPosts.js.map

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

package/dist/connectors/telegram/answerSink.d.ts

@@ -0,0 +1,46 @@
+import type { AnswerSink } from '../../platform/answerSink';
+import type { RequestAlertReason } from '../../requests/types';
+import { type SessionKey } from '../../sessionKey';
+import type { SendMessagesToThread } from '../../utils/messageSendService';
+/**
+ * @name TelegramAnswerSinkDeps
+ * @description The bot primitives the sink drives. `postAlert` sends the
+ * localized alert text and resolves its message id (`null` when the send
+ * failed); the pin helpers swallow their own failures and `pinMessage` pins WITH
+ * a notification; the answer-pin store remembers the latest pinned answer per
+ * conversation across restarts.
+ */
+export interface TelegramAnswerSinkDeps {
+    sendMessages: SendMessagesToThread;
+    postAlert: (key: SessionKey, requestId: string, reason: RequestAlertReason) => Promise<number | null>;
+    pinMessage: (key: SessionKey, messageId: number) => Promise<boolean>;
+    unpinMessage: (key: SessionKey, messageId: number) => Promise<void>;
+    getAnswerPinMessageId: (key: SessionKey) => number | undefined;
+    setAnswerPinMessageId: (key: SessionKey, messageId: number) => Promise<void>;
+}
+/**
+ * @description Telegram's answer sink (core S3, pins S8): an answer is posted as
+ * its own message (split over the message cap) through the same paced, recorded
+ * send path as `send_messages_to_user`, which reports whether it landed. A
+ * partial delivery (some of the split messages failed) still counts as
+ * delivered but comes back as a warning, so the agent knows part of the answer is
+ * missing.
+ *
+ * Every delivered answer is PINNED with a notification — the operator runs
+ * topics muted and a pin is what notifies — and only the LATEST answer of a
+ * conversation stays pinned: the previous answer's pin is released silently, the
+ * message itself stays in the chat. The record of the pinned answer is persisted,
+ * so an answer after a restart still releases the one before. A pin that fails
+ * leaves the previous record as it is — nothing was replaced. Native question
+ * pins and scheduled-run pins are separate records and never touched here. Of a
+ * split answer the FIRST message is pinned: the notification previews its start.
+ * The pin hand-over is serialized per conversation: two answers delivered at once
+ * (parallel `answer_request` calls) would otherwise both read the same previous
+ * pin and leave the earlier of them pinned for good.
+ *
+ * The wake-up alert (core S4) is a bot message naming the request, PINNED with a
+ * notification and unpinned when that request closes. Its message id is the
+ * alert handle.
+ */
+export declare function createTelegramAnswerSink(deps: TelegramAnswerSinkDeps): AnswerSink;
+//# sourceMappingURL=answerSink.d.ts.map

package/dist/connectors/telegram/answerSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerSink.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/answerSink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtG,UAAU,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,qBAAqB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,qBAAqB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAqCjF"}

package/dist/connectors/telegram/answerSink.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTelegramAnswerSink = createTelegramAnswerSink;
+const sessionKey_1 = require("../../sessionKey");
+const state_1 = require("../../state");
+/**
+ * @description Telegram's answer sink (core S3, pins S8): an answer is posted as
+ * its own message (split over the message cap) through the same paced, recorded
+ * send path as `send_messages_to_user`, which reports whether it landed. A
+ * partial delivery (some of the split messages failed) still counts as
+ * delivered but comes back as a warning, so the agent knows part of the answer is
+ * missing.
+ *
+ * Every delivered answer is PINNED with a notification — the operator runs
+ * topics muted and a pin is what notifies — and only the LATEST answer of a
+ * conversation stays pinned: the previous answer's pin is released silently, the
+ * message itself stays in the chat. The record of the pinned answer is persisted,
+ * so an answer after a restart still releases the one before. A pin that fails
+ * leaves the previous record as it is — nothing was replaced. Native question
+ * pins and scheduled-run pins are separate records and never touched here. Of a
+ * split answer the FIRST message is pinned: the notification previews its start.
+ * The pin hand-over is serialized per conversation: two answers delivered at once
+ * (parallel `answer_request` calls) would otherwise both read the same previous
+ * pin and leave the earlier of them pinned for good.
+ *
+ * The wake-up alert (core S4) is a bot message naming the request, PINNED with a
+ * notification and unpinned when that request closes. Its message id is the
+ * alert handle.
+ */
+function createTelegramAnswerSink(deps) {
+    const answerPinLock = new state_1.KeyLock();
+    function pinLatestAnswer(key, messageId) {
+        return answerPinLock.withLock((0, sessionKey_1.keyToString)(key), async () => {
+            const previousMessageId = deps.getAnswerPinMessageId(key);
+            if (previousMessageId === messageId)
+                return;
+            const isPinned = await deps.pinMessage(key, messageId);
+            if (!isPinned)
+                return;
+            // The new pin is up; the previous answer leaves the pinned bar quietly.
+            if (previousMessageId !== undefined)
+                await deps.unpinMessage(key, previousMessageId);
+            await deps.setAnswerPinMessageId(key, messageId);
+        });
+    }
+    return {
+        async deliverAnswer(key, delivery) {
+            const result = await deps.sendMessages((0, sessionKey_1.keyToString)(key), { messages: [delivery.body] });
+            if (!result.ok)
+                return { ok: false, error: result.error };
+            const [firstMessageId] = result.sentMessageIds;
+            if (firstMessageId !== undefined)
+                await pinLatestAnswer(key, firstMessageId);
+            return result.undeliveredCount > 0 ? { ok: true, warning: result.summary } : { ok: true };
+        },
+        async deliverAlert(key, alert) {
+            const messageId = await deps.postAlert(key, alert.requestId, alert.reason);
+            if (messageId === null)
+                return { ok: false, error: 'the alert message could not be sent' };
+            const isPinned = await deps.pinMessage(key, messageId);
+            // Unpinned it still stands in the topic; only a pinned one needs releasing.
+            return isPinned ? { ok: true, alertRef: messageId.toString() } : { ok: true };
+        },
+        async releaseAlert(key, alertRef) {
+            const messageId = Number(alertRef);
+            if (Number.isInteger(messageId))
+                await deps.unpinMessage(key, messageId);
+        },
+    };
+}
+//# sourceMappingURL=answerSink.js.map

package/dist/connectors/telegram/answerSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerSink.js","sourceRoot":"","sources":["../../../src/connectors/telegram/answerSink.ts"],"names":[],"mappings":";;AA+CA,4DAqCC;AAlFD,iDAAgE;AAChE,uCAAsC;AAoBtC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,wBAAwB,CAAC,IAA4B;IACnE,MAAM,aAAa,GAAG,IAAI,eAAO,EAAE,CAAC;IAEpC,SAAS,eAAe,CAAC,GAAe,EAAE,SAAiB;QACzD,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAA,wBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC1D,IAAI,iBAAiB,KAAK,SAAS;gBAAE,OAAO;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,wEAAwE;YACxE,IAAI,iBAAiB,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACrF,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAA,wBAAW,EAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1D,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;YAC/C,IAAI,cAAc,KAAK,SAAS;gBAAE,MAAM,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK;YAC3B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3E,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;YAC3F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvD,4EAA4E;YAC5E,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAChF,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ;YAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;gBAAE,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC3E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/connectors/telegram/commands/autoContinueLimits.d.ts

@@ -0,0 +1,34 @@
+import type { Message } from 'telegraf/typings/core/types/typegram';
+import type { SessionKey } from '../../../sessionKey';
+import { RequestWakeUpEngine } from '../../../requests/wakeUpEngine';
+import type { BotCore } from './botCore';
+/**
+ * @description Append the shared `/auto_continue_limits` pointer to a usage-limit
+ * arming notice. ONE key appended at ONE place, so the reset-time notice and the
+ * "retrying in N min" fallback can never drift apart (the `effort.current_hint`
+ * block shared by both `/model`-set replies is the same pattern). No inline
+ * keyboard is needed: Telegram auto-links a bare command written in message text.
+ */
+export declare function appendAutoContinueLimitsHint(noticeText: string): string;
+/**
+ * What the auto-resume switch needs from the bot: the shared core, the armed usage-limit retry it reads and
+ * cancels, and the request wake-up engine, which exists only after the boot built it.
+ */
+export interface AutoContinueLimitsPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral'> {
+    /** Open the `/limits` screen in the topic (the bare alias lands there). */
+    openLimitsView: (key: SessionKey) => Promise<void>;
+    getArmedLimitRetryFireAt: (key: SessionKey) => number | null;
+    cancelApiRetry: (key: SessionKey) => void;
+    getRequestWakeUpEngine: () => Pick<RequestWakeUpEngine, 'stopWakingForLimitWait'> | null;
+}
+/**
+ * @description Build the auto-resume switch over its ports. It returns the picker consumer the usage-limit
+ * notice's own buttons call, and the `register…()` calls.
+ */
+export declare function createAutoContinueLimits(ports: AutoContinueLimitsPorts): {
+    applyAutoContinueLimits: (key: SessionKey, isGeneral: boolean, enabled: boolean | null) => Promise<string>;
+    consumeAutoContinueLimitsPicker: (key: SessionKey, cbMsg: Message | undefined, text: string) => Promise<void>;
+    registerAutoContinueLimitsCommands: () => void;
+    registerAutoContinueLimitsCallbacks: () => void;
+};
+//# sourceMappingURL=autoContinueLimits.d.ts.map

package/dist/connectors/telegram/commands/autoContinueLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoContinueLimits.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/autoContinueLimits.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;GAGG;AACH,MAAM,WAAW,uBACf,SAAQ,IAAI,CACV,OAAO,EACP,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CAC9G;IACD,2EAA2E;IAC3E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,wBAAwB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7D,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,sBAAsB,EAAE,MAAM,IAAI,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,GAAG,IAAI,CAAC;CAC1F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB;mCAezB,UAAU,aAAa,OAAO,WAAW,OAAO,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,CAAC;2CAyBjE,UAAU,SAAS,OAAO,GAAG,SAAS,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;8CAqBzE,IAAI;+CAeH,IAAI;EAYrD"}

package/dist/connectors/telegram/commands/autoContinueLimits.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendAutoContinueLimitsHint = appendAutoContinueLimitsHint;
+exports.createAutoContinueLimits = createAutoContinueLimits;
+const sessionKeyCodec_1 = require("../sessionKeyCodec");
+const rateLimiter_1 = require("../../../rateLimiter");
+const i18n_1 = require("../../../i18n");
+const sendErrorClassifier_1 = require("../../../sendErrorClassifier");
+/**
+ * @description Append the shared `/auto_continue_limits` pointer to a usage-limit
+ * arming notice. ONE key appended at ONE place, so the reset-time notice and the
+ * "retrying in N min" fallback can never drift apart (the `effort.current_hint`
+ * block shared by both `/model`-set replies is the same pattern). No inline
+ * keyboard is needed: Telegram auto-links a bare command written in message text.
+ */
+function appendAutoContinueLimitsHint(noticeText) {
+    return `${noticeText}\n\n${(0, i18n_1.t)('autoContinueLimits.noticeHint')}`;
+}
+/**
+ * @description Build the auto-resume switch over its ports. It returns the picker consumer the usage-limit
+ * notice's own buttons call, and the `register…()` calls.
+ */
+function createAutoContinueLimits(ports) {
+    const { openLimitsView, getArmedLimitRetryFireAt, cancelApiRetry, getRequestWakeUpEngine, bot, command, getState, replyToThread, authoriseContext, withThreadLocale, checkIsGeneral } = ports;
+    /**
+     * @description Apply the `/auto_continue_limits` setting and RETURN the
+     * confirmation text — the single write path behind the command and its picker
+     * buttons, so the two can never drift. The caller decides delivery (the command
+     * replies; the picker edits its own message into the confirmation).
+     *
+     * Regular topic → the per-thread override; General topic → the instance-wide
+     * default. Turning it OFF for a topic also drops that topic's armed resume:
+     * staying armed after «Disable» would contradict the setting. Unlike
+     * `/compact_on_idle` there is no timer to re-arm — the toggle is read at the
+     * moment a limit error arrives.
+     */
+    async function applyAutoContinueLimits(key, isGeneral, enabled) {
+        if (isGeneral) {
+            const value = enabled ?? true;
+            await getState().setAutoContinueOnLimitGlobalDefault(value);
+            return (0, i18n_1.t)('autoContinueLimits.setGlobal', { state: value ? (0, i18n_1.t)('autoContinueLimits.on') : (0, i18n_1.t)('autoContinueLimits.off') });
+        }
+        await getState().setAutoContinueOnLimitOverride(key, enabled);
+        // `null` drops the override: what the topic follows now is the instance default.
+        const effective = getState().checkIsAutoContinueOnLimitEnabled(key);
+        const stateWord = effective ? (0, i18n_1.t)('autoContinueLimits.on') : (0, i18n_1.t)('autoContinueLimits.off');
+        if (!effective) {
+            const isLimitWaitArmed = getArmedLimitRetryFireAt(key) !== null;
+            cancelApiRetry(key);
+            // Nothing resumes this wait any more: its request must not be woken into the same limit.
+            if (isLimitWaitArmed)
+                await getRequestWakeUpEngine()?.stopWakingForLimitWait(key);
+        }
+        return (0, i18n_1.t)('autoContinueLimits.setThisTopic', { state: stateWord });
+    }
+    /**
+     * @description Rewrite the tapped picker into a final, keyboard-less confirmation:
+     * a pick consumes the menu (the `/language` picker is the reference), so the same
+     * button can't be acted on twice and the topic reads truthfully. Best-effort — a
+     * failed edit only costs the relabel, never the state change that preceded it.
+     */
+    async function consumeAutoContinueLimitsPicker(key, cbMsg, text) {
+        if (!cbMsg)
+            return;
+        try {
+            await (0, rateLimiter_1.enqueueSend)(key, () => bot.telegram.editMessageText((0, sessionKeyCodec_1.getTelegramChatId)(key), cbMsg.message_id, undefined, text));
+        }
+        catch (e) {
+            const desc = (0, sendErrorClassifier_1.checkIsApiError)(e) ? (0, sendErrorClassifier_1.getErrorDescription)(e) : '';
+            if (!/message is not modified/i.test(desc))
+                console.warn('[acl_cb] picker relabel failed:', desc || e);
+        }
+    }
+    /** Shared `acl_on` / `acl_off` tap handler: apply, then consume the picker. */
+    async function handleAutoContinueLimitsCallback(ctx, enabled) {
+        const key = await authoriseContext(ctx);
+        if (!key) {
+            await ctx.answerCbQuery((0, i18n_1.t)('cb.access_denied'));
+            return;
+        }
+        await withThreadLocale(key, async () => {
+            const confirmation = await applyAutoContinueLimits(key, checkIsGeneral(key), enabled);
+            await ctx.answerCbQuery();
+            await consumeAutoContinueLimitsPicker(key, ctx.callbackQuery?.message, confirmation);
+        });
+    }
+    function registerAutoContinueLimitsCommands() {
+        // `/auto_continue_limits` — hidden alias of `/limits`. `on` / `off` set the setting (regular topic →
+        // per-thread override; General → the instance-wide default); bare opens the `/limits` screen. Deliberately
+        // NOT gated on an adapter/session: a limit can hit any topic at any time, and the operator must be able to
+        // set the preference before that.
+        command('auto_continue_limits', async (ctx, key) => {
+            const arg = ctx.message.text.split(/\s+/).slice(1).join(' ').trim().toLowerCase();
+            if (arg === 'on' || arg === 'off') {
+                await replyToThread(key, await applyAutoContinueLimits(key, checkIsGeneral(key), arg === 'on'));
+                return;
+            }
+            await openLimitsView(key);
+        });
+    }
+    function registerAutoContinueLimitsCallbacks() {
+        bot.action('acl_on', (ctx) => handleAutoContinueLimitsCallback(ctx, true));
+        bot.action('acl_off', (ctx) => handleAutoContinueLimitsCallback(ctx, false));
+    }
+    return {
+        applyAutoContinueLimits,
+        consumeAutoContinueLimitsPicker,
+        registerAutoContinueLimitsCommands,
+        registerAutoContinueLimitsCallbacks,
+    };
+}
+//# sourceMappingURL=autoContinueLimits.js.map

package/dist/connectors/telegram/commands/autoContinueLimits.js.map

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

package/dist/connectors/telegram/commands/botCore.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The ports every Telegram command module takes from `bot.ts`: the telegraf instance, the neutral command
+ * registrar, the topic send helpers and the few cross-cutting calls a handler makes. A module asks for the
+ * members it uses (`Pick<BotCore, …>`), and `bot.ts` builds the one object that satisfies them all.
+ */
+import type { Context, NarrowedContext, Telegraf } from 'telegraf';
+import type { Message, Update } from 'telegraf/typings/core/types/typegram';
+import type { InboundCommand } from '../../../platform/inbound';
+import type { SessionKey } from '../../../sessionKey';
+import type { StateStore } from '../../../state';
+/** The Telegram context a command handler receives — a text message, always. */
+export type CommandContext = NarrowedContext<Context, Update.MessageUpdate<Message.TextMessage>>;
+/** Register a command handler on the neutral router. */
+export type RegisterCommand = (name: string | string[], handler: (ctx: CommandContext, key: SessionKey, parsed: InboundCommand) => Promise<void> | void) => void;
+export interface BotCore {
+    bot: Telegraf;
+    command: RegisterCommand;
+    /**
+     * The state store, assigned when the bot boots — after the handlers are registered. Read it through this
+     * getter each time a handler RUNS; a copy taken at registration would be `undefined`.
+     */
+    getState: () => StateStore;
+    /** Send into the topic (paced, tracked for `/clear_messages`); the sent message id, or `null` when the send failed. */
+    replyToThread: (key: SessionKey, text: string, extra?: object, options?: {
+        unpaced?: boolean;
+    }) => Promise<number | null>;
+    /** Edit a message of the topic in place; `false` when the edit failed. */
+    editThreadMessage: (key: SessionKey, messageId: number, text: string, extra?: object) => Promise<boolean>;
+    deleteThreadMessage: (key: SessionKey, messageId: number) => Promise<void>;
+    /** Gate a callback or message to an admin of the served group; the topic's key, or `null` when it is refused. */
+    authoriseContext: (ctx: Context) => Promise<SessionKey | null>;
+    /** Run `fn` with the topic's resolved locale for `t(…)`. */
+    withThreadLocale: <TResult>(key: SessionKey, fn: () => TResult) => TResult;
+    checkIsGeneral: (key: SessionKey) => boolean;
+    /** Refresh (or create) the topic's pinned status banner. */
+    updatePinnedStatus: (key: SessionKey) => Promise<void>;
+    /** Close the topic's open request as cancelled (the conversation was cancelled or ended). */
+    cancelConversationRequest: (key: SessionKey) => void;
+    /**
+     * Wake the topic's SLEEPING conversation (process stopped, session kept) before a command that needs a live
+     * agent. The notice to post (a resume that failed and a fresh start), `''` for a silent resume, `null` when
+     * nothing slept.
+     */
+    wakeSleepingSession: (key: SessionKey) => Promise<string | null>;
+}
+//# sourceMappingURL=botCore.d.ts.map

package/dist/connectors/telegram/commands/botCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"botCore.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botCore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAEjG,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAC5F,IAAI,CAAC;AAEV,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,UAAU,CAAC;IAC3B,uHAAuH;IACvH,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1H,0EAA0E;IAC1E,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1G,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,iHAAiH;IACjH,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/D,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IAC7C,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,6FAA6F;IAC7F,yBAAyB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClE"}

package/dist/connectors/telegram/commands/botCore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=botCore.js.map

package/dist/connectors/telegram/commands/botCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botCore.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botCore.ts"],"names":[],"mappings":""}

package/dist/connectors/telegram/commands/callbackMessage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The message a callback button sits on.
+ */
+import type { Context } from 'telegraf';
+/**
+ * @description Id of the message a callback button sits on, or `null` when
+ * Telegram did not attach one (a very old message). Callbacks that resolve an
+ * INDEX against a per-message snapshot need it to reject a stale keyboard
+ * rather than resolve against another message's list.
+ */
+export declare function getCallbackMessageId(ctx: Context): number | null;
+//# sourceMappingURL=callbackMessage.d.ts.map

package/dist/connectors/telegram/commands/callbackMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackMessage.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEhE"}

package/dist/connectors/telegram/commands/callbackMessage.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallbackMessageId = getCallbackMessageId;
+/**
+ * @description Id of the message a callback button sits on, or `null` when
+ * Telegram did not attach one (a very old message). Callbacks that resolve an
+ * INDEX against a per-message snapshot need it to reject a stale keyboard
+ * rather than resolve against another message's list.
+ */
+function getCallbackMessageId(ctx) {
+    return ctx.callbackQuery?.message?.message_id ?? null;
+}
+//# sourceMappingURL=callbackMessage.js.map

package/dist/connectors/telegram/commands/callbackMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackMessage.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":";;AAWA,oDAEC;AARD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/connectors/telegram/commands/claudeAccounts.d.ts

@@ -0,0 +1,58 @@
+import type { SessionKey } from '../../../sessionKey';
+import type { ClaudeConfigDirApplyResult } from '../../../adapters/claudeConfigDir';
+import type { ClaudeLoginProfile } from '../../../agentLogin/agentLogin';
+import { type ClaudeAuthStatus } from '../../../utils/claudeProfiles';
+import type { BotCore } from './botCore';
+/**
+ * How a profile change reached the topic's live session: the adapter's own answer, plus `restartRequired`
+ * for a backend that cannot re-spawn a working session by itself (the tmux TUI mid-turn).
+ */
+export type ClaudeProfileApplyOutcome = ClaudeConfigDirApplyResult | 'restartRequired';
+/**
+ * What the account picker needs from the bot: the shared core, where profiles live, the CLI status probe,
+ * the profile sign-in driver, and the hooks that move live sessions onto a changed pick.
+ */
+export interface ClaudeAccountsPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'editThreadMessage' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral'> {
+    getDataDir: () => string;
+    /** The instance zone (`/timezone`) the reset instants are shown in. */
+    getInstanceTimezone: () => string;
+    /** Bring the per-profile usage snapshots up to date (`utils/claudeUsageRefresher.ts`); never throws. */
+    refreshClaudeUsage: (options: {
+        maxAgeMs?: number;
+    }) => Promise<void>;
+    /** `claude auth status --json` under `configDir` (`null` = `~/.claude`); `null` when the probe fails. */
+    readClaudeAuthStatus: (configDir: string | null) => Promise<ClaudeAuthStatus | null>;
+    /** Start the out-of-band sign-in of `profile`; the relay posts the link and the outcome into the topic. */
+    startClaudeProfileLogin: (key: SessionKey, profile: ClaudeLoginProfile) => Promise<void>;
+    /** Bring ONE topic's live Claude session onto the profile it now resolves to. */
+    applyClaudeProfile: (key: SessionKey) => Promise<ClaudeProfileApplyOutcome>;
+    /** Bring every served topic's live Claude session onto its resolved profile (after a General change / a removal). */
+    applyClaudeProfileEverywhere: () => Promise<void>;
+    /** The OpenCode providers the server is authenticated for (its live catalog); `[]` when it cannot be read. */
+    detectOpenCodeProviders: () => Promise<string[]>;
+    /** Drop a provider's stored credentials and post the outcome — the `/disconnect <provider>` flow, unchanged. */
+    disconnectOpenCodeProvider: (key: SessionKey, providerId: string) => Promise<void>;
+    /** Start the `/connect <provider>` flow (the method picker: OAuth or API key), unchanged. */
+    startOpenCodeConnect: (key: SessionKey, providerId: string) => Promise<void>;
+    /**
+     * The «auto switch to a fallback model» setting (`fallbackChain.ts` owns it and its confirmation): the legacy
+     * `autoswitch on|off` verb and the old `acct_autosw_*` buttons write it through here.
+     */
+    applyAutoSwitch: (key: SessionKey, isGeneral: boolean, enabled: boolean) => Promise<string>;
+    /** `~/.claude`, where the default login lives; injectable so a test signs out a temp directory, never the real one. */
+    getHomeClaudeDir?: () => string;
+}
+/**
+ * @description Build the `/account` feature over its ports: the command, its buttons, the name capture the
+ * «Add» button arms (the text handler asks `checkIsAwaitingProfileName` / `submitProfileName`), and the
+ * auth-status sink the sign-in driver reports to.
+ */
+export declare function createClaudeAccounts(ports: ClaudeAccountsPorts): {
+    registerClaudeAccountCommands: () => void;
+    registerClaudeAccountCallbacks: () => void;
+    checkIsAwaitingProfileName: (key: SessionKey) => boolean;
+    cancelProfileNameCapture: (key: SessionKey) => boolean;
+    submitProfileName: (key: SessionKey, text: string) => Promise<void>;
+    onClaudeProfileAuthStatus: (_key: SessionKey, profile: ClaudeLoginProfile, status: ClaudeAuthStatus | null) => Promise<void>;
+};
+//# sourceMappingURL=claudeAccounts.d.ts.map

package/dist/connectors/telegram/commands/claudeAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeAccounts.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/claudeAccounts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EASL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAiCvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG,iBAAiB,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,OAAO,EACP,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CACpI;IACD,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,wGAAwG;IACxG,kBAAkB,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,yGAAyG;IACzG,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrF,2GAA2G;IAC3G,uBAAuB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,iFAAiF;IACjF,kBAAkB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5E,qHAAqH;IACrH,4BAA4B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,8GAA8G;IAC9G,uBAAuB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,gHAAgH;IAChH,0BAA0B,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,6FAA6F;IAC7F,oBAAoB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;OAGG;IACH,eAAe,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,uHAAuH;IACvH,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AAKD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB;yCAkXnB,IAAI;0CAgEH,IAAI;sCAtGN,UAAU,KAAG,OAAO;oCAKtB,UAAU,KAAG,OAAO;6BAgBrB,UAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sCA5Q/B,UAAU,WAAW,kBAAkB,UAAU,gBAAgB,GAAG,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;EA4dxI"}