tarsk 0.4.4 → 0.4.6

package/dist/features/projects/projects.routes.js

@@ -1,255 +0,0 @@
-/**
- * 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 { handleCreateProject } from "./projects-create.route.js";
-import { handleOpenFolderProject } from "./projects-open-folder.route.js";
-import { handleListProjects } from "./projects-list.route.js";
-import { handleGetProject } from "./projects-get.route.js";
-import { handleDeleteProject } from "./projects-delete.route.js";
-import { handleOpenProject } from "./projects-open.route.js";
-import { handleUpdateProject } from "./projects-update.route.js";
-import { handleSaveCommand, handleDeleteCommand } from "./projects-commands.route.js";
-import { handleRunCommand } from "./projects-run-command.route.js";
-import { handleStartRun, handleSuggestRun, handleStopRun, handleCheckRunning, } from "./projects-run.route.js";
-import { handleGetPackageScripts } from "./projects-package-scripts.route.js";
-import { handleGetAIFiles, handleGetAIFile, handleSaveAIFile, handleDeleteAIFile, handleCreateSkill, } from "./projects-ai-files.route.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) => {
-        return handleCreateProject(c, projectManager);
-    });
-    /**
-     * POST /api/projects/open-folder
-     * Create a new project by selecting a local folder via native OS dialog
-     *
-     * Response: Newline-delimited JSON stream of ProjectEvent objects
-     */
-    router.post("/open-folder", async (c) => {
-        return handleOpenFolderProject(c, projectManager);
-    });
-    /**
-     * 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) => {
-        return handleListProjects(c, projectManager, threadManager);
-    });
-    /**
-     * 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) => {
-        return handleGetProject(c, projectManager);
-    });
-    /**
-     * 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) => {
-        return handleDeleteProject(c, projectManager);
-    });
-    /**
-     * 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) => {
-        return handleOpenProject(c, projectManager);
-    });
-    /**
-     * PUT /api/projects/:id
-     * Update project properties (unified endpoint)
-     *
-     * Request body (all fields optional):
-     * {
-     *   "program": "VS Code" | "Cursor" | "Windsurf" | "Xcode" | "Android Studio" | "Kiro",
-     *   "setupScript": "npm install" | null,
-     *   "name": "new-project-name",
-     *   "runCommand": "npm run dev" | null,
-     *   "commitMethod": "pull-request" | "direct",
-     *   "runNow": boolean (optional) - if true, run the setup script in the first thread
-     * }
-     *
-     * Response:
-     * {
-     *   "success": true,
-     *   "message": "Project updated"
-     * }
-     */
-    router.put("/:id", async (c) => {
-        return handleUpdateProject(c, projectManager);
-    });
-    /**
-     * POST /api/projects/:id/commands
-     * Add or update a command for a project
-     */
-    router.post("/:id/commands", async (c) => {
-        return handleSaveCommand(c, projectManager);
-    });
-    /**
-     * DELETE /api/projects/:id/commands/:commandId
-     * Delete a command from a project
-     */
-    router.delete("/:id/commands/:commandId", async (c) => {
-        return handleDeleteCommand(c, projectManager);
-    });
-    /**
-     * 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) => {
-        return handleRunCommand(c, projectManager);
-    });
-    /**
-     * POST /api/projects/:id/run
-     * Start the dev server process for a project
-     */
-    router.post("/:id/run", async (c) => {
-        return handleStartRun(c, projectManager);
-    });
-    /**
-     * POST /api/projects/:id/run-suggest
-     * Suggest a run command for a project based on package.json
-     */
-    router.post("/:id/run-suggest", async (c) => {
-        return handleSuggestRun(c, projectManager);
-    });
-    /**
-     * POST /api/projects/:id/stop
-     * Stop the dev server process for a project
-     */
-    router.post("/:id/stop", async (c) => {
-        return handleStopRun(c, projectManager);
-    });
-    /**
-     * GET /api/projects/:id/running
-     * Check if a dev server process is running for a project
-     */
-    router.get("/:id/running", async (c) => {
-        return handleCheckRunning(c, projectManager);
-    });
-    /**
-     * GET /api/projects/:id/package-scripts
-     * Get available npm scripts from package.json files in the project
-     */
-    router.get("/:id/package-scripts", async (c) => {
-        return handleGetPackageScripts(c, projectManager);
-    });
-    /**
-     * GET /api/projects/:id/ai-files
-     * List AI-related files (skills, rules, commands, markdown files)
-     */
-    router.get("/:id/ai-files", async (c) => {
-        return handleGetAIFiles(c, projectManager);
-    });
-    /**
-     * GET /api/projects/:id/ai-file?path=...
-     * Read the content of an AI-related file
-     */
-    router.get("/:id/ai-file", async (c) => {
-        return handleGetAIFile(c, projectManager);
-    });
-    /**
-     * PUT /api/projects/:id/ai-file
-     * Save the content of an AI-related file
-     */
-    router.put("/:id/ai-file", async (c) => {
-        return handleSaveAIFile(c, projectManager);
-    });
-    /**
-     * DELETE /api/projects/:id/ai-file?path=...
-     * Delete a file or folder
-     */
-    router.delete("/:id/ai-file", async (c) => {
-        return handleDeleteAIFile(c, projectManager);
-    });
-    /**
-     * POST /api/projects/:id/ai-files/skill
-     * Create a new skill with SKILL.md
-     */
-    router.post("/:id/ai-files/skill", async (c) => {
-        return handleCreateSkill(c, projectManager);
-    });
-    return router;
-}
-//# sourceMappingURL=projects.routes.js.map

package/dist/features/projects/terminal-session-manager.d.ts

@@ -1,55 +0,0 @@
-/**
- * TerminalSessionManager manages working directory state for terminal sessions
- *
- * This manager is responsible for:
- * - Maintaining working directory state per thread
- * - Tracking current working directory between command executions
- * - Providing session isolation for different threads
- */
-export interface TerminalSession {
-    threadId: string;
-    currentWorkingDirectory: string;
-    baseDirectory: string;
-}
-export declare class TerminalSessionManager {
-    private sessions;
-    /**
-     * Get or create a terminal session for a thread
-     * @param threadId - The thread ID
-     * @param baseDirectory - The base directory for the thread
-     * @returns The terminal session
-     */
-    getOrCreateSession(threadId: string, baseDirectory: string): TerminalSession;
-    /**
-     * Get the current working directory for a thread
-     * @param threadId - The thread ID
-     * @returns The current working directory or null if no session exists
-     */
-    getCurrentWorkingDirectory(threadId: string): string | null;
-    /**
-     * Update the working directory for a thread session
-     * @param threadId - The thread ID
-     * @param newWorkingDirectory - The new working directory
-     */
-    updateWorkingDirectory(threadId: string, newWorkingDirectory: string): void;
-    /**
-     * Reset a thread's session to its base directory
-     * @param threadId - The thread ID
-     */
-    resetSession(threadId: string): void;
-    /**
-     * Remove a terminal session (cleanup)
-     * @param threadId - The thread ID
-     */
-    removeSession(threadId: string): void;
-    /**
-     * Clear all sessions (useful for cleanup or testing)
-     */
-    clearAllSessions(): void;
-    /**
-     * Get all active sessions (useful for debugging)
-     * @returns Array of all active sessions
-     */
-    getAllSessions(): TerminalSession[];
-}
-//# sourceMappingURL=terminal-session-manager.d.ts.map

package/dist/features/projects/terminal-session-manager.js

@@ -1,90 +0,0 @@
-/**
- * TerminalSessionManager manages working directory state for terminal sessions
- *
- * This manager is responsible for:
- * - Maintaining working directory state per thread
- * - Tracking current working directory between command executions
- * - Providing session isolation for different threads
- */
-import { realpathSync } from "fs";
-export class TerminalSessionManager {
-    sessions = new Map();
-    /**
-     * Get or create a terminal session for a thread
-     * @param threadId - The thread ID
-     * @param baseDirectory - The base directory for the thread
-     * @returns The terminal session
-     */
-    getOrCreateSession(threadId, baseDirectory) {
-        let session = this.sessions.get(threadId);
-        if (!session) {
-            // Create a new session starting at the base directory
-            session = {
-                threadId,
-                currentWorkingDirectory: realpathSync(baseDirectory),
-                baseDirectory: realpathSync(baseDirectory),
-            };
-            this.sessions.set(threadId, session);
-        }
-        return session;
-    }
-    /**
-     * Get the current working directory for a thread
-     * @param threadId - The thread ID
-     * @returns The current working directory or null if no session exists
-     */
-    getCurrentWorkingDirectory(threadId) {
-        const session = this.sessions.get(threadId);
-        return session ? session.currentWorkingDirectory : null;
-    }
-    /**
-     * Update the working directory for a thread session
-     * @param threadId - The thread ID
-     * @param newWorkingDirectory - The new working directory
-     */
-    updateWorkingDirectory(threadId, newWorkingDirectory) {
-        const session = this.sessions.get(threadId);
-        if (session) {
-            try {
-                // Resolve to real path to handle symlinks and relative paths
-                const realPath = realpathSync(newWorkingDirectory);
-                session.currentWorkingDirectory = realPath;
-            }
-            catch {
-                // If realpath fails, use the path as-is
-                session.currentWorkingDirectory = newWorkingDirectory;
-            }
-        }
-    }
-    /**
-     * Reset a thread's session to its base directory
-     * @param threadId - The thread ID
-     */
-    resetSession(threadId) {
-        const session = this.sessions.get(threadId);
-        if (session) {
-            session.currentWorkingDirectory = session.baseDirectory;
-        }
-    }
-    /**
-     * Remove a terminal session (cleanup)
-     * @param threadId - The thread ID
-     */
-    removeSession(threadId) {
-        this.sessions.delete(threadId);
-    }
-    /**
-     * Clear all sessions (useful for cleanup or testing)
-     */
-    clearAllSessions() {
-        this.sessions.clear();
-    }
-    /**
-     * Get all active sessions (useful for debugging)
-     * @returns Array of all active sessions
-     */
-    getAllSessions() {
-        return Array.from(this.sessions.values());
-    }
-}
-//# sourceMappingURL=terminal-session-manager.js.map

package/dist/features/providers/provider-resolver.d.ts

@@ -1,13 +0,0 @@
-import { type CatalogProvider } from "../models/models-catalog.js";
-export interface ResolvedProvider extends CatalogProvider {
-    apiKey?: string;
-}
-/**
- * Resolve a provider's full config from catalog data.
- */
-export declare function resolveProviderConfig(providerName: string): Promise<ResolvedProvider | null>;
-/**
- * Find the keyName for a provider from catalog data.
- */
-export declare function resolveProviderKeyName(providerName: string): Promise<string>;
-//# sourceMappingURL=provider-resolver.d.ts.map

package/dist/features/providers/provider-resolver.js

@@ -1,22 +0,0 @@
-import { getCatalogProvider } from "../models/models-catalog.js";
-/**
- * Resolve a provider's full config from catalog data.
- */
-export async function resolveProviderConfig(providerName) {
-    const slug = providerName.toLowerCase();
-    const catalogProvider = await getCatalogProvider(slug);
-    if (!catalogProvider)
-        return null;
-    return catalogProvider;
-}
-/**
- * Find the keyName for a provider from catalog data.
- */
-export async function resolveProviderKeyName(providerName) {
-    const slug = providerName.toLowerCase();
-    const catalogProvider = await getCatalogProvider(slug);
-    if (catalogProvider?.env?.[0])
-        return catalogProvider.env[0];
-    return "";
-}
-//# sourceMappingURL=provider-resolver.js.map

package/dist/features/providers/providers-get-credits.route.d.ts

@@ -1,15 +0,0 @@
-/**
- * GET /api/providers/:name/credits
- * Get current balance for a provider
- */
-import type { Context } from "hono";
-import type { MetadataManager } from "../metadata/metadata.manager.js";
-export declare function getProviderCredits(c: Context, metadataManager: MetadataManager): Promise<(Response & import("hono").TypedResponse<{
-    balance: number | null;
-    status: string;
-    reason?: string | undefined;
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
-    balance: null;
-    status: string;
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">)>;
-//# sourceMappingURL=providers-get-credits.route.d.ts.map

package/dist/features/providers/providers-get-credits.route.js

@@ -1,51 +0,0 @@
-/**
- * GET /api/providers/:name/credits
- * Get current balance for a provider
- */
-import { getCatalogProvider } from "../models/models-catalog.js";
-import { getOpenRouterCredits } from "../models/model-info-openrouter.js";
-import { getAIHubMixCredits } from "../models/model-info-aihubmix.js";
-import { readEnvFile } from "../../core/env-manager.js";
-export async function getProviderCredits(c, metadataManager) {
-    const name = c.req.param("name");
-    if (name.toLowerCase() === "openrouter") {
-        try {
-            const keys = await metadataManager.getProviderKeys();
-            const envFileKeys = await readEnvFile();
-            const provider = await getCatalogProvider("openrouter");
-            const apiKey = keys["OpenRouter"] ||
-                (provider?.env && provider.env.length > 0
-                    ? envFileKeys[provider.env[0]] || process.env[provider.env[0]]
-                    : "");
-            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 = await getCatalogProvider("aihubmix");
-            const apiKey = keys["AIHubMix"] ||
-                (provider?.env && provider.env.length > 0
-                    ? envFileKeys[provider.env[0]] || process.env[provider.env[0]]
-                    : "");
-            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" });
-}
-//# sourceMappingURL=providers-get-credits.route.js.map

package/dist/features/providers/providers-get.route.d.ts

@@ -1,16 +0,0 @@
-/**
- * GET /api/providers
- * Get all providers with their stored API keys from catalog data.
- */
-import type { Context } from "hono";
-import type { MetadataManager } from "../metadata/metadata.manager.js";
-export declare function getProviders(c: Context, metadataManager: MetadataManager): Promise<Response & import("hono").TypedResponse<{
-    name: string;
-    slug: string;
-    url: string;
-    keyName: string;
-    authType: "APIKey";
-    api: string;
-    apiKey: string;
-}[], import("hono/utils/http-status").ContentfulStatusCode, "json">>;
-//# sourceMappingURL=providers-get.route.d.ts.map

package/dist/features/providers/providers-get.route.js

@@ -1,32 +0,0 @@
-/**
- * GET /api/providers
- * Get all providers with their stored API keys from catalog data.
- */
-import { readEnvFile } from "../../core/env-manager.js";
-import { getModelsCatalog } from "../models/models-catalog.js";
-export async function getProviders(c, metadataManager) {
-    const keys = await metadataManager.getProviderKeys();
-    const envFileKeys = await readEnvFile();
-    const catalog = await getModelsCatalog();
-    const providersWithKeys = [];
-    // Process all catalog providers
-    if (catalog) {
-        for (const [catalogId, catalogProvider] of Object.entries(catalog)) {
-            const keyName = catalogProvider.env?.[0] || "";
-            const envFileKey = keyName ? envFileKeys[keyName] : "";
-            const processEnvKey = keyName ? process.env[keyName] : "";
-            const storedKey = keys[catalogProvider.name] || keys[catalogId];
-            providersWithKeys.push({
-                name: catalogProvider.name ?? catalogId,
-                slug: catalogId,
-                url: catalogProvider.doc ?? "",
-                keyName,
-                authType: "APIKey",
-                api: catalogProvider.api ?? "",
-                apiKey: storedKey ?? envFileKey ?? processEnvKey ?? "",
-            });
-        }
-    }
-    return c.json(providersWithKeys);
-}
-//# sourceMappingURL=providers-get.route.js.map

package/dist/features/providers/providers-open-external.route.d.ts

@@ -1,15 +0,0 @@
-/**
- * POST /api/providers/open-external
- * Opens an external URL using the system's default browser
- */
-import type { Context } from "hono";
-export declare function openExternalUrl(c: Context): Promise<(Response & import("hono").TypedResponse<{
-    error: string;
-}, 400, "json">) | (Response & import("hono").TypedResponse<{
-    success: true;
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
-    error: string;
-}, 501, "json">) | (Response & import("hono").TypedResponse<{
-    error: string;
-}, 500, "json">)>;
-//# sourceMappingURL=providers-open-external.route.d.ts.map

package/dist/features/providers/providers-open-external.route.js

@@ -1,49 +0,0 @@
-/**
- * POST /api/providers/open-external
- * Opens an external URL using the system's default browser
- */
-let Utils = null;
-let utilsLoaded = false;
-// Lazy load Utils from electrobun (optional - may not be available in pure server mode)
-async function loadUtils() {
-    if (utilsLoaded)
-        return;
-    utilsLoaded = true;
-    try {
-        const electrobun = await import("electrobun/bun");
-        Utils = electrobun.Utils;
-    }
-    catch {
-        // electrobun not available in pure server mode - that's OK
-    }
-}
-export async function openExternalUrl(c) {
-    try {
-        await loadUtils();
-        const { url } = await c.req.json();
-        if (!url || typeof url !== "string") {
-            return c.json({ error: "URL is required and must be a string" }, 400);
-        }
-        // Validate URL format
-        try {
-            new URL(url);
-        }
-        catch {
-            return c.json({ error: "Invalid URL format" }, 400);
-        }
-        // Open the URL in the system's default browser (only available in desktop mode)
-        if (Utils) {
-            await Utils.openExternal(url);
-            return c.json({ success: true });
-        }
-        else {
-            console.error(`External URL opening not available in server mode: ${url}`);
-            return c.json({ error: "External URL opening not available in server mode" }, 501);
-        }
-    }
-    catch (error) {
-        console.error("Failed to open external URL:", error);
-        return c.json({ error: "Failed to open URL" }, 500);
-    }
-}
-//# sourceMappingURL=providers-open-external.route.js.map

package/dist/features/providers/providers-post-bulk-keys.route.d.ts

@@ -1,14 +0,0 @@
-/**
- * POST /api/providers/bulk-keys
- * Save all provider API keys at once
- */
-import type { Context } from "hono";
-import type { MetadataManager } from "../metadata/metadata.manager.js";
-export declare function postProviderBulkKeys(c: Context, metadataManager: MetadataManager): Promise<(Response & import("hono").TypedResponse<{
-    error: string;
-}, 400, "json">) | (Response & import("hono").TypedResponse<{
-    success: true;
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
-    error: string;
-}, 500, "json">)>;
-//# sourceMappingURL=providers-post-bulk-keys.route.d.ts.map

package/dist/features/providers/providers-post-bulk-keys.route.js

@@ -1,31 +0,0 @@
-/**
- * POST /api/providers/bulk-keys
- * Save all provider API keys at once
- */
-import { updateEnvFile } from "../../core/env-manager.js";
-import { resolveProviderKeyName } from "./provider-resolver.js";
-export async function postProviderBulkKeys(c, metadataManager) {
-    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 (from catalog or hardcoded)
-        const envUpdates = {};
-        for (const [providerName, apiKey] of Object.entries(keys)) {
-            const keyName = await resolveProviderKeyName(providerName);
-            if (keyName) {
-                envUpdates[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: ${String(error)}` }, 500);
-    }
-}
-//# sourceMappingURL=providers-post-bulk-keys.route.js.map