@agenthippo-ai/agenthippo 0.1.0

package/out/spotlight/install.js

@@ -0,0 +1,339 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installSpotlightViewFromFiles = installSpotlightViewFromFiles;
+exports.listInstalledSpotlightViews = listInstalledSpotlightViews;
+exports.setActiveSpotlightView = setActiveSpotlightView;
+exports.isSpotlightViewInstalled = isSpotlightViewInstalled;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const branding_1 = require("../branding");
+const utils_1 = require("../utils");
+const index_1 = require("../utils/index");
+const publish_1 = require("./publish");
+const yaml_1 = require("./yaml");
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+function parseStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((entry) => typeof entry === 'string' && entry.trim().length > 0)
+        .map(entry => path.basename(entry.trim()));
+}
+function dedupeBasenames(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const basename = path.basename(value.trim());
+        if (!basename || seen.has(basename)) {
+            continue;
+        }
+        seen.add(basename);
+        result.push(basename);
+    }
+    return result;
+}
+function resolveAnalyticsRoot(scope, workspaceRoot) {
+    if (scope === 'workspace') {
+        if (!workspaceRoot?.trim()) {
+            throw new Error('Workspace-scoped views require an open workspace folder');
+        }
+        return path.join(workspaceRoot.trim(), branding_1.AGENTIDE_DIR_NAME, 'analytics');
+    }
+    return path.join((0, index_1.getAgentideHome)(), 'analytics');
+}
+function getFileMap(files) {
+    const map = new Map();
+    for (const file of files) {
+        const content = Buffer.isBuffer(file.content)
+            ? file.content
+            : Buffer.from(file.content, 'utf-8');
+        map.set(file.path.replace(/\\/g, '/'), content);
+    }
+    return map;
+}
+async function mergePanelEntry(viewsConfigPath, entry, overwrite) {
+    await fs_1.promises.mkdir(path.dirname(viewsConfigPath), { recursive: true });
+    let config;
+    try {
+        const raw = await fs_1.promises.readFile(viewsConfigPath, 'utf-8');
+        config = (0, yaml_1.parseSpotlightYamlRecord)(raw) ?? { version: 1, activeViewId: 'global', views: [] };
+    }
+    catch {
+        config = { version: 1, activeViewId: 'global', views: [] };
+    }
+    const views = Array.isArray(config.views) ? [...config.views] : [];
+    const normalizedId = (0, yaml_1.normalizeSpotlightViewId)(entry.id);
+    const existingIndex = views.findIndex(item => {
+        if (!item || typeof item !== 'object') {
+            return false;
+        }
+        const candidate = item;
+        return (0, yaml_1.normalizeSpotlightViewId)(typeof candidate.id === 'string' ? candidate.id : undefined) === normalizedId;
+    });
+    const payload = {
+        id: normalizedId,
+        name: entry.name,
+        scope: entry.scope,
+        scripts: dedupeBasenames(entry.scripts),
+    };
+    if (existingIndex >= 0) {
+        if (!overwrite) {
+            throw new Error(`Spotlight view "${normalizedId}" is already registered in ${viewsConfigPath}`);
+        }
+        views[existingIndex] = payload;
+    }
+    else {
+        views.push(payload);
+    }
+    config.views = views;
+    if (typeof config.version !== 'number') {
+        config.version = 1;
+    }
+    if (typeof config.activeViewId !== 'string') {
+        config.activeViewId = 'global';
+    }
+    await fs_1.promises.writeFile(viewsConfigPath, (0, yaml_1.dumpSpotlightYaml)(config), 'utf-8');
+}
+// -----------------------------------------------------------------------------
+// Install
+// -----------------------------------------------------------------------------
+/**
+ * Install a Spotlight view bundle downloaded from the store.
+ */
+async function installSpotlightViewFromFiles(files, options) {
+    const fileMap = getFileMap(files);
+    const manifestRaw = fileMap.get('view.yaml');
+    const panelEntryRaw = fileMap.get('panel-entry.yaml');
+    if (!manifestRaw || !panelEntryRaw) {
+        throw new Error('Store bundle is missing view.yaml or panel-entry.yaml');
+    }
+    const manifest = (0, yaml_1.parseSpotlightYamlRecord)(manifestRaw.toString('utf-8'));
+    const panelEntry = (0, yaml_1.parseSpotlightYamlRecord)(panelEntryRaw.toString('utf-8'));
+    if (!manifest || !panelEntry) {
+        throw new Error('Invalid view.yaml or panel-entry.yaml in store bundle');
+    }
+    const id = (0, yaml_1.normalizeSpotlightViewId)(typeof manifest.id === 'string' ? manifest.id : options.slug, options.slug);
+    if (id !== (0, yaml_1.normalizeSpotlightViewId)(options.slug, options.slug)) {
+        throw new Error(`Bundle id "${id}" does not match requested slug "${options.slug}"`);
+    }
+    const scope = manifest.scope === 'workspace' || panelEntry.scope === 'workspace'
+        ? 'workspace'
+        : 'global';
+    const name = typeof manifest.name === 'string' && manifest.name.trim()
+        ? manifest.name.trim()
+        : typeof panelEntry.name === 'string' && panelEntry.name.trim()
+            ? panelEntry.name.trim()
+            : id;
+    const scripts = dedupeBasenames(parseStringArray(manifest.scripts).length
+        ? parseStringArray(manifest.scripts)
+        : parseStringArray(panelEntry.scripts));
+    const analyticsRoot = resolveAnalyticsRoot(scope, options.workspaceRoot);
+    const installDir = path.join(analyticsRoot, 'views', id);
+    const viewsConfigPath = path.join(analyticsRoot, 'panel', 'views.yaml');
+    const scriptsDir = path.join(installDir, 'scripts');
+    if (!options.overwrite && await (0, utils_1.pathExists)(installDir)) {
+        throw new Error(`Spotlight view "${id}" already exists at ${installDir}`);
+    }
+    if (options.overwrite) {
+        await fs_1.promises.rm(installDir, { recursive: true, force: true });
+    }
+    await fs_1.promises.mkdir(scriptsDir, { recursive: true });
+    const INSTALLABLE_PREFIXES = [
+        'scripts/',
+        'assets/',
+        'images/',
+        'charts/',
+        'reports/',
+        'exports/',
+    ];
+    const INSTALLABLE_ROOT_FILES = new Set(['manifest.json', 'README.md']);
+    const SKIP_PATHS = new Set(['view.yaml', 'panel-entry.yaml']);
+    for (const [relPath, content] of fileMap.entries()) {
+        if (SKIP_PATHS.has(relPath)) {
+            continue;
+        }
+        if (!INSTALLABLE_ROOT_FILES.has(relPath) && !INSTALLABLE_PREFIXES.some(prefix => relPath.startsWith(prefix))) {
+            continue;
+        }
+        const destination = path.join(installDir, relPath);
+        await fs_1.promises.mkdir(path.dirname(destination), { recursive: true });
+        await fs_1.promises.writeFile(destination, content);
+    }
+    const now = new Date().toISOString();
+    const installedVersion = (0, publish_1.resolveViewPublishVersionFromParsed)(manifest) ?? options.version ?? '1.0.0';
+    const runtimeManifest = {
+        version: installedVersion,
+        id,
+        name,
+        description: typeof manifest.description === 'string' ? manifest.description : '',
+        author: typeof manifest.author === 'string' ? manifest.author : undefined,
+        scope,
+        projectId: '',
+        agentId: '',
+        createdAt: now,
+        updatedAt: now,
+        scripts,
+        storeVersion: installedVersion,
+    };
+    if (Array.isArray(manifest.tags)) {
+        runtimeManifest.tags = manifest.tags.filter((tag) => typeof tag === 'string');
+    }
+    await fs_1.promises.writeFile(path.join(installDir, 'view.yaml'), (0, yaml_1.dumpSpotlightYaml)(runtimeManifest), 'utf-8');
+    await mergePanelEntry(viewsConfigPath, {
+        id,
+        name,
+        scope,
+        scripts,
+    }, !!options.overwrite);
+    if (options.activate) {
+        let config;
+        try {
+            const raw = await fs_1.promises.readFile(viewsConfigPath, 'utf-8');
+            config = (0, yaml_1.parseSpotlightYamlRecord)(raw) ?? {};
+        }
+        catch {
+            config = { version: 1, views: [] };
+        }
+        config.activeViewId = id;
+        if (typeof config.version !== 'number') {
+            config.version = 1;
+        }
+        await fs_1.promises.writeFile(viewsConfigPath, (0, yaml_1.dumpSpotlightYaml)(config), 'utf-8');
+    }
+    if (options.logger) {
+        (0, utils_1.logInfo)(options.logger, `[Spotlight] Installed view "${id}" to ${installDir}`);
+    }
+    return {
+        id,
+        scope,
+        installDir,
+        viewsConfigPath,
+        version: (0, publish_1.resolveViewPublishVersionFromParsed)(manifest) ?? options.version ?? '1.0.0',
+    };
+}
+/**
+ * List Spotlight views installed under home and workspace analytics roots.
+ */
+async function listInstalledSpotlightViews(workspaceRoot) {
+    const results = [];
+    const seen = new Set();
+    async function scan(root) {
+        const viewsDir = path.join(root, 'views');
+        if (!(await (0, utils_1.pathExists)(viewsDir))) {
+            return;
+        }
+        const entries = await fs_1.promises.readdir(viewsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('.')) {
+                continue;
+            }
+            const key = entry.name.toLowerCase();
+            if (seen.has(key)) {
+                continue;
+            }
+            const metadataPath = path.join(viewsDir, entry.name, 'view.yaml');
+            try {
+                const raw = await fs_1.promises.readFile(metadataPath, 'utf-8');
+                const parsed = (0, yaml_1.parseSpotlightYamlRecord)(raw);
+                if (!parsed) {
+                    continue;
+                }
+                const id = (0, yaml_1.normalizeSpotlightViewId)(typeof parsed.id === 'string' ? parsed.id : entry.name, entry.name);
+                const scope = parsed.scope === 'workspace' ? 'workspace' : 'global';
+                seen.add(key);
+                results.push({
+                    slug: id,
+                    displayName: typeof parsed.name === 'string' && parsed.name.trim() ? parsed.name.trim() : id,
+                    description: typeof parsed.description === 'string' ? parsed.description.trim() : undefined,
+                    tags: Array.isArray(parsed.tags)
+                        ? parsed.tags.filter((tag) => typeof tag === 'string')
+                        : ['spotlight'],
+                    latestVersion: typeof parsed.storeVersion === 'string'
+                        ? parsed.storeVersion
+                        : (0, publish_1.resolveViewPublishVersionFromParsed)(parsed) ?? 'local',
+                    scope,
+                });
+            }
+            catch {
+                // Skip malformed view folders.
+            }
+        }
+    }
+    await scan(path.join((0, index_1.getAgentideHome)(), 'analytics'));
+    if (workspaceRoot?.trim()) {
+        await scan(path.join(workspaceRoot.trim(), branding_1.AGENTIDE_DIR_NAME, 'analytics'));
+    }
+    return results.sort((a, b) => a.slug.localeCompare(b.slug));
+}
+/**
+ * Set the active Spotlight view in panel/views.yaml.
+ */
+async function setActiveSpotlightView(viewsConfigPath, viewId) {
+    const normalized = (0, yaml_1.normalizeSpotlightViewId)(viewId, viewId);
+    let config;
+    try {
+        const raw = await fs_1.promises.readFile(viewsConfigPath, 'utf-8');
+        config = (0, yaml_1.parseSpotlightYamlRecord)(raw) ?? { version: 1, views: [] };
+    }
+    catch {
+        config = { version: 1, views: [] };
+    }
+    config.activeViewId = normalized;
+    if (typeof config.version !== 'number') {
+        config.version = 1;
+    }
+    await fs_1.promises.writeFile(viewsConfigPath, (0, yaml_1.dumpSpotlightYaml)(config), 'utf-8');
+}
+async function isSpotlightViewInstalled(viewId, workspaceRoot) {
+    const normalized = (0, yaml_1.normalizeSpotlightViewId)(viewId, viewId);
+    for (const root of [
+        path.join((0, index_1.getAgentideHome)(), 'analytics', 'views', normalized, 'view.yaml'),
+        workspaceRoot?.trim()
+            ? path.join(workspaceRoot.trim(), branding_1.AGENTIDE_DIR_NAME, 'analytics', 'views', normalized, 'view.yaml')
+            : '',
+    ].filter(Boolean)) {
+        if (await (0, utils_1.pathExists)(root)) {
+            return true;
+        }
+    }
+    return false;
+}