@getpaseo/plugin 0.7.0-beta.1 → 0.7.0-beta.3

package/dist/client-state.d.ts

@@ -5,6 +5,7 @@ export interface PluginClientStateSource {
     getWorkspace(id: string): PluginWorkspaceSnapshot | null;
     getAgent(id: string): PluginAgentSnapshot | null;
 }
+export declare function usePluginClientStateSource(): PluginClientStateSource | null;
 export declare function useWorkspace<Selection>(workspaceId: string, selector: (workspace: PluginWorkspaceSnapshot) => Selection): Selection | null;
 export declare function useAgent<Selection>(agentId: string, selector: (agent: PluginAgentSnapshot) => Selection): Selection | null;
 export declare function PluginClientStateProvider({ children, source, }: {

package/dist/client-state.js

@@ -3,8 +3,11 @@ import { createContext, useContext } from "react";
 import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/with-selector";
 import { shallowEqual } from "./shallow.js";
 const PluginClientStateContext = createContext(null);
+export function usePluginClientStateSource() {
+    return useContext(PluginClientStateContext);
+}
 function usePluginEntity(input) {
-    const source = useContext(PluginClientStateContext);
+    const source = usePluginClientStateSource();
     if (!source)
         throw new Error("Plugin state hooks must run inside a workspace panel");
     return useSyncExternalStoreWithSelector(source.subscribe, () => input.read(source, input.id), () => input.read(source, input.id), (entity) => (entity ? input.selector(entity) : null), shallowEqual);

package/dist/contracts.d.ts

@@ -29,7 +29,18 @@ export interface PluginHostProps {
         platform: "ios" | "android" | "web";
     };
 }
-export interface PluginSurfaceProps extends PluginHostProps {
+interface PluginNavigableHostProps extends PluginHostProps {
+    /** Client-owned navigation. Undefined on older hosts; hide dependent affordances when absent. */
+    readonly navigation?: {
+        readonly openAgent: (input: {
+            readonly agentId: string;
+        }) => void;
+        readonly openWorkspace: (input: {
+            readonly workspaceId: string;
+        }) => void;
+    };
+}
+export interface PluginSurfaceProps extends PluginNavigableHostProps {
 }
 export interface PluginIconProps {
     name: string;
@@ -82,15 +93,36 @@ interface PluginWorkspacePanelBase {
     icon: string;
     locations?: readonly PluginPanelLocation[];
 }
-export interface PluginWorkspacePanelProps extends PluginHostProps {
+export interface PluginWorkspacePanelProps extends PluginNavigableHostProps {
     context: "workspace";
     workspaceId: string;
 }
-export interface PluginAgentPanelProps extends PluginHostProps {
+export interface PluginAgentPanelProps extends PluginNavigableHostProps {
     context: "agent";
     workspaceId: string;
     agentId: string;
 }
+export interface PluginComposerPillProps extends PluginHostProps {
+    workspaceId: string;
+    agentId: string;
+}
+export interface PluginComposerPillContribution {
+    id: string;
+    title: string;
+    workspaceId: string;
+    agentId: string;
+    Component: ComponentType<PluginComposerPillProps>;
+    onPress(): void | Promise<void>;
+}
+export interface PluginClientOpenPanelOptions extends PluginOpenPanelOptions {
+    workspaceId: string;
+    agentId?: string;
+}
+export interface PluginClientContext extends PluginCommandCapabilities {
+    addComposerPill(contribution: PluginComposerPillContribution): PluginCleanup;
+    openPanel(id: string, options: PluginClientOpenPanelOptions): void;
+}
+export type PluginClientContribution = (client: PluginClientContext) => PluginCleanup;
 export type PluginWorkspacePanelContribution = (PluginWorkspacePanelBase & {
     context: "workspace";
     Component: ComponentType<PluginWorkspacePanelProps>;
@@ -215,6 +247,7 @@ export interface PluginContext {
     addSidebarItem(contribution: PluginSidebarContribution): void;
     addWorkspacePanel(contribution: PluginWorkspacePanelContribution): void;
     addCommandCenterItem(contribution: PluginCommandCenterItemContribution): void;
+    addClientSide(contribution: PluginClientContribution): void;
     addAttachmentSource(contribution: PluginAttachmentSourceContribution): void;
     addTheme(contribution: PluginThemeContribution): void;
     addTimelineTransformer<ItemType extends AgentTimelineItem["type"]>(contribution: PluginTimelineTransformerContribution<ItemType>): void;

package/dist/host.d.ts

@@ -1,5 +1,6 @@
 export { PluginClientStateProvider, type PluginClientStateSource } from "./client-state.js";
-import type { PluginAttachmentSourceContribution, PluginCommandCenterItemContribution, PluginContext, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeContribution, PluginTimelineRendererContribution, PluginTimelineTransformerContribution, PluginWorkspacePanelContribution } from "./contracts.js";
+export { usePluginRuntimeContextBridge, type PluginRuntimeContextBridge, } from "./runtime-context-bridge.js";
+import type { PluginAttachmentSourceContribution, PluginCommandCenterItemContribution, PluginClientContribution, PluginContext, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeContribution, PluginTimelineRendererContribution, PluginTimelineTransformerContribution, PluginWorkspacePanelContribution } from "./contracts.js";
 import { PluginRpcProvider } from "./rpc-context.js";
 import { PaseoApiProvider } from "./paseo-context.js";
 import { callPluginRpc } from "./rpc.js";
@@ -9,6 +10,7 @@ interface PluginCollector {
     addSidebarItem(contribution: PluginSidebarContribution): void;
     addWorkspacePanel(contribution: PluginWorkspacePanelContribution): void;
     addCommandCenterItem(contribution: PluginCommandCenterItemContribution): void;
+    addClientSide(contribution: PluginClientContribution): void;
     addAttachmentSource(contribution: PluginAttachmentSourceContribution): void;
     addTheme(contribution: PluginThemeContribution): void;
     addTimelineTransformer(contribution: PluginTimelineTransformerContribution): void;
@@ -19,12 +21,13 @@ export interface PluginRegistrationCollector {
     sidebarItems: PluginSidebarContribution[];
     workspacePanels: PluginWorkspacePanelContribution[];
     commandCenterItems: PluginCommandCenterItemContribution[];
+    clientSide: PluginClientContribution | null;
     attachmentSources: PluginAttachmentSourceContribution[];
     themes: PluginThemeContribution[];
     timelineTransformers: PluginTimelineTransformerContribution[];
     timelineRenderers: PluginTimelineRendererContribution[];
 }
-export declare function createPluginContext(collector: PluginCollector): Pick<PluginContext, "addSurface" | "addSidebarItem" | "addWorkspacePanel" | "addCommandCenterItem" | "addAttachmentSource" | "addTheme" | "addTimelineTransformer" | "addTimelineRenderer">;
+export declare function createPluginContext(collector: PluginCollector): Pick<PluginContext, "addSurface" | "addSidebarItem" | "addWorkspacePanel" | "addCommandCenterItem" | "addClientSide" | "addAttachmentSource" | "addTheme" | "addTimelineTransformer" | "addTimelineRenderer">;
 export declare function searchPluginAttachments(source: PluginAttachmentSourceContribution, invoke: (method: string, input: unknown) => Promise<unknown>, query: string): Promise<{
     items: {
         id: string;

package/dist/host.js

@@ -1,5 +1,6 @@
 import { PluginAttachmentSearchPayloadSchema } from "./attachments.js";
 export { PluginClientStateProvider } from "./client-state.js";
+export { usePluginRuntimeContextBridge, } from "./runtime-context-bridge.js";
 import { PluginRpcProvider } from "./rpc-context.js";
 import { PaseoApiProvider } from "./paseo-context.js";
 import { callPluginRpc } from "./rpc.js";
@@ -17,6 +18,9 @@ export function createPluginContext(collector) {
         addCommandCenterItem(contribution) {
             collector.addCommandCenterItem(contribution);
         },
+        addClientSide(contribution) {
+            collector.addClientSide(contribution);
+        },
         addAttachmentSource(contribution) {
             collector.addAttachmentSource(contribution);
         },

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { ComponentType } from "react";
 import type { PluginIconProps } from "./contracts.js";
 export { PluginAttachmentItemSchema, PluginAttachmentSearchPayloadSchema, defineAttachmentSource, defineRpc, type PluginAttachmentItem, type PluginAttachmentSearchPayload, type PluginRpcContract, } from "./server.js";
 export declare const Icon: ComponentType<PluginIconProps>;
-export type { PluginAttachmentSourceContribution, PluginAgentCommandContext, PluginAgentPanelProps, PluginAgentSnapshot, PluginCleanup, PluginCommandCapabilities, PluginCommandCenterItemContribution, PluginContribution, PluginContext, PluginGlobalCommandContext, PluginHandlerContext, PluginHostProps, PluginOpenPanelOptions, PluginIconProps, PluginPanelLocation, PluginTheme, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeColors, PluginThemeContribution, PluginTimelineData, PluginTimelineItem, PluginTimelineItemProps, PluginTimelineRendererContribution, PluginTimelineTransformerContribution, PluginTimelineTransformResult, PluginWorkspaceCommandContext, PluginWorkspacePanelContribution, PluginWorkspacePanelProps, PluginWorkspaceSnapshot, } from "./contracts.js";
+export type { PluginAttachmentSourceContribution, PluginAgentCommandContext, PluginAgentPanelProps, PluginAgentSnapshot, PluginCleanup, PluginCommandCapabilities, PluginCommandCenterItemContribution, PluginClientContext, PluginClientContribution, PluginClientOpenPanelOptions, PluginComposerPillContribution, PluginComposerPillProps, PluginContribution, PluginContext, PluginGlobalCommandContext, PluginHandlerContext, PluginHostProps, PluginOpenPanelOptions, PluginIconProps, PluginPanelLocation, PluginTheme, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeColors, PluginThemeContribution, PluginTimelineData, PluginTimelineItem, PluginTimelineItemProps, PluginTimelineRendererContribution, PluginTimelineTransformerContribution, PluginTimelineTransformResult, PluginWorkspaceCommandContext, PluginWorkspacePanelContribution, PluginWorkspacePanelProps, PluginWorkspaceSnapshot, } from "./contracts.js";
 export { usePaseo } from "./paseo-context.js";
 export { useAgent, useWorkspace } from "./client-state.js";
 export { useRpc } from "./rpc-context.js";

package/dist/paseo-context.d.ts

@@ -1,5 +1,6 @@
 import type { PaseoApi } from "@getpaseo/client";
 import { type ReactNode } from "react";
+export declare function usePaseoContextValue(): PaseoApi | null;
 export declare function PaseoApiProvider({ children, paseo }: {
     children: ReactNode;
     paseo: PaseoApi;

package/dist/paseo-context.js

@@ -1,11 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from "react";
 const PaseoApiContext = createContext(null);
+export function usePaseoContextValue() {
+    return useContext(PaseoApiContext);
+}
 export function PaseoApiProvider({ children, paseo }) {
     return _jsx(PaseoApiContext.Provider, { value: paseo, children: children });
 }
 export function usePaseo() {
-    const paseo = useContext(PaseoApiContext);
+    const paseo = usePaseoContextValue();
     if (!paseo)
         throw new Error("usePaseo must run inside a contributed plugin surface");
     return paseo;

package/dist/react-native.d.ts

@@ -0,0 +1,29 @@
+import type { ComponentType, FunctionComponent, ReactNode } from "react";
+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;
+}
+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;
+export type { PluginIconProps } from "./contracts.js";
+//# sourceMappingURL=react-native.d.ts.map

package/dist/react-native.js

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

package/dist/rpc-context.d.ts

@@ -1,6 +1,10 @@
 import { type ReactNode } from "react";
 import type { ZodType, input as ZodInput, output as ZodOutput } from "zod";
 import { type PluginRpcContract } from "./rpc.js";
+export interface PluginRpcContextValue {
+    invoke(method: string, input: unknown): Promise<unknown>;
+}
+export declare function usePluginRpcContextValue(): PluginRpcContextValue | null;
 export declare function PluginRpcProvider({ children, invoke, }: {
     children: ReactNode;
     invoke(method: string, input: unknown): Promise<unknown>;

package/dist/rpc-context.js

@@ -2,12 +2,15 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useMemo } from "react";
 import { callPluginRpc } from "./rpc.js";
 const PluginRpcContext = createContext(null);
+export function usePluginRpcContextValue() {
+    return useContext(PluginRpcContext);
+}
 export function PluginRpcProvider({ children, invoke, }) {
     const value = useMemo(() => ({ invoke }), [invoke]);
     return _jsx(PluginRpcContext.Provider, { value: value, children: children });
 }
 export function useRpc(contract) {
-    const context = useContext(PluginRpcContext);
+    const context = usePluginRpcContextValue();
     if (!context)
         throw new Error("useRpc must run inside a contributed plugin surface");
     return useCallback((input) => callPluginRpc(contract, context.invoke, input), [context, contract]);

package/dist/runtime-context-bridge.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from "react";
+export type PluginRuntimeContextBridge = (children: ReactNode) => ReactNode;
+/** Rebuilds plugin runtime contexts inside React Native portal hosts. */
+export declare function usePluginRuntimeContextBridge(): PluginRuntimeContextBridge;
+//# sourceMappingURL=runtime-context-bridge.d.ts.map

package/dist/runtime-context-bridge.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+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 paseo = usePaseoContextValue();
+    const rpc = usePluginRpcContextValue();
+    const state = usePluginClientStateSource();
+    if (!paseo || !rpc) {
+        throw new Error("Plugin UI must run inside a contributed plugin surface");
+    }
+    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]);
+}
+//# sourceMappingURL=runtime-context-bridge.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/plugin",
-  "version": "0.7.0-beta.1",
+  "version": "0.7.0-beta.3",
   "description": "Paseo plugin SDK package",
   "files": [
     "dist",
@@ -18,6 +18,11 @@
       "source": "./src/server.ts",
       "default": "./dist/server.js"
     },
+    "./react-native": {
+      "types": "./dist/react-native.d.ts",
+      "source": "./src/react-native.ts",
+      "default": "./dist/react-native.js"
+    },
     "./host": {
       "types": "./dist/host.d.ts",
       "source": "./src/host.ts",
@@ -39,8 +44,8 @@
     "use-sync-external-store": "^1.6.0"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.7.0-beta.1",
-    "@getpaseo/protocol": "0.7.0-beta.1",
+    "@getpaseo/client": "0.7.0-beta.3",
+    "@getpaseo/protocol": "0.7.0-beta.3",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
     "react": "19.1.0",
@@ -49,8 +54,8 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@getpaseo/client": "0.7.0-beta.1",
-    "@getpaseo/protocol": "0.7.0-beta.1",
+    "@getpaseo/client": "0.7.0-beta.3",
+    "@getpaseo/protocol": "0.7.0-beta.3",
     "react": "19.1.0",
     "zod": "^4.4.3"
   }