tarsk 0.4.4 → 0.4.6

package/dist/agent/agent.prompt-loader.js

@@ -1,227 +0,0 @@
-/**
- * System prompt loader for Pi Agent
- * Loads agent system prompt from agents.md file with fallback
- */
-import { resolve } from "path";
-import { readFileSync } from "fs";
-import { analyzeProject } from "../project-analyzer.js";
-import { RuleManager } from "../features/rules/rules.manager.js";
-import { devServerCache } from "../core/dev-server-cache.js";
-/**
- * Default prompt used when agents.md cannot be loaded
- */
-const DEFAULT_PROMPT = "You are a helpful coding assistant. You have access to read, bash, edit, todo, and write tools. Use them to explore and modify the codebase as needed. Break tasks down into smaller, manageable steps using the todo tool.";
-const PLAN_MODE_INSTRUCTIONS = `
-
-# Plan Mode (ACTIVE)
-
-You are currently in PLAN MODE. You MUST follow these constraints strictly:
-
-## What you MUST do:
-- Analyze the user's request thoroughly
-- Create a clear, structured plan with numbered steps
-- Identify all files that would need to be created, modified, or deleted
-- Explain the reasoning behind each step
-- Highlight complexity and potential risks for each step
-- Present the plan for user review and approval
-
-## What you MUST NOT do:
-- Do NOT use any tools that modify files (Write, Edit, Bash with write operations)
-- Do NOT create, delete, or modify any files
-- Do NOT run any commands that change system state (npm install, git commit, etc.)
-- You MAY use read-only tools (Read, Glob, Grep, Bash with read-only commands like ls, cat, git status, git log, git diff) to explore the codebase
-
-## Output format:
-Structure your response as:
-1. **Understanding**: Brief summary of what the user wants
-2. **Plan**: Numbered steps with file paths and descriptions of changes
-3. **Files to modify**: List of files with what changes each needs
-4. **Considerations**: Any risks, trade-offs, or questions
-
-YOU MUST use the ask_user tool to ask clarifying questions if needed and to confirm implementation of the plan.
-
-Remember: You are ONLY planning. Do NOT execute any changes.`;
-/**
- * Load agents.md content as developer context
- */
-function loadDeveloperContext(threadPath) {
-    try {
-        // Path to agents.md in the thread directory
-        const agentsPath = resolve(threadPath, "agents.md");
-        const agentsContent = readFileSync(agentsPath, "utf-8").trim();
-        console.log("[ai] Successfully loaded agents.md from thread path for developer context");
-        return agentsContent;
-    }
-    catch (error) {
-        // Gracefully fall back if agents.md not found
-        const isFileNotFound = error && typeof error === "object" && "code" in error && error.code === "ENOENT";
-        if (isFileNotFound) {
-            console.log("[ai] agents.md not found in thread path, skipping developer context");
-        }
-        else {
-            console.warn("[ai] Error loading agents.md from thread path:", error instanceof Error ? error.message : String(error));
-        }
-        return "";
-    }
-}
-/**
- * Load and format rules for the prompt
- */
-async function loadRulesSection(threadPath) {
-    try {
-        const ruleManager = new RuleManager();
-        const rules = await ruleManager.loadRules(threadPath);
-        if (rules.length > 0) {
-            const rulesSection = ruleManager.formatRulesForPrompt(rules);
-            console.log(`[ai] Loaded ${rules.length} rule(s) from .agents/rules directory`);
-            return rulesSection;
-        }
-        return "";
-    }
-    catch (error) {
-        console.warn("[ai] Error loading rules:", error instanceof Error ? error.message : String(error));
-        return "";
-    }
-}
-/**
- * Check if dev server is running and reachable for the thread
- */
-async function loadDevServerSection(threadPath) {
-    try {
-        // Extract thread ID from path (last part of the path)
-        const threadId = threadPath.split(/[\\/]/).pop() ?? "unknown";
-        // Check if there's a cached URL for this thread
-        const cachedUrl = devServerCache.getUrl(threadId);
-        if (!cachedUrl) {
-            return "";
-        }
-        // Check if the dev server is reachable
-        try {
-            const response = await fetch(cachedUrl, {
-                method: "HEAD",
-                signal: AbortSignal.timeout(3000), // 3 second timeout
-            });
-            if (response.ok) {
-                console.log(`[ai] Dev server is running at ${cachedUrl} for thread ${threadId}`);
-                return `\n\n# Dev Server\n\nThe dev server is running at ${cachedUrl}.`;
-            }
-            else {
-                console.log(`[ai] Dev server at ${cachedUrl} responded with status ${response.status} for thread ${threadId}`);
-                return "";
-            }
-        }
-        catch (fetchError) {
-            console.log(`[ai] Dev server at ${cachedUrl} is not reachable for thread ${threadId}:`, fetchError instanceof Error ? fetchError.message : String(fetchError));
-            return "";
-        }
-    }
-    catch (error) {
-        console.warn("[ai] Error checking dev server status:", error instanceof Error ? error.message : String(error));
-        return "";
-    }
-}
-/**
- * Load project analysis section
- */
-function loadProjectAnalysisSection(threadPath) {
-    try {
-        const projectAnalysis = analyzeProject(threadPath);
-        if (projectAnalysis) {
-            return "\n\n# Project Analysis\n\n" + projectAnalysis;
-        }
-        return "";
-    }
-    catch (error) {
-        console.warn("[ai] Error analyzing project:", error instanceof Error ? error.message : String(error));
-        return "";
-    }
-}
-/**
- * Format skills for the prompt
- */
-function formatSkillsSection(skills) {
-    if (!skills || skills.length === 0) {
-        return "";
-    }
-    let skillsSection = "\n\n# Available Skills\n\n";
-    skillsSection +=
-        "The following skills are available for this session. Use them to enhance your capabilities:\n\n";
-    for (const skill of skills) {
-        skillsSection += `## ${skill.name}\n\n`;
-        skillsSection += `**Description**: ${skill.description}\n\n`;
-        if (skill.compatibility) {
-            skillsSection += `**Compatibility**: ${skill.compatibility}\n\n`;
-        }
-        skillsSection += skill.instructions;
-        skillsSection += "\n\n---\n\n";
-    }
-    console.log(`[ai] Injected ${skills.length} skill(s) into system prompt: ${skills.map((s) => s.name).join(", ")}`);
-    return skillsSection;
-}
-/**
- * Format available agents for injection into the system prompt
- */
-function formatAgentsSection(agents) {
-    const invocable = agents.filter((a) => !a.disableModelInvocation);
-    if (invocable.length === 0)
-        return "";
-    let section = "\n\n# Available Agents\n\n" +
-        "Use the `agent` tool to delegate focused subtasks to these specialized agents. " +
-        "Each agent runs in an isolated context and returns its result.\n\n";
-    for (const agent of invocable) {
-        section += `## ${agent.name}\n\n`;
-        section += `**Description**: ${agent.description}\n`;
-        section += `**Invoke as**: \`agentName: "${agent.name}"\`\n\n`;
-    }
-    console.log(`[ai] Injected ${invocable.length} agent(s) into system prompt: ${invocable.map((a) => a.name).join(", ")}`);
-    return section;
-}
-/**
- * Load agent system prompt from agents.md file
- * System prompt is the DEFAULT_PROMPT, agents.md is appended as developer context
- *
- * @param threadPath - Path to the thread directory (required)
- * @param skills - Optional array of activated skills to inject into the prompt
- * @param planMode - Optional flag to enable plan mode instructions
- * @param agents - Optional array of available agent definitions to inject into the prompt
- */
-export async function loadAgentSystemPrompt(threadPath, skills, planMode, agents) {
-    // Start with the default prompt
-    let prompt = DEFAULT_PROMPT;
-    // Load and append developer context
-    const agentsContent = loadDeveloperContext(threadPath);
-    if (agentsContent) {
-        prompt += "\n\n# Developer Context\n\n" + agentsContent;
-    }
-    // Load and append rules
-    const rulesSection = await loadRulesSection(threadPath);
-    if (rulesSection) {
-        prompt += rulesSection;
-    }
-    // Append project analysis
-    const projectAnalysisSection = loadProjectAnalysisSection(threadPath);
-    if (projectAnalysisSection) {
-        prompt += projectAnalysisSection;
-    }
-    // Append dev server status
-    const devServerSection = await loadDevServerSection(threadPath);
-    if (devServerSection) {
-        prompt += devServerSection;
-    }
-    // Append plan mode instructions if enabled
-    if (planMode) {
-        prompt += PLAN_MODE_INSTRUCTIONS;
-    }
-    // Append skills section
-    const skillsSection = formatSkillsSection(skills ?? []);
-    if (skillsSection) {
-        prompt += skillsSection;
-    }
-    // Append agents section
-    const agentsSection = formatAgentsSection(agents ?? []);
-    if (agentsSection) {
-        prompt += agentsSection;
-    }
-    return prompt;
-}
-//# sourceMappingURL=agent.prompt-loader.js.map

package/dist/agent/agent.subagent-executor.d.ts

@@ -1,35 +0,0 @@
-/**
- * Subagent executor
- *
- * Runs an isolated agent invocation with a controlled tool set.
- * Used by the agent tool to spawn subagents for focused subtasks.
- * Unlike PiExecutorImpl, tools are passed in rather than built internally,
- * which allows callers to restrict which tools the subagent can use.
- */
-import type { AgentEvent } from "@tarsk/shared";
-import type { MetadataManager } from "../features/metadata/metadata.manager.js";
-import type { Tool } from "../tools/index.js";
-export interface SubagentOptions {
-    /** The task prompt for the subagent */
-    prompt: string;
-    /** System prompt to use (from AGENT.md or a default) */
-    systemPrompt: string;
-    /** Pre-filtered tool set the subagent is allowed to use */
-    tools: Tool[];
-    /** Model identifier (provider-prefixed, e.g. "anthropic/claude-opus-4-6") */
-    model: string;
-    /** Provider name (e.g. "anthropic") */
-    provider: string;
-    /** MetadataManager for API key resolution */
-    metadataManager: MetadataManager;
-    /** Callback for each event emitted during subagent execution */
-    onEvent: (event: AgentEvent) => void;
-    /** Optional abort signal */
-    signal?: AbortSignal;
-}
-/**
- * Execute a subagent and return its final result text.
- * All events are reported via onEvent for the parent to stream.
- */
-export declare function executeSubagent(options: SubagentOptions): Promise<string>;
-//# sourceMappingURL=agent.subagent-executor.d.ts.map

package/dist/agent/agent.subagent-executor.js

@@ -1,135 +0,0 @@
-/**
- * Subagent executor
- *
- * Runs an isolated agent invocation with a controlled tool set.
- * Used by the agent tool to spawn subagents for focused subtasks.
- * Unlike PiExecutorImpl, tools are passed in rather than built internally,
- * which allows callers to restrict which tools the subagent can use.
- */
-import { Agent } from "@mariozechner/pi-agent-core";
-import { resolveProviderConfig } from "../features/providers/provider-resolver.js";
-import { resolveModel } from "./agent.model-resolver.js";
-import { EventQueue } from "./agent.event-transformer.js";
-import { getErrorCode, formatErrorEvent } from "./agent.error-utils.js";
-/**
- * Execute a subagent and return its final result text.
- * All events are reported via onEvent for the parent to stream.
- */
-export async function executeSubagent(options) {
-    const { prompt, systemPrompt, tools, metadataManager, onEvent, signal } = options;
-    const providerName = options.provider;
-    let model = options.model.trim().replace(`${providerName.toLowerCase()}/`, "");
-    const providerConfig = await resolveProviderConfig(providerName);
-    if (!providerConfig) {
-        throw new Error(`Unknown provider for subagent: ${providerName}`);
-    }
-    let apiKey = providerConfig.env && providerConfig.env.length > 0
-        ? process.env[providerConfig.env[0]]
-        : undefined;
-    if (!apiKey) {
-        const providerKeys = await metadataManager.getProviderKeys();
-        apiKey = providerKeys[providerConfig.name];
-    }
-    if (!apiKey) {
-        throw new Error(`No API key found for subagent provider: ${providerName}. ` +
-            `Set ${providerConfig.env && providerConfig.env.length > 0 ? providerConfig.env[0] : "an API key"} ` +
-            `in environment variables or configuration.`);
-    }
-    const resolvedModel = resolveModel(providerName, model, providerConfig);
-    console.log(`[subagent] Starting with model=${resolvedModel.id}, tools=${tools.map((t) => t.name).join(",")}`);
-    const agent = new Agent({
-        initialState: {
-            systemPrompt,
-            model: resolvedModel,
-            tools,
-        },
-        getApiKey: async () => apiKey,
-    });
-    const eventQueue = new EventQueue();
-    let done = false;
-    let aborted = false;
-    const onAbort = () => {
-        if (aborted)
-            return;
-        aborted = true;
-        agent.abort();
-        done = true;
-        eventQueue.notify();
-    };
-    if (signal) {
-        if (signal.aborted)
-            return "";
-        signal.addEventListener("abort", onAbort, { once: true });
-    }
-    const unsubscribe = agent.subscribe((event) => {
-        eventQueue.handlePiEvent(event);
-        // Drain the queue immediately and forward events to the parent
-        while (eventQueue.length > 0) {
-            const e = eventQueue.shift();
-            if (e)
-                onEvent(e);
-        }
-    });
-    const promptDone = agent
-        .prompt(prompt)
-        .then(() => {
-        done = true;
-        eventQueue.notify();
-    })
-        .catch((err) => {
-        const errMessage = err instanceof Error ? err.message : String(err);
-        console.error(`[subagent] Agent prompt failed:`, errMessage);
-        if (!eventQueue.errorOccurred) {
-            eventQueue.errorOccurred = true;
-            const errorEvent = {
-                type: "error",
-                content: errMessage,
-                error: {
-                    code: getErrorCode(err) ?? "SUBAGENT_EXECUTION_ERROR",
-                    message: errMessage,
-                    details: { stack: err instanceof Error ? err.stack : undefined },
-                },
-            };
-            onEvent(errorEvent);
-        }
-        done = true;
-        eventQueue.notify();
-    });
-    try {
-        // Drain any remaining queued events while waiting for completion
-        while (!done || eventQueue.length > 0) {
-            if (eventQueue.length > 0) {
-                const e = eventQueue.shift();
-                if (e)
-                    onEvent(e);
-            }
-            else {
-                await new Promise((resolve) => {
-                    eventQueue.setResolver(resolve);
-                });
-            }
-        }
-        if (!aborted) {
-            await promptDone;
-            // Drain any final events
-            while (eventQueue.length > 0) {
-                const e = eventQueue.shift();
-                if (e)
-                    onEvent(e);
-            }
-        }
-        return eventQueue.finalContent;
-    }
-    catch (error) {
-        onEvent(formatErrorEvent(error));
-        return "";
-    }
-    finally {
-        if (signal)
-            signal.removeEventListener("abort", onAbort);
-        unsubscribe();
-        agent.abort();
-        eventQueue.clearResolver();
-    }
-}
-//# sourceMappingURL=agent.subagent-executor.js.map

package/dist/bun/index.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/bun/index.js

@@ -1,165 +0,0 @@
-import Electrobun, { BrowserWindow, PATHS, ApplicationMenu } from "electrobun/bun";
-import path from "path";
-import { Utils } from "electrobun/bun";
-import { startTarskServer } from "../server.js";
-import { logger } from "../core/logger.js";
-// Setup logging to capture all console output
-logger.setupLogging();
-const args = process.argv.slice(2);
-const isDebug = args.includes("--debug");
-console.log(`Startup: isDebug=${isDebug} electroBun=${!!Electrobun}`);
-if (!isDebug && !Electrobun) {
-    console.log = () => { };
-}
-async function showLogs() {
-    Utils.showItemInFolder(logger.getLogFilePath());
-}
-async function checkForAppUpdate() {
-    try {
-        // Skip update checks in dev mode
-        let info = undefined;
-        try {
-            console.log(`checkForAppUpdate.getLocalInfo()`);
-            info = await Electrobun.Updater.getLocallocalInfo();
-            console.log(`checkForAppUpdate`, info);
-        }
-        catch (e) {
-            console.warn("Failed to get local info", e);
-            //return;
-        }
-        console.log(`checkForAppUpdate.checkForUpdate()`);
-        const updateInfo = await Electrobun.Updater.checkForUpdate();
-        console.log(`checkForAppUpdate.checkForUpdate()`, updateInfo);
-        if (!updateInfo?.updateAvailable) {
-            console.log("No updates available");
-            Utils.showNotification({
-                title: "No Updates Available",
-            });
-            return;
-        }
-        Utils.showNotification({
-            title: "Downloading Update",
-        });
-        console.log(`checkForAppUpdate.downloadUpdate()`);
-        await Electrobun.Updater.downloadUpdate();
-        console.log(`checkForAppUpdate.downloadUpdate() completed`);
-        if (Electrobun.Updater.updateInfo()?.updateReady) {
-            Utils.showNotification({
-                title: "Applying Update",
-            });
-            console.log(`checkForAppUpdate.applyUpdate()`);
-            await Electrobun.Updater.applyUpdate();
-            console.log(`checkForAppUpdate.applyUpdate() completed`);
-        }
-    }
-    catch (error) {
-        if (isDebug) {
-            console.error("Failed to check/apply update", error);
-        }
-    }
-}
-// Setup application menu with version info
-const setupMenu = async () => {
-    try {
-        // Skip version info and updates in dev mode
-        let version = "Unknown";
-        let includeUpdateMenu = false;
-        try {
-            const localInfo = await Electrobun.Updater.getLocallocalInfo();
-            console.log(`Local info:`, localInfo);
-            version = localInfo.version;
-            includeUpdateMenu = true;
-        }
-        catch (e) {
-            // In dev mode, version.json doesn't exist - this is expected
-            console.log(`Version check failed: ${String(e)}`);
-        }
-        const tarskSubmenu = [
-            {
-                label: `Version ${version}`,
-                action: "show-version",
-                enabled: false,
-                type: "normal",
-            },
-        ];
-        if (includeUpdateMenu) {
-            tarskSubmenu.push({ type: "separator" }, // eslint-disable-line @typescript-eslint/no-explicit-any
-            {
-                label: "Check for Updates",
-                action: "check-for-updates",
-                type: "normal",
-            });
-        }
-        tarskSubmenu.push({ type: "separator" }, // eslint-disable-line @typescript-eslint/no-explicit-any
-        {
-            label: "View Logs",
-            action: "view-logs",
-            type: "normal",
-        }, { type: "separator" }, // eslint-disable-line @typescript-eslint/no-explicit-any
-        { role: "quit" });
-        const menu = [
-            {
-                label: "Tarsk",
-                submenu: tarskSubmenu,
-            },
-            {
-                label: "Edit",
-                submenu: [
-                    { role: "undo" },
-                    { role: "redo" },
-                    { type: "separator" }, // eslint-disable-line @typescript-eslint/no-explicit-any
-                    { role: "cut" },
-                    { role: "copy" },
-                    { role: "paste" },
-                    { role: "selectAll" },
-                ],
-            },
-        ];
-        ApplicationMenu.setApplicationMenu(menu); // eslint-disable-line @typescript-eslint/no-explicit-any
-        Electrobun.events.on("application-menu-clicked", async (e) => {
-            switch (e.data.action) {
-                case "view-logs":
-                    await showLogs();
-                    break;
-                case "check-for-updates":
-                    await checkForAppUpdate();
-                    break;
-                default:
-                    break;
-            }
-        });
-    }
-    catch (error) {
-        if (isDebug) {
-            console.error("Failed to setup menu:", error);
-        }
-    }
-};
-console.log(`index.ts setupMenu()`);
-await setupMenu();
-// Check for updates on startup
-//void checkForAppUpdate();
-const publicDir = path.join(PATHS.VIEWS_FOLDER, "public");
-const { url } = await startTarskServer({
-    isDebug,
-    openBrowser: false,
-    publicDir,
-    updater: {
-        checkForUpdate: () => Electrobun.Updater.checkForUpdate(),
-        downloadUpdate: () => Electrobun.Updater.downloadUpdate(),
-        applyUpdate: () => Electrobun.Updater.applyUpdate(),
-        getUpdateInfo: () => Electrobun.Updater.updateInfo(),
-    },
-});
-new BrowserWindow({
-    title: "Tarsk",
-    transparent: false,
-    url,
-    frame: {
-        width: 1320,
-        height: 860,
-        x: 120,
-        y: 80,
-    },
-});
-//# sourceMappingURL=index.js.map

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-import { spawnProcess } from "./core/utils.js";
-import { fileURLToPath } from "url";
-import path from "path";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-// Run the main index.js with --open flag to open browser
-const indexPath = path.join(__dirname, "index.js");
-const args = [...process.argv.slice(2), "--open"];
-const child = spawnProcess("node", [indexPath, ...args], {
-    stdio: "inherit",
-});
-process.on("SIGINT", () => {
-    child.kill("SIGINT");
-});
-process.on("SIGTERM", () => {
-    child.kill("SIGTERM");
-});
-child.on("exit", (code) => {
-    process.exit(code ?? 0);
-});
-//# sourceMappingURL=cli.js.map

package/dist/core/crypto.d.ts

@@ -1,29 +0,0 @@
-/**
- * Crypto utilities for encrypting/decrypting sensitive data
- *
- * Uses AES-256-GCM encryption with a machine-specific key derived from
- * unchanging machine identifiers.
- */
-/**
- * Encrypt a string value
- *
- * @param plaintext - The string to encrypt
- * @returns Base64-encoded encrypted data in format: iv:authTag:ciphertext
- */
-export declare function encrypt(plaintext: string): Promise<string>;
-/**
- * Decrypt an encrypted string value
- *
- * @param encryptedData - Base64-encoded encrypted data in format: iv:authTag:ciphertext
- * @returns The decrypted plaintext string
- * @throws Error if decryption fails (wrong key, corrupted data, etc.)
- */
-export declare function decrypt(encryptedData: string): Promise<string>;
-/**
- * Check if a string appears to be encrypted
- *
- * @param value - The string to check
- * @returns true if the string appears to be in encrypted format
- */
-export declare function isEncrypted(value: string): boolean;
-//# sourceMappingURL=crypto.d.ts.map