@pipeworx/mcp-openstates 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipeworx/mcp-openstates",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "OpenStates MCP — bills, legislators, votes in all 50 US states",
   "type": "module",
   "main": "src/index.ts",
@@ -26,7 +26,7 @@
     "@cloudflare/workers-types": "^4.20260405.1"
   },
   "pipeworx": {
-    "sourceHash": "v1-cb3703013cf69fc6e2fc70bca57a6857b7ead99de0e71beaa6a32b1312e11733",
-    "sourceCommit": "c7cc6672266b20d1b5feb0c4c2d631e50ad8ba17"
+    "sourceHash": "v1-d9939703c0e177f41da0fbd131835af380ebc15e9c75b8fd58b9dbebd35552be",
+    "sourceCommit": "69152ffc15233d5998bfe6fe195c040cdb328366"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.pipeworx-io/openstates",
   "title": "Openstates",
   "description": "OpenStates MCP — bills, legislators, votes in all 50 US states",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "websiteUrl": "https://pipeworx.io/packs/openstates",
   "repository": {
     "url": "https://github.com/pipeworx-io/mcp-openstates",

package/src/index.ts

@@ -997,8 +997,8 @@ export function resolveSessionCandidates(requested: string, sessions: OsSession[
   return hits
     .map((s, i) => ({ s, i }))
     .sort((a, b) => {
-      const pa = a.s.classification === 'primary' ? 0 : 1;
-      const pb = b.s.classification === 'primary' ? 0 : 1;
+      const pa = isSpecialSession(a.s) ? 1 : 0;
+      const pb = isSpecialSession(b.s) ? 1 : 0;
       if (pa !== pb) return pa - pb;
       const da = a.s.start_date ?? '';
       const db = b.s.start_date ?? '';
@@ -1009,6 +1009,14 @@ export function resolveSessionCandidates(requested: string, sessions: OsSession[
     .slice(0, 4);
 }
 
+// OpenStates does not always populate `classification` (Texas leaves it off and
+// names its specials "…Called Session"), so read the name too — otherwise the
+// newest special session outranks the regular one for the same year.
+function isSpecialSession(s: OsSession): boolean {
+  if (s.classification) return s.classification !== 'primary';
+  return /\b(special|called|extraordinary|extra)\b/i.test(s.name ?? '');
+}
+
 const TERRITORIES = new Set(['pr', 'gu', 'vi', 'as', 'mp']);
 
 function jurisdictionPathId(jurisdiction: string): string {
@@ -1021,6 +1029,25 @@ function jurisdictionPathId(jurisdiction: string): string {
   return j.startsWith('ocd-jurisdiction/') ? j : encodeURIComponent(j);
 }
 
+// Session lists change a few times a year; the upstream free tier is small and
+// per-minute throttled, so keep them per isolate for an hour rather than
+// spending a request on every zero-row search.
+const SESSION_TTL_MS = 60 * 60 * 1000;
+const sessionCache = new Map<string, { at: number; data: { name?: string; legislative_sessions?: OsSession[] } }>();
+
+async function jurisdictionSessions(apiKey: string, jurisdiction: string) {
+  const key = jurisdictionPathId(jurisdiction);
+  const hit = sessionCache.get(key);
+  if (hit && Date.now() - hit.at < SESSION_TTL_MS) return hit.data;
+  const data = await osFetch<{ name?: string; legislative_sessions?: OsSession[] }>(
+    apiKey,
+    `/jurisdictions/${key}`,
+    new URLSearchParams({ include: 'legislative_sessions' }),
+  );
+  sessionCache.set(key, { at: Date.now(), data });
+  return data;
+}
+
 /**
  * Check a session value against the jurisdiction's real session list.
  * exact → it IS a valid identifier (an empty result is genuine).
@@ -1033,11 +1060,7 @@ async function resolveSession(
   jurisdiction: string,
   session: string,
 ): Promise<{ exact?: string; candidates: OsSession[] }> {
-  const data = await osFetch<{ name?: string; legislative_sessions?: OsSession[] }>(
-    apiKey,
-    `/jurisdictions/${jurisdictionPathId(jurisdiction)}`,
-    new URLSearchParams({ include: 'legislative_sessions' }),
-  );
+  const data = await jurisdictionSessions(apiKey, jurisdiction);
   const sessions = (data.legislative_sessions ?? []).filter((s) => s && s.identifier);
   const norm = session.trim().toLowerCase();
   const exact = sessions.find(

package/src/server.ts

@@ -9,7 +9,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import pack from './index.js';
 
 const server = new Server(
-  { name: '@pipeworx/mcp-openstates', version: '0.1.3' },
+  { name: '@pipeworx/mcp-openstates', version: '0.1.4' },
   { capabilities: { tools: {} } },
 );