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

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/benchmark/llm-json.bench.ts

@@ -0,0 +1,96 @@
+import { performance } from 'node:perf_hooks';
+
+import { ErrorCode } from '../src/lib/errors.js';
+import { parseJsonFromLlmResponse } from '../src/lib/llm-json.js';
+
+type BenchResult = {
+  label: string;
+  iterations: number;
+  meanMs: number;
+  p50Ms: number;
+  p95Ms: number;
+  minMs: number;
+  maxMs: number;
+  heapUsedMb: number;
+};
+
+const RAW_JSON = '{"ok":true,"count":2}';
+const CODE_BLOCK_JSON = '```json\n{"ok":true,"count":2}\n```';
+const EMBEDDED_JSON =
+  'Result: {"ok":true,"text":"{value}","items":[{"a":1},{"a":2}]} done';
+
+const ITERATIONS = 15000;
+const WARMUP = 1500;
+
+function percentile(values: number[], p: number): number {
+  if (values.length === 0) return 0;
+  const index = Math.floor((values.length - 1) * p);
+  return values[index] ?? 0;
+}
+
+function round(value: number, digits = 3): number {
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+}
+
+function runBench(label: string, payload: string): BenchResult {
+  if (global.gc) global.gc();
+
+  for (let i = 0; i < WARMUP; i += 1) {
+    parseJsonFromLlmResponse(
+      payload,
+      (value) => value as { ok: boolean; count?: number },
+      { errorCode: ErrorCode.E_INVALID_INPUT }
+    );
+  }
+
+  const times: number[] = new Array(ITERATIONS);
+  const startMem = process.memoryUsage().heapUsed;
+
+  for (let i = 0; i < ITERATIONS; i += 1) {
+    const start = performance.now();
+    parseJsonFromLlmResponse(
+      payload,
+      (value) => value as { ok: boolean; count?: number },
+      { errorCode: ErrorCode.E_INVALID_INPUT }
+    );
+    times[i] = performance.now() - start;
+  }
+
+  if (global.gc) global.gc();
+  const endMem = process.memoryUsage().heapUsed;
+
+  const sorted = [...times].sort((a, b) => a - b);
+  const mean = times.reduce((sum, value) => sum + value, 0) / times.length;
+  const heapUsedMb = endMem / 1024 / 1024;
+
+  return {
+    label,
+    iterations: ITERATIONS,
+    meanMs: round(mean),
+    p50Ms: round(percentile(sorted, 0.5)),
+    p95Ms: round(percentile(sorted, 0.95)),
+    minMs: round(sorted[0] ?? 0),
+    maxMs: round(sorted[sorted.length - 1] ?? 0),
+    heapUsedMb: round(heapUsedMb, 2),
+  };
+}
+
+const results: BenchResult[] = [
+  runBench('parse:raw', RAW_JSON),
+  runBench('parse:codeblock', CODE_BLOCK_JSON),
+  runBench('parse:embedded', EMBEDDED_JSON),
+];
+
+console.log(
+  JSON.stringify(
+    {
+      node: process.version,
+      iterations: ITERATIONS,
+      warmup: WARMUP,
+      results,
+    },
+    null,
+    2
+  )
+);

package/benchmark/output-validation.bench.ts

@@ -0,0 +1,108 @@
+import { performance } from 'node:perf_hooks';
+
+import {
+  normalizePromptText,
+  validateTechniqueOutput,
+} from '../src/lib/output-validation.js';
+
+type BenchResult = {
+  label: string;
+  iterations: number;
+  meanMs: number;
+  p50Ms: number;
+  p95Ms: number;
+  minMs: number;
+  maxMs: number;
+  heapUsedMb: number;
+};
+
+const SAMPLE_NORMALIZE = [
+  '```text\nHello\n```',
+  'Refined Prompt:\n```text\nHello\n```',
+  'Optimized Prompt:\nHello',
+  'Hello world',
+];
+
+const STRUCTURED_OUTPUT = '## Title\n- Item\n';
+const ROLE_OUTPUT = 'You are a helpful assistant.\nReturn a JSON array.';
+
+const ITERATIONS = 20000;
+const WARMUP = 2000;
+
+function percentile(values: number[], p: number): number {
+  if (values.length === 0) return 0;
+  const index = Math.floor((values.length - 1) * p);
+  return values[index] ?? 0;
+}
+
+function round(value: number, digits = 3): number {
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+}
+
+function runBench(label: string, fn: () => void): BenchResult {
+  if (global.gc) global.gc();
+
+  for (let i = 0; i < WARMUP; i += 1) {
+    fn();
+  }
+
+  const times: number[] = new Array(ITERATIONS);
+  const startMem = process.memoryUsage().heapUsed;
+
+  for (let i = 0; i < ITERATIONS; i += 1) {
+    const start = performance.now();
+    fn();
+    times[i] = performance.now() - start;
+  }
+
+  if (global.gc) global.gc();
+  const endMem = process.memoryUsage().heapUsed;
+
+  const sorted = [...times].sort((a, b) => a - b);
+  const mean = times.reduce((sum, value) => sum + value, 0) / times.length;
+  const heapUsedMb = endMem / 1024 / 1024;
+
+  return {
+    label,
+    iterations: ITERATIONS,
+    meanMs: round(mean),
+    p50Ms: round(percentile(sorted, 0.5)),
+    p95Ms: round(percentile(sorted, 0.95)),
+    minMs: round(sorted[0] ?? 0),
+    maxMs: round(sorted[sorted.length - 1] ?? 0),
+    heapUsedMb: round(heapUsedMb, 2),
+  };
+}
+
+let normalizeIndex = 0;
+function nextNormalizeInput(): string {
+  const value = SAMPLE_NORMALIZE[normalizeIndex % SAMPLE_NORMALIZE.length];
+  normalizeIndex += 1;
+  return value ?? '';
+}
+
+const results: BenchResult[] = [
+  runBench('normalizePromptText', () => {
+    normalizePromptText(nextNormalizeInput());
+  }),
+  runBench('validateTechniqueOutput:structured', () => {
+    validateTechniqueOutput(STRUCTURED_OUTPUT, 'structured', 'gpt');
+  }),
+  runBench('validateTechniqueOutput:roleBased', () => {
+    validateTechniqueOutput(ROLE_OUTPUT, 'roleBased', 'gpt');
+  }),
+];
+
+console.log(
+  JSON.stringify(
+    {
+      node: process.version,
+      iterations: ITERATIONS,
+      warmup: WARMUP,
+      results,
+    },
+    null,
+    2
+  )
+);

package/benchmark/prompt-analysis.bench.ts

@@ -0,0 +1,105 @@
+import { performance } from 'node:perf_hooks';
+
+import {
+  buildPatternCache,
+  detectTargetFormat,
+  resolveFormat,
+} from '../src/lib/prompt-analysis.js';
+
+type BenchResult = {
+  label: string;
+  iterations: number;
+  meanMs: number;
+  p50Ms: number;
+  p95Ms: number;
+  minMs: number;
+  maxMs: number;
+  heapUsedMb: number;
+};
+
+const PROMPTS = [
+  'Summarize the following meeting notes and extract action items.\n\nNotes:\n- Discussed Q4 roadmap\n- Risks include vendor delay\n\nOutput: bullet list.',
+  '<system>You are a helpful assistant.</system>\n<task>Return a JSON object with keys a,b,c.</task>',
+  '## Goal\nAnalyze sales data.\n\n**Constraints**\n- Use only 2024 data\n- Return CSV\n',
+  '{"task":"classify","labels":["bug","feature"],"text":"App crashes on launch"}',
+  'Please rewrite this prompt for clarity and include guardrails against injection attacks.',
+];
+
+const ITERATIONS = 20000;
+const WARMUP = 2000;
+
+function percentile(values: number[], p: number): number {
+  if (values.length === 0) return 0;
+  const index = Math.floor((values.length - 1) * p);
+  return values[index] ?? 0;
+}
+
+function round(value: number, digits = 3): number {
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+}
+
+function selectPrompt(index: number): string {
+  return PROMPTS[index % PROMPTS.length] ?? '';
+}
+
+function runBench(label: string, fn: (prompt: string) => void): BenchResult {
+  if (global.gc) global.gc();
+
+  for (let i = 0; i < WARMUP; i += 1) {
+    fn(selectPrompt(i));
+  }
+
+  const times: number[] = new Array(ITERATIONS);
+  const startMem = process.memoryUsage().heapUsed;
+
+  for (let i = 0; i < ITERATIONS; i += 1) {
+    const prompt = selectPrompt(i);
+    const start = performance.now();
+    fn(prompt);
+    times[i] = performance.now() - start;
+  }
+
+  if (global.gc) global.gc();
+  const endMem = process.memoryUsage().heapUsed;
+
+  const sorted = [...times].sort((a, b) => a - b);
+  const mean = times.reduce((sum, value) => sum + value, 0) / times.length;
+  const heapUsedMb = endMem / 1024 / 1024;
+
+  return {
+    label,
+    iterations: ITERATIONS,
+    meanMs: round(mean),
+    p50Ms: round(percentile(sorted, 0.5)),
+    p95Ms: round(percentile(sorted, 0.95)),
+    minMs: round(sorted[0] ?? 0),
+    maxMs: round(sorted[sorted.length - 1] ?? 0),
+    heapUsedMb: round(heapUsedMb, 2),
+  };
+}
+
+const benches: BenchResult[] = [
+  runBench('buildPatternCache', (prompt) => {
+    void buildPatternCache(prompt);
+  }),
+  runBench('detectTargetFormat', (prompt) => {
+    void detectTargetFormat(prompt);
+  }),
+  runBench('resolveFormat:auto', (prompt) => {
+    void resolveFormat('auto', prompt);
+  }),
+];
+
+console.log(
+  JSON.stringify(
+    {
+      node: process.version,
+      iterations: ITERATIONS,
+      warmup: WARMUP,
+      results: benches,
+    },
+    null,
+    2
+  )
+);

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

@@ -28,4 +28,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

@@ -41,4 +41,3 @@ const envSchema = z.object({
     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

@@ -17,4 +17,3 @@ export declare const PATTERNS: {
     readonly qualityIndicators: RegExp;
     readonly antiPatterns: RegExp;
 };
-//# sourceMappingURL=patterns.d.ts.map

package/dist/config/patterns.js

@@ -17,4 +17,3 @@ export const PATTERNS = {
     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

@@ -64,6 +64,10 @@ export interface PatternCache {
     hasBoldOrHeaders: boolean;
     hasAngleBrackets: boolean;
     hasJsonChars: boolean;
+    hasRole: boolean;
+    hasExamples: boolean;
+    hasStepByStep: boolean;
+    isVague: boolean;
 }
 export interface FormatScoringConfig {
     positive: {
@@ -171,4 +175,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

@@ -92,6 +92,12 @@ for (const event of EXIT_EVENTS) {
         void beginShutdown({ event });
     });
 }
+process.stdin.once('end', () => {
+    void beginShutdown({ event: 'stdin_end' });
+});
+process.stdin.once('close', () => {
+    void beginShutdown({ event: 'stdin_close' });
+});
 async function main() {
     await validateApiKeys();
     server = createServer();
@@ -100,4 +106,3 @@ async function main() {
 main().catch((error) => {
     void beginShutdown({ err: error });
 });
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/abort-signals.d.ts

@@ -1,2 +1 @@
 export declare function buildAbortSignal(timeoutMs: number, signal?: AbortSignal): AbortSignal;
-//# sourceMappingURL=abort-signals.d.ts.map

package/dist/lib/abort-signals.js

@@ -2,4 +2,3 @@ export function buildAbortSignal(timeoutMs, signal) {
     const timeoutSignal = AbortSignal.timeout(timeoutMs);
     return signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
 }
-//# sourceMappingURL=abort-signals.js.map

package/dist/lib/errors.d.ts

@@ -13,4 +13,3 @@ export declare class McpError extends Error {
 export declare function createSuccessResponse<T extends Record<string, unknown>>(text: string, structured: T, extraContent?: ContentBlock[]): SuccessResponse<T>;
 export declare function createErrorResponse(error: unknown, fallbackCode?: ErrorCodeType, context?: string): ErrorResponse;
 export { ErrorCode };
-//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.js

@@ -138,4 +138,3 @@ export { ErrorCode };
 function isZodError(error) {
     return typeof error === 'object' && error !== null && 'issues' in error;
 }
-//# sourceMappingURL=errors.js.map

package/dist/lib/llm-client.d.ts

@@ -4,4 +4,3 @@ export declare function getProviderInfo(): Promise<{
     provider: LLMProvider;
     model: string;
 }>;
-//# sourceMappingURL=llm-client.d.ts.map

package/dist/lib/llm-client.js

@@ -54,4 +54,3 @@ export async function getProviderInfo() {
     const client = await getLLMClient();
     return { provider: client.getProvider(), model: client.getModel() };
 }
-//# sourceMappingURL=llm-client.js.map

package/dist/lib/llm-json/scan.d.ts

@@ -0,0 +1 @@
+export declare function extractFirstJsonFragment(text: string): string | null;

package/dist/lib/llm-json/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/lib/llm-json/scan.ts"],"names":[],"mappings":"AAgHA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUpE"}