dsh-capability-panel 1.3.0 → 1.4.0

package/lib/index.d.ts

@@ -166,6 +166,32 @@ interface AgentCreatedPayload {
     };
   };
 }
+/**
+ * The Host's Session controller, as far as this plugin uses it: the two
+ * members that open one path on the user's own desktop. Structural like every
+ * other service here, so nothing static is imported from
+ * `@deepseek-ai/dsh-api-session-controller` — and it spans this plugin's whole
+ * supported range, because both members exist in every generation from
+ * 0.1.2-rc.1 through 0.2.x. The richer members (`workspaceDesktop`,
+ * `workspacePathApplications`) only appear from 0.1.7-rc.2, so they stay unused
+ * rather than optional-by-extra-probing.
+ */
+interface SessionControllerLike {
+  /**
+   * Whether this deployment can hand one path to a native desktop. `false` is
+   * an answer rather than a failure: either the deployment turned native
+   * opening off, or the platform announces no desktop at all.
+   */
+  canOpenWorkspacePath(): boolean;
+  /**
+   * Verify the path through the composed filesystem, then open it natively.
+   * Rejects with the Host's own error when no verified mapping exists, which is
+   * how a sandboxed deployment refuses a path outside its roots.
+   */
+  openWorkspacePath(request: {
+    readonly path: string;
+  }, signal: AbortSignal): Promise<unknown>;
+}
 interface HostServices {
   /**
    * This plugin's own cordis fiber, read for the profile entry id that 0.1.7
@@ -201,6 +227,7 @@ interface HostServices {
   get(name: 'agents', strict?: boolean): AgentsService | undefined;
   get(name: 'agentPresets', strict?: boolean): AgentPresetsService | undefined;
   get(name: 'settings', strict?: boolean): SettingsService | undefined;
+  get(name: 'sessionController', strict?: boolean): SessionControllerLike | undefined;
   get(name: 'skills', strict?: boolean): SkillsService | undefined;
   get(name: 'tools', strict?: boolean): ToolsService | undefined;
   on(event: 'agent/created',
@@ -285,6 +312,12 @@ interface SkillSummary {
     readonly modelInvocable?: unknown;
   };
   readonly resourceBase?: unknown;
+  /**
+   * The absolute instruction file path, when the provider supplies one —
+   * `SKILL.md` for a directory bundle, the file itself for a flat Markdown
+   * skill, absent for a virtual skill registered in memory.
+   */
+  readonly path?: unknown;
 }
 interface SkillDefinitionLike {
   readonly name?: unknown;
@@ -293,6 +326,8 @@ interface SkillDefinitionLike {
   readonly source?: unknown;
   readonly provider?: unknown;
   readonly resourceBase?: unknown;
+  /** The provider's instruction-file path, inherited by the panel's shadow. */
+  readonly path?: unknown;
 }
 interface IncomingLike$1 extends IncomingLike {
   on?(event: 'data', listener: (chunk: unknown) => void): void;

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/loopback.ts","../src/host/types.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;AACiB,UAAA,YAAA,CAAY;;;oBAGT;ECkBH;AAQjB;;;EAQY,SAAA,MAAA,CAAA,EAAA;IAAO,SAAA,aAAA,CAAA,EAAA,MAAA;EAkBF,CAAA;AAMjB;;;;AAAA;AAoBA;AAKA;;;;;AAa8B,UA9Eb,eAAA,CA8Ea;EAAO,SAAA,QAAA,CAAA,EAAA,OAAA;EA8BpB;EAWA,SAAA,OAAA,CAAA,EAAA;IAgBA,SAAA,EAAA,CAAA,EAAe,OAAA;IAMkF,SAAA,IAAA,CAAA,EAAA,OAAA;IAAlB,SAAA,MAAA,CAAA,EAAA,OAAA;EAKnC,CAAA;EAEc,QAAA,EAAA,EAhJ7D,OAgJ6D,CAAA,IAAA,CAAA;EAED,OAAA,EAAA,EAjJ7D,OAiJ6D,CAAA,IAAA,CAAA;;AAEqB,UAhJ9E,UAAA,CAgJ8E;EAW9E,OAAA,EAAA,EA1JJ,QA0JiB,CA1JR,eA0JQ,CAAA;EACsC;;;;;AAIpE;EAMiB,KAAA,GAAA,EA9JL,OA8JK,CAAA,OAAmB,CAAA;AAOpC;AAkES,UArNQ,aAAA,CAqNR;EAAO,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EApNU,SAoNV,GAAA,SAAA;EAqBC;EAIA,IAAA,EAAA,EA3OP,SA2OgB,EAAA;AAiB1B;AASiB,UAlQA,eAAA,CAkQmB;EASnB,SAAA,EAAA,EAAA,MAAa;EAMb;;;;ACrTjB;EAGgB,SAAK,KAAA,CAAA,EAAA,QAAM,GAAA,MAAY;EA6B1B;;;;;;;;;;;UDwBI,cAAA;;2BAEU;;UAGV,mBAAA;UACP,QAAQ;;;;;;gCAMc;;;;;;8BAMF,QAAQ;;;UA8BrB;SACR;;;;;;4BAMmB;;;UAIX,kBAAA;;;;;;;;;;;;;;;UAgBA,eAAA;;;;;;;;MAM+E,kBAAkB;;;;;;;eAKrD;;2EAEc;;0EAED;;wFAEc;;UAWvE,aAAA;;;;MACkC,iBAAiB;;;;MACJ,QAAQ;;UAGvD,YAAA;4BACW;;;;;;;;;;;;UAKX,mBAAA;kBACC;;;0BAEsB;;;;UAIvB,YAAA;;;;;;;;;;;;;;;;;;;qBAeI,qBAAmB,uBAAuB;;;;;;;;;;;;yCAYtB;yCACA;+CACM;2CACJ;yCACF;wCACD;;;;;;;;sBAShB,+BAA+B;;iGAKS;;mDAKrC;;;;;;;;;;;;;;;;;;;;;;;;iBAcT;;;;SACT;;;;;;;UAqBQ,mBAAA;;;;;UAIA,SAAA;;;;;;;;;;;;;;;;;;;;;;UAiBA,YAAA;;;;;;;;;;UASA,mBAAA;;;;;;;;UASA,cAAA,SAAqB;;;;;UAMrB,kBAAA;qCACoB;;;;;AD/UrC;;;;ACqBA;AAQA;;;;;AA0BA;AAMA;AAoBA;AAKA;;AACU,cC9DG,MD8DH,EC9DS,WD8DT,CAAA,GAAA,EAAA,GAAA,EAAA,OAAA,CAAA;;AAY4B,iBCvEtB,KAAA,CDuEsB,GAAA,ECvEX,YDuEW,CAAA,EAAA,IAAA;AAAR,cC1CjB,MD0CiB,EAAA,MAAA,EAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/loopback.ts","../src/host/types.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;AACiB,UAAA,YAAA,CAAY;;;oBAGT;ECkBH;AAQjB;;;EAQY,SAAA,MAAA,CAAA,EAAA;IAAO,SAAA,aAAA,CAAA,EAAA,MAAA;EAkBF,CAAA;AAMjB;;;;AAAA;AAoBA;AAKA;;;;;AAa8B,UA9Eb,eAAA,CA8Ea;EAAO,SAAA,QAAA,CAAA,EAAA,OAAA;EA8BpB;EAWA,SAAA,OAAA,CAAA,EAAA;IAgBA,SAAA,EAAA,CAAA,EAAe,OAAA;IAMkF,SAAA,IAAA,CAAA,EAAA,OAAA;IAAlB,SAAA,MAAA,CAAA,EAAA,OAAA;EAKnC,CAAA;EAEc,QAAA,EAAA,EAhJ7D,OAgJ6D,CAAA,IAAA,CAAA;EAED,OAAA,EAAA,EAjJ7D,OAiJ6D,CAAA,IAAA,CAAA;;AAEqB,UAhJ9E,UAAA,CAgJ8E;EAW9E,OAAA,EAAA,EA1JJ,QA0JiB,CA1JR,eA0JQ,CAAA;EACsC;;;;;AAIpE;EAMiB,KAAA,GAAA,EA9JL,OA8JK,CAAA,OAAmB,CAAA;AAiBpC;AAmE2B,UAhOV,aAAA,CAgOU;EAcT,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EA7OQ,SA6OR,GAAA,SAAA;EACT;EAAO,IAAA,EAAA,EA5ON,SA4OM,EAAA;AAqBhB;AAIiB,UAlQA,eAAA,CAkQS;EAiBT,SAAA,EAAA,EAAA,MAAY;EAeZ;AAWjB;AAMA;;;;ECvVa;EAGG,SAAK,IAAA,CAAA,EAAA,MAAM;EA6Bd,SAAsB,IAAA,CAAA,EAAA,MAAA;;;;;;;;;UDwBlB,cAAA;;2BAEU;;UAGV,mBAAA;UACP,QAAQ;;;;;;gCAMc;;;;;;8BAMF,QAAQ;;;UA8BrB;SACR;;;;;;4BAMmB;;;UAIX,kBAAA;;;;;;;;;;;;;;;UAgBA,eAAA;;;;;;;;MAM+E,kBAAkB;;;;;;;eAKrD;;2EAEc;;0EAED;;wFAEc;;UAWvE,aAAA;;;;MACkC,iBAAiB;;;;MACJ,QAAQ;;UAGvD,YAAA;4BACW;;;;;;;;;;;;UAKX,mBAAA;kBACC;;;0BAEsB;;;;;;;;;;;;;;UAcvB,qBAAA;;;;;;;;;;;;;;aAY+C,cAAc;;UAG7D,YAAA;;;;;;;;;;;;;;;;;;;qBAeI,qBAAmB,uBAAuB;;;;;;;;;;;;yCAYtB;yCACA;+CACM;2CACJ;oDACS;yCACX;wCACD;;;;;;;;sBAShB,+BAA+B;;iGAKS;;mDAKrC;;;;;;;;;;;;;;;;;;;;;;;;iBAcT;;;;SACT;;;;;;;UAqBQ,mBAAA;;;;;UAIA,SAAA;;;;;;;;;;;;;;;;;;;;;;UAiBA,YAAA;;;;;;;;;;;;;;;;UAeA,mBAAA;;;;;;;;;;UAWA,cAAA,SAAqB;;;;;UAMrB,kBAAA;qCACoB;;;;;ADjXrC;;;;ACqBA;AAQA;;;;;AA0BA;AAMA;AAoBA;AAKA;;AACU,cC9DG,MD8DH,EC9DS,WD8DT,CAAA,GAAA,EAAA,GAAA,EAAA,OAAA,CAAA;;AAY4B,iBCvEtB,KAAA,CDuEsB,GAAA,ECvEX,YDuEW,CAAA,EAAA,IAAA;AAAR,cC1CjB,MD0CiB,EAAA,MAAA,EAAA"}

package/lib/index.js

@@ -252,7 +252,7 @@ function decideStates(available, loads, shadowedSeqs, disabledSkills = /* @__PUR
 		if (bucket === void 0) byName.set(record.skillName, [record]);
 		else bucket.push(record);
 	}
-	return available.map(({ name, description, masked, source, provider, path, group }) => {
+	return available.map(({ name, description, masked, source, provider, path, fileAddress, group }) => {
 		const records = byName.get(name) ?? [];
 		let state = "unloaded";
 		if (records.length > 0) {
@@ -269,6 +269,7 @@ function decideStates(available, loads, shadowedSeqs, disabledSkills = /* @__PUR
 			source,
 			provider,
 			...path === void 0 ? {} : { path },
+			...fileAddress === void 0 ? {} : { fileAddress },
 			...group === void 0 ? {} : { group }
 		};
 	});
@@ -449,6 +450,7 @@ function createCapabilityController(ctx, appendStats, blockedCounts) {
 			source: typeof original.source === "string" ? original.source : "custom",
 			provider: typeof original.provider === "string" ? original.provider : "capability-panel",
 			...original.resourceBase === void 0 ? {} : { resourceBase: original.resourceBase },
+			...typeof original.path === "string" ? { path: original.path } : {},
 			invocation: {
 				modelInvocable: false,
 				userInvocable: true
@@ -594,6 +596,7 @@ function createCapabilityController(ctx, appendStats, blockedCounts) {
 						source: typeof original.source === "string" ? original.source : "custom",
 						provider: typeof original.provider === "string" ? original.provider : "capability-panel",
 						...original.resourceBase === void 0 ? {} : { resourceBase: original.resourceBase },
+						...typeof original.path === "string" ? { path: original.path } : {},
 						invocation: {
 							modelInvocable: false,
 							userInvocable: true
@@ -7815,6 +7818,44 @@ async function restartMcpServer(ctx, server) {
 	await entry.refresh();
 }
 
+//#endregion
+//#region src/host/skill-preview.ts
+/** The single member used from `@deepseek-ai/dsh-util-workspace-path`. */
+function pickFileAddressFor(module) {
+	const candidate = module.fileAddressFor;
+	return typeof candidate === "function" ? candidate : void 0;
+}
+let probed = false;
+let builder;
+/**
+* Resolve the Host's address helper once, or `undefined` when this deployment
+* has no such export. The probe result is remembered either way: a missing
+* package cannot appear later in one process's life.
+* @returns the helper, when the running Host ships it.
+*/
+async function loadFileAddressFor() {
+	if (!probed) {
+		probed = true;
+		try {
+			builder = pickFileAddressFor(await import("@deepseek-ai/dsh-util-workspace-path"));
+		} catch {
+			builder = void 0;
+		}
+	}
+	return builder;
+}
+/**
+* The address that opens `file` in the Host's right-sidebar preview.
+* @param forFile - the resolved helper; `undefined` means this Host cannot.
+* @param sessionId - the Session whose workspace resolves the path.
+* @param cwd - that Session's workspace root, when the Host reported one.
+* @param file - the skill's absolute instruction file path.
+* @returns the address, or `undefined` when the preview is unavailable.
+*/
+function previewAddressFor(forFile, sessionId, cwd, file) {
+	return forFile === void 0 ? void 0 : forFile(sessionId, cwd, file);
+}
+
 //#endregion
 //#region src/host/catalog.ts
 /** Coerce a skill summary field to a string, falling back when the runtime shape is wrong. */
@@ -7875,6 +7916,7 @@ async function readAvailable(services, sessionId, degraded, presetDirs = []) {
 			...cwd === void 0 ? {} : { cwd },
 			scope: agent
 		});
+		const forFile = await loadFileAddressFor();
 		const out = [];
 		const seen = /* @__PURE__ */ new Map();
 		const groupFor = (source, rawRoot) => {
@@ -7892,6 +7934,8 @@ async function readAvailable(services, sessionId, degraded, presetDirs = []) {
 			const rawRoot = rawPath === "" ? "" : parentDir(rawPath);
 			const path = rawRoot === "" ? "" : displayPath(rawRoot, cwd);
 			const group = groupFor(source, rawRoot);
+			const file = coerceString(item.path, "");
+			const fileAddress = file === "" ? void 0 : previewAddressFor(forFile, sessionId, cwd, file);
 			const existing = seen.get(item.name);
 			if (existing !== void 0) {
 				if (masked) existing.masked = true;
@@ -7899,6 +7943,7 @@ async function readAvailable(services, sessionId, degraded, presetDirs = []) {
 					existing.source = source;
 					existing.provider = provider;
 					if (path !== "") existing.path = path;
+					if (fileAddress !== void 0) existing.fileAddress = fileAddress;
 					if (group !== void 0) existing.group = group;
 				}
 				continue;
@@ -7911,6 +7956,7 @@ async function readAvailable(services, sessionId, degraded, presetDirs = []) {
 				source,
 				provider,
 				...path === "" ? {} : { path },
+				...fileAddress === void 0 ? {} : { fileAddress },
 				...group === void 0 ? {} : { group }
 			};
 			seen.set(item.name, row);
@@ -8439,13 +8485,43 @@ function isLoopback(req) {
 */
 function openFolder(path) {
 	return new Promise((resolve, reject) => {
-		exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} "${path}"`, (error) => {
+		exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start \"\"" : "xdg-open"} "${path}"`, (error) => {
 			if (error) reject(/* @__PURE__ */ new Error(`failed to open folder: ${error.message}`));
 			else resolve();
 		});
 	});
 }
 
+//#endregion
+//#region src/host/open-source-folder.ts
+/**
+* Whether the resolved service really carries both members this route calls.
+* Probed rather than assumed, exactly like the other optional services: the
+* service name is stable across generations, but a composition is free to
+* mount a partial implementation.
+*/
+function isUsableOpener(opener) {
+	return opener !== void 0 && typeof opener.canOpenWorkspacePath === "function" && typeof opener.openWorkspacePath === "function";
+}
+/**
+* Open `path` through the Host when it can, else through `fallback`.
+* @param opener - the Session controller, when the composition mounts one.
+* @param path - absolute folder path already resolved from the source key.
+* @param fallback - this plugin's own opener, used where the Host cannot.
+* @returns which opener ran.
+*/
+async function openSourceFolder(opener, path, fallback) {
+	if (isUsableOpener(opener)) {
+		if (!opener.canOpenWorkspacePath()) return "unsupported";
+		try {
+			await opener.openWorkspacePath({ path }, new AbortController().signal);
+			return "host";
+		} catch {}
+	}
+	await fallback(path);
+	return "local";
+}
+
 //#endregion
 //#region src/host/route.ts
 const ROUTE = "/api/capability-panel";
@@ -8675,7 +8751,10 @@ function createRouteHandler(services, capabilities, stats, blockedCounts, preset
 					return;
 				}
 				try {
-					await openFolder(folderPath);
+					if (await openSourceFolder(services.get("sessionController", false), folderPath, openFolder) === "unsupported") {
+						json(res, 500, { error: "this deployment cannot open folders on a desktop" });
+						return;
+					}
 					json(res, 200, { ok: true });
 				} catch (error) {
 					json(res, 500, { error: `failed to open folder: ${errorMessage(error)}` });