@palettelab/sdk 0.1.0

package/dist/hooks/index.js

@@ -0,0 +1,246 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  PlatformCtx: () => PlatformCtx,
+  usePlatform: () => usePlatform,
+  usePluginChat: () => usePluginChat,
+  usePluginDataRooms: () => usePluginDataRooms,
+  usePluginTasks: () => usePluginTasks
+});
+module.exports = __toCommonJS(hooks_exports);
+
+// src/hooks/use-platform.ts
+var import_react = require("react");
+var PlatformCtx = (0, import_react.createContext)(null);
+function usePlatform() {
+  const ctx = (0, import_react.useContext)(PlatformCtx);
+  if (!ctx) {
+    throw new Error(
+      "usePlatform must be used within a PlatformProvider. This is provided automatically when your plugin runs on the Palette platform."
+    );
+  }
+  return ctx;
+}
+
+// src/hooks/use-plugin-tasks.ts
+var import_react2 = require("react");
+function usePluginTasks(agentId) {
+  const { apiFetch } = usePlatform();
+  const [tasks, setTasks] = (0, import_react2.useState)([]);
+  const [stats, setStats] = (0, import_react2.useState)(null);
+  const [loading, setLoading] = (0, import_react2.useState)(true);
+  const fetchTasks = (0, import_react2.useCallback)(async () => {
+    try {
+      const params = new URLSearchParams();
+      if (agentId) params.set("agent_id", String(agentId));
+      const res = await apiFetch(`/api/v1/tasks?${params}`);
+      setTasks(await res.json());
+    } catch {
+    }
+  }, [apiFetch, agentId]);
+  const fetchStats = (0, import_react2.useCallback)(async () => {
+    try {
+      const res = await apiFetch("/api/v1/tasks/stats");
+      setStats(await res.json());
+    } catch {
+    }
+  }, [apiFetch]);
+  (0, import_react2.useEffect)(() => {
+    setLoading(true);
+    Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
+  }, [fetchTasks, fetchStats]);
+  const createTask = (0, import_react2.useCallback)(async (payload) => {
+    const res = await apiFetch("/api/v1/tasks", {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+    const task = await res.json();
+    await Promise.all([fetchTasks(), fetchStats()]);
+    return task;
+  }, [apiFetch, fetchTasks, fetchStats]);
+  const updateTask = (0, import_react2.useCallback)(async (taskId, payload) => {
+    const res = await apiFetch(`/api/v1/tasks/${taskId}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    });
+    const task = await res.json();
+    await Promise.all([fetchTasks(), fetchStats()]);
+    return task;
+  }, [apiFetch, fetchTasks, fetchStats]);
+  const deleteTask = (0, import_react2.useCallback)(async (taskId) => {
+    await apiFetch(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
+    await Promise.all([fetchTasks(), fetchStats()]);
+  }, [apiFetch, fetchTasks, fetchStats]);
+  return { tasks, stats, loading, createTask, updateTask, deleteTask, refetch: fetchTasks };
+}
+
+// src/hooks/use-plugin-data-rooms.ts
+var import_react3 = require("react");
+function usePluginDataRooms() {
+  const { apiFetch } = usePlatform();
+  const [rooms, setRooms] = (0, import_react3.useState)([]);
+  const [loading, setLoading] = (0, import_react3.useState)(true);
+  const fetchRooms = (0, import_react3.useCallback)(async () => {
+    try {
+      const res = await apiFetch("/api/v1/data-rooms");
+      setRooms(await res.json());
+    } catch {
+    }
+  }, [apiFetch]);
+  (0, import_react3.useEffect)(() => {
+    setLoading(true);
+    fetchRooms().finally(() => setLoading(false));
+  }, [fetchRooms]);
+  const fetchFolder = (0, import_react3.useCallback)(async (roomId, folderId) => {
+    const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
+    const res = await apiFetch(path);
+    return res.json();
+  }, [apiFetch]);
+  return { rooms, loading, fetchFolder, refetch: fetchRooms };
+}
+
+// src/hooks/use-plugin-chat.ts
+var import_react4 = require("react");
+
+// src/api.ts
+var _baseUrl = process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:8000";
+function getBaseUrl() {
+  return _baseUrl;
+}
+
+// src/hooks/use-plugin-chat.ts
+function usePluginChat(agentId) {
+  const { apiFetch } = usePlatform();
+  const [threads, setThreads] = (0, import_react4.useState)([]);
+  const [messages, setMessages] = (0, import_react4.useState)([]);
+  const [streaming, setStreaming] = (0, import_react4.useState)(false);
+  const [activeThreadId, setActiveThreadId] = (0, import_react4.useState)(null);
+  const abortRef = (0, import_react4.useRef)(null);
+  const fetchThreads = (0, import_react4.useCallback)(async () => {
+    const res = await apiFetch(`/api/v1/chat/${agentId}/threads`);
+    setThreads(await res.json());
+  }, [apiFetch, agentId]);
+  const createThread = (0, import_react4.useCallback)(async () => {
+    const res = await apiFetch(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
+    const thread = await res.json();
+    setActiveThreadId(thread.id);
+    setMessages([]);
+    await fetchThreads();
+    return thread;
+  }, [apiFetch, agentId, fetchThreads]);
+  const fetchMessages = (0, import_react4.useCallback)(async (threadId) => {
+    const res = await apiFetch(`/api/v1/chat/threads/${threadId}/messages`);
+    const msgs = await res.json();
+    setMessages(msgs);
+    setActiveThreadId(threadId);
+  }, [apiFetch]);
+  const sendMessage = (0, import_react4.useCallback)(async (threadId, content) => {
+    setStreaming(true);
+    abortRef.current = new AbortController();
+    const userMsg = {
+      id: crypto.randomUUID(),
+      thread_id: threadId,
+      role: "user",
+      content,
+      attachments: null,
+      created_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    setMessages((prev) => [...prev, userMsg]);
+    let assistantContent = "";
+    const assistantMsg = {
+      id: crypto.randomUUID(),
+      thread_id: threadId,
+      role: "assistant",
+      content: "",
+      attachments: null,
+      created_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    setMessages((prev) => [...prev, assistantMsg]);
+    try {
+      const res = await fetch(`${getBaseUrl()}/api/v1/chat/threads/${threadId}/send`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ content }),
+        signal: abortRef.current.signal
+      });
+      const reader = res.body?.getReader();
+      if (!reader) return;
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const event = JSON.parse(line.slice(6));
+            if (event.event === "token") {
+              assistantContent += event.content;
+              setMessages((prev) => {
+                const copy = [...prev];
+                copy[copy.length - 1] = { ...copy[copy.length - 1], content: assistantContent };
+                return copy;
+              });
+            }
+            if (event.event === "done" && event.message_id) {
+              setMessages((prev) => {
+                const copy = [...prev];
+                copy[copy.length - 1] = { ...copy[copy.length - 1], id: event.message_id };
+                return copy;
+              });
+            }
+          } catch {
+          }
+        }
+      }
+    } finally {
+      setStreaming(false);
+      abortRef.current = null;
+    }
+  }, []);
+  const stopStreaming = (0, import_react4.useCallback)(() => {
+    abortRef.current?.abort();
+  }, []);
+  return {
+    threads,
+    messages,
+    streaming,
+    activeThreadId,
+    fetchThreads,
+    createThread,
+    fetchMessages,
+    sendMessage,
+    stopStreaming
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PlatformCtx,
+  usePlatform,
+  usePluginChat,
+  usePluginDataRooms,
+  usePluginTasks
+});

package/dist/hooks/index.mjs

@@ -0,0 +1,215 @@
+// src/hooks/use-platform.ts
+import { createContext, useContext } from "react";
+var PlatformCtx = createContext(null);
+function usePlatform() {
+  const ctx = useContext(PlatformCtx);
+  if (!ctx) {
+    throw new Error(
+      "usePlatform must be used within a PlatformProvider. This is provided automatically when your plugin runs on the Palette platform."
+    );
+  }
+  return ctx;
+}
+
+// src/hooks/use-plugin-tasks.ts
+import { useCallback, useEffect, useState } from "react";
+function usePluginTasks(agentId) {
+  const { apiFetch } = usePlatform();
+  const [tasks, setTasks] = useState([]);
+  const [stats, setStats] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const fetchTasks = useCallback(async () => {
+    try {
+      const params = new URLSearchParams();
+      if (agentId) params.set("agent_id", String(agentId));
+      const res = await apiFetch(`/api/v1/tasks?${params}`);
+      setTasks(await res.json());
+    } catch {
+    }
+  }, [apiFetch, agentId]);
+  const fetchStats = useCallback(async () => {
+    try {
+      const res = await apiFetch("/api/v1/tasks/stats");
+      setStats(await res.json());
+    } catch {
+    }
+  }, [apiFetch]);
+  useEffect(() => {
+    setLoading(true);
+    Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
+  }, [fetchTasks, fetchStats]);
+  const createTask = useCallback(async (payload) => {
+    const res = await apiFetch("/api/v1/tasks", {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+    const task = await res.json();
+    await Promise.all([fetchTasks(), fetchStats()]);
+    return task;
+  }, [apiFetch, fetchTasks, fetchStats]);
+  const updateTask = useCallback(async (taskId, payload) => {
+    const res = await apiFetch(`/api/v1/tasks/${taskId}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    });
+    const task = await res.json();
+    await Promise.all([fetchTasks(), fetchStats()]);
+    return task;
+  }, [apiFetch, fetchTasks, fetchStats]);
+  const deleteTask = useCallback(async (taskId) => {
+    await apiFetch(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
+    await Promise.all([fetchTasks(), fetchStats()]);
+  }, [apiFetch, fetchTasks, fetchStats]);
+  return { tasks, stats, loading, createTask, updateTask, deleteTask, refetch: fetchTasks };
+}
+
+// src/hooks/use-plugin-data-rooms.ts
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+function usePluginDataRooms() {
+  const { apiFetch } = usePlatform();
+  const [rooms, setRooms] = useState2([]);
+  const [loading, setLoading] = useState2(true);
+  const fetchRooms = useCallback2(async () => {
+    try {
+      const res = await apiFetch("/api/v1/data-rooms");
+      setRooms(await res.json());
+    } catch {
+    }
+  }, [apiFetch]);
+  useEffect2(() => {
+    setLoading(true);
+    fetchRooms().finally(() => setLoading(false));
+  }, [fetchRooms]);
+  const fetchFolder = useCallback2(async (roomId, folderId) => {
+    const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
+    const res = await apiFetch(path);
+    return res.json();
+  }, [apiFetch]);
+  return { rooms, loading, fetchFolder, refetch: fetchRooms };
+}
+
+// src/hooks/use-plugin-chat.ts
+import { useCallback as useCallback3, useRef, useState as useState3 } from "react";
+
+// src/api.ts
+var _baseUrl = process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:8000";
+function getBaseUrl() {
+  return _baseUrl;
+}
+
+// src/hooks/use-plugin-chat.ts
+function usePluginChat(agentId) {
+  const { apiFetch } = usePlatform();
+  const [threads, setThreads] = useState3([]);
+  const [messages, setMessages] = useState3([]);
+  const [streaming, setStreaming] = useState3(false);
+  const [activeThreadId, setActiveThreadId] = useState3(null);
+  const abortRef = useRef(null);
+  const fetchThreads = useCallback3(async () => {
+    const res = await apiFetch(`/api/v1/chat/${agentId}/threads`);
+    setThreads(await res.json());
+  }, [apiFetch, agentId]);
+  const createThread = useCallback3(async () => {
+    const res = await apiFetch(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
+    const thread = await res.json();
+    setActiveThreadId(thread.id);
+    setMessages([]);
+    await fetchThreads();
+    return thread;
+  }, [apiFetch, agentId, fetchThreads]);
+  const fetchMessages = useCallback3(async (threadId) => {
+    const res = await apiFetch(`/api/v1/chat/threads/${threadId}/messages`);
+    const msgs = await res.json();
+    setMessages(msgs);
+    setActiveThreadId(threadId);
+  }, [apiFetch]);
+  const sendMessage = useCallback3(async (threadId, content) => {
+    setStreaming(true);
+    abortRef.current = new AbortController();
+    const userMsg = {
+      id: crypto.randomUUID(),
+      thread_id: threadId,
+      role: "user",
+      content,
+      attachments: null,
+      created_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    setMessages((prev) => [...prev, userMsg]);
+    let assistantContent = "";
+    const assistantMsg = {
+      id: crypto.randomUUID(),
+      thread_id: threadId,
+      role: "assistant",
+      content: "",
+      attachments: null,
+      created_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    setMessages((prev) => [...prev, assistantMsg]);
+    try {
+      const res = await fetch(`${getBaseUrl()}/api/v1/chat/threads/${threadId}/send`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ content }),
+        signal: abortRef.current.signal
+      });
+      const reader = res.body?.getReader();
+      if (!reader) return;
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const event = JSON.parse(line.slice(6));
+            if (event.event === "token") {
+              assistantContent += event.content;
+              setMessages((prev) => {
+                const copy = [...prev];
+                copy[copy.length - 1] = { ...copy[copy.length - 1], content: assistantContent };
+                return copy;
+              });
+            }
+            if (event.event === "done" && event.message_id) {
+              setMessages((prev) => {
+                const copy = [...prev];
+                copy[copy.length - 1] = { ...copy[copy.length - 1], id: event.message_id };
+                return copy;
+              });
+            }
+          } catch {
+          }
+        }
+      }
+    } finally {
+      setStreaming(false);
+      abortRef.current = null;
+    }
+  }, []);
+  const stopStreaming = useCallback3(() => {
+    abortRef.current?.abort();
+  }, []);
+  return {
+    threads,
+    messages,
+    streaming,
+    activeThreadId,
+    fetchThreads,
+    createThread,
+    fetchMessages,
+    sendMessage,
+    stopStreaming
+  };
+}
+export {
+  PlatformCtx,
+  usePlatform,
+  usePluginChat,
+  usePluginDataRooms,
+  usePluginTasks
+};

package/dist/index.d.mts

@@ -0,0 +1,31 @@
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from './plugin-CQH23f5N.mjs';
+export { C as ChatAttachment, a as ChatMessage, b as ChatThread, D as DataRoom, c as DataRoomFile, d as DataRoomFolder, e as DataRoomPermission, T as Task, f as TaskAgentSnippet, g as TaskCreatePayload, h as TaskPriority, i as TaskStats, j as TaskStatus, k as TaskType, l as TaskUpdatePayload } from './data-room-BP0PjYoe.mjs';
+export { AgentResource, ResourcesByGroup } from './types/index.mjs';
+export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.mjs';
+export { PluginProvider } from './components/index.mjs';
+import 'react';
+import 'react/jsx-runtime';
+
+/**
+ * API fetch wrapper for plugin developers.
+ * Handles credentials, JSON content type, token refresh, and error extraction.
+ *
+ * Usage:
+ *   import { apiFetch } from "@palettelab/sdk"
+ *   const res = await apiFetch("/api/v1/tasks")
+ *   const data = await res.json()
+ */
+/** Override the base URL (called by platform runtime, not plugins) */
+declare function setBaseUrl(url: string): void;
+declare function getBaseUrl(): string;
+/**
+ * Authenticated API fetch with automatic token refresh.
+ * Throws on non-2xx responses with the server's error detail.
+ */
+declare function apiFetch(path: string, init?: RequestInit): Promise<Response>;
+/**
+ * Upload a file via multipart form data.
+ */
+declare function apiUpload(path: string, file: File, fieldName?: string, extraFields?: Record<string, string>): Promise<Response>;
+
+export { apiFetch, apiUpload, getBaseUrl, setBaseUrl };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from './plugin-CQH23f5N.js';
+export { C as ChatAttachment, a as ChatMessage, b as ChatThread, D as DataRoom, c as DataRoomFile, d as DataRoomFolder, e as DataRoomPermission, T as Task, f as TaskAgentSnippet, g as TaskCreatePayload, h as TaskPriority, i as TaskStats, j as TaskStatus, k as TaskType, l as TaskUpdatePayload } from './data-room-BP0PjYoe.js';
+export { AgentResource, ResourcesByGroup } from './types/index.js';
+export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.js';
+export { PluginProvider } from './components/index.js';
+import 'react';
+import 'react/jsx-runtime';
+
+/**
+ * API fetch wrapper for plugin developers.
+ * Handles credentials, JSON content type, token refresh, and error extraction.
+ *
+ * Usage:
+ *   import { apiFetch } from "@palettelab/sdk"
+ *   const res = await apiFetch("/api/v1/tasks")
+ *   const data = await res.json()
+ */
+/** Override the base URL (called by platform runtime, not plugins) */
+declare function setBaseUrl(url: string): void;
+declare function getBaseUrl(): string;
+/**
+ * Authenticated API fetch with automatic token refresh.
+ * Throws on non-2xx responses with the server's error detail.
+ */
+declare function apiFetch(path: string, init?: RequestInit): Promise<Response>;
+/**
+ * Upload a file via multipart form data.
+ */
+declare function apiUpload(path: string, file: File, fieldName?: string, extraFields?: Record<string, string>): Promise<Response>;
+
+export { apiFetch, apiUpload, getBaseUrl, setBaseUrl };