botmancers 0.5.0 → 0.6.1

package/app/node_modules/ws/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "ws",
+  "version": "8.22.0",
+  "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
+  "keywords": [
+    "HyBi",
+    "Push",
+    "RFC-6455",
+    "WebSocket",
+    "WebSockets",
+    "real-time"
+  ],
+  "homepage": "https://github.com/websockets/ws",
+  "bugs": "https://github.com/websockets/ws/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/websockets/ws.git"
+  },
+  "author": "Einar Otto Stangvik <einaros@gmail.com> (http://2x.io)",
+  "license": "MIT",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "import": "./wrapper.mjs",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "browser": "browser.js",
+  "engines": {
+    "node": ">=10.0.0"
+  },
+  "files": [
+    "browser.js",
+    "index.js",
+    "lib/*.js",
+    "wrapper.mjs"
+  ],
+  "scripts": {
+    "test": "nyc --reporter=lcov --reporter=text mocha --throw-deprecation test/*.test.js",
+    "integration": "mocha --throw-deprecation test/*.integration.js",
+    "lint": "eslint . && prettier --check --ignore-path .gitignore \"**/*.{json,md,yaml,yml}\""
+  },
+  "peerDependencies": {
+    "bufferutil": "^4.0.1",
+    "utf-8-validate": ">=5.0.2"
+  },
+  "peerDependenciesMeta": {
+    "bufferutil": {
+      "optional": true
+    },
+    "utf-8-validate": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "benchmark": "^2.1.4",
+    "bufferutil": "^4.0.1",
+    "eslint": "^10.0.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.0.0",
+    "globals": "^17.0.0",
+    "mocha": "^8.4.0",
+    "nyc": "^15.0.0",
+    "prettier": "^3.0.0",
+    "utf-8-validate": "^6.0.0"
+  },
+  "allowScripts": {
+    "bufferutil": true,
+    "utf-8-validate": true
+  }
+}

package/app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botmancers-app",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "private": true,
   "type": "commonjs"
 }

package/app/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{"BOTMANCERS_BUILD_VERSION":"0.5.0","BOTMANCERS_BUILD_COMMIT":"47984e52c3b4b718ad944d03532e9b80efc95529"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":__dirname,"enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","repoRoot":__dirname,"turbopack":{"root":__dirname},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/favicon.ico","destination":"/brand/botmancers-logo-filled-64.png"}],"fallback":[]}}
+const nextConfig = {"env":{"BOTMANCERS_BUILD_VERSION":"0.6.1","BOTMANCERS_BUILD_COMMIT":"37fd03570d80dad5a36f4ce5e901641aa2dd4295"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":__dirname,"enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["@slack/socket-mode","@slack/web-api"],"repoRoot":__dirname,"turbopack":{"root":__dirname},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/favicon.ico","destination":"/brand/botmancers-logo-filled-64.png"}],"fallback":[]}}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/dist/cli.js

@@ -210,14 +210,17 @@ export async function bridgeMain(argv, env, io = processIo) {
         }
         return EXIT.listen;
     }
-    const shown = address.family === 'IPv6' ? `[${address.address}]` : address.address;
-    err(`botmancers ${packageVersion()}: MCP bridge listening on http://${shown}:${address.port}${MCP_PATH} (health: ${HEALTH_PATH}) -> ${config.botmancersUrl}`);
+    // The handlers go in before the listening line: a supervisor or test that
+    // signals the bridge as soon as it reads that line must never beat them, or
+    // the default action kills the process instead of a clean exit 0.
     const stop = (signal) => {
         err(`botmancers: ${signal} received, shutting down.`);
         bridge.close().then(() => process.exit(EXIT.ok));
     };
     process.once('SIGINT', () => stop('SIGINT'));
     process.once('SIGTERM', () => stop('SIGTERM'));
+    const shown = address.family === 'IPv6' ? `[${address.address}]` : address.address;
+    err(`botmancers ${packageVersion()}: MCP bridge listening on http://${shown}:${address.port}${MCP_PATH} (health: ${HEALTH_PATH}) -> ${config.botmancersUrl}`);
     return 'serving';
 }
 function invokedDirectly() {

package/dist/product.d.ts

@@ -102,6 +102,11 @@ export declare function inspect(ctx: Ctx): Promise<Inspection>;
 export declare function formatStatus(ctx: Ctx, view: Inspection, report?: ManagedReport): string;
 export declare function status(ctx: Ctx): Promise<number>;
 export declare function mergeServiceTokens(generated: string | undefined, ...explicit: (string | undefined)[]): string;
+export declare const SLACK_TOKEN_ENVS: readonly ["BOTMANCERS_SLACK_APP_TOKEN", "BOTMANCERS_SLACK_BOT_TOKEN"];
+export declare function childEnvs(ctx: Ctx): {
+    core: NodeJS.ProcessEnv;
+    bridge: NodeJS.ProcessEnv;
+};
 export declare function supervise(ctx: Ctx, onReady: (record: RunRecord) => void, onClaim?: () => void): Promise<number>;
 export declare function open(ctx: Ctx): Promise<number>;
 export interface StartOptions {
@@ -112,4 +117,7 @@ export interface StartOptions {
 export declare function parseStartArgs(argv: string[]): StartOptions;
 export declare function start(ctx: Ctx, options: StartOptions): Promise<number>;
 export declare function stop(ctx: Ctx): Promise<number>;
+type Level = 'ok' | 'warn' | 'fail' | 'info';
+export declare function slackDoctorLine(health: unknown, coreEnv: Record<string, string | undefined>, running: boolean): [Level, string, string];
 export declare function doctor(ctx: Ctx): Promise<number>;
+export {};

package/dist/product.js

@@ -61,7 +61,11 @@ export function productContext(env, io) {
         throw new UsageError(error.message);
     }
     const bridge = readEnvFile(paths.bridgeEnv) ?? {};
-    const redact = createRedactor([bridge[ENV.serviceToken], bridge[ENV.mcpToken], env[ENV.serviceToken], env[ENV.mcpToken]]);
+    const core = readEnvFile(paths.coreEnv) ?? {};
+    const redact = createRedactor([
+        bridge[ENV.serviceToken], bridge[ENV.mcpToken], env[ENV.serviceToken], env[ENV.mcpToken],
+        ...SLACK_TOKEN_ENVS.flatMap(key => [env[key], core[key]]),
+    ]);
     const out = (write) => (text) => write(redact(text));
     return { env, io: { stdout: out(io.stdout), stderr: out(io.stderr) }, paths, appDir: appDir(env), uiPort, mcpPort, version: packageVersion(), redact };
 }
@@ -408,13 +412,19 @@ export function mergeServiceTokens(generated, ...explicit) {
         entries.set(BRIDGE_SERVICE_ID, entry);
     return [...entries.values()].join(',');
 }
-function childEnvs(ctx) {
+export const SLACK_TOKEN_ENVS = ['BOTMANCERS_SLACK_APP_TOKEN', 'BOTMANCERS_SLACK_BOT_TOKEN'];
+export function childEnvs(ctx) {
     const coreFile = readEnvFile(ctx.paths.coreEnv) ?? {};
     const bridgeFile = readEnvFile(ctx.paths.bridgeEnv) ?? {};
     const shell = { ...ctx.env };
     // The core never holds the raw bridge tokens.
     for (const key of [ENV.serviceToken, ENV.mcpToken, ENV.url, ENV.host, ENV.port, UI_PORT_ENV])
         delete shell[key];
+    // NOT-518: the Slack tokens are the core's alone (its Socket Mode
+    // transport); the MCP bridge never receives them.
+    const bridgeShell = { ...shell };
+    for (const key of SLACK_TOKEN_ENVS)
+        delete bridgeShell[key];
     const home = ctx.paths.home;
     return {
         core: {
@@ -428,7 +438,7 @@ function childEnvs(ctx) {
             NEXT_TELEMETRY_DISABLED: '1',
         },
         bridge: {
-            ...shell,
+            ...bridgeShell,
             [ENV.serviceToken]: bridgeFile[ENV.serviceToken],
             [ENV.mcpToken]: bridgeFile[ENV.mcpToken],
             [ENV.url]: uiUrl(ctx),
@@ -900,6 +910,61 @@ async function reachable(url) {
         return false;
     }
 }
+// NOT-519: the Slack relay line. A running core reports its state on the
+// read-only GET /api/health (lib/slack-runtime slackRuntimeStatus: state,
+// reason, connections, never a token); doctor never sends Slack anything and
+// never posts to the core. Stopped, only whether the credentials are present
+// is told (from core.env and the environment), never their values.
+const SLACK_APP_TOKEN = 'BOTMANCERS_SLACK_APP_TOKEN';
+const SLACK_BOT_TOKEN = 'BOTMANCERS_SLACK_BOT_TOKEN';
+const SLACK_STATES = ['disabled', 'misconfigured', 'failed', 'connecting', 'connected', 'reconnecting', 'stopped'];
+const SLACK_REASON = /^[a-z_]{1,64}$/;
+const SLACK_FIX = {
+    app_token_missing: `set ${SLACK_APP_TOKEN} (xapp-…) in core.env`,
+    bot_token_missing: `set ${SLACK_BOT_TOKEN} (xoxb-…) in core.env`,
+    app_token_invalid: `${SLACK_APP_TOKEN} must be an app-level xapp- token`,
+    bot_token_invalid: `${SLACK_BOT_TOKEN} must be a bot xoxb- token`,
+    share_config_absent: 'add a Slack channel to the share allowlist (Agent Config → Session sharing)',
+    share_config_invalid: 'fix config/session-shares.json (Agent Config → Session sharing names the problem)',
+    share_config_no_audience: 'add a Slack channel to the share allowlist (Agent Config → Session sharing)',
+    workspace_not_allowlisted: 'the bot token\'s workspace has no channel on the share allowlist',
+    slack_auth_failed: 'Slack refused the bot token (auth.test); check it and restart',
+    slack_connect_failed: 'Socket Mode did not connect; check the app token and Socket Mode, then restart',
+};
+export function slackDoctorLine(health, coreEnv, running) {
+    const restart = `then ${RESTART_ACTION}`;
+    const slack = health && typeof health === 'object' ? health.slack : undefined;
+    if (running && slack && typeof slack === 'object') {
+        const { state, reason, connections } = slack;
+        if (typeof state === 'string' && SLACK_STATES.includes(state)) {
+            const why = typeof reason === 'string' && SLACK_REASON.test(reason) ? reason : null;
+            const fix = why && SLACK_FIX[why] ? `; ${SLACK_FIX[why]}, ${restart}` : '';
+            const count = typeof connections === 'number' && Number.isInteger(connections) && connections > 1 ? ` (${connections - 1} reconnect${connections === 2 ? '' : 's'} since start)` : '';
+            if (state === 'disabled')
+                return ['info', 'slack', 'Slack relay disabled (no Slack tokens configured); session shares cannot reach Slack.'];
+            if (state === 'connected')
+                return ['ok', 'slack', `Slack relay connected over Socket Mode${count}`];
+            if (state === 'connecting')
+                return ['info', 'slack', 'Slack relay connecting to Socket Mode'];
+            if (state === 'reconnecting')
+                return ['warn', 'slack', `Slack relay reconnecting to Socket Mode${count}; questions wait and are answered once it reconnects`];
+            if (state === 'stopped')
+                return ['warn', 'slack', `Slack relay stopped in a running core; ${RESTART_ACTION}`];
+            return ['warn', 'slack', `Slack relay ${state}${why ? ` (${why})` : ''}${fix}`];
+        }
+    }
+    const app = (coreEnv[SLACK_APP_TOKEN] ?? '').trim() !== '';
+    const bot = (coreEnv[SLACK_BOT_TOKEN] ?? '').trim() !== '';
+    if (!app && !bot)
+        return ['info', 'slack', 'Slack relay disabled (no Slack tokens configured); session shares cannot reach Slack.'];
+    if (!app || !bot) {
+        const reason = app ? 'bot_token_missing' : 'app_token_missing';
+        return ['warn', 'slack', `Slack relay misconfigured (${reason}); ${SLACK_FIX[reason]}`];
+    }
+    if (running)
+        return ['warn', 'slack', 'Slack tokens are configured, but the running core reports no Slack state; restart with this version.'];
+    return ['info', 'slack', 'Slack tokens are configured; the relay connects when botmancers starts.'];
+}
 export async function doctor(ctx) {
     const checks = [];
     const add = (level, name, detail) => checks.push([level, name, detail]);
@@ -997,6 +1062,7 @@ export async function doctor(ctx) {
         add('ok', 'hermes', `HERMES_API_SERVER_KEY is configured (gateway ${core.HERMES_BASE_URL?.trim() || 'http://127.0.0.1:8642'})`);
     else
         add('warn', 'hermes', `Hermes is not configured: conversational turns post a Hermes error until HERMES_API_SERVER_KEY is set in ${ctx.paths.coreEnv}.`);
+    add(...slackDoctorLine(view.core?.ok ? view.core.body : undefined, core, !!view.record && !!view.core?.ok));
     const deckUrl = (ctx.env[AGENT_DECK_URL_ENV] ?? '').trim() || DEFAULT_AGENT_DECK_URL;
     const deckBin = onPath('agent-deck', ctx.env);
     if (!deckBin)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botmancers",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Botmancers: the UI, core engine, and authenticated MCP bridge (contracts botmancers.mcp.v1 and botmancers.mcp.v2) as one CLI-managed product. `botmancers start` runs it all; bare `botmancers` runs the bridge only.",
   "keywords": [
     "botmancers",
@@ -56,7 +56,7 @@
     "build": "npm run clean && tsc -p tsconfig.json",
     "build:app": "node scripts/build-app.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && npm run build:app && node --test \"test/*.test.mjs\"",
+    "test": "npm run build && npm run build:app && node --test --test-timeout=120000 --test-force-exit \"test/*.test.mjs\"",
     "check:pack": "node scripts/check-pack.mjs",
     "check:skill": "node scripts/check-skill.mjs",
     "smoke:install": "node scripts/smoke-install.mjs",