@camerontaylor/paseo-plugin 0.12.0-fork.1 → 0.13.0-fork.2

package/dist/client/runtime-context-bridge.js

@@ -1,10 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { PluginTranslationProvider, usePluginTranslationRuntime } from "./translations.js";
 import { useCallback } from "react";
 import { PluginClientStateProvider, usePluginClientStateSource } from "./client-state.js";
 import { PaseoApiProvider, usePaseoContextValue } from "./paseo-context.js";
 import { PluginRpcProvider, usePluginRpcContextValue } from "./rpc-context.js";
 /** Rebuilds plugin runtime contexts inside React Native portal hosts. */
 export function usePluginRuntimeContextBridge() {
+    const translations = usePluginTranslationRuntime();
     const paseo = usePaseoContextValue();
     const rpc = usePluginRpcContextValue();
     const state = usePluginClientStateSource();
@@ -13,7 +15,7 @@ export function usePluginRuntimeContextBridge() {
     }
     return useCallback((children) => {
         const content = state ? (_jsx(PluginClientStateProvider, { source: state, children: children })) : (children);
-        return (_jsx(PaseoApiProvider, { paseo: paseo, children: _jsx(PluginRpcProvider, { invoke: rpc.invoke, children: content }) }));
-    }, [paseo, rpc, state]);
+        return (_jsx(PaseoApiProvider, { paseo: paseo, children: _jsx(PluginRpcProvider, { invoke: rpc.invoke, children: _jsx(PluginTranslationProvider, { runtime: translations, children: content }) }) }));
+    }, [paseo, rpc, state, translations]);
 }
 //# sourceMappingURL=runtime-context-bridge.js.map

package/dist/client/tab.d.ts

@@ -0,0 +1,6 @@
+import type { JsonValue } from "@camerontaylor/paseo-protocol/agent-types";
+import type { ZodType } from "zod";
+import type { PluginTab } from "./contracts.js";
+/** Validates the panel's persisted state, using the default for missing or invalid values. */
+export declare function useTabState<T extends JsonValue>(tab: PluginTab, schema: ZodType<T>, defaultState: T): [T, (next: T) => void];
+//# sourceMappingURL=tab.d.ts.map

package/dist/client/tab.js

@@ -0,0 +1,9 @@
+import { useCallback, useMemo } from "react";
+/** Validates the panel's persisted state, using the default for missing or invalid values. */
+export function useTabState(tab, schema, defaultState) {
+    const parsed = useMemo(() => schema.safeParse(tab.state), [schema, tab.state]);
+    const writeState = tab.setState;
+    const setState = useCallback((next) => writeState(next), [writeState]);
+    return [parsed.success ? parsed.data : defaultState, setState];
+}
+//# sourceMappingURL=tab.js.map

package/dist/client/translations.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from "react";
+import type { PluginMessage, PluginText, PluginTranslations, TranslationKey, TranslationArguments, TranslationResource } from "../text.js";
+export declare function defineTranslations<const Resource extends TranslationResource>(definition: {
+    resources: Readonly<Record<string, TranslationResource>> & {
+        en: Resource;
+    };
+}): PluginTranslations<Resource>;
+/** App language source. Each installation subscribes for exactly its own lifetime. */
+export interface PluginLocaleSource {
+    getLocale(): string;
+    subscribe(listener: () => void): () => void;
+}
+export interface PluginI18n {
+    readonly locale: string;
+    t<Resource extends TranslationResource, Key extends TranslationKey<Resource>>(messages: PluginTranslations<Resource>, key: Key, ...args: TranslationArguments<Resource, Key>): string;
+}
+export declare class PluginTranslationRuntime implements PluginI18n {
+    private readonly source;
+    private readonly engines;
+    private readonly listeners;
+    private readonly unsubscribe;
+    private stopped;
+    constructor(source: PluginLocaleSource);
+    get locale(): string;
+    getSnapshot: () => string;
+    subscribe: (listener: () => void) => (() => void);
+    t<Resource extends TranslationResource, Key extends TranslationKey<Resource>>(messages: PluginTranslations<Resource>, key: Key, ...args: TranslationArguments<Resource, Key>): string;
+    resolve: (text: PluginText, locale?: string) => string;
+    dispose(): void;
+}
+export declare function isPluginMessage(value: unknown): value is PluginMessage;
+export declare function requirePluginText(text: unknown): PluginText;
+export declare function PluginTranslationProvider({ runtime, children, }: {
+    runtime: PluginTranslationRuntime;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePluginTranslationRuntime(): PluginTranslationRuntime;
+export declare function useTranslation<Resource extends TranslationResource>(messages: PluginTranslations<Resource>): {
+    locale: string;
+    t: <Key extends TranslationKey<Resource>>(key: Key, ...args: TranslationArguments<Resource, Key>) => string;
+};
+//# sourceMappingURL=translations.d.ts.map

package/dist/client/translations.js

@@ -0,0 +1,153 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useSyncExternalStore, } from "react";
+import { createInstance } from "i18next";
+const messageDefinitions = new WeakMap();
+export function defineTranslations(definition) {
+    const english = validateResources(definition.resources);
+    return {
+        resources: definition.resources,
+        message: (key, ...args) => {
+            const source = english.get(key) ?? english.get(`${key}_other`);
+            if (source === undefined)
+                throw new Error(`Unknown translation key: ${key}`);
+            const options = args[0];
+            for (const name of placeholders(source)) {
+                if (options?.[name] === undefined)
+                    throw new Error(`Missing translation value: ${name} (${key})`);
+            }
+            const message = Object.freeze({});
+            messageDefinitions.set(message, { resources: definition.resources, key, options });
+            return message;
+        },
+    };
+}
+export class PluginTranslationRuntime {
+    constructor(source) {
+        this.source = source;
+        this.engines = new Map();
+        this.listeners = new Set();
+        this.stopped = false;
+        this.getSnapshot = () => this.locale;
+        this.subscribe = (listener) => {
+            if (this.stopped)
+                throw new Error("Plugin translations have stopped");
+            this.listeners.add(listener);
+            return () => {
+                this.listeners.delete(listener);
+            };
+        };
+        this.resolve = (text, locale = this.locale) => {
+            if (typeof text === "string")
+                return text;
+            if (this.stopped)
+                throw new Error("Plugin translations have stopped");
+            const message = messageDefinitions.get(text);
+            if (!message)
+                throw new Error("Plugin labels must use messages.message()");
+            let engine = this.engines.get(message.resources);
+            if (!engine) {
+                engine = createInstance();
+                void engine.init({
+                    initAsync: false,
+                    lng: this.locale,
+                    fallbackLng: "en",
+                    resources: Object.fromEntries(Object.entries(message.resources).map(([language, translation]) => [
+                        language,
+                        { translation },
+                    ])),
+                    interpolation: { escapeValue: false },
+                    returnNull: false,
+                    returnObjects: false,
+                });
+                this.engines.set(message.resources, engine);
+            }
+            return engine.t(message.key, { ...message.options, lng: locale });
+        };
+        this.unsubscribe = source.subscribe(() => {
+            for (const listener of this.listeners)
+                listener();
+        });
+    }
+    get locale() {
+        return this.source.getLocale();
+    }
+    t(messages, key, ...args) {
+        return this.resolve(messages.message(key, ...args));
+    }
+    dispose() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.unsubscribe();
+        this.listeners.clear();
+        this.engines.clear();
+    }
+}
+export function isPluginMessage(value) {
+    return (typeof value === "object" && value !== null && messageDefinitions.has(value));
+}
+export function requirePluginText(text) {
+    if (typeof text === "string" && text.trim())
+        return text.trim();
+    if (isPluginMessage(text))
+        return text;
+    throw new Error("Plugin label must be a non-empty string or a translation message");
+}
+function flatten(resource, prefix = "") {
+    if (!resource || typeof resource !== "object" || Array.isArray(resource))
+        throw new Error("Translation resources must be objects of strings");
+    const result = new Map();
+    for (const [key, value] of Object.entries(resource)) {
+        if (!key || key.includes(".") || ["__proto__", "constructor", "prototype"].includes(key))
+            throw new Error(`Invalid translation key: ${key}`);
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "string")
+            result.set(path, value);
+        else
+            for (const entry of flatten(value, path))
+                result.set(...entry);
+    }
+    return result;
+}
+function pluralBase(key) {
+    return key.replace(/_(zero|one|two|few|many|other)$/, "");
+}
+function placeholders(value) {
+    return [
+        ...new Set([...value.matchAll(/{{-?\s*([^},\s]+)(?:[^}]*)}}/g)].map((match) => match[1])),
+    ].sort();
+}
+function validateResources(resources) {
+    const english = flatten(resources.en);
+    if (!english.size)
+        throw new Error("Plugin translations require English messages");
+    for (const [locale, resource] of Object.entries(resources)) {
+        if (Intl.getCanonicalLocales(locale)[0] !== locale)
+            throw new Error(`Translation locale must be canonical: ${locale}`);
+        for (const [key, value] of flatten(resource)) {
+            const source = english.get(key) ?? english.get(`${pluralBase(key)}_other`);
+            if (source === undefined)
+                throw new Error(`Unknown translation key in ${locale}: ${key}`);
+            if (placeholders(value).join(",") !== placeholders(source).join(","))
+                throw new Error(`Translation placeholders differ in ${locale}: ${key}`);
+        }
+    }
+    return english;
+}
+const Context = createContext(null);
+export function PluginTranslationProvider({ runtime, children, }) {
+    return _jsx(Context.Provider, { value: runtime, children: children });
+}
+export function usePluginTranslationRuntime() {
+    const runtime = useContext(Context);
+    if (!runtime)
+        throw new Error("Plugin translations must run inside a contributed plugin surface");
+    return runtime;
+}
+export function useTranslation(messages) {
+    const runtime = usePluginTranslationRuntime();
+    const locale = useSyncExternalStore(runtime.subscribe, runtime.getSnapshot, runtime.getSnapshot);
+    const t = useCallback((key, ...args) => runtime.resolve(messages.message(key, ...args), locale), [runtime, messages, locale]);
+    return { locale, t };
+}
+//# sourceMappingURL=translations.js.map

package/dist/client/ui.d.ts

@@ -1,4 +1,62 @@
-import type { ComponentType, ReactNode, Ref } from "react";
+import type { ComponentType, FunctionComponent, ReactNode, ForwardRefExoticComponent, RefAttributes, ReactElement, Ref } from "react";
+import type { StyleProp, ViewStyle, ScrollView as NativeScrollView, ScrollViewProps, FlatList as NativeFlatList, FlatListProps, TextInput as NativeTextInput, TextInputProps, TextProps } from "react-native";
+import type { PluginIconProps } from "../icons.js";
+import type { PluginIcon } from "./contracts.js";
+export interface ModalProps {
+    title: string;
+    icon?: ReactNode;
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    children: ReactNode;
+}
+export interface ModalContentProps {
+    children: ReactNode;
+    /** Paint the full body below the header. */
+    style?: StyleProp<ViewStyle>;
+    /** Overrides the default 24px padding and 16px gap. Safe-area clearance stays host-owned. */
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    /** Default true. Set false for a bounded body with your own ScrollView or FlatList. */
+    scrollable?: boolean;
+}
+export interface ModalComponent extends FunctionComponent<ModalProps> {
+    Content: ComponentType<ModalContentProps>;
+}
+export type ToastVariant = "default" | "info" | "success" | "warning" | "error";
+export interface ToastOptions {
+    variant?: ToastVariant;
+    durationMs?: number;
+}
+export interface ToastApi {
+    show(message: string, options?: ToastOptions): void;
+    error(message: string): void;
+}
+/** Renders a Lucide icon by `name`, or any plugin icon by `icon`. An unusable icon renders nothing. */
+export type IconProps = Partial<PluginIconProps> & ({
+    name: string;
+    icon?: never;
+} | {
+    icon: PluginIcon;
+    name?: never;
+});
+export declare const Icon: ComponentType<IconProps>;
+export declare const Modal: ModalComponent;
+export declare function useToast(): ToastApi;
+export interface StreamedTextProps extends Omit<TextProps, "children"> {
+    text: string;
+    phase: "streaming" | "complete";
+}
+/** Plain assistant text with host-owned streaming pacing and typography. */
+export declare const StreamedText: ComponentType<StreamedTextProps>;
+export type { PluginIconProps } from "../icons.js";
+/** React Native scrolling with the host's sheet gestures when rendered inside a sheet. */
+export declare const ScrollView: ForwardRefExoticComponent<ScrollViewProps & RefAttributes<NativeScrollView>>;
+export declare function FlatList<Item>(props: FlatListProps<Item> & {
+    ref?: Ref<NativeFlatList<Item>>;
+}): ReactElement;
+/** Copies text to this client's clipboard. Rejects when copying is unavailable or denied. */
+export declare function copyText(text: string): Promise<void>;
+/** Native input focus integrated with modal keyboard positioning. */
+export declare const TextInput: ForwardRefExoticComponent<TextInputProps & RefAttributes<NativeTextInput>>;
 export interface SettingsSectionProps {
     title: string;
     info?: ReactNode;
@@ -46,6 +104,7 @@ export interface SettingsActionProps extends SettingsRowProps {
     onPress(): void;
     disabled?: boolean;
 }
+/** @deprecated Use SettingsSection for plugin settings headings. */
 export declare const SettingsGroup: ComponentType<SettingsSectionProps>;
 export declare const SettingsSection: ComponentType<SettingsSectionProps>;
 export declare const SettingsCard: ComponentType<{
@@ -65,17 +124,14 @@ export interface ExternalLinkProps {
     onError?: (error: unknown) => void;
 }
 export declare const ExternalLink: ComponentType<ExternalLinkProps>;
-export type SidebarIcon = string | ComponentType<{
-    size: number;
-    color: string;
-}>;
+export type SidebarIcon = PluginIcon;
 export interface SidebarRowProps {
     /**
      * Tells rows of one item apart when the item renders several: "bot-2". Unique within the item.
      * Omit it when the item renders one row.
      */
     id?: string;
-    /** A Lucide icon name or a component. */
+    /** A Lucide icon name, inline SVG, or a component. */
     icon?: SidebarIcon;
     /** Defaults to the item's registered title. */
     label?: string;
@@ -88,4 +144,16 @@ export interface SidebarRowProps {
 export declare const SidebarRow: ComponentType<SidebarRowProps>;
 /** A line between groups of rows. Render it from a sidebar item's `Component`. */
 export declare const SidebarSeparator: ComponentType;
+/** Paseo's loading state. Fills the panel; the panel decides when to show it. */
+export declare const Loading: ComponentType;
+/** Render a local document URL in an isolated frame. */
+export declare const DocumentFrame: ComponentType<{
+    url: string;
+    testID?: string;
+}>;
+export interface MarkdownProps {
+    children: string;
+}
+/** Renders Markdown using Paseo’s theme, selection, and link behavior. */
+export declare const Markdown: ComponentType<MarkdownProps>;
 //# sourceMappingURL=ui.d.ts.map

package/dist/contracts.d.ts

@@ -1,4 +1,6 @@
+import type { PluginText } from "./text.js";
 import type { JsonValue } from "@camerontaylor/paseo-protocol/agent-types";
+import type { PluginSerializableIcon } from "./icons.js";
 import type { PluginRpcContract } from "./rpc.js";
 export interface PluginTheme {
     readonly colors: {
@@ -61,18 +63,18 @@ export interface PluginThemeColors {
     mutedForeground: string;
     ring: string;
 }
-export interface PluginThemeContribution {
+export interface PluginThemeContribution<Text extends PluginText = string> {
     id: string;
-    name: string;
+    name: Text;
     appearance: "light" | "dark";
     colors: PluginThemeColors;
 }
-export interface PluginAttachmentSourceContribution {
+export interface PluginAttachmentSourceContribution<Text extends PluginText = string> {
     id: string;
-    title: string;
-    icon: string;
-    pickerTitle: string;
-    searchPlaceholder: string;
+    title: Text;
+    icon: PluginSerializableIcon;
+    pickerTitle: Text;
+    searchPlaceholder: Text;
     search: PluginRpcContract;
 }
 export type PluginTimelineData = JsonValue;

package/dist/icons.d.ts

@@ -0,0 +1,18 @@
+/** What a component icon receives from the surface that draws it. */
+export interface PluginIconProps {
+    size: number;
+    color: string;
+}
+/** Inline SVG markup. Paseo validates it when the contribution registers. */
+export interface PluginSvgIcon {
+    svg: string;
+}
+/** An icon that can be stored or sent: a Lucide icon name, or inline SVG. */
+export type PluginSerializableIcon = string | PluginSvgIcon;
+export declare const PLUGIN_SVG_ICON_MAX_BYTES: number;
+/**
+ * Why Paseo refuses to render this SVG, or null when it is a self-contained document.
+ * The daemon applies it to provider and usage-source icon files; the app to inline plugin icons.
+ */
+export declare function findSvgIconProblem(svg: string): string | null;
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.js

@@ -0,0 +1,30 @@
+export const PLUGIN_SVG_ICON_MAX_BYTES = 64 * 1024;
+const EXTERNAL_HREF = /\s(?:href|xlink:href)\s*=\s*(?:(["'])(.*?)\1|([^\s>]+))/gi;
+/**
+ * Why Paseo refuses to render this SVG, or null when it is a self-contained document.
+ * The daemon applies it to provider and usage-source icon files; the app to inline plugin icons.
+ */
+export function findSvgIconProblem(svg) {
+    if (new TextEncoder().encode(svg).byteLength > PLUGIN_SVG_ICON_MAX_BYTES) {
+        return "exceeds 64 KiB";
+    }
+    if (!/^\s*<svg(?:\s|>)/i.test(svg))
+        return "not an SVG document";
+    if (/<script(?:\s|>)/i.test(svg))
+        return "script elements are not allowed";
+    if (/<foreignObject(?:\s|>)/i.test(svg))
+        return "foreignObject elements are not allowed";
+    if (/<style(?:\s|>)/i.test(svg))
+        return "style elements are not allowed";
+    if (/\son[a-z0-9_-]*\s*=/i.test(svg))
+        return "event-handler attributes are not allowed";
+    if (/javascript\s*:/i.test(svg))
+        return "javascript URLs are not allowed";
+    for (const match of svg.matchAll(EXTERNAL_HREF)) {
+        const href = match[2] ?? match[3] ?? "";
+        if (!href.startsWith("#"))
+            return "external href references are not allowed";
+    }
+    return null;
+}
+//# sourceMappingURL=icons.js.map

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export type { PluginTheme, PluginWorkspaceSnapshot, PluginAgentSnapshot, PluginT
 export { defineSettings, settingsRpc, type SettingsDefinition } from "./settings.js";
 export { defineAttachmentSource, PluginAttachmentItemSchema, PluginAttachmentSearchPayloadSchema, type PluginAttachmentItem, type PluginAttachmentSearchPayload, } from "./attachments.js";
 export { defineRpc, type PluginRpcContract, type RpcInput, type RpcOutput } from "./rpc.js";
+export type { PluginText, PluginMessage } from "./text.js";
+export { findSvgIconProblem, PLUGIN_SVG_ICON_MAX_BYTES, type PluginIconProps, type PluginSerializableIcon, type PluginSvgIcon, } from "./icons.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,4 +3,5 @@ export { PLUGIN_SDK_PACKAGE_NAMES, pluginSdkEntry } from "./sdk-specifiers.js";
 export { defineSettings, settingsRpc } from "./settings.js";
 export { defineAttachmentSource, PluginAttachmentItemSchema, PluginAttachmentSearchPayloadSchema, } from "./attachments.js";
 export { defineRpc } from "./rpc.js";
+export { findSvgIconProblem, PLUGIN_SVG_ICON_MAX_BYTES, } from "./icons.js";
 //# sourceMappingURL=index.js.map

package/dist/server/acp-internal/connection.js

@@ -319,10 +319,16 @@ class AcpRuntime {
         /**
          * Fallback ids for streamed chunks that carry no `messageId`, one per
          * chunk kind. Consecutive chunks of a kind continue the same timeline
-         * item; a chunk of the other kind, a tool call, a plan, a user message,
-         * or a turn boundary ends it (#4699).
+         * item; a chunk of another kind, a tool call, a plan, or a turn boundary
+         * ends it (#4699).
          */
         this.fallbackChunkIds = new Map();
+        /**
+         * Active while a persisted session loads. ACP agents replay the loaded
+         * session's updates before session/load resolves; the value follows the
+         * open request's history contract.
+         */
+        this.replayWindow = null;
         this.closing = false;
         this.processFailed = false;
         this.configTransaction = false;
@@ -377,13 +383,22 @@ class AcpRuntime {
         };
         let response;
         if (nativeSessionId) {
-            response = await this.call(this.connection.loadSession({
-                sessionId: nativeSessionId,
-                cwd: input.config.cwd,
-                mcpServers,
-                _meta: metadata,
-            }));
+            // ACP agents replay the loaded session's updates before session/load resolves,
+            // so the native id must be registered first for them to pass the session filter.
             this.nativeSessionId = nativeSessionId;
+            this.replayWindow = input.history === "replay" ? "replay" : "skip";
+            try {
+                response = await this.call(this.connection.loadSession({
+                    sessionId: nativeSessionId,
+                    cwd: input.config.cwd,
+                    mcpServers,
+                    _meta: metadata,
+                }));
+                await this.drainNotifications();
+            }
+            finally {
+                this.replayWindow = null;
+            }
         }
         else {
             const newSession = await this.call(this.connection.newSession({
@@ -732,6 +747,13 @@ class AcpRuntime {
     sessionUpdate(notification) {
         if (notification.sessionId !== this.nativeSessionId)
             return;
+        if (this.replayWindow === "skip")
+            return;
+        if (this.replayWindow === "replay" &&
+            notification.update.sessionUpdate === "user_message_chunk") {
+            this.reduceUserMessageChunk(notification.update);
+            return;
+        }
         this.reduceUpdate(notification.update);
     }
     reduceUpdate(update) {
@@ -742,11 +764,12 @@ class AcpRuntime {
                 this.fallbackChunkIds.clear();
                 return;
             }
-            // A chunk of one kind ends the other kind's item, whatever its content
-            // or id: reasoning, then text, then reasoning again are three items.
+            // A chunk of one kind ends every other kind's open item, whatever its
+            // content or id: reasoning, then text, then reasoning again are three items.
             this.fallbackChunkIds.delete(update.sessionUpdate === "agent_message_chunk"
                 ? "agent_thought_chunk"
                 : "agent_message_chunk");
+            this.fallbackChunkIds.delete("user_message_chunk");
             if (update.content.type !== "text")
                 return;
             const id = this.resolveChunkId(update.sessionUpdate, update.messageId);
@@ -776,6 +799,27 @@ class AcpRuntime {
             this.fallbackChunkIds.clear();
         this.reduceStateUpdate(update);
     }
+    // Historical user messages arrive only as replayed chunks; a live prompt
+    // already echoes its own user message when it is admitted.
+    reduceUserMessageChunk(update) {
+        this.fallbackChunkIds.delete("agent_message_chunk");
+        this.fallbackChunkIds.delete("agent_thought_chunk");
+        if (update.content.type !== "text")
+            return;
+        const id = this.resolveChunkId("user_message_chunk", update.messageId);
+        const text = `${this.messages.get(id) ?? ""}${update.content.text}`;
+        this.messages.set(id, text);
+        this.emit({
+            type: "timeline.item",
+            sessionId: this.options.boundarySessionId,
+            item: {
+                type: "user_message",
+                id,
+                text,
+                ...(update.messageId ? { messageId: update.messageId } : {}),
+            },
+        });
+    }
     resolveChunkId(kind, messageId) {
         if (messageId) {
             this.fallbackChunkIds.delete(kind);

package/dist/server/lifecycle.d.ts

@@ -50,6 +50,10 @@ export interface PluginLifecycleEvents {
         agent: PluginHookAgent;
         turnId: string | null;
         outcome: PluginTurnOutcome;
+        /**
+         * @deprecated Always empty. Fetch history on demand with
+         * context.paseo.agents.ref(agent.id).timeline.refetch({ direction: "tail", limit: 20 }).
+         */
         timeline: readonly AgentTimelineItem[];
     };
     "agent.permission_requested": {

package/dist/text.d.ts

@@ -0,0 +1,34 @@
+/** A persistent label resolved in the presenting app's language. */
+declare const pluginMessage: unique symbol;
+export interface PluginMessage {
+    readonly [pluginMessage]: true;
+}
+export type PluginText = string | PluginMessage;
+export interface TranslationResource {
+    readonly [key: string]: string | TranslationResource;
+}
+export interface TranslationOptions {
+    readonly count?: number;
+    readonly [name: string]: unknown;
+}
+export type TranslationKey<Resource> = {
+    [Key in keyof Resource & string]: Resource[Key] extends string ? Key | (Key extends `${infer Base}_${"zero" | "one" | "two" | "few" | "many" | "other"}` ? Base : never) : Resource[Key] extends TranslationResource ? `${Key}.${TranslationKey<Resource[Key]>}` : never;
+}[keyof Resource & string];
+export interface PluginTranslations<Resource extends TranslationResource = TranslationResource> {
+    readonly resources: Readonly<Record<string, TranslationResource>> & {
+        readonly en: Resource;
+    };
+    message<Key extends TranslationKey<Resource>>(key: Key, ...args: TranslationArguments<Resource, Key>): PluginMessage;
+}
+type Lookup<Resource, Key extends string> = Key extends `${infer Head}.${infer Tail}` ? Head extends keyof Resource ? Lookup<Resource[Head], Tail> : never : Key extends keyof Resource ? Resource[Key] : never;
+type Trim<Value extends string> = Value extends ` ${infer Rest}` | `${infer Rest} ` ? Trim<Rest> : Value;
+type InterpolationName<Value extends string> = Trim<Value> extends `-${infer Rest}` ? InterpolationName<Rest> : Trim<Value> extends `${infer Name},${string}` ? Trim<Name> : Trim<Value>;
+type InterpolationNames<Value> = Value extends string ? string extends Value ? never : Value extends `${string}{{${infer Name}}}${infer Rest}` ? InterpolationName<Name> | InterpolationNames<Rest> : never : never;
+type MessageOptions<Resource, Key extends string> = TranslationOptions & ([Lookup<Resource, `${Key}_other`>] extends [never] ? {} : {
+    count: number;
+}) & {
+    [Name in InterpolationNames<Lookup<Resource, Key> | Lookup<Resource, `${Key}_other`>>]: string | number | boolean | Date;
+};
+export type TranslationArguments<Resource, Key extends string> = {} extends MessageOptions<Resource, Key> ? [options?: MessageOptions<Resource, Key>] : [options: MessageOptions<Resource, Key>];
+export {};
+//# sourceMappingURL=text.d.ts.map

package/dist/text.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=text.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camerontaylor/paseo-plugin",
-  "version": "0.12.0-fork.1",
+  "version": "0.13.0-fork.2",
   "description": "Paseo plugin SDK package",
   "files": [
     "dist",
@@ -62,28 +62,30 @@
     "build": "tsc -p tsconfig.json --incremental false",
     "build:clean": "npm run clean && npm run build",
     "prepack": "npm run build:clean",
-    "typecheck": "tsgo --noEmit && tsgo -p tsconfig.examples.json --noEmit",
-    "test": "vitest run"
+    "typecheck": "tsgo --noEmit && npm run typecheck:examples",
+    "test": "vitest run",
+    "typecheck:examples": "npm --prefix ../../plugin-examples/markdown-panel install --ignore-scripts --no-audit --no-fund && tsgo -p tsconfig.examples.json --noEmit"
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.4.0",
+    "i18next": "^26.3.0",
     "use-sync-external-store": "^1.6.0"
   },
   "devDependencies": {
-    "@camerontaylor/paseo-client": "0.12.0-fork.1",
-    "@camerontaylor/paseo-protocol": "0.12.0-fork.1",
+    "@camerontaylor/paseo-client": "0.13.0-fork.2",
+    "@camerontaylor/paseo-protocol": "0.13.0-fork.2",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
-    "react": "19.1.0",
-    "react-native": "0.81.5",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.6",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@camerontaylor/paseo-client": "0.12.0-fork.1",
-    "@camerontaylor/paseo-protocol": "0.12.0-fork.1",
-    "react": "~19.1.0",
+    "@camerontaylor/paseo-client": "0.13.0-fork.2",
+    "@camerontaylor/paseo-protocol": "0.13.0-fork.2",
+    "react": ">=19.1.0 <20",
     "react-native": ">=0.81.5",
     "zod": "^4.4.3"
   },