@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/workspace/dist/skill-install.js

@@ -0,0 +1,346 @@
+/**
+ * Install skills into the workspace from a local directory or a git repo.
+ *
+ * Mirrors Hermes `skills_hub.py` / `skills_hub_install.py`: skills should be
+ * installable, not only hand-copied `SKILL.md` files. Everything is validated
+ * fail-closed — a candidate without a parseable `SKILL.md` is rejected, and
+ * nothing is ever written outside the target skills root.
+ */
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { shouldSkipScanDir } from "./scan-guards.js";
+import { isSkillName, parseSkillMarkdown } from "./skills.js";
+/** Default workspace skills root (product skill home — see `.agents/`). */
+export const WORKSPACE_SKILLS_REL_DIR = ".agents/skills";
+export class SkillInstallError extends Error {
+    code;
+    constructor(message, code = "SKILL_INSTALL") {
+        super(message);
+        this.name = "SkillInstallError";
+        this.code = code;
+    }
+}
+function resolveSkillsRoot(options) {
+    const env = options.env ?? process.env;
+    const configured = options.skillsRoot?.trim() ||
+        String(env.XRK_SKILLS_DIR ?? "").trim() ||
+        WORKSPACE_SKILLS_REL_DIR;
+    return path.isAbsolute(configured)
+        ? path.resolve(configured)
+        : path.resolve(options.workspaceRoot, configured);
+}
+/**
+ * The skills root that install / list / remove operate on. Exposed so CLI
+ * surfaces can print the resolved location without re-deriving the
+ * `XRK_SKILLS_DIR` default.
+ */
+export function resolveInstalledSkillsRoot(options) {
+    return resolveSkillsRoot(options);
+}
+/** Throw when `child` would land outside `root` (path-traversal guard). */
+function assertInside(root, child) {
+    const absRoot = path.resolve(root);
+    const absChild = path.resolve(child);
+    const rel = path.relative(absRoot, absChild);
+    if (rel === "" || rel === ".")
+        return;
+    if (rel === ".." || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel)) {
+        throw new SkillInstallError(`skill path escapes the skills root: ${child}`, "SKILL_PATH");
+    }
+}
+function isDirectory(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate a candidate skill directory: it must hold a `SKILL.md` whose
+ * frontmatter parses and yields a usable name.
+ */
+function readValidSkill(dir, fallbackName) {
+    const skillFile = path.join(dir, "SKILL.md");
+    if (!existsSync(skillFile)) {
+        throw new SkillInstallError(`not a skill directory (no SKILL.md): ${dir}`, "SKILL_INVALID");
+    }
+    let raw;
+    try {
+        raw = readFileSync(skillFile, "utf8");
+    }
+    catch (err) {
+        throw new SkillInstallError(`cannot read ${skillFile}: ${err instanceof Error ? err.message : String(err)}`, "SKILL_INVALID");
+    }
+    const parsed = parseSkillMarkdown(raw, fallbackName);
+    if (parsed.invalid) {
+        throw new SkillInstallError(`skill frontmatter is invalid in ${skillFile} (fail closed)`, "SKILL_INVALID");
+    }
+    const name = parsed.name.trim() || fallbackName;
+    if (!isSkillName(name)) {
+        throw new SkillInstallError(`invalid skill name "${name}" (from ${skillFile})`, "SKILL_NAME");
+    }
+    return { name };
+}
+/** Install a validated skill directory into the workspace skills root. */
+function publishSkill(sourceDir, fallbackName, options, source, url) {
+    const skillsRoot = resolveSkillsRoot(options);
+    const { name } = readValidSkill(sourceDir, fallbackName);
+    const target = path.join(skillsRoot, name);
+    assertInside(skillsRoot, target);
+    const srcAbs = path.resolve(sourceDir);
+    if (srcAbs === path.resolve(target)) {
+        throw new SkillInstallError(`skill "${name}" is already at ${target}`, "SKILL_EXISTS");
+    }
+    // Copying a directory into itself would recurse forever.
+    if (path.resolve(target).startsWith(`${srcAbs}${path.sep}`)) {
+        throw new SkillInstallError(`refusing to install a skill into its own source tree: ${target}`, "SKILL_PATH");
+    }
+    if (existsSync(target) && options.force !== true) {
+        throw new SkillInstallError(`skill "${name}" already exists at ${target} (use force to overwrite)`, "SKILL_EXISTS");
+    }
+    mkdirSync(skillsRoot, { recursive: true });
+    if (existsSync(target))
+        rmSync(target, { recursive: true, force: true });
+    cpSync(sourceDir, target, { recursive: true });
+    return {
+        name,
+        directory: target,
+        source,
+        ...(url !== undefined ? { url } : {}),
+    };
+}
+/** Find every directory containing `SKILL.md`, breadth-first and bounded. */
+function findSkillDirs(root, maxDepth = 4) {
+    const found = [];
+    const walk = (dir, depth) => {
+        if (existsSync(path.join(dir, "SKILL.md")))
+            found.push(dir);
+        if (depth >= maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (shouldSkipScanDir(entry))
+                continue;
+            const child = path.join(dir, entry);
+            if (isDirectory(child))
+                walk(child, depth + 1);
+        }
+    };
+    walk(root, 0);
+    return found;
+}
+/** Pick the one skill directory inside a checkout, or explain the ambiguity. */
+function locateSkillDir(cloneRoot, subdir) {
+    if (subdir) {
+        const target = path.resolve(cloneRoot, subdir);
+        assertInside(cloneRoot, target);
+        if (!isDirectory(target)) {
+            throw new SkillInstallError(`subdirectory not found in repository: ${subdir}`, "SKILL_NOT_FOUND");
+        }
+        return target;
+    }
+    if (existsSync(path.join(cloneRoot, "SKILL.md")))
+        return cloneRoot;
+    // Convention: a `skills/` folder holding one directory per skill.
+    const skillsDir = path.join(cloneRoot, "skills");
+    const searchRoot = isDirectory(skillsDir) ? skillsDir : cloneRoot;
+    const candidates = findSkillDirs(searchRoot).filter((dir) => path.resolve(dir) !== path.resolve(cloneRoot));
+    if (candidates.length === 0) {
+        throw new SkillInstallError(`no SKILL.md found in ${cloneRoot}`, "SKILL_NOT_FOUND");
+    }
+    if (candidates.length > 1) {
+        const rel = candidates
+            .map((c) => path.relative(cloneRoot, c) || ".")
+            .map((r) => r.split(path.sep).join("/"))
+            .sort();
+        throw new SkillInstallError(`repository contains ${candidates.length} skills; pass a #subdir — ` +
+            `candidates: ${rel.join(", ")}`, "SKILL_AMBIGUOUS");
+    }
+    return candidates[0];
+}
+/**
+ * Install from a local directory. `spec` may be a plain path, or
+ * `file:`/`link:` prefixed, optionally with a `#subdir` fragment when the
+ * directory is a collection.
+ */
+export function installSkillFromLocalDir(spec, options) {
+    const { target: specPath, subdir } = splitSpec(spec);
+    const bare = specPath.startsWith("file:")
+        ? specPath.slice("file:".length)
+        : specPath.startsWith("link:")
+            ? specPath.slice("link:".length)
+            : specPath;
+    if (!bare.trim()) {
+        throw new SkillInstallError("local skill spec is empty", "SKILL_SPEC");
+    }
+    const sourceDir = path.resolve(bare);
+    if (!isDirectory(sourceDir)) {
+        throw new SkillInstallError(`local skill directory not found: ${sourceDir}`, "SKILL_NOT_FOUND");
+    }
+    const resolved = subdir
+        ? (() => {
+            const target = path.resolve(sourceDir, subdir);
+            assertInside(sourceDir, target);
+            if (!isDirectory(target)) {
+                throw new SkillInstallError(`subdirectory not found: ${subdir}`, "SKILL_NOT_FOUND");
+            }
+            return target;
+        })()
+        : sourceDir;
+    return publishSkill(resolved, path.basename(resolved), options, "local");
+}
+function parseGitSpec(url, subdir) {
+    if (url.startsWith("github:")) {
+        const rest = url.slice("github:".length).trim();
+        if (!rest) {
+            throw new SkillInstallError("github: spec needs owner/repo", "SKILL_SPEC");
+        }
+        return {
+            url: `https://github.com/${rest}.git`,
+            ...(subdir !== undefined ? { subdir } : {}),
+        };
+    }
+    if (url.startsWith("git+")) {
+        return {
+            url: url.slice("git+".length),
+            ...(subdir !== undefined ? { subdir } : {}),
+        };
+    }
+    return { url, ...(subdir !== undefined ? { subdir } : {}) };
+}
+/**
+ * Install from a git repository (`git:` / `github:` / `git+` / https / ssh).
+ * `#subdir` selects one skill when the repository holds several.
+ */
+export function installSkillFromGit(spec, options) {
+    const { target: rawUrl, subdir } = splitSpec(spec);
+    if (rawUrl.startsWith("git:")) {
+        const rest = rawUrl.slice("git:".length).trim();
+        const parsed = parseGitSpec(rest, subdir);
+        return cloneAndPublish(parsed, options);
+    }
+    return cloneAndPublish(parseGitSpec(rawUrl, subdir), options);
+}
+function cloneAndPublish(spec, options) {
+    if (!spec.url.trim()) {
+        throw new SkillInstallError("git skill spec is empty", "SKILL_SPEC");
+    }
+    const gitBin = options.gitBin?.trim() || "git";
+    const stage = mkdtempSync(path.join(tmpdir(), "xrk-skill-clone-"));
+    try {
+        const argv = [
+            "clone",
+            "--depth",
+            "1",
+            ...(options.ref?.trim() ? ["--branch", options.ref.trim()] : []),
+            spec.url,
+            stage,
+        ];
+        const result = spawnSync(gitBin, argv, {
+            encoding: "utf8",
+            env: options.env ?? process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        if ((result.status ?? 1) !== 0) {
+            const detail = (result.stderr ||
+                result.stdout ||
+                result.error?.message ||
+                "").trim();
+            throw new SkillInstallError(`git clone failed for ${spec.url}: ${detail || "unknown error"}`, "SKILL_GIT");
+        }
+        const skillDir = locateSkillDir(stage, spec.subdir);
+        return publishSkill(skillDir, path.basename(skillDir), options, "git", spec.url);
+    }
+    finally {
+        try {
+            rmSync(stage, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/** Split a `path#subdir` spec (subdir uses `/`, never absolute). */
+function splitSpec(spec) {
+    const raw = spec.trim();
+    if (!raw) {
+        throw new SkillInstallError("skill spec is empty", "SKILL_SPEC");
+    }
+    const hash = raw.indexOf("#");
+    if (hash < 0)
+        return { target: raw };
+    const target = raw.slice(0, hash);
+    const subdir = raw.slice(hash + 1).trim();
+    if (!target) {
+        throw new SkillInstallError(`invalid skill spec: ${spec}`, "SKILL_SPEC");
+    }
+    if (!subdir)
+        return { target };
+    if (subdir.startsWith("/") || subdir.startsWith("\\") || /^[A-Za-z]:/.test(subdir)) {
+        throw new SkillInstallError(`#subdir must be repository-relative: ${subdir}`, "SKILL_PATH");
+    }
+    return { target, subdir };
+}
+const GIT_URL_RE = /^(?:git:|git\+|github:|https?:\/\/|ssh:\/\/|git@)/i;
+/** True when the spec points at a git repository rather than a local path. */
+export function isGitSkillSpec(spec) {
+    return GIT_URL_RE.test(spec.trim());
+}
+/**
+ * Install a skill from either a local directory or a git repository.
+ * Git specs are detected by prefix / URL shape.
+ */
+export function installSkill(spec, options) {
+    return isGitSkillSpec(spec)
+        ? installSkillFromGit(spec, options)
+        : installSkillFromLocalDir(spec, options);
+}
+/** Remove an installed skill by name. Returns false when it was absent. */
+export function removeInstalledSkill(name, options) {
+    if (!isSkillName(name)) {
+        throw new SkillInstallError(`invalid skill name "${name}"`, "SKILL_NAME");
+    }
+    const skillsRoot = resolveSkillsRoot(options);
+    const target = path.join(skillsRoot, name);
+    assertInside(skillsRoot, target);
+    if (!existsSync(target))
+        return false;
+    rmSync(target, { recursive: true, force: true });
+    return true;
+}
+/** List skills currently installed in the workspace skills root. */
+export function listInstalledSkills(options) {
+    const skillsRoot = resolveSkillsRoot(options);
+    if (!isDirectory(skillsRoot))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(skillsRoot).sort()) {
+        if (shouldSkipScanDir(entry))
+            continue;
+        const dir = path.join(skillsRoot, entry);
+        if (!isDirectory(dir))
+            continue;
+        const skillFile = path.join(dir, "SKILL.md");
+        if (!existsSync(skillFile))
+            continue;
+        let description = "";
+        try {
+            description = parseSkillMarkdown(readFileSync(skillFile, "utf8"), entry).description;
+        }
+        catch {
+            /* keep empty description */
+        }
+        out.push({ name: entry, directory: dir, description });
+    }
+    return out;
+}
+//# sourceMappingURL=skill-install.js.map

package/node_modules/@xrkseek/workspace/dist/skill-install.js.map

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

package/node_modules/@xrkseek/workspace/dist/tool-output-persist.d.ts

@@ -1,8 +1,4 @@
-/**
- * Product data root (`XRK_HOME` / `~/.xrk`). Never the session workspace.
- * Mirrors `@xrkseek/server-config` `resolveXrkHome` without taking that dep
- * (workspace is a leaf under presets).
- */
+/** Product data root (`XRK_HOME` / `~/.xrk`). Never the session workspace. */
 export declare function resolveProductHome(env?: NodeJS.ProcessEnv): string;
 /** Shared spill tree: `{productHome}/spill` (Host `hostReadableRoots`). */
 export declare function resolveSpillRoot(env?: NodeJS.ProcessEnv): string;

package/node_modules/@xrkseek/workspace/dist/tool-output-persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-output-persist.d.ts","sourceRoot":"","sources":["../src/tool-output-persist.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAMR;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAER;AAED,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,0BAA0B,CA+B5B"}
+{"version":3,"file":"tool-output-persist.d.ts","sourceRoot":"","sources":["../src/tool-output-persist.ts"],"names":[],"mappings":"AASA,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAER;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAER;AAED,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,0BAA0B,CAsC5B"}

package/node_modules/@xrkseek/workspace/dist/tool-output-persist.js

@@ -1,28 +1,10 @@
 import { mkdir, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
-const HOME_ENVS = ["XRK_HOME", "XRK_DSH_HOME", "DSH_HOME"];
-function expandHomePath(value) {
-    if (value === "~")
-        return homedir();
-    if (value.startsWith("~/") || value.startsWith("~\\")) {
-        return path.join(homedir(), value.slice(2));
-    }
-    return value;
-}
-/**
- * Product data root (`XRK_HOME` / `~/.xrk`). Never the session workspace.
- * Mirrors `@xrkseek/server-config` `resolveXrkHome` without taking that dep
- * (workspace is a leaf under presets).
- */
+import { capSpillText, pruneSpillTree, resolveXrkHome, } from "@xrkseek/xrk-home-paths";
+/** Product data root (`XRK_HOME` / `~/.xrk`). Never the session workspace. */
 export function resolveProductHome(env = process.env) {
-    for (const key of HOME_ENVS) {
-        const raw = env[key]?.trim();
-        if (raw)
-            return path.resolve(expandHomePath(raw));
-    }
-    return path.resolve(path.join(homedir(), ".xrk"));
+    return resolveXrkHome(env);
 }
 /** Shared spill tree: `{productHome}/spill` (Host `hostReadableRoots`). */
 export function resolveSpillRoot(env = process.env) {
@@ -48,10 +30,16 @@ export function createWorkspaceToolOutputPersist(options = {}) {
     return {
         dir,
         async persist(fullContent) {
+            const spill = path.resolve(root, "spill");
+            const rel = path.relative(spill, dir);
+            const tree = rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel))
+                ? spill
+                : dir;
+            pruneSpillTree(tree);
             await ensureDir();
             const name = `tool_${Date.now().toString(36)}_${randomUUID().slice(0, 8)}.txt`;
             const abs = path.join(dir, name);
-            await writeFile(abs, fullContent, "utf8");
+            await writeFile(abs, capSpillText(fullContent), "utf8");
             return abs;
         },
     };

package/node_modules/@xrkseek/workspace/dist/tool-output-persist.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-output-persist.js","sourceRoot":"","sources":["../src/tool-output-persist.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-output-persist.js","sourceRoot":"","sources":["../src/tool-output-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAChC,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAC9B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAyBD;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,UAA6C,EAAE;IAE/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC,CAAC,OAAO,CACvE,KAAK,EACL,GAAG,CACJ,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,yDAAyD,WAAW,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,KAAgC,CAAC;IACrC,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,KAAK,KAAK,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,KAAK,CAAC,OAAO,CAAC,WAAmB;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACtC,MAAM,IAAI,GACR,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC5D,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,GAAG,CAAC;YACV,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,MAAM,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,MAAM,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/workspace/dist/user-product-home.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Resolve the global product home used for standing inject and home skills.
+ *
+ * - Test override `homeDir` → `{homeDir}/.xrk` (isolated fake OS home).
+ * - Otherwise {@link resolveXrkHome} (`XRK_HOME` / `XRK_DSH_HOME` / `DSH_HOME` / `~/.xrk`).
+ */
+export declare function resolveUserProductHome(homeDir?: string): string;
+/**
+ * Logical section prefix for home product standing
+ * (`~/.xrk/` or `$XRK_HOME/`). Test `homeDir` always displays as `~/.xrk/`.
+ */
+export declare function userProductHomeLogicalPrefix(homeDir?: string): string;
+/**
+ * Map a `~/.xrk/...` relative path onto {@link resolveUserProductHome}.
+ * Non-`.xrk` paths are returned unchanged for the caller to join onto OS home.
+ */
+export declare function resolveUnderUserProductHome(rel: string, homeDir?: string): string | undefined;
+//# sourceMappingURL=user-product-home.d.ts.map

package/node_modules/@xrkseek/workspace/dist/user-product-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-product-home.d.ts","sourceRoot":"","sources":["../src/user-product-home.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAapB"}

package/node_modules/@xrkseek/workspace/dist/user-product-home.js

@@ -0,0 +1,45 @@
+/**
+ * Global product-data home for workspace inject / home skills.
+ * Leaf packages must not hand-roll `homedir()` + `.xrk` or `XRK_HOME`.
+ */
+import path from "node:path";
+import { XRK_HOME_DIR_NAME, resolveXrkHome, xrkHomeDisplay, } from "@xrkseek/xrk-home-paths";
+/**
+ * Resolve the global product home used for standing inject and home skills.
+ *
+ * - Test override `homeDir` → `{homeDir}/.xrk` (isolated fake OS home).
+ * - Otherwise {@link resolveXrkHome} (`XRK_HOME` / `XRK_DSH_HOME` / `DSH_HOME` / `~/.xrk`).
+ */
+export function resolveUserProductHome(homeDir) {
+    const override = homeDir?.trim();
+    if (override) {
+        return path.resolve(path.join(path.resolve(override), XRK_HOME_DIR_NAME));
+    }
+    return resolveXrkHome();
+}
+/**
+ * Logical section prefix for home product standing
+ * (`~/.xrk/` or `$XRK_HOME/`). Test `homeDir` always displays as `~/.xrk/`.
+ */
+export function userProductHomeLogicalPrefix(homeDir) {
+    if (homeDir?.trim()) {
+        return `~/${XRK_HOME_DIR_NAME}/`;
+    }
+    return `${xrkHomeDisplay(resolveUserProductHome())}/`;
+}
+/**
+ * Map a `~/.xrk/...` relative path onto {@link resolveUserProductHome}.
+ * Non-`.xrk` paths are returned unchanged for the caller to join onto OS home.
+ */
+export function resolveUnderUserProductHome(rel, homeDir) {
+    const normalized = rel.replace(/\\/g, "/");
+    if (normalized === ".xrk" || normalized === XRK_HOME_DIR_NAME) {
+        return resolveUserProductHome(homeDir);
+    }
+    const prefix = `${XRK_HOME_DIR_NAME}/`;
+    if (normalized.startsWith(prefix)) {
+        return path.join(resolveUserProductHome(homeDir), ...normalized.slice(prefix.length).split("/").filter(Boolean));
+    }
+    return undefined;
+}
+//# sourceMappingURL=user-product-home.js.map

package/node_modules/@xrkseek/workspace/dist/user-product-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-product-home.js","sourceRoot":"","sources":["../src/user-product-home.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO,KAAK,iBAAiB,GAAG,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,cAAc,CAAC,sBAAsB,EAAE,CAAC,GAAG,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,GAAW,EACX,OAAgB;IAEhB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;QAC9D,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,iBAAiB,GAAG,CAAC;IACvC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CACd,sBAAsB,CAAC,OAAO,CAAC,EAC/B,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/node_modules/@xrkseek/workspace/package.json

@@ -1,27 +1,28 @@
-{
-  "name": "@xrkseek/workspace",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/core-tools": "workspace:*",
-    "@xrkseek/protocol": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/workspace"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/workspace",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*",
+    "@xrkseek/protocol": "workspace:*",
+    "@xrkseek/xrk-home-paths": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/workspace"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/xrk-home-paths/README.md

@@ -0,0 +1,4 @@
+Shared product-home helpers (`XRK_HOME` / `XRK_DSH_HOME` / `DSH_HOME` → `~/.xrk`).
+
+Leaf packages and Host import this instead of inlining env loops.
+`xrkCachePath` joins under `{home}/cache/…` for rebuildable data (e.g. request-image variants).

package/node_modules/@xrkseek/xrk-home-paths/dist/index.d.ts

@@ -0,0 +1,44 @@
+/** Directory name under the OS home. */
+export declare const XRK_HOME_DIR_NAME = ".xrk";
+/** Stable user-facing display form for the default product home. */
+export declare const DEFAULT_XRK_HOME_DISPLAY = "~/.xrk";
+/** Env vars that override the default home (first non-empty wins). */
+export declare const XRK_HOME_ENVS: readonly ["XRK_HOME", "XRK_DSH_HOME", "DSH_HOME"];
+/** Default `~/.xrk`. */
+export declare function defaultXrkHome(): string;
+/**
+ * Expand supported tilde prefixes against the OS home.
+ * Returns the original value when no supported prefix is present.
+ */
+export declare function expandHomePath(value: string): string;
+/**
+ * Resolve the single-root product home from env.
+ * Precedence: `XRK_HOME` → `XRK_DSH_HOME` → `DSH_HOME` → `~/.xrk`.
+ * Empty / whitespace-only env is treated as unset.
+ */
+export declare function resolveXrkHome(env?: NodeJS.ProcessEnv): string;
+/**
+ * Like {@link resolveXrkHome}, but an explicit configured path wins over env.
+ * Used by Host/Face injectors that pass `xrkHome` / `productDir`.
+ */
+export declare function resolveConfiguredXrkHome(configured: string | undefined, env?: NodeJS.ProcessEnv): string;
+/** Join segments onto the resolved product home. */
+export declare function xrkHomePath(...segments: string[]): string;
+/**
+ * Join path segments onto the product home's `cache` directory without creating it.
+ * Rebuildable data (request-image variants, etc.) belongs here — not under durable
+ * `{home}/attachments/v1`.
+ *
+ * @param optionsOrSegment - explicit home override, or the first path segment.
+ * @param segments - additional path segments after the first child, if any.
+ */
+export declare function xrkCachePath(optionsOrSegment?: {
+    readonly xrkHome?: string;
+} | string, ...segments: string[]): string;
+/**
+ * Describe a resolved home for user-facing copy.
+ * Default home → `~/.xrk`; otherwise `$XRK_HOME` (primary override name).
+ */
+export declare function xrkHomeDisplay(resolvedHome: string): string;
+export { SPILL_MAX_AGE_MS, SPILL_MAX_FILE_BYTES, SPILL_MAX_TOTAL_BYTES, capSpillText, pruneSpillTree, type PruneSpillTreeOptions, } from "./spill-budget.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/xrk-home-paths/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,WAA2B,CAAC;AAEjE,sEAAsE;AACtE,eAAO,MAAM,aAAa,mDAAoD,CAAC;AAE/E,wBAAwB;AACxB,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAIR;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CACzB,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,gBAAgB,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAW,EAC7D,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}