tarsk 0.2.5 → 0.3.0

package/dist/routes/projects.js

@@ -0,0 +1,365 @@
+/**
+ * Project routes for the REST API
+ *
+ * Handles all project-related operations:
+ * - POST /api/projects - Create a new project
+ * - GET /api/projects - List all projects
+ * - GET /api/projects/:id - Get project details
+ * - DELETE /api/projects/:id - Delete a project
+ */
+import { Hono } from 'hono';
+import { AVAILABLE_PROGRAMS } from '../types/models.js';
+import { streamAsyncGenerator } from '../lib/stream-helper.js';
+import { ResponseBuilder } from '../lib/response-builder.js';
+/**
+ * Creates project routes
+ * @param projectManager - The ProjectManager instance
+ * @param threadManager - The ThreadManager instance
+ * @returns Hono router with project routes
+ */
+export function createProjectRoutes(projectManager, threadManager) {
+    const router = new Hono();
+    /**
+     * POST /api/projects
+     * Create a new project from a git URL
+     *
+     * Request body:
+     * {
+     *   "gitUrl": "https://github.com/user/repo.git"
+     * }
+     *
+     * Response: Newline-delimited JSON stream of ProjectEvent objects
+     *
+     * Requirements:
+     * - 6.2 - THE App SHALL send a POST request with the git URL to the CLI
+     * - 8.2 - THE CLI SHALL support streaming responses to the client
+     */
+    router.post('/', async (c) => {
+        try {
+            const body = await c.req.json();
+            const { gitUrl } = body;
+            // Validate gitUrl is provided
+            if (!gitUrl || typeof gitUrl !== 'string') {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'gitUrl is required and must be a string', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            // Stream the project creation events
+            return streamAsyncGenerator(c, projectManager.createProject(gitUrl));
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('REQUEST_PARSE_ERROR', 'Failed to parse request body', 400, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * GET /api/projects
+     * List all projects with expanded threads
+     *
+     * Response:
+     * [
+     *   {
+     *     "projectId": "uuid",
+     *     "gitUrl": "https://github.com/user/repo.git",
+     *     "projectPath": "/path/to/project",
+     *     "threads": [
+     *       {
+     *         "threadId": "uuid",
+     *         "title": "thread-title",
+     *         "path": "/path/to/thread",
+     *         "isSelected": false
+     *       }
+     *     ]
+     *   }
+     * ]
+     *
+     * Requirements:
+     * - 6.2 - THE CLI SHALL expose REST API endpoints for Project operations
+     */
+    router.get('/', async (c) => {
+        try {
+            const projects = await projectManager.listProjects();
+            // Get the currently selected thread
+            const selectedThreadId = await threadManager.getSelectedThreadId();
+            // Expand threads for each project
+            const expandedProjects = await Promise.all(projects.map(async (project) => {
+                const threads = await threadManager.listThreads(project.id);
+                return {
+                    projectId: project.id,
+                    gitUrl: project.gitUrl,
+                    projectPath: project.path,
+                    openWith: project.openWith,
+                    commands: project.commands || [],
+                    threads: threads.map(thread => ({
+                        threadId: thread.id,
+                        title: thread.title,
+                        path: thread.path,
+                        isSelected: thread.id === selectedThreadId
+                    }))
+                };
+            }));
+            return c.json(expandedProjects);
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('LIST_PROJECTS_ERROR', 'Failed to list projects', 500, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * GET /api/projects/:id
+     * Get project details by ID
+     *
+     * Response:
+     * {
+     *   "id": "uuid",
+     *   "name": "project-name",
+     *   "gitUrl": "https://github.com/user/repo.git",
+     *   "path": "/path/to/project",
+     *   "createdAt": "2024-01-01T00:00:00Z",
+     *   "threads": ["thread-id-1", "thread-id-2"]
+     * }
+     *
+     * Requirements:
+     * - 6.2 - THE CLI SHALL expose REST API endpoints for Project operations
+     */
+    router.get('/:id', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            if (!projectId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            const project = await projectManager.getProject(projectId);
+            if (!project) {
+                const { response, statusCode } = ResponseBuilder.error('PROJECT_NOT_FOUND', `Project not found: ${projectId}`, 404);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            return c.json(project);
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('GET_PROJECT_ERROR', 'Failed to get project', 500, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * DELETE /api/projects/:id
+     * Delete a project and all its threads
+     *
+     * Response:
+     * {
+     *   "success": true,
+     *   "message": "Project deleted successfully"
+     * }
+     *
+     * Requirements:
+     * - 6.2 - THE CLI SHALL expose REST API endpoints for Project operations
+     */
+    router.delete('/:id', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            if (!projectId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            await projectManager.deleteProject(projectId);
+            const { response, statusCode } = ResponseBuilder.success({ success: true, message: 'Project deleted successfully' });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Check if it's a "not found" error
+            if (errorMessage.includes('not found')) {
+                const { response, statusCode } = ResponseBuilder.error('PROJECT_NOT_FOUND', errorMessage, 404);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            const { response, statusCode } = ResponseBuilder.error('DELETE_PROJECT_ERROR', 'Failed to delete project', 500, errorMessage);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * POST /api/projects/:id/open
+     * Open a project in the specified program
+     *
+     * Request body:
+     * {
+     *   "program": "VS Code" | "Cursor" | "Windsurf" | "Xcode" | "Android Studio" | "Kiro"
+     * }
+     *
+     * Response:
+     * {
+     *   "success": true,
+     *   "message": "Project opened in VS Code"
+     * }
+     */
+    router.post('/:id/open', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            const body = await c.req.json();
+            const { program } = body;
+            if (!projectId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            if (!program) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Program is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            if (!AVAILABLE_PROGRAMS.includes(program)) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', `Invalid program. Must be one of: ${AVAILABLE_PROGRAMS.join(', ')}`, 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            const project = await projectManager.getProject(projectId);
+            if (!project) {
+                const { response, statusCode } = ResponseBuilder.error('PROJECT_NOT_FOUND', `Project not found: ${projectId}`, 404);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            await projectManager.openWith(projectId, program);
+            const { response, statusCode } = ResponseBuilder.success({ success: true, message: `Project opened in ${program}` });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const { response, statusCode } = ResponseBuilder.error('OPEN_PROGRAM_ERROR', 'Failed to open project', 500, errorMessage);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * PUT /api/projects/:id/open-with
+     * Update the project's open-with program preference
+     *
+     * Request body:
+     * {
+     *   "program": "VS Code" | "Cursor" | "Windsurf" | "Xcode" | "Android Studio" | "Kiro"
+     * }
+     *
+     * Response:
+     * {
+     *   "success": true,
+     *   "message": "Open-with program updated"
+     * }
+     */
+    router.put('/:id/open-with', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            const body = await c.req.json();
+            const { program } = body;
+            if (!projectId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            if (!program) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Program is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            if (!AVAILABLE_PROGRAMS.includes(program)) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', `Invalid program. Must be one of: ${AVAILABLE_PROGRAMS.join(', ')}`, 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            const project = await projectManager.getProject(projectId);
+            if (!project) {
+                const { response, statusCode } = ResponseBuilder.error('PROJECT_NOT_FOUND', `Project not found: ${projectId}`, 404);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            await projectManager.updateOpenWith(projectId, program);
+            const { response, statusCode } = ResponseBuilder.success({ success: true, message: 'Open-with program updated' });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const { response, statusCode } = ResponseBuilder.error('UPDATE_PROGRAM_ERROR', 'Failed to update open-with program', 500, errorMessage);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * POST /api/projects/:id/commands
+     * Add or update a command for a project
+     */
+    router.post('/:id/commands', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            const command = await c.req.json();
+            if (!projectId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID is required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            await projectManager.saveCommand(projectId, command);
+            const { response, statusCode } = ResponseBuilder.success({ success: true, message: 'Command saved' });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('SAVE_COMMAND_ERROR', 'Failed to save command', 500, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * DELETE /api/projects/:id/commands/:commandId
+     * Delete a command from a project
+     */
+    router.delete('/:id/commands/:commandId', async (c) => {
+        try {
+            const projectId = c.req.param('id');
+            const commandId = c.req.param('commandId');
+            if (!projectId || !commandId) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Project ID and Command ID are required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            await projectManager.deleteCommand(projectId, commandId);
+            const { response, statusCode } = ResponseBuilder.success({ success: true, message: 'Command deleted' });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('DELETE_COMMAND_ERROR', 'Failed to delete command', 500, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    /**
+     * POST /api/projects/:projectId/threads/:threadId/commands/run
+     * Run a command in a thread's directory
+     */
+    router.post('/:projectId/threads/:threadId/commands/run', async (c) => {
+        try {
+            const threadId = c.req.param('threadId');
+            const { commandLine, cwd } = await c.req.json();
+            if (!threadId || !commandLine) {
+                const { response, statusCode } = ResponseBuilder.error('INVALID_REQUEST', 'Thread ID and commandLine are required', 400);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return c.json(response, statusCode);
+            }
+            return streamAsyncGenerator(c, projectManager.runCommand(threadId, commandLine, cwd));
+        }
+        catch (error) {
+            const { response, statusCode } = ResponseBuilder.error('RUN_COMMAND_ERROR', 'Failed to run command', 500, error instanceof Error ? error.message : String(error));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return c.json(response, statusCode);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=projects.js.map

package/dist/routes/providers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Provider routes for the REST API
+ *
+ * Handles all provider-related operations:
+ * - GET /api/providers - List all built-in providers
+ */
+import { Hono } from 'hono';
+import { MetadataManager } from '../managers/metadata-manager.js';
+/**
+ * Creates provider routes
+ * @param metadataManager - Manager for metadata persistence
+ * @returns Hono router with provider routes
+ */
+export declare function createProviderRoutes(metadataManager: MetadataManager): Hono;
+//# sourceMappingURL=providers.d.ts.map

package/dist/routes/providers.js

@@ -0,0 +1,130 @@
+/**
+ * Provider routes for the REST API
+ *
+ * Handles all provider-related operations:
+ * - GET /api/providers - List all built-in providers
+ */
+import { Hono } from 'hono';
+import { PROVIDERS } from '../provider.js';
+import { getOpenRouterCredits } from '../model-info-openrouter.js';
+import { getAIHubMixCredits } from '../model-info-aihubmix.js';
+import { updateEnvFile, readEnvFile } from '../utils/env-manager.js';
+/**
+ * Creates provider routes
+ * @param metadataManager - Manager for metadata persistence
+ * @returns Hono router with provider routes
+ */
+export function createProviderRoutes(metadataManager) {
+    const router = new Hono();
+    /**
+     * GET /api/providers
+     * Get all built-in providers with their stored API keys
+     */
+    router.get('/', async (c) => {
+        const keys = await metadataManager.getProviderKeys();
+        const envFileKeys = await readEnvFile();
+        const providersWithKeys = PROVIDERS.map(p => {
+            // Priority: metadata storage > .env file > environment variables
+            const storedKey = keys[p.name];
+            const envFileKey = p.keyName ? envFileKeys[p.keyName] : '';
+            const processEnvKey = p.keyName ? process.env[p.keyName] : '';
+            return {
+                ...p,
+                apiKey: storedKey || envFileKey || processEnvKey || ''
+            };
+        });
+        return c.json(providersWithKeys);
+    });
+    /**
+     * POST /api/providers/keys
+     * Save a provider API key
+     */
+    router.post('/keys', async (c) => {
+        try {
+            const { providerName, apiKey } = await c.req.json();
+            if (!providerName) {
+                return c.json({ error: 'providerName is required' }, 400);
+            }
+            await metadataManager.saveProviderKey(providerName, apiKey);
+            // Also update .env if provider has a keyName
+            const provider = PROVIDERS.find(p => p.name === providerName);
+            if (provider && provider.keyName) {
+                await updateEnvFile({ [provider.keyName]: apiKey });
+            }
+            return c.json({ success: true });
+        }
+        catch (error) {
+            return c.json({ error: `Failed to save provider key: ${error}` }, 500);
+        }
+    });
+    /**
+     * POST /api/providers/bulk-keys
+     * Save all provider API keys at once
+     */
+    router.post('/bulk-keys', async (c) => {
+        try {
+            const { keys } = await c.req.json(); // keys is Record<string, string> where key is providerName
+            if (!keys || typeof keys !== 'object') {
+                return c.json({ error: 'keys object is required' }, 400);
+            }
+            await metadataManager.saveAllProviderKeys(keys);
+            // Also update .env for all providers that have a keyName
+            const envUpdates = {};
+            for (const [providerName, apiKey] of Object.entries(keys)) {
+                const provider = PROVIDERS.find(p => p.name === providerName);
+                if (provider && provider.keyName) {
+                    envUpdates[provider.keyName] = apiKey;
+                }
+            }
+            if (Object.keys(envUpdates).length > 0) {
+                await updateEnvFile(envUpdates);
+            }
+            return c.json({ success: true });
+        }
+        catch (error) {
+            return c.json({ error: `Failed to save bulk provider keys: ${error}` }, 500);
+        }
+    });
+    /**
+     * GET /api/providers/:name/credits
+     * Get current balance for a provider
+     */
+    router.get('/:name/credits', async (c) => {
+        const name = c.req.param('name');
+        if (name.toLowerCase() === 'openrouter') {
+            try {
+                const keys = await metadataManager.getProviderKeys();
+                const envFileKeys = await readEnvFile();
+                const provider = PROVIDERS.find(p => p.name.toLowerCase() === 'openrouter');
+                const apiKey = keys['OpenRouter'] || (provider?.keyName ? (envFileKeys[provider.keyName] || process.env[provider.keyName]) : '');
+                if (!apiKey) {
+                    return c.json({ balance: null, status: 'unknown', reason: 'No API key' });
+                }
+                const credits = await getOpenRouterCredits(apiKey);
+                return c.json(credits);
+            }
+            catch (error) {
+                return c.json({ balance: null, status: 'unknown', reason: String(error) });
+            }
+        }
+        if (name.toLowerCase() === 'aihubmix' || name.toLowerCase() === 'aihub') {
+            try {
+                const keys = await metadataManager.getProviderKeys();
+                const envFileKeys = await readEnvFile();
+                const provider = PROVIDERS.find(p => p.name.toLowerCase() === 'aihubmix');
+                const apiKey = keys['AIHubMix'] || (provider?.keyName ? (envFileKeys[provider.keyName] || process.env[provider.keyName]) : '');
+                if (!apiKey) {
+                    return c.json({ balance: null, status: 'unknown', reason: 'No API key' });
+                }
+                const credits = await getAIHubMixCredits(apiKey);
+                return c.json(credits);
+            }
+            catch (error) {
+                return c.json({ balance: null, status: 'unknown', reason: String(error) });
+            }
+        }
+        return c.json({ balance: null, status: 'unknown' });
+    });
+    return router;
+}
+//# sourceMappingURL=providers.js.map

package/dist/routes/threads-old.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Thread routes for the REST API
+ *
+ * Handles all thread-related operations:
+ * - POST /api/threads - Create a new thread
+ * - GET /api/threads?projectId=xxx - List threads for a project
+ * - DELETE /api/threads/:id - Delete a thread
+ */
+import { Hono } from 'hono';
+import type { ThreadManager } from '../managers/thread-manager.js';
+import type { ConversationManager } from '../managers/conversation-manager.js';
+import type { GitManager } from '../managers/git-manager.js';
+export declare function createThreadRoutes(threadManager: ThreadManager, gitManager: GitManager, conversationManager: ConversationManager): Hono;
+//# sourceMappingURL=threads-old.d.ts.map