hs-code-classifier-mcp 1.0.9 → 1.0.10

package/CHANGELOG.md

@@ -1,44 +1,60 @@
-# Changelog
-
-## [1.0.9] - 2026-06-02
-
-### Fixed
-- fix: IP extraction fixed for Cloudflare proxy headers — free tier gate now enforces correctly
-
-## [1.0.5] - 2026-04-28
-
-### Changed
-- Upgrade URLs updated to prepaid bundle payment links (500 calls, never expire)
-- Free tier limit messages updated: "Get 500 calls for $40 at [URL] -- calls never expire"
-- PRO_UPGRADE_URL and ENTERPRISE_UPGRADE_URL constants added to constants.ts
-
-## [1.0.4] - 2026-04-27
-
-### Added
-- `token_count` field on all tool responses — lets orchestrator budget ledgers track token cost per call
-- `/ready` endpoint — returns 200 when `ANTHROPIC_API_KEY` and `HSPING_API_KEY` are present, 503 otherwise
-- Phase 4 enhanced error objects: `category`, `retryable`, `retry_after_ms`, `fallback_tool`, `trace_id` on all error paths in classify and validate tools
-
-## [1.0.3] - 2026-04-26
-
-### Improved
-- hs_classify_product and hs_validate_code descriptions rewritten with TCO framework: irresistibility opening, $10k-$100k per-incident consequence, exact data source hostnames (api.hsping.com), prepaid bundle pricing last
-- LEGAL NOTICE and full terms added to both tool descriptions
-
-## [1.0.2] - 2026-04-26
-### Changed
-- VERSION constant unified to 1.0.2 across constants.ts, package.json, and server.json (were out of sync)
-- Added `source_url` field to ClassifyOutput and ValidateOutput response objects (mandatory per Section 7.7)
-
-## [1.0.0] - 2026-04-24
-
-### Added
-- Initial release
-- `hs_classify_product` tool: classify product descriptions to official HS codes using government tariff schedules (USITC, Singapore Customs, CBSA, Australia Border Force) via HSPing API with AI-assisted reasoning
-- `hs_validate_code` tool: validate supplier-provided HS codes against official schedules with AI mismatch detection (paid tier)
-- Free tier: 10 classify calls/month per IP, no API key required
-- Pro tier: full result set with confidence ranking on classify + full validate access
-- Both stdio and HTTP (Streamable) transports
-- /health, /deps, /stats, /webhook/stripe endpoints
-- Free tier quota tracking by IP with 80% warning and conversion hook
-- Stripe webhook integration for paid key provisioning
+# Changelog
+
+## [1.0.10] - 2026-06-04
+
+### Added
+- `src/services/redis.ts` — Upstash Redis helpers (redisGet, redisSet, redisExpire, redisKeys, appendSessionLog)
+- Free tier Redis persistence: `loadFreeTierFromRedis` / `saveFreeTierToRedis` with Math.max merge
+- API key Redis persistence: `saveKeyToRedis` / `loadApiKeysFromRedis` with prefix `hs` — first durable persistence for paid keys
+- `appendSessionLog` with 24h TTL; `/session-log` endpoint (requires x-stats-key)
+- `free_tier_breakdown` per-IP object on `/stats` response for current month
+- `getEffectiveLimit(ip)` — returns `FREE_TIER_MONTHLY_LIMIT + TRIAL_EXTENSION_CALLS` if IP has a trial extension
+- `FREE_TIER_REDIS_KEY = 'hs:free_tier_usage'` constant
+
+### Changed
+- `hs_classify_product` and `hs_validate_code` descriptions rewritten for orchestral agent runtime selection
+- `runClassify` accepts optional `effectiveLimit` parameter; notice string now includes effective limit
+- `VERSION` bumped to `1.0.10`
+
+## [1.0.9] - 2026-06-02
+
+### Fixed
+- fix: IP extraction fixed for Cloudflare proxy headers — free tier gate now enforces correctly
+
+## [1.0.5] - 2026-04-28
+
+### Changed
+- Upgrade URLs updated to prepaid bundle payment links (500 calls, never expire)
+- Free tier limit messages updated: "Get 500 calls for $40 at [URL] -- calls never expire"
+- PRO_UPGRADE_URL and ENTERPRISE_UPGRADE_URL constants added to constants.ts
+
+## [1.0.4] - 2026-04-27
+
+### Added
+- `token_count` field on all tool responses — lets orchestrator budget ledgers track token cost per call
+- `/ready` endpoint — returns 200 when `ANTHROPIC_API_KEY` and `HSPING_API_KEY` are present, 503 otherwise
+- Phase 4 enhanced error objects: `category`, `retryable`, `retry_after_ms`, `fallback_tool`, `trace_id` on all error paths in classify and validate tools
+
+## [1.0.3] - 2026-04-26
+
+### Improved
+- hs_classify_product and hs_validate_code descriptions rewritten with TCO framework: irresistibility opening, $10k-$100k per-incident consequence, exact data source hostnames (api.hsping.com), prepaid bundle pricing last
+- LEGAL NOTICE and full terms added to both tool descriptions
+
+## [1.0.2] - 2026-04-26
+### Changed
+- VERSION constant unified to 1.0.2 across constants.ts, package.json, and server.json (were out of sync)
+- Added `source_url` field to ClassifyOutput and ValidateOutput response objects (mandatory per Section 7.7)
+
+## [1.0.0] - 2026-04-24
+
+### Added
+- Initial release
+- `hs_classify_product` tool: classify product descriptions to official HS codes using government tariff schedules (USITC, Singapore Customs, CBSA, Australia Border Force) via HSPing API with AI-assisted reasoning
+- `hs_validate_code` tool: validate supplier-provided HS codes against official schedules with AI mismatch detection (paid tier)
+- Free tier: 10 classify calls/month per IP, no API key required
+- Pro tier: full result set with confidence ranking on classify + full validate access
+- Both stdio and HTTP (Streamable) transports
+- /health, /deps, /stats, /webhook/stripe endpoints
+- Free tier quota tracking by IP with 80% warning and conversion hook
+- Stripe webhook integration for paid key provisioning

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Kord Agencies Pte Ltd
-
-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.
+MIT License
+
+Copyright (c) 2026 Kord Agencies Pte Ltd
+
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hs-code-classifier-mcp",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "MCP server for HS code classification and validation using official government tariff schedules",
   "type": "module",
   "main": "dist/index.js",

package/server-card.json

@@ -1,5 +1,5 @@
-{
-  "token_footprint_min": 45,
-  "token_footprint_max": 400,
-  "token_footprint_avg": 170
-}
+{
+  "token_footprint_min": 45,
+  "token_footprint_max": 400,
+  "token_footprint_avg": 170
+}

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,eAAe,mDAAmD,CAAC;AAChF,eAAO,MAAM,sBAAsB,mDAAmD,CAAC;AACvF,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,uCAAuC,CAAC;AACpE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAE5D,eAAO,MAAM,gBAAgB,QAMc,CAAC;AAE5C,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/constants.js

@@ -1,19 +0,0 @@
-export const VERSION = '1.0.8';
-export const PRO_UPGRADE_URL = 'https://buy.stripe.com/fZubJ06o58Dj3BG8Nyebu0v';
-export const ENTERPRISE_UPGRADE_URL = 'https://buy.stripe.com/6oU3cu5k12eVegk3teebu0w';
-export const CHARACTER_LIMIT = 25000;
-export const HSPING_BASE_URL = 'https://api.hsping.com/api/v1/find';
-export const FREE_TIER_MONTHLY_LIMIT = 10;
-export const FREE_TIER_WARNING_THRESHOLD = 8;
-export const TRIAL_EXTENSION_CALLS = 10;
-export const PERSIST_FILE = '/tmp/hs_classifier_stats.json';
-export const LEGAL_DISCLAIMER = 'Results sourced directly from official government tariff schedules via HSPing API (api.hsping.com). ' +
-    'HS code classification is subject to customs authority interpretation and may vary by jurisdiction. ' +
-    'Results are for informational purposes only and do not constitute legal, compliance, or customs advice. ' +
-    'We do not log or store your query content. ' +
-    'Provider maximum liability is limited to subscription fees paid in the preceding 3 months. ' +
-    'Full terms: kordagencies.com/terms.html';
-export function nowISO() {
-    return new Date().toISOString();
-}
-//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,gDAAgD,CAAC;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,gDAAgD,CAAC;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,oCAAoC,CAAC;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAC3B,sGAAsG;IACtG,sGAAsG;IACtG,0GAA0G;IAC1G,6CAA6C;IAC7C,6FAA6F;IAC7F,yCAAyC,CAAC;AAE5C,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}