Merge pull request #21 from CASParser/release-please--branches--main--changes--next--components--cas-parser-node

sameerkumar18 · web-flow · commit cd1cd45ea26f · 2026-03-27T16:56:13.000-03:00
release: 1.10.3
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -19,7 +19,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/cas-parser-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@v6
 
@@ -43,7 +43,7 @@ jobs:
     timeout-minutes: 5
     name: build
     runs-on: ${{ github.repository == 'stainless-sdks/cas-parser-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     permissions:
       contents: read
       id-token: write
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 node_modules
 yarn-error.log
 codegen.log
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.10.2"
+  ".": "1.10.3"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.10.3 (2026-03-27)
+
+Full Changelog: [v1.10.2...v1.10.3](https://github.com/CASParser/cas-parser-node/compare/v1.10.2...v1.10.3)
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([c586cc0](https://github.com/CASParser/cas-parser-node/commit/c586cc0ec3026afa1ebce62cd27df64c9324745d))
+* **internal:** fix MCP server TS errors that occur with required client options ([a284756](https://github.com/CASParser/cas-parser-node/commit/a284756cb83eb774ab2483a1581b7b180e474f94))
+* **internal:** support custom-instructions-path flag in MCP servers ([8089550](https://github.com/CASParser/cas-parser-node/commit/8089550962d4a008a8a39f6662576f792da4221a))
+* **internal:** update gitignore ([c3d5073](https://github.com/CASParser/cas-parser-node/commit/c3d50737ff158aa5dd43743005fb68ee23a7ea05))
+
 ## 1.10.2 (2026-03-17)
 
 Full Changelog: [v1.10.1...v1.10.2](https://github.com/CASParser/cas-parser-node/compare/v1.10.1...v1.10.2)
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cas-parser-node",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "The official TypeScript library for the Cas Parser API",
   "author": "Cas Parser <sameer@casparser.in>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/manifest.json b/packages/mcp-server/manifest.json
@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "cas-parser-node-mcp",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "The official MCP Server for the Cas Parser API",
   "author": {
     "name": "Cas Parser",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cas-parser-node-mcp",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "The official MCP Server for the Cas Parser API",
   "author": "Cas Parser <sameer@casparser.in>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/code-tool.ts b/packages/mcp-server/src/code-tool.ts
@@ -285,15 +285,13 @@ const localDenoHandler = async ({
 
       // Strip null/undefined values so that the worker SDK client can fall back to
       // reading from environment variables (including any upstreamClientEnvs).
-      const opts: ClientOptions = Object.fromEntries(
-        Object.entries({
-          baseURL: client.baseURL,
-          apiKey: client.apiKey,
-          defaultHeaders: {
-            'X-Stainless-MCP': 'true',
-          },
-        }).filter(([_, v]) => v != null),
-      ) as ClientOptions;
+      const opts = {
+        ...(client.baseURL != null ? { baseURL: client.baseURL } : undefined),
+        ...(client.apiKey != null ? { apiKey: client.apiKey } : undefined),
+        defaultHeaders: {
+          'X-Stainless-MCP': 'true',
+        },
+      } satisfies Partial<ClientOptions> as ClientOptions;
 
       const req = worker.request(
         'http://localhost',
diff --git a/packages/mcp-server/src/http.ts b/packages/mcp-server/src/http.ts
@@ -23,7 +23,8 @@ const newServer = async ({
   res: express.Response;
 }): Promise<McpServer | null> => {
   const stainlessApiKey = getStainlessApiKey(req, mcpOptions);
-  const server = await newMcpServer(stainlessApiKey);
+  const customInstructionsPath = mcpOptions.customInstructionsPath;
+  const server = await newMcpServer({ stainlessApiKey, customInstructionsPath });
 
   const authOptions = parseClientAuthHeaders(req, false);
 
diff --git a/packages/mcp-server/src/instructions.ts b/packages/mcp-server/src/instructions.ts
@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import fs from 'fs/promises';
 import { readEnv } from './util';
 import { getLogger } from './logger';
 
@@ -12,9 +13,15 @@ interface InstructionsCacheEntry {
 
 const instructionsCache = new Map<string, InstructionsCacheEntry>();
 
-export async function getInstructions(stainlessApiKey: string | undefined): Promise<string> {
+export async function getInstructions({
+  stainlessApiKey,
+  customInstructionsPath,
+}: {
+  stainlessApiKey?: string | undefined;
+  customInstructionsPath?: string | undefined;
+}): Promise<string> {
   const now = Date.now();
-  const cacheKey = stainlessApiKey ?? '';
+  const cacheKey = customInstructionsPath ?? stainlessApiKey ?? '';
   const cached = instructionsCache.get(cacheKey);
 
   if (cached && now - cached.fetchedAt <= INSTRUCTIONS_CACHE_TTL_MS) {
@@ -28,12 +35,28 @@ export async function getInstructions(stainlessApiKey: string | undefined): Prom
     }
   }
 
-  const fetchedInstructions = await fetchLatestInstructions(stainlessApiKey);
+  let fetchedInstructions: string;
+
+  if (customInstructionsPath) {
+    fetchedInstructions = await fetchLatestInstructionsFromFile(customInstructionsPath);
+  } else {
+    fetchedInstructions = await fetchLatestInstructionsFromApi(stainlessApiKey);
+  }
+
   instructionsCache.set(cacheKey, { fetchedInstructions, fetchedAt: now });
   return fetchedInstructions;
 }
 
-async function fetchLatestInstructions(stainlessApiKey: string | undefined): Promise<string> {
+async function fetchLatestInstructionsFromFile(path: string): Promise<string> {
+  try {
+    return await fs.readFile(path, 'utf-8');
+  } catch (error) {
+    getLogger().error({ error, path }, 'Error fetching instructions from file');
+    throw error;
+  }
+}
+
+async function fetchLatestInstructionsFromApi(stainlessApiKey: string | undefined): Promise<string> {
   // Setting the stainless API key is optional, but may be required
   // to authenticate requests to the Stainless API.
   const response = await fetch(
diff --git a/packages/mcp-server/src/options.ts b/packages/mcp-server/src/options.ts
@@ -22,6 +22,7 @@ export type McpOptions = {
   codeAllowedMethods?: string[] | undefined;
   codeBlockedMethods?: string[] | undefined;
   codeExecutionMode: McpCodeExecutionMode;
+  customInstructionsPath?: string | undefined;
 };
 
 export type McpCodeExecutionMode = 'stainless-sandbox' | 'local';
@@ -52,6 +53,10 @@ export function parseCLIOptions(): CLIOptions {
       description:
         "Where to run code execution in code tool; 'stainless-sandbox' will execute code in Stainless-hosted sandboxes whereas 'local' will execute code locally on the MCP server machine.",
     })
+    .option('custom-instructions-path', {
+      type: 'string',
+      description: 'Path to custom instructions for the MCP server',
+    })
     .option('debug', { type: 'boolean', description: 'Enable debug logging' })
     .option('log-format', {
       type: 'string',
@@ -117,6 +122,7 @@ export function parseCLIOptions(): CLIOptions {
     codeAllowedMethods: argv.codeAllowedMethods,
     codeBlockedMethods: argv.codeBlockedMethods,
     codeExecutionMode: argv.codeExecutionMode as McpCodeExecutionMode,
+    customInstructionsPath: argv.customInstructionsPath,
     transport,
     logFormat,
     port: argv.port,
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
@@ -16,14 +16,20 @@ import { McpOptions } from './options';
 import { blockedMethodsForCodeTool } from './methods';
 import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from './types';
 
-export const newMcpServer = async (stainlessApiKey: string | undefined) =>
+export const newMcpServer = async ({
+  stainlessApiKey,
+  customInstructionsPath,
+}: {
+  stainlessApiKey?: string | undefined;
+  customInstructionsPath?: string | undefined;
+}) =>
   new McpServer(
     {
       name: 'cas_parser_node_api',
-      version: '1.10.2',
+      version: '1.10.3',
     },
     {
-      instructions: await getInstructions(stainlessApiKey),
+      instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),
       capabilities: { tools: {}, logging: {} },
     },
   );
diff --git a/packages/mcp-server/src/stdio.ts b/packages/mcp-server/src/stdio.ts
@@ -4,7 +4,10 @@ import { initMcpServer, newMcpServer } from './server';
 import { getLogger } from './logger';
 
 export const launchStdioServer = async (mcpOptions: McpOptions) => {
-  const server = await newMcpServer(mcpOptions.stainlessApiKey);
+  const server = await newMcpServer({
+    stainlessApiKey: mcpOptions.stainlessApiKey,
+    customInstructionsPath: mcpOptions.customInstructionsPath,
+  });
 
   await initMcpServer({ server, mcpOptions, stainlessApiKey: mcpOptions.stainlessApiKey });
 
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.10.2'; // x-release-please-version
+export const VERSION = '1.10.3'; // x-release-please-version

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`.prism.log`
	`2`	`+.stdy.log`
`2`	`3`	`node_modules`
`3`	`4`	`yarn-error.log`
`4`	`5`	`codegen.log`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.10.2"`
	`2`	`+ ".": "1.10.3"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "cas-parser-node",`
`3`		`- "version": "1.10.2",`
	`3`	`+ "version": "1.10.3",`
`4`	`4`	`"description": "The official TypeScript library for the Cas Parser API",`
`5`	`5`	`"author": "Cas Parser <sameer@casparser.in>",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"dxt_version": "0.2",`
`3`	`3`	`"name": "cas-parser-node-mcp",`
`4`		`- "version": "1.10.2",`
	`4`	`+ "version": "1.10.3",`
`5`	`5`	`"description": "The official MCP Server for the Cas Parser API",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "Cas Parser",`