@getpaseo/plugin 0.6.1 → 0.7.0-beta.2

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

@@ -1,14 +1,20 @@
 import type { ComponentType } from "react";
 import type { PaseoApi } from "@getpaseo/client";
+import type { AgentTimelineItem } from "@getpaseo/protocol/agent-types";
 import type { ZodType, input as ZodInput, output as ZodOutput } from "zod";
 import type { PluginRpcContract } from "./rpc.js";
 export interface PluginTheme {
     readonly colors: {
         readonly surface0: string;
+        readonly surface1: string;
+        readonly surface2: string;
+        readonly border: string;
         readonly foreground: string;
         readonly foregroundMuted: string;
         readonly accent: string;
         readonly accentForeground: string;
+        readonly statusSuccess: string;
+        readonly statusWarning: string;
         readonly statusDanger: string;
     };
 }
@@ -25,6 +31,11 @@ export interface PluginHostProps {
 }
 export interface PluginSurfaceProps extends PluginHostProps {
 }
+export interface PluginIconProps {
+    name: string;
+    size?: number;
+    color?: string;
+}
 export interface PluginWorkspaceSnapshot {
     readonly id: string;
     readonly projectId: string;
@@ -80,6 +91,27 @@ export interface PluginAgentPanelProps extends PluginHostProps {
     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>;
@@ -121,6 +153,45 @@ export interface PluginAttachmentSourceContribution {
     searchPlaceholder: string;
     search: PluginRpcContract;
 }
+export type PluginTimelineData = null | boolean | number | string | PluginTimelineData[] | {
+    [key: string]: PluginTimelineData;
+};
+export interface PluginTimelineItem {
+    type: "plugin";
+    kind: string;
+    version: number;
+    data: PluginTimelineData;
+}
+export interface PluginTimelineTransformResult {
+    items: PluginTimelineItem[];
+}
+export type PluginTimelineTransformerContribution<ItemType extends AgentTimelineItem["type"] = AgentTimelineItem["type"]> = ItemType extends AgentTimelineItem["type"] ? {
+    id: string;
+    query: {
+        itemType: ItemType;
+    };
+    transform(input: {
+        item: Extract<AgentTimelineItem, {
+            type: ItemType;
+        }>;
+    }): PluginTimelineTransformResult | undefined;
+} : never;
+export interface PluginTimelineItemProps<Data = unknown> extends PluginHostProps {
+    agentId: string;
+    item: {
+        type: "plugin";
+        kind: string;
+        version: number;
+        data: Data;
+    };
+    timestamp: Date;
+}
+export interface PluginTimelineRendererContribution<Schema extends ZodType = ZodType> {
+    kind: string;
+    version: number;
+    schema: Schema;
+    Component: ComponentType<PluginTimelineItemProps<ZodOutput<Schema>>>;
+}
 export interface PluginCommandCapabilities {
     paseo: PaseoApi;
     rpc<InputSchema extends ZodType, OutputSchema extends ZodType>(contract: PluginRpcContract<InputSchema, OutputSchema>, input: ZodInput<InputSchema>): Promise<ZodOutput<OutputSchema>>;
@@ -165,8 +236,11 @@ 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;
+    addTimelineRenderer<Schema extends ZodType>(contribution: PluginTimelineRendererContribution<Schema>): void;
 }
 export type PluginCleanup = () => void | Promise<void>;
 export type PluginContribution = (plugin: PluginContext) => PluginCleanup;

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, 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,18 +10,24 @@ 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;
+    addTimelineRenderer(contribution: PluginTimelineRendererContribution): void;
 }
 export interface PluginRegistrationCollector {
     surfaces: PluginSurfaceContribution[];
     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">;
+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,12 +18,21 @@ export function createPluginContext(collector) {
         addCommandCenterItem(contribution) {
             collector.addCommandCenterItem(contribution);
         },
+        addClientSide(contribution) {
+            collector.addClientSide(contribution);
+        },
         addAttachmentSource(contribution) {
             collector.addAttachmentSource(contribution);
         },
         addTheme(contribution) {
             collector.addTheme(contribution);
         },
+        addTimelineTransformer(contribution) {
+            collector.addTimelineTransformer(contribution);
+        },
+        addTimelineRenderer(contribution) {
+            collector.addTimelineRenderer(contribution);
+        },
     };
 }
 export async function searchPluginAttachments(source, invoke, query) {

package/dist/index.d.ts

@@ -1,5 +1,8 @@
+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 type { PluginAttachmentSourceContribution, PluginAgentCommandContext, PluginAgentPanelProps, PluginAgentSnapshot, PluginCleanup, PluginCommandCapabilities, PluginCommandCenterItemContribution, PluginContribution, PluginContext, PluginGlobalCommandContext, PluginHandlerContext, PluginHostProps, PluginOpenPanelOptions, PluginPanelLocation, PluginTheme, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeColors, PluginThemeContribution, PluginWorkspaceCommandContext, PluginWorkspacePanelContribution, PluginWorkspacePanelProps, PluginWorkspaceSnapshot, } from "./contracts.js";
+export declare const Icon: ComponentType<PluginIconProps>;
+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.6.1",
+  "version": "0.7.0-beta.2",
   "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,7 +44,8 @@
     "use-sync-external-store": "^1.6.0"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.6.1",
+    "@getpaseo/client": "0.7.0-beta.2",
+    "@getpaseo/protocol": "0.7.0-beta.2",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
     "react": "19.1.0",
@@ -48,7 +54,8 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@getpaseo/client": "0.6.1",
+    "@getpaseo/client": "0.7.0-beta.2",
+    "@getpaseo/protocol": "0.7.0-beta.2",
     "react": "19.1.0",
     "zod": "^4.4.3"
   }