@poco-ai/agentero-dsh-pdf 0.1.0 → 0.1.2

package/lib/client/index.d.ts

@@ -6,6 +6,7 @@ declare module '@deepseek-ai/cordis' {
             registerOpener(kind: 'paper' | 'note', opener: (id: string) => void): () => void;
             request(url: string, init?: RequestInit): Promise<Response>;
             getVault(): Promise<{
+                path: string;
                 scope: string;
             }>;
         };

package/lib/client/pdf-panel.d.ts

@@ -51,6 +51,8 @@ export interface PdfInjected {
     loadPdf: (ref: string) => Promise<ArrayBuffer>;
     loadMarks: (ref: string) => Promise<PaintMark[]>;
     addMark: (body: MarkAdd) => Promise<string | undefined>;
+    /** Vault-relative ref for a file-resource address, or an empty string outside the vault. */
+    resolveAddress: (address: string) => string;
     /** Send a question and citation as a new conversation turn. */
     ask: (text: string) => Promise<void>;
     /** Write the PDF outline back to the file; resolves after the host saved it. */

package/lib/client/resource-path.d.ts

@@ -0,0 +1,43 @@
+/**
+ * File resources the right Sidebar routes to this plugin.
+ *
+ * PDF links and mentions arrive as `dsh-resource://file/...` addresses. A
+ * Session-scoped address keeps the path as the caller wrote it (workspace
+ * relative or absolute); the absolute form drops the leading slash. The host
+ * only reads files inside the vault, so an address has to be mapped back to a
+ * vault-relative ref before the panel can open it.
+ */
+/** A file address split into its scope and decoded path. */
+export type FileResource = {
+    readonly scope: 'session';
+    readonly sessionId: string;
+    /** Absolute or workspace-relative path; `/`-separated. */
+    readonly path: string;
+} | {
+    readonly scope: 'absolute';
+    /** Absolute path: `/a/b` on POSIX, `C:/a/b` on Windows, `//server/share/a` for UNC. */
+    readonly path: string;
+};
+/**
+ * Parse one `dsh-resource://file/` address.
+ * @param address - candidate address.
+ * @returns its scope and decoded path, or undefined for another resource or a malformed address.
+ */
+export declare function parseFileResource(address: string): FileResource | undefined;
+/** Whether a path is absolute in either spelling the host accepts. */
+export declare function isAbsolutePath(value: string): boolean;
+/** Join a relative path onto an absolute base, using `/` separators. */
+export declare function joinPath(base: string, relative: string): string;
+/**
+ * Strip the vault root from an absolute path.
+ * @param vaultPath - configured vault directory.
+ * @param absolutePath - absolute path to test.
+ * @returns the vault-relative path, or undefined when it lies outside the vault.
+ */
+export declare function vaultRelative(vaultPath: string, absolutePath: string): string | undefined;
+/**
+ * Final path segment of a file-resource address.
+ * @param address - candidate address.
+ * @returns the decoded basename, or undefined when the address is not a file resource.
+ */
+export declare function resourceName(address: string): string | undefined;

package/lib/client.js

@@ -49177,6 +49177,57 @@ function PdfPage(props) {
   );
 }
 
+// src/client/resource-path.ts
+var FILE_PREFIX = "dsh-resource://file/";
+function isDriveSegment(segment) {
+  return segment !== void 0 && /^[A-Za-z]:$/.test(segment);
+}
+function parseFileResource(address) {
+  if (!address.startsWith(FILE_PREFIX)) return void 0;
+  try {
+    const end = address.search(/[?#]/);
+    const [scope, ...rest] = address.slice(FILE_PREFIX.length, end === -1 ? void 0 : end).split("/");
+    if (scope === "session") {
+      const [sessionId, ...segments] = rest;
+      if (sessionId === void 0 || sessionId === "" || segments.length === 0) return void 0;
+      return { scope, sessionId: decodeURIComponent(sessionId), path: segments.map(decodeURIComponent).join("/") };
+    }
+    if (scope === "absolute") {
+      const unc = rest[0] === "" && rest.length > 1;
+      const segments = (unc ? rest.slice(1) : rest).map(decodeURIComponent);
+      if (segments.length === 0 || segments[0] === "") return void 0;
+      if (unc) return { scope, path: `//${segments.join("/")}` };
+      return { scope, path: isDriveSegment(segments[0]) ? segments.join("/") : `/${segments.join("/")}` };
+    }
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+function isAbsolutePath(value) {
+  return value.startsWith("/") || /^[A-Za-z]:[/\\]/.test(value) || value.startsWith("\\\\");
+}
+function joinPath(base, relative) {
+  return `${base.replace(/\\/g, "/").replace(/\/+$/, "")}/${relative.replace(/\\/g, "/").replace(/^(?:\.\/)+/, "")}`;
+}
+function vaultRelative(vaultPath, absolutePath) {
+  const root = vaultPath.replace(/\\/g, "/").replace(/\/+$/, "");
+  if (root === "") return void 0;
+  const normalized = absolutePath.replace(/\\/g, "/");
+  const windows = /^[A-Za-z]:/.test(root);
+  const prefix = `${root}/`;
+  const candidate = windows ? normalized.toLowerCase() : normalized;
+  const expected = windows ? prefix.toLowerCase() : prefix;
+  if (!candidate.startsWith(expected)) return void 0;
+  return normalized.slice(prefix.length);
+}
+function resourceName(address) {
+  const file = parseFileResource(address);
+  if (file === void 0) return void 0;
+  const name2 = file.path.slice(file.path.lastIndexOf("/") + 1);
+  return name2 === "" ? void 0 : name2;
+}
+
 // src/client/selection-menu.tsx
 var import_react85 = require("react");
 
@@ -57977,13 +58028,15 @@ function paperRef(params) {
   return typeof ref === "string" ? ref : "";
 }
 function PdfTitle({ useTabInfo, t }) {
-  const ref = paperRef(useTabInfo().tab.navigation.params);
-  const name2 = ref.split("/").filter((part) => part !== "").pop();
+  const navigation = useTabInfo().tab.navigation;
+  const ref = paperRef(navigation.params);
+  const name2 = ref !== "" ? ref.split("/").filter((part) => part !== "").pop() : resourceName(navigation.address);
   return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { children: name2 === void 0 || name2 === "" ? t("title") : name2 });
 }
 function PdfPanel(props) {
-  const { t, sessionId, useTabInfo, loadPdf, loadMarks, addMark, ask, saveBookmarks, translate, loadLayout } = props;
-  const paperPath = paperRef(useTabInfo().tab.navigation.params);
+  const { t, sessionId, useTabInfo, loadPdf, loadMarks, addMark, ask, saveBookmarks, translate, loadLayout, resolveAddress } = props;
+  const navigation = useTabInfo().tab.navigation;
+  const paperPath = paperRef(navigation.params) || resolveAddress(navigation.address);
   const [status, setStatus] = (0, import_react86.useState)("empty");
   const [message, setMessage] = (0, import_react86.useState)("");
   const [bytes, setBytes] = (0, import_react86.useState)(void 0);
@@ -58316,18 +58369,37 @@ var inject = ["slots", "locale", "agentero", "sidebarRight", "sidebarRightTabs",
 function apply(ctx) {
   const source = ctx.agentero;
   const request = source.request.bind(source);
+  let vaultPath;
+  void source.getVault().then((info) => {
+    vaultPath = info.path;
+  }).catch(() => {
+  });
+  const vaultRefOf = (address) => {
+    const file = parseFileResource(address);
+    if (file === void 0 || vaultPath === void 0) return void 0;
+    if (file.scope === "absolute") return vaultRelative(vaultPath, file.path);
+    if (file.path.startsWith("papers/")) return vaultRelative(vaultPath, joinPath(vaultPath, file.path));
+    const cwd = ctx.sessions.list.getSnapshot().byId[file.sessionId]?.cwd;
+    if (cwd === void 0 || cwd === "" || !isAbsolutePath(cwd)) return void 0;
+    return vaultRelative(vaultPath, joinPath(cwd, file.path));
+  };
   ctx.effect(() => ctx.locale.register(NS, { zh, en }));
   const t = ctx.locale.bind(NS);
   ctx.effect(() => ctx.sidebarRightTabs.register({
     id: TAB_ID,
     kind: TAB_KIND,
     keepMounted: true,
-    title: () => t("title")
+    // Claim vault PDFs at the extension band so the builtin text preview stops
+    // drawing them. Addresses outside the vault stay with the builtin viewer.
+    patterns: ["*.pdf"],
+    canOpen: (address) => vaultRefOf(address) !== void 0,
+    title: (address) => resourceName(address) ?? t("title")
   }));
   ctx.effect(() => ctx.agentero.registerOpener("paper", (id3) => {
     ctx.sidebarRight.openTab(TAB_KIND, { params: { ref: id3 } });
   }));
   const face = {
+    resolveAddress: (address) => vaultRefOf(address) ?? "",
     async loadPdf(ref) {
       const response = await request(`/agentero/api/pdf?ref=${encodeURIComponent(ref)}`, { cache: "no-store" });
       if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poco-ai/agentero-dsh-pdf",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "publishConfig": {
     "access": "public"
   },