@agent-native/dispatch 0.13.13 → 0.14.1

package/src/server/lib/dispatch-routing.spec.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from "vitest";
+
+import { dispatchIntegrationRoutingHint } from "./dispatch-routing.js";
+
+describe("dispatchIntegrationRoutingHint", () => {
+  it.each([
+    "File a security review request for the platform team",
+    "Add this hiring ask to the intake board",
+    "Add two design tasks for the launch page",
+    "Create a design task for the new onboarding flow",
+    "Create a vendor request form with the required fields",
+    "What is currently in the editorial requests queue?",
+  ])(
+    "resolves structured intake through workspace capabilities: %s",
+    (text) => {
+      const hint = dispatchIntegrationRoutingHint(text);
+      expect(hint?.targetAgent).toBeUndefined();
+      expect(hint?.instruction).toContain("workspace instructions/resources");
+      expect(hint?.instruction).toContain("do not assume a particular app");
+    },
+  );
+
+  it.each([
+    "Design a homepage for the launch",
+    "Create a visual mockup for this settings screen",
+    "Redesign the product UI",
+  ])("routes visual output to Design: %s", (text) => {
+    expect(dispatchIntegrationRoutingHint(text)).toMatchObject({
+      targetAgent: "design",
+    });
+  });
+
+  it("lets unrelated domain questions use normal agent discovery", () => {
+    expect(
+      dispatchIntegrationRoutingHint(
+        "What were the reasons for closed-lost deals this quarter?",
+      ),
+    ).toBeUndefined();
+  });
+
+  it("leaves organization-specific shorthand to learned workspace instructions", () => {
+    expect(dispatchIntegrationRoutingHint("Apoorva queue")).toBeUndefined();
+  });
+});

package/src/server/lib/dispatch-routing.ts

@@ -0,0 +1,42 @@
+const STRUCTURED_INTAKE_PATTERNS = [
+  /\b(?:file|submit|add|log|track|triage|prioriti[sz]e|create)\b.{0,64}\b(?:asks?|requests?|tickets?|tasks?|intake)\b/i,
+  /\b(?:asks?|requests?|tickets?|intake)\b.{0,64}\b(?:database|table|board|form|queue|priority|deadline|urgency)\b/i,
+  /\b(?:database|table|board|form|queue)\b.{0,64}\b(?:asks?|requests?|tickets?|intake|priority|deadline|urgency)\b/i,
+];
+
+const VISUAL_DESIGN_PATTERNS = [
+  /\b(?:design|redesign|create|make|generate|mock(?:\s+up)?)\b.{0,64}\b(?:visual|mockup|wireframe|screen|interface|ui|website|landing\s+page|homepage|logo|graphic|illustration)\b/i,
+  /\b(?:visual|ui|website|product|brand)\s+design\b/i,
+];
+
+export interface DispatchIntegrationRoutingHint {
+  targetAgent?: string;
+  instruction: string;
+}
+
+export function dispatchIntegrationRoutingHint(
+  text: string,
+): DispatchIntegrationRoutingHint | undefined {
+  const normalized = text.replace(/\s+/g, " ").trim();
+  if (!normalized) return undefined;
+
+  // Route by the requested artifact type, not organization-specific names.
+  // Exact destinations, schemas, and required fields come from workspace
+  // resources such as shared LEARNINGS.md rather than this classifier.
+  if (STRUCTURED_INTAKE_PATTERNS.some((pattern) => pattern.test(normalized))) {
+    return {
+      instruction:
+        "Resolve this structured-intake request from loaded workspace instructions/resources and discovered app capabilities. Follow any workspace-defined canonical destination and form contract; do not assume a particular app, database, schema, or owner. Preserve the source thread URL, submit once, verify the saved record, and return its exact link.",
+    };
+  }
+
+  if (VISUAL_DESIGN_PATTERNS.some((pattern) => pattern.test(normalized))) {
+    return {
+      targetAgent: "design",
+      instruction:
+        "Delegate to Design because the requested output is a visual design, mockup, or interface rather than an intake record.",
+    };
+  }
+
+  return undefined;
+}

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

package/src/styles/dispatch-css.spec.ts

@@ -62,4 +62,15 @@ describe("dispatch route shells", () => {
 
     expect(chatRoute).toContain("@agent-native/dispatch/routes/pages/chat");
   });
+
+  it("re-exports the operations console from the Dispatch template", () => {
+    const operationsRoute = fs.readFileSync(
+      path.join(repoRoot, "templates/dispatch/app/routes/operations.tsx"),
+      "utf-8",
+    );
+
+    expect(operationsRoute).toContain(
+      "@agent-native/dispatch/routes/pages/operations",
+    );
+  });
 });