@agenthippo-ai/agenthippo 0.1.0

package/out/agentpack/paths.js

@@ -0,0 +1,475 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_CONSTANTS = void 0;
+exports.getAgentideHome = getAgentideHome;
+exports.getUserAgentsDir = getUserAgentsDir;
+exports.getUserSkillsDir = getUserSkillsDir;
+exports.getUserSkillDir = getUserSkillDir;
+exports.getUserMcpDir = getUserMcpDir;
+exports.getUserMcpServerDir = getUserMcpServerDir;
+exports.getUserAgentRoot = getUserAgentRoot;
+exports.getUserAgentVersionDir = getUserAgentVersionDir;
+exports.getUserAgentCurrentPath = getUserAgentCurrentPath;
+exports.getAgentideDir = getAgentideDir;
+exports.getAgentsDir = getAgentsDir;
+exports.getAgentRoot = getAgentRoot;
+exports.resolveAgentRuntimePaths = resolveAgentRuntimePaths;
+exports.resolveRuntimePaths = resolveRuntimePaths;
+exports.isDefaultAgent = isDefaultAgent;
+exports.getAgentManifestPath = getAgentManifestPath;
+exports.getAgentAgentsMdPath = getAgentAgentsMdPath;
+exports.getAgentContextPath = getAgentContextPath;
+exports.getAgentSkillsDir = getAgentSkillsDir;
+exports.getAgentRulesDir = getAgentRulesDir;
+exports.getAgentMcpDir = getAgentMcpDir;
+exports.getSessionsDir = getSessionsDir;
+exports.parseAgentIdFromPath = parseAgentIdFromPath;
+exports.isValidPackName = isValidPackName;
+exports.normalizePackName = normalizePackName;
+exports.getPackNameError = getPackNameError;
+exports.packNameToTitle = packNameToTitle;
+exports.stripModelProviderPrefix = stripModelProviderPrefix;
+exports.generateDefaultAgentYaml = generateDefaultAgentYaml;
+exports.generateAgentYaml = generateAgentYaml;
+exports.generateAgentsMd = generateAgentsMd;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const branding_1 = require("../branding");
+/**
+ * Constants for agent directory structure.
+ * All agents (including default) live under .agentide/agents/<agentId>/
+ */
+exports.AGENT_CONSTANTS = {
+    // The reserved agent ID for the workspace's default agent
+    DEFAULT_AGENT_ID: 'default',
+    // Directory names
+    AGENTIDE_DIR_NAME: branding_1.AGENTIDE_DIR_NAME,
+    AGENTS_DIR: 'agents',
+    RULES_DIR: 'rules',
+    SKILLS_DIR: 'skills',
+    MCP_DIR: 'mcp',
+    SESSIONS_DIR: 'sessions',
+    // File names
+    MANIFEST_FILE: 'agent.yaml',
+    AGENTS_MD: 'AGENTS.md',
+    GHOST_TEXT_FILE: 'GHOST_TEXT.md',
+    TERMINAL_ASSIST_FILE: 'TERMINAL_ASSIST.md',
+    CLAUDE_MD: 'CLAUDE.md',
+    CONTEXT_MD: 'context.md',
+    // Provenance file (tracks where a workspace agent came from)
+    SOURCE_FILE: '.agentide-source.json',
+    // UAL version pointer file
+    CURRENT_VERSION_FILE: 'current.txt',
+};
+// -----------------------------------------------------------------------------
+// User Agent Library (UAL) Paths
+// -----------------------------------------------------------------------------
+/**
+ * Get the AGENTHIPPO_HOME directory (User Agent Library root).
+ * Respects AGENTHIPPO_HOME env var, defaults to ~/.agent-hippo
+ */
+function getAgentideHome() {
+    return process.env.AGENTHIPPO_HOME || path.join(os.homedir(), exports.AGENT_CONSTANTS.AGENTIDE_DIR_NAME);
+}
+/**
+ * Get the User Agent Library agents directory.
+ * ${AGENTHIPPO_HOME}/agents/
+ */
+function getUserAgentsDir() {
+    return process.env.AGENTIDE_USER_AGENTS_DIR || path.join(getAgentideHome(), exports.AGENT_CONSTANTS.AGENTS_DIR);
+}
+/**
+ * Get the User Library skills directory.
+ * ${AGENTHIPPO_HOME}/skills/
+ */
+function getUserSkillsDir() {
+    return path.join(getAgentideHome(), exports.AGENT_CONSTANTS.SKILLS_DIR);
+}
+/**
+ * Get the path to a specific skill in the User Library.
+ * ${AGENTHIPPO_HOME}/skills/<skillSlug>/
+ */
+function getUserSkillDir(skillSlug) {
+    return path.join(getUserSkillsDir(), skillSlug);
+}
+/**
+ * Get the User Library MCP directory.
+ * ${AGENTHIPPO_HOME}/mcp/
+ */
+function getUserMcpDir() {
+    return path.join(getAgentideHome(), exports.AGENT_CONSTANTS.MCP_DIR);
+}
+/**
+ * Get the path to a specific MCP in the User Library.
+ * ${AGENTHIPPO_HOME}/mcp/<mcpSlug>/
+ */
+function getUserMcpServerDir(mcpSlug) {
+    return path.join(getUserMcpDir(), mcpSlug);
+}
+/**
+ * Get the UAL root for a specific agent.
+ * ${AGENTHIPPO_HOME}/agents/<agentId>/
+ */
+function getUserAgentRoot(agentId) {
+    return path.join(getUserAgentsDir(), agentId);
+}
+/**
+ * Get the path to a specific version in the UAL.
+ * ${AGENTHIPPO_HOME}/agents/<agentId>/<version>/
+ */
+function getUserAgentVersionDir(agentId, version) {
+    return path.join(getUserAgentRoot(agentId), version);
+}
+/**
+ * Get the path to current.txt pointer file in the UAL.
+ * ${AGENTHIPPO_HOME}/agents/<agentId>/current.txt
+ */
+function getUserAgentCurrentPath(agentId) {
+    return path.join(getUserAgentRoot(agentId), exports.AGENT_CONSTANTS.CURRENT_VERSION_FILE);
+}
+/**
+ * Get the .agentide directory path for a workspace.
+ */
+function getAgentideDir(workspaceRoot) {
+    return path.join(workspaceRoot, exports.AGENT_CONSTANTS.AGENTIDE_DIR_NAME);
+}
+/**
+ * Get the agents directory path (.agentide/agents/).
+ */
+function getAgentsDir(workspaceRoot) {
+    return path.join(getAgentideDir(workspaceRoot), exports.AGENT_CONSTANTS.AGENTS_DIR);
+}
+/**
+ * Get the root directory for a specific agent.
+ */
+function getAgentRoot(workspaceRoot, agentId) {
+    return path.join(getAgentsDir(workspaceRoot), agentId);
+}
+/**
+ * Resolve runtime paths for any agent (default or pack).
+ * All agents have the same structure under .agentide/agents/<agentId>/
+ */
+function resolveAgentRuntimePaths(workspaceRoot, storageUri, agentId, agentVersion = '0.0.0') {
+    const agentRoot = getAgentRoot(workspaceRoot, agentId);
+    return {
+        agentId,
+        agentVersion,
+        // Agent content paths
+        agentRoot,
+        rulesDir: path.join(agentRoot, exports.AGENT_CONSTANTS.RULES_DIR),
+        skillsDir: path.join(agentRoot, exports.AGENT_CONSTANTS.SKILLS_DIR),
+        mcpDir: path.join(agentRoot, exports.AGENT_CONSTANTS.MCP_DIR),
+        // Derived directories (at workspace root - synced from active agent)
+        codexDerivedDir: path.join(workspaceRoot, '.codex'),
+        claudeDerivedDir: path.join(workspaceRoot, '.claude'),
+        // SDK config directories (in VS Code storage, isolated per agent)
+        codexHome: path.join(storageUri, exports.AGENT_CONSTANTS.AGENTS_DIR, agentId, 'codex'),
+        claudeConfigDir: path.join(storageUri, exports.AGENT_CONSTANTS.AGENTS_DIR, agentId, 'claude'),
+    };
+}
+/**
+ * Resolve runtime paths for the active agent.
+ * If no agentId provided, returns paths for the default agent.
+ */
+function resolveRuntimePaths(workspaceRoot, storageUri, agentId, agentVersion) {
+    const effectiveAgentId = agentId ?? exports.AGENT_CONSTANTS.DEFAULT_AGENT_ID;
+    return resolveAgentRuntimePaths(workspaceRoot, storageUri, effectiveAgentId, agentVersion);
+}
+/**
+ * Check if an agent is the default workspace agent.
+ */
+function isDefaultAgent(agentId) {
+    return agentId === exports.AGENT_CONSTANTS.DEFAULT_AGENT_ID;
+}
+/**
+ * Get the path to an agent's manifest file (agent.yaml).
+ */
+function getAgentManifestPath(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.MANIFEST_FILE);
+}
+/**
+ * Get the path to an agent's AGENTS.md file.
+ */
+function getAgentAgentsMdPath(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.AGENTS_MD);
+}
+/**
+ * Get the path to an agent's context.md file.
+ */
+function getAgentContextPath(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.CONTEXT_MD);
+}
+/**
+ * Get the path to an agent's skills directory.
+ */
+function getAgentSkillsDir(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.SKILLS_DIR);
+}
+/**
+ * Get the path to an agent's rules directory.
+ */
+function getAgentRulesDir(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.RULES_DIR);
+}
+/**
+ * Get the path to an agent's MCP directory.
+ */
+function getAgentMcpDir(workspaceRoot, agentId) {
+    return path.join(getAgentRoot(workspaceRoot, agentId), exports.AGENT_CONSTANTS.MCP_DIR);
+}
+/**
+ * Get the sessions directory path (.agentide/sessions/).
+ * Sessions are shared across all agents.
+ */
+function getSessionsDir(workspaceRoot) {
+    return path.join(getAgentideDir(workspaceRoot), exports.AGENT_CONSTANTS.SESSIONS_DIR);
+}
+/**
+ * Parse agent ID from an agent root path.
+ */
+function parseAgentIdFromPath(agentRoot) {
+    const parts = agentRoot.split(path.sep);
+    const agentsIdx = parts.lastIndexOf(exports.AGENT_CONSTANTS.AGENTS_DIR);
+    if (agentsIdx !== -1 && parts.length > agentsIdx + 1) {
+        return parts[agentsIdx + 1];
+    }
+    return undefined;
+}
+// -----------------------------------------------------------------------------
+// Pack Name Validation
+// -----------------------------------------------------------------------------
+/**
+ * Characters that are not allowed in pack names (path separators and problematic chars).
+ */
+const INVALID_PACK_NAME_CHARS = /[/\\:*?"<>|]/;
+/**
+ * Check if a pack name is valid.
+ * Pack names just need to be non-empty and valid as directory names.
+ */
+function isValidPackName(name) {
+    if (!name || name.trim().length === 0) {
+        return false;
+    }
+    // Reject path separators and other problematic filesystem characters
+    if (INVALID_PACK_NAME_CHARS.test(name)) {
+        return false;
+    }
+    // Reject hidden directories (starting with .)
+    if (name.startsWith('.')) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Normalize a pack name to a clean, filesystem-safe format.
+ * - Trims whitespace
+ * - Converts to lowercase
+ * - Replaces spaces and underscores with hyphens
+ * - Removes consecutive hyphens
+ * - Removes leading/trailing hyphens
+ *
+ * @example "My Code Reviewer" -> "my-code-reviewer"
+ * @example "  Code_Review  " -> "code-review"
+ */
+function normalizePackName(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, '-') // Replace spaces/underscores with hyphens
+        .replace(/-+/g, '-') // Collapse multiple hyphens
+        .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
+}
+/**
+ * Get an error message for an invalid pack name, or undefined if valid.
+ * Note: Call normalizePackName first to clean the input.
+ */
+function getPackNameError(name) {
+    if (!name || name.trim().length === 0) {
+        return 'Pack name is required';
+    }
+    if (INVALID_PACK_NAME_CHARS.test(name)) {
+        return 'Pack name cannot contain path separators or special characters (/ \\ : * ? " < > |)';
+    }
+    if (name.startsWith('.')) {
+        return 'Pack name cannot start with a dot';
+    }
+    return undefined;
+}
+/**
+ * Convert a pack name (hyphenated, underscored, or spaced) to Title Case for display.
+ */
+function packNameToTitle(name) {
+    // Split on common separators: hyphens, underscores, spaces
+    return name.split(/[-_\s]+/).map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
+}
+// -----------------------------------------------------------------------------
+// Model ID Utilities
+// -----------------------------------------------------------------------------
+/**
+ * Strip provider prefixes from model IDs for cleaner storage in agent.yaml.
+ * E.g., 'agentide-litellm::litellm/gpt-4.1-nano' -> 'litellm/gpt-4.1-nano'
+ *
+ * @param modelId The full model identifier with possible provider prefix
+ * @returns The model ID without the provider prefix
+ */
+function stripModelProviderPrefix(modelId) {
+    // Common provider prefixes: 'agentide-litellm::', 'agentide::', etc.
+    const prefixMatch = modelId.match(/^[a-z0-9-]+::/i);
+    if (prefixMatch) {
+        return modelId.slice(prefixMatch[0].length);
+    }
+    return modelId;
+}
+// -----------------------------------------------------------------------------
+// Pack Scaffold Templates
+// -----------------------------------------------------------------------------
+/**
+ * Generate the default workspace agent manifest (agent.yaml).
+ * Used by multiple bootstrapping/reset paths to keep defaults consistent.
+ */
+function generateDefaultAgentYaml(options = {}) {
+    const { engine = 'claude', model, includeHeaderComments = true, includeModelHintComment = false, } = options;
+    const normalizedModel = model ? stripModelProviderPrefix(model) : undefined;
+    return [
+        ...(includeHeaderComments ? [
+            '# Agent Hippo Pack Configuration',
+            '# This is the default agent pack for agenthippo.',
+            '# Edit this file to customize the agent\'s behavior.',
+            '',
+        ] : []),
+        'apiVersion: agenthippo.ai/v1',
+        'kind: Agent',
+        'metadata:',
+        '  name: default',
+        '  version: "1.0.0"',
+        '  description: "agent hippo"',
+        'spec:',
+        '  # Preferred engine (claude or codex)',
+        `  engine: ${engine}`,
+        ...(normalizedModel
+            ? [`  model: ${normalizedModel}`]
+            : (includeModelHintComment
+                ? [
+                    '  # Model to use (optional - uses engine default if not specified)',
+                    '  # model: claude-sonnet-4-20250514',
+                ]
+                : [])),
+        '  permissions:',
+        '    # File access scope for this agent:',
+        '    # - read-only: no file writes',
+        '    # - workspace-write: writes limited to workspace folders',
+        '    # - full: full filesystem access (yolo)',
+        '    fileAccess: full',
+        '  visibility: internal',
+        '',
+    ].join('\n');
+}
+/**
+ * Generate agent.yaml content for a new pack.
+ */
+function generateAgentYaml(packName, options = {}) {
+    const { description = `A specialized agent for ${packNameToTitle(packName).toLowerCase()} tasks`, engine = 'claude', author = process.env.USER || 'unknown', } = options;
+    // Use provided model or default based on engine
+    // Strip provider prefixes for cleaner yaml (e.g., 'agentide-litellm::litellm/gpt-4.1-nano' -> 'litellm/gpt-4.1-nano')
+    const rawModel = options.model ?? (engine === 'claude' ? 'claude-sonnet-4' : 'codex');
+    const model = stripModelProviderPrefix(rawModel);
+    const cheapModel = options.cheapModel ? stripModelProviderPrefix(options.cheapModel) : undefined;
+    return [
+        `# ${packName} Agent Manifest`,
+        'apiVersion: agenthippo.ai/v1',
+        'kind: Agent',
+        'metadata:',
+        `  name: ${packName}`,
+        '  version: 0.1.0',
+        `  author: ${author}`,
+        `  description: ${description}`,
+        '',
+        'spec:',
+        `  engine: ${engine}`,
+        `  model: ${model}`,
+        ...(cheapModel ? [`  cheapModel: ${cheapModel}`] : []),
+        '',
+        '  skills: []',
+        '  # Uncomment to add skills:',
+        '  # - path: ./skills/my-skill',
+        '',
+        '  # Optional: seed pack data into workspace on first use (target missing/empty)',
+        '  # Remove this block if your pack has no data files.',
+        '  # data:',
+        '  #   sourcePath: ./data',
+        `  #   workspacePath: ${exports.AGENT_CONSTANTS.AGENTIDE_DIR_NAME}/data/${packName}`,
+        '',
+        '  permissions:',
+        '    # File access scope for this pack:',
+        '    # - read-only: no file writes',
+        '    # - workspace-write: writes limited to workspace folders',
+        '    # - full: full filesystem access (yolo)',
+        '    fileAccess: full',
+        '',
+        '  visibility: internal',
+        '',
+    ].join('\n');
+}
+/**
+ * Generate AGENTS.md content for a new pack.
+ */
+function generateAgentsMd(packName, options = {}) {
+    const title = packNameToTitle(packName);
+    const description = options.description || `A specialized agent for ${title.toLowerCase()} tasks.`;
+    return `# ${title} Agent
+
+${description}
+
+## Core Behaviors
+
+1. Follow user instructions precisely
+2. Explain reasoning before making changes
+3. Ask for clarification when requirements are ambiguous
+
+## Constraints
+
+- Stay within the scope of the task
+- Prefer simple solutions over complex ones
+- Test changes before committing
+
+## Output Format
+
+Provide clear, actionable responses with code examples when relevant.
+`;
+}