weread-export 0.1.2

package/lib/types/tools.d.ts

@@ -0,0 +1,63 @@
+/**
+ * weread-export — model-facing tools.
+ *
+ * Mounted via ctx.tools.register. Covers the WeRead surface: status,
+ * config, search, book info, shelf, notes/highlights, reading stats,
+ * cache sync, and multi-target export (flomo / local file / Notion) with
+ * optional LLM prompt processing. Every tool resolves to { ok, message, ... }
+ * and never throws for API-level outcomes.
+ */
+import type { WereadStore } from './store.ts';
+import type { ExportDest } from './store.ts';
+/** Shared tool dependencies. */
+export interface ToolContext {
+    store: WereadStore;
+}
+/** Status tool: configuration + cache + export targets. */
+export declare function wereadStatusTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Config tool: set/clear the API key, default flomo tag, and export limit. */
+export declare function wereadConfigTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Search tool: book store search. */
+export declare function wereadSearchTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Book tool: metadata + progress + chapter catalog summary. */
+export declare function wereadBookTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Shelf tool: live bookshelf (optionally from cache). */
+export declare function wereadShelfTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Notes tool: notebook overview or per-book highlights + thoughts. */
+export declare function wereadNotesTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Readdata tool: reading statistics. */
+export declare function wereadReaddataTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Sync tool: pull shelf + notebooks into the local cache. */
+export declare function wereadSyncTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Shared export request. */
+export interface ExportRequest {
+    bookId?: string;
+    dest?: ExportDest;
+    localDir?: string;
+    tag?: string;
+    prompt?: string;
+    usePrompt?: boolean;
+    limit?: number;
+}
+/** Export result shape. */
+export interface ExportResult {
+    ok: boolean;
+    message: string;
+    dest: ExportDest;
+    sent?: number;
+    file?: string;
+    pageId?: string;
+    memoCount?: number;
+    bookId?: string;
+}
+/**
+ * Core export pipeline: pull highlights (+ thoughts), optionally process
+ * through the LLM prompt, then deliver to flomo / local file / Notion.
+ */
+export declare function runExport(ctx: ToolContext, req: ExportRequest): Promise<ExportResult>;
+/** Multi-target export tool: flomo / local file / Notion + optional prompt. */
+export declare function wereadExportTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Flomo tool: convenience wrapper around weread_export with dest=flomo. */
+export declare function wereadFlomoTool(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Build every weread tool. */
+export declare function buildTools(ctx: ToolContext): import("@deepseek-ai/dsh-tools").ToolDefinition[];

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "weread-export",
+  "version": "0.1.2",
+  "description": "微信读书 (WeChat Reading) integration for DeepSeek Harness: connect the official WeRead Skills Agent Gateway with a wrk- API key, then browse your bookshelf, export highlights & thoughts, query reading stats, and send highlights to flomo — agent tools plus a web settings panel",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "weread",
+    "wechat-reading",
+    "微信读书",
+    "books",
+    "highlights",
+    "notes",
+    "reading"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zhengjy01/weread-export"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsdown",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.5",
+    "lightningcss": "1.32.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2"
+  }
+}