@nuomiji/agentbox 0.1.0

package/dist/commands/import.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1 @@
+export declare function inspectCommand(targetPath: string): Promise<void>;

package/dist/commands/inspect.js

@@ -0,0 +1,21 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+export async function inspectCommand(targetPath) {
+    const root = path.resolve(targetPath);
+    const manifestPath = path.join(root, "box.yaml");
+    const resolvedPath = path.join(root, "resolved.yaml");
+    const manifest = parse(await readFile(manifestPath, "utf8"));
+    const resolved = parse(await readFile(resolvedPath, "utf8"));
+    process.stdout.write(`Name: ${manifest.metadata.name}\n`);
+    process.stdout.write(`Source host: ${manifest.metadata.sourceHost}\n`);
+    process.stdout.write(`Created at: ${manifest.metadata.createdAt}\n`);
+    process.stdout.write(`Suggested targets: ${manifest.compatibility.suggestedTargets.join(", ")}\n`);
+    process.stdout.write(`Bindings: ${resolved.bindings.length}\n`);
+    process.stdout.write(`Host artifacts: ${resolved.hostArtifacts.length}\n`);
+    process.stdout.write(`Enabled layer files:\n`);
+    for (const [layerName, layerRef] of Object.entries(manifest.layers)) {
+        process.stdout.write(`- ${layerName}: ${layerRef.path} (${layerRef.portability})\n`);
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAgB,CAAC;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAqB,CAAC;IAEjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE/C,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,WAAW,KAAK,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/dist/commands/install-skills.d.ts

@@ -0,0 +1,11 @@
+import type { InstallScope } from "../core/materialize.js";
+export interface InstallSkillsCommandOptions {
+    execute?: boolean;
+    targetRoot?: string;
+    realHome?: boolean;
+    projectRoot?: string;
+    scope?: InstallScope;
+    force?: boolean;
+    only?: string[];
+}
+export declare function installSkillsCommand(inputPath: string, options: InstallSkillsCommandOptions): Promise<void>;

package/dist/commands/install-skills.js

@@ -0,0 +1,316 @@
+import { cp, mkdir, mkdtemp, readFile, rm, stat, symlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { tmpdir } from "node:os";
+import { spawn } from "node:child_process";
+import { parse } from "yaml";
+import { describeMaterializationMode, getDefaultInstallScope, resolvePortablePath } from "../core/materialize.js";
+import { pathExists } from "../core/fs.js";
+import { toYaml } from "../core/yaml.js";
+import { resolveSkillTargetStrategy } from "../import/install-plan.js";
+export async function installSkillsCommand(inputPath, options) {
+    const planPath = await resolvePlanPath(inputPath);
+    const parsedPlan = parse(await readFile(planPath, "utf8"));
+    const scope = options.scope ?? parsedPlan.scope ?? getDefaultInstallScope(parsedPlan.targetHost);
+    const plan = withScopeOverride(parsedPlan, scope);
+    const selectedEntries = selectEntries(plan.entries, options.only ?? []);
+    const resolutionContext = getResolutionContext(planPath, options);
+    validateResolutionContext(resolutionContext, options.execute === true);
+    if (selectedEntries.length === 0) {
+        throw new Error("No matching skill entries were found in the install plan.");
+    }
+    if (!options.execute) {
+        printDryRun(planPath, plan, selectedEntries, resolutionContext);
+        return;
+    }
+    const reportRoot = getReportRoot(planPath, resolutionContext);
+    await mkdir(reportRoot, { recursive: true });
+    const reportEntries = [];
+    for (const entry of selectedEntries) {
+        const reportEntry = await installSkillEntry(entry, resolutionContext, options.force === true);
+        reportEntries.push(reportEntry);
+    }
+    const report = {
+        apiVersion: "agentbox/v0.1",
+        kind: "SkillInstallReport",
+        planPath,
+        executed: true,
+        targetRoot: reportRoot,
+        installedCount: reportEntries.filter((entry) => entry.status === "installed").length,
+        skippedCount: reportEntries.filter((entry) => entry.status === "skipped").length,
+        entries: reportEntries
+    };
+    const reportPath = path.join(reportRoot, "agentbox-skill-install-report.yaml");
+    await writeFile(reportPath, toYaml(report), "utf8");
+    const activationMapPath = path.join(reportRoot, "agentbox-skill-activation-map.yaml");
+    await writeFile(activationMapPath, toYaml(buildActivationMap(reportRoot, selectedEntries, reportEntries)), "utf8");
+    process.stdout.write(`Skill install plan executed: ${planPath}\n`);
+    process.stdout.write(`Target scope: ${scope}\n`);
+    process.stdout.write(`Mode: ${describeMaterializationMode(resolutionContext)}\n`);
+    process.stdout.write(`Installed: ${report.installedCount}\n`);
+    process.stdout.write(`Skipped: ${report.skippedCount}\n`);
+    process.stdout.write(`Report: ${reportPath}\n`);
+    process.stdout.write(`Activation map: ${activationMapPath}\n`);
+    const failedEntries = reportEntries.filter((entry) => entry.status === "failed");
+    if (failedEntries.length > 0) {
+        throw new Error(`Skill installation failed for: ${failedEntries.map((entry) => entry.skillName).join(", ")}`);
+    }
+}
+async function resolvePlanPath(inputPath) {
+    const resolved = path.resolve(inputPath);
+    const info = await stat(resolved);
+    if (info.isFile()) {
+        return resolved;
+    }
+    const candidates = [
+        path.join(resolved, "skill-install-plan.yaml"),
+        path.join(resolved, "agentbox-skill-install-plan.yaml")
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`No skill install plan was found under: ${resolved}`);
+}
+function selectEntries(entries, only) {
+    if (only.length === 0) {
+        return entries;
+    }
+    const allowed = new Set(only);
+    return entries.filter((entry) => allowed.has(entry.skillName));
+}
+function printDryRun(planPath, plan, entries, resolutionContext) {
+    process.stdout.write(`Skill install dry-run: ${planPath}\n`);
+    process.stdout.write(`Source host: ${plan.sourceHost}\n`);
+    process.stdout.write(`Target host: ${plan.targetHost}\n`);
+    process.stdout.write(`Target scope: ${plan.scope}\n`);
+    process.stdout.write(`Mode: ${describeMaterializationMode(resolutionContext)}\n`);
+    for (const entry of entries) {
+        process.stdout.write(`- ${entry.skillName}: ${entry.installStrategy}\n`);
+        process.stdout.write(`  source: ${entry.source.sourceUrl ?? "(manual)"}\n`);
+        process.stdout.write(`  target folder: ${resolvePortablePath(path.join(entry.target.downloadRoot, entry.target.targetFolderName), resolutionContext)}\n`);
+    }
+    process.stdout.write("Use --execute to materialize these skills.\n");
+}
+async function installSkillEntry(entry, resolutionContext, force) {
+    const notes = [...entry.notes];
+    const downloadRoot = resolvePortablePath(entry.target.downloadRoot, resolutionContext);
+    const activationRoot = resolvePortablePath(entry.target.activationRoot, resolutionContext);
+    const destinationPath = path.join(downloadRoot, entry.target.targetFolderName);
+    if (entry.status === "manual-review" || entry.installStrategy === "manual" || !entry.source.sourceUrl) {
+        notes.push("Skipped automatic installation because this skill requires manual review.");
+        return {
+            skillName: entry.skillName,
+            status: "skipped",
+            destination: destinationPath,
+            activationRoot,
+            activationPath: null,
+            activationStatus: "not-applicable",
+            notes
+        };
+    }
+    if ((await pathExists(destinationPath)) && !force) {
+        notes.push("Skipped because destination already exists. Re-run with --force to replace it.");
+        return {
+            skillName: entry.skillName,
+            status: "skipped",
+            destination: destinationPath,
+            activationRoot,
+            activationPath: path.join(activationRoot, entry.target.targetFolderName),
+            activationStatus: "not-applicable",
+            notes
+        };
+    }
+    const tempRoot = await mkdtemp(path.join(tmpdir(), "agentbox-skill-"));
+    const cloneDir = path.join(tempRoot, "repo");
+    try {
+        await runGitClone(entry.source.sourceUrl, cloneDir);
+        const skillSourceDir = resolveSkillSourceDir(cloneDir, entry.source.skillPath);
+        if (!(await pathExists(skillSourceDir))) {
+            throw new Error(`Skill path not found after clone: ${skillSourceDir}`);
+        }
+        if (await pathExists(destinationPath)) {
+            await rm(destinationPath, { recursive: true, force: true });
+        }
+        await mkdir(downloadRoot, { recursive: true });
+        await cp(skillSourceDir, destinationPath, { recursive: true });
+        const activation = await activateInstalledSkill(entry, destinationPath, activationRoot, force);
+        notes.push(...activation.notes);
+        if (entry.source.expectedHash) {
+            notes.push(`Expected skill hash preserved for later verification: ${entry.source.expectedHash}`);
+        }
+        return {
+            skillName: entry.skillName,
+            status: "installed",
+            destination: destinationPath,
+            activationRoot,
+            activationPath: activation.activationPath,
+            activationStatus: activation.activationStatus,
+            notes
+        };
+    }
+    catch (error) {
+        notes.push(error instanceof Error ? error.message : String(error));
+        return {
+            skillName: entry.skillName,
+            status: "failed",
+            destination: destinationPath,
+            activationRoot,
+            activationPath: path.join(activationRoot, entry.target.targetFolderName),
+            activationStatus: "failed",
+            notes
+        };
+    }
+    finally {
+        await rm(tempRoot, { recursive: true, force: true });
+    }
+}
+async function activateInstalledSkill(entry, destinationPath, activationRoot, force) {
+    const notes = [];
+    if (entry.target.activationMode === "workspace-local" || samePath(activationRoot, path.dirname(destinationPath))) {
+        await mkdir(activationRoot, { recursive: true });
+        notes.push(`Skill is already installed in activation scope at ${destinationPath}.`);
+        return {
+            activationPath: destinationPath,
+            activationStatus: entry.target.activationMode === "workspace-local" ? "copied" : "reserved",
+            notes
+        };
+    }
+    const activationPath = path.join(activationRoot, entry.target.targetFolderName);
+    await mkdir(activationRoot, { recursive: true });
+    if (await pathExists(activationPath)) {
+        if (!force) {
+            notes.push(`Activation path already exists at ${activationPath}; preserving existing host-visible entry.`);
+            return {
+                activationPath,
+                activationStatus: "reserved",
+                notes
+            };
+        }
+        await rm(activationPath, { recursive: true, force: true });
+    }
+    try {
+        const linkType = process.platform === "win32" ? "junction" : "dir";
+        await symlink(destinationPath, activationPath, linkType);
+        notes.push(`Created host-visible skill link at ${activationPath}.`);
+        return {
+            activationPath,
+            activationStatus: "linked",
+            notes
+        };
+    }
+    catch (error) {
+        await cp(destinationPath, activationPath, { recursive: true });
+        notes.push(`Link creation failed, so AgentBox copied the skill into the activation root instead: ${error instanceof Error ? error.message : String(error)}`);
+        return {
+            activationPath,
+            activationStatus: "copied",
+            notes
+        };
+    }
+}
+function resolveSkillSourceDir(repoRoot, skillPath) {
+    if (!skillPath) {
+        return repoRoot;
+    }
+    const normalized = skillPath.replace(/[\\/]+/g, path.sep);
+    const folder = path.dirname(normalized);
+    if (folder === "." || folder === "") {
+        return repoRoot;
+    }
+    return path.join(repoRoot, folder);
+}
+async function runGitClone(sourceUrl, destination) {
+    await mkdir(path.dirname(destination), { recursive: true });
+    await new Promise((resolve, reject) => {
+        const child = spawn("git", ["clone", "--depth", "1", sourceUrl, destination], {
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(stderr.trim() || `git clone failed with exit code ${code}`));
+        });
+    });
+}
+function buildActivationMap(targetRoot, selectedEntries, reportEntries) {
+    const reportBySkill = new Map(reportEntries.map((entry) => [entry.skillName, entry]));
+    return {
+        apiVersion: "agentbox/v0.1",
+        kind: "SkillActivationMap",
+        targetRoot,
+        entries: selectedEntries.map((planEntry) => {
+            const reportEntry = reportBySkill.get(planEntry.skillName);
+            return {
+                skillName: planEntry.skillName,
+                activationMode: planEntry.target.activationMode,
+                sourcePath: reportEntry?.destination ?? null,
+                activationRoot: reportEntry?.activationRoot ?? null,
+                activationPath: reportEntry?.activationPath ?? null,
+                activationStatus: reportEntry?.activationStatus ?? "not-applicable"
+            };
+        })
+    };
+}
+function samePath(left, right) {
+    const normalizedLeft = path.resolve(left);
+    const normalizedRight = path.resolve(right);
+    return process.platform === "win32"
+        ? normalizedLeft.toLowerCase() === normalizedRight.toLowerCase()
+        : normalizedLeft === normalizedRight;
+}
+function withScopeOverride(plan, scope) {
+    if (plan.scope === scope) {
+        return plan;
+    }
+    const targetStrategy = resolveSkillTargetStrategy(plan.targetHost, scope);
+    return {
+        ...plan,
+        scope,
+        targetStrategy,
+        entries: plan.entries.map((entry) => ({
+            ...entry,
+            target: {
+                ...entry.target,
+                scope,
+                downloadRoot: targetStrategy.downloadRoot,
+                activationRoot: targetStrategy.activationRoot,
+                activationMode: targetStrategy.activationMode
+            }
+        }))
+    };
+}
+function getResolutionContext(planPath, options) {
+    if (options.realHome) {
+        return {
+            mode: "real-home",
+            projectRoot: options.projectRoot
+        };
+    }
+    return {
+        mode: "sandbox",
+        targetRoot: options.targetRoot ?? path.join(path.dirname(planPath), "installed-skills")
+    };
+}
+function validateResolutionContext(context, isExecute) {
+    if (!isExecute) {
+        return;
+    }
+    if (context.mode === "real-home" && !context.projectRoot) {
+        process.stdout.write("Real-home install will use only user-scope paths unless a project root is provided.\n");
+    }
+}
+function getReportRoot(planPath, context) {
+    if (context.mode === "sandbox") {
+        return path.resolve(context.targetRoot ?? path.join(path.dirname(planPath), "installed-skills"));
+    }
+    return path.join(path.dirname(planPath), "real-home-install-report");
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/commands/install-skills.js.map

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

package/dist/commands/pack.d.ts

@@ -0,0 +1,4 @@
+export interface PackCommandOptions {
+    output?: string;
+}
+export declare function packCommand(snapshotPath: string, options: PackCommandOptions): Promise<void>;

package/dist/commands/pack.js

@@ -0,0 +1,37 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+import { createArchiveFromDirectory } from "../core/archive.js";
+import { pathExists } from "../core/fs.js";
+export async function packCommand(snapshotPath, options) {
+    const inputDir = path.resolve(snapshotPath);
+    await assertSnapshotDirectory(inputDir);
+    const manifest = await readManifest(inputDir);
+    const outputFile = resolveOutputFile(inputDir, manifest, options.output);
+    await createArchiveFromDirectory(inputDir, outputFile);
+    process.stdout.write(`Packed snapshot: ${inputDir}\n`);
+    process.stdout.write(`Bundle written to: ${outputFile}\n`);
+}
+async function assertSnapshotDirectory(inputDir) {
+    const requiredFiles = ["box.yaml", "resolved.yaml", "sources.yaml"];
+    for (const filename of requiredFiles) {
+        const exists = await pathExists(path.join(inputDir, filename));
+        if (!exists) {
+            throw new Error(`Missing required snapshot file: ${filename}`);
+        }
+    }
+}
+async function readManifest(inputDir) {
+    const manifestPath = path.join(inputDir, "box.yaml");
+    const raw = await readFile(manifestPath, "utf8");
+    return parse(raw);
+}
+function resolveOutputFile(inputDir, manifest, requestedOutput) {
+    if (requestedOutput) {
+        const resolved = path.resolve(requestedOutput);
+        return resolved.endsWith(".agentbox") ? resolved : `${resolved}.agentbox`;
+    }
+    const safeName = manifest.metadata.name.replace(/[^a-zA-Z0-9._-]+/g, "-");
+    return path.join(path.dirname(inputDir), `${safeName}.agentbox`);
+}
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,YAAoB,EAAE,OAA2B;IACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,0BAA0B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,QAAQ,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,UAAU,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,QAAgB;IACrD,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IACpE,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,GAAG,CAAgB,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,QAAqB,EAAE,eAAwB;IAC1F,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,WAAW,CAAC;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,QAAQ,WAAW,CAAC,CAAC;AACnE,CAAC"}

package/dist/commands/preview.d.ts

@@ -0,0 +1,8 @@
+import type { InstallScope } from "../core/materialize.js";
+import type { SupportedHost } from "../core/types.js";
+export interface PreviewCommandOptions {
+    host: SupportedHost;
+    output?: string;
+    scope?: InstallScope;
+}
+export declare function previewCommand(stagingPath: string, options: PreviewCommandOptions): Promise<void>;

package/dist/commands/preview.js

@@ -0,0 +1,108 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+import { resolveBindings } from "../core/bindings.js";
+import { parseEnvObject } from "../core/env.js";
+import { pathExists } from "../core/fs.js";
+import { toYaml } from "../core/yaml.js";
+import { buildCompatibilityReport } from "../import/compatibility.js";
+import { generateClaudeCodePreview } from "../import/claude-code.js";
+import { generateCodexPreview } from "../import/codex.js";
+import { buildSkillInstallPlan } from "../import/install-plan.js";
+import { generateOpenClawPreview } from "../import/openclaw.js";
+export async function previewCommand(stagingPath, options) {
+    const root = path.resolve(stagingPath);
+    const resolvedPath = path.join(root, "resolved.yaml");
+    const bindingsPath = path.join(root, "bindings.env");
+    if (!(await pathExists(resolvedPath))) {
+        throw new Error(`resolved.yaml not found in: ${root}`);
+    }
+    const resolved = parse(await readFile(resolvedPath, "utf8"));
+    const bindings = (await pathExists(bindingsPath))
+        ? parseEnvObject(await readFile(bindingsPath, "utf8"))
+        : {};
+    const outputDir = path.resolve(options.output ?? path.join(root, "import-preview"));
+    await mkdir(outputDir, { recursive: true });
+    const context = {
+        sourceHost: resolved.host.id,
+        targetHost: options.host,
+        bindings
+    };
+    const result = await generatePreviewForTarget(outputDir, resolved, context);
+    const bindingResolution = resolveBindings(resolved.bindings, resolvedBindingsTemplate(resolved), [
+        {
+            kind: "explicit",
+            name: "bindings.env",
+            values: bindings
+        }
+    ]);
+    const skillInstallPlan = buildSkillInstallPlan(resolved, context.sourceHost, context.targetHost, {
+        scope: options.scope
+    });
+    const skillInstallPlanPath = path.join(outputDir, "skill-install-plan.yaml");
+    await writeFile(skillInstallPlanPath, toYaml(skillInstallPlan), "utf8");
+    const compatibilityReport = buildCompatibilityReport({
+        resolved,
+        sourceHost: context.sourceHost,
+        targetHost: context.targetHost,
+        bindingResolution,
+        preview: result,
+        skillInstallPlan
+    });
+    const compatibilityReportPath = path.join(outputDir, "compatibility-report.yaml");
+    await writeFile(compatibilityReportPath, toYaml(compatibilityReport), "utf8");
+    const generatedFiles = [...result.generatedFiles, skillInstallPlanPath, compatibilityReportPath];
+    const warnings = [...new Set([...result.warnings, ...skillInstallPlan.warnings, ...compatibilityReport.warnings])];
+    const planEntries = [
+        ...result.plan,
+        {
+            sourceLayer: "skills",
+            targetPath: skillInstallPlanPath,
+            action: "create-preview",
+            risk: "low",
+            notes: ["Portable skill reconstruction plan with source URLs, expected hashes, and target host install hints."]
+        },
+        {
+            sourceLayer: "bindings, compatibility",
+            targetPath: compatibilityReportPath,
+            action: "create-preview",
+            risk: "low",
+            notes: ["Compatibility summary covering binding readiness, manual migration steps, and blocked layers."]
+        }
+    ];
+    await writeFile(path.join(outputDir, "import-report.yaml"), toYaml({
+        sourceHost: context.sourceHost,
+        targetHost: result.targetHost,
+        targetScope: skillInstallPlan.scope,
+        generatedFiles,
+        warnings
+    }), "utf8");
+    await writeFile(path.join(outputDir, "write-plan.yaml"), toYaml({
+        sourceHost: context.sourceHost,
+        targetHost: result.targetHost,
+        targetScope: skillInstallPlan.scope,
+        mode: "preview-only",
+        entries: planEntries,
+        warnings
+    }), "utf8");
+    process.stdout.write(`Import preview generated for host: ${options.host}\n`);
+    process.stdout.write(`Preview directory: ${result.outputDir}\n`);
+    process.stdout.write(`Generated files: ${generatedFiles.length}\n`);
+    process.stdout.write(`Warnings: ${warnings.length}\n`);
+}
+function resolvedBindingsTemplate(resolved) {
+    return Object.fromEntries(resolved.bindings.map((binding) => [binding.key, ""]));
+}
+async function generatePreviewForTarget(outputDir, resolved, context) {
+    if (context.targetHost === "codex") {
+        return generateCodexPreview(outputDir, resolved, context);
+    }
+    if (context.targetHost === "claude-code") {
+        return generateClaudeCodePreview(outputDir, resolved, context);
+    }
+    if (context.targetHost === "openclaw") {
+        return generateOpenClawPreview(outputDir, resolved, context);
+    }
+    throw new Error(`Import preview target is not implemented yet: ${context.targetHost}`);
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

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

package/dist/commands/unpack.d.ts

@@ -0,0 +1,4 @@
+export interface UnpackCommandOptions {
+    output?: string;
+}
+export declare function unpackCommand(bundlePath: string, options: UnpackCommandOptions): Promise<void>;

package/dist/commands/unpack.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import { extractArchiveToDirectory } from "../core/archive.js";
+import { pathExists } from "../core/fs.js";
+export async function unpackCommand(bundlePath, options) {
+    const inputFile = path.resolve(bundlePath);
+    const outputDir = resolveOutputDir(inputFile, options.output);
+    if (!(await pathExists(inputFile))) {
+        throw new Error(`Bundle not found: ${inputFile}`);
+    }
+    await extractArchiveToDirectory(inputFile, outputDir);
+    await assertExtractedSnapshot(outputDir);
+    process.stdout.write(`Unpacked bundle: ${inputFile}\n`);
+    process.stdout.write(`Staging directory: ${outputDir}\n`);
+}
+function resolveOutputDir(inputFile, requestedOutput) {
+    if (requestedOutput) {
+        return path.resolve(requestedOutput);
+    }
+    const parsed = path.parse(inputFile);
+    const baseName = parsed.ext === ".agentbox" ? parsed.name : parsed.base;
+    return path.join(parsed.dir, `${baseName}.unpacked`);
+}
+async function assertExtractedSnapshot(outputDir) {
+    const requiredFiles = [
+        "box.yaml",
+        "resolved.yaml",
+        "sources.yaml",
+        "bindings.template.env"
+    ];
+    for (const filename of requiredFiles) {
+        const exists = await pathExists(path.join(outputDir, filename));
+        if (!exists) {
+            throw new Error(`Unpacked bundle is missing required file: ${filename}`);
+        }
+    }
+    const layersDir = path.join(outputDir, "layers");
+    const metaDir = path.join(outputDir, "meta");
+    if (!(await pathExists(layersDir))) {
+        throw new Error("Unpacked bundle is missing layers directory.");
+    }
+    if (!(await pathExists(metaDir))) {
+        throw new Error("Unpacked bundle is missing meta directory.");
+    }
+}
+//# sourceMappingURL=unpack.js.map

package/dist/commands/unpack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpack.js","sourceRoot":"","sources":["../../src/commands/unpack.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,OAA6B;IACnF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,yBAAyB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAEzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,SAAS,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,SAAS,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,eAAwB;IACnE,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IACxE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,QAAQ,WAAW,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,SAAiB;IACtD,MAAM,aAAa,GAAG;QACpB,UAAU;QACV,eAAe;QACf,cAAc;QACd,uBAAuB;KACxB,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/core/archive.d.ts

@@ -0,0 +1,2 @@
+export declare function createArchiveFromDirectory(inputDir: string, outputFile: string): Promise<void>;
+export declare function extractArchiveToDirectory(inputFile: string, outputDir: string): Promise<void>;