dsh-plugin-subscriptions 0.2.0 → 0.3.0

package/README.md

@@ -14,6 +14,10 @@ Logged-in providers join the session model picker with their live model catalogs
 
 ![Model picker with subscription models](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/model-picker.png)
 
+Models that advertise reasoning levels get an **Effort** selector in the same menu — Codex models, and Grok 4.6 / 4.5 (levels and defaults come from each provider's live catalog, not a hardcoded list):
+
+![Reasoning effort selector](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/model-effort.png)
+
 The `image_generate` tool renders its result inline in the conversation:
 
 ![image_generate renders the image inline](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/image-generate-inline.png)
@@ -24,7 +28,7 @@ The `image_generate` tool renders its result inline in the conversation:
 |----------|-------------------|--------|
 | `codex`  | ChatGPT Plus/Pro  | live catalog from `chatgpt.com/backend-api/codex/models` |
 | `claude` | Claude Pro/Max    | claude-opus-4-5, claude-sonnet-4-5, claude-haiku-4-5 |
-| `grok`   | X Premium (xAI)   | live catalog from `api.x.ai/v1/models` (chat models only) |
+| `grok`   | X Premium (xAI)   | live catalog from `api.x.ai/v1/models` (chat models only); reasoning efforts from the Grok CLI catalog (`cli-chat-proxy.grok.com/v1/models`) |
 
 Only logged-in providers appear in the session model picker; the lists above refresh on login/logout. Vision-capable models declare `['text', 'image']` input modalities, and image content is translated to each provider's wire format.
 
@@ -73,6 +77,18 @@ cp overlay.example.yml overlay.yml   # then edit the name: to this checkout's ab
 dsh --profile headless --patch <checkout>/overlay.yml "your task"
 ```
 
+## Update
+
+Installed from npm:
+
+```sh
+dsh plugin --profile web update --latest dsh-plugin-subscriptions
+```
+
+Installed from GitHub: re-run the same `add github:V1ki/dsh-plugin-subscriptions` command — it re-fetches the sources and rebuilds. A linked local checkout just needs `git pull && pnpm build` in the checkout.
+
+Either way, restart `dsh web` afterwards so the new version loads.
+
 ## Use
 
 1. `dsh web`, open the printed URL.

package/README.zh.md

@@ -14,6 +14,10 @@
 
 ![模型选择器中的订阅模型](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/model-picker.png)
 
+声明了推理等级的模型会在同一菜单里多出**推理等级**选择 —— Codex 系列模型,以及 Grok 4.6 / 4.5(档位和默认值来自各 provider 的实时目录,不是硬编码列表):
+
+![推理等级选择器](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/model-effort.png)
+
 `image_generate` 工具生成的图片直接内联显示在对话里:
 
 ![image_generate 内联显示生成的图片](https://raw.githubusercontent.com/V1ki/dsh-plugin-subscriptions/main/docs/images/image-generate-inline.png)
@@ -24,7 +28,7 @@
 |----------|------------------|------|
 | `codex`  | ChatGPT Plus/Pro | 从 `chatgpt.com/backend-api/codex/models` 实时获取 |
 | `claude` | Claude Pro/Max   | claude-opus-4-5、claude-sonnet-4-5、claude-haiku-4-5 |
-| `grok`   | X Premium (xAI)  | 从 `api.x.ai/v1/models` 实时获取(仅对话模型) |
+| `grok`   | X Premium (xAI)  | 从 `api.x.ai/v1/models` 实时获取(仅对话模型);推理等级来自 Grok CLI 目录(`cli-chat-proxy.grok.com/v1/models`) |
 
 只有已登录的 provider 才会出现在会话模型选择器里;登录/退出后列表自动刷新。支持视觉的模型会声明 `['text', 'image']` 输入模态,图片内容会被翻译成各 provider 的 wire 格式。
 
@@ -73,6 +77,18 @@ cp overlay.example.yml overlay.yml   # 然后把 name: 改成本检出的 lib/in
 dsh --profile headless --patch <检出目录>/overlay.yml "你的任务"
 ```
 
+## 更新
+
+npm 安装的:
+
+```sh
+dsh plugin --profile web update --latest dsh-plugin-subscriptions
+```
+
+GitHub 安装的:重新执行一遍 `add github:V1ki/dsh-plugin-subscriptions` —— 会重新拉取源码并构建。link 的本地检出只需在检出目录里 `git pull && pnpm build`。
+
+无论哪种方式,更新后都要重启 `dsh web` 才会加载新版本。
+
 ## 使用
 
 1. `dsh web`,打开打印的 URL。

package/lib/index.js

@@ -2439,6 +2439,58 @@ function grokModalities(id) {
 	return /code|embed/i.test(id) ? ["text"] : ["text", "image"];
 }
 /**
+* The Grok Build CLI chat proxy's model catalog — the only grok endpoint that
+* advertises reasoning capability. The `api.x.ai/v1/models` and
+* `/v1/language-models` payloads carry pricing, context, and aliases only, so
+* effort metadata must come from here (the same source the official CLI's
+* picker uses).
+*/
+const GROK_CLI_MODELS_URL = "https://cli-chat-proxy.grok.com/v1/models";
+/** Map one CLI catalog entry's reasoning fields, or undefined when unsupported. */
+function grokCliReasoning(entry) {
+	if (entry.supports_reasoning_effort !== true) return void 0;
+	const efforts = (entry.reasoning_efforts ?? []).filter((level) => typeof level.value === "string" && level.value.length > 0).map((level) => ({
+		id: ReasoningEffortId(level.value),
+		name: typeof level.label === "string" && level.label.length > 0 ? level.label : level.value,
+		...typeof level.description === "string" && level.description.length > 0 ? { description: level.description } : {}
+	}));
+	if (efforts.length === 0) return void 0;
+	const defaultEffort = typeof entry.reasoning_effort === "string" && efforts.some((effort) => effort.id === ReasoningEffortId(entry.reasoning_effort)) ? ReasoningEffortId(entry.reasoning_effort) : void 0;
+	return {
+		efforts,
+		...defaultEffort === void 0 ? {} : { defaultEffort }
+	};
+}
+/**
+* Fetch the CLI catalog and index its per-model metadata by model id.
+* @param session - the stored session (used as-is; never refreshed here).
+* @param fetchFn - fetch implementation (injectable for tests).
+* @returns model id → contributed metadata.
+*/
+async function fetchGrokCliCatalog(session, fetchFn = fetch) {
+	const response = await fetchFn(GROK_CLI_MODELS_URL, { headers: {
+		"authorization": `Bearer ${session.accessToken}`,
+		"x-xai-token-auth": "xai-grok-cli",
+		"accept": "application/json",
+		...attributionHeaders()
+	} });
+	if (!response.ok) throw await oauthEndpointError(response, "grok CLI catalog");
+	const payload = await response.json();
+	if (!Array.isArray(payload.data)) throw new Error("grok CLI catalog returned no data array");
+	const catalog = /* @__PURE__ */ new Map();
+	for (const entry of payload.data) {
+		if (typeof entry.id !== "string" || entry.id.length === 0) continue;
+		const reasoning = grokCliReasoning(entry);
+		catalog.set(entry.id, {
+			...typeof entry.name === "string" && entry.name.length > 0 ? { name: entry.name } : {},
+			...typeof entry.description === "string" && entry.description.length > 0 ? { description: entry.description } : {},
+			...typeof entry.context_window === "number" && entry.context_window > 0 ? { contextWindow: entry.context_window } : {},
+			...reasoning === void 0 ? {} : { reasoning }
+		});
+	}
+	return catalog;
+}
+/**
 * The /v1/models list also serves generation models that cannot chat
 * (grok-imagine-image*, grok-imagine-video*) and embedding models; the picker
 * must not offer them. Heuristic over the id substring, verified against the
@@ -2448,17 +2500,24 @@ function isChatModel(id) {
 	return !/imagine|image-|video|embed/i.test(id);
 }
 /**
-* Fetch the live grok model list.
+* Fetch the live grok model list, enriched with the CLI catalog's per-model
+* metadata (display name, context window, reasoning efforts). The api.x.ai
+* list stays authoritative for which models exist; the CLI catalog is
+* enrichment only, so its failure degrades to a plain list instead of taking
+* discovery down — models it does not cover simply expose no efforts.
 * @param session - the stored session (used as-is; never refreshed here).
 * @param fetchFn - fetch implementation (injectable for tests).
-* @returns discovered chat models in endpoint order (id doubles as the name).
+* @param onWarn - warning sink for a failed CLI catalog fetch.
+* @returns discovered chat models in endpoint order.
 */
-async function fetchGrokModels(session, fetchFn = fetch) {
-	const response = await fetchFn(GROK_MODELS_URL, { headers: {
+async function fetchGrokModels(session, fetchFn = fetch, onWarn) {
+	const [response, cliCatalog] = await Promise.all([fetchFn(GROK_MODELS_URL, { headers: {
 		"authorization": `Bearer ${session.accessToken}`,
 		"accept": "application/json",
 		...attributionHeaders()
-	} });
+	} }), fetchGrokCliCatalog(session, fetchFn).catch((error) => {
+		onWarn?.(`grok CLI catalog fetch failed; reasoning efforts are unavailable (${errorChain(error)})`);
+	})]);
 	if (!response.ok) throw await oauthEndpointError(response, "grok models");
 	const payload = await response.json();
 	if (!Array.isArray(payload.data)) throw new Error("grok models endpoint returned no data array");
@@ -2470,7 +2529,8 @@ async function fetchGrokModels(session, fetchFn = fetch) {
 		seen.add(entry.id);
 		discovered.push({
 			id: entry.id,
-			name: entry.id
+			name: entry.id,
+			...cliCatalog?.get(entry.id)
 		});
 	}
 	if (discovered.length === 0) throw new Error("grok models endpoint returned an empty catalog");
@@ -2501,10 +2561,11 @@ var GrokAdapter = class extends LlmAdapter {
 		if (await this.options.tokens.peek() === void 0) return [];
 		if (!this.options.discovery) return this.staticModels(provider);
 		try {
-			return (await this.catalog.get(async () => fetchGrokModels(await this.options.tokens.session(), this.options.fetchFn))).map((model) => ({
+			return (await this.catalog.get(async () => fetchGrokModels(await this.options.tokens.session(), this.options.fetchFn, this.options.onWarn))).map((model) => ({
 				provider,
 				id: model.id,
 				name: model.name,
+				...model.description === void 0 ? {} : { description: model.description },
 				inputModalities: grokModalities(model.id)
 			}));
 		} catch (error) {
@@ -2521,9 +2582,11 @@ var GrokAdapter = class extends LlmAdapter {
 			provider,
 			id: model,
 			name: discovered?.name ?? configured?.name ?? model,
+			...discovered?.description === void 0 ? {} : { description: discovered.description },
 			inputModalities: configured?.inputModalities ?? grokModalities(model),
-			context: { contextWindow: configured?.contextWindow ?? GROK_CONTEXT_WINDOW },
-			defaultMaxTokens: configured?.maxTokens ?? GROK_DEFAULT_MAX_TOKENS
+			context: { contextWindow: discovered?.contextWindow ?? configured?.contextWindow ?? GROK_CONTEXT_WINDOW },
+			defaultMaxTokens: configured?.maxTokens ?? GROK_DEFAULT_MAX_TOKENS,
+			...discovered?.reasoning === void 0 ? {} : { reasoning: discovered.reasoning }
 		});
 	}
 	async *stream(options) {
@@ -2556,6 +2619,7 @@ var GrokAdapter = class extends LlmAdapter {
 			tool_choice: "auto",
 			parallel_tool_calls: true,
 			...options.maxTokens !== void 0 ? { max_output_tokens: options.maxTokens } : {},
+			...options.reasoningEffort !== void 0 ? { reasoning: { effort: String(options.reasoningEffort) } } : {},
 			store: false,
 			stream: true
 		};

package/lib/providers/grok.d.ts

@@ -80,12 +80,34 @@ export declare const GROK_BILLING_URL = "https://cli-chat-proxy.grok.com/v1/bill
 export declare function fetchGrokUsage(session: GrokSession, fetchFn?: FetchFn, signal?: AbortSignal): Promise<ProviderUsage>;
 export declare const GROK_MODELS_URL = "https://api.x.ai/v1/models";
 /**
- * Fetch the live grok model list.
+ * The Grok Build CLI chat proxy's model catalog — the only grok endpoint that
+ * advertises reasoning capability. The `api.x.ai/v1/models` and
+ * `/v1/language-models` payloads carry pricing, context, and aliases only, so
+ * effort metadata must come from here (the same source the official CLI's
+ * picker uses).
+ */
+export declare const GROK_CLI_MODELS_URL = "https://cli-chat-proxy.grok.com/v1/models";
+/** Per-model metadata the CLI catalog contributes to a discovered model. */
+type GrokCliModelMeta = Partial<Pick<DiscoveredModel, 'name' | 'description' | 'contextWindow' | 'reasoning'>>;
+/**
+ * Fetch the CLI catalog and index its per-model metadata by model id.
+ * @param session - the stored session (used as-is; never refreshed here).
+ * @param fetchFn - fetch implementation (injectable for tests).
+ * @returns model id → contributed metadata.
+ */
+export declare function fetchGrokCliCatalog(session: GrokSession, fetchFn?: FetchFn): Promise<Map<string, GrokCliModelMeta>>;
+/**
+ * Fetch the live grok model list, enriched with the CLI catalog's per-model
+ * metadata (display name, context window, reasoning efforts). The api.x.ai
+ * list stays authoritative for which models exist; the CLI catalog is
+ * enrichment only, so its failure degrades to a plain list instead of taking
+ * discovery down — models it does not cover simply expose no efforts.
  * @param session - the stored session (used as-is; never refreshed here).
  * @param fetchFn - fetch implementation (injectable for tests).
- * @returns discovered chat models in endpoint order (id doubles as the name).
+ * @param onWarn - warning sink for a failed CLI catalog fetch.
+ * @returns discovered chat models in endpoint order.
  */
-export declare function fetchGrokModels(session: GrokSession, fetchFn?: FetchFn): Promise<DiscoveredModel[]>;
+export declare function fetchGrokModels(session: GrokSession, fetchFn?: FetchFn, onWarn?: (message: string) => void): Promise<DiscoveredModel[]>;
 /** Constructor dependencies for {@link GrokAdapter}. */
 export interface GrokAdapterOptions {
     models: readonly ModelEntry[];
@@ -112,3 +134,4 @@ export declare class GrokAdapter extends LlmAdapter {
     stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
     private request;
 }
+export {};

package/lib/providers/grok.js

@@ -3,7 +3,7 @@
  * auth.x.ai with the Grok CLI client id, and streaming against the xAI
  * Responses-style endpoint.
  */
-import { attributionHeaders, EMPTY_RESPONSE_CODE, errorChain, LlmAdapter, LlmError } from '@deepseek-ai/dsh-llm';
+import { attributionHeaders, EMPTY_RESPONSE_CODE, errorChain, LlmAdapter, LlmError, ReasoningEffortId } from '@deepseek-ai/dsh-llm';
 import { decodeJwtPayload } from '../auth/jwt.js';
 import { resolveImages } from '../translate/resolved.js';
 import { streamResponses, toResponsesInput, toResponsesTools } from '../translate/responses.js';
@@ -276,28 +276,110 @@ function grokModalities(id) {
     return /code|embed/i.test(id) ? ['text'] : ['text', 'image'];
 }
 /**
- * The /v1/models list also serves generation models that cannot chat
- * (grok-imagine-image*, grok-imagine-video*) and embedding models; the picker
- * must not offer them. Heuristic over the id substring, verified against the
- * live catalog (grok-build-0.1 and the grok-4 family pass).
+ * The Grok Build CLI chat proxy's model catalog — the only grok endpoint that
+ * advertises reasoning capability. The `api.x.ai/v1/models` and
+ * `/v1/language-models` payloads carry pricing, context, and aliases only, so
+ * effort metadata must come from here (the same source the official CLI's
+ * picker uses).
  */
-function isChatModel(id) {
-    return !/imagine|image-|video|embed/i.test(id);
+export const GROK_CLI_MODELS_URL = 'https://cli-chat-proxy.grok.com/v1/models';
+/** Map one CLI catalog entry's reasoning fields, or undefined when unsupported. */
+function grokCliReasoning(entry) {
+    if (entry.supports_reasoning_effort !== true)
+        return undefined;
+    const efforts = (entry.reasoning_efforts ?? [])
+        .filter(level => typeof level.value === 'string' && level.value.length > 0)
+        .map(level => ({
+        id: ReasoningEffortId(level.value),
+        name: typeof level.label === 'string' && level.label.length > 0 ? level.label : level.value,
+        ...typeof level.description === 'string' && level.description.length > 0
+            ? { description: level.description }
+            : {},
+    }));
+    if (efforts.length === 0)
+        return undefined;
+    // The per-entry `default` flags are unreliable (the live catalog marks
+    // several levels default at once), so the top-level `reasoning_effort`
+    // field is the trusted default.
+    const defaultEffort = typeof entry.reasoning_effort === 'string'
+        && efforts.some(effort => effort.id === ReasoningEffortId(entry.reasoning_effort))
+        ? ReasoningEffortId(entry.reasoning_effort)
+        : undefined;
+    return { efforts, ...defaultEffort === undefined ? {} : { defaultEffort } };
 }
 /**
- * Fetch the live grok model list.
+ * Fetch the CLI catalog and index its per-model metadata by model id.
  * @param session - the stored session (used as-is; never refreshed here).
  * @param fetchFn - fetch implementation (injectable for tests).
- * @returns discovered chat models in endpoint order (id doubles as the name).
+ * @returns model id → contributed metadata.
  */
-export async function fetchGrokModels(session, fetchFn = fetch) {
-    const response = await fetchFn(GROK_MODELS_URL, {
+export async function fetchGrokCliCatalog(session, fetchFn = fetch) {
+    const response = await fetchFn(GROK_CLI_MODELS_URL, {
         headers: {
             'authorization': `Bearer ${session.accessToken}`,
+            // The proxy only honors bearer tokens presented as the Grok CLI.
+            'x-xai-token-auth': 'xai-grok-cli',
             'accept': 'application/json',
             ...attributionHeaders(),
         },
     });
+    if (!response.ok)
+        throw await oauthEndpointError(response, 'grok CLI catalog');
+    const payload = await response.json();
+    if (!Array.isArray(payload.data))
+        throw new Error('grok CLI catalog returned no data array');
+    const catalog = new Map();
+    for (const entry of payload.data) {
+        if (typeof entry.id !== 'string' || entry.id.length === 0)
+            continue;
+        const reasoning = grokCliReasoning(entry);
+        catalog.set(entry.id, {
+            ...typeof entry.name === 'string' && entry.name.length > 0 ? { name: entry.name } : {},
+            ...typeof entry.description === 'string' && entry.description.length > 0
+                ? { description: entry.description }
+                : {},
+            ...typeof entry.context_window === 'number' && entry.context_window > 0
+                ? { contextWindow: entry.context_window }
+                : {},
+            ...reasoning === undefined ? {} : { reasoning },
+        });
+    }
+    return catalog;
+}
+/**
+ * The /v1/models list also serves generation models that cannot chat
+ * (grok-imagine-image*, grok-imagine-video*) and embedding models; the picker
+ * must not offer them. Heuristic over the id substring, verified against the
+ * live catalog (grok-build-0.1 and the grok-4 family pass).
+ */
+function isChatModel(id) {
+    return !/imagine|image-|video|embed/i.test(id);
+}
+/**
+ * Fetch the live grok model list, enriched with the CLI catalog's per-model
+ * metadata (display name, context window, reasoning efforts). The api.x.ai
+ * list stays authoritative for which models exist; the CLI catalog is
+ * enrichment only, so its failure degrades to a plain list instead of taking
+ * discovery down — models it does not cover simply expose no efforts.
+ * @param session - the stored session (used as-is; never refreshed here).
+ * @param fetchFn - fetch implementation (injectable for tests).
+ * @param onWarn - warning sink for a failed CLI catalog fetch.
+ * @returns discovered chat models in endpoint order.
+ */
+export async function fetchGrokModels(session, fetchFn = fetch, onWarn) {
+    const [response, cliCatalog] = await Promise.all([
+        fetchFn(GROK_MODELS_URL, {
+            headers: {
+                'authorization': `Bearer ${session.accessToken}`,
+                'accept': 'application/json',
+                ...attributionHeaders(),
+            },
+        }),
+        fetchGrokCliCatalog(session, fetchFn).catch((error) => {
+            onWarn?.(`grok CLI catalog fetch failed; reasoning efforts are unavailable (${errorChain(error)})`);
+            return undefined;
+        }),
+    ]);
     if (!response.ok)
         throw await oauthEndpointError(response, 'grok models');
     const payload = await response.json();
@@ -311,7 +393,7 @@ export async function fetchGrokModels(session, fetchFn = fetch) {
         if (!isChatModel(entry.id))
             continue;
         seen.add(entry.id);
-        discovered.push({ id: entry.id, name: entry.id });
+        discovered.push({ id: entry.id, name: entry.id, ...cliCatalog?.get(entry.id) });
     }
     // An empty catalog from a 200 response is treated as a discovery failure so
     // the adapter falls back to the static catalog instead of vanishing from
@@ -350,11 +432,12 @@ export class GrokAdapter extends LlmAdapter {
             // The fetcher runs only on a cache miss, and resolves the session
             // through the refresh-aware path so an expired access token renews here
             // instead of failing discovery into the static fallback.
-            const discovered = await this.catalog.get(async () => fetchGrokModels(await this.options.tokens.session(), this.options.fetchFn));
+            const discovered = await this.catalog.get(async () => fetchGrokModels(await this.options.tokens.session(), this.options.fetchFn, this.options.onWarn));
             return discovered.map(model => ({
                 provider,
                 id: model.id,
                 name: model.name,
+                ...model.description === undefined ? {} : { description: model.description },
                 inputModalities: grokModalities(model.id),
             }));
         }
@@ -379,10 +462,14 @@ export class GrokAdapter extends LlmAdapter {
             provider,
             id: model,
             name: discovered?.name ?? configured?.name ?? model,
+            ...discovered?.description === undefined ? {} : { description: discovered.description },
             inputModalities: configured?.inputModalities ?? grokModalities(model),
-            context: { contextWindow: configured?.contextWindow ?? GROK_CONTEXT_WINDOW },
+            context: { contextWindow: discovered?.contextWindow ?? configured?.contextWindow ?? GROK_CONTEXT_WINDOW },
             defaultMaxTokens: configured?.maxTokens ?? GROK_DEFAULT_MAX_TOKENS,
-            // No reasoning metadata: effort selection is not exposed for grok.
+            // Efforts come from the discovered CLI catalog; models it does not
+            // cover expose none, so the harness rejects explicit efforts before
+            // provider I/O instead of the API 400ing.
+            ...discovered?.reasoning === undefined ? {} : { reasoning: discovered.reasoning },
         });
     }
     async *stream(options) {
@@ -422,6 +509,11 @@ export class GrokAdapter extends LlmAdapter {
             tool_choice: 'auto',
             parallel_tool_calls: true,
             ...options.maxTokens !== undefined ? { max_output_tokens: options.maxTokens } : {},
+            // The harness only passes an effort the resolved model advertised (the
+            // CLI catalog's), so this never reaches a model that rejects it.
+            ...options.reasoningEffort !== undefined
+                ? { reasoning: { effort: String(options.reasoningEffort) } }
+                : {},
             store: false,
             stream: true,
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-subscriptions",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Use ChatGPT (Codex), Claude, and Grok (X Premium) subscriptions as DeepSeek Harness LLM providers, with OAuth login from the web Settings page",
   "license": "MIT",
   "repository": {
@@ -48,12 +48,6 @@
       ]
     }
   },
-  "scripts": {
-    "build": "tsc && tsdown",
-    "test": "tsc -p tsconfig.test.json && node --test lib-test/test/",
-    "prepare": "tsdown -c tsdown.prepare.config.ts",
-    "prepublishOnly": "pnpm build && pnpm test"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-attachment": "^0.1.0-rc.5",
@@ -81,5 +75,9 @@
     "react": "^18.2.0",
     "tsdown": "^0.15.0",
     "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "tsc && tsdown",
+    "test": "tsc -p tsconfig.test.json && node --test lib-test/test/"
   }
-}
+}