agentstudio 0.3.3 → 0.4.0

package/routes/engine.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Engine Configuration API Routes
+ *
+ * Provides endpoints for:
+ * - GET /api/engine - Get current engine configuration
+ * - GET /api/engine/capabilities - Get engine capabilities
+ * - GET /api/engine/paths - Get engine paths configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const engineConfig_js_1 = require("../config/engineConfig.js");
+const cursorConfigService_js_1 = require("../services/cursorConfigService.js");
+const router = (0, express_1.Router)();
+/**
+ * GET /api/engine
+ * Get current engine configuration
+ */
+router.get('/', (_req, res) => {
+    try {
+        const config = (0, engineConfig_js_1.getEngineConfig)();
+        const response = {
+            engine: config.engine,
+            name: config.name,
+            version: config.version,
+            capabilities: config.capabilities,
+            paths: config.paths,
+        };
+        res.json(response);
+    }
+    catch (error) {
+        console.error('Error getting engine config:', error);
+        res.status(500).json({
+            error: 'Failed to get engine configuration',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+/**
+ * GET /api/engine/capabilities
+ * Get engine capabilities only
+ */
+router.get('/capabilities', (_req, res) => {
+    try {
+        const config = (0, engineConfig_js_1.getEngineConfig)();
+        res.json(config.capabilities);
+    }
+    catch (error) {
+        console.error('Error getting engine capabilities:', error);
+        res.status(500).json({
+            error: 'Failed to get engine capabilities',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+/**
+ * GET /api/engine/paths
+ * Get engine paths configuration
+ */
+router.get('/paths', (_req, res) => {
+    try {
+        const paths = (0, engineConfig_js_1.getEnginePaths)();
+        res.json(paths);
+    }
+    catch (error) {
+        console.error('Error getting engine paths:', error);
+        res.status(500).json({
+            error: 'Failed to get engine paths',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+/**
+ * GET /api/engine/feature/:feature
+ * Check if a specific feature is supported
+ */
+router.get('/feature/:feature', (req, res) => {
+    try {
+        const { feature } = req.params;
+        const config = (0, engineConfig_js_1.getEngineConfig)();
+        const features = config.capabilities.features;
+        if (!(feature in features)) {
+            res.status(400).json({
+                error: 'Unknown feature',
+                message: `Feature "${feature}" is not recognized`,
+                validFeatures: Object.keys(features),
+            });
+            return;
+        }
+        const supported = (0, engineConfig_js_1.isFeatureSupported)(feature);
+        res.json({
+            feature,
+            supported,
+            engine: (0, engineConfig_js_1.getEngineType)(),
+        });
+    }
+    catch (error) {
+        console.error('Error checking feature:', error);
+        res.status(500).json({
+            error: 'Failed to check feature support',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+/**
+ * GET /api/engine/project-data
+ * Get project data directory information
+ */
+router.get('/project-data', (req, res) => {
+    try {
+        const { projectPath } = req.query;
+        if (!projectPath || typeof projectPath !== 'string') {
+            res.status(400).json({
+                error: 'Missing projectPath query parameter',
+            });
+            return;
+        }
+        const hash = (0, engineConfig_js_1.projectPathToHash)(projectPath);
+        const dataDir = (0, engineConfig_js_1.getProjectDataDir)(projectPath);
+        res.json({
+            projectPath,
+            hash,
+            dataDir,
+            mcpsDir: `${dataDir}/mcps`,
+            transcriptsDir: `${dataDir}/agent-transcripts`,
+            terminalsDir: `${dataDir}/terminals`,
+            assetsDir: `${dataDir}/assets`,
+        });
+    }
+    catch (error) {
+        console.error('Error getting project data:', error);
+        res.status(500).json({
+            error: 'Failed to get project data directory',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+/**
+ * GET /api/engine/cursor-config
+ * Get Cursor configuration (MCP, rules, commands, skills, plugins)
+ * Only available when running with cursor-cli engine
+ */
+router.get('/cursor-config', async (_req, res) => {
+    try {
+        if (!(0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'This endpoint is only available when running with cursor-cli engine',
+            });
+            return;
+        }
+        const [mcp, rules, commands, skills, plugins, marketplaces] = await Promise.all([
+            (0, cursorConfigService_js_1.getMcpServers)(),
+            (0, cursorConfigService_js_1.getRules)(),
+            (0, cursorConfigService_js_1.getCommands)(),
+            (0, cursorConfigService_js_1.getSkills)(),
+            (0, cursorConfigService_js_1.getPluginsConfig)(),
+            (0, cursorConfigService_js_1.getMarketplacesConfig)(),
+        ]);
+        res.json({
+            mcp,
+            rules,
+            commands,
+            skills,
+            plugins,
+            marketplaces,
+        });
+    }
+    catch (error) {
+        console.error('Error getting Cursor config:', error);
+        res.status(500).json({
+            error: 'Failed to get Cursor configuration',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+});
+exports.default = router;
+//# sourceMappingURL=engine.js.map

package/routes/engine.js.map

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

package/routes/gitVersions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Git Version Management API Routes
+ *
+ * Provides endpoints for managing project versions via Git.
+ * All routes are scoped under /api/projects/:projectId/versions
+ */
+import express from 'express';
+declare const router: express.Router;
+export default router;
+//# sourceMappingURL=gitVersions.d.ts.map

package/routes/gitVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitVersions.d.ts","sourceRoot":"","sources":["../../src/routes/gitVersions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAe9B,QAAA,MAAM,MAAM,EAAE,OAAO,CAAC,MAA8C,CAAC;AAsJrE,eAAe,MAAM,CAAC"}

package/routes/gitVersions.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Git Version Management API Routes
+ *
+ * Provides endpoints for managing project versions via Git.
+ * All routes are scoped under /api/projects/:projectId/versions
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const projectMetadataStorage_1 = require("../services/projectMetadataStorage");
+const gitVersionService_1 = require("../services/gitVersionService");
+const router = express_1.default.Router({ mergeParams: true });
+const projectStorage = new projectMetadataStorage_1.ProjectMetadataStorage();
+/**
+ * Resolve project path from the projectId URL parameter.
+ * projectId can be an encoded path or a project identifier.
+ */
+function resolveProjectPath(projectId) {
+    const decodedPath = decodeURIComponent(projectId);
+    // Try to look up the project to get the real path
+    const project = projectStorage.getProject(decodedPath);
+    if (project && project.path) {
+        return project.path;
+    }
+    // Fallback: use decoded path directly
+    return decodedPath;
+}
+// ========================================
+// GET /api/projects/:projectId/versions
+// List all versions for a project
+// ========================================
+router.get('/', async (req, res) => {
+    try {
+        const projectPath = resolveProjectPath(req.params.projectId);
+        const versions = await (0, gitVersionService_1.listVersions)(projectPath);
+        res.json({ versions });
+    }
+    catch (error) {
+        console.error('[GitVersion] Error listing versions:', error.message);
+        res.status(500).json({ error: error.message || 'Failed to list versions' });
+    }
+});
+// ========================================
+// GET /api/projects/:projectId/versions/status
+// Get version status (current version, dirty state, etc.)
+// ========================================
+router.get('/status', async (req, res) => {
+    try {
+        const projectPath = resolveProjectPath(req.params.projectId);
+        const status = await (0, gitVersionService_1.getVersionStatus)(projectPath);
+        res.json(status);
+    }
+    catch (error) {
+        console.error('[GitVersion] Error getting version status:', error.message);
+        res.status(500).json({ error: error.message || 'Failed to get version status' });
+    }
+});
+// ========================================
+// POST /api/projects/:projectId/versions
+// Create a new version
+// Body: { message: string }
+// ========================================
+router.post('/', async (req, res) => {
+    try {
+        const projectPath = resolveProjectPath(req.params.projectId);
+        const { message } = req.body;
+        if (!message || typeof message !== 'string' || !message.trim()) {
+            return res.status(400).json({ error: 'Version message is required' });
+        }
+        const result = await (0, gitVersionService_1.createVersion)(projectPath, message.trim());
+        console.log(`[GitVersion] Created version ${result.tag} for project: ${projectPath}`);
+        res.json({
+            success: true,
+            version: result,
+        });
+    }
+    catch (error) {
+        console.error('[GitVersion] Error creating version:', error.message);
+        if (error.message.includes('No changes to save')) {
+            return res.status(400).json({ error: error.message });
+        }
+        res.status(500).json({ error: error.message || 'Failed to create version' });
+    }
+});
+// ========================================
+// POST /api/projects/:projectId/versions/checkout
+// Switch to a specific version
+// Body: { tag: string, force?: boolean }
+// ========================================
+router.post('/checkout', async (req, res) => {
+    try {
+        const projectPath = resolveProjectPath(req.params.projectId);
+        const { tag, force } = req.body;
+        if (!tag || typeof tag !== 'string') {
+            return res.status(400).json({ error: 'Version tag is required' });
+        }
+        await (0, gitVersionService_1.checkoutVersion)(projectPath, tag, !!force);
+        console.log(`[GitVersion] Checked out version ${tag} for project: ${projectPath}`);
+        res.json({
+            success: true,
+            message: `Switched to version ${tag}`,
+            tag,
+        });
+    }
+    catch (error) {
+        console.error('[GitVersion] Error checking out version:', error.message);
+        if (error.message === 'DIRTY_WORKING_TREE') {
+            return res.status(409).json({
+                error: 'Working tree has uncommitted changes',
+                code: 'DIRTY_WORKING_TREE',
+                message: 'Please save a new version or discard changes before switching versions.',
+            });
+        }
+        if (error.message.includes('not found')) {
+            return res.status(404).json({ error: error.message });
+        }
+        res.status(500).json({ error: error.message || 'Failed to checkout version' });
+    }
+});
+// ========================================
+// DELETE /api/projects/:projectId/versions/:tag
+// Delete a version tag
+// ========================================
+router.delete('/:tag', async (req, res) => {
+    try {
+        const projectPath = resolveProjectPath(req.params.projectId);
+        const tag = req.params.tag;
+        await (0, gitVersionService_1.deleteVersion)(projectPath, tag);
+        console.log(`[GitVersion] Deleted version ${tag} for project: ${projectPath}`);
+        res.json({
+            success: true,
+            message: `Version ${tag} deleted`,
+        });
+    }
+    catch (error) {
+        console.error('[GitVersion] Error deleting version:', error.message);
+        if (error.message.includes('not found')) {
+            return res.status(404).json({ error: error.message });
+        }
+        res.status(500).json({ error: error.message || 'Failed to delete version' });
+    }
+});
+exports.default = router;
+//# sourceMappingURL=gitVersions.js.map

package/routes/gitVersions.js.map

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

package/routes/hooks.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hooks API routes (Claude Code only)
+ *
+ * Hooks are configured in settings files:
+ * - Global: ~/.claude/settings.json
+ * - Local: .claude/settings.local.json
+ */
+import { Router } from 'express';
+declare const router: Router;
+export default router;
+//# sourceMappingURL=hooks.d.ts.map

package/routes/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/routes/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAgB,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAQ7D,QAAA,MAAM,MAAM,EAAE,MAAiB,CAAC;AA2UhC,eAAe,MAAM,CAAC"}

package/routes/hooks.js

@@ -0,0 +1,303 @@
+"use strict";
+/**
+ * Hooks API routes (Claude Code only)
+ *
+ * Hooks are configured in settings files:
+ * - Global: ~/.claude/settings.json
+ * - Local: .claude/settings.local.json
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const engineConfig_js_1 = require("../config/engineConfig.js");
+const sdkConfig_js_1 = require("../config/sdkConfig.js");
+const router = (0, express_1.Router)();
+// Get global settings file path
+const getGlobalSettingsPath = () => {
+    return path_1.default.join(os_1.default.homedir(), '.claude', 'settings.json');
+};
+// Get local settings file path
+const getLocalSettingsPath = (projectPath) => {
+    const sdkDirName = (0, sdkConfig_js_1.getSdkDirName)();
+    if (projectPath) {
+        return path_1.default.join(projectPath, sdkDirName, 'settings.local.json');
+    }
+    return path_1.default.join(process.cwd(), '..', sdkDirName, 'settings.local.json');
+};
+// Check if file exists
+async function fileExists(filePath) {
+    try {
+        await promises_1.default.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Read settings file
+async function readSettingsFile(filePath) {
+    try {
+        if (!(await fileExists(filePath))) {
+            return {};
+        }
+        const content = await promises_1.default.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Error reading settings file ${filePath}:`, error);
+        return {};
+    }
+}
+// Write settings file
+async function writeSettingsFile(filePath, settings) {
+    const dir = path_1.default.dirname(filePath);
+    await promises_1.default.mkdir(dir, { recursive: true });
+    await promises_1.default.writeFile(filePath, JSON.stringify(settings, null, 2), 'utf-8');
+}
+// Extract hooks from settings
+function extractHooks(settings, scope) {
+    const hooksConfig = settings;
+    const hooks = hooksConfig.hooks || [];
+    return hooks.map((hook, index) => ({
+        id: `${scope}:${index}`,
+        event: hook.event,
+        command: hook.command,
+        matcher: hook.matcher,
+        enabled: hook.enabled !== false,
+        timeout: hook.timeout,
+    }));
+}
+// GET /api/hooks - List all hooks
+router.get('/', async (req, res) => {
+    try {
+        // Hooks are only available in Claude SDK mode
+        if ((0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'Hooks are only available when using Claude SDK engine',
+            });
+            return;
+        }
+        const projectPath = req.query.projectPath;
+        const scope = req.query.scope || 'all';
+        const hooks = [];
+        // Read global hooks
+        if (scope === 'all' || scope === 'global') {
+            const globalSettings = await readSettingsFile(getGlobalSettingsPath());
+            const globalHooks = extractHooks(globalSettings, 'global');
+            hooks.push(...globalHooks);
+        }
+        // Read local hooks
+        if (scope === 'all' || scope === 'local') {
+            const localSettings = await readSettingsFile(getLocalSettingsPath(projectPath));
+            const localHooks = extractHooks(localSettings, 'local');
+            hooks.push(...localHooks);
+        }
+        res.json({
+            hooks,
+            engine: 'claude-sdk',
+        });
+    }
+    catch (error) {
+        console.error('Error listing hooks:', error);
+        res.status(500).json({ error: 'Failed to list hooks' });
+    }
+});
+// GET /api/hooks/:id - Get a single hook
+router.get('/:id', async (req, res) => {
+    try {
+        if ((0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'Hooks are only available when using Claude SDK engine',
+            });
+            return;
+        }
+        const { id } = req.params;
+        const projectPath = req.query.projectPath;
+        // Parse id format: scope:index
+        const [scope, indexStr] = id.split(':');
+        const index = parseInt(indexStr, 10);
+        if (!scope || isNaN(index) || !['global', 'local'].includes(scope)) {
+            res.status(400).json({ error: 'Invalid hook ID format. Expected: scope:index' });
+            return;
+        }
+        const settingsPath = scope === 'global'
+            ? getGlobalSettingsPath()
+            : getLocalSettingsPath(projectPath);
+        const settings = await readSettingsFile(settingsPath);
+        const hooksConfig = settings;
+        const hooks = hooksConfig.hooks || [];
+        if (index < 0 || index >= hooks.length) {
+            res.status(404).json({ error: 'Hook not found' });
+            return;
+        }
+        const hook = hooks[index];
+        const hookItem = {
+            id,
+            event: hook.event,
+            command: hook.command,
+            matcher: hook.matcher,
+            enabled: hook.enabled !== false,
+            timeout: hook.timeout,
+        };
+        res.json({ hook: hookItem });
+    }
+    catch (error) {
+        console.error('Error getting hook:', error);
+        res.status(500).json({ error: 'Failed to get hook' });
+    }
+});
+// POST /api/hooks - Create a new hook
+router.post('/', async (req, res) => {
+    try {
+        if ((0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'Hooks are only available when using Claude SDK engine',
+            });
+            return;
+        }
+        const hookData = req.body;
+        const projectPath = req.query.projectPath;
+        const scope = req.query.scope || 'global';
+        if (!hookData.event || !hookData.command) {
+            res.status(400).json({ error: 'Missing required fields: event, command' });
+            return;
+        }
+        const validEvents = [
+            'PreToolUse', 'PostToolUse', 'PostToolUseFailure',
+            'PermissionRequest', 'SessionStart', 'UserPromptSubmit', 'Notification'
+        ];
+        if (!validEvents.includes(hookData.event)) {
+            res.status(400).json({ error: `Invalid event type. Must be one of: ${validEvents.join(', ')}` });
+            return;
+        }
+        const settingsPath = scope === 'global'
+            ? getGlobalSettingsPath()
+            : getLocalSettingsPath(projectPath);
+        const settings = await readSettingsFile(settingsPath);
+        const hooksConfig = settings;
+        if (!hooksConfig.hooks) {
+            hooksConfig.hooks = [];
+        }
+        const newHook = {
+            event: hookData.event,
+            command: hookData.command,
+            matcher: hookData.matcher,
+            enabled: hookData.enabled !== false,
+            timeout: hookData.timeout,
+        };
+        hooksConfig.hooks.push(newHook);
+        await writeSettingsFile(settingsPath, settings);
+        const hookItem = {
+            id: `${scope}:${hooksConfig.hooks.length - 1}`,
+            ...newHook,
+            enabled: newHook.enabled !== false,
+        };
+        res.status(201).json({ hook: hookItem, message: 'Hook created successfully' });
+    }
+    catch (error) {
+        console.error('Error creating hook:', error);
+        res.status(500).json({ error: 'Failed to create hook' });
+    }
+});
+// PUT /api/hooks/:id - Update a hook
+router.put('/:id', async (req, res) => {
+    try {
+        if ((0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'Hooks are only available when using Claude SDK engine',
+            });
+            return;
+        }
+        const { id } = req.params;
+        const updateData = req.body;
+        const projectPath = req.query.projectPath;
+        // Parse id format: scope:index
+        const [scope, indexStr] = id.split(':');
+        const index = parseInt(indexStr, 10);
+        if (!scope || isNaN(index) || !['global', 'local'].includes(scope)) {
+            res.status(400).json({ error: 'Invalid hook ID format. Expected: scope:index' });
+            return;
+        }
+        const settingsPath = scope === 'global'
+            ? getGlobalSettingsPath()
+            : getLocalSettingsPath(projectPath);
+        const settings = await readSettingsFile(settingsPath);
+        const hooksConfig = settings;
+        const hooks = hooksConfig.hooks || [];
+        if (index < 0 || index >= hooks.length) {
+            res.status(404).json({ error: 'Hook not found' });
+            return;
+        }
+        // Update hook
+        const existingHook = hooks[index];
+        const updatedHook = {
+            event: updateData.event ?? existingHook.event,
+            command: updateData.command ?? existingHook.command,
+            matcher: updateData.matcher ?? existingHook.matcher,
+            enabled: updateData.enabled ?? existingHook.enabled,
+            timeout: updateData.timeout ?? existingHook.timeout,
+        };
+        hooks[index] = updatedHook;
+        await writeSettingsFile(settingsPath, settings);
+        const hookItem = {
+            id,
+            ...updatedHook,
+            enabled: updatedHook.enabled !== false,
+        };
+        res.json({ hook: hookItem, message: 'Hook updated successfully' });
+    }
+    catch (error) {
+        console.error('Error updating hook:', error);
+        res.status(500).json({ error: 'Failed to update hook' });
+    }
+});
+// DELETE /api/hooks/:id - Delete a hook
+router.delete('/:id', async (req, res) => {
+    try {
+        if ((0, engineConfig_js_1.isCursorEngine)()) {
+            res.status(400).json({
+                error: 'Not available',
+                message: 'Hooks are only available when using Claude SDK engine',
+            });
+            return;
+        }
+        const { id } = req.params;
+        const projectPath = req.query.projectPath;
+        // Parse id format: scope:index
+        const [scope, indexStr] = id.split(':');
+        const index = parseInt(indexStr, 10);
+        if (!scope || isNaN(index) || !['global', 'local'].includes(scope)) {
+            res.status(400).json({ error: 'Invalid hook ID format. Expected: scope:index' });
+            return;
+        }
+        const settingsPath = scope === 'global'
+            ? getGlobalSettingsPath()
+            : getLocalSettingsPath(projectPath);
+        const settings = await readSettingsFile(settingsPath);
+        const hooksConfig = settings;
+        const hooks = hooksConfig.hooks || [];
+        if (index < 0 || index >= hooks.length) {
+            res.status(404).json({ error: 'Hook not found' });
+            return;
+        }
+        // Remove hook
+        hooks.splice(index, 1);
+        await writeSettingsFile(settingsPath, settings);
+        res.json({ message: 'Hook deleted successfully' });
+    }
+    catch (error) {
+        console.error('Error deleting hook:', error);
+        res.status(500).json({ error: 'Failed to delete hook' });
+    }
+});
+exports.default = router;
+//# sourceMappingURL=hooks.js.map