synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/cli/panels/common.js

@@ -0,0 +1,143 @@
+import { spawn } from "node:child_process";
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Shared pieces of the panel adapters (`cli/panels/*`): run an existing slash handler and keep
+ * its last line as the panel's status, browse a folder, show a file, open a file outside Synorch.
+ * The adapters stay thin: the data and the actions are the text commands' own.
+ */
+/** Runs `handler` with a `print` that collects its lines; resolves the lines. */
+export async function captured(handler) {
+    const lines = [];
+    await handler((printed) => lines.push(...printed));
+    return lines;
+}
+/**
+ * An action result from a text handler's output: its last line becomes the status line (and the
+ * one line the transcript gets, through `note`), the page reloads.
+ */
+export function outcome(lines, note, extra = {}) {
+    const last = [...lines].reverse().find((line) => line.trim() !== "") ?? "done";
+    const failed = /^(no |not |unknown|error|sign-in .* did not)/i.test(last);
+    if (!failed)
+        note?.(last);
+    return { message: last, level: failed ? "warning" : "success", refresh: true, ...extra };
+}
+const GUI_EDITORS = new Set(["code", "code-insiders", "cursor", "codium", "windsurf", "zed", "subl", "sublime_text", "atom", "notepad", "notepad++", "gedit", "kate", "mate", "idea", "webstorm", "fleet", "gvim", "mvim"]);
+/**
+ * Opens a file for the user without leaving the TUI: a graphical `$VISUAL` / `$EDITOR` (VS Code,
+ * Cursor, Zed, Sublime…), else the system's default application. A terminal editor (vim, nano) is
+ * never started here: it would fight the TUI for the terminal. Resolves a line for the status bar.
+ */
+export async function openFile(file, env, platform = process.platform) {
+    const editor = (env.VISUAL ?? env.EDITOR ?? "").trim();
+    const words = editor.split(/\s+/).filter((word) => word !== "" && word !== "--wait" && word !== "-w");
+    const program = words[0];
+    const base = program === undefined ? "" : path.basename(program).replace(/\.(exe|cmd|bat)$/i, "").toLowerCase();
+    if (program !== undefined && GUI_EDITORS.has(base)) {
+        const windows = platform === "win32";
+        const args = [...words.slice(1), windows ? `"${file}"` : file];
+        if (await launch(windows ? `"${program}"` : program, args, windows))
+            return `opened in ${base}: ${file}`;
+    }
+    const system = platform === "win32" ? { command: "rundll32.exe", args: ["url.dll,FileProtocolHandler", file] } : platform === "darwin" ? { command: "open", args: [file] } : { command: "xdg-open", args: [file] };
+    if (env.SSH_CONNECTION === undefined && env.SSH_TTY === undefined && (await launch(system.command, system.args, false)))
+        return `opened ${file}`;
+    return `open it yourself: ${file} (set VISUAL to a graphical editor such as code)`;
+}
+function launch(command, args, shell) {
+    return new Promise((resolve) => {
+        try {
+            const child = spawn(command, [...args], { detached: true, stdio: "ignore", windowsHide: true, shell });
+            child.once("error", () => resolve(false));
+            child.once("spawn", () => {
+                child.unref();
+                resolve(true);
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+const MAX_FILES = 300;
+const SKIP_DIRECTORIES = new Set([".git", "node_modules", "__pycache__", ".venv", "dist"]);
+/** Files under `dir` (relative paths, sorted, at most 300, four levels deep, VCS and dependency folders skipped). */
+export async function listFiles(dir, depth = 4) {
+    const out = [];
+    const walk = async (current, level) => {
+        if (out.length >= MAX_FILES || level > depth)
+            return;
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (out.length >= MAX_FILES)
+                return;
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRECTORIES.has(entry.name))
+                    await walk(full, level + 1);
+            }
+            else if (entry.isFile())
+                out.push(path.relative(dir, full));
+        }
+    };
+    await walk(dir, 0);
+    return out;
+}
+const MAX_SHOWN_BYTES = 256 * 1024;
+/** A file as panel blocks: markdown rendered, other text verbatim, binary and huge files described. */
+export async function fileBlocks(file) {
+    let size = 0;
+    try {
+        size = (await stat(file)).size;
+    }
+    catch (error) {
+        return [{ kind: "text", text: `cannot read ${file}: ${error instanceof Error ? error.message : String(error)}`, tone: "warning" }];
+    }
+    const bytes = await readFile(file).catch(() => undefined);
+    if (bytes === undefined)
+        return [{ kind: "text", text: `cannot read ${file}`, tone: "warning" }];
+    const head = bytes.subarray(0, MAX_SHOWN_BYTES);
+    if (head.includes(0))
+        return [{ kind: "fields", rows: [{ label: "file", value: file }, { label: "size", value: `${size} bytes` }] }, { kind: "text", text: "binary file: press o to open it", tone: "muted" }];
+    const text = head.toString("utf8");
+    const blocks = [/\.(md|markdown|mdx)$/i.test(file) ? { kind: "markdown", text } : { kind: "code", text }];
+    if (size > MAX_SHOWN_BYTES)
+        blocks.push({ kind: "text", text: `… showing the first ${MAX_SHOWN_BYTES / 1024} KB of ${Math.round(size / 1024)} KB`, tone: "muted" });
+    return blocks;
+}
+/** A file's page with `o` to open it outside. */
+export function filePage(file, crumb, env) {
+    return async () => ({
+        title: crumb,
+        crumb,
+        subtitle: file,
+        views: [{ kind: "document", label: crumb, blocks: await fileBlocks(file) }],
+        actions: [{ key: "o", label: "open file", run: async () => ({ message: await openFile(file, env) }) }],
+    });
+}
+/** The items of a folder listing, each opening its file page. */
+export async function folderItems(dir, env) {
+    const files = await listFiles(dir);
+    return files.map((relative) => {
+        const full = path.join(dir, relative);
+        return {
+            id: relative,
+            label: relative.split(path.sep).join("/"),
+            open: filePage(full, path.basename(relative), env),
+            actions: [{ key: "o", label: "open file", run: async () => ({ message: await openFile(full, env) }) }],
+        };
+    });
+}
+/** `12 items` / `1 item`. */
+export function plural(count, word, many = `${word}s`) {
+    return `${count} ${count === 1 ? word : many}`;
+}
+//# sourceMappingURL=common.js.map

package/dist/harness/cli/panels/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/harness/cli/panels/common.ts"],"names":[],"mappings":"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"}

package/dist/harness/cli/panels/mcp.d.ts

@@ -0,0 +1,18 @@
+import type { PanelBadge, PanelItem, PanelPage } from "../../contracts/index.ts";
+import type { McpServerStatus } from "../../mcp/index.ts";
+import { type McpSlashHost } from "../mcp-command.ts";
+/**
+ * `/mcp` as a panel: servers (by where they are declared) → a server's page (state, transport,
+ * trust, the log tail, its tools) → a tool (description and input schema). Reconnect, enable,
+ * disable, sign in / out and approve run the `/mcp` sub-commands.
+ */
+export interface McpPanelHost extends McpSlashHost {
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+export declare function mcpBadge(state: McpServerStatus["state"]): PanelBadge;
+/** One server: overview with the log tail, then its tools. */
+export declare function mcpServerPage(host: McpPanelHost, entry: McpServerStatus): Promise<PanelPage>;
+export declare function mcpServerItem(host: McpPanelHost, entry: McpServerStatus): PanelItem;
+/** The `/mcp` root page. */
+export declare function mcpPanel(host: McpPanelHost): PanelPage;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/harness/cli/panels/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../../src/harness/cli/panels/mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAc,SAAS,EAAE,SAAS,EAAa,MAAM,0BAA0B,CAAC;AAErH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnE;;;;GAIG;AAEH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,UAAU,CAiBpE;AA6CD,8DAA8D;AAC9D,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAiClG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,SAAS,CAWnF;AAED,4BAA4B;AAC5B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAatD"}

package/dist/harness/cli/panels/mcp.js

@@ -0,0 +1,132 @@
+import { open } from "node:fs/promises";
+import { documentPage, groupedViews } from "../../contracts/index.js";
+import { runMcpSlash } from "../mcp-command.js";
+import { captured, openFile, outcome, plural } from "./common.js";
+export function mcpBadge(state) {
+    switch (state) {
+        case "connected":
+            return { label: "connected", tone: "success" };
+        case "idle":
+            return { label: "ready", tone: "muted" };
+        case "starting":
+            return { label: "starting", tone: "accent" };
+        case "failed":
+            return { label: "failed", tone: "error" };
+        case "disabled":
+            return { label: "off", tone: "muted" };
+        case "needs-approval":
+            return { label: "needs trust", tone: "warning" };
+        case "needs-auth":
+            return { label: "needs sign-in", tone: "warning" };
+    }
+}
+const LOG_TAIL_BYTES = 8 * 1024;
+async function logTail(file) {
+    let handle;
+    try {
+        handle = await open(file, "r");
+        const size = (await handle.stat()).size;
+        const length = Math.min(size, LOG_TAIL_BYTES);
+        const buffer = Buffer.alloc(length);
+        await handle.read(buffer, 0, length, size - length);
+        const lines = buffer.toString("utf8").split(/\r?\n/);
+        if (size > length)
+            lines.shift();
+        return lines.slice(-40).join("\n").trimEnd();
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+function serverActions(host, entry) {
+    const run = async (verb) => outcome(await captured((print) => runMcpSlash({ ...host, print }, `${verb} ${entry.name}`)), (line) => host.print([line]));
+    const actions = [];
+    if (entry.state === "needs-approval")
+        actions.push({ key: "a", label: "approve", confirm: `Run the repository's MCP server ${entry.name} here?`, run: () => run("approve") });
+    if (entry.state === "needs-auth")
+        actions.push({ key: "l", label: "sign in", run: () => run("login") });
+    if (entry.state !== "disabled" && entry.state !== "needs-approval")
+        actions.push({ key: "r", label: "reconnect", run: () => run("reconnect") });
+    actions.push(entry.state === "disabled" ? { key: "e", label: "enable", run: () => run("enable") } : { key: "d", label: "disable", run: () => run("disable") });
+    if (entry.transport !== "stdio")
+        actions.push({ key: "x", label: "sign out", run: () => run("logout") });
+    actions.push({ key: "o", label: "open log", run: async () => ({ message: await openFile(entry.logFile, host.env) }) });
+    return actions;
+}
+function toolPage(server, tool) {
+    const blocks = [
+        { kind: "fields", rows: [{ label: "tool", value: tool.name }, { label: "server", value: server }, { label: "model sees", value: `mcp__${server}__${tool.name}` }] },
+        { kind: "markdown", text: tool.description === undefined || tool.description.trim() === "" ? "_no description_" : tool.description },
+        { kind: "heading", text: "Input schema" },
+        { kind: "code", text: JSON.stringify(tool.inputSchema, null, 2) ?? "{}" },
+    ];
+    if (tool.annotations !== undefined && Object.keys(tool.annotations).length > 0)
+        blocks.push({ kind: "heading", text: "Annotations" }, { kind: "code", text: JSON.stringify(tool.annotations, null, 2) ?? "" });
+    return documentPage(tool.name, blocks);
+}
+/** One server: overview with the log tail, then its tools. */
+export async function mcpServerPage(host, entry) {
+    const rows = [
+        { label: "state", value: mcpBadge(entry.state).label, tone: mcpBadge(entry.state).tone },
+        { label: "declared", value: `${entry.source} (${entry.file})` },
+        { label: "runs", value: `${entry.transport} ${entry.target}` },
+        { label: "trust", value: entry.trust === "read-only" ? "read-only: tools only read, they never prompt" : "full: tools may change things (ask mode prompts)" },
+        { label: "startup", value: entry.startup === "session" ? "with every session" : "lazy: at first use" },
+        ...(entry.error === undefined ? [] : [{ label: "problem", value: entry.error, tone: "error" }]),
+        ...(entry.detail === undefined || entry.detail === entry.error ? [] : [{ label: "details", value: entry.detail.slice(0, 2000) }]),
+        ...(entry.missingVariables.length === 0 ? [] : [{ label: "unset", value: entry.missingVariables.join(", "), tone: "warning" }]),
+        { label: "log", value: entry.logFile },
+    ];
+    const tail = await logTail(entry.logFile);
+    const blocks = [{ kind: "fields", rows }, { kind: "heading", text: "Log (latest lines)" }, tail === undefined || tail === "" ? { kind: "text", text: "no log yet", tone: "muted" } : { kind: "code", text: tail }];
+    const infos = host.manager.serverTools(entry.name);
+    const tools = infos.length > 0
+        ? infos.map((tool) => ({ id: tool.name, label: tool.name, ...(tool.description === undefined ? {} : { description: tool.description }), open: () => toolPage(entry.name, tool) }))
+        : entry.tools.map((name) => ({ id: name, label: name, description: "connect the server to see its description and schema", open: () => documentPage(name, [{ kind: "text", text: `${name}: the server is not connected; press r to reconnect for its description and schema.`, tone: "muted" }]) }));
+    const views = [
+        { kind: "document", label: "Overview", blocks },
+        { kind: "list", label: "Tools", items: tools, empty: entry.state === "connected" ? "the server lists no tools" : "no tools known yet: the server starts at first use (r reconnects now)" },
+    ];
+    return {
+        title: entry.name,
+        subtitle: `${entry.transport} ${host.sep} ${entry.source} ${host.sep} ${plural(entry.tools.length, "tool")}`,
+        views,
+        actions: serverActions(host, entry),
+        reload: async () => {
+            const fresh = host.manager.status().find((candidate) => candidate.name === entry.name);
+            return fresh === undefined ? documentPage(entry.name, [{ kind: "text", text: "no longer configured", tone: "muted" }]) : mcpServerPage(host, fresh);
+        },
+    };
+}
+export function mcpServerItem(host, entry) {
+    return {
+        id: entry.name,
+        label: entry.name,
+        meta: entry.transport,
+        badges: [mcpBadge(entry.state)],
+        description: entry.state === "failed" && entry.error !== undefined ? entry.error : `${entry.tools.length > 0 ? `${plural(entry.tools.length, "tool")} ${host.sep} ` : ""}${entry.target}`,
+        search: entry.source,
+        open: () => mcpServerPage(host, entry),
+        actions: serverActions(host, entry),
+    };
+}
+/** The `/mcp` root page. */
+export function mcpPanel(host) {
+    const status = host.manager.status();
+    const problems = host.manager.problems;
+    const views = groupedViews(status, (entry) => mcpServerItem(host, entry), (entry) => (entry.source === "mcp.json" ? "project" : entry.source === "claude-plugin" ? "plugin" : entry.source), [["user", "User"], ["project", "Project"], ["plugin", "Plugins"]], { empty: "No MCP servers configured. Add one: syn mcp add playwright -- npx @playwright/mcp@latest" });
+    if (problems.length > 0)
+        views.push({ kind: "document", label: `Problems ${problems.length}`, blocks: [{ kind: "text", text: problems.map((problem) => `${problem.file}: ${problem.message}`).join("\n"), tone: "warning" }] });
+    const connected = status.filter((entry) => entry.state === "connected").length;
+    return {
+        title: "MCP servers",
+        crumb: "MCP",
+        subtitle: `${plural(status.length, "server")} ${host.sep} ${connected} connected ${host.sep} tools reach the model as mcp__<server>__<tool>`,
+        views,
+        reload: () => mcpPanel(host),
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/harness/cli/panels/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../../src/harness/cli/panels/mcp.ts"],"names":[],"mappings":"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"}

package/dist/harness/cli/panels/plugins.d.ts

@@ -0,0 +1,8 @@
+import type { PanelPage } from "../../contracts/index.ts";
+import { type ExtensionSlashHost } from "../extensions-command.ts";
+import type { PluginEntry } from "../extensions/index.ts";
+/** One plugin: manifest, then a tab per kind of content. */
+export declare function pluginPage(host: ExtensionSlashHost, plugin: PluginEntry): PanelPage;
+/** The `/plugins` root page. */
+export declare function pluginsPanel(host: ExtensionSlashHost): PanelPage;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/harness/cli/panels/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../src/harness/cli/panels/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkD,SAAS,EAAa,MAAM,0BAA0B,CAAC;AAErH,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAyC1D,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CA+CnF;AAED,gCAAgC;AAChC,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAkBhE"}

package/dist/harness/cli/panels/plugins.js

@@ -0,0 +1,114 @@
+import { documentPage, groupedViews } from "../../contracts/index.js";
+import { runPluginsSlash } from "../extensions-command.js";
+import { captured, openFile, outcome, plural } from "./common.js";
+import { skillItem } from "./skills.js";
+/**
+ * `/plugins` as a panel: plugins (Synorch and Claude Code) → a plugin's page (manifest, then its
+ * skills, commands, MCP servers, agents and hooks as tabs, each drillable) → the item. Install,
+ * enable, disable and remove run the `/plugins` sub-commands.
+ */
+function pluginBadges(plugin) {
+    if (plugin.enabled)
+        return [{ label: "on", tone: "success" }];
+    if (plugin.shadowed)
+        return [{ label: "shadowed", tone: "muted" }];
+    return [{ label: plugin.offReason === "claude" ? "off in Claude" : "off", tone: "muted" }];
+}
+function stateText(plugin) {
+    return plugin.enabled ? "on" : plugin.shadowed ? "shadowed by the Synorch plugin of the same name" : plugin.offReason === "claude" ? "disabled in Claude Code" : "off in Synorch";
+}
+function pluginActions(host, plugin) {
+    const run = async (argument, back = false) => outcome(await captured((print) => runPluginsSlash({ ...host, print }, argument)), (line) => host.print([line]), back ? { back: true } : {});
+    const actions = [plugin.enabled ? { key: "d", label: "disable", run: () => run(`disable ${plugin.key}`) } : { key: "e", label: "enable", run: () => run(`enable ${plugin.key}`) }];
+    if (plugin.origin === "synorch")
+        actions.push({ key: "x", label: "remove", confirm: `Remove the plugin ${plugin.key}? Its files are deleted.`, run: () => run(`remove ${plugin.key}`, true) });
+    actions.push({ key: "o", label: "open folder", run: async () => ({ message: await openFile(plugin.contents.root, host.env) }) });
+    return actions;
+}
+function installAction(host) {
+    return {
+        key: "i",
+        label: "install",
+        input: { prompt: "Plugin to install (path, git URL or name@marketplace)" },
+        run: async (spec) => outcome(await captured((print) => runPluginsSlash({ ...host, print }, `install ${spec ?? ""}`)), (line) => host.print([line])),
+    };
+}
+function rawItem(id, label, blocks, description) {
+    return { id, label, ...(description === undefined ? {} : { description }), open: () => documentPage(label, blocks) };
+}
+/** One plugin: manifest, then a tab per kind of content. */
+export function pluginPage(host, plugin) {
+    const contents = plugin.contents;
+    const statuses = host.extensions.statuses();
+    const statusOf = (name, kind) => statuses.find((status) => status.item.kind === kind && status.item.name === `${contents.name}:${name}` && status.item.plugin === plugin.key);
+    const manifest = [
+        {
+            kind: "fields",
+            rows: [
+                { label: "plugin", value: plugin.key },
+                { label: "state", value: stateText(plugin), tone: plugin.enabled ? "success" : "muted" },
+                { label: "origin", value: plugin.origin === "claude" ? "Claude Code (read in place, never changed)" : "Synorch" },
+                ...(contents.version === undefined ? [] : [{ label: "version", value: contents.version }]),
+                { label: "from", value: plugin.detail },
+                { label: "folder", value: contents.root },
+                { label: "description", value: contents.description === "" ? "(none)" : contents.description },
+                { label: "contains", value: [plural(contents.skills.length, "skill"), plural(contents.commands.length, "command"), plural(Object.keys(contents.mcpServers).length, "MCP server"), plural(contents.agents.length, "agent"), plural(contents.hooks.length, "hook")].join(", ") },
+            ],
+        },
+    ];
+    if (contents.problems.length > 0)
+        manifest.push({ kind: "text", text: contents.problems.map((problem) => `warning: ${problem}`).join("\n"), tone: "warning" });
+    const views = [{ kind: "document", label: "Manifest", blocks: manifest }];
+    const skills = contents.skills.map((skill) => {
+        const status = statusOf(skill.name, "skill");
+        return status === undefined ? rawItem(`skill:${skill.name}`, skill.name, [{ kind: "fields", rows: [{ label: "file", value: skill.file }, { label: "description", value: skill.meta.description }] }], skill.meta.description) : skillItem(host, status);
+    });
+    const commands = contents.commands.map((command) => {
+        const status = statusOf(command.name, "command");
+        return status === undefined ? rawItem(`command:${command.name}`, `/${contents.name}:${command.name}`, [{ kind: "fields", rows: [{ label: "file", value: command.file ?? "(inline)" }, { label: "description", value: command.meta.description }] }], command.meta.description) : skillItem(host, status);
+    });
+    const servers = Object.entries(contents.mcpServers).map(([name, entry]) => rawItem(`mcp:${name}`, name, [{ kind: "fields", rows: [{ label: "server", value: name }, { label: "runs as", value: plugin.enabled ? "a plugin server (/mcp shows its state and tools)" : "nothing: the plugin is off" }] }, { kind: "heading", text: "Definition" }, { kind: "code", text: JSON.stringify(entry, null, 2) ?? "" }]));
+    const agents = contents.agents.map((name) => rawItem(`agent:${name}`, name, [{ kind: "fields", rows: [{ label: "agent", value: name }, { label: "support", value: "listed only; Synorch does not run plugin agents yet" }] }]));
+    const hooks = contents.hooks.map((name) => rawItem(`hook:${name}`, name, [{ kind: "fields", rows: [{ label: "hook", value: name }, { label: "support", value: "listed only; plugin hooks never run" }] }]));
+    if (skills.length > 0)
+        views.push({ kind: "list", label: "Skills", items: skills });
+    if (commands.length > 0)
+        views.push({ kind: "list", label: "Commands", items: commands });
+    if (servers.length > 0)
+        views.push({ kind: "list", label: "MCP servers", items: servers });
+    if (agents.length > 0)
+        views.push({ kind: "list", label: "Agents", items: agents });
+    if (hooks.length > 0)
+        views.push({ kind: "list", label: "Hooks", items: hooks });
+    return {
+        title: plugin.key,
+        subtitle: `${plugin.origin} ${host.sep} ${stateText(plugin)}${contents.version === undefined ? "" : ` ${host.sep} ${contents.version}`}`,
+        views,
+        actions: pluginActions(host, plugin),
+        reload: () => {
+            const fresh = host.extensions.state().plugins.find((candidate) => candidate.key === plugin.key);
+            return fresh === undefined ? documentPage(plugin.key, [{ kind: "text", text: "no longer installed", tone: "muted" }]) : pluginPage(host, fresh);
+        },
+    };
+}
+/** The `/plugins` root page. */
+export function pluginsPanel(host) {
+    const plugins = host.extensions.state().plugins;
+    const item = (plugin) => ({
+        id: plugin.key,
+        label: plugin.key,
+        ...(plugin.contents.version === undefined ? {} : { meta: plugin.contents.version }),
+        badges: pluginBadges(plugin),
+        description: plugin.contents.description === "" ? `${plural(plugin.contents.skills.length, "skill")}, ${plural(plugin.contents.commands.length, "command")}` : plugin.contents.description,
+        open: () => pluginPage(host, plugin),
+        actions: pluginActions(host, plugin),
+    });
+    return {
+        title: "Plugins",
+        subtitle: `${plural(plugins.length, "plugin")} ${host.sep} ${plugins.filter((plugin) => plugin.enabled).length} on ${host.sep} Claude Code plugin format`,
+        views: groupedViews(plugins, item, (plugin) => plugin.origin, [["synorch", "Synorch"], ["claude", "Claude"]], { empty: "No plugins yet: press i to install one (path, git URL or name@marketplace)" }),
+        actions: [installAction(host)],
+        reload: () => pluginsPanel(host),
+    };
+}
+//# sourceMappingURL=plugins.js.map

package/dist/harness/cli/panels/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../../src/harness/cli/panels/plugins.ts"],"names":[],"mappings":"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"}

package/dist/harness/cli/panels/session.d.ts

@@ -0,0 +1,54 @@
+import type { PanelBlock, PanelField, PanelPage } from "../../contracts/index.ts";
+import type { HarnessView, OrchestrationView } from "../../contracts/views.ts";
+import type { SettingRow } from "../config-command.ts";
+import { type MemoryDeskHost } from "../memory-desk.ts";
+import type { SlashCommand } from "../slash-commands.ts";
+import { type McpPanelHost } from "./mcp.ts";
+/**
+ * Panels of the session commands: `/help`, `/status`, `/config`, `/resume`, `/runs`, `/memory`,
+ * `/usage` and `/context`. Each takes the data its text form already builds, so the text and the
+ * panel never disagree; the conversation passes the data in.
+ */
+export interface InvocableEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly argsHint: string | undefined;
+    readonly source: string;
+}
+export declare function helpPanel(commands: readonly SlashCommand[], invocable: readonly InvocableEntry[], keys: string, sep: string): PanelPage;
+/** `Label           value` report lines (continuations indented) as fields. */
+export declare function reportFields(lines: readonly string[], column?: number): PanelField[];
+export declare function statusPanel(lines: readonly string[], mcp: McpPanelHost | undefined, sep: string): PanelPage;
+export interface ConfigPanelHost {
+    readonly sep: string;
+    /** The settings now (undefined when the user configuration cannot be read). */
+    rows(): Promise<{
+        readonly rows: readonly SettingRow[];
+        readonly userFile: string;
+    } | undefined>;
+    /** Picks a new value with the choice modal and saves it; the line it printed. */
+    edit(row: SettingRow): Promise<string | undefined>;
+}
+export declare function configPanel(host: ConfigPanelHost): Promise<PanelPage>;
+export interface ResumeEntry {
+    readonly sessionId: string;
+    readonly title: string;
+    readonly when: string;
+    readonly forkOf: string | undefined;
+}
+export declare function resumePanel(entries: readonly ResumeEntry[], sep: string): PanelPage;
+export interface RunEntry {
+    readonly id: string;
+    readonly goal: string;
+    readonly status: string;
+    readonly running: boolean;
+    view(): OrchestrationView;
+    /** The run's status report (`/runs <id>`). */
+    report(): string;
+    cancel(): void;
+}
+export declare function runsPanel(runs: () => readonly RunEntry[], sep: string): PanelPage;
+export declare function memoryPanel(host: MemoryDeskHost): Promise<PanelPage>;
+/** A harness card (usage, context) as a one-page panel, with extra text blocks under it. */
+export declare function cardPanel(title: string, view: HarnessView, extra?: readonly PanelBlock[], reload?: () => Promise<PanelPage>): PanelPage;
+//# sourceMappingURL=session.d.ts.map

package/dist/harness/cli/panels/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/harness/cli/panels/session.ts"],"names":[],"mappings":"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"}