@tonydua/dsh-web-search-exa 0.1.4 → 0.2.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tonydua/dsh-web-search-exa",
   "description": "Zero-config Exa web search provider for DeepSeek Harness (dsh): keyless anonymous MCP fallback (mcp.exa.ai/mcp) plus keyed REST search — a drop-in WebSearchProvider for the ctx.web seam, no API key required.",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -27,10 +27,10 @@
   },
   "type": "module",
   "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
+  "types": "lib/index.d.ts",
   "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
+      "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
     "./package.json": "./package.json"
@@ -42,30 +42,51 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.0-rc.1": "compatible",
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-alpha.1": "compatible"
+      }
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "test": "node --test test/index.test.js"
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "pretest": "pnpm run build",
+    "test": "node --test test/index.test.js",
+    "test:only": "node --test test/index.test.js",
+    "prepublishOnly": "pnpm run build",
+    "compat": "bash scripts/compat-matrix.sh"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-web": "^0.1.2-rc.1"
+    "@deepseek-ai/cordis": ">=4.0.2 || >=4.0.5-alpha.1",
+    "@deepseek-ai/dsh-launch-environment": ">=0.1.2-alpha.2 || >=0.1.3-alpha.2 || >=0.1.4-0 || >=0.1.5-alpha.1 || >=0.1.6-alpha.1 || >=0.1.7-alpha.1 || >=0.1.8 || >=0.2.0-rc.1 || >=0.2.1-alpha.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.2 || >=0.1.3-alpha.2 || >=0.1.4-0 || >=0.1.5-alpha.1 || >=0.1.6-alpha.1 || >=0.1.7-alpha.1 || >=0.1.8 || >=0.2.0-rc.1 || >=0.2.1-alpha.1",
+    "@deepseek-ai/dsh-web": ">=0.1.2-alpha.2 || >=0.1.3-alpha.2 || >=0.1.4-0 || >=0.1.5-alpha.1 || >=0.1.6-alpha.1 || >=0.1.7-alpha.1 || >=0.1.8 || >=0.2.0-rc.1 || >=0.2.1-alpha.1"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-web": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-launch-environment": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-web": "^0.1.5-rc.3",
+    "@types/node": "^22.19.0",
+    "tsdown": "^0.23.0",
+    "typescript": "^5.9.0"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.19.0"
   }
 }

package/lib/types/index.d.ts

@@ -1,70 +0,0 @@
-/**
- * Type declarations for `@tonydua/dsh-web-search-exa`.
- * @module @tonydua/dsh-web-search-exa
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { WebSearchProvider } from '@deepseek-ai/dsh-web';
-
-/** Config schema type (fields are optional at the load boundary). */
-export interface ExaSearchProviderConfig {
-	/** Provider id registered into `ctx.web`; defaults to `exa`. */
-	providerId?: string;
-	/** Literal Exa API key; empty/missing enables the anonymous MCP path. */
-	apiKey?: string;
-	/** Environment variable consulted when no literal `apiKey` is configured. */
-	apiKeyEnv?: string;
-	/** Exa API base URL; `/search` is appended for the keyed REST path. */
-	baseURL?: string;
-	/** @deprecated Use `baseURL`; this full endpoint remains supported for compatibility. */
-	apiURL?: string;
-	/** Exa hosted MCP endpoint, used by the anonymous fallback. */
-	mcpURL?: string;
-	/** REST retrieval mode: `auto`, `keyword`, or `neural`. */
-	searchType?: 'auto' | 'keyword' | 'neural';
-	/** Default result count when the request carries no `maxResults`. */
-	numResults?: number;
-	/** Highlight sentences requested per result on the REST path. */
-	highlightsPerResult?: number;
-}
-
-/** Fully resolved options accepted by the provider constructor. */
-export interface ExaSearchProviderOptions {
-	providerId?: string;
-	apiKey: string;
-	apiKeyEnv: string;
-	baseURL: string;
-	apiURL?: string;
-	mcpURL: string;
-	searchType: 'auto' | 'keyword' | 'neural';
-	numResults?: number;
-	highlightsPerResult: number;
-}
-
-/** The Exa-backed provider with anonymous MCP fallback. */
-export class ExaSearchProvider implements WebSearchProvider {
-	readonly id: string;
-	constructor(
-		resolveOptions: () => ExaSearchProviderOptions,
-		resolveApiKey?: (options: ExaSearchProviderOptions) => string | undefined,
-	);
-	available(): boolean;
-	search(request: { query: string; maxResults?: number }, signal?: AbortSignal): Promise<{
-		sources: ReadonlyArray<{ url: string; title?: string; snippet?: string; publishedAt?: string }>;
-		truncated: boolean;
-	}>;
-}
-
-/** Cordis plugin name used by loader diagnostics. */
-export const name: string;
-/** The web seam this provider registers into. */
-export const inject: readonly ['web'];
-/** Config schema (schemastery). */
-export const Config: import('@deepseek-ai/schemastery').Schema<ExaSearchProviderConfig>;
-/** Settings namespace for the Web panel section. */
-export const SETTINGS_NAMESPACE: string;
-/** Default Exa API base URL; `/search` is appended. */
-export const DEFAULT_BASE_URL: string;
-/** Legacy default full REST endpoint. */
-export const DEFAULT_API_URL: string;
-/** Register the Exa search provider with `ctx.web` and install its Settings section. */
-export function apply(ctx: Context, config: ExaSearchProviderConfig): void;