@agenthippo-ai/agenthippo 1.110.9 → 1.110.19

package/out/agentpack/paths.js

@@ -1,498 +0,0 @@
-"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.userScopedEngineHome = userScopedEngineHome;
-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 crypto = __importStar(require("crypto"));
-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);
-}
-/**
- * Key an engine's SDK state dir (CODEX_HOME / claudeConfigDir) by the verified request
- * user in multi-tenant serve/headless deployments (secure-obo-design §8 Phase 0).
- *
- * The base dir is per-agent, not per-user — under concurrent turns of different users the
- * codex engine rewrites the shared config.toml per turn, so one user's engine can launch
- * pointed at another user's per-turn credential state. Scoping the home per verified user
- * makes any remaining config race same-user (same credential ⇒ harmless).
- *
- * Returns the base dir unchanged when no verified user is in scope: the IDE and
- * single-tenant CLI paths have no `runWithCredential` frame and must be unaffected.
- * The user id is hashed — it is an email/subject, never safe as a raw path segment.
- */
-function userScopedEngineHome(baseHome, verifiedUserId) {
-    const uid = verifiedUserId?.trim();
-    if (!uid) {
-        return baseHome;
-    }
-    const hash = crypto.createHash('sha256').update(uid).digest('hex').slice(0, 16);
-    return path.join(baseHome, 'users', hash);
-}
-/**
- * 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.
-`;
-}