managed-deepagents 0.4.0-dev.68 → 0.4.0-dev.69

package/dist/channels/slack/normalize.js

@@ -0,0 +1,320 @@
+/**
+ * Slack Events API verification and Phase 1 event normalization.
+ *
+ * These helpers are pure library primitives for the managed channel service.
+ * They do not perform HTTP I/O or durable enqueue.
+ */
+import { ChannelError } from "../errors.js";
+import { encodeSlackSourceThreadKey, slackGroupingId, } from "./source-thread.js";
+const REPLAY_WINDOW_SECONDS = 60 * 5;
+/**
+ * Verify a Slack request signature over the exact raw body bytes.
+ *
+ * Computes HMAC-SHA256 of `v0:{timestamp}:{raw_body}` and compares safely.
+ * Rejects timestamps older than five minutes.
+ */
+export async function verifySlackRequest(rawBody, headers, signingSecret, nowSeconds = Math.floor(Date.now() / 1000)) {
+    const timestamp = Number(headers.timestamp);
+    if (!Number.isFinite(timestamp)) {
+        throw new ChannelError("channel_invalid_signature", "missing or invalid Slack request timestamp");
+    }
+    if (Math.abs(nowSeconds - timestamp) > REPLAY_WINDOW_SECONDS) {
+        throw new ChannelError("channel_replay_rejected", "Slack request timestamp outside replay window");
+    }
+    if (!headers.signature || !headers.signature.startsWith("v0=")) {
+        throw new ChannelError("channel_invalid_signature", "missing or invalid Slack signature header");
+    }
+    const body = typeof rawBody === "string" ? rawBody : new TextDecoder().decode(rawBody);
+    const base = `v0:${headers.timestamp}:${body}`;
+    const expected = `v0=${await hmacSha256Hex(signingSecret, base)}`;
+    if (!constantTimeEquals(expected, headers.signature)) {
+        throw new ChannelError("channel_invalid_signature", "Slack signature verification failed");
+    }
+}
+/**
+ * Normalize a verified Slack Events API payload into a channel-neutral event.
+ *
+ * Filters bot/system/unsupported shapes and applies declarative trigger/filters.
+ */
+export function normalizeSlackEvent(input) {
+    const body = asRecord(input.body);
+    if (!body) {
+        return { status: "filtered", reason: "unsupported_payload" };
+    }
+    if (body.type === "url_verification") {
+        const challenge = body.challenge;
+        if (typeof challenge !== "string") {
+            return { status: "filtered", reason: "invalid_url_verification" };
+        }
+        return { status: "url_verification", challenge };
+    }
+    if (body.type !== "event_callback") {
+        return {
+            status: "filtered",
+            reason: "unsupported_envelope",
+            eventId: stringField(body, "event_id"),
+        };
+    }
+    const eventId = stringField(body, "event_id");
+    const apiAppId = stringField(body, "api_app_id");
+    if (apiAppId && apiAppId !== input.installation.apiAppId) {
+        return { status: "filtered", reason: "app_mismatch", eventId };
+    }
+    if (body.is_ext_shared_channel === true) {
+        if (!input.config.filters.allowSharedConversations) {
+            return {
+                status: "filtered",
+                reason: "shared_conversation_denied",
+                eventId,
+            };
+        }
+    }
+    const event = asRecord(body.event);
+    if (!event) {
+        return { status: "filtered", reason: "missing_event", eventId };
+    }
+    // Always filter bot/app messages in Phase 1.
+    if (event.bot_id || event.subtype === "bot_message") {
+        return { status: "filtered", reason: "bot_message", eventId };
+    }
+    if (input.installation.botUserId &&
+        stringField(event, "user") === input.installation.botUserId) {
+        return { status: "filtered", reason: "own_bot_message", eventId };
+    }
+    if (typeof event.subtype === "string" &&
+        event.subtype !== "" &&
+        event.subtype !== "file_share") {
+        return { status: "filtered", reason: `subtype_${event.subtype}`, eventId };
+    }
+    const trigger = resolveTrigger(event, input.isDirectMessageSurface === true);
+    if (!trigger || !input.config.on.includes(trigger)) {
+        return {
+            status: "filtered",
+            reason: trigger ? "trigger_disabled" : "unsupported_trigger",
+            eventId,
+        };
+    }
+    const conversationId = stringField(event, "channel");
+    const userId = stringField(event, "user");
+    const messageTs = stringField(event, "ts");
+    if (!conversationId || !userId || !messageTs) {
+        return { status: "filtered", reason: "missing_identity_fields", eventId };
+    }
+    if (!conversationAllowed(conversationId, input.config)) {
+        return { status: "filtered", reason: "conversation_filtered", eventId };
+    }
+    const eventTeamId = stringField(event, "team") ?? stringField(body, "team_id");
+    if (eventTeamId &&
+        eventTeamId !== input.installation.contextTeamId &&
+        eventTeamId !== input.installation.id) {
+        return { status: "filtered", reason: "workspace_mismatch", eventId };
+    }
+    const actorTeamId = resolveActorTeamId(body, event, input.installation);
+    if (!actorTeamId) {
+        return { status: "filtered", reason: "ambiguous_actor_namespace", eventId };
+    }
+    const actorId = `slack:${actorTeamId}:${userId}`;
+    if (!actorAllowed(actorId, input.config)) {
+        return { status: "filtered", reason: "actor_filtered", eventId };
+    }
+    const threadTs = stringField(event, "thread_ts");
+    const usesAppMentionGrouping = trigger === "app_mention" || trigger === "thread_reply";
+    const addressThreadId = usesAppMentionGrouping
+        ? (threadTs ?? messageTs)
+        : threadTs;
+    let text = typeof event.text === "string" ? event.text : "";
+    text = decodeSlackEscaping(text);
+    // When Slack dual-delivers message + app_mention for an @mention, drop the
+    // message path so app_mention owns the run.
+    if (trigger === "thread_reply" &&
+        input.config.on.includes("app_mention") &&
+        input.installation.botUserId &&
+        textMentionsBot(text, input.installation.botUserId)) {
+        return { status: "filtered", reason: "covered_by_app_mention", eventId };
+    }
+    if (trigger === "app_mention") {
+        text = applyMentionBehavior(text, input.config.mentionBehavior);
+    }
+    const groupingMode = usesAppMentionGrouping
+        ? input.config.conversation.appMention
+        : input.config.conversation.directMessage;
+    const groupingId = slackGroupingId(groupingMode, messageTs, threadTs);
+    const sourceThreadKey = encodeSlackSourceThreadKey({
+        installationKind: input.installation.kind,
+        installationId: input.installation.id,
+        contextTeamId: input.installation.contextTeamId,
+        conversationId,
+        mode: groupingMode,
+        groupingId,
+    });
+    const attachments = [];
+    const files = event.files;
+    if (Array.isArray(files)) {
+        for (const [index, file] of files.entries()) {
+            const record = asRecord(file);
+            if (!record)
+                continue;
+            attachments.push({
+                id: `slack-file:${stringField(record, "id") ?? index}`,
+                kind: inferAttachmentKind(stringField(record, "mimetype")),
+                name: stringField(record, "name") ?? undefined,
+                contentType: stringField(record, "mimetype") ?? undefined,
+                size: typeof record.size === "number" && Number.isFinite(record.size)
+                    ? record.size
+                    : undefined,
+            });
+        }
+    }
+    const message = {
+        id: messageTs,
+        text,
+        attachments,
+    };
+    const channelEvent = {
+        deliveryId: input.deliveryId,
+        ...(eventId ? { eventId } : {}),
+        type: trigger,
+        ...(typeof event.ts === "string"
+            ? {
+                occurredAt: slackTsToIso(event.ts),
+            }
+            : {}),
+        address: {
+            conversationId,
+            ...(addressThreadId ? { threadId: addressThreadId } : {}),
+        },
+        message,
+    };
+    const tenantId = input.installation.kind === "team"
+        ? `slack:${input.installation.id}`
+        : `slack:${input.installation.id}`;
+    return {
+        status: "accepted",
+        event: channelEvent,
+        actorId,
+        tenantId,
+        sourceThreadKey,
+        trigger,
+        groupingMode,
+    };
+}
+function resolveTrigger(event, isDirectMessageSurface) {
+    if (event.type === "app_mention") {
+        return "app_mention";
+    }
+    if (event.type === "message") {
+        const channelType = stringField(event, "channel_type");
+        if (isDirectMessageSurface || channelType === "im") {
+            return "direct_message";
+        }
+        // Channel/group (or unknown surface) replies in a thread.
+        if (stringField(event, "thread_ts")) {
+            return "thread_reply";
+        }
+    }
+    return undefined;
+}
+function textMentionsBot(text, botUserId) {
+    const escaped = botUserId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`<@${escaped}(?:\\|[^>]+)?>`, "i").test(text);
+}
+function resolveActorTeamId(body, event, installation) {
+    const fromEvent = stringField(event, "team");
+    if (fromEvent)
+        return fromEvent;
+    const fromBody = stringField(body, "team_id");
+    if (fromBody)
+        return fromBody;
+    if (installation.kind === "team") {
+        return installation.contextTeamId || installation.id;
+    }
+    // Enterprise installs need an unambiguous workspace context for the actor.
+    return installation.contextTeamId || undefined;
+}
+function conversationAllowed(conversationId, config) {
+    const include = config.filters.includeConversations;
+    const exclude = config.filters.excludeConversations;
+    if (include && include.length > 0 && !include.includes(conversationId)) {
+        return false;
+    }
+    if (exclude && exclude.includes(conversationId)) {
+        return false;
+    }
+    return true;
+}
+function actorAllowed(actorId, config) {
+    const include = config.filters.includeActors;
+    const exclude = config.filters.excludeActors;
+    if (include && include.length > 0 && !include.includes(actorId)) {
+        return false;
+    }
+    if (exclude && exclude.includes(actorId)) {
+        return false;
+    }
+    return true;
+}
+function applyMentionBehavior(text, behavior) {
+    if (behavior === "preserve") {
+        return text;
+    }
+    // Strip <@U…> / <@W…> / <@B…> mention tokens and collapse leftover whitespace.
+    return text
+        .replace(/<@[UWB][A-Z0-9]+(?:\|[^>]+)?>/gi, " ")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n[ \t]+/g, "\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+/** Decode Slack transport escaping (`&amp;` `&lt;` `&gt;`). */
+export function decodeSlackEscaping(text) {
+    // Decode `&lt;` / `&gt;` before `&amp;` so a literal `&amp;lt;` stays `&lt;`
+    // instead of cascading into `<` (CodeQL double-unescape).
+    return text
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
+function inferAttachmentKind(contentType) {
+    if (!contentType)
+        return "unknown";
+    if (contentType.startsWith("image/"))
+        return "image";
+    if (contentType.startsWith("audio/"))
+        return "audio";
+    if (contentType.startsWith("video/"))
+        return "video";
+    return "file";
+}
+function slackTsToIso(ts) {
+    const seconds = Number(ts);
+    if (!Number.isFinite(seconds))
+        return undefined;
+    return new Date(seconds * 1000).toISOString();
+}
+function asRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+async function hmacSha256Hex(secret, value) {
+    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(value));
+    return [...new Uint8Array(signature)]
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+function constantTimeEquals(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    let mismatch = 0;
+    for (let i = 0; i < a.length; i += 1) {
+        mismatch |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return mismatch === 0;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/channels/slack/normalize.js.map

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

package/dist/channels/slack/source-thread.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Versioned Slack source-thread key encoding.
+ *
+ * Format: `slack:v1:<base64url(JSON array)>` where the array is:
+ * `[installationKind, installationId, contextTeamId, conversationId, mode, groupingId]`
+ *
+ * Opaque provider IDs are never parsed with delimiter assumptions.
+ */
+export type SourceThreadMode = "thread" | "conversation" | "message";
+export type InstallationKind = "team" | "enterprise";
+export interface SlackSourceThreadParts {
+    installationKind: InstallationKind;
+    installationId: string;
+    contextTeamId: string;
+    conversationId: string;
+    mode: SourceThreadMode;
+    groupingId: string;
+}
+/**
+ * Encode a Slack source thread key. Array order is the canonical serialization;
+ * both runtimes share byte-level fixtures over this shape.
+ */
+export declare function encodeSlackSourceThreadKey(parts: SlackSourceThreadParts): string;
+/** Decode a `slack:v1:` source thread key, or return `undefined` if malformed. */
+export declare function decodeSlackSourceThreadKey(key: string): SlackSourceThreadParts | undefined;
+/**
+ * Resolve the MDA grouping id for a Slack conversation mapping mode.
+ *
+ * - `"thread"`: parent `thread_ts`, or the message's own `ts` for a new thread
+ * - `"conversation"`: constant `root` (conversation id is a separate segment)
+ * - `"message"`: message `ts`
+ */
+export declare function slackGroupingId(mode: SourceThreadMode, messageTs: string, threadTs?: string): string;
+//# sourceMappingURL=source-thread.d.ts.map

package/dist/channels/slack/source-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-thread.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/source-thread.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAWR;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,sBAAsB,GAAG,SAAS,CAuCpC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAQR"}

package/dist/channels/slack/source-thread.js

@@ -0,0 +1,92 @@
+/**
+ * Versioned Slack source-thread key encoding.
+ *
+ * Format: `slack:v1:<base64url(JSON array)>` where the array is:
+ * `[installationKind, installationId, contextTeamId, conversationId, mode, groupingId]`
+ *
+ * Opaque provider IDs are never parsed with delimiter assumptions.
+ */
+const SOURCE_THREAD_PREFIX = "slack:v1:";
+/**
+ * Encode a Slack source thread key. Array order is the canonical serialization;
+ * both runtimes share byte-level fixtures over this shape.
+ */
+export function encodeSlackSourceThreadKey(parts) {
+    const payload = [
+        parts.installationKind,
+        parts.installationId,
+        parts.contextTeamId,
+        parts.conversationId,
+        parts.mode,
+        parts.groupingId,
+    ];
+    const json = JSON.stringify(payload);
+    return `${SOURCE_THREAD_PREFIX}${base64UrlEncode(json)}`;
+}
+/** Decode a `slack:v1:` source thread key, or return `undefined` if malformed. */
+export function decodeSlackSourceThreadKey(key) {
+    if (!key.startsWith(SOURCE_THREAD_PREFIX)) {
+        return undefined;
+    }
+    try {
+        const json = base64UrlDecode(key.slice(SOURCE_THREAD_PREFIX.length));
+        const payload = JSON.parse(json);
+        if (!Array.isArray(payload) || payload.length !== 6) {
+            return undefined;
+        }
+        const [installationKind, installationId, contextTeamId, conversationId, mode, groupingId,] = payload;
+        if ((installationKind !== "team" && installationKind !== "enterprise") ||
+            typeof installationId !== "string" ||
+            typeof contextTeamId !== "string" ||
+            typeof conversationId !== "string" ||
+            (mode !== "thread" && mode !== "conversation" && mode !== "message") ||
+            typeof groupingId !== "string") {
+            return undefined;
+        }
+        return {
+            installationKind,
+            installationId,
+            contextTeamId,
+            conversationId,
+            mode,
+            groupingId,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the MDA grouping id for a Slack conversation mapping mode.
+ *
+ * - `"thread"`: parent `thread_ts`, or the message's own `ts` for a new thread
+ * - `"conversation"`: constant `root` (conversation id is a separate segment)
+ * - `"message"`: message `ts`
+ */
+export function slackGroupingId(mode, messageTs, threadTs) {
+    if (mode === "conversation") {
+        return "root";
+    }
+    if (mode === "message") {
+        return messageTs;
+    }
+    return threadTs ?? messageTs;
+}
+function base64UrlEncode(value) {
+    const bytes = new TextEncoder().encode(value);
+    let binary = "";
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary)
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+function base64UrlDecode(value) {
+    const padded = value + "=".repeat((4 - (value.length % 4)) % 4);
+    const binary = atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
+    const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}
+//# sourceMappingURL=source-thread.js.map

package/dist/channels/slack/source-thread.js.map

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

package/dist/channels/slack/transport.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Slack Web API transport for managed channel egress.
+ *
+ * Uses `fetch` against `https://slack.com/api/*` — no Slack SDK dependency.
+ * Credentials stay in process env / constructor args; they never appear on
+ * `runtime.channel`.
+ */
+import type { ChannelTransport } from "../runtime.js";
+/** Optional override so tests can point at a local mock Slack Web API. */
+export declare const SLACK_API_BASE_ENV = "SLACK_API_BASE";
+/** Default status string for Slack Assistants `assistant.threads.setStatus`. */
+export declare const DEFAULT_ASSISTANT_STATUS = "is thinking\u2026";
+/**
+ * Curated rotating loading strings shown by Slack while the indicator is active.
+ * Capped at 10 by Slack's API.
+ */
+export declare const DEFAULT_LOADING_MESSAGES: readonly string[];
+export interface SlackWebApiTransportOptions {
+    botToken: string;
+    /** Slack Web API base URL (default `https://slack.com/api`). */
+    apiBase?: string;
+    /** Optional fetch override for tests. */
+    fetch?: typeof fetch;
+}
+export interface SetSlackAssistantStatusOptions {
+    botToken: string;
+    channelId: string;
+    threadTs: string;
+    /** Status text; empty string clears the indicator. */
+    status?: string;
+    loadingMessages?: readonly string[];
+    apiBase?: string;
+    fetch?: typeof fetch;
+}
+/**
+ * Build a {@link ChannelTransport} backed by Slack `chat.postMessage` /
+ * `chat.update`.
+ */
+export declare function createSlackWebApiTransport(options: SlackWebApiTransportOptions): ChannelTransport;
+/**
+ * Set (or clear) Slack's Assistants thread status indicator.
+ *
+ * Wraps `assistant.threads.setStatus`. Failures are logged and never thrown —
+ * the indicator is a UX nicety, not a correctness requirement. Returns whether
+ * Slack accepted the update.
+ */
+export declare function setSlackAssistantStatus(options: SetSlackAssistantStatusOptions): Promise<boolean>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/channels/slack/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,sBAAiB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAWrD,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAsElB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,CAyClB"}