atabey 0.1.1-beta → 0.1.2

package/dist/shared/src/file-lock.js

@@ -1,240 +1,2 @@
-/**
- * Atomic File-Based Locking — OS-level exclusive create via open('wx').
- *
- * Replaces check-then-act lock races. No Redis/Redlock required.
- *
- * Pattern:
- *   resource  →  .atabey/locks/<relative>.lock  (created with O_EXCL / 'wx')
- *   holder writes JSON metadata after exclusive create
- *   release unlinks the lock file
- *
- * Stale locks (TTL exceeded) are reclaimed atomically when possible.
- */
-import fs from "fs";
-import os from "os";
-import path from "path";
-export class AtomicFileLock {
-    locksDir;
-    projectRoot;
-    ttlMs;
-    retryMs;
-    timeoutMs;
-    constructor(options = {}) {
-        this.projectRoot = options.projectRoot ?? process.cwd();
-        this.locksDir = options.locksDir
-            ? path.resolve(options.locksDir)
-            : path.join(this.projectRoot, ".atabey", "locks");
-        this.ttlMs = options.ttlMs ?? 5 * 60 * 1000;
-        this.retryMs = options.retryMs ?? 50;
-        this.timeoutMs = options.timeoutMs ?? 10_000;
-    }
-    /** Absolute path of the lock file for a resource. */
-    getLockPath(resource) {
-        const abs = path.isAbsolute(resource)
-            ? resource
-            : path.resolve(this.projectRoot, resource);
-        let relative = path.relative(this.projectRoot, abs);
-        if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
-            // Outside project root — hash path to avoid escaping locks dir
-            relative = `_ext/${Buffer.from(abs).toString("base64url")}`;
-        }
-        // Normalize separators for cross-platform lock paths
-        relative = relative.split(path.sep).join("/");
-        return path.join(this.locksDir, `${relative}.lock`);
-    }
-    /**
-     * Try to acquire a lock once (non-blocking).
-     * Uses atomic exclusive file create (`wx` = O_CREAT | O_EXCL | O_WRONLY).
-     */
-    tryAcquire(resource, ownerId, reason, _reclaimDepth = 0) {
-        const lockPath = this.getLockPath(resource);
-        fs.mkdirSync(path.dirname(lockPath), { recursive: true });
-        // Reclaim stale lock first (best-effort, still atomic on create)
-        this.reclaimIfStale(lockPath);
-        const now = Date.now();
-        const meta = {
-            ownerId,
-            resource,
-            acquiredAt: new Date(now).toISOString(),
-            expiresAt: new Date(now + this.ttlMs).toISOString(),
-            reason,
-            pid: process.pid,
-            hostname: os.hostname(),
-        };
-        try {
-            // Atomic exclusive create WITH content in one syscall sequence
-            // (writeFileSync + flag 'wx' = O_CREAT|O_EXCL|O_WRONLY): there is no
-            // window where the lock file exists empty for a reader to misread.
-            fs.writeFileSync(lockPath, JSON.stringify(meta, null, 2), { encoding: "utf8", flag: "wx" });
-            return { acquired: true, meta };
-        }
-        catch (err) {
-            const code = err.code;
-            if (code === "EEXIST") {
-                // Another process holds it. Reclaim only if corrupt/empty or expired.
-                const heldBy = this.readMeta(lockPath) ?? undefined;
-                if ((!heldBy || this.isExpired(heldBy)) && _reclaimDepth < 1) {
-                    this.forceRemove(lockPath, heldBy ?? null);
-                    return this.tryAcquire(resource, ownerId, reason, _reclaimDepth + 1);
-                }
-                return { acquired: false, heldBy };
-            }
-            throw err;
-        }
-    }
-    /**
-     * Acquire with async retry until timeout.
-     */
-    async acquireAsync(resource, ownerId, options) {
-        const timeoutMs = options?.timeoutMs ?? this.timeoutMs;
-        const retryMs = options?.retryMs ?? this.retryMs;
-        const start = Date.now();
-        while (true) {
-            const result = this.tryAcquire(resource, ownerId, options?.reason);
-            if (result.acquired && result.meta) {
-                return result.meta;
-            }
-            if (Date.now() - start >= timeoutMs) {
-                const holder = result.heldBy?.ownerId ?? "unknown";
-                throw new Error(`[AtomicFileLock] Timeout acquiring lock for "${resource}" after ${timeoutMs}ms (held by ${holder})`);
-            }
-            await sleep(retryMs);
-        }
-    }
-    /**
-     * Release lock only if owned by ownerId (or force=true).
-     */
-    release(resource, ownerId, force = false) {
-        const lockPath = this.getLockPath(resource);
-        if (!fs.existsSync(lockPath))
-            return true;
-        const meta = this.readMeta(lockPath);
-        if (!meta) {
-            // Corrupt/empty lock — safe to drop (atomic create means a real
-            // holder always has readable meta).
-            this.forceRemove(lockPath, null);
-            return true;
-        }
-        if (!force && meta.ownerId !== ownerId) {
-            return false;
-        }
-        this.forceRemove(lockPath, meta);
-        return true;
-    }
-    isLocked(resource) {
-        const lockPath = this.getLockPath(resource);
-        if (!fs.existsSync(lockPath))
-            return null;
-        const meta = this.readMeta(lockPath);
-        if (!meta)
-            return null;
-        if (this.isExpired(meta)) {
-            this.forceRemove(lockPath, meta);
-            return null;
-        }
-        return meta;
-    }
-    /**
-     * Run `fn` while holding the lock.
-     * ALWAYS releases in `finally` even if `fn` throws (disk full, parse errors, etc.).
-     * Without this, a leftover `.lock` file would deadlock every subsequent writer until TTL.
-     *
-     * Prefer this API over bare acquire/release for any mutating work.
-     */
-    async withLock(resource, ownerId, fn, options) {
-        await this.acquireAsync(resource, ownerId, options);
-        try {
-            return await fn();
-        }
-        finally {
-            // Never let release errors mask the original failure or leave a lock.
-            try {
-                this.release(resource, ownerId);
-            }
-            catch {
-                this.forceRemove(this.getLockPath(resource), null);
-            }
-            // Belt-and-suspenders: if our lock is somehow still present, force drop it.
-            const stillHeld = this.isLocked(resource);
-            if (stillHeld && stillHeld.ownerId === ownerId) {
-                this.forceRemove(this.getLockPath(resource), stillHeld);
-            }
-        }
-    }
-    /**
-     * Synchronous withLock — same try/finally release guarantee.
-     */
-    withLockSync(resource, ownerId, fn, options) {
-        const result = this.tryAcquire(resource, ownerId, options?.reason);
-        if (!result.acquired) {
-            const holder = result.heldBy?.ownerId ?? "unknown";
-            throw new Error(`[AtomicFileLock] Could not acquire lock for "${resource}" (held by ${holder})`);
-        }
-        try {
-            return fn();
-        }
-        finally {
-            try {
-                this.release(resource, ownerId);
-            }
-            catch {
-                this.forceRemove(this.getLockPath(resource), null);
-            }
-            const stillHeld = this.isLocked(resource);
-            if (stillHeld && stillHeld.ownerId === ownerId) {
-                this.forceRemove(this.getLockPath(resource), stillHeld);
-            }
-        }
-    }
-    reclaimIfStale(lockPath) {
-        if (!fs.existsSync(lockPath))
-            return;
-        if (this.isReclaimable(lockPath)) {
-            this.forceRemove(lockPath, this.readMeta(lockPath));
-        }
-    }
-    /**
-     * True when an existing lock file may be safely stolen: unparseable/empty
-     * (corrupt, e.g. crashed mid-write) or past its TTL.
-     */
-    isReclaimable(lockPath) {
-        const meta = this.readMeta(lockPath);
-        if (!meta)
-            return true;
-        return this.isExpired(meta);
-    }
-    isExpired(meta) {
-        const exp = Date.parse(meta.expiresAt);
-        if (Number.isNaN(exp)) {
-            // Fallback: acquiredAt + ttl
-            const acq = Date.parse(meta.acquiredAt);
-            return Number.isNaN(acq) ? true : Date.now() - acq > this.ttlMs;
-        }
-        return Date.now() > exp;
-    }
-    readMeta(lockPath) {
-        try {
-            const raw = fs.readFileSync(lockPath, "utf8");
-            return JSON.parse(raw);
-        }
-        catch {
-            return null;
-        }
-    }
-    forceRemove(lockPath, _meta) {
-        try {
-            fs.unlinkSync(lockPath);
-        }
-        catch {
-            // ignore ENOENT races
-        }
-    }
-}
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-/** Convenience: lock under project `.atabey/locks`. */
-export function createProjectFileLock(projectRoot, options) {
-    return new AtomicFileLock({ ...options, projectRoot });
-}
+export * from "./modules/concurrency/file-lock.js";
 //# sourceMappingURL=file-lock.js.map

package/dist/shared/src/file-lock.js.map

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

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

@@ -1,9 +1 @@
-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;
-export declare function runCommandQuiet(command: string, args: string[], cwd: string): void;
+export * from "./modules/primitives/fs.js";

package/dist/shared/src/fs.js

@@ -1,54 +1,2 @@
-import { execFileSync } from "child_process";
-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));
-    // Atomic append: oku → ekle → atomic yaz
-    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
-    writeTextFile(filePath, existing + content);
-}
-export function writeJsonFile(filePath, value, dryRun = false) {
-    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
-}
-export function runCommandQuiet(command, args, cwd) {
-    execFileSync(command, args, { cwd, stdio: "ignore" });
-}
+export * from "./modules/primitives/fs.js";
 //# sourceMappingURL=fs.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../shared/src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,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,yCAAyC;IACzC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;AAChD,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;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IACxE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../shared/src/fs.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

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

@@ -1,31 +1,2 @@
-export * from "./database.js";
-export * from "./pii.js";
-export * from "./lock.js";
-export * from "./audit.js";
-export * from "./audit-chain.js";
-export * from "./logger.js";
-export * from "./retention.js";
-export * from "./errors.js";
-export * from "./constants.js";
-export * from "./string.js";
-export * from "./types.js";
-export * from "./fs.js";
-export * from "./job-queue.js";
-export * from "./worker-pool.js";
-export * from "./file-lock.js";
-export * from "./sandbox.js";
-export * from "./sandbox-runtime.js";
-export * from "./sandbox-fs.js";
-export * from "./resilience.js";
-export * from "./policy-gate.js";
-export * from "./storage.js";
-export * from "./time.js";
-export * from "./secrets.js";
-export * from "./tokenizer.js";
-export * from "./migrations.js";
-export * from "./tls.js";
-export * from "./outbound-http.js";
-export * from "./api-catalog.js";
-export * from "./agent-identity.js";
-export * from "./memory-prune.js";
-export * from "./otel.js";
+export * from "./modules/index.js";
+export * as Modules from "./modules/index.js";

package/dist/shared/src/index.js

@@ -1,32 +1,3 @@
-export * from "./database.js";
-export * from "./pii.js";
-export * from "./lock.js";
-export * from "./audit.js";
-export * from "./audit-chain.js";
-export * from "./logger.js";
-export * from "./retention.js";
-export * from "./errors.js";
-export * from "./constants.js";
-export * from "./string.js";
-export * from "./types.js";
-export * from "./fs.js";
-export * from "./job-queue.js";
-export * from "./worker-pool.js";
-export * from "./file-lock.js";
-export * from "./sandbox.js";
-export * from "./sandbox-runtime.js";
-export * from "./sandbox-fs.js";
-export * from "./resilience.js";
-export * from "./policy-gate.js";
-export * from "./storage.js";
-export * from "./time.js";
-export * from "./secrets.js";
-export * from "./tokenizer.js";
-export * from "./migrations.js";
-export * from "./tls.js";
-export * from "./outbound-http.js";
-export * from "./api-catalog.js";
-export * from "./agent-identity.js";
-export * from "./memory-prune.js";
-export * from "./otel.js";
+export * from "./modules/index.js";
+export * as Modules from "./modules/index.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../shared/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../shared/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/shared/src/job-queue.d.ts

@@ -1,76 +1 @@
-/**
- * Job Queue — concurrency-limited async work dispatcher backed by SQLite database persistence.
- *
- * Prevents unbounded parallel LLM / agent work from ballooning memory
- * or starving the main event loop. Job lifecycles (pending, running, completed, failed)
- * are recorded in the database when initialized, providing persistence and auditability.
- */
-export type JobStatus = "pending" | "running" | "completed" | "failed";
-export interface JobRecord {
-    id: number;
-    queue_name: string;
-    payload: string;
-    status: JobStatus;
-    retries: number;
-    max_retries: number;
-    error_message?: string | null;
-    created_at: string;
-    updated_at: string;
-}
-export interface EnqueueOptions {
-    /** Optional JSON-serializable payload or description of the task */
-    payload?: unknown;
-    /** Max retries before permanent failure (default: 3) */
-    maxRetries?: number;
-}
-export interface JobQueueOptions {
-    /** Max concurrent running jobs. Default: os.cpus().length (min 1, max 16). */
-    maxConcurrency?: number;
-    /** Optional name for diagnostics and DB tracking. */
-    name?: string;
-    /** Called when a job fails (after the promise rejects to the caller). */
-    onError?: (error: unknown, jobId: number) => void;
-}
-export interface JobQueueStats {
-    name: string;
-    maxConcurrency: number;
-    running: number;
-    pending: number;
-    completed: number;
-    failed: number;
-}
-export declare class JobQueue {
-    private readonly maxConcurrency;
-    private readonly name;
-    private readonly onError?;
-    private readonly pending;
-    private running;
-    private nextId;
-    private completed;
-    private failed;
-    private closed;
-    constructor(options?: JobQueueOptions);
-    /**
-     * Enqueue an async job. Resolves/rejects with the job result.
-     * Back-pressures via wait in the queue — does not spawn unbounded work.
-     * If SQLite is initialized, records job creation in the database.
-     */
-    enqueue<T>(fn: () => Promise<T>, options?: EnqueueOptions): Promise<T>;
-    /** Retrieve a job record from the database by ID. */
-    getJobRecord(id: number): JobRecord | null;
-    /** Retrieve job records from the database for this queue. */
-    getQueueRecords(status?: JobStatus, limit?: number): JobRecord[];
-    /** Current queue diagnostics. */
-    getStats(): JobQueueStats;
-    /** Reject pending jobs and stop accepting new ones. In-flight jobs finish. */
-    close(reason?: string): void;
-    /** Wait until running + pending reach zero (or timeout). */
-    drain(timeoutMs?: number): Promise<void>;
-    private pump;
-    private execute;
-}
-/** Backward compatibility alias */
-export { JobQueue as InMemoryJobQueue };
-export declare function getAgentJobQueue(options?: JobQueueOptions): JobQueue;
-/** Test helper — reset singleton. */
-export declare function resetAgentJobQueue(): void;
+export * from "./modules/concurrency/job-queue.js";