@nuomiji/agentbox 0.1.0

package/dist/core/archive.js

@@ -0,0 +1,46 @@
+import { createWriteStream } from "node:fs";
+import { mkdir, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import AdmZip from "adm-zip";
+import { ZipFile } from "yazl";
+export async function createArchiveFromDirectory(inputDir, outputFile) {
+    await mkdir(path.dirname(outputFile), { recursive: true });
+    const zip = new ZipFile();
+    const output = createWriteStream(outputFile);
+    const completion = new Promise((resolve, reject) => {
+        output.on("close", () => resolve());
+        output.on("error", reject);
+        zip.outputStream.on("error", reject);
+    });
+    zip.outputStream.pipe(output);
+    await addDirectoryToArchive(zip, inputDir, inputDir);
+    zip.end();
+    await completion;
+}
+export async function extractArchiveToDirectory(inputFile, outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const zip = new AdmZip(inputFile);
+    zip.extractAllTo(outputDir, true);
+}
+async function addDirectoryToArchive(zip, rootDir, currentDir) {
+    const entries = await readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        const relativePath = toPosix(path.relative(rootDir, fullPath));
+        if (entry.isDirectory()) {
+            zip.addEmptyDirectory(relativePath);
+            await addDirectoryToArchive(zip, rootDir, fullPath);
+            continue;
+        }
+        if (entry.isFile()) {
+            const info = await stat(fullPath);
+            zip.addFile(fullPath, relativePath, {
+                mtime: info.mtime
+            });
+        }
+    }
+}
+function toPosix(value) {
+    return value.split(path.sep).join("/");
+}
+//# sourceMappingURL=archive.js.map

package/dist/core/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,QAAgB,EAAE,UAAkB;IACnF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3D,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrD,GAAG,CAAC,GAAG,EAAE,CAAC;IAEV,MAAM,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,SAAiB,EAAE,SAAiB;IAClF,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,GAAY,EAAE,OAAe,EAAE,UAAkB;IACpF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACpC,MAAM,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE;gBAClC,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/bindings.d.ts

@@ -0,0 +1,22 @@
+import type { BindingRequirement } from "./types.js";
+export interface BindingResolutionSource {
+    kind: "explicit" | "env-file" | "process-env" | "template-empty";
+    name: string;
+    values: Record<string, string | undefined>;
+}
+export interface BindingResolutionEntry {
+    key: string;
+    kind: BindingRequirement["kind"];
+    required: boolean;
+    description: string;
+    value: string;
+    provided: boolean;
+    source: BindingResolutionSource["kind"];
+}
+export interface BindingResolutionResult {
+    entries: BindingResolutionEntry[];
+    values: Record<string, string>;
+    missingRequired: BindingResolutionEntry[];
+    providedCount: number;
+}
+export declare function resolveBindings(requirements: BindingRequirement[], templateEntries: Record<string, string>, sources: BindingResolutionSource[]): BindingResolutionResult;

package/dist/core/bindings.js

@@ -0,0 +1,46 @@
+export function resolveBindings(requirements, templateEntries, sources) {
+    const requirementMap = new Map(requirements.map((binding) => [binding.key, binding]));
+    const allKeys = new Set([
+        ...Object.keys(templateEntries),
+        ...requirements.map((binding) => binding.key)
+    ]);
+    const entries = [];
+    const values = {};
+    for (const key of Array.from(allKeys).sort()) {
+        const requirement = requirementMap.get(key);
+        const resolved = resolveBindingValue(key, sources);
+        const value = resolved?.value ?? templateEntries[key] ?? "";
+        const entry = {
+            key,
+            kind: requirement?.kind ?? "secret",
+            required: requirement?.required ?? false,
+            description: requirement?.description ?? `Binding required by template key "${key}"`,
+            value,
+            provided: value.length > 0,
+            source: resolved?.source ?? "template-empty"
+        };
+        entries.push(entry);
+        values[key] = value;
+    }
+    const missingRequired = entries.filter((entry) => entry.required && !entry.provided);
+    const providedCount = entries.filter((entry) => entry.provided).length;
+    return {
+        entries,
+        values,
+        missingRequired,
+        providedCount
+    };
+}
+function resolveBindingValue(key, sources) {
+    for (const source of sources) {
+        const value = source.values[key];
+        if (value !== undefined && value.length > 0) {
+            return {
+                value,
+                source: source.kind
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=bindings.js.map

package/dist/core/bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/core/bindings.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,eAAe,CAC7B,YAAkC,EAClC,eAAuC,EACvC,OAAkC;IAElC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS;QAC9B,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;QAC/B,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;KAC9C,CAAC,CAAC;IAEH,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,KAAK,GAA2B;YACpC,GAAG;YACH,IAAI,EAAE,WAAW,EAAE,IAAI,IAAI,QAAQ;YACnC,QAAQ,EAAE,WAAW,EAAE,QAAQ,IAAI,KAAK;YACxC,WAAW,EAAE,WAAW,EAAE,WAAW,IAAI,qCAAqC,GAAG,GAAG;YACpF,KAAK;YACL,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;YAC1B,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,gBAAgB;SAC7C,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrF,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAEvE,OAAO;QACL,OAAO;QACP,MAAM;QACN,eAAe;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAW,EACX,OAAkC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,13 @@
+export interface ParsedEnvLine {
+    kind: "entry" | "comment" | "blank";
+    raw: string;
+    key?: string;
+    value?: string;
+}
+export declare function parseEnvTemplate(input: string): ParsedEnvLine[];
+export declare function parseEnvObject(input: string): Record<string, string>;
+export declare function serializeEnvObject(values: Record<string, string>): string;
+export declare function parseKeyValueArg(input: string): {
+    key: string;
+    value: string;
+};

package/dist/core/env.js

@@ -0,0 +1,49 @@
+export function parseEnvTemplate(input) {
+    return input.split(/\r?\n/).map((line) => {
+        if (line.trim() === "") {
+            return { kind: "blank", raw: line };
+        }
+        if (line.trimStart().startsWith("#")) {
+            return { kind: "comment", raw: line };
+        }
+        const equalsIndex = line.indexOf("=");
+        if (equalsIndex === -1) {
+            return { kind: "comment", raw: line };
+        }
+        const key = line.slice(0, equalsIndex).trim();
+        const value = line.slice(equalsIndex + 1);
+        return {
+            kind: "entry",
+            raw: line,
+            key,
+            value
+        };
+    });
+}
+export function parseEnvObject(input) {
+    const result = {};
+    for (const line of parseEnvTemplate(input)) {
+        if (line.kind === "entry" && line.key) {
+            result[line.key] = line.value ?? "";
+        }
+    }
+    return result;
+}
+export function serializeEnvObject(values) {
+    const keys = Object.keys(values).sort();
+    if (keys.length === 0) {
+        return "# No bindings supplied.\n";
+    }
+    return `${keys.map((key) => `${key}=${values[key] ?? ""}`).join("\n")}\n`;
+}
+export function parseKeyValueArg(input) {
+    const equalsIndex = input.indexOf("=");
+    if (equalsIndex <= 0) {
+        throw new Error(`Invalid --set value "${input}". Expected KEY=VALUE.`);
+    }
+    return {
+        key: input.slice(0, equalsIndex).trim(),
+        value: input.slice(equalsIndex + 1)
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAgB,CAAC,IAAI,EAAE,EAAE;QACtD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,IAAI;YACT,GAAG;YACH,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA8B;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,wBAAwB,CAAC,CAAC;IACzE,CAAC;IACD,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE;QACvC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/core/fs.d.ts

@@ -0,0 +1,12 @@
+export declare function pathExists(targetPath: string): Promise<boolean>;
+export declare function readJsonIfExists<T>(targetPath: string): Promise<T | null>;
+export declare function readTextIfExists(targetPath: string): Promise<string | null>;
+export declare function countDirectoryEntries(targetPath: string, kind?: "file" | "directory" | "any"): Promise<number>;
+export declare function listDirectoryNames(targetPath: string, limit?: number): Promise<string[]>;
+export declare function listFileNames(targetPath: string, limit?: number): Promise<string[]>;
+export declare function listMarkdownFilesRecursive(targetPath: string, limit?: number): Promise<string[]>;
+export declare function listFilesRecursive(targetPath: string, limit?: number, filter?: (entryPath: string) => boolean): Promise<string[]>;
+export declare function listRecentFiles(targetPath: string, limit?: number, extensions?: string[]): Promise<string[]>;
+export declare function readTextPreview(targetPath: string, maxChars?: number): Promise<string | null>;
+export declare function readJsonlTail<T>(targetPath: string, limit?: number): Promise<T[]>;
+export declare function detectFormat(targetPath: string): Promise<"file" | "directory" | "json" | "yaml" | "toml" | "markdown" | "sqlite" | "unknown">;

package/dist/core/fs.js

@@ -0,0 +1,233 @@
+import { access, readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+export async function pathExists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readJsonIfExists(targetPath) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return null;
+        }
+        const raw = await readFile(targetPath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function readTextIfExists(targetPath) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return null;
+        }
+        return await readFile(targetPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function countDirectoryEntries(targetPath, kind = "any") {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return 0;
+        }
+        const entries = await readdir(targetPath, { withFileTypes: true });
+        if (kind === "any") {
+            return entries.length;
+        }
+        return entries.filter((entry) => (kind === "file" ? entry.isFile() : entry.isDirectory())).length;
+    }
+    catch {
+        return 0;
+    }
+}
+export async function listDirectoryNames(targetPath, limit = 50) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const entries = await readdir(targetPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .slice(0, limit)
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+export async function listFileNames(targetPath, limit = 50) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const entries = await readdir(targetPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile())
+            .slice(0, limit)
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+export async function listMarkdownFilesRecursive(targetPath, limit = 100) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const results = [];
+        await walk(targetPath, async (entryPath, isDirectory) => {
+            if (results.length >= limit) {
+                return;
+            }
+            if (!isDirectory && entryPath.toLowerCase().endsWith(".md")) {
+                results.push(entryPath);
+            }
+        });
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+export async function listFilesRecursive(targetPath, limit = 100, filter) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const results = [];
+        await walk(targetPath, async (entryPath, isDirectory) => {
+            if (results.length >= limit || isDirectory) {
+                return;
+            }
+            if (!filter || filter(entryPath)) {
+                results.push(entryPath);
+            }
+        });
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+export async function listRecentFiles(targetPath, limit = 20, extensions) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const files = await listFilesRecursive(targetPath, Math.max(limit * 5, limit), (entryPath) => {
+            if (!extensions || extensions.length === 0) {
+                return true;
+            }
+            const lower = entryPath.toLowerCase();
+            return extensions.some((extension) => lower.endsWith(extension.toLowerCase()));
+        });
+        const withStats = await Promise.all(files.map(async (filePath) => {
+            try {
+                return { filePath, mtimeMs: (await stat(filePath)).mtimeMs };
+            }
+            catch {
+                return { filePath, mtimeMs: 0 };
+            }
+        }));
+        return withStats
+            .filter((entry) => entry.mtimeMs > 0)
+            .sort((left, right) => right.mtimeMs - left.mtimeMs)
+            .slice(0, limit)
+            .map((entry) => entry.filePath);
+    }
+    catch {
+        return [];
+    }
+}
+export async function readTextPreview(targetPath, maxChars = 600) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return null;
+        }
+        const raw = await readFile(targetPath, "utf8");
+        const normalized = raw.replace(/\r\n/g, "\n").trim();
+        if (!normalized) {
+            return null;
+        }
+        return normalized.length > maxChars ? `${normalized.slice(0, maxChars - 3)}...` : normalized;
+    }
+    catch {
+        return null;
+    }
+}
+export async function readJsonlTail(targetPath, limit = 20) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return [];
+        }
+        const raw = await readFile(targetPath, "utf8");
+        const lines = raw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0)
+            .slice(-limit);
+        const results = [];
+        for (const line of lines) {
+            try {
+                results.push(JSON.parse(line));
+            }
+            catch {
+                // Ignore malformed lines for best-effort history extraction.
+            }
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+export async function detectFormat(targetPath) {
+    try {
+        if (!(await pathExists(targetPath))) {
+            return "unknown";
+        }
+        const info = await stat(targetPath);
+        if (info.isDirectory()) {
+            return "directory";
+        }
+        const lower = targetPath.toLowerCase();
+        if (lower.endsWith(".json")) {
+            return "json";
+        }
+        if (lower.endsWith(".yaml") || lower.endsWith(".yml")) {
+            return "yaml";
+        }
+        if (lower.endsWith(".toml")) {
+            return "toml";
+        }
+        if (lower.endsWith(".md")) {
+            return "markdown";
+        }
+        if (lower.endsWith(".sqlite") || lower.endsWith(".db")) {
+            return "sqlite";
+        }
+        return "file";
+    }
+    catch {
+        return "unknown";
+    }
+}
+async function walk(root, visit) {
+    const entries = await readdir(root, { withFileTypes: true });
+    for (const entry of entries) {
+        const entryPath = path.join(root, entry.name);
+        await visit(entryPath, entry.isDirectory());
+        if (entry.isDirectory()) {
+            await walk(entryPath, visit);
+        }
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/core/fs.js.map

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

package/dist/core/materialize.d.ts

@@ -0,0 +1,10 @@
+import type { SupportedHost } from "./types.js";
+export type InstallScope = "user" | "project";
+export interface PathResolutionContext {
+    mode: "sandbox" | "real-home";
+    targetRoot?: string;
+    projectRoot?: string;
+}
+export declare function getDefaultInstallScope(targetHost: SupportedHost): InstallScope;
+export declare function resolvePortablePath(portablePath: string, context: PathResolutionContext): string;
+export declare function describeMaterializationMode(context: PathResolutionContext): string;

package/dist/core/materialize.js

@@ -0,0 +1,54 @@
+import { homedir } from "node:os";
+import path from "node:path";
+export function getDefaultInstallScope(targetHost) {
+    return "user";
+}
+export function resolvePortablePath(portablePath, context) {
+    const portable = portablePath.replace(/\//g, "\\");
+    if (context.mode === "real-home") {
+        if (portable.startsWith("{{HOME}}")) {
+            return path.join(homedir(), portable.slice("{{HOME}}".length).replace(/^\\+/, ""));
+        }
+        if (portable.startsWith("{{PROJECT_ROOT}}")) {
+            if (!context.projectRoot) {
+                throw new Error(`Portable path requires project root but none was provided: ${portablePath}`);
+            }
+            return path.join(path.resolve(context.projectRoot), portable.slice("{{PROJECT_ROOT}}".length).replace(/^\\+/, ""));
+        }
+        if (portable.startsWith("{{TARGET_SKILLS_ROOT}}")) {
+            throw new Error("{{TARGET_SKILLS_ROOT}} cannot be resolved in real-home mode without an explicit sandbox target root.");
+        }
+        if (path.isAbsolute(portable)) {
+            return portable;
+        }
+        if (!context.projectRoot) {
+            throw new Error(`Relative portable path requires project root in real-home mode: ${portablePath}`);
+        }
+        return path.join(path.resolve(context.projectRoot), portable);
+    }
+    if (!context.targetRoot) {
+        throw new Error("Sandbox path resolution requires targetRoot.");
+    }
+    const targetRoot = path.resolve(context.targetRoot);
+    if (portable.startsWith("{{HOME}}")) {
+        return path.join(targetRoot, "home", portable.slice("{{HOME}}".length).replace(/^\\+/, ""));
+    }
+    if (portable.startsWith("{{PROJECT_ROOT}}")) {
+        return path.join(targetRoot, "project", portable.slice("{{PROJECT_ROOT}}".length).replace(/^\\+/, ""));
+    }
+    if (portable.startsWith("{{TARGET_SKILLS_ROOT}}")) {
+        return path.join(targetRoot, "skills", portable.slice("{{TARGET_SKILLS_ROOT}}".length).replace(/^\\+/, ""));
+    }
+    if (path.isAbsolute(portable)) {
+        const driveSanitized = portable.replace(/[:\\\/]/g, "_");
+        return path.join(targetRoot, "absolute", driveSanitized);
+    }
+    return path.join(targetRoot, portable);
+}
+export function describeMaterializationMode(context) {
+    if (context.mode === "real-home") {
+        return context.projectRoot ? `real-home (project root: ${path.resolve(context.projectRoot)})` : "real-home";
+    }
+    return `sandbox (${path.resolve(context.targetRoot ?? ".")})`;
+}
+//# sourceMappingURL=materialize.js.map

package/dist/core/materialize.js.map

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

package/dist/core/redaction.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedSnapshot, SourceSnapshot } from "./types.js";
+export interface RedactionEvent {
+    kind: "path" | "token-like" | "url-credential" | "binding-template";
+    location: string;
+    beforePreview: string;
+    afterPreview: string;
+    reason: string;
+}
+export interface SecurityAudit {
+    generatedAt: string;
+    rulesVersion: string;
+    eventCount: number;
+    events: RedactionEvent[];
+}
+export interface RedactionContext {
+    homeDir: string;
+    cwd: string;
+}
+export interface RedactionResult {
+    resolved: ResolvedSnapshot;
+    sources: SourceSnapshot;
+    audit: SecurityAudit;
+    bindingsTemplate: string;
+}
+export declare function redactCollectedData(context: RedactionContext, resolved: ResolvedSnapshot, sources: SourceSnapshot): RedactionResult;