@iseoane/agent-depot 0.3.0 → 0.4.0

package/dist/src/tui/sources-recipes.js

@@ -0,0 +1,216 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { createAppOperations } from "../app-flow.js";
+import { BUILT_IN_SOURCE } from "../sources.js";
+import { handleCatalogActionKey } from "./catalog-flow.js";
+import { ActionPanel } from "./catalog-panel.js";
+import { hasUnmanagedCopy, isInstalled, loadInstalledSkills } from "./catalog-installs.js";
+import { appName, appStepLines } from "./app-actions.js";
+import { errorText } from "./batch.js";
+import { useMounted } from "./view-state.js";
+import { PreviewConfirm } from "./panel-parts.js";
+import { answerYesNo } from "./mode-keys.js";
+import { rowStyle, theme } from "./theme.js";
+import { computeWindow, pageStep } from "./window.js";
+/**
+ * Returns section focus, key dispatch (true when consumed), the recipe panel,
+ * and the Git list's share of the common height budget. Sources owns key dispatch.
+ */
+export function useSourcesRecipes({ operations, environment, onCapturingChange, height, gitCount, }) {
+    const homeDirectory = environment?.homeDirectory;
+    const appEnvironment = environment?.appEnvironment;
+    const apps = useMemo(() => createAppOperations({
+        homeDirectory,
+        ...appEnvironment,
+    }), [homeDirectory, appEnvironment]);
+    const mounted = useMounted();
+    const [rows, setRows] = useState([]);
+    const [error, setError] = useState();
+    const [loadError, setLoadError] = useState();
+    const [focused, setFocused] = useState(false);
+    // Ref mirrors keep Tab and subsequent keys in a single burst on the same section.
+    const focusRef = useRef(false);
+    const [index, setIndex] = useState(0);
+    const indexRef = useRef(0);
+    const [mode, setModeState] = useState({ kind: "browse" });
+    const modeRef = useRef(mode);
+    const setMode = (next) => {
+        modeRef.current = next;
+        onCapturingChange?.(next.kind !== "browse");
+        setModeState(next);
+    };
+    const finish = async () => {
+        await reload();
+        if (mounted.current)
+            setMode({ kind: "browse" });
+    };
+    const preview = async (entry, status) => {
+        setError(undefined);
+        setMode({ kind: "busy" });
+        try {
+            const steps = await apps.preview(entry);
+            if (mounted.current) {
+                setMode({
+                    kind: "approve",
+                    entry,
+                    lines: [
+                        `File: ${entry.file}`,
+                        `Platform: ${entry.recipe?.platform ?? "all"}`,
+                        `Status: ${status}`,
+                        ...steps.flatMap(step => [step.step, ...appStepLines(step)]),
+                    ],
+                });
+            }
+        }
+        catch (error) {
+            if (mounted.current) {
+                setError(errorText(error));
+                setMode({ kind: "browse" });
+            }
+        }
+    };
+    const flow = {
+        operations,
+        env: environment ?? {},
+        isMounted: () => mounted.current,
+        setAction: action => setMode(action.kind === "browse"
+            ? { kind: "browse" }
+            : { kind: "install", action }),
+        setMessage: message => {
+            if (mounted.current)
+                setError(message?.text);
+        },
+        keepMarked: () => undefined,
+        finish: async (result) => {
+            if (mounted.current) {
+                setError(result.kind === "error" ? result.text : undefined);
+                setMode({ kind: result.kind === "ok" ? "prompt" : "browse" });
+            }
+        },
+    };
+    const startAI = async () => {
+        setMode({ kind: "busy" });
+        try {
+            if (!operations.discoverSkills)
+                throw new Error("Discovery is not supported by the configured operations");
+            const [skills, installed] = await Promise.all([
+                operations.discoverSkills([BUILT_IN_SOURCE.id]),
+                loadInstalledSkills(operations, environment ?? {}),
+            ]);
+            const skill = skills.find(skill => skill.name === "agent-depot-apprecipe");
+            if (!skill)
+                throw new Error("Built-in agent-depot-apprecipe Skill is unavailable");
+            if (!mounted.current)
+                return;
+            if (isInstalled(skill, installed) || hasUnmanagedCopy(skill, installed)) {
+                setMode({ kind: "prompt" });
+            }
+            else {
+                flow.setAction({ kind: "host", skills: [skill], cursor: 0, selected: [] });
+            }
+        }
+        catch (error) {
+            if (mounted.current) {
+                setError(errorText(error));
+                setMode({ kind: "browse" });
+            }
+        }
+    };
+    /** Handles captured modes and browse keys only in the focused section. */
+    const handleKey = (input, key) => {
+        const current = modeRef.current;
+        if (current.kind === "busy")
+            return true;
+        if (current.kind === "install") {
+            // Host/scope/version are selection prompts; version chooses latest or fixed
+            // by number. Only the separate fixed mode accepts free-text version input.
+            // n declines these selections; fixed input and in-flight installs are untouched.
+            const decline = input === "n" && ["host", "scope", "version"].includes(current.action.kind);
+            handleCatalogActionKey(flow, current.action, input, decline ? { ...key, escape: true } : key);
+            return true;
+        }
+        if (current.kind === "guide" || current.kind === "manual" || current.kind === "prompt") {
+            if (key.escape || input === "n")
+                setMode({ kind: "browse" });
+            else if (current.kind === "guide" && input === "1")
+                void startAI();
+            else if (current.kind === "guide" && input === "2")
+                setMode({ kind: "manual" });
+            return true;
+        }
+        if (current.kind === "approve") {
+            answerYesNo(input, key, () => {
+                setMode({ kind: "busy" });
+                void apps.approve(current.entry).then(finish, error => {
+                    if (mounted.current) {
+                        setError(errorText(error));
+                        setMode({ kind: "browse" });
+                    }
+                });
+            }, () => setMode({ kind: "browse" }));
+            return true;
+        }
+        if (key.tab) {
+            setError(undefined);
+            focusRef.current = !focusRef.current;
+            setFocused(focusRef.current);
+            return true;
+        }
+        if (!focusRef.current)
+            return false;
+        if (key.downArrow || input === "j" || key.upArrow || input === "k" || key.pageDown || key.pageUp) {
+            const step = key.pageDown || key.pageUp ? pageStep(recipeHeight) : 1;
+            const down = key.downArrow || input === "j" || key.pageDown;
+            indexRef.current = Math.min(Math.max(indexRef.current + (down ? step : -step), 0), Math.max(rows.length - 1, 0));
+            setIndex(indexRef.current);
+        }
+        else if (input === "n") {
+            setError(undefined);
+            setMode({ kind: "guide" });
+        }
+        else if (input === "r") {
+            void reload();
+        }
+        else if (key.return) {
+            const row = rows[Math.min(indexRef.current, rows.length - 1)];
+            if (row)
+                void preview(row.entry, row.status);
+        }
+        return true;
+    };
+    /** Reloads parsing and approval receipts, never version/latest commands. */
+    const reload = useCallback(async () => {
+        try {
+            const entries = await apps.load();
+            const rows = await Promise.all(entries.map(async (entry) => {
+                const inspection = await apps.approvalStatus(entry);
+                const status = inspection.status === "invalid"
+                    ? `invalid recipe: ${inspection.reason}`
+                    : inspection.status;
+                return { entry, status };
+            }));
+            if (mounted.current) {
+                setRows(rows);
+                setLoadError(undefined);
+            }
+        }
+        catch (error) {
+            if (mounted.current)
+                setLoadError(errorText(error));
+        }
+    }, [apps, mounted]);
+    useEffect(() => { void reload(); }, [reload]);
+    // Give each nonempty section half the rows, then reclaim unused Git capacity.
+    const budget = Math.max(height, gitCount > 0 && rows.length > 0 ? 2 : 1);
+    const gitShare = Math.min(gitCount, Math.max(1, Math.floor(budget / 2)));
+    const recipeHeight = Math.min(rows.length, budget - gitShare);
+    const gitHeight = Math.max(1, budget - recipeHeight);
+    const at = Math.min(index, rows.length - 1);
+    const window = computeWindow(rows.length, at, recipeHeight);
+    const panel = (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { ...rowStyle(focused && rows.length === 0), children: ["App recipes \u00B7 ", apps.directory, " \u00B7 Tab switches section"] }), focused ? _jsx(Text, { color: theme.muted, children: "j/k move \u00B7 Enter preview \u00B7 n add recipe \u00B7 r reload" }) : null, loadError ? _jsxs(Text, { color: theme.error, children: ["Error loading App recipes: ", loadError] }) : null, error ? _jsx(Text, { color: theme.error, children: error }) : null, rows.slice(window.start, window.end).map(({ entry, status }, offset) => {
+                const selected = focused && window.start + offset === at;
+                return (_jsxs(Text, { ...rowStyle(selected), children: [selected ? "> " : "  ", entry.file.split(/[\\/]/u).pop(), " \u00B7 ", status] }, entry.file));
+            }), window.indicator ? _jsx(Text, { color: theme.muted, children: window.indicator }) : null, mode.kind === "guide" ? (_jsxs(Text, { children: ["1 With the AI skill · install if missing, then copy the prompt\n", "2 Manual · write a recipe using the schema\nn or Esc closes"] })) : null, mode.kind === "manual" ? (_jsxs(Text, { children: ["Write a JSON recipe in ", apps.directory, "\n", "Schema: agent-depot app schema \u00B7 n or Esc closes"] })) : null, mode.kind === "prompt" ? (_jsxs(Text, { children: ["Use the agent-depot-apprecipe skill to create the recipe for <app>", "\n", "Recipes: ", apps.directory, " \u00B7 n or Esc closes"] })) : null, mode.kind === "install" ? _jsx(ActionPanel, { mode: mode.action }) : null, mode.kind === "busy" ? _jsx(Text, { children: "Working..." }) : null, mode.kind === "approve" ? (_jsx(PreviewConfirm, { lines: mode.lines, question: `Approve ${appName(mode.entry)}? y/n` })) : null] }));
+    return { focused, handleKey, gitHeight, panel };
+}

package/dist/src/tui/sources-view.js

@@ -5,6 +5,7 @@ import { initialMode, modeReducer } from "./sources-mode.js";
 import { rowStyle, theme } from "./theme.js";
 import { computeWindow, pageStep, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
+import { useSourcesRecipes } from "./sources-recipes.js";
 /** The highlighted index: by stable id while that source exists, otherwise the bounded fallback index. */
 function resolveIndex(sources, selection) {
     const found = sources.findIndex((source) => source.id === selection.id);
@@ -28,8 +29,8 @@ async function refreshEach(operations, targets) {
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }
-export function SourcesView({ operations, onCapturingChange, onOpenCatalog, listHeight }) {
-    const height = useListHeight(listHeight, 7);
+export function SourcesView({ operations, onCapturingChange, onOpenCatalog, listHeight, environment }) {
+    const height = useListHeight(listHeight, 9);
     const [state, setState] = useState({ status: "loading" });
     // The highlight follows the source id; the index is only the fallback once that source is gone.
     // Selection and marks are mirrored in refs updated first, so keys delivered in one burst act on the latest state.
@@ -95,6 +96,9 @@ export function SourcesView({ operations, onCapturingChange, onOpenCatalog, list
     const sourcesRef = useRef(sources);
     sourcesRef.current = sources;
     const selected = resolveIndex(sources, selection);
+    const recipes = useSourcesRecipes({
+        operations, environment, onCapturingChange, height, gitCount: sources.length,
+    });
     const select = (index) => {
         const listed = sourcesRef.current;
         const bounded = Math.min(Math.max(index, 0), Math.max(listed.length - 1, 0));
@@ -201,6 +205,11 @@ export function SourcesView({ operations, onCapturingChange, onOpenCatalog, list
                 dispatch({ type: "done" });
             return;
         }
+        if (recipes.handleKey(input, key)) {
+            if (key.tab)
+                setMessage(undefined);
+            return;
+        }
         const listed = sourcesRef.current;
         const at = resolveIndex(listed, selectionRef.current);
         const highlighted = listed[at];
@@ -211,10 +220,10 @@ export function SourcesView({ operations, onCapturingChange, onOpenCatalog, list
             select(at - 1);
         }
         else if (key.pageDown) {
-            select(at + pageStep(height));
+            select(at + pageStep(recipes.gitHeight));
         }
         else if (key.pageUp) {
-            select(at - pageStep(height));
+            select(at - pageStep(recipes.gitHeight));
         }
         else if (key.return && highlighted) {
             onOpenCatalog?.(highlighted);
@@ -255,11 +264,11 @@ export function SourcesView({ operations, onCapturingChange, onOpenCatalog, list
         return _jsx(Text, { children: "Loading sources..." });
     if (state.status === "error")
         return _jsxs(Text, { color: theme.error, children: ["Error: ", state.message] });
-    const window = computeWindow(sources.length, selected, height);
+    const window = computeWindow(sources.length, selected, recipes.gitHeight);
     return (_jsxs(Box, { flexDirection: "column", children: [builtin ? _jsxs(Text, { color: theme.muted, children: ["    ", builtin.id, " \u00B7 included"] }) : null, sources.length === 0 ? _jsx(Text, { children: "No Git sources \u00B7 n to add" }) : null, sources.length > 0 ? _jsxs(Text, { color: theme.muted, children: ["      ", "ID  KIND  URL"] }) : null, sources.slice(window.start, window.end).map((source, offset) => {
                 const index = window.start + offset;
-                return (_jsxs(Text, { ...rowStyle(index === selected), children: [index === selected ? "> " : "  ", marked.has(source.id) ? "[x] " : "[ ] ", source.id, "  ", source.kind, "  ", source.url] }, source.id));
-            }), window.indicator ? _jsx(Text, { color: theme.muted, children: window.indicator }) : null, selectedCount > 0 ? _jsxs(Text, { children: [selectedCount, " selected"] }) : null, _jsx(Prompt, { mode: mode }), message ? _jsx(Text, { color: message.kind === "error" ? theme.error : theme.success, children: message.text }) : null] }));
+                return (_jsxs(Text, { ...rowStyle(!recipes.focused && index === selected), children: [!recipes.focused && index === selected ? "> " : "  ", marked.has(source.id) ? "[x] " : "[ ] ", source.id, "  ", source.kind, "  ", source.url] }, source.id));
+            }), window.indicator ? _jsx(Text, { color: theme.muted, children: window.indicator }) : null, selectedCount > 0 ? _jsxs(Text, { children: [selectedCount, " selected"] }) : null, recipes.panel, _jsx(Prompt, { mode: mode }), message ? _jsx(Text, { color: message.kind === "error" ? theme.error : theme.success, children: message.text }) : null] }));
 }
 function Prompt({ mode }) {
     if (mode.kind === "input")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iseoane/agent-depot",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A cross-platform catalog for reusable coding-agent skills.",
   "license": "MIT",
   "author": "iseoane",