@trim21/personal-pi-extensions 0.1.612 → 0.1.613

package/src/talk/registry.ts

@@ -81,7 +81,9 @@ export function deriveAddr(cwd: string, agentId: string): string {
 
 /** Validate a talk address before it becomes a storage key. */
 export function assertAddress(addr: string): void {
-  if (!ADDRESS_PATTERN.test(addr)) throw new TypeError(`Invalid talk address: ${addr}`);
+  if (!ADDRESS_PATTERN.test(addr)) {
+    throw new TypeError(`Invalid talk address: ${addr}`);
+  }
 }
 
 // ── Storage namespaces ───────────────────────────────────────────────────
@@ -111,7 +113,9 @@ export async function writeRecord(storage: TalkStorage, record: AgentRecord): Pr
 
 export async function readRecord(storage: TalkStorage, addr: string): Promise<AgentRecord | null> {
   const raw = await storage.readJson(RECORDS_NS, recordKey(addr));
-  if (Value.Check(AgentRecordSchema, raw)) return raw;
+  if (Value.Check(AgentRecordSchema, raw)) {
+    return raw;
+  }
   // Migrate legacy records in place of the `sessionId` → `agentId` rename.
   if (Value.Check(LegacyAgentRecordSchema, raw)) {
     // Value.Check 是类型守卫，raw 已收窄成 legacy 记录的形状，不需要再断言。
@@ -126,9 +130,13 @@ export async function listRecords(storage: TalkStorage): Promise<AgentRecord[]>
   const out: AgentRecord[] = [];
   for (const key of await storage.listKeys(RECORDS_NS)) {
     const addr = key.slice(0, -".json".length);
-    if (!ADDRESS_PATTERN.test(addr)) continue;
+    if (!ADDRESS_PATTERN.test(addr)) {
+      continue;
+    }
     const record = await readRecord(storage, addr);
-    if (record) out.push(record);
+    if (record) {
+      out.push(record);
+    }
   }
   return out.toSorted((a, b) => a.startedAt - b.startedAt);
 }
@@ -160,22 +168,30 @@ export function readStartTime(pid: number): number | undefined {
  * unreadable — we fall back to the bare pid check.
  */
 function pidAlive(pid: number, pidStart?: number): boolean {
-  if (!Number.isSafeInteger(pid) || pid <= 0) return false;
+  if (!Number.isSafeInteger(pid) || pid <= 0) {
+    return false;
+  }
   try {
     process.kill(pid, 0);
   } catch (error) {
     // EPERM means the process exists but isn't ours — still alive
     return (error as NodeJS.ErrnoException).code === "EPERM";
   }
-  if (pidStart === undefined) return true;
+  if (pidStart === undefined) {
+    return true;
+  }
   const start = readStartTime(pid);
   // 读不到启动时间时保守认为「pid 还活着」，只有两边都读到且不同才判定被复用
   return start === undefined || start === pidStart;
 }
 
 export function presenceOf(record: AgentRecord): Presence {
-  if (record.offline) return "offline";
-  if (!pidAlive(record.pid, record.pidStart)) return "offline";
+  if (record.offline) {
+    return "offline";
+  }
+  if (!pidAlive(record.pid, record.pidStart)) {
+    return "offline";
+  }
   return "live";
 }
 
@@ -196,12 +212,18 @@ export async function sweep(storage: TalkStorage, now: number = Date.now()): Pro
   for (const record of await listRecords(storage)) {
     // Without a heartbeat, lastSeenAt only tracks the last event, so an idle
     // live agent would look long-quiet — never reap a live process.
-    if (pidAlive(record.pid, record.pidStart)) continue;
+    if (pidAlive(record.pid, record.pidStart)) {
+      continue;
+    }
     const quietFor = now - record.lastSeenAt;
-    if (quietFor < SWEEP_OFFLINE_GRACE_MS) continue;
+    if (quietFor < SWEEP_OFFLINE_GRACE_MS) {
+      continue;
+    }
     const hasMail =
       (await storage.hasKeys(inboxNs(record.addr))) || (await storage.hasKeys(asksNs(record.addr)));
-    if (hasMail && quietFor < SWEEP_MAIL_KEEP_MS) continue;
+    if (hasMail && quietFor < SWEEP_MAIL_KEEP_MS) {
+      continue;
+    }
     await storage.removeNamespace(inboxNs(record.addr));
     await storage.removeNamespace(asksNs(record.addr));
     await storage.removeKey(RECORDS_NS, recordKey(record.addr));

package/src/talk/storage.ts

@@ -100,7 +100,9 @@ export class SqliteTalkStorage implements TalkStorage {
     const row = this.db
       .prepare("SELECT value FROM talk_kv WHERE namespace = ? AND key = ?")
       .get(namespace, key) as { value: string } | undefined;
-    if (row === undefined) return Promise.resolve(null);
+    if (row === undefined) {
+      return Promise.resolve(null);
+    }
     try {
       return Promise.resolve(JSON.parse(row.value) as unknown);
     } catch {

package/src/vision-agent.ts

@@ -120,7 +120,9 @@ export function resolveImagePaths(params: { path?: string | string[] }): string[
 }
 
 function toTrimmedList(value: string | string[] | undefined): string[] {
-  if (value === undefined) return [];
+  if (value === undefined) {
+    return [];
+  }
   const list = Array.isArray(value) ? value : [value];
   return list.map((s) => s.trim()).filter((s) => s.length > 0);
 }
@@ -143,9 +145,13 @@ export function loadVisionConfig(settingsPath = SETTINGS_PATH): VisionConfigSett
   } catch {
     return undefined;
   }
-  if (!Value.Check(visionSettingsSchema, parsed)) return undefined;
+  if (!Value.Check(visionSettingsSchema, parsed)) {
+    return undefined;
+  }
   const config = parsed.visionConfig;
-  if (config === undefined) return undefined;
+  if (config === undefined) {
+    return undefined;
+  }
   const provider = config.provider?.trim() || undefined;
   const defaultProvider = parsed.defaultProvider?.trim() || undefined;
   return {
@@ -210,9 +216,15 @@ export function buildPendantMarkdown(params: {
 
 /** 按文件头识别真实图片类型，识别不出返回 undefined */
 function sniffMime(buf: Buffer): string | undefined {
-  if (buf.length >= 8 && buf.readUInt32BE(0) === 0x89504e47) return "image/png";
-  if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) return "image/jpeg";
-  if (buf.length >= 6 && buf.toString("ascii", 0, 4) === "GIF8") return "image/gif";
+  if (buf.length >= 8 && buf.readUInt32BE(0) === 0x89504e47) {
+    return "image/png";
+  }
+  if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) {
+    return "image/jpeg";
+  }
+  if (buf.length >= 6 && buf.toString("ascii", 0, 4) === "GIF8") {
+    return "image/gif";
+  }
   if (
     buf.length >= 12 &&
     buf.toString("ascii", 0, 4) === "RIFF" &&
@@ -220,14 +232,18 @@ function sniffMime(buf: Buffer): string | undefined {
   ) {
     return "image/webp";
   }
-  if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) return "image/bmp";
+  if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) {
+    return "image/bmp";
+  }
   return undefined;
 }
 
 /** 读取图片文件 → base64 + mimeType + 展示名 */
 function loadImageBytes(path: string): { base64: string; mimeType: string; label: string } {
   const ext = extname(path).toLowerCase();
-  if (!IMAGE_EXTS.has(ext)) throw new Error(`不支持的文件格式: ${ext || "(无扩展名)"}`);
+  if (!IMAGE_EXTS.has(ext)) {
+    throw new Error(`不支持的文件格式: ${ext || "(无扩展名)"}`);
+  }
 
   let stat;
   try {
@@ -238,8 +254,12 @@ function loadImageBytes(path: string): { base64: string; mimeType: string; label
       { cause: error },
     );
   }
-  if (!stat.isFile()) throw new Error(`不是普通文件: ${path}`);
-  if (stat.size === 0) throw new Error(`文件为空: ${path}`);
+  if (!stat.isFile()) {
+    throw new Error(`不是普通文件: ${path}`);
+  }
+  if (stat.size === 0) {
+    throw new Error(`文件为空: ${path}`);
+  }
   if (stat.size > MAX_IMAGE_BYTES) {
     throw new Error(`图片过大 (${(stat.size / 1024 / 1024).toFixed(1)}MB)，上限 10MB`);
   }
@@ -293,7 +313,9 @@ export async function callVision(
     );
   } catch (error) {
     // 用户主动取消（signal abort）不是失败，转成 VisionAbortError 由调用方处理
-    if (error instanceof Error && error.name === "AbortError") throw new VisionAbortError();
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new VisionAbortError();
+    }
     throw error;
   }
   const text = contentText(result.content).trim();
@@ -325,11 +347,14 @@ export default function visionAgent(pi: ExtensionAPI) {
     const hasTool = active.includes(TOOL_NAME);
     if (hasTool && isMultimodal(model)) {
       pi.setActiveTools(active.filter((t) => t !== TOOL_NAME));
-      if (notify) notify(`主模型 ${model?.id ?? "?"} 支持视觉 → 已隐藏 ${TOOL_NAME}，图片原生透传`);
+      if (notify) {
+        notify(`主模型 ${model?.id ?? "?"} 支持视觉 → 已隐藏 ${TOOL_NAME}，图片原生透传`);
+      }
     } else if (!hasTool && !isMultimodal(model)) {
       pi.setActiveTools([...active, TOOL_NAME]);
-      if (notify)
+      if (notify) {
         notify(`主模型 ${model?.id ?? "?"} 不支持视觉 → 已启用 ${TOOL_NAME}，由视觉模型代理识别`);
+      }
     }
   }
 
@@ -347,7 +372,9 @@ export default function visionAgent(pi: ExtensionAPI) {
   // baseUrl/apiKey 由 pi 的模型注册表在调用时解析（execute 里 find），
   // 配置好 settings.json / models.json 后重新加载（/reload）即可生效。
   const visionConfig = loadVisionConfig();
-  if (!visionConfig?.model) return;
+  if (!visionConfig?.model) {
+    return;
+  }
 
   pi.registerTool({
     name: TOOL_NAME,

package/src/web/config.ts

@@ -20,7 +20,9 @@ export function webSearchConfigPath(): string {
 /** ~/.pi/web-search.json 的 search1apiApiKey，或 SEARCH1API_KEY 环境变量。 */
 export async function loadSearch1ApiKey(path = webSearchConfigPath()): Promise<string | undefined> {
   const envKey = process.env.SEARCH1API_KEY;
-  if (envKey) return envKey;
+  if (envKey) {
+    return envKey;
+  }
   try {
     const raw = await readFile(path, "utf8");
     const parsed = Value.Parse(webSearchSchema, JSON.parse(raw));

package/src/web/fetch.ts

@@ -38,33 +38,65 @@ const MAX_MARKDOWN_BYTES = 100 * 1024;
 
 function isPrivateIpv4(ip: string): boolean {
   const parts = ip.split(".").map(Number);
-  if (parts.length !== 4 || parts.some((p) => Number.isNaN(p))) return false;
+  if (parts.length !== 4 || parts.some((p) => Number.isNaN(p))) {
+    return false;
+  }
   const [a, b, c] = parts;
-  if (a === 0) return true; // 0.0.0.0/8
-  if (a === 10) return true; // 10.0.0.0/8
-  if (a === 127) return true; // 127.0.0.0/8 loopback
-  if (a === 169 && b === 254) return true; // 169.254.0.0/16 link-local
-  if (a === 172 && b >= 16 && b <= 31) return true; // 172.16.0.0/12
-  if (a === 192 && b === 168) return true; // 192.168.0.0/16
-  if (a === 100 && b >= 64 && b <= 127) return true; // 100.64.0.0/10 CGNAT
-  if (a === 198 && (b === 18 || b === 19)) return true; // 198.18.0.0/15 benchmarking
-  if (a === 192 && b === 0 && c === 0) return true; // 192.0.0.0/24
+  if (a === 0) {
+    return true; // 0.0.0.0/8
+  }
+  if (a === 10) {
+    return true; // 10.0.0.0/8
+  }
+  if (a === 127) {
+    return true; // 127.0.0.0/8 loopback
+  }
+  if (a === 169 && b === 254) {
+    return true; // 169.254.0.0/16 link-local
+  }
+  if (a === 172 && b >= 16 && b <= 31) {
+    return true; // 172.16.0.0/12
+  }
+  if (a === 192 && b === 168) {
+    return true; // 192.168.0.0/16
+  }
+  if (a === 100 && b >= 64 && b <= 127) {
+    return true; // 100.64.0.0/10 CGNAT
+  }
+  if (a === 198 && (b === 18 || b === 19)) {
+    return true; // 198.18.0.0/15 benchmarking
+  }
+  if (a === 192 && b === 0 && c === 0) {
+    return true; // 192.0.0.0/24
+  }
   return a >= 224; // 224.0.0.0/3 multicast + reserved
 }
 
 function isPrivateIpv6(ip: string): boolean {
   const lower = ip.toLowerCase();
-  if (lower === "::" || lower === "::1") return true; // unspecified / loopback
-  if (lower.startsWith("fc") || lower.startsWith("fd")) return true; // fc00::/7 ULA
-  if (/^fe[89ab]/.test(lower)) return true; // fe80::/10 link-local
-  if (lower.startsWith("::ffff:")) return isPrivateIpv4(lower.slice(7));
+  if (lower === "::" || lower === "::1") {
+    return true; // unspecified / loopback
+  }
+  if (lower.startsWith("fc") || lower.startsWith("fd")) {
+    return true; // fc00::/7 ULA
+  }
+  if (/^fe[89ab]/.test(lower)) {
+    return true; // fe80::/10 link-local
+  }
+  if (lower.startsWith("::ffff:")) {
+    return isPrivateIpv4(lower.slice(7));
+  }
   return false;
 }
 
 export function isPrivateAddress(ip: string): boolean {
   const version = isIP(ip);
-  if (version === 4) return isPrivateIpv4(ip);
-  if (version === 6) return isPrivateIpv6(ip);
+  if (version === 4) {
+    return isPrivateIpv4(ip);
+  }
+  if (version === 6) {
+    return isPrivateIpv6(ip);
+  }
   return true; // 非 IP 一律拒绝
 }
 
@@ -181,7 +213,9 @@ export async function fetchPage(url: string, signal?: AbortSignal): Promise<Fetc
     const decoder = new TextDecoder();
     for (;;) {
       const chunk = (await reader.read()) as { done: boolean; value: Uint8Array };
-      if (chunk.done) break;
+      if (chunk.done) {
+        break;
+      }
       body += decoder.decode(chunk.value, { stream: true });
       if (Buffer.byteLength(body, "utf8") > MAX_BYTES) {
         throw new Error(`页面过大，上限 ${MAX_BYTES} bytes`);
@@ -222,7 +256,9 @@ export async function saveUrlToFile(
       const reader = response.body.getReader();
       for (;;) {
         const chunk = (await reader.read()) as { done: boolean; value: Uint8Array };
-        if (chunk.done) break;
+        if (chunk.done) {
+          break;
+        }
         bytes += chunk.value.byteLength;
         if (bytes > MAX_FILE_BYTES) {
           throw new Error(`文件过大，上限 ${MAX_FILE_BYTES} bytes`);
@@ -248,10 +284,18 @@ export async function saveUrlToFile(
 /** 按 mime 主体分类响应；html 走 readability，其余文本类原样返回 */
 function classifyContentType(contentType: string): "html" | "text" | null {
   const mime = contentType.split(";", 1)[0]?.trim().toLowerCase() ?? "";
-  if (mime === "text/html" || mime === "application/xhtml+xml") return "html";
-  if (mime.startsWith("text/")) return "text";
-  if (mime === "application/json" || mime.endsWith("+json")) return "text";
-  if (mime === "application/xml" || mime.endsWith("+xml")) return "text";
+  if (mime === "text/html" || mime === "application/xhtml+xml") {
+    return "html";
+  }
+  if (mime.startsWith("text/")) {
+    return "text";
+  }
+  if (mime === "application/json" || mime.endsWith("+json")) {
+    return "text";
+  }
+  if (mime === "application/xml" || mime.endsWith("+xml")) {
+    return "text";
+  }
   return null;
 }
 
@@ -272,7 +316,9 @@ interface ParsedDocument {
  */
 function unshadowReactStreaming(document: ParsedDocument): void {
   for (const el of document.querySelectorAll("[hidden]")) {
-    if (/^S:\d+$/.test(el.id ?? "")) el.removeAttribute("hidden");
+    if (/^S:\d+$/.test(el.id ?? "")) {
+      el.removeAttribute("hidden");
+    }
   }
 }
 
@@ -285,7 +331,9 @@ export function extractMarkdown(html: string, sourceUrl: string): FetchedPage {
   // linkedom document 的兼容方法，cast 桥接即可
   const article = new Readability(parsed.document).parse();
   let title = article?.title ?? document.title?.trim() ?? sourceUrl;
-  if (typeof title !== "string" || title.length === 0) title = sourceUrl;
+  if (typeof title !== "string" || title.length === 0) {
+    title = sourceUrl;
+  }
   let body = article?.content;
   if (!body || body.length === 0) {
     body = document.body?.textContent ?? "";
@@ -303,7 +351,9 @@ export function extractMarkdown(html: string, sourceUrl: string): FetchedPage {
 }
 
 function truncateMarkdown(text: string): { text: string; truncated: boolean } {
-  if (Buffer.byteLength(text, "utf8") <= MAX_MARKDOWN_BYTES) return { text, truncated: false };
+  if (Buffer.byteLength(text, "utf8") <= MAX_MARKDOWN_BYTES) {
+    return { text, truncated: false };
+  }
   const bytes = Buffer.from(text, "utf8");
   const sliced = bytes.subarray(0, MAX_MARKDOWN_BYTES).toString("utf8");
   const cut = sliced.lastIndexOf("\n", sliced.length - 1);

package/src/web/search.ts

@@ -51,13 +51,17 @@ export interface SearchOptions {
 }
 
 function clampNumResults(value: number | undefined): number {
-  if (typeof value !== "number" || !Number.isFinite(value)) return 5;
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return 5;
+  }
   return Math.max(1, Math.min(Math.floor(value), 50));
 }
 
 function normalizeDomain(raw: string): string | undefined {
   const input = raw.trim().toLowerCase().replace(/^-/, "").trim();
-  if (!input) return undefined;
+  if (!input) {
+    return undefined;
+  }
   try {
     const host = input.includes("://")
       ? new URL(input).hostname
@@ -76,7 +80,9 @@ function splitDomainFilter(domainFilter: string[] | undefined): {
   const excludeSites: string[] = [];
   for (const raw of domainFilter ?? []) {
     const domain = normalizeDomain(raw);
-    if (!domain) continue;
+    if (!domain) {
+      continue;
+    }
     (raw.trimStart().startsWith("-") ? excludeSites : includeSites).push(domain);
   }
   return { includeSites, excludeSites };
@@ -90,10 +96,18 @@ export function buildSearchBody(query: string, options: SearchOptions): Record<s
     max_results: numResults,
     crawl_results: options.includeContent ? Math.min(numResults, 5) : 0,
   };
-  if (options.recencyFilter) body.time_range = options.recencyFilter;
-  if (options.searchService) body.search_service = options.searchService;
-  if (includeSites.length > 0) body.include_sites = includeSites;
-  if (excludeSites.length > 0) body.exclude_sites = excludeSites;
+  if (options.recencyFilter) {
+    body.time_range = options.recencyFilter;
+  }
+  if (options.searchService) {
+    body.search_service = options.searchService;
+  }
+  if (includeSites.length > 0) {
+    body.include_sites = includeSites;
+  }
+  if (excludeSites.length > 0) {
+    body.exclude_sites = excludeSites;
+  }
   return body;
 }
 
@@ -108,14 +122,18 @@ function mapHits(
   const hits: SearchHit[] = [];
   for (const item of results) {
     const url = item.link?.trim();
-    if (!url) continue;
+    if (!url) {
+      continue;
+    }
     const hit: SearchHit = {
       title: item.title?.trim() || url,
       url,
       snippet: item.snippet?.replaceAll(/\s+/g, " ").trim() || "",
     };
     const content = item.content?.trim();
-    if (content) hit.content = content;
+    if (content) {
+      hit.content = content;
+    }
     hits.push(hit);
   }
   return hits;
@@ -232,7 +250,9 @@ export default function webSearchTool(pi: ExtensionAPI): void {
         const hits: SearchHit[] = [];
         for (const result of results) {
           for (const hit of result.hits) {
-            if (seen.has(hit.url)) continue;
+            if (seen.has(hit.url)) {
+              continue;
+            }
             seen.add(hit.url);
             hits.push(hit);
           }