agor-live 0.21.2 → 0.23.1

package/dist/core/environment/render-snapshot.js

@@ -2,10 +2,7 @@
 import fs from "fs";
 
 // src/yaml/index.ts
-import yaml from "js-yaml";
-var load = yaml.load;
-var dump = yaml.dump;
-var YAMLException = yaml.YAMLException;
+import * as yaml from "js-yaml";
 
 // src/config/variant-resolver.ts
 function resolveVariant(env, variantName) {

package/dist/core/environment/webhook.cjs

@@ -45,10 +45,7 @@ __export(webhook_exports, {
 module.exports = __toCommonJS(webhook_exports);
 
 // src/yaml/index.ts
-var import_js_yaml = __toESM(require("js-yaml"), 1);
-var load = import_js_yaml.default.load;
-var dump = import_js_yaml.default.dump;
-var YAMLException = import_js_yaml.default.YAMLException;
+var yaml = __toESM(require("js-yaml"), 1);
 
 // src/config/variant-resolver.ts
 function resolveVariant(env, variantName) {

package/dist/core/environment/webhook.js

@@ -1,8 +1,5 @@
 // src/yaml/index.ts
-import yaml from "js-yaml";
-var load = yaml.load;
-var dump = yaml.dump;
-var YAMLException = yaml.YAMLException;
+import * as yaml from "js-yaml";
 
 // src/config/variant-resolver.ts
 function resolveVariant(env, variantName) {

package/dist/core/gateway/connector-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-registry.d.ts","sourceRoot":"","sources":["../../src/gateway/connector-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,gBAAgB,CAAC;AAQ9E;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAMlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"connector-registry.d.ts","sourceRoot":"","sources":["../../src/gateway/connector-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,gBAAgB,CAAC;AAS9E;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAMlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAE9D"}

package/dist/core/gateway/connector.d.ts

@@ -4,7 +4,7 @@
  * Defines the contract for platform-specific connectors that handle
  * sending messages to and receiving messages from messaging platforms.
  */
-import type { ChannelType } from '../types/gateway';
+import type { ChannelType, SlackTestResult } from '../types/gateway';
 /**
  * Inbound message from a messaging platform
  */
@@ -55,6 +55,28 @@ export interface GatewayConnector {
         blocks?: unknown[];
         metadata?: Record<string, unknown>;
     }): Promise<string>;
+    /**
+     * Delete a previously sent platform message when supported.
+     *
+     * Used for temporary UX affordances (for example, Slack progress rows) that
+     * should disappear once the durable assistant response has arrived.
+     */
+    deleteMessage?(req: {
+        threadId: string;
+        messageId: string;
+    }): Promise<void>;
+    /**
+     * Set platform-native thread status when supported.
+     *
+     * Slack exposes this via assistant.threads.setStatus; unlike a mutable chat
+     * message, the status is rendered by Slack as assistant chrome.
+     */
+    setThreadStatus?(req: {
+        threadId: string;
+        status: string;
+        loadingMessages?: string[];
+        iconEmoji?: string;
+    }): Promise<void>;
     /**
      * Start listening for inbound messages (e.g., via Socket Mode or webhooks)
      */
@@ -71,5 +93,14 @@ export interface GatewayConnector {
      * own `sendMessage` will interpret. Callers should accept either shape.
      */
     formatMessage?(markdown: string): string | OutboundPayload;
+    /**
+     * Best-effort probe of the connector's credentials and reachability.
+     *
+     * Implementations exercise real platform API calls to verify what they can
+     * (token validity, Socket Mode handshake, sampled channel access) and return
+     * a structured report. `result.notVerifiable` lists what the probe cannot
+     * prove, so a green result is never mistaken for full verification.
+     */
+    testConnection?(): Promise<SlackTestResult>;
 }
 //# sourceMappingURL=connector.d.ts.map

package/dist/core/gateway/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,CAEtF;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;CAC5D"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,CAEtF;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,eAAe,CAAC,CAAC,GAAG,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;IAE3D;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C"}

package/dist/core/gateway/connectors/slack-manifest.cjs

@@ -0,0 +1,108 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/gateway/connectors/slack-manifest.ts
+var slack_manifest_exports = {};
+__export(slack_manifest_exports, {
+  buildSlackManifest: () => buildSlackManifest,
+  requiredBotEvents: () => requiredBotEvents,
+  requiredBotScopes: () => requiredBotScopes
+});
+module.exports = __toCommonJS(slack_manifest_exports);
+function hasChannelLikeSurface(opts) {
+  return opts.publicChannels || opts.privateChannels || opts.groupDms;
+}
+function sortedUnique(values) {
+  return [...new Set(values)].sort();
+}
+function requiredBotScopes(opts) {
+  const scopes = ["chat:write", "im:history", "im:read", "users:read"];
+  if (hasChannelLikeSurface(opts)) {
+    scopes.push("app_mentions:read");
+  }
+  if (opts.publicChannels) {
+    scopes.push("channels:history", "channels:read");
+  }
+  if (opts.privateChannels) {
+    scopes.push("groups:history", "groups:read");
+  }
+  if (opts.groupDms) {
+    scopes.push("mpim:history", "mpim:read");
+  }
+  if (opts.alignUsers) {
+    scopes.push("users:read.email");
+  }
+  if (opts.outbound) {
+    scopes.push(
+      "chat:write.public",
+      "channels:read",
+      "groups:read",
+      "im:write",
+      "users:read.email"
+    );
+  }
+  return sortedUnique(scopes);
+}
+function requiredBotEvents(opts) {
+  const events = ["message.im"];
+  if (hasChannelLikeSurface(opts)) {
+    events.push("app_mention");
+  }
+  return sortedUnique(events);
+}
+function buildSlackManifest(opts) {
+  return {
+    display_information: {
+      name: opts.appName
+    },
+    features: {
+      bot_user: {
+        display_name: opts.botDisplayName ?? opts.appName,
+        always_online: true
+      },
+      app_home: {
+        messages_tab_enabled: true,
+        messages_tab_read_only_enabled: false,
+        home_tab_enabled: false
+      }
+    },
+    oauth_config: {
+      scopes: {
+        bot: requiredBotScopes(opts)
+      }
+    },
+    settings: {
+      event_subscriptions: {
+        bot_events: requiredBotEvents(opts)
+      },
+      interactivity: {
+        is_enabled: false
+      },
+      org_deploy_enabled: false,
+      socket_mode_enabled: true,
+      token_rotation_enabled: false
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildSlackManifest,
+  requiredBotEvents,
+  requiredBotScopes
+});

package/dist/core/gateway/connectors/slack-manifest.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Slack App Manifest generator
+ *
+ * Pure, dependency-free derivation of the Slack OAuth bot scopes, event
+ * subscriptions, and a complete app manifest from a small set of capability
+ * toggles. The output is the full manifest JSON a user can paste into Slack's
+ * "Create app from manifest" flow — no scope or event needs to be added by
+ * hand. The only manual step left to the user is generating the app-level
+ * token (`connections:write`), which is not a bot scope and therefore never
+ * appears in this manifest.
+ *
+ * The scope/event matrix mirrors what the Slack connector actually calls; see
+ * {@link ./slack.ts}. DMs are always handled, so there is no DM toggle, and
+ * channel-like surfaces trigger exclusively on `app_mention` (verified in the
+ * connector's inbound filter), so no `message.channels`/`groups`/`mpim` events
+ * are requested.
+ */
+export interface SlackWizardOptions {
+    appName: string;
+    botDisplayName?: string;
+    /** Listen in public channels (`#channel`). */
+    publicChannels: boolean;
+    /** Listen in private channels (groups). */
+    privateChannels: boolean;
+    /** Listen in group DMs (multi-person IMs). */
+    groupDms: boolean;
+    /** Resolve Slack user email → Agor user (requires reading user emails). */
+    alignUsers: boolean;
+    /** Proactive outbound: post to channels by name and DM users by email. */
+    outbound: boolean;
+}
+export interface SlackBotEventSubscriptions {
+    bot_events: string[];
+}
+export interface SlackAppManifest {
+    display_information: {
+        name: string;
+    };
+    features: {
+        bot_user: {
+            display_name: string;
+            always_online: boolean;
+        };
+        app_home: {
+            messages_tab_enabled: boolean;
+            messages_tab_read_only_enabled: boolean;
+            home_tab_enabled: boolean;
+        };
+    };
+    oauth_config: {
+        scopes: {
+            bot: string[];
+        };
+    };
+    settings: {
+        event_subscriptions: SlackBotEventSubscriptions;
+        interactivity: {
+            is_enabled: boolean;
+        };
+        org_deploy_enabled: boolean;
+        socket_mode_enabled: boolean;
+        token_rotation_enabled: boolean;
+    };
+}
+/**
+ * Bot OAuth scopes required for the selected capabilities, de-duplicated and
+ * stable-sorted. Derived from the connector's Web API usage.
+ */
+export declare function requiredBotScopes(opts: SlackWizardOptions): string[];
+/**
+ * Bot event subscriptions required for the selected capabilities,
+ * de-duplicated and stable-sorted. Channel-like surfaces trigger only on
+ * `app_mention`; DMs trigger on `message.im`.
+ */
+export declare function requiredBotEvents(opts: SlackWizardOptions): string[];
+/**
+ * Build the complete Slack app manifest for the selected capabilities.
+ *
+ * Socket Mode is enabled, so no request URLs or signing secret are emitted.
+ * Interactivity is disabled because the connector uses no interactive components.
+ * The assistant view is omitted because the connector does not handle assistant
+ * lifecycle events.
+ */
+export declare function buildSlackManifest(opts: SlackWizardOptions): SlackAppManifest;
+//# sourceMappingURL=slack-manifest.d.ts.map

package/dist/core/gateway/connectors/slack-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-manifest.d.ts","sourceRoot":"","sources":["../../../src/gateway/connectors/slack-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,eAAe,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,YAAY,EAAE,MAAM,CAAC;YACrB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,QAAQ,EAAE;YACR,oBAAoB,EAAE,OAAO,CAAC;YAC9B,8BAA8B,EAAE,OAAO,CAAC;YACxC,gBAAgB,EAAE,OAAO,CAAC;SAC3B,CAAC;KACH,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,EAAE,CAAC;SACf,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,mBAAmB,EAAE,0BAA0B,CAAC;QAChD,aAAa,EAAE;YACb,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;QACF,kBAAkB,EAAE,OAAO,CAAC;QAC5B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,sBAAsB,EAAE,OAAO,CAAC;KACjC,CAAC;CACH;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAgCpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAQpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,CAiC7E"}

package/dist/core/gateway/connectors/slack-manifest.js

@@ -0,0 +1,81 @@
+// src/gateway/connectors/slack-manifest.ts
+function hasChannelLikeSurface(opts) {
+  return opts.publicChannels || opts.privateChannels || opts.groupDms;
+}
+function sortedUnique(values) {
+  return [...new Set(values)].sort();
+}
+function requiredBotScopes(opts) {
+  const scopes = ["chat:write", "im:history", "im:read", "users:read"];
+  if (hasChannelLikeSurface(opts)) {
+    scopes.push("app_mentions:read");
+  }
+  if (opts.publicChannels) {
+    scopes.push("channels:history", "channels:read");
+  }
+  if (opts.privateChannels) {
+    scopes.push("groups:history", "groups:read");
+  }
+  if (opts.groupDms) {
+    scopes.push("mpim:history", "mpim:read");
+  }
+  if (opts.alignUsers) {
+    scopes.push("users:read.email");
+  }
+  if (opts.outbound) {
+    scopes.push(
+      "chat:write.public",
+      "channels:read",
+      "groups:read",
+      "im:write",
+      "users:read.email"
+    );
+  }
+  return sortedUnique(scopes);
+}
+function requiredBotEvents(opts) {
+  const events = ["message.im"];
+  if (hasChannelLikeSurface(opts)) {
+    events.push("app_mention");
+  }
+  return sortedUnique(events);
+}
+function buildSlackManifest(opts) {
+  return {
+    display_information: {
+      name: opts.appName
+    },
+    features: {
+      bot_user: {
+        display_name: opts.botDisplayName ?? opts.appName,
+        always_online: true
+      },
+      app_home: {
+        messages_tab_enabled: true,
+        messages_tab_read_only_enabled: false,
+        home_tab_enabled: false
+      }
+    },
+    oauth_config: {
+      scopes: {
+        bot: requiredBotScopes(opts)
+      }
+    },
+    settings: {
+      event_subscriptions: {
+        bot_events: requiredBotEvents(opts)
+      },
+      interactivity: {
+        is_enabled: false
+      },
+      org_deploy_enabled: false,
+      socket_mode_enabled: true,
+      token_rotation_enabled: false
+    }
+  };
+}
+export {
+  buildSlackManifest,
+  requiredBotEvents,
+  requiredBotScopes
+};

package/dist/core/gateway/connectors/slack.d.ts

@@ -12,16 +12,50 @@
  *     enable_channels?: boolean,                    // Listen in public channels
  *     enable_groups?: boolean,                      // Listen in private channels
  *     enable_mpim?: boolean,                        // Listen in group DMs
- *     require_mention?: boolean,                    // Require @mention in channels
- *     allow_thread_replies_without_mention?: boolean, // Allow thread replies without @mention (default: true)
+ *     require_mention?: boolean,                    // Legacy; Slack channel-like prompts now always require @mention
+ *     allow_thread_replies_without_mention?: boolean, // Legacy; ignored for Slack channel-like prompts
  *     allowed_channel_ids?: string[]                // Channel ID whitelist
  *   }
  *
  * Thread ID format: "{channel_id}-{thread_ts}"
  *   e.g. "C07ABC123-1707340800.123456"
  */
-import type { ChannelType } from '../../types/gateway';
+import { WebClient } from '@slack/web-api';
+import type { ChannelType, SlackTestResult } from '../../types/gateway';
 import type { GatewayConnector, InboundMessage, OutboundPayload } from '../connector';
+export interface SlackUserAvatarProfile {
+    slackUserId: string;
+    email: string | null;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+export interface SlackThreadHistoryMessage {
+    ts: string;
+    iso_time: string;
+    user_id?: string;
+    user_name?: string;
+    actor_label: string;
+    text: string;
+    is_bot: boolean;
+    is_trigger: boolean;
+    is_mention: boolean;
+}
+export interface SlackThreadHistoryRequest {
+    threadId: string;
+    oldestTs?: string;
+    latestTs?: string;
+    inclusive?: boolean;
+    limit?: number;
+    includeBotMessages?: boolean;
+    triggerTs?: string;
+}
+export interface SlackThreadHistoryResult {
+    threadId: string;
+    channel: string;
+    thread_ts: string;
+    messages: SlackThreadHistoryMessage[];
+    has_more?: boolean;
+}
 /**
  * Wrap GFM tables in code fences so Slack renders them monospace.
  *
@@ -48,7 +82,9 @@ export declare function markdownToMrkdwn(markdown: string): string;
 /**
  * Build a Slack outbound payload from GitHub-flavored markdown.
  *
- * If the message contains GFM tables, emits a `blocks` array that uses
+ * If the message contains rich or multiple GFM tables and fits Slack's native
+ * markdown block budget, emits a `markdown` block so Slack can preserve richer
+ * table Markdown. Otherwise emits a `blocks` array that uses
  * Block Kit's native `table` block (Aug 2025) for the first qualifying
  * table and falls back to a monospace code block for any table that
  * exceeds Slack's caps (>{@link TABLE_MAX_ROWS} rows, >{@link TABLE_MAX_COLS}
@@ -65,6 +101,15 @@ export declare function markdownToMrkdwn(markdown: string): string;
  * the legacy path produced, so non-table messages are unchanged on the wire.
  */
 export declare function markdownToSlackPayload(markdown: string): OutboundPayload;
+/**
+ * Decide whether the `allowed_channel_ids` whitelist permits an inbound event.
+ *
+ * DMs (`im`) always pass: a DM conversation id is never present in a
+ * channel-id whitelist, so applying the filter there would silently disable
+ * direct messages the moment any whitelist is configured. The whitelist only
+ * governs channel-like surfaces (`channel`/`group`/`mpim`).
+ */
+export declare function isChannelAllowedByWhitelist(channelType: string, channelId: string | undefined, allowedChannelIds: string[] | undefined): boolean;
 export declare class SlackConnector implements GatewayConnector {
     readonly channelType: ChannelType;
     private web;
@@ -73,10 +118,12 @@ export declare class SlackConnector implements GatewayConnector {
     private botUserId;
     /** Cache: Slack user ID → profile (email + display name, or null if unavailable). */
     private userProfileCache;
+    private inboundEventDedup;
     /** Cache: Slack channel ID → channel name */
     private channelNameCache;
     private static USER_CACHE_TTL_MS;
     private static USER_CACHE_ERROR_TTL_MS;
+    private static INBOUND_EVENT_DEDUP_TTL_MS;
     /**
      * Cache: Slack channel ID → channel type string (channel/group/mpim/im).
      *
@@ -91,6 +138,26 @@ export declare class SlackConnector implements GatewayConnector {
     private static CHANNEL_CACHE_TTL_MS;
     private static CHANNEL_CACHE_ERROR_TTL_MS;
     constructor(config: Record<string, unknown>);
+    /**
+     * Build a Slack WebClient for an arbitrary token. Isolated so connection
+     * probes can construct a client for the app-level (`xapp-`) token, and so
+     * tests can stub the app-token client independently of `this.web`.
+     */
+    protected createWebClient(token: string): WebClient;
+    /**
+     * Best-effort probe of the configured Slack credentials and reachability.
+     *
+     * Probes capabilities directly rather than diffing scope-header strings:
+     *   - `auth.test()` with the bot token → team + bot identity.
+     *   - `apps.connections.open()` with the app-level token → Socket Mode /
+     *     `connections:write` validity.
+     *   - `conversations.info` on the first whitelisted channel (when any) →
+     *     channel reachability.
+     *
+     * Slack's `missing_scope` needed/provided detail and rate-limit `Retry-After`
+     * are surfaced verbatim. Never logs or returns token values.
+     */
+    testConnection(): Promise<SlackTestResult>;
     /**
      * Look up a Slack user's email address by their user ID.
      *
@@ -110,6 +177,13 @@ export declare class SlackConnector implements GatewayConnector {
         email: string | null;
         displayName: string | null;
     }>;
+    /**
+     * Look up a Slack user by email and return display metadata including a
+     * high-resolution avatar URL. Used by Agor's admin-triggered user avatar
+     * sync. Prefer image_512 for crisp large/retina rendering, falling back to
+     * smaller Slack-provided variants.
+     */
+    lookupUserAvatarByEmail(email: string): Promise<SlackUserAvatarProfile | null>;
     /**
      * Look up a Slack channel's name by its ID.
      *
@@ -118,6 +192,8 @@ export declare class SlackConnector implements GatewayConnector {
      * Falls back to its own conversations.info call if not cached.
      */
     lookupChannelName(channelId: string): Promise<string | null>;
+    private lookupLatestThreadReply;
+    private shouldProcessInboundEventOnce;
     /**
      * Cache a known channel type from a trusted source (e.g. `message` event with explicit `channel_type`).
      */
@@ -148,6 +224,59 @@ export declare class SlackConnector implements GatewayConnector {
         blocks?: unknown[];
         metadata?: Record<string, unknown>;
     }): Promise<string>;
+    /**
+     * Send directly to a Slack channel or thread. Used for proactive outbound
+     * emits where no gateway thread_session_map exists yet.
+     */
+    sendSlackMessage(req: {
+        channel: string;
+        text: string;
+        blocks?: unknown[];
+        thread_ts?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        ts: string;
+        channel: string;
+        thread_ts: string;
+        permalink?: string | null;
+    }>;
+    /** Resolve a Slack channel by its human name (with or without #). */
+    resolveChannelByName(name: string): Promise<{
+        channel: string;
+        name: string;
+    }>;
+    /** Resolve a Slack user email to a DM channel with that user. */
+    openDmByEmail(email: string): Promise<{
+        channel: string;
+        user_id: string;
+    }>;
+    fetchThreadHistory(req: SlackThreadHistoryRequest): Promise<SlackThreadHistoryResult>;
+    startStream(req: {
+        threadId: string;
+        text?: string;
+        recipientUserId?: string;
+        recipientTeamId?: string;
+    }): Promise<string>;
+    appendStream(req: {
+        threadId: string;
+        ts: string;
+        text: string;
+    }): Promise<void>;
+    stopStream(req: {
+        threadId: string;
+        ts: string;
+        text?: string;
+    }): Promise<void>;
+    deleteMessage(req: {
+        threadId: string;
+        messageId: string;
+    }): Promise<void>;
+    setThreadStatus(req: {
+        threadId: string;
+        status: string;
+        loadingMessages?: string[];
+        iconEmoji?: string;
+    }): Promise<void>;
     /**
      * Start listening for inbound messages via Socket Mode
      *
@@ -156,7 +285,7 @@ export declare class SlackConnector implements GatewayConnector {
      * - Public channels (if enable_channels = true)
      * - Private channels (if enable_groups = true)
      * - Group DMs (if enable_mpim = true)
-     * - Mention requirement (if require_mention = true)
+     * - Explicit mention requirement for channel-like conversations
      * - Channel whitelist (if allowed_channel_ids is set)
      */
     startListening(callback: (msg: InboundMessage) => void): Promise<void>;
@@ -169,8 +298,8 @@ export declare class SlackConnector implements GatewayConnector {
      *
      * Returns `{ text, blocks? }`. `text` is the mrkdwn fallback used for
      * notifications and clients that don't render Block Kit; `blocks` is set
-     * when the message contains a GFM table that we can emit as a native
-     * Block Kit `table` block (or a monospace section fallback alongside one).
+     * when the message contains tables that can benefit from Slack's native
+     * markdown/table blocks.
      */
     formatMessage(markdown: string): OutboundPayload;
 }

package/dist/core/gateway/connectors/slack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/gateway/connectors/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA8JtF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAoJD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAuCxE;AAaD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAW;IAE5C,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAuB;IAExC,qFAAqF;IACrF,OAAO,CAAC,gBAAgB,CAGpB;IAEJ,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB,CAAiE;IACzF,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAa;IAEnD;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB,CAA0D;IAClF,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAkB;IACrD,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAa;gBAE1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAa3C;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlE;;;;;;;;OAQG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAmDhE;;;;;;OAMG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiClE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;;;;;;OAQG;YACW,kBAAkB;IAoFhC;;;;;;;;;OASG;IACG,WAAW,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CnB;;;;;;;;;;OAUG;IACG,cAAc,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiS5E;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;CAGjD"}
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/gateway/connectors/slack.ts"],"names":[],"mappings":"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"}