atabey 0.0.15 → 0.0.17

package/framework-mcp/dist/utils/errors.js

@@ -1,68 +0,0 @@
-/**
- * Enterprise Base Error class for the Agent Atabey Framework.
- */
-export class AtabeyBaseError extends Error {
-    code;
-    timestamp;
-    details;
-    solution;
-    constructor(message, code = "ATABEY_INTERNAL_ERROR", details, solution) {
-        super(message);
-        this.name = this.constructor.name;
-        this.code = code;
-        this.timestamp = new Date();
-        this.details = details;
-        this.solution = solution;
-        // Ensure proper prototype chain and capture stack trace
-        Object.setPrototypeOf(this, new.target.prototype);
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-    }
-    /**
-     * Converts the error into a structured JSON log format.
-     */
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            timestamp: this.timestamp.toISOString(),
-            details: this.details,
-            solution: this.solution,
-            stack: this.stack,
-        };
-    }
-}
-/**
- * Thrown when configuration loading or validation fails.
- */
-export class ConfigurationError extends AtabeyBaseError {
-    constructor(message, details, solution) {
-        super(message, "CONFIGURATION_ERROR", details, solution);
-    }
-}
-/**
- * Thrown when data schema or payload validation fails.
- */
-export class ValidationError extends AtabeyBaseError {
-    constructor(message, details, solution) {
-        super(message, "VALIDATION_ERROR", details, solution);
-    }
-}
-/**
- * Thrown when adapter initialization or execution fails.
- */
-export class AdapterError extends AtabeyBaseError {
-    constructor(message, adapterId, details, solution) {
-        super(`Adapter '${adapterId}' failure: ${message}`, "ADAPTER_ERROR", details, solution);
-    }
-}
-/**
- * Thrown when orchestration or agent communication fails.
- */
-export class OrchestrationError extends AtabeyBaseError {
-    constructor(message, details, solution) {
-        super(message, "ORCHESTRATION_ERROR", details, solution);
-    }
-}

package/framework-mcp/dist/utils/fs.js

@@ -1,44 +0,0 @@
-import fs from "fs";
-import path from "path";
-/**
- * Ensures directory existence.
- */
-export function ensureDir(dirPath) {
-    if (!fs.existsSync(dirPath)) {
-        fs.mkdirSync(dirPath, { recursive: true });
-    }
-}
-/**
- * Atomically writes a text file.
- */
-export function writeTextFileAtomic(filePath, content) {
-    const dir = path.dirname(filePath);
-    ensureDir(dir);
-    const tempPath = `${filePath}.${Math.random().toString(36).slice(2, 9)}.tmp`;
-    const finalContent = content.endsWith("\n") ? content : `${content}\n`;
-    try {
-        fs.writeFileSync(tempPath, finalContent, "utf8");
-        fs.renameSync(tempPath, filePath);
-    }
-    catch (err) {
-        if (fs.existsSync(tempPath)) {
-            try {
-                fs.unlinkSync(tempPath);
-            }
-            catch { /* ignore */ }
-        }
-        throw err;
-    }
-}
-/**
- * Atomically appends to a file (if supported by OS) or simulates it.
- * Note: Real atomic append on POSIX is a single write() call with O_APPEND.
- * For simplicity and robustness across platforms, we use a simple append here
- * as the risk of corruption is lower than a full rewrite, but for logs
- * it's acceptable.
- */
-export function appendFileSafe(filePath, content) {
-    const dir = path.dirname(filePath);
-    ensureDir(dir);
-    fs.appendFileSync(filePath, content, "utf8");
-}

package/framework-mcp/dist/utils/memory.js

@@ -1,74 +0,0 @@
-import fs from "fs";
-import os from "os";
-import path from "path";
-const CWD = process.cwd();
-const HOME = os.homedir();
-const FRAMEWORK = {
-    CORE_DIR: ".atabey",
-};
-const FRAMEWORK_DIR_CANDIDATES = [
-    ".atabey",
-    ".agents",
-    ".claude",
-    ".gemini",
-    ".grok",
-    ".cursor",
-];
-const MCP = {
-    TEST_DIR_ENV: "ATABEY_TEST_DIR",
-};
-function findFrameworkDir(basePath) {
-    try {
-        const pkgPath = path.join(basePath, "package.json");
-        if (fs.existsSync(pkgPath)) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-            if (pkg.atabey && typeof pkg.atabey.frameworkDir === "string") {
-                const customDir = path.join(basePath, pkg.atabey.frameworkDir);
-                if (fs.existsSync(customDir))
-                    return customDir;
-            }
-        }
-    }
-    catch {
-        // ignore
-    }
-    return null;
-}
-export function isFrameworkDevelopmentRepo() {
-    try {
-        const pkgPath = path.join(CWD, "package.json");
-        if (fs.existsSync(pkgPath)) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-            if (pkg.name === "atabey") {
-                return true;
-            }
-        }
-    }
-    catch {
-        // ignore
-    }
-    return false;
-}
-export function getConfigDir() {
-    const localDir = findFrameworkDir(CWD);
-    if (localDir)
-        return localDir;
-    // Check for standard local directories if package.json doesn't specify
-    const localCandidates = [...FRAMEWORK_DIR_CANDIDATES, ".agent"];
-    for (const cand of localCandidates) {
-        const p = path.join(CWD, cand);
-        if (fs.existsSync(p))
-            return p;
-    }
-    // In dev repo, don't fall back to global dir. Point to local default.
-    if (isFrameworkDevelopmentRepo()) {
-        return path.join(CWD, FRAMEWORK.CORE_DIR);
-    }
-    return path.join(HOME, FRAMEWORK.CORE_DIR);
-}
-export function getFrameworkDir() {
-    const testDir = process.env[MCP.TEST_DIR_ENV];
-    if (testDir)
-        return testDir;
-    return getConfigDir();
-}

package/framework-mcp/dist/utils/metrics.js

@@ -1,56 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { resolveFrameworkDir } from "./security.js";
-export const Metrics = {
-    /**
-     * Estimates tokens based on character count (rough heuristic: 1 token ~= 4 chars).
-     */
-    estimateTokens: (text) => {
-        return Math.ceil(text.length / 4);
-    },
-    /**
-     * Logs the token usage and action to the observability metrics file.
-     */
-    logUsage: (projectRoot, agent, action, tokens) => {
-        Metrics.saveMetric(projectRoot, {
-            timestamp: new Date().toISOString(),
-            agent,
-            action,
-            estimatedTokens: tokens
-        });
-    },
-    /**
-     * Logs an error occurrence to the observability metrics file.
-     */
-    logError: (projectRoot, agent, action, error) => {
-        Metrics.saveMetric(projectRoot, {
-            timestamp: new Date().toISOString(),
-            agent,
-            action: `ERROR: ${action}`,
-            estimatedTokens: 0,
-            error
-        });
-    },
-    /**
-     * Internal helper to save metric entries.
-     */
-    saveMetric: (projectRoot, entry) => {
-        const frameworkDir = resolveFrameworkDir(projectRoot);
-        const metricsPath = path.join(projectRoot, frameworkDir, "observability/metrics.json");
-        try {
-            const metricsDir = path.dirname(metricsPath);
-            if (!fs.existsSync(metricsDir))
-                fs.mkdirSync(metricsDir, { recursive: true });
-            let currentMetrics = [];
-            if (fs.existsSync(metricsPath)) {
-                currentMetrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
-            }
-            currentMetrics.push(entry);
-            // Keep only last 100 entries to save space
-            if (currentMetrics.length > 100)
-                currentMetrics.shift();
-            fs.writeFileSync(metricsPath, JSON.stringify(currentMetrics, null, 2));
-        }
-        catch { /* ignore: metrics should not block the main process */ }
-    }
-};

package/framework-mcp/dist/utils/permissions.js

@@ -1,71 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { resolveFrameworkDir } from "./security.js";
-function globToRegex(glob) {
-    const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-    const step1 = escaped.replace(/\*\*/g, "__DBL_STR__");
-    const step2 = step1.replace(/\*/g, "[^/]*");
-    const regexStr = "^" + step2.replace(/__DBL_STR__/g, ".*") + "$";
-    return new RegExp(regexStr);
-}
-/**
- * Validates if the active agent has write permission for the target file.
- * Automatically identifies the active agent by checking the status.json store
- * for the agent in the "EXECUTING" state.
- */
-export function verifyWritePermission(projectRoot, targetFilePath) {
-    const frameworkDir = resolveFrameworkDir(projectRoot);
-    const absoluteFrameworkPath = path.isAbsolute(frameworkDir)
-        ? frameworkDir
-        : path.resolve(projectRoot, frameworkDir);
-    const matrixPath = path.join(absoluteFrameworkPath, "permission-matrix.json");
-    // If no permission matrix exists, skip enforcement (default allow)
-    if (!fs.existsSync(matrixPath)) {
-        return;
-    }
-    let matrix;
-    try {
-        matrix = JSON.parse(fs.readFileSync(matrixPath, "utf8"));
-    }
-    catch (e) {
-        throw new Error(`Failed to parse permission-matrix.json: ${String(e)}`, { cause: e });
-    }
-    // Determine the active agent from status.json
-    const statusPath = path.join(absoluteFrameworkPath, "memory", "status.json");
-    let activeAgent = null;
-    if (fs.existsSync(statusPath)) {
-        try {
-            const status = JSON.parse(fs.readFileSync(statusPath, "utf8"));
-            // Find an agent that is currently in the EXECUTING state
-            for (const [agentName, info] of Object.entries(status)) {
-                const data = info;
-                if (data.state === "EXECUTING") {
-                    activeAgent = agentName.startsWith("@") ? agentName : `@${agentName}`;
-                    break;
-                }
-            }
-        }
-        catch (e) {
-            // Log warning but don't crash, default to allowing if status can't be parsed
-            process.stderr.write(`[Permissions] Warning: Failed to read status.json: ${String(e)}\n`);
-        }
-    }
-    // If no active executing agent is found, default to allowing
-    if (!activeAgent) {
-        return;
-    }
-    const agentRules = matrix[activeAgent];
-    // If no rules defined for the agent, default to allowing
-    if (!agentRules || !agentRules.write) {
-        return;
-    }
-    // Resolve target path relative to project root for glob matching
-    const relativeTargetPath = path.relative(projectRoot, path.resolve(projectRoot, targetFilePath));
-    const allowed = agentRules.write.some(glob => {
-        const regex = globToRegex(glob);
-        return regex.test(relativeTargetPath);
-    });
-    if (!allowed) {
-        throw new Error(`Permission Denied: Agent ${activeAgent} is not authorized to write to "${relativeTargetPath}". Matrix rules restrict writes to: [${agentRules.write.join(", ")}].`);
-    }
-}

package/framework-mcp/dist/utils/security.js

@@ -1,60 +0,0 @@
-import path from "path";
-import fs from "fs";
-import { FRAMEWORK, MCP, UNIFIED_HUB_DIR } from "../constants.js"; // New import
-import os from "os"; // Need os.homedir()
-/**
- * Validates and resolves a user-provided path to prevent path traversal attacks.
- * Ensures the resolved path stays within the project root boundary.
- */
-export function safePath(projectRoot, userPath) {
-    const resolved = path.resolve(projectRoot, userPath);
-    const normalizedRoot = path.resolve(projectRoot);
-    if (!resolved.startsWith(normalizedRoot + path.sep) && resolved !== normalizedRoot) {
-        throw new Error(`Access denied: path "${userPath}" escapes project root.`);
-    }
-    return resolved;
-}
-/**
- * Resolves the active framework directory.
- * Priority: ATABEY_TEST_DIR (env) -> package.json `atabey.frameworkDir` -> `.atabey` -> other adapter dirs -> global HOME.
- */
-export function resolveFrameworkDir(projectRoot) {
-    // For test environments, use the explicitly set test directory.
-    const testDir = process.env[MCP.TEST_DIR_ENV];
-    if (testDir)
-        return testDir;
-    // 1. Authoritative source: read from package.json if present
-    try {
-        const pkgPath = path.join(projectRoot, "package.json");
-        if (fs.existsSync(pkgPath)) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-            const atabeyConfig = pkg["atabey"];
-            if (atabeyConfig && typeof atabeyConfig["frameworkDir"] === "string") {
-                // Ensure the path is relative if it's within the project, otherwise use as-is.
-                const resolvedDir = path.resolve(projectRoot, atabeyConfig["frameworkDir"]);
-                if (resolvedDir.startsWith(path.resolve(projectRoot))) {
-                    return path.relative(projectRoot, resolvedDir);
-                }
-                return atabeyConfig["frameworkDir"];
-            }
-        }
-    }
-    catch {
-        // ignore — fall through to filesystem scan
-    }
-    // 2. Filesystem scan in projectRoot for common framework directories
-    const localCandidates = [
-        FRAMEWORK.CORE_DIR, // .atabey
-        UNIFIED_HUB_DIR, // .agents
-        // Add other adapter specific directories if needed, or remove if unified is strictly enforced
-    ];
-    for (const candidate of localCandidates) {
-        const candidatePath = path.join(projectRoot, candidate);
-        if (fs.existsSync(candidatePath)) {
-            return candidate;
-        }
-    }
-    // 3. Fallback to global home directory.
-    const homeDir = os.homedir();
-    return path.join(homeDir, FRAMEWORK.CORE_DIR);
-}

package/framework-mcp/dist/utils/storage.js

@@ -1,207 +0,0 @@
-import Database from "better-sqlite3";
-import path from "path";
-import fs from "fs";
-import { getFrameworkDir } from "./memory.js";
-/**
- * [DB] Atabey Storage Engine
- * Central SQLite database for enterprise-scale agent state management.
- */
-export class Storage {
-    static db = null;
-    static getDB() {
-        if (!this.db) {
-            const frameworkDir = getFrameworkDir();
-            if (!fs.existsSync(frameworkDir)) {
-                fs.mkdirSync(frameworkDir, { recursive: true });
-            }
-            const dbPath = path.join(frameworkDir, "atabey.db");
-            this.db = new Database(dbPath);
-            this.initializeSchema();
-        }
-        return this.db;
-    }
-    static initializeSchema() {
-        const db = this.db;
-        // Agents Table
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS agents (
-                name TEXT PRIMARY KEY,
-                state TEXT DEFAULT 'READY',
-                task TEXT DEFAULT 'Idle',
-                last_updated DATETIME DEFAULT CURRENT_TIMESTAMP
-            )
-        `);
-        // Messages (Hermes) Table
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS messages (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
-                sender TEXT,
-                receiver TEXT,
-                category TEXT,
-                content TEXT,
-                trace_id TEXT,
-                parent_id TEXT,
-                status TEXT DEFAULT 'PENDING',
-                priority TEXT DEFAULT 'NORMAL',
-                requires_approval BOOLEAN DEFAULT 0
-            )
-        `);
-        // Tasks Table
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS tasks (
-                id TEXT PRIMARY KEY,
-                trace_id TEXT,
-                description TEXT,
-                agent TEXT,
-                status TEXT DEFAULT 'PENDING',
-                priority TEXT DEFAULT 'NORMAL',
-                dependencies TEXT, -- JSON Array
-                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-            )
-        `);
-        // Logs Table
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS logs (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
-                agent TEXT,
-                action TEXT,
-                trace_id TEXT,
-                status TEXT,
-                summary TEXT,
-                findings TEXT
-            )
-        `);
-        // Metadata (State) Table
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS metadata (
-                key TEXT PRIMARY KEY,
-                value TEXT
-            )
-        `);
-    }
-    // --- Agent Operations ---
-    static updateAgentStatus(name, state, task, lastUpdated) {
-        const db = this.getDB();
-        const cleanName = name.replace("@", "");
-        const timestamp = lastUpdated || new Date().toISOString();
-        db.prepare(`
-            INSERT INTO agents (name, state, task, last_updated) 
-            VALUES (?, ?, ?, ?)
-            ON CONFLICT(name) DO UPDATE SET 
-                state = excluded.state,
-                task = excluded.task,
-                last_updated = excluded.last_updated
-        `).run(cleanName, state, task, timestamp);
-    }
-    static getAllAgents() {
-        return this.getDB().prepare("SELECT * FROM agents").all();
-    }
-    // --- Message Operations ---
-    static saveMessage(msg) {
-        const db = this.getDB();
-        db.prepare(`
-            INSERT INTO messages (sender, receiver, category, content, trace_id, parent_id, status, priority, requires_approval)
-            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-        `).run(msg.from, msg.to, msg.category, msg.content, msg.traceId, msg.parentId || null, msg.status || "PENDING", msg.priority || "NORMAL", msg.requiresApproval ? 1 : 0);
-    }
-    static getPendingMessages() {
-        const rows = this.getDB().prepare("SELECT * FROM messages WHERE status IN ('PENDING', 'APPROVED') ORDER BY priority DESC, timestamp ASC").all();
-        return rows.map(r => ({
-            id: r.id,
-            timestamp: r.timestamp,
-            from: r.sender,
-            to: r.receiver,
-            category: r.category,
-            content: r.content,
-            traceId: r.trace_id,
-            parentId: r.parent_id || undefined,
-            status: r.status,
-            priority: r.priority,
-            requiresApproval: r.requires_approval === 1
-        }));
-    }
-    static updateMessageStatus(id, status) {
-        this.getDB().prepare("UPDATE messages SET status = ? WHERE id = ?").run(status, id);
-    }
-    // --- Task Operations ---
-    static saveTask(task) {
-        const db = this.getDB();
-        db.prepare(`
-            INSERT INTO tasks (id, trace_id, description, agent, status, priority, dependencies)
-            VALUES (?, ?, ?, ?, ?, ?, ?)
-            ON CONFLICT(id) DO UPDATE SET
-                status = excluded.status,
-                description = excluded.description
-        `).run(task.id, task.traceId, task.description, task.agent, task.status, task.priority, JSON.stringify(task.dependencies || []));
-    }
-    static getTasks(traceId) {
-        const db = this.getDB();
-        let rows;
-        if (traceId) {
-            rows = db.prepare("SELECT * FROM tasks WHERE trace_id = ?").all(traceId);
-        }
-        else {
-            rows = db.prepare("SELECT * FROM tasks").all();
-        }
-        return rows.map(r => {
-            let deps = [];
-            try {
-                const parsed = JSON.parse(r.dependencies || "[]");
-                // Handle cases where dependencies might be double-stringified or are raw JSON strings
-                deps = Array.isArray(parsed) ? parsed : JSON.parse(parsed);
-            }
-            catch {
-                // Keep empty array
-            }
-            return {
-                id: r.id,
-                traceId: r.trace_id,
-                description: r.description,
-                agent: r.agent,
-                status: r.status,
-                priority: r.priority,
-                dependencies: deps
-            };
-        });
-    }
-    static getLogs(agentName) {
-        const db = this.getDB();
-        let rows;
-        const cleanName = agentName ? agentName.replace("@", "") : undefined;
-        if (cleanName) {
-            rows = db.prepare("SELECT * FROM logs WHERE agent = ? ORDER BY timestamp DESC").all(cleanName);
-        }
-        else {
-            rows = db.prepare("SELECT * FROM logs ORDER BY timestamp DESC").all();
-        }
-        return rows.map(r => ({
-            id: r.id,
-            timestamp: r.timestamp,
-            agent: r.agent,
-            action: r.action,
-            trace_id: r.trace_id || undefined,
-            status: r.status,
-            summary: r.summary,
-            findings: r.findings || undefined
-        }));
-    }
-    // --- Metadata Operations ---
-    static setMetadata(key, value) {
-        this.getDB().prepare(`
-            INSERT INTO metadata (key, value) VALUES (?, ?)
-            ON CONFLICT(key) DO UPDATE SET value = excluded.value
-        `).run(key, value);
-    }
-    static getMetadata(key) {
-        const row = this.getDB().prepare("SELECT value FROM metadata WHERE key = ?").get(key);
-        return row ? row.value : null;
-    }
-    static reset() {
-        if (this.db) {
-            this.db.close();
-            this.db = null;
-        }
-    }
-}

package/framework-mcp/dist/utils/types.js

@@ -1,16 +0,0 @@
-/**
- * Agent Atabey Framework — Internal Branded Types
- * Used to enforce absolute type safety within the core orchestration logic.
- */
-/**
- * Casts a raw string to a Branded Type.
- * Use this only at the boundaries of the system.
- */
-export function asTraceID(val) { return val; }
-export function asAgentID(val) { return val; }
-export function asPhaseID(val) { return val; }
-export function asProjectPath(val) { return val; }
-export function asMessageID(val) { return val; }
-export function asTaskID(val) { return val; }
-export function asLogID(val) { return val; }
-export function asPlanID(val) { return val; }

package/framework-mcp/dist/utils/zod-to-mcp.js

@@ -1,77 +0,0 @@
-import { z } from "zod";
-/**
- * A surgical converter to transform Zod schemas into MCP-compliant JSON schemas.
- * This ensures "Single Source of Truth" and eliminates Type Drift.
- */
-export function zodToMcpSchema(schema) {
-    const jsonSchema = {
-        type: "object",
-        properties: {},
-        required: []
-    };
-    const shape = schema.shape;
-    for (const key in shape) {
-        const field = shape[key];
-        const { type, properties, required } = parseZodField(field);
-        jsonSchema.properties[key] = {
-            type,
-            ...(properties || {})
-        };
-        if (required) {
-            jsonSchema.required.push(key);
-        }
-    }
-    if (jsonSchema.required.length === 0) {
-        delete jsonSchema.required;
-    }
-    return jsonSchema;
-}
-function parseZodField(field) {
-    let type = "string";
-    let properties = {};
-    let isRequired = !field.isOptional() && !field.isNullable();
-    let unwrapped = field;
-    // Handle Optional/Nullable
-    while (unwrapped instanceof z.ZodOptional || unwrapped instanceof z.ZodNullable || unwrapped instanceof z.ZodDefault) {
-        if (unwrapped instanceof z.ZodDefault) {
-            properties.default = unwrapped._def.defaultValue();
-        }
-        unwrapped = unwrapped._def.innerType;
-    }
-    // Handle Branded Types
-    if (unwrapped instanceof z.ZodBranded) {
-        unwrapped = unwrapped._def.type;
-    }
-    if (unwrapped instanceof z.ZodString) {
-        type = "string";
-        const checks = unwrapped._def.checks;
-        for (const check of checks) {
-            if (check.kind === "regex")
-                properties.pattern = check.regex.source;
-            if (check.kind === "min")
-                properties.minLength = check.value;
-        }
-    }
-    else if (unwrapped instanceof z.ZodNumber) {
-        type = "number";
-    }
-    else if (unwrapped instanceof z.ZodBoolean) {
-        type = "boolean";
-    }
-    else if (unwrapped instanceof z.ZodEnum) {
-        type = "string";
-        properties.enum = unwrapped._def.values;
-    }
-    else if (unwrapped instanceof z.ZodArray) {
-        type = "array";
-        const itemType = parseZodField(unwrapped._def.type);
-        properties.items = { type: itemType.type, ...(itemType.properties || {}) };
-    }
-    else if (unwrapped instanceof z.ZodObject) {
-        type = "object";
-        const nested = zodToMcpSchema(unwrapped);
-        properties.properties = nested.properties;
-        properties.required = nested.required;
-    }
-    return { type, properties, required: isRequired };
-}