dsh-moli 1.0.0 → 1.0.2

package/README.md

@@ -1,10 +1,39 @@
 # dsh-moli
 
+[![npm version](https://img.shields.io/npm/v/dsh-moli)](https://www.npmjs.com/package/dsh-moli)
+[![license](https://img.shields.io/npm/l/dsh-moli)](LICENSE)
+
 Expose a locally installed [Moli](https://github.com/lexmount/moli) (`moli.exe`, a Rust headless
 browser for AI agents) as **DeepSeek Harness tools**, so an agent can call it instead of shelling out.
 
 English | [中文](README.zh.md)
 
+## Quick start
+
+Published on npm as [`dsh-moli`](https://www.npmjs.com/package/dsh-moli):
+
+```powershell
+dsh plugin --profile web add dsh-moli
+```
+
+That is the recommended route: it resolves through the npm registry, so it also works where GitHub
+is slow or unreachable, and DSH's install dialog can fall back to a regional mirror. Installing
+straight from the repository works too, and needs GitHub to be reachable:
+
+```powershell
+dsh plugin --profile web add github:27painter/dsh-moli
+```
+
+Either way, restart DSH, then check the engine and fetch a page:
+
+```
+moli_probe
+moli_fetch url=https://example.com dump=markdown
+```
+
+Moli itself is a separate download. `moli_probe` reports whether it is present, and
+`moli_probe action=install` can fetch it. See [Installation](#installation).
+
 ## What it provides
 
 | Tool | Purpose |
@@ -53,6 +82,13 @@ The plugin is installed into a DSH profile. Pick the route that matches your mac
 
 Nothing else to fetch. The plugin finds `moli.exe` on its own and both tools work immediately.
 
+```powershell
+dsh plugin --profile web add dsh-moli
+```
+
+Install from the repository instead if you prefer tracking the source, or if the registry is
+unreachable for you:
+
 ```powershell
 dsh plugin --profile web add github:27painter/dsh-moli
 ```
@@ -64,7 +100,7 @@ Restart DSH, then confirm with `moli_probe`.
 Install the plugin the same way, restart, then let it fetch Moli for you:
 
 ```powershell
-dsh plugin --profile web add github:27painter/dsh-moli
+dsh plugin --profile web add dsh-moli
 # restart DSH, then call:
 moli_probe action=install
 ```

package/README.zh.md

@@ -4,6 +4,31 @@
 
 [English](README.md) | 中文
 
+## 快速开始
+
+已发布到 npm：[`dsh-moli`](https://www.npmjs.com/package/dsh-moli)
+
+```powershell
+dsh plugin --profile web add dsh-moli
+```
+
+**推荐走这条**：它经 npm registry 解析，所以在 GitHub 慢或不通的网络里照样能装，而且 DSH 的安装对话框能
+回退到国内镜像。直接从仓库装也可以，但需要 GitHub 可达：
+
+```powershell
+dsh plugin --profile web add github:27painter/dsh-moli
+```
+
+两种方式都要重启 DSH，然后自检并抓一个页面：
+
+```
+moli_probe
+moli_fetch url=https://example.com dump=markdown
+```
+
+Moli 本体是另外下载的。`moli_probe` 会报告它是否在场，`moli_probe action=install` 可以替你拉取。
+详见[安装](#安装)。
+
 ## 与 Moli 官方 agent skill 的关系
 
 Moli 仓库自带官方 agent skill：[`moli-webfetch`](https://github.com/lexmount/moli/tree/main/skills/moli-webfetch)、
@@ -48,6 +73,12 @@ moli_fetch url=https://example.com dump=pdf        writeTo=/绝对路径/a.pdf
 
 不需要再装别的东西。插件自己会找到 `moli.exe`，两个工具立即可用。
 
+```powershell
+dsh plugin --profile web add dsh-moli
+```
+
+若你更想跟踪源码，或 registry 对你不可达，改从仓库装：
+
 ```powershell
 dsh plugin --profile web add github:27painter/dsh-moli
 ```
@@ -59,7 +90,7 @@ dsh plugin --profile web add github:27painter/dsh-moli
 同样方式装插件、重启，然后让它替你把 Moli 拉下来：
 
 ```powershell
-dsh plugin --profile web add github:27painter/dsh-moli
+dsh plugin --profile web add dsh-moli
 # 重启 DSH，然后调用：
 moli_probe action=install
 ```

package/index.js

@@ -27,7 +27,17 @@ const DEFAULTS = {
   insecureTls: true,
 };
 
-/** Parameter schema of `moli_fetch`, in the registry's DSL. */
+/**
+ * Parameter schema of `moli_fetch`.
+ *
+ * The two schema layers follow DIFFERENT rules, which is easy to get wrong:
+ * - A parameter spec uses the author DSL, where a property-level `required: true`
+ *   is correct. `parameterSchemaSpecToJsonSchema` hoists it into an object-level
+ *   `required` array and strips the flag.
+ * - A raw output schema is validated as-is, so `required` there must already be an
+ *   object-level array of names. A property-level `required: true` makes the
+ *   registry reject the whole tool with `JsonSchemaError`.
+ */
 const FETCH_PARAMETERS = {
   url: { type: 'string', required: true, description: 'Absolute http:// or https:// URL to fetch.' },
   dump: {
@@ -65,13 +75,20 @@ const FETCH_PARAMETERS = {
   cookieFile: { type: 'string', description: 'Netscape/curl cookie-jar file to send.' },
 };
 
+/**
+ * `required` is an object-level array of property names in the registry's schema
+ * subset for a RAW schema. A property-level `required: true` belongs to the
+ * parameter DSL instead; here it makes the registry reject the tool.
+ */
+
 /** Result schema of `moli_fetch`; only `ok` and `url` are always present. */
 const FETCH_OUTPUT_SCHEMA = {
   type: 'object',
   additionalProperties: true,
+  required: ['ok', 'url'],
   properties: {
-    ok: { type: 'boolean', required: true },
-    url: { type: 'string', required: true },
+    ok: { type: 'boolean' },
+    url: { type: 'string' },
     kind: { type: 'string', enum: ['text', 'binary'] },
     dump: { type: 'string' },
     content: { type: 'string' },
@@ -93,8 +110,9 @@ const FETCH_OUTPUT_SCHEMA = {
 const PROBE_OUTPUT_SCHEMA = {
   type: 'object',
   additionalProperties: true,
+  required: ['installed'],
   properties: {
-    installed: { type: 'boolean', required: true },
+    installed: { type: 'boolean' },
     exe: { type: 'string' },
     version: { type: 'string' },
     httpsOk: { type: 'boolean' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-moli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "DeepSeek Harness tools for the local Moli headless browser: rendered fetches, markdown, semantic trees, screenshots, and PDFs.",
   "license": "MIT",