@getpaseo/plugin 0.6.0 → 0.7.0-beta.1

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;
@@ -121,6 +132,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>>;
@@ -167,6 +217,8 @@ export interface PluginContext {
     addCommandCenterItem(contribution: PluginCommandCenterItemContribution): 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,5 @@
 export { PluginClientStateProvider, type PluginClientStateSource } from "./client-state.js";
-import type { PluginAttachmentSourceContribution, PluginCommandCenterItemContribution, PluginContext, PluginSidebarContribution, PluginSurfaceContribution, PluginSurfaceProps, PluginThemeContribution, PluginWorkspacePanelContribution } from "./contracts.js";
+import type { PluginAttachmentSourceContribution, PluginCommandCenterItemContribution, 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";
@@ -11,6 +11,8 @@ interface PluginCollector {
     addCommandCenterItem(contribution: PluginCommandCenterItemContribution): void;
     addAttachmentSource(contribution: PluginAttachmentSourceContribution): void;
     addTheme(contribution: PluginThemeContribution): void;
+    addTimelineTransformer(contribution: PluginTimelineTransformerContribution): void;
+    addTimelineRenderer(contribution: PluginTimelineRendererContribution): void;
 }
 export interface PluginRegistrationCollector {
     surfaces: PluginSurfaceContribution[];
@@ -19,8 +21,10 @@ export interface PluginRegistrationCollector {
     commandCenterItems: PluginCommandCenterItemContribution[];
     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" | "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

@@ -23,6 +23,12 @@ export function createPluginContext(collector) {
         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, 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/plugin",
-  "version": "0.6.0",
+  "version": "0.7.0-beta.1",
   "description": "Paseo plugin SDK package",
   "files": [
     "dist",
@@ -39,7 +39,8 @@
     "use-sync-external-store": "^1.6.0"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.6.0",
+    "@getpaseo/client": "0.7.0-beta.1",
+    "@getpaseo/protocol": "0.7.0-beta.1",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
     "react": "19.1.0",
@@ -48,7 +49,8 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@getpaseo/client": "0.6.0",
+    "@getpaseo/client": "0.7.0-beta.1",
+    "@getpaseo/protocol": "0.7.0-beta.1",
     "react": "19.1.0",
     "zod": "^4.4.3"
   }