charness 3.7.0 → 3.8.0

package/dist/bot.d.ts.map

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

package/dist/bot.js

@@ -239,6 +239,14 @@ const compaction_1 = require("./connectors/telegram/commands/compaction");
 const autoContinueLimits_1 = require("./connectors/telegram/commands/autoContinueLimits");
 const botSkills_2 = require("./connectors/telegram/commands/botSkills");
 const taskAgents_1 = require("./connectors/telegram/commands/taskAgents");
+const runners_1 = require("./connectors/telegram/commands/runners");
+const gateWrapper_1 = require("./runners/gateWrapper");
+const hubAddress_1 = require("./runners/hubAddress");
+const hubAddressCandidates_1 = require("./runners/hubAddressCandidates");
+const hubPaths_1 = require("./runners/hubPaths");
+const hubPairing_1 = require("./runners/hubPairing");
+const runnersOverview_1 = require("./runners/runnersOverview");
+const ssh_1 = require("./remoteRun/ssh");
 const claudeAccounts_1 = require("./connectors/telegram/commands/claudeAccounts");
 const claudeProfiles_1 = require("./utils/claudeProfiles");
 const claudeUsage_1 = require("./utils/claudeUsage");
@@ -263,7 +271,7 @@ const stt_1 = require("./connectors/telegram/commands/stt");
 const claudeApiSpend_1 = require("./utils/claudeApiSpend");
 const claudeProfileUsageLines_1 = require("./utils/claudeProfileUsageLines");
 const resolveBinary_1 = require("./utils/resolveBinary");
-const runnersConfig_1 = require("./remoteRun/runnersConfig");
+const runnerSummary_1 = require("./remoteRun/runnerSummary");
 // ═══════════════════════════════════════════════════════════════════════════════
 //  ENV parsing & fatal validation
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -3140,6 +3148,7 @@ async function replyToThread(key, text, extra = {}, options = {}) {
             openBindMessages.remember((0, sessionKey_1.keyToString)(key), messageId, Date.now());
         return messageId;
     };
+    const releaseSecret = options.isSecret ? (0, outputTrace_1.markOutboundTextSecret)(text) : null;
     try {
         return await trackSent(await sendOnce(buildSendExtra(key, extra)));
     }
@@ -3174,6 +3183,9 @@ async function replyToThread(key, text, extra = {}, options = {}) {
         await handleSendError(key, e);
         return null;
     }
+    finally {
+        releaseSecret?.();
+    }
 }
 /**
  * @description Edit an existing assistant message in the thread.
@@ -4087,7 +4099,7 @@ function stopAllAdaptersFor(key, adapterNames) {
     return (0, createAdapter_1.stopAllAdaptersFor)(key, createAdapter_1.getAdapter, adapterNames);
 }
 /**
- * @description Explicit-stop teardown used by `/new`/`/clear_session`:
+ * @description Explicit-stop teardown used by `/new`:
  * sweep every adapter active for the thread, then RELEASE the persisted session
  * ids (even when nothing was running) so a later bot restart won't auto-reattach
  * and any half-dead state from a crash/SSE-giveup is cleared. The session stays
@@ -5874,7 +5886,7 @@ command('list', async (_ctx, key) => {
     await replyToThread(key, `${(0, i18n_1.t)('list.header', { count: rows.length })}\n${body}`, { parse_mode: 'Markdown' });
 });
 /**
- * @description `/new` (alias `/clear_session`) — stop the thread's current agent
+ * @description `/new` — stop the thread's current agent
  * session and immediately start a fresh one in the SAME topic with the SAME
  * adapter. The old session is RELEASED (not deleted): its transcript stays on
  * disk so it's still resumable via `/sessions`, but a bot restart won't
@@ -5884,7 +5896,7 @@ command('list', async (_ctx, key) => {
  * Guards mirror `handleStartCommand`: General has no binding/agent, so it just
  * hints; an unbound topic gets the standard bind-required reply.
  */
-command(['new', 'clear_session'], async (_ctx, key) => {
+command('new', async (_ctx, key) => {
     if (checkIsGeneral(key)) {
         await replyToThread(key, (0, i18n_1.t)('new.general_hint'));
         return;
@@ -6585,6 +6597,26 @@ const { registerTaskAgentsCommands, registerTaskAgentsCallbacks } = (0, taskAgen
     readTaskAgentStatus: () => ([...ENV.servedPlatforms].some((platform) => platform !== 'telegram') ? taskAgentSlots?.getStatus() ?? null : null),
 });
 registerTaskAgentsCommands();
+// ── Paired runners (`/runners`): `connectors/telegram/commands/runners.ts`, the hub in `runners/` ──
+const runnersHub = (0, hubPaths_1.createHubContext)();
+const runnersCacheDir = (0, ssh_1.getRemoteRunCacheDir)();
+const { registerRunnersCommands, registerRunnersCallbacks, handleRunnersAddressText, cancelRunnersAddressWait, startRunnersWatcher } = (0, runners_1.createRunners)({
+    ...botCore,
+    hub: runnersHub,
+    // The pairing messages this instance sent: its own record (the hub registry is shared by every instance of the OS user).
+    pairingMessagesPath: path.join((0, state_1.resolveDataDir)(), 'runner-pairing-messages.json'),
+    sweepExpiredCodes: async (nowMs) => { await (0, hubPairing_1.sweepExpiredPairings)(runnersHub, nowMs); },
+    readRunnerHost: (0, instanceSettings_1.createRunnerHostReader)(() => (0, instanceSettings_1.getInstanceSettingsPath)(), (line) => console.error(line)),
+    saveRunnerHost: (address) => (0, instanceSettings_1.saveInstanceSettingsChange)((0, instanceSettings_1.getInstanceSettingsPath)(), { runnerHost: address }),
+    getBotLabel: () => (bot.botInfo?.username === undefined ? os.hostname() : `@${bot.botInfo.username}`),
+    readOverview: (nowMs) => (0, runnersOverview_1.readRunnersOverview)(runnersHub, runnersCacheDir, nowMs),
+    probeOverview: (overview, nowMs) => (0, runnersOverview_1.probeRunnersOverview)(runnersHub, overview, runnersCacheDir, nowMs),
+    listAddressCandidates: () => (0, hubAddressCandidates_1.listPublicAddressCandidates)(),
+    scanHostKey: hubAddress_1.scanHostKey,
+    ensureGateWrapper: () => { (0, gateWrapper_1.ensureGateWrapper)(runnersHub); },
+    now: Date.now,
+});
+registerRunnersCommands();
 // ── Claude account profiles (`/account`): `utils/claudeProfiles.ts`, `commands/claudeAccounts.ts` ──
 /**
  * @description The Claude config directory a conversation's NEXT process starts with: its resolved account
@@ -8053,8 +8085,8 @@ command('clear_messages', async (ctx, key) => {
 const botCommands = new Set([
     'start', 'claude', 'opencode', 'oc', 'terminal', 'agent', 'sessions', 'resume', 'cancel', 'model', 'connect',
     'disconnect', 'stop', 'stopall', 'stop-all', 'quit-all', 'status', 'c', 'y', 'n', 'enter', 'up', 'down', 'tab', 'esc', 'escape', 'interrupt', 'output', 'clear_messages',
-    'bind', 'topic', 'unbind', 'where', 'ls', 'list', 'new', 'clear_session', 'whoami', 'version', 'help', 'language', 'lang',
-    'doctor', 'mcp', 'rename_session', 'compact', 'compact_on_idle', 'compact_summary', 'bot_skills', 'task_agents', 'auto_continue_limits', 'limits', 'limits_autoswitch', 'trace', 'timestamps', 'timezone', 'schedule', 'reminders', 'todo', 'thinking', 'tool_results',
+    'bind', 'topic', 'unbind', 'where', 'ls', 'list', 'new', 'whoami', 'version', 'help', 'language', 'lang',
+    'doctor', 'mcp', 'rename_session', 'compact', 'compact_on_idle', 'compact_summary', 'bot_skills', 'task_agents', 'runners', 'auto_continue_limits', 'limits', 'limits_autoswitch', 'trace', 'timestamps', 'timezone', 'schedule', 'reminders', 'todo', 'thinking', 'tool_results',
     'subagent', 'claude_mode', 'effort', 'verbosity', 'quit', 'q', 'quitall', 'pair', 'account', 'accounts', 'fallback', 'stt', 'voice', 'speech', 'update',
 ]);
 /**
@@ -8091,6 +8123,8 @@ bot.on((0, filters_1.message)('text'), async (ctx) => {
         cancelTopicInput(key);
         // ... and an armed `/stt` address or key step.
         await cancelSttInput(key);
+        // ... and the `/runners` address step.
+        cancelRunnersAddressWait(key);
         if (botCommands.has(cmd))
             return;
         // `/login` on a json-stream Claude thread (idle or per-turn lifecycle) has no
@@ -8194,6 +8228,9 @@ bot.on((0, filters_1.message)('text'), async (ctx) => {
             return;
         }
     }
+    // `/runners` → «Enter another address»: this General message is the address runners dial. A slash command wins over the wait.
+    if (await handleRunnersAddressText(key, text))
+        return;
     // Session is mid-startup → buffer the prompt and replay it once the agent is
     // ready, instead of dropping it into the "no agent running" guidance below.
     if (startupPromptBuffer.checkIsStarting(kStr)) {
@@ -9307,6 +9344,7 @@ registerCompactionCallbacks();
 registerAutoContinueLimitsCallbacks();
 registerBotSkillsCallbacks();
 registerTaskAgentsCallbacks();
+registerRunnersCallbacks();
 registerBackendSwitchCallbacks();
 registerClaudeAccountCallbacks();
 registerFallbackChainCallbacks();
@@ -11103,8 +11141,7 @@ exports.COMMANDS_MENU = [
     { command: 'opencode', description: '▶️ Start OpenCode' },
     { command: 'terminal', description: '🖥 Open a raw shell in the bound folder' },
     { command: 'claude_mode', description: '🔀 Claude backend: json-stream ⇄ per-turn ⇄ tmux (deprecated)' },
-    { command: 'new', description: '🆕 Restart session (alias /clear_session)' },
-    { command: 'clear_session', description: '🆕 Restart session (alias /new)' },
+    { command: 'new', description: '🆕 Restart session' },
     { command: 'model', description: '🧠 Switch model' },
     { command: 'effort', description: '⚙️ Reasoning effort' },
     { command: 'verbosity', description: '🔊 Output verbosity (thinking+tools+sub-agents)' },
@@ -11121,6 +11158,7 @@ exports.COMMANDS_MENU = [
     { command: 'compact_summary', description: '📄 Post the compaction summary (toggle)' },
     { command: 'bot_skills', description: '🧰 The bot\'s own skills for agents (on/off)' },
     { command: 'task_agents', description: '🧵 How many tracker task agents work at once' },
+    { command: 'runners', description: '🖥 Runners — machines for the agents\' tests and builds' },
     { command: 'accounts', description: '👤 Claude accounts and OpenCode providers (switch, add, re-login, remove, connect, disconnect)' },
     { command: 'limits', description: '🚧 Usage limits — switch this topic' },
     { command: 'limits_autoswitch', description: '🔁 Automatic switching on a usage limit' },
@@ -12273,7 +12311,7 @@ function wireScheduler(wiring) {
         sendMessagesToThread,
         compactConversation: (threadKeyStr) => armDeferredCompaction((0, sessionKey_1.keyFromString)(threadKeyStr)),
         listClaudeProfiles: listClaudeProfilesForAgent,
-        isRemoteRunOffered: () => (0, runnersConfig_1.checkIsRemoteRunOffered)(),
+        getRemoteRunRunnerLines: () => (0, runnerSummary_1.getRunnerSummaryLines)(),
         // A refused tool call leaves one line in the bounded diagnostic log (agent-diag.log): the SDK refuses before the bot sees it.
         logDiagnostic: diagLog_1.appendDiagLog,
         ...(jiraConnector
@@ -13223,6 +13261,9 @@ async function startBot() {
         console.warn('[platform] native Windows notice failed:', e instanceof Error ? e.message : e);
     }
     await startUpdates();
+    // Pairing messages of `/runners` turn into «paired» / «expired» (and survive this restart through the registry's notes).
+    if (ENV.servedPlatforms.has('telegram'))
+        startRunnersWatcher();
     // The local speech engine: clean up after an earlier run, re-attach to / start its install. Starts no process.
     void bootSttLocalEngine().catch((e) => console.warn('[STT] boot step failed:', e instanceof Error ? e.message : e));
     console.log(`Launching Telegraf bot (long polling, dropPendingUpdates=${bootMode.dropPendingUpdates})...`);