@lowlysre/icd-10-cm 3.1.0 → 3.1.1

package/README.md

@@ -16,6 +16,7 @@ A data package containing the FY2027 ICD-10-CM diagnosis codes and descriptions
 - 🔒 Secure, a zero dependency package with provenance
 - ⚛️ Small, limited to CM (Clinical Modification) data and less than 1MB compressed
 - 🔏 Immutable, GitHub releases are locked and cannot be altered or replaced after publishing
+- 🔌 Offline, the full code set ships inside the package: no API keys, no rate limits, and no calls to government servers at runtime. It runs inside closed-loop healthcare systems that block outbound traffic or require a vendor review for every external API
 
 ## Install
 
@@ -60,6 +61,27 @@ ICD10_CM_RELEASE.effectiveDate; // "2026-10-01"
 ICD10_CM_RELEASE.codeCount; // 74879
 ```
 
+### Using with AI
+
+- Grounding AI output. Language models describe ICD-10-CM codes from memory, so they get laterality and severity wrong and invent descriptions for codes that don't exist. Check each model-produced code against the official set before showing or storing it.
+- Agent tools. Expose `getICD10Description` as a tool or function call, so an agent reads the official description instead of recalling one.
+
+```ts
+import { getICD10Description } from "@lowlysre/icd-10-cm";
+
+const modelCodes = ["E11.9", "H40.1131", "E11.99"];
+
+const checked = modelCodes.map((code) => ({
+  code,
+  description: getICD10Description(code) ?? null,
+}));
+// [
+//   { code: "E11.9", description: "Type 2 diabetes mellitus without complications" },
+//   { code: "H40.1131", description: "Primary open-angle glaucoma, bilateral, mild stage" },
+//   { code: "E11.99", description: null }, // not a real code
+// ]
+```
+
 ## API
 
 - `getICD10Description(code)` (also the default export) returns the description for a code, or `undefined` when the code isn't in the bundled release. Input is normalized first.
@@ -102,6 +124,7 @@ See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for setup and the yearly data upd
 
 ## Versions
 
+- v3.1.1 - README AI use cases (output grounding, agent tools), closed-loop offline use, `ai`, `llm`, and `offline` npm keywords
 - v3.1.0 - `ICD10_CM_RELEASE` export with the bundled fiscal year, effective date, and code count. Node.js 22+ declared in `engines`, `package.json` exported, expanded npm keywords. API, CDN, and versioning docs, plus contributing and security guides
 - v3.0.0 - Data updated to the October 1, 2026 ICD-10-CM release (74,879 codes, from the FY2027 set)
 - v2.0.0 - Data updated to the April 1, 2026 ICD-10-CM release (74,719 codes, from the FY2024 set). TypeScript 7 (native compiler) toolchain, ESLint replaced with oxlint + Prettier, dropped tsup for plain tsc (zero-bundler dual ESM/CJS), dataset shipped once and lazy-loaded (~50% smaller install, faster imports), fixed broken `require()` entry point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowlysre/icd-10-cm",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "FY2027 ICD-10-CM diagnosis codes and descriptions (CDC/NCHS, effective October 1, 2026) with TypeScript types and zero dependencies",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -68,6 +68,9 @@
     "nchs",
     "cms",
     "fhir",
+    "ai",
+    "llm",
+    "offline",
     "fy2027",
     "typescript"
   ],