@agent-native/dispatch 0.1.1

package/src/db/index.ts

@@ -0,0 +1,12 @@
+import { createGetDb } from "@agent-native/core/db";
+import * as schema from "./schema.js";
+
+export const getDb = createGetDb(schema);
+
+export function db() {
+  return getDb();
+}
+
+export { schema };
+export * from "./schema.js";
+export * from "./migrations.js";

package/src/db/migrations.ts

@@ -0,0 +1,165 @@
+export const dispatchMigrations: Array<{ version: number; sql: string }> = [
+  {
+    version: 1,
+    sql: `
+      CREATE TABLE IF NOT EXISTS dispatch_destinations (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        name TEXT NOT NULL,
+        platform TEXT NOT NULL,
+        destination TEXT NOT NULL,
+        thread_ref TEXT,
+        notes TEXT,
+        created_by TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS dispatch_identity_links (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        platform TEXT NOT NULL,
+        external_user_id TEXT NOT NULL,
+        external_user_name TEXT,
+        linked_by TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS dispatch_link_tokens (
+        id TEXT PRIMARY KEY,
+        token TEXT NOT NULL,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        platform TEXT NOT NULL,
+        created_by TEXT NOT NULL,
+        expires_at INTEGER NOT NULL,
+        claimed_at INTEGER,
+        claimed_by_external_user_id TEXT,
+        claimed_by_external_user_name TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS dispatch_approval_requests (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        change_type TEXT NOT NULL,
+        target_type TEXT NOT NULL,
+        target_id TEXT,
+        status TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        before_value TEXT,
+        after_value TEXT,
+        requested_by TEXT NOT NULL,
+        reviewed_by TEXT,
+        reviewed_at INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS dispatch_audit_events (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        actor TEXT NOT NULL,
+        action TEXT NOT NULL,
+        target_type TEXT NOT NULL,
+        target_id TEXT,
+        summary TEXT NOT NULL,
+        metadata TEXT,
+        created_at INTEGER NOT NULL
+      );
+    `,
+  },
+  {
+    version: 2,
+    sql: `
+      CREATE TABLE IF NOT EXISTS vault_secrets (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        name TEXT NOT NULL,
+        credential_key TEXT NOT NULL,
+        value TEXT NOT NULL,
+        provider TEXT,
+        description TEXT,
+        created_by TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS vault_grants (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        secret_id TEXT NOT NULL,
+        app_id TEXT NOT NULL,
+        granted_by TEXT NOT NULL,
+        status TEXT NOT NULL,
+        synced_at INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS vault_requests (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        credential_key TEXT NOT NULL,
+        app_id TEXT NOT NULL,
+        reason TEXT,
+        requested_by TEXT NOT NULL,
+        status TEXT NOT NULL,
+        reviewed_by TEXT,
+        reviewed_at INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS vault_audit_log (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        secret_id TEXT,
+        app_id TEXT,
+        action TEXT NOT NULL,
+        actor TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        metadata TEXT,
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS workspace_resources (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        kind TEXT NOT NULL,
+        name TEXT NOT NULL,
+        description TEXT,
+        path TEXT NOT NULL,
+        content TEXT NOT NULL,
+        scope TEXT NOT NULL,
+        created_by TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS workspace_resource_grants (
+        id TEXT PRIMARY KEY,
+        owner_email TEXT NOT NULL,
+        org_id TEXT,
+        resource_id TEXT NOT NULL,
+        app_id TEXT NOT NULL,
+        status TEXT NOT NULL,
+        synced_at INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+    `,
+  },
+];

package/src/db/schema.ts

@@ -0,0 +1,160 @@
+import { table, text, integer } from "@agent-native/core/db/schema";
+
+export const dispatchDestinations = table("dispatch_destinations", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  name: text("name").notNull(),
+  platform: text("platform").notNull(),
+  destination: text("destination").notNull(),
+  threadRef: text("thread_ref"),
+  notes: text("notes"),
+  createdBy: text("created_by").notNull(),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const dispatchIdentityLinks = table("dispatch_identity_links", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  platform: text("platform").notNull(),
+  externalUserId: text("external_user_id").notNull(),
+  externalUserName: text("external_user_name"),
+  linkedBy: text("linked_by").notNull(),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const dispatchLinkTokens = table("dispatch_link_tokens", {
+  id: text("id").primaryKey(),
+  token: text("token").notNull(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  platform: text("platform").notNull(),
+  createdBy: text("created_by").notNull(),
+  expiresAt: integer("expires_at").notNull(),
+  claimedAt: integer("claimed_at"),
+  claimedByExternalUserId: text("claimed_by_external_user_id"),
+  claimedByExternalUserName: text("claimed_by_external_user_name"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const dispatchApprovalRequests = table("dispatch_approval_requests", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  changeType: text("change_type").notNull(),
+  targetType: text("target_type").notNull(),
+  targetId: text("target_id"),
+  status: text("status").notNull(),
+  summary: text("summary").notNull(),
+  payload: text("payload").notNull(),
+  beforeValue: text("before_value"),
+  afterValue: text("after_value"),
+  requestedBy: text("requested_by").notNull(),
+  reviewedBy: text("reviewed_by"),
+  reviewedAt: integer("reviewed_at"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const dispatchAuditEvents = table("dispatch_audit_events", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  actor: text("actor").notNull(),
+  action: text("action").notNull(),
+  targetType: text("target_type").notNull(),
+  targetId: text("target_id"),
+  summary: text("summary").notNull(),
+  metadata: text("metadata"),
+  createdAt: integer("created_at").notNull(),
+});
+
+// ─── Vault: workspace-wide secret management ───────────────────────
+
+export const vaultSecrets = table("vault_secrets", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  name: text("name").notNull(),
+  credentialKey: text("credential_key").notNull(),
+  value: text("value").notNull(),
+  provider: text("provider"),
+  description: text("description"),
+  createdBy: text("created_by").notNull(),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const vaultGrants = table("vault_grants", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  secretId: text("secret_id").notNull(),
+  appId: text("app_id").notNull(),
+  grantedBy: text("granted_by").notNull(),
+  status: text("status").notNull(),
+  syncedAt: integer("synced_at"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const vaultRequests = table("vault_requests", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  credentialKey: text("credential_key").notNull(),
+  appId: text("app_id").notNull(),
+  reason: text("reason"),
+  requestedBy: text("requested_by").notNull(),
+  status: text("status").notNull(),
+  reviewedBy: text("reviewed_by"),
+  reviewedAt: integer("reviewed_at"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const vaultAuditLog = table("vault_audit_log", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  secretId: text("secret_id"),
+  appId: text("app_id"),
+  action: text("action").notNull(),
+  actor: text("actor").notNull(),
+  summary: text("summary").notNull(),
+  metadata: text("metadata"),
+  createdAt: integer("created_at").notNull(),
+});
+
+// ─── Workspace Resources: shared skills, instructions, agents ──────
+
+export const workspaceResources = table("workspace_resources", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  kind: text("kind").notNull(), // "skill" | "instruction" | "agent"
+  name: text("name").notNull(),
+  description: text("description"),
+  path: text("path").notNull(), // resource path, e.g. "skills/designer.md"
+  content: text("content").notNull(),
+  scope: text("scope").notNull(), // "all" (push to all apps) | "selected" (grant per-app)
+  createdBy: text("created_by").notNull(),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});
+
+export const workspaceResourceGrants = table("workspace_resource_grants", {
+  id: text("id").primaryKey(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  resourceId: text("resource_id").notNull(),
+  appId: text("app_id").notNull(),
+  status: text("status").notNull(), // "active" | "revoked"
+  syncedAt: integer("synced_at"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull(),
+});

package/src/hooks/use-mobile.tsx

@@ -0,0 +1,21 @@
+import * as React from "react";
+
+const MOBILE_BREAKPOINT = 768;
+
+export function useIsMobile() {
+  const [isMobile, setIsMobile] = React.useState<boolean | undefined>(
+    undefined,
+  );
+
+  React.useEffect(() => {
+    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
+    const onChange = () => {
+      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    };
+    mql.addEventListener("change", onChange);
+    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
+
+  return !!isMobile;
+}

package/src/hooks/use-navigation-state.ts

@@ -0,0 +1,132 @@
+import { useEffect } from "react";
+import { useLocation, useNavigate } from "react-router";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  agentNativePath,
+  appBasePath,
+  appPath,
+} from "@agent-native/core/client";
+
+export interface NavigationState {
+  view: string;
+  path?: string;
+}
+
+export function useNavigationState() {
+  const location = useLocation();
+  const navigate = useNavigate();
+  const qc = useQueryClient();
+
+  // Sync current route to application state
+  useEffect(() => {
+    const state: NavigationState = {
+      view: resolveView(location.pathname),
+      path: appPath(location.pathname),
+    };
+
+    fetch(agentNativePath("/_agent-native/application-state/navigation"), {
+      method: "PUT",
+      keepalive: true,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(state),
+    }).catch(() => {});
+  }, [location.pathname]);
+
+  // Listen for navigate commands from agent
+  const { data: navCommand } = useQuery({
+    queryKey: ["navigate-command"],
+    queryFn: async () => {
+      const res = await fetch(
+        agentNativePath("/_agent-native/application-state/navigate"),
+      );
+      if (!res.ok) return null;
+      const data = await res.json();
+      if (data) {
+        // Return with a timestamp to ensure uniqueness
+        return { ...data, _ts: Date.now() };
+      }
+      return null;
+    },
+    refetchInterval: 2_000,
+    refetchIntervalInBackground: true,
+    structuralSharing: false,
+  });
+
+  useEffect(() => {
+    if (!navCommand) return;
+    // Delete the one-shot command AFTER reading it
+    fetch(agentNativePath("/_agent-native/application-state/navigate"), {
+      method: "DELETE",
+      headers: { "X-Agent-Native-CSRF": "1" },
+    }).catch(() => {});
+    const cmd = navCommand as NavigationState;
+
+    // Navigate to a specific path or resolve view name to path
+    const path = routerPath(cmd.path || resolvePath(cmd.view) || "/overview");
+    navigate(path);
+    qc.setQueryData(["navigate-command"], null);
+  }, [navCommand, navigate, qc]);
+}
+
+function routerPath(path: string): string {
+  const basePath = appBasePath();
+  if (!basePath) return path;
+  if (path === basePath) return "/";
+  if (path.startsWith(`${basePath}/`)) {
+    return path.slice(basePath.length) || "/";
+  }
+  return path;
+}
+
+function resolveView(pathname: string): string {
+  if (pathname.startsWith("/apps")) return "apps";
+  if (pathname.startsWith("/new-app")) return "new-app";
+  if (pathname.startsWith("/vault")) return "vault";
+  if (pathname.startsWith("/integrations")) return "integrations";
+  if (pathname.startsWith("/workspace")) return "workspace";
+  if (pathname.startsWith("/agents")) return "agents";
+  if (pathname.startsWith("/messaging")) return "messaging";
+  if (pathname.startsWith("/destinations")) return "destinations";
+  if (pathname.startsWith("/identities")) return "identities";
+  if (pathname.startsWith("/approvals")) return "approvals";
+  if (pathname.startsWith("/audit")) return "audit";
+  if (pathname.startsWith("/team")) return "team";
+  return "overview";
+}
+
+function resolvePath(view?: string): string | undefined {
+  switch (view) {
+    case "overview":
+      return "/overview";
+    case "apps":
+      return "/apps";
+    case "new-app":
+    case "create-app":
+      return "/new-app";
+    case "vault":
+    case "secrets":
+      return "/vault";
+    case "integrations":
+      return "/integrations";
+    case "workspace":
+    case "resources":
+      return "/workspace";
+    case "agents":
+      return "/agents";
+    case "messaging":
+      return "/messaging";
+    case "destinations":
+    case "routes":
+      return "/destinations";
+    case "identities":
+      return "/identities";
+    case "approvals":
+      return "/approvals";
+    case "audit":
+      return "/audit";
+    case "team":
+      return "/team";
+    default:
+      return undefined;
+  }
+}

package/src/hooks/use-toast.ts

@@ -0,0 +1,188 @@
+import * as React from "react";
+
+import type { ToastActionElement, ToastProps } from "@/components/ui/toast";
+
+const TOAST_LIMIT = 1;
+const TOAST_REMOVE_DELAY = 1000000;
+
+type ToasterToast = ToastProps & {
+  id: string;
+  title?: React.ReactNode;
+  description?: React.ReactNode;
+  action?: ToastActionElement;
+};
+
+const actionTypes = {
+  ADD_TOAST: "ADD_TOAST",
+  UPDATE_TOAST: "UPDATE_TOAST",
+  DISMISS_TOAST: "DISMISS_TOAST",
+  REMOVE_TOAST: "REMOVE_TOAST",
+} as const;
+
+let count = 0;
+
+function genId() {
+  count = (count + 1) % Number.MAX_SAFE_INTEGER;
+  return count.toString();
+}
+
+type ActionType = typeof actionTypes;
+
+type Action =
+  | {
+      type: ActionType["ADD_TOAST"];
+      toast: ToasterToast;
+    }
+  | {
+      type: ActionType["UPDATE_TOAST"];
+      toast: Partial<ToasterToast>;
+    }
+  | {
+      type: ActionType["DISMISS_TOAST"];
+      toastId?: ToasterToast["id"];
+    }
+  | {
+      type: ActionType["REMOVE_TOAST"];
+      toastId?: ToasterToast["id"];
+    };
+
+interface State {
+  toasts: ToasterToast[];
+}
+
+const toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();
+
+const addToRemoveQueue = (toastId: string) => {
+  if (toastTimeouts.has(toastId)) {
+    return;
+  }
+
+  const timeout = setTimeout(() => {
+    toastTimeouts.delete(toastId);
+    dispatch({
+      type: "REMOVE_TOAST",
+      toastId: toastId,
+    });
+  }, TOAST_REMOVE_DELAY);
+
+  toastTimeouts.set(toastId, timeout);
+};
+
+export const reducer = (state: State, action: Action): State => {
+  switch (action.type) {
+    case "ADD_TOAST":
+      return {
+        ...state,
+        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),
+      };
+
+    case "UPDATE_TOAST":
+      return {
+        ...state,
+        toasts: state.toasts.map((t) =>
+          t.id === action.toast.id ? { ...t, ...action.toast } : t,
+        ),
+      };
+
+    case "DISMISS_TOAST": {
+      const { toastId } = action;
+
+      // ! Side effects ! - This could be extracted into a dismissToast() action,
+      // but I'll keep it here for simplicity
+      if (toastId) {
+        addToRemoveQueue(toastId);
+      } else {
+        state.toasts.forEach((toast) => {
+          addToRemoveQueue(toast.id);
+        });
+      }
+
+      return {
+        ...state,
+        toasts: state.toasts.map((t) =>
+          t.id === toastId || toastId === undefined
+            ? {
+                ...t,
+                open: false,
+              }
+            : t,
+        ),
+      };
+    }
+    case "REMOVE_TOAST":
+      if (action.toastId === undefined) {
+        return {
+          ...state,
+          toasts: [],
+        };
+      }
+      return {
+        ...state,
+        toasts: state.toasts.filter((t) => t.id !== action.toastId),
+      };
+  }
+};
+
+const listeners: Array<(state: State) => void> = [];
+
+let memoryState: State = { toasts: [] };
+
+function dispatch(action: Action) {
+  memoryState = reducer(memoryState, action);
+  listeners.forEach((listener) => {
+    listener(memoryState);
+  });
+}
+
+type Toast = Omit<ToasterToast, "id">;
+
+function toast({ ...props }: Toast) {
+  const id = genId();
+
+  const update = (props: ToasterToast) =>
+    dispatch({
+      type: "UPDATE_TOAST",
+      toast: { ...props, id },
+    });
+  const dismiss = () => dispatch({ type: "DISMISS_TOAST", toastId: id });
+
+  dispatch({
+    type: "ADD_TOAST",
+    toast: {
+      ...props,
+      id,
+      open: true,
+      onOpenChange: (open) => {
+        if (!open) dismiss();
+      },
+    },
+  });
+
+  return {
+    id: id,
+    dismiss,
+    update,
+  };
+}
+
+function useToast() {
+  const [state, setState] = React.useState<State>(memoryState);
+
+  React.useEffect(() => {
+    listeners.push(setState);
+    return () => {
+      const index = listeners.indexOf(setState);
+      if (index > -1) {
+        listeners.splice(index, 1);
+      }
+    };
+  }, [state]);
+
+  return {
+    ...state,
+    toast,
+    dismiss: (toastId?: string) => dispatch({ type: "DISMISS_TOAST", toastId }),
+  };
+}
+
+export { useToast, toast };

package/src/index.ts

@@ -0,0 +1,19 @@
+/**
+ * @agent-native/dispatch — workspace control plane for agent-native apps.
+ *
+ * Most consumers import from one of the subpaths instead of this top-level
+ * entry, since each subpath has different runtime needs (server vs client):
+ *
+ *   import { dispatchRoutes } from "@agent-native/dispatch/routes";
+ *   import { setupDispatch } from "@agent-native/dispatch/server";
+ *   import { dispatchSchema, dispatchMigrations } from "@agent-native/dispatch/db";
+ *
+ * The top-level export only re-exports the universal config types so callers
+ * can write `DispatchConfig` once and reuse across server/client modules.
+ */
+
+export type {
+  DispatchConfig,
+  DispatchAuthConfig,
+  DispatchIntegrationsConfig,
+} from "./config.js";

package/src/lib/utils.ts

@@ -0,0 +1 @@
+export { cn } from "@agent-native/core";