[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_342":343,"_344":345},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_74":235,"_40":-7,"_236":-5,"_17":237,"_238":239,"_240":241,"_242":243,"_244":245,"_91":-5,"_246":247,"_248":249,"_250":48,"_251":252,"_253":26,"_254":-5,"_255":-5,"_256":257},"routes/_app.x.$handle.$name.compare.$branch",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":-5},"handle","pmillspaugh","name","townie","branchName","main","project",{"_32":58,"_13":14,"_34":194,"_46":-5,"_195":48,"_49":50,"_196":50,"_197":198,"_199":200,"_201":202,"_203":-5,"_204":48,"_205":-5,"_206":-5,"_207":208,"_52":53,"_209":-5,"_210":-5,"_211":-5,"_212":-5,"_213":214,"_215":214,"_216":217,"_218":217,"_219":217,"_220":214,"_221":214,"_222":223,"_224":225,"_226":28,"_47":48},"ahead",21,"behind",15,"diff",{"_63":64,"_65":66,"_67":68},"hasChanges",true,"sourceBranch",{"_40":56,"_13":16,"_32":57,"_38":58,"_42":33,"_43":59,"_60":50,"_61":39,"_62":53,"_54":14,"_51":12},"targetBranch",{"_32":33,"_34":35,"_36":37,"_13":16,"_38":39,"_40":41,"_42":-5,"_43":-5,"_44":45,"_46":-5,"_47":48,"_49":50,"_51":12,"_52":53,"_54":55},"pull","id","30974772-0dab-11f1-9c72-42dde27851f2","createdAt",["D",1771516433093],"updatedAt",["D",1778182283784],"projectId","30970370-0dab-11f1-9c72-42dde27851f2","version",207,"forkedBranchId","forkedBranchVersion","lockfileKey","1778182365861-esm.town_v_pmillspaugh_duck@207-main","deletedAt","isOwned",false,"privacy","public","userHandle","orgId","631c5cff-7089-4994-8427-c7580df789cd","projectName","duck",22,"95e003ac-127f-11f1-8493-42dde27851f2","95da4390-127f-11f1-8493-42dde27851f2",192,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","added",[184],"deleted",[],"modified",[69,70,71,72,73],{"_74":167,"_76":168,"_78":169},{"_74":149,"_76":150,"_78":151},{"_74":130,"_76":131,"_78":132},{"_74":107,"_76":108,"_78":109},{"_74":75,"_76":77,"_78":79},"path","prompt.md","targetFile",{"_32":99,"_13":75,"_81":100,"_83":-5,"_84":33,"_85":101,"_87":48,"_34":102,"_40":103,"_90":91,"_92":104,"_65":48,"_94":-5,"_95":-7,"_74":105,"_97":106},"sourceFile",{"_32":80,"_13":75,"_81":82,"_83":-5,"_84":57,"_85":86,"_87":26,"_34":88,"_40":89,"_90":91,"_92":93,"_65":48,"_94":-5,"_95":-7,"_74":96,"_97":98},"57b06156-1281-11f1-a326-42dde27851f2","fileId","019c9642-6a83-73c7-ab5a-80ac0e4a14b1","parentId","branchId","branchVersion",4,"latest",["D",1772048215635],1,"fileType","file","content","You are a Slack agent named \"Townie\" with access to Val Town via the Val Town\nMCP server.\n\n- Do not tag users.\n- Keep your responses concise and to the point.\n- Use emoji sparingly. I mean it.","label","children",[75],"contentHash","437dae41f728cc427dd0fb1748fd1c3ae1c06d2eec809aa9048833647c466a38","d20111e8-11a1-11f1-9939-42dde27851f2","5dcc9270-11a1-11f1-876b-42dde27851f2",148,["D",1771952213573],3,"You are a Slack agent with access to Val Town via the Val Town MCP server.\n\n- Do not tag users.\n- Keep your responses concise and to the point.\n- Use emoji sparingly. I mean it.",[75],"ed3b3f315904a804dae08a0dfcf39d7184305baff0a019dcdced4a2bf9084080","lib/slack-utils.ts",{"_32":121,"_13":111,"_81":122,"_83":123,"_84":33,"_85":124,"_87":48,"_34":125,"_40":126,"_90":116,"_92":127,"_65":48,"_94":-5,"_95":-7,"_74":128,"_97":129},{"_32":110,"_13":111,"_81":112,"_83":113,"_84":57,"_85":114,"_87":26,"_34":115,"_40":89,"_90":116,"_92":117,"_65":48,"_94":-5,"_95":-7,"_74":118,"_97":119},"c1cd018e-1281-11f1-85b3-42dde27851f2","slack-utils.ts","019c9642-6a83-73c7-ab5a-73dc8704aea8","019c9642-6a83-73c7-ab5a-77dfc27f3e3a",6,["D",1772048393657],"script","import { WebClient } from \"npm:@slack/web-api@7.14.1\";\nimport { ModelMessage } from \"npm:ai@6.0.92\";\n\nconst signingSecret = Deno.env.get(\"SLACK_SIGNING_SECRET\")!;\n\nexport const client = new WebClient(Deno.env.get(\"SLACK_BOT_TOKEN\"));\n\n// See https://api.slack.com/authentication/verifying-requests-from-slack\nexport async function isValidSlackRequest({\n request,\n rawBody,\n}: {\n request: Request;\n rawBody: string;\n}) {\n const timestamp = request.headers.get(\"X-Slack-Request-Timestamp\");\n const slackSignature = request.headers.get(\"X-Slack-Signature\");\n\n if (!timestamp || !slackSignature) {\n console.log(\"Missing timestamp or signature\");\n return false;\n }\n\n // Prevent replay attacks on the order of 5 minutes\n if (Math.abs(Date.now() / 1000 - parseInt(timestamp)) > 60 * 5) {\n console.log(\"Timestamp out of range\");\n return false;\n }\n\n const encoder = new TextEncoder();\n const base = `v0:${timestamp}:${rawBody}`;\n\n const key = await crypto.subtle.importKey(\n \"raw\",\n encoder.encode(signingSecret),\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n\n const signature = await crypto.subtle.sign(\n \"HMAC\",\n key,\n encoder.encode(base),\n );\n\n const hmacHex = Array.from(new Uint8Array(signature))\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n const computedSignature = encoder.encode(`v0=${hmacHex}`);\n const expectedSignature = encoder.encode(slackSignature);\n\n // Prevent timing attacks with constant-time comparison\n if (computedSignature.length !== expectedSignature.length) return false;\n let result = 0;\n for (let i = 0; i < computedSignature.length; i++) {\n result |= computedSignature[i] ^ expectedSignature[i];\n }\n return result === 0;\n}\n\nexport const verifyRequest = async ({\n requestType,\n request,\n rawBody,\n}: {\n requestType: string;\n request: Request;\n rawBody: string;\n}) => {\n const validRequest = await isValidSlackRequest({ request, rawBody });\n if (!validRequest || requestType !== \"event_callback\") {\n throw new Error(\"Invalid request\");\n }\n};\n\nexport const updateStatus = async (\n { channel, thread_ts, status }: {\n channel: string;\n thread_ts: string;\n status: string;\n },\n) => {\n await client.assistant.threads.setStatus({\n channel_id: channel,\n thread_ts: thread_ts,\n status: status,\n loading_messages: [\n \"combobulating...\",\n \"crunching...\",\n \"computing...\",\n \"compiling...\",\n \"calculating...\",\n \"cycling...\",\n \"compressing...\",\n \"clicking...\",\n \"clocking...\",\n \"clucking...\",\n ],\n });\n};\n\nexport const updateThreadTitle = async (\n { channel, thread_ts, title }: {\n channel: string;\n thread_ts: string;\n title: string;\n },\n) => {\n await client.assistant.threads.setTitle({\n channel_id: channel,\n thread_ts: thread_ts,\n title: title,\n });\n};\n\nexport async function getThread(\n channel_id: string,\n thread_ts: string,\n botUserId: string,\n): Promise {\n const { messages } = await client.conversations.replies({\n channel: channel_id,\n ts: thread_ts,\n limit: 50,\n });\n\n if (!messages) throw new Error(\"No messages found in thread\");\n\n const result = messages\n .map((message) => {\n const isBot = !!message.bot_id;\n if (!message.text) return null;\n\n // For app mentions, remove the mention prefix\n // For IM messages, keep the full text\n let content = message.text;\n if (!isBot && content.includes(`<@${botUserId}>`)) {\n content = content.replace(`<@${botUserId}> `, \"\");\n }\n\n return {\n role: isBot ? \"assistant\" : \"user\",\n content: content,\n } as ModelMessage;\n })\n .filter((msg): msg is ModelMessage => msg !== null);\n\n return result;\n}\n\nexport const getBotId = async () => {\n const { user_id: botUserId } = await client.auth.test();\n\n if (!botUserId) {\n throw new Error(\"botUserId is undefined\");\n }\n return botUserId;\n};",[120,111],"276bf106bbd634b98b2b0a722d5c7d4527bc6ee2d7ee7c12aa9bdf35d52efb63","lib","669ea896-11a8-11f1-9583-42dde27851f2","1a82383e-0dbf-11f1-b208-42dde27851f2","53baa4f8-0dae-11f1-a141-42dde27851f2",166,["D",1771955039882],13,"import { WebClient } from \"npm:@slack/web-api@7.14.1\";\nimport { ModelMessage } from \"npm:ai@6.0.92\";\n\nconst signingSecret = Deno.env.get(\"SLACK_SIGNING_SECRET\")!;\n\nexport const client = new WebClient(Deno.env.get(\"SLACK_BOT_TOKEN\"));\n\n// See https://api.slack.com/authentication/verifying-requests-from-slack\nexport async function isValidSlackRequest({\n request,\n rawBody,\n}: {\n request: Request;\n rawBody: string;\n}) {\n const timestamp = request.headers.get(\"X-Slack-Request-Timestamp\");\n const slackSignature = request.headers.get(\"X-Slack-Signature\");\n\n if (!timestamp || !slackSignature) {\n console.log(\"Missing timestamp or signature\");\n return false;\n }\n\n // Prevent replay attacks on the order of 5 minutes\n if (Math.abs(Date.now() / 1000 - parseInt(timestamp)) > 60 * 5) {\n console.log(\"Timestamp out of range\");\n return false;\n }\n\n const encoder = new TextEncoder();\n const base = `v0:${timestamp}:${rawBody}`;\n\n const key = await crypto.subtle.importKey(\n \"raw\",\n encoder.encode(signingSecret),\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n\n const signature = await crypto.subtle.sign(\n \"HMAC\",\n key,\n encoder.encode(base),\n );\n\n const hmacHex = Array.from(new Uint8Array(signature))\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n const computedSignature = encoder.encode(`v0=${hmacHex}`);\n const expectedSignature = encoder.encode(slackSignature);\n\n // Prevent timing attacks with constant-time comparison\n if (computedSignature.length !== expectedSignature.length) return false;\n let result = 0;\n for (let i = 0; i < computedSignature.length; i++) {\n result |= computedSignature[i] ^ expectedSignature[i];\n }\n return result === 0;\n}\n\nexport const verifyRequest = async ({\n requestType,\n request,\n rawBody,\n}: {\n requestType: string;\n request: Request;\n rawBody: string;\n}) => {\n const validRequest = await isValidSlackRequest({ request, rawBody });\n if (!validRequest || requestType !== \"event_callback\") {\n throw new Error(\"Invalid request\");\n }\n};\n\nexport const updateStatus = async (\n { channel, thread_ts, status }: {\n channel: string;\n thread_ts: string;\n status: string;\n },\n) => {\n await client.assistant.threads.setStatus({\n channel_id: channel,\n thread_ts: thread_ts,\n status: status,\n loading_messages: [\n \"quacking...\",\n \"flapping...\",\n \"waddling...\",\n \"splashing...\",\n \"ruffling...\",\n \"paddling...\",\n \"preening...\",\n \"plucking...\",\n \"chirping...\",\n \"bobbling...\",\n ],\n });\n};\n\nexport const updateThreadTitle = async (\n { channel, thread_ts, title }: {\n channel: string;\n thread_ts: string;\n title: string;\n },\n) => {\n await client.assistant.threads.setTitle({\n channel_id: channel,\n thread_ts: thread_ts,\n title: title,\n });\n};\n\nexport async function getThread(\n channel_id: string,\n thread_ts: string,\n botUserId: string,\n): Promise {\n const { messages } = await client.conversations.replies({\n channel: channel_id,\n ts: thread_ts,\n limit: 50,\n });\n\n if (!messages) throw new Error(\"No messages found in thread\");\n\n const result = messages\n .map((message) => {\n const isBot = !!message.bot_id;\n if (!message.text) return null;\n\n // For app mentions, remove the mention prefix\n // For IM messages, keep the full text\n let content = message.text;\n if (!isBot && content.includes(`<@${botUserId}>`)) {\n content = content.replace(`<@${botUserId}> `, \"\");\n }\n\n return {\n role: isBot ? \"assistant\" : \"user\",\n content: content,\n } as ModelMessage;\n })\n .filter((msg): msg is ModelMessage => msg !== null);\n\n return result;\n}\n\nexport const getBotId = async () => {\n const { user_id: botUserId } = await client.auth.test();\n\n if (!botUserId) {\n throw new Error(\"botUserId is undefined\");\n }\n return botUserId;\n};",[120,111],"a175d0be2fe8829a82b7be135ef3d4e4352b74c32e179b19f603b567e1cb9536","lib/handle-thread-started.ts",{"_32":142,"_13":134,"_81":143,"_83":123,"_84":33,"_85":144,"_87":48,"_34":145,"_40":86,"_90":116,"_92":146,"_65":48,"_94":-5,"_95":-7,"_74":147,"_97":148},{"_32":133,"_13":134,"_81":135,"_83":113,"_84":57,"_85":136,"_87":26,"_34":137,"_40":138,"_90":116,"_92":139,"_65":48,"_94":-5,"_95":-7,"_74":140,"_97":141},"2d206c5e-128d-11f1-8bce-42dde27851f2","handle-thread-started.ts","019c9642-6a83-73c7-ab5a-6e7ee1234283",14,["D",1772053298180],2,"import type { AssistantThreadStartedEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client } from \"./slack-utils.ts\";\n\nexport async function handleThreadStarted(\n event: AssistantThreadStartedEvent,\n) {\n const { channel_id, thread_ts } = event.assistant_thread;\n console.log(`Thread started: ${channel_id} ${thread_ts}`);\n console.log(JSON.stringify(event));\n\n await client.chat.postMessage({\n channel: channel_id,\n thread_ts: thread_ts,\n text: \"Hello, I'm townie from Val Town (lowercase t townie, unofficial)\",\n });\n\n await client.assistant.threads.setSuggestedPrompts({\n channel_id: channel_id,\n thread_ts: thread_ts,\n prompts: [\n {\n title: \"What vals have I worked on recently?\",\n message: \"What vals have I worked on recently?\",\n },\n {\n title: \"Create a cron val\",\n message: \"Create a cron val\",\n },\n {\n title: \"How does persistence work in Val Town?\",\n message: \"How does persistence work in Val Town?\",\n },\n ],\n });\n}",[120,134],"1f2aac0bd6e6fb5a03282047b6dfce8b9b65e3f0aa5ea2ad6942a9b7a070a2d0","eefb2d6c-1195-11f1-ab88-42dde27851f2","a0377488-1195-11f1-a723-42dde27851f2",126,["D",1771947108224],"import type { AssistantThreadStartedEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client } from \"./slack-utils.ts\";\n\nexport async function handleThreadStarted(\n event: AssistantThreadStartedEvent,\n) {\n const { channel_id, thread_ts } = event.assistant_thread;\n console.log(`Thread started: ${channel_id} ${thread_ts}`);\n console.log(JSON.stringify(event));\n\n await client.chat.postMessage({\n channel: channel_id,\n thread_ts: thread_ts,\n text:\n \"Hello, I'm an agent from Val Town. I'm just a duck, but maybe someday I'll be like Townie.\",\n });\n\n await client.assistant.threads.setSuggestedPrompts({\n channel_id: channel_id,\n thread_ts: thread_ts,\n prompts: [\n {\n title: \"What vals have I worked on recently?\",\n message: \"What vals have I worked on recently?\",\n },\n {\n title: \"Create an HTTP val\",\n message: \"Create an HTTP val\",\n },\n {\n title: \"How does persistence work in Val Town?\",\n message: \"How does persistence work in Val Town?\",\n },\n ],\n });\n}",[120,134],"c0ad7df8ce7b942bf377359bae5fda797de7845cf6ff1f6d8d8a4f3fa1dc240c","lib/generate-response.ts",{"_32":159,"_13":153,"_81":160,"_83":123,"_84":33,"_85":161,"_87":48,"_34":162,"_40":163,"_90":116,"_92":164,"_65":48,"_94":-5,"_95":-7,"_74":165,"_97":166},{"_32":152,"_13":153,"_81":154,"_83":113,"_84":57,"_85":103,"_87":26,"_34":155,"_40":89,"_90":116,"_92":156,"_65":48,"_94":-5,"_95":-7,"_74":157,"_97":158},"5d64eac8-1280-11f1-8a36-42dde27851f2","generate-response.ts","019c9642-6a83-73c7-ab5a-61a77b879a57",["D",1772047795703],"import { generateText, ModelMessage, stepCountIs } from \"npm:ai@6.0.92\";\nimport { anthropic } from \"npm:@ai-sdk/anthropic@3.0.45\";\nimport { createMCPClient } from \"npm:@ai-sdk/mcp@1.0.21\";\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst prompt = await readFile(\"/prompt.md\");\nconst mcpClient = await createMCPClient({\n transport: {\n type: \"http\",\n url: \"https://api.val.town/v3/mcp\",\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"TOWNIE_TOKEN\")}`,\n },\n },\n});\nconst mcpTools = await mcpClient.tools();\n\nexport const generateResponse = async (messages: ModelMessage[]) => {\n console.log(`generating LLM response...`);\n\n const { text } = await generateText({\n model: anthropic(\"claude-sonnet-4-6\"),\n tools: {\n webSearch: anthropic.tools.webSearch_20250305({ maxUses: 3 }),\n ...mcpTools,\n },\n stopWhen: stepCountIs(5),\n system: prompt,\n messages,\n });\n\n console.log(`generated LLM response: ${text.slice(0, 25)}...`);\n\n // Convert markdown to Slack mrkdwn format\n return text.replace(/\\[(.*?)\\]\\((.*?)\\)/g, \"<$2|$1>\").replace(/\\*\\*/g, \"*\");\n};",[120,153],"7ce941fe640681362558fd8edb46b382ee7515d6a93831bc0f77e19ddd31e040","cb156f66-11bd-11f1-b02d-42dde27851f2","0cb2f46e-0dbf-11f1-b26c-42dde27851f2",185,["D",1771964227857],39,"import { generateText, ModelMessage, stepCountIs } from \"npm:ai@6.0.92\";\nimport { anthropic } from \"npm:@ai-sdk/anthropic@3.0.45\";\nimport { createMCPClient } from \"npm:@ai-sdk/mcp@1.0.21\";\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst prompt = await readFile(\"/prompt.md\");\nconst mcpClient = await createMCPClient({\n transport: {\n type: \"http\",\n url: \"https://api.val.town/v3/mcp\",\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"VAL_TOWN_API_TOKEN\")}`,\n },\n },\n});\nconst mcpTools = await mcpClient.tools();\n\nexport const generateResponse = async (messages: ModelMessage[]) => {\n console.log(`generating LLM response...`);\n\n const { text } = await generateText({\n model: anthropic(\"claude-sonnet-4-6\"),\n tools: {\n webSearch: anthropic.tools.webSearch_20250305({ maxUses: 3 }),\n ...mcpTools,\n },\n stopWhen: stepCountIs(5),\n system: prompt,\n messages,\n });\n\n console.log(`generated LLM response: ${text.slice(0, 25)}...`);\n\n // Convert markdown to Slack mrkdwn format\n return text.replace(/\\[(.*?)\\]\\((.*?)\\)/g, \"<$2|$1>\").replace(/\\*\\*/g, \"*\");\n};",[120,153],"c9b6d9e63ae18c60ded51087f6161dc5479eaf5f1f95d7963db873672cfc9629","README.md",{"_32":177,"_13":167,"_81":178,"_83":-5,"_84":33,"_85":59,"_87":48,"_34":179,"_40":180,"_90":91,"_92":181,"_65":48,"_94":-5,"_95":-7,"_74":182,"_97":183},{"_32":170,"_13":167,"_81":171,"_83":-5,"_84":57,"_85":22,"_87":26,"_34":172,"_40":173,"_90":91,"_92":174,"_65":48,"_94":-5,"_95":-7,"_74":175,"_97":176},"bce57d1a-128e-11f1-b8cc-42dde27851f2","019c9642-6a83-73c7-ab5a-7a821aa3f81d",["D",1772053968890],9,"# Townie (unofficial): Slack agent\n\nBYOA (Bring Your Own Agent) to Slack.\n\n## Setup\n\nIt should only take 5-10 minutes to get your agent responding to DMs and\n`@mentions` in Slack.\n\n1. Go to [api.slack.com/apps](https://api.slack.com/apps) to create a Slack app\n -- choose \"From scratch\"\n1. Under OAuth & Permissions > Scopes > Bot Token Scopes, add the following:\n - `app_mentions:read`\n - `assistant:write`\n - `channels:history`\n - `chat:write`\n - `im:history`\n - `im:write`\n1. Under App Home > Show Tabs > Chat Tab, check \"Allow users to send Slash\n commands and messages from the chat tab\"\n1. Under OAuth & Permissions > OAuth Tokens, install the app to your workspace\n1. Remix this val if you haven't already\n1. Add your\n [environment variables](https://docs.val.town/reference/environment-variables/)\n in your val sidebar:\n 1. `TOWNIE_TOKEN` from\n [Settings > API tokens](https://www.val.town/settings/api)\n 1. `SLACK_BOT_TOKEN` in your Slack app: OAuth & Permissions > OAuth Tokens >\n Bot User OAuth Token\n 1. `SLACK_SIGNING_SECRET` in your Slack app: Basic Information > Signing\n Secret\n 1. `ANTHROPIC_API_KEY` from the\n [Claude console](https://platform.claude.com/settings/keys)\n1. Copy your HTTP url in `events.ts` (note: you can\n [add a custom subdomain](/vals/http/custom-subdomains/)), then in your Slack\n app paste it under Event Subscriptions > Request URL\n1. In your Slack app under Events Subscription > Enable Events > Subscribe to\n bot events, add `app_mention`, `assistant_thread_started`, and `message.im`\n\n## Architecture\n\n```\ntownie/\n├── events.ts # HTTP entry point (Hono app, Slack event router)\n├── prompt.md # System prompt for your agent\n├── README.md\n└── lib/\n ├── generate-response.ts # AI core (Claude + MCP + web search)\n ├── handle-app-mention.ts # Handles @mentions in channels and threads\n ├── handle-message.ts # Handles DMs in assistant (Slack app) threads\n ├── handle-thread-started.ts # Greeting + suggested prompts on new assistant thread\n └── slack-utils.ts # Slack client and utils\n```\n\n### Models\n\nThis template uses Claude Sonnet 4.6 directly in\n[lib/generate-response.ts](./lib/generate-response.ts), which requires setting\nan `ANTHROPIC_API_KEY` environment variable. Alternatively, you could use a\ngateway to switch between models easily, like the\n[Vercel AI Gateway](https://vercel.com/ai-gateway) or the\n[Kilo Gateway](https://kilo.ai/gateway).\n\n### Tools\n\nThis agent comes with the following tools:\n\n1. [Anthropic web search](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)\n2. [Val Town MCP server](https://docs.val.town/guides/prompting/mcp)\n\nYou should of course edit and add your own tools! That's the whole point of BYOA\n:)\n\n### Version pinning\n\nThis val uses\n[pinned imports](https://docs.val.town/reference/version-control/#imports--pinning)\n(latest package version as of 2/19/26) to avoid breaking changes:\n\n1. `@slack/web-api@7.14.1`\n2. `hono@4.12.0`\n3. `ai@6.0.92`\n4. `@ai-sdk/anthropic@3.0.45`\n5. `@ai-sdk/mcp@1.0.21`\n\n## Credits\n\nThis val is based on Vercel's\n[Slackbot Agent Guide](https://ai-sdk.dev/cookbook/guides/slackbot), adapted for\nVal Town.",[167],"7a9b59e8a2a6dc5cd1ec5448f4c7e64de3b3a598e19000b2f32c361f7c39385b","cf6eed3e-11c3-11f1-bd19-42dde27851f2","e59d92a2-0dab-11f1-bd8b-42dde27851f2",["D",1771966812149],29,"# duck: Slack agent\n\nBYOA (Bring Your Own Agent) to Slack.\n\n## Setup\n\nIt should only take 10-15 minutes to get your agent responding to DMs and\n`@mentions` in Slack.\n\n1. Go to [api.slack.com/apps](https://api.slack.com/apps) to create a Slack app -- choose \"From scratch\"\n1. Under OAuth & Permissions, add the following bot token scopes:\n - `app_mentions:read`\n - `assistant:write`\n - `channels:history`\n - `chat:write`\n - `im:history`\n - `im:write`\n1. Install the app to your workspace (button under OAuth Tokens subsection)\n1. Under App Home > Show Tabs > Chat Tab, check \"Allow users to send Slash\n commands and messages from the chat tab\"\n1. Remix this val if you haven't already\n1. Add your\n [environment variables](https://docs.val.town/reference/environment-variables/)\n in your val sidebar:\n 1. `VAL_TOWN_API_TOKEN` from\n [Settings > API tokens](https://www.val.town/settings/api)\n 1. `SLACK_BOT_TOKEN` in your Slack app: OAuth & Permissions > OAuth Tokens >\n Bot User OAuth Token\n 1. `SLACK_SIGNING_SECRET` in your Slack app: from Basic Information > Signing\n Secret\n 1. `ANTHROPIC_API_KEY` from the\n [Anthropic console](https://platform.claude.com/settings/keys)\n1. Copy your HTTP url in `events.ts` (note: you can\n [add a custom subdomain](/vals/http/custom-subdomains/)), then in your Slack\n app paste it under Event Subscriptions > Request URL\n1. In your Slack app under Events Subscription > Enable Events > Subscribe to\n bot events, add `app_mention`, `assistant_thread_started`, and `message.im`\n\n## Architecture\n\n```\nduck/\n├── events.ts # HTTP entry point (Hono app, Slack event router)\n├── prompt.md # System prompt for your agent\n├── README.md\n└── lib/\n ├── generate-response.ts # AI core (Claude + MCP + web search)\n ├── handle-app-mention.ts # Handles @mentions in channels and threads\n ├── handle-message.ts # Handles DMs in assistant (Slack app) threads\n ├── handle-thread-started.ts # Greeting + suggested prompts on new assistant thread\n └── slack-utils.ts # Slack client and utils\n```\n\n### Models\n\nThis template uses Claude Sonnet 4.6 directly in\n[lib/generate-response.ts](./lib/generate-response.ts), which requires setting\nan `ANTHROPIC_API_KEY` environment variable. Alternatively, you could use a\ngateway to switch between models easily, like the\n[Vercel AI Gateway](https://vercel.com/ai-gateway) or the\n[Kilo Gateway](https://kilo.ai/gateway).\n\n### Tools\n\nThis agent comes with the following tools:\n\n1. [Anthropic web search](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)\n2. [Val Town MCP server](https://docs.val.town/guides/prompting/mcp)\n\nYou should of course edit and add your own tools! That's the whole point of BYOA\n:)\n\n### Version pinning\n\nThis val uses\n[pinned imports](https://docs.val.town/reference/version-control/#imports--pinning)\n(latest package version as of 2/19/26) to avoid breaking changes:\n\n1. `@slack/web-api@7.14.1`\n2. `hono@4.12.0`\n3. `ai@6.0.92`\n4. `@ai-sdk/anthropic@3.0.45`\n5. `@ai-sdk/mcp@1.0.21`\n\n## Credits\n\nThis val is based on Vercel's\n[Slackbot Agent Guide](https://ai-sdk.dev/cookbook/guides/slackbot), adapted for\nVal Town.",[167],"283a9d0ac7893d03303e9bb7559a3c66faf3efba8fb7ed34eb4135cd0e9d7a5b",{"_74":185,"_76":-7,"_78":186},"rotate-token.ts",{"_32":187,"_13":185,"_81":188,"_83":-5,"_84":57,"_85":56,"_87":26,"_34":189,"_40":114,"_90":190,"_92":191,"_65":48,"_94":-5,"_95":-7,"_74":192,"_97":193},"3f55c2f1-a104-4538-9ffc-84430122248d","cff7f564-2863-11f1-b1b1-42dde27851f2",["D",1782308399225],"interval","import { email } from \"https://esm.town/v/std/email\";\n\nexport default async function (_interval: Interval) {\n await email({\n subject: \"townie slack agent api key expires in 1 week\",\n text: \"rotate townie's (er, noni's) val town api key \",\n });\n}",[185],"35faa69ad69a89ed600fb44e6b9355ab03ea94316a1f5f3f399518151373ca9b",["D",1772047460906],"legacyEnvVars","httpPrivacy","description","(unofficial)","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/9d7c45b4-38a8-441c-1ffb-cc9c79a0f000/square512?exp=1789563599&sig=5b5cdebceb3cbecda23a8bda6194de9c0486df049098836d6a45e258ba3aa6e1","userId","6906d0a1-0165-46b9-8717-60dfd935316a","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_234":230},"org",{"_11":12,"_227":228,"_229":230,"_201":202,"_231":232,"_233":48},"branch","displayName","Pete Millspaugh","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/c3c0aadf-86a9-4c2e-ef01-fb649d6fb000/square512?exp=1789563599&sig=adf1a5ac0fa2e9cdf8971f11f995711c7d7d47e9c24a087fa25160e15a044d6a","tier","pro","canRestrictVals","profileImageUrl","","adoptOrgId",{"_32":58,"_13":14,"_34":338,"_46":-5,"_195":48,"_49":50,"_196":50,"_197":198,"_199":200,"_201":202,"_203":-5,"_204":48,"_205":-5,"_206":-5,"_207":208,"_52":53,"_209":-5,"_210":-5,"_211":-5,"_212":-5,"_213":214,"_215":214,"_216":217,"_218":217,"_219":217,"_220":214,"_221":214,"_222":339,"_224":340,"_226":341,"_47":48},"tree",[296,302,303,304,305],"files",[296,297,298,299,300,301,302,303,304,305],"counts",{"_286":208,"_287":89,"_288":208,"_289":290,"_291":292},"contents",[263,264,265,266,267],"upstreamProject",{"_32":39,"_13":55,"_197":260,"_199":261,"_49":50,"_222":262},"upstreamBranch",{"_32":33,"_34":258,"_36":259,"_13":16,"_38":39,"_40":41,"_42":-5,"_43":-5,"_44":45,"_46":-5,"_47":48,"_49":50,"_51":12,"_52":53,"_54":55},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1771516433093],["D",1778182283784],"BYOA (Bring Your Own Agent) to Slack","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/987690a1-8efe-43e7-08f1-b9e55b561b00/square512?exp=1789563599&sig=eefb47d8c18c013d63db14b42233c5311e75ebd95da0c420a922551043e8bf7c",{"_11":12,"_234":230},{"_32":282,"_13":120,"_81":113,"_83":-5,"_84":57,"_85":89,"_87":26,"_34":283,"_40":208,"_90":284,"_92":-5,"_65":48,"_94":-5,"_74":285},{"_32":170,"_13":167,"_81":171,"_83":-5,"_84":57,"_85":22,"_87":26,"_34":280,"_40":173,"_90":91,"_92":174,"_65":48,"_94":-5,"_74":281},{"_32":272,"_13":273,"_81":274,"_83":-5,"_84":57,"_85":89,"_87":26,"_34":275,"_40":208,"_90":276,"_92":277,"_65":48,"_94":278,"_74":279},{"_32":80,"_13":75,"_81":82,"_83":-5,"_84":57,"_85":86,"_87":26,"_34":270,"_40":89,"_90":91,"_92":93,"_65":48,"_94":-5,"_74":271},{"_32":187,"_13":185,"_81":188,"_83":-5,"_84":57,"_85":56,"_87":26,"_34":268,"_40":114,"_90":190,"_92":191,"_65":48,"_94":-5,"_74":269},["D",1782308399225],[185],["D",1772048215635],[75],"95e50014-127f-11f1-8493-42dde27851f2","events.ts","019c9642-6a83-73c7-ab5a-7c0e286ae3ed",["D",1772047460906],"http","import { Hono } from \"npm:hono@4.12.0\";\nimport type {\n GenericMessageEvent,\n SlackEvent,\n} from \"npm:@slack/web-api@7.14.1\";\nimport { getBotId, verifyRequest } from \"./lib/slack-utils.ts\";\nimport { handleAppMention } from \"./lib/handle-app-mention.ts\";\nimport { handleThreadStarted } from \"./lib/handle-thread-started.ts\";\nimport { handleMessage } from \"./lib/handle-message.ts\";\n\nconst app = new Hono();\n\napp.get(\"/\", (c) => {\n return c.text(\"BYOA (Bring Your Own Agent) to Slack with Val Town\");\n});\n\napp.post(\"/events\", async (c) => {\n const rawBody = await c.req.text();\n const payload = JSON.parse(rawBody);\n const requestType = payload.type as \"url_verification\" | \"event_callback\";\n\n // See https://api.slack.com/events/url_verification\n if (requestType === \"url_verification\") {\n return new Response(payload.challenge, { status: 200 });\n }\n\n try {\n await verifyRequest({ requestType, request: c.req.raw, rawBody });\n const botUserId = await getBotId();\n const event = payload.event as SlackEvent;\n console.log(`Received ${event.type}`);\n\n // Fire-and-forget: Slack expects a response within 3 seconds\n // 1. Immediately respond to Slack\n // 2. Continue processing the message asynchronously\n // 3. Send the AI response when it's ready\n switch (event.type) {\n // When you tag your @agent in a Slack channel or thread\n case \"app_mention\":\n handleAppMention(event, botUserId).catch((err) =>\n console.error(\"Error in handleAppMention\", err)\n );\n break;\n\n // When you create a new chat with the agent app in Slack\n case \"assistant_thread_started\":\n handleThreadStarted(event).catch((err) =>\n console.error(\"Error in handleThreadStarted\", err)\n );\n break;\n\n // When you send a message in any channel or thread the agent is in?\n case \"message\": {\n const msgEvent = event as GenericMessageEvent;\n handleMessage(msgEvent, botUserId).catch((err) =>\n console.error(\"Error in handleMessage\", err)\n );\n break;\n }\n }\n\n return new Response(\"Success!\", { status: 200 });\n } catch (error) {\n console.error(\"Error generating response\", error);\n return new Response(\"Error generating response\", { status: 500 });\n }\n});\n\nexport default app.fetch;","slack-townie",[273],["D",1772053968890],[167],"95e4e1f6-127f-11f1-8493-42dde27851f2",["D",1772047460906],"directory",[120],"pulls","branches","forks","envVars",{"_293":86,"_295":208},"connections",{"_293":208,"_294":208},"count","unfilledCount","emptyCount",{"_32":282,"_13":120,"_81":113,"_83":-5,"_84":57,"_85":89,"_87":26,"_34":335,"_40":208,"_90":284,"_92":-5,"_65":48,"_94":-5,"_95":336,"_74":337},{"_32":152,"_13":153,"_81":154,"_83":113,"_84":57,"_85":103,"_87":26,"_34":155,"_40":89,"_90":116,"_92":156,"_65":48,"_94":-5,"_95":333,"_74":334},{"_32":326,"_13":327,"_81":328,"_83":113,"_84":57,"_85":89,"_87":26,"_34":329,"_40":208,"_90":116,"_92":330,"_65":48,"_94":-5,"_95":331,"_74":332},{"_32":319,"_13":320,"_81":321,"_83":113,"_84":57,"_85":89,"_87":26,"_34":322,"_40":208,"_90":116,"_92":323,"_65":48,"_94":-5,"_95":324,"_74":325},{"_32":133,"_13":134,"_81":135,"_83":113,"_84":57,"_85":136,"_87":26,"_34":137,"_40":138,"_90":116,"_92":139,"_65":48,"_94":-5,"_95":317,"_74":318},{"_32":110,"_13":111,"_81":112,"_83":113,"_84":57,"_85":114,"_87":26,"_34":115,"_40":89,"_90":116,"_92":117,"_65":48,"_94":-5,"_95":315,"_74":316},{"_32":170,"_13":167,"_81":171,"_83":-5,"_84":57,"_85":22,"_87":26,"_34":172,"_40":173,"_90":91,"_92":174,"_65":48,"_94":-5,"_95":313,"_74":314},{"_32":272,"_13":273,"_81":274,"_83":-5,"_84":57,"_85":89,"_87":26,"_34":310,"_40":208,"_90":276,"_92":277,"_65":48,"_94":278,"_95":311,"_74":312},{"_32":80,"_13":75,"_81":82,"_83":-5,"_84":57,"_85":86,"_87":26,"_34":88,"_40":89,"_90":91,"_92":93,"_65":48,"_94":-5,"_95":308,"_74":309},{"_32":187,"_13":185,"_81":188,"_83":-5,"_84":57,"_85":56,"_87":26,"_34":189,"_40":114,"_90":190,"_92":191,"_65":48,"_94":-5,"_95":306,"_74":307},[],[185],[],[75],["D",1772047460906],[],[273],[],[167],[],[120,111],[],[120,134],"95e4b7d0-127f-11f1-8493-42dde27851f2","handle-message.ts","019c9642-6a83-73c7-ab5a-6b37961b1ef6",["D",1772047460906],"import type { GenericMessageEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client, getThread, updateStatus } from \"./slack-utils.ts\";\nimport { generateResponse } from \"./generate-response.ts\";\n\nexport async function handleMessage(\n event: GenericMessageEvent,\n botUserId: string,\n) {\n console.log(`Message: ${JSON.stringify(event)}`);\n\n if (\n event.bot_id ||\n event.bot_id === botUserId ||\n event.bot_profile ||\n !event.thread_ts\n ) {\n return;\n }\n\n const { thread_ts, channel } = event;\n await updateStatus({ channel, thread_ts, status: \"is thinking...\" });\n\n // TODO: set a dynamic title after the first user message\n // await updateTitle({ channel, thread_ts, title: \"TODO\" });\n\n const messages = await getThread(channel, thread_ts, botUserId);\n const result = await generateResponse(messages);\n\n await client.chat.postMessage({\n channel: channel,\n thread_ts: thread_ts,\n text: result,\n unfurl_links: false,\n blocks: [\n {\n type: \"section\",\n text: {\n type: \"mrkdwn\",\n text: result,\n },\n },\n ],\n });\n}",[],[120,320],"95e4afe2-127f-11f1-8493-42dde27851f2","handle-app-mention.ts","019c9642-6a83-73c7-ab5a-64c38efe3547",["D",1772047460906],"import { AppMentionEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client, getThread, updateStatus } from \"./slack-utils.ts\";\nimport { generateResponse } from \"./generate-response.ts\";\n\nexport async function handleAppMention(\n event: AppMentionEvent,\n botUserId: string,\n) {\n console.log(`App mention: ${JSON.stringify(event)}`);\n\n if (event.bot_id || event.bot_id === botUserId || event.bot_profile) {\n console.log(\"Skipping app mention\");\n return;\n }\n\n const { thread_ts, channel } = event;\n const threadTs = thread_ts ?? event.ts;\n await updateStatus({\n thread_ts: threadTs,\n channel,\n status: \"is thinking...\",\n });\n\n const messages = thread_ts\n ? await getThread(channel, thread_ts, botUserId)\n : [{ role: \"user\" as const, content: event.text }];\n\n const result = await generateResponse(messages);\n\n await client.chat.postMessage({\n channel,\n thread_ts: threadTs,\n text: result,\n unfurl_links: false,\n blocks: [\n {\n type: \"section\",\n text: {\n type: \"mrkdwn\",\n text: result,\n },\n },\n ],\n });\n}",[],[120,327],[],[120,153],["D",1772047460906],[297,298,299,300,301],[120],["D",1772047460906],{"_11":12,"_234":230},{"_11":12,"_227":228,"_229":230,"_201":202,"_231":232,"_233":48},{"_40":56,"_13":16,"_32":57,"_38":58,"_42":33,"_43":59,"_60":50,"_61":39,"_62":53,"_54":14,"_51":12},"ctx",{"_222":-5,"_255":375,"_376":377,"_378":379,"_380":48,"_381":48,"_382":48,"_383":26,"_384":-5,"_385":-7,"_386":-7,"_387":208,"_388":48,"_389":48,"_390":-5,"_391":48,"_392":48,"_393":48,"_394":-5},"ENV",{"_346":347,"_348":349,"_350":16,"_351":352,"_353":354,"_355":356,"_357":358,"_359":360,"_361":362,"_363":364,"_365":366,"_367":368,"_369":370,"_371":372,"_373":374},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Compare

Mergetownie/mainintoduck/main

README.md+10-9

lib/generate-response.ts+1-1

lib/handle-thread-started.ts+3-4

lib/slack-utils.ts+10-10

prompt.md+2-1

Crotate-token.ts+8-0