atabey 0.0.1

package/dist/src/modules/agents/types.d.ts

@@ -0,0 +1,31 @@
+export type AgentTier = "supreme" | "core" | "recon";
+export type AgentTag = "core" | "orchestration" | "governance" | "security" | "design" | "logic" | "ui" | "mobile" | "native" | "audit" | "discipline" | "data" | "infra" | "recon" | "logistics" | "strategy";
+export interface AgentInstructions {
+    /** One-line identity statement surfaced to the agent as its persona. */
+    identity: string;
+    /** The agent's primary mission objective. */
+    mission: string;
+    /** Chain of Thought protocol the agent must follow. */
+    chainOfThought: string;
+    /** Mandatory, ordered discipline rules the agent must enforce. */
+    rules: string[];
+    /**
+     * Optional: skill documents the agent MUST read before acting.
+     * Paths are relative to the framework's knowledge directory.
+     */
+    knowledgeFiles?: string[];
+}
+export interface AgentDefinition {
+    /** Machine identifier — used in routing and send_agent_message targets. */
+    name: string;
+    displayName: string;
+    role: string;
+    description: string;
+    /** Capability score 1–10. Determines orchestration authority. */
+    capability: 10 | 9 | 8;
+    tier: AgentTier;
+    tags: AgentTag[];
+    stateMachine: string;
+    tools: string[];
+    instructions: AgentInstructions;
+}

package/dist/src/modules/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/modules/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/modules/agents/types.ts"],"names":[],"mappings":""}

package/dist/src/modules/skills/definitions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Core Skill Definitions for Agent Atabey.
+ * Groups tools into logical capabilities for agents.
+ */
+export declare const CORE_SKILLS: {
+    FILE_SYSTEM: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    EDITING: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    ORCHESTRATION: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    GOVERNANCE: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    QUALITY_ASSURANCE: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    DATABASE_MANAGEMENT: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+    DEVOPS_INFRASTRUCTURE: {
+        name: string;
+        tools: string[];
+        description: string;
+        mandates: string[];
+    };
+};

package/dist/src/modules/skills/definitions.js

@@ -0,0 +1,71 @@
+/**
+ * Core Skill Definitions for Agent Atabey.
+ * Groups tools into logical capabilities for agents.
+ */
+export const CORE_SKILLS = {
+    FILE_SYSTEM: {
+        name: "File System Mastery",
+        tools: ["read_file", "write_file"],
+        description: "Enables reading and writing files in the workspace with token efficiency.",
+        mandates: [
+            "- **Token Efficiency:** When reading large files, always specify `startLine` and `endLine` to avoid loading the entire file content into context.",
+            "- **Surgical Changes:** Avoid overwriting entire files for small updates; prefer surgical edit tools."
+        ]
+    },
+    EDITING: {
+        name: "Surgical Code Modification",
+        tools: ["replace_text", "patch_file"],
+        description: "Enables surgical, precise edits to source code files without overwriting the entire content.",
+        mandates: [
+            "- **Precise Selection:** Ensure `oldText` matches the target string exactly, including all whitespace and indentation.",
+            "- **Line-based Replacement:** Use `patch_file` for multi-line block updates, specifying exact 1-indexed start and end lines."
+        ]
+    },
+    ORCHESTRATION: {
+        name: "Hermes Orchestration & Messaging",
+        tools: ["orchestrate_loop", "send_agent_message", "get_framework_status", "log_agent_action"],
+        description: "Governs inter-agent message passing, task delegation, and execution logs using the Hermes Message Broker.",
+        mandates: [
+            "- **Traceability:** Always include the active `traceId` in all messages and action logs.",
+            "- **Action Logs:** Log critical operations with `log_agent_action` to ensure transparency and accountability.",
+            "- **Message Loops:** Run `orchestrate_loop` to process queued messages and trigger state transitions."
+        ]
+    },
+    GOVERNANCE: {
+        name: "Control Plane Governance & Locking",
+        tools: ["acquire_lock", "release_lock", "register_agent", "update_contract_hash"],
+        description: "Governs access control, resource locking, type contract validation, and agent registration.",
+        mandates: [
+            "- **Locking Protocol:** Always acquire a lock via `acquire_lock` on shared resources (like memory files) before editing, and release it immediately after writing.",
+            "- **Contract Enforcement:** Run `update_contract_hash` to re-sync backend types and check for breaking API changes."
+        ]
+    },
+    QUALITY_ASSURANCE: {
+        name: "Quality Assurance & Testing",
+        tools: ["run_shell_command", "view_file"],
+        description: "Enforces testing coverage standards, code style compliance, and runs test suites.",
+        mandates: [
+            "- **Zero-Mock Policy:** Integration tests must use real test database connections or service-compatible backends; do not rely on fake mocks.",
+            "- **Coverage Standards:** Ensure new code meets the 80% test coverage threshold before transitioning to release phases."
+        ]
+    },
+    DATABASE_MANAGEMENT: {
+        name: "Database Management & Migrations",
+        tools: ["view_file", "replace_text", "run_shell_command"],
+        description: "Handles database migrations, schema design, and query optimization.",
+        mandates: [
+            "- **No Direct DB Calls in Controllers:** Database operations must be isolated inside repository or service files; controllers must never perform raw DB calls.",
+            "- **No Raw SQL Strings:** Do not write raw SQL query strings; strictly use type-safe query builders like Kysely."
+        ]
+    },
+    DEVOPS_INFRASTRUCTURE: {
+        name: "DevOps & Infrastructure",
+        tools: ["run_shell_command", "view_file"],
+        description: "Manages CI/CD pipelines, container configurations, env files, and deployments.",
+        mandates: [
+            "- **No Hardcoded Secrets:** Never embed API keys, secrets, or passwords inside configuration files or codebases.",
+            "- **Immutable Deploys:** Ensure build steps compile production bundles successfully without configuration side-effects."
+        ]
+    }
+};
+//# sourceMappingURL=definitions.js.map

package/dist/src/modules/skills/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/modules/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,WAAW,EAAE;QACT,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QAClC,WAAW,EAAE,2EAA2E;QACxF,QAAQ,EAAE;YACN,mJAAmJ;YACnJ,uGAAuG;SAC1G;KACJ;IACD,OAAO,EAAE;QACL,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;QACrC,WAAW,EAAE,8FAA8F;QAC3G,QAAQ,EAAE;YACN,wHAAwH;YACxH,8HAA8H;SACjI;KACJ;IACD,aAAa,EAAE;QACX,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,CAAC;QAC7F,WAAW,EAAE,2GAA2G;QACxH,QAAQ,EAAE;YACN,0FAA0F;YAC1F,+GAA+G;YAC/G,uGAAuG;SAC1G;KACJ;IACD,UAAU,EAAE;QACR,IAAI,EAAE,oCAAoC;QAC1C,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;QACjF,WAAW,EAAE,6FAA6F;QAC1G,QAAQ,EAAE;YACN,oKAAoK;YACpK,qHAAqH;SACxH;KACJ;IACD,iBAAiB,EAAE;QACf,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,mFAAmF;QAChG,QAAQ,EAAE;YACN,8IAA8I;YAC9I,yHAAyH;SAC5H;KACJ;IACD,mBAAmB,EAAE;QACjB,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,CAAC;QACzD,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE;YACN,gKAAgK;YAChK,kHAAkH;SACrH;KACJ;IACD,qBAAqB,EAAE;QACnB,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,gFAAgF;QAC7F,QAAQ,EAAE;YACN,kHAAkH;YAClH,yHAAyH;SAC5H;KACJ;CACJ,CAAC"}

package/dist/src/shared/constants.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Agent Atabey — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+export declare const FRAMEWORK: {
+    readonly NAME: "Agent Atabey";
+    readonly CORE_DIR: ".atabey";
+    readonly UNIFIED_HUB_DIR: ".agents";
+    readonly CONSTITUTION_FILE: "ATABEY.md";
+    readonly DEFAULT_TRACE_ID: "T-000";
+    readonly DEFAULT_PHASE: "PHASE_0";
+    readonly DEFAULT_MANAGER_STATE: "ACTIVE";
+};
+export declare const PROJECT_PHASES: readonly ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+export declare const ADAPTER_DIRS: {
+    readonly GEMINI: ".gemini";
+    readonly CLAUDE: ".claude";
+    readonly GROK: ".grok";
+    readonly CURSOR: ".cursor";
+    readonly CODEX: ".agents";
+    readonly ANTIGRAVITY: ".antigravity";
+    readonly LOCAL: ".atabey";
+    readonly LEGACY_AGENT: ".agent";
+};
+/** Priority order for framework directory resolution (CLI + MCP). */
+export declare const FRAMEWORK_DIR_CANDIDATES: readonly [".atabey", ".agents", ".claude", ".gemini", ".grok", ".cursor", ".antigravity", ".atabey"];
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export declare const UNIFIED_ADAPTER_SLUG: {
+    readonly gemini: "gemini";
+    readonly claude: "claude";
+    readonly grok: "grok";
+    readonly cursor: "cursor";
+    readonly codex: "codex";
+    readonly local: "local";
+    readonly "antigravity-cli": "antigravity";
+};
+export type UnifiedAdapterSlug = keyof typeof UNIFIED_ADAPTER_SLUG;
+export declare const NATIVE_AGENT_PATHS: {
+    readonly gemini: string;
+    readonly claude: string;
+    readonly grok: string;
+    readonly cursor: string;
+    readonly codex: string;
+    readonly local: string;
+    readonly "antigravity-cli": string;
+};
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export declare const LEGACY_AGENT_LAYOUT_BASES: readonly [string, string, string, string, string, string, string];
+export declare const FRAMEWORK_SUBDIRS: {
+    readonly AGENTS: "agents";
+    readonly SKILLS: "skills";
+    readonly KNOWLEDGE: "knowledge";
+    readonly PROMPTS: "prompts";
+    readonly MEMORY: "memory";
+    readonly ROUTER: "router";
+    readonly REGISTRY: "registry";
+    readonly OBSERVABILITY: "observability";
+    readonly RULES: "rules";
+    readonly MESSAGES: "messages";
+    readonly LOGS: "logs";
+    readonly MEMORY_GRAPH: "memory-graph";
+};
+export declare const CORE_SCAFFOLD_SUBDIRS: readonly ["knowledge", "prompts", "memory", "router", "registry", "observability", "rules"];
+export declare const RUNTIME_SUBDIRS: readonly ["messages", "logs", "memory-graph"];
+export declare const MEMORY_SUBDIRS: {
+    readonly TASKS: "tasks";
+    readonly HISTORY: "history";
+};
+export declare const MEMORY_FILES: {
+    readonly STATE: "state.json";
+    readonly STATUS: "status.json";
+    readonly PROJECT_MEMORY: "PROJECT_MEMORY.md";
+    readonly SHARED_FACTS: "shared-facts.json";
+};
+export declare const DEFAULT_MONOREPO_PATHS: {
+    readonly backend: "apps/backend";
+    readonly frontend: "apps/web";
+    readonly mobile: "apps/mobile";
+    readonly docs: "docs";
+    readonly tests: "tests";
+};
+/** Cursor rule globs per agent role (enterprise monorepo layout). */
+export declare const CURSOR_AGENT_GLOBS: Record<string, string>;
+export declare const MCP: {
+    readonly SERVER_NAME: "atabey";
+    readonly ROOT_CONFIG_FILE: "mcp.json";
+    readonly PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT";
+    readonly TEST_DIR_ENV: "ATABEY_TEST_DIR";
+};
+export declare const ROOT_CONFIG_FILES: {
+    readonly MCP: "mcp.json";
+    readonly DOT_MCP: ".mcp.json";
+    readonly ENV_EXAMPLE: ".env.example";
+    readonly VSCODE_MCP: ".vscode/mcp.json";
+};
+export declare const TEMPLATE_PLACEHOLDERS: {
+    readonly FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}";
+    readonly ADAPTER: "{{ADAPTER}}";
+    readonly BACKEND_DIR: "{{BACKEND_DIR}}";
+    readonly FRONTEND_DIR: "{{FRONTEND_DIR}}";
+    readonly DOCS_DIR: "{{DOCS_DIR}}";
+    readonly TESTS_DIR: "{{TESTS_DIR}}";
+};
+export declare const AGENT_FILE_EXT: {
+    readonly MARKDOWN: ".md";
+    readonly CURSOR_RULE: ".mdc";
+};
+export declare function pathJoin(...segments: string[]): string;
+export declare function corePath(...segments: string[]): string;
+export declare function unifiedHubPath(...segments: string[]): string;
+export declare function unifiedAdapterPath(slug: string, ...segments: string[]): string;
+export declare function knowledgePath(filename: string): string;
+/** Backward-compatible aliases */
+export declare const CORE_FRAMEWORK_DIR: ".atabey";
+export declare const UNIFIED_HUB_DIR: ".agents";
+export declare const SKILLS_HUB_PATH: string;

package/dist/src/shared/constants.js

@@ -0,0 +1,184 @@
+/**
+ * Agent Atabey — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+// ─── Framework identity ───────────────────────────────────────────────────────
+export const FRAMEWORK = {
+    NAME: "Agent Atabey",
+    CORE_DIR: ".atabey",
+    UNIFIED_HUB_DIR: ".agents",
+    CONSTITUTION_FILE: "ATABEY.md",
+    DEFAULT_TRACE_ID: "T-000",
+    DEFAULT_PHASE: "PHASE_0",
+    DEFAULT_MANAGER_STATE: "ACTIVE",
+};
+export const PROJECT_PHASES = [
+    "PHASE_0",
+    "PHASE_1",
+    "PHASE_2",
+    "PHASE_3",
+    "PHASE_4",
+];
+// ─── Adapter platform directories (native / legacy) ───────────────────────────
+export const ADAPTER_DIRS = {
+    GEMINI: ".gemini",
+    CLAUDE: ".claude",
+    GROK: ".grok",
+    CURSOR: ".cursor",
+    CODEX: ".agents",
+    ANTIGRAVITY: ".antigravity",
+    LOCAL: ".atabey",
+    LEGACY_AGENT: ".agent",
+};
+/** Priority order for framework directory resolution (CLI + MCP). */
+export const FRAMEWORK_DIR_CANDIDATES = [
+    FRAMEWORK.CORE_DIR,
+    ADAPTER_DIRS.CODEX,
+    ADAPTER_DIRS.CLAUDE,
+    ADAPTER_DIRS.GEMINI,
+    ADAPTER_DIRS.GROK,
+    ADAPTER_DIRS.CURSOR,
+    ADAPTER_DIRS.ANTIGRAVITY,
+    ADAPTER_DIRS.LOCAL,
+];
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export const UNIFIED_ADAPTER_SLUG = {
+    gemini: "gemini",
+    claude: "claude",
+    grok: "grok",
+    cursor: "cursor",
+    codex: "codex",
+    local: "local",
+    "antigravity-cli": "antigravity",
+};
+// ─── Native agent instruction paths (legacy tool compatibility) ───────────────
+export const NATIVE_AGENT_PATHS = {
+    gemini: pathJoin(ADAPTER_DIRS.GEMINI, "agents"),
+    claude: pathJoin(ADAPTER_DIRS.CLAUDE, "agents"),
+    grok: pathJoin(ADAPTER_DIRS.GROK, "agents"),
+    cursor: pathJoin(ADAPTER_DIRS.CURSOR, "rules"),
+    codex: pathJoin(ADAPTER_DIRS.CODEX, "instructions"),
+    local: pathJoin(ADAPTER_DIRS.LOCAL, "agents"),
+    "antigravity-cli": pathJoin(ADAPTER_DIRS.ANTIGRAVITY, "agents"),
+};
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export const LEGACY_AGENT_LAYOUT_BASES = [
+    NATIVE_AGENT_PATHS.gemini,
+    NATIVE_AGENT_PATHS.claude,
+    NATIVE_AGENT_PATHS.cursor,
+    NATIVE_AGENT_PATHS.grok,
+    NATIVE_AGENT_PATHS.codex,
+    NATIVE_AGENT_PATHS.local,
+    NATIVE_AGENT_PATHS["antigravity-cli"],
+];
+// ─── Framework internal subdirectories (under `.atabey/`) ──────────────────
+export const FRAMEWORK_SUBDIRS = {
+    AGENTS: "agents",
+    SKILLS: "skills",
+    KNOWLEDGE: "knowledge",
+    PROMPTS: "prompts",
+    MEMORY: "memory",
+    ROUTER: "router",
+    REGISTRY: "registry",
+    OBSERVABILITY: "observability",
+    RULES: "rules",
+    MESSAGES: "messages",
+    LOGS: "logs",
+    MEMORY_GRAPH: "memory-graph",
+};
+export const CORE_SCAFFOLD_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.KNOWLEDGE,
+    FRAMEWORK_SUBDIRS.PROMPTS,
+    FRAMEWORK_SUBDIRS.MEMORY,
+    FRAMEWORK_SUBDIRS.ROUTER,
+    FRAMEWORK_SUBDIRS.REGISTRY,
+    FRAMEWORK_SUBDIRS.OBSERVABILITY,
+    FRAMEWORK_SUBDIRS.RULES,
+];
+export const RUNTIME_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.MESSAGES,
+    FRAMEWORK_SUBDIRS.LOGS,
+    FRAMEWORK_SUBDIRS.MEMORY_GRAPH,
+];
+export const MEMORY_SUBDIRS = {
+    TASKS: "tasks",
+    HISTORY: "history",
+};
+export const MEMORY_FILES = {
+    STATE: "state.json",
+    STATUS: "status.json",
+    PROJECT_MEMORY: "PROJECT_MEMORY.md",
+    SHARED_FACTS: "shared-facts.json",
+};
+// ─── Monorepo default paths ───────────────────────────────────────────────────
+export const DEFAULT_MONOREPO_PATHS = {
+    backend: "apps/backend",
+    frontend: "apps/web",
+    mobile: "apps/mobile",
+    docs: "docs",
+    tests: "tests",
+};
+/** Cursor rule globs per agent role (enterprise monorepo layout). */
+export const CURSOR_AGENT_GLOBS = {
+    manager: "**/*",
+    security: "**/*",
+    architect: "**/*",
+    backend: `${DEFAULT_MONOREPO_PATHS.backend}/**/*`,
+    frontend: `${DEFAULT_MONOREPO_PATHS.frontend}/**/*`,
+    mobile: `${DEFAULT_MONOREPO_PATHS.mobile}/**/*`,
+    native: "apps/native/**/*",
+    database: `${DEFAULT_MONOREPO_PATHS.backend}/src/database/**/*`,
+    devops: "{.github,docker,infra,scripts,*.yml,*.yaml,Dockerfile*}",
+    quality: "**/*",
+    analyst: "{docs,specs,contracts}/**/*",
+    explorer: "**/*",
+    git: "**/*",
+};
+// ─── MCP & environment ──────────────────────────────────────────────────────
+export const MCP = {
+    SERVER_NAME: "atabey",
+    ROOT_CONFIG_FILE: "mcp.json",
+    PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT",
+    TEST_DIR_ENV: "ATABEY_TEST_DIR",
+};
+export const ROOT_CONFIG_FILES = {
+    MCP: MCP.ROOT_CONFIG_FILE,
+    DOT_MCP: ".mcp.json",
+    ENV_EXAMPLE: ".env.example",
+    VSCODE_MCP: ".vscode/mcp.json",
+};
+// ─── Shim template placeholders ───────────────────────────────────────────────
+export const TEMPLATE_PLACEHOLDERS = {
+    FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}",
+    ADAPTER: "{{ADAPTER}}",
+    BACKEND_DIR: "{{BACKEND_DIR}}",
+    FRONTEND_DIR: "{{FRONTEND_DIR}}",
+    DOCS_DIR: "{{DOCS_DIR}}",
+    TESTS_DIR: "{{TESTS_DIR}}",
+};
+// ─── File extensions ─────────────────────────────────────────────────────────
+export const AGENT_FILE_EXT = {
+    MARKDOWN: ".md",
+    CURSOR_RULE: ".mdc",
+};
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+export function pathJoin(...segments) {
+    return segments.filter(Boolean).join("/");
+}
+export function corePath(...segments) {
+    return pathJoin(FRAMEWORK.CORE_DIR, ...segments);
+}
+export function unifiedHubPath(...segments) {
+    return pathJoin(FRAMEWORK.UNIFIED_HUB_DIR, ...segments);
+}
+export function unifiedAdapterPath(slug, ...segments) {
+    return unifiedHubPath(slug, ...segments);
+}
+export function knowledgePath(filename) {
+    return corePath(FRAMEWORK_SUBDIRS.KNOWLEDGE, filename);
+}
+/** Backward-compatible aliases */
+export const CORE_FRAMEWORK_DIR = FRAMEWORK.CORE_DIR;
+export const UNIFIED_HUB_DIR = FRAMEWORK.UNIFIED_HUB_DIR;
+export const SKILLS_HUB_PATH = pathJoin(UNIFIED_HUB_DIR, FRAMEWORK_SUBDIRS.SKILLS);
+//# sourceMappingURL=constants.js.map

package/dist/src/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/constants.ts"],"names":[],"mappings":"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"}

package/dist/src/shared/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Enterprise Base Error class for the Agent Atabey Framework.
+ */
+export declare class AtabeyBaseError extends Error {
+    readonly code: string;
+    readonly timestamp: Date;
+    readonly details?: unknown;
+    readonly solution?: string;
+    constructor(message: string, code?: string, details?: unknown, solution?: string);
+    /**
+     * Converts the error into a structured JSON log format.
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+        details: unknown;
+        solution: string | undefined;
+        stack: string | undefined;
+    };
+}
+/**
+ * Thrown when configuration loading or validation fails.
+ */
+export declare class ConfigurationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when data schema or payload validation fails.
+ */
+export declare class ValidationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when adapter initialization or execution fails.
+ */
+export declare class AdapterError extends AtabeyBaseError {
+    constructor(message: string, adapterId: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when orchestration or agent communication fails.
+ */
+export declare class OrchestrationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}

package/dist/src/shared/errors.js

@@ -0,0 +1,69 @@
+/**
+ * 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);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACtB,IAAI,CAAS;IACb,SAAS,CAAO;IAChB,OAAO,CAAW;IAClB,QAAQ,CAAU;IAElC,YAAY,OAAe,EAAE,IAAI,GAAG,uBAAuB,EAAE,OAAiB,EAAE,QAAiB;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAChD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC7C,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAiB,EAAE,QAAiB;QAChF,KAAK,CAAC,YAAY,SAAS,cAAc,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5F,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/src/shared/fs.d.ts

@@ -0,0 +1,8 @@
+export declare function ensureDir(dirPath: string, dryRun?: boolean): void;
+/**
+ * Writes content to a file atomically by using a temporary file.
+ * This prevents data corruption during unexpected system failures.
+ */
+export declare function writeTextFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function appendFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function writeJsonFile(filePath: string, value: unknown, dryRun?: boolean): void;

package/dist/src/shared/fs.js

@@ -0,0 +1,48 @@
+import fs from "fs";
+import path from "path";
+import { logger } from "./logger.js";
+export function ensureDir(dirPath, dryRun = false) {
+    if (!fs.existsSync(dirPath)) {
+        if (dryRun) {
+            logger.info(`[DRY RUN] Would create directory: ${dirPath}`);
+        }
+        else {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+}
+/**
+ * Writes content to a file atomically by using a temporary file.
+ * This prevents data corruption during unexpected system failures.
+ */
+export function writeTextFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would write file: ${filePath}`);
+        return;
+    }
+    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))
+            fs.unlinkSync(tempPath);
+        throw err;
+    }
+}
+export function appendFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would append to file: ${filePath}`);
+        return;
+    }
+    ensureDir(path.dirname(filePath));
+    fs.appendFileSync(filePath, content, "utf8");
+}
+export function writeJsonFile(filePath, value, dryRun = false) {
+    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/shared/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/shared/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAM,GAAG,KAAK;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IAC3E,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;IAEvE,IAAI,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IACxE,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAM,GAAG,KAAK;IAC1E,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}