@palettelab/sdk 0.1.10 → 0.1.11

package/README.md

@@ -122,6 +122,7 @@ import {
   PluginProvider,
   usePlatform,
   createPaletteClient,
+  usePluginTranslations,
   usePluginTasks,
   usePluginDataRooms,
   usePluginChat,
@@ -169,6 +170,37 @@ export default function PluginRoot(props: PluginComponentProps) {
 }
 ```
 
+## App Translations And OS Language
+
+Palette OS passes the current global language into every plugin through
+`usePlatform()`. Keep translations in your app repo, then let the SDK choose the
+right language.
+
+```tsx
+import { usePluginTranslations, type TranslationResources } from "@palettelab/sdk"
+
+const resources = {
+  en: { title: "Invoices", greeting: "Hello, {{name}}" },
+  ko: { title: "청구서", greeting: "안녕하세요, {{name}}님" },
+} satisfies TranslationResources
+
+function App() {
+  const { t, language, setLanguage } = usePluginTranslations(resources)
+
+  return (
+    <main>
+      <h1>{t("title")}</h1>
+      <button onClick={() => setLanguage(language === "ko" ? "en" : "ko")}>
+        {language === "ko" ? "EN" : "KO"}
+      </button>
+    </main>
+  )
+}
+```
+
+The same context is available in `pltt dev`, so local development and OS runtime
+use the same translation path.
+
 ## Palette Client
 
 Use `createPaletteClient()` when an app needs common Palette OS services without
@@ -332,7 +364,7 @@ Use the SDK test utilities to render plugin components with a mock platform cont
 import { createMockPlatformContext, withPluginProvider } from "@palettelab/sdk"
 
 const ctx = createMockPlatformContext({
-  pluginId: "hello-sdk",
+  pluginId: "my-plugin",
   organizationId: 1,
 })
 

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-o-qmdCBl.mjs';
+import { P as PlatformContext } from '../plugin-DZRaxKt3.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-o-qmdCBl.js';
+import { P as PlatformContext } from '../plugin-DZRaxKt3.js';
 
 /**
  * Provider that wraps plugin components with the platform context.

package/dist/hooks/index.d.mts

@@ -1,71 +1,4 @@
-import * as react from 'react';
-import { P as PlatformContext } from '../plugin-o-qmdCBl.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';
-
-/**
- * React context for platform services.
- * The platform runtime provides this — plugin developers consume it.
- */
-declare const PlatformCtx: react.Context<PlatformContext | null>;
-/**
- * Access the platform context from within a plugin component.
- *
- * Provides: user, organizationId, agents, apiFetch, navigate, showToast
- *
- * @example
- * ```tsx
- * import { usePlatform } from "@palettelab/sdk/hooks"
- *
- * function MyPlugin() {
- *   const { user, apiFetch, showToast } = usePlatform()
- *   // ...
- * }
- * ```
- */
-declare function usePlatform(): PlatformContext;
-
-/**
- * Hook for managing tasks from within a plugin.
- *
- * @param agentId - Optional agent ID to filter tasks
- */
-declare function usePluginTasks(agentId?: number): {
-    tasks: Task[];
-    stats: TaskStats | null;
-    loading: boolean;
-    createTask: (payload: TaskCreatePayload) => Promise<Task>;
-    updateTask: (taskId: number, payload: TaskUpdatePayload) => Promise<Task>;
-    deleteTask: (taskId: number) => Promise<void>;
-    refetch: () => Promise<void>;
-};
-
-/**
- * Hook for accessing data rooms from within a plugin.
- */
-declare function usePluginDataRooms(): {
-    rooms: DataRoom[];
-    loading: boolean;
-    fetchFolder: (roomId: number, folderId?: number) => Promise<{
-        folders: DataRoomFolder[];
-        files: DataRoomFile[];
-    }>;
-    refetch: () => Promise<void>;
-};
-
-/**
- * Hook for chat functionality within a plugin.
- * Supports creating threads, sending messages, and SSE streaming.
- */
-declare function usePluginChat(agentId: number): {
-    threads: ChatThread[];
-    messages: ChatMessage[];
-    streaming: boolean;
-    activeThreadId: string | null;
-    fetchThreads: () => Promise<void>;
-    createThread: () => Promise<ChatThread>;
-    fetchMessages: (threadId: string) => Promise<void>;
-    sendMessage: (threadId: string, content: string) => Promise<void>;
-    stopStreaming: () => void;
-};
-
-export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks };
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-BL37Z-Ns.mjs';
+import 'react';
+import '../plugin-DZRaxKt3.mjs';
+import '../data-room-Dtd9LLHf.mjs';

package/dist/hooks/index.d.ts

@@ -1,71 +1,4 @@
-import * as react from 'react';
-import { P as PlatformContext } from '../plugin-o-qmdCBl.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';
-
-/**
- * React context for platform services.
- * The platform runtime provides this — plugin developers consume it.
- */
-declare const PlatformCtx: react.Context<PlatformContext | null>;
-/**
- * Access the platform context from within a plugin component.
- *
- * Provides: user, organizationId, agents, apiFetch, navigate, showToast
- *
- * @example
- * ```tsx
- * import { usePlatform } from "@palettelab/sdk/hooks"
- *
- * function MyPlugin() {
- *   const { user, apiFetch, showToast } = usePlatform()
- *   // ...
- * }
- * ```
- */
-declare function usePlatform(): PlatformContext;
-
-/**
- * Hook for managing tasks from within a plugin.
- *
- * @param agentId - Optional agent ID to filter tasks
- */
-declare function usePluginTasks(agentId?: number): {
-    tasks: Task[];
-    stats: TaskStats | null;
-    loading: boolean;
-    createTask: (payload: TaskCreatePayload) => Promise<Task>;
-    updateTask: (taskId: number, payload: TaskUpdatePayload) => Promise<Task>;
-    deleteTask: (taskId: number) => Promise<void>;
-    refetch: () => Promise<void>;
-};
-
-/**
- * Hook for accessing data rooms from within a plugin.
- */
-declare function usePluginDataRooms(): {
-    rooms: DataRoom[];
-    loading: boolean;
-    fetchFolder: (roomId: number, folderId?: number) => Promise<{
-        folders: DataRoomFolder[];
-        files: DataRoomFile[];
-    }>;
-    refetch: () => Promise<void>;
-};
-
-/**
- * Hook for chat functionality within a plugin.
- * Supports creating threads, sending messages, and SSE streaming.
- */
-declare function usePluginChat(agentId: number): {
-    threads: ChatThread[];
-    messages: ChatMessage[];
-    streaming: boolean;
-    activeThreadId: string | null;
-    fetchThreads: () => Promise<void>;
-    createThread: () => Promise<ChatThread>;
-    fetchMessages: (threadId: string) => Promise<void>;
-    sendMessage: (threadId: string, content: string) => Promise<void>;
-    stopStreaming: () => void;
-};
-
-export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks };
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-DEvPH60n.js';
+import 'react';
+import '../plugin-DZRaxKt3.js';
+import '../data-room-Dtd9LLHf.js';

package/dist/hooks/index.js

@@ -24,7 +24,8 @@ __export(hooks_exports, {
   usePlatform: () => usePlatform,
   usePluginChat: () => usePluginChat,
   usePluginDataRooms: () => usePluginDataRooms,
-  usePluginTasks: () => usePluginTasks
+  usePluginTasks: () => usePluginTasks,
+  usePluginTranslations: () => usePluginTranslations
 });
 module.exports = __toCommonJS(hooks_exports);
 
@@ -242,11 +243,75 @@ function usePluginChat(agentId) {
     stopStreaming
   };
 }
+
+// src/i18n.ts
+var import_react5 = require("react");
+function normalizePaletteLanguage(language, fallback = "en") {
+  const trimmed = language?.trim().toLowerCase();
+  if (!trimmed) return fallback;
+  return trimmed.split("-")[0] || fallback;
+}
+function languageCandidates(language, fallbackLanguage = "en") {
+  const candidates = [
+    language,
+    normalizePaletteLanguage(language, fallbackLanguage),
+    fallbackLanguage,
+    normalizePaletteLanguage(fallbackLanguage, "en"),
+    "en"
+  ].filter(Boolean);
+  return Array.from(new Set(candidates));
+}
+function getValue(dictionary, key) {
+  if (!dictionary) return void 0;
+  let current = dictionary;
+  for (const part of key.split(".")) {
+    if (current === null || typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[part];
+  }
+  if (typeof current === "string" || typeof current === "number" || typeof current === "boolean" || current === null) {
+    return current;
+  }
+  return void 0;
+}
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(/\{\{?\s*([a-zA-Z0-9_.-]+)\s*\}?\}/g, (match, key) => {
+    const value = values[key];
+    return value === void 0 || value === null ? match : String(value);
+  });
+}
+function translate(resources, key, options = {}) {
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage, "en");
+  for (const language of languageCandidates(options.language, fallbackLanguage)) {
+    const value = getValue(resources[language], key);
+    if (value !== void 0) {
+      return interpolate(String(value ?? ""), options.values);
+    }
+  }
+  return interpolate(options.defaultValue ?? key, options.values);
+}
+function usePluginTranslations(resources, options = {}) {
+  const platform = usePlatform();
+  const language = normalizePaletteLanguage(platform.language, options.fallbackLanguage ?? platform.fallbackLanguage);
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage ?? platform.fallbackLanguage, "en");
+  const t = (0, import_react5.useCallback)(
+    (key, values, defaultValue) => translate(resources, key, { language, fallbackLanguage, values, defaultValue }),
+    [fallbackLanguage, language, resources]
+  );
+  return {
+    language,
+    fallbackLanguage,
+    supportedLanguages: platform.supportedLanguages,
+    setLanguage: platform.setLanguage,
+    t
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PlatformCtx,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
-  usePluginTasks
+  usePluginTasks,
+  usePluginTranslations
 });

package/dist/hooks/index.mjs

@@ -212,10 +212,74 @@ function usePluginChat(agentId) {
     stopStreaming
   };
 }
+
+// src/i18n.ts
+import { useCallback as useCallback4 } from "react";
+function normalizePaletteLanguage(language, fallback = "en") {
+  const trimmed = language?.trim().toLowerCase();
+  if (!trimmed) return fallback;
+  return trimmed.split("-")[0] || fallback;
+}
+function languageCandidates(language, fallbackLanguage = "en") {
+  const candidates = [
+    language,
+    normalizePaletteLanguage(language, fallbackLanguage),
+    fallbackLanguage,
+    normalizePaletteLanguage(fallbackLanguage, "en"),
+    "en"
+  ].filter(Boolean);
+  return Array.from(new Set(candidates));
+}
+function getValue(dictionary, key) {
+  if (!dictionary) return void 0;
+  let current = dictionary;
+  for (const part of key.split(".")) {
+    if (current === null || typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[part];
+  }
+  if (typeof current === "string" || typeof current === "number" || typeof current === "boolean" || current === null) {
+    return current;
+  }
+  return void 0;
+}
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(/\{\{?\s*([a-zA-Z0-9_.-]+)\s*\}?\}/g, (match, key) => {
+    const value = values[key];
+    return value === void 0 || value === null ? match : String(value);
+  });
+}
+function translate(resources, key, options = {}) {
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage, "en");
+  for (const language of languageCandidates(options.language, fallbackLanguage)) {
+    const value = getValue(resources[language], key);
+    if (value !== void 0) {
+      return interpolate(String(value ?? ""), options.values);
+    }
+  }
+  return interpolate(options.defaultValue ?? key, options.values);
+}
+function usePluginTranslations(resources, options = {}) {
+  const platform = usePlatform();
+  const language = normalizePaletteLanguage(platform.language, options.fallbackLanguage ?? platform.fallbackLanguage);
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage ?? platform.fallbackLanguage, "en");
+  const t = useCallback4(
+    (key, values, defaultValue) => translate(resources, key, { language, fallbackLanguage, values, defaultValue }),
+    [fallbackLanguage, language, resources]
+  );
+  return {
+    language,
+    fallbackLanguage,
+    supportedLanguages: platform.supportedLanguages,
+    setLanguage: platform.setLanguage,
+    t
+  };
+}
 export {
   PlatformCtx,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
-  usePluginTasks
+  usePluginTasks,
+  usePluginTranslations
 };

package/dist/index-BL37Z-Ns.d.mts

@@ -0,0 +1,96 @@
+import * as react from 'react';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-DZRaxKt3.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;
+type TranslationDictionary = {
+    [key: string]: TranslationPrimitive | TranslationDictionary;
+};
+type TranslationResources = Record<PaletteLanguage, TranslationDictionary>;
+type TranslationValues = Record<string, string | number | boolean | null | undefined>;
+interface TranslateOptions {
+    language?: PaletteLanguage;
+    fallbackLanguage?: PaletteLanguage;
+    defaultValue?: string;
+    values?: TranslationValues;
+}
+interface UsePluginTranslationsOptions {
+    fallbackLanguage?: PaletteLanguage;
+}
+declare function normalizePaletteLanguage(language?: string | null, fallback?: PaletteLanguage): PaletteLanguage;
+declare function translate(resources: TranslationResources, key: string, options?: TranslateOptions): string;
+declare function usePluginTranslations(resources: TranslationResources, options?: UsePluginTranslationsOptions): {
+    language: string;
+    fallbackLanguage: string;
+    supportedLanguages: string[];
+    setLanguage: (language: PaletteLanguage) => void;
+    t: (key: string, values?: TranslationValues, defaultValue?: string) => string;
+};
+
+/**
+ * React context for platform services.
+ * The platform runtime provides this — plugin developers consume it.
+ */
+declare const PlatformCtx: react.Context<PlatformContext | null>;
+/**
+ * Access the platform context from within a plugin component.
+ *
+ * Provides: user, organizationId, agents, apiFetch, navigate, showToast
+ *
+ * @example
+ * ```tsx
+ * import { usePlatform } from "@palettelab/sdk/hooks"
+ *
+ * function MyPlugin() {
+ *   const { user, apiFetch, showToast } = usePlatform()
+ *   // ...
+ * }
+ * ```
+ */
+declare function usePlatform(): PlatformContext;
+
+/**
+ * Hook for managing tasks from within a plugin.
+ *
+ * @param agentId - Optional agent ID to filter tasks
+ */
+declare function usePluginTasks(agentId?: number): {
+    tasks: Task[];
+    stats: TaskStats | null;
+    loading: boolean;
+    createTask: (payload: TaskCreatePayload) => Promise<Task>;
+    updateTask: (taskId: number, payload: TaskUpdatePayload) => Promise<Task>;
+    deleteTask: (taskId: number) => Promise<void>;
+    refetch: () => Promise<void>;
+};
+
+/**
+ * Hook for accessing data rooms from within a plugin.
+ */
+declare function usePluginDataRooms(): {
+    rooms: DataRoom[];
+    loading: boolean;
+    fetchFolder: (roomId: number, folderId?: number) => Promise<{
+        folders: DataRoomFolder[];
+        files: DataRoomFile[];
+    }>;
+    refetch: () => Promise<void>;
+};
+
+/**
+ * Hook for chat functionality within a plugin.
+ * Supports creating threads, sending messages, and SSE streaming.
+ */
+declare function usePluginChat(agentId: number): {
+    threads: ChatThread[];
+    messages: ChatMessage[];
+    streaming: boolean;
+    activeThreadId: string | null;
+    fetchThreads: () => Promise<void>;
+    createThread: () => Promise<ChatThread>;
+    fetchMessages: (threadId: string) => Promise<void>;
+    sendMessage: (threadId: string, content: string) => Promise<void>;
+    stopStreaming: () => void;
+};
+
+export { PlatformCtx as P, type TranslateOptions as T, type UsePluginTranslationsOptions as U, type TranslationDictionary as a, type TranslationPrimitive as b, type TranslationResources as c, type TranslationValues as d, usePluginChat as e, usePluginDataRooms as f, usePluginTasks as g, usePluginTranslations as h, normalizePaletteLanguage as n, translate as t, usePlatform as u };

package/dist/index-DEvPH60n.d.ts

@@ -0,0 +1,96 @@
+import * as react from 'react';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-DZRaxKt3.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;
+type TranslationDictionary = {
+    [key: string]: TranslationPrimitive | TranslationDictionary;
+};
+type TranslationResources = Record<PaletteLanguage, TranslationDictionary>;
+type TranslationValues = Record<string, string | number | boolean | null | undefined>;
+interface TranslateOptions {
+    language?: PaletteLanguage;
+    fallbackLanguage?: PaletteLanguage;
+    defaultValue?: string;
+    values?: TranslationValues;
+}
+interface UsePluginTranslationsOptions {
+    fallbackLanguage?: PaletteLanguage;
+}
+declare function normalizePaletteLanguage(language?: string | null, fallback?: PaletteLanguage): PaletteLanguage;
+declare function translate(resources: TranslationResources, key: string, options?: TranslateOptions): string;
+declare function usePluginTranslations(resources: TranslationResources, options?: UsePluginTranslationsOptions): {
+    language: string;
+    fallbackLanguage: string;
+    supportedLanguages: string[];
+    setLanguage: (language: PaletteLanguage) => void;
+    t: (key: string, values?: TranslationValues, defaultValue?: string) => string;
+};
+
+/**
+ * React context for platform services.
+ * The platform runtime provides this — plugin developers consume it.
+ */
+declare const PlatformCtx: react.Context<PlatformContext | null>;
+/**
+ * Access the platform context from within a plugin component.
+ *
+ * Provides: user, organizationId, agents, apiFetch, navigate, showToast
+ *
+ * @example
+ * ```tsx
+ * import { usePlatform } from "@palettelab/sdk/hooks"
+ *
+ * function MyPlugin() {
+ *   const { user, apiFetch, showToast } = usePlatform()
+ *   // ...
+ * }
+ * ```
+ */
+declare function usePlatform(): PlatformContext;
+
+/**
+ * Hook for managing tasks from within a plugin.
+ *
+ * @param agentId - Optional agent ID to filter tasks
+ */
+declare function usePluginTasks(agentId?: number): {
+    tasks: Task[];
+    stats: TaskStats | null;
+    loading: boolean;
+    createTask: (payload: TaskCreatePayload) => Promise<Task>;
+    updateTask: (taskId: number, payload: TaskUpdatePayload) => Promise<Task>;
+    deleteTask: (taskId: number) => Promise<void>;
+    refetch: () => Promise<void>;
+};
+
+/**
+ * Hook for accessing data rooms from within a plugin.
+ */
+declare function usePluginDataRooms(): {
+    rooms: DataRoom[];
+    loading: boolean;
+    fetchFolder: (roomId: number, folderId?: number) => Promise<{
+        folders: DataRoomFolder[];
+        files: DataRoomFile[];
+    }>;
+    refetch: () => Promise<void>;
+};
+
+/**
+ * Hook for chat functionality within a plugin.
+ * Supports creating threads, sending messages, and SSE streaming.
+ */
+declare function usePluginChat(agentId: number): {
+    threads: ChatThread[];
+    messages: ChatMessage[];
+    streaming: boolean;
+    activeThreadId: string | null;
+    fetchThreads: () => Promise<void>;
+    createThread: () => Promise<ChatThread>;
+    fetchMessages: (threadId: string) => Promise<void>;
+    sendMessage: (threadId: string, content: string) => Promise<void>;
+    stopStreaming: () => void;
+};
+
+export { PlatformCtx as P, type TranslateOptions as T, type UsePluginTranslationsOptions as U, type TranslationDictionary as a, type TranslationPrimitive as b, type TranslationResources as c, type TranslationValues as d, usePluginChat as e, usePluginDataRooms as f, usePluginTasks as g, usePluginTranslations as h, normalizePaletteLanguage as n, translate as t, usePlatform as u };

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-o-qmdCBl.mjs';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition } from './plugin-o-qmdCBl.mjs';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-DZRaxKt3.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-DZRaxKt3.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 { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.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-BL37Z-Ns.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
 
@@ -43,8 +43,10 @@ type SandboxBridge = {
     apiFetch: PlatformContext["apiFetch"];
     navigate: (path: string) => void;
     showToast: (message: string, type?: ToastType) => void;
+    getLanguage: () => PlatformContext["language"];
+    setLanguage: PlatformContext["setLanguage"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast">): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-o-qmdCBl.js';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition } from './plugin-o-qmdCBl.js';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-DZRaxKt3.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-DZRaxKt3.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 { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.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-DEvPH60n.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
 
@@ -43,8 +43,10 @@ type SandboxBridge = {
     apiFetch: PlatformContext["apiFetch"];
     navigate: (path: string) => void;
     showToast: (message: string, type?: ToastType) => void;
+    getLanguage: () => PlatformContext["language"];
+    setLanguage: PlatformContext["setLanguage"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast">): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;

package/dist/index.js

@@ -41,13 +41,16 @@ __export(src_exports, {
   hasPermission: () => hasPermission,
   isPaletteApiError: () => isPaletteApiError,
   isSandboxRuntime: () => isSandboxRuntime,
+  normalizePaletteLanguage: () => normalizePaletteLanguage,
   setBaseUrl: () => setBaseUrl,
+  translate: () => translate,
   updateInstallConfig: () => updateInstallConfig,
   uploadToSignedUrl: () => uploadToSignedUrl,
   usePlatform: () => usePlatform,
   usePluginChat: () => usePluginChat,
   usePluginDataRooms: () => usePluginDataRooms,
   usePluginTasks: () => usePluginTasks,
+  usePluginTranslations: () => usePluginTranslations,
   withPluginProvider: () => withPluginProvider
 });
 module.exports = __toCommonJS(src_exports);
@@ -140,7 +143,10 @@ function createSandboxBridge(platform) {
   return {
     apiFetch: platform.apiFetch,
     navigate: platform.navigate,
-    showToast: platform.showToast
+    showToast: platform.showToast,
+    getLanguage: () => platform.language ?? "en",
+    setLanguage: platform.setLanguage ?? (() => {
+    })
   };
 }
 function isSandboxRuntime() {
@@ -214,6 +220,11 @@ function createMockPlatformContext(overrides = {}) {
     orgs: [],
     agents: [],
     permissions: [],
+    language: "en",
+    fallbackLanguage: "en",
+    supportedLanguages: ["en", "ko"],
+    setLanguage: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -435,14 +446,77 @@ function createPaletteClient(ctx) {
   };
 }
 
-// src/hooks/use-plugin-tasks.ts
+// src/i18n.ts
 var import_react3 = require("react");
+function normalizePaletteLanguage(language, fallback = "en") {
+  const trimmed = language?.trim().toLowerCase();
+  if (!trimmed) return fallback;
+  return trimmed.split("-")[0] || fallback;
+}
+function languageCandidates(language, fallbackLanguage = "en") {
+  const candidates = [
+    language,
+    normalizePaletteLanguage(language, fallbackLanguage),
+    fallbackLanguage,
+    normalizePaletteLanguage(fallbackLanguage, "en"),
+    "en"
+  ].filter(Boolean);
+  return Array.from(new Set(candidates));
+}
+function getValue(dictionary, key) {
+  if (!dictionary) return void 0;
+  let current = dictionary;
+  for (const part of key.split(".")) {
+    if (current === null || typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[part];
+  }
+  if (typeof current === "string" || typeof current === "number" || typeof current === "boolean" || current === null) {
+    return current;
+  }
+  return void 0;
+}
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(/\{\{?\s*([a-zA-Z0-9_.-]+)\s*\}?\}/g, (match, key) => {
+    const value = values[key];
+    return value === void 0 || value === null ? match : String(value);
+  });
+}
+function translate(resources, key, options = {}) {
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage, "en");
+  for (const language of languageCandidates(options.language, fallbackLanguage)) {
+    const value = getValue(resources[language], key);
+    if (value !== void 0) {
+      return interpolate(String(value ?? ""), options.values);
+    }
+  }
+  return interpolate(options.defaultValue ?? key, options.values);
+}
+function usePluginTranslations(resources, options = {}) {
+  const platform = usePlatform();
+  const language = normalizePaletteLanguage(platform.language, options.fallbackLanguage ?? platform.fallbackLanguage);
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage ?? platform.fallbackLanguage, "en");
+  const t = (0, import_react3.useCallback)(
+    (key, values, defaultValue) => translate(resources, key, { language, fallbackLanguage, values, defaultValue }),
+    [fallbackLanguage, language, resources]
+  );
+  return {
+    language,
+    fallbackLanguage,
+    supportedLanguages: platform.supportedLanguages,
+    setLanguage: platform.setLanguage,
+    t
+  };
+}
+
+// src/hooks/use-plugin-tasks.ts
+var import_react4 = require("react");
 function usePluginTasks(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [tasks, setTasks] = (0, import_react3.useState)([]);
-  const [stats, setStats] = (0, import_react3.useState)(null);
-  const [loading, setLoading] = (0, import_react3.useState)(true);
-  const fetchTasks = (0, import_react3.useCallback)(async () => {
+  const [tasks, setTasks] = (0, import_react4.useState)([]);
+  const [stats, setStats] = (0, import_react4.useState)(null);
+  const [loading, setLoading] = (0, import_react4.useState)(true);
+  const fetchTasks = (0, import_react4.useCallback)(async () => {
     try {
       const params = new URLSearchParams();
       if (agentId) params.set("agent_id", String(agentId));
@@ -451,18 +525,18 @@ function usePluginTasks(agentId) {
     } catch {
     }
   }, [apiFetch2, agentId]);
-  const fetchStats = (0, import_react3.useCallback)(async () => {
+  const fetchStats = (0, import_react4.useCallback)(async () => {
     try {
       const res = await apiFetch2("/api/v1/tasks/stats");
       setStats(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     setLoading(true);
     Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
   }, [fetchTasks, fetchStats]);
-  const createTask = (0, import_react3.useCallback)(async (payload) => {
+  const createTask = (0, import_react4.useCallback)(async (payload) => {
     const res = await apiFetch2("/api/v1/tasks", {
       method: "POST",
       body: JSON.stringify(payload)
@@ -471,7 +545,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const updateTask = (0, import_react3.useCallback)(async (taskId, payload) => {
+  const updateTask = (0, import_react4.useCallback)(async (taskId, payload) => {
     const res = await apiFetch2(`/api/v1/tasks/${taskId}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
@@ -480,7 +554,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const deleteTask = (0, import_react3.useCallback)(async (taskId) => {
+  const deleteTask = (0, import_react4.useCallback)(async (taskId) => {
     await apiFetch2(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
     await Promise.all([fetchTasks(), fetchStats()]);
   }, [apiFetch2, fetchTasks, fetchStats]);
@@ -488,23 +562,23 @@ function usePluginTasks(agentId) {
 }
 
 // src/hooks/use-plugin-data-rooms.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 function usePluginDataRooms() {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [rooms, setRooms] = (0, import_react4.useState)([]);
-  const [loading, setLoading] = (0, import_react4.useState)(true);
-  const fetchRooms = (0, import_react4.useCallback)(async () => {
+  const [rooms, setRooms] = (0, import_react5.useState)([]);
+  const [loading, setLoading] = (0, import_react5.useState)(true);
+  const fetchRooms = (0, import_react5.useCallback)(async () => {
     try {
       const res = await apiFetch2("/api/v1/data-rooms");
       setRooms(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     setLoading(true);
     fetchRooms().finally(() => setLoading(false));
   }, [fetchRooms]);
-  const fetchFolder = (0, import_react4.useCallback)(async (roomId, folderId) => {
+  const fetchFolder = (0, import_react5.useCallback)(async (roomId, folderId) => {
     const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
     const res = await apiFetch2(path);
     return res.json();
@@ -513,19 +587,19 @@ function usePluginDataRooms() {
 }
 
 // src/hooks/use-plugin-chat.ts
-var import_react5 = require("react");
+var import_react6 = require("react");
 function usePluginChat(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [threads, setThreads] = (0, import_react5.useState)([]);
-  const [messages, setMessages] = (0, import_react5.useState)([]);
-  const [streaming, setStreaming] = (0, import_react5.useState)(false);
-  const [activeThreadId, setActiveThreadId] = (0, import_react5.useState)(null);
-  const abortRef = (0, import_react5.useRef)(null);
-  const fetchThreads = (0, import_react5.useCallback)(async () => {
+  const [threads, setThreads] = (0, import_react6.useState)([]);
+  const [messages, setMessages] = (0, import_react6.useState)([]);
+  const [streaming, setStreaming] = (0, import_react6.useState)(false);
+  const [activeThreadId, setActiveThreadId] = (0, import_react6.useState)(null);
+  const abortRef = (0, import_react6.useRef)(null);
+  const fetchThreads = (0, import_react6.useCallback)(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`);
     setThreads(await res.json());
   }, [apiFetch2, agentId]);
-  const createThread = (0, import_react5.useCallback)(async () => {
+  const createThread = (0, import_react6.useCallback)(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
     const thread = await res.json();
     setActiveThreadId(thread.id);
@@ -533,13 +607,13 @@ function usePluginChat(agentId) {
     await fetchThreads();
     return thread;
   }, [apiFetch2, agentId, fetchThreads]);
-  const fetchMessages = (0, import_react5.useCallback)(async (threadId) => {
+  const fetchMessages = (0, import_react6.useCallback)(async (threadId) => {
     const res = await apiFetch2(`/api/v1/chat/threads/${threadId}/messages`);
     const msgs = await res.json();
     setMessages(msgs);
     setActiveThreadId(threadId);
   }, [apiFetch2]);
-  const sendMessage = (0, import_react5.useCallback)(async (threadId, content) => {
+  const sendMessage = (0, import_react6.useCallback)(async (threadId, content) => {
     setStreaming(true);
     abortRef.current = new AbortController();
     const userMsg = {
@@ -607,7 +681,7 @@ function usePluginChat(agentId) {
       abortRef.current = null;
     }
   }, []);
-  const stopStreaming = (0, import_react5.useCallback)(() => {
+  const stopStreaming = (0, import_react6.useCallback)(() => {
     abortRef.current?.abort();
   }, []);
   return {
@@ -645,12 +719,15 @@ function usePluginChat(agentId) {
   hasPermission,
   isPaletteApiError,
   isSandboxRuntime,
+  normalizePaletteLanguage,
   setBaseUrl,
+  translate,
   updateInstallConfig,
   uploadToSignedUrl,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
   usePluginTasks,
+  usePluginTranslations,
   withPluginProvider
 });

package/dist/index.mjs

@@ -86,7 +86,10 @@ function createSandboxBridge(platform) {
   return {
     apiFetch: platform.apiFetch,
     navigate: platform.navigate,
-    showToast: platform.showToast
+    showToast: platform.showToast,
+    getLanguage: () => platform.language ?? "en",
+    setLanguage: platform.setLanguage ?? (() => {
+    })
   };
 }
 function isSandboxRuntime() {
@@ -160,6 +163,11 @@ function createMockPlatformContext(overrides = {}) {
     orgs: [],
     agents: [],
     permissions: [],
+    language: "en",
+    fallbackLanguage: "en",
+    supportedLanguages: ["en", "ko"],
+    setLanguage: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -381,14 +389,77 @@ function createPaletteClient(ctx) {
   };
 }
 
+// src/i18n.ts
+import { useCallback } from "react";
+function normalizePaletteLanguage(language, fallback = "en") {
+  const trimmed = language?.trim().toLowerCase();
+  if (!trimmed) return fallback;
+  return trimmed.split("-")[0] || fallback;
+}
+function languageCandidates(language, fallbackLanguage = "en") {
+  const candidates = [
+    language,
+    normalizePaletteLanguage(language, fallbackLanguage),
+    fallbackLanguage,
+    normalizePaletteLanguage(fallbackLanguage, "en"),
+    "en"
+  ].filter(Boolean);
+  return Array.from(new Set(candidates));
+}
+function getValue(dictionary, key) {
+  if (!dictionary) return void 0;
+  let current = dictionary;
+  for (const part of key.split(".")) {
+    if (current === null || typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[part];
+  }
+  if (typeof current === "string" || typeof current === "number" || typeof current === "boolean" || current === null) {
+    return current;
+  }
+  return void 0;
+}
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(/\{\{?\s*([a-zA-Z0-9_.-]+)\s*\}?\}/g, (match, key) => {
+    const value = values[key];
+    return value === void 0 || value === null ? match : String(value);
+  });
+}
+function translate(resources, key, options = {}) {
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage, "en");
+  for (const language of languageCandidates(options.language, fallbackLanguage)) {
+    const value = getValue(resources[language], key);
+    if (value !== void 0) {
+      return interpolate(String(value ?? ""), options.values);
+    }
+  }
+  return interpolate(options.defaultValue ?? key, options.values);
+}
+function usePluginTranslations(resources, options = {}) {
+  const platform = usePlatform();
+  const language = normalizePaletteLanguage(platform.language, options.fallbackLanguage ?? platform.fallbackLanguage);
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage ?? platform.fallbackLanguage, "en");
+  const t = useCallback(
+    (key, values, defaultValue) => translate(resources, key, { language, fallbackLanguage, values, defaultValue }),
+    [fallbackLanguage, language, resources]
+  );
+  return {
+    language,
+    fallbackLanguage,
+    supportedLanguages: platform.supportedLanguages,
+    setLanguage: platform.setLanguage,
+    t
+  };
+}
+
 // src/hooks/use-plugin-tasks.ts
-import { useCallback, useEffect, useState } from "react";
+import { useCallback as useCallback2, useEffect, useState } from "react";
 function usePluginTasks(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [tasks, setTasks] = useState([]);
   const [stats, setStats] = useState(null);
   const [loading, setLoading] = useState(true);
-  const fetchTasks = useCallback(async () => {
+  const fetchTasks = useCallback2(async () => {
     try {
       const params = new URLSearchParams();
       if (agentId) params.set("agent_id", String(agentId));
@@ -397,7 +468,7 @@ function usePluginTasks(agentId) {
     } catch {
     }
   }, [apiFetch2, agentId]);
-  const fetchStats = useCallback(async () => {
+  const fetchStats = useCallback2(async () => {
     try {
       const res = await apiFetch2("/api/v1/tasks/stats");
       setStats(await res.json());
@@ -408,7 +479,7 @@ function usePluginTasks(agentId) {
     setLoading(true);
     Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
   }, [fetchTasks, fetchStats]);
-  const createTask = useCallback(async (payload) => {
+  const createTask = useCallback2(async (payload) => {
     const res = await apiFetch2("/api/v1/tasks", {
       method: "POST",
       body: JSON.stringify(payload)
@@ -417,7 +488,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const updateTask = useCallback(async (taskId, payload) => {
+  const updateTask = useCallback2(async (taskId, payload) => {
     const res = await apiFetch2(`/api/v1/tasks/${taskId}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
@@ -426,7 +497,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const deleteTask = useCallback(async (taskId) => {
+  const deleteTask = useCallback2(async (taskId) => {
     await apiFetch2(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
     await Promise.all([fetchTasks(), fetchStats()]);
   }, [apiFetch2, fetchTasks, fetchStats]);
@@ -434,12 +505,12 @@ function usePluginTasks(agentId) {
 }
 
 // src/hooks/use-plugin-data-rooms.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect2, useState as useState2 } from "react";
 function usePluginDataRooms() {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [rooms, setRooms] = useState2([]);
   const [loading, setLoading] = useState2(true);
-  const fetchRooms = useCallback2(async () => {
+  const fetchRooms = useCallback3(async () => {
     try {
       const res = await apiFetch2("/api/v1/data-rooms");
       setRooms(await res.json());
@@ -450,7 +521,7 @@ function usePluginDataRooms() {
     setLoading(true);
     fetchRooms().finally(() => setLoading(false));
   }, [fetchRooms]);
-  const fetchFolder = useCallback2(async (roomId, folderId) => {
+  const fetchFolder = useCallback3(async (roomId, folderId) => {
     const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
     const res = await apiFetch2(path);
     return res.json();
@@ -459,7 +530,7 @@ function usePluginDataRooms() {
 }
 
 // src/hooks/use-plugin-chat.ts
-import { useCallback as useCallback3, useRef, useState as useState3 } from "react";
+import { useCallback as useCallback4, useRef, useState as useState3 } from "react";
 function usePluginChat(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [threads, setThreads] = useState3([]);
@@ -467,11 +538,11 @@ function usePluginChat(agentId) {
   const [streaming, setStreaming] = useState3(false);
   const [activeThreadId, setActiveThreadId] = useState3(null);
   const abortRef = useRef(null);
-  const fetchThreads = useCallback3(async () => {
+  const fetchThreads = useCallback4(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`);
     setThreads(await res.json());
   }, [apiFetch2, agentId]);
-  const createThread = useCallback3(async () => {
+  const createThread = useCallback4(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
     const thread = await res.json();
     setActiveThreadId(thread.id);
@@ -479,13 +550,13 @@ function usePluginChat(agentId) {
     await fetchThreads();
     return thread;
   }, [apiFetch2, agentId, fetchThreads]);
-  const fetchMessages = useCallback3(async (threadId) => {
+  const fetchMessages = useCallback4(async (threadId) => {
     const res = await apiFetch2(`/api/v1/chat/threads/${threadId}/messages`);
     const msgs = await res.json();
     setMessages(msgs);
     setActiveThreadId(threadId);
   }, [apiFetch2]);
-  const sendMessage = useCallback3(async (threadId, content) => {
+  const sendMessage = useCallback4(async (threadId, content) => {
     setStreaming(true);
     abortRef.current = new AbortController();
     const userMsg = {
@@ -553,7 +624,7 @@ function usePluginChat(agentId) {
       abortRef.current = null;
     }
   }, []);
-  const stopStreaming = useCallback3(() => {
+  const stopStreaming = useCallback4(() => {
     abortRef.current?.abort();
   }, []);
   return {
@@ -590,12 +661,15 @@ export {
   hasPermission,
   isPaletteApiError,
   isSandboxRuntime,
+  normalizePaletteLanguage,
   setBaseUrl,
+  translate,
   updateInstallConfig,
   uploadToSignedUrl,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
   usePluginTasks,
+  usePluginTranslations,
   withPluginProvider
 };

package/dist/{plugin-o-qmdCBl.d.mts → plugin-DZRaxKt3.d.mts}

@@ -67,6 +67,8 @@ interface AgentConfig {
     notes: string | null;
 }
 
+/** BCP-47 language tag used by Palette OS and plugin translation helpers */
+type PaletteLanguage = string;
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -149,6 +151,14 @@ interface PlatformContext {
     orgs: OrgSummary[];
     /** Available agents */
     agents: Agent[];
+    /** Current Palette OS language, normalized for plugin translation lookup */
+    language: PaletteLanguage;
+    /** Fallback language used when a plugin does not provide a key for language */
+    fallbackLanguage: PaletteLanguage;
+    /** Languages available in the current Palette OS environment */
+    supportedLanguages: PaletteLanguage[];
+    /** Update the Palette OS language preference */
+    setLanguage: (language: PaletteLanguage) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -163,4 +173,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, PluginAgentDefinition as d, PluginComponentProps as e, PluginManifest as f, PluginToolDefinition as g };
+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 };

package/dist/{plugin-o-qmdCBl.d.ts → plugin-DZRaxKt3.d.ts}

@@ -67,6 +67,8 @@ interface AgentConfig {
     notes: string | null;
 }
 
+/** BCP-47 language tag used by Palette OS and plugin translation helpers */
+type PaletteLanguage = string;
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -149,6 +151,14 @@ interface PlatformContext {
     orgs: OrgSummary[];
     /** Available agents */
     agents: Agent[];
+    /** Current Palette OS language, normalized for plugin translation lookup */
+    language: PaletteLanguage;
+    /** Fallback language used when a plugin does not provide a key for language */
+    fallbackLanguage: PaletteLanguage;
+    /** Languages available in the current Palette OS environment */
+    supportedLanguages: PaletteLanguage[];
+    /** Update the Palette OS language preference */
+    setLanguage: (language: PaletteLanguage) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -163,4 +173,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, PluginAgentDefinition as d, PluginComponentProps as e, PluginManifest as f, PluginToolDefinition as g };
+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 };

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, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from '../plugin-o-qmdCBl.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 PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-DZRaxKt3.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, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from '../plugin-o-qmdCBl.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 PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-DZRaxKt3.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.10",
+  "version": "0.1.11",
   "description": "Palette Platform SDK for building plugins and apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",