@nanhara/hara 0.118.0 → 0.119.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to `@nanhara/hara`.
 > Versioning (pre-1.0, SemVer-style): the **minor** (middle) number bumps for a **new feature**; the
 > **patch** (last) number bumps for **optimizations/fixes of existing features**.
 
+## 0.119.0 — project panels: the chat ↔ live-preview split
+
+- **Plugin panels become project-aware.** A plugin panel can declare `detect` markers (e.g.
+  `.hara/design`, `remotion.config.ts`); `project.panels` returns the panels applicable to a
+  project's cwd. In Hara Desktop, opening a design/video project surfaces a preview toggle right
+  on the conversation — talk to the agent on the left, watch the live preview react on the right.
+  Detect-less panels stay global-only (settings page).
+
 ## 0.118.0 — session delete & fork · slash skills over serve
 
 - **`session.delete`** — permanent removal (codex thread/delete; archive stays the soft path).

package/dist/plugins/plugins.js

@@ -174,6 +174,23 @@ export function uninstallPlugin(name) {
     rmSync(dest, { recursive: true, force: true });
     return true;
 }
+/** Panels applicable to a project cwd — a panel matches when any of its `detect` markers exists under
+ *  the cwd. Pure over the given plugin list (testable); `panelsForProject` binds it to enabled plugins. */
+export function matchPanels(plugins, cwd) {
+    const out = [];
+    for (const pl of plugins) {
+        for (const panel of pl.manifest.panels ?? []) {
+            if (!panel.detect?.length)
+                continue; // global-only panels stay off project surfaces
+            if (panel.detect.some((m) => existsSync(join(cwd, m))))
+                out.push({ plugin: pl.name, panel });
+        }
+    }
+    return out;
+}
+export function panelsForProject(cwd) {
+    return matchPanels(enabledPlugins(), cwd);
+}
 /** Persist a plugin's enabled flag in ~/.hara/config.json (`plugins.enabled[name]`). */
 export function setPluginEnabled(name, on) {
     const p = join(homedir(), ".hara", "config.json");

package/dist/serve/server.js

@@ -20,7 +20,7 @@ import { fuzzyRank } from "../fuzzy.js";
 import { loadAgentsMd } from "../context/agents-md.js";
 import { expandMentions } from "../context/mentions.js";
 import { memoryDigest } from "../memory/store.js";
-import { listInstalled, enabledPlugins, setPluginEnabled } from "../plugins/plugins.js";
+import { listInstalled, enabledPlugins, setPluginEnabled, panelsForProject } from "../plugins/plugins.js";
 import { loadSkillIndex, loadSkillBody } from "../skills/skills.js";
 import { loadJobs, saveJobs, addJob } from "../cron/store.js";
 import { parseSchedule, describeSchedule } from "../cron/schedule.js";
@@ -210,7 +210,7 @@ export async function startServe(opts, deps) {
                     const methods = [
                         "session.list", "session.create", "session.resume", "session.send", "session.interrupt", "session.set-model",
                         "session.rename", "session.archive", "session.compact", "session.rewind", "session.context", "session.delete", "session.fork",
-                        "approval.reply", "plugins.list", "plugins.set", "skills.list", "models.list", "files.search",
+                        "approval.reply", "plugins.list", "plugins.set", "skills.list", "models.list", "files.search", "project.panels",
                         "automation.list", "automation.add", "automation.toggle", "automation.delete",
                     ];
                     return reply(rpcResult(id, { name: "hara", version: deps.version, protocol: PROTOCOL_VERSION, cwd: opts.cwd, provider: deps.providerId, model: deps.model, capabilities: { methods } }));
@@ -399,6 +399,14 @@ export async function startServe(opts, deps) {
                         const cwd = typeof p.cwd === "string" && p.cwd ? p.cwd : opts.cwd;
                         return reply(rpcResult(id, { skills: loadSkillIndex(cwd).map((s) => ({ id: s.id, description: s.description, source: s.source })) }));
                     }
+                    case "project.panels": {
+                        // panels applicable to a project (plugin manifest `detect` markers under the cwd) — powers
+                        // the desktop's chat ↔ live-preview split for design/video projects.
+                        const ps = typeof p.sessionId === "string" ? hub.get(p.sessionId) : undefined;
+                        const pcwd = typeof p.cwd === "string" && p.cwd ? p.cwd : (ps?.meta.cwd ?? opts.cwd);
+                        const panels = panelsForProject(pcwd).map(({ plugin, panel }) => ({ plugin, id: panel.id, title: panel.title, command: panel.command, args: panel.args ?? [], port: panel.port }));
+                        return reply(rpcResult(id, { cwd: pcwd, panels }));
+                    }
                     case "files.search": {
                         // fuzzy file lookup for the composer's @-mention autocomplete (codex fuzzyFileSearch).
                         // Relative POSIX paths; empty query returns the first files as a browse list.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.118.0",
+  "version": "0.119.0",
   "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
     "hara": "dist/index.js"