@runcore-sh/runcore 0.1.2

package/dist/files/store.js

@@ -0,0 +1,271 @@
+/**
+ * File store — append-only JSONL persistence for FileEntry and FileEvent.
+ * Follows src/queue/store.ts pattern: in-memory Map cache, last-occurrence-wins.
+ *
+ * Files:
+ *   brain/files/registry.jsonl — file metadata
+ *   brain/files/events.jsonl   — audit trail
+ */
+import { readFile, appendFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("files.store");
+const REGISTRY_SCHEMA = JSON.stringify({
+    _schema: "file",
+    version: 1,
+    fields: [
+        "id", "name", "slug", "mimeType", "sizeBytes", "category", "tags",
+        "origin", "ownerId", "taskId", "parentId", "version", "storagePath",
+        "checksum", "encrypted", "visibility", "status", "textPreview", "meta",
+        "createdAt", "updatedAt",
+    ],
+});
+const EVENTS_SCHEMA = JSON.stringify({
+    _schema: "file_event",
+    version: 1,
+    fields: ["id", "fileId", "action", "actor", "detail", "timestamp"],
+});
+/** Generate a file ID: file_<timestamp>_<8-hex>. */
+export function generateFileId() {
+    const ts = Date.now();
+    const rand = randomBytes(4).toString("hex");
+    return `file_${ts}_${rand}`;
+}
+/** Generate an event ID: evt_<timestamp>_<8-hex>. */
+function generateEventId() {
+    const ts = Date.now();
+    const rand = randomBytes(4).toString("hex");
+    return `evt_${ts}_${rand}`;
+}
+export class FileStore {
+    cache = null;
+    registryPath;
+    eventsPath;
+    constructor(brainDir) {
+        this.registryPath = join(brainDir, "files", "registry.jsonl");
+        this.eventsPath = join(brainDir, "files", "events.jsonl");
+    }
+    // ── File I/O helpers ────────────────────────────────────────────────────
+    async ensureFile(filePath, schemaLine) {
+        try {
+            await readFile(filePath, "utf-8");
+        }
+        catch {
+            await mkdir(dirname(filePath), { recursive: true });
+            await appendFile(filePath, schemaLine + "\n", "utf-8");
+        }
+    }
+    async load() {
+        if (this.cache)
+            return this.cache;
+        await this.ensureFile(this.registryPath, REGISTRY_SCHEMA);
+        log.debug("loading file registry", { filePath: this.registryPath });
+        const raw = await readFile(this.registryPath, "utf-8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        const map = new Map();
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                map.set(obj.id, obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        this.cache = map;
+        log.info("file registry loaded", { fileCount: map.size });
+        return map;
+    }
+    async appendRegistry(entry) {
+        await appendFile(this.registryPath, JSON.stringify(entry) + "\n", "utf-8");
+    }
+    async appendEvent(event) {
+        await this.ensureFile(this.eventsPath, EVENTS_SCHEMA);
+        await appendFile(this.eventsPath, JSON.stringify(event) + "\n", "utf-8");
+    }
+    // ── Event logging ─────────────────────────────────────────────────────
+    async logEvent(fileId, action, actor, detail) {
+        const event = {
+            id: generateEventId(),
+            fileId,
+            action,
+            actor,
+            detail,
+            timestamp: new Date().toISOString(),
+        };
+        await this.appendEvent(event);
+        log.debug("file event logged", { fileId, action, actor });
+        return event;
+    }
+    // ── CRUD ──────────────────────────────────────────────────────────────
+    async list(filter) {
+        const map = await this.load();
+        let results = [...map.values()].filter((f) => f.status !== "quarantined");
+        if (filter) {
+            if (filter.category)
+                results = results.filter((f) => f.category === filter.category);
+            if (filter.origin)
+                results = results.filter((f) => f.origin === filter.origin);
+            if (filter.status)
+                results = results.filter((f) => f.status === filter.status);
+            if (filter.taskId)
+                results = results.filter((f) => f.taskId === filter.taskId);
+            if (filter.tags?.length) {
+                results = results.filter((f) => filter.tags.some((t) => f.tags.includes(t)));
+            }
+            if (filter.folderId) {
+                results = results.filter((f) => f.meta?.folderId === filter.folderId);
+            }
+            if (filter.search) {
+                const q = filter.search.toLowerCase();
+                results = results.filter((f) => f.name.toLowerCase().includes(q) ||
+                    f.tags.some((t) => t.toLowerCase().includes(q)) ||
+                    f.textPreview?.toLowerCase().includes(q));
+            }
+        }
+        // Default: exclude archived unless explicitly requested
+        if (!filter?.status) {
+            results = results.filter((f) => f.status !== "archived");
+        }
+        results.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        if (filter?.offset)
+            results = results.slice(filter.offset);
+        if (filter?.limit)
+            results = results.slice(0, filter.limit);
+        return results;
+    }
+    async get(id) {
+        const map = await this.load();
+        return map.get(id) ?? null;
+    }
+    async create(fields) {
+        await this.load();
+        const now = new Date().toISOString();
+        const entry = {
+            ...fields,
+            id: generateFileId(),
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.cache.set(entry.id, entry);
+        await this.appendRegistry(entry);
+        await this.logEvent(entry.id, "created", fields.ownerId ?? "system");
+        log.info("file created", { id: entry.id, name: entry.name, category: entry.category });
+        return entry;
+    }
+    async update(id, patch) {
+        const map = await this.load();
+        const existing = map.get(id);
+        if (!existing)
+            return null;
+        const mergedMeta = patch.meta
+            ? { ...(existing.meta ?? {}), ...patch.meta }
+            : existing.meta;
+        const updated = {
+            ...existing,
+            ...patch,
+            meta: mergedMeta,
+            id: existing.id, // prevent overwrite
+            createdAt: existing.createdAt,
+            updatedAt: new Date().toISOString(),
+        };
+        map.set(id, updated);
+        await this.appendRegistry(updated);
+        await this.logEvent(id, "updated", "system");
+        log.debug("file updated", { id, changes: Object.keys(patch) });
+        return updated;
+    }
+    async archive(id, actor) {
+        const map = await this.load();
+        const existing = map.get(id);
+        if (!existing)
+            return { ok: false, message: `File not found: ${id}` };
+        if (existing.status === "archived")
+            return { ok: true, message: "Already archived" };
+        const updated = {
+            ...existing,
+            status: "archived",
+            updatedAt: new Date().toISOString(),
+        };
+        map.set(id, updated);
+        await this.appendRegistry(updated);
+        await this.logEvent(id, "archived", actor);
+        log.info("file archived", { id, name: existing.name });
+        return { ok: true, message: `Archived: ${existing.name}` };
+    }
+    async restore(id, actor) {
+        const map = await this.load();
+        const existing = map.get(id);
+        if (!existing)
+            return { ok: false, message: `File not found: ${id}` };
+        if (existing.status !== "archived")
+            return { ok: true, message: "Not archived" };
+        const updated = {
+            ...existing,
+            status: "active",
+            updatedAt: new Date().toISOString(),
+        };
+        map.set(id, updated);
+        await this.appendRegistry(updated);
+        await this.logEvent(id, "restored", actor);
+        log.info("file restored", { id, name: existing.name });
+        return { ok: true, message: `Restored: ${existing.name}` };
+    }
+    // ── Storage metrics ───────────────────────────────────────────────────
+    async getStorageUsage() {
+        const map = await this.load();
+        const cats = [
+            "upload", "report", "template", "attachment", "export",
+            "resume", "media", "ingest", "other",
+        ];
+        const byCategory = Object.fromEntries(cats.map((c) => [c, 0]));
+        let totalBytes = 0;
+        let fileCount = 0;
+        for (const entry of map.values()) {
+            if (entry.status === "archived" || entry.status === "quarantined")
+                continue;
+            totalBytes += entry.sizeBytes;
+            byCategory[entry.category] = (byCategory[entry.category] ?? 0) + entry.sizeBytes;
+            fileCount++;
+        }
+        return { totalBytes, byCategory, fileCount };
+    }
+    // ── Compaction ────────────────────────────────────────────────────────
+    async compact() {
+        const map = await this.load();
+        const tasks = [...map.values()];
+        const lines = [REGISTRY_SCHEMA, ...tasks.map((t) => JSON.stringify(t))];
+        const before = (await readFile(this.registryPath, "utf-8"))
+            .split("\n")
+            .filter((l) => l.trim().length > 0).length;
+        await writeFile(this.registryPath, lines.join("\n") + "\n", "utf-8");
+        const after = lines.length;
+        log.info("registry compacted", { before, after });
+        return { before, after };
+    }
+    // ── Events query ──────────────────────────────────────────────────────
+    async getEvents(fileId) {
+        await this.ensureFile(this.eventsPath, EVENTS_SCHEMA);
+        const raw = await readFile(this.eventsPath, "utf-8");
+        const events = [];
+        for (const line of raw.split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                if (obj.fileId === fileId)
+                    events.push(obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/files/store.js.map

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

package/dist/files/templates.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Document template management — DASH-65.
+ * Templates live in storage/templates/<name>/ with versioned files.
+ * Supports {{variable}} substitution for Markdown templates.
+ */
+import type { FileEntry } from "./types.js";
+import type { FileStore } from "./store.js";
+export interface TemplateInfo {
+    name: string;
+    slug: string;
+    latestVersion: number;
+    mimeType: string;
+    storagePath: string;
+    fileId: string | null;
+    createdAt: string;
+}
+export interface TemplateGenerateResult {
+    ok: boolean;
+    content?: string;
+    file?: FileEntry;
+    message: string;
+}
+/**
+ * Create a new template from a buffer.
+ * Stores at storage/templates/<slug>/v1.<ext>
+ */
+export declare function createTemplate(name: string, buffer: Buffer, mimeType: string, storageRoot: string, store: FileStore): Promise<{
+    ok: boolean;
+    template?: TemplateInfo;
+    message: string;
+}>;
+/**
+ * List all templates.
+ */
+export declare function listTemplates(storageRoot: string, store: FileStore): Promise<TemplateInfo[]>;
+/**
+ * Get a template by name/slug.
+ */
+export declare function getTemplate(nameOrSlug: string, store: FileStore): Promise<TemplateInfo | null>;
+/**
+ * Generate a document from a template by filling {{variable}} placeholders.
+ * Currently supports Markdown and plain text templates.
+ */
+export declare function generateFromTemplate(nameOrSlug: string, variables: Record<string, string>, storageRoot: string, store: FileStore): Promise<TemplateGenerateResult>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/files/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/files/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuDpE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAe9B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,sBAAsB,CAAC,CA4DjC"}

package/dist/files/templates.js

@@ -0,0 +1,179 @@
+/**
+ * Document template management — DASH-65.
+ * Templates live in storage/templates/<name>/ with versioned files.
+ * Supports {{variable}} substitution for Markdown templates.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+import { slugify } from "./validate.js";
+const log = createLogger("files.templates");
+// ── Template CRUD ───────────────────────────────────────────────────────────
+/**
+ * Create a new template from a buffer.
+ * Stores at storage/templates/<slug>/v1.<ext>
+ */
+export async function createTemplate(name, buffer, mimeType, storageRoot, store) {
+    try {
+        const slug = slugify(name);
+        if (!slug)
+            return { ok: false, message: "Invalid template name" };
+        const ext = extensionForMime(mimeType);
+        const templateDir = join(storageRoot, "templates", slug);
+        await mkdir(templateDir, { recursive: true });
+        const version = 1;
+        const fileName = `v${version}${ext}`;
+        const filePath = join(templateDir, fileName);
+        await writeFile(filePath, buffer);
+        // Register in file store
+        const checksum = createHash("sha256").update(buffer).digest("hex");
+        const storagePath = join("templates", slug, fileName);
+        const entry = await store.create({
+            name,
+            slug,
+            mimeType,
+            sizeBytes: buffer.length,
+            category: "template",
+            tags: ["template"],
+            origin: "system",
+            ownerId: null,
+            taskId: null,
+            parentId: null,
+            version,
+            storagePath,
+            checksum,
+            encrypted: false,
+            visibility: "agents",
+            status: "active",
+        });
+        log.info("template created", { name, slug, fileId: entry.id });
+        return {
+            ok: true,
+            template: {
+                name,
+                slug,
+                latestVersion: version,
+                mimeType,
+                storagePath,
+                fileId: entry.id,
+                createdAt: entry.createdAt,
+            },
+            message: `Template '${name}' created`,
+        };
+    }
+    catch (err) {
+        log.error("template creation failed", { name, error: err.message });
+        return { ok: false, message: `Failed: ${err.message}` };
+    }
+}
+/**
+ * List all templates.
+ */
+export async function listTemplates(storageRoot, store) {
+    const files = await store.list({ category: "template" });
+    return files.map((f) => ({
+        name: f.name,
+        slug: f.slug,
+        latestVersion: f.version,
+        mimeType: f.mimeType,
+        storagePath: f.storagePath,
+        fileId: f.id,
+        createdAt: f.createdAt,
+    }));
+}
+/**
+ * Get a template by name/slug.
+ */
+export async function getTemplate(nameOrSlug, store) {
+    const slug = slugify(nameOrSlug);
+    const files = await store.list({ category: "template" });
+    const match = files.find((f) => f.slug === slug || f.name === nameOrSlug);
+    if (!match)
+        return null;
+    return {
+        name: match.name,
+        slug: match.slug,
+        latestVersion: match.version,
+        mimeType: match.mimeType,
+        storagePath: match.storagePath,
+        fileId: match.id,
+        createdAt: match.createdAt,
+    };
+}
+/**
+ * Generate a document from a template by filling {{variable}} placeholders.
+ * Currently supports Markdown and plain text templates.
+ */
+export async function generateFromTemplate(nameOrSlug, variables, storageRoot, store) {
+    const template = await getTemplate(nameOrSlug, store);
+    if (!template)
+        return { ok: false, message: `Template not found: ${nameOrSlug}` };
+    try {
+        const templatePath = join(storageRoot, template.storagePath);
+        const content = await readFile(templatePath, "utf-8");
+        // Replace {{variable}} placeholders
+        let filled = content;
+        for (const [key, value] of Object.entries(variables)) {
+            filled = filled.replace(new RegExp(`\\{\\{${escapeRegex(key)}\\}\\}`, "g"), value);
+        }
+        // Warn about unfilled placeholders
+        const unfilled = filled.match(/\{\{[^}]+\}\}/g);
+        if (unfilled) {
+            log.warn("template has unfilled placeholders", { template: template.name, unfilled });
+        }
+        // Register the generated file
+        const buffer = Buffer.from(filled, "utf-8");
+        const checksum = createHash("sha256").update(buffer).digest("hex");
+        const now = new Date();
+        const year = now.getFullYear().toString();
+        const month = (now.getMonth() + 1).toString().padStart(2, "0");
+        const slug = slugify(template.name + "-generated");
+        const ext = extensionForMime(template.mimeType);
+        const storagePath = join("generated", year, month, `${slug}${ext}`);
+        const fullPath = join(storageRoot, storagePath);
+        await mkdir(join(storageRoot, "generated", year, month), { recursive: true });
+        await writeFile(fullPath, buffer);
+        const entry = await store.create({
+            name: `${template.name} (generated)`,
+            slug,
+            mimeType: template.mimeType,
+            sizeBytes: buffer.length,
+            category: "report",
+            tags: ["generated", `from:${template.slug}`],
+            origin: "template",
+            ownerId: null,
+            taskId: null,
+            parentId: template.fileId,
+            version: 1,
+            storagePath,
+            checksum,
+            encrypted: false,
+            visibility: "agents",
+            status: "active",
+        });
+        log.info("template generated", { template: template.name, fileId: entry.id });
+        return { ok: true, content: filled, file: entry, message: "Generated from template" };
+    }
+    catch (err) {
+        log.error("template generation failed", { template: template.name, error: err.message });
+        return { ok: false, message: `Generation failed: ${err.message}` };
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function extensionForMime(mimeType) {
+    const map = {
+        "text/markdown": ".md",
+        "text/plain": ".txt",
+        "text/csv": ".csv",
+        "application/json": ".json",
+        "application/x-yaml": ".yaml",
+        "application/pdf": ".pdf",
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+    };
+    return map[mimeType] ?? ".txt";
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=templates.js.map

package/dist/files/templates.js.map

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

package/dist/files/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * File management types — DASH-65.
+ * All interfaces for the file registry, events, validation, and sync.
+ */
+export type FileCategory = "upload" | "report" | "template" | "attachment" | "export" | "resume" | "media" | "ingest" | "other";
+export type FileOrigin = "user-upload" | "agent" | "gdrive-sync" | "template" | "system";
+export type FileStatus = "active" | "archived" | "processing" | "quarantined";
+export type FileVisibility = "private" | "agents" | "shared";
+export interface FileEntry {
+    id: string;
+    name: string;
+    slug: string;
+    mimeType: string;
+    sizeBytes: number;
+    category: FileCategory;
+    tags: string[];
+    origin: FileOrigin;
+    ownerId: string | null;
+    taskId: string | null;
+    parentId: string | null;
+    version: number;
+    storagePath: string;
+    checksum: string;
+    encrypted: boolean;
+    visibility: FileVisibility;
+    status: FileStatus;
+    textPreview?: string;
+    meta?: Record<string, string | number | boolean>;
+    createdAt: string;
+    updatedAt: string;
+}
+export type FileAction = "created" | "updated" | "versioned" | "archived" | "restored" | "downloaded" | "shared" | "quarantined" | "synced" | "attached" | "detached" | "compressed" | "encrypted" | "decrypted";
+export interface FileEvent {
+    id: string;
+    fileId: string;
+    action: FileAction;
+    actor: string;
+    detail?: string;
+    timestamp: string;
+}
+export interface FileFilter {
+    category?: FileCategory;
+    origin?: FileOrigin;
+    status?: FileStatus;
+    tags?: string[];
+    taskId?: string;
+    folderId?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface FileSearchResult {
+    file: FileEntry;
+    relevance: number;
+    matchContext?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    rejected?: string;
+    sanitizedName: string;
+    detectedMime: string;
+    detectedExt: string;
+}
+export interface CompressionResult {
+    originalBytes: number;
+    compressedBytes: number;
+    saved: number;
+    action: string;
+}
+export interface VersionInfo {
+    version: number;
+    storagePath: string;
+    sizeBytes: number;
+    checksum: string;
+    createdAt: string;
+}
+export interface GDriveSyncEntry {
+    fileId: string;
+    driveFileId: string;
+    driveVersion: number;
+    localChecksum: string;
+    syncedAt: string;
+    direction: "push" | "pull";
+}
+export interface ShareLink {
+    id: string;
+    fileId: string;
+    token: string;
+    expiresAt: string;
+    maxDownloads: number | null;
+    downloads: number;
+    createdAt: string;
+}
+export interface FileSettings {
+    enabled: boolean;
+    maxStorageBytes: number;
+    maxUploadBytes: number;
+    maxVersions: number;
+    autoCompress: boolean;
+    autoThumbnail: boolean;
+    encryptSensitive: boolean;
+    cleanupDays: number;
+    gdrive: {
+        syncEnabled: boolean;
+        folderId: string | null;
+        syncIntervalMs: number;
+    };
+}
+export declare const DEFAULT_FILE_SETTINGS: FileSettings;
+export interface StorageUsage {
+    totalBytes: number;
+    byCategory: Record<FileCategory, number>;
+    fileCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/files/types.d.ts.map

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