@tiagojct/subsub 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Sub-Sub follows the version numbers of npm: a change in the second number (0.12) can change how you use it; a change in the third (0.12.1) only fixes. Until the pilot results are in, new versions are fixes only, apart from changes that the pilot asks for.
 
+## 0.12.1 (2026-10-07)
+
+Files and notes without a parent item (Zotero server 0.5.5):
+
+- Sub-Sub lists them, reads each file, finds the reference and makes the parent item: from a DOI, PMID or ISBN, or from the file's own text (magazines, reports, books). An item already in the library is used instead of a copy. One preview for up to 25 files; undo puts the files back and moves the new items to the trash.
+- Reference search for these files in Crossref, Google Books, Internet Archive, Open Library and Wikidata, without a key. Web search through Brave Search when you save a key in `subsub init`.
+- A search of the library for attachments or notes now says that it covers regular items only, instead of finding nothing.
+
+Also:
+
+- Sub-Sub no longer offers to change its own programs; it says what it cannot do.
+- Citekeys for long organisation names are shorter (europeancommission2026), and an item without creators takes the first main word of its title (economist2026, not the2026). Existing keys do not change.
+- OpenCode's "requires Global regions" error is explained in plain words.
+
 ## 0.12.0 (2026-10-07)
 
 For new users:

package/dist/config.js

@@ -59,7 +59,7 @@ export function uiLanguage(language) {
 }
 export const PROFILES = ["reader", "scholar", "author", "editor"];
 /** The Zotero server release that this Sub-Sub version runs when there is no local server folder. */
-export const SERVER_VERSION = "0.5.4";
+export const SERVER_VERSION = "0.5.5";
 /** The Starbuck release (PyPI) that this Sub-Sub version runs when there is no local Starbuck folder. */
 export const STARBUCK_VERSION = "0.2.0";
 export const STARBUCK_SOURCE = `starbuck==${STARBUCK_VERSION}`;

package/dist/init.js

@@ -21,7 +21,7 @@
  * yes|no, --profile, --tags health-sciences|health-informatics|any-field,
  * --email, --starbuck on|off, --models keep|later|opencode-go|mistral-eu|google-free.
  */
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
@@ -164,6 +164,9 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
     }
     explain("Contact email", "Unpaywall needs an email address to find open-access PDFs. Sub-Sub sends it with its requests to PubMed, Europe PMC, OpenAlex, Crossref and Unpaywall, as they ask, and to nobody else.");
     const email = (await io.ask("Email (optional)", flags.email ?? envValues.ZOTERO_CONTACT_EMAIL ?? "")).trim();
+    explain("Web search", "Optional. To identify files without a parent item, such as magazines and reports, Sub-Sub can search the web through Brave Search. Brave needs a key: https://brave.com/search/api/ (free tier; a card is asked at sign-up). Searches then go to Brave, in the United States. Without a key Sub-Sub uses Crossref, Google Books, Internet Archive, Open Library and Wikidata.");
+    const hadBrave = Boolean(envValues.BRAVE_API_KEY);
+    const brave = (await io.ask(hadBrave ? "Brave Search key (Enter keeps the saved key)" : "Brave Search key (Enter for none)", flags.brave ?? "")).trim();
     explain("Reference checks (Starbuck)", "An optional add-on for manuscripts: it checks that each cited work exists, matches its citation and was not retracted. Sub-Sub then has /verify.");
     const starbuck = await io.choose("Reference checks", [
         { value: "off", label: "Off" },
@@ -218,7 +221,9 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
     const alerts = !existsSync(alertsTarget) && existsSync(legacyAlerts) ? legacyAlerts : alertsTarget;
     mkdirSync(dirname(envFile), { recursive: true });
     const before = existsSync(envFile) ? readFileSync(envFile, "utf8") : "# Settings for the Sub-Sub Zotero servers (zotero-local-mcp). Written by subsub init.\n";
-    writeFileSync(envFile, upsertEnv(before, { ZOTERO_VAULT: notes, ZOTERO_VOCAB: vocab, ZOTERO_ALERTS: alerts, ZOTERO_CONTACT_EMAIL: email || undefined }));
+    writeFileSync(envFile, upsertEnv(before, { ZOTERO_VAULT: notes, ZOTERO_VOCAB: vocab, ZOTERO_ALERTS: alerts, ZOTERO_CONTACT_EMAIL: email || undefined, BRAVE_API_KEY: brave || undefined }));
+    if (brave || hadBrave)
+        chmodSync(envFile, 0o600); // the file holds a key
     const patch = {
         profile,
         userName: userName || undefined,

package/dist/keys.js

@@ -40,6 +40,8 @@ export function saveApiKey(agentDir, provider, key) {
 export function providerTrouble(text) {
     if (!text)
         return undefined;
+    if (/requires Global regions|not available in your region|region.{0,40}not (supported|allowed)/i.test(text))
+        return "region";
     if (/RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|usage limit/i.test(text))
         return "quota";
     if (/\b(503|529)\b|UNAVAILABLE|high demand|overloaded/i.test(text))
@@ -56,12 +58,14 @@ export const TROUBLE_TEXT_PT = {
     busy: "O fornecedor do modelo está sobrecarregado neste momento. Tente outra vez dentro de alguns minutos ou use outro modelo (/model).",
     blocked: "O fornecedor do modelo interrompeu a resposta (por exemplo, por repetir uma fonte palavra por palavra). Peça outra vez por outras palavras ou use outro modelo (/model).",
     key: "O fornecedor do modelo não aceitou a chave da API. Verifique-a ou introduza uma nova com /login.",
+    region: "O fornecedor recusa este modelo com a definição de região da sua conta. No OpenCode, permita as regiões globais (Global) nas definições de privacidade do workspace, ou escolha um modelo que a sua região permita (/model).",
 };
 export const TROUBLE_TEXT = {
     quota: "The model provider refused the request: a limit of your account was reached. Free tiers limit the text sent each minute and the requests each day. Wait a minute and ask Sub-Sub to continue; if it happens again, the daily limit is used up (it resets the next day). Or use another model (/model).",
     busy: "The model provider is busy at the moment. Try again in a few minutes, or use another model (/model).",
     blocked: "The model provider stopped the reply (for example, because it repeated a source word for word). Ask again in other words, or use another model (/model).",
     key: "The model provider did not accept the API key. Check it, or enter a new one with /login.",
+    region: "The provider refuses this model with your account's region setting. In OpenCode, allow Global regions in the workspace's Privacy settings, or choose a model your region allows (/model).",
 };
 /**
  * Seconds to wait before a per-minute limit lets the request through again, or undefined when the

package/dist/preview.js

@@ -23,6 +23,9 @@ const WORDS = {
         wouldImport: (n) => `${n} item(s) would be imported:`,
         noAbstract: "(no abstract)",
         wouldAttach: (n) => `${n} PDF(s) would be attached:`,
+        wouldParent: (n) => `${n} file(s) or note(s) would get a parent item:`,
+        newItem: "new",
+        existingItem: "existing item",
         newCollection: "New collection",
         inside: "inside",
         noteOn: "Note on",
@@ -48,6 +51,9 @@ const WORDS = {
         wouldImport: (n) => `${n} item(ns) vão ser importados:`,
         noAbstract: "(sem resumo)",
         wouldAttach: (n) => `${n} PDF(s) vão ser anexados:`,
+        wouldParent: (n) => `${n} ficheiro(s) ou nota(s) vão ter um item principal:`,
+        newItem: "novo",
+        existingItem: "item existente",
         newCollection: "Nova coleção",
         inside: "dentro de",
         noteOn: "Nota sobre",
@@ -141,6 +147,29 @@ export function formatPreview(tool, preview, lang = "en") {
         lines.push(w.wouldAttach(p.would_attach.length));
         lines.push(...list(p.would_attach.map((r) => `${s(r.item, 60)}  [${r.host_type ?? "?"}, ${r.version ?? "?"}${r.license ? `, ${r.license}` : ""}]`), w));
     }
+    if (Array.isArray(p.would_set_parent)) {
+        lines.push(w.wouldParent(p.would_set_parent.length));
+        const rows = [];
+        for (const r of p.would_set_parent.slice(0, 6)) {
+            rows.push(`${s(r.file, 60)}`);
+            if (r.parent === "new") {
+                const f = r.fields ?? {};
+                const where = ["publicationTitle", "date", "issue", "volume", "pages", "publisher", "ISBN", "DOI"]
+                    .filter((k) => f[k])
+                    .map((k) => `${k}: ${s(f[k], 40)}`)
+                    .join(", ");
+                rows.push(`  -> ${w.newItem} ${r.type} ${r.citekey}: ${s(r.item, 80)}`);
+                if (where)
+                    rows.push(`     ${where}`);
+            }
+            else {
+                rows.push(`  -> ${w.existingItem} ${r.parent_key}: ${s(r.item, 70)}`);
+            }
+        }
+        lines.push(...rows);
+        if (p.would_set_parent.length > 6)
+            lines.push(w.more(p.would_set_parent.length - 6));
+    }
     if (p.would_create && typeof p.would_create === "object") {
         const nc = p.would_create;
         lines.push(`${w.newCollection}: ${nc.name}${nc.parent ? ` (${w.inside} ${nc.parent})` : ""}`);

package/dist/roles.js

@@ -9,6 +9,7 @@ export const ZOTERO_READ = [
     "status",
     "library_overview",
     "find_items",
+    "standalone_items",
     "get_item",
     "get_fulltext",
     "list_tags",
@@ -35,13 +36,23 @@ export const PREVIEW_WRITES = new Set([
         "import_queue",
         "repair_metadata",
         "attach_oa_pdfs",
+        "set_parent_items",
     ].map((n) => `zotero_${n}`),
     "scholar_attach_note",
 ]);
 /** Writes without a dry run that still need a yes. */
 export const CONFIRM_WRITES = new Set(["scholar_export_bibliography"]);
 /** Zotero tools that look at the library or write only a note in the Sub-Sub folder. */
-export const ZOTERO_CHECKS = ["tag_audit", "audit_metadata", "find_duplicates", "check_retractions", "missing_pdfs", "write_tag_review"].map((n) => `zotero_${n}`);
+export const ZOTERO_CHECKS = [
+    "tag_audit",
+    "audit_metadata",
+    "find_duplicates",
+    "check_retractions",
+    "missing_pdfs",
+    "write_tag_review",
+    "find_reference",
+    "web_search",
+].map((n) => `zotero_${n}`);
 /**
  * The tools of a mode. The Librarian manages the library: Zotero tools and files.
  * The Researcher has the same, plus searches, notes and reference checks. The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiagojct/subsub",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Sub-Sub: a research assistant that works from your own Zotero library, in the browser or the terminal, built on pi",
   "type": "module",
   "license": "MIT",

package/roles/librarian.md

@@ -1,6 +1,6 @@
 You are Sub-Sub, the librarian for {{user}}'s Zotero library. {{about}} Reply briefly. No emojis.
 
-You change the library through the zotero_ tools. You have no web access; outside metadata reaches you only through the import and repair tools. For literature searches and notes, {{user}} switches to the Researcher (/researcher), which also does everything you do.
+You change the library through the zotero_ tools. Outside metadata reaches you through the import and repair tools, zotero_find_reference and, when {{user}} has set it up, zotero_web_search. You do not search the literature. For literature searches and notes, {{user}} switches to the Researcher (/researcher), which also does everything you do.
 
 ## How changes work
 
@@ -8,6 +8,18 @@ You change the library through the zotero_ tools. You have no web access; outsid
 - If a call is blocked because {{user}} did not approve, ask what to change. Do not retry the same call.
 - Report the journal_id after each applied change. {{User}} can revert with /undo or ask you to use undo.
 - Start a session with zotero_status. If Zotero is not reachable, stop and tell {{user}}.
+- You cannot change Sub-Sub, its servers or its settings, and you do not offer to. When a tool you need is missing or fails, say in plain words what you cannot do and what {{user}} can do instead in Zotero. {{User}} can report it at https://github.com/tiagojct/subsub/issues.
+
+## Files and notes without a parent item
+
+PDFs, scans and notes that sit alone in the library (no parent item) are not found by zotero_find_items. To give them a proper reference:
+
+1. zotero_standalone_items lists them (kind="attachment" for files only).
+2. For each file, read it with zotero_get_fulltext(key): the first pages usually give title, authors, date, publication, issue and publisher. If there is no indexed text, say that {{user}} can right-click the file in Zotero and choose Reindex Item; a scan without a text layer cannot be read. A clear file name ("Weird_Tales_-_v31n02_[1938-02].pdf") can still identify the work: propose the item and say that it rests on the file name only.
+3. If the text gives a DOI or ISBN, use it. Otherwise look the work up with zotero_find_reference (Crossref, Google Books, Internet Archive, Open Library, Wikidata; good for magazines, books and reports) and, if it is available, zotero_web_search. Put only the title, the publication and the date in a query, never other text from the file.
+4. Accept a candidate only when it agrees with the file's own text (title, date, issue). Search results are often near misses. When nothing agrees, build the item from the file's text alone, and say which fields you could not confirm.
+5. Call zotero_set_parent_items with up to 25 files: identifier= for a DOI, PMID or ISBN; item_type + fields + creators for anything else. A magazine article is magazineArticle (publicationTitle, date, issue, pages); a whole issue is a magazineArticle with the issue title, or a document; a newspaper article is newspaperArticle; a book is book; a report is report. Use parent_key when the work is already in the library. A person is a creator with lastName and firstName; name is only for an organisation.
+6. The server uses an item that is already in the library instead of making a copy. Report what was new and what was existing, and the journal_id.
 
 ## How to tag
 

package/roles/researcher.md

@@ -22,6 +22,7 @@ You read the Zotero library (zotero_ tools), search PubMed, Europe PMC and OpenA
 - If a call is blocked because {{user}} did not approve, ask what to change. Do not retry the same call.
 - Report the journal_id after each applied change. {{User}} can revert with /undo or ask you to use undo.
 - Start work on the library with zotero_status. If Zotero is not reachable, stop and tell {{user}}.
+- You cannot change Sub-Sub, its servers or its settings, and you do not offer to. When a tool you need is missing or fails, say in plain words what you cannot do and what {{user}} can do instead in Zotero. {{User}} can report it at https://github.com/tiagojct/subsub/issues.
 - Older shared rules may say that the researcher cannot change the library and hands works over to the librarian. That was before version 0.10: you do both.
 
 ## Questions about the library
@@ -44,6 +45,17 @@ You read the Zotero library (zotero_ tools), search PubMed, Europe PMC and OpenA
 - zotero_check_retractions: call again while still_unchecked > 0. Propose the tag _retracted for retracted items.
 - zotero_missing_pdfs, then zotero_attach_oa_pdfs in batches of 25. Say when a file is an accepted manuscript.
 
+## Files and notes without a parent item
+
+PDFs, scans and notes that sit alone in the library (no parent item) are not found by zotero_find_items. To give them a proper reference:
+
+1. zotero_standalone_items lists them (kind="attachment" for files only).
+2. For each file, read it with zotero_get_fulltext(key): the first pages usually give title, authors, date, publication, issue and publisher. If there is no indexed text, say that {{user}} can right-click the file in Zotero and choose Reindex Item; a scan without a text layer cannot be read. A clear file name ("Weird_Tales_-_v31n02_[1938-02].pdf") can still identify the work: propose the item and say that it rests on the file name only.
+3. If the text gives a DOI or ISBN, use it. Otherwise look the work up with zotero_find_reference (Crossref, Google Books, Internet Archive, Open Library, Wikidata; good for magazines, books and reports) and, if it is available, zotero_web_search. Put only the title, the publication and the date in a query, never other text from the file.
+4. Accept a candidate only when it agrees with the file's own text (title, date, issue). Search results are often near misses. When nothing agrees, build the item from the file's text alone, and say which fields you could not confirm.
+5. Call zotero_set_parent_items with up to 25 files: identifier= for a DOI, PMID or ISBN; item_type + fields + creators for anything else. A magazine article is magazineArticle (publicationTitle, date, issue, pages); a whole issue is a magazineArticle with the issue title, or a document; a newspaper article is newspaperArticle; a book is book; a report is report. Use parent_key when the work is already in the library. A person is a creator with lastName and firstName; name is only for an organisation.
+6. The server uses an item that is already in the library instead of making a copy. Report what was new and what was existing, and the journal_id.
+
 ## How to tag
 
 - A tag must be supported by the item itself: title and abstract, or the full text. If you are unsure, leave the tag out. Fewer correct tags are better than many loose ones.

package/src/config.ts

@@ -65,7 +65,7 @@ export type Profile = "reader" | "scholar" | "author" | "editor";
 export const PROFILES: Profile[] = ["reader", "scholar", "author", "editor"];
 
 /** The Zotero server release that this Sub-Sub version runs when there is no local server folder. */
-export const SERVER_VERSION = "0.5.4";
+export const SERVER_VERSION = "0.5.5";
 
 /** The Starbuck release (PyPI) that this Sub-Sub version runs when there is no local Starbuck folder. */
 export const STARBUCK_VERSION = "0.2.0";

package/src/init.ts

@@ -22,7 +22,7 @@
  * --email, --starbuck on|off, --models keep|later|opencode-go|mistral-eu|google-free.
  */
 
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
@@ -235,6 +235,13 @@ export async function runInit(
 	explain("Contact email", "Unpaywall needs an email address to find open-access PDFs. Sub-Sub sends it with its requests to PubMed, Europe PMC, OpenAlex, Crossref and Unpaywall, as they ask, and to nobody else.");
 	const email = (await io.ask("Email (optional)", flags.email ?? envValues.ZOTERO_CONTACT_EMAIL ?? "")).trim();
 
+	explain(
+		"Web search",
+		"Optional. To identify files without a parent item, such as magazines and reports, Sub-Sub can search the web through Brave Search. Brave needs a key: https://brave.com/search/api/ (free tier; a card is asked at sign-up). Searches then go to Brave, in the United States. Without a key Sub-Sub uses Crossref, Google Books, Internet Archive, Open Library and Wikidata.",
+	);
+	const hadBrave = Boolean(envValues.BRAVE_API_KEY);
+	const brave = (await io.ask(hadBrave ? "Brave Search key (Enter keeps the saved key)" : "Brave Search key (Enter for none)", flags.brave ?? "")).trim();
+
 	explain("Reference checks (Starbuck)", "An optional add-on for manuscripts: it checks that each cited work exists, matches its citation and was not retracted. Sub-Sub then has /verify.");
 	const starbuck = await io.choose(
 		"Reference checks",
@@ -308,7 +315,11 @@ export async function runInit(
 	const alerts = !existsSync(alertsTarget) && existsSync(legacyAlerts) ? legacyAlerts : alertsTarget;
 	mkdirSync(dirname(envFile), { recursive: true });
 	const before = existsSync(envFile) ? readFileSync(envFile, "utf8") : "# Settings for the Sub-Sub Zotero servers (zotero-local-mcp). Written by subsub init.\n";
-	writeFileSync(envFile, upsertEnv(before, { ZOTERO_VAULT: notes, ZOTERO_VOCAB: vocab, ZOTERO_ALERTS: alerts, ZOTERO_CONTACT_EMAIL: email || undefined }));
+	writeFileSync(
+		envFile,
+		upsertEnv(before, { ZOTERO_VAULT: notes, ZOTERO_VOCAB: vocab, ZOTERO_ALERTS: alerts, ZOTERO_CONTACT_EMAIL: email || undefined, BRAVE_API_KEY: brave || undefined }),
+	);
+	if (brave || hadBrave) chmodSync(envFile, 0o600); // the file holds a key
 
 	const patch: Record<string, unknown> = {
 		profile,

package/src/keys.ts

@@ -38,11 +38,12 @@ export function saveApiKey(agentDir: string, provider: string, key: string): voi
 }
 
 
-export type Trouble = "quota" | "busy" | "blocked" | "key";
+export type Trouble = "quota" | "busy" | "blocked" | "key" | "region";
 
 /** What a provider's error means for the user, or undefined when it is something else. */
 export function providerTrouble(text: string | undefined): Trouble | undefined {
 	if (!text) return undefined;
+	if (/requires Global regions|not available in your region|region.{0,40}not (supported|allowed)/i.test(text)) return "region";
 	if (/RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|usage limit/i.test(text)) return "quota";
 	if (/\b(503|529)\b|UNAVAILABLE|high demand|overloaded/i.test(text)) return "busy";
 	if (/RECITATION|SAFETY|PROHIBITED_CONTENT/.test(text)) return "blocked";
@@ -56,12 +57,14 @@ export const TROUBLE_TEXT_PT: Record<Trouble, string> = {
 	busy: "O fornecedor do modelo está sobrecarregado neste momento. Tente outra vez dentro de alguns minutos ou use outro modelo (/model).",
 	blocked: "O fornecedor do modelo interrompeu a resposta (por exemplo, por repetir uma fonte palavra por palavra). Peça outra vez por outras palavras ou use outro modelo (/model).",
 	key: "O fornecedor do modelo não aceitou a chave da API. Verifique-a ou introduza uma nova com /login.",
+	region: "O fornecedor recusa este modelo com a definição de região da sua conta. No OpenCode, permita as regiões globais (Global) nas definições de privacidade do workspace, ou escolha um modelo que a sua região permita (/model).",
 };
 export const TROUBLE_TEXT: Record<Trouble, string> = {
 	quota: "The model provider refused the request: a limit of your account was reached. Free tiers limit the text sent each minute and the requests each day. Wait a minute and ask Sub-Sub to continue; if it happens again, the daily limit is used up (it resets the next day). Or use another model (/model).",
 	busy: "The model provider is busy at the moment. Try again in a few minutes, or use another model (/model).",
 	blocked: "The model provider stopped the reply (for example, because it repeated a source word for word). Ask again in other words, or use another model (/model).",
 	key: "The model provider did not accept the API key. Check it, or enter a new one with /login.",
+	region: "The provider refuses this model with your account's region setting. In OpenCode, allow Global regions in the workspace's Privacy settings, or choose a model your region allows (/model).",
 };
 
 /**

package/src/preview.ts

@@ -27,6 +27,9 @@ const WORDS = {
 		wouldImport: (n: number) => `${n} item(s) would be imported:`,
 		noAbstract: "(no abstract)",
 		wouldAttach: (n: number) => `${n} PDF(s) would be attached:`,
+		wouldParent: (n: number) => `${n} file(s) or note(s) would get a parent item:`,
+		newItem: "new",
+		existingItem: "existing item",
 		newCollection: "New collection",
 		inside: "inside",
 		noteOn: "Note on",
@@ -52,6 +55,9 @@ const WORDS = {
 		wouldImport: (n: number) => `${n} item(ns) vão ser importados:`,
 		noAbstract: "(sem resumo)",
 		wouldAttach: (n: number) => `${n} PDF(s) vão ser anexados:`,
+		wouldParent: (n: number) => `${n} ficheiro(s) ou nota(s) vão ter um item principal:`,
+		newItem: "novo",
+		existingItem: "item existente",
 		newCollection: "Nova coleção",
 		inside: "dentro de",
 		noteOn: "Nota sobre",
@@ -158,6 +164,26 @@ export function formatPreview(tool: string, preview: unknown, lang: Lang = "en")
 			),
 		);
 	}
+	if (Array.isArray(p.would_set_parent)) {
+		lines.push(w.wouldParent(p.would_set_parent.length));
+		const rows: string[] = [];
+		for (const r of (p.would_set_parent as Obj[]).slice(0, 6)) {
+			rows.push(`${s(r.file, 60)}`);
+			if (r.parent === "new") {
+				const f = (r.fields as Obj | undefined) ?? {};
+				const where = ["publicationTitle", "date", "issue", "volume", "pages", "publisher", "ISBN", "DOI"]
+					.filter((k) => f[k])
+					.map((k) => `${k}: ${s(f[k], 40)}`)
+					.join(", ");
+				rows.push(`  -> ${w.newItem} ${r.type} ${r.citekey}: ${s(r.item, 80)}`);
+				if (where) rows.push(`     ${where}`);
+			} else {
+				rows.push(`  -> ${w.existingItem} ${r.parent_key}: ${s(r.item, 70)}`);
+			}
+		}
+		lines.push(...rows);
+		if (p.would_set_parent.length > 6) lines.push(w.more(p.would_set_parent.length - 6));
+	}
 	if (p.would_create && typeof p.would_create === "object") {
 		const nc = p.would_create as Obj;
 		lines.push(`${w.newCollection}: ${nc.name}${nc.parent ? ` (${w.inside} ${nc.parent})` : ""}`);

package/src/roles.ts

@@ -14,6 +14,7 @@ export const ZOTERO_READ = [
 	"status",
 	"library_overview",
 	"find_items",
+	"standalone_items",
 	"get_item",
 	"get_fulltext",
 	"list_tags",
@@ -41,6 +42,7 @@ export const PREVIEW_WRITES = new Set([
 		"import_queue",
 		"repair_metadata",
 		"attach_oa_pdfs",
+		"set_parent_items",
 	].map((n) => `zotero_${n}`),
 	"scholar_attach_note",
 ]);
@@ -49,7 +51,16 @@ export const PREVIEW_WRITES = new Set([
 export const CONFIRM_WRITES = new Set(["scholar_export_bibliography"]);
 
 /** Zotero tools that look at the library or write only a note in the Sub-Sub folder. */
-export const ZOTERO_CHECKS = ["tag_audit", "audit_metadata", "find_duplicates", "check_retractions", "missing_pdfs", "write_tag_review"].map(
+export const ZOTERO_CHECKS = [
+	"tag_audit",
+	"audit_metadata",
+	"find_duplicates",
+	"check_retractions",
+	"missing_pdfs",
+	"write_tag_review",
+	"find_reference",
+	"web_search",
+].map(
 	(n) => `zotero_${n}`,
 );
 

package/web/app.js

@@ -370,6 +370,7 @@ function scrollDown(force = false) {
 
 // A provider error in plain words (keep in step with providerTrouble in src/keys.ts), with the raw text below.
 function troubleOf(text) {
+	if (/requires Global regions|not available in your region|region.{0,40}not (supported|allowed)/i.test(text)) return "region";
 	if (/RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|usage limit/i.test(text)) return "quota";
 	if (/\b(503|529)\b|UNAVAILABLE|high demand|overloaded/i.test(text)) return "busy";
 	if (/RECITATION|SAFETY|PROHIBITED_CONTENT/.test(text)) return "blocked";

package/web/i18n.js

@@ -68,6 +68,7 @@ export const STRINGS = {
 		trouble_busy: "The model provider is busy at the moment. Try again in a few minutes, or choose another model with the model button.",
 		trouble_blocked: "The model provider stopped the reply (for example, because it repeated a source word for word). Ask again in other words, or choose another model.",
 		trouble_key: "The model provider did not accept the API key. Enter it again with the model button.",
+		trouble_region: "The provider refuses this model with your account's region setting. In OpenCode, allow Global regions in the workspace's Privacy settings, or choose a model your region allows with the model button.",
 		details: "Details",
 		undo: "Undo",
 		where_eu: "Where your data goes: servers in the European Union. Covered by the GDPR, the choice for material you would not send outside the EU.",
@@ -192,6 +193,7 @@ export const STRINGS = {
 		trouble_busy: "O fornecedor do modelo está sobrecarregado neste momento. Tente outra vez dentro de alguns minutos ou escolha outro modelo no botão do modelo.",
 		trouble_blocked: "O fornecedor do modelo interrompeu a resposta (por exemplo, por repetir uma fonte palavra por palavra). Peça outra vez por outras palavras ou escolha outro modelo.",
 		trouble_key: "O fornecedor do modelo não aceitou a chave da API. Volte a introduzi-la no botão do modelo.",
+		trouble_region: "O fornecedor recusa este modelo com a definição de região da sua conta. No OpenCode, permita as regiões globais (Global) nas definições de privacidade do workspace, ou escolha no botão do modelo um modelo que a sua região permita.",
 		details: "Detalhes",
 		undo: "Anular",
 		where_eu: "Para onde vão os seus dados: servidores na União Europeia. Abrangidos pelo RGPD; a escolha para material que não enviaria para fora da UE.",
@@ -298,6 +300,10 @@ export const SUGGESTIONS = {
 export const TOOLS = {
 	en: {
 		find_items: "search the library",
+		standalone_items: "list files without a parent item",
+		set_parent_items: "give files a parent item",
+		find_reference: "look up a reference",
+		web_search: "search the web",
 		get_item: "read an item",
 		get_fulltext: "read the full text",
 		library_overview: "library overview",
@@ -354,6 +360,10 @@ export const TOOLS = {
 	},
 	pt: {
 		find_items: "pesquisar na biblioteca",
+		standalone_items: "listar ficheiros sem item principal",
+		set_parent_items: "dar um item principal aos ficheiros",
+		find_reference: "procurar uma referência",
+		web_search: "pesquisar na web",
 		get_item: "ler um item",
 		get_fulltext: "ler o texto completo",
 		library_overview: "resumo da biblioteca",