@qilin-agent/dsh-compat 3.1.4 → 3.1.6

package/lib/index.js

@@ -2,8 +2,8 @@
 /**
 * DSH-era module-name aliases.
 *
-* QiLin renamed every harness package (`@deepseek-ai/cordis` → `@qilin-agent/kylin`,
-* `@deepseek-ai/dsh-client-ui-slots` → `@qilin-agent/client-ui-slots`, …), but the
+* QiLin renamed every harness package in the scope below, but the
+* channel sync still hands this layer the upstream spellings, so
 * DSH plugin ecosystem ships prebuilt bundles whose factories `require()` the
 * old names. The static platform aliases keep those `require` calls resolvable
 * against QiLin's module table, and {@link dshCompatModuleId} canonicalizes the
@@ -41,6 +41,22 @@ const DSH_PACKAGE_PREFIX = "@deepseek-ai/dsh-";
 /** The QiLin scope the prefix rule maps package heads onto. */
 const QILIN_SCOPE = "@qilin-agent/";
 /**
+* QiLin names the exact alias tables produce, reversed back onto their DSH-era
+* spellings. The vendored foundations keep their published DSH-era names:
+* schemastery stayed scoped, cosmokit was unscoped in the DSH ecosystem
+* ([rescope mapping](../../../../../docs/rescope.md)).
+*/
+const QILIN_EXACT_ALIASES = {
+	"@qilin-agent/kylin": "@deepseek-ai/cordis",
+	"@qilin-agent/schemastery": "@deepseek-ai/schemastery",
+	"@qilin-agent/cosmokit": "@qilin-agent/cosmokit",
+	"@qilin-agent/cli": "@deepseek-ai/dsh",
+	"@qilin-agent/client-store": "@deepseek-ai/dsh-client-store",
+	"@qilin-agent/client-ui-slots": "@deepseek-ai/dsh-client-ui-slots",
+	"@qilin-agent/client-ui-primitives": "@deepseek-ai/dsh-client-ui-primitives",
+	"@qilin-agent/client-ui-dockkit": "@deepseek-ai/dsh-client-ui-dockkit"
+};
+/**
 * Package heads whose QiLin name is not the mechanical `dsh-` strip. The DSH
 * client module system (`client-runtime`) is QiLin's `client-modules`; the
 * Cordis runner and tool family, the agent preset, and the DSH-SDK subagent
@@ -65,6 +81,8 @@ const DSH_PACKAGE_RENAMES = {
 	"skill-badge": "experimental-skill-badge",
 	"session-title-all-prompts-llm": "experimental-session-title-all-prompts-llm"
 };
+/** DSH-era package heads the rename table maps QiLin heads back onto. */
+const QILIN_TO_DSH_HEADS = Object.fromEntries(Object.entries(DSH_PACKAGE_RENAMES).map(([dshHead, qilinHead]) => [qilinHead, dshHead]));
 /**
 * Canonicalize one module specifier for QiLin's module graph: an exact
 * platform or application alias wins; a scoped `@deepseek-ai/dsh-<pkg>[/subpath]` name maps
@@ -82,6 +100,24 @@ function dshCompatModuleId(specifier) {
 	const [head = "", ...subpath] = specifier.slice(17).split("/");
 	return QILIN_SCOPE + [DSH_PACKAGE_RENAMES[head] ?? head, ...subpath].join("/");
 }
+/**
+* The DSH-era name one QiLin harness package also published under, when it has
+* one: the inverse of {@link dshCompatModuleId} for the mechanical rescope and
+* the exact alias values. Subpaths carry through (`@qilin-agent/session/sub`
+* aliases to `@deepseek-ai/dsh-session/sub`). Vendored foundations without a
+* DSH-era name and QiLin-authored families outside the rescope return
+* undefined.
+* @param qilinName - the QiLin package name (optionally with a subpath).
+* @returns the DSH-era alias, or undefined when the name has none.
+*/
+function dshCompatAliasOf(qilinName) {
+	const exact = QILIN_EXACT_ALIASES[qilinName];
+	if (exact !== void 0) return exact;
+	if (!qilinName.startsWith(QILIN_SCOPE)) return void 0;
+	const [head = "", ...subpath] = qilinName.slice(13).split("/");
+	if (head.startsWith("kylin-plugin-")) return void 0;
+	return DSH_PACKAGE_PREFIX + [QILIN_TO_DSH_HEADS[head] ?? head, ...subpath].join("/");
+}
 //#endregion
 //#region lib/types/manifest.js
 /**
@@ -113,6 +149,21 @@ function bundlePatchOf(manifest) {
 	if (typeof dsh === "string") return dsh;
 }
 /**
+* Read a bundle's declared patch files from either manifest channel, in application order.
+* @param manifest - the bundle's parsed package.json.
+* @returns the declared patch files; empty when the bundle declares none.
+* @throws when a declaration is neither a string nor a list of strings.
+*/
+function bundlePatchFilesOf(manifest) {
+	const channels = manifest;
+	if (typeof channels !== "object" || channels === null) return [];
+	const declared = channels.qilin?.bundle?.patch ?? channels.dsh?.bundle?.patch;
+	if (declared === void 0) return [];
+	const files = typeof declared === "string" ? [declared] : declared;
+	if (!Array.isArray(files) || !files.every((file) => typeof file === "string")) throw new Error("qilin.bundle.patch must be a file path or a list of file paths");
+	return files;
+}
+/**
 * Pick a package's client declaration: `qilin.client` when present (the
 * native key wins for a package that carries both), else `dsh.client`.
 * @param manifest - the parsed `package.json` value of the package.
@@ -133,4 +184,4 @@ function clientDeclarationOf(manifest) {
 	};
 }
 //#endregion
-export { DSH_APPLICATION_MODULE_ALIASES, DSH_PLATFORM_MODULE_ALIASES, bundlePatchOf, clientDeclarationOf, dshCompatModuleId };
+export { DSH_APPLICATION_MODULE_ALIASES, DSH_PLATFORM_MODULE_ALIASES, bundlePatchFilesOf, bundlePatchOf, clientDeclarationOf, dshCompatAliasOf, dshCompatModuleId };

package/lib/types/aliases.d.ts

@@ -1,8 +1,8 @@
 /**
  * DSH-era module-name aliases.
  *
- * QiLin renamed every harness package (`@deepseek-ai/cordis` → `@qilin-agent/kylin`,
- * `@deepseek-ai/dsh-client-ui-slots` → `@qilin-agent/client-ui-slots`, …), but the
+ * QiLin renamed every harness package in the scope below, but the
+ * channel sync still hands this layer the upstream spellings, so
  * DSH plugin ecosystem ships prebuilt bundles whose factories `require()` the
  * old names. The static platform aliases keep those `require` calls resolvable
  * against QiLin's module table, and {@link dshCompatModuleId} canonicalizes the
@@ -38,4 +38,15 @@ export declare const DSH_APPLICATION_MODULE_ALIASES: Readonly<Record<string, str
  * @returns the QiLin-canonical specifier for graph and seed-table lookups.
  */
 export declare function dshCompatModuleId(specifier: string): string;
+/**
+ * The DSH-era name one QiLin harness package also published under, when it has
+ * one: the inverse of {@link dshCompatModuleId} for the mechanical rescope and
+ * the exact alias values. Subpaths carry through (`@qilin-agent/session/sub`
+ * aliases to `@deepseek-ai/dsh-session/sub`). Vendored foundations without a
+ * DSH-era name and QiLin-authored families outside the rescope return
+ * undefined.
+ * @param qilinName - the QiLin package name (optionally with a subpath).
+ * @returns the DSH-era alias, or undefined when the name has none.
+ */
+export declare function dshCompatAliasOf(qilinName: string): string | undefined;
 //# sourceMappingURL=aliases.d.ts.map

package/lib/types/index.d.ts

@@ -4,6 +4,6 @@
  * {@link ./manifest.ts}.
  * @module @qilin-agent/dsh-compat
  */
-export { DSH_APPLICATION_MODULE_ALIASES, DSH_PLATFORM_MODULE_ALIASES, dshCompatModuleId, } from './aliases.ts';
-export { bundlePatchOf, clientDeclarationOf, type ClientDeclaration, type ClientDeclarationKey, } from './manifest.ts';
+export { DSH_APPLICATION_MODULE_ALIASES, DSH_PLATFORM_MODULE_ALIASES, dshCompatAliasOf, dshCompatModuleId, } from './aliases.ts';
+export { bundlePatchFilesOf, bundlePatchOf, clientDeclarationOf, type ClientDeclaration, type ClientDeclarationKey, } from './manifest.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/manifest.d.ts

@@ -19,6 +19,13 @@
  * @returns the declared patch path, or `undefined` when neither key declares one.
  */
 export declare function bundlePatchOf(manifest: unknown): string | undefined;
+/**
+ * Read a bundle's declared patch files from either manifest channel, in application order.
+ * @param manifest - the bundle's parsed package.json.
+ * @returns the declared patch files; empty when the bundle declares none.
+ * @throws when a declaration is neither a string nor a list of strings.
+ */
+export declare function bundlePatchFilesOf(manifest: unknown): string[];
 /** Which manifest key supplied a client declaration. */
 export type ClientDeclarationKey = 'qilin.client' | 'dsh.client';
 /** One picked client declaration: the key that supplied it and its raw value. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/dsh-compat",
   "description": "DSH-era plugin ecosystem compatibility: module-name aliases and manifest-key fallback readers",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -30,9 +30,9 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   }
 }