@agent-relay/slack-primitive 6.0.12

package/dist/actions/post-message.d.ts

@@ -0,0 +1,9 @@
+import type { PostMessageOutput, PostMessageParams, SlackWebApiLike } from '../types.js';
+/**
+ * Resolve Slack references and post a message.
+ * @param slack - Slack Web API client.
+ * @param params - Message parameters.
+ * @returns Posted message metadata and soft mention-resolution warnings.
+ */
+export declare function postMessage(slack: SlackWebApiLike, params: PostMessageParams): Promise<PostMessageOutput>;
+//# sourceMappingURL=post-message.d.ts.map

package/dist/actions/post-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message.d.ts","sourceRoot":"","sources":["../../src/actions/post-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAyC5B"}

package/dist/actions/post-message.js

@@ -0,0 +1,48 @@
+import { resolveChannel } from './resolve-channel.js';
+import { resolveUser } from './resolve-user.js';
+/**
+ * Resolve Slack references and post a message.
+ * @param slack - Slack Web API client.
+ * @param params - Message parameters.
+ * @returns Posted message metadata and soft mention-resolution warnings.
+ */
+export async function postMessage(slack, params) {
+    const channelInput = params.channel ?? process.env.SLACK_DEFAULT_CHANNEL;
+    if (!channelInput) {
+        throw new Error('Slack postMessage channel is missing; provide channel or set SLACK_DEFAULT_CHANNEL.');
+    }
+    const channel = await resolveChannel(slack, channelInput);
+    const userCache = new Map();
+    const resolvedMentions = [];
+    const warnings = [];
+    for (const mention of params.mentions ?? []) {
+        try {
+            resolvedMentions.push(await resolveUser(slack, mention, { cache: userCache }));
+        }
+        catch (error) {
+            warnings.push({
+                type: 'mention_unresolved',
+                input: mention,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    const mentionPrefix = resolvedMentions.map((mention) => `<@${mention.userId}>`).join(' ');
+    const text = mentionPrefix ? `${mentionPrefix} ${params.text}` : params.text;
+    const response = await slack.chat.postMessage({
+        channel: channel.id,
+        text,
+        thread_ts: params.threadTs,
+        unfurl_links: params.unfurl,
+        unfurl_media: params.unfurl,
+    });
+    return {
+        channel: response.channel ?? channel.id,
+        ts: response.ts ?? '',
+        text: response.message?.text ?? text,
+        resolvedMentions,
+        unresolvedMentions: warnings.map((warning) => warning.input),
+        warnings,
+    };
+}
+//# sourceMappingURL=post-message.js.map

package/dist/actions/post-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message.js","sourceRoot":"","sources":["../../src/actions/post-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAsB,EACtB,MAAyB;IAEzB,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACzE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IACtD,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IACpD,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,gBAAgB,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QAC5C,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,YAAY,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE;QACvC,EAAE,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE;QACrB,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI;QACpC,gBAAgB;QAChB,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAC5D,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/actions/resolve-channel.d.ts

@@ -0,0 +1,9 @@
+import { type SlackChannelSummary, type SlackWebApiLike } from '../types.js';
+/**
+ * Resolve a Slack channel reference to a channel object.
+ * @param slack - Slack Web API client.
+ * @param channel - Raw channel id or #channel-name reference.
+ * @returns Resolved Slack channel summary.
+ */
+export declare function resolveChannel(slack: SlackWebApiLike, channel: string): Promise<SlackChannelSummary>;
+//# sourceMappingURL=resolve-channel.d.ts.map

package/dist/actions/resolve-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-channel.d.ts","sourceRoot":"","sources":["../../src/actions/resolve-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAIjG;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAwB9B"}

package/dist/actions/resolve-channel.js

@@ -0,0 +1,29 @@
+import { SlackPostBackError } from '../types.js';
+const CHANNEL_ID_PATTERN = /^[CGD][A-Z0-9]{2,}$/;
+/**
+ * Resolve a Slack channel reference to a channel object.
+ * @param slack - Slack Web API client.
+ * @param channel - Raw channel id or #channel-name reference.
+ * @returns Resolved Slack channel summary.
+ */
+export async function resolveChannel(slack, channel) {
+    if (CHANNEL_ID_PATTERN.test(channel)) {
+        return { id: channel };
+    }
+    const name = channel.startsWith('#') ? channel.slice(1) : channel;
+    let cursor;
+    do {
+        const response = await slack.conversations.list({
+            cursor,
+            limit: 200,
+            types: 'public_channel,private_channel',
+        });
+        const match = response.channels?.find((candidate) => candidate.name === name);
+        if (match?.id) {
+            return match;
+        }
+        cursor = response.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+    throw new SlackPostBackError('channel_not_found', `Slack channel not found: ${channel}`);
+}
+//# sourceMappingURL=resolve-channel.js.map

package/dist/actions/resolve-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-channel.js","sourceRoot":"","sources":["../../src/actions/resolve-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkD,MAAM,aAAa,CAAC;AAEjG,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAsB,EACtB,OAAe;IAEf,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,IAAI,MAA0B,CAAC;IAE/B,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC;YAC9C,MAAM;YACN,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,gCAAgC;SACxC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9E,IAAI,KAAK,EAAE,EAAE,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,QAAQ,CAAC,iBAAiB,EAAE,WAAW,IAAI,SAAS,CAAC;IAChE,CAAC,QAAQ,MAAM,EAAE;IAEjB,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,4BAA4B,OAAO,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/actions/resolve-user.d.ts

@@ -0,0 +1,13 @@
+import type { SlackResolvedMention, SlackUserSummary, SlackWebApiLike } from '../types.js';
+export interface ResolveUserOptions {
+    cache?: Map<string, SlackUserSummary>;
+}
+/**
+ * Resolve a Slack user mention to a user id.
+ * @param slack - Slack Web API client.
+ * @param mention - Raw user id, @email@example.com, or @handle reference.
+ * @param options - Optional user cache.
+ * @returns Resolved mention record.
+ */
+export declare function resolveUser(slack: SlackWebApiLike, mention: string, options?: ResolveUserOptions): Promise<SlackResolvedMention>;
+//# sourceMappingURL=resolve-user.d.ts.map

package/dist/actions/resolve-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-user.d.ts","sourceRoot":"","sources":["../../src/actions/resolve-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3F,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}

package/dist/actions/resolve-user.js

@@ -0,0 +1,93 @@
+/**
+ * Resolve a Slack user mention to a user id.
+ * @param slack - Slack Web API client.
+ * @param mention - Raw user id, @email@example.com, or @handle reference.
+ * @param options - Optional user cache.
+ * @returns Resolved mention record.
+ */
+export async function resolveUser(slack, mention, options = {}) {
+    const normalized = mention.startsWith('@') ? mention.slice(1) : mention;
+    if (isSlackUserId(normalized)) {
+        return { input: mention, userId: normalized };
+    }
+    if (isEmailCandidate(normalized)) {
+        const response = await slack.users.lookupByEmail({ email: normalized });
+        const userId = response.user?.id;
+        if (!userId) {
+            throw new Error(`Slack user not found for email: ${mention}`);
+        }
+        if (response.user) {
+            rememberUser(options.cache, response.user);
+        }
+        return { input: mention, userId };
+    }
+    const cache = options.cache ?? new Map();
+    let cached = cache.get(normalized.toLowerCase());
+    if (!cached) {
+        await populateUserCache(slack, cache);
+        cached = cache.get(normalized.toLowerCase());
+    }
+    if (cached?.id) {
+        return { input: mention, userId: cached.id };
+    }
+    throw new Error(`Slack user not found for handle: ${mention}`);
+}
+function isSlackUserId(value) {
+    if (value.length < 3)
+        return false;
+    if (value[0] !== 'U' && value[0] !== 'W')
+        return false;
+    for (let i = 1; i < value.length; i += 1) {
+        const code = value.charCodeAt(i);
+        const isDigit = code >= 48 && code <= 57;
+        const isUppercase = code >= 65 && code <= 90;
+        if (!isDigit && !isUppercase)
+            return false;
+    }
+    return true;
+}
+function isEmailCandidate(value) {
+    const at = value.indexOf('@');
+    if (at <= 0 || at !== value.lastIndexOf('@') || at === value.length - 1)
+        return false;
+    const domain = value.slice(at + 1);
+    const dot = domain.indexOf('.');
+    return dot > 0 && dot < domain.length - 1 && !hasAsciiWhitespace(value);
+}
+function hasAsciiWhitespace(value) {
+    for (let i = 0; i < value.length; i += 1) {
+        const code = value.charCodeAt(i);
+        if (code === 9 || code === 10 || code === 11 || code === 12 || code === 13 || code === 32) {
+            return true;
+        }
+    }
+    return false;
+}
+async function populateUserCache(slack, cache) {
+    let cursor;
+    do {
+        const response = await slack.users.list({ cursor, limit: 200 });
+        for (const user of response.members ?? []) {
+            rememberUser(cache, user);
+        }
+        cursor = response.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+}
+function rememberUser(cache, user) {
+    if (!cache)
+        return;
+    for (const key of userKeys(user)) {
+        cache.set(key.toLowerCase(), user);
+    }
+}
+function userKeys(user) {
+    return [
+        user.id,
+        user.name,
+        user.realName,
+        user.profile?.email,
+        user.profile?.displayName,
+        user.profile?.realName,
+    ].filter((value) => Boolean(value));
+}
+//# sourceMappingURL=resolve-user.js.map

package/dist/actions/resolve-user.js.map

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

package/dist/adapter.d.ts

@@ -0,0 +1,23 @@
+import { SlackAction, SlackClientInterface, type PostMessageOutput, type PostMessageParams, type RequiredSlackRuntimeConfig, type ResolveChannelParams, type ResolveUserParams, type SlackActionName, type SlackActionOutputMap, type SlackActionParamsMap, type SlackActionResult, type SlackChannelSummary, type SlackResolvedMention, type SlackRuntime, type SlackRuntimeAvailability, type SlackRuntimeConfig, type SlackRuntimeDetectionResult, type SlackWebApiLike } from './types.js';
+export declare function normalizeSlackRuntimeConfig(config?: SlackRuntimeConfig): RequiredSlackRuntimeConfig;
+export declare abstract class BaseSlackAdapter extends SlackClientInterface {
+    protected readonly slack: SlackWebApiLike;
+    constructor(config: RequiredSlackRuntimeConfig, slack: SlackWebApiLike);
+    isAuthenticated(): Promise<boolean>;
+    executeAction<Name extends SlackAction>(action: Name, params: SlackActionParamsMap[Name]): Promise<SlackActionResult<SlackActionOutputMap[Name]>>;
+    executeAction<TOutput = unknown>(action: SlackAction | SlackActionName, params?: unknown): Promise<SlackActionResult<TOutput>>;
+    postMessage(params: PostMessageParams): Promise<PostMessageOutput>;
+    resolveUser(params: ResolveUserParams): Promise<SlackResolvedMention>;
+    resolveChannel(params: ResolveChannelParams): Promise<SlackChannelSummary>;
+    private dispatchAction;
+}
+export declare class SlackAdapterFactory {
+    static create(config?: SlackRuntimeConfig): Promise<SlackClientInterface>;
+    static detect(config?: SlackRuntimeConfig): Promise<SlackRuntimeDetectionResult>;
+    static detectRuntime(config?: SlackRuntimeConfig): Promise<SlackRuntime>;
+    static testRuntime(runtime: SlackRuntime, config?: SlackRuntimeConfig): Promise<SlackRuntimeAvailability>;
+}
+export declare const SlackClientFactory: typeof SlackAdapterFactory;
+export declare function detectSlackRuntime(config?: SlackRuntimeConfig): Promise<SlackRuntimeDetectionResult>;
+export declare function createSlackAdapter(config?: SlackRuntimeConfig): Promise<SlackClientInterface>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAEhC,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,kBAAuB,GAAG,0BAA0B,CAkBvG;AAQD,8BAAsB,gBAAiB,SAAQ,oBAAoB;IAG/D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,eAAe;gBADzC,MAAM,EAAE,0BAA0B,EACf,KAAK,EAAE,eAAe;IAKrC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAYzC,aAAa,CAAC,IAAI,SAAS,WAAW,EACpC,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACjC,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,aAAa,CAAC,OAAO,GAAG,OAAO,EAC7B,MAAM,EAAE,WAAW,GAAG,eAAe,EACrC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IA+BhC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOlE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAIlE,cAAc;CAY7B;AAED,qBAAa,mBAAmB;WACjB,MAAM,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;WAmBtE,MAAM,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;WAwB7E,aAAa,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlF,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,wBAAwB,CAAC;CAkCrC;AAED,eAAO,MAAM,kBAAkB,4BAAsB,CAAC;AAEtD,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAExG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEjG"}

package/dist/adapter.js

@@ -0,0 +1,194 @@
+import { postMessage as postMessageAction } from './actions/post-message.js';
+import { resolveChannel as resolveChannelAction } from './actions/resolve-channel.js';
+import { resolveUser as resolveUserAction } from './actions/resolve-user.js';
+import { SlackAction, SlackClientInterface, } from './types.js';
+const DEFAULT_TIMEOUT = 30_000;
+export function normalizeSlackRuntimeConfig(config = {}) {
+    const env = config.env ?? process.env;
+    const token = nonEmpty(config.token) ?? nonEmpty(env.SLACK_BOT_TOKEN) ?? '';
+    const cloudApiToken = nonEmpty(config.cloudApiToken) ?? nonEmpty(env.CLOUD_API_TOKEN) ?? '';
+    const cloudApiUrl = nonEmpty(config.cloudApiUrl) ?? nonEmpty(env.CLOUD_API_URL) ?? '';
+    return {
+        ...config,
+        runtime: config.runtime && config.runtime !== 'auto'
+            ? config.runtime
+            : selectRuntime({ token, cloudApiToken, cloudApiUrl }),
+        env,
+        token,
+        cloudApiToken,
+        cloudApiUrl,
+        timeout: config.timeout ?? DEFAULT_TIMEOUT,
+    };
+}
+function selectRuntime(input) {
+    if (input.cloudApiToken && input.cloudApiUrl)
+        return 'cloud-relay';
+    if (input.token)
+        return 'local';
+    return 'noop';
+}
+export class BaseSlackAdapter extends SlackClientInterface {
+    slack;
+    constructor(config, slack) {
+        super(config);
+        this.slack = slack;
+    }
+    async isAuthenticated() {
+        if (!this.slack.auth) {
+            return Boolean(this.config.token);
+        }
+        try {
+            const response = await this.slack.auth.test();
+            return response.ok !== false;
+        }
+        catch {
+            return false;
+        }
+    }
+    async executeAction(action, params) {
+        const startedAt = Date.now();
+        try {
+            const data = (await this.dispatchAction(action, params));
+            return {
+                success: true,
+                output: stringifyOutput(data),
+                data,
+                metadata: {
+                    runtime: this.getRuntime(),
+                    executionTime: Date.now() - startedAt,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : String(error),
+                metadata: {
+                    runtime: this.getRuntime(),
+                    executionTime: Date.now() - startedAt,
+                },
+            };
+        }
+    }
+    async postMessage(params) {
+        return postMessageAction(this.slack, {
+            ...params,
+            channel: params.channel ?? this.config.env.SLACK_DEFAULT_CHANNEL,
+        });
+    }
+    async resolveUser(params) {
+        return resolveUserAction(this.slack, params.mention);
+    }
+    async resolveChannel(params) {
+        return resolveChannelAction(this.slack, params.channel);
+    }
+    async dispatchAction(action, params) {
+        switch (action) {
+            case SlackAction.PostMessage:
+                return this.postMessage(params);
+            case SlackAction.ResolveUser:
+                return this.resolveUser(params);
+            case SlackAction.ResolveChannel:
+                return this.resolveChannel(params);
+            default:
+                throw new Error(`Unsupported Slack action: ${String(action)}`);
+        }
+    }
+}
+export class SlackAdapterFactory {
+    static async create(config = {}) {
+        const normalized = normalizeSlackRuntimeConfig(config);
+        switch (normalized.runtime) {
+            case 'cloud-relay': {
+                const { SlackCloudRelayClient } = await import('./cloud-relay-runtime.js');
+                return new SlackCloudRelayClient(normalized);
+            }
+            case 'noop': {
+                const { SlackNoopClient } = await import('./noop-runtime.js');
+                return new SlackNoopClient(normalized);
+            }
+            case 'local':
+            default: {
+                const { SlackWebApiClient } = await import('./local-runtime.js');
+                return new SlackWebApiClient(normalized);
+            }
+        }
+    }
+    static async detect(config = {}) {
+        const normalized = normalizeSlackRuntimeConfig(config);
+        const local = await this.testRuntime('local', normalized);
+        const cloudRelay = await this.testRuntime('cloud-relay', normalized);
+        const noop = await this.testRuntime('noop', normalized);
+        const requested = config.runtime ?? 'auto';
+        const selected = normalized.runtime;
+        const summary = selected === 'cloud-relay' ? cloudRelay : selected === 'noop' ? noop : local;
+        return {
+            runtime: selected,
+            requestedRuntime: requested,
+            source: normalized.token || normalized.cloudApiToken || normalized.cloudApiUrl ? 'config' : 'environment',
+            available: summary.available,
+            reason: summary.reason,
+            checkedAt: new Date().toISOString(),
+            local,
+            cloudRelay,
+            noop,
+        };
+    }
+    static async detectRuntime(config = {}) {
+        return normalizeSlackRuntimeConfig(config).runtime;
+    }
+    static testRuntime(runtime, config = {}) {
+        const normalized = normalizeSlackRuntimeConfig(config);
+        switch (runtime) {
+            case 'cloud-relay': {
+                const ready = Boolean(normalized.cloudApiToken && normalized.cloudApiUrl);
+                return Promise.resolve({
+                    runtime,
+                    available: ready,
+                    authenticated: ready,
+                    reason: ready
+                        ? 'CLOUD_API_TOKEN and CLOUD_API_URL are configured.'
+                        : 'CLOUD_API_TOKEN or CLOUD_API_URL is not configured.',
+                });
+            }
+            case 'noop': {
+                return Promise.resolve({
+                    runtime,
+                    available: true,
+                    authenticated: false,
+                    reason: 'noop runtime is always available.',
+                });
+            }
+            case 'local':
+            default: {
+                const ready = Boolean(normalized.token);
+                return Promise.resolve({
+                    runtime,
+                    available: ready,
+                    authenticated: ready,
+                    reason: ready ? 'SLACK_BOT_TOKEN is configured.' : 'SLACK_BOT_TOKEN is not configured.',
+                });
+            }
+        }
+    }
+}
+export const SlackClientFactory = SlackAdapterFactory;
+export function detectSlackRuntime(config = {}) {
+    return SlackAdapterFactory.detect(config);
+}
+export function createSlackAdapter(config = {}) {
+    return SlackAdapterFactory.create(config);
+}
+function nonEmpty(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function stringifyOutput(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'undefined')
+        return '';
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,62 @@
+import type { PostMessageOutput, PostMessageParams, ResolveChannelParams, ResolveUserParams, SlackAction, SlackActionName, SlackActionOutputMap, SlackActionParamsMap, SlackActionResult, SlackChannelSummary, SlackClientInterface, SlackResolvedMention, SlackRuntime, SlackRuntimeConfig, SlackRuntimeDetectionResult } from './types.js';
+/**
+ * High-level Slack primitive client.
+ */
+export declare class SlackClient {
+    private readonly adapterPromise;
+    constructor(config?: SlackRuntimeConfig);
+    /**
+     * Create a Slack client and eagerly resolve the local runtime.
+     * @param config - Slack runtime configuration.
+     * @returns Configured Slack client.
+     */
+    static create(config?: SlackRuntimeConfig): Promise<SlackClient>;
+    /**
+     * Inspect local runtime availability without creating a client.
+     * @param config - Slack runtime configuration.
+     * @returns Runtime detection details.
+     */
+    static detect(config?: SlackRuntimeConfig): Promise<SlackRuntimeDetectionResult>;
+    /**
+     * Detect the runtime that will be selected. Phase A always returns local.
+     * @param config - Slack runtime configuration.
+     * @returns Selected Slack runtime.
+     */
+    static detectRuntime(config?: SlackRuntimeConfig): Promise<SlackRuntime>;
+    /**
+     * Return the selected low-level adapter.
+     * @returns Slack adapter.
+     */
+    getAdapter(): Promise<SlackClientInterface>;
+    /**
+     * Return the selected runtime.
+     * @returns Slack runtime.
+     */
+    getRuntime(): Promise<SlackRuntime>;
+    /**
+     * Check whether the selected runtime is authenticated.
+     * @returns True when Slack auth succeeds.
+     */
+    isAuthenticated(): Promise<boolean>;
+    executeAction<Name extends SlackAction>(action: Name, params: SlackActionParamsMap[Name]): Promise<SlackActionResult<SlackActionOutputMap[Name]>>;
+    executeAction<TOutput = unknown>(action: SlackAction | SlackActionName, params?: unknown): Promise<SlackActionResult<TOutput>>;
+    /**
+     * Post a Slack message.
+     * @param params - Message parameters.
+     * @returns Posted message output.
+     */
+    postMessage(params: PostMessageParams): Promise<PostMessageOutput>;
+    /**
+     * Resolve a Slack user mention.
+     * @param params - User resolution parameters.
+     * @returns Resolved mention.
+     */
+    resolveUser(params: ResolveUserParams): Promise<SlackResolvedMention>;
+    /**
+     * Resolve a Slack channel reference.
+     * @param params - Channel resolution parameters.
+     * @returns Resolved channel.
+     */
+    resolveChannel(params: ResolveChannelParams): Promise<SlackChannelSummary>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;gBAEnD,MAAM,GAAE,kBAAuB;IAI3C;;;;OAIG;WACU,MAAM,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAM1E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIpF;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5E;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI3C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAIzC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC,aAAa,CAAC,IAAI,SAAS,WAAW,EACpC,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACjC,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,aAAa,CAAC,OAAO,GAAG,OAAO,EAC7B,MAAM,EAAE,WAAW,GAAG,eAAe,EACrC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IActC;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxE;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI3E;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAGjF"}

package/dist/client.js

@@ -0,0 +1,91 @@
+import { SlackAdapterFactory } from './adapter.js';
+/**
+ * High-level Slack primitive client.
+ */
+export class SlackClient {
+    adapterPromise;
+    constructor(config = {}) {
+        this.adapterPromise = SlackAdapterFactory.create(config);
+    }
+    /**
+     * Create a Slack client and eagerly resolve the local runtime.
+     * @param config - Slack runtime configuration.
+     * @returns Configured Slack client.
+     */
+    static async create(config = {}) {
+        const client = new SlackClient(config);
+        await client.getAdapter();
+        return client;
+    }
+    /**
+     * Inspect local runtime availability without creating a client.
+     * @param config - Slack runtime configuration.
+     * @returns Runtime detection details.
+     */
+    static detect(config = {}) {
+        return SlackAdapterFactory.detect(config);
+    }
+    /**
+     * Detect the runtime that will be selected. Phase A always returns local.
+     * @param config - Slack runtime configuration.
+     * @returns Selected Slack runtime.
+     */
+    static detectRuntime(config = {}) {
+        return SlackAdapterFactory.detectRuntime(config);
+    }
+    /**
+     * Return the selected low-level adapter.
+     * @returns Slack adapter.
+     */
+    getAdapter() {
+        return this.adapterPromise;
+    }
+    /**
+     * Return the selected runtime.
+     * @returns Slack runtime.
+     */
+    async getRuntime() {
+        return (await this.getAdapter()).getRuntime();
+    }
+    /**
+     * Check whether the selected runtime is authenticated.
+     * @returns True when Slack auth succeeds.
+     */
+    async isAuthenticated() {
+        return (await this.getAdapter()).isAuthenticated();
+    }
+    /**
+     * Execute any registered Slack primitive action by action name.
+     * @param action - Slack action name.
+     * @param params - Action parameters.
+     * @returns Action result.
+     */
+    async executeAction(action, params) {
+        return (await this.getAdapter()).executeAction(action, params);
+    }
+    /**
+     * Post a Slack message.
+     * @param params - Message parameters.
+     * @returns Posted message output.
+     */
+    async postMessage(params) {
+        return (await this.getAdapter()).postMessage(params);
+    }
+    /**
+     * Resolve a Slack user mention.
+     * @param params - User resolution parameters.
+     * @returns Resolved mention.
+     */
+    async resolveUser(params) {
+        return (await this.getAdapter()).resolveUser(params);
+    }
+    /**
+     * Resolve a Slack channel reference.
+     * @param params - Channel resolution parameters.
+     * @returns Resolved channel.
+     */
+    async resolveChannel(params) {
+        return (await this.getAdapter()).resolveChannel(params);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAmBnD;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,cAAc,CAAgC;IAE/D,YAAY,SAA6B,EAAE;QACzC,IAAI,CAAC,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAA6B,EAAE;QACjD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,SAA6B,EAAE;QAC3C,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,SAA6B,EAAE;QAClD,OAAO,mBAAmB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC;IACrD,CAAC;IAUD;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,MAAqC,EACrC,MAAgB;QAEhB,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,MAA4B;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF"}