@palettelab/sdk 0.1.15 → 0.1.17

package/dist/index.mjs

@@ -110,6 +110,32 @@ async function updateInstallConfig(pluginId, config) {
   return res.json();
 }
 
+// src/connections.ts
+async function getConnections(pluginId) {
+  const res = await apiFetch(`/api/v1/app-installs/${encodeURIComponent(pluginId)}/connections`);
+  return res.json();
+}
+async function startConnection(pluginId, connectionId) {
+  const res = await apiFetch(
+    `/api/v1/app-installs/${encodeURIComponent(pluginId)}/connections/${encodeURIComponent(connectionId)}/authorize`,
+    { method: "POST" }
+  );
+  return res.json();
+}
+async function disconnectConnection(pluginId, connectionId) {
+  await apiFetch(
+    `/api/v1/app-installs/${encodeURIComponent(pluginId)}/connections/${encodeURIComponent(connectionId)}`,
+    { method: "DELETE" }
+  );
+}
+async function requireConnection(pluginId, connectionId) {
+  const connection = (await getConnections(pluginId)).find((item) => item.id === connectionId);
+  if (!connection || !["connected", "expiring"].includes(connection.status)) {
+    throw new Error(`Palette connection is not configured: ${connectionId}`);
+  }
+  return connection;
+}
+
 // src/test-utils.tsx
 import { createElement } from "react";
 
@@ -171,6 +197,7 @@ function createMockPlatformContext(overrides = {}) {
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
+    routePath: "/",
     showToast: () => {
     },
     ...overrides
@@ -584,6 +611,28 @@ function createPaletteClient(ctx) {
         return updateInstallConfig(resolved, values);
       }
     },
+    connections: {
+      list: (pluginId = ctx?.pluginId ?? "") => {
+        const resolved = pluginId || defaultPluginId2();
+        if (!resolved) throw new Error("pluginId is required to read connections");
+        return getConnections(resolved);
+      },
+      connect: (connectionId, pluginId = ctx?.pluginId ?? "") => {
+        const resolved = pluginId || defaultPluginId2();
+        if (!resolved) throw new Error("pluginId is required to start a connection");
+        return startConnection(resolved, connectionId);
+      },
+      disconnect: (connectionId, pluginId = ctx?.pluginId ?? "") => {
+        const resolved = pluginId || defaultPluginId2();
+        if (!resolved) throw new Error("pluginId is required to disconnect a connection");
+        return disconnectConnection(resolved, connectionId);
+      },
+      require: (connectionId, pluginId = ctx?.pluginId ?? "") => {
+        const resolved = pluginId || defaultPluginId2();
+        if (!resolved) throw new Error("pluginId is required to require a connection");
+        return requireConnection(resolved, connectionId);
+      }
+    },
     permissions: {
       has: (permission) => ctx ? hasPermission(ctx, permission) : false,
       hasAny: (permissions) => ctx ? hasAnyPermission(ctx, permissions) : false,
@@ -660,14 +709,216 @@ function usePluginTranslations(resources, options = {}) {
   };
 }
 
+// src/router.tsx
+import {
+  Component,
+  createContext as createContext2,
+  createElement as createElement2,
+  useCallback as useCallback2,
+  useContext as useContext2,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+var RouterCtx = createContext2(null);
+var NOT_FOUND = /* @__PURE__ */ Symbol.for("palette.router.not-found");
+function notFound() {
+  throw Object.assign(new Error("Palette route not found"), { code: NOT_FOUND });
+}
+function normalizePath(path) {
+  const clean = String(path || "/").split("#")[0].split("?")[0] || "/";
+  return `/${clean.replace(/^\/+/, "").replace(/\/+$/, "")}`.replace(/^\/$/, "/");
+}
+function splitPath(path) {
+  return normalizePath(path).split("/").filter(Boolean).map(decodeURIComponent);
+}
+function routeScore(route) {
+  if (typeof route.score === "number") return route.score;
+  return route.segments.reduce((score, segment) => {
+    if (segment.kind === "static") return score + 10;
+    if (segment.kind === "dynamic") return score + 5;
+    return score + (segment.optional ? 1 : 2);
+  }, route.segments.length);
+}
+function matchRoute(route, path) {
+  const parts = splitPath(path);
+  const params = {};
+  let index = 0;
+  for (const segment of route.segments) {
+    if (segment.kind === "catchAll") {
+      const rest = parts.slice(index);
+      if (!segment.optional && rest.length === 0) return null;
+      params[segment.name] = rest;
+      index = parts.length;
+      break;
+    }
+    const value = parts[index];
+    if (value === void 0) return null;
+    if (segment.kind === "static") {
+      if (value !== segment.value) return null;
+    } else {
+      params[segment.name] = value;
+    }
+    index += 1;
+  }
+  return index === parts.length ? params : null;
+}
+function currentPluginPath(pluginId, routePath) {
+  if (routePath) return normalizePath(routePath);
+  if (typeof window === "undefined") return "/";
+  const path = window.location.pathname;
+  if (pluginId) {
+    const prefix = `/apps/${pluginId}`;
+    if (path === prefix) return "/";
+    if (path.startsWith(`${prefix}/`)) return normalizePath(path.slice(prefix.length));
+  }
+  return normalizePath(path);
+}
+function currentSearchParams() {
+  if (typeof window === "undefined") return new URLSearchParams();
+  return new URLSearchParams(window.location.search);
+}
+var PaletteRouteErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+    this.reset = () => this.setState({ error: null });
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(_error, _info) {
+  }
+  render() {
+    const error = this.state.error;
+    if (!error) return this.props.children;
+    if (error.code === NOT_FOUND && this.props.notFound) {
+      return createElement2(this.props.notFound);
+    }
+    if (this.props.fallback) {
+      return createElement2(this.props.fallback, { error, reset: this.reset });
+    }
+    throw error;
+  }
+};
+function renderRoute(route) {
+  const page = createElement2(route.page);
+  const wrapped = (route.layouts || []).reduceRight(
+    (children, Layout) => createElement2(Layout, null, children),
+    page
+  );
+  return createElement2(
+    PaletteRouteErrorBoundary,
+    { fallback: route.error, notFound: route.notFound },
+    wrapped
+  );
+}
+function PaletteAppRouter({
+  routes,
+  notFound: NotFound
+}) {
+  const platform = usePlatform();
+  const [location, setLocation] = useState(() => ({
+    pathname: currentPluginPath(platform.pluginId, platform.routePath),
+    searchParams: currentSearchParams()
+  }));
+  useEffect(() => {
+    setLocation({
+      pathname: currentPluginPath(platform.pluginId, platform.routePath),
+      searchParams: currentSearchParams()
+    });
+  }, [platform.pluginId, platform.routePath]);
+  useEffect(() => {
+    const sync = () => setLocation({
+      pathname: currentPluginPath(platform.pluginId, platform.routePath),
+      searchParams: currentSearchParams()
+    });
+    window.addEventListener("popstate", sync);
+    return () => window.removeEventListener("popstate", sync);
+  }, [platform.pluginId, platform.routePath]);
+  const sortedRoutes = useMemo(
+    () => [...routes].sort((a, b) => routeScore(b) - routeScore(a)),
+    [routes]
+  );
+  const matched = useMemo(() => {
+    for (const route of sortedRoutes) {
+      const params = matchRoute(route, location.pathname);
+      if (params) return { route, params };
+    }
+    return null;
+  }, [location.pathname, sortedRoutes]);
+  const navigate = useCallback2((target, replace = false) => {
+    const [pathPart, queryPart = ""] = String(target || "/").split("?");
+    const pathname = normalizePath(pathPart);
+    const next = `${pathname}${queryPart ? `?${queryPart}` : ""}`;
+    setLocation({ pathname, searchParams: new URLSearchParams(queryPart) });
+    const currentPath = typeof window === "undefined" ? "" : window.location.pathname;
+    const inPalettePath = platform.pluginId && (currentPath.startsWith(`/apps/${platform.pluginId}`) || platform.routePath !== void 0);
+    const osPath = inPalettePath && platform.pluginId ? `/apps/${platform.pluginId}${pathname === "/" ? "" : pathname}${queryPart ? `?${queryPart}` : ""}` : next;
+    if (replace && typeof window !== "undefined") window.history.replaceState(null, "", osPath);
+    else platform.navigate(osPath);
+  }, [platform]);
+  const state = useMemo(() => ({
+    pathname: location.pathname,
+    searchParams: location.searchParams,
+    params: matched?.params || {},
+    push: (path) => navigate(path, false),
+    replace: (path) => navigate(path, true)
+  }), [location.pathname, location.searchParams, matched?.params, navigate]);
+  const content = matched ? renderRoute(matched.route) : NotFound ? createElement2(NotFound) : createElement2("div", null, "Page not found");
+  return createElement2(RouterCtx.Provider, { value: state }, content);
+}
+function useRouterState() {
+  const value = useContext2(RouterCtx);
+  if (!value) throw new Error("Palette app router hooks must be used inside PaletteAppRouter");
+  return value;
+}
+function useRouter() {
+  const { push, replace } = useRouterState();
+  return { push, replace, back: () => window.history.back(), forward: () => window.history.forward() };
+}
+function usePathname() {
+  return useRouterState().pathname;
+}
+function useSearchParams() {
+  return useRouterState().searchParams;
+}
+function useParams() {
+  return useRouterState().params;
+}
+function Link({
+  href,
+  replace,
+  onClick,
+  children,
+  ...props
+}) {
+  const router = useRouter();
+  return createElement2(
+    "a",
+    {
+      ...props,
+      href,
+      onClick: (event) => {
+        onClick?.(event);
+        if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
+        event.preventDefault();
+        if (replace) router.replace(href);
+        else router.push(href);
+      }
+    },
+    children
+  );
+}
+
 // src/hooks/use-plugin-tasks.ts
-import { useCallback as useCallback2, useEffect, useState } from "react";
+import { useCallback as useCallback3, useEffect as useEffect2, useState as useState2 } from "react";
 function usePluginTasks(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [tasks, setTasks] = useState([]);
-  const [stats, setStats] = useState(null);
-  const [loading, setLoading] = useState(true);
-  const fetchTasks = useCallback2(async () => {
+  const [tasks, setTasks] = useState2([]);
+  const [stats, setStats] = useState2(null);
+  const [loading, setLoading] = useState2(true);
+  const fetchTasks = useCallback3(async () => {
     try {
       const params = new URLSearchParams();
       if (agentId) params.set("agent_id", String(agentId));
@@ -676,18 +927,18 @@ function usePluginTasks(agentId) {
     } catch {
     }
   }, [apiFetch2, agentId]);
-  const fetchStats = useCallback2(async () => {
+  const fetchStats = useCallback3(async () => {
     try {
       const res = await apiFetch2("/api/v1/tasks/stats");
       setStats(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  useEffect(() => {
+  useEffect2(() => {
     setLoading(true);
     Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
   }, [fetchTasks, fetchStats]);
-  const createTask = useCallback2(async (payload) => {
+  const createTask = useCallback3(async (payload) => {
     const res = await apiFetch2("/api/v1/tasks", {
       method: "POST",
       body: JSON.stringify(payload)
@@ -696,7 +947,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const updateTask = useCallback2(async (taskId, payload) => {
+  const updateTask = useCallback3(async (taskId, payload) => {
     const res = await apiFetch2(`/api/v1/tasks/${taskId}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
@@ -705,7 +956,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const deleteTask = useCallback2(async (taskId) => {
+  const deleteTask = useCallback3(async (taskId) => {
     await apiFetch2(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
     await Promise.all([fetchTasks(), fetchStats()]);
   }, [apiFetch2, fetchTasks, fetchStats]);
@@ -713,23 +964,23 @@ function usePluginTasks(agentId) {
 }
 
 // src/hooks/use-plugin-data-rooms.ts
-import { useCallback as useCallback3, useEffect as useEffect2, useState as useState2 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect3, useState as useState3 } from "react";
 function usePluginDataRooms() {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [rooms, setRooms] = useState2([]);
-  const [loading, setLoading] = useState2(true);
-  const fetchRooms = useCallback3(async () => {
+  const [rooms, setRooms] = useState3([]);
+  const [loading, setLoading] = useState3(true);
+  const fetchRooms = useCallback4(async () => {
     try {
       const res = await apiFetch2("/api/v1/data-rooms");
       setRooms(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  useEffect2(() => {
+  useEffect3(() => {
     setLoading(true);
     fetchRooms().finally(() => setLoading(false));
   }, [fetchRooms]);
-  const fetchFolder = useCallback3(async (roomId, folderId) => {
+  const fetchFolder = useCallback4(async (roomId, folderId) => {
     const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
     const res = await apiFetch2(path);
     return res.json();
@@ -738,19 +989,19 @@ function usePluginDataRooms() {
 }
 
 // src/hooks/use-plugin-chat.ts
-import { useCallback as useCallback4, useRef, useState as useState3 } from "react";
+import { useCallback as useCallback5, useRef, useState as useState4 } from "react";
 function usePluginChat(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [threads, setThreads] = useState3([]);
-  const [messages, setMessages] = useState3([]);
-  const [streaming, setStreaming] = useState3(false);
-  const [activeThreadId, setActiveThreadId] = useState3(null);
+  const [threads, setThreads] = useState4([]);
+  const [messages, setMessages] = useState4([]);
+  const [streaming, setStreaming] = useState4(false);
+  const [activeThreadId, setActiveThreadId] = useState4(null);
   const abortRef = useRef(null);
-  const fetchThreads = useCallback4(async () => {
+  const fetchThreads = useCallback5(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`);
     setThreads(await res.json());
   }, [apiFetch2, agentId]);
-  const createThread = useCallback4(async () => {
+  const createThread = useCallback5(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
     const thread = await res.json();
     setActiveThreadId(thread.id);
@@ -758,13 +1009,13 @@ function usePluginChat(agentId) {
     await fetchThreads();
     return thread;
   }, [apiFetch2, agentId, fetchThreads]);
-  const fetchMessages = useCallback4(async (threadId) => {
+  const fetchMessages = useCallback5(async (threadId) => {
     const res = await apiFetch2(`/api/v1/chat/threads/${threadId}/messages`);
     const msgs = await res.json();
     setMessages(msgs);
     setActiveThreadId(threadId);
   }, [apiFetch2]);
-  const sendMessage = useCallback4(async (threadId, content) => {
+  const sendMessage = useCallback5(async (threadId, content) => {
     setStreaming(true);
     abortRef.current = new AbortController();
     const userMsg = {
@@ -832,7 +1083,7 @@ function usePluginChat(agentId) {
       abortRef.current = null;
     }
   }, []);
-  const stopStreaming = useCallback4(() => {
+  const stopStreaming = useCallback5(() => {
     abortRef.current?.abort();
   }, []);
   return {
@@ -849,8 +1100,10 @@ function usePluginChat(agentId) {
 }
 export {
   DataRoomClient,
+  Link,
   OrganizationClient,
   PaletteApiError,
+  PaletteAppRouter,
   PlatformCtx,
   PluginProvider,
   StorageClient,
@@ -861,8 +1114,10 @@ export {
   createPaletteClient,
   createSandboxBridge,
   dataRooms,
+  disconnectConnection,
   errorFromResponse,
   getBaseUrl,
+  getConnections,
   getInstallConfig,
   hasAllPermissions,
   hasAnyPermission,
@@ -870,14 +1125,21 @@ export {
   isPaletteApiError,
   isSandboxRuntime,
   normalizePaletteLanguage,
+  notFound,
+  requireConnection,
   setBaseUrl,
+  startConnection,
   translate,
   updateInstallConfig,
   uploadToSignedUrl,
+  useParams,
+  usePathname,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
   usePluginTasks,
   usePluginTranslations,
+  useRouter,
+  useSearchParams,
   withPluginProvider
 };

package/dist/{plugin-UV46q1mU.d.mts → plugin-dpLzOtF6.d.mts}

@@ -106,7 +106,7 @@ interface PluginManifest {
     frontend?: {
         entry: string;
         sandbox?: boolean;
-        framework?: "react" | "next";
+        framework?: "react" | "next" | "palette-app";
         config?: string;
     };
     backend?: {
@@ -116,6 +116,9 @@ interface PluginManifest {
     agents?: PluginAgentDefinition[];
     tools?: PluginToolDefinition[];
     permissions?: string[];
+    connections?: PluginConnectionDefinition[];
+    provides?: PluginProvidesDefinition;
+    requires?: PluginRequiresDefinition;
     public_routes?: string[];
     rate_limit?: {
         per_minute?: number;
@@ -124,6 +127,46 @@ interface PluginManifest {
     reviews?: number;
     featured?: boolean;
 }
+interface PluginConnectionDefinition {
+    id: string;
+    provider: "google" | "instagram" | "slack" | "linear" | "hubspot" | "stripe" | "zendesk" | "custom";
+    label: string;
+    auth?: "oauth2" | "api_key";
+    scopes?: string[];
+    required?: boolean;
+}
+interface PluginServiceRouteDefinition {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    operation_id?: string;
+    description?: string;
+}
+interface PluginServiceDefinition {
+    id: string;
+    version?: string;
+    label?: string;
+    description?: string;
+    permissions?: string[];
+    routes?: PluginServiceRouteDefinition[];
+}
+interface PluginProvidesDefinition {
+    services?: PluginServiceDefinition[];
+    events?: string[];
+}
+interface PluginAppDependencyDefinition {
+    id: string;
+    version?: string;
+    required?: boolean;
+    reason?: string;
+}
+interface PluginServiceDependencyDefinition extends PluginAppDependencyDefinition {
+    provider?: string;
+}
+interface PluginRequiresDefinition {
+    apps?: PluginAppDependencyDefinition[];
+    services?: PluginServiceDependencyDefinition[];
+    events?: string[];
+}
 interface PluginAgentDefinition {
     name: string;
     field: string;
@@ -165,6 +208,8 @@ interface PlatformContext {
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
     navigate: (path: string) => void;
+    /** Current route path within the plugin app, when mounted by Palette OS */
+    routePath?: string;
     /** Show a toast notification */
     showToast: (message: string, type?: "success" | "error" | "info") => void;
     /** Permissions declared for the current plugin install/runtime */
@@ -175,4 +220,4 @@ interface PluginComponentProps {
     platform: PlatformContext;
 }
 
-export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginManifest as g, PluginToolDefinition as h };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginConnectionDefinition as g, PluginManifest as h, PluginToolDefinition as i };

package/dist/{plugin-UV46q1mU.d.ts → plugin-dpLzOtF6.d.ts}

@@ -106,7 +106,7 @@ interface PluginManifest {
     frontend?: {
         entry: string;
         sandbox?: boolean;
-        framework?: "react" | "next";
+        framework?: "react" | "next" | "palette-app";
         config?: string;
     };
     backend?: {
@@ -116,6 +116,9 @@ interface PluginManifest {
     agents?: PluginAgentDefinition[];
     tools?: PluginToolDefinition[];
     permissions?: string[];
+    connections?: PluginConnectionDefinition[];
+    provides?: PluginProvidesDefinition;
+    requires?: PluginRequiresDefinition;
     public_routes?: string[];
     rate_limit?: {
         per_minute?: number;
@@ -124,6 +127,46 @@ interface PluginManifest {
     reviews?: number;
     featured?: boolean;
 }
+interface PluginConnectionDefinition {
+    id: string;
+    provider: "google" | "instagram" | "slack" | "linear" | "hubspot" | "stripe" | "zendesk" | "custom";
+    label: string;
+    auth?: "oauth2" | "api_key";
+    scopes?: string[];
+    required?: boolean;
+}
+interface PluginServiceRouteDefinition {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    operation_id?: string;
+    description?: string;
+}
+interface PluginServiceDefinition {
+    id: string;
+    version?: string;
+    label?: string;
+    description?: string;
+    permissions?: string[];
+    routes?: PluginServiceRouteDefinition[];
+}
+interface PluginProvidesDefinition {
+    services?: PluginServiceDefinition[];
+    events?: string[];
+}
+interface PluginAppDependencyDefinition {
+    id: string;
+    version?: string;
+    required?: boolean;
+    reason?: string;
+}
+interface PluginServiceDependencyDefinition extends PluginAppDependencyDefinition {
+    provider?: string;
+}
+interface PluginRequiresDefinition {
+    apps?: PluginAppDependencyDefinition[];
+    services?: PluginServiceDependencyDefinition[];
+    events?: string[];
+}
 interface PluginAgentDefinition {
     name: string;
     field: string;
@@ -165,6 +208,8 @@ interface PlatformContext {
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
     navigate: (path: string) => void;
+    /** Current route path within the plugin app, when mounted by Palette OS */
+    routePath?: string;
     /** Show a toast notification */
     showToast: (message: string, type?: "success" | "error" | "info") => void;
     /** Permissions declared for the current plugin install/runtime */
@@ -175,4 +220,4 @@ interface PluginComponentProps {
     platform: PlatformContext;
 }
 
-export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginManifest as g, PluginToolDefinition as h };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginConnectionDefinition as g, PluginManifest as h, PluginToolDefinition as i };