@dsh-enhanced/llm-route-capabilities 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-enhanced contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @dsh-enhanced/llm-route-capabilities
+
+普通、非激活型 TypeScript 库，用于把 provider/model 的工具调用能力声明附着到一个精确的 DSH `LlmRuntime` 实例。它不声明 `dsh.bundle`，也不会向 profile 注入任何 Cordis patch。
+
+能力分为 `none`（不能接收 DSH tools）、`native`（原生 tool-call stream）和 `bridge`（由 provider 的受约束协议桥接为 DSH tool calls）。精确 model 声明覆盖 provider 声明；重复 selector 会失败，卸载 disposer 只撤回自己注册的声明。

package/lib/index.d.ts

@@ -0,0 +1,19 @@
+import type { LlmRuntime } from '@deepseek-ai/dsh-llm';
+import { version } from './version.js';
+export type ToolCallMode = 'none' | 'native' | 'bridge';
+export interface LlmRouteCapabilityDeclaration {
+    readonly provider: string;
+    readonly model?: string;
+    readonly toolCalls: ToolCallMode;
+}
+export type LlmRouteCapabilityDisposer = () => void;
+/**
+ * Attach one audited capability declaration to exactly one live LLM runtime.
+ * A selector has a single owner; even an identical duplicate is rejected so
+ * plugin unload cannot make another plugin's declaration disappear.
+ */
+export declare function registerLlmRouteCapability(runtime: LlmRuntime, input: LlmRouteCapabilityDeclaration): LlmRouteCapabilityDisposer;
+/** Resolve the exact-model declaration first, then the provider-wide fallback. */
+export declare function resolveLlmRouteCapability(runtime: LlmRuntime, provider: string, model: string): Readonly<LlmRouteCapabilityDeclaration> | undefined;
+export { version };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEvD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;CACjC;AAED,MAAM,MAAM,0BAA0B,GAAG,MAAM,IAAI,CAAA;AA2EnD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,6BAA6B,GACnC,0BAA0B,CAsB5B;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,6BAA6B,CAAC,GAAG,SAAS,CAIrD;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/lib/index.js

@@ -0,0 +1,97 @@
+import { version } from './version.js';
+const registrySymbol = Symbol.for('@dsh-enhanced/llm-route-capabilities/runtime-registry/v1');
+const providerPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,255}$/u;
+const modes = new Set(['none', 'native', 'bridge']);
+function registryTarget(runtime) {
+    return runtime;
+}
+function validState(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return candidate.schemaVersion === 1
+        && candidate.providers instanceof Map
+        && candidate.models instanceof Map;
+}
+function registry(runtime, create) {
+    const target = registryTarget(runtime);
+    const existing = target[registrySymbol];
+    if (existing !== undefined) {
+        if (!validState(existing)) {
+            throw new Error('llm-route-capabilities: incompatible registry is already attached to this LlmRuntime');
+        }
+        return existing;
+    }
+    if (!create)
+        return undefined;
+    const state = {
+        schemaVersion: 1,
+        providers: new Map(),
+        models: new Map(),
+    };
+    Object.defineProperty(target, registrySymbol, {
+        value: state,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return state;
+}
+function normalize(input) {
+    if (!providerPattern.test(input.provider)) {
+        throw new Error('llm-route-capabilities: provider must be an exact non-empty provider id');
+    }
+    if (input.model !== undefined
+        && (input.model.length === 0 || input.model.length > 512 || /[\s\p{Cc}]/u.test(input.model))) {
+        throw new Error('llm-route-capabilities: model must be an exact non-empty model id');
+    }
+    if (!modes.has(input.toolCalls)) {
+        throw new Error('llm-route-capabilities: invalid tool-call mode');
+    }
+    return Object.freeze({
+        provider: input.provider,
+        ...(input.model === undefined ? {} : { model: input.model }),
+        toolCalls: input.toolCalls,
+    });
+}
+function modelKey(provider, model) {
+    return JSON.stringify([provider, model]);
+}
+/**
+ * Attach one audited capability declaration to exactly one live LLM runtime.
+ * A selector has a single owner; even an identical duplicate is rejected so
+ * plugin unload cannot make another plugin's declaration disappear.
+ */
+export function registerLlmRouteCapability(runtime, input) {
+    const declaration = normalize(input);
+    const state = registry(runtime, true);
+    const entries = declaration.model === undefined ? state.providers : state.models;
+    const key = declaration.model === undefined
+        ? declaration.provider
+        : modelKey(declaration.provider, declaration.model);
+    if (entries.has(key)) {
+        const selector = declaration.model === undefined
+            ? declaration.provider
+            : `${declaration.provider}/${declaration.model}`;
+        throw new Error(`llm-route-capabilities: duplicate route capability selector: ${selector}`);
+    }
+    const token = Symbol('llm-route-capability-registration');
+    entries.set(key, { declaration, token });
+    let disposed = false;
+    return () => {
+        if (disposed)
+            return;
+        disposed = true;
+        const current = entries.get(key);
+        if (current?.token === token)
+            entries.delete(key);
+    };
+}
+/** Resolve the exact-model declaration first, then the provider-wide fallback. */
+export function resolveLlmRouteCapability(runtime, provider, model) {
+    const state = registry(runtime, false);
+    return state?.models.get(modelKey(provider, model))?.declaration
+        ?? state?.providers.get(provider)?.declaration;
+}
+export { version };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "0.1.3";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/lib/version.js

@@ -0,0 +1,2 @@
+export const version = '0.1.3';
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@dsh-enhanced/llm-route-capabilities",
+  "version": "0.1.3",
+  "description": "Runtime-local LLM route capability declarations for DeepSeek Harness integrations.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/22-ai-00/dsh-enhanced.git",
+    "directory": "packages/llm-route-capabilities"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "llm",
+    "tool-calls"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.8 <0.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@types/node": "22.20.0",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}