@andreprado/agentkit 0.1.0-alpha.19 → 0.1.0-alpha.20

package/src/runtime/config.ts

@@ -30,8 +30,8 @@ const AGENT_RUNTIMES = new Set<AgentRuntime>(["local", "edge"]);
 const PROVIDERS = new Set<AgentProviderName>(["test", "openai", "anthropic", "openrouter", "custom"]);
 const ACCESS_MODES = new Set<AccessMode>(["private", "token", "public"]);
 const TOOL_VISIBILITIES = new Set<ToolVisibility>(["user", "internal"]);
-const CHANNEL_TYPES = new Set<ChannelType>(["website", "telegram", "whatsapp", "discord"]);
-const CHANNEL_PROVIDERS = new Set<ChannelProvider>(["agentkit", "telegram", "zapster", "meta", "discord"]);
+const CHANNEL_TYPES = new Set<ChannelType>(["website", "telegram", "whatsapp", "discord", "slack"]);
+const CHANNEL_PROVIDERS = new Set<ChannelProvider>(["agentkit", "telegram", "zapster", "meta", "discord", "slack"]);
 const CHANNEL_BUFFER_MODES = new Set<ChannelBufferMode>(["off", "debounce"]);
 const CHANNEL_AUDIO_MODES = new Set<ChannelAudioMode>(["off", "reject", "transcribe"]);
 const DISCORD_CHANNEL_MODES = new Set<DiscordChannelMode>(["interactions", "bot"]);
@@ -622,6 +622,11 @@ function validateChannel(value: unknown, index: number, hasTranscriptionConfig:
     return;
   }
 
+  if (value.type === "slack") {
+    validateSlackChannel(value, index);
+    return;
+  }
+
   validateChannelAudio(value.audio, index, hasTranscriptionConfig);
 
   if (value.type === "website") {
@@ -694,7 +699,7 @@ function validateTelegramChannel(value: Record<string, unknown>, index: number):
 
 function validateWhatsappChannel(value: Record<string, unknown>, index: number): void {
   if (value.type !== "whatsapp") {
-    throw invalidConfig(`channels[${index}].type must be "website", "telegram", "whatsapp", or "discord".`);
+    throw invalidConfig(`channels[${index}].type must be "website", "telegram", "whatsapp", "discord", or "slack".`);
   }
 
   if (value.provider === "zapster") {
@@ -738,6 +743,18 @@ function validateDiscordChannel(value: Record<string, unknown>, index: number):
   );
 }
 
+function validateSlackChannel(value: Record<string, unknown>, index: number): void {
+  if (value.provider !== "slack") {
+    throw invalidConfig(`channels[${index}].provider must be "slack" when type is "slack".`);
+  }
+
+  if (value.audio !== undefined) {
+    throw invalidConfig(`channels[${index}].audio is not supported when type is "slack".`);
+  }
+
+  expectRequiredSecrets(value.secrets, ["SLACK_BOT_TOKEN", "SLACK_SIGNING_SECRET"], `channels[${index}]`);
+}
+
 function validateChannelLimits(value: unknown, index: number): void {
   if (value === undefined) {
     return;

package/src/runtime/core/targets.ts

@@ -6,7 +6,7 @@ export type RuntimeTargetId = (typeof runtimeTargetIds)[number];
 export type RuntimeTargetCapabilityState = "available" | "planned" | "unsupported";
 export type RuntimeStorageCapability = "agentkit" | "durable-object-sqlite" | "local-sqlite" | "postgres";
 export type RuntimeFilesCapability = "none" | "r2" | "local-disk" | "s3-compatible";
-export type RuntimeChannelCapability = "website" | "telegram" | "whatsapp";
+export type RuntimeChannelCapability = "website" | "telegram" | "whatsapp" | "discord" | "slack";
 export type RuntimeProviderSupport = "pi-local" | "edge-compatible" | "server-env";
 
 export type RuntimeTargetCapabilities = {
@@ -35,7 +35,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "available",
       storage: ["local-sqlite"],
       files: ["local-disk"],
-      channels: ["website"],
+      channels: ["website", "slack"],
       providers: ["pi-local"],
     },
   },
@@ -48,7 +48,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "planned",
       storage: ["agentkit", "durable-object-sqlite", "postgres"],
       files: ["none", "r2"],
-      channels: ["website", "telegram", "whatsapp"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
       providers: ["edge-compatible"],
     },
   },
@@ -61,7 +61,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "planned",
       storage: ["local-sqlite", "postgres"],
       files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
       providers: ["server-env"],
     },
   },
@@ -74,7 +74,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "unsupported",
       storage: ["local-sqlite", "postgres"],
       files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
       providers: ["server-env"],
     },
   },

package/src/runtime/dev-server.ts

@@ -8,7 +8,8 @@ import { Readable } from "node:stream";
 import { openCapsuleStore, type ConversationRecord } from "../storage/sqlite";
 import type { AgentChannel, ChannelProvider, ChannelType } from "../index";
 import type { ChannelAdapter, NormalizedChannelMessage, RawWebhookEvent } from "./channels";
-import { discordChannelAdapter, isDiscordPingInteraction } from "./channels/discord";
+import { discordChannelAdapter } from "./channels/discord";
+import { slackChannelAdapter } from "./channels/slack";
 import { telegramChannelAdapter } from "./channels/telegram";
 import { websiteChannelAdapter } from "./channels/website";
 import { metaWhatsappChannelAdapter } from "./channels/whatsapp-meta";
@@ -319,7 +320,7 @@ async function handleDevServerRequest(
       return await handleLocalFile(capsule, request, decodeURIComponent(fileMatch[1]));
     }
 
-    const channelMatch = route.match(/^\/channels\/([^/]+)\/(website|telegram|whatsapp|discord)\/([^/]+)\/webhook$/);
+    const channelMatch = route.match(/^\/channels\/([^/]+)\/(website|telegram|whatsapp|discord|slack)\/([^/]+)\/webhook$/);
 
     if (channelMatch) {
       return await handlePortableChannel(capsule, request, channelRuntime, {
@@ -504,12 +505,12 @@ async function handlePortableChannel(
     throw new AgentKitError(verification.code, verification.message);
   }
 
-  if (channel.type === "whatsapp" && channel.provider === "meta" && request.method === "GET") {
-    return new Response(new URL(request.url).searchParams.get("hub.challenge") ?? "");
-  }
+  const webhookResponse = adapter.getWebhookResponse
+    ? await adapter.getWebhookResponse({ ...rawEvent, channel, secrets })
+    : null;
 
-  if (channel.type === "discord" && channel.provider === "discord" && isDiscordPingInteraction(rawBody)) {
-    return jsonResponse({ type: 1 });
+  if (webhookResponse) {
+    return channelAdapterResponse(webhookResponse);
   }
 
   const events = await adapter.normalizeInbound(rawEvent);
@@ -1140,9 +1141,31 @@ function adapterForChannel(type: ChannelType, provider: ChannelProvider): Channe
     return discordChannelAdapter;
   }
 
+  if (type === "slack" && provider === "slack") {
+    return slackChannelAdapter;
+  }
+
   throw new AgentKitError("channel_not_found", `No channel adapter for ${type}/${provider}.`);
 }
 
+function channelAdapterResponse(response: {
+  status?: number;
+  headers?: Record<string, string>;
+  body: string | Record<string, unknown>;
+}): Response {
+  if (typeof response.body === "string") {
+    return new Response(response.body, {
+      status: response.status ?? 200,
+      headers: response.headers,
+    });
+  }
+
+  return jsonResponse(response.body, {
+    status: response.status ?? 200,
+    headers: response.headers,
+  });
+}
+
 function discordLocalInteractionResponse(
   deliveries: Array<{
     state: string;

package/src/runtime/targets/cloudflare/build.ts

@@ -451,6 +451,17 @@ export function discordChannel(input) {
   };
 }
 
+export function slackChannel(input) {
+  return {
+    type: "slack",
+    provider: "slack",
+    name: input.name,
+    secrets: normalizeChannelSecrets(input.secrets ?? ["SLACK_BOT_TOKEN", "SLACK_SIGNING_SECRET"], "slack channel"),
+    ...(input.limits ? { limits: input.limits } : {}),
+    ...(input.buffer ? { buffer: normalizeChannelBuffer(input.buffer, "slack channel") } : {}),
+  };
+}
+
 function defaultWhatsappChannelSecrets(provider) {
   if (provider === "zapster") {
     return ["ZAPSTER_API_KEY", "ZAPSTER_INSTANCE_ID", "ZAPSTER_WEBHOOK_ID"];
@@ -715,6 +726,10 @@ export class AgentKitConversationStore extends DurableObject {
         status TEXT NOT NULL,
         error_code TEXT,
         error_message TEXT,
+        input_tokens INTEGER,
+        output_tokens INTEGER,
+        total_tokens INTEGER,
+        cost_json TEXT,
         created_at TEXT NOT NULL,
         completed_at TEXT
       );
@@ -738,6 +753,18 @@ export class AgentKitConversationStore extends DurableObject {
     } catch {
       // Existing Durable Object tables either already have this column or do not need migration.
     }
+    for (const statement of [
+      "ALTER TABLE runs ADD COLUMN input_tokens INTEGER",
+      "ALTER TABLE runs ADD COLUMN output_tokens INTEGER",
+      "ALTER TABLE runs ADD COLUMN total_tokens INTEGER",
+      "ALTER TABLE runs ADD COLUMN cost_json TEXT",
+    ]) {
+      try {
+        this.sql.exec(statement);
+      } catch {
+        // Existing Durable Object tables either already have this column or do not need migration.
+      }
+    }
   }
 
   async fetch(request) {
@@ -835,7 +862,7 @@ export class AgentKitConversationStore extends DurableObject {
     }
 
     const runs = this.sql.exec(
-      "SELECT id, conversation_id, provider, model, status, error_code, error_message, created_at, completed_at FROM runs WHERE conversation_id = ? ORDER BY rowid ASC",
+      "SELECT id, conversation_id, provider, model, status, error_code, error_message, input_tokens, output_tokens, total_tokens, cost_json, created_at, completed_at FROM runs WHERE conversation_id = ? ORDER BY rowid ASC",
       conversationId,
     ).toArray();
 
@@ -849,6 +876,7 @@ export class AgentKitConversationStore extends DurableObject {
         status: String(run.status),
         errorCode: run.error_code === null || run.error_code === undefined ? null : String(run.error_code),
         errorMessage: run.error_message === null || run.error_message === undefined ? null : String(run.error_message),
+        usage: readStoredUsage(run),
         startedAt: String(run.created_at),
         completedAt: run.completed_at === null || run.completed_at === undefined ? null : String(run.completed_at),
         toolCalls: this.readToolCalls(String(run.id)),
@@ -920,6 +948,7 @@ export class AgentKitConversationStore extends DurableObject {
     const userMessageId = crypto.randomUUID();
     const assistantMessageId = crypto.randomUUID();
     const title = titleFromMessage(String(input.userMessage || ""));
+    const usage = normalizeRuntimeUsage(input.usage);
 
     this.sql.exec(
       "INSERT OR IGNORE INTO conversations (id, agent_name, title, created_at, updated_at) VALUES (?, ?, ?, ?, ?)",
@@ -939,7 +968,7 @@ export class AgentKitConversationStore extends DurableObject {
       now,
     );
     this.sql.exec(
-      "INSERT INTO runs (id, conversation_id, provider, model, status, error_code, error_message, created_at, completed_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
+      "INSERT INTO runs (id, conversation_id, provider, model, status, error_code, error_message, input_tokens, output_tokens, total_tokens, cost_json, created_at, completed_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
       runId,
       conversationId,
       manifest.provider.name,
@@ -947,6 +976,10 @@ export class AgentKitConversationStore extends DurableObject {
       String(input.status || "completed"),
       input.errorCode ? String(input.errorCode) : null,
       input.errorMessage ? String(input.errorMessage) : null,
+      usage.inputTokens ?? null,
+      usage.outputTokens ?? null,
+      usage.totalTokens ?? null,
+      usage.cost && Object.keys(usage.cost).length > 0 ? JSON.stringify(usage.cost) : null,
       now,
       now,
     );
@@ -990,7 +1023,7 @@ export class AgentKitConversationStore extends DurableObject {
 }
 
 export default {
-  async fetch(request, env) {
+  async fetch(request, env, ctx) {
     const url = new URL(request.url);
 
     if (request.method === "GET" && url.pathname === "/_agentkit") {
@@ -1062,7 +1095,7 @@ export default {
     }
 
     if (request.method === "POST" && (url.pathname === "/chat" || url.pathname === "/v1/chat")) {
-      return handleChat(request, env);
+      return handleChat(request, env, ctx);
     }
 
     if (request.method === "GET" && (url.pathname === "/conversations" || url.pathname === "/v1/conversations")) {
@@ -1095,8 +1128,8 @@ export default {
 
 function isHostedChannelWebhookPath(pathname) {
   return (
-    /^\\/channels\\/[^/]+\\/(?:website\\/agentkit|telegram\\/telegram|whatsapp\\/(?:zapster|meta)|discord\\/discord)\\/webhook$/.test(pathname) ||
-    /^\\/channels\\/[^/]+\\/(?:website|telegram|discord)\\/webhook$/.test(pathname) ||
+    /^\\/channels\\/[^/]+\\/(?:website\\/agentkit|telegram\\/telegram|whatsapp\\/(?:zapster|meta)|discord\\/discord|slack\\/slack)\\/webhook$/.test(pathname) ||
+    /^\\/channels\\/[^/]+\\/(?:website|telegram|discord|slack)\\/webhook$/.test(pathname) ||
     /^\\/channels\\/[^/]+\\/whatsapp\\/(?:zapster|meta)\\/webhook$/.test(pathname)
   );
 }
@@ -1269,7 +1302,7 @@ async function handleTool(request, env, toolName) {
   }
 }
 
-async function handleChat(request, env) {
+async function handleChat(request, env, ctx) {
   let body;
 
   try {
@@ -1306,13 +1339,26 @@ async function handleChat(request, env) {
 
   const previousMessages = await loadConversationMessages(env, conversationId).catch(() => []);
   let content;
+  let providerResult;
   const toolCalls = [];
 
   try {
-    const providerResult = await callHostedProvider(env, [...previousMessages, { role: "user", content: message }], request.signal, toolCalls);
+    providerResult = await callHostedProvider(env, [...previousMessages, { role: "user", content: message }], request.signal, toolCalls);
     content = providerResult.content;
   } catch (error) {
-    await persistFailure(env, conversationId, message, error, toolCalls);
+    const persisted = await persistFailure(env, conversationId, message, error, toolCalls);
+    queueRuntimeUsage(ctx, sendRuntimeUsage(env, {
+      kind: "chat_run",
+      status: "failed",
+      conversationId,
+      runId: persisted?.runId,
+      provider: manifest.provider.name,
+      model: manifest.provider.model,
+      metadata: {
+        error_code: error && typeof error === "object" && "code" in error ? String(error.code) : "runtime_error",
+        tool_calls: toolCalls.length,
+      },
+    }));
     return hostedErrorResponse(error);
   }
 
@@ -1320,8 +1366,21 @@ async function handleChat(request, env) {
     conversationId,
     userMessage: message,
     assistantMessage: content,
+    usage: providerResult.usage,
     toolCalls,
   });
+  queueRuntimeUsage(ctx, sendRuntimeUsage(env, {
+    kind: "chat_run",
+    status: "succeeded",
+    conversationId: persisted.conversationId ?? conversationId,
+    runId: persisted.runId,
+    provider: manifest.provider.name,
+    model: manifest.provider.model,
+    usage: providerResult.usage,
+    metadata: {
+      tool_calls: toolCalls.length,
+    },
+  }));
 
   return Response.json({
     message: {
@@ -1409,6 +1468,7 @@ async function callHostedProvider(env, messages, signal, toolCalls = []) {
 
   return {
     content: result.message.content,
+    usage: result.usage,
   };
 }
 
@@ -1836,7 +1896,7 @@ async function hostedFakeEmbedding(input, dimensions) {
 }
 
 async function persistFailure(env, conversationId, userMessage, error, toolCalls = []) {
-  await persist(env, {
+  return persist(env, {
     conversationId,
     userMessage,
     status: "failed",
@@ -2530,6 +2590,73 @@ async function persist(env, input) {
   return response.json();
 }
 
+function queueRuntimeUsage(ctx, promise) {
+  const safePromise = promise.catch(() => undefined);
+
+  if (ctx && typeof ctx.waitUntil === "function") {
+    ctx.waitUntil(safePromise);
+    return;
+  }
+
+  void safePromise;
+}
+
+async function sendRuntimeUsage(env, input) {
+  if (!env.AGENTKIT_CLOUD_API_URL || !env.AGENTKIT_DEPLOY_ID || !env.AGENTKIT_RUNTIME_GATE_TOKEN) {
+    return;
+  }
+
+  const usage = normalizeRuntimeUsage(input.usage);
+  const metadata = isRecord(input.metadata) ? input.metadata : {};
+  const body = {
+    kind: input.kind || "chat_run",
+    status: input.status || "succeeded",
+    ...(input.runId ? { run_id: String(input.runId) } : {}),
+    ...(input.conversationId ? { conversation_id: String(input.conversationId) } : {}),
+    ...(input.provider ? { provider: String(input.provider) } : {}),
+    ...(input.model ? { model: String(input.model) } : {}),
+    ...(usage.inputTokens !== undefined ? { input_tokens: usage.inputTokens } : {}),
+    ...(usage.outputTokens !== undefined ? { output_tokens: usage.outputTokens } : {}),
+    ...(usage.totalTokens !== undefined ? { total_tokens: usage.totalTokens } : {}),
+    ...(usage.cost && Object.keys(usage.cost).length > 0 ? { cost: usage.cost } : {}),
+    ...(usage.cost?.total !== undefined ? { cost_usd: usage.cost.total } : {}),
+    metadata: sanitizeRuntimeUsageMetadata(metadata),
+  };
+
+  const url = new URL(
+    "/v1/runtime/deploys/" + encodeURIComponent(String(env.AGENTKIT_DEPLOY_ID)) + "/usage",
+    env.AGENTKIT_CLOUD_API_URL,
+  );
+  await fetch(url.href, {
+    method: "POST",
+    headers: {
+      Authorization: "Bearer " + env.AGENTKIT_RUNTIME_GATE_TOKEN,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+}
+
+function sanitizeRuntimeUsageMetadata(value) {
+  const metadata = {};
+
+  for (const [key, raw] of Object.entries(value)) {
+    if (!/^[A-Za-z0-9_.:-]{1,80}$/.test(key)) {
+      continue;
+    }
+
+    if (typeof raw === "string") {
+      metadata[key] = raw.length > 160 ? raw.slice(0, 160) : raw;
+    } else if (typeof raw === "number" && Number.isFinite(raw)) {
+      metadata[key] = raw;
+    } else if (typeof raw === "boolean") {
+      metadata[key] = raw;
+    }
+  }
+
+  return metadata;
+}
+
 async function loadConversationMessages(env, conversationId) {
   if (!env.AGENTKIT_CONVERSATIONS || !conversationId) {
     return [];
@@ -2863,6 +2990,68 @@ function titleFromMessage(content) {
   return compact.length <= 80 ? compact : \`\${compact.slice(0, 77)}...\`;
 }
 
+function readStoredUsage(row) {
+  const usage = {};
+  const inputTokens = normalizeRuntimeInteger(row.input_tokens);
+  const outputTokens = normalizeRuntimeInteger(row.output_tokens);
+  const totalTokens = normalizeRuntimeInteger(row.total_tokens);
+  const cost = normalizeRuntimeCost(parseStoredJson(row.cost_json, {}));
+
+  if (inputTokens !== undefined) usage.inputTokens = inputTokens;
+  if (outputTokens !== undefined) usage.outputTokens = outputTokens;
+  if (totalTokens !== undefined) usage.totalTokens = totalTokens;
+  if (Object.keys(cost).length > 0) usage.cost = cost;
+
+  return usage;
+}
+
+function normalizeRuntimeUsage(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+
+  const usage = {};
+  const inputTokens = normalizeRuntimeInteger(value.inputTokens ?? value.input_tokens);
+  const outputTokens = normalizeRuntimeInteger(value.outputTokens ?? value.output_tokens);
+  const totalTokens = normalizeRuntimeInteger(value.totalTokens ?? value.total_tokens);
+  const cost = normalizeRuntimeCost(value.cost);
+
+  if (inputTokens !== undefined) usage.inputTokens = inputTokens;
+  if (outputTokens !== undefined) usage.outputTokens = outputTokens;
+  if (totalTokens !== undefined) usage.totalTokens = totalTokens;
+  if (Object.keys(cost).length > 0) usage.cost = cost;
+
+  return usage;
+}
+
+function normalizeRuntimeCost(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+
+  const cost = {};
+
+  for (const field of ["input", "output", "cacheRead", "cacheWrite", "total"]) {
+    const normalized = normalizeRuntimeNumber(value[field]);
+
+    if (normalized !== undefined) {
+      cost[field] = normalized;
+    }
+  }
+
+  return cost;
+}
+
+function normalizeRuntimeInteger(value) {
+  const normalized = normalizeRuntimeNumber(value);
+  return normalized !== undefined && Number.isInteger(normalized) ? normalized : undefined;
+}
+
+function normalizeRuntimeNumber(value) {
+  const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
+  return typeof parsed === "number" && Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+}
+
 function parseStoredJson(value, fallback) {
   if (typeof value !== "string") {
     return fallback;
@@ -2944,6 +3133,10 @@ CREATE TABLE IF NOT EXISTS runs (
   status TEXT NOT NULL,
   error_code TEXT,
   error_message TEXT,
+  input_tokens INTEGER,
+  output_tokens INTEGER,
+  total_tokens INTEGER,
+  cost_json TEXT,
   created_at TEXT NOT NULL,
   completed_at TEXT
 );

package/src/templates/skills/agentkit-capsule/SKILL.md

@@ -27,7 +27,7 @@ Use this first inside an AgentKit Agent Capsule.
 - Improve from hosted or local production evidence: `skills/agentkit-improve/SKILL.md`
 - Prepare hosted deploy: `skills/agentkit-deploy/SKILL.md`
 - Work with secrets, external APIs, public access, channels, or real data: `skills/agentkit-security/SKILL.md`
-- Add or debug website, Telegram, WhatsApp, or Discord channels: `skills/agentkit-channels/SKILL.md`
+- Add or debug website, Telegram, WhatsApp, Discord, or Slack channels: `skills/agentkit-channels/SKILL.md`
 - Investigate command failures: `skills/agentkit-troubleshooting/SKILL.md`
 
 For a compact docs map, read `references/docs-router.md`.

package/src/templates/skills/agentkit-capsule/references/docs-router.md

@@ -6,9 +6,10 @@ Prefer the narrowest source that covers the task.
 - Tools, schemas, secrets, and direct tool tests: `docs/guides/add-tool.md`
 - Knowledge sources, indexing, search, and hosted sync: `docs/guides/add-knowledge.md`
 - Evals and deterministic side-effect guards: `docs/guides/run-evals.md`
+- Safe AgentKit product feedback drafts/submission: `docs/guides/send-feedback.md`
 - Real provider setup: `docs/guides/use-provider.md`
 - Deploy readiness, managed secrets, smoke checks, hosted UI: `docs/guides/prepare-deploy.md`
-- Channels: `docs/guides/add-channel.md`, `connect-discord.md`, `connect-telegram.md`, `connect-whatsapp-zapster.md`, `debug-channel.md`
+- Channels: `docs/guides/add-channel.md`, `connect-discord.md`, `connect-slack.md`, `connect-telegram.md`, `connect-whatsapp-zapster.md`, `debug-channel.md`
 - Security: `docs/guides/security-rules.md`
 
 Use `npm run agentkit -- docs full` only for a complete-contract audit, framework internals, or a behavior not covered by the task guide.

package/src/templates/skills/agentkit-channels/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agentkit-channels
-description: Use when adding, connecting, testing, buffering, transcribing audio, or debugging AgentKit website, Telegram, WhatsApp, or Discord channels, including channel config helpers, provider secrets, webhook setup, channel tests, delivery logs, burst-message buffers, and transcription provider secrets.
+description: Use when adding, connecting, testing, buffering, transcribing audio, or debugging AgentKit website, Telegram, WhatsApp, Discord, or Slack channels, including channel config helpers, provider secrets, webhook setup, channel tests, delivery logs, burst-message buffers, and transcription provider secrets.
 ---
 
 # AgentKit Channels
@@ -82,6 +82,7 @@ npm run agentkit -- channels connect telegram support-telegram
 npm run agentkit -- channels add whatsapp support-whatsapp --provider zapster
 npm run agentkit -- channels connect discord support-discord
 npm run agentkit -- channels connect discord server-discord --mode bot
+npm run agentkit -- channels connect slack support-slack
 npm run agentkit -- channels doctor support-telegram
 npm run agentkit -- channels test support-telegram --message "hello"
 npm run agentkit -- channels test-audio support-telegram --fixture voice-note
@@ -92,6 +93,7 @@ npm run agentkit -- channels deliveries list support-telegram
 ## References
 
 - `references/discord.md`
+- `references/slack.md`
 - `references/telegram.md`
 - `references/whatsapp-zapster.md`
 - `references/channel-buffering.md`

package/src/templates/skills/agentkit-channels/references/slack.md

@@ -0,0 +1,56 @@
+# Slack Channel
+
+Slack uses Events API webhooks.
+
+V1 supports:
+
+- `app_mention` in channels.
+- `message.im` direct messages.
+- Outbound replies through `chat.postMessage`.
+
+V1 does not support Socket Mode, files, audio transcription, app-management automation, or all-channel message listening.
+
+## Required Secrets
+
+```txt
+SLACK_BOT_TOKEN
+SLACK_SIGNING_SECRET
+```
+
+## Config
+
+```ts
+slackChannel({
+  name: "support-slack",
+})
+```
+
+## Commands
+
+```sh
+agentkit deploy
+agentkit secret set SLACK_BOT_TOKEN --stdin
+agentkit secret set SLACK_SIGNING_SECRET --stdin
+agentkit channels connect slack support-slack
+agentkit channels test support-slack --message "hello"
+agentkit channels deliveries list support-slack
+```
+
+## Slack Setup
+
+In Slack app configuration:
+
+1. Basic Information: copy Signing Secret into `SLACK_SIGNING_SECRET`.
+2. OAuth & Permissions: add bot scopes `app_mentions:read`, `im:history`, and `chat:write`.
+3. Install or reinstall the app to the workspace.
+4. Copy the Bot User OAuth Token into `SLACK_BOT_TOKEN`.
+5. Event Subscriptions: enable events and paste the AgentKit webhook URL.
+6. Subscribe to bot events `app_mention` and `message.im`.
+
+## Runtime Behavior
+
+AgentKit verifies `X-Slack-Signature` and `X-Slack-Request-Timestamp` against the raw body before processing events. It rejects stale timestamps, answers `url_verification` with the literal challenge, skips bot/subtype messages, maps channel mentions to Slack threads, maps DMs to the Slack DM channel and user, and replies with `chat.postMessage`.
+
+Outbound Slack text escapes Slack control mentions and disables link-name expansion and unfurls.
+
+Slack audio is not supported in V1; do not configure `audio` on `slackChannel`.

package/src/templates/skills/agentkit-troubleshooting/SKILL.md

@@ -13,6 +13,7 @@ Use this when something fails.
 2. Run the narrow inspect command before guessing.
 3. Route to a task skill when the failure points to config, tools, database, provider, evals, deploy, Knowledge, or channels.
 4. Load `llms-full.txt` only when the narrow skill and guide do not explain the behavior.
+5. If the failure appears to be an AgentKit bug, missing docs, or unclear recovery path, create a local feedback draft after diagnosis.
 
 ## First Commands
 
@@ -42,6 +43,12 @@ For deploy issues:
 npm run agentkit -- deploy doctor
 ```
 
+For AgentKit product feedback:
+
+```sh
+npm run agentkit -- feedback create --about last-run --kind bug --summary "short concrete summary"
+```
+
 For production behavior issues:
 
 ```sh
@@ -60,3 +67,10 @@ npm run agentkit -- replay .agentkit/improve/<run> --against local
 - channel secret missing: set hosted managed secret, not source files;
 - production behavior drift: collect an improve bundle and convert it to regression evals before patching;
 - local AgentKit skills are stale: run `npm run agentkit -- skills sync`.
+
+## Feedback Rules
+
+- `feedback create` writes a local draft only; it does not send anything.
+- Review the draft before `feedback send`.
+- Sending requires `agentkit login --token agk_user_...`.
+- Do not paste `.env` values, provider keys, cookies, client PII, or full private transcripts into feedback.