@joeldmtz/prtl 0.1.2

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+export interface CliIO {
+    write(text: string): void;
+    error(text: string): void;
+    isInteractive: boolean;
+}
+export declare const createProgram: (io?: CliIO) => Command;
+export declare const defaultIO: () => CliIO;
+export declare const runCli: (argv?: string[], io?: CliIO) => Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACxB;AAOD,eAAO,MAAM,aAAa,GAAI,KAAI,KAAmB,KAAG,OA6EvD,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,KAI3B,CAAC;AAEH,eAAO,MAAM,MAAM,GAAU,OAAM,MAAM,EAAiB,EAAE,KAAK,KAAK,KAAG,OAAO,CAAC,IAAI,CAmBpF,CAAC"}

package/dist/cli.js

@@ -0,0 +1,106 @@
+import { deleteTarget, listSessions, openTarget, resolveTarget } from "@joeldmtz/prtl-core";
+import { Command } from "commander";
+import { formatHumanList, formatOperationResult } from "./format.js";
+import { confirm } from "./prompt.js";
+import { renderInteractive } from "./tui/index.js";
+const providerOption = (value) => {
+    if (value === "herdr" || value === "tmux")
+        return value;
+    throw new Error("provider must be herdr or tmux");
+};
+export const createProgram = (io = defaultIO()) => {
+    const program = new Command();
+    program
+        .name("prtl")
+        .description("Portal for Herdr and tmux sessions")
+        .version("0.1.0")
+        .showHelpAfterError()
+        .exitOverride();
+    program
+        .command("interactive")
+        .aliases(["i", "select"])
+        .description("Open the interactive session selector")
+        .action(() => renderInteractive());
+    program
+        .command("list")
+        .alias("ls")
+        .description("List Herdr and tmux sessions")
+        .option("--json", "Output normalized prtl JSON")
+        .option("--provider <provider>", "Filter provider: herdr|tmux", providerOption)
+        .action(async (options) => {
+        const result = await listSessions({ provider: options.provider, timeoutMs: 900 });
+        io.write(options.json ? `${JSON.stringify(result, null, 2)}\n` : formatHumanList(result));
+    });
+    program
+        .command("open <name>")
+        .alias("o")
+        .description("Open a session or pane by name")
+        .option("--provider <provider>", "Filter provider: herdr|tmux", providerOption)
+        .action(async (name, options) => {
+        const listed = await listSessions({ provider: options.provider, timeoutMs: 900 });
+        const resolved = resolveTarget(listed.items, name);
+        if (resolved.type === "ambiguous" && io.isInteractive) {
+            renderInteractive({ items: resolved.matches, query: name });
+            return;
+        }
+        const result = resolved.type === "resolved" ? await openTarget(name, { items: listed.items }) : resolved;
+        io.write(formatOperationResult(result));
+        if (result.type === "not_found" || result.type === "ambiguous" || result.type === "failed")
+            process.exitCode = 1;
+    });
+    program
+        .command("delete <name>")
+        .aliases(["rm", "del"])
+        .description("Delete a session or pane by name")
+        .option("--provider <provider>", "Filter provider: herdr|tmux", providerOption)
+        .option("--yes", "Skip confirmation prompt")
+        .action(async (name, options) => {
+        const listed = await listSessions({ provider: options.provider, timeoutMs: 900 });
+        const resolved = resolveTarget(listed.items, name);
+        if (resolved.type !== "resolved") {
+            io.write(formatOperationResult(resolved));
+            process.exitCode = 1;
+            return;
+        }
+        if (!options.yes) {
+            if (!io.isInteractive) {
+                io.error("Refusing to delete without --yes in noninteractive mode.\n");
+                process.exitCode = 1;
+                return;
+            }
+            const accepted = await confirm(`Delete ${resolved.target.provider} ${resolved.target.id}?`);
+            if (!accepted) {
+                io.write("Delete cancelled.\n");
+                return;
+            }
+        }
+        const result = await deleteTarget(name, { items: listed.items });
+        io.write(formatOperationResult(result));
+        if (result.type === "failed")
+            process.exitCode = 1;
+    });
+    return program;
+};
+export const defaultIO = () => ({
+    write: (text) => process.stdout.write(text),
+    error: (text) => process.stderr.write(text),
+    isInteractive: Boolean(process.stdin.isTTY && process.stdout.isTTY)
+});
+export const runCli = async (argv = process.argv, io) => {
+    if (argv.length <= 2) {
+        renderInteractive();
+        return;
+    }
+    const program = createProgram(io);
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "commander.helpDisplayed") {
+            return;
+        }
+        throw error;
+    }
+};

package/dist/format.d.ts

@@ -0,0 +1,5 @@
+import type { PrtlListResult, PrtlPane, ProviderOperationResult } from "@joeldmtz/prtl-core";
+export declare const describeTarget: (item: PrtlPane) => string;
+export declare const formatHumanList: (result: PrtlListResult) => string;
+export declare const formatOperationResult: (result: ProviderOperationResult) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,uBAAuB,EAExB,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,cAAc,GAAI,MAAM,QAAQ,KAAG,MAW/C,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,cAAc,KAAG,MAuCxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,uBAAuB,KAAG,MAevE,CAAC"}

package/dist/format.js

@@ -0,0 +1,57 @@
+const providerLabel = (item) => item.provider.toUpperCase();
+export const describeTarget = (item) => {
+    const hierarchy = item.provider === "herdr"
+        ? [item.workspace, item.tab, item.name ?? item.id]
+        : [item.session, item.tab, item.name ?? item.id];
+    const context = hierarchy.filter(Boolean).join(" > ");
+    const agent = item.agent?.name
+        ? ` agent=${item.agent.name}${item.agent.status ? `:${item.agent.status}` : ""}`
+        : "";
+    const cwd = item.cwd ? ` cwd=${item.cwd}` : "";
+    return `${providerLabel(item)} ${item.id} ${context}${agent}${cwd}`.trim();
+};
+export const formatHumanList = (result) => {
+    const lines = [];
+    lines.push(`prtl ${result.version} · ${result.items.length} panes · ${result.generatedAt}`);
+    for (const [provider, status] of Object.entries(result.metadata.providers)) {
+        const source = status.source ? ` via ${status.source}` : "";
+        lines.push(`${provider.toUpperCase()}: ${status.available ? "available" : "unavailable"}${source}`);
+    }
+    const grouped = result.items.reduce((groups, item) => {
+        groups[item.provider] ??= [];
+        groups[item.provider].push(item);
+        return groups;
+    }, {});
+    for (const [provider, items] of Object.entries(grouped)) {
+        lines.push("");
+        lines.push(provider.toUpperCase());
+        for (const item of items) {
+            const hierarchy = item.provider === "herdr"
+                ? `${item.workspace ?? "?"} > ${item.tab ?? "?"}`
+                : `${item.session ?? "?"} > ${item.tab ?? "?"}`;
+            const label = item.name ?? item.id;
+            const agent = item.agent?.name
+                ? ` · ${item.agent.name}${item.agent.status ? ` ${item.agent.status}` : ""}`
+                : "";
+            const detail = item.command ?? item.cwd ?? "";
+            lines.push(`  ${item.focused ? "*" : " "} ${item.id}  ${hierarchy} > ${label}${agent}${detail ? ` · ${detail}` : ""}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+};
+export const formatOperationResult = (result) => {
+    switch (result.type) {
+        case "opened":
+            return `Opened ${describeTarget(result.target)}\n`;
+        case "deleted":
+            return `Deleted ${describeTarget(result.target)}\n`;
+        case "failed":
+            return `Failed ${describeTarget(result.target)}: ${result.error}\n`;
+        case "ambiguous":
+            return `Ambiguous target '${result.query}'. Matches:\n${result.matches.map((item) => `  - ${describeTarget(item)}`).join("\n")}\n`;
+        case "not_found":
+            return `No target found for '${result.query}'.\n`;
+        default:
+            return "Unknown operation result.\n";
+    }
+};

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { runCli } from "./cli.js";
+await runCli();

package/dist/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const confirm: (message: string) => Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAO9D,CAAC"}

package/dist/prompt.js

@@ -0,0 +1,8 @@
+export const confirm = async (message) => {
+    process.stdout.write(`${message} [y/N] `);
+    for await (const chunk of process.stdin) {
+        const answer = chunk.toString().trim().toLowerCase();
+        return answer === "y" || answer === "yes";
+    }
+    return false;
+};

package/dist/tui/App.d.ts

@@ -0,0 +1,10 @@
+import { type PrtlPane } from "@joeldmtz/prtl-core";
+import React from "react";
+interface AppProps {
+    initialItems?: PrtlPane[];
+    initialQuery?: string;
+    onOpen?: (item: PrtlPane, items: PrtlPane[]) => Promise<void> | void;
+}
+export declare const App: ({ initialItems, initialQuery, onOpen }: AppProps) => React.ReactElement;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/dist/tui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/tui/App.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAA8B,MAAM,OAAO,CAAC;AAMnD,UAAU,QAAQ;IAChB,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtE;AAgBD,eAAO,MAAM,GAAG,GAAI,wCAA6C,QAAQ,KAAG,KAAK,CAAC,YAyLjF,CAAC"}

package/dist/tui/App.js

@@ -0,0 +1,121 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { deleteTarget, filterItems, listSessions, openTarget } from "@joeldmtz/prtl-core";
+import { useEffect, useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import TextInput from "ink-text-input";
+const truncate = (value, max) => {
+    if (!value)
+        return "";
+    return value.length > max ? `${value.slice(0, Math.max(0, max - 1))}…` : value;
+};
+const statusLine = (result) => {
+    if (!result)
+        return "loading providers";
+    return Object.entries(result.metadata.providers)
+        .map(([provider, status]) => `${provider}:${status.available ? (status.source ?? "ok") : "down"}`)
+        .join("  ");
+};
+export const App = ({ initialItems, initialQuery = "", onOpen }) => {
+    const { exit } = useApp();
+    const columns = process.stdout.columns ?? 80;
+    const rows = process.stdout.rows ?? 24;
+    const [result, setResult] = useState(initialItems
+        ? {
+            version: "0.1.0",
+            generatedAt: new Date().toISOString(),
+            items: initialItems,
+            metadata: { providers: {} }
+        }
+        : undefined);
+    const [query, setQuery] = useState(initialQuery);
+    const [selected, setSelected] = useState(0);
+    const [mode, setMode] = useState("list");
+    const [message, setMessage] = useState();
+    const load = async () => {
+        setMessage(undefined);
+        setResult(await listSessions({ timeoutMs: 900 }));
+        setSelected(0);
+    };
+    useEffect(() => {
+        if (!initialItems)
+            void load();
+    }, []);
+    const items = filterItems(result?.items ?? [], query);
+    const current = items[Math.min(selected, Math.max(0, items.length - 1))];
+    const isWide = columns >= 100;
+    const isNarrow = columns < 70;
+    const visibleRows = Math.max(4, rows - 8);
+    const start = Math.max(0, Math.min(selected - Math.floor(visibleRows / 2), Math.max(0, items.length - visibleRows)));
+    const visibleItems = items.slice(start, start + visibleRows);
+    useInput((input, key) => {
+        if (mode === "search") {
+            if (key.escape || key.return)
+                setMode("list");
+            return;
+        }
+        if (mode === "metadata") {
+            if (key.escape || input === "q" || input === "m")
+                setMode("list");
+            return;
+        }
+        if (mode === "delete") {
+            if (key.escape || input === "n" || input === "q")
+                setMode("list");
+            if (input === "y" && current) {
+                void deleteTarget(current.id, { items }).then((deleted) => {
+                    setMessage(deleted.type === "deleted" ? `Deleted ${current.id}` : deleted.type);
+                    setMode("list");
+                    void load();
+                });
+            }
+            return;
+        }
+        if (input === "q" || key.escape)
+            exit();
+        if (input === "/")
+            setMode("search");
+        if (input === "r")
+            void load();
+        if (input === "m" && current)
+            setMode("metadata");
+        if (input === "d" && current)
+            setMode("delete");
+        if (key.downArrow || input === "j")
+            setSelected((value) => Math.min(items.length - 1, value + 1));
+        if (key.upArrow || input === "k")
+            setSelected((value) => Math.max(0, value - 1));
+        if (key.return && current) {
+            if (onOpen) {
+                void Promise.resolve(onOpen(current, items));
+                return;
+            }
+            void openTarget(current.id, { items }).then((opened) => {
+                if (opened.type === "opened")
+                    exit();
+                else
+                    setMessage(opened.type === "failed" ? opened.error : opened.type);
+            });
+        }
+    });
+    const renderRow = (item, index) => {
+        const absolute = start + index;
+        const hierarchy = item.provider === "herdr"
+            ? `${item.workspace ?? "?"} > ${item.tab ?? "?"}`
+            : `${item.session ?? "?"} > ${item.tab ?? "?"}`;
+        const label = item.name ?? item.id;
+        const agent = item.agent?.name
+            ? `${item.agent.name}${item.agent.status ? ` ${item.agent.status}` : ""}`
+            : item.command;
+        return (_jsxs(Box, { children: [_jsxs(Text, { color: absolute === selected ? "cyan" : undefined, children: [absolute === selected ? "›" : " ", " "] }), _jsxs(Text, { color: item.provider === "herdr" ? "magenta" : "green", children: [item.provider.toUpperCase(), " "] }), _jsxs(Text, { children: [truncate(hierarchy, isNarrow ? 20 : 34), " "] }), _jsxs(Text, { bold: true, children: [truncate(label, isNarrow ? 16 : 22), " "] }), !isNarrow && _jsx(Text, { dimColor: true, children: truncate(agent, 28) })] }, `${item.provider}:${item.id}`));
+    };
+    const detail = current ? (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, width: isWide ? Math.floor(columns * 0.35) : undefined, children: [_jsx(Text, { bold: true, children: "Details" }), _jsxs(Text, { children: ["Provider: ", current.provider] }), _jsxs(Text, { children: ["Source: ", current.metadata.source] }), _jsxs(Text, { children: ["ID: ", current.id] }), _jsxs(Text, { children: ["Name: ", current.name ?? "-"] }), _jsxs(Text, { children: ["CWD: ", truncate(current.cwd, 46) || "-"] }), _jsxs(Text, { children: ["Command: ", current.command ?? "-"] }), _jsxs(Text, { children: ["Agent: ", current.agent?.name ?? "-"] })] })) : null;
+    if (mode === "metadata" && current) {
+        const rawKeys = current.metadata.raw && typeof current.metadata.raw === "object"
+            ? Object.keys(current.metadata.raw).join(", ")
+            : typeof current.metadata.raw;
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: "cyan", children: "prtl metadata" }), _jsxs(Text, { children: ["Provider: ", current.provider] }), _jsxs(Text, { children: ["Source: ", current.metadata.source] }), _jsxs(Text, { children: ["Collected: ", current.metadata.collectedAt] }), _jsxs(Text, { children: ["ID: ", current.id] }), _jsxs(Text, { children: ["Raw: ", truncate(rawKeys, columns - 6)] }), _jsx(Text, { dimColor: true, children: "Esc/q/m back" })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { bold: true, color: "cyan", children: "prtl \u00B7 sessions portal" }), _jsx(Text, { dimColor: true, children: statusLine(result) })] }), _jsxs(Box, { children: [_jsx(Text, { children: "Search: " }), mode === "search" ? (_jsx(TextInput, { value: query, onChange: setQuery })) : (_jsx(Text, { children: query || "-" }))] }), _jsxs(Box, { flexDirection: isWide ? "row" : "column", children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, flexGrow: 1, children: [result ? visibleItems.map(renderRow) : _jsx(Text, { children: "Loading Herdr and tmux\u2026" }), result && items.length === 0 && _jsx(Text, { dimColor: true, children: "No targets match this search." })] }), isWide
+                        ? detail
+                        : current && (_jsx(Text, { dimColor: true, children: truncate(`${current.id} ${current.cwd ?? current.command ?? ""}`, columns - 2) }))] }), mode === "delete" && current && _jsxs(Text, { color: "red", children: ["Delete ", current.id, "? y/N"] }), message && _jsx(Text, { color: "yellow", children: message }), _jsx(Text, { dimColor: true, children: "Enter open \u00B7 d delete \u00B7 m metadata \u00B7 r refresh \u00B7 / search \u00B7 q quit" })] }));
+};

package/dist/tui/index.d.ts

@@ -0,0 +1,6 @@
+import { type PrtlPane } from "@joeldmtz/prtl-core";
+export declare const renderInteractive: (options?: {
+    items?: PrtlPane[];
+    query?: string;
+}) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEhE,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,IAiBpF,CAAC"}

package/dist/tui/index.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { App } from "./App.js";
+import { openTarget } from "@joeldmtz/prtl-core";
+export const renderInteractive = (options) => {
+    let unmount = () => undefined;
+    const instance = render(_jsx(App, { initialItems: options?.items, initialQuery: options?.query, onOpen: async (item, items) => {
+            unmount();
+            const result = await openTarget(item.id, { items });
+            if (result.type === "failed") {
+                process.stderr.write(`${result.error}\n`);
+                process.exitCode = 1;
+            }
+        } }));
+    unmount = () => instance.unmount();
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@joeldmtz/prtl",
+  "version": "0.1.2",
+  "type": "module",
+  "bin": {
+    "prtl": "dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@joeldmtz/prtl-core": "0.1.2",
+    "commander": "latest",
+    "ink": "latest",
+    "ink-text-input": "latest",
+    "react": "latest",
+    "string-width": "latest"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "bun ../../scripts/resolve-workspace.ts",
+    "postpublish": "bun ../../scripts/restore-workspace.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "latest",
+    "ink-testing-library": "latest"
+  }
+}