@mastra/factory 0.4.0 → 0.5.0-alpha.1

package/dist/integrations/slack/integration.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `SlackIntegration` — Slack as a `FactoryIntegration`.
+ *
+ * Slack contributes two things to a factory: the chat channels that carry
+ * inbound messages into agent runs (`channels()`), and the browser-facing
+ * account-link routes that bind a Slack sender to a Mastra tenant (`routes()`).
+ * Both used to be assembled by hand in the deploy entry, which had to reach
+ * into the prepared agent controller by string key, resolve storage domains
+ * itself, mint its own state signer, and splice routes onto the factory's
+ * assembled server config. Implementing the integration interface instead means
+ * the factory does all of that the same way it already does for GitHub and
+ * Linear, and the entry's job shrinks to reading Slack's env vars once.
+ *
+ * Slack ships as a factory built-in alongside GitHub and Linear (it originally
+ * lived in `mastracode/web` to keep `@mastra/slack`/`chat` out of this package;
+ * the team reversed that so `create-factory` consumers get Slack channels out
+ * of the box). The integration interface remains open — third parties still add
+ * capabilities by implementing `FactoryIntegration` from outside the package.
+ */
+import type { ApiRoute } from '@mastra/core/server';
+import type { FactoryChannelsConfig, FactoryIntegration, IntegrationContext } from '../base.js';
+/**
+ * Slack app credentials, read from env ONCE by the deploy entry. `signingSecret`
+ * is required because the Slack adapter validates it at construction — an
+ * integration constructed without it would throw during `prepare()` rather than
+ * reporting itself unconfigured.
+ */
+export interface SlackIntegrationConfig {
+    /** Verifies inbound Slack request signatures. Required. */
+    signingSecret: string;
+    /** Bot token used to post replies and ephemeral cards. */
+    botToken?: string;
+    /**
+     * OAuth client credentials. Required for account linking: "Sign in with
+     * Slack" (OIDC) is the only flow that writes a link, so without these the
+     * settings surface reports `canConnect: false` and no sender can link.
+     */
+    clientId?: string;
+    clientSecret?: string;
+    /**
+     * HTTPS origin Slack redirects back to. Slack requires HTTPS, so locally this
+     * is the tunnel origin rather than the app's own public URL.
+     */
+    oidcRedirectBaseUrl?: string;
+    /** SPA origin the post-connect redirect returns to. */
+    uiOrigin?: string;
+}
+export declare class SlackIntegration implements FactoryIntegration {
+    #private;
+    readonly id = "slack";
+    /**
+     * The OIDC connect flow round-trips a signed `state` through Slack, so the
+     * replica handling the callback must be able to verify a state a different
+     * replica signed.
+     */
+    readonly requiresStableStateSigner = true;
+    constructor(config: SlackIntegrationConfig);
+    channels(ctx: IntegrationContext): FactoryChannelsConfig;
+    routes(ctx: IntegrationContext): ApiRoute[];
+    diagnostics(): Record<string, unknown>;
+}
+//# sourceMappingURL=integration.d.ts.map

package/dist/integrations/slack/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKhG;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAiB,YAAW,kBAAkB;;IACzD,QAAQ,CAAC,EAAE,WAAW;IACtB;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,QAAQ;gBAU9B,MAAM,EAAE,sBAAsB;IAS1C,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,qBAAqB;IAmBxD,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE;IAc3C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASvC"}

package/dist/integrations/slack/integration.js

@@ -0,0 +1,67 @@
+import { createSlackConnectRoutes } from "./connect-route.js";
+import { adaptSourceControlOwner, createSlackChannelsConfig } from "./slack.js";
+//#region src/integrations/slack/integration.ts
+var SlackIntegration = class {
+	id = "slack";
+	/**
+	* The OIDC connect flow round-trips a signed `state` through Slack, so the
+	* replica handling the callback must be able to verify a state a different
+	* replica signed.
+	*/
+	requiresStableStateSigner = true;
+	#config;
+	/**
+	* Whether `channels()` found a source-control owner on the context and wired
+	* repo-backed sessions. Set at the channels() attach path, which runs once at
+	* boot before diagnostics are served.
+	*/
+	#repoBackedSessions = false;
+	constructor(config) {
+		if (!config.signingSecret) throw new Error("SlackIntegration: 'signingSecret' is required — Slack cannot verify inbound requests without it.");
+		this.#config = config;
+	}
+	channels(ctx) {
+		const sourceControlOwner = ctx.storage.sourceControlOwner;
+		this.#repoBackedSessions = Boolean(sourceControlOwner);
+		return createSlackChannelsConfig({
+			slack: {
+				clientId: this.#config.clientId,
+				clientSecret: this.#config.clientSecret,
+				signingSecret: this.#config.signingSecret,
+				botToken: this.#config.botToken
+			},
+			accountLinks: ctx.storage.channelIdentity,
+			projects: ctx.storage.projects,
+			sourceControl: sourceControlOwner ? adaptSourceControlOwner(sourceControlOwner) : void 0,
+			workItems: ctx.rules?.workItems
+		});
+	}
+	routes(ctx) {
+		const { clientId, clientSecret, oidcRedirectBaseUrl, uiOrigin } = this.#config;
+		return createSlackConnectRoutes({
+			auth: ctx.auth,
+			accountLinks: ctx.storage.channelIdentity,
+			tenantStateSigner: ctx.stateSigner,
+			oidc: clientId && clientSecret && oidcRedirectBaseUrl ? {
+				clientId,
+				clientSecret,
+				redirectBaseUrl: oidcRedirectBaseUrl,
+				uiOrigin
+			} : void 0,
+			projects: ctx.storage.projects
+		});
+	}
+	diagnostics() {
+		const { clientId, clientSecret, botToken, oidcRedirectBaseUrl } = this.#config;
+		return {
+			configured: true,
+			botTokenConfigured: Boolean(botToken),
+			oidcConfigured: Boolean(clientId && clientSecret && oidcRedirectBaseUrl),
+			repoBackedSessions: this.#repoBackedSessions
+		};
+	}
+};
+//#endregion
+export { SlackIntegration };
+
+//# sourceMappingURL=integration.js.map

package/dist/integrations/slack/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","names":["#config","#repoBackedSessions"],"sources":["../../../src/integrations/slack/integration.ts"],"sourcesContent":["/**\n * `SlackIntegration` — Slack as a `FactoryIntegration`.\n *\n * Slack contributes two things to a factory: the chat channels that carry\n * inbound messages into agent runs (`channels()`), and the browser-facing\n * account-link routes that bind a Slack sender to a Mastra tenant (`routes()`).\n * Both used to be assembled by hand in the deploy entry, which had to reach\n * into the prepared agent controller by string key, resolve storage domains\n * itself, mint its own state signer, and splice routes onto the factory's\n * assembled server config. Implementing the integration interface instead means\n * the factory does all of that the same way it already does for GitHub and\n * Linear, and the entry's job shrinks to reading Slack's env vars once.\n *\n * Slack ships as a factory built-in alongside GitHub and Linear (it originally\n * lived in `mastracode/web` to keep `@mastra/slack`/`chat` out of this package;\n * the team reversed that so `create-factory` consumers get Slack channels out\n * of the box). The integration interface remains open — third parties still add\n * capabilities by implementing `FactoryIntegration` from outside the package.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\n\nimport type { FactoryChannelsConfig, FactoryIntegration, IntegrationContext } from '../base.js';\n\nimport { createSlackConnectRoutes } from './connect-route.js';\nimport { createSlackChannelsConfig, adaptSourceControlOwner } from './slack.js';\n\n/**\n * Slack app credentials, read from env ONCE by the deploy entry. `signingSecret`\n * is required because the Slack adapter validates it at construction — an\n * integration constructed without it would throw during `prepare()` rather than\n * reporting itself unconfigured.\n */\nexport interface SlackIntegrationConfig {\n  /** Verifies inbound Slack request signatures. Required. */\n  signingSecret: string;\n  /** Bot token used to post replies and ephemeral cards. */\n  botToken?: string;\n  /**\n   * OAuth client credentials. Required for account linking: \"Sign in with\n   * Slack\" (OIDC) is the only flow that writes a link, so without these the\n   * settings surface reports `canConnect: false` and no sender can link.\n   */\n  clientId?: string;\n  clientSecret?: string;\n  /**\n   * HTTPS origin Slack redirects back to. Slack requires HTTPS, so locally this\n   * is the tunnel origin rather than the app's own public URL.\n   */\n  oidcRedirectBaseUrl?: string;\n  /** SPA origin the post-connect redirect returns to. */\n  uiOrigin?: string;\n}\n\nexport class SlackIntegration implements FactoryIntegration {\n  readonly id = 'slack';\n  /**\n   * The OIDC connect flow round-trips a signed `state` through Slack, so the\n   * replica handling the callback must be able to verify a state a different\n   * replica signed.\n   */\n  readonly requiresStableStateSigner = true;\n\n  readonly #config: SlackIntegrationConfig;\n  /**\n   * Whether `channels()` found a source-control owner on the context and wired\n   * repo-backed sessions. Set at the channels() attach path, which runs once at\n   * boot before diagnostics are served.\n   */\n  #repoBackedSessions = false;\n\n  constructor(config: SlackIntegrationConfig) {\n    if (!config.signingSecret) {\n      throw new Error(\n        \"SlackIntegration: 'signingSecret' is required — Slack cannot verify inbound requests without it.\",\n      );\n    }\n    this.#config = config;\n  }\n\n  channels(ctx: IntegrationContext): FactoryChannelsConfig {\n    // Repo-backed sessions come from the factory's source-control owner\n    // (GitHub, when registered) — no config-level wiring by the entry.\n    const sourceControlOwner = ctx.storage.sourceControlOwner;\n    this.#repoBackedSessions = Boolean(sourceControlOwner);\n    return createSlackChannelsConfig({\n      slack: {\n        clientId: this.#config.clientId,\n        clientSecret: this.#config.clientSecret,\n        signingSecret: this.#config.signingSecret,\n        botToken: this.#config.botToken,\n      },\n      accountLinks: ctx.storage.channelIdentity,\n      projects: ctx.storage.projects,\n      sourceControl: sourceControlOwner ? adaptSourceControlOwner(sourceControlOwner) : undefined,\n      workItems: ctx.rules?.workItems,\n    });\n  }\n\n  routes(ctx: IntegrationContext): ApiRoute[] {\n    const { clientId, clientSecret, oidcRedirectBaseUrl, uiOrigin } = this.#config;\n    return createSlackConnectRoutes({\n      auth: ctx.auth,\n      accountLinks: ctx.storage.channelIdentity,\n      tenantStateSigner: ctx.stateSigner,\n      oidc:\n        clientId && clientSecret && oidcRedirectBaseUrl\n          ? { clientId, clientSecret, redirectBaseUrl: oidcRedirectBaseUrl, uiOrigin }\n          : undefined,\n      projects: ctx.storage.projects,\n    });\n  }\n\n  diagnostics(): Record<string, unknown> {\n    const { clientId, clientSecret, botToken, oidcRedirectBaseUrl } = this.#config;\n    return {\n      configured: true,\n      botTokenConfigured: Boolean(botToken),\n      oidcConfigured: Boolean(clientId && clientSecret && oidcRedirectBaseUrl),\n      repoBackedSessions: this.#repoBackedSessions,\n    };\n  }\n}\n"],"mappings":";;;AAsDA,IAAa,mBAAb,MAA4D;CAC1D,KAAc;;;;;;CAMd,4BAAqC;CAErC;;;;;;CAMA,sBAAsB;CAEtB,YAAY,QAAgC;EAC1C,IAAI,CAAC,OAAO,eACV,MAAM,IAAI,MACR,kGACF;EAEF,KAAKA,UAAU;CACjB;CAEA,SAAS,KAAgD;EAGvD,MAAM,qBAAqB,IAAI,QAAQ;EACvC,KAAKC,sBAAsB,QAAQ,kBAAkB;EACrD,OAAO,0BAA0B;GAC/B,OAAO;IACL,UAAU,KAAKD,QAAQ;IACvB,cAAc,KAAKA,QAAQ;IAC3B,eAAe,KAAKA,QAAQ;IAC5B,UAAU,KAAKA,QAAQ;GACzB;GACA,cAAc,IAAI,QAAQ;GAC1B,UAAU,IAAI,QAAQ;GACtB,eAAe,qBAAqB,wBAAwB,kBAAkB,IAAI,KAAA;GAClF,WAAW,IAAI,OAAO;EACxB,CAAC;CACH;CAEA,OAAO,KAAqC;EAC1C,MAAM,EAAE,UAAU,cAAc,qBAAqB,aAAa,KAAKA;EACvE,OAAO,yBAAyB;GAC9B,MAAM,IAAI;GACV,cAAc,IAAI,QAAQ;GAC1B,mBAAmB,IAAI;GACvB,MACE,YAAY,gBAAgB,sBACxB;IAAE;IAAU;IAAc,iBAAiB;IAAqB;GAAS,IACzE,KAAA;GACN,UAAU,IAAI,QAAQ;EACxB,CAAC;CACH;CAEA,cAAuC;EACrC,MAAM,EAAE,UAAU,cAAc,UAAU,wBAAwB,KAAKA;EACvE,OAAO;GACL,YAAY;GACZ,oBAAoB,QAAQ,QAAQ;GACpC,gBAAgB,QAAQ,YAAY,gBAAgB,mBAAmB;GACvE,oBAAoB,KAAKC;EAC3B;CACF;AACF"}

package/dist/integrations/slack/slack.d.ts

@@ -0,0 +1,273 @@
+import type { ChannelHandler, ChannelHandlers, ResolveResourceId, ResolveThreadId } from '@mastra/core/channels';
+import type { ChannelAccountLink, ChannelAccountLinkKey, ChannelIdentityStorage } from '../../storage/domains/channel-identity/base.js';
+import type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';
+import type { WorkItemsStorage } from '../../storage/domains/work-items/base.js';
+import type { FactoryChannelsConfig } from '../base.js';
+type HandlerThread = Parameters<ChannelHandler>[0];
+type HandlerMessage = Parameters<ChannelHandler>[1];
+/** Dependencies the Slack channel handlers close over, injected from the web entry. */
+interface SlackChannelDeps {
+    /**
+     * The factory's reverse-index store mapping a Slack sender to a Mastra
+     * tenant. When provided, inbound messages from an unlinked sender are not
+     * dispatched — the run only proceeds (with the sender's tenant stamped on
+     * the request context) once they've linked their account. Unlinked senders
+     * get an ephemeral "connect your account" card instead.
+     */
+    accountLinks?: ChannelIdentityStorage;
+    /**
+     * Factory projects domain. When provided (alongside `accountLinks`), a
+     * linked sender's run must also resolve to a Factory project before it
+     * dispatches: their link's default factory, else their tenant's only
+     * factory (stamped back onto the link), else an ephemeral "pick a default
+     * factory" card and no run. Unset → no factory routing (runs dispatch as
+     * before).
+     */
+    projects?: FactoryProjectsStorage;
+    /**
+     * Narrow source-control surface used to make new Slack threads repo-backed:
+     * when the sender is linked and their factory has a repository, the thread's
+     * resourceId becomes a Factory user-session id (repo cloned on a
+     * `slack/{threadTs}` branch) instead of the chat-only `channel:...` id.
+     * Absent (no source-control integration registered) → chat-only sessions as
+     * before.
+     */
+    sourceControl?: SlackSourceControl;
+    /**
+     * Factory work-items domain. When provided, a dispatched new-session thread
+     * (DM or mention) upserts a Work-board card in Building (`execute`) carrying
+     * the Slack thread as its external source and binding the repo-backed
+     * session. Best-effort — a failure never blocks the run. Unset → no card.
+     */
+    workItems?: WorkItemsStorage;
+}
+/**
+ * The slice of the source-control owner's storage the Slack wiring needs.
+ * Structural (not the storage types themselves) so slack.ts stays decoupled
+ * from the owning integration's module graph and tests can stub it.
+ */
+export interface SlackSourceControl {
+    /**
+     * Resolve the factory's linked repository — first repo on the factory's
+     * source-control connection, the same single-repo assumption the web kickoff
+     * makes.
+     */
+    resolveProjectRepository(args: {
+        orgId: string;
+        factoryProjectId: string;
+    }): Promise<{
+        projectRepositoryId: string;
+        baseBranch: string;
+    } | null>;
+    /** Look up an existing user session for a repo branch (idempotent reuse). */
+    getSessionForBranch(args: {
+        projectRepositoryId: string;
+        userId: string;
+        branch: string;
+    }): Promise<{
+        sessionId: string;
+    } | null>;
+    /** Create the durable user-session row the workspace factory materializes. */
+    createSession(args: {
+        projectRepositoryId: string;
+        orgId: string;
+        userId: string;
+        branch: string;
+        baseBranch: string;
+    }): Promise<{
+        sessionId: string;
+    }>;
+}
+/**
+ * Structural slice of the source-control owner's storage handle
+ * (`IntegrationContext.storage.sourceControlOwner`, a `SourceControlStorageHandle`)
+ * the adapter reads. Structural so slack.ts stays decoupled from the storage
+ * module graph and tests can stub it. The handle is bound during
+ * `factory.prepare()`; all access here is lazy (request time).
+ */
+interface SourceControlOwnerSlice {
+    integrationId: string;
+    connections: {
+        list(args: {
+            orgId: string;
+            factoryProjectId: string;
+        }): Promise<Array<{
+            id: string;
+            integrationId: string;
+        }>>;
+    };
+    projectRepositories: {
+        list(args: {
+            orgId: string;
+            connectionId: string;
+        }): Promise<Array<{
+            id: string;
+            repositoryId: string;
+            branch?: string | null;
+        }>>;
+    };
+    repositories: {
+        get(args: {
+            orgId: string;
+            id: string;
+        }): Promise<{
+            defaultBranch: string;
+        } | null>;
+    };
+    sessions: {
+        getForBranch(args: {
+            projectRepositoryId: string;
+            userId: string;
+            branch: string;
+        }): Promise<{
+            sessionId: string;
+        } | null>;
+        create(input: {
+            sessionId: string;
+            projectRepositoryId: string;
+            orgId: string;
+            userId: string;
+            branch: string;
+            baseBranch: string;
+        }): Promise<{
+            sessionId: string;
+        }>;
+    };
+}
+/**
+ * Adapt the source-control owner's storage handle into the
+ * {@link SlackSourceControl} surface. Nothing here is GitHub-specific — the
+ * owner is whichever integration owns source control, matched by its own
+ * `integrationId`. Repo resolution mirrors the factory's own
+ * `ensureFactoryRuleSession`: the owner's connection on the factory → its
+ * first linked repository → pinned branch or repo default as the base.
+ */
+export declare function adaptSourceControlOwner(owner: SourceControlOwnerSlice): SlackSourceControl;
+/** Outcome of the sender-link gate for one inbound message. */
+type LinkedSenderResult = 
+/** Gating not configured — dispatch as before account linking existed. */
+{
+    status: 'ungated';
+}
+/** Sender unlinked — Connect card posted (when possible), do not dispatch. */
+ | {
+    status: 'blocked';
+}
+/** Sender linked — their tenant plus the sender key the link lives under. */
+ | {
+    status: 'linked';
+    link: ChannelAccountLink;
+    key: ChannelAccountLinkKey;
+};
+/**
+ * Resolve the sender's account link, posting an ephemeral "connect your
+ * account" card (visible only to the sender) linking into the web UI's
+ * Slack-connect flow when they're unlinked.
+ */
+export declare function resolveLinkedSender({ thread, message, accountLinks, }: {
+    thread: HandlerThread;
+    message: HandlerMessage;
+    accountLinks?: ChannelIdentityStorage;
+}): Promise<LinkedSenderResult>;
+/** Outcome of factory routing for one linked sender's inbound message. */
+type FactoryRouteResult = 
+/** Factory routing not configured — dispatch without a factory. */
+{
+    status: 'ungated';
+}
+/** No factory resolved — prompt card posted (when possible), do not dispatch. */
+ | {
+    status: 'blocked';
+}
+/** The Factory project this sender's runs route to. */
+ | {
+    status: 'resolved';
+    factoryProjectId: string;
+    slackWorkItemsEnabled: boolean;
+};
+/**
+ * Decide which Factory project a linked sender's run belongs to:
+ *
+ * 1. The link's `defaultFactoryProjectId`, when it still exists (a stale id —
+ *    deleted factory — falls through as if unset).
+ * 2. Else, the tenant's only factory, stamped back onto the link so it shows
+ *    up (and stays editable) in Connected Accounts settings.
+ * 3. Else — zero or several factories — an ephemeral "pick a default factory"
+ *    card deep-linking to settings, and the run is blocked.
+ */
+export declare function resolveFactoryForLink({ thread, message, link, key, accountLinks, projects, }: {
+    thread: HandlerThread;
+    message: HandlerMessage;
+    link: ChannelAccountLink;
+    key: ChannelAccountLinkKey;
+    accountLinks: ChannelIdentityStorage;
+    projects?: FactoryProjectsStorage;
+}): Promise<FactoryRouteResult>;
+/**
+ * Resolve the resourceId for a NEW Slack channel thread. A linked sender whose
+ * factory has a repository gets a Factory user-session id — the controller
+ * session then materializes the repo sandbox via the factory's dynamic
+ * workspace (clone + PAT), the session shows up in the web Sessions list, and
+ * View Session deep-links land on the normal workspace route. Everything else
+ * (unlinked, unrouted, repo-less, or no source control) keeps the chat-only
+ * `defaultResourceId`.
+ *
+ * Pure lookups only — cards for unlinked/unrouted senders are the dispatch
+ * gate's job; this hook must never post.
+ */
+export declare function createChannelResourceIdResolver(deps: SlackChannelDeps): ResolveResourceId;
+/**
+ * Thread id for a NEW Slack channel thread. Repo-backed threads take the
+ * user-session id AS their thread id, matching the web convention
+ * (FactoryStartCoordinator seeds threads with threadId = sessionId) so
+ * `/workspaces/{sessionId}/threads/{sessionId}` resolves Slack-created
+ * sessions exactly like web-created ones — no `?resourceId=` override needed.
+ * Chat-only threads keep the default random id: their `channel:...`
+ * resourceId is a memory key, not a unique thread id.
+ */
+export declare const resolveChannelThreadId: ResolveThreadId;
+/**
+ * Upsert the Work-board card for a dispatched Slack-thread run. Keyed on the
+ * thread via `externalSource` — the work-items domain's unique
+ * `(factory_project_id, source_key)` index makes repeat messages reuse the
+ * same card, and `reuseMode: 'preserve'` keeps a card a human already dragged
+ * across stages untouched. The card lands in Building (`execute`) for every
+ * dispatched thread (DM or mention) — there is deliberately no per-origin
+ * stage split; smart routing is a follow-up.
+ *
+ * The session id / branch / threadId and the workspace deep-link are resolved
+ * by the caller (which already looked up the internal thread), so this helper
+ * just shapes and writes. Best-effort: the run is already dispatched, so a
+ * failure logs instead of throwing — work-item creation must never abort a Slack run.
+ */
+export declare function upsertThreadWorkItem({ workItems, thread, message, link, factoryProjectId, session, url, }: {
+    workItems: WorkItemsStorage;
+    thread: HandlerThread;
+    message: HandlerMessage;
+    link: ChannelAccountLink;
+    factoryProjectId: string;
+    /**
+     * The repo-backed Factory session to bind under the `chat` role, or
+     * `undefined` for a chat-only thread (no Factory session to bind).
+     */
+    session?: {
+        sessionId: string;
+        branch: string;
+        threadId: string;
+    };
+    /** Workspace deep-link to the running session; omitted when no public URL. */
+    url?: string;
+}): Promise<void>;
+export declare const createHandlers: (deps: SlackChannelDeps) => ChannelHandlers;
+/** Slack app credentials, passed in explicitly rather than read from env here. */
+interface SlackCredentials {
+    clientId?: string;
+    clientSecret?: string;
+    signingSecret: string;
+    botToken?: string;
+}
+export declare function createSlackChannelsConfig(deps: SlackChannelDeps & {
+    slack: SlackCredentials;
+}): FactoryChannelsConfig;
+export {};
+//# sourceMappingURL=slack.d.ts.map

package/dist/integrations/slack/slack.d.ts.map

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