@palettelab/sdk 0.1.23 → 0.1.25

package/README.md

@@ -185,6 +185,7 @@ Public frontend helpers exported by `@palettelab/sdk`:
 - Organization/user: `UserClient`, `OrganizationClient`, including `current`, `updateProfile`, `listMine`, `listMembers`, `getMember`, `getMemberByEmail`, `inviteMember`, and `updateMemberRole`.
 - Permissions: `hasPermission(ctx, permission)`, `hasAnyPermission(ctx, permissions)`, `hasAllPermissions(ctx, permissions)`.
 - Translations: `normalizePaletteLanguage`, `translate`, `usePluginTranslations`.
+- OS context: `usePlatform().language`, `usePlatform().setLanguage()`, `usePlatform().colorMode`, and `usePlatform().setColorMode()`.
 - Hooks: `usePluginTasks`, `usePluginDataRooms`, `usePluginChat`.
 - Sandbox: `createSandboxBridge`, `isSandboxRuntime`.
 - Testing: `createMockPlatformContext`, `withPluginProvider`.
@@ -249,6 +250,32 @@ function App() {
 The same context is available in `pltt dev`, so local development and OS runtime
 use the same translation path.
 
+## App Color Mode And OS Theme
+
+Palette OS also passes the current light/dark mode into every plugin through
+`usePlatform()`. Apps can read `colorMode` to update app-owned styling or call
+`setColorMode()` to request an OS-level light/dark change.
+
+```tsx
+import { usePlatform } from "@palettelab/sdk"
+
+function ThemeAwarePanel() {
+  const { colorMode, setColorMode } = usePlatform()
+
+  return (
+    <section data-color-mode={colorMode}>
+      <button onClick={() => setColorMode(colorMode === "dark" ? "light" : "dark")}>
+        Switch to {colorMode === "dark" ? "light" : "dark"}
+      </button>
+    </section>
+  )
+}
+```
+
+Native React apps re-render when Palette OS changes between light and dark mode.
+For non-React code, Palette OS also dispatches a `palette:theme-change` browser
+event with `{ colorMode: "light" | "dark" }` in `event.detail`.
+
 ## Next-Compatible Apps
 
 The Palette appstore runtime loads plugin frontends as native React modules. If
@@ -565,6 +592,7 @@ import { createSandboxBridge, isSandboxRuntime } from "@palettelab/sdk"
 if (isSandboxRuntime()) {
   const bridge = createSandboxBridge()
   const result = await bridge.apiFetch("/api/v1/tasks")
+  const colorMode = bridge.getColorMode()
   console.log(result)
 }
 ```

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-DXqw6d0s.mjs';
+import { P as PlatformContext } from '../plugin-EHBRmN0H.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-DXqw6d0s.js';
+import { P as PlatformContext } from '../plugin-EHBRmN0H.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-CmY9M7Rg.mjs';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-DZqNC7hK.mjs';
 import 'react';
-import '../plugin-DXqw6d0s.mjs';
+import '../plugin-EHBRmN0H.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-CGSwI4TZ.js';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-BFvgg3uv.js';
 import 'react';
-import '../plugin-DXqw6d0s.js';
+import '../plugin-EHBRmN0H.js';
 import '../data-room-Dtd9LLHf.js';

package/dist/{index-CGSwI4TZ.d.ts → index-BFvgg3uv.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-DXqw6d0s.js';
+import { e as PaletteLanguage, P as PlatformContext } from './plugin-EHBRmN0H.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;
@@ -35,7 +35,7 @@ declare const PlatformCtx: react.Context<PlatformContext | null>;
 /**
  * Access the platform context from within a plugin component.
  *
- * Provides: user, organizationId, agents, apiFetch, navigate, showToast
+ * Provides: user, organizationId, agents, language, colorMode, apiFetch, navigate, showToast
  *
  * @example
  * ```tsx

package/dist/{index-CmY9M7Rg.d.mts → index-DZqNC7hK.d.mts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-DXqw6d0s.mjs';
+import { e as PaletteLanguage, P as PlatformContext } from './plugin-EHBRmN0H.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;
@@ -35,7 +35,7 @@ declare const PlatformCtx: react.Context<PlatformContext | null>;
 /**
  * Access the platform context from within a plugin component.
  *
- * Provides: user, organizationId, agents, apiFetch, navigate, showToast
+ * Provides: user, organizationId, agents, language, colorMode, apiFetch, navigate, showToast
  *
  * @example
  * ```tsx

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-DXqw6d0s.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-DXqw6d0s.mjs';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-EHBRmN0H.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteColorMode, e as PaletteLanguage, f as PluginAgentDefinition, g as PluginComponentProps, h as PluginConnectionDefinition, i as PluginManifest, j as PluginToolDefinition } from './plugin-EHBRmN0H.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-CmY9M7Rg.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-DZqNC7hK.mjs';
 export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
@@ -77,8 +77,10 @@ type SandboxBridge = {
     showToast: (message: string, type?: ToastType) => void;
     getLanguage: () => PlatformContext["language"];
     setLanguage: PlatformContext["setLanguage"];
+    getColorMode: () => PlatformContext["colorMode"];
+    setColorMode: PlatformContext["setColorMode"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage" | "colorMode" | "setColorMode">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;
@@ -187,6 +189,56 @@ declare const broker: {
 /** Typed proxy: `palette.services("org/v1").members.list({ ... })`. */
 declare function servicesProxy(namespaceVersion: string): any;
 
+/**
+ * OS notifications — push a notification into the OS-level notification pool.
+ *
+ *   import { notifications } from "@palettelab/sdk"
+ *
+ *   await notifications.push({
+ *     title: "Export complete",
+ *     body: "Your report is ready to download.",
+ *     severity: "success",
+ *     route: "/exports/123",          // opened inside this app when clicked
+ *   })
+ *
+ * The notification appears in the OS notification center (and as a transient
+ * toast); clicking it opens/focuses the app window at `action_route`.
+ *
+ * The stable contract is `POST /api/v1/notifications/` on the platform API —
+ * this helper is sugar over it. Runs in the user's session (cookies included);
+ * sandboxed iframe apps are not supported yet (no session in the iframe).
+ */
+type OsNotificationSeverity = "info" | "success" | "warning" | "error";
+type OsNotificationInput = {
+    title: string;
+    body?: string;
+    /**
+     * Route to open when the notification is clicked. Relative routes
+     * ("/exports/123") resolve inside the calling app; absolute routes
+     * ("/apps/other-app") are used as-is.
+     */
+    route?: string;
+    severity?: OsNotificationSeverity;
+    /** Arbitrary structured payload, stored alongside the notification. */
+    data?: Record<string, unknown>;
+    /** Override the source app id. Inferred from the URL when omitted. */
+    appId?: string;
+};
+type OsNotification = {
+    id: number;
+    type: string;
+    title: string;
+    body: string | null;
+    source_app_id: string | null;
+    action_route: string | null;
+    severity: OsNotificationSeverity | null;
+    is_read: boolean;
+    created_at: string;
+};
+declare const notifications: {
+    push(input: OsNotificationInput): Promise<OsNotification>;
+};
+
 interface DataRoomContents {
     room?: DataRoom;
     folders: DataRoomFolder[];
@@ -230,9 +282,11 @@ declare class DataRoomClient {
         upload_url: string;
         blob_path: string;
         file_url: string;
+        content_type?: string;
     }>;
     confirmUpload(roomId: number, file: File, upload: {
         blob_path: string;
+        content_type?: string;
     }, options?: DataRoomUploadOptions): Promise<DataRoomFile>;
     uploadFile(roomId: number, file: File, options?: DataRoomUploadOptions): Promise<DataRoomFile>;
 }
@@ -346,6 +400,13 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         error: (message: string) => void | undefined;
         info: (message: string) => void | undefined;
     };
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+        push: (input: OsNotificationInput) => Promise<OsNotification>;
+    };
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -393,6 +454,13 @@ declare const palette: {
         error: (message: string) => void | undefined;
         info: (message: string) => void | undefined;
     };
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+        push: (input: OsNotificationInput) => Promise<OsNotification>;
+    };
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -419,4 +487,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 { BrokerCallError, type BrokerCallOptions, type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, CrossAppGrantError, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type EventMeta, type InstallConfig, MissingDependencyError, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, type SandboxBrokerMessage, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, broker, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, events, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, palette, requireConnection, servicesProxy, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { BrokerCallError, type BrokerCallOptions, type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, CrossAppGrantError, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type EventMeta, type InstallConfig, MissingDependencyError, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, type OsNotification, type OsNotificationInput, type OsNotificationSeverity, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, type SandboxBrokerMessage, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, broker, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, events, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, notifications, palette, requireConnection, servicesProxy, 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-DXqw6d0s.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-DXqw6d0s.js';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-EHBRmN0H.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteColorMode, e as PaletteLanguage, f as PluginAgentDefinition, g as PluginComponentProps, h as PluginConnectionDefinition, i as PluginManifest, j as PluginToolDefinition } from './plugin-EHBRmN0H.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-CGSwI4TZ.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-BFvgg3uv.js';
 export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
@@ -77,8 +77,10 @@ type SandboxBridge = {
     showToast: (message: string, type?: ToastType) => void;
     getLanguage: () => PlatformContext["language"];
     setLanguage: PlatformContext["setLanguage"];
+    getColorMode: () => PlatformContext["colorMode"];
+    setColorMode: PlatformContext["setColorMode"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage" | "colorMode" | "setColorMode">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;
@@ -187,6 +189,56 @@ declare const broker: {
 /** Typed proxy: `palette.services("org/v1").members.list({ ... })`. */
 declare function servicesProxy(namespaceVersion: string): any;
 
+/**
+ * OS notifications — push a notification into the OS-level notification pool.
+ *
+ *   import { notifications } from "@palettelab/sdk"
+ *
+ *   await notifications.push({
+ *     title: "Export complete",
+ *     body: "Your report is ready to download.",
+ *     severity: "success",
+ *     route: "/exports/123",          // opened inside this app when clicked
+ *   })
+ *
+ * The notification appears in the OS notification center (and as a transient
+ * toast); clicking it opens/focuses the app window at `action_route`.
+ *
+ * The stable contract is `POST /api/v1/notifications/` on the platform API —
+ * this helper is sugar over it. Runs in the user's session (cookies included);
+ * sandboxed iframe apps are not supported yet (no session in the iframe).
+ */
+type OsNotificationSeverity = "info" | "success" | "warning" | "error";
+type OsNotificationInput = {
+    title: string;
+    body?: string;
+    /**
+     * Route to open when the notification is clicked. Relative routes
+     * ("/exports/123") resolve inside the calling app; absolute routes
+     * ("/apps/other-app") are used as-is.
+     */
+    route?: string;
+    severity?: OsNotificationSeverity;
+    /** Arbitrary structured payload, stored alongside the notification. */
+    data?: Record<string, unknown>;
+    /** Override the source app id. Inferred from the URL when omitted. */
+    appId?: string;
+};
+type OsNotification = {
+    id: number;
+    type: string;
+    title: string;
+    body: string | null;
+    source_app_id: string | null;
+    action_route: string | null;
+    severity: OsNotificationSeverity | null;
+    is_read: boolean;
+    created_at: string;
+};
+declare const notifications: {
+    push(input: OsNotificationInput): Promise<OsNotification>;
+};
+
 interface DataRoomContents {
     room?: DataRoom;
     folders: DataRoomFolder[];
@@ -230,9 +282,11 @@ declare class DataRoomClient {
         upload_url: string;
         blob_path: string;
         file_url: string;
+        content_type?: string;
     }>;
     confirmUpload(roomId: number, file: File, upload: {
         blob_path: string;
+        content_type?: string;
     }, options?: DataRoomUploadOptions): Promise<DataRoomFile>;
     uploadFile(roomId: number, file: File, options?: DataRoomUploadOptions): Promise<DataRoomFile>;
 }
@@ -346,6 +400,13 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         error: (message: string) => void | undefined;
         info: (message: string) => void | undefined;
     };
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+        push: (input: OsNotificationInput) => Promise<OsNotification>;
+    };
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -393,6 +454,13 @@ declare const palette: {
         error: (message: string) => void | undefined;
         info: (message: string) => void | undefined;
     };
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+        push: (input: OsNotificationInput) => Promise<OsNotification>;
+    };
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -419,4 +487,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 { BrokerCallError, type BrokerCallOptions, type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, CrossAppGrantError, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type EventMeta, type InstallConfig, MissingDependencyError, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, type SandboxBrokerMessage, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, broker, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, events, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, palette, requireConnection, servicesProxy, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { BrokerCallError, type BrokerCallOptions, type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, CrossAppGrantError, DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type EventMeta, type InstallConfig, MissingDependencyError, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, type OsNotification, type OsNotificationInput, type OsNotificationSeverity, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, type SandboxBrokerMessage, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, broker, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, events, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, notifications, palette, requireConnection, servicesProxy, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.js

@@ -52,6 +52,7 @@ __export(src_exports, {
   isSandboxRuntime: () => isSandboxRuntime,
   normalizePaletteLanguage: () => normalizePaletteLanguage,
   notFound: () => notFound,
+  notifications: () => notifications,
   palette: () => palette,
   requireConnection: () => requireConnection,
   servicesProxy: () => servicesProxy,
@@ -164,6 +165,9 @@ function createSandboxBridge(platform) {
     showToast: platform.showToast,
     getLanguage: () => platform.language ?? "en",
     setLanguage: platform.setLanguage ?? (() => {
+    }),
+    getColorMode: () => platform.colorMode ?? "light",
+    setColorMode: platform.setColorMode ?? (() => {
     })
   };
 }
@@ -269,6 +273,9 @@ function createMockPlatformContext(overrides = {}) {
     supportedLanguages: ["en", "ko"],
     setLanguage: () => {
     },
+    colorMode: "light",
+    setColorMode: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -367,13 +374,14 @@ var DataRoomClient = class {
     return res.json();
   }
   async confirmUpload(roomId, file, upload, options = {}) {
+    const contentType = upload.content_type ?? options.contentType ?? file.type ?? "application/octet-stream";
     const res = await apiFetch(`/api/v1/data-rooms/${roomId}/files/confirm-upload`, {
       method: "POST",
       body: JSON.stringify({
         blob_path: upload.blob_path,
         original_filename: file.name,
         file_size: file.size,
-        mime_type: options.contentType ?? file.type ?? "application/octet-stream",
+        mime_type: contentType,
         folder_id: options.folderId ?? null
       })
     });
@@ -381,9 +389,10 @@ var DataRoomClient = class {
   }
   async uploadFile(roomId, file, options = {}) {
     const upload = await this.requestUpload(roomId, file, options);
+    const contentType = upload.content_type ?? options.contentType ?? file.type ?? "application/octet-stream";
     const put = await fetch(upload.upload_url, {
       method: "PUT",
-      headers: { "Content-Type": options.contentType ?? file.type ?? "application/octet-stream" },
+      headers: { "Content-Type": contentType },
       body: file
     });
     if (!put.ok) throw new Error(`Upload failed: ${put.statusText}`);
@@ -392,6 +401,13 @@ var DataRoomClient = class {
 };
 var dataRooms = new DataRoomClient();
 
+// src/plugin-id.ts
+function currentPluginId() {
+  if (typeof window === "undefined") return void 0;
+  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
+  return match ? decodeURIComponent(match[1]) : void 0;
+}
+
 // src/services.ts
 var BrokerCallError = class extends Error {
   constructor(message, target, status) {
@@ -424,11 +440,6 @@ function brokerError(message, target, status) {
   return new BrokerCallError(message, target, status);
 }
 var CALLER_HEADER = "X-Palette-Caller-App";
-function currentPluginId() {
-  if (typeof window === "undefined") return void 0;
-  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
-  return match ? decodeURIComponent(match[1]) : void 0;
-}
 async function brokerCallDirect(target, payload, options = {}) {
   const callerAppId = options.callerAppId ?? currentPluginId();
   const headers = {};
@@ -553,16 +564,11 @@ var SUBSCRIBERS = /* @__PURE__ */ new Map();
 var activeStream = null;
 var activeStreamUrl = null;
 var sandboxBound = false;
-function currentPluginId2() {
-  if (typeof window === "undefined") return void 0;
-  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
-  return match ? decodeURIComponent(match[1]) : void 0;
-}
 function streamUrl() {
   const params = new URLSearchParams();
   const targets = Array.from(SUBSCRIBERS.keys());
   if (targets.length) params.set("targets", targets.join(","));
-  const callerAppId = currentPluginId2();
+  const callerAppId = currentPluginId();
   if (callerAppId) params.set("caller_app_id", callerAppId);
   const query = params.toString();
   return `${getBaseUrl()}/api/v1/os-broker/events/stream${query ? `?${query}` : ""}`;
@@ -658,6 +664,32 @@ var events = {
   }
 };
 
+// src/notifications.ts
+function resolveActionRoute(route, appId) {
+  if (!route) return appId ? `/apps/${appId}` : void 0;
+  if (route.startsWith("/apps/")) return route;
+  if (!appId) return route;
+  return `/apps/${appId}${route.startsWith("/") ? route : `/${route}`}`;
+}
+var notifications = {
+  async push(input) {
+    const appId = input.appId ?? currentPluginId();
+    const res = await apiFetch("/api/v1/notifications/", {
+      method: "POST",
+      body: JSON.stringify({
+        title: input.title,
+        body: input.body,
+        type: "app",
+        source_app_id: appId,
+        action_route: resolveActionRoute(input.route, appId),
+        severity: input.severity,
+        data: input.data
+      })
+    });
+    return await res.json();
+  }
+};
+
 // src/permissions.ts
 function hasPermission(ctx, permission) {
   return ctx.permissions?.includes(permission) ?? false;
@@ -988,6 +1020,13 @@ function createPaletteClient(ctx) {
       error: (message) => ctx?.showToast(message, "error"),
       info: (message) => ctx?.showToast(message, "info")
     },
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+      push: (input) => notifications.push({ appId: ctx?.pluginId || void 0, ...input })
+    },
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -1496,6 +1535,7 @@ function usePluginChat(agentId) {
   isSandboxRuntime,
   normalizePaletteLanguage,
   notFound,
+  notifications,
   palette,
   requireConnection,
   servicesProxy,

package/dist/index.mjs

@@ -89,6 +89,9 @@ function createSandboxBridge(platform) {
     showToast: platform.showToast,
     getLanguage: () => platform.language ?? "en",
     setLanguage: platform.setLanguage ?? (() => {
+    }),
+    getColorMode: () => platform.colorMode ?? "light",
+    setColorMode: platform.setColorMode ?? (() => {
     })
   };
 }
@@ -194,6 +197,9 @@ function createMockPlatformContext(overrides = {}) {
     supportedLanguages: ["en", "ko"],
     setLanguage: () => {
     },
+    colorMode: "light",
+    setColorMode: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -292,13 +298,14 @@ var DataRoomClient = class {
     return res.json();
   }
   async confirmUpload(roomId, file, upload, options = {}) {
+    const contentType = upload.content_type ?? options.contentType ?? file.type ?? "application/octet-stream";
     const res = await apiFetch(`/api/v1/data-rooms/${roomId}/files/confirm-upload`, {
       method: "POST",
       body: JSON.stringify({
         blob_path: upload.blob_path,
         original_filename: file.name,
         file_size: file.size,
-        mime_type: options.contentType ?? file.type ?? "application/octet-stream",
+        mime_type: contentType,
         folder_id: options.folderId ?? null
       })
     });
@@ -306,9 +313,10 @@ var DataRoomClient = class {
   }
   async uploadFile(roomId, file, options = {}) {
     const upload = await this.requestUpload(roomId, file, options);
+    const contentType = upload.content_type ?? options.contentType ?? file.type ?? "application/octet-stream";
     const put = await fetch(upload.upload_url, {
       method: "PUT",
-      headers: { "Content-Type": options.contentType ?? file.type ?? "application/octet-stream" },
+      headers: { "Content-Type": contentType },
       body: file
     });
     if (!put.ok) throw new Error(`Upload failed: ${put.statusText}`);
@@ -317,6 +325,13 @@ var DataRoomClient = class {
 };
 var dataRooms = new DataRoomClient();
 
+// src/plugin-id.ts
+function currentPluginId() {
+  if (typeof window === "undefined") return void 0;
+  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
+  return match ? decodeURIComponent(match[1]) : void 0;
+}
+
 // src/services.ts
 var BrokerCallError = class extends Error {
   constructor(message, target, status) {
@@ -349,11 +364,6 @@ function brokerError(message, target, status) {
   return new BrokerCallError(message, target, status);
 }
 var CALLER_HEADER = "X-Palette-Caller-App";
-function currentPluginId() {
-  if (typeof window === "undefined") return void 0;
-  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
-  return match ? decodeURIComponent(match[1]) : void 0;
-}
 async function brokerCallDirect(target, payload, options = {}) {
   const callerAppId = options.callerAppId ?? currentPluginId();
   const headers = {};
@@ -478,16 +488,11 @@ var SUBSCRIBERS = /* @__PURE__ */ new Map();
 var activeStream = null;
 var activeStreamUrl = null;
 var sandboxBound = false;
-function currentPluginId2() {
-  if (typeof window === "undefined") return void 0;
-  const match = window.location.pathname.match(/\/apps\/([^/?#]+)/);
-  return match ? decodeURIComponent(match[1]) : void 0;
-}
 function streamUrl() {
   const params = new URLSearchParams();
   const targets = Array.from(SUBSCRIBERS.keys());
   if (targets.length) params.set("targets", targets.join(","));
-  const callerAppId = currentPluginId2();
+  const callerAppId = currentPluginId();
   if (callerAppId) params.set("caller_app_id", callerAppId);
   const query = params.toString();
   return `${getBaseUrl()}/api/v1/os-broker/events/stream${query ? `?${query}` : ""}`;
@@ -583,6 +588,32 @@ var events = {
   }
 };
 
+// src/notifications.ts
+function resolveActionRoute(route, appId) {
+  if (!route) return appId ? `/apps/${appId}` : void 0;
+  if (route.startsWith("/apps/")) return route;
+  if (!appId) return route;
+  return `/apps/${appId}${route.startsWith("/") ? route : `/${route}`}`;
+}
+var notifications = {
+  async push(input) {
+    const appId = input.appId ?? currentPluginId();
+    const res = await apiFetch("/api/v1/notifications/", {
+      method: "POST",
+      body: JSON.stringify({
+        title: input.title,
+        body: input.body,
+        type: "app",
+        source_app_id: appId,
+        action_route: resolveActionRoute(input.route, appId),
+        severity: input.severity,
+        data: input.data
+      })
+    });
+    return await res.json();
+  }
+};
+
 // src/permissions.ts
 function hasPermission(ctx, permission) {
   return ctx.permissions?.includes(permission) ?? false;
@@ -913,6 +944,13 @@ function createPaletteClient(ctx) {
       error: (message) => ctx?.showToast(message, "error"),
       info: (message) => ctx?.showToast(message, "info")
     },
+    /**
+     * OS notification pool. Unlike `toast`, these persist in the OS
+     * notification center and can open the app when clicked.
+     */
+    notifications: {
+      push: (input) => notifications.push({ appId: ctx?.pluginId || void 0, ...input })
+    },
     /**
      * OS-broker RPC. Typed entry point: `palette.services("org/v1").members.list({...})`.
      * The proxy resolves a dotted method chain into a qualified target string
@@ -1429,6 +1467,7 @@ export {
   isSandboxRuntime,
   normalizePaletteLanguage,
   notFound,
+  notifications,
   palette,
   requireConnection,
   servicesProxy,

package/dist/{plugin-DXqw6d0s.d.mts → plugin-EHBRmN0H.d.mts}

@@ -69,6 +69,8 @@ interface AgentConfig {
 
 /** BCP-47 language tag used by Palette OS and plugin translation helpers */
 type PaletteLanguage = string;
+/** Palette OS light/dark interface mode */
+type PaletteColorMode = "light" | "dark";
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -240,6 +242,10 @@ interface PlatformContext {
     supportedLanguages: PaletteLanguage[];
     /** Update the Palette OS language preference */
     setLanguage: (language: PaletteLanguage) => void;
+    /** Current Palette OS light/dark interface mode */
+    colorMode: PaletteColorMode;
+    /** Update the Palette OS light/dark interface mode */
+    setColorMode: (mode: PaletteColorMode) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -256,4 +262,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, PluginConnectionDefinition as g, PluginManifest as h, PluginToolDefinition as i };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteColorMode as d, PaletteLanguage as e, PluginAgentDefinition as f, PluginComponentProps as g, PluginConnectionDefinition as h, PluginManifest as i, PluginToolDefinition as j };

package/dist/{plugin-DXqw6d0s.d.ts → plugin-EHBRmN0H.d.ts}

@@ -69,6 +69,8 @@ interface AgentConfig {
 
 /** BCP-47 language tag used by Palette OS and plugin translation helpers */
 type PaletteLanguage = string;
+/** Palette OS light/dark interface mode */
+type PaletteColorMode = "light" | "dark";
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -240,6 +242,10 @@ interface PlatformContext {
     supportedLanguages: PaletteLanguage[];
     /** Update the Palette OS language preference */
     setLanguage: (language: PaletteLanguage) => void;
+    /** Current Palette OS light/dark interface mode */
+    colorMode: PaletteColorMode;
+    /** Update the Palette OS light/dark interface mode */
+    setColorMode: (mode: PaletteColorMode) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -256,4 +262,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, PluginConnectionDefinition as g, PluginManifest as h, PluginToolDefinition as i };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteColorMode as d, PaletteLanguage as e, PluginAgentDefinition as f, PluginComponentProps as g, PluginConnectionDefinition as h, PluginManifest as i, PluginToolDefinition as j };

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 PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition, U as User } from '../plugin-DXqw6d0s.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteColorMode, e as PaletteLanguage, P as PlatformContext, f as PluginAgentDefinition, g as PluginComponentProps, h as PluginConnectionDefinition, i as PluginManifest, j as PluginToolDefinition, U as User } from '../plugin-EHBRmN0H.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 PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition, U as User } from '../plugin-DXqw6d0s.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteColorMode, e as PaletteLanguage, P as PlatformContext, f as PluginAgentDefinition, g as PluginComponentProps, h as PluginConnectionDefinition, i as PluginManifest, j as PluginToolDefinition, U as User } from '../plugin-EHBRmN0H.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.23",
+  "version": "0.1.25",
   "description": "Palette Platform SDK for building plugins and apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",