paseo/packages/app/src/plugins/timeline/model.ts

import type {
  PluginTimelineData,
  PluginTimelineItem,
  PluginTimelineTransformResult,
} from "@getpaseo/plugin";
import type { AgentTimelineItem } from "@getpaseo/protocol/agent-types";
import type { InstalledPlugin } from "../types";

export interface InstalledPluginTimelineItem extends PluginTimelineItem {
  id: string;
  pluginId: string;
}

export interface TimelineItemTransformInput {
  item: AgentTimelineItem;
  phase: "streaming" | "complete";
  sourceId: string;
}

export type TimelineItemTransform = (
  input: TimelineItemTransformInput,
) => InstalledPluginTimelineItem[] | undefined;

function isTimelineData(value: unknown, ancestors: Set<object>): value is PluginTimelineData {
  if (value === null || typeof value === "string" || typeof value === "boolean") {
    return true;
  }
  if (typeof value === "number") return Number.isFinite(value);
  if (typeof value !== "object") return false;
  if (ancestors.has(value)) return false;
  if (!Array.isArray(value)) {
    const prototype = Object.getPrototypeOf(value);
    if (prototype !== Object.prototype && prototype !== null) return false;
    if (Reflect.ownKeys(value).some((key) => typeof key !== "string")) return false;
  }

  ancestors.add(value);
  const values = Array.isArray(value) ? value : Object.values(value);
  const valid = values.every((child) => isTimelineData(child, ancestors));
  ancestors.delete(value);
  return valid;
}

function parseTransformResult(value: unknown): PluginTimelineTransformResult {
  if (!value || typeof value !== "object") {
    throw new Error("transform must return an object containing items");
  }
  const items = Reflect.get(value, "items");
  if (!Array.isArray(items)) throw new Error("transform result items must be an array");

  for (const item of items) {
    if (!item || typeof item !== "object" || Reflect.get(item, "type") !== "plugin") {
      throw new Error('transformed timeline items must have type "plugin"');
    }
    const kind = Reflect.get(item, "kind");
    const id = Reflect.get(item, "id");
    const version = Reflect.get(item, "version");
    if (typeof kind !== "string" || !/^[a-z][a-z0-9-]*$/.test(kind)) {
      throw new Error(`invalid transformed timeline item kind: ${String(kind)}`);
    }
    if (id !== undefined && (typeof id !== "string" || id.length === 0)) {
      throw new Error(`invalid transformed timeline item id: ${String(id)}`);
    }
    if (!Number.isInteger(version) || Number(version) < 1) {
      throw new Error(`invalid transformed timeline item version: ${String(version)}`);
    }
    if (!isTimelineData(Reflect.get(item, "data"), new Set())) {
      throw new Error(`transformed timeline item ${kind} data must be JSON-compatible`);
    }
  }
  return { items: items as PluginTimelineItem[] };
}

export function transformTimelineItem(
  input: TimelineItemTransformInput & { plugins: readonly InstalledPlugin[] },
): InstalledPluginTimelineItem[] | undefined {
  for (const plugin of input.plugins) {
    for (const transformer of plugin.timelineTransformers) {
      if (transformer.query.itemType !== input.item.type) continue;
      try {
        const transform = transformer.transform as (input: {
          item: AgentTimelineItem;
          phase: "streaming" | "complete";
        }) => PluginTimelineTransformResult | undefined;
        const output = transform({ item: input.item, phase: input.phase });
        if (output === undefined) continue;
        const parsed = parseTransformResult(output);
        return parsed.items.map((transformedItem, index) => ({
          type: "plugin",
          id: transformedItem.id ?? `${input.sourceId}/${index}`,
          kind: transformedItem.kind,
          version: transformedItem.version,
          data: JSON.parse(JSON.stringify(transformedItem.data)) as PluginTimelineData,
          pluginId: plugin.id,
        }));
      } catch (error) {
        console.warn(
          `[Plugins] Timeline transformer failed: ${plugin.id}/${transformer.id}`,
          error,
        );
      }
    }
  }
  return undefined;
}