@agent-native/dispatch 0.13.12 → 0.14.0

package/src/server/lib/env-config.ts

@@ -4,6 +4,16 @@ export const envKeys: EnvKeyConfig[] = [
   {
     key: "SLACK_BOT_TOKEN",
     label: "Slack bot token",
+    required: false,
+  },
+  {
+    key: "SLACK_CLIENT_ID",
+    label: "Slack OAuth client ID",
+    required: true,
+  },
+  {
+    key: "SLACK_CLIENT_SECRET",
+    label: "Slack OAuth client secret",
     required: true,
   },
   {
@@ -16,6 +26,41 @@ export const envKeys: EnvKeyConfig[] = [
     label: "Telegram bot token",
     required: true,
   },
+  {
+    key: "TELEGRAM_WEBHOOK_SECRET",
+    label: "Telegram webhook secret",
+    required: true,
+  },
+  {
+    key: "MICROSOFT_TEAMS_APP_ID",
+    label: "Microsoft Bot app ID",
+    required: false,
+  },
+  {
+    key: "MICROSOFT_TEAMS_APP_PASSWORD",
+    label: "Microsoft Bot client secret",
+    required: false,
+  },
+  {
+    key: "MICROSOFT_TEAMS_APP_TENANT_ID",
+    label: "Microsoft Bot tenant ID",
+    required: false,
+  },
+  {
+    key: "MICROSOFT_TEAMS_ALLOWED_TENANT_IDS",
+    label: "Allowed Microsoft Teams tenant IDs",
+    required: false,
+  },
+  {
+    key: "DISCORD_APPLICATION_ID",
+    label: "Discord application ID",
+    required: false,
+  },
+  {
+    key: "DISCORD_PUBLIC_KEY",
+    label: "Discord public key",
+    required: false,
+  },
   {
     key: "EMAIL_AGENT_ADDRESS",
     label: "Agent email address",
@@ -41,6 +86,11 @@ export const envKeys: EnvKeyConfig[] = [
     label: "WhatsApp phone number ID",
     required: false,
   },
+  {
+    key: "WHATSAPP_APP_SECRET",
+    label: "WhatsApp app secret",
+    required: false,
+  },
   {
     key: "PYLON_API_KEY",
     label: "Pylon API key",

package/src/server/lib/onboarding-steps.ts

@@ -9,7 +9,12 @@
  * their first workspace app first.
  */
 
+import { listIntegrationInstallations } from "@agent-native/core/integrations";
 import { registerOnboardingStep } from "@agent-native/core/onboarding";
+import {
+  getRequestOrgId,
+  getRequestUserEmail,
+} from "@agent-native/core/server/request-context";
 
 import { listWorkspaceApps } from "./app-creation-store.js";
 
@@ -47,4 +52,31 @@ export function registerDispatchOnboardingSteps(): void {
       }
     },
   });
+
+  registerOnboardingStep({
+    id: "dispatch:connect-slack-workspace",
+    title: "Connect a Slack workspace",
+    description:
+      "Install Agent Native with OAuth, then configure channel identities and access policies.",
+    order: 60,
+    required: false,
+    methods: [
+      {
+        id: "open-messaging",
+        kind: "link",
+        primary: true,
+        label: "Open Messaging",
+        payload: { url: "/messaging", external: false },
+      },
+    ],
+    isComplete: async () => {
+      const userEmail = getRequestUserEmail();
+      if (!userEmail) return false;
+      const rows = await listIntegrationInstallations(
+        { userEmail, orgId: getRequestOrgId() ?? null },
+        "slack",
+      ).catch(() => []);
+      return rows.some((row) => row.status === "connected");
+    },
+  });
 }

package/src/server/plugins/integrations.ts

@@ -4,7 +4,7 @@ import { dispatchActions } from "../../actions/index.js";
 import { getDispatchConfig } from "../index.js";
 import {
   beforeDispatchProcess,
-  resolveDispatchOwner,
+  resolveDispatchExecutionContext,
 } from "../lib/dispatch-integrations.js";
 
 const dispatchIntegrationActions = {
@@ -32,6 +32,9 @@ Default posture:
 
 When a user asks for something:
 - If it belongs to analytics, content, slides, clips, assets, etc., delegate via call-agent — do not re-implement the domain logic in dispatch.
+- Synthetic uptime, health-check, and URL-availability monitors belong to Analytics, even when the monitored target is another app such as Clips. Delegate creation to Analytics and relay its exact monitor URL. Dispatch-native recurring jobs are for reminders, digests, and agent workflows, not HTTP uptime probes.
+- Route by the requested artifact type, not by organization-specific names stored in code. For structured records, databases, tables, queues, boards, and intake forms, resolve the owning app and canonical destination from loaded workspace instructions/resources plus discovered app capabilities; do not assume Content, a database ID, schema, owner, or required fields. Visual designs, mockups, wireframes, screens, and interfaces belong to Design. A trusted Required target agent hint in integration context is authoritative.
+- When delegating structured intake to the resolved owning app, preserve the exact Source thread URL and the workspace instruction context, inspect the destination's current required fields, ask only for missing values, submit once, verify the saved record, and return the exact link.
 - In messaging integrations, use call-agent for cross-app delegation; do not use ask_app.
 - After call-agent returns an answer, RELAY IT DIRECTLY to the user with at most a one-line preface — do not rephrase, summarize, or add commentary. The downstream agent already crafted the answer; your job is delivery, not editing. This minimizes round-trips and keeps the user-visible reply fast.
 - Exception: if the downstream agent reports a missing model/provider credential, do not name exact env vars, Vault keys, tokens, or secrets. Say the target app needs an LLM connection and recommend connecting Builder/managed LLM for that app; keep bring-your-own provider keys as a secondary option only if the user asks.
@@ -62,7 +65,7 @@ const dispatchIntegrationsPlugin = async (nitroApp: any) => {
   const plugin = createIntegrationsPlugin({
     appId: "dispatch",
     actions: dispatchIntegrationActions,
-    resolveOwner: resolveDispatchOwner,
+    resolveExecutionContext: resolveDispatchExecutionContext,
     beforeProcess: beforeDispatchProcess,
     systemPrompt,
     // Inherit the framework default (claude-sonnet-4-6 from