@poncho-ai/cli 0.12.0 → 0.13.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/cli@0.12.0 build /home/runner/work/poncho-ai/poncho-ai/packages/cli
+> @poncho-ai/cli@0.13.0 build /home/runner/work/poncho-ai/poncho-ai/packages/cli
 > tsup src/index.ts src/cli.ts --format esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es2022
 ESM Build start
 ESM dist/cli.js                          94.00 B
-ESM dist/run-interactive-ink-64QEOUXL.js 53.83 KB
 ESM dist/index.js                        857.00 B
-ESM dist/chunk-XIFWXRUB.js               241.46 KB
-ESM ⚡️ Build success in 59ms
+ESM dist/run-interactive-ink-VZBOYJYS.js 53.83 KB
+ESM dist/chunk-CUCEDHME.js               245.47 KB
+ESM ⚡️ Build success in 47ms
 DTS Build start
-DTS ⚡️ Build success in 3442ms
+DTS ⚡️ Build success in 3770ms
 DTS dist/cli.d.ts   20.00 B
 DTS dist/index.d.ts 3.56 KB

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @poncho-ai/cli
 
+## 0.13.0
+
+### Minor Changes
+
+- [#10](https://github.com/cesr/poncho-ai/pull/10) [`d5bce7b`](https://github.com/cesr/poncho-ai/commit/d5bce7be5890c657bea915eb0926feb6de66b218) Thanks [@cesr](https://github.com/cesr)! - Add generic messaging layer with Slack as the first adapter. Agents can now respond to @mentions in Slack by adding `messaging: [{ platform: 'slack' }]` to `poncho.config.js`. Includes signature verification, threaded conversations, processing indicators, and Vercel `waitUntil` support.
+
+### Patch Changes
+
+- Updated dependencies [[`d5bce7b`](https://github.com/cesr/poncho-ai/commit/d5bce7be5890c657bea915eb0926feb6de66b218)]:
+  - @poncho-ai/messaging@0.2.0
+  - @poncho-ai/harness@0.13.1
+  - @poncho-ai/sdk@1.0.1
+
 ## 0.12.0
 
 ### Minor Changes

package/dist/{chunk-XIFWXRUB.js → chunk-CUCEDHME.js}

@@ -22,6 +22,10 @@ import {
   resolveStateConfig
 } from "@poncho-ai/harness";
 import { getTextContent } from "@poncho-ai/sdk";
+import {
+  AgentBridge,
+  SlackAdapter
+} from "@poncho-ai/messaging";
 import Busboy from "busboy";
 import { Command } from "commander";
 import dotenv from "dotenv";
@@ -3509,12 +3513,17 @@ var buildConfigFromOnboardingAnswers = (answers) => {
     enabled: telemetryEnabled
   };
   maybeSet(telemetry, "otlp", answers["telemetry.otlp"]);
-  return {
+  const messagingPlatform = String(answers["messaging.platform"] ?? "none");
+  const config = {
     mcp: [],
     auth,
     storage,
     telemetry
   };
+  if (messagingPlatform !== "none") {
+    config.messaging = [{ platform: messagingPlatform }];
+  }
+  return config;
 };
 var collectEnvVars = (answers) => {
   const envVars = /* @__PURE__ */ new Set();
@@ -3658,11 +3667,13 @@ var summarizeConfig = (config) => {
   const memoryEnabled = config?.storage?.memory?.enabled ?? config?.memory?.enabled ?? false;
   const authRequired = config?.auth?.required ?? false;
   const telemetryEnabled = config?.telemetry?.enabled ?? true;
+  const messagingPlatforms = (config?.messaging ?? []).map((m) => m.platform);
   return [
     `storage: ${provider}`,
     `memory tools: ${memoryEnabled ? "enabled" : "disabled"}`,
     `auth: ${authRequired ? "required" : "not required"}`,
-    `telemetry: ${telemetryEnabled ? "enabled" : "disabled"}`
+    `telemetry: ${telemetryEnabled ? "enabled" : "disabled"}`,
+    ...messagingPlatforms.length > 0 ? [`messaging: ${messagingPlatforms.join(", ")}`] : []
   ];
 };
 var getOnboardingMarkerPath = async (workingDir) => {
@@ -3738,6 +3749,7 @@ var consumeFirstRunIntro = async (workingDir, input2) => {
     "- **Turn on telemetry**: Track usage with OpenTelemetry/OTLP",
     "- **Add MCP servers**: Connect external tool servers",
     "- **Schedule cron jobs**: Set up recurring tasks in AGENT.md frontmatter",
+    "- **Connect to Slack**: Set up messaging so users can @mention this agent in Slack",
     "",
     "Just let me know what you'd like to work on!\n"
   ].join("\n");
@@ -4181,6 +4193,24 @@ cron:
 - Docker/Fly.io: scheduler runs automatically.
 - Trigger manually: \`curl http://localhost:3000/api/cron/daily-report\`
 
+## Messaging (Slack)
+
+Connect your agent to Slack so it responds to @mentions:
+
+1. Create a Slack App at [api.slack.com/apps](https://api.slack.com/apps)
+2. Add Bot Token Scopes: \`app_mentions:read\`, \`chat:write\`, \`reactions:write\`
+3. Enable Event Subscriptions, set Request URL to \`https://<your-url>/api/messaging/slack\`, subscribe to \`app_mention\`
+4. Install to workspace, copy Bot Token and Signing Secret
+5. Set env vars:
+   \`\`\`
+   SLACK_BOT_TOKEN=xoxb-...
+   SLACK_SIGNING_SECRET=...
+   \`\`\`
+6. Add to \`poncho.config.js\`:
+   \`\`\`javascript
+   messaging: [{ platform: 'slack' }]
+   \`\`\`
+
 ## Deployment
 
 \`\`\`bash
@@ -4883,6 +4913,90 @@ var createRequestHandler = async (options) => {
     workingDir,
     agentId: identity.id
   });
+  const messagingRoutes = /* @__PURE__ */ new Map();
+  const messagingRouteRegistrar = (method, path, routeHandler) => {
+    let byMethod = messagingRoutes.get(path);
+    if (!byMethod) {
+      byMethod = /* @__PURE__ */ new Map();
+      messagingRoutes.set(path, byMethod);
+    }
+    byMethod.set(method, routeHandler);
+  };
+  const messagingRunner = {
+    async getOrCreateConversation(conversationId, meta) {
+      const existing = await conversationStore.get(conversationId);
+      if (existing) {
+        return { messages: existing.messages };
+      }
+      const now = Date.now();
+      const conversation = {
+        conversationId,
+        title: meta.title ?? `${meta.platform} thread`,
+        messages: [],
+        ownerId: meta.ownerId,
+        tenantId: null,
+        createdAt: now,
+        updatedAt: now
+      };
+      await conversationStore.update(conversation);
+      return { messages: [] };
+    },
+    async run(conversationId, input2) {
+      const output = await harness.runToCompletion({
+        task: input2.task,
+        messages: input2.messages
+      });
+      const response = output.result.response ?? "";
+      const conversation = await conversationStore.get(conversationId);
+      if (conversation) {
+        conversation.messages = [
+          ...input2.messages,
+          { role: "user", content: input2.task },
+          { role: "assistant", content: response }
+        ];
+        await conversationStore.update(conversation);
+      }
+      return { response };
+    }
+  };
+  const messagingBridges = [];
+  if (config?.messaging && config.messaging.length > 0) {
+    let waitUntilHook;
+    if (process.env.VERCEL) {
+      try {
+        const modName = "@vercel/functions";
+        const mod = await import(
+          /* webpackIgnore: true */
+          modName
+        );
+        waitUntilHook = mod.waitUntil;
+      } catch {
+      }
+    }
+    for (const channelConfig of config.messaging) {
+      if (channelConfig.platform === "slack") {
+        const adapter = new SlackAdapter({
+          botTokenEnv: channelConfig.botTokenEnv,
+          signingSecretEnv: channelConfig.signingSecretEnv
+        });
+        const bridge = new AgentBridge({
+          adapter,
+          runner: messagingRunner,
+          waitUntil: waitUntilHook
+        });
+        adapter.registerRoutes(messagingRouteRegistrar);
+        try {
+          await bridge.start();
+          messagingBridges.push(bridge);
+          console.log(`  Slack messaging enabled at /api/messaging/slack`);
+        } catch (err) {
+          console.warn(
+            `  Slack messaging disabled: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+    }
+  }
   const sessionStore = new SessionStore();
   const loginRateLimiter = new LoginRateLimiter();
   const authToken = process.env.PONCHO_AUTH_TOKEN ?? "";
@@ -4940,6 +5054,14 @@ var createRequestHandler = async (options) => {
       writeJson(response, 200, { status: "ok" });
       return;
     }
+    const messagingByMethod = messagingRoutes.get(pathname ?? "");
+    if (messagingByMethod) {
+      const routeHandler = messagingByMethod.get(request.method ?? "");
+      if (routeHandler) {
+        await routeHandler(request, response);
+        return;
+      }
+    }
     const cookies = parseCookies(request);
     const sessionId = cookies.poncho_session;
     const session = sessionId ? sessionStore.get(sessionId) : void 0;
@@ -6036,7 +6158,7 @@ var runInteractive = async (workingDir, params) => {
   await harness.initialize();
   const identity = await ensureAgentIdentity2(workingDir);
   try {
-    const { runInteractiveInk } = await import("./run-interactive-ink-64QEOUXL.js");
+    const { runInteractiveInk } = await import("./run-interactive-ink-VZBOYJYS.js");
     await runInteractiveInk({
       harness,
       params,

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "./chunk-XIFWXRUB.js";
+} from "./chunk-CUCEDHME.js";
 
 // src/cli.ts
 void main();

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   runTests,
   startDevServer,
   updateAgentGuidance
-} from "./chunk-XIFWXRUB.js";
+} from "./chunk-CUCEDHME.js";
 export {
   addSkill,
   buildCli,

package/dist/{run-interactive-ink-64QEOUXL.js → run-interactive-ink-VZBOYJYS.js}

@@ -2,7 +2,7 @@ import {
   consumeFirstRunIntro,
   inferConversationTitle,
   resolveHarnessEnvironment
-} from "./chunk-XIFWXRUB.js";
+} from "./chunk-CUCEDHME.js";
 
 // src/run-interactive-ink.ts
 import * as readline from "readline";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/cli",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "CLI for building and deploying AI agents",
   "repository": {
     "type": "git",
@@ -27,8 +27,9 @@
     "react": "^19.2.4",
     "react-devtools-core": "^6.1.5",
     "yaml": "^2.8.1",
-    "@poncho-ai/harness": "0.13.0",
-    "@poncho-ai/sdk": "1.0.0"
+    "@poncho-ai/messaging": "0.2.0",
+    "@poncho-ai/harness": "0.13.1",
+    "@poncho-ai/sdk": "1.0.1"
   },
   "devDependencies": {
     "@types/busboy": "^1.5.4",

package/src/index.ts

@@ -29,6 +29,13 @@ import {
 } from "@poncho-ai/harness";
 import type { AgentEvent, FileInput, Message, RunInput } from "@poncho-ai/sdk";
 import { getTextContent } from "@poncho-ai/sdk";
+import {
+  AgentBridge,
+  SlackAdapter,
+  type AgentRunner,
+  type MessagingAdapter,
+  type RouteRegistrar,
+} from "@poncho-ai/messaging";
 import Busboy from "busboy";
 import { Command } from "commander";
 import dotenv from "dotenv";
@@ -567,6 +574,24 @@ cron:
 - Docker/Fly.io: scheduler runs automatically.
 - Trigger manually: \`curl http://localhost:3000/api/cron/daily-report\`
 
+## Messaging (Slack)
+
+Connect your agent to Slack so it responds to @mentions:
+
+1. Create a Slack App at [api.slack.com/apps](https://api.slack.com/apps)
+2. Add Bot Token Scopes: \`app_mentions:read\`, \`chat:write\`, \`reactions:write\`
+3. Enable Event Subscriptions, set Request URL to \`https://<your-url>/api/messaging/slack\`, subscribe to \`app_mention\`
+4. Install to workspace, copy Bot Token and Signing Secret
+5. Set env vars:
+   \`\`\`
+   SLACK_BOT_TOKEN=xoxb-...
+   SLACK_SIGNING_SECRET=...
+   \`\`\`
+6. Add to \`poncho.config.js\`:
+   \`\`\`javascript
+   messaging: [{ platform: 'slack' }]
+   \`\`\`
+
 ## Deployment
 
 \`\`\`bash
@@ -1371,6 +1396,100 @@ export const createRequestHandler = async (options?: {
     workingDir,
     agentId: identity.id,
   });
+  // ---------------------------------------------------------------------------
+  // Messaging adapters (Slack, etc.) — routes bypass Poncho auth; each
+  // adapter handles its own request verification (e.g. Slack signing secret).
+  // ---------------------------------------------------------------------------
+  const messagingRoutes = new Map<string, Map<string, (req: IncomingMessage, res: ServerResponse) => Promise<void>>>();
+  const messagingRouteRegistrar: RouteRegistrar = (method, path, routeHandler) => {
+    let byMethod = messagingRoutes.get(path);
+    if (!byMethod) {
+      byMethod = new Map();
+      messagingRoutes.set(path, byMethod);
+    }
+    byMethod.set(method, routeHandler);
+  };
+
+  const messagingRunner: AgentRunner = {
+    async getOrCreateConversation(conversationId, meta) {
+      const existing = await conversationStore.get(conversationId);
+      if (existing) {
+        return { messages: existing.messages };
+      }
+      const now = Date.now();
+      const conversation = {
+        conversationId,
+        title: meta.title ?? `${meta.platform} thread`,
+        messages: [] as Message[],
+        ownerId: meta.ownerId,
+        tenantId: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      await conversationStore.update(conversation);
+      return { messages: [] };
+    },
+    async run(conversationId, input) {
+      const output = await harness.runToCompletion({
+        task: input.task,
+        messages: input.messages,
+      });
+      const response = output.result.response ?? "";
+
+      const conversation = await conversationStore.get(conversationId);
+      if (conversation) {
+        conversation.messages = [
+          ...input.messages,
+          { role: "user" as const, content: input.task },
+          { role: "assistant" as const, content: response },
+        ];
+        await conversationStore.update(conversation);
+      }
+
+      return { response };
+    },
+  };
+
+  const messagingBridges: AgentBridge[] = [];
+  if (config?.messaging && config.messaging.length > 0) {
+    let waitUntilHook: ((promise: Promise<unknown>) => void) | undefined;
+    if (process.env.VERCEL) {
+      try {
+        // Dynamic require via variable so TypeScript doesn't attempt static
+        // resolution of @vercel/functions (only present in Vercel deployments).
+        const modName = "@vercel/functions";
+        const mod = await import(/* webpackIgnore: true */ modName);
+        waitUntilHook = mod.waitUntil;
+      } catch {
+        // @vercel/functions not installed -- fall through to no-op.
+      }
+    }
+
+    for (const channelConfig of config.messaging) {
+      if (channelConfig.platform === "slack") {
+        const adapter = new SlackAdapter({
+          botTokenEnv: channelConfig.botTokenEnv,
+          signingSecretEnv: channelConfig.signingSecretEnv,
+        });
+        const bridge = new AgentBridge({
+          adapter,
+          runner: messagingRunner,
+          waitUntil: waitUntilHook,
+        });
+        adapter.registerRoutes(messagingRouteRegistrar);
+        try {
+          await bridge.start();
+          messagingBridges.push(bridge);
+          console.log(`  Slack messaging enabled at /api/messaging/slack`);
+        } catch (err) {
+          console.warn(
+            `  Slack messaging disabled: ${err instanceof Error ? err.message : String(err)}`,
+          );
+        }
+      }
+    }
+  }
+
   const sessionStore = new SessionStore();
   const loginRateLimiter = new LoginRateLimiter();
 
@@ -1442,6 +1561,17 @@ export const createRequestHandler = async (options?: {
       return;
     }
 
+    // Messaging adapter routes bypass Poncho auth (they verify requests
+    // using platform-specific mechanisms, e.g. Slack signing secret).
+    const messagingByMethod = messagingRoutes.get(pathname ?? "");
+    if (messagingByMethod) {
+      const routeHandler = messagingByMethod.get(request.method ?? "");
+      if (routeHandler) {
+        await routeHandler(request, response);
+        return;
+      }
+    }
+
     const cookies = parseCookies(request);
     const sessionId = cookies.poncho_session;
     const session = sessionId ? sessionStore.get(sessionId) : undefined;

package/src/init-feature-context.ts

@@ -29,11 +29,15 @@ const summarizeConfig = (config: PonchoConfig | undefined): string[] => {
   const memoryEnabled = config?.storage?.memory?.enabled ?? config?.memory?.enabled ?? false;
   const authRequired = config?.auth?.required ?? false;
   const telemetryEnabled = config?.telemetry?.enabled ?? true;
+  const messagingPlatforms = (config?.messaging ?? []).map((m) => m.platform);
   return [
     `storage: ${provider}`,
     `memory tools: ${memoryEnabled ? "enabled" : "disabled"}`,
     `auth: ${authRequired ? "required" : "not required"}`,
     `telemetry: ${telemetryEnabled ? "enabled" : "disabled"}`,
+    ...(messagingPlatforms.length > 0
+      ? [`messaging: ${messagingPlatforms.join(", ")}`]
+      : []),
   ];
 };
 
@@ -127,6 +131,7 @@ export const consumeFirstRunIntro = async (
     "- **Turn on telemetry**: Track usage with OpenTelemetry/OTLP",
     "- **Add MCP servers**: Connect external tool servers",
     "- **Schedule cron jobs**: Set up recurring tasks in AGENT.md frontmatter",
+    "- **Connect to Slack**: Set up messaging so users can @mention this agent in Slack",
     "",
     "Just let me know what you'd like to work on!\n",
   ].join("\n");

package/src/init-onboarding.ts

@@ -339,12 +339,20 @@ export const buildConfigFromOnboardingAnswers = (
   };
   maybeSet(telemetry, "otlp", answers["telemetry.otlp"]);
 
-  return {
+  const messagingPlatform = String(answers["messaging.platform"] ?? "none");
+
+  const config: PonchoConfig = {
     mcp: [],
     auth,
     storage,
     telemetry,
   };
+
+  if (messagingPlatform !== "none") {
+    config.messaging = [{ platform: messagingPlatform as "slack" }];
+  }
+
+  return config;
 };
 
 export const isDefaultOnboardingConfig = (
@@ -354,7 +362,7 @@ export const isDefaultOnboardingConfig = (
     return true;
   }
   const topLevelKeys = Object.keys(config);
-  const allowedTopLevel = new Set(["mcp", "auth", "storage", "telemetry"]);
+  const allowedTopLevel = new Set(["mcp", "auth", "storage", "telemetry", "messaging"]);
   if (topLevelKeys.some((key) => !allowedTopLevel.has(key))) {
     return false;
   }