@tschmz/imp 0.1.0

package/dist/files/tar-archive.js

@@ -0,0 +1,308 @@
+import { createReadStream } from "node:fs";
+import { chmod, mkdir, open, readdir, stat, writeFile } from "node:fs/promises";
+import { dirname, join, posix, relative, resolve, sep } from "node:path";
+const tarBlockSize = 512;
+const zeroBlock = Buffer.alloc(tarBlockSize, 0);
+const defaultReadChunkSize = 64 * 1024;
+const defaultExtractLimits = {
+    maxEntrySizeBytes: 512 * 1024 * 1024,
+    maxEntries: 10_000,
+};
+export async function createTarArchive(sourceDir, outputPath) {
+    const archive = await open(outputPath, "w", 0o600);
+    try {
+        for (const entry of await listTarEntries(sourceDir)) {
+            await archive.write(buildTarHeader(entry));
+            if (entry.type === "file") {
+                const sourcePath = join(sourceDir, entry.path);
+                await writeFileContentToArchive(archive, sourcePath, entry.size);
+            }
+        }
+        await archive.write(zeroBlock);
+        await archive.write(zeroBlock);
+        await archive.chmod(0o600);
+    }
+    finally {
+        await archive.close();
+    }
+}
+export async function extractTarArchive(archivePath, outputDir, options = {}) {
+    const archive = await open(archivePath, "r");
+    const reader = new TarArchiveReader(archive);
+    const directoryModes = new Map();
+    const limits = { ...defaultExtractLimits, ...options };
+    let entries = 0;
+    try {
+        while (true) {
+            const header = await reader.readBlock();
+            if (header === null) {
+                break;
+            }
+            if (isZeroBlock(header)) {
+                break;
+            }
+            entries += 1;
+            if (entries > limits.maxEntries) {
+                throw new Error(`Invalid backup archive: entry count exceeds limit (${limits.maxEntries})`);
+            }
+            assertHeaderChecksum(header);
+            const entry = parseTarHeader(header);
+            const targetPath = resolve(outputDir, entry.path);
+            assertArchivePath(targetPath, outputDir);
+            if (entry.size > limits.maxEntrySizeBytes) {
+                throw new Error(`Invalid backup archive: tar entry too large for ${entry.path} (${entry.size} bytes exceeds ${limits.maxEntrySizeBytes})`);
+            }
+            if (entry.type === "directory") {
+                await mkdir(targetPath, { recursive: true, mode: 0o700 });
+                directoryModes.set(targetPath, normalizeExtractedDirectoryMode(entry.mode));
+                continue;
+            }
+            await mkdir(dirname(targetPath), { recursive: true });
+            await streamEntryContentToFile(reader, targetPath, entry);
+            await reader.skipPadding(entry.size);
+        }
+    }
+    finally {
+        await archive.close();
+    }
+    for (const [path, mode] of [...directoryModes.entries()].sort(([left], [right]) => right.length - left.length)) {
+        await chmod(path, mode);
+    }
+}
+async function listTarEntries(root, currentDir = root) {
+    const dirEntries = await readdir(currentDir, { withFileTypes: true });
+    const entries = [];
+    for (const dirEntry of dirEntries.sort((left, right) => left.name.localeCompare(right.name))) {
+        const absolutePath = join(currentDir, dirEntry.name);
+        const relativePath = toTarPath(relative(root, absolutePath));
+        const fileStat = await stat(absolutePath);
+        if (dirEntry.isDirectory()) {
+            entries.push({
+                path: `${relativePath}/`,
+                type: "directory",
+                mode: fileStat.mode & 0o777,
+                size: 0,
+                mtime: Math.floor(fileStat.mtimeMs / 1000),
+            });
+            entries.push(...(await listTarEntries(root, absolutePath)));
+            continue;
+        }
+        if (dirEntry.isFile()) {
+            entries.push({
+                path: relativePath,
+                type: "file",
+                mode: fileStat.mode & 0o777,
+                size: fileStat.size,
+                mtime: Math.floor(fileStat.mtimeMs / 1000),
+            });
+        }
+    }
+    return entries;
+}
+function buildTarHeader(entry) {
+    const header = Buffer.alloc(tarBlockSize, 0);
+    const { name, prefix } = splitTarPath(entry.path);
+    writeStringField(header, 0, 100, name);
+    writeOctalField(header, 100, 8, entry.mode);
+    writeOctalField(header, 108, 8, 0);
+    writeOctalField(header, 116, 8, 0);
+    writeOctalField(header, 124, 12, entry.size);
+    writeOctalField(header, 136, 12, entry.mtime);
+    header.fill(0x20, 148, 156);
+    header[156] = entry.type === "directory" ? "5".charCodeAt(0) : "0".charCodeAt(0);
+    writeStringField(header, 257, 6, "ustar");
+    writeStringField(header, 263, 2, "00");
+    writeStringField(header, 265, 32, "root");
+    writeStringField(header, 297, 32, "root");
+    writeStringField(header, 345, 155, prefix);
+    const checksum = calculateChecksum(header);
+    writeChecksumField(header, checksum);
+    return header;
+}
+function parseTarHeader(header) {
+    const name = readStringField(header, 0, 100);
+    const prefix = readStringField(header, 345, 155);
+    const path = prefix ? `${prefix}/${name}` : name;
+    const typeFlag = String.fromCharCode(header[156] || "0".charCodeAt(0));
+    const type = typeFlag === "5" ? "directory" : "file";
+    return {
+        path,
+        type,
+        mode: readOctalField(header, 100, 8) || 0o600,
+        size: readOctalField(header, 124, 12),
+        mtime: readOctalField(header, 136, 12),
+    };
+}
+function splitTarPath(path) {
+    if (Buffer.byteLength(path) <= 100) {
+        return { name: path, prefix: "" };
+    }
+    const normalized = path.endsWith("/") ? path.slice(0, -1) : path;
+    const segments = normalized.split("/");
+    for (let index = segments.length - 1; index > 0; index -= 1) {
+        const prefix = segments.slice(0, index).join("/");
+        const name = segments.slice(index).join("/");
+        if (Buffer.byteLength(name) <= 100 && Buffer.byteLength(prefix) <= 155) {
+            return {
+                name: path.endsWith("/") ? `${name}/` : name,
+                prefix,
+            };
+        }
+    }
+    throw new Error(`Archive entry path is too long for tar format: ${path}`);
+}
+function writeStringField(buffer, offset, length, value) {
+    const encoded = Buffer.from(value, "utf8");
+    if (encoded.byteLength > length) {
+        throw new Error(`Value does not fit in tar header field: ${value}`);
+    }
+    encoded.copy(buffer, offset);
+}
+function writeOctalField(buffer, offset, length, value) {
+    const encoded = Buffer.from(value.toString(8).padStart(length - 1, "0").slice(-(length - 1)), "ascii");
+    encoded.copy(buffer, offset);
+    buffer[offset + length - 1] = 0;
+}
+function writeChecksumField(buffer, checksum) {
+    const encoded = Buffer.from(checksum.toString(8).padStart(6, "0"), "ascii");
+    encoded.copy(buffer, 148);
+    buffer[154] = 0;
+    buffer[155] = 0x20;
+}
+function readStringField(buffer, offset, length) {
+    return buffer
+        .subarray(offset, offset + length)
+        .toString("utf8")
+        .replace(/\0.*$/, "")
+        .trim();
+}
+function readOctalField(buffer, offset, length) {
+    const raw = buffer
+        .subarray(offset, offset + length)
+        .toString("ascii")
+        .replace(/\0.*$/, "")
+        .trim();
+    if (!raw) {
+        return 0;
+    }
+    return Number.parseInt(raw, 8);
+}
+function calculateChecksum(buffer) {
+    let sum = 0;
+    for (const byte of buffer) {
+        sum += byte;
+    }
+    return sum;
+}
+function assertHeaderChecksum(header) {
+    const expected = readOctalField(header, 148, 8);
+    const copy = Buffer.from(header);
+    copy.fill(0x20, 148, 156);
+    const actual = calculateChecksum(copy);
+    if (expected !== actual) {
+        throw new Error("Invalid backup archive: tar header checksum mismatch");
+    }
+}
+function isZeroBlock(block) {
+    return block.equals(zeroBlock);
+}
+function getPaddingSize(size) {
+    const remainder = size % tarBlockSize;
+    return remainder === 0 ? 0 : tarBlockSize - remainder;
+}
+function normalizeExtractedDirectoryMode(mode) {
+    return mode | 0o100;
+}
+function toTarPath(path) {
+    return path.split(sep).join(posix.sep);
+}
+function assertArchivePath(targetPath, outputDir) {
+    const normalizedOutputDir = resolve(outputDir);
+    if (targetPath !== normalizedOutputDir &&
+        !targetPath.startsWith(`${normalizedOutputDir}${sep}`)) {
+        throw new Error("Invalid backup archive: contains path traversal entry");
+    }
+}
+async function writeFileContentToArchive(archive, sourcePath, size) {
+    for await (const chunk of createReadStream(sourcePath)) {
+        await archive.write(chunk);
+    }
+    await writePadding(archive, size);
+}
+async function writePadding(archive, size) {
+    const paddingSize = getPaddingSize(size);
+    if (paddingSize > 0) {
+        await archive.write(Buffer.alloc(paddingSize, 0));
+    }
+}
+async function streamEntryContentToFile(reader, targetPath, entry) {
+    if (entry.size === 0) {
+        await writeFile(targetPath, Buffer.alloc(0), { mode: entry.mode });
+        return;
+    }
+    const output = await open(targetPath, "w", entry.mode);
+    try {
+        let remaining = entry.size;
+        while (remaining > 0) {
+            const chunkSize = Math.min(remaining, defaultReadChunkSize);
+            const chunk = await reader.readExact(chunkSize, `Invalid backup archive: truncated tar entry for ${entry.path}`);
+            let writeOffset = 0;
+            while (writeOffset < chunk.byteLength) {
+                const { bytesWritten } = await output.write(chunk, writeOffset, chunk.byteLength - writeOffset);
+                if (bytesWritten === 0) {
+                    throw new Error(`Failed to extract tar entry: short write for ${entry.path}`);
+                }
+                writeOffset += bytesWritten;
+            }
+            remaining -= chunk.byteLength;
+        }
+    }
+    finally {
+        await output.close();
+    }
+}
+class TarArchiveReader {
+    archive;
+    offset = 0;
+    constructor(archive) {
+        this.archive = archive;
+    }
+    async readBlock() {
+        const block = await this.readChunk(tarBlockSize);
+        if (block.byteLength === 0) {
+            return null;
+        }
+        if (block.byteLength < tarBlockSize) {
+            throw new Error("Invalid backup archive: truncated tar header");
+        }
+        return block;
+    }
+    async readExact(size, errorMessage) {
+        const chunk = await this.readChunk(size);
+        if (chunk.byteLength !== size) {
+            throw new Error(errorMessage);
+        }
+        return chunk;
+    }
+    async skipPadding(size) {
+        const paddingSize = getPaddingSize(size);
+        if (paddingSize === 0) {
+            return;
+        }
+        await this.readExact(paddingSize, "Invalid backup archive: truncated tar padding");
+    }
+    async readChunk(size) {
+        const buffer = Buffer.allocUnsafe(size);
+        let totalBytesRead = 0;
+        while (totalBytesRead < size) {
+            const { bytesRead } = await this.archive.read(buffer, totalBytesRead, size - totalBytesRead, this.offset);
+            if (bytesRead === 0) {
+                break;
+            }
+            totalBytesRead += bytesRead;
+            this.offset += bytesRead;
+        }
+        return buffer.subarray(0, totalBytesRead);
+    }
+}
+//# sourceMappingURL=tar-archive.js.map

package/dist/files/tar-archive.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createDaemon } from "./daemon/create-daemon.js";
+export type { Daemon, DaemonConfig } from "./daemon/types.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createDaemon } from "./daemon/create-daemon.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/logging/daemon-startup-failure-reporter.d.ts

@@ -0,0 +1,2 @@
+import type { DaemonStartupFailureReporter } from "../application/run-daemon-use-case.js";
+export declare function createDaemonStartupFailureReporter(): DaemonStartupFailureReporter;

package/dist/logging/daemon-startup-failure-reporter.js

@@ -0,0 +1,19 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { createFileLogger } from "./file-logger.js";
+export function createDaemonStartupFailureReporter() {
+    return {
+        report: async ({ runtimeConfig, error }) => {
+            await Promise.all(runtimeConfig.activeEndpoints.map(async (endpoint) => {
+                await ensureStartupLogFile(endpoint.paths.logFilePath);
+                const logger = createFileLogger(endpoint.paths.logFilePath, runtimeConfig.logging.level);
+                await logger.error("daemon failed to start", { endpointId: endpoint.id }, error);
+            }));
+        },
+    };
+}
+async function ensureStartupLogFile(path) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, "", { encoding: "utf8", flag: "a" });
+}
+//# sourceMappingURL=daemon-startup-failure-reporter.js.map

package/dist/logging/daemon-startup-failure-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-startup-failure-reporter.js","sourceRoot":"","sources":["../../src/logging/daemon-startup-failure-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE;YACzC,MAAM,OAAO,CAAC,GAAG,CACf,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACnD,MAAM,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzF,MAAM,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACnF,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY;IAC9C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/logging/file-logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger, LogLevel } from "./types.js";
+export declare function createFileLogger(path: string, level?: LogLevel): Logger;
+export declare function rotateLogFileOnStartup(path: string): Promise<void>;

package/dist/logging/file-logger.js

@@ -0,0 +1,87 @@
+import { appendFile, mkdir, rename, stat, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+const LOG_LEVEL_PRIORITY = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+export function createFileLogger(path, level = "info") {
+    return {
+        async debug(message, fields) {
+            if (!shouldLog("debug", level)) {
+                return;
+            }
+            await writeLogLine(path, "DEBUG", message, fields);
+            console.debug(formatConsoleLog(message, fields));
+        },
+        async info(message, fields) {
+            if (!shouldLog("info", level)) {
+                return;
+            }
+            await writeLogLine(path, "INFO", message, fields);
+            console.log(formatConsoleLog(message, fields));
+        },
+        async error(message, fields, error) {
+            if (!shouldLog("error", level)) {
+                return;
+            }
+            await writeLogLine(path, "ERROR", message, fields);
+            if (error !== undefined) {
+                await writeLogLine(path, "ERROR", formatError(error), fields);
+            }
+            console.error(formatConsoleLog(message, fields));
+            if (error !== undefined) {
+                console.error(error);
+            }
+        },
+    };
+}
+export async function rotateLogFileOnStartup(path) {
+    await mkdir(dirname(path), { recursive: true });
+    const hasContent = await hasExistingLogContent(path);
+    if (hasContent) {
+        await rename(path, `${path}.1`);
+    }
+    await writeFile(path, "", { encoding: "utf8", flag: "w" });
+}
+async function hasExistingLogContent(path) {
+    try {
+        const fileStats = await stat(path);
+        return fileStats.size > 0;
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function shouldLog(entryLevel, configuredLevel) {
+    return LOG_LEVEL_PRIORITY[entryLevel] >= LOG_LEVEL_PRIORITY[configuredLevel];
+}
+async function writeLogLine(path, level, message, fields) {
+    const payload = {
+        ts: new Date().toISOString(),
+        level,
+        message,
+        ...(fields ?? {}),
+    };
+    await appendFile(path, `${JSON.stringify(payload)}\n`, "utf8");
+}
+function isMissingFileError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function formatError(error) {
+    if (error instanceof Error) {
+        return error.stack ?? `${error.name}: ${error.message}`;
+    }
+    return String(error);
+}
+function formatConsoleLog(message, fields) {
+    if (!fields || Object.keys(fields).length === 0) {
+        return message;
+    }
+    return `${message} ${JSON.stringify(fields)}`;
+}
+//# sourceMappingURL=file-logger.js.map

package/dist/logging/file-logger.js.map

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

package/dist/logging/types.d.ts

@@ -0,0 +1,34 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogFields {
+    endpointId?: string;
+    transport?: string;
+    conversationId?: string;
+    messageId?: string;
+    agentId?: string;
+    correlationId?: string;
+    command?: string;
+    backupId?: string;
+    durationMs?: number;
+    errorType?: string;
+    hookName?: string;
+    hookRegistrationName?: string;
+    skillCount?: number;
+    skillNames?: string[];
+    workspaceDirectory?: string;
+    workspaceSkillsPath?: string;
+    overriddenSkillNames?: string[];
+    initialWorkingDirectory?: string;
+    configuredBuiltInTools?: string[];
+    resolvedBuiltInTools?: string[];
+    missingBuiltInTools?: string[];
+    configuredMcpServers?: string[];
+    initializedMcpServers?: string[];
+    failedMcpServers?: string[];
+    resolvedMcpTools?: string[];
+    resolvedTools?: string[];
+}
+export interface Logger {
+    debug(message: string, fields?: LogFields): Promise<void>;
+    info(message: string, fields?: LogFields): Promise<void>;
+    error(message: string, fields?: LogFields, error?: unknown): Promise<void>;
+}

package/dist/logging/types.js

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

package/dist/logging/types.js.map

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

package/dist/logging/view-logs.d.ts

@@ -0,0 +1,27 @@
+import type { DaemonConfig } from "../daemon/types.js";
+export interface LogTarget {
+    endpointId: string;
+    logFilePath: string;
+}
+type ReadLogFile = (path: string, encoding: "utf8") => Promise<string>;
+type WatchLogFile = (path: string, options: {
+    signal?: AbortSignal;
+}) => AsyncIterable<{
+    eventType: string;
+}>;
+interface ViewLogsDependencies {
+    readFile?: ReadLogFile;
+    watch?: WatchLogFile;
+}
+export declare function viewDaemonLogs(options: {
+    runtimeConfig: DaemonConfig;
+    endpointId?: string;
+    lines?: number;
+    follow?: boolean;
+    stdout?: NodeJS.WritableStream;
+    signal?: AbortSignal;
+    dependencies?: ViewLogsDependencies;
+}): Promise<void>;
+export declare function resolveLogTargets(runtimeConfig: DaemonConfig, endpointId?: string): LogTarget[];
+export declare function readRecentLogLines(logFilePath: string, lines: number, readFileImpl?: ReadLogFile): Promise<string[]>;
+export {};