@qilin-agent/tool-workspace-dependencies 3.1.4 → 3.1.6

package/lib/index.js

@@ -1,9 +1,9 @@
-import { cp, lstat, mkdir, mkdtemp, readFile, rename, rm, stat } from "node:fs/promises";
+import { cp, lstat, mkdir, mkdtemp, readFile, readlink, rename, rm, stat, symlink } from "node:fs/promises";
 import { dirname, isAbsolute, join } from "node:path";
 import z from "@qilin-agent/schemastery";
 import { defineTool } from "@qilin-agent/tools";
 //#region lib/types/index.js
-/** Model-facing query for a bundled Python, Node.js, and pnpm payload, in place or installed under the QiLin home. */
+/** Model-facing query for a bundled Python, Node.js, and pnpm payload, in place or installed under the Harness home. */
 /** Cordis plugin identity. */
 const name = "tool-workspace-dependencies";
 /** Registry the tool registers into. */
@@ -75,6 +75,49 @@ async function readPrimaryRuntime(root) {
 	return parsePrimaryRuntime(JSON.parse(await readFile(join(root, "runtime.json"), "utf8")));
 }
 /**
+* Identify POSIX interpreter aliases that can survive payload relocation.
+* @param root - Payload directory.
+* @param manifest - Validated payload metadata.
+* @returns Relative alias paths mapped to their sibling interpreter filename; regular command files are omitted.
+* @throws When an interpreter alias does not point directly to the versioned regular file.
+*/
+async function primaryRuntimePythonAliases(root, manifest) {
+	const aliases = /* @__PURE__ */ new Map();
+	if (manifest.platform === "win32") return aliases;
+	const interpreter = `python${manifest.python.split(".").slice(0, 2).join(".")}`;
+	for (const name of ["python", "python3"]) {
+		const path = `dependencies/python/bin/${name}`;
+		let entry;
+		try {
+			entry = await lstat(join(root, path));
+		} catch (error) {
+			if (error.code === "ENOENT") continue;
+			throw error;
+		}
+		if (!entry.isSymbolicLink()) continue;
+		if (await readlink(join(root, path)) !== interpreter || !(await lstat(join(root, "dependencies/python/bin", interpreter))).isFile()) throw new Error(`primary runtime: invalid Python alias ${path}`);
+		aliases.set(path, interpreter);
+	}
+	return aliases;
+}
+/**
+* Copy a payload, retaining only validated Python interpreter aliases as relative links.
+* @param source - Payload directory; all other links are materialized.
+* @param destination - Empty destination owned by the caller.
+* @param manifest - Validated source metadata.
+* @returns Resolves after every copied file and interpreter alias is available independently of the source.
+*/
+async function copyPrimaryRuntime(source, destination, manifest) {
+	const aliases = await primaryRuntimePythonAliases(source, manifest);
+	const excluded = new Set([...aliases.keys()].map((path) => join(source, path)));
+	await cp(source, destination, {
+		recursive: true,
+		dereference: true,
+		filter: (path) => !excluded.has(path)
+	});
+	for (const [path, target] of aliases) await symlink(target, join(destination, path));
+}
+/**
 * Resolve platform-specific interpreter and library locations without changing the environment.
 * @param root - Absolute payload or installation directory.
 * @param manifest - Validated runtime metadata.
@@ -129,14 +172,16 @@ async function compatibleManifest(source) {
 * @returns Paths into the payload itself.
 */
 async function resolvePrimaryRuntime(source) {
-	const paths = workspaceDependencyPaths(source, await compatibleManifest(source));
+	const manifest = await compatibleManifest(source);
+	await primaryRuntimePythonAliases(source, manifest);
+	const paths = workspaceDependencyPaths(source, manifest);
 	await validatePayloadEntries(paths);
 	return paths;
 }
 /**
 * Install the application-owned payload locally, retaining a complete previous tree on copy failure.
 * @param source - Payload carried by the current installation.
-* @param root - Fixed primary runtime directory under the QiLin home.
+* @param root - Fixed primary runtime directory under the Harness home.
 * @returns Paths into the installed payload; no PATH or package-manager configuration is changed.
 */
 async function installPrimaryRuntime(source, root) {
@@ -146,16 +191,14 @@ async function installPrimaryRuntime(source, root) {
 	const previousExists = await exists(previous);
 	if (!await exists(root) && previousExists) await rename(previous, root);
 	if (await exists(join(root, "runtime.json")) && JSON.stringify(await readPrimaryRuntime(root)) === JSON.stringify(manifest)) {
+		await primaryRuntimePythonAliases(root, manifest);
 		const paths = workspaceDependencyPaths(root, manifest);
 		await validatePayloadEntries(paths);
 		return paths;
 	}
 	const staging = await mkdtemp(join(dirname(root), ".primary-runtime-"));
 	try {
-		await cp(source, staging, {
-			recursive: true,
-			dereference: true
-		});
+		await copyPrimaryRuntime(source, staging, manifest);
 		await validatePayloadEntries(workspaceDependencyPaths(staging, manifest));
 		await rm(previous, {
 			recursive: true,
@@ -249,4 +292,4 @@ function apply(ctx, config) {
 	}));
 }
 //#endregion
-export { Config, apply, inject, installPrimaryRuntime, name, parsePrimaryRuntime, readPrimaryRuntime, resolvePrimaryRuntime, workspaceDependencyPaths };
+export { Config, apply, copyPrimaryRuntime, inject, installPrimaryRuntime, name, parsePrimaryRuntime, primaryRuntimePythonAliases, readPrimaryRuntime, resolvePrimaryRuntime, workspaceDependencyPaths };

package/lib/types/index.d.ts

@@ -1,4 +1,4 @@
-/** Model-facing query for a bundled Python, Node.js, and pnpm payload, in place or installed under the QiLin home. */
+/** Model-facing query for a bundled Python, Node.js, and pnpm payload, in place or installed under the Harness home. */
 import type { Context } from '@qilin-agent/kylin';
 import z from '@qilin-agent/schemastery';
 /** Cordis plugin identity. */
@@ -10,8 +10,8 @@ export interface Config {
     /** Payload directory carrying `runtime.json` and `dependencies/`. */
     readonly source: string;
     /**
-     * Installation directory under the QiLin home. When set, the payload is copied there on the
-     * first call (the copy-on-first-use behavior); when omitted, the payload is used in place without copying,
+     * Installation directory under the Harness home. When set, the payload is copied there on the
+     * first call (the Desktop behavior); when omitted, the payload is used in place without copying,
      * which suits read-only carriers such as container image layers.
      */
     readonly root?: string;
@@ -57,6 +57,22 @@ export declare function parsePrimaryRuntime(value: unknown): PrimaryRuntimeManif
  * @returns Validated top-level versions and target identifiers, including for legacy components manifests.
  */
 export declare function readPrimaryRuntime(root: string): Promise<PrimaryRuntimeManifest>;
+/**
+ * Identify POSIX interpreter aliases that can survive payload relocation.
+ * @param root - Payload directory.
+ * @param manifest - Validated payload metadata.
+ * @returns Relative alias paths mapped to their sibling interpreter filename; regular command files are omitted.
+ * @throws When an interpreter alias does not point directly to the versioned regular file.
+ */
+export declare function primaryRuntimePythonAliases(root: string, manifest: PrimaryRuntimeManifest): Promise<ReadonlyMap<string, string>>;
+/**
+ * Copy a payload, retaining only validated Python interpreter aliases as relative links.
+ * @param source - Payload directory; all other links are materialized.
+ * @param destination - Empty destination owned by the caller.
+ * @param manifest - Validated source metadata.
+ * @returns Resolves after every copied file and interpreter alias is available independently of the source.
+ */
+export declare function copyPrimaryRuntime(source: string, destination: string, manifest: PrimaryRuntimeManifest): Promise<void>;
 /**
  * Resolve platform-specific interpreter and library locations without changing the environment.
  * @param root - Absolute payload or installation directory.
@@ -73,7 +89,7 @@ export declare function resolvePrimaryRuntime(source: string): Promise<Workspace
 /**
  * Install the application-owned payload locally, retaining a complete previous tree on copy failure.
  * @param source - Payload carried by the current installation.
- * @param root - Fixed primary runtime directory under the QiLin home.
+ * @param root - Fixed primary runtime directory under the Harness home.
  * @returns Paths into the installed payload; no PATH or package-manager configuration is changed.
  */
 export declare function installPrimaryRuntime(source: string, root: string): Promise<WorkspaceDependencies>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/tool-workspace-dependencies",
   "description": "The load_workspace_dependencies tool: absolute paths into a bundled Python, Node.js, and pnpm payload",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -29,19 +29,19 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/tools": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/tools": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
-    "@qilin-agent/llm": "3.1.4",
-    "@qilin-agent/system-prompt": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/tools": "3.1.4",
-    "@qilin-agent/agent": "3.1.4",
-    "@qilin-agent/kylin-plugin-include": "~1.0.8",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.4"
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/llm": "3.1.6",
+    "@qilin-agent/system-prompt": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/tools": "3.1.6",
+    "@qilin-agent/kylin-plugin-include": "~1.0.10",
+    "@qilin-agent/kylin-plugin-loader": "~1.0.6"
   },
   "dependencies": {
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   }
 }