Skip to content

dsh-zotero v0.2.0

Latest

Choose a tag to compare

@Vncntvx Vncntvx released this 15 Aug 12:57
· 8 commits to main since this release
v0.2.0
dc8b1ed

dsh-zotero v0.2.0. Built from commit dc8b1ed, matching dsh-zotero@0.2.0 on npm (gitHead dc8b1ed).

Highlights

  • Note bodies are first-class. zotero_get returns note body text, zotero_retrieve ranks note bodies alongside annotations, and zotero_search scans note content client-side and synthesizes note titles when Zotero supplies none. New budgets: maxNoteScanRecords (default 200) and maxNoteBodyChars (default 30000).
  • Connection failures ask the user instead of failing silently. A tool call that hits ZOTERO_NOT_RUNNING, ZOTERO_API_DISABLED, ZOTERO_API_VERSION, or ZOTERO_TIMEOUT shows a question card with the recommended action first, retries once with the original arguments, then returns the typed error. Headless compositions degrade to the error without asking; a broken question mechanism never masks the original failure.
  • Config is editable in the web UI. The plugin registers a Zotero card in dsh web (Settings → Plugins → Plugin config) listing all 19 fields. Values are written to $DSH_HOME/settings.yaml under zotero:, hot-apply on save without restart, and invalid values are rejected before writing, keeping the plugin on the last valid config.
  • zotero_export caps refs per call with maxExportRefs (default 1000), protecting the request line from the server's HTTP header limit.
  • zotero_retrieve returns real note body passages instead of title-only previews, so evidence from notes cites the actual text.

Performance

  • Scope listings are cached and only the requested kinds are normalized per call, cutting repeated zotero_get and zotero_search work.

Install

dsh plugin --profile <name> add dsh-zotero

Local tarball (npm pack) and GitHub source installs (dsh plugin --profile <name> add github:Vncntvx/dsh-zotero) work as before. See the README "Install" section.