@oni.bot/core 0.6.3 → 1.0.0

package/dist/oni-code/file-reader.js

@@ -0,0 +1,368 @@
+import { readFileSync } from "node:fs";
+import { extname } from "node:path";
+import { inflateRawSync } from "node:zlib";
+// ── Text file extensions (read as UTF-8) ─────────────────────
+const TEXT_EXTENSIONS = new Set([
+    ".txt", ".md", ".markdown", ".json", ".jsonc", ".yaml", ".yml",
+    ".xml", ".html", ".htm", ".css", ".scss", ".less", ".sass",
+    ".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".mts", ".cts",
+    ".py", ".rb", ".go", ".rs", ".java", ".kt", ".scala", ".c", ".cpp",
+    ".h", ".hpp", ".cs", ".swift", ".php", ".lua", ".r", ".jl",
+    ".sh", ".bash", ".zsh", ".fish", ".ps1", ".bat", ".cmd",
+    ".sql", ".graphql", ".gql", ".proto",
+    ".toml", ".ini", ".cfg", ".conf", ".env",
+    ".csv", ".tsv", ".log",
+    ".svg", ".tex", ".bib",
+    ".dockerfile", ".makefile", ".cmake",
+    ".gitignore", ".gitattributes", ".editorconfig",
+    ".eslintrc", ".prettierrc", ".babelrc",
+]);
+// ── Image extensions ─────────────────────────────────────────
+const IMAGE_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp", ".ico", ".tiff", ".tif",
+]);
+const MIME_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+    ".ico": "image/x-icon",
+    ".tiff": "image/tiff",
+    ".tif": "image/tiff",
+};
+// ── ZIP Parser ───────────────────────────────────────────────
+const ZIP_LOCAL_HEADER = 0x04034b50;
+/**
+ * Parse ZIP local file headers and extract deflated entries as UTF-8 strings.
+ * Returns a Map<filename, decompressedContent>.
+ *
+ * This is a minimal parser — it reads local headers sequentially
+ * and decompresses deflate (method 8) or stores (method 0) entries.
+ * Sufficient for Office Open XML formats.
+ */
+export function parseZipEntries(buf) {
+    const entries = new Map();
+    let pos = 0;
+    while (pos + 30 <= buf.length) {
+        const sig = buf.readUInt32LE(pos);
+        if (sig !== ZIP_LOCAL_HEADER)
+            break;
+        const method = buf.readUInt16LE(pos + 8);
+        const compressedSize = buf.readUInt32LE(pos + 18);
+        const nameLen = buf.readUInt16LE(pos + 26);
+        const extraLen = buf.readUInt16LE(pos + 28);
+        const nameStart = pos + 30;
+        const name = buf.toString("utf-8", nameStart, nameStart + nameLen);
+        const dataStart = nameStart + nameLen + extraLen;
+        const dataEnd = dataStart + compressedSize;
+        if (dataEnd > buf.length)
+            break;
+        const compressedData = buf.subarray(dataStart, dataEnd);
+        let content;
+        if (method === 0) {
+            // Stored (no compression)
+            content = compressedData.toString("utf-8");
+        }
+        else if (method === 8) {
+            // Deflate
+            try {
+                content = inflateRawSync(compressedData).toString("utf-8");
+            }
+            catch {
+                content = "";
+            }
+        }
+        else {
+            content = "";
+        }
+        entries.set(name, content);
+        pos = dataEnd;
+    }
+    return entries;
+}
+// ── Format Extractors ────────────────────────────────────────
+/** Extract text from .docx — reads word/document.xml */
+function extractDocx(buf) {
+    const entries = parseZipEntries(buf);
+    const docXml = entries.get("word/document.xml") ?? "";
+    if (!docXml) {
+        return { content: "[Could not find document.xml in DOCX]", format: "docx" };
+    }
+    // Extract text from <w:t> tags, preserving paragraph breaks
+    const paragraphs = [];
+    const pRegex = /<w:p[\s>][\s\S]*?<\/w:p>/g;
+    let pMatch;
+    while ((pMatch = pRegex.exec(docXml)) !== null) {
+        // Collect all <w:t> text within this paragraph
+        const tRegex = /<w:t[^>]*>([^<]*)<\/w:t>/g;
+        let text = "";
+        let tMatch;
+        while ((tMatch = tRegex.exec(pMatch[0])) !== null) {
+            text += tMatch[1];
+        }
+        if (text) {
+            paragraphs.push(text);
+        }
+    }
+    return {
+        content: paragraphs.join("\n"),
+        format: "docx",
+        metadata: { paragraphCount: paragraphs.length },
+    };
+}
+/** Extract text from .xlsx — reads shared strings + sheet data */
+function extractXlsx(buf) {
+    const entries = parseZipEntries(buf);
+    // Parse shared strings
+    const sharedStringsXml = entries.get("xl/sharedStrings.xml") ?? "";
+    const sharedStrings = [];
+    const siRegex = /<si>[\s\S]*?<\/si>/g;
+    let siMatch;
+    while ((siMatch = siRegex.exec(sharedStringsXml)) !== null) {
+        const tMatch = /<t[^>]*>([^<]*)<\/t>/.exec(siMatch[0]);
+        sharedStrings.push(tMatch ? tMatch[1] : "");
+    }
+    // Parse sheets
+    const sheetNames = [...entries.keys()]
+        .filter((k) => k.startsWith("xl/worksheets/sheet") && k.endsWith(".xml"))
+        .sort();
+    const lines = [];
+    for (const sheetName of sheetNames) {
+        const sheetXml = entries.get(sheetName) ?? "";
+        if (sheetNames.length > 1) {
+            const label = sheetName.replace("xl/worksheets/", "").replace(".xml", "");
+            lines.push(`--- ${label} ---`);
+        }
+        const rowRegex = /<row[^>]*>([\s\S]*?)<\/row>/g;
+        let rowMatch;
+        while ((rowMatch = rowRegex.exec(sheetXml)) !== null) {
+            const cells = [];
+            const cellRegex = /<c\s([^>]*)>[\s\S]*?<v>([^<]*)<\/v>[\s\S]*?<\/c>/g;
+            let cellMatch;
+            while ((cellMatch = cellRegex.exec(rowMatch[1])) !== null) {
+                const attrs = cellMatch[1];
+                const value = cellMatch[2];
+                const typeMatch = /\bt="([^"]*)"/.exec(attrs);
+                if (typeMatch?.[1] === "s") {
+                    // Shared string reference
+                    const idx = parseInt(value, 10);
+                    cells.push(sharedStrings[idx] ?? value);
+                }
+                else {
+                    cells.push(value);
+                }
+            }
+            if (cells.length > 0) {
+                lines.push(cells.join("\t"));
+            }
+        }
+    }
+    return {
+        content: lines.join("\n"),
+        format: "xlsx",
+        metadata: { sheetCount: sheetNames.length },
+    };
+}
+/** Extract text from .pptx — reads ppt/slides/slide*.xml */
+function extractPptx(buf) {
+    const entries = parseZipEntries(buf);
+    const slideNames = [...entries.keys()]
+        .filter((k) => k.startsWith("ppt/slides/slide") && k.endsWith(".xml"))
+        .sort((a, b) => {
+        const numA = parseInt(a.match(/slide(\d+)/)?.[1] ?? "0", 10);
+        const numB = parseInt(b.match(/slide(\d+)/)?.[1] ?? "0", 10);
+        return numA - numB;
+    });
+    const slides = [];
+    for (let i = 0; i < slideNames.length; i++) {
+        const slideXml = entries.get(slideNames[i]) ?? "";
+        const texts = [];
+        // Extract text from <a:t> tags
+        const tRegex = /<a:t>([^<]*)<\/a:t>/g;
+        let tMatch;
+        while ((tMatch = tRegex.exec(slideXml)) !== null) {
+            if (tMatch[1].trim()) {
+                texts.push(tMatch[1]);
+            }
+        }
+        if (texts.length > 0) {
+            slides.push(`--- Slide ${i + 1} ---\n${texts.join("\n")}`);
+        }
+    }
+    return {
+        content: slides.join("\n\n"),
+        format: "pptx",
+        metadata: { slideCount: slideNames.length },
+    };
+}
+/** Extract text from PDF content streams.
+ *  Handles: uncompressed streams, FlateDecode streams.
+ *  Extracts text from Tj, TJ, ', " operators.
+ *  This is a basic parser — complex PDFs (scanned, encrypted) will return partial/empty results. */
+function extractPdf(buf) {
+    const raw = buf.toString("latin1");
+    // Find all stream...endstream blocks
+    const texts = [];
+    const streamRegex = /stream\r?\n([\s\S]*?)endstream/g;
+    let streamMatch;
+    while ((streamMatch = streamRegex.exec(raw)) !== null) {
+        let streamData = streamMatch[1];
+        // Check if this stream's object has FlateDecode filter
+        // Look backwards from stream position for the object dictionary
+        const before = raw.substring(Math.max(0, streamMatch.index - 200), streamMatch.index);
+        const isFlate = /\/Filter\s*\/FlateDecode/.test(before);
+        if (isFlate) {
+            try {
+                const compressed = Buffer.from(streamData, "latin1");
+                streamData = inflateRawSync(compressed).toString("latin1");
+            }
+            catch {
+                // Skip streams that fail to decompress
+                continue;
+            }
+        }
+        // Extract text from PDF text operators
+        extractPdfText(streamData, texts);
+    }
+    const content = texts.join("\n").trim();
+    return {
+        content: content || "[No extractable text found in PDF]",
+        format: "pdf",
+        metadata: { extractedSegments: texts.length },
+    };
+}
+/** Parse PDF content stream text operators: Tj, TJ, ' */
+function extractPdfText(stream, out) {
+    // Tj — show string: (text) Tj
+    const tjRegex = /\(([^)]*)\)\s*Tj/g;
+    let m;
+    while ((m = tjRegex.exec(stream)) !== null) {
+        const decoded = decodePdfString(m[1]);
+        if (decoded.trim())
+            out.push(decoded);
+    }
+    // TJ — show array: [(text) -kern (text)] TJ
+    const tjArrayRegex = /\[((?:[^]]*?))\]\s*TJ/g;
+    while ((m = tjArrayRegex.exec(stream)) !== null) {
+        const inner = m[1];
+        const parts = [];
+        const partRegex = /\(([^)]*)\)/g;
+        let pm;
+        while ((pm = partRegex.exec(inner)) !== null) {
+            parts.push(decodePdfString(pm[1]));
+        }
+        const line = parts.join("");
+        if (line.trim())
+            out.push(line);
+    }
+    // ' operator — move to next line and show string: (text) '
+    const quoteRegex = /\(([^)]*)\)\s*'/g;
+    while ((m = quoteRegex.exec(stream)) !== null) {
+        const decoded = decodePdfString(m[1]);
+        if (decoded.trim())
+            out.push(decoded);
+    }
+}
+/** Decode PDF string escape sequences */
+function decodePdfString(s) {
+    return s
+        .replace(/\\n/g, "\n")
+        .replace(/\\r/g, "\r")
+        .replace(/\\t/g, "\t")
+        .replace(/\\\(/g, "(")
+        .replace(/\\\)/g, ")")
+        .replace(/\\\\/g, "\\")
+        .replace(/\\(\d{1,3})/g, (_m, octal) => String.fromCharCode(parseInt(octal, 8)));
+}
+/** Return image as base64 data URI */
+function extractImage(buf, ext) {
+    const mime = MIME_TYPES[ext] ?? "application/octet-stream";
+    const base64 = buf.toString("base64");
+    return {
+        content: `data:${mime};base64,${base64}`,
+        format: "image",
+        metadata: {
+            mimeType: mime,
+            sizeBytes: buf.length,
+        },
+    };
+}
+/** Strip RTF control words and extract plain text */
+function extractRtf(content) {
+    let text = content;
+    // Remove RTF groups we don't need (fonttbl, colortbl, stylesheet, etc.)
+    text = text.replace(/\{\\fonttbl[^}]*\}/g, "");
+    text = text.replace(/\{\\colortbl[^}]*\}/g, "");
+    text = text.replace(/\{\\stylesheet[^}]*\}/g, "");
+    text = text.replace(/\{\\info[^}]*\}/g, "");
+    // Convert \par to newlines
+    text = text.replace(/\\par\b\s?/g, "\n");
+    // Remove all control words (e.g., \b, \i, \f0, \fs24)
+    text = text.replace(/\\[a-z]+\d*\s?/g, "");
+    // Remove remaining braces
+    text = text.replace(/[{}]/g, "");
+    // Clean up whitespace
+    text = text.replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+    return { content: text, format: "rtf" };
+}
+// ── Main Entry Point ─────────────────────────────────────────
+/**
+ * Extract text content from a file based on its extension.
+ * Returns structured content for binary formats, or reads as UTF-8 for text files.
+ */
+export function extractFileContent(absPath) {
+    const ext = extname(absPath).toLowerCase();
+    // Text files — read as UTF-8
+    if (TEXT_EXTENSIONS.has(ext) || ext === "") {
+        return {
+            content: readFileSync(absPath, "utf-8"),
+            format: "text",
+        };
+    }
+    const buf = readFileSync(absPath);
+    switch (ext) {
+        case ".docx":
+            return extractDocx(buf);
+        case ".xlsx":
+        case ".xls":
+            return extractXlsx(buf);
+        case ".pptx":
+            return extractPptx(buf);
+        case ".pdf":
+            return extractPdf(buf);
+        case ".rtf":
+            return extractRtf(buf.toString("utf-8"));
+        case ".png":
+        case ".jpg":
+        case ".jpeg":
+        case ".gif":
+        case ".webp":
+        case ".bmp":
+        case ".ico":
+        case ".tiff":
+        case ".tif":
+            return extractImage(buf, ext);
+        default:
+            // Try reading as UTF-8 text as fallback
+            try {
+                return { content: buf.toString("utf-8"), format: "text" };
+            }
+            catch {
+                return {
+                    content: `[Binary file: ${ext}, ${buf.length} bytes]`,
+                    format: "binary",
+                };
+            }
+    }
+}
+/**
+ * Returns true if the file extension indicates a binary format
+ * that extractFileContent can handle (not a plain text file).
+ */
+export function isBinaryFormat(absPath) {
+    const ext = extname(absPath).toLowerCase();
+    return !TEXT_EXTENSIONS.has(ext) && ext !== "";
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/oni-code/file-reader.js.map

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

package/dist/oni-code/file-watcher.d.ts

@@ -0,0 +1,66 @@
+/**
+ * File Watcher — reactive file system monitoring for the ONI workspace.
+ *
+ * Uses native `node:fs` watch with recursive support to detect file
+ * changes in the project directory. Publishes events to direct subscribers
+ * and optionally to the EventBus.
+ *
+ * Features:
+ * - Debounced change events (prevents rapid-fire on save)
+ * - Path-segment ignore matching (node_modules, .git, dist, etc.)
+ * - Agent-initiated change tracking (internal vs external edits)
+ * - Swarm-aware: concurrent agents call markAgentChange() before writes
+ */
+import type { EventBus } from "../events/bus.js";
+export type FileChangeType = "create" | "modify" | "delete";
+export interface FileChangeEvent {
+    path: string;
+    changeType: FileChangeType;
+    timestamp: number;
+    agentInitiated: boolean;
+}
+export type FileChangeHandler = (event: FileChangeEvent) => void;
+export interface FileWatcherConfig {
+    rootDir: string;
+    /** Path segments to ignore (e.g., "node_modules", ".git") */
+    ignore?: string[];
+    /** Debounce interval in ms (default: 100) */
+    debounceMs?: number;
+    /** EventBus to publish file.changed events */
+    bus?: EventBus;
+}
+/**
+ * Check if a relative path should be ignored based on path segments.
+ * Matches any segment in the path against the ignore set.
+ */
+export declare function isIgnoredPath(relativePath: string, ignoreSet: Set<string>): boolean;
+export declare class FileWatcher {
+    private config;
+    private watcher;
+    private handlers;
+    private pending;
+    private agentChanges;
+    private ignoreSet;
+    private debounceMs;
+    constructor(config: FileWatcherConfig);
+    /** Get the merged ignore set (for testing/inspection). */
+    getIgnoreSet(): ReadonlySet<string>;
+    start(): void;
+    stop(): void;
+    isWatching(): boolean;
+    /**
+     * Mark a file path as being changed by the agent (internal edit).
+     * The next change event for this path will have `agentInitiated: true`.
+     * Call this BEFORE the write operation.
+     */
+    markAgentChange(path: string): void;
+    /**
+     * Check if a path has a pending agent-initiated mark.
+     * (For testing/inspection — does not consume the mark.)
+     */
+    hasAgentMark(path: string): boolean;
+    on(handler: FileChangeHandler): () => void;
+    private debounce;
+    private resolveChange;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/oni-code/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/oni-code/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAmBD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAGT;AAID,qBAAa,WAAW;IAQV,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAAoD;IACnE,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,UAAU,CAAS;gBAEP,MAAM,EAAE,iBAAiB;IAQ7C,0DAA0D;IAC1D,YAAY,IAAI,WAAW,CAAC,MAAM,CAAC;IAMnC,KAAK,IAAI,IAAI;IAsBb,IAAI,IAAI,IAAI;IAYZ,UAAU,IAAI,OAAO;IAMrB;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMnC,EAAE,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAS1C,OAAO,CAAC,QAAQ;YAYF,aAAa;CA0C5B"}

package/dist/oni-code/file-watcher.js

@@ -0,0 +1,167 @@
+/**
+ * File Watcher — reactive file system monitoring for the ONI workspace.
+ *
+ * Uses native `node:fs` watch with recursive support to detect file
+ * changes in the project directory. Publishes events to direct subscribers
+ * and optionally to the EventBus.
+ *
+ * Features:
+ * - Debounced change events (prevents rapid-fire on save)
+ * - Path-segment ignore matching (node_modules, .git, dist, etc.)
+ * - Agent-initiated change tracking (internal vs external edits)
+ * - Swarm-aware: concurrent agents call markAgentChange() before writes
+ */
+import { watch } from "node:fs";
+import { stat } from "node:fs/promises";
+import { join, normalize } from "node:path";
+// ── Default ignore list ───────────────────────────────────────
+const DEFAULT_IGNORE = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".turbo",
+    "coverage",
+    ".nyc_output",
+    ".cache",
+    "__pycache__",
+]);
+// ── Exported helpers ──────────────────────────────────────────
+/**
+ * Check if a relative path should be ignored based on path segments.
+ * Matches any segment in the path against the ignore set.
+ */
+export function isIgnoredPath(relativePath, ignoreSet) {
+    const segments = relativePath.split(/[\\/]/);
+    return segments.some((s) => ignoreSet.has(s));
+}
+// ── FileWatcher ───────────────────────────────────────────────
+export class FileWatcher {
+    config;
+    watcher = null;
+    handlers = new Set();
+    pending = new Map();
+    agentChanges = new Set();
+    ignoreSet;
+    debounceMs;
+    constructor(config) {
+        this.config = config;
+        this.ignoreSet = new Set([
+            ...DEFAULT_IGNORE,
+            ...(config.ignore ?? []),
+        ]);
+        this.debounceMs = config.debounceMs ?? 100;
+    }
+    /** Get the merged ignore set (for testing/inspection). */
+    getIgnoreSet() {
+        return this.ignoreSet;
+    }
+    // ── Lifecycle ─────────────────────────────────────────────
+    start() {
+        if (this.watcher)
+            return;
+        try {
+            this.watcher = watch(this.config.rootDir, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                if (isIgnoredPath(filename, this.ignoreSet))
+                    return;
+                const fullPath = join(this.config.rootDir, filename);
+                this.debounce(fullPath, eventType);
+            });
+            this.watcher.on("error", () => {
+                // Silently handle watcher errors (network drives, permissions, etc.)
+            });
+        }
+        catch {
+            this.watcher = null;
+        }
+    }
+    stop() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        for (const timer of this.pending.values()) {
+            clearTimeout(timer);
+        }
+        this.pending.clear();
+        this.agentChanges.clear();
+    }
+    isWatching() {
+        return this.watcher !== null;
+    }
+    // ── Agent-initiated change tracking ───────────────────────
+    /**
+     * Mark a file path as being changed by the agent (internal edit).
+     * The next change event for this path will have `agentInitiated: true`.
+     * Call this BEFORE the write operation.
+     */
+    markAgentChange(path) {
+        this.agentChanges.add(normalize(path));
+    }
+    /**
+     * Check if a path has a pending agent-initiated mark.
+     * (For testing/inspection — does not consume the mark.)
+     */
+    hasAgentMark(path) {
+        return this.agentChanges.has(normalize(path));
+    }
+    // ── Event subscription ────────────────────────────────────
+    on(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    // ── Internal ──────────────────────────────────────────────
+    debounce(path, eventType) {
+        const existing = this.pending.get(path);
+        if (existing)
+            clearTimeout(existing);
+        this.pending.set(path, setTimeout(() => {
+            this.pending.delete(path);
+            void this.resolveChange(path, eventType);
+        }, this.debounceMs));
+    }
+    async resolveChange(path, eventType) {
+        const normalizedPath = normalize(path);
+        const agentInitiated = this.agentChanges.delete(normalizedPath);
+        let changeType;
+        if (eventType === "change") {
+            changeType = "modify";
+        }
+        else {
+            // "rename" — check existence to distinguish create vs delete
+            try {
+                await stat(path);
+                changeType = "create";
+            }
+            catch {
+                changeType = "delete";
+            }
+        }
+        const event = {
+            path: normalizedPath,
+            changeType,
+            timestamp: Date.now(),
+            agentInitiated,
+        };
+        for (const handler of this.handlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Swallow handler errors
+            }
+        }
+        if (this.config.bus) {
+            this.config.bus.emit({
+                type: "file.changed",
+                ...event,
+            });
+        }
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/oni-code/file-watcher.js.map

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