@viztor/dsh-tinyfish 0.4.1 → 0.5.0

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="assets/tinyfish.svg" alt="TinyFish logo" width="120" />
+  <img src="icon.svg" alt="TinyFish logo" width="120" />
   <h1>dsh-tinyfish</h1>
   <p><strong>Free web search and fetch for the DeepSeek Harness.</strong><br />Give your agent the live web — at $0 per call.</p>
 
@@ -26,6 +26,8 @@ cd ~/.dsh/profiles/web
 npm install dsh-tinyfish   # or: npm install @viztor/dsh-tinyfish — same thing
 ```
 
+Pick **one** name and install it once. Both tarballs carry byte-identical code and read the same settings (providers register as `tinyfish`, configuration lives under the row id `dsh-tinyfish`, credentials under the same two refs) — so switching names later loses nothing, but mounting both loads the bundle twice. `dsh-tinyfish` is the name DSH convention and these docs use.
+
 <details>
 <summary><strong>📦 Installing from GitHub Packages instead</strong></summary>
 
@@ -75,7 +77,7 @@ then `npm install @viztor/dsh-tinyfish` resolves from the mirror. Unless npmjs i
 The default is `direct`, because the package is named for TinyFish — a fresh install asks for the credential its own name implies. Prefer Monid (it reuses a platform key your Monid MCP mount may already hold)? Pin it in your profile patch:
 
 ```yaml
-- id: web-tinyfish
+- id: dsh-tinyfish
   config:
     channel: monid
 ```
@@ -95,7 +97,7 @@ The page shows the key for the **selected** channel, plus the saved-or-not statu
 
 <br />
 
-Everything lives in one row, `web-tinyfish`. The row is validated, so an out-of-range value is rejected with a message rather than silently clamped.
+Everything lives in one row, `dsh-tinyfish`. The row is validated, so an out-of-range value is rejected with a message rather than silently clamped.
 
 | key | default | meaning |
 | --- | --- | --- |
@@ -114,7 +116,7 @@ Everything lives in one row, `web-tinyfish`. The row is validated, so an out-of-
 Turning one off reports _unavailable_ rather than _missing_ — the harness tells those apart, and only the second means "the install is broken".
 
 ```yaml
-- id: web-tinyfish
+- id: dsh-tinyfish
   config:
     search: true
     fetch: false # keep TinyFish for search, let dsh-web use another fetch
@@ -125,7 +127,7 @@ Turning one off reports _unavailable_ rather than _missing_ — the harness tell
 `filters` is a nested object, and the settings form addresses one flat key per field — so search tuning stays operator-level:
 
 ```yaml
-- id: web-tinyfish
+- id: dsh-tinyfish
   config:
     channel: monid
     filters:
@@ -187,7 +189,7 @@ pnpm run release:gate   # build, then the full gate incl. 11 package checks
 pnpm run test:live      # the real APIs, still $0, needs credentials
 ```
 
-Requires **DSH 0.2.0+** and **Node 22.14+**. Full process and invariants: [`AGENTS.md`](./AGENTS.md). Contributing: [`CONTRIBUTING.md`](./CONTRIBUTING.md).
+Requires **DSH 0.2.0+** and **Node 24+**. Full process and invariants: [`AGENTS.md`](./AGENTS.md). Contributing: [`CONTRIBUTING.md`](./CONTRIBUTING.md).
 
 </details>
 

package/cordis.patch.yml

@@ -23,14 +23,14 @@
 # where the preference belongs and where it can be changed without a new
 # release:
 #
-#   - id: web-tinyfish
+#   - id: dsh-tinyfish
 #     config:
 #       channel: monid
 #
 # `apiKey` is not set here either — a secret belongs in the environment, the
 # CLI's own store, or the harness credentials service, never in a patch file.
 - insert:
-    - id: web-tinyfish
+    - id: dsh-tinyfish
       name: "dsh-tinyfish"
       config:
         attempts: 3

package/lib/client.js

@@ -33,7 +33,7 @@ let react_jsx_runtime = require("react/jsx-runtime");
 * duplicated on purpose. It must equal the exported `name` of `src/index.ts`:
 * that is what the Plugins page keys the row by.
 */
-const NS = "web-tinyfish";
+const NS = "dsh-tinyfish";
 /**
 * Client-side services this page needs.
 *
@@ -352,10 +352,14 @@ function TinyfishCard(props) {
 */
 function apply(ctx) {
 	ctx.effect(() => {
-		ctx.locale.register(NS, {
-			zh,
-			en
-		});
+		try {
+			return ctx.locale.register(NS, {
+				zh,
+				en
+			});
+		} catch {
+			return;
+		}
 	}, "dsh-tinyfish: dictionaries");
 	const scope = ctx.configForms.get(NS);
 	const model = new _deepseek_ai_dsh_client_ui_primitives.SettingsFormModel(scope, SPECS, [{

package/lib/index.d.mts

@@ -313,8 +313,9 @@ export declare class TinyfishFetchProvider implements WebFetchProvider {
  *
  * @module dsh-tinyfish
  */
-/** Settings namespace, matching the `<kind>-<provider>` convention. */
-export declare const WEB_TINYFISH_SETTINGS_NAMESPACE = "web-tinyfish";
+/** Settings namespace, matching the plugin identity. */
+export declare const TINYFISH_SETTINGS_NAMESPACE = "dsh-tinyfish";
+export declare const WEB_TINYFISH_SETTINGS_NAMESPACE = "dsh-tinyfish";
 /**
  * The plugin's settings schema.
  *
@@ -389,7 +390,17 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
 }>>, "plain">;
 /** Cordis service dependencies. */
 export declare const inject: string[];
-/** The bundle name. Must equal the manifest `name`: the loader matches on it. */
+/**
+ * The bundle name, as the code calls itself.
+ *
+ * This does NOT have to equal the manifest `name`: `dsh-opencode` ships as
+ * `@viztor/dsh-opencode` while exporting `dsh-opencode`, and mounts fine.
+ * Package identity is the install path (`node_modules/dsh-tinyfish` vs
+ * `node_modules/@viztor/dsh-tinyfish`); the providers register as `tinyfish`
+ * and the settings live under the row id `dsh-tinyfish`, so either install
+ * name reads and writes the same settings. Install exactly one — mounting
+ * both loads the bundle twice.
+ */
 export declare const name = "dsh-tinyfish";
 /** Project one resolved section into the options the next operation serves. */
 export declare function resolveOptions(config: unknown, ctx?: Context, env?: Record<string, string | undefined>): TinyfishProviderOptions;

package/lib/index.mjs

@@ -209,8 +209,8 @@ async function resolveApiKeyAsync(channel, options = {}) {
 */
 function requireKey(channel, key) {
 	if (key) return;
-	if (channel === "monid") throw new WebError("The tinyfish provider has no Monid API key. Run `monid keys add` to store one in the local credential file, or export MONID_API_KEY, or set the web-tinyfish `apiKeyEnv` row in the profile's cordis.patch.yml.", WEB_PROVIDER_CREDENTIAL_MISSING);
-	throw new WebError("The tinyfish provider has no TinyFish API key. Run `tinyfish auth login` to save one, or export TINYFISH_API_KEY, or set the web-tinyfish `apiKeyEnv` row in the profile's cordis.patch.yml — or switch the provider's channel to 'monid' to use a Monid key instead.", WEB_PROVIDER_CREDENTIAL_MISSING);
+	if (channel === "monid") throw new WebError("The tinyfish provider has no Monid API key. Run `monid keys add` to store one in the local credential file, or export MONID_API_KEY, or set the dsh-tinyfish `apiKeyEnv` row in the profile's cordis.patch.yml.", WEB_PROVIDER_CREDENTIAL_MISSING);
+	throw new WebError("The tinyfish provider has no TinyFish API key. Run `tinyfish auth login` to save one, or export TINYFISH_API_KEY, or set the dsh-tinyfish `apiKeyEnv` row in the profile's cordis.patch.yml — or switch the provider's channel to 'monid' to use a Monid key instead.", WEB_PROVIDER_CREDENTIAL_MISSING);
 }
 /** `fetch` with auth applied and failures mapped to `WebError`. */
 async function call(url, options) {
@@ -661,8 +661,9 @@ function sameUrl(a, b) {
 *
 * @module dsh-tinyfish
 */
-/** Settings namespace, matching the `<kind>-<provider>` convention. */
-const WEB_TINYFISH_SETTINGS_NAMESPACE = "web-tinyfish";
+/** Settings namespace, matching the plugin identity. */
+const TINYFISH_SETTINGS_NAMESPACE = "dsh-tinyfish";
+const WEB_TINYFISH_SETTINGS_NAMESPACE = TINYFISH_SETTINGS_NAMESPACE;
 /**
 * The plugin's settings schema.
 *
@@ -710,7 +711,17 @@ const Config = z.object({
 });
 /** Cordis service dependencies. */
 const inject = ["web"];
-/** The bundle name. Must equal the manifest `name`: the loader matches on it. */
+/**
+* The bundle name, as the code calls itself.
+*
+* This does NOT have to equal the manifest `name`: `dsh-opencode` ships as
+* `@viztor/dsh-opencode` while exporting `dsh-opencode`, and mounts fine.
+* Package identity is the install path (`node_modules/dsh-tinyfish` vs
+* `node_modules/@viztor/dsh-tinyfish`); the providers register as `tinyfish`
+* and the settings live under the row id `dsh-tinyfish`, so either install
+* name reads and writes the same settings. Install exactly one — mounting
+* both loads the bundle twice.
+*/
 const name = "dsh-tinyfish";
 /**
 * Clamp `attempts` to a range the retry loop can honour.
@@ -822,4 +833,4 @@ function apply(ctx, config) {
 	ctx.web.registerFetchProvider(new TinyfishFetchProvider(options));
 }
 //#endregion
-export { Config, DEFAULT_FETCH_BASE, DEFAULT_MONID_BASE, DEFAULT_SEARCH_BASE, TINYFISH_PROVIDER_ID, TinyfishFetchProvider, TinyfishSearchProvider, WEB_ABORTED, WEB_PROVIDER_CREDENTIAL_MISSING, WEB_PROVIDER_ERROR, WEB_TINYFISH_SETTINGS_NAMESPACE, WebError, apply, inject, name, resolveApiKey, resolveOptions, tinyfishFetch, tinyfishSearch, toIsoDate };
+export { Config, DEFAULT_FETCH_BASE, DEFAULT_MONID_BASE, DEFAULT_SEARCH_BASE, TINYFISH_PROVIDER_ID, TINYFISH_SETTINGS_NAMESPACE, TinyfishFetchProvider, TinyfishSearchProvider, WEB_ABORTED, WEB_PROVIDER_CREDENTIAL_MISSING, WEB_PROVIDER_ERROR, WEB_TINYFISH_SETTINGS_NAMESPACE, WebError, apply, inject, name, resolveApiKey, resolveOptions, tinyfishFetch, tinyfishSearch, toIsoDate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viztor/dsh-tinyfish",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "TinyFish-backed search and fetch providers for the DeepSeek Harness web capability seam (ctx.web) — $0 SERP and page extraction, direct or via Monid.",
   "keywords": [
     "cordis",
@@ -27,7 +27,7 @@
     "cordis.patch.yml",
     "README.md",
     "LICENSE",
-    "assets/tinyfish.svg"
+    "icon.svg"
   ],
   "type": "module",
   "main": "lib/index.mjs",
@@ -74,7 +74,7 @@
     "@vitest/coverage-v8": "5.0.1",
     "react": "^18.3.1",
     "typescript": "^7.0.2",
-    "ultracite": "^7.12.1",
+    "ultracite": "^7.12.2",
     "vite-plus": "catalog:",
     "vitest": "5.0.1"
   },
@@ -84,6 +84,7 @@
     "@deepseek-ai/dsh-launch-environment": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-web": "^0.2.0-rc.1"
   },
+  "icon": "./icon.svg",
   "engines": {
     "node": ">=24"
   },