@sequoiaport/codes 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sequoiaport
+
+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,262 @@
+# @sequoiaport/codes
+
+Official TypeScript/JavaScript SDK for the [Sequoia Codes API](https://sequoiacodes.com) — a unified API for medical code search and lookup.
+
+Query **ICD-10**, **CPT**, **HCPCS**, **SNOMED CT**, **LOINC**, and **RxNorm** codes through a single client. The SDK also covers **LCD/NCD** coverage guidelines and a **clinical orchestrator** for cross-system operations like coverage checks and diagnosis-to-procedure mapping.
+
+- Fully typed with Zod-validated responses
+- Supports both ESM and CommonJS
+- Includes [agent skills](https://skills.sh) for AI coding assistants
+
+## Installation
+
+```bash
+npm install @sequoiaport/codes
+```
+
+## Quick Start
+
+```typescript
+import { SequoiaCodesClient } from "@sequoiaport/codes";
+
+const client = new SequoiaCodesClient({
+  apiKey: process.env.SEQUOIA_CODES_API_KEY!,
+});
+
+// Search for ICD-10 codes
+const icd10Results = await client.icd10.searchCode({ query: "diabetes type 2" });
+console.log(icd10Results.results);
+
+// Look up a specific SNOMED code
+const snomedCode = await client.snomed.identifyCode({ code: "73211009" });
+console.log(snomedCode.concept);
+
+// Search for CPT procedures
+const cptResults = await client.cpt.searchCode({ query: "knee replacement" });
+console.log(cptResults.results);
+```
+
+## API Categories
+
+### Coding Systems
+
+- **`client.snomed`** - SNOMED CT clinical terminology
+- **`client.icd10`** - ICD-10 diagnosis codes
+- **`client.cpt`** - CPT procedure codes
+- **`client.hcpcs`** - HCPCS procedure codes
+- **`client.loinc`** - LOINC laboratory test codes
+- **`client.rxnorm`** - RxNorm drug/medication codes
+
+### Guidelines
+
+- **`client.lcd`** - Local Coverage Determinations
+- **`client.ncd`** - National Coverage Determinations
+
+### Orchestrators
+
+- **`client.clinical`** - Cross-engine clinical operations
+- **`client.system`** - System health and async results
+
+## Examples
+
+### SNOMED
+
+```typescript
+// Hybrid search
+const results = await client.snomed.searchCode({
+  query: "heart failure",
+  limit: 10,
+});
+
+// Lookup by code
+const concept = await client.snomed.identifyCode({ code: "84114007" });
+```
+
+### ICD-10
+
+```typescript
+// Search with billing filter
+const results = await client.icd10.searchCode({
+  query: "diabetes",
+  billingOnly: true,
+  limit: 20,
+});
+
+// Lookup specific code
+const code = await client.icd10.identifyCode({ code: "E11.9" });
+
+// Get all chapters
+const chapters = await client.icd10.getChapters();
+```
+
+### CPT/HCPCS
+
+```typescript
+// Search CPT codes
+const cptResults = await client.cpt.searchCode({ query: "colonoscopy" });
+
+// Get cost/RVU data
+const cost = await client.cpt.getCost({ code: "45378" });
+
+// Get ICD-10 linking terms
+const linkTerms = await client.cpt.linkIcd10({ code: "99213" });
+
+// Search HCPCS codes
+const hcpcsResults = await client.hcpcs.searchCode({ query: "wheelchair" });
+```
+
+### LOINC
+
+```typescript
+// Search lab tests
+const results = await client.loinc.searchCode({ query: "glucose" });
+
+// Lookup specific code
+const test = await client.loinc.identifyCode({ code: "2345-7" });
+
+// Get panel members
+const panel = await client.loinc.getPanelMembers({ code: "24323-8" });
+```
+
+### RxNorm
+
+```typescript
+// Search drugs
+const results = await client.rxnorm.searchCode({ query: "metformin" });
+
+// Lookup by NDC
+const ndcResult = await client.rxnorm.identifyCode({
+  type: "ndc",
+  code: "0002-4112-01",
+});
+
+// Lookup by RXCUI
+const rxcuiResult = await client.rxnorm.identifyCode({
+  type: "rxcui",
+  code: "861004",
+});
+
+// Get active ingredients
+const ingredients = await client.rxnorm.getIngredients({ rxcui: "861004" });
+```
+
+### Guidelines (LCD/NCD)
+
+```typescript
+// Search LCD guidelines
+const lcdResults = await client.lcd.searchGuidelines({ query: "MRI" });
+
+// Lookup specific LCD
+const lcd = await client.lcd.identifyGuideline({ id: "L33288" });
+
+// Search NCD guidelines
+const ncdResults = await client.ncd.searchGuidelines({ query: "oxygen" });
+
+// Lookup NCD by section
+const ncd = await client.ncd.identifyGuideline({ section: "220.6" });
+```
+
+### Clinical Orchestrator
+
+```typescript
+// Check coverage for CPT + ICD-10 pair
+const coverage = await client.clinical.checkCoverage({
+  cpt_code: "99213",
+  icd10_code: "E11.9",
+});
+
+// Map diagnosis to procedures
+const procedures = await client.clinical.getProceduresForDiagnosis({
+  icd10_code: "M17.11",
+});
+
+// Get metadata from all engines
+const metadata = await client.clinical.getMetadata();
+```
+
+### System
+
+```typescript
+// Health check
+const health = await client.system.health();
+
+// Get async result
+const result = await client.system.getResult({ request_id: "abc123" });
+```
+
+## Configuration
+
+```typescript
+const client = new SequoiaCodesClient({
+  apiKey: "your-api-key",
+  baseUrl: "https://api.sequoiacodes.com", // optional
+  version: "v1", // optional
+});
+```
+
+## Error Handling
+
+```typescript
+import { SequoiaCodesClient, CodesApiError } from "@sequoiaport/codes";
+
+try {
+  const result = await client.icd10.searchCode({ query: "test" });
+} catch (error) {
+  if (error instanceof CodesApiError) {
+    console.error(`API Error ${error.status}: ${error.message}`);
+    console.error(`Action: ${error.action}`);
+  }
+}
+```
+
+## TypeScript Support
+
+All methods are fully typed. Import types as needed:
+
+```typescript
+import type {
+  SnomedConcept,
+  Icd10Code,
+  CPTCode,
+  LoincCode,
+  RxnormDrug,
+} from "@sequoiaport/codes";
+```
+
+## Agent Skills
+
+This SDK includes agent skills compatible with the [Vercel Agent Skills](https://skills.sh) ecosystem. Skills give AI coding agents the knowledge to use the Sequoia Codes SDK for medical coding tasks.
+
+### Install Skills
+
+```bash
+# Install all skills from this repo
+npx skills add @sequoiaport/codes
+
+# Or install individual skills
+npx skills add @sequoiaport/codes/medical-codes
+npx skills add @sequoiaport/codes/icd10-codes
+npx skills add @sequoiaport/codes/cpt-codes
+npx skills add @sequoiaport/codes/snomed-codes
+npx skills add @sequoiaport/codes/hcpcs-codes
+npx skills add @sequoiaport/codes/loinc-codes
+npx skills add @sequoiaport/codes/rxnorm-codes
+```
+
+### Available Skills
+
+| Skill | Description |
+|-------|-------------|
+| `medical-codes` | Comprehensive skill covering all coding systems, guidelines, and clinical orchestration |
+| `icd10-codes` | ICD-10 diagnosis code search and lookup |
+| `cpt-codes` | CPT procedure code search, lookup, cost/RVU, and ICD-10 linking |
+| `snomed-codes` | SNOMED CT clinical terminology search and lookup |
+| `hcpcs-codes` | HCPCS Level II code search, lookup, and cost |
+| `loinc-codes` | LOINC laboratory test code search, lookup, and panel members |
+| `rxnorm-codes` | RxNorm drug code search, NDC/RXCUI lookup, and ingredients |
+
+Skills are compatible with Claude Code, Cursor, GitHub Copilot, Gemini, and [17+ other agents](https://skills.sh).
+
+## License
+
+MIT