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

package/dist/attachments.d.ts

@@ -1,6 +1,7 @@
+import type { PluginText } from "./text.js";
 import { z } from "zod";
 import type { PluginAttachmentSourceContribution } from "./contracts.js";
-export declare function defineAttachmentSource<Definition extends PluginAttachmentSourceContribution>(definition: Definition): Definition;
+export declare function defineAttachmentSource<Definition extends PluginAttachmentSourceContribution<PluginText>>(definition: Definition): Definition;
 export declare const PluginAttachmentItemSchema: z.ZodObject<{
     id: z.ZodString;
     identifier: z.ZodString;

package/dist/client/buttons.d.ts

@@ -1,5 +1,7 @@
+import type { PluginText } from "../text.js";
 import type { ComponentType } from "react";
-import type { PluginHostProps } from "./contracts.js";
+import type { PluginIconProps } from "../icons.js";
+import type { PluginHostProps, PluginIcon } from "./contracts.js";
 export type PluginButtonContext = {
     context: "workspace";
     workspaceId: string;
@@ -8,57 +10,54 @@ export type PluginButtonContext = {
     workspaceId: string;
     agentId: string;
 };
-export type PluginButtonIconProps = PluginHostProps & PluginButtonContext & {
-    size: number;
-    color: string;
-};
+export type PluginButtonIconProps = PluginHostProps & PluginButtonContext & PluginIconProps;
 export type PluginButtonContentProps = PluginHostProps & PluginButtonContext & {
     close(): void;
 };
-export type PluginButtonIcon = string | ComponentType<PluginButtonIconProps>;
-export type PluginButtonBehavior = {
+export type PluginButtonIcon = PluginIcon<PluginButtonIconProps>;
+export type PluginButtonBehavior<Text extends PluginText = string> = {
     kind: "action";
     onPress(): void | Promise<void>;
 } | {
     kind: "menu";
-    items: readonly PluginButtonMenuEntry[];
+    items: readonly PluginButtonMenuEntry<Text>[];
 } | {
     kind: "popover";
     Content: ComponentType<PluginButtonContentProps>;
 };
-export type PluginButtonMenuEntry = {
+export type PluginButtonMenuEntry<Text extends PluginText = string> = {
     kind: "separator";
     id: string;
 } | {
     kind: "item";
     id: string;
-    title: string;
+    title: Text;
     icon?: PluginButtonIcon;
     visible?: boolean;
     disabled?: boolean;
-    behavior: PluginButtonBehavior;
+    behavior: PluginButtonBehavior<Text>;
 };
-export interface PluginButton {
-    title: string;
+export interface PluginButton<Text extends PluginText = string> {
+    title: Text;
     icon: PluginButtonIcon;
     /** Omit for an icon-only header button. Composer pills use title when omitted. */
-    label?: string;
+    label?: Text;
     visible?: boolean;
     disabled?: boolean;
-    behavior: PluginButtonBehavior;
+    behavior: PluginButtonBehavior<Text>;
 }
-export interface PluginButtonRegistration {
+export interface PluginButtonRegistration<Text extends PluginText = string> {
     /** Updates presentation in place. Supply a complete behavior to replace it. */
-    update(patch: Partial<PluginButton>): void;
+    update(patch: Partial<PluginButton<Text>>): void;
     /** Idempotent. Updates after removal do nothing. */
     remove(): void;
 }
-export interface PluginHeaderButtonContribution {
+export interface PluginHeaderButtonContribution<Text extends PluginText = string> {
     id: string;
     workspaceId: string;
-    button: PluginButton;
+    button: PluginButton<Text>;
 }
-export interface PluginComposerPillContribution extends PluginHeaderButtonContribution {
+export interface PluginComposerPillContribution<Text extends PluginText = string> extends PluginHeaderButtonContribution<Text> {
     agentId: string;
 }
 //# sourceMappingURL=buttons.d.ts.map

package/dist/client/contracts.d.ts

@@ -1,10 +1,13 @@
+import type { PluginText } from "../text.js";
 import type { ComponentType } from "react";
 import type { PaseoApi } from "@camerontaylor/paseo-client";
-import type { AgentTimelineItem } from "@camerontaylor/paseo-protocol/agent-types";
+import type { AgentTimelineItem, JsonValue } from "@camerontaylor/paseo-protocol/agent-types";
 import type { ZodType, input as ZodInput, output as ZodOutput } from "zod";
+import type { PluginFile } from "./file.js";
 import type { PluginRpcContract } from "../rpc.js";
 import type { PluginButtonRegistration, PluginHeaderButtonContribution, PluginComposerPillContribution } from "./buttons.js";
 import type { PluginTheme, PluginWorkspaceSnapshot, PluginAgentSnapshot, PluginThemeContribution, PluginAttachmentSourceContribution, PluginTimelineTransformResult, PluginCleanup } from "../contracts.js";
+import type { PluginIconProps, PluginSerializableIcon } from "../icons.js";
 export interface PluginHostProps {
     theme: PluginTheme;
     host: {
@@ -62,36 +65,74 @@ export interface PluginSidebarItemProps extends PluginHostProps {
     /** Anchored to the item on wide layouts; a bottom sheet on compact layouts. */
     openPopover(Content: ComponentType<PluginPopoverProps>): void;
 }
-export interface PluginSidebarItemContribution {
+export interface PluginSidebarItemContribution<Text extends PluginText = string> {
     id: string;
     /** Settings row label, accessibility label, and default label for SidebarRow. */
-    title: string;
+    title: Text;
     Component: ComponentType<PluginSidebarItemProps>;
 }
-export interface PluginIconProps {
-    name: string;
-    size?: number;
-    color?: string;
-}
+/**
+ * A Lucide icon name, inline SVG markup, or a component. Components receive the surface's size
+ * and color; buttons widen the props with their host and target context.
+ */
+export type PluginIcon<Props extends PluginIconProps = PluginIconProps> = PluginSerializableIcon | ComponentType<Props>;
 export type PluginPanelLocation = "workspace" | "explorer";
 export interface PluginOpenPanelOptions {
     location?: PluginPanelLocation;
 }
-interface PluginWorkspacePanelBase {
+interface PluginWorkspacePanelBase<Text extends PluginText = string> {
     id: string;
-    title: string;
-    icon: string;
+    title: Text;
+    icon: PluginIcon;
     locations?: readonly PluginPanelLocation[];
 }
-export interface PluginWorkspacePanelProps extends PluginNavigableHostProps {
-    context: "workspace";
+export interface PluginTab {
+    /** Shows the tab's unsaved dot and asks before closing. */
+    setModified(modified: boolean): void;
+    /** Opaque persisted JSON. Undefined until written; the panel validates it. */
+    readonly state: unknown;
+    setState(state: JsonValue): void;
+}
+export interface PluginPanelProps<Params> extends PluginNavigableHostProps {
     workspaceId: string;
+    readonly params: Readonly<Params>;
+    revision: number;
+    tab: PluginTab;
+}
+export interface PluginWorkspacePanelParams {
+}
+export interface PluginAgentPanelParams {
+    readonly agentId: string;
+}
+export interface PluginFilePanelParams {
+    readonly path: string;
+    readonly lineStart?: number;
+    readonly lineEnd?: number;
+}
+export interface PluginWorkspacePanelProps extends PluginPanelProps<PluginWorkspacePanelParams> {
+    /** @deprecated Use the panel registration to select the context. */
+    context: "workspace";
 }
-export interface PluginAgentPanelProps extends PluginNavigableHostProps {
+export interface PluginAgentPanelProps extends PluginPanelProps<PluginAgentPanelParams> {
+    /** @deprecated Use the panel registration to select the context. */
     context: "agent";
-    workspaceId: string;
+    /** @deprecated Read `params.agentId`. */
     agentId: string;
 }
+export interface PluginFilePanelProps extends PluginPanelProps<PluginFilePanelParams> {
+    file: PluginFile;
+}
+export interface PluginFilePanelContribution<Text extends PluginText = string> {
+    id: string;
+    title: Text;
+    icon: PluginIcon;
+    /** Extensions without the dot, case-insensitive, and exact filenames. */
+    files: {
+        extensions: readonly string[];
+        filenames?: readonly string[];
+    };
+    Component: ComponentType<PluginFilePanelProps>;
+}
 export interface PluginClientOpenPanelOptions extends PluginOpenPanelOptions {
     workspaceId: string;
     agentId?: string;
@@ -100,48 +141,56 @@ interface PluginClientContextAliases {
     /** @deprecated Use `addScreen`. */
     addSurface(id: string, Component: ComponentType<PluginSurfaceProps>): PluginCleanup;
     /** @deprecated Use `addSidebarHeaderItem`. */
-    addSidebarItem(contribution: PluginSidebarContribution): PluginCleanup;
+    addSidebarItem(contribution: PluginSidebarContribution<PluginText>): PluginCleanup;
 }
 export interface PluginClientContext extends PluginCommandCapabilities, PluginClientContextAliases {
+    readonly i18n: import("./translations.js").PluginI18n;
     /** Play a base64-encoded audio file on this client; resolves when playback ends. */
     playAudio(source: {
         base64: string;
         mimeType: string;
     }): Promise<void>;
-    addSettingsScreen(contribution: PluginSettingsScreenContribution): PluginCleanup;
-    addScreen(contribution: PluginScreenContribution): PluginCleanup;
-    addSidebarHeaderItem(contribution: PluginSidebarItemContribution): PluginCleanup;
-    addSidebarFooterItem(contribution: PluginSidebarItemContribution): PluginCleanup;
-    addWorkspacePanel(contribution: PluginWorkspacePanelContribution): PluginCleanup;
-    addCommandCenterItem(contribution: PluginCommandCenterItemContribution): PluginCleanup;
-    addSlashCommand(contribution: PluginClientSlashCommandContribution): PluginCleanup;
-    addHeaderButton(contribution: PluginHeaderButtonContribution): PluginButtonRegistration;
-    addComposerPill(contribution: PluginComposerPillContribution): PluginButtonRegistration;
-    addAttachmentSource(contribution: PluginAttachmentSourceContribution): PluginCleanup;
-    addTheme(contribution: PluginThemeContribution): PluginCleanup;
+    addSettingsScreen(contribution: PluginSettingsScreenContribution<PluginText>): PluginCleanup;
+    addScreen(contribution: PluginScreenContribution<PluginText>): PluginCleanup;
+    addSidebarHeaderItem(contribution: PluginSidebarItemContribution<PluginText>): PluginCleanup;
+    addSidebarFooterItem(contribution: PluginSidebarItemContribution<PluginText>): PluginCleanup;
+    addAgentPanel(contribution: PluginAgentPanelContribution<PluginText>): PluginCleanup;
+    addWorkspacePanel(contribution: PluginWorkspacePanelContribution<PluginText>): PluginCleanup;
+    addCommandCenterItem(contribution: PluginCommandCenterItemContribution<PluginText>): PluginCleanup;
+    addSlashCommand(contribution: PluginClientSlashCommandContribution<PluginText>): PluginCleanup;
+    addHeaderButton(contribution: PluginHeaderButtonContribution<PluginText>): PluginButtonRegistration<PluginText>;
+    addComposerPill(contribution: PluginComposerPillContribution<PluginText>): PluginButtonRegistration<PluginText>;
+    addAttachmentSource(contribution: PluginAttachmentSourceContribution<PluginText>): PluginCleanup;
+    addTheme(contribution: PluginThemeContribution<PluginText>): PluginCleanup;
+    addFilePanel(contribution: PluginFilePanelContribution<PluginText>): PluginCleanup;
     addTimelineTransformer<ItemType extends AgentTimelineItem["type"]>(contribution: PluginTimelineTransformerContribution<ItemType>): PluginCleanup;
     addTimelineRenderer<Schema extends ZodType>(contribution: PluginTimelineRendererContribution<Schema>): PluginCleanup;
     openPanel(id: string, options: PluginClientOpenPanelOptions): void;
 }
 export type PluginClientContribution = (client: PluginClientContext) => PluginCleanup;
-export type PluginWorkspacePanelContribution = (PluginWorkspacePanelBase & {
-    context: "workspace";
+export type PluginWorkspacePanelContribution<Text extends PluginText = string> = (PluginWorkspacePanelBase<Text> & {
+    /** @deprecated Omit context. */
+    context?: "workspace";
     Component: ComponentType<PluginWorkspacePanelProps>;
-}) | (PluginWorkspacePanelBase & {
+}) | (PluginWorkspacePanelBase<Text> & {
+    /** @deprecated Register with `addAgentPanel`. */
     context: "agent";
     Component: ComponentType<PluginAgentPanelProps>;
 });
-export interface PluginSettingsScreenContribution {
+export interface PluginAgentPanelContribution<Text extends PluginText = string> extends PluginWorkspacePanelBase<Text> {
+    Component: ComponentType<PluginAgentPanelProps>;
+}
+export interface PluginSettingsScreenContribution<Text extends PluginText = string> {
     id: string;
-    title: string;
-    icon: string;
+    title: Text;
+    icon: PluginIcon;
     Component: ComponentType<PluginSurfaceProps>;
 }
 /** The screen header's title: fixed, or derived from the params the screen was opened with. */
-export type PluginScreenTitle = string | ((params: PluginScreenParams) => string);
-export interface PluginScreenContribution {
+export type PluginScreenTitle<Text extends PluginText = string> = Text | ((params: PluginScreenParams) => Text);
+export interface PluginScreenContribution<Text extends PluginText = string> {
     id: string;
-    title: PluginScreenTitle;
+    title: PluginScreenTitle<Text>;
     Component: ComponentType<PluginScreenProps>;
 }
 export interface PluginSurfaceContribution {
@@ -149,10 +198,10 @@ export interface PluginSurfaceContribution {
     Component: ComponentType<PluginSurfaceProps>;
 }
 /** @deprecated Use `PluginSidebarItemContribution` with `addSidebarHeaderItem`. */
-export interface PluginSidebarContribution {
+export interface PluginSidebarContribution<Text extends PluginText = string> {
     id: string;
-    title: string;
-    icon: string;
+    title: Text;
+    icon: PluginIcon;
     surface: string;
 }
 export type PluginTimelineTransformerContribution<ItemType extends AgentTimelineItem["type"] = AgentTimelineItem["type"]> = ItemType extends AgentTimelineItem["type"] ? {
@@ -205,33 +254,33 @@ export interface PluginAgentCommandContext extends PluginCommandCapabilities {
     agent: PluginAgentSnapshot;
     openPanel(id: string, options?: PluginOpenPanelOptions): void;
 }
-interface PluginCommandCenterItemBase {
+interface PluginCommandCenterItemBase<Text extends PluginText = string> {
     id: string;
-    title: string;
-    icon: string;
+    title: Text;
+    icon: PluginIcon;
     keywords?: readonly string[];
 }
-export type PluginCommandCenterItemContribution = (PluginCommandCenterItemBase & {
+export type PluginCommandCenterItemContribution<Text extends PluginText = string> = (PluginCommandCenterItemBase<Text> & {
     context: "global";
     onSelect(context: PluginGlobalCommandContext): void | Promise<void>;
-}) | (PluginCommandCenterItemBase & {
+}) | (PluginCommandCenterItemBase<Text> & {
     context: "workspace";
     onSelect(context: PluginWorkspaceCommandContext): void | Promise<void>;
-}) | (PluginCommandCenterItemBase & {
+}) | (PluginCommandCenterItemBase<Text> & {
     context: "agent";
     onSelect(context: PluginAgentCommandContext): void | Promise<void>;
 });
-interface PluginClientSlashCommandBase {
+interface PluginClientSlashCommandBase<Text extends PluginText = string> {
     name: string;
-    description: string;
-    argumentHint: string;
+    description: Text;
+    argumentHint: Text;
 }
-export type PluginClientSlashCommandContribution = (PluginClientSlashCommandBase & {
+export type PluginClientSlashCommandContribution<Text extends PluginText = string> = (PluginClientSlashCommandBase<Text> & {
     context: "workspace";
     onSubmit(context: PluginWorkspaceCommandContext & {
         args: string;
     }): void | Promise<void>;
-}) | (PluginClientSlashCommandBase & {
+}) | (PluginClientSlashCommandBase<Text> & {
     context: "agent";
     onSubmit(context: PluginAgentCommandContext & {
         args: string;

package/dist/client/file.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The file a file panel shows. Stable for the life of the tab's target. The stat fields hold the
+ * latest version Paseo knows; read them while rendering. Changing them does not re-render the
+ * panel: `watch`, or a re-render from the read hooks, is how a panel learns they changed.
+ */
+export interface PluginFile {
+    /** Absolute path on the host. */
+    readonly path: string;
+    readonly name: string;
+    /** Lowercase, without the dot; empty when the name has none. */
+    readonly extension: string;
+    readonly size: number;
+    readonly modifiedAt: string;
+    readonly mimeType: string;
+    /** Reads the file as UTF-8. A byte order mark is dropped here and written back by `writeText`. */
+    readText(): Promise<string>;
+    readBytes(): Promise<Uint8Array>;
+    /**
+     * A local URL of the file's current bytes, for `DocumentFrame` and images. Paseo owns it: it stays
+     * valid until a URL of a newer version resolves or the tab closes.
+     */
+    url(): Promise<string>;
+    /**
+     * Writes the file if it has not changed since this handle last read or wrote it. Otherwise
+     * rejects with `PluginFileConflictError`; `force: true` writes anyway. Rejects with
+     * `PluginFileDeletedError` when the file is gone.
+     */
+    writeText(text: string, options?: PluginFileWriteOptions): Promise<void>;
+    writeBytes(bytes: Uint8Array, options?: PluginFileWriteOptions): Promise<void>;
+    /**
+     * Calls `listener` when the file changes on disk or is deleted. This handle's own writes do not
+     * notify. A deletion is reported once a read confirms it; the panel stays mounted. Returns the
+     * unsubscribe function.
+     */
+    watch(listener: (event: PluginFileEvent) => void): () => void;
+}
+export interface PluginFileWriteOptions {
+    force?: boolean;
+}
+/** What happened to the file on disk. Switch on `type`; later versions may add fields. */
+export type PluginFileEvent = {
+    type: "changed";
+} | {
+    type: "deleted";
+};
+/** The file changed on disk since the handle last read or wrote it. */
+export declare class PluginFileConflictError extends Error {
+    constructor(message?: string);
+}
+/** The file was deleted on disk. */
+export declare class PluginFileDeletedError extends Error {
+    constructor(message?: string);
+}
+export type PluginFileTextState = {
+    status: "loading";
+} | {
+    status: "ready";
+    text: string;
+} | {
+    status: "error";
+    error: Error;
+};
+export type PluginFileBytesState = {
+    status: "loading";
+} | {
+    status: "ready";
+    bytes: Uint8Array;
+} | {
+    status: "error";
+    error: Error;
+};
+export type PluginFileUrlState = {
+    status: "loading";
+} | {
+    status: "ready";
+    url: string;
+} | {
+    status: "error";
+    error: Error;
+};
+/**
+ * The file's text, re-read when it changes on disk. Keeps the current text during a re-read. A
+ * deleted file is an error holding a `PluginFileDeletedError`.
+ */
+export declare function useFileText(file: PluginFile): PluginFileTextState;
+/**
+ * The file's bytes, re-read when it changes on disk. Keeps the current bytes during a re-read. A
+ * deleted file is an error holding a `PluginFileDeletedError`.
+ */
+export declare function useFileBytes(file: PluginFile): PluginFileBytesState;
+/**
+ * A local URL of the file, replaced when it changes on disk. A deleted file is an error holding a
+ * `PluginFileDeletedError`.
+ */
+export declare function useFileUrl(file: PluginFile): PluginFileUrlState;
+//# sourceMappingURL=file.d.ts.map

package/dist/client/file.js

@@ -0,0 +1,87 @@
+import { useEffect, useState } from "react";
+/** The file changed on disk since the handle last read or wrote it. */
+export class PluginFileConflictError extends Error {
+    constructor(message = "The file changed on disk.") {
+        super(message);
+        this.name = "PluginFileConflictError";
+    }
+}
+/** The file was deleted on disk. */
+export class PluginFileDeletedError extends Error {
+    constructor(message = "The file was deleted.") {
+        super(message);
+        this.name = "PluginFileDeletedError";
+    }
+}
+/**
+ * The file's text, re-read when it changes on disk. Keeps the current text during a re-read. A
+ * deleted file is an error holding a `PluginFileDeletedError`.
+ */
+export function useFileText(file) {
+    const state = useFileRead(file, "text");
+    return state.status === "ready" ? { status: "ready", text: state.value } : state;
+}
+/**
+ * The file's bytes, re-read when it changes on disk. Keeps the current bytes during a re-read. A
+ * deleted file is an error holding a `PluginFileDeletedError`.
+ */
+export function useFileBytes(file) {
+    const state = useFileRead(file, "bytes");
+    return state.status === "ready" ? { status: "ready", bytes: state.value } : state;
+}
+/**
+ * A local URL of the file, replaced when it changes on disk. A deleted file is an error holding a
+ * `PluginFileDeletedError`.
+ */
+export function useFileUrl(file) {
+    const state = useFileRead(file, "url");
+    return state.status === "ready" ? { status: "ready", url: state.value } : state;
+}
+function useFileRead(file, read) {
+    const [state, setState] = useState(() => ({ file, read, state: { status: "loading" } }));
+    useEffect(() => {
+        let generation = 0;
+        let active = true;
+        const load = async () => {
+            const current = ++generation;
+            let next;
+            try {
+                next = { status: "ready", value: await readFile(file, read) };
+            }
+            catch (error) {
+                next = { status: "error", error: asError(error) };
+            }
+            if (active && current === generation)
+                setState({ file, read, state: next });
+        };
+        void load();
+        const unwatch = file.watch((event) => {
+            if (event.type === "changed") {
+                void load();
+                return;
+            }
+            generation += 1;
+            setState({
+                file,
+                read,
+                state: { status: "error", error: new PluginFileDeletedError() },
+            });
+        });
+        return () => {
+            active = false;
+            unwatch();
+        };
+    }, [file, read]);
+    return state.file === file && state.read === read ? state.state : { status: "loading" };
+}
+function readFile(file, read) {
+    if (read === "text")
+        return file.readText();
+    if (read === "bytes")
+        return file.readBytes();
+    return file.url();
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=file.js.map

package/dist/client/host.d.ts

@@ -1,10 +1,11 @@
+import type { PluginText } from "../text.js";
 export { PluginClientStateProvider, type PluginClientStateSource } from "./client-state.js";
 export { usePluginRuntimeContextBridge, type PluginRuntimeContextBridge, } from "./runtime-context-bridge.js";
 import type { PluginAttachmentSourceContribution } from "../contracts.js";
 import { PluginRpcProvider } from "./rpc-context.js";
 import { PaseoApiProvider } from "./paseo-context.js";
 import { callPluginRpc } from "../rpc.js";
-export declare function searchPluginAttachments(source: PluginAttachmentSourceContribution, invoke: (method: string, input: unknown) => Promise<unknown>, query: string): Promise<{
+export declare function searchPluginAttachments(source: PluginAttachmentSourceContribution<PluginText>, invoke: (method: string, input: unknown) => Promise<unknown>, query: string): Promise<{
     items: {
         id: string;
         identifier: string;
@@ -16,4 +17,6 @@ export declare function searchPluginAttachments(source: PluginAttachmentSourceCo
     }[];
 }>;
 export { callPluginRpc, PaseoApiProvider, PluginRpcProvider };
+export { PluginTranslationRuntime, PluginTranslationProvider, usePluginTranslationRuntime, requirePluginText, isPluginMessage, } from "./translations.js";
+export type { PluginLocaleSource } from "./translations.js";
 //# sourceMappingURL=host.d.ts.map

package/dist/client/host.js

@@ -9,4 +9,5 @@ export async function searchPluginAttachments(source, invoke, query) {
     return PluginAttachmentSearchPayloadSchema.parseAsync(output);
 }
 export { callPluginRpc, PaseoApiProvider, PluginRpcProvider };
+export { PluginTranslationRuntime, PluginTranslationProvider, usePluginTranslationRuntime, requirePluginText, isPluginMessage, } from "./translations.js";
 //# sourceMappingURL=host.js.map

package/dist/client/index.d.ts

@@ -1,5 +1,8 @@
-export type { PluginHostProps, PluginSurfaceProps, PluginScreenProps, PluginPopoverProps, PluginScreenParams, PluginOpenScreenInput, PluginScreenLocation, PluginSidebarItemProps, PluginSidebarItemContribution, PluginIconProps, PluginPanelLocation, PluginOpenPanelOptions, PluginWorkspacePanelProps, PluginAgentPanelProps, PluginClientOpenPanelOptions, PluginClientContext, PluginClientContribution, PluginWorkspacePanelContribution, PluginSettingsScreenContribution, PluginSurfaceContribution, PluginScreenContribution, PluginScreenTitle, PluginSidebarContribution, PluginTimelineTransformerContribution, PluginTimelineItemProps, PluginTimelineRendererContribution, PluginCommandCapabilities, PluginGlobalCommandContext, PluginWorkspaceCommandContext, PluginAgentCommandContext, PluginCommandCenterItemContribution, PluginClientSlashCommandContribution, SettingsState, } from "./contracts.js";
+export type { PluginHostProps, PluginTab, PluginPanelProps, PluginWorkspacePanelParams, PluginAgentPanelParams, PluginFilePanelParams, PluginAgentPanelContribution, PluginFilePanelContribution, PluginFilePanelProps, PluginSurfaceProps, PluginScreenProps, PluginPopoverProps, PluginScreenParams, PluginOpenScreenInput, PluginScreenLocation, PluginSidebarItemProps, PluginSidebarItemContribution, PluginIcon, PluginPanelLocation, PluginOpenPanelOptions, PluginWorkspacePanelProps, PluginAgentPanelProps, PluginClientOpenPanelOptions, PluginClientContext, PluginClientContribution, PluginWorkspacePanelContribution, PluginSettingsScreenContribution, PluginSurfaceContribution, PluginScreenContribution, PluginScreenTitle, PluginSidebarContribution, PluginTimelineTransformerContribution, PluginTimelineItemProps, PluginTimelineRendererContribution, PluginCommandCapabilities, PluginGlobalCommandContext, PluginWorkspaceCommandContext, PluginAgentCommandContext, PluginCommandCenterItemContribution, PluginClientSlashCommandContribution, SettingsState, } from "./contracts.js";
 export type { PluginButton, PluginButtonBehavior, PluginButtonContentProps, PluginButtonContext, PluginButtonIcon, PluginButtonIconProps, PluginButtonMenuEntry, PluginButtonRegistration, PluginComposerPillContribution, PluginHeaderButtonContribution, } from "./buttons.js";
+export type { PluginIconProps, PluginSerializableIcon, PluginSvgIcon } from "../icons.js";
+export type { PluginFile, PluginFileBytesState, PluginFileEvent, PluginFileTextState, PluginFileUrlState, PluginFileWriteOptions, } from "./file.js";
+export { PluginFileConflictError, PluginFileDeletedError, useFileBytes, useFileText, useFileUrl, } from "./file.js";
 export { usePaseo } from "./paseo-context.js";
 export { useAgent, useWorkspace } from "./client-state.js";
 export { useRpc } from "./rpc-context.js";
@@ -19,4 +22,8 @@ export declare function useHosts(): readonly PluginHostSummary[];
 export declare function getPaseoClient(serverId: string): import("@camerontaylor/paseo-client").PaseoApi;
 /** Open an absolute HTTP(S) URL using the client platform’s external opener. */
 export declare function openExternalUrl(url: string): Promise<void>;
+export { defineTranslations, useTranslation } from "./translations.js";
+export type { PluginI18n } from "./translations.js";
+export type { PluginText, PluginMessage, PluginTranslations } from "../text.js";
+export { useTabState } from "./tab.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.js

@@ -1,4 +1,7 @@
+export { PluginFileConflictError, PluginFileDeletedError, useFileBytes, useFileText, useFileUrl, } from "./file.js";
 export { usePaseo } from "./paseo-context.js";
 export { useAgent, useWorkspace } from "./client-state.js";
 export { useRpc } from "./rpc-context.js";
+export { defineTranslations, useTranslation } from "./translations.js";
+export { useTabState } from "./tab.js";
 //# sourceMappingURL=index.js.map

package/dist/client/react-native.d.ts

@@ -1,46 +1,5 @@
-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 } from "react-native";
-import type { PluginIconProps } 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;
-}
-export declare const Icon: ComponentType<PluginIconProps>;
-export declare const Modal: ModalComponent;
-export declare function useToast(): ToastApi;
+/** @deprecated Import Paseo UI from @getpaseo/plugin/client/ui. */
+export * from "./ui.js";
+/** @deprecated Render StreamedText from @getpaseo/plugin/client/ui. Removed after 2027-04-20 with this entry. */
 export declare function useRevealedText(text: string, phase: "streaming" | "complete"): string;
-export type { PluginIconProps } from "./contracts.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>>;
 //# sourceMappingURL=react-native.d.ts.map

package/dist/client/react-native.js

@@ -1,2 +1,4 @@
-export {};
+// COMPAT(pluginReactNativeEntrypoint): added in v0.13.0, remove after 2027-04-20
+/** @deprecated Import Paseo UI from @getpaseo/plugin/client/ui. */
+export * from "./ui.js";
 //# sourceMappingURL=react-native.js.map