byterover-cli 1.7.2 → 2.0.0

package/dist/tui/features/curate/api/create-curate-task.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Curate Task API
+ *
+ * Creates a curate task via transport. The task execution happens on the server,
+ * and progress/completion events are received via task:* events.
+ */
+export interface CreateCurateTaskDTO {
+    content?: string;
+    files?: string[];
+    folders?: string[];
+}
+export interface CreateCurateTaskResult {
+    taskId: string;
+}
+/**
+ * Create a curate task via transport.
+ * Returns immediately after task is acknowledged - actual execution is async.
+ *
+ * When folders are provided, sends as 'curate-folder' task type which
+ * triggers the FolderPackExecutor on the server for full directory analysis.
+ */
+export declare const createCurateTask: ({ content, files, folders }: CreateCurateTaskDTO) => Promise<CreateCurateTaskResult>;

package/dist/tui/features/curate/api/create-curate-task.js

@@ -0,0 +1,40 @@
+/**
+ * Curate Task API
+ *
+ * Creates a curate task via transport. The task execution happens on the server,
+ * and progress/completion events are received via task:* events.
+ */
+import { randomUUID } from 'node:crypto';
+import { TaskEvents } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+/**
+ * Create a curate task via transport.
+ * Returns immediately after task is acknowledged - actual execution is async.
+ *
+ * When folders are provided, sends as 'curate-folder' task type which
+ * triggers the FolderPackExecutor on the server for full directory analysis.
+ */
+export const createCurateTask = async ({ content, files, folders }) => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient) {
+        throw new Error('Not connected to server');
+    }
+    const taskId = randomUUID();
+    const hasFolder = Boolean(folders?.length);
+    const taskType = hasFolder ? 'curate-folder' : 'curate';
+    // Provide default context for folder curation when none is provided
+    const resolvedContent = content?.trim()
+        ? content
+        : hasFolder
+            ? 'Analyze this folder and extract all relevant knowledge, patterns, and documentation.'
+            : '';
+    await apiClient.request(TaskEvents.CREATE, {
+        clientCwd: process.cwd(),
+        content: resolvedContent,
+        ...(hasFolder && folders ? { folderPath: folders[0] } : {}),
+        ...(!hasFolder && files && files.length > 0 ? { files } : {}),
+        taskId,
+        type: taskType,
+    });
+    return { taskId };
+};

package/dist/tui/features/curate/components/curate-flow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CurateFlow Component
+ *
+ * Creates a curate task via transport. Output is rendered
+ * by useActivityLogs via the task event pipeline, not by this component.
+ */
+import React from 'react';
+import type { CustomDialogCallbacks } from '../../../types/commands.js';
+interface CurateFlowProps extends CustomDialogCallbacks {
+    context?: string;
+    files?: string[];
+    flags?: {
+        apiKey?: string;
+        model?: string;
+        verbose?: boolean;
+    };
+    folders?: string[];
+}
+export declare function CurateFlow({ context, files, folders, onComplete }: CurateFlowProps): React.ReactNode;
+export {};

package/dist/tui/features/curate/components/curate-flow.js

@@ -0,0 +1,41 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * CurateFlow Component
+ *
+ * Creates a curate task via transport. Output is rendered
+ * by useActivityLogs via the task event pipeline, not by this component.
+ */
+import { Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { useEffect, useState } from 'react';
+import { formatTransportError } from '../../../utils/error-messages.js';
+import { createCurateTask } from '../api/create-curate-task.js';
+export function CurateFlow({ context, files, folders, onComplete }) {
+    const [running, setRunning] = useState(true);
+    const [error, setError] = useState();
+    useEffect(() => {
+        createCurateTask({
+            content: context,
+            files: files && files.length > 0 ? files : undefined,
+            folders: folders && folders.length > 0 ? folders : undefined,
+        })
+            .then(() => {
+            setRunning(false);
+            // Task is queued - completion will come via task:completed event
+            onComplete('');
+        })
+            .catch((error_) => {
+            const message = error_ instanceof Error ? formatTransportError(error_) : String(error_);
+            setRunning(false);
+            setError(message);
+            onComplete(`Curate failed: ${message}`);
+        });
+    }, []);
+    if (error) {
+        return _jsxs(Text, { color: "red", children: ["Error: ", error] });
+    }
+    if (running) {
+        return (_jsxs(Text, { children: [_jsx(Spinner, { type: "dots" }), " Curating..."] }));
+    }
+    return null;
+}

package/dist/tui/features/hub/api/add-hub-registry.d.ts

@@ -0,0 +1,15 @@
+import type { MutationConfig } from '../../../lib/react-query.js';
+import { type HubRegistryAddResponse } from '../../../../shared/transport/events/index.js';
+export type AddHubRegistryDTO = {
+    authScheme?: string;
+    headerName?: string;
+    name: string;
+    token?: string;
+    url: string;
+};
+export declare const addHubRegistry: ({ authScheme, headerName, name, token, url }: AddHubRegistryDTO) => Promise<HubRegistryAddResponse>;
+type UseAddHubRegistryOptions = {
+    mutationConfig?: MutationConfig<typeof addHubRegistry>;
+};
+export declare const useAddHubRegistry: ({ mutationConfig }?: UseAddHubRegistryOptions) => import("@tanstack/react-query").UseMutationResult<HubRegistryAddResponse, Error, AddHubRegistryDTO, unknown>;
+export {};

package/dist/tui/features/hub/api/add-hub-registry.js

@@ -0,0 +1,30 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { HubEvents, } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { getHubEntriesQueryOptions } from './get-hub-entries.js';
+import { getHubRegistriesQueryOptions } from './list-hub-registries.js';
+export const addHubRegistry = ({ authScheme, headerName, name, token, url }) => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(HubEvents.REGISTRY_ADD, {
+        authScheme: authScheme,
+        headerName,
+        name,
+        token,
+        url,
+    });
+};
+export const useAddHubRegistry = ({ mutationConfig } = {}) => {
+    const queryClient = useQueryClient();
+    const { onSuccess, ...restConfig } = mutationConfig ?? {};
+    return useMutation({
+        onSuccess(...args) {
+            queryClient.invalidateQueries({ queryKey: getHubRegistriesQueryOptions().queryKey });
+            queryClient.invalidateQueries({ queryKey: getHubEntriesQueryOptions().queryKey });
+            onSuccess?.(...args);
+        },
+        ...restConfig,
+        mutationFn: addHubRegistry,
+    });
+};

package/dist/tui/features/hub/api/get-hub-entries.d.ts

@@ -0,0 +1,16 @@
+import type { QueryConfig } from '../../../lib/react-query.js';
+import { type HubListResponse } from '../../../../shared/transport/events/index.js';
+export declare const getHubEntries: () => Promise<HubListResponse>;
+export declare const getHubEntriesQueryOptions: () => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<HubListResponse, Error, HubListResponse, string[]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<HubListResponse, string[], never> | undefined;
+} & {
+    queryKey: string[] & {
+        [dataTagSymbol]: HubListResponse;
+        [dataTagErrorSymbol]: Error;
+    };
+};
+type UseGetHubEntriesOptions = {
+    queryConfig?: QueryConfig<typeof getHubEntriesQueryOptions>;
+};
+export declare const useGetHubEntries: ({ queryConfig }?: UseGetHubEntriesOptions) => import("@tanstack/react-query").UseQueryResult<HubListResponse, Error>;
+export {};

package/dist/tui/features/hub/api/get-hub-entries.js

@@ -0,0 +1,17 @@
+import { queryOptions, useQuery } from '@tanstack/react-query';
+import { HubEvents } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+export const getHubEntries = () => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(HubEvents.LIST, undefined, { timeout: 60_000 });
+};
+export const getHubEntriesQueryOptions = () => queryOptions({
+    queryFn: getHubEntries,
+    queryKey: ['hub', 'list'],
+});
+export const useGetHubEntries = ({ queryConfig } = {}) => useQuery({
+    ...getHubEntriesQueryOptions(),
+    ...queryConfig,
+});

package/dist/tui/features/hub/api/install-hub-entry.d.ts

@@ -0,0 +1,14 @@
+import type { MutationConfig } from '../../../lib/react-query.js';
+import { type HubInstallResponse } from '../../../../shared/transport/events/index.js';
+export type InstallHubEntryDTO = {
+    agent?: string;
+    entryId: string;
+    registry?: string;
+    scope?: 'global' | 'project';
+};
+export declare const installHubEntry: ({ agent, entryId, registry, scope }: InstallHubEntryDTO) => Promise<HubInstallResponse>;
+type UseInstallHubEntryOptions = {
+    mutationConfig?: MutationConfig<typeof installHubEntry>;
+};
+export declare const useInstallHubEntry: ({ mutationConfig }?: UseInstallHubEntryOptions) => import("@tanstack/react-query").UseMutationResult<HubInstallResponse, Error, InstallHubEntryDTO, unknown>;
+export {};

package/dist/tui/features/hub/api/install-hub-entry.js

@@ -0,0 +1,24 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { HubEvents } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { getHubEntriesQueryOptions } from './get-hub-entries.js';
+export const installHubEntry = ({ agent, entryId, registry, scope }) => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(HubEvents.INSTALL, { agent, entryId, registry, scope }, { timeout: 60_000 });
+};
+export const useInstallHubEntry = ({ mutationConfig } = {}) => {
+    const queryClient = useQueryClient();
+    const { onSuccess, ...restConfig } = mutationConfig ?? {};
+    return useMutation({
+        onSuccess(...args) {
+            queryClient.invalidateQueries({
+                queryKey: getHubEntriesQueryOptions().queryKey,
+            });
+            onSuccess?.(...args);
+        },
+        ...restConfig,
+        mutationFn: installHubEntry,
+    });
+};

package/dist/tui/features/hub/api/list-hub-registries.d.ts

@@ -0,0 +1,16 @@
+import type { QueryConfig } from '../../../lib/react-query.js';
+import { type HubRegistryListResponse } from '../../../../shared/transport/events/index.js';
+export declare const getHubRegistries: () => Promise<HubRegistryListResponse>;
+export declare const getHubRegistriesQueryOptions: () => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<HubRegistryListResponse, Error, HubRegistryListResponse, string[]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<HubRegistryListResponse, string[], never> | undefined;
+} & {
+    queryKey: string[] & {
+        [dataTagSymbol]: HubRegistryListResponse;
+        [dataTagErrorSymbol]: Error;
+    };
+};
+type UseGetHubRegistriesOptions = {
+    queryConfig?: QueryConfig<typeof getHubRegistriesQueryOptions>;
+};
+export declare const useGetHubRegistries: ({ queryConfig }?: UseGetHubRegistriesOptions) => import("@tanstack/react-query").UseQueryResult<HubRegistryListResponse, Error>;
+export {};

package/dist/tui/features/hub/api/list-hub-registries.js

@@ -0,0 +1,17 @@
+import { queryOptions, useQuery } from '@tanstack/react-query';
+import { HubEvents } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+export const getHubRegistries = () => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(HubEvents.REGISTRY_LIST);
+};
+export const getHubRegistriesQueryOptions = () => queryOptions({
+    queryFn: getHubRegistries,
+    queryKey: ['hub', 'registries'],
+});
+export const useGetHubRegistries = ({ queryConfig } = {}) => useQuery({
+    ...getHubRegistriesQueryOptions(),
+    ...queryConfig,
+});

package/dist/tui/features/hub/api/remove-hub-registry.d.ts

@@ -0,0 +1,11 @@
+import type { MutationConfig } from '../../../lib/react-query.js';
+import { type HubRegistryRemoveResponse } from '../../../../shared/transport/events/index.js';
+export type RemoveHubRegistryDTO = {
+    name: string;
+};
+export declare const removeHubRegistry: ({ name }: RemoveHubRegistryDTO) => Promise<HubRegistryRemoveResponse>;
+type UseRemoveHubRegistryOptions = {
+    mutationConfig?: MutationConfig<typeof removeHubRegistry>;
+};
+export declare const useRemoveHubRegistry: ({ mutationConfig }?: UseRemoveHubRegistryOptions) => import("@tanstack/react-query").UseMutationResult<HubRegistryRemoveResponse, Error, RemoveHubRegistryDTO, unknown>;
+export {};

package/dist/tui/features/hub/api/remove-hub-registry.js

@@ -0,0 +1,24 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { HubEvents, } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { getHubEntriesQueryOptions } from './get-hub-entries.js';
+import { getHubRegistriesQueryOptions } from './list-hub-registries.js';
+export const removeHubRegistry = ({ name }) => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(HubEvents.REGISTRY_REMOVE, { name });
+};
+export const useRemoveHubRegistry = ({ mutationConfig } = {}) => {
+    const queryClient = useQueryClient();
+    const { onSuccess, ...restConfig } = mutationConfig ?? {};
+    return useMutation({
+        onSuccess(...args) {
+            queryClient.invalidateQueries({ queryKey: getHubRegistriesQueryOptions().queryKey });
+            queryClient.invalidateQueries({ queryKey: getHubEntriesQueryOptions().queryKey });
+            onSuccess?.(...args);
+        },
+        ...restConfig,
+        mutationFn: removeHubRegistry,
+    });
+};

package/dist/tui/features/hub/components/hub-agent-step.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface HubAgentStepProps {
+    isActive: boolean;
+    onBack: () => void;
+    onSelect: (agentDisplayName: string) => void;
+}
+export declare function HubAgentStep({ isActive, onBack, onSelect }: HubAgentStepProps): React.ReactNode;
+export {};

package/dist/tui/features/hub/components/hub-agent-step.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'ink';
+import { useMemo } from 'react';
+import { SelectableList } from '../../../components/selectable-list.js';
+import { useTheme } from '../../../hooks/index.js';
+import { useGetAgents } from '../../connectors/api/get-agents.js';
+export function HubAgentStep({ isActive, onBack, onSelect }) {
+    const { theme: { colors }, } = useTheme();
+    const { data } = useGetAgents();
+    const items = useMemo(() => (data?.agents ?? [])
+        .filter((agent) => agent.supportedConnectorTypes.includes('skill'))
+        .map((agent) => ({ id: agent.id, name: agent.name })), [data]);
+    return (_jsx(SelectableList, { filterKeys: (item) => [item.name], isActive: isActive, items: items, keyExtractor: (item) => item.id, onCancel: onBack, onSelect: (item) => onSelect(item.name), renderItem: (item, isHighlighted) => (_jsx(Text, { backgroundColor: isHighlighted ? colors.dimText : undefined, color: colors.text, children: item.name })), searchPlaceholder: "Search agents...", title: "Select target agent" }));
+}

package/dist/tui/features/hub/components/hub-detail-step.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { HubEntryDTO } from '../../../../shared/transport/types/dto.js';
+interface HubDetailStepProps {
+    entry: HubEntryDTO;
+    isActive: boolean;
+    onBack: () => void;
+    onInstall: (entry: HubEntryDTO) => void;
+}
+export declare function HubDetailStep({ entry, isActive, onBack, onInstall }: HubDetailStepProps): React.ReactNode;
+export {};

package/dist/tui/features/hub/components/hub-detail-step.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useInput } from 'ink';
+import open from 'open';
+import { useTheme } from '../../../hooks/index.js';
+const SKILL_COLOR = '#10b96e';
+const BUNDLE_COLOR = '#636bff';
+export function HubDetailStep({ entry, isActive, onBack, onInstall }) {
+    const { theme: { colors }, } = useTheme();
+    useInput((input, key) => {
+        if (key.return) {
+            onInstall(entry);
+            return;
+        }
+        if (key.escape) {
+            onBack();
+            return;
+        }
+        if (input === 'o') {
+            open(entry.path_url).catch(() => { });
+        }
+    }, { isActive });
+    const typeColor = entry.type === 'agent-skill' ? SKILL_COLOR : BUNDLE_COLOR;
+    const typeLabel = entry.type === 'agent-skill' ? 'skill' : 'bundle';
+    return (_jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { bold: true, color: colors.text, children: entry.name }), _jsxs(Text, { color: typeColor, children: ["[", typeLabel, "]"] }), _jsxs(Text, { color: colors.dimText, children: ["v", entry.version] })] }), _jsx(Text, { color: colors.dimText, children: entry.id })] }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: colors.text, children: entry.long_description }) }), entry.metadata.use_cases.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: colors.dimText, children: "USE CASES" }), entry.metadata.use_cases.map((useCase) => (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.primary, children: "-" }), _jsx(Text, { color: colors.text, children: useCase })] }, useCase)))] })), _jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [entry.tags.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Tags'.padEnd(14) }), entry.tags.map((tag) => (_jsxs(Text, { color: colors.dimText, children: ["#", tag] }, tag)))] })), entry.dependencies.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Requires'.padEnd(14) }), entry.dependencies.map((dep) => (_jsx(Text, { color: colors.warning, children: dep }, dep)))] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Category'.padEnd(14) }), _jsx(Text, { color: colors.text, children: entry.category })] }), entry.registry && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Registry'.padEnd(14) }), _jsx(Text, { color: colors.text, children: entry.registry })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Author'.padEnd(14) }), _jsx(Text, { color: colors.text, children: entry.author.name })] }), _jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.dimText, children: 'License'.padEnd(14) }), _jsx(Text, { color: colors.text, children: entry.license })] })] }), _jsxs(Box, { gap: 1, marginBottom: 1, children: [_jsx(Text, { color: colors.dimText, children: 'Files'.padEnd(14) }), entry.file_tree.map((file) => (_jsx(Text, { color: colors.dimText, children: file.name }, file.name)))] }), _jsxs(Box, { gap: 2, children: [_jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.primary, children: "Enter" }), " Install"] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "o" }), " Open in browser"] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Esc" }), " Back"] })] })] }));
+}

package/dist/tui/features/hub/components/hub-flow.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+export interface HubFlowProps {
+    isActive?: boolean;
+    onCancel: () => void;
+    onComplete: (message: string) => void;
+}
+export declare const HubFlow: React.FC<HubFlowProps>;

package/dist/tui/features/hub/components/hub-flow.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { useCallback, useEffect, useState } from 'react';
+import { HubEvents } from '../../../../shared/transport/events/hub-events.js';
+import { useTheme } from '../../../hooks/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { useGetHubEntries } from '../api/get-hub-entries.js';
+import { useInstallHubEntry } from '../api/install-hub-entry.js';
+import { HubAgentStep } from './hub-agent-step.js';
+import { HubDetailStep } from './hub-detail-step.js';
+import { HubListStep } from './hub-list-step.js';
+export const HubFlow = ({ isActive = true, onCancel, onComplete }) => {
+    const { theme: { colors }, } = useTheme();
+    const [step, setStep] = useState('list');
+    const [selectedEntry, setSelectedEntry] = useState(null);
+    const [progressMessages, setProgressMessages] = useState([]);
+    const { data, error, isLoading } = useGetHubEntries();
+    const installMutation = useInstallHubEntry();
+    const entries = data?.entries ?? [];
+    useEffect(() => {
+        const { apiClient } = useTransportStore.getState();
+        if (!apiClient || !isLoading)
+            return;
+        const unsub = apiClient.on(HubEvents.LIST_PROGRESS, (progressData) => {
+            setProgressMessages((prev) => [...prev, progressData.message]);
+        });
+        return () => {
+            unsub();
+        };
+    }, [isLoading]);
+    const handleSelectEntry = useCallback((entry) => {
+        setSelectedEntry(entry);
+        setStep('detail');
+    }, []);
+    const handleBack = useCallback(() => {
+        setSelectedEntry(null);
+        setStep('list');
+    }, []);
+    const handleInstall = useCallback((entry) => {
+        if (entry.type === 'agent-skill') {
+            setStep('select-agent');
+        }
+        else {
+            setStep('installing');
+            installMutation
+                .mutateAsync({ entryId: entry.id, registry: entry.registry, scope: 'project' })
+                .then((result) => onComplete(result.installedPath ? `${result.message}\nLocation: ${result.installedPath}` : result.message))
+                .catch((error_) => onComplete(`Install failed: ${error_ instanceof Error ? error_.message : 'Unknown error'}`));
+        }
+    }, [installMutation, onComplete]);
+    const handleAgentSelect = useCallback((agentDisplayName) => {
+        if (!selectedEntry)
+            return;
+        setStep('installing');
+        installMutation
+            .mutateAsync({ agent: agentDisplayName, entryId: selectedEntry.id, registry: selectedEntry.registry })
+            .then((result) => onComplete(result.installedPath ? `${result.message}\nLocation: ${result.installedPath}` : result.message))
+            .catch((error_) => onComplete(`Install failed: ${error_ instanceof Error ? error_.message : 'Unknown error'}`));
+    }, [installMutation, onComplete, selectedEntry]);
+    const handleAgentBack = useCallback(() => {
+        setStep('detail');
+    }, []);
+    if (isLoading) {
+        return (_jsxs(Box, { flexDirection: "column", children: [progressMessages.map((msg, i) => (_jsx(Text, { color: colors.dimText, children: msg }, i))), _jsx(Text, { children: _jsx(Spinner, { type: "dots" }) })] }));
+    }
+    if (error) {
+        onComplete(`Failed to load hub: ${error.message}`);
+        return null;
+    }
+    switch (step) {
+        case 'detail': {
+            if (!selectedEntry)
+                return null;
+            return _jsx(HubDetailStep, { entry: selectedEntry, isActive: isActive, onBack: handleBack, onInstall: handleInstall });
+        }
+        case 'installing': {
+            return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.primary, children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { color: colors.text, children: ["Installing ", _jsx(Text, { bold: true, children: selectedEntry?.name }), "..."] })] }), _jsx(Text, { color: colors.dimText, children: "Downloading files from hub registry" })] }));
+        }
+        case 'list': {
+            return _jsx(HubListStep, { entries: entries, isActive: isActive, onCancel: onCancel, onSelect: handleSelectEntry });
+        }
+        case 'select-agent': {
+            return _jsx(HubAgentStep, { isActive: isActive, onBack: handleAgentBack, onSelect: handleAgentSelect });
+        }
+        default: {
+            return null;
+        }
+    }
+};

package/dist/tui/features/hub/components/hub-list-step.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { HubEntryDTO } from '../../../../shared/transport/types/dto.js';
+interface HubListStepProps {
+    entries: HubEntryDTO[];
+    isActive: boolean;
+    onCancel: () => void;
+    onSelect: (entry: HubEntryDTO) => void;
+}
+export declare function HubListStep({ entries, isActive, onCancel, onSelect }: HubListStepProps): React.ReactNode;
+export {};

package/dist/tui/features/hub/components/hub-list-step.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { SelectableList } from '../../../components/selectable-list.js';
+import { useTerminalBreakpoint, useTheme } from '../../../hooks/index.js';
+const SKILL_COLOR = '#10b96e';
+const BUNDLE_COLOR = '#636bff';
+export function HubListStep({ entries, isActive, onCancel, onSelect }) {
+    const { theme: { colors }, } = useTheme();
+    const { rows } = useTerminalBreakpoint();
+    // SelectableList uses (availableHeight - 4) as the visible item count.
+    // Each hub item renders 3 lines (id line + description + marginBottom blank).
+    //
+    // Chrome lines outside SelectableList (external):
+    //   header (2) + footer (1) + command input bar (3) = 6
+    // Chrome lines inside SelectableList (internal):
+    //   border top/bottom (2) + title+margin (2) + search+margin (2)
+    //   + keybind hints+margin (2) + scroll indicators (2 worst case) = 10
+    // Total chrome = 16, so lines available for items = rows - 16
+    // Visible items = floor((rows - 16) / 3), then add back the 4 that
+    // SelectableList subtracts internally. Min 7 ensures at least 3 items.
+    const availableHeight = Math.max(7, Math.floor((rows - 16) / 3) + 4);
+    return (_jsx(SelectableList, { availableHeight: availableHeight, filterKeys: (entry) => [
+            entry.id,
+            entry.name,
+            entry.description,
+            ...entry.tags,
+            entry.author.name,
+            ...(entry.registry ? [entry.registry] : []),
+        ], isActive: isActive, items: entries, keyExtractor: (entry) => `${entry.id}-${entry.registry}`, onCancel: onCancel, onSelect: onSelect, renderItem: (entry) => {
+            const typeColor = entry.type === 'agent-skill' ? SKILL_COLOR : BUNDLE_COLOR;
+            const typeLabel = entry.type === 'agent-skill' ? 'skill' : 'bundle';
+            return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { bold: true, color: colors.text, children: entry.id }), _jsx(Text, { color: colors.dimText, children: "-" }), _jsx(Text, { color: typeColor, children: typeLabel }), _jsx(Text, { color: colors.dimText, children: "-" }), _jsxs(Text, { color: colors.dimText, children: ["v", entry.version] }), entry.registry && (_jsxs(_Fragment, { children: [_jsx(Text, { color: colors.dimText, children: "-" }), _jsxs(Text, { color: colors.dimText, children: ["(", entry.registry, ")"] })] }))] }), _jsx(Text, { color: colors.dimText, children: entry.description })] }));
+        }, searchPlaceholder: "Search skills & bundles...", title: `BRV Hub  ${entries.length} entries` }));
+}

package/dist/tui/features/hub/components/hub-registry-add-view.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface HubRegistryAddViewProps {
+    authScheme?: string;
+    headerName?: string;
+    name: string;
+    onCancel: () => void;
+    onComplete: (message: string) => void;
+    token?: string;
+    url: string;
+}
+export declare function HubRegistryAddView({ authScheme, headerName, name, onComplete, token, url, }: HubRegistryAddViewProps): React.ReactNode;
+export {};

package/dist/tui/features/hub/components/hub-registry-add-view.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import React, { useState } from 'react';
+import { HubEvents } from '../../../../shared/transport/events/hub-events.js';
+import { useTheme } from '../../../hooks/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { useAddHubRegistry } from '../api/add-hub-registry.js';
+export function HubRegistryAddView({ authScheme, headerName, name, onComplete, token, url, }) {
+    const { theme: { colors }, } = useTheme();
+    const [progressMessages, setProgressMessages] = useState([]);
+    const addMutation = useAddHubRegistry();
+    React.useEffect(() => {
+        const { apiClient } = useTransportStore.getState();
+        let unsub;
+        if (apiClient) {
+            unsub = apiClient.on(HubEvents.REGISTRY_ADD_PROGRESS, (progressData) => {
+                setProgressMessages((prev) => [...prev, progressData.message]);
+            });
+        }
+        addMutation
+            .mutateAsync({ authScheme, headerName, name, token, url })
+            .then((result) => {
+            unsub?.();
+            onComplete(result.message);
+        })
+            .catch((error) => {
+            unsub?.();
+            onComplete(`Failed to add registry: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        });
+        return () => {
+            unsub?.();
+        };
+    }, []);
+    return (_jsxs(Box, { flexDirection: "column", children: [progressMessages.map((msg, i) => (_jsx(Text, { color: colors.dimText, children: msg }, i))), _jsxs(Box, { gap: 1, children: [_jsx(Text, { color: colors.primary, children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { color: colors.text, children: ["Adding registry ", _jsx(Text, { bold: true, children: name }), "..."] })] })] }));
+}

package/dist/tui/features/hub/components/hub-registry-list-view.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface HubRegistryListViewProps {
+    onCancel: () => void;
+    onComplete: (message: string) => void;
+}
+export declare function HubRegistryListView({ onComplete }: HubRegistryListViewProps): React.ReactNode;
+export {};

package/dist/tui/features/hub/components/hub-registry-list-view.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { useEffect, useState } from 'react';
+import { HubEvents } from '../../../../shared/transport/events/hub-events.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+import { useGetHubRegistries } from '../api/list-hub-registries.js';
+export function HubRegistryListView({ onComplete }) {
+    const [progressMessages, setProgressMessages] = useState([]);
+    const { data, error, isLoading } = useGetHubRegistries();
+    useEffect(() => {
+        const { apiClient } = useTransportStore.getState();
+        if (!apiClient || !isLoading)
+            return;
+        const unsub = apiClient.on(HubEvents.REGISTRY_LIST_PROGRESS, (progressData) => {
+            setProgressMessages((prev) => [...prev, progressData.message]);
+        });
+        return () => {
+            unsub();
+        };
+    }, [isLoading]);
+    if (isLoading) {
+        return (_jsxs(Box, { flexDirection: "column", children: [progressMessages.map((msg, i) => (_jsx(Text, { children: msg }, i))), _jsxs(Text, { children: [_jsx(Spinner, { type: "dots" }), " Loading registries..."] })] }));
+    }
+    if (error) {
+        onComplete(`Failed to load registries: ${error.message}`);
+        return null;
+    }
+    const registries = data?.registries ?? [];
+    const lines = registries.map((r) => {
+        const scheme = r.authScheme && r.authScheme !== 'none' && r.authScheme !== 'bearer' ? ` [${r.authScheme}]` : '';
+        const tokenLabel = r.hasToken ? ' (authenticated)' : '';
+        const statusLabel = r.status === 'ok' ? `${r.entryCount} entries` : `error: ${r.error}`;
+        return `  ${r.name} - ${r.url}${scheme}${tokenLabel} (${statusLabel})`;
+    });
+    onComplete(`Registries (${registries.length}):\n${lines.join('\n')}`);
+    return null;
+}