charness 0.0.0-stage → 3.0.0

package/dist/connectors/jira/trigger.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createdTriggerId = void 0;
+exports.findNewestTrigger = findNewestTrigger;
+exports.getIssueTrigger = getIssueTrigger;
+exports.checkIsPersonAccount = checkIsPersonAccount;
+exports.findEarlierPerson = findEarlierPerson;
+exports.getRequester = getRequester;
+/**
+ * @description Which change made an issue a request (Jira connector plan J5,
+ * D11–D12): the newest changelog entry that set the assignee to the AI account
+ * or moved the status into the trigger set. An issue created already matching
+ * has no such entry; its trigger is the creation itself. And who asked (J5b,
+ * R24): the person behind that change, or — when an app or automation made it —
+ * the nearest person before it, else the reporter. Pure: the poller hands in the
+ * changelog entries it read, newest pages first.
+ */
+/** The trigger id of an issue that matched from its creation. */
+exports.createdTriggerId = 'created';
+/** Jira's `accountType` of a person (an app or automation is `app`). */
+const personAccountType = 'atlassian';
+/** A changelog item names its field by `fieldId` (stable) or, on older entries, only by `field`. */
+function getItemField(item) {
+    return item.fieldId ?? item.field;
+}
+function getHistoryKind(history, match) {
+    for (const item of history.items) {
+        const field = getItemField(item);
+        if (field === 'assignee' && item.to === match.aiAccountId)
+            return 'assigned';
+        if (field === 'status' && item.to !== null && item.to !== undefined && match.triggerStatusIds.has(item.to))
+            return 'statusChanged';
+    }
+    return null;
+}
+/** Newest first: by creation time, then by id (Jira's ids grow). */
+function compareHistoriesNewestFirst(left, right) {
+    const byTime = Date.parse(right.created) - Date.parse(left.created);
+    return byTime !== 0 && Number.isFinite(byTime) ? byTime : Number(right.id) - Number(left.id);
+}
+/**
+ * @description The newest entry among `histories` that matches, or `null`. When
+ * `histories` are the NEWEST entries of the changelog (any number of its last
+ * pages), a match among them is the newest of the whole changelog — what lets
+ * the poller stop reading at the first page that holds one.
+ */
+function findNewestTrigger(histories, match) {
+    for (const history of [...histories].sort(compareHistoriesNewestFirst)) {
+        const kind = getHistoryKind(history, match);
+        if (kind)
+            return { triggerId: history.id, kind, author: history.author ?? null };
+    }
+    return null;
+}
+/** The trigger over a WHOLE changelog: its newest matching entry, else the creation. */
+function getIssueTrigger(histories, match, creator) {
+    return findNewestTrigger(histories, match) ?? { triggerId: exports.createdTriggerId, kind: 'created', author: creator };
+}
+/** A person, as opposed to an app or automation; a missing type is read as a person. */
+function checkIsPersonAccount(account) {
+    return account.accountType === undefined || account.accountType === personAccountType;
+}
+/** A person who may be handed an issue back: not an app, not the AI account itself. */
+function checkIsRequesterCandidate(account, aiAccountId) {
+    return account !== null && account !== undefined && checkIsPersonAccount(account) && account.accountId !== aiAccountId;
+}
+/**
+ * @description R24: the nearest person BEFORE the trigger in `histories` — the
+ * author of the newest older entry who is a person other than the AI account —
+ * or `null` when none of these entries has one (the caller may read older pages).
+ * Nothing comes before a creation trigger.
+ */
+function findEarlierPerson(histories, trigger, aiAccountId) {
+    if (trigger.kind === 'created')
+        return null;
+    const newestFirst = [...histories].sort(compareHistoriesNewestFirst);
+    const triggerIndex = newestFirst.findIndex((history) => history.id === trigger.triggerId);
+    if (triggerIndex < 0)
+        return null;
+    return newestFirst.slice(triggerIndex + 1).find((history) => checkIsRequesterCandidate(history.author, aiAccountId))?.author ?? null;
+}
+/**
+ * @description The requester ("sender") an answer goes back to: the trigger's
+ * author when a person made the change; when an app or automation made it (or
+ * Jira names no one), the nearest earlier person in the changelog (R24), else the
+ * issue's reporter — an app cannot read a comment or take the issue back.
+ */
+function getRequester(trigger, histories, reporter, aiAccountId) {
+    if (checkIsRequesterCandidate(trigger.author, aiAccountId))
+        return trigger.author;
+    return findEarlierPerson(histories, trigger, aiAccountId) ?? reporter;
+}
+//# sourceMappingURL=trigger.js.map

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

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

package/dist/connectors/jira/triggerLog.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { RotatingJsonlFile } from '../../utils/rotatingJsonlFile';
+/**
+ * @description The Jira connector's trigger log (plan J5, D12):
+ * `DATA_DIR/jira-triggers.jsonl`, one line per trigger the poller decided on,
+ * indexed in memory at boot. It is what keeps a trigger from becoming a second
+ * request — after a restart too — and what the run budget counts. Connector-
+ * owned, so the core request ledger stays platform-agnostic.
+ */
+export declare const jiraTriggerLogFileName = "jira-triggers.jsonl";
+/**
+ * @name JiraTriggerOutcome
+ * @description `request` — a request was opened; `selfAuthored` — the AI account
+ * made the change itself; `parked` — the issue was over its run budget.
+ */
+export type JiraTriggerOutcome = 'request' | 'selfAuthored' | 'parked';
+declare const triggerRecordSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    triggerId: z.ZodString;
+    outcome: z.ZodEnum<{
+        request: "request";
+        selfAuthored: "selfAuthored";
+        parked: "parked";
+    }>;
+    at: z.ZodNumber;
+    requestId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JiraTriggerRecord = z.infer<typeof triggerRecordSchema>;
+export declare class JiraTriggerLog {
+    private readonly file;
+    private readonly seen;
+    private readonly requestTimesByIssue;
+    constructor(file: RotatingJsonlFile<JiraTriggerRecord>);
+    static createForDataDir(filePath: string): JiraTriggerLog;
+    /** @description Index the file. A line that does not parse is skipped with a warning (never fatal). */
+    load(): Promise<void>;
+    private index;
+    checkIsSeen(issueKey: string, triggerId: string): boolean;
+    /** @description Requests opened for the issue in the rolling 24 h before `nowMs`. */
+    getRequestCountLastDay(issueKey: string, nowMs: number): number;
+    /** @description Persist a decision; `false` when the line could not be written (then nothing is indexed). */
+    record(record: JiraTriggerRecord): boolean;
+    /**
+     * @description Index a decision whose line could not be written, for this
+     * process only: a request already posted is never posted again before a
+     * restart (after one, its trigger reads as new).
+     */
+    remember(record: JiraTriggerRecord): void;
+}
+export {};
+//# sourceMappingURL=triggerLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggerLog.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/triggerLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;GAMG;AAEH,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAK5D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEvE,QAAA,MAAM,mBAAmB;;;;;;;;;;iBAOvB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMpE,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA+B;gBAEtC,IAAI,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;IAEvE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAIzD,uGAAuG;IACjG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,KAAK;IAQb,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzD,qFAAqF;IACrF,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/D,6GAA6G;IAC7G,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;IAM1C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAG1C"}

package/dist/connectors/jira/triggerLog.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JiraTriggerLog = exports.jiraTriggerLogFileName = void 0;
+const zod_1 = require("zod");
+const rotatingJsonlFile_1 = require("../../utils/rotatingJsonlFile");
+/**
+ * @description The Jira connector's trigger log (plan J5, D12):
+ * `DATA_DIR/jira-triggers.jsonl`, one line per trigger the poller decided on,
+ * indexed in memory at boot. It is what keeps a trigger from becoming a second
+ * request — after a restart too — and what the run budget counts. Connector-
+ * owned, so the core request ledger stays platform-agnostic.
+ */
+exports.jiraTriggerLogFileName = 'jira-triggers.jsonl';
+/** Ample for years of triggers; the one `.1` backup is read too. */
+const jiraTriggerLogMaxBytes = 10 * 1024 * 1024;
+const msPerDay = 24 * 60 * 60 * 1000;
+const triggerRecordSchema = zod_1.z.object({
+    issueKey: zod_1.z.string().min(1),
+    triggerId: zod_1.z.string().min(1),
+    outcome: zod_1.z.enum(['request', 'selfAuthored', 'parked']),
+    /** Epoch ms. */
+    at: zod_1.z.number(),
+    requestId: zod_1.z.string().optional(),
+});
+function getTriggerIdentity(issueKey, triggerId) {
+    return `${issueKey}\u0000${triggerId}`;
+}
+class JiraTriggerLog {
+    file;
+    seen = new Set();
+    requestTimesByIssue = new Map();
+    constructor(file) {
+        this.file = file;
+    }
+    static createForDataDir(filePath) {
+        return new JiraTriggerLog(new rotatingJsonlFile_1.RotatingJsonlFile(filePath, jiraTriggerLogMaxBytes));
+    }
+    /** @description Index the file. A line that does not parse is skipped with a warning (never fatal). */
+    async load() {
+        const { records, skippedCount } = await this.file.readRecords(triggerRecordSchema);
+        for (const record of records)
+            this.index(record);
+        if (skippedCount > 0)
+            console.warn(`[jira] trigger log: ${skippedCount} unreadable line(s) skipped`);
+    }
+    index(record) {
+        this.seen.add(getTriggerIdentity(record.issueKey, record.triggerId));
+        if (record.outcome !== 'request')
+            return;
+        const times = this.requestTimesByIssue.get(record.issueKey) ?? [];
+        times.push(record.at);
+        this.requestTimesByIssue.set(record.issueKey, times);
+    }
+    checkIsSeen(issueKey, triggerId) {
+        return this.seen.has(getTriggerIdentity(issueKey, triggerId));
+    }
+    /** @description Requests opened for the issue in the rolling 24 h before `nowMs`. */
+    getRequestCountLastDay(issueKey, nowMs) {
+        return (this.requestTimesByIssue.get(issueKey) ?? []).filter((at) => at > nowMs - msPerDay).length;
+    }
+    /** @description Persist a decision; `false` when the line could not be written (then nothing is indexed). */
+    record(record) {
+        if (!this.file.append(record))
+            return false;
+        this.index(record);
+        return true;
+    }
+    /**
+     * @description Index a decision whose line could not be written, for this
+     * process only: a request already posted is never posted again before a
+     * restart (after one, its trigger reads as new).
+     */
+    remember(record) {
+        this.index(record);
+    }
+}
+exports.JiraTriggerLog = JiraTriggerLog;
+//# sourceMappingURL=triggerLog.js.map

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

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

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

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { RotatingJsonlFile } from '../../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.
+ */
+export declare const jiraUnconfirmedPostsFileName = "jira-unconfirmed-posts.jsonl";
+export declare const unconfirmedPostMaxAgeMs: number;
+declare const unconfirmedPostLineSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    bodyHash: z.ZodString;
+    state: z.ZodEnum<{
+        unconfirmed: "unconfirmed";
+        settled: "settled";
+    }>;
+    at: z.ZodNumber;
+}, z.core.$strip>;
+type UnconfirmedPostLine = z.infer<typeof unconfirmedPostLineSchema>;
+/** @description The hash a comment's comparable text is remembered by — the text itself stays out of the file. */
+export declare function getCommentBodyHash(comparableText: string): string;
+export declare class JiraUnconfirmedPosts {
+    private readonly file;
+    private readonly now;
+    /** Post start time of every open entry, by request and body hash. */
+    private readonly postedAtByIdentity;
+    constructor(file: RotatingJsonlFile<UnconfirmedPostLine>, now: () => number);
+    static createForDataDir(filePath: string, now: () => number): JiraUnconfirmedPosts;
+    /**
+     * @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).
+     */
+    load(): Promise<void>;
+    private apply;
+    /** @description When the unconfirmed post of this body started, or `null` when there is none (or it is too old to matter). */
+    getPostedAt(requestId: string, bodyHash: string): number | 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.
+     */
+    private forgetExpired;
+    /**
+     * @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: string, bodyHash: string, postedAt: number): void;
+    /** @description The post landed, or a check found it did not: nothing to check on a resend any more. */
+    settle(requestId: string, bodyHash: string): void;
+    private write;
+}
+export {};
+//# sourceMappingURL=unconfirmedPosts.d.ts.map

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,31 @@
+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'> {
+    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): {
+    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":"AAKA,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;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAqBD;;;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,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;2CAqCjB,UAAU,SAAS,OAAO,GAAG,SAAS,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;8CAqBzE,IAAI;+CA2BH,IAAI;EAWrD"}