@j0hanz/prompt-tuner-mcp-server 1.0.8 → 1.0.10

package/AGENTS.md

@@ -1,39 +1,82 @@
-# Repository Guidelines
+# AGENTS.md
 
-## Project Structure & Module Organization
+## Project Overview
 
-- `src/` holds TypeScript source. `src/index.ts` is the entry point and `src/server.ts` wires the MCP server. Subfolders include `config/`, `lib/`, `tools/`, `resources/`, `prompts/`, `schemas/`, and `types/`.
-- `tests/` contains Vitest suites; test files use the `*.test.ts` naming pattern.
-- `dist/` is generated build output (do not edit by hand).
-- `docs/` stores static assets. `CONFIGURATION.md` documents runtime environment variables.
+- **Goal**: MCP server for refining, analyzing, optimizing, and validating AI prompts.
+- **Stack**: Node.js (>=20), TypeScript, Model Context Protocol (MCP), Zod, Vitest.
+- **Key Libraries**: `@modelcontextprotocol/sdk`, `openai`, `@anthropic-ai/sdk`, `@google/genai`, `zod`.
 
-## Build, Test, and Development Commands
+## Repo Map / Structure
 
-- `npm run dev` / `npm run dev:http`: run from source with tsx watch (HTTP variant adds `--http`).
-- `npm run build`: compile TypeScript into `dist/` and set executable permissions.
-- `npm run start` / `npm run start:http`: run the compiled server from `dist/`.
-- `npm run test` / `npm run test:watch`: run Vitest once or in watch mode.
-- `npm run lint` and `npm run format`: ESLint checks and Prettier formatting.
-- `npm run type-check`: `tsc --noEmit` for strict type validation.
+- `src/`: TypeScript source code.
+  - `index.ts`: CLI entry point.
+  - `server.ts`: MCP server initialization and tool registration.
+  - `config/`: Environment variables, constants, and configuration logic.
+  - `lib/`: Core logic (LLM clients, retry mechanisms, validation, prompt analysis).
+  - `tools/`: Tool implementations (`refine_prompt`, `analyze_prompt`, etc.).
+  - `schemas/`: Zod schemas for inputs and outputs.
+  - `prompts/`: Internal prompt templates used by the server.
+- `tests/`: Integration and unit tests (`*.test.ts`).
+- `dist/`: Compiled JavaScript output (generated).
+- `docs/`: Documentation assets.
+- `CONFIGURATION.md`: Detailed environment variable reference.
 
-## Coding Style & Naming Conventions
+## Setup & Environment
 
-- TypeScript, ES modules, Node >= 20.
-- Prettier rules: 2-space indentation, single quotes, trailing commas, 80-char line width, sorted imports.
-- ESLint is strict; avoid `any`, unused imports, and floating promises; prefer `type` imports.
-- Naming: `camelCase` for variables/functions, `PascalCase` for types, `UPPER_CASE` for constants; leading `_` is allowed for unused args.
+- **Install dependencies**: `npm install`
+- **Environment variables**:
+  - Defined in `src/config/env.ts` and documented in `CONFIGURATION.md`.
+  - Key variables: `LLM_PROVIDER`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`.
+- **Node.js Version**: `>=20.0.0` (enforced in `package.json`).
 
-## Testing Guidelines
+## Development Workflow
 
-- Use Vitest in the Node environment; keep tests in `tests/` and name `*.test.ts`.
-- Favor deterministic tests and keep individual tests under the 15s timeout.
+- **Dev mode**: `npm run dev` (runs `src/index.ts` with `tsx watch`).
+- **Build**: `npm run build` (compiles to `dist/` and sets executable permissions).
+- **Start production**: `npm run start` (runs `dist/index.js`).
+- **MCP Inspector**: `npm run inspector` (debugs the server using the MCP inspector).
 
-## Commit & Pull Request Guidelines
+## Testing
 
-- History favors short, imperative summaries; common pattern is `refactor: ...`, plus plain `Add ...` and version bumps like `1.0.5`.
-- PRs should include a brief summary, tests run (for example, `npm run test`), and note any config or environment changes. Link related issues when applicable.
+- **Run all tests**: `npm run test` (uses Vitest).
+- **Watch mode**: `npm run test:watch`.
+- **Coverage**: `npm run test:coverage`.
+- **Test files**: Located in `tests/` directory, matching `*.test.ts`.
 
-## Security & Configuration Tips
+## Code Style & Conventions
 
-- Runtime behavior is driven by environment variables; see `CONFIGURATION.md` for required keys and limits.
-- Never commit API keys. Be cautious with `INCLUDE_ERROR_CONTEXT=true` in production.
+- **Language**: TypeScript (ES2022 target, NodeNext module resolution).
+- **Linting**: `npm run lint` (ESLint with `typescript-eslint` and `unused-imports`).
+- **Formatting**: `npm run format` (Prettier).
+- **Type Checking**: `npm run type-check` (runs `tsc --noEmit`).
+- **Naming Conventions**:
+  - Variables/Functions: `camelCase`.
+  - Types/Interfaces/Classes: `PascalCase`.
+  - Constants: `UPPER_CASE`.
+  - Files: `kebab-case`.
+- **Rules**:
+  - No `any` types (`@typescript-eslint/no-explicit-any`).
+  - Explicit function return types required.
+  - Unused imports are forbidden.
+  - Prefer `type` imports.
+
+## Build / Release
+
+- **Output Directory**: `dist/` (cleared and regenerated on build).
+- **Process**: `npm run build` compiles TS to JS and makes `dist/index.js` executable.
+
+## Security & Safety
+
+- **Secrets**: API keys must be passed via environment variables; never committed.
+- **Validation**: All tool inputs are validated using Zod schemas in `src/schemas/`.
+- **Error Handling**: Error context is sanitized to prevent leaking sensitive info (controlled by `INCLUDE_ERROR_CONTEXT`).
+
+## Pull Request / Commit Guidelines
+
+- **Commit Messages**: Imperative mood (e.g., "Add feature", "Fix bug").
+- **Required Checks**: Ensure `npm run lint`, `npm run type-check`, and `npm run test` pass before submitting.
+
+## Troubleshooting
+
+- **Missing API Key**: Ensure `LLM_PROVIDER` matches the set API key (e.g., `OPENAI_API_KEY` for `openai`).
+- **Build Errors**: Run `npm run type-check` to identify TypeScript issues.

package/CONFIGURATION.md

@@ -1,6 +1,6 @@
 # PromptTuner MCP Configuration Guide
 
-PromptTuner MCP is configured entirely via environment variables. Set them in your MCP client configuration (for example `mcp.json`, `claude_desktop_config.json`) or a `.env` file.
+PromptTuner MCP is configured entirely via environment variables. Set them in your MCP client configuration (for example `mcp.json`, `claude_desktop_config.json`) or a `.env` file. Node.js >= 22.0.0 is required (see `package.json` engines).
 
 ## Required configuration
 
@@ -33,6 +33,10 @@ Set `LLM_MODEL` to override the default model for the chosen provider.
 | `LLM_MAX_TOKENS`    | `8000`  | Upper bound for model output tokens. |
 | `LLM_TIMEOUT_MS`    | `60000` | Per-request timeout (ms).            |
 
+All numeric values are parsed as integers. Invalid values or values below the minimum thresholds will fail startup validation.
+
+Minimums: `MAX_PROMPT_LENGTH` >= 1, `LLM_MAX_TOKENS` >= 1, `LLM_TIMEOUT_MS` >= 1000.
+
 ### Prompt length enforcement
 
 - Input is trimmed before validation.
@@ -61,13 +65,15 @@ Tool max tokens are derived from `LLM_MAX_TOKENS`:
 
 Retries use exponential backoff with jitter and stop when the total timeout is exceeded.
 
+Minimums: `RETRY_MAX_ATTEMPTS` >= 0, `RETRY_BASE_DELAY_MS` >= 100, `RETRY_MAX_DELAY_MS` >= 1000, `RETRY_TOTAL_TIMEOUT_MS` >= 10000.
+
 ## Logging and error context (optional)
 
-| Variable                | Default | Description                                                    |
-| ----------------------- | ------- | -------------------------------------------------------------- |
-| `DEBUG`                 | `false` | Enables debug logging. Logs are written to stderr.             |
-| `LOG_FORMAT`            | `text`  | Parsed but currently unused (logging output is JSON via pino). |
-| `INCLUDE_ERROR_CONTEXT` | `false` | Adds a sanitized prompt snippet (up to 200 chars) to errors.   |
+| Variable                | Default | Description                                                                              |
+| ----------------------- | ------- | ---------------------------------------------------------------------------------------- |
+| `DEBUG`                 | `false` | Enables debug logging (set to the string `true` or `false`). Logs are written to stderr. |
+| `LOG_FORMAT`            | `text`  | Accepted values: `json`, `text`. Currently ignored; output is always JSON via pino.      |
+| `INCLUDE_ERROR_CONTEXT` | `false` | Adds a sanitized prompt snippet (up to 200 chars) to errors.                             |
 
 ## Provider-specific settings
 
@@ -179,7 +185,7 @@ The following behaviors are hardcoded for stability:
 
 If you have an old `.env` file, remove unused settings:
 
-- `PORT`, `HOST`, `CORS_ORIGIN` (stdio transport only; `--http` is reserved).
+- `PORT`, `HOST`, `CORS_ORIGIN` (stdio transport only; no HTTP listener).
 - `API_KEY` (no server-level auth).
 - `LOG_LEVEL` (use `DEBUG=true` or false).
 - `RATE_LIMIT`, `RATE_WINDOW_MS` (no server-side rate limiting).
@@ -192,7 +198,7 @@ If you have an old `.env` file, remove unused settings:
 
 ### Prompt rejected
 
-- Reduce `MAX_PROMPT_LENGTH` or trim the input to remove excessive whitespace.
+- Shorten the prompt, remove excessive whitespace, or increase `MAX_PROMPT_LENGTH`.
 
 ### Timeout errors
 
@@ -215,4 +221,4 @@ If you have an old `.env` file, remove unused settings:
 2. Use input variables for secrets (for example `"OPENAI_API_KEY": "${input:openai-api-key}"`).
 3. Start with defaults and tune only when needed.
 4. Enable `DEBUG=true` temporarily for troubleshooting.
-5. Prefer JSON logging in production (current output is JSON via pino).
+5. Logs are JSON via pino; plan parsing/collection accordingly.

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@j0hanz/prompt-tuner-mcp-server.svg)](https://www.npmjs.com/package/@j0hanz/prompt-tuner-mcp-server)
 [![License](https://img.shields.io/npm/l/@j0hanz/prompt-tuner-mcp-server)](LICENSE)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen)](https://nodejs.org/)
 
 PromptTuner MCP is an MCP server that refines, analyzes, optimizes, and validates prompts using OpenAI, Anthropic, or Google Gemini.
 
@@ -14,7 +14,7 @@ PromptTuner MCP is an MCP server that refines, analyzes, optimizes, and validate
 2. Resolves the target format (`auto` uses heuristics; falls back to `gpt` if no format is detected).
 3. Calls the selected provider with retry and timeout controls.
 4. Validates and normalizes LLM output, falling back to stricter prompts or the `basic` technique when needed.
-5. Returns human-readable text plus machine-friendly `structuredContent` (and prompt files for refined/optimized outputs).
+5. Returns human-readable text plus machine-friendly `structuredContent` (and resource blocks for refined/optimized outputs).
 
 ## Features
 
@@ -27,7 +27,7 @@ PromptTuner MCP is an MCP server that refines, analyzes, optimizes, and validate
 
 ## Quick Start
 
-PromptTuner runs over stdio (MCP default). The `--http` flag shown in some scripts is reserved and currently has no effect.
+PromptTuner runs over stdio only. The `dev:http` and `start:http` scripts are compatibility aliases (no HTTP transport yet).
 
 ### Claude Desktop
 
@@ -95,11 +95,11 @@ Returns: `ok`, `hasTypos`, `isVague`, `missingContext`, `suggestions`, `score`,
 
 Apply multiple techniques sequentially and return before/after scores.
 
-| Parameter      | Type     | Required | Default     | Notes                               |
-| -------------- | -------- | -------- | ----------- | ----------------------------------- |
-| `prompt`       | string   | Yes      | -           | Trimmed and length-checked.         |
-| `techniques`   | string[] | No       | `["basic"]` | 1-6 techniques; duplicates removed. |
-| `targetFormat` | string   | No       | `auto`      | `auto`, `claude`, `gpt`, `json`.    |
+| Parameter      | Type     | Required | Default     | Notes                                                                                                                           |
+| -------------- | -------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `prompt`       | string   | Yes      | -           | Trimmed and length-checked.                                                                                                     |
+| `techniques`   | string[] | No       | `["basic"]` | 1-6 techniques; duplicates removed. `comprehensive` expands to `basic -> roleBased -> structured -> fewShot -> chainOfThought`. |
+| `targetFormat` | string   | No       | `auto`      | `auto`, `claude`, `gpt`, `json`.                                                                                                |
 
 Returns: `ok`, `original`, `optimized`, `techniquesApplied`, `targetFormat`, `beforeScore`, `afterScore`, `scoreDelta`, `improvements`, `usedFallback`, `scoreAdjusted`, `overallSource`, `provider`, `model`.
 
@@ -119,10 +119,10 @@ Token limits used for `validate_prompt`: `claude` 200000, `gpt` 128000, `gemini`
 
 ## Response Format
 
-- `content`: human-readable Markdown summary.
+- `content`: array of content blocks (human-readable Markdown text plus optional resources).
 - `structuredContent`: machine-parseable results.
 - Errors return `structuredContent.ok=false` and an `error` object with `code`, `message`, optional `context` (sanitized, up to 200 chars), `details`, and `recoveryHint`.
-- `refine_prompt` and `optimize_prompt` include a `resource` content block with a `file:///` URI containing the refined or optimized prompt.
+- `refine_prompt` and `optimize_prompt` include a `resource` content block with a `file:///` URI and the prompt text in `resource.text` (Markdown).
 
 ## Prompts
 
@@ -159,27 +159,27 @@ Token limits used for `validate_prompt`: `claude` 200000, `gpt` 128000, `gemini`
 
 ### Prerequisites
 
-- Node.js >= 20.0.0
+- Node.js >= 22.0.0
 - npm
 
 ### Scripts
 
-| Command                  | Description                                              |
-| ------------------------ | -------------------------------------------------------- |
-| `npm run build`          | Compile TypeScript and set permissions.                  |
-| `npm run dev`            | Run from source in watch mode.                           |
-| `npm run dev:http`       | Run from source with `--http` (reserved, no effect).     |
-| `npm run start`          | Run the compiled server from `dist/`.                    |
-| `npm run start:http`     | Run compiled server with `--http` (reserved, no effect). |
-| `npm run test`           | Run Vitest once.                                         |
-| `npm run test:coverage`  | Run tests with coverage.                                 |
-| `npm run test:watch`     | Run Vitest in watch mode.                                |
-| `npm run lint`           | Run ESLint.                                              |
-| `npm run format`         | Run Prettier.                                            |
-| `npm run type-check`     | TypeScript type checking.                                |
-| `npm run inspector`      | Run MCP Inspector against `dist/index.js`.               |
-| `npm run inspector:http` | Inspector with `--http` (reserved, no effect).           |
-| `npm run duplication`    | Run jscpd duplication report.                            |
+| Command                  | Description                                           |
+| ------------------------ | ----------------------------------------------------- |
+| `npm run build`          | Compile TypeScript and set permissions.               |
+| `npm run dev`            | Run from source in watch mode.                        |
+| `npm run dev:http`       | Alias of `npm run dev` (no HTTP transport yet).       |
+| `npm run start`          | Run the compiled server from `dist/`.                 |
+| `npm run start:http`     | Alias of `npm run start` (no HTTP transport yet).     |
+| `npm run test`           | Run Vitest once.                                      |
+| `npm run test:coverage`  | Run tests with coverage.                              |
+| `npm run test:watch`     | Run Vitest in watch mode.                             |
+| `npm run lint`           | Run ESLint.                                           |
+| `npm run format`         | Run Prettier.                                         |
+| `npm run type-check`     | TypeScript type checking.                             |
+| `npm run inspector`      | Run MCP Inspector against `dist/index.js`.            |
+| `npm run inspector:http` | Alias of `npm run inspector` (no HTTP transport yet). |
+| `npm run duplication`    | Run jscpd duplication report.                         |
 
 ## Project Structure
 
@@ -190,8 +190,7 @@ src/
   config/         Configuration and constants
   lib/            Shared utilities (LLM, retry, validation)
   tools/          Tool implementations
-  prompts/        Prompt templates
-  resources/      Resource registration (currently none)
+  prompts/        MCP prompt templates
   schemas/        Zod input/output schemas
   types/          Shared types
 

package/dist/config/constants.d.ts

@@ -24,4 +24,3 @@ export declare const DEFAULT_MODELS: {
     readonly anthropic: "claude-3-5-sonnet-20241022";
     readonly google: "gemini-2.0-flash-exp";
 };
-//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.js

@@ -11,7 +11,6 @@ export const SCORING_WEIGHTS = {
 };
 export const SERVER_NAME = 'prompttuner-mcp';
 export const SERVER_VERSION = packageJson.version;
-// Configurable via environment variables
 const { MAX_PROMPT_LENGTH: ENV_MAX_PROMPT_LENGTH, LLM_TIMEOUT_MS: ENV_LLM_TIMEOUT_MS, LLM_MAX_TOKENS: ENV_LLM_MAX_TOKENS, } = config;
 export const MAX_PROMPT_LENGTH = ENV_MAX_PROMPT_LENGTH;
 export const MIN_PROMPT_LENGTH = 1;
@@ -28,4 +27,3 @@ export const DEFAULT_MODELS = {
     anthropic: 'claude-3-5-sonnet-20241022',
     google: 'gemini-2.0-flash-exp',
 };
-//# sourceMappingURL=constants.js.map

package/dist/config/env.d.ts

@@ -16,4 +16,3 @@ export declare const config: {
     ANTHROPIC_API_KEY?: string | undefined;
     GOOGLE_API_KEY?: string | undefined;
 };
-//# sourceMappingURL=env.d.ts.map

package/dist/config/env.js

@@ -11,11 +11,9 @@ const numberString = (def, min = 0) => z
     .transform((v) => parseInt(v, 10))
     .refine((n) => n >= min, { message: `Must be >= ${min}` });
 const envSchema = z.object({
-    // Server
     LOG_FORMAT: z.enum(['json', 'text']).optional().default('text'),
     DEBUG: booleanString,
     INCLUDE_ERROR_CONTEXT: booleanString,
-    // LLM
     LLM_PROVIDER: z
         .enum(['openai', 'anthropic', 'google'])
         .optional()
@@ -28,17 +26,13 @@ const envSchema = z.object({
         .optional()
         .default('false')
         .transform((v) => v === 'true'),
-    // Keys
     OPENAI_API_KEY: z.string().optional(),
     ANTHROPIC_API_KEY: z.string().optional(),
     GOOGLE_API_KEY: z.string().optional(),
-    // Constraints
     MAX_PROMPT_LENGTH: numberString(10000, 1),
-    // Retry
     RETRY_MAX_ATTEMPTS: numberString(3, 0),
     RETRY_BASE_DELAY_MS: numberString(1000, 100),
     RETRY_MAX_DELAY_MS: numberString(10000, 1000),
     RETRY_TOTAL_TIMEOUT_MS: numberString(180000, 10000),
 });
 export const config = envSchema.parse(process.env);
-//# sourceMappingURL=env.js.map

package/dist/config/instructions.d.ts

@@ -1,2 +1 @@
 export declare const SERVER_INSTRUCTIONS = "# PromptTuner MCP\n\nA lean prompt optimization toolkit for refining, analyzing, and validating prompts.\n\n## Quick Start\n\n| Goal | Tool | When to Use |\n|------|------|-------------|\n| Quick fix | `refine_prompt` | Fix typos and clarity issues |\n| Deep optimization | `optimize_prompt` | Apply multiple techniques |\n| Quality check | `analyze_prompt` | Get scores and suggestions |\n| Safety check | `validate_prompt` | Find issues and estimate tokens |\n\n## Tools\n\n### refine_prompt\nImproves a prompt using a single optimization technique.\n\n**Techniques:**\n- `basic` (default) - Fix grammar, spelling, and clarity\n- `chainOfThought` - Add step-by-step reasoning guidance\n- `fewShot` - Add input/output examples\n- `roleBased` - Add expert persona/role context\n- `structured` - Add XML (Claude) or Markdown (GPT) structure\n- `comprehensive` - Apply all techniques intelligently\n\n**Example:**\n```json\n{ \"prompt\": \"help me code\", \"technique\": \"roleBased\", \"targetFormat\": \"claude\" }\n```\n\n### analyze_prompt\nScores your prompt (0-100) across clarity, specificity, completeness, structure, and effectiveness.\n\n### optimize_prompt\nChains multiple techniques for maximum improvement and returns before/after scores plus improvements.\n\n**Example:**\n```json\n{ \"prompt\": \"write code\", \"techniques\": [\"basic\", \"roleBased\", \"structured\"] }\n```\n\n### validate_prompt\nChecks for prompt issues, estimates token usage, and optionally detects injection risks.\n\n## Target Formats\n\n| Format | Best For | Structure |\n|--------|----------|-----------|\n| `claude` | Anthropic Claude | XML tags: `<context>`, `<task>`, `<requirements>` |\n| `gpt` | OpenAI GPT | Markdown: `## Context`, `## Task`, `**bold**` |\n| `json` | Structured output | JSON schema specification |\n| `auto` | Auto-detect | Uses prompt heuristics to pick format |\n\n## Technique Selection Guide\n\n| Task Type | Recommended Techniques |\n|-----------|----------------------|\n| Simple query | `basic` only |\n| Code task | `roleBased` + `structured` |\n| Complex analysis | `roleBased` + `chainOfThought` |\n| Data extraction | `structured` + `fewShot` |\n| Creative writing | `roleBased` + `fewShot` |\n| Maximum quality | `comprehensive` |\n\n## Workflow Prompts\n- `quick-optimize` - Single-step refinement\n- `deep-optimize` - Comprehensive optimization\n- `analyze` - Quality analysis\n\n## Modern Best Practices (2024-2025)\n\n1. **Be Specific** - Replace vague words with concrete terms\n2. **Add Role Context** - Use specific expert personas\n3. **Use Structure** - XML for Claude, Markdown for GPT (never mix)\n4. **Show Examples** - 2-3 diverse examples for pattern tasks\n5. **Add Constraints** - Clear ALWAYS/NEVER rules\n6. **Specify Output** - Define the expected format explicitly\n7. **Enable Reasoning** - Add task-specific reasoning triggers when needed\n8. **Place Key Instructions Twice** - Start and end for long prompts\n\n## Prompt Architecture (Recommended Order)\n```\n1. Role/Identity (if applicable)\n2. Context/Background\n3. Task/Objective\n4. Instructions/Steps\n5. Requirements/Constraints (ALWAYS/NEVER)\n6. Output Format\n7. Examples (if helpful)\n8. Final Reminder (reiterate critical instruction)\n```";
-//# sourceMappingURL=instructions.d.ts.map

package/dist/config/instructions.js

@@ -90,4 +90,3 @@ Checks for prompt issues, estimates token usage, and optionally detects injectio
 7. Examples (if helpful)
 8. Final Reminder (reiterate critical instruction)
 \`\`\``;
-//# sourceMappingURL=instructions.js.map

package/dist/config/patterns.d.ts

@@ -1,5 +1,4 @@
 export declare const PATTERNS: {
-    readonly roleIndicators: RegExp;
     readonly exampleIndicators: RegExp;
     readonly stepByStepIndicators: RegExp;
     readonly xmlStructure: RegExp;
@@ -8,13 +7,6 @@ export declare const PATTERNS: {
     readonly claudePatterns: RegExp;
     readonly gptPatterns: RegExp;
     readonly vagueWords: RegExp;
-    readonly needsReasoning: RegExp;
-    readonly hasStepByStep: RegExp;
     readonly hasRole: RegExp;
-    readonly constraintPatterns: RegExp;
-    readonly outputSpecPatterns: RegExp;
     readonly fewShotStructure: RegExp;
-    readonly qualityIndicators: RegExp;
-    readonly antiPatterns: RegExp;
 };
-//# sourceMappingURL=patterns.d.ts.map

package/dist/config/patterns.js

@@ -1,5 +1,4 @@
 export const PATTERNS = {
-    roleIndicators: /\b(you are|act as|pretend to be|as a|role:|persona:|imagine you are|your role is|you're an?)\b/i,
     exampleIndicators: /(?:^|\s|[([{])(example:|for example|e\.g\.|such as|here's an example|input:|output:|sample:|demonstration:)(?:$|\s|[)\]}.!?,])/i,
     stepByStepIndicators: /(?:^|\s|[([{])(step by step|step-by-step|first,|then,|finally,|1\.|2\.|3\.|let's think|let's work through|let's analyze|let's break|systematically)(?:$|\s|[)\]}.!?,])/i,
     xmlStructure: /<[a-z_]+>[^<]*<\/[a-z_]+>/is,
@@ -8,13 +7,6 @@ export const PATTERNS = {
     claudePatterns: /<(thinking|response|context|instructions|example|task|requirements|output_format|rules|constraints)>/i,
     gptPatterns: /^##\s|^###\s|\*\*[^*]+\*\*|^>\s/m,
     vagueWords: /\b(something|stuff|things|maybe|kind of|sort of|etc|whatever|somehow|certain|various)\b/gi,
-    needsReasoning: /\b(calculate|analyze|compare|evaluate|explain|solve|debug|review|reason|deduce|derive|prove|assess|investigate|examine|determine)\b/i,
-    hasStepByStep: /step[- ]by[- ]step|first,|then,|finally,|let's think|let's work through|let's analyze/i,
     hasRole: /\b(you are|act as|as a|role:|persona:|your role|you're an?|imagine you are)\b/i,
-    constraintPatterns: /\b(NEVER|ALWAYS|MUST|MUST NOT|DO NOT|RULES:|CONSTRAINTS:|REQUIREMENTS:)\b/,
-    outputSpecPatterns: /\b(output format|respond with|return as|format:|expected output|response format|<output|## Output)\b/i,
     fewShotStructure: /<example>|Example \d+:|Input:|Output:|###\s*Example|Q:|A:/i,
-    qualityIndicators: /\b(specific|detailed|comprehensive|thorough|clear|concise|precise|accurate)\b/i,
-    antiPatterns: /\b(do whatever|anything|everything|all of it|any way you want)\b/i,
 };
-//# sourceMappingURL=patterns.js.map

package/dist/config/types.d.ts

@@ -1,31 +1,28 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export type ToolRegistrar = (server: McpServer) => void;
-interface TextContentBlock {
-    type: 'text';
-    text: string;
-}
-interface TextResourcePayload {
+interface ResourceTextPayload {
     uri: string;
-    mimeType?: string;
     text: string;
+    mimeType?: string;
 }
-interface BlobResourcePayload {
+interface ResourceBlobPayload {
     uri: string;
-    mimeType?: string;
     blob: string;
+    mimeType?: string;
 }
-interface ResourceContentBlock {
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
     type: 'resource';
-    resource: TextResourcePayload | BlobResourcePayload;
-}
-interface ResourceLinkContentBlock {
+    resource: ResourceTextPayload | ResourceBlobPayload;
+} | {
     type: 'resource_link';
     uri: string;
     name: string;
     description?: string;
     mimeType?: string;
-}
-export type ContentBlock = TextContentBlock | ResourceContentBlock | ResourceLinkContentBlock;
+};
 export interface ErrorResponse {
     [key: string]: unknown;
     content: ContentBlock[];
@@ -64,6 +61,10 @@ export interface PatternCache {
     hasBoldOrHeaders: boolean;
     hasAngleBrackets: boolean;
     hasJsonChars: boolean;
+    hasRole: boolean;
+    hasExamples: boolean;
+    hasStepByStep: boolean;
+    isVague: boolean;
 }
 export interface FormatScoringConfig {
     positive: {
@@ -82,7 +83,6 @@ export interface FormatResult {
     rawScore: number;
 }
 export type LLMProvider = 'openai' | 'anthropic' | 'google';
-export type ValidProvider = 'openai' | 'anthropic' | 'google';
 export interface SafeErrorDetails {
     status?: number;
     code?: string;
@@ -109,12 +109,6 @@ export interface LLMToolOptions {
     timeoutMs?: number;
     signal?: AbortSignal;
 }
-export interface RetryOptions {
-    maxRetries?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    totalTimeoutMs?: number;
-}
 export interface McpErrorOptions {
     context?: string;
     details?: Record<string, unknown>;
@@ -171,4 +165,3 @@ export interface ValidationResponse {
     issues: ValidationIssue[];
 }
 export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/config/types.js

@@ -19,4 +19,3 @@ export const ErrorCode = {
     E_LLM_AUTH_FAILED: 'E_LLM_AUTH_FAILED',
     E_TIMEOUT: 'E_TIMEOUT',
 };
-//# sourceMappingURL=types.js.map

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,103 +1,69 @@
 #!/usr/bin/env node
 import { logger } from './lib/errors.js';
-import { createServer, startServer, validateApiKeys } from './server.js';
+import { startServer, validateApiKeys } from './server.js';
 const SHUTDOWN_DELAY_MS = 500;
-const SIGNALS = [
-    'SIGHUP',
-    'SIGINT',
-    'SIGQUIT',
-    'SIGILL',
-    'SIGTRAP',
-    'SIGABRT',
-    'SIGBUS',
-    'SIGFPE',
-    'SIGSEGV',
-    'SIGUSR2',
-    'SIGTERM',
-];
-const ERROR_EVENTS = ['uncaughtException', 'unhandledRejection'];
-const EXIT_EVENTS = ['beforeExit'];
-let shuttingDown = false;
+const SIGNALS = ['SIGHUP', 'SIGINT', 'SIGTERM'];
 let server = null;
+let shuttingDown = false;
 function logSecondShutdown(reason) {
-    if (reason.signal) {
-        logger.error({ signal: reason.signal }, `Second ${reason.signal}, exiting`);
-        return;
-    }
-    if (reason.err) {
-        logger.error({ err: reason.err }, 'Second error, exiting');
-        return;
-    }
-    logger.error('Second shutdown event, exiting');
+    logger.error({ reason }, 'Second shutdown, exiting');
 }
-function logShutdownStart(reason) {
-    if (reason.err) {
-        logger.error({ err: reason.err }, 'Server closing due to error');
-    }
-    if (reason.signal) {
-        logger.info({ signal: reason.signal }, 'Server shutting down gracefully');
+function logShutdown(reason, err) {
+    if (err) {
+        logger.error({ err, reason }, 'Server shutting down due to error');
     }
-    if (reason.event) {
-        logger.info({ event: reason.event }, 'Server shutting down gracefully');
+    else {
+        logger.info({ reason }, 'Server shutting down');
     }
 }
-function resolveExitCode(reason) {
-    return reason.err ? 1 : 0;
-}
 function startForcedShutdownTimer() {
     return setTimeout(() => {
         logger.error({ delayMs: SHUTDOWN_DELAY_MS }, 'Forced shutdown due to timeout');
         process.exit(1);
     }, SHUTDOWN_DELAY_MS);
 }
-async function closeServerIfConnected() {
-    if (server?.isConnected()) {
+async function closeServer() {
+    if (!server?.isConnected())
+        return true;
+    try {
         await server.close();
+        return true;
+    }
+    catch (closeError) {
+        logger.error({ err: closeError }, 'Error during shutdown');
+        return false;
     }
 }
-async function beginShutdown(reason) {
+async function shutdown(reason, err) {
     if (shuttingDown) {
         logSecondShutdown(reason);
         process.exit(1);
         return;
     }
     shuttingDown = true;
-    logShutdownStart(reason);
-    let exitCode = resolveExitCode(reason);
+    logShutdown(reason, err);
     const timeout = startForcedShutdownTimer();
-    try {
-        await closeServerIfConnected();
-    }
-    catch (error) {
+    let exitCode = err ? 1 : 0;
+    if (!(await closeServer()))
         exitCode = 1;
-        logger.error({ err: error }, 'Error during shutdown');
-    }
-    finally {
-        clearTimeout(timeout);
-        process.exit(exitCode);
-    }
+    clearTimeout(timeout);
+    process.exit(exitCode);
 }
 for (const signal of SIGNALS) {
-    process.once(signal, (received) => {
-        void beginShutdown({ signal: received });
-    });
-}
-for (const event of ERROR_EVENTS) {
-    process.once(event, (err) => {
-        void beginShutdown({ err });
-    });
-}
-for (const event of EXIT_EVENTS) {
-    process.once(event, () => {
-        void beginShutdown({ event });
+    process.once(signal, () => {
+        void shutdown(signal);
     });
 }
+process.once('uncaughtException', (err) => {
+    void shutdown('uncaughtException', err);
+});
+process.once('unhandledRejection', (err) => {
+    void shutdown('unhandledRejection', err);
+});
 async function main() {
     await validateApiKeys();
-    server = createServer();
-    await startServer(server);
+    server = await startServer();
 }
-main().catch((error) => {
-    void beginShutdown({ err: error });
+main().catch((err) => {
+    void shutdown('startup', err);
 });
-//# sourceMappingURL=index.js.map