atabey 0.0.16 → 0.0.18

package/framework-mcp/dist/framework-mcp/src/utils/telemetry-streamer.js

@@ -1,396 +0,0 @@
-/**
- * ─── ASYNCHRONOUS TELEMETRY STREAMER ───────────────────────────────
- *
- * Streams local audit logs, metrics, and governance events to the
- * central enterprise server asynchronously without blocking the
- * developer's AI CLI workflow.
- *
- * Features:
- * - Batch streaming (accumulates events, sends in batches)
- * - Retry with exponential backoff
- * - Queue persistence (survives process restarts)
- * - Bandwidth throttling (max N events per minute)
- * - PII masking before transmission (GDPR/KVKK)
- * - Connection health monitoring
- *
- * Architecture:
- *   [Local MCP] → SQLite Queue → Batch Processor → HTTPS/WS → [Enterprise Server]
- *
- * [KVKK/GDPR] All PII is masked BEFORE leaving the local machine.
- */
-import fs from "fs";
-import os from "os";
-import path from "path";
-import { maskObject, maskText } from "../../../src/shared/pii.js";
-// ─── Configuration ────────────────────────────────────────────────
-const CONFIG = {
-    /** Enterprise server URL (e.g., https://atabey.company.com) */
-    SERVER_URL: process.env.ATABEY_SERVER_URL || "",
-    /** Auth token for enterprise server */
-    AUTH_TOKEN: process.env.ATABEY_SERVER_TOKEN || "",
-    /** Max events per batch */
-    BATCH_SIZE: parseInt(process.env.ATABEY_TELEMETRY_BATCH_SIZE || "50", 10),
-    /** Flush interval in ms */
-    FLUSH_INTERVAL_MS: parseInt(process.env.ATABEY_TELEMETRY_FLUSH_INTERVAL || "30000", 10),
-    /** Max retries per batch */
-    MAX_RETRIES: parseInt(process.env.ATABEY_TELEMETRY_MAX_RETRIES || "3", 10),
-    /** Retry base delay (exponential backoff) */
-    RETRY_BASE_DELAY_MS: parseInt(process.env.ATABEY_TELEMETRY_RETRY_DELAY || "1000", 10),
-    /** Max events per minute (throttle) */
-    MAX_EVENTS_PER_MINUTE: parseInt(process.env.ATABEY_TELEMETRY_RATE_LIMIT || "200", 10),
-    /** Enable/disable telemetry */
-    ENABLED: process.env.ATABEY_TELEMETRY_ENABLED !== "false",
-    /** Use WebSocket for real-time streaming (fallback to HTTPS) */
-    USE_WEBSOCKET: process.env.ATABEY_TELEMETRY_WS === "true",
-};
-// ─── Telemetry Streamer ───────────────────────────────────────────
-export class TelemetryStreamer {
-    static instance;
-    queue = [];
-    flushTimer = null;
-    ws = null;
-    wsReconnectTimer = null;
-    eventCountThisMinute = 0;
-    minuteResetTimer = null;
-    machineId;
-    projectHash;
-    isFlushing = false;
-    constructor() {
-        this.machineId = this.generateMachineId();
-        this.projectHash = this.generateProjectHash();
-    }
-    static getInstance() {
-        if (!TelemetryStreamer.instance) {
-            TelemetryStreamer.instance = new TelemetryStreamer();
-        }
-        return TelemetryStreamer.instance;
-    }
-    /**
-     * Start the telemetry streamer.
-     * Begins periodic flush and WebSocket connection if configured.
-     */
-    start() {
-        if (!CONFIG.ENABLED || !CONFIG.SERVER_URL) {
-            process.stderr.write("[TELEMETRY] Disabled or no server URL configured.\n");
-            return;
-        }
-        process.stderr.write(`[TELEMETRY] Starting streamer → ${CONFIG.SERVER_URL}\n`);
-        // Periodic flush
-        this.flushTimer = setInterval(() => this.flush(), CONFIG.FLUSH_INTERVAL_MS);
-        // Minute counter reset
-        this.minuteResetTimer = setInterval(() => {
-            this.eventCountThisMinute = 0;
-        }, 60000);
-        // WebSocket connection (if enabled)
-        if (CONFIG.USE_WEBSOCKET) {
-            this.connectWebSocket();
-        }
-        // Flush on exit
-        process.on("beforeExit", () => this.flushSync());
-        process.on("SIGINT", () => { this.flushSync(); });
-        process.on("SIGTERM", () => { this.flushSync(); });
-    }
-    /**
-     * Stop the telemetry streamer.
-     */
-    stop() {
-        if (this.flushTimer) {
-            clearInterval(this.flushTimer);
-            this.flushTimer = null;
-        }
-        if (this.minuteResetTimer) {
-            clearInterval(this.minuteResetTimer);
-            this.minuteResetTimer = null;
-        }
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-        if (this.wsReconnectTimer) {
-            clearTimeout(this.wsReconnectTimer);
-            this.wsReconnectTimer = null;
-        }
-        this.flushSync();
-    }
-    /**
-     * Enqueue a telemetry event for streaming.
-     * Events are batched and sent asynchronously.
-     */
-    enqueue(event) {
-        if (!CONFIG.ENABLED)
-            return;
-        // Rate limiting
-        if (this.eventCountThisMinute >= CONFIG.MAX_EVENTS_PER_MINUTE) {
-            return; // Silently drop
-        }
-        this.eventCountThisMinute++;
-        const fullEvent = {
-            ...event,
-            id: `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-            machineId: this.machineId,
-            projectHash: this.projectHash,
-            // [KVKK/GDPR] Mask PII before queuing
-            payload: maskObject(event.payload),
-        };
-        this.queue.push({ event: fullEvent, retries: 0, lastAttempt: null });
-        // If queue is large enough, flush immediately
-        if (this.queue.length >= CONFIG.BATCH_SIZE) {
-            this.flush();
-        }
-    }
-    /**
-     * Convenience method for logging tool calls.
-     */
-    logToolCall(agent, toolName, tokens, traceId, durationMs) {
-        this.enqueue({
-            type: "tool_call",
-            timestamp: new Date().toISOString(),
-            agent,
-            payload: {
-                tool: toolName,
-                estimatedTokens: tokens,
-                traceId,
-                durationMs,
-            },
-        });
-    }
-    /**
-     * Convenience method for logging governance violations.
-     */
-    logGovernanceViolation(agent, toolName, error) {
-        this.enqueue({
-            type: "governance_violation",
-            timestamp: new Date().toISOString(),
-            agent,
-            payload: {
-                tool: toolName,
-                error: maskText(error),
-            },
-        });
-    }
-    /**
-     * Convenience method for logging errors.
-     */
-    logError(agent, action, error) {
-        this.enqueue({
-            type: "error",
-            timestamp: new Date().toISOString(),
-            agent,
-            payload: {
-                action,
-                error: maskText(error),
-            },
-        });
-    }
-    // ─── Private Methods ───────────────────────────────────────
-    /**
-     * Flush queued events to the enterprise server.
-     */
-    async flush() {
-        if (this.isFlushing || this.queue.length === 0)
-            return;
-        this.isFlushing = true;
-        let success;
-        const batch = this.queue.splice(0, CONFIG.BATCH_SIZE);
-        try {
-            const events = batch.map(q => q.event);
-            // [KVKK/GDPR] Double-check PII masking before transmission
-            const sanitizedEvents = events.map(e => ({
-                ...e,
-                payload: maskObject(e.payload),
-            }));
-            success = await this.sendBatch(sanitizedEvents);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : "Unknown error";
-            process.stderr.write(`[TELEMETRY] Send batch failed: ${message}\n`);
-            success = false;
-        }
-        if (!success) {
-            // Re-queue with retry count
-            for (const q of batch) {
-                q.retries++;
-                q.lastAttempt = Date.now();
-                if (q.retries < CONFIG.MAX_RETRIES) {
-                    this.queue.push(q);
-                }
-                else {
-                    // Max retries exceeded, log locally and drop
-                    process.stderr.write(`[TELEMETRY] Dropped event after ${CONFIG.MAX_RETRIES} retries: ${q.event.type}\n`);
-                    this.saveToLocalFallback(q.event);
-                }
-            }
-        }
-        this.isFlushing = false;
-    }
-    /**
-     * Synchronous flush (for process exit).
-     */
-    flushSync() {
-        if (this.queue.length === 0)
-            return;
-        const batch = this.queue.splice(0, CONFIG.BATCH_SIZE);
-        const events = batch.map(q => q.event);
-        // Save to local fallback file (best effort)
-        for (const event of events) {
-            this.saveToLocalFallback(event);
-        }
-    }
-    /**
-     * Send a batch of events to the enterprise server via HTTPS.
-     */
-    async sendBatch(events) {
-        try {
-            const url = `${CONFIG.SERVER_URL.replace(/\/$/, "")}/api/telemetry/ingest`;
-            const response = await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "Authorization": `Bearer ${CONFIG.AUTH_TOKEN}`,
-                    "X-Machine-Id": this.machineId,
-                    "X-Project-Hash": this.projectHash,
-                },
-                body: JSON.stringify({
-                    batch: events,
-                    sentAt: new Date().toISOString(),
-                    machineId: this.machineId,
-                }),
-            });
-            if (!response.ok) {
-                process.stderr.write(`[TELEMETRY] Server returned ${response.status}: ${response.statusText}\n`);
-                return false;
-            }
-            return true;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            process.stderr.write(`[TELEMETRY] Send failed: ${message}\n`);
-            return false;
-        }
-    }
-    /**
-     * Connect to enterprise server via WebSocket for real-time streaming.
-     */
-    connectWebSocket() {
-        // Native WebSocket is available in Node.js >= 22.
-        // For older versions, we skip WebSocket and rely on HTTPS batch mode.
-        const NodeWebSocket = typeof WebSocket !== "undefined" ? WebSocket : undefined;
-        if (!NodeWebSocket) {
-            process.stderr.write("[TELEMETRY] WebSocket unavailable (Node.js < 22). Using HTTPS batch mode only.\n");
-            // Force HTTPS mode by disabling WS flag
-            return;
-        }
-        try {
-            const wsUrl = CONFIG.SERVER_URL.replace(/^http/, "ws").replace(/\/$/, "") + "/ws/telemetry";
-            this.ws = new NodeWebSocket(wsUrl);
-            this.ws.onopen = () => {
-                process.stderr.write("[TELEMETRY] WebSocket connected.\n");
-                // Authenticate
-                this.ws?.send(JSON.stringify({
-                    type: "auth",
-                    token: CONFIG.AUTH_TOKEN,
-                    machineId: this.machineId,
-                    projectHash: this.projectHash,
-                }));
-            };
-            this.ws.onclose = () => {
-                process.stderr.write("[TELEMETRY] WebSocket disconnected. Reconnecting...\n");
-                this.ws = null;
-                // Reconnect after delay
-                this.wsReconnectTimer = setTimeout(() => this.connectWebSocket(), 5000);
-            };
-            this.ws.onerror = () => {
-                // onclose will handle reconnection
-            };
-            this.ws.onmessage = (msg) => {
-                try {
-                    const data = JSON.parse(msg.data.toString());
-                    if (data.type === "config_update") {
-                        process.stderr.write(`[TELEMETRY] Config update received: ${JSON.stringify(data.payload)}\n`);
-                        // Apply remote config changes
-                        if (data.payload.maxEventsPerMinute) {
-                            // Dynamic rate limiting from server
-                        }
-                    }
-                }
-                catch { /* ignore */ }
-            };
-        }
-        catch (error) {
-            process.stderr.write(`[TELEMETRY] WebSocket connection failed: ${error}\n`);
-            // Retry
-            this.wsReconnectTimer = setTimeout(() => this.connectWebSocket(), 10000);
-        }
-    }
-    /**
-     * Save event to local fallback file (when server is unreachable).
-     */
-    saveToLocalFallback(event) {
-        try {
-            const frameworkDir = process.env.ATABEY_FRAMEWORK_DIR || path.join(process.cwd(), ".atabey");
-            const telemetryDir = path.join(frameworkDir, "telemetry");
-            if (!fs.existsSync(telemetryDir)) {
-                fs.mkdirSync(telemetryDir, { recursive: true });
-            }
-            const fallbackPath = path.join(telemetryDir, "pending-events.jsonl");
-            fs.appendFileSync(fallbackPath, JSON.stringify(event) + "\n");
-        }
-        catch { /* ignore: best effort */ }
-    }
-    /**
-     * Generate a unique machine ID.
-     */
-    generateMachineId() {
-        try {
-            const hostname = os.hostname();
-            const cpus = os.cpus();
-            const cpuModel = cpus.length > 0 ? cpus[0].model : "unknown";
-            const hash = this.simpleHash(`${hostname}-${cpuModel}`);
-            return `machine-${hash}`;
-        }
-        catch {
-            return `machine-${Math.random().toString(36).substr(2, 8)}`;
-        }
-    }
-    /**
-     * Generate a project hash for grouping.
-     */
-    generateProjectHash() {
-        try {
-            const pkgPath = path.join(process.cwd(), "package.json");
-            if (fs.existsSync(pkgPath)) {
-                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-                return this.simpleHash(pkg.name || pkgPath);
-            }
-        }
-        catch { /* ignore */ }
-        return this.simpleHash(process.cwd());
-    }
-    /**
-     * Simple string hash.
-     */
-    simpleHash(str) {
-        let hash = 0;
-        for (let i = 0; i < str.length; i++) {
-            const char = str.charCodeAt(i);
-            hash = ((hash << 5) - hash) + char;
-            hash = hash & hash; // Convert to 32bit integer
-        }
-        return Math.abs(hash).toString(16).substring(0, 8);
-    }
-    /**
-     * Get streamer status.
-     */
-    getStatus() {
-        return {
-            enabled: CONFIG.ENABLED,
-            serverUrl: CONFIG.SERVER_URL,
-            queueSize: this.queue.length,
-            wsConnected: this.ws?.readyState === WebSocket.OPEN,
-            eventsThisMinute: this.eventCountThisMinute,
-        };
-    }
-}
-// ─── Singleton Export ─────────────────────────────────────────────
-export const telemetryStreamer = TelemetryStreamer.getInstance();
-export { CONFIG as TelemetryConfig };

package/framework-mcp/dist/framework-mcp/src/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/framework-mcp/src/utils/zod-to-mcp.js

@@ -1,79 +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: {}
-    };
-    const requiredKeys = [];
-    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) {
-            requiredKeys.push(key);
-        }
-    }
-    if (requiredKeys.length > 0) {
-        jsonSchema.required = requiredKeys;
-    }
-    return jsonSchema;
-}
-function parseZodField(field) {
-    let type = "string";
-    const properties = {};
-    const 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;
-        if (nested.required) {
-            properties.required = nested.required;
-        }
-    }
-    return { type, properties, required: isRequired };
-}

package/framework-mcp/dist/index.js

@@ -1,156 +0,0 @@
-#!/usr/bin/env node
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { TOOLS, toolHandlers, toolSchemas } from "./tools/index.js";
-import { RESOURCES, handleReadResource } from "./resources/index.js";
-// ─── Server Setup ─────────────────────────────────────────────────
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Robustly find package.json by walking up from __dirname
-function findPackageJson(startDir) {
-    let currentDir = startDir;
-    while (currentDir !== path.parse(currentDir).root) {
-        const pkgPath = path.join(currentDir, "package.json");
-        if (fs.existsSync(pkgPath))
-            return pkgPath;
-        currentDir = path.dirname(currentDir);
-    }
-    throw new Error("Could not find package.json for atabey-mcp");
-}
-const pkgPath = findPackageJson(__dirname);
-const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-const serverVersion = pkg.version;
-const server = new Server({
-    name: "atabey-mcp",
-    version: serverVersion,
-}, {
-    capabilities: {
-        tools: {},
-        resources: {},
-    },
-});
-/**
- * Validates tool arguments using Zod schemas for "Zero Type Hole" compliance.
- * Falls back to basic presence check if no Zod schema is defined for the tool.
- */
-function validateArgs(toolName, args) {
-    const schema = toolSchemas[toolName];
-    if (schema) {
-        const result = schema.safeParse(args);
-        if (!result.success) {
-            return result.error.errors.map(e => `${e.path.join(".")}: ${e.message}`).join(", ");
-        }
-        return null;
-    }
-    // Fallback for tools without Zod schemas yet
-    const definition = TOOLS.find(t => t.name === toolName);
-    if (!definition)
-        return `Unknown tool: ${toolName}`;
-    const required = definition.inputSchema.required || [];
-    for (const field of required) {
-        if (args[field] === undefined || args[field] === null || args[field] === "") {
-            return `Missing required argument: '${field}' for tool '${toolName}'`;
-        }
-    }
-    return null;
-}
-server.setRequestHandler(ListToolsRequestSchema, async (request) => {
-    // 2026 Stateless Spec: Log client info from metadata if available
-    const meta = request._meta;
-    if (meta) {
-        process.stderr.write(`[MCP] Stateless ListTools from ${meta.client?.name || "unknown"} v${meta.client?.version || "?.?"}\n`);
-    }
-    return { tools: TOOLS };
-});
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return { resources: RESOURCES };
-});
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const uri = request.params.uri;
-    try {
-        const content = await handleReadResource(uri);
-        return {
-            contents: [
-                {
-                    uri,
-                    mimeType: "text/markdown",
-                    text: content,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to read resource: ${message}`, { cause: error });
-    }
-});
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const req = request;
-    const { name, arguments: args } = req.params;
-    const meta = request._meta;
-    // 2026 Stateless Spec: Prioritize metadata-driven context
-    if (meta) {
-        process.stderr.write(`[MCP] Stateless CallTool: ${name} (Client: ${meta.client?.name || "unknown"})\n`);
-    }
-    const projectRoot = process.env.ATABEY_PROJECT_ROOT || process.cwd();
-    try {
-        const handler = toolHandlers[name];
-        if (!handler) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `[ERROR] Unknown tool: ${name}` }],
-            };
-        }
-        // [SECURITY] Runtime Validation
-        const validationError = validateArgs(name, args || {});
-        if (validationError) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `[ERROR] Validation Error: ${validationError}` }],
-            };
-        }
-        return await handler(projectRoot, args || {});
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
-            isError: true,
-            content: [{ type: "text", text: `[ERROR] Execution failed: ${message}` }],
-        };
-    }
-});
-// ─── Graceful Startup & Shutdown ──────────────────────────────────
-async function run() {
-    const transport = new StdioServerTransport();
-    // Prevent unhandled errors from crashing the MCP stream
-    process.on("uncaughtException", (error) => {
-        process.stderr.write(`[atabey-mcp] Uncaught exception: ${error.message}
-`);
-    });
-    process.on("unhandledRejection", (reason) => {
-        const message = reason instanceof Error ? reason.message : String(reason);
-        process.stderr.write(`[atabey-mcp] Unhandled rejection: ${message}
-`);
-    });
-    // Graceful shutdown on SIGINT/SIGTERM
-    const shutdown = async () => {
-        try {
-            await server.close();
-        }
-        catch {
-            // Already closed or failed — safe to ignore
-        }
-        process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    await server.connect(transport);
-}
-run().catch((error) => {
-    process.stderr.write(`[atabey-mcp] Fatal startup error: ${error.message}
-`);
-    process.exit(1);
-});