charness 3.6.1 → 3.8.0

package/dist/instanceSettings.js

@@ -38,19 +38,32 @@ exports.createEmptyInstanceSettings = createEmptyInstanceSettings;
 exports.validateInstanceSettings = validateInstanceSettings;
 exports.getInstanceSettingsPath = getInstanceSettingsPath;
 exports.saveInstanceSettings = saveInstanceSettings;
+exports.saveInstanceSettingsChange = saveInstanceSettingsChange;
 exports.loadInstanceSettingsForUpdate = loadInstanceSettingsForUpdate;
 exports.createInstanceDefaultEffortReader = createInstanceDefaultEffortReader;
 exports.createUpdateSettingsReader = createUpdateSettingsReader;
+exports.createBotSkillsSettingsReader = createBotSkillsSettingsReader;
+exports.createTaskAgentsMaxConcurrentReader = createTaskAgentsMaxConcurrentReader;
+exports.createTodoSettingsReader = createTodoSettingsReader;
+exports.createRunnerHostReader = createRunnerHostReader;
 const os = __importStar(require("os"));
 const zod_1 = require("zod");
 const configDirFile_1 = require("./configDirFile");
 const effortLevels_1 = require("./effortLevels");
+const botSkillsSetting_1 = require("./utils/botSkillsSetting");
+const taskAgentLimit_1 = require("./trackers/taskAgentLimit");
+const hubIds_1 = require("./runners/hubIds");
 const updateModes_1 = require("./selfUpdate/updateModes");
+const nag_1 = require("./todos/nag");
 /**
  * @description The instance-wide settings: ONE JSON file, `settings.json`, in the charness config directory
  * (beside the instance's real `.env`, like `stt.json`). `/effort` in the General topic writes it; an operator may
  * hand-edit it and the next read sees the edit (the load is cached by file stamp, no restart). More instance
- * settings will move here later; today it holds `defaultEffort`, `autoUpdate` and `whatsNew`.
+ * settings will move here later; today it holds `defaultEffort`, `autoUpdate`, `whatsNew`, `botSkills` (whether the bot's
+ * own skills reach the agents: the way an instance without General sets it), `taskAgents` (the cap on tracker task agents
+ * running at once — the way an instance without General sets it), `todo` (the shared todo lists: on / off and the
+ * staleness reminder's interval — also the way an instance without General sets them) and `runnerHost` (the address
+ * paired runners dial, chosen once in `/runners`).
  *
  * Validation is strict and all-or-nothing, like `stt.json`: a typo is an error that NAMES the field. Unlike
  * `stt.json`, an invalid file is NOT served from its last good copy — the built-in defaults apply and one error
@@ -60,14 +73,27 @@ const updateModes_1 = require("./selfUpdate/updateModes");
 exports.instanceSettingsFileName = 'settings.json';
 /** Not secret: readable by the group, like any config file. */
 const settingsFileMode = 0o644;
+/** The longest reminder interval a hand-edited `settings.json` may name: a day. */
+const todoReminderMaxMinutes = 24 * 60;
 const rawSettingsSchema = zod_1.z.strictObject({
     defaultEffort: zod_1.z.enum(effortLevels_1.claudeEffortLevels).optional(),
     autoUpdate: zod_1.z.enum(updateModes_1.autoUpdateModes).optional(),
     whatsNew: zod_1.z.boolean().optional(),
+    botSkills: zod_1.z.enum(botSkillsSetting_1.botSkillsSettingValues).optional(),
+    taskAgents: zod_1.z.strictObject({
+        /** `0` = no limit. */
+        maxConcurrent: zod_1.z.number().int().min(0).max(taskAgentLimit_1.taskAgentsMaxConcurrentUpperBound).optional(),
+    }).optional(),
+    todo: zod_1.z.strictObject({
+        isEnabled: zod_1.z.boolean().optional(),
+        /** `0` = no staleness reminder. */
+        reminderMinutes: zod_1.z.number().int().min(0).max(todoReminderMaxMinutes).optional(),
+    }).optional(),
+    runnerHost: zod_1.z.strictObject({ host: hubIds_1.hubHostSchema, port: hubIds_1.hubPortSchema }).optional(),
 });
 /** @description The settings of an instance that has no `settings.json`: nothing set. */
 function createEmptyInstanceSettings() {
-    return { defaultEffort: null, autoUpdate: null, whatsNew: null };
+    return { defaultEffort: null, autoUpdate: null, whatsNew: null, botSkills: null, taskAgents: { maxConcurrent: null }, todo: { isEnabled: null, reminderMinutes: null }, runnerHost: null };
 }
 /**
  * @description Validate a parsed `settings.json` object. Every error names its field
@@ -87,6 +113,10 @@ function validateInstanceSettings(parsedJson) {
             defaultEffort: parsed.data.defaultEffort ?? null,
             autoUpdate: parsed.data.autoUpdate ?? null,
             whatsNew: parsed.data.whatsNew ?? null,
+            botSkills: parsed.data.botSkills ?? null,
+            taskAgents: { maxConcurrent: parsed.data.taskAgents?.maxConcurrent ?? null },
+            todo: { isEnabled: parsed.data.todo?.isEnabled ?? null, reminderMinutes: parsed.data.todo?.reminderMinutes ?? null },
+            runnerHost: parsed.data.runnerHost ?? null,
         },
     };
 }
@@ -114,12 +144,38 @@ function saveInstanceSettings(filePath, settings) {
         ...(settings.defaultEffort === null ? {} : { defaultEffort: settings.defaultEffort }),
         ...(settings.autoUpdate === null ? {} : { autoUpdate: settings.autoUpdate }),
         ...(settings.whatsNew === null ? {} : { whatsNew: settings.whatsNew }),
+        ...(settings.botSkills === null ? {} : { botSkills: settings.botSkills }),
+        ...(settings.taskAgents.maxConcurrent === null ? {} : { taskAgents: { maxConcurrent: settings.taskAgents.maxConcurrent } }),
+        ...(settings.todo.isEnabled === null && settings.todo.reminderMinutes === null
+            ? {}
+            : {
+                todo: {
+                    ...(settings.todo.isEnabled === null ? {} : { isEnabled: settings.todo.isEnabled }),
+                    ...(settings.todo.reminderMinutes === null ? {} : { reminderMinutes: settings.todo.reminderMinutes }),
+                },
+            }),
+        ...(settings.runnerHost === null ? {} : { runnerHost: { host: settings.runnerHost.host, port: settings.runnerHost.port } }),
     };
     const validation = validateInstanceSettings(body);
     if (!validation.ok)
         throw new Error(`refusing to write an invalid ${exports.instanceSettingsFileName}: ${validation.errors.join('; ')}`);
     (0, configDirFile_1.writeJsonFileAtomically)(filePath, body, settingsFileMode);
 }
+/**
+ * @description Write `change` on top of what `settings.json` at `filePath` holds (a broken file is replaced — the
+ * button the operator tapped is the fix). `null` on success, else the errno code of the failed write (logged).
+ */
+function saveInstanceSettingsChange(filePath, change) {
+    try {
+        saveInstanceSettings(filePath, { ...loadInstanceSettingsForUpdate(filePath), ...change });
+        return null;
+    }
+    catch (error) {
+        const code = (0, configDirFile_1.getCaughtErrnoCode)(error);
+        console.warn(`[Settings] could not write ${filePath} (${code})`);
+        return code;
+    }
+}
 /**
  * @description The settings a change starts from: the file's own when it is valid, else the empty ones. A change
  * made on top of a broken file replaces it — the button the operator tapped is the fix.
@@ -129,44 +185,81 @@ function loadInstanceSettingsForUpdate(filePath) {
     return load.status === 'invalid' ? createEmptyInstanceSettings() : load.config;
 }
 /**
- * @description The reader that `effortLevels.setInstanceDefaultEffortReader` takes: `settings.json`'s
- * `defaultEffort`, re-read when the file changes. A missing file, or a file without the field, is `null` (the
- * code fallback). An invalid file is `null` too, and `logError` gets ONE line per distinct broken state of the
- * file — not one per session start.
+ * The broken states of the file already logged. The load is cached by the file's stamp, so every reader of one broken
+ * state holds the SAME load object: one line per broken state for the whole process, however many readers read it.
  */
-function createInstanceDefaultEffortReader(getFilePath, logError) {
-    let lastReportedLoad = null;
+const reportedInvalidLoads = new WeakSet();
+/**
+ * @description A reader of one part of `settings.json`, re-read when the file changes: `select` picks it out of the
+ * file's settings. An invalid file reads as the empty settings (so `select` fills in the defaults), and ONE line per
+ * distinct broken state of the file is logged — not one per read, not one per reader.
+ */
+function createSettingsPartReader(getFilePath, logError, select) {
     return () => {
         const load = (0, exports.loadInstanceSettings)(getFilePath());
         if (load.status === 'invalid') {
-            if (load !== lastReportedLoad) {
-                lastReportedLoad = load;
+            if (!reportedInvalidLoads.has(load)) {
+                reportedInvalidLoads.add(load);
                 logError(`[Settings] ${load.errors.join('; ')} (the built-in defaults apply until it is fixed)`);
             }
-            return null;
+            return select(createEmptyInstanceSettings());
         }
-        lastReportedLoad = null;
-        return load.config.defaultEffort;
+        return select(load.config);
     };
 }
+/**
+ * @description The reader that `effortLevels.setInstanceDefaultEffortReader` takes: `settings.json`'s
+ * `defaultEffort`, re-read when the file changes. A missing file, or a file without the field, is `null` (the
+ * code fallback). An invalid file is `null` too, and `logError` gets ONE line per distinct broken state of the
+ * file — not one per session start.
+ */
+function createInstanceDefaultEffortReader(getFilePath, logError) {
+    return createSettingsPartReader(getFilePath, logError, (settings) => settings.defaultEffort);
+}
 /**
  * @description The reader the update engine and the `/update` screen use: `settings.json`'s `autoUpdate` and `whatsNew` with the
  * defaults (`on`, shown) filled in, re-read when the file changes — a hand edit applies at the next check. An invalid file reads
  * as the defaults, and `logError` gets ONE line per distinct broken state (not one per read).
  */
 function createUpdateSettingsReader(getFilePath, logError) {
-    let lastReportedLoad = null;
-    return () => {
-        const load = (0, exports.loadInstanceSettings)(getFilePath());
-        if (load.status === 'invalid') {
-            if (load !== lastReportedLoad) {
-                lastReportedLoad = load;
-                logError(`[Settings] ${load.errors.join('; ')} (the built-in defaults apply until it is fixed)`);
-            }
-            return { autoUpdate: updateModes_1.defaultAutoUpdateMode, whatsNew: updateModes_1.defaultWhatsNew };
-        }
-        lastReportedLoad = null;
-        return { autoUpdate: load.config.autoUpdate ?? updateModes_1.defaultAutoUpdateMode, whatsNew: load.config.whatsNew ?? updateModes_1.defaultWhatsNew };
-    };
+    return createSettingsPartReader(getFilePath, logError, (settings) => ({
+        autoUpdate: settings.autoUpdate ?? updateModes_1.defaultAutoUpdateMode,
+        whatsNew: settings.whatsNew ?? updateModes_1.defaultWhatsNew,
+    }));
+}
+/**
+ * @description The reader of the «Bot skills» default the file seeds (`utils/botSkills.ts`): `botSkills`, re-read when the
+ * file changes — a hand edit applies to the next agent start. `null` = the file does not say. An invalid file reads as `null`,
+ * and `logError` gets ONE line per distinct broken state (not one per read).
+ */
+function createBotSkillsSettingsReader(getFilePath, logError) {
+    return createSettingsPartReader(getFilePath, logError, (settings) => settings.botSkills);
+}
+/**
+ * @description The reader of the cap on tracker task agents the file seeds (`trackers/taskAgentLimit.ts`): `taskAgents.maxConcurrent`,
+ * re-read when the file changes — a hand edit applies to the next hand-over. `null` = the file does not say. An invalid file reads
+ * as `null`, and `logError` gets ONE line per distinct broken state (not one per read).
+ */
+function createTaskAgentsMaxConcurrentReader(getFilePath, logError) {
+    return createSettingsPartReader(getFilePath, logError, (settings) => settings.taskAgents.maxConcurrent);
+}
+/**
+ * @description The reader the todo registry uses: `settings.json`'s `todo` with the defaults (on, a reminder every
+ * hour) filled in, re-read when the file changes. An invalid file reads as the defaults, and `logError` gets ONE line
+ * per distinct broken state (not one per read).
+ */
+function createTodoSettingsReader(getFilePath, logError) {
+    return createSettingsPartReader(getFilePath, logError, (settings) => ({
+        isEnabled: settings.todo.isEnabled ?? true,
+        reminderMinutes: settings.todo.reminderMinutes ?? nag_1.todoReminderDefaultMinutes,
+    }));
+}
+/**
+ * @description The reader of the address paired runners dial (`/runners`): `runnerHost`, re-read when the file changes — a hand
+ * edit applies to the next pairing. `null` = not chosen yet. An invalid file reads as `null`, and `logError` gets ONE line per
+ * distinct broken state (not one per read).
+ */
+function createRunnerHostReader(getFilePath, logError) {
+    return createSettingsPartReader(getFilePath, logError, (settings) => settings.runnerHost);
 }
 //# sourceMappingURL=instanceSettings.js.map

package/dist/instanceSettings.js.map

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

package/dist/openCodeQuestionFlow.d.ts

@@ -33,6 +33,36 @@ export declare function buildQuestionBodyLines(question: OpenCodeQuestion, escap
  * rejects the Markdown render of a question.
  */
 export declare function buildQuestionBodyLinesPlain(question: OpenCodeQuestion): string[];
+/**
+ * @description How a question's message ends in the topic. A question message is never deleted: the buttons go, the
+ * text stays, and the note below it says what became of the question.
+ *  - `unanswered` — it was closed with no answer (a message sent instead, `/esc`, the session gone);
+ *  - `askedAgain` — the same question was put again further down (re-posted to the bottom, re-asked after the idle
+ *    compaction), so this copy is only the record.
+ * An answer is a note of its own (`agent.question_answered_note`), built where the chosen label is known.
+ */
+export type QuestionClosing = 'unanswered' | 'askedAgain';
+/** How a question's message ends: a {@link QuestionClosing}, or with the answer that was given. */
+export type QuestionEnd = QuestionClosing | {
+    answer: string;
+};
+/**
+ * @description The text a question's message is edited to when it ends: the same body it was posted with (header,
+ * question, numbered options with their descriptions), a blank line, then `note`. `escape` is the one
+ * {@link buildQuestionBodyLines} takes; the note goes through it too, since it may carry the chosen label.
+ */
+export declare function buildClosedQuestionText(question: OpenCodeQuestion, note: string, escape: (text: string) => string): string;
+/**
+ * @description {@link buildClosedQuestionText} as plain text: no escaping, no bold marker — what the close is edited to
+ * when Telegram cannot parse the Markdown render of it, the way {@link buildQuestionBodyLinesPlain} is for a post.
+ *
+ * `maxLength` is the most characters the text may have (a Telegram message holds a few thousand): a question that
+ * filled a message when it was asked cannot take an answer note under it, and the note is the result the person looks
+ * for, so the BODY gives way — first the option descriptions (what a long question is mostly made of; the labels stay,
+ * they are what the answer names), then, if that is still too long, the end of the body, cut with an ellipsis. The note
+ * is never cut. No limit by default.
+ */
+export declare function buildClosedQuestionPlainText(question: OpenCodeQuestion, note: string, maxLength?: number): string;
 /**
  * @description How to route a user's free-form reply that arrives WHILE an
  * OpenCode interactive question is pending. Mirrors `getClaudeReplyRoute`:

package/dist/openCodeQuestionFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openCodeQuestionFlow.d.ts","sourceRoot":"","sources":["../src/openCodeQuestionFlow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAWhF;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC5C,kBAAkB,CAQpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,SAAS,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAoBlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,oBAAoB,GAAG,oBAAoB,CAe3F"}
+{"version":3,"file":"openCodeQuestionFlow.d.ts","sourceRoot":"","sources":["../src/openCodeQuestionFlow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAWhF;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;AAE1D,mGAAmG;AACnG,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,CAER;AAKD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiC,GAAG,MAAM,CAmB3I;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC5C,kBAAkB,CAQpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,SAAS,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAoBlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,oBAAoB,GAAG,oBAAoB,CAe3F"}

package/dist/openCodeQuestionFlow.js

@@ -15,6 +15,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildQuestionBodyLines = buildQuestionBodyLines;
 exports.buildQuestionBodyLinesPlain = buildQuestionBodyLinesPlain;
+exports.buildClosedQuestionText = buildClosedQuestionText;
+exports.buildClosedQuestionPlainText = buildClosedQuestionPlainText;
 exports.getQuestionReplyRoute = getQuestionReplyRoute;
 exports.recordAnswerAndAdvance = recordAnswerAndAdvance;
 exports.migratePendingQuestionState = migratePendingQuestionState;
@@ -65,6 +67,47 @@ function buildQuestionBodyLinesPlain(question) {
     });
     return lines;
 }
+/**
+ * @description The text a question's message is edited to when it ends: the same body it was posted with (header,
+ * question, numbered options with their descriptions), a blank line, then `note`. `escape` is the one
+ * {@link buildQuestionBodyLines} takes; the note goes through it too, since it may carry the chosen label.
+ */
+function buildClosedQuestionText(question, note, escape) {
+    return [...buildQuestionBodyLines(question, escape), '', escape(note)].join('\n');
+}
+/** What stands where a cut body ends. */
+const cutBodyEllipsis = '…';
+/**
+ * @description {@link buildClosedQuestionText} as plain text: no escaping, no bold marker — what the close is edited to
+ * when Telegram cannot parse the Markdown render of it, the way {@link buildQuestionBodyLinesPlain} is for a post.
+ *
+ * `maxLength` is the most characters the text may have (a Telegram message holds a few thousand): a question that
+ * filled a message when it was asked cannot take an answer note under it, and the note is the result the person looks
+ * for, so the BODY gives way — first the option descriptions (what a long question is mostly made of; the labels stay,
+ * they are what the answer names), then, if that is still too long, the end of the body, cut with an ellipsis. The note
+ * is never cut. No limit by default.
+ */
+function buildClosedQuestionPlainText(question, note, maxLength = Number.POSITIVE_INFINITY) {
+    const render = (shown) => [...buildQuestionBodyLinesPlain(shown), '', note].join('\n');
+    const full = render(question);
+    if (full.length <= maxLength)
+        return full;
+    const withoutDescriptions = { ...question, options: question.options.map((option) => ({ label: option.label })) };
+    const shortened = render(withoutDescriptions);
+    if (shortened.length <= maxLength)
+        return shortened;
+    const noteBlock = `\n\n${note}`;
+    const bodyBudget = Math.max(maxLength - noteBlock.length - cutBodyEllipsis.length, 0);
+    const body = buildQuestionBodyLinesPlain(withoutDescriptions).join('\n');
+    // Whole characters up to the budget, which counts UTF-16 units as a message limit does: a code point is never split in two.
+    let cutBody = '';
+    for (const character of body) {
+        if (cutBody.length + character.length > bodyBudget)
+            break;
+        cutBody += character;
+    }
+    return `${cutBody}${cutBodyEllipsis}${noteBlock}`;
+}
 /**
  * @description Decide how to route a user's reply for a thread that has an
  * OpenCode question on screen. Pure so the digit-in-range precedence is

package/dist/openCodeQuestionFlow.js.map

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

package/dist/outputTrace.d.ts

@@ -90,6 +90,12 @@ export interface RecvTraceFields {
 export declare function traceRecvUpdate(fields: RecvTraceFields): void;
 /** Record an adapter `output`/`status`/`thinking`/`toolResult` event entering the bot's send path. */
 export declare function traceAgentEmit(event: 'output' | 'status' | 'thinking' | 'toolResult', key: SessionKey, text: string): void;
+/**
+ * @description Mark `text` as a secret while it is being sent (a pairing line is a credential): the `sendTry` / `sendOk` /
+ * `sendErr` records of the Bot API call that carries exactly this text keep its length and nothing else. The trace is the only
+ * place a sent text could be quoted, and it is written to disk. Returns the release to call once the send settled.
+ */
+export declare function markOutboundTextSecret(text: string): () => void;
 /**
  * @description Structural view of `Telegram`/`ApiClient` — just enough to wrap
  * `callApi`. Method syntax keeps `Telegram` assignable (bivariant params), and

package/dist/outputTrace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outputTrace.d.ts","sourceRoot":"","sources":["../src/outputTrace.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8D/C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE5D;AAcD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,8DAA8D;IAC9D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAgCD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,IAAI,CAavF;AAsDD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD;AAiBD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAW7D;AAcD,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ1H;AAyED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;CACzG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA4B3D"}
+{"version":3,"file":"outputTrace.d.ts","sourceRoot":"","sources":["../src/outputTrace.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8D/C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE5D;AAcD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,8DAA8D;IAC9D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAgCD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,IAAI,CAavF;AAsDD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD;AAiBD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAW7D;AAcD,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ1H;AA4CD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAO/D;AAwCD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;CACzG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA4B3D"}

package/dist/outputTrace.js

@@ -13,6 +13,7 @@ exports.configureTraceWriterForTests = configureTraceWriterForTests;
 exports.flushTraceBufferSyncOnExit = flushTraceBufferSyncOnExit;
 exports.traceRecvUpdate = traceRecvUpdate;
 exports.traceAgentEmit = traceAgentEmit;
+exports.markOutboundTextSecret = markOutboundTextSecret;
 exports.installCallApiTrace = installCallApiTrace;
 const node_fs_1 = require("node:fs");
 const node_fs_2 = require("node:fs");
@@ -356,6 +357,28 @@ function getBooleanField(source, field) {
     const value = source[field];
     return typeof value === 'boolean' ? value : undefined;
 }
+/** What the trace keeps of a message that holds a secret: nothing of the text, only its length. */
+const secretTextPreview = '[secret — text not recorded]';
+/** The texts of the secret messages being sent right now, each with how many sends of it are in flight. */
+const secretOutboundTexts = new Map();
+/**
+ * @description Mark `text` as a secret while it is being sent (a pairing line is a credential): the `sendTry` / `sendOk` /
+ * `sendErr` records of the Bot API call that carries exactly this text keep its length and nothing else. The trace is the only
+ * place a sent text could be quoted, and it is written to disk. Returns the release to call once the send settled.
+ */
+function markOutboundTextSecret(text) {
+    secretOutboundTexts.set(text, (secretOutboundTexts.get(text) ?? 0) + 1);
+    return () => {
+        const remaining = (secretOutboundTexts.get(text) ?? 1) - 1;
+        if (remaining > 0)
+            secretOutboundTexts.set(text, remaining);
+        else
+            secretOutboundTexts.delete(text);
+    };
+}
+function createApiCallPreview(text) {
+    return secretOutboundTexts.has(text) ? secretTextPreview : createTracePreview(text);
+}
 function extractApiCallFields(method, payload) {
     const p = payload;
     const text = getStringField(p, 'text');
@@ -370,7 +393,7 @@ function extractApiCallFields(method, payload) {
         // notifies, repins are silent), so it must be visible in the trace.
         disableNotification: getBooleanField(p, 'disable_notification'),
         len: text?.length,
-        preview: text === undefined ? undefined : createTracePreview(text),
+        preview: text === undefined ? undefined : createApiCallPreview(text),
     };
 }
 /**

package/dist/outputTrace.js.map

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

package/dist/postToSession.d.ts

@@ -4,11 +4,12 @@
  * conversation's own sleeping session, else starts one if needed — let a
  * BUSY session finish its turn (up to {@link waitIdleTimeoutMs} — live work is
  * never interrupted on purpose; after the bound the forward takes the normal
- * interrupt path), then forward — unless an armed usage-limit wait holds the
- * prompt, checked before the session is touched and again right before the
- * forward (R23). The scheduler's fire (steps 3–4) and the Jira
- * connector's requests share it. Every side effect is injected, so the wait
- * loop runs on a fake clock in tests.
+ * interrupt path) and ensure the session again once it did (the stop that
+ * follows a per-turn conversation's turn may have put it to sleep), then forward —
+ * unless an armed usage-limit wait holds the prompt, checked before the session
+ * is touched and again right before the forward (R23). The scheduler's fire
+ * (steps 3–4) and the Jira connector's requests share it. Every side effect is
+ * injected, so the wait loop runs on a fake clock in tests.
  */
 /** Poll cadence for the wait-for-idle loop: re-check the busy probe every 5s. */
 export declare const busyPollIntervalMs = 5000;
@@ -91,4 +92,18 @@ export type PostToSessionResult = {
 export declare function postToSession(deps: PostToSessionDeps, conversationKey: string, prompt: string | SessionPromptText, fallbackAdapterName?: string, options?: {
     heldText?: string;
 }): Promise<PostToSessionResult>;
+/**
+ * @name PostToIdleSessionDeps
+ * @description `checkIsIdle` = the session is live and not working right now; `forward` writes the prompt.
+ */
+export interface PostToIdleSessionDeps {
+    checkIsIdle: () => boolean;
+    forward: () => Promise<void>;
+}
+/**
+ * @description The idle-only sibling of {@link postToSession} for a bot-made technical prompt (the todo list's
+ * staleness reminder): it never ensures, resumes or starts a session and never waits for a turn — a session that is
+ * not idle at this moment gets nothing (`false`). A forward that throws is logged and reads as not posted.
+ */
+export declare function postToIdleSession(deps: PostToIdleSessionDeps): Promise<boolean>;
 //# sourceMappingURL=postToSession.d.ts.map

package/dist/postToSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postToSession.d.ts","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEnF,iHAAiH;AACjH,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAErH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3F,sFAAsF;IACtF,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;iGAC6F;IAC7F,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvG,sDAAsD;IACtD,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAU3D,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAClC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}
+{"version":3,"file":"postToSession.d.ts","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEnF,iHAAiH;AACjH,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAErH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3F,sFAAsF;IACtF,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;iGAC6F;IAC7F,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvG,sDAAsD;IACtD,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAU3D,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAClC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CASrF"}