loopengine 0.1.80 → 0.1.81

package/README.md

@@ -172,13 +172,15 @@ export const config: AgentConfig = {
 }
 ```
 
-Or skip the code: in the console, the Permissions tab's **Where approval
-requests and questions are sent** section sets a
+Or skip the code: in the console, the agent's **Messaging** tab sets a
 webhook, Slack or Lark target for one agent (saved to
-`agents/<name>/notifier.yml`, with its secret in the agent's own `.env`),
-sends a test, shows recent deliveries, and lists every decision still
-waiting with Approve/Deny buttons. The tab warns you when an agent has
-`ask` rules but nobody would be told.
+`agents/<name>/messaging.yml`, with its secret in the agent's own `.env`;
+an older `notifier.yml` is still read), sends a test and shows recent
+deliveries. With Slack, people can also reply in a request's thread to
+ask the agent about it, and it answers there (**Answer replies in a
+request's thread**, on by default). The Permissions tab lists every
+decision still waiting with Approve/Deny buttons, and warns you when an
+agent has `ask` rules but nobody would be told.
 
 Every notification links to a **decision page**: a signed, single-use
 link (`/decide/<token>`, valid 7 days) where whoever got the message can

package/dist/core/agent-config.d.ts

@@ -195,6 +195,7 @@ export type HttpNotifierConfig = {
         channelId: string;
         publicUrl?: string;
         buttons?: boolean;
+        replyHint?: boolean;
     };
     events: HttpNotifierEvent[];
 } | {

package/dist/core/http-notifier.d.ts

@@ -8,7 +8,7 @@ interface ResolvedHttpNotifier {
     onRunFinish?: NonNullable<AgentConfig['onRunFinish']>;
 }
 /** Where an agent's durable approvals/questions go, for the console:
- * `code` (AgentConfig.httpNotifier), `file` (agents/<name>/notifier.yml),
+ * `code` (AgentConfig.httpNotifier), `file` (agents/<name>/messaging.yml),
  * or `none`. A file whose secret isn't set yet is reported, not used. */
 export declare function describeNotifier(config: AgentConfig): {
     source: 'code' | 'file' | 'none';
@@ -19,7 +19,7 @@ export declare function describeNotifier(config: AgentConfig): {
     error?: string;
 };
 /** AgentConfig.httpNotifier when the agent sets one in code; otherwise
- * its agents/<name>/notifier.yml (see core/notifier-file.ts), re-read on
+ * its agents/<name>/messaging.yml (see core/notifier-file.ts), re-read on
  * every call so a console edit applies to the very next turn. */
 export declare function resolveHttpNotifier(config: AgentConfig): ResolvedHttpNotifier;
 export {};

package/dist/core/http-notifier.js

@@ -33,7 +33,7 @@ function formatEmailLifecycleSubject(event, context) {
     return event === 'run_start' ? `${context.agent} started` : `${context.agent} finished`;
 }
 /** Where an agent's durable approvals/questions go, for the console:
- * `code` (AgentConfig.httpNotifier), `file` (agents/<name>/notifier.yml),
+ * `code` (AgentConfig.httpNotifier), `file` (agents/<name>/messaging.yml),
  * or `none`. A file whose secret isn't set yet is reported, not used. */
 export function describeNotifier(config) {
     if (config.httpNotifier)
@@ -44,7 +44,7 @@ export function describeNotifier(config) {
         file = readNotifierFile(dir);
     }
     catch (err) {
-        return { source: 'none', error: `notifier.yml is invalid: ${err instanceof Error ? err.message : String(err)}` };
+        return { source: 'none', error: `The messaging settings are invalid: ${err instanceof Error ? err.message : String(err)}` };
     }
     if (!file)
         return { source: 'none' };
@@ -52,7 +52,7 @@ export function describeNotifier(config) {
     return { source: missingSecret ? 'none' : 'file', channel: file.channel, events: file.events, file, missingSecret };
 }
 /** AgentConfig.httpNotifier when the agent sets one in code; otherwise
- * its agents/<name>/notifier.yml (see core/notifier-file.ts), re-read on
+ * its agents/<name>/messaging.yml (see core/notifier-file.ts), re-read on
  * every call so a console edit applies to the very next turn. */
 export function resolveHttpNotifier(config) {
     const httpNotifier = config.httpNotifier;
@@ -72,7 +72,7 @@ function resolveFromFile(config) {
         file = readNotifierFile(dir);
     }
     catch (err) {
-        console.error(`[loopengine] ignoring agents/${config.name}/notifier.yml:`, err instanceof Error ? err.message : err);
+        console.error(`[loopengine] ignoring the messaging settings in agents/${config.name}/:`, err instanceof Error ? err.message : err);
         return EMPTY;
     }
     if (!file)
@@ -101,13 +101,13 @@ function buildResolved(httpNotifier, agentDir) {
             break;
         }
         case 'slack': {
-            const { botToken, channelId, publicUrl, buttons } = httpNotifier.config;
+            const { botToken, channelId, publicUrl, buttons, replyHint } = httpNotifier.config;
             // One shared instance for every concern this httpNotifier actually
             // covers — same "it's Slack-specific, not approval/question/
             // lifecycle-specific" reasoning SlackNotifier's own doc
             // comment works out; cheap to construct (holds two strings, does no
             // I/O itself) so there's no reason to build one per event kind.
-            const slack = new SlackNotifier({ botToken, channelId, publicUrl, buttons, onThread: ({ channel, ts, pendingId, kind }) => recordThread(agentDir, { app: 'slack', conversation: channel, ts, pendingId, kind }),
+            const slack = new SlackNotifier({ botToken, channelId, publicUrl, buttons, replyHint, onThread: ({ channel, ts, pendingId, kind }) => recordThread(agentDir, { app: 'slack', conversation: channel, ts, pendingId, kind }),
             });
             resolved = {
                 approver: events.has('approval') ? slack : undefined,

package/dist/core/http-notify-triggers/slack.d.ts

@@ -13,6 +13,7 @@ export declare class SlackNotifier implements DurableApprover, DurableQuestionHa
     private readonly channelId;
     private readonly publicUrl?;
     private readonly buttons;
+    private readonly replyHint;
     private readonly onThread?;
     /** `publicUrl`: where this server is reachable (LOOPENGINE_PUBLIC_URL
      * wins when set) — when known, each message links to a decision page
@@ -22,14 +23,17 @@ export declare class SlackNotifier implements DurableApprover, DurableQuestionHa
      * slack.ts); default true, false for a console-configured notifier,
      * which relies on the link instead. `onThread`: told where each
      * approval request or question landed, so a reply in its thread can be
-     * matched to it (core/messaging/threads.ts). */
+     * matched to it (core/messaging/threads.ts). `replyHint`: add a line
+     * saying replies in the thread are answered, when they are. */
     constructor(options: {
         botToken: string;
         channelId: string;
         publicUrl?: string;
         buttons?: boolean;
+        replyHint?: boolean;
         onThread?: (posted: SlackPostedRequest) => void;
     });
+    private replyHintBlocks;
     private threadRecorder;
     private decideLine;
     requestDurableApproval(tool: string, args: Record<string, unknown>, scope: Scope, reason: string): {

package/dist/core/http-notify-triggers/slack.js

@@ -31,6 +31,7 @@ export class SlackNotifier {
     channelId;
     publicUrl;
     buttons;
+    replyHint;
     onThread;
     /** `publicUrl`: where this server is reachable (LOOPENGINE_PUBLIC_URL
      * wins when set) — when known, each message links to a decision page
@@ -40,14 +41,22 @@ export class SlackNotifier {
      * slack.ts); default true, false for a console-configured notifier,
      * which relies on the link instead. `onThread`: told where each
      * approval request or question landed, so a reply in its thread can be
-     * matched to it (core/messaging/threads.ts). */
+     * matched to it (core/messaging/threads.ts). `replyHint`: add a line
+     * saying replies in the thread are answered, when they are. */
     constructor(options) {
         this.botToken = options.botToken;
         this.channelId = options.channelId;
         this.publicUrl = options.publicUrl;
         this.buttons = options.buttons ?? true;
+        this.replyHint = options.replyHint ?? false;
         this.onThread = options.onThread;
     }
+    replyHintBlocks(kind) {
+        if (!this.replyHint)
+            return [];
+        const text = kind === 'approval' ? 'Reply in this thread to ask about it.' : 'Reply in this thread to ask about the question.';
+        return [{ type: 'context', elements: [{ type: 'mrkdwn', text }] }];
+    }
     threadRecorder(pendingId, kind) {
         const onThread = this.onThread;
         return onThread ? (posted) => onThread({ ...posted, pendingId, kind }) : undefined;
@@ -75,6 +84,7 @@ export class SlackNotifier {
                         ],
                     }]
                 : []),
+            ...this.replyHintBlocks('approval'),
         ], this.threadRecorder(pendingId, 'approval'));
         return { pendingId };
     }
@@ -93,6 +103,7 @@ export class SlackNotifier {
             ...(this.buttons
                 ? [{ type: 'actions', elements: [...optionButtons, { type: 'button', text: { type: 'plain_text', text: 'Other…' }, action_id: 'open_answer_modal', value: pendingId }] }]
                 : []),
+            ...this.replyHintBlocks('question'),
         ], this.threadRecorder(pendingId, 'question'));
         return { pendingId };
     }

package/dist/core/messaging/connectors/slack/events.js

@@ -1,3 +1,4 @@
+import { toSlackMrkdwn } from './format.js';
 /** Reads an Events API body. Only people's new messages come through;
  * edits, deletions, joins and every bot's messages (this agent's own
  * included) are `ignore`. */
@@ -49,7 +50,7 @@ export function createSlackConnector(botToken) {
             const res = await fetch('https://slack.com/api/chat.postMessage', {
                 method: 'POST',
                 headers: { Authorization: `Bearer ${botToken}`, 'content-type': 'application/json; charset=utf-8' },
-                body: JSON.stringify({ channel: conversation, thread_ts: threadTs, text }),
+                body: JSON.stringify({ channel: conversation, thread_ts: threadTs, text: toSlackMrkdwn(text) }),
             });
             const body = (await res.json());
             if (!body.ok)

package/dist/core/messaging/connectors/slack/format.d.ts

@@ -0,0 +1 @@
+export declare function toSlackMrkdwn(markdown: string): string;

package/dist/core/messaging/connectors/slack/format.js

@@ -0,0 +1,34 @@
+// Models write Markdown even when asked for Slack's own format, and Slack
+// shows Markdown's **bold**, [links](url) and # headings as literal
+// characters. This turns the common cases into Slack mrkdwn before a
+// reply is posted; code (```blocks``` and `spans`) is left as written.
+const CODE = /(```[\s\S]*?```|`[^`\n]*`)/;
+export function toSlackMrkdwn(markdown) {
+    return markdown
+        .split(CODE)
+        .map((part, i) => (i % 2 === 1 ? part : convertProse(part)))
+        .join('');
+}
+function convertProse(text) {
+    const bold = [];
+    const keepBold = (inner) => {
+        bold.push(inner);
+        return `\u0000${bold.length - 1}\u0000`;
+    };
+    let out = text
+        // # Heading -> *Heading*
+        .replace(/^#{1,6}[ \t]+(.+?)[ \t]*#*[ \t]*$/gm, (_m, title) => keepBold(title))
+        // - item / * item -> • item
+        .replace(/^([ \t]*)[-*+][ \t]+/gm, '$1• ')
+        // **bold** / __bold__ -> *bold*
+        .replace(/\*\*(?=\S)([\s\S]*?\S)\*\*/g, (_m, inner) => keepBold(inner))
+        .replace(/__(?=\S)([\s\S]*?\S)__/g, (_m, inner) => keepBold(inner))
+        // *italic* -> _italic_ (what's left of single asterisks)
+        .replace(/(^|[^\w*])\*(?=\S)([^*\n]*?\S)\*(?![\w*])/g, '$1_$2_')
+        // ~~strike~~ -> ~strike~
+        .replace(/~~(?=\S)([\s\S]*?\S)~~/g, '~$1~')
+        // [text](url) -> <url|text>
+        .replace(/\[([^\]\n]+)\]\((https?:\/\/[^\s)]+)\)/g, '<$2|$1>');
+    out = out.replace(/\u0000(\d+)\u0000/g, (_m, n) => `*${bold[Number(n)]}*`);
+    return out;
+}

package/dist/core/messaging/connectors/slack/index.d.ts

@@ -1,3 +1,4 @@
 export { createSlackConnector, parseSlackEvent, type SlackEvent } from './events.js';
+export { toSlackMrkdwn } from './format.js';
 export { SLACK_ANSWER_ACTION_ID, SLACK_ANSWER_BLOCK_ID, openSlackAnswerModal, parseSlackInteraction, replyInSlack, slackOutcomeText, verifySlackRequest, type SlackInteraction, } from './interactions.js';
 export { listSlackChannels, slackAppManifest, type SlackChannel } from './setup.js';

package/dist/core/messaging/connectors/slack/index.js

@@ -1,8 +1,9 @@
 // The Slack connector (core/messaging/connector.ts), one file per part:
-// thread replies (./events.ts), buttons and the signing check
+// thread replies (./events.ts) and their formatting (./format.ts), buttons and the signing check
 // (./interactions.ts), and the console's app setup (./setup.ts).
 // Posting requests is still SlackNotifier's job
 // (core/http-notify-triggers/slack.ts).
 export { createSlackConnector, parseSlackEvent } from './events.js';
+export { toSlackMrkdwn } from './format.js';
 export { SLACK_ANSWER_ACTION_ID, SLACK_ANSWER_BLOCK_ID, openSlackAnswerModal, parseSlackInteraction, replyInSlack, slackOutcomeText, verifySlackRequest, } from './interactions.js';
 export { listSlackChannels, slackAppManifest } from './setup.js';

package/dist/core/notifier-file.d.ts

@@ -14,6 +14,9 @@ export interface NotifierFile {
      * remembered from the console's own address when saving.
      * LOOPENGINE_PUBLIC_URL, when set, wins over it. */
     publicUrl?: string;
+    /** slack: answer replies in a request's thread (core/messaging/).
+     * Unset counts as on. */
+    conversations?: boolean;
 }
 /** The env var each channel's secret is read from, per agent. */
 export declare const NOTIFIER_SECRET_VARS: Record<NotifierFileChannel, string>;
@@ -23,14 +26,18 @@ export declare const NOTIFIER_SECRET_VARS: Record<NotifierFileChannel, string>;
 export declare const NOTIFIER_SLACK_SIGNING_SECRET_VAR = "LOOPENGINE_NOTIFIER_SLACK_SIGNING_SECRET";
 export declare class NotifierFileError extends Error {
 }
+/** The older single-connection file, still read when messaging.yml is absent. */
 export declare function notifierFilePath(dir: string): string;
+export declare function messagingFilePath(dir: string): string;
 /** Throws NotifierFileError naming the first problem. */
 export declare function validateNotifierFile(input: unknown): NotifierFile;
-/** undefined when the agent has no notifier.yml. */
+/** The agent's connection: messaging.yml's first, else the older
+ * notifier.yml's; undefined when it has neither. */
 export declare function readNotifierFile(dir: string): NotifierFile | undefined;
+/** Writes messaging.yml (and drops an older notifier.yml it replaces). */
 export declare function writeNotifierFile(dir: string, input: unknown): NotifierFile;
 export declare function removeNotifierFile(dir: string): void;
-/** The HttpNotifierConfig a notifier.yml describes, with its secret read
+/** The HttpNotifierConfig a connection describes, with its secret read
  * from `env` — or which secret is missing, so nothing is sent unsigned
  * or unauthenticated. */
 export declare function notifierConfigFromFile(file: NotifierFile, env: AgentEnv): {

package/dist/core/notifier-file.js

@@ -1,7 +1,21 @@
-// agents/<name>/notifier.yml — where an agent's "ask" approvals and
-// questions go when nobody is watching a live chat, set from the console
-// (Permissions → "Where approval requests and questions are sent") instead of in code. Only consulted when the
-// agent's own AgentConfig.httpNotifier is unset; code always wins.
+// agents/<name>/messaging.yml — where an agent's "ask" approvals and
+// questions go when nobody is watching a live chat, and whether it
+// answers replies there, set from the console's Messaging tab instead of
+// in code. Only consulted when the agent's own AgentConfig.httpNotifier
+// is unset; code always wins.
+//
+// The file holds a list of connections, though only the first is used
+// for now:
+//
+//   connections:
+//     - app: slack
+//       channelId: C0123456
+//       events: [approval, question]
+//       conversations: true
+//
+// An older agents/<name>/notifier.yml (one connection, `channel:` for
+// `app:`) is still read; saving from the console replaces it with
+// messaging.yml.
 //
 // The file holds only non-secret settings. The one secret each channel
 // needs (a webhook signing secret, a Slack bot token, a Lark app secret)
@@ -25,9 +39,13 @@ const CHANNELS = ['webhook', 'slack', 'lark'];
 const EVENTS = ['approval', 'question', 'run_start', 'run_finish'];
 export class NotifierFileError extends Error {
 }
+/** The older single-connection file, still read when messaging.yml is absent. */
 export function notifierFilePath(dir) {
     return join(dir, 'notifier.yml');
 }
+export function messagingFilePath(dir) {
+    return join(dir, 'messaging.yml');
+}
 /** Throws NotifierFileError naming the first problem. */
 export function validateNotifierFile(input) {
     if (!input || typeof input !== 'object')
@@ -42,6 +60,12 @@ export function validateNotifierFile(input) {
     }
     const str = (key) => (typeof raw[key] === 'string' && raw[key].trim() ? raw[key].trim() : undefined);
     const file = { channel, events: events };
+    if (raw.conversations !== undefined) {
+        if (typeof raw.conversations !== 'boolean')
+            throw new NotifierFileError('conversations must be true or false');
+        if (channel === 'slack')
+            file.conversations = raw.conversations;
+    }
     const publicUrl = str('publicUrl');
     if (publicUrl) {
         if (!/^https?:\/\/[^/]+/.test(publicUrl))
@@ -70,24 +94,43 @@ export function validateNotifierFile(input) {
     }
     return file;
 }
-/** undefined when the agent has no notifier.yml. */
+/** The agent's connection: messaging.yml's first, else the older
+ * notifier.yml's; undefined when it has neither. */
 export function readNotifierFile(dir) {
+    const messagingPath = messagingFilePath(dir);
+    if (existsSync(messagingPath)) {
+        const parsed = parseYaml(readFileSync(messagingPath, 'utf8'));
+        if (parsed?.connections !== undefined && !Array.isArray(parsed.connections))
+            throw new NotifierFileError('connections must be a list');
+        const first = parsed?.connections?.[0];
+        if (first === undefined)
+            return undefined;
+        if (!first || typeof first !== 'object')
+            throw new NotifierFileError('each connection must be an object');
+        const { app, ...rest } = first;
+        return validateNotifierFile({ channel: app, ...rest });
+    }
     const path = notifierFilePath(dir);
     if (!existsSync(path))
         return undefined;
     return validateNotifierFile(parseYaml(readFileSync(path, 'utf8')));
 }
+/** Writes messaging.yml (and drops an older notifier.yml it replaces). */
 export function writeNotifierFile(dir, input) {
     const file = validateNotifierFile(input);
-    const header = '# Where this agent sends approval requests and questions when it is called over HTTP.\n' +
-        `# Edited from the console (Permissions tab). The secret lives in this agent's env as ${NOTIFIER_SECRET_VARS[file.channel]}.\n`;
-    writeFileSync(notifierFilePath(dir), header + stringifyYaml(file));
+    const { channel, ...rest } = file;
+    const header = '# Where this agent sends approval requests and questions when it is called over HTTP,\n' +
+        '# and whether it answers replies there. Edited from the console (Messaging tab).\n' +
+        `# The secret lives in this agent's env as ${NOTIFIER_SECRET_VARS[channel]}.\n`;
+    writeFileSync(messagingFilePath(dir), header + stringifyYaml({ connections: [{ app: channel, ...rest }] }));
+    rmSync(notifierFilePath(dir), { force: true });
     return file;
 }
 export function removeNotifierFile(dir) {
+    rmSync(messagingFilePath(dir), { force: true });
     rmSync(notifierFilePath(dir), { force: true });
 }
-/** The HttpNotifierConfig a notifier.yml describes, with its secret read
+/** The HttpNotifierConfig a connection describes, with its secret read
  * from `env` — or which secret is missing, so nothing is sent unsigned
  * or unauthenticated. */
 export function notifierConfigFromFile(file, env) {
@@ -105,7 +148,14 @@ export function notifierConfigFromFile(file, env) {
             return {
                 config: {
                     channel: 'slack',
-                    config: { botToken: secret, channelId: file.channelId, publicUrl: file.publicUrl, buttons: Boolean(env.get(NOTIFIER_SLACK_SIGNING_SECRET_VAR)) },
+                    config: {
+                        botToken: secret,
+                        channelId: file.channelId,
+                        publicUrl: file.publicUrl,
+                        buttons: Boolean(env.get(NOTIFIER_SLACK_SIGNING_SECRET_VAR)),
+                        // Says replies in the thread are answered, when they are.
+                        replyHint: Boolean(env.get(NOTIFIER_SLACK_SIGNING_SECRET_VAR)) && file.conversations !== false && process.env.LOOPENGINE_PLAN !== 'free',
+                    },
                     events: file.events,
                 },
             };

package/dist/index.d.ts

@@ -19,7 +19,7 @@ export { parseSlackEvent, createSlackConnector, verifySlackRequest, parseSlackIn
 export { createDecisionToken, verifyDecisionToken, decidePath, decideLinkMaker, decisionLinkTtlMs, type DecisionKind } from '#core/approval-links.js';
 export { renderDecidePage, renderDecideGonePage, renderDecideInvalidPage, type DecidePageItem } from './web/decide-page.js';
 export { sendTestWebhook } from '#core/http-notify-triggers/webhook.js';
-export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, listAgentSlackChannels, announceToNotifier, type DefaultWebhook } from './web/notifier-admin.js';
+export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, slackConversationsOn, listAgentSlackChannels, announceToNotifier, type DefaultWebhook } from './web/notifier-admin.js';
 export type * from './core/loop-events.js';
 export { streamMessage, streamMessageWithCallbacks, sendMessage, approveCall, denyCall, answerQuestion, getSessionHistory, } from './core/client.js';
 export type { RequestOptions, SendMessageResult, PendingApprovalResult, PendingQuestionResult, PendingResult, MessageResult, StreamMessageCallbacks, } from './core/client.js';

package/dist/index.js

@@ -20,7 +20,7 @@ export { parseSlackEvent, createSlackConnector, verifySlackRequest, parseSlackIn
 export { createDecisionToken, verifyDecisionToken, decidePath, decideLinkMaker, decisionLinkTtlMs } from '#core/approval-links.js';
 export { renderDecidePage, renderDecideGonePage, renderDecideInvalidPage } from './web/decide-page.js';
 export { sendTestWebhook } from '#core/http-notify-triggers/webhook.js';
-export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, listAgentSlackChannels, announceToNotifier } from './web/notifier-admin.js';
+export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, slackConversationsOn, listAgentSlackChannels, announceToNotifier } from './web/notifier-admin.js';
 // The framework-agnostic browser client for adapters/http.ts's own wire
 // protocol (see client.ts's own header comment) — this, not a deep
 // subpath import, is how a consumer's React/Vue/etc. chat UI is meant to

package/dist/web/agents-config-page.js

@@ -898,8 +898,13 @@ ${consoleShellScript}
 
   function renderActauthTabPlaceholder() {
     return '<div id="pendingContent"></div>' +
-      '<section id="actauthSection"><div id="actauthContent"><p class="hint">Loading&hellip;</p></div></section>' +
-      '<div id="approvalsContent"><p class="hint">Loading&hellip;</p></div>';
+      '<section id="actauthSection"><div id="actauthContent"><p class="hint">Loading&hellip;</p></div></section>';
+  }
+
+  // The Messaging tab: where approval requests and questions go, and
+  // whether the agent answers replies there. Filled by loadApprovalsSection.
+  function renderMessagingTabPlaceholder() {
+    return '<div id="approvalsContent"><p class="hint">Loading&hellip;</p></div>';
   }
 
   function renderActauthRuleRow(r) {
@@ -963,11 +968,12 @@ ${consoleShellScript}
         '</form></section>';
   }
 
-  // ---- Permissions → "Where approval requests and questions are sent": where "ask" decisions go when nobody is
-  // in Chat (web/notifier-admin.ts behind GET/PUT/DELETE .../notifier),
-  // the decisions still waiting (GET .../pending), and recent webhook
-  // deliveries. Reloaded every time the tab opens, so the waiting list is
-  // current. ----
+  // ---- Messaging tab: where "ask" decisions go when nobody is in Chat,
+  // and whether the agent answers replies there (web/notifier-admin.ts
+  // behind GET/PUT/DELETE .../notifier), plus recent deliveries. The
+  // decisions still waiting (GET .../pending) show at the top of
+  // Permissions. Reloaded every time either tab opens, so the waiting
+  // list is current. ----
 
   var lastNotifier = null;
   var NOTIFIER_EVENTS = [
@@ -1006,6 +1012,19 @@ ${consoleShellScript}
     return '<strong>Nowhere yet</strong>, so nobody is notified. Choose a webhook, Slack channel or Lark chat below.';
   }
 
+  // Slack only: whether replies in a request's thread are answered. On
+  // unless turned off; locked on LoopEngine Cloud's free plan.
+  function renderConversationsField(n, f) {
+    var free = n.plan === 'free';
+    var on = !free && f.conversations !== false;
+    return '<div class="body-field" style="margin:4px 0 0">' +
+      '<label class="tool-picker-item" style="border:0;padding:0;justify-content:flex-start"><input type="checkbox" name="conversations" id="slackConversations"' + (on ? ' checked' : '') + (free ? ' disabled' : '') + '> ' +
+      'Answer replies in a request&#39;s thread' + (free ? ' <span class="le-pill accent">Pro</span>' : '') + '</label>' +
+      '<p class="hint" style="margin:2px 0 0">' + (free
+        ? 'Talking a request through in Slack needs LoopEngine Pro. Approve and Deny buttons work on every plan.'
+        : 'People can ask the agent about a request in its thread, and it answers there. It can&#39;t approve or change anything from the thread yet: deciding still uses the buttons.') + '</p></div>';
+  }
+
   function renderNotifierForm(n) {
     var f = n.file || { channel: 'webhook', events: ['approval', 'question'] };
     var events = f.events || [];
@@ -1046,6 +1065,7 @@ ${consoleShellScript}
           (n.slack && n.slack.signingSecretSet ? 'set &mdash; Approve/Deny buttons are on' : 'adds Approve/Deny buttons inside Slack; without it, messages carry the approval link') + ')</span>' +
           '<input type="password" name="signingSecret" autocomplete="off"></label>' +
         '<p class="hint" style="margin:0">Buttons send their clicks to <code id="slackInteractivityUrl"></code> (the manifest already points there).</p>' +
+        renderConversationsField(n, f) +
         '<p class="hint" style="margin:0" id="slackEventsNote"></p>') +
       field('lark', '<label>App ID<input name="appId" value="' + escapeHtml(f.appId || '') + '"></label><label>Chat ID<input name="chatId" value="' + escapeHtml(f.chatId || '') + '"></label>' + secretField('lark', 'App secret')) +
       '<label>Link address <span class="hint">(messages link here so people can approve without logging in; use an address they can reach)</span>' +
@@ -1091,32 +1111,29 @@ ${consoleShellScript}
     if (tools.length && n && n.source === 'none') {
       html += '<div class="approvals-nudge"><strong>Approval requests aren&#39;t sent anywhere yet.</strong> ' +
         escapeHtml(tools.slice(0, 3).join(', ')) + (tools.length > 3 ? ' and more' : '') + ' can stop for approval, but when an app calls this agent over HTTP nobody is notified. ' +
-        '<a href="#approvalsSetup" class="approvals-nudge-link">Choose where they go</a></div>';
+        '<a href="?tab=messaging" data-tab="messaging">Choose where they go</a></div>';
     }
     if (pending.length) html += '<section><h3>Waiting for a decision (' + pending.length + ')</h3>' + renderPendingTable(pending) + '</section>';
     return html;
   }
 
   function renderApprovalsHtml(n) {
-    return '<section id="approvalsSetup"><h3>Where approval requests and questions are sent</h3>' +
-      '<p class="muted" style="margin:0 0 8px">When an app calls this agent over HTTP and a tool call needs approval, or the agent asks a question, it&#39;s sent here. In Chat it shows up in the conversation instead.</p>' +
+    return '<p class="muted" style="margin:0 0 20px">Connect a messaging app, so this agent can reach people when nobody is in Chat. When an app calls it over HTTP or a scheduled task runs, and a tool call needs approval or the agent asks a question, the request is sent here. In Chat it shows up in the conversation instead.</p>' +
+      '<section id="approvalsSetup"><h3>Connection</h3>' +
       '<p class="muted" style="margin:0 0 12px">Currently: ' + renderNotifierStatus(n) + '</p>' +
         (n.error ? '<p class="error">' + escapeHtml(n.error) + '</p>' : '') +
         (n.source === 'code' ? '' : renderNotifierForm(n)) + '</section>' +
+      '<section><h3>Deciding in Slack <span class="le-pill neutral">coming soon</span></h3>' +
+        '<ul class="muted" style="margin:0;padding-left:18px">' +
+          '<li><strong>Approvers</strong>: link Slack people to LoopEngine users, so they can approve, deny or change a request by replying in its thread.</li>' +
+          '<li><strong>Confirm-required tools</strong>: tools, such as ones that move money or delete data, that always need a Confirm click, never just a typed yes.</li>' +
+        '</ul></section>' +
       '<section><h3>Recent deliveries</h3>' + renderDeliveries(n.deliveries || []) + '</section>';
   }
 
   function wirePendingHandlers(name) {
     var content = detail.querySelector('#pendingContent');
     if (!content) return;
-    var nudgeLink = content.querySelector('.approvals-nudge-link');
-    if (nudgeLink) {
-      nudgeLink.addEventListener('click', function (ev) {
-        ev.preventDefault();
-        var target = detail.querySelector('#approvalsSetup');
-        if (target) target.scrollIntoView({ behavior: 'smooth', block: 'start' });
-      });
-    }
     var copyBtns = content.querySelectorAll('.pending-copy');
     for (var c = 0; c < copyBtns.length; c++) {
       copyBtns[c].addEventListener('click', function (ev) {
@@ -1231,6 +1248,10 @@ ${consoleShellScript}
       var secret = data.get('secret_' + channel);
       if (secret) body.secret = secret;
       if (channel === 'slack' && data.get('signingSecret')) body.signingSecret = data.get('signingSecret');
+      var conversationsBox = form.querySelector('#slackConversations');
+      // A locked switch (free plan) keeps whatever was saved before.
+      if (channel === 'slack' && conversationsBox && !conversationsBox.disabled) body.conversations = conversationsBox.checked;
+      else if (channel === 'slack' && lastNotifier && lastNotifier.file && lastNotifier.file.conversations !== undefined) body.conversations = lastNotifier.file.conversations;
       result.textContent = 'Saving…';
       fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/notifier', {
         method: 'PUT', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body),
@@ -1338,7 +1359,7 @@ ${consoleShellScript}
     var list = tasks.length
       ? '<div class="le-table-wrap"><table><thead><tr><th>Task</th><th>When</th><th>Status</th><th>Last run</th><th></th></tr></thead><tbody>' + tasks.map(renderScheduleRow).join('') + '</tbody></table></div>'
       : '<p class="hint">Nothing scheduled yet.</p>';
-    return '<p class="muted" style="margin:0 0 20px">Messages this agent receives on a timer, like a cron job. Each run works like an app calling it over HTTP: an approval goes wherever the Permissions tab sends it, and with nowhere set, a call that needs approval is denied. The agent can also schedule its own tasks when asked in Chat (&ldquo;remind me tomorrow at 9&rdquo;); they appear here too.</p>' +
+    return '<p class="muted" style="margin:0 0 20px">Messages this agent receives on a timer, like a cron job. Each run works like an app calling it over HTTP: an approval goes wherever the Messaging tab sends it, and with nowhere set, a call that needs approval is denied. The agent can also schedule its own tasks when asked in Chat (&ldquo;remind me tomorrow at 9&rdquo;); they appear here too.</p>' +
       '<section><h3>Scheduled (' + active.length + ' active)</h3>' + list + '</section>' +
       '<section><h3>New schedule</h3>' +
         '<form class="add-source" id="scheduleForm" style="max-width:560px">' +
@@ -1351,7 +1372,7 @@ ${consoleShellScript}
               '<input type="datetime-local" name="runAt" aria-label="Date and time"></div>' +
           '</div>' +
           '<label>Name <span class="hint">(optional)</span><input name="task_name" placeholder="Daily ticket summary"></label>' +
-          '<label class="http-tool-inline-label"><input type="checkbox" name="notify"> Send each result through this agent&#39;s notifier (set in the Permissions tab)</label>' +
+          '<label class="http-tool-inline-label"><input type="checkbox" name="notify"> Send each result through this agent&#39;s messaging connection (set in the Messaging tab)</label>' +
           '<div style="display:flex;gap:8px"><button type="submit">Schedule</button></div>' +
           '<div id="scheduleResult" class="hint"></div>' +
         '</form></section>';
@@ -2898,7 +2919,7 @@ ${consoleShellScript}
 
   // ---- Tab switching + agent selection ----
 
-  var CONFIG_TABS = ['overview', 'tools', 'skills', 'abilities', 'actauth', 'schedules', 'env'];
+  var CONFIG_TABS = ['overview', 'tools', 'skills', 'abilities', 'actauth', 'messaging', 'schedules', 'env'];
 
   function switchTab(tab) {
     if (CONFIG_TABS.indexOf(tab) === -1) tab = 'overview';
@@ -2919,7 +2940,7 @@ ${consoleShellScript}
     if (tab === 'actauth' && actauthLoadedFor !== currentName) {
       loadActauthTab(currentName);
     }
-    if (tab === 'actauth') loadApprovalsSection(currentName);
+    if (tab === 'actauth' || tab === 'messaging') loadApprovalsSection(currentName);
     if (tab === 'env' && envLoadedFor !== currentName) {
       loadEnvTab(currentName);
     }
@@ -3021,6 +3042,7 @@ ${consoleShellScript}
       '<div class="tab-panel" data-tab-panel="skills">' + renderSkillsTabHtml(cfg) + '</div>' +
       '<div class="tab-panel" data-tab-panel="tools">' + renderToolsTabHtml(cfg) + '</div>' +
       '<div class="tab-panel" data-tab-panel="actauth">' + renderActauthTabPlaceholder() + '</div>' +
+      '<div class="tab-panel" data-tab-panel="messaging">' + renderMessagingTabPlaceholder() + '</div>' +
       '<div class="tab-panel" data-tab-panel="env">' + renderEnvTabPlaceholder() + '</div>' +
       '<div class="tab-panel" data-tab-panel="abilities">' + renderAbilitiesTabPlaceholder() + '</div>' +
       '<div class="tab-panel" data-tab-panel="schedules">' + renderSchedulesTabPlaceholder() + '</div>' +

package/dist/web/console-shell.js

@@ -44,7 +44,7 @@ export const consoleShellScript = `<script>
   var toSet = {};
   var TABS = [
     ['chat', 'Chat'], ['overview', 'Overview'], ['abilities', 'Abilities'], ['tools', 'Tools'],
-    ['skills', 'Skills'], ['actauth', 'Permissions'], ['schedules', 'Schedules'], ['env', 'Environment']
+    ['skills', 'Skills'], ['actauth', 'Permissions'], ['messaging', 'Messaging'], ['schedules', 'Schedules'], ['env', 'Environment']
   ];
 
   function esc(s) {

package/dist/web/notifier-admin.d.ts

@@ -15,6 +15,7 @@ export declare function describeAgentNotifier(config: AgentConfig, defaultWebhoo
     source: string;
     defaultWebhookUrl: string | null;
     publicUrl: string | null;
+    plan: string | null;
     secretVars: Record<NotifierFileChannel, string>;
     secretsSet: {
         [k: string]: boolean;
@@ -23,6 +24,7 @@ export declare function describeAgentNotifier(config: AgentConfig, defaultWebhoo
         signingSecretVar: string;
         signingSecretSet: boolean;
         interactivityPath: string;
+        eventsPath: string;
         manifestTemplate: Record<string, unknown>;
     };
     deliveries: import("../core/notifier-deliveries.js").NotifierDelivery[];
@@ -32,7 +34,7 @@ export declare function describeAgentNotifier(config: AgentConfig, defaultWebhoo
     missingSecret?: string;
     error?: string;
 };
-/** Writes agents/<name>/notifier.yml from the console form and, when the
+/** Writes agents/<name>/messaging.yml from the console form and, when the
  * form includes one, the channel's secret into the agent's own env.
  * Throws NotifierFileError for an invalid form. */
 export declare function saveAgentNotifier(config: AgentConfig, body: Record<string, unknown>): Promise<void>;
@@ -44,10 +46,14 @@ export declare function slackCredentialsFor(config: AgentConfig): {
     botToken?: string;
     signingSecret?: string;
 };
+/** Whether replies in a Slack request's thread are answered: on unless
+ * the Messaging tab turned Conversations off. An agent whose Slack
+ * notifier is set in code always answers. */
+export declare function slackConversationsOn(config: AgentConfig): boolean;
 /** Channels for the console's picker, with the token being typed in or,
  * when none is given, the one already saved. */
 export declare function listAgentSlackChannels(config: AgentConfig, botToken?: string): Promise<SlackChannel[]>;
-/** Removes notifier.yml; the stored secret is left alone, so turning the
+/** Removes the messaging settings; the stored secret is left alone, so turning the
  * notifier back on doesn't need it re-entered. */
 export declare function removeAgentNotifier(config: AgentConfig): void;
 /** Posts a plain announcement through the agent's notifier — a scheduled

package/dist/web/notifier-admin.js

@@ -19,6 +19,9 @@ export function describeAgentNotifier(config, defaultWebhook) {
         source,
         defaultWebhookUrl: defaultWebhook?.webhookUrl ?? null,
         publicUrl: process.env.LOOPENGINE_PUBLIC_URL ?? null,
+        // LOOPENGINE_PLAN ('free' on LoopEngine Cloud's free plan): the
+        // console locks Conversations on free. null when self-hosted.
+        plan: process.env.LOOPENGINE_PLAN ?? null,
         secretVars: NOTIFIER_SECRET_VARS,
         secretsSet,
         slack: {
@@ -26,6 +29,8 @@ export function describeAgentNotifier(config, defaultWebhook) {
             signingSecretSet: env.get(NOTIFIER_SLACK_SIGNING_SECRET_VAR) !== undefined,
             // Where the Slack app's Interactivity Request URL should point.
             interactivityPath: `/hooks/slack/${encodeURIComponent(config.name)}`,
+            // Where replies in a request's thread arrive (core/messaging/).
+            eventsPath: `/hooks/slack/${encodeURIComponent(config.name)}/events`,
             // The console swaps __INTERACTIVITY_URL__ for the link address +
             // interactivityPath as you type.
             manifestTemplate: slackAppManifest({ agentName: config.name, interactivityUrl: '__INTERACTIVITY_URL__' }),
@@ -33,7 +38,7 @@ export function describeAgentNotifier(config, defaultWebhook) {
         deliveries: listDeliveries(config.name),
     };
 }
-/** Writes agents/<name>/notifier.yml from the console form and, when the
+/** Writes agents/<name>/messaging.yml from the console form and, when the
  * form includes one, the channel's secret into the agent's own env.
  * Throws NotifierFileError for an invalid form. */
 export async function saveAgentNotifier(config, body) {
@@ -54,6 +59,19 @@ export function slackCredentialsFor(config) {
     const botToken = config.httpNotifier?.channel === 'slack' ? config.httpNotifier.config.botToken : env.get(NOTIFIER_SECRET_VARS.slack);
     return { botToken, signingSecret: env.get(NOTIFIER_SLACK_SIGNING_SECRET_VAR) };
 }
+/** Whether replies in a Slack request's thread are answered: on unless
+ * the Messaging tab turned Conversations off. An agent whose Slack
+ * notifier is set in code always answers. */
+export function slackConversationsOn(config) {
+    if (config.httpNotifier)
+        return config.httpNotifier.channel === 'slack';
+    try {
+        return readNotifierFile(agentDirFor(config))?.conversations !== false;
+    }
+    catch {
+        return false;
+    }
+}
 /** Channels for the console's picker, with the token being typed in or,
  * when none is given, the one already saved. */
 export async function listAgentSlackChannels(config, botToken) {
@@ -62,13 +80,13 @@ export async function listAgentSlackChannels(config, botToken) {
         throw new Error('Enter the bot token first');
     return listSlackChannels(token);
 }
-/** Removes notifier.yml; the stored secret is left alone, so turning the
+/** Removes the messaging settings; the stored secret is left alone, so turning the
  * notifier back on doesn't need it re-entered. */
 export function removeAgentNotifier(config) {
     removeNotifierFile(agentDirFor(config));
 }
 /** The notifier settings that apply to an agent: its code httpNotifier,
- * else its notifier.yml (once its secret is set), else the
+ * else its messaging.yml (once its secret is set), else the
  * deployment-wide default webhook. */
 function activeNotifierTarget(config, defaultWebhook) {
     if (config.httpNotifier)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.1.80",
+  "version": "0.1.81",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",