dsh-zotero 0.5.2 → 0.6.0

package/lib/ask.d.ts

@@ -16,7 +16,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolRunContext } from '@deepseek-ai/dsh-tools';
 /** The parts of a tool execution `withConnectivityAsk` needs. */
-export type ConnectivityAskExec = Pick<ToolRunContext, 'signal' | 'agent'>;
+type ConnectivityAskExec = Pick<ToolRunContext, 'signal' | 'agent'>;
 /**
  * Run one Zotero request; on a connectivity failure, ask the user how to
  * proceed and retry at most once when they choose the recommended action.
@@ -31,4 +31,5 @@ export type ConnectivityAskExec = Pick<ToolRunContext, 'signal' | 'agent'>;
  *   fails again.
  */
 export declare function withConnectivityAsk<T>(ctx: Context, exec: ConnectivityAskExec, run: () => Promise<T>): Promise<T>;
+export {};
 //# sourceMappingURL=ask.d.ts.map

package/lib/ask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAyB1E,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;AA2E1E;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CA4BZ"}
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAyB1E,iEAAiE;AACjE,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;AA2EnE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/lib/attachments.d.ts

@@ -2,10 +2,11 @@
  * Attachment records and deterministic attachment selection.
  *
  * Zotero's own best-attachment choice (`links.attachment` on item
- * responses) is preferred wherever it exists; `selectAttachment` is the
+ * responses) is preferred wherever it exists; `selectAttachments` is the
  * documented fallback that ranks child rows the same way Zotero's
  * `getBestAttachment` does — PDF over other kinds, imported files first,
- * then earliest addition date, then key order.
+ * then earliest addition date, then key order. Single selection is the
+ * ranking's first entry.
  * @module dsh-zotero/attachments
  */
 /**
@@ -36,21 +37,10 @@ export declare function bestAttachmentFromLinks(json: unknown): {
  * @throws {ZoteroError} `ZOTERO_UNEXPECTED` when the object has no valid Zotero key.
  */
 export declare function normalizeAttachmentRecord(json: unknown): ZoteroAttachmentCandidate;
-/**
- * Select one attachment of the requested kind from raw child rows, ranked
- * deterministically: imported files first, then earliest `dateAdded`, then
- * key order. Rows without an attachment content type are skipped; a
- * malformed attachment row fails loud like every other broken invariant.
- * @param rows - raw child item JSON objects (notes and annotations are skipped).
- * @param kind - `pdf` selects `application/pdf`; anything else is matched as a literal content type.
- * @returns the winning record, or undefined when no row matches the kind.
- * @throws {ZoteroError} `ZOTERO_UNEXPECTED` on an attachment row without a valid key.
- */
-export declare function selectAttachment(rows: readonly unknown[], kind: string): ZoteroAttachmentCandidate | undefined;
 /**
  * Select every attachment of the requested kind from raw child rows, ordered
- * by the same deterministic ranking {@link selectAttachment} uses — so the
- * first entry always equals the single-selection answer, and a work with
+ * by the same deterministic ranking Zotero's `getBestAttachment` uses — so
+ * the first entry always equals the single-selection answer, and a work with
  * several PDFs (publisher copy, manuscript, supplement) can enter evidence
  * ranking as several first-class sources.
  */

package/lib/attachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,GACZ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKlD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAmBlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,yBAAyB,GAAG,SAAS,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,SAAS,yBAAyB,EAAE,CAoBtC"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,GACZ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKlD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAmBlF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,SAAS,yBAAyB,EAAE,CAoBtC"}

package/lib/attachments.js

@@ -2,19 +2,21 @@
  * Attachment records and deterministic attachment selection.
  *
  * Zotero's own best-attachment choice (`links.attachment` on item
- * responses) is preferred wherever it exists; `selectAttachment` is the
+ * responses) is preferred wherever it exists; `selectAttachments` is the
  * documented fallback that ranks child rows the same way Zotero's
  * `getBestAttachment` does — PDF over other kinds, imported files first,
- * then earliest addition date, then key order.
+ * then earliest addition date, then key order. Single selection is the
+ * ranking's first entry.
  * @module dsh-zotero/attachments
  */
 import { ZOTERO_UNEXPECTED, ZoteroError } from './errors.js';
 import { asRecord, asString, isObjectKey } from './json.js';
+import { ATTACHMENT_HREF_PATTERN } from './ref-grammar.js';
 /** Extract a Zotero object key from an API `links.attachment.href`. */
 export function extractAttachmentKey(href) {
     if (href === undefined)
         return undefined;
-    return /\/items\/([A-Z0-9]{8})(?:[/?#]|$)/.exec(href)?.[1];
+    return ATTACHMENT_HREF_PATTERN.exec(href)?.[1];
 }
 /**
  * Read Zotero's own best-attachment link from an item response.
@@ -49,23 +51,10 @@ export function normalizeAttachmentRecord(json) {
         ...(url !== undefined ? { url } : {}),
     };
 }
-/**
- * Select one attachment of the requested kind from raw child rows, ranked
- * deterministically: imported files first, then earliest `dateAdded`, then
- * key order. Rows without an attachment content type are skipped; a
- * malformed attachment row fails loud like every other broken invariant.
- * @param rows - raw child item JSON objects (notes and annotations are skipped).
- * @param kind - `pdf` selects `application/pdf`; anything else is matched as a literal content type.
- * @returns the winning record, or undefined when no row matches the kind.
- * @throws {ZoteroError} `ZOTERO_UNEXPECTED` on an attachment row without a valid key.
- */
-export function selectAttachment(rows, kind) {
-    return selectAttachments(rows, kind)[0];
-}
 /**
  * Select every attachment of the requested kind from raw child rows, ordered
- * by the same deterministic ranking {@link selectAttachment} uses — so the
- * first entry always equals the single-selection answer, and a work with
+ * by the same deterministic ranking Zotero's `getBestAttachment` uses — so
+ * the first entry always equals the single-selection answer, and a work with
  * several PDFs (publisher copy, manuscript, supplement) can enter evidence
  * ranking as several first-class sources.
  */

package/lib/attachments.js.map

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

package/lib/client.js

@@ -1012,7 +1012,7 @@ function devFreeze(value) {
 }
 
 // src/client/card-form.ts
-function numberField(field2) {
+function numberFieldSpec(field2) {
   return {
     field: field2,
     // A section that carries no number for this field renders empty rather
@@ -1026,7 +1026,7 @@ function numberField(field2) {
     }
   };
 }
-function booleanField(field2) {
+function booleanFieldSpec(field2) {
   return {
     field: field2,
     format: (value) => typeof value === "boolean" ? String(value) : "",
@@ -1039,7 +1039,7 @@ function booleanField(field2) {
     }
   };
 }
-function textField(field2) {
+function textFieldSpec(field2) {
   return {
     field: field2,
     format: (value) => typeof value === "string" ? value : "",
@@ -1246,9 +1246,9 @@ var FIELD_SPECS = [
   { key: "defaultLocale", kind: "text", group: "groupDefaults" }
 ];
 var FIELDS = FIELD_SPECS.map((spec) => {
-  if (spec.kind === "number") return numberField(spec.key);
-  if (spec.kind === "boolean") return booleanField(spec.key);
-  return textField(spec.key);
+  if (spec.kind === "number") return numberFieldSpec(spec.key);
+  if (spec.kind === "boolean") return booleanFieldSpec(spec.key);
+  return textFieldSpec(spec.key);
 });
 var FIELD_GROUPS = groupFields(FIELD_SPECS);
 var NUMERIC_FIELD_KEYS = new Set(
@@ -1510,9 +1510,37 @@ function ZoteroPluginCard(props) {
 // src/client/components/SourcesTab.tsx
 var import_react11 = require("react");
 
+// src/ref-grammar.ts
+var REF_KEY_SOURCE = "[A-Z0-9]{8}";
+var ATTACHMENT_HREF_PATTERN = new RegExp(`/items/(${REF_KEY_SOURCE})(?:[/?#]|$)`);
+var ZOTERO_USER_ITEM_PATH_PATTERN = new RegExp(
+  `^/users/(\\d+)/items/(${REF_KEY_SOURCE})(?:[/?#].*)?$`
+);
+var ZOTERO_GROUP_ITEM_PATH_PATTERN = new RegExp(
+  `^/groups/(\\d+)/items/(${REF_KEY_SOURCE})(?:[/?#].*)?$`
+);
+var LIBRARY = "(?<libraryType>user|group)/(?<libraryId>\\d+)";
+var KINDS = "(?<kind>item|attachment|annotation|collection|search)";
+var SERVER_QUALIFIER = "\\?server=(?<serverId>[A-Za-z0-9_-]{1,64})";
+var REF_PATTERN = new RegExp(
+  `^zotero://${LIBRARY}/${KINDS}/(?<key>${REF_KEY_SOURCE})(?:${SERVER_QUALIFIER})?$`
+);
+var REF_IN_TEXT_PATTERN = new RegExp(
+  `zotero://${LIBRARY}/${KINDS}/(?<key>${REF_KEY_SOURCE})`
+);
+
+// src/json.ts
+var OBJECT_KEY_PATTERN = new RegExp(`^${REF_KEY_SOURCE}$`);
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function asString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+
 // src/client/presenters.ts
 function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+  return asRecord(value) !== void 0;
 }
 function callNameOf(block) {
   return "kind" in block ? block.call?.name ?? null : block.name;
@@ -1521,10 +1549,9 @@ function orderKeyOf(block) {
   return "kind" in block ? block.seq : 1e9 + block.time;
 }
 function stringField(record2, key) {
-  const value = record2[key];
-  return typeof value === "string" ? value : void 0;
+  return asString(record2[key]);
 }
-function numberField2(record2, key) {
+function numberField(record2, key) {
   const value = record2[key];
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -1565,10 +1592,7 @@ function argsOf(block) {
   }
 }
 function shortKeyOf(value) {
-  const match = /zotero:\/\/user\/0\/(?:item|attachment|annotation|collection|search)\/([A-Z0-9]{8})/.exec(
-    value
-  );
-  return match?.[1] ?? null;
+  return REF_IN_TEXT_PATTERN.exec(value)?.groups?.key ?? null;
 }
 function evidenceItemsOf(meta3) {
   const items = meta3["items"];
@@ -1618,9 +1642,9 @@ function exportItemsOf(value) {
     if (ref === void 0) continue;
     const key = stringField(entry, "key");
     const title = stringField(entry, "title");
-    const entryIndex = numberField2(entry, "entryIndex");
-    const start = numberField2(entry, "start");
-    const end = numberField2(entry, "end");
+    const entryIndex = numberField(entry, "entryIndex");
+    const start = numberField(entry, "start");
+    const end = numberField(entry, "end");
     items.push({
       ref,
       ...key === void 0 ? {} : { key },
@@ -1641,7 +1665,7 @@ function decodeSearchRows(value) {
     const title = stringField(item, "title");
     const creatorSummary = stringField(item, "creatorSummary");
     if (ref === void 0 || title === void 0 || creatorSummary === void 0) return null;
-    const year = numberField2(item, "year");
+    const year = numberField(item, "year");
     const bestAttachmentRef = stringField(item, "bestAttachmentRef");
     const bestAttachmentType = stringField(item, "bestAttachmentType");
     rows.push({
@@ -1658,7 +1682,7 @@ function decodeSearchRows(value) {
 function decodeSupportedLibrary(value) {
   if (!isRecord(value)) return null;
   const type = stringField(value, "type");
-  const id = numberField2(value, "id");
+  const id = numberField(value, "id");
   if (type !== "user" && type !== "group" || id === void 0 || !Number.isInteger(id))
     return null;
   if (type === "user" && id !== 0) return null;
@@ -1687,7 +1711,7 @@ function decodeResolvedScope(value) {
 function searchMetaOf(meta3) {
   return {
     rows: decodeSearchRows(meta3["items"]),
-    omitted: numberField2(meta3, "omitted") ?? null,
+    omitted: numberField(meta3, "omitted") ?? null,
     scope: decodeResolvedScope(meta3["scope"]),
     library: decodeSupportedLibrary(meta3["library"])
   };
@@ -1705,7 +1729,7 @@ function getMetaOf(meta3) {
   return {
     title: stringField(meta3, "title") ?? null,
     creators: stringField(meta3, "creators") ?? null,
-    year: numberField2(meta3, "year") ?? null,
+    year: numberField(meta3, "year") ?? null,
     venue: stringField(meta3, "venue") ?? null,
     bestAttachment
   };
@@ -1717,7 +1741,7 @@ function decodeSourceAvailability(value) {
     if (!isRecord(entry)) continue;
     const requested = boolField(entry, "requested");
     const unavailable = boolField(entry, "unavailable");
-    const returnedPassages = numberField2(entry, "returnedPassages");
+    const returnedPassages = numberField(entry, "returnedPassages");
     if (requested === void 0 || unavailable === void 0 || returnedPassages === void 0)
       continue;
     result[source] = { requested, returnedPassages, unavailable };
@@ -1728,10 +1752,10 @@ function decodeCoverage(value) {
   if (!isRecord(value)) return null;
   const complete = boolField(value, "complete");
   if (complete === void 0) return null;
-  const indexedPages = numberField2(value, "indexedPages");
-  const totalPages = numberField2(value, "totalPages");
-  const indexedChars = numberField2(value, "indexedChars");
-  const totalChars = numberField2(value, "totalChars");
+  const indexedPages = numberField(value, "indexedPages");
+  const totalPages = numberField(value, "totalPages");
+  const indexedChars = numberField(value, "indexedChars");
+  const totalChars = numberField(value, "totalChars");
   return {
     complete,
     ...indexedPages === void 0 ? {} : { indexedPages },
@@ -1744,7 +1768,7 @@ function retrieveMetaOf(meta3) {
   const truncated = boolField(meta3, "truncated");
   return {
     items: evidenceItemsOf(meta3),
-    count: numberField2(meta3, "count") ?? null,
+    count: numberField(meta3, "count") ?? null,
     truncated: truncated === void 0 ? null : truncated,
     attachmentRef: stringField(meta3, "attachmentRef") ?? null,
     attachmentContentType: stringField(meta3, "attachmentContentType") ?? null,
@@ -1769,7 +1793,7 @@ function exportMetaOf(meta3) {
     style: stringField(meta3, "style") ?? null,
     locale: stringField(meta3, "locale") ?? null,
     refs: stringArrayOf(meta3["refs"]),
-    refsOmitted: numberField2(meta3, "refsOmitted") ?? 0,
+    refsOmitted: numberField(meta3, "refsOmitted") ?? 0,
     items: exportItemsOf(meta3["items"])
   };
 }
@@ -2409,10 +2433,10 @@ var import_dsh_client_ui_primitives3 = require("@deepseek-ai/dsh-client-ui-primi
 
 // src/client/build-info.ts
 function buildVersion() {
-  return true ? "0.5.2" : "unknown";
+  return true ? "0.6.0" : "unknown";
 }
 function buildCommit() {
-  return true ? "ae33e5b" : "unknown";
+  return true ? "00b1b30" : "unknown";
 }
 function buildInfoOf() {
   return `${buildVersion()} \xB7 ${buildCommit()}`;
@@ -2436,7 +2460,7 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style2;
   document.head.appendChild(tag);
 }
-var workspace_default = { "view": "_o1AEW_view", "detailTabCount": "_o1AEW_detailTabCount", "action": "_o1AEW_action", "sidebar": "_o1AEW_sidebar", "filterClear": "_o1AEW_filterClear", "backAction": "_o1AEW_backAction", "listItemMeta": "_o1AEW_listItemMeta", "evidencePage": "_o1AEW_evidencePage", "listItemSelected": "_o1AEW_listItemSelected", "statusText": "_o1AEW_statusText", "emptyNote": "_o1AEW_emptyNote", "note": "_o1AEW_note", "diagnosis": "_o1AEW_diagnosis", "lensBar": "_o1AEW_lensBar", "section": "_o1AEW_section", "passages": "_o1AEW_passages", "detailToggle": "_o1AEW_detailToggle", "listItem": "_o1AEW_listItem", "summaryLine": "_o1AEW_summaryLine", "passage": "_o1AEW_passage", "sourceTag": "_o1AEW_sourceTag", "filterArrowLeft": "_o1AEW_filterArrowLeft", "sectionLabel": "_o1AEW_sectionLabel", "emptyWrap": "_o1AEW_emptyWrap", "exportStack": "_o1AEW_exportStack", "actionRow": "_o1AEW_actionRow", "panel": "_o1AEW_panel", "emptyText": "_o1AEW_emptyText", "empty": "_o1AEW_empty", "warning": "_o1AEW_warning", "inspectorTitleWrap": "_o1AEW_inspectorTitleWrap", "detailTabActive": "_o1AEW_detailTabActive", "lensTabCount": "_o1AEW_lensTabCount", "listbox": "_o1AEW_listbox", "line": "_o1AEW_line", "lensTabActive": "_o1AEW_lensTabActive", "inspectorHead": "_o1AEW_inspectorHead", "detailTab": "_o1AEW_detailTab", "inspectorBody": "_o1AEW_inspectorBody", "availability": "_o1AEW_availability", "emptyIcon": "_o1AEW_emptyIcon", "spacer": "_o1AEW_spacer", "lensTab": "_o1AEW_lensTab", "inspectorTitle": "_o1AEW_inspectorTitle", "inspectorTabs": "_o1AEW_inspectorTabs", "passageHead": "_o1AEW_passageHead", "starterRow": "_o1AEW_starterRow", "inspectorMeta": "_o1AEW_inspectorMeta", "badge": "_o1AEW_badge", "inspector": "_o1AEW_inspector", "menuButton": "_o1AEW_menuButton", "refresh": "_o1AEW_refresh", "toolbar": "_o1AEW_toolbar", "workspace": "_o1AEW_workspace", "cardStack": "_o1AEW_cardStack", "listItemTitle": "_o1AEW_listItemTitle", "badges": "_o1AEW_badges", "filterBar": "_o1AEW_filterBar", "filterArrow": "_o1AEW_filterArrow", "evidenceEntry": "_o1AEW_evidenceEntry", "exportsPage": "_o1AEW_exportsPage", "filterArrowRight": "_o1AEW_filterArrowRight" };
+var workspace_default = { "panel": "_o1AEW_panel", "inspector": "_o1AEW_inspector", "line": "_o1AEW_line", "passage": "_o1AEW_passage", "lensTabActive": "_o1AEW_lensTabActive", "inspectorMeta": "_o1AEW_inspectorMeta", "evidenceEntry": "_o1AEW_evidenceEntry", "emptyWrap": "_o1AEW_emptyWrap", "inspectorTitle": "_o1AEW_inspectorTitle", "action": "_o1AEW_action", "empty": "_o1AEW_empty", "availability": "_o1AEW_availability", "workspace": "_o1AEW_workspace", "detailTab": "_o1AEW_detailTab", "inspectorHead": "_o1AEW_inspectorHead", "cardStack": "_o1AEW_cardStack", "passages": "_o1AEW_passages", "spacer": "_o1AEW_spacer", "filterArrowLeft": "_o1AEW_filterArrowLeft", "badges": "_o1AEW_badges", "passageHead": "_o1AEW_passageHead", "emptyNote": "_o1AEW_emptyNote", "detailToggle": "_o1AEW_detailToggle", "exportStack": "_o1AEW_exportStack", "warning": "_o1AEW_warning", "detailTabCount": "_o1AEW_detailTabCount", "starterRow": "_o1AEW_starterRow", "filterArrow": "_o1AEW_filterArrow", "statusText": "_o1AEW_statusText", "sourceTag": "_o1AEW_sourceTag", "listbox": "_o1AEW_listbox", "lensTab": "_o1AEW_lensTab", "backAction": "_o1AEW_backAction", "emptyIcon": "_o1AEW_emptyIcon", "actionRow": "_o1AEW_actionRow", "evidencePage": "_o1AEW_evidencePage", "toolbar": "_o1AEW_toolbar", "diagnosis": "_o1AEW_diagnosis", "emptyText": "_o1AEW_emptyText", "listItem": "_o1AEW_listItem", "badge": "_o1AEW_badge", "inspectorTabs": "_o1AEW_inspectorTabs", "listItemMeta": "_o1AEW_listItemMeta", "note": "_o1AEW_note", "detailTabActive": "_o1AEW_detailTabActive", "summaryLine": "_o1AEW_summaryLine", "menuButton": "_o1AEW_menuButton", "sidebar": "_o1AEW_sidebar", "inspectorTitleWrap": "_o1AEW_inspectorTitleWrap", "refresh": "_o1AEW_refresh", "exportsPage": "_o1AEW_exportsPage", "listItemSelected": "_o1AEW_listItemSelected", "lensBar": "_o1AEW_lensBar", "filterBar": "_o1AEW_filterBar", "sectionLabel": "_o1AEW_sectionLabel", "lensTabCount": "_o1AEW_lensTabCount", "section": "_o1AEW_section", "filterArrowRight": "_o1AEW_filterArrowRight", "inspectorBody": "_o1AEW_inspectorBody", "filterClear": "_o1AEW_filterClear", "view": "_o1AEW_view", "listItemTitle": "_o1AEW_listItemTitle" };
 
 // src/client/components/workspace/WorkspaceToolbar.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
@@ -2768,7 +2792,7 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style3;
   document.head.appendChild(tag);
 }
-var open_default = { "blocked": "_02bwZG_blocked", "srOnly": "_02bwZG_srOnly", "link": "_02bwZG_link", "note": "_02bwZG_note", "linkWrap": "_02bwZG_linkWrap", "button": "_02bwZG_button" };
+var open_default = { "blocked": "_02bwZG_blocked", "linkWrap": "_02bwZG_linkWrap", "link": "_02bwZG_link", "note": "_02bwZG_note", "button": "_02bwZG_button", "srOnly": "_02bwZG_srOnly" };
 
 // src/client/components/open/BlockedOpenAction.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
@@ -2939,7 +2963,7 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style4;
   document.head.appendChild(tag);
 }
-var cards_default = { "exportToggle": "_27yOoG_exportToggle", "sourceTag": "_27yOoG_sourceTag", "exportSection": "_27yOoG_exportSection", "line": "_27yOoG_line", "exportCodeLabel": "_27yOoG_exportCodeLabel", "exportSectionTitle": "_27yOoG_exportSectionTitle", "cardHead": "_27yOoG_cardHead", "exportCode": "_27yOoG_exportCode", "exportPre": "_27yOoG_exportPre", "exportKeys": "_27yOoG_exportKeys", "note": "_27yOoG_note", "chevron": "_27yOoG_chevron", "exportHead": "_27yOoG_exportHead", "passages": "_27yOoG_passages", "exportTitle": "_27yOoG_exportTitle", "documentTitle": "_27yOoG_documentTitle", "unresolvedItemsText": "_27yOoG_unresolvedItemsText", "exportRow": "_27yOoG_exportRow", "chevronOpen": "_27yOoG_chevronOpen", "cardTitle": "_27yOoG_cardTitle", "documentKey": "_27yOoG_documentKey", "exportCodeHead": "_27yOoG_exportCodeHead", "exportKeysText": "_27yOoG_exportKeysText", "availability": "_27yOoG_availability", "exportBody": "_27yOoG_exportBody", "lineAction": "_27yOoG_lineAction", "card": "_27yOoG_card", "lineActions": "_27yOoG_lineActions", "exportSectionHead": "_27yOoG_exportSectionHead", "unresolvedItems": "_27yOoG_unresolvedItems", "passage": "_27yOoG_passage", "exportFacts": "_27yOoG_exportFacts", "exportSectionActions": "_27yOoG_exportSectionActions", "link": "_27yOoG_link", "passageHead": "_27yOoG_passageHead", "exportSectionCount": "_27yOoG_exportSectionCount" };
+var cards_default = { "passageHead": "_27yOoG_passageHead", "exportSectionActions": "_27yOoG_exportSectionActions", "exportBody": "_27yOoG_exportBody", "passage": "_27yOoG_passage", "card": "_27yOoG_card", "cardTitle": "_27yOoG_cardTitle", "lineAction": "_27yOoG_lineAction", "sourceTag": "_27yOoG_sourceTag", "unresolvedItemsText": "_27yOoG_unresolvedItemsText", "exportSectionTitle": "_27yOoG_exportSectionTitle", "note": "_27yOoG_note", "exportPre": "_27yOoG_exportPre", "exportTitle": "_27yOoG_exportTitle", "chevronOpen": "_27yOoG_chevronOpen", "unresolvedItems": "_27yOoG_unresolvedItems", "chevron": "_27yOoG_chevron", "exportHead": "_27yOoG_exportHead", "exportToggle": "_27yOoG_exportToggle", "exportCodeLabel": "_27yOoG_exportCodeLabel", "link": "_27yOoG_link", "exportFacts": "_27yOoG_exportFacts", "documentKey": "_27yOoG_documentKey", "exportSection": "_27yOoG_exportSection", "availability": "_27yOoG_availability", "lineActions": "_27yOoG_lineActions", "exportKeysText": "_27yOoG_exportKeysText", "documentTitle": "_27yOoG_documentTitle", "cardHead": "_27yOoG_cardHead", "passages": "_27yOoG_passages", "exportCode": "_27yOoG_exportCode", "exportKeys": "_27yOoG_exportKeys", "line": "_27yOoG_line", "exportSectionCount": "_27yOoG_exportSectionCount", "exportSectionHead": "_27yOoG_exportSectionHead", "exportRow": "_27yOoG_exportRow", "exportCodeHead": "_27yOoG_exportCodeHead" };
 
 // src/client/components/CopyButton.tsx
 var import_jsx_runtime10 = require("react/jsx-runtime");
@@ -3132,11 +3156,16 @@ function SourceEvidence({ item, t }) {
 var import_react8 = require("react");
 var import_dsh_client_ui_primitives9 = require("@deepseek-ai/dsh-client-ui-primitives");
 
+// src/export-items.ts
+var BIBTEX_KEY_SOURCE = "@[A-Za-z]+\\{([^,\\s{}]+),";
+var BIBTEX_KEY = new RegExp(BIBTEX_KEY_SOURCE);
+
 // src/client/sources/bibtex.ts
+var BIBTEX_KEY2 = new RegExp(BIBTEX_KEY_SOURCE, "g");
 function bibTexKeysOf(text) {
   const keys = [];
   const seen = /* @__PURE__ */ new Set();
-  for (const match of text.matchAll(/@[A-Za-z]+\{([^,\s{}]+),/g)) {
+  for (const match of text.matchAll(BIBTEX_KEY2)) {
     const key = match[1];
     if (!seen.has(key)) {
       seen.add(key);
@@ -3690,11 +3719,17 @@ function currentTime() {
   const pad = (value) => String(value).padStart(2, "0");
   return `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
 }
-function sessionSignatureOf(slice) {
-  if (slice === void 0) return "";
-  const last = slice.nodes.length === 0 ? -1 : orderKeyOf(slice.nodes[slice.nodes.length - 1]);
-  const running = slice.runningCalls.map((call) => call.callId).join(",");
-  return `${slice.nodes.length}:${last}:${slice.runningCalls.length}:${running}`;
+function sessionSignatureOf(snapshot) {
+  if (snapshot === void 0) return "";
+  let count = 0;
+  const running = [];
+  for (const raw of snapshot.nodes.values()) {
+    const node = raw;
+    if (node.kind !== "tool-call" || node.visibility !== "visible") continue;
+    count += 1;
+    if (!("kind" in node.data.root)) running.push(node.data.root.callId);
+  }
+  return `${count}:${running.join(",")}`;
 }
 function stateOf(result, checkedAt) {
   if (!result.ok) return { kind: "remote-error", message: result.error.message };
@@ -3703,8 +3738,8 @@ function stateOf(result, checkedAt) {
   }
   return { kind: "unavailable", data: result.value, checkedAt };
 }
-function collectZoteroCalls(slice) {
-  if (slice === void 0) return [];
+function collectZoteroCalls(snapshot) {
+  if (snapshot === void 0) return [];
   const out = [];
   const seen = /* @__PURE__ */ new Set();
   const visit = (block) => {
@@ -3715,16 +3750,17 @@ function collectZoteroCalls(slice) {
     }
     for (const child of block.subCalls) visit(child);
   };
-  for (const node of slice.nodes) {
-    if (node.kind === "tool-result") visit(node);
+  for (const raw of snapshot.nodes.values()) {
+    const node = raw;
+    if (node.kind !== "tool-call" || node.visibility !== "visible") continue;
+    visit(node.data.root);
   }
-  for (const call of slice.runningCalls) visit(call);
   out.sort((a, b) => orderKeyOf(a) - orderKeyOf(b));
   return out;
 }
 function SourcesTab({ status, t, useSession, useChat, inputActions }) {
   const sessionId = useSession((snapshot) => snapshot.sessionId);
-  const chat = useChat((snapshot) => snapshot.legacy);
+  const chat = useChat((snapshot) => snapshot);
   const [statusState, setStatusState] = (0, import_react11.useState)({ kind: "loading" });
   const [requestId, setRequestId] = (0, import_react11.useState)(0);
   const [serverId, setServerId] = (0, import_react11.useState)(void 0);