@homescriptone/opencode-viewer-extender 0.0.0-stage → 1.2.0

package/public/plugins/bulk-select.js

@@ -0,0 +1,95 @@
+// Bulk select plugin: select multiple projects and sessions, then export them
+// as a single .zip of JSON files or delete them (project deletes cascade).
+
+OCV.define({
+  id: "bulk-select",
+  name: "Bulk select · export & delete",
+  description: "Select multiple projects and sessions to export as a .zip or delete.",
+
+  setup(api) {
+    api.registerBulkAction({
+      id: "bulk-export-zip",
+      label: "Export selected (.zip)",
+      async handler({ projectIds, sessionIds, host }) {
+        const entries = [];
+        const seenSessions = new Set();
+        const projectsById = new Map(host.getProjects().map((project) => [project.id, project]));
+
+        const addSession = async (sessionId, folder) => {
+          if (seenSessions.has(sessionId)) return;
+          seenSessions.add(sessionId);
+          const detail = await host.api.getSessionDetail(sessionId);
+          entries.push({ name: `${folder}/${sessionId}.json`, data: JSON.stringify(detail, null, 2) });
+        };
+
+        for (const projectId of projectIds) {
+          const project = projectsById.get(projectId);
+          const folderName = sanitize(`${project?.name || projectId}-${projectId}`);
+          entries.push({
+            name: `projects/${folderName}/project.json`,
+            data: JSON.stringify(project ?? { id: projectId }, null, 2)
+          });
+          const sessions = await host.api.getProjectSessions(projectId);
+          for (const session of sessions) {
+            await addSession(session.id, `projects/${folderName}/sessions`);
+          }
+        }
+
+        for (const sessionId of sessionIds) {
+          await addSession(sessionId, "sessions");
+        }
+
+        entries.push({
+          name: "manifest.json",
+          data: JSON.stringify(
+            { exportedAt: new Date().toISOString(), projectIds, sessionIds, files: entries.length + 1 },
+            null,
+            2
+          )
+        });
+
+        const blob = host.createZip(entries);
+        host.download(`ocv-export-${Date.now()}.zip`, blob, "application/zip");
+        host.notify(`Exported ${entries.length} files.`);
+      }
+    });
+
+    api.registerBulkAction({
+      id: "bulk-delete",
+      label: "Delete selected",
+      danger: true,
+      write: true,
+      async handler({ projectIds, sessionIds, host }) {
+        const parts = [];
+        if (projectIds.length) parts.push(`${projectIds.length} project(s) (and all their sessions)`);
+        if (sessionIds.length) parts.push(`${sessionIds.length} session(s)`);
+        if (!parts.length) return;
+
+        const ok = window.confirm(`Delete ${parts.join(" and ")}? This cannot be undone.`);
+        if (!ok) return;
+
+        let deleted = 0;
+        for (const projectId of projectIds) {
+          await host.api.deleteProject(projectId);
+          deleted += 1;
+        }
+        for (const sessionId of sessionIds) {
+          await host.api.deleteSession(sessionId);
+          deleted += 1;
+        }
+
+        host.clearSelection();
+        host.refresh();
+        host.notify(`Deleted ${deleted} item(s).`);
+      }
+    });
+  }
+});
+
+function sanitize(value) {
+  return String(value ?? "item")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 60) || "item";
+}

package/public/plugins/example.js

@@ -0,0 +1,75 @@
+// Example OCV plugin (API v2).
+// Drop any .js file into public/plugins/ and it is auto-loaded at startup.
+//
+// A plugin calls OCV.define({ id, name, description, setup(api), teardown? }).
+// setup() registers features and returns nothing; every register* call returns
+// an unregister function, and disabled plugins are torn down automatically.
+//
+// api registration hooks:
+//   api.registerPartRenderer(type, renderer)  renderer(part, helpers) -> HTML
+//   api.registerExportFormat({ id, label, extension, mime, build })
+//   api.registerSessionAction({ id, label, handler })
+//   api.registerBulkAction({ id, label, danger?, handler })
+//
+// api.host exposes host data/actions:
+//   host.getProjects(), host.getSessions(), host.getSelection()
+//   host.api.getProjectSessions(id), host.api.getSessionDetail(id)
+//   host.api.deleteProject(id), host.api.deleteSession(id)
+//   host.download(name, content, mime), host.createZip(entries), host.refresh()
+
+OCV.define({
+  id: "example",
+  name: "Example plugin",
+  description: "Demonstrates the plugin hooks: snapshot renderer, text export, copy session ID.",
+
+  setup(api) {
+    // 1. Custom part renderer: surface "snapshot" parts (hidden by default).
+    api.registerPartRenderer("snapshot", function (part, helpers) {
+      const hash = String(part.hash ?? part.snapshot ?? "").slice(0, 12);
+      if (!hash) return "";
+      return `<div class="part part-snapshot"><span class="tiny-muted">snapshot</span> <code>${helpers.escapeHtml(hash)}</code></div>`;
+    });
+
+    // 2. Custom export format: plain text transcript.
+    api.registerExportFormat({
+      id: "example-txt",
+      label: "Plain text (.txt) — example",
+      extension: "txt",
+      mime: "text/plain",
+      build(ctx) {
+        const lines = [];
+        lines.push(ctx.session?.title || "Session");
+        lines.push("");
+        for (const message of ctx.messages ?? []) {
+          if (message._type === "subagent") {
+            lines.push(`[subagent] ${message.title || message.id}`);
+            continue;
+          }
+          lines.push(`## ${message.role || "unknown"}`);
+          for (const part of message.parts ?? []) {
+            if (typeof part.text === "string" && part.text.trim()) lines.push(part.text.trim());
+            else if (part.type === "tool") lines.push(`[tool: ${part.tool ?? "unknown"}]`);
+          }
+          lines.push("");
+        }
+        return lines.join("\n");
+      }
+    });
+
+    // 3. Custom session action: copy the session id.
+    api.registerSessionAction({
+      id: "example-copy-id",
+      label: "Copy session ID",
+      handler(ctx) {
+        if (ctx.session?.id && navigator.clipboard) {
+          navigator.clipboard.writeText(String(ctx.session.id));
+        }
+      }
+    });
+  },
+
+  teardown() {
+    // registrations returned by api.register* are removed automatically;
+    // release any listeners/timers here if needed.
+  }
+});