paseo-form-render 0.0.0-stage → 0.2.0

package/server/file-picker.ts

@@ -0,0 +1,253 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import type { RpcInput } from "@getpaseo/plugin";
+import type { PluginServerContext } from "@getpaseo/plugin/server";
+import {
+  type listProjectFilesRpc,
+  type createDirectoryRpc,
+  type FilePickerShortcut,
+} from "../shared/pickers";
+
+type Paseo = Parameters<Parameters<PluginServerContext["handle"]>[1]>[1]["paseo"];
+
+export async function handleListProjectFiles(
+  { agentId, subPath, targetPath }: RpcInput<typeof listProjectFilesRpc>,
+  { paseo }: { paseo: Paseo },
+) {
+  try {
+    const agent = paseo.agents.ref(agentId);
+    let cwd: string | null | undefined = agent?.cwd;
+    if (!cwd) {
+      if (agent) {
+        const snapshot = await agent.refresh();
+        cwd = snapshot?.agent?.cwd;
+      }
+      if (!cwd) {
+        cwd = process.cwd();
+      }
+    }
+
+    const homeDir = os.homedir();
+    const shortcuts: FilePickerShortcut[] = [
+      { id: "project", label: "Project", icon: "📁", path: cwd },
+      { id: "home", label: "Home", icon: "🏠", path: homeDir },
+    ];
+    const desktopDir = path.join(homeDir, "Desktop");
+    if (fs.existsSync(desktopDir)) {
+      shortcuts.push({ id: "desktop", label: "Desktop", icon: "🖥️", path: desktopDir });
+    }
+    const downloadsDir = path.join(homeDir, "Downloads");
+    if (fs.existsSync(downloadsDir)) {
+      shortcuts.push({ id: "downloads", label: "Downloads", icon: "📥", path: downloadsDir });
+    }
+
+    // OneDrive detection: check Windows env vars (OneDrive, OneDriveCommercial, OneDriveConsumer) or ~/OneDrive
+    const oneDriveCandidates = [
+      { id: "onedrive", label: "OneDrive", path: process.env.OneDrive },
+      { id: "onedrive-commercial", label: "OneDrive (Work)", path: process.env.OneDriveCommercial },
+      { id: "onedrive-consumer", label: "OneDrive (Personal)", path: process.env.OneDriveConsumer },
+    ];
+
+    const addedOneDrivePaths = new Set<string>();
+    for (const item of oneDriveCandidates) {
+      if (item.path && !addedOneDrivePaths.has(item.path)) {
+        try {
+          if (fs.existsSync(item.path)) {
+            addedOneDrivePaths.add(item.path);
+            shortcuts.push({
+              id: item.id,
+              label: item.label,
+              icon: "☁️",
+              path: item.path,
+            });
+          }
+        } catch {}
+      }
+    }
+
+    if (addedOneDrivePaths.size === 0) {
+      const defaultOneDrive = path.join(homeDir, "OneDrive");
+      try {
+        if (fs.existsSync(defaultOneDrive)) {
+          shortcuts.push({
+            id: "onedrive",
+            label: "OneDrive",
+            icon: "☁️",
+            path: defaultOneDrive,
+          });
+        }
+      } catch {}
+    }
+
+    let rawPath = (targetPath !== undefined && targetPath !== null && targetPath !== "")
+      ? targetPath
+      : (subPath || "");
+
+    let targetDir: string;
+    if (rawPath.startsWith("~")) {
+      targetDir = path.resolve(homeDir, rawPath.slice(1).replace(/^[/\\]/, ""));
+    } else if (path.isAbsolute(rawPath)) {
+      targetDir = path.resolve(rawPath);
+    } else if (rawPath) {
+      targetDir = path.resolve(cwd, rawPath);
+    } else {
+      targetDir = cwd;
+    }
+
+    try {
+      const stat = await fs.promises.stat(targetDir);
+      if (!stat.isDirectory()) {
+        targetDir = path.dirname(targetDir);
+      }
+    } catch {
+      targetDir = cwd;
+    }
+
+    const relToCwd = path.relative(cwd, targetDir);
+    const isWorkspaceRelative =
+      !relToCwd.startsWith("..") && !path.isAbsolute(relToCwd);
+
+    const currentPath = isWorkspaceRelative
+      ? (relToCwd ? relToCwd.replace(/\\/g, "/") : "")
+      : targetDir.replace(/\\/g, "/");
+
+    let parentPath: string | null = null;
+    if (isWorkspaceRelative) {
+      if (currentPath) {
+        const parentResolved = path.dirname(targetDir);
+        const relParent = path.relative(cwd, parentResolved).replace(/\\/g, "/");
+        parentPath = relParent === "" ? "" : relParent;
+      }
+    } else {
+      const parentDir = path.dirname(targetDir);
+      if (parentDir !== targetDir) {
+        parentPath = parentDir.replace(/\\/g, "/");
+      }
+    }
+
+    let entries: { name: string; isDirectory: boolean; relativePath: string; fullPath: string }[] = [];
+    let readError: string | undefined;
+
+    try {
+      const dirents = await fs.promises.readdir(targetDir, { withFileTypes: true });
+      entries = dirents
+        .filter((d) => !d.name.startsWith(".") && d.name !== "node_modules")
+        .map((d) => {
+          const fullPath = path.join(targetDir, d.name);
+          const entryRelToCwd = path.relative(cwd, fullPath);
+          const entryInsideCwd =
+            !entryRelToCwd.startsWith("..") && !path.isAbsolute(entryRelToCwd);
+          const relativePath = entryInsideCwd
+            ? entryRelToCwd.replace(/\\/g, "/")
+            : fullPath.replace(/\\/g, "/");
+          return {
+            name: d.name,
+            isDirectory: d.isDirectory(),
+            relativePath,
+            fullPath: fullPath.replace(/\\/g, "/"),
+          };
+        })
+        .sort((a, b) => {
+          if (a.isDirectory && !b.isDirectory) return -1;
+          if (!a.isDirectory && b.isDirectory) return 1;
+          return a.name.localeCompare(b.name);
+        });
+    } catch (e) {
+      readError = e instanceof Error ? e.message : String(e);
+    }
+
+    return {
+      currentPath,
+      parentPath,
+      entries,
+      shortcuts,
+      isWorkspaceRelative,
+      error: readError,
+    };
+  } catch (err) {
+    return {
+      currentPath: "",
+      parentPath: null,
+      entries: [],
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}
+
+export async function handleCreateDirectory(
+  { agentId, parentPath, name }: RpcInput<typeof createDirectoryRpc>,
+  { paseo }: { paseo: Paseo },
+) {
+  try {
+    const trimmedName = name.trim();
+    if (!trimmedName) {
+      return { success: false, error: "Folder name cannot be empty." };
+    }
+    if (
+      trimmedName === "." ||
+      trimmedName === ".." ||
+      trimmedName.includes("/") ||
+      trimmedName.includes("\\") ||
+      /[<>:"|?*]/.test(trimmedName)
+    ) {
+      return { success: false, error: "Folder name contains invalid characters." };
+    }
+
+    const agent = paseo.agents.ref(agentId);
+    let cwd: string | null | undefined = agent?.cwd;
+    if (!cwd) {
+      if (agent) {
+        const snapshot = await agent.refresh();
+        cwd = snapshot?.agent?.cwd;
+      }
+      if (!cwd) {
+        cwd = process.cwd();
+      }
+    }
+
+    const homeDir = os.homedir();
+    let targetDir: string;
+    if (parentPath.startsWith("~")) {
+      targetDir = path.resolve(homeDir, parentPath.slice(1).replace(/^[/\\]/, ""));
+    } else if (path.isAbsolute(parentPath)) {
+      targetDir = path.resolve(parentPath);
+    } else if (parentPath) {
+      targetDir = path.resolve(cwd, parentPath);
+    } else {
+      targetDir = cwd;
+    }
+
+    const newFullPath = path.join(targetDir, trimmedName);
+
+    if (path.dirname(newFullPath) !== targetDir) {
+      return { success: false, error: "Invalid target path." };
+    }
+
+    if (fs.existsSync(newFullPath)) {
+      return { success: false, error: "A folder or file with this name already exists." };
+    }
+
+    await fs.promises.mkdir(newFullPath, { recursive: false });
+
+    const relToCwd = path.relative(cwd, newFullPath);
+    const isWorkspaceRelative =
+      !relToCwd.startsWith("..") && !path.isAbsolute(relToCwd);
+
+    const relativePath = isWorkspaceRelative
+      ? (relToCwd ? relToCwd.replace(/\\/g, "/") : "")
+      : newFullPath.replace(/\\/g, "/");
+
+    return {
+      success: true,
+      fullPath: newFullPath.replace(/\\/g, "/"),
+      relativePath,
+    };
+  } catch (err: any) {
+    if (err?.code === "EACCES" || err?.code === "EPERM") {
+      return { success: false, error: "Permission denied: unable to create folder in this location." };
+    }
+    return { success: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+

package/server/settings.ts

@@ -0,0 +1,26 @@
+import type { PluginServerContext } from "@getpaseo/plugin/server";
+import { DEFAULT_AUTO_FIX_RETRIES, DEFAULT_PREFER_FORMS, pfrSettings } from "../shared/settings";
+
+export function registerPfrSettings(server: PluginServerContext) {
+  return server.registerSettings(pfrSettings);
+}
+
+export type PfrSettingsHandle = ReturnType<typeof registerPfrSettings>;
+
+export interface PfrSettingsValues {
+  autoFixMaxRetries: number;
+  preferForms: boolean;
+}
+
+const DEFAULT_VALUES: PfrSettingsValues = { autoFixMaxRetries: DEFAULT_AUTO_FIX_RETRIES, preferForms: DEFAULT_PREFER_FORMS };
+
+/** Reads the saved settings, falling back to the defaults when they cannot be loaded. */
+export async function readPfrSettings(settings: PfrSettingsHandle): Promise<PfrSettingsValues> {
+  try {
+    const state = await settings.read();
+    if (state.status === "ready") return state.values;
+  } catch (error) {
+    console.warn("[paseo-form-render] could not read settings, using defaults", error);
+  }
+  return DEFAULT_VALUES;
+}

package/shared/demo.ts

@@ -0,0 +1,96 @@
+import { defineRpc } from "@getpaseo/plugin";
+import { z } from "zod";
+
+export const TIMELINE_KIND = "paseo-form-render";
+
+/** Asks the daemon to put the demo form into an agent's timeline; nothing is sent to the agent. */
+export const showDemoForm = defineRpc({
+  name: "pfr-form.demo",
+  input: z.object({ agentId: z.string() }),
+  output: z.object({}),
+});
+
+export const DEMO_FORM_TEXT = [
+  "Here is a demonstration of the interactive form:",
+  "```pfr-form",
+  JSON.stringify(
+    {
+      type: "Card",
+      title: "Demo Configuration Form",
+      description: "Try filling out this form and submitting it to the agent.",
+      children: [
+        { type: "Metric", label: "Current Version", value: "v0.1.0" },
+        {
+          type: "Input",
+          id: "project_name",
+          label: "Project Name",
+          placeholder: "e.g., My Awesome Project",
+          required: true,
+        },
+        {
+          type: "Input",
+          id: "project_desc",
+          label: "Project Description",
+          placeholder: "Enter details (vertically resizable)...",
+          multiline: true,
+        },
+        {
+          type: "Select",
+          id: "environment",
+          label: "Target Environment",
+          options: [
+            { label: "Development", value: "dev" },
+            { label: "Staging", value: "staging" },
+            { label: "Production", value: "prod" },
+          ],
+          defaultValue: "dev",
+        },
+        {
+          type: "MultiSelect",
+          id: "features",
+          label: "Included Features",
+          placeholder: "Select features to enable...",
+          options: [
+            { label: "Authentication (SSO)", value: "auth" },
+            { label: "Metrics & Telemetry", value: "metrics" },
+            { label: "Auto-backup to Cloud", value: "backup" },
+            { label: "Email Notifications", value: "email" },
+          ],
+          defaultValue: ["auth", "metrics"],
+        },
+        {
+          type: "FilePicker",
+          id: "video_file",
+          label: "Video File (.mp4)",
+          placeholder: "Choose an MP4 video file or enter path...",
+          pickerType: "file",
+          extensions: ["mp4"],
+          required: true,
+        },
+        {
+          type: "FilePicker",
+          id: "output_dir",
+          label: "Output Directory",
+          placeholder: "Choose output folder...",
+          pickerType: "folder",
+        },
+        {
+          type: "Toggle",
+          id: "notify_team",
+          label: "Send notification to team on completion",
+          defaultValue: true,
+        },
+        {
+          type: "Button",
+          label: "Submit Configuration",
+          variant: "primary",
+          action: "submit",
+          message: "Proceed with the submitted configuration.",
+        },
+      ],
+    },
+    null,
+    2,
+  ),
+  "```",
+].join("\n");