@palettelab/sdk 0.1.16 → 0.1.18

package/README.md

@@ -318,6 +318,8 @@ Included clients:
 These helpers are intentionally thin wrappers over platform APIs. Apps can still
 use `apiFetch()` directly for custom backend routes.
 
+App storage is different from Data Rooms. Use `palette.storage` for app-owned files that should go directly to the OS-configured storage backend, such as GCS. Use `palette.dataRooms` only when the file should appear as a user-visible Data Room document.
+
 App storage uploads are scoped by Palette to:
 
 ```text
@@ -446,6 +448,16 @@ const config = await getInstallConfig("my-plugin")
 await updateInstallConfig("my-plugin", { ...config, enabled: true })
 ```
 
+Plugins can also read and start Palette-managed third-party connections declared
+in `palette-plugin.json`:
+
+```ts
+import { getConnections, startConnection } from "@palettelab/sdk"
+
+const connections = await getConnections("my-plugin")
+await startConnection("my-plugin", "google_calendar")
+```
+
 ## Sandbox Bridge
 
 Appstore plugin frontends run inside an iframe sandbox by default. Use `createSandboxBridge` when you need to explicitly call host-proxied APIs from sandbox runtime code.

package/dist/components/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { P as PlatformContext } from '../plugin-CG6spHKI.mjs';
+import { P as PlatformContext } from '../plugin-dpLzOtF6.mjs';
 
 /**
  * Provider that wraps plugin components with the platform context.

package/dist/components/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { P as PlatformContext } from '../plugin-CG6spHKI.js';
+import { P as PlatformContext } from '../plugin-dpLzOtF6.js';
 
 /**
  * Provider that wraps plugin components with the platform context.

package/dist/hooks/index.d.mts

@@ -1,4 +1,4 @@
-export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-BGT6xBGD.mjs';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-DsfTFnZb.mjs';
 import 'react';
-import '../plugin-CG6spHKI.mjs';
+import '../plugin-dpLzOtF6.mjs';
 import '../data-room-Dtd9LLHf.mjs';

package/dist/hooks/index.d.ts

@@ -1,4 +1,4 @@
-export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-Beo6F2Fr.js';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-D0i35Hem.js';
 import 'react';
-import '../plugin-CG6spHKI.js';
+import '../plugin-dpLzOtF6.js';
 import '../data-room-Dtd9LLHf.js';

package/dist/{index-Beo6F2Fr.d.ts → index-D0i35Hem.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-CG6spHKI.js';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-dpLzOtF6.js';
 import { T as Task, i as TaskStats, g as TaskCreatePayload, l as TaskUpdatePayload, D as DataRoom, a as DataRoomFolder, b as DataRoomFile, d as ChatThread, c as ChatMessage } from './data-room-Dtd9LLHf.js';
 
 type TranslationPrimitive = string | number | boolean | null;

package/dist/{index-BGT6xBGD.d.mts → index-DsfTFnZb.d.mts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-CG6spHKI.mjs';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-dpLzOtF6.mjs';
 import { T as Task, i as TaskStats, g as TaskCreatePayload, l as TaskUpdatePayload, D as DataRoom, a as DataRoomFolder, b as DataRoomFile, d as ChatThread, c as ChatMessage } from './data-room-Dtd9LLHf.mjs';
 
 type TranslationPrimitive = string | number | boolean | null;

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-CG6spHKI.mjs';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition } from './plugin-CG6spHKI.mjs';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-dpLzOtF6.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition } from './plugin-dpLzOtF6.mjs';
 import { D as DataRoom, a as DataRoomFolder, b as DataRoomFile } from './data-room-Dtd9LLHf.mjs';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, 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-Dtd9LLHf.mjs';
 export { AgentResource, ResourcesByGroup } from './types/index.mjs';
 import { ReactElement } from 'react';
-export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-BGT6xBGD.mjs';
+export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-DsfTFnZb.mjs';
 export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
@@ -54,6 +54,31 @@ type InstallConfig = Record<string, unknown>;
 declare function getInstallConfig(pluginId: string): Promise<InstallConfig>;
 declare function updateInstallConfig(pluginId: string, config: InstallConfig): Promise<InstallConfig>;
 
+type ConnectionStatusValue = "available" | "connected" | "expiring" | "failed" | "missing";
+interface ConnectionStatus {
+    id: string;
+    provider: string;
+    label: string;
+    auth: "oauth2" | "api_key";
+    scopes: string[];
+    required: boolean;
+    status: ConnectionStatusValue;
+    account_label?: string | null;
+    granted_scopes: string[];
+    expires_at?: string | null;
+    connected_at?: string | null;
+    last_error?: string | null;
+}
+interface ConnectionAuthStart {
+    connection_id: string;
+    authorize_url: string;
+    mode: "oauth2" | "mock";
+}
+declare function getConnections(pluginId: string): Promise<ConnectionStatus[]>;
+declare function startConnection(pluginId: string, connectionId: string): Promise<ConnectionAuthStart>;
+declare function disconnectConnection(pluginId: string, connectionId: string): Promise<void>;
+declare function requireConnection(pluginId: string, connectionId: string): Promise<ConnectionStatus>;
+
 declare function createMockPlatformContext(overrides?: Partial<PlatformContext>): PlatformContext;
 declare function withPluginProvider(element: ReactElement, platform?: Partial<PlatformContext>): ReactElement;
 
@@ -196,6 +221,12 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         get: (pluginId?: string) => Promise<InstallConfig>;
         update: (values: Record<string, unknown>, pluginId?: string) => Promise<InstallConfig>;
     };
+    connections: {
+        list: (pluginId?: string) => Promise<ConnectionStatus[]>;
+        connect: (connectionId: string, pluginId?: string) => Promise<ConnectionAuthStart>;
+        disconnect: (connectionId: string, pluginId?: string) => Promise<void>;
+        require: (connectionId: string, pluginId?: string) => Promise<ConnectionStatus>;
+    };
     permissions: {
         has: (permission: string) => boolean;
         hasAny: (permissions: string[]) => boolean;
@@ -213,4 +244,4 @@ declare function hasPermission(ctx: PlatformContext, permission: string): boolea
 declare function hasAnyPermission(ctx: PlatformContext, permissions: string[]): boolean;
 declare function hasAllPermissions(ctx: PlatformContext, permissions: string[]): boolean;
 
-export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, requireConnection, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-CG6spHKI.js';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition } from './plugin-CG6spHKI.js';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-dpLzOtF6.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition } from './plugin-dpLzOtF6.js';
 import { D as DataRoom, a as DataRoomFolder, b as DataRoomFile } from './data-room-Dtd9LLHf.js';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, 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-Dtd9LLHf.js';
 export { AgentResource, ResourcesByGroup } from './types/index.js';
 import { ReactElement } from 'react';
-export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-Beo6F2Fr.js';
+export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-D0i35Hem.js';
 export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
@@ -54,6 +54,31 @@ type InstallConfig = Record<string, unknown>;
 declare function getInstallConfig(pluginId: string): Promise<InstallConfig>;
 declare function updateInstallConfig(pluginId: string, config: InstallConfig): Promise<InstallConfig>;
 
+type ConnectionStatusValue = "available" | "connected" | "expiring" | "failed" | "missing";
+interface ConnectionStatus {
+    id: string;
+    provider: string;
+    label: string;
+    auth: "oauth2" | "api_key";
+    scopes: string[];
+    required: boolean;
+    status: ConnectionStatusValue;
+    account_label?: string | null;
+    granted_scopes: string[];
+    expires_at?: string | null;
+    connected_at?: string | null;
+    last_error?: string | null;
+}
+interface ConnectionAuthStart {
+    connection_id: string;
+    authorize_url: string;
+    mode: "oauth2" | "mock";
+}
+declare function getConnections(pluginId: string): Promise<ConnectionStatus[]>;
+declare function startConnection(pluginId: string, connectionId: string): Promise<ConnectionAuthStart>;
+declare function disconnectConnection(pluginId: string, connectionId: string): Promise<void>;
+declare function requireConnection(pluginId: string, connectionId: string): Promise<ConnectionStatus>;
+
 declare function createMockPlatformContext(overrides?: Partial<PlatformContext>): PlatformContext;
 declare function withPluginProvider(element: ReactElement, platform?: Partial<PlatformContext>): ReactElement;
 
@@ -196,6 +221,12 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         get: (pluginId?: string) => Promise<InstallConfig>;
         update: (values: Record<string, unknown>, pluginId?: string) => Promise<InstallConfig>;
     };
+    connections: {
+        list: (pluginId?: string) => Promise<ConnectionStatus[]>;
+        connect: (connectionId: string, pluginId?: string) => Promise<ConnectionAuthStart>;
+        disconnect: (connectionId: string, pluginId?: string) => Promise<void>;
+        require: (connectionId: string, pluginId?: string) => Promise<ConnectionStatus>;
+    };
     permissions: {
         has: (permission: string) => boolean;
         hasAny: (permissions: string[]) => boolean;
@@ -213,4 +244,4 @@ declare function hasPermission(ctx: PlatformContext, permission: string): boolea
 declare function hasAnyPermission(ctx: PlatformContext, permissions: string[]): boolean;
 declare function hasAllPermissions(ctx: PlatformContext, permissions: string[]): boolean;
 
-export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, requireConnection, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.js

@@ -35,8 +35,10 @@ __export(src_exports, {
   createPaletteClient: () => createPaletteClient,
   createSandboxBridge: () => createSandboxBridge,
   dataRooms: () => dataRooms,
+  disconnectConnection: () => disconnectConnection,
   errorFromResponse: () => errorFromResponse,
   getBaseUrl: () => getBaseUrl,
+  getConnections: () => getConnections,
   getInstallConfig: () => getInstallConfig,
   hasAllPermissions: () => hasAllPermissions,
   hasAnyPermission: () => hasAnyPermission,
@@ -45,7 +47,9 @@ __export(src_exports, {
   isSandboxRuntime: () => isSandboxRuntime,
   normalizePaletteLanguage: () => normalizePaletteLanguage,
   notFound: () => notFound,
+  requireConnection: () => requireConnection,
   setBaseUrl: () => setBaseUrl,
+  startConnection: () => startConnection,
   translate: () => translate,
   updateInstallConfig: () => updateInstallConfig,
   uploadToSignedUrl: () => uploadToSignedUrl,
@@ -174,6 +178,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
 var import_react2 = require("react");
 
@@ -649,6 +679,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,
@@ -1122,8 +1174,10 @@ function usePluginChat(agentId) {
   createPaletteClient,
   createSandboxBridge,
   dataRooms,
+  disconnectConnection,
   errorFromResponse,
   getBaseUrl,
+  getConnections,
   getInstallConfig,
   hasAllPermissions,
   hasAnyPermission,
@@ -1132,7 +1186,9 @@ function usePluginChat(agentId) {
   isSandboxRuntime,
   normalizePaletteLanguage,
   notFound,
+  requireConnection,
   setBaseUrl,
+  startConnection,
   translate,
   updateInstallConfig,
   uploadToSignedUrl,

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";
 
@@ -585,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,
@@ -1066,8 +1114,10 @@ export {
   createPaletteClient,
   createSandboxBridge,
   dataRooms,
+  disconnectConnection,
   errorFromResponse,
   getBaseUrl,
+  getConnections,
   getInstallConfig,
   hasAllPermissions,
   hasAnyPermission,
@@ -1076,7 +1126,9 @@ export {
   isSandboxRuntime,
   normalizePaletteLanguage,
   notFound,
+  requireConnection,
   setBaseUrl,
+  startConnection,
   translate,
   updateInstallConfig,
   uploadToSignedUrl,

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

@@ -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;
@@ -177,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-CG6spHKI.d.ts → plugin-dpLzOtF6.d.ts}

@@ -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;
@@ -177,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/types/index.d.mts

@@ -1,4 +1,4 @@
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-CG6spHKI.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition, U as User } from '../plugin-dpLzOtF6.mjs';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, D as DataRoom, b as DataRoomFile, a 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-Dtd9LLHf.mjs';
 
 interface AgentResource {

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-CG6spHKI.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition, U as User } from '../plugin-dpLzOtF6.js';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, D as DataRoom, b as DataRoomFile, a 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-Dtd9LLHf.js';
 
 interface AgentResource {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palettelab/sdk",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Palette Platform SDK for building plugins and apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",