@inkeep/agents-work-apps 0.0.0-dev-20260219165156 → 0.0.0-dev-20260219204727

package/dist/github/mcp/auth.d.ts

@@ -1,7 +1,7 @@
-import * as hono0 from "hono";
+import * as hono1 from "hono";
 
 //#region src/github/mcp/auth.d.ts
-declare const githubMcpAuth: () => hono0.MiddlewareHandler<{
+declare const githubMcpAuth: () => hono1.MiddlewareHandler<{
   Variables: {
     toolId: string;
   };

package/dist/github/mcp/index.d.ts

@@ -1,11 +1,11 @@
 import { Hono } from "hono";
-import * as hono_types3 from "hono/types";
+import * as hono_types5 from "hono/types";
 
 //#region src/github/mcp/index.d.ts
 declare const app: Hono<{
   Variables: {
     toolId: string;
   };
-}, hono_types3.BlankSchema, "/">;
+}, hono_types5.BlankSchema, "/">;
 //#endregion
 export { app as default };

package/dist/github/mcp/schemas.d.ts

@@ -76,8 +76,8 @@ declare const ChangedFileSchema: z.ZodObject<{
   path: z.ZodString;
   status: z.ZodEnum<{
     added: "added";
-    modified: "modified";
     removed: "removed";
+    modified: "modified";
     renamed: "renamed";
     copied: "copied";
     changed: "changed";

package/dist/github/routes/setup.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
-import * as hono_types4 from "hono/types";
+import * as hono_types6 from "hono/types";
 
 //#region src/github/routes/setup.d.ts
-declare const app: Hono<hono_types4.BlankEnv, hono_types4.BlankSchema, "/">;
+declare const app: Hono<hono_types6.BlankEnv, hono_types6.BlankSchema, "/">;
 //#endregion
 export { app as default };

package/dist/github/routes/setup.js

@@ -1,7 +1,7 @@
 import { env } from "../../env.js";
 import { getLogger } from "../../logger.js";
-import { getStateSigningSecret, isStateSigningConfigured } from "../config.js";
 import runDbClient_default from "../../db/runDbClient.js";
+import { getStateSigningSecret, isStateSigningConfigured } from "../config.js";
 import { createAppJwt, determineStatus, fetchInstallationDetails, fetchInstallationRepositories } from "../installation.js";
 import { createInstallation, generateId, getInstallationByGitHubId, listProjectsMetadata, setProjectAccessMode, syncRepositories, updateInstallationStatusByGitHubId } from "@inkeep/agents-core";
 import { Hono } from "hono";

package/dist/github/routes/tokenExchange.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
-import * as hono_types6 from "hono/types";
+import * as hono_types3 from "hono/types";
 
 //#region src/github/routes/tokenExchange.d.ts
-declare const app: Hono<hono_types6.BlankEnv, hono_types6.BlankSchema, "/">;
+declare const app: Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
 //#endregion
 export { app as default };

package/dist/github/routes/tokenExchange.js

@@ -1,6 +1,6 @@
 import { getLogger } from "../../logger.js";
-import { isGitHubAppConfigured } from "../config.js";
 import runDbClient_default from "../../db/runDbClient.js";
+import { isGitHubAppConfigured } from "../config.js";
 import { generateInstallationAccessToken, lookupInstallationForRepo } from "../installation.js";
 import { validateOidcToken } from "../oidcToken.js";
 import { checkProjectRepositoryAccess, getInstallationByGitHubId } from "@inkeep/agents-core";

package/dist/github/routes/webhooks.js

@@ -1,6 +1,6 @@
 import { getLogger } from "../../logger.js";
-import { getWebhookSecret, isWebhookConfigured } from "../config.js";
 import runDbClient_default from "../../db/runDbClient.js";
+import { getWebhookSecret, isWebhookConfigured } from "../config.js";
 import { addRepositories, deleteInstallation, getInstallationByGitHubId, removeRepositories, updateInstallationStatusByGitHubId } from "@inkeep/agents-core";
 import { Hono } from "hono";
 import { createHmac, timingSafeEqual } from "node:crypto";

package/dist/slack/index.js

@@ -1,7 +1,7 @@
 import { clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createConnectSession, deleteWorkspaceInstallation, findWorkspaceConnectionByTeamId, getConnectionAccessToken, getSlackIntegrationId, getSlackNango, getWorkspaceDefaultAgentFromNango, listWorkspaceInstallations, setWorkspaceDefaultAgent, storeWorkspaceInstallation, updateConnectionMetadata } from "./services/nango.js";
 import { getChannelAgentConfig, getWorkspaceDefaultAgent } from "./services/events/utils.js";
-import { getBotTokenForTeam, setBotTokenForTeam } from "./services/workspace-tokens.js";
 import "./services/events/index.js";
+import { getBotTokenForTeam, setBotTokenForTeam } from "./services/workspace-tokens.js";
 import { dispatchSlackEvent } from "./dispatcher.js";
 import "./routes/oauth.js";
 import routes_default from "./routes/index.js";

package/dist/slack/services/dev-config.d.ts

@@ -0,0 +1,23 @@
+import { DefaultAgentConfig } from "./nango.js";
+
+//#region src/slack/services/dev-config.d.ts
+interface SlackDevConfig {
+  devId: string;
+  appId: string;
+  clientId: string;
+  clientSecret: string;
+  signingSecret: string;
+  appToken: string;
+  botToken: string;
+  teamId: string;
+  teamName: string;
+  configRefreshToken?: string;
+  metadata?: Record<string, string>;
+}
+declare function isSlackDevMode(): boolean;
+declare function loadSlackDevConfig(): SlackDevConfig | null;
+declare function getDevDefaultAgent(config: SlackDevConfig | null): DefaultAgentConfig | null;
+declare function resetDevConfigCache(): void;
+declare function saveSlackDevConfig(config: SlackDevConfig): boolean;
+//#endregion
+export { SlackDevConfig, getDevDefaultAgent, isSlackDevMode, loadSlackDevConfig, resetDevConfigCache, saveSlackDevConfig };

package/dist/slack/services/dev-config.js

@@ -0,0 +1,91 @@
+import { env } from "../../env.js";
+import { getLogger } from "../../logger.js";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, parse } from "node:path";
+
+//#region src/slack/services/dev-config.ts
+const logger = getLogger("slack-dev-config");
+const DEV_CONFIG_FILENAME = ".slack-dev.json";
+const CACHE_TTL_MS = 5e3;
+let cachedConfig = null;
+let cacheExpiresAt = 0;
+let resolvedConfigPath;
+function findDevConfigPath() {
+	let dir = process.cwd();
+	while (true) {
+		const candidate = join(dir, DEV_CONFIG_FILENAME);
+		if (existsSync(candidate)) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir || parse(dir).root === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+function getDevConfigPath() {
+	if (resolvedConfigPath !== void 0) return resolvedConfigPath;
+	resolvedConfigPath = findDevConfigPath();
+	return resolvedConfigPath;
+}
+let devModeChecked = false;
+let devModeResult = false;
+function isSlackDevMode() {
+	if (devModeChecked) return devModeResult;
+	devModeResult = env.ENVIRONMENT === "development" && getDevConfigPath() !== null;
+	devModeChecked = true;
+	return devModeResult;
+}
+function loadSlackDevConfig() {
+	if (cachedConfig && Date.now() < cacheExpiresAt) return cachedConfig;
+	const configPath = getDevConfigPath();
+	if (!configPath) return null;
+	try {
+		const raw = readFileSync(configPath, "utf-8");
+		cachedConfig = JSON.parse(raw);
+		cacheExpiresAt = Date.now() + CACHE_TTL_MS;
+		return cachedConfig;
+	} catch (error) {
+		logger.error({
+			error,
+			configPath
+		}, "Failed to read .slack-dev.json");
+		return null;
+	}
+}
+function getDevDefaultAgent(config) {
+	if (!config?.metadata?.default_agent) return null;
+	try {
+		return JSON.parse(config.metadata.default_agent);
+	} catch (error) {
+		logger.warn({
+			error,
+			rawValue: config.metadata.default_agent
+		}, "Failed to parse default_agent metadata as JSON - check .slack-dev.json format");
+		return null;
+	}
+}
+function resetDevConfigCache() {
+	cachedConfig = null;
+	cacheExpiresAt = 0;
+	resolvedConfigPath = void 0;
+	devModeChecked = false;
+	devModeResult = false;
+}
+function saveSlackDevConfig(config) {
+	const configPath = getDevConfigPath();
+	if (!configPath) return false;
+	try {
+		writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+		cachedConfig = config;
+		cacheExpiresAt = Date.now() + CACHE_TTL_MS;
+		return true;
+	} catch (error) {
+		logger.error({
+			error,
+			configPath
+		}, "Failed to write .slack-dev.json");
+		return false;
+	}
+}
+
+//#endregion
+export { getDevDefaultAgent, isSlackDevMode, loadSlackDevConfig, resetDevConfigCache, saveSlackDevConfig };

package/dist/slack/services/events/app-mention.js

@@ -5,7 +5,6 @@ import { SlackStrings } from "../../i18n/strings.js";
 import { getSlackChannelInfo, getSlackClient, getSlackUserInfo, postMessageInThread } from "../client.js";
 import { checkIfBotThread, classifyError, findCachedUserMapping, formatChannelContext, generateSlackConversationId, getThreadContext, getUserFriendlyErrorMessage, resolveChannelAgentConfig, timedOp } from "./utils.js";
 import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, setSpanWithError, tracer } from "../../tracer.js";
-import { getBotTokenForTeam } from "../workspace-tokens.js";
 import { streamAgentResponse } from "./streaming.js";
 import { signSlackUserToken } from "@inkeep/agents-core";
 
@@ -60,13 +59,12 @@ async function handleAppMention(params) {
 			label: "workspace connection lookup",
 			context: { teamId }
 		});
-		const botToken = workspaceConnection?.botToken || getBotTokenForTeam(teamId) || env.SLACK_BOT_TOKEN;
-		if (!botToken) {
+		if (!workspaceConnection?.botToken) {
 			logger.error({ teamId }, "No bot token available — cannot respond to @mention");
 			span.end();
 			return;
 		}
-		const tenantId = workspaceConnection?.tenantId;
+		const { botToken, tenantId } = workspaceConnection;
 		if (!tenantId) {
 			logger.error({ teamId }, "Workspace connection has no tenantId — workspace may need reinstall");
 			await getSlackClient(botToken).chat.postEphemeral({

package/dist/slack/services/events/utils.d.ts

@@ -8,9 +8,9 @@ import { AgentOption } from "../modals.js";
  * Called on every @mention and /inkeep command — caching avoids redundant DB queries.
  */
 declare function findCachedUserMapping(tenantId: string, slackUserId: string, teamId: string, clientId?: string): Promise<{
-  id: string;
   createdAt: string;
   updatedAt: string;
+  id: string;
   tenantId: string;
   clientId: string;
   slackUserId: string;

package/dist/slack/services/index.js

@@ -5,12 +5,12 @@ import { checkUserIsChannelMember, getSlackChannelInfo, getSlackChannels, getSla
 import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
 import { buildAgentSelectorModal, buildFollowUpModal, buildMessageShortcutModal } from "./modals.js";
 import { handleAgentPickerCommand, handleCommand, handleHelpCommand, handleLinkCommand, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand } from "./commands/index.js";
-import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
 import { streamAgentResponse } from "./events/streaming.js";
 import { handleAppMention } from "./events/app-mention.js";
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal } from "./events/block-actions.js";
 import { handleFollowUpSubmission, handleModalSubmission } from "./events/modal-submission.js";
 import "./events/index.js";
 import { parseSlackCommandBody, parseSlackEventBody, verifySlackRequest } from "./security.js";
+import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
 
 export { SlackErrorType, buildAgentSelectorModal, buildConversationResponseBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage, deleteWorkspaceInstallation, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, findWorkspaceConnectionByTeamId, generateSlackConversationId, getAgentConfigSources, getBotTokenForTeam, getChannelAgentConfig, getConnectionAccessToken, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackIntegrationId, getSlackNango, getSlackTeamInfo, getSlackUserInfo, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, getWorkspaceDefaultAgentFromNango, handleAgentPickerCommand, handleAppMention, handleCommand, handleFollowUpSubmission, handleHelpCommand, handleLinkCommand, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };

package/dist/slack/services/nango.d.ts

@@ -30,6 +30,8 @@ interface SlackWorkspaceConnection {
 /**
  * Find a workspace connection by Slack team ID.
  * Uses PostgreSQL first (O(1)) with in-memory caching, then falls back to Nango.
+ * In development mode with .slack-dev.json present, returns a local connection
+ * built from the dev config file instead of hitting Nango.
  *
  * Performance: This function is called on every @mention and command.
  * The PostgreSQL-first approach with caching provides O(1) lookups.

package/dist/slack/services/nango.js

@@ -1,6 +1,7 @@
 import { env } from "../../env.js";
 import { getLogger } from "../../logger.js";
 import runDbClient_default from "../../db/runDbClient.js";
+import { getDevDefaultAgent, isSlackDevMode, loadSlackDevConfig, saveSlackDevConfig } from "./dev-config.js";
 import { findWorkAppSlackWorkspaceBySlackTeamId } from "@inkeep/agents-core";
 import { Nango } from "@nangohq/node";
 
@@ -78,6 +79,10 @@ function getSlackIntegrationId() {
 	return env.NANGO_SLACK_INTEGRATION_ID || "slack-agent";
 }
 async function createConnectSession(params) {
+	if (isSlackDevMode()) {
+		logger.debug({}, "Skipping Nango connect session in dev mode");
+		return null;
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -105,6 +110,7 @@ async function createConnectSession(params) {
 	}
 }
 async function getConnectionAccessToken(connectionId) {
+	if (isSlackDevMode()) return loadSlackDevConfig()?.botToken ?? null;
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -117,9 +123,27 @@ async function getConnectionAccessToken(connectionId) {
 		return null;
 	}
 }
+function buildDevWorkspaceConnection(devConfig, teamId) {
+	const connection = {
+		connectionId: `dev:${teamId}`,
+		teamId,
+		teamName: devConfig.teamName || "dev",
+		botToken: devConfig.botToken,
+		tenantId: "default",
+		defaultAgent: getDevDefaultAgent(devConfig) ?? void 0
+	};
+	evictWorkspaceCache();
+	workspaceConnectionCache.set(teamId, {
+		connection,
+		expiresAt: Date.now() + CACHE_TTL_MS
+	});
+	return connection;
+}
 /**
 * Find a workspace connection by Slack team ID.
 * Uses PostgreSQL first (O(1)) with in-memory caching, then falls back to Nango.
+* In development mode with .slack-dev.json present, returns a local connection
+* built from the dev config file instead of hitting Nango.
 *
 * Performance: This function is called on every @mention and command.
 * The PostgreSQL-first approach with caching provides O(1) lookups.
@@ -130,6 +154,15 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 		logger.debug({ teamId }, "Workspace connection cache hit");
 		return cached.connection;
 	}
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (devConfig) {
+			logger.debug({ teamId }, "Using .slack-dev.json for workspace connection");
+			return buildDevWorkspaceConnection(devConfig, teamId);
+		}
+		logger.debug({ teamId }, "No .slack-dev.json found returning null");
+		return null;
+	}
 	try {
 		const dbWorkspace = await findWorkAppSlackWorkspaceBySlackTeamId(runDbClient_default)(teamId);
 		if (dbWorkspace?.nangoConnectionId) {
@@ -155,7 +188,7 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 			}
 		}
 		logger.debug({ teamId }, "PostgreSQL lookup failed, falling back to Nango iteration");
-		return findWorkspaceConnectionByTeamIdFromNango(teamId);
+		return await findWorkspaceConnectionByTeamIdFromNango(teamId);
 	} catch (error) {
 		logger.error({
 			error,
@@ -165,6 +198,7 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 	}
 }
 async function getWorkspaceDefaultAgentFromNangoByConnectionId(connectionId) {
+	if (isSlackDevMode()) return getDevDefaultAgent(loadSlackDevConfig());
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -234,10 +268,23 @@ function clearWorkspaceConnectionCache(teamId) {
 	else workspaceConnectionCache.clear();
 }
 async function updateConnectionMetadata(connectionId, metadata) {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return false;
+		devConfig.metadata = {
+			...devConfig.metadata,
+			...metadata
+		};
+		return saveSlackDevConfig(devConfig);
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
-		await nango.updateMetadata(integrationId, connectionId, metadata);
+		const lastUpdatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		await nango.updateMetadata(integrationId, connectionId, {
+			...metadata,
+			last_updated_at: lastUpdatedAt
+		});
 		return true;
 	} catch (error) {
 		logger.error({
@@ -248,6 +295,17 @@ async function updateConnectionMetadata(connectionId, metadata) {
 	}
 }
 async function setWorkspaceDefaultAgent(teamId, defaultAgent) {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return false;
+		devConfig.metadata = {
+			...devConfig.metadata,
+			default_agent: defaultAgent ? JSON.stringify(defaultAgent) : ""
+		};
+		const saved = saveSlackDevConfig(devConfig);
+		if (saved) clearWorkspaceConnectionCache(teamId);
+		return saved;
+	}
 	try {
 		const workspace = await findWorkspaceConnectionByTeamId(teamId);
 		if (!workspace) {
@@ -266,6 +324,7 @@ async function setWorkspaceDefaultAgent(teamId, defaultAgent) {
 	}
 }
 async function getWorkspaceDefaultAgentFromNango(teamId) {
+	if (isSlackDevMode()) return getDevDefaultAgent(loadSlackDevConfig());
 	try {
 		return (await findWorkspaceConnectionByTeamId(teamId))?.defaultAgent || null;
 	} catch (error) {
@@ -294,6 +353,13 @@ async function storeWorkspaceInstallation(data) {
 		teamId: data.teamId,
 		enterpriseId: data.enterpriseId
 	});
+	if (isSlackDevMode()) {
+		logger.debug({ connectionId }, "Skipping Nango store in dev mode");
+		return {
+			connectionId: `dev:${data.teamId}`,
+			success: true
+		};
+	}
 	try {
 		const integrationId = getSlackIntegrationId();
 		const secretKey = env.NANGO_SLACK_SECRET_KEY || env.NANGO_SECRET_KEY;
@@ -406,6 +472,18 @@ async function storeWorkspaceInstallation(data) {
 * List all workspace installations from Nango.
 */
 async function listWorkspaceInstallations() {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return [];
+		return [{
+			connectionId: `dev:${devConfig.teamId}`,
+			teamId: devConfig.teamId,
+			teamName: devConfig.teamName,
+			botToken: devConfig.botToken,
+			tenantId: "default",
+			defaultAgent: getDevDefaultAgent(devConfig) ?? void 0
+		}];
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -445,6 +523,10 @@ async function listWorkspaceInstallations() {
 * Delete a workspace installation from Nango.
 */
 async function deleteWorkspaceInstallation(connectionId) {
+	if (isSlackDevMode()) {
+		logger.debug({ connectionId }, "Skipping Nango delete in dev mode");
+		return true;
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-work-apps",
-  "version": "0.0.0-dev-20260219165156",
+  "version": "0.0.0-dev-20260219204727",
   "description": "First party integrations for Inkeep Agents",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -33,7 +33,7 @@
     "jose": "^6.1.0",
     "minimatch": "^10.1.1",
     "slack-block-builder": "^2.8.0",
-    "@inkeep/agents-core": "0.0.0-dev-20260219165156"
+    "@inkeep/agents-core": "0.0.0-dev-20260219204727"
   },
   "peerDependencies": {
     "@hono/zod-openapi": "^1.1.5",