json-from-llm 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres
 to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.2.1] - 2026-06-07
+
+### Added
+
+- Added provider-style fixtures for fenced OpenAI-like output, multiple fenced
+  candidates, Anthropic-like prose wrappers, malformed drafts before final JSON,
+  truncated streams and unclosed reasoning blocks.
+- Added edge-case coverage for BOM/whitespace, escaped braces in strings,
+  deeply nested JSON and partial malformed input.
+
+### Changed
+
+- Made balanced scanning delimiter-aware so mismatched `{` / `]` drafts and
+  truncated JSON-looking containers are skipped as malformed candidates.
+- Prefer complete fenced payloads across all JSON-ish fences before falling back
+  to lower-confidence balanced fragments inside fenced prose.
+- Treat unclosed reasoning tags as reasoning through the end of the text to
+  avoid extracting valid-looking draft JSON.
+
 ## [0.2.0] - 2026-06-05
 
 ### Added

package/README.md

@@ -35,9 +35,9 @@ const data = extractJson<{ score: number }>(modelOutput);
 
 ## Why
 
-- **Reasoning-model aware.** Strips `<think>` / `<thinking>` blocks first, so brace-laden reasoning (a real cause of `No object generated` failures with DeepSeek R1, Gemini 2.5 thinking, prompted Claude) never gets mistaken for the payload.
+- **Reasoning-model aware.** Strips `<think>` / `<thinking>` blocks first, including unclosed reasoning prefixes, so brace-laden reasoning (a real cause of `No object generated` failures with DeepSeek R1, Gemini 2.5 thinking, prompted Claude) never gets mistaken for the payload.
 - **Handles the real wrappers.** Markdown fences (`json` and bare ```), conversational prose before/after, and the JSON sitting bare in the text.
-- **String-aware, never corrupts.** The scanner and the trailing-comma repair both respect string contents — a `}` or `,` inside `"a string value"` is left alone.
+- **String-aware, delimiter-aware, never corrupts.** The scanner and the trailing-comma repair both respect string contents — a `}` or `,` inside `"a string value"` is left alone, and mismatched or truncated JSON-looking drafts are skipped.
 - **Conservative repair.** Removes trailing commas (the most common malformation); it will never rewrite your data.
 - **Fixture-backed edge cases.** Public fixtures cover reasoning tags, fenced JSON, prose wrappers, trailing commas, top-level type expectations and no-JSON failures.
 - **Two library entry points + CLI.** `extractJson` throws on failure; `tryExtractJson` returns `{ found }`; `json-from-llm` reads stdin for shell pipelines.
@@ -107,23 +107,69 @@ interface ExtractOptions {
 extractJson('[1,2] then the answer {"a":1}', { expect: 'object' }); // { a: 1 }
 ```
 
+### Provider-style snippets
+
+OpenAI-style fenced output:
+
+`````ts
+const value = extractJson<{ score: number }>(
+  `Here is the JSON:
+```json
+{"score":8,"reason":"clear"}
+````,
+  { expect: 'object' },
+);
+`````
+
+Anthropic-style prose around the object:
+
+```ts
+const result = tryExtractJson<{ safe: boolean }>(
+  'I will return the object first.\n{"safe":true}\nLet me know if you need more.',
+  { expect: 'object' },
+);
+```
+
+Gemini-style thinking plus a top-level array:
+
+```ts
+const items = extractJson<Array<{ id: string }>>(
+  '<thinking>{draft: true}</thinking>\n[{"id":"a"}]',
+  { expect: 'array' },
+);
+```
+
 ### Algorithm
 
-1. Strip `<think>` / `<thinking>` / `<reasoning>` blocks.
-2. Prefer the contents of fenced `json (or bare `) code blocks.
-3. Otherwise scan for the first balanced `{…}` / `[…]` that parses, string-aware.
-4. If parsing fails, apply conservative repair (trailing commas) and retry.
+1. Strip `<think>` / `<thinking>` / `<reasoning>` blocks. If a reasoning tag is opened and never closed, treat the rest as reasoning.
+2. Prefer complete contents of fenced `json` (or bare) code blocks.
+3. If a fence contains prose, scan inside those fences for balanced JSON after complete fence payloads have been tried.
+4. Otherwise scan for the first balanced `{…}` / `[…]` that parses, string-aware and delimiter-aware.
+5. If parsing fails, apply conservative repair (trailing commas) and retry.
 
 The low-level pieces (`stripReasoning`, `fencedBlocks`, `balancedSpans`, `removeTrailingCommas`) are exported too.
 
+### Caveats
+
+- TypeScript generics do not validate runtime shape. Pair this with your schema validator when fields matter.
+- Repair is intentionally narrow: trailing commas only. It will not convert JSON5, comments, single quotes or unquoted keys.
+- Candidate order is deterministic: JSON-ish fences first, then balanced objects/arrays in document order, filtered by `expect`.
+- Unclosed reasoning tags return no JSON from that suffix instead of risking a draft extraction.
+
 ## Fixture corpus
 
 The package includes a small public corpus under [`fixtures/`](./fixtures):
 
 - `deepseek-thinking-object.txt`
 - `gemini-reasoning-array.txt`
+- `openai-fenced-object.txt`
+- `multiple-fenced-final.txt`
+- `anthropic-prose-object.txt`
 - `prose-trailing-commas.txt`
+- `malformed-draft-valid-final.txt`
 - `expect-object-skips-array.txt`
+- `truncated-stream-no-json.txt`
+- `unclosed-thinking-no-json.txt`
 - `no-json.txt`
 - expected `tryExtractJson` outputs under `fixtures/expected/`
 

package/dist/cli.js

@@ -48,19 +48,21 @@ function balancedSpans(text) {
   while (i < text.length) {
     const ch = text[i];
     if (ch === "{" || ch === "[") {
-      const end = matchBalanced(text, i);
-      if (end !== -1) {
-        spans.push(text.slice(i, end));
-        i = end;
+      const match = matchBalanced(text, i);
+      if (match.end !== -1) {
+        spans.push(text.slice(i, match.end));
+        i = match.end;
         continue;
       }
+      i = Math.max(match.resume, i + 1);
+      continue;
     }
     i++;
   }
   return spans;
 }
 function matchBalanced(text, start) {
-  let depth = 0;
+  const expectedClosers = [];
   let inString = false;
   let escaped = false;
   for (let i = start; i < text.length; i++) {
@@ -77,22 +79,53 @@ function matchBalanced(text, start) {
     }
     if (ch === '"') {
       inString = true;
-    } else if (ch === "{" || ch === "[") {
-      depth++;
-    } else if (ch === "}" || ch === "]") {
-      depth--;
-      if (depth === 0) {
-        return i + 1;
+      continue;
+    }
+    if (ch === "{") {
+      expectedClosers.push("}");
+      continue;
+    }
+    if (ch === "[") {
+      expectedClosers.push("]");
+      continue;
+    }
+    if (ch === "}" || ch === "]") {
+      if (expectedClosers.pop() !== ch) {
+        return { end: -1, resume: i + 1 };
+      }
+      if (expectedClosers.length === 0) {
+        return { end: i + 1, resume: i + 1 };
       }
     }
   }
-  return -1;
+  return {
+    end: -1,
+    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1
+  };
+}
+function looksLikeJsonContainerStart(text, start) {
+  let index = start + 1;
+  while (index < text.length && /\s/.test(text[index])) {
+    index++;
+  }
+  const next = text[index];
+  if (text[start] === "{") {
+    return next === '"' || next === "}";
+  }
+  return next === void 0 || next === "[" || next === "{" || next === '"' || next === "]" || next === "-" || next >= "0" && next <= "9" || next === "t" || next === "f" || next === "n";
 }
 
 // src/strip.ts
-var REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\s\S]*?<\/\1>/gi;
+var CLOSED_REASONING_BLOCK = /<(think|thinking|reasoning|thought)\b[^>]*>[\s\S]*?<\/\1>/gi;
+var OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\b[^>]*>/gi;
 function stripReasoning(text) {
-  return text.replace(REASONING_TAGS, "");
+  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, "");
+  OPEN_REASONING_TAG.lastIndex = 0;
+  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);
+  if (!unclosed) {
+    return withoutClosedBlocks;
+  }
+  return withoutClosedBlocks.slice(0, unclosed.index);
 }
 var FENCE = /```[^\S\n]*([a-zA-Z0-9_+-]*)[^\S\n]*\n?([\s\S]*?)```/g;
 function fencedBlocks(text) {
@@ -150,8 +183,10 @@ function tryExtractJson(text, options = {}) {
   const expect = options.expect ?? "any";
   const cleaned = stripReasoning(text);
   const candidates = [];
-  for (const block of fencedBlocks(cleaned)) {
-    candidates.push(block, ...balancedSpans(block));
+  const blocks = fencedBlocks(cleaned);
+  candidates.push(...blocks);
+  for (const block of blocks) {
+    candidates.push(...balancedSpans(block));
   }
   candidates.push(...balancedSpans(cleaned));
   for (const candidate of candidates) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { extractJson } from './extract.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions } from './types.ts';\n\nexport interface CliStreams {\n  stdout: (chunk: string) => void;\n  stderr: (chunk: string) => void;\n}\n\ninterface CliConfig extends ExtractOptions {\n  help: boolean;\n}\n\nconst usage = `Usage: json-from-llm [--expect object|array|any] [--no-repair]\n\nRead LLM output from stdin and print the extracted JSON value to stdout.\n\nOptions:\n  --expect <type>  Require the top-level JSON value to be object, array or any.\n  --no-repair     Disable conservative trailing-comma repair.\n  -h, --help      Show this help text.\n`;\n\nfunction parseArgs(args: string[]): CliConfig | string {\n  const config: CliConfig = { help: false };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg === '-h' || arg === '--help') {\n      config.help = true;\n      continue;\n    }\n\n    if (arg === '--no-repair') {\n      config.repair = false;\n      continue;\n    }\n\n    if (arg === '--expect') {\n      const value = args[index + 1];\n      if (value !== 'object' && value !== 'array' && value !== 'any') {\n        return 'invalid --expect value; use object, array or any';\n      }\n      config.expect = value;\n      index += 1;\n      continue;\n    }\n\n    return `unknown option: ${arg}`;\n  }\n\n  return config;\n}\n\nexport async function runCli(\n  args: string[],\n  stdin: string,\n  streams: CliStreams,\n): Promise<number> {\n  const config = parseArgs(args);\n\n  if (typeof config === 'string') {\n    streams.stderr(`json-from-llm: ${config}\\n`);\n    return 2;\n  }\n\n  if (config.help) {\n    streams.stdout(usage);\n    return 0;\n  }\n\n  try {\n    const value = extractJson(stdin, config);\n    streams.stdout(`${JSON.stringify(value)}\\n`);\n    return 0;\n  } catch (error) {\n    if (error instanceof JsonExtractionError) {\n      streams.stderr('json-from-llm: no JSON found\\n');\n      return 1;\n    }\n\n    streams.stderr(\n      `json-from-llm: ${error instanceof Error ? error.message : String(error)}\\n`,\n    );\n    return 1;\n  }\n}\n\nasync function readStdin(): Promise<string> {\n  process.stdin.setEncoding('utf8');\n  let input = '';\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n  return input;\n}\n\nexport function isExecutedFile(moduleUrl: string, argvPath?: string): boolean {\n  if (!argvPath) {\n    return false;\n  }\n\n  try {\n    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argvPath);\n  } catch {\n    return false;\n  }\n}\n\nfunction isMain(): boolean {\n  return isExecutedFile(import.meta.url, process.argv[1]);\n}\n\nasync function main(): Promise<void> {\n  process.exitCode = await runCli(process.argv.slice(2), await readStdin(), {\n    stdout: (chunk) => {\n      process.stdout.write(chunk);\n    },\n    stderr: (chunk) => {\n      process.stderr.write(chunk);\n    },\n  });\n}\n\nif (isMain()) {\n  void main();\n}\n","/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware: braces and brackets inside JSON strings do\n * not affect nesting, so prose like `\"the } char\"` won't break the scan.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const end = matchBalanced(text, i);\n      if (end !== -1) {\n        spans.push(text.slice(i, end));\n        i = end;\n        continue;\n      }\n    }\n    i++;\n  }\n  return spans;\n}\n\n/** Return the index just past the balanced value starting at `start`, or -1. */\nfunction matchBalanced(text: string, start: number): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n    } else if (ch === '{' || ch === '[') {\n      depth++;\n    } else if (ch === '}' || ch === ']') {\n      depth--;\n      if (depth === 0) {\n        return i + 1;\n      }\n    }\n  }\n\n  return -1;\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n */\nconst REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\\s\\S]*?<\\/\\1>/gi;\n\nexport function stripReasoning(text: string): string {\n  return text.replace(REASONING_TAGS, '');\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  for (const block of fencedBlocks(cleaned)) {\n    candidates.push(block, ...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts","../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { extractJson } from './extract.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions } from './types.ts';\n\nexport interface CliStreams {\n  stdout: (chunk: string) => void;\n  stderr: (chunk: string) => void;\n}\n\ninterface CliConfig extends ExtractOptions {\n  help: boolean;\n}\n\nconst usage = `Usage: json-from-llm [--expect object|array|any] [--no-repair]\n\nRead LLM output from stdin and print the extracted JSON value to stdout.\n\nOptions:\n  --expect <type>  Require the top-level JSON value to be object, array or any.\n  --no-repair     Disable conservative trailing-comma repair.\n  -h, --help      Show this help text.\n`;\n\nfunction parseArgs(args: string[]): CliConfig | string {\n  const config: CliConfig = { help: false };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg === '-h' || arg === '--help') {\n      config.help = true;\n      continue;\n    }\n\n    if (arg === '--no-repair') {\n      config.repair = false;\n      continue;\n    }\n\n    if (arg === '--expect') {\n      const value = args[index + 1];\n      if (value !== 'object' && value !== 'array' && value !== 'any') {\n        return 'invalid --expect value; use object, array or any';\n      }\n      config.expect = value;\n      index += 1;\n      continue;\n    }\n\n    return `unknown option: ${arg}`;\n  }\n\n  return config;\n}\n\nexport async function runCli(\n  args: string[],\n  stdin: string,\n  streams: CliStreams,\n): Promise<number> {\n  const config = parseArgs(args);\n\n  if (typeof config === 'string') {\n    streams.stderr(`json-from-llm: ${config}\\n`);\n    return 2;\n  }\n\n  if (config.help) {\n    streams.stdout(usage);\n    return 0;\n  }\n\n  try {\n    const value = extractJson(stdin, config);\n    streams.stdout(`${JSON.stringify(value)}\\n`);\n    return 0;\n  } catch (error) {\n    if (error instanceof JsonExtractionError) {\n      streams.stderr('json-from-llm: no JSON found\\n');\n      return 1;\n    }\n\n    streams.stderr(\n      `json-from-llm: ${error instanceof Error ? error.message : String(error)}\\n`,\n    );\n    return 1;\n  }\n}\n\nasync function readStdin(): Promise<string> {\n  process.stdin.setEncoding('utf8');\n  let input = '';\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n  return input;\n}\n\nexport function isExecutedFile(moduleUrl: string, argvPath?: string): boolean {\n  if (!argvPath) {\n    return false;\n  }\n\n  try {\n    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argvPath);\n  } catch {\n    return false;\n  }\n}\n\nfunction isMain(): boolean {\n  return isExecutedFile(import.meta.url, process.argv[1]);\n}\n\nasync function main(): Promise<void> {\n  process.exitCode = await runCli(process.argv.slice(2), await readStdin(), {\n    stdout: (chunk) => {\n      process.stdout.write(chunk);\n    },\n    stderr: (chunk) => {\n      process.stderr.write(chunk);\n    },\n  });\n}\n\nif (isMain()) {\n  void main();\n}\n","/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware and delimiter-aware: braces and brackets\n * inside JSON strings do not affect nesting, and `[` must close with `]`.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const match = matchBalanced(text, i);\n      if (match.end !== -1) {\n        spans.push(text.slice(i, match.end));\n        i = match.end;\n        continue;\n      }\n\n      i = Math.max(match.resume, i + 1);\n      continue;\n    }\n    i++;\n  }\n  return spans;\n}\n\ninterface MatchResult {\n  /** Index just past the balanced value, or -1 when no complete value exists. */\n  end: number;\n  /** Next scan index after a malformed or incomplete candidate. */\n  resume: number;\n}\n\nfunction matchBalanced(text: string, start: number): MatchResult {\n  const expectedClosers: string[] = [];\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      continue;\n    }\n\n    if (ch === '{') {\n      expectedClosers.push('}');\n      continue;\n    }\n\n    if (ch === '[') {\n      expectedClosers.push(']');\n      continue;\n    }\n\n    if (ch === '}' || ch === ']') {\n      if (expectedClosers.pop() !== ch) {\n        return { end: -1, resume: i + 1 };\n      }\n      if (expectedClosers.length === 0) {\n        return { end: i + 1, resume: i + 1 };\n      }\n    }\n  }\n\n  return {\n    end: -1,\n    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1,\n  };\n}\n\nfunction looksLikeJsonContainerStart(text: string, start: number): boolean {\n  let index = start + 1;\n  while (index < text.length && /\\s/.test(text[index])) {\n    index++;\n  }\n\n  const next = text[index];\n  if (text[start] === '{') {\n    return next === '\"' || next === '}';\n  }\n\n  return (\n    next === undefined ||\n    next === '[' ||\n    next === '{' ||\n    next === '\"' ||\n    next === ']' ||\n    next === '-' ||\n    (next >= '0' && next <= '9') ||\n    next === 't' ||\n    next === 'f' ||\n    next === 'n'\n  );\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n *\n * If a reasoning tag is opened but not closed, treat the rest of the text as\n * reasoning. Returning no JSON is safer than extracting a valid-looking draft.\n */\nconst CLOSED_REASONING_BLOCK =\n  /<(think|thinking|reasoning|thought)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi;\nconst OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\\b[^>]*>/gi;\n\nexport function stripReasoning(text: string): string {\n  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, '');\n  OPEN_REASONING_TAG.lastIndex = 0;\n  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);\n\n  if (!unclosed) {\n    return withoutClosedBlocks;\n  }\n\n  return withoutClosedBlocks.slice(0, unclosed.index);\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  const blocks = fencedBlocks(cleaned);\n  candidates.push(...blocks);\n  for (const block of blocks) {\n    candidates.push(...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -74,19 +74,21 @@ function balancedSpans(text) {
   while (i < text.length) {
     const ch = text[i];
     if (ch === "{" || ch === "[") {
-      const end = matchBalanced(text, i);
-      if (end !== -1) {
-        spans.push(text.slice(i, end));
-        i = end;
+      const match = matchBalanced(text, i);
+      if (match.end !== -1) {
+        spans.push(text.slice(i, match.end));
+        i = match.end;
         continue;
       }
+      i = Math.max(match.resume, i + 1);
+      continue;
     }
     i++;
   }
   return spans;
 }
 function matchBalanced(text, start) {
-  let depth = 0;
+  const expectedClosers = [];
   let inString = false;
   let escaped = false;
   for (let i = start; i < text.length; i++) {
@@ -103,22 +105,53 @@ function matchBalanced(text, start) {
     }
     if (ch === '"') {
       inString = true;
-    } else if (ch === "{" || ch === "[") {
-      depth++;
-    } else if (ch === "}" || ch === "]") {
-      depth--;
-      if (depth === 0) {
-        return i + 1;
+      continue;
+    }
+    if (ch === "{") {
+      expectedClosers.push("}");
+      continue;
+    }
+    if (ch === "[") {
+      expectedClosers.push("]");
+      continue;
+    }
+    if (ch === "}" || ch === "]") {
+      if (expectedClosers.pop() !== ch) {
+        return { end: -1, resume: i + 1 };
+      }
+      if (expectedClosers.length === 0) {
+        return { end: i + 1, resume: i + 1 };
       }
     }
   }
-  return -1;
+  return {
+    end: -1,
+    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1
+  };
+}
+function looksLikeJsonContainerStart(text, start) {
+  let index = start + 1;
+  while (index < text.length && /\s/.test(text[index])) {
+    index++;
+  }
+  const next = text[index];
+  if (text[start] === "{") {
+    return next === '"' || next === "}";
+  }
+  return next === void 0 || next === "[" || next === "{" || next === '"' || next === "]" || next === "-" || next >= "0" && next <= "9" || next === "t" || next === "f" || next === "n";
 }
 
 // src/strip.ts
-var REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\s\S]*?<\/\1>/gi;
+var CLOSED_REASONING_BLOCK = /<(think|thinking|reasoning|thought)\b[^>]*>[\s\S]*?<\/\1>/gi;
+var OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\b[^>]*>/gi;
 function stripReasoning(text) {
-  return text.replace(REASONING_TAGS, "");
+  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, "");
+  OPEN_REASONING_TAG.lastIndex = 0;
+  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);
+  if (!unclosed) {
+    return withoutClosedBlocks;
+  }
+  return withoutClosedBlocks.slice(0, unclosed.index);
 }
 var FENCE = /```[^\S\n]*([a-zA-Z0-9_+-]*)[^\S\n]*\n?([\s\S]*?)```/g;
 function fencedBlocks(text) {
@@ -176,8 +209,10 @@ function tryExtractJson(text, options = {}) {
   const expect = options.expect ?? "any";
   const cleaned = stripReasoning(text);
   const candidates = [];
-  for (const block of fencedBlocks(cleaned)) {
-    candidates.push(block, ...balancedSpans(block));
+  const blocks = fencedBlocks(cleaned);
+  candidates.push(...blocks);
+  for (const block of blocks) {
+    candidates.push(...balancedSpans(block));
   }
   candidates.push(...balancedSpans(cleaned));
   for (const candidate of candidates) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["export { extractJson, tryExtractJson } from './extract.ts';\nexport { stripReasoning, fencedBlocks } from './strip.ts';\nexport { balancedSpans } from './scan.ts';\nexport { removeTrailingCommas } from './repair.ts';\nexport { JsonExtractionError } from './types.ts';\nexport type { ExtractOptions, ExtractResult } from './types.ts';\n","/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware: braces and brackets inside JSON strings do\n * not affect nesting, so prose like `\"the } char\"` won't break the scan.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const end = matchBalanced(text, i);\n      if (end !== -1) {\n        spans.push(text.slice(i, end));\n        i = end;\n        continue;\n      }\n    }\n    i++;\n  }\n  return spans;\n}\n\n/** Return the index just past the balanced value starting at `start`, or -1. */\nfunction matchBalanced(text: string, start: number): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n    } else if (ch === '{' || ch === '[') {\n      depth++;\n    } else if (ch === '}' || ch === ']') {\n      depth--;\n      if (depth === 0) {\n        return i + 1;\n      }\n    }\n  }\n\n  return -1;\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n */\nconst REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\\s\\S]*?<\\/\\1>/gi;\n\nexport function stripReasoning(text: string): string {\n  return text.replace(REASONING_TAGS, '');\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  for (const block of fencedBlocks(cleaned)) {\n    candidates.push(block, ...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["export { extractJson, tryExtractJson } from './extract.ts';\nexport { stripReasoning, fencedBlocks } from './strip.ts';\nexport { balancedSpans } from './scan.ts';\nexport { removeTrailingCommas } from './repair.ts';\nexport { JsonExtractionError } from './types.ts';\nexport type { ExtractOptions, ExtractResult } from './types.ts';\n","/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware and delimiter-aware: braces and brackets\n * inside JSON strings do not affect nesting, and `[` must close with `]`.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const match = matchBalanced(text, i);\n      if (match.end !== -1) {\n        spans.push(text.slice(i, match.end));\n        i = match.end;\n        continue;\n      }\n\n      i = Math.max(match.resume, i + 1);\n      continue;\n    }\n    i++;\n  }\n  return spans;\n}\n\ninterface MatchResult {\n  /** Index just past the balanced value, or -1 when no complete value exists. */\n  end: number;\n  /** Next scan index after a malformed or incomplete candidate. */\n  resume: number;\n}\n\nfunction matchBalanced(text: string, start: number): MatchResult {\n  const expectedClosers: string[] = [];\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      continue;\n    }\n\n    if (ch === '{') {\n      expectedClosers.push('}');\n      continue;\n    }\n\n    if (ch === '[') {\n      expectedClosers.push(']');\n      continue;\n    }\n\n    if (ch === '}' || ch === ']') {\n      if (expectedClosers.pop() !== ch) {\n        return { end: -1, resume: i + 1 };\n      }\n      if (expectedClosers.length === 0) {\n        return { end: i + 1, resume: i + 1 };\n      }\n    }\n  }\n\n  return {\n    end: -1,\n    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1,\n  };\n}\n\nfunction looksLikeJsonContainerStart(text: string, start: number): boolean {\n  let index = start + 1;\n  while (index < text.length && /\\s/.test(text[index])) {\n    index++;\n  }\n\n  const next = text[index];\n  if (text[start] === '{') {\n    return next === '\"' || next === '}';\n  }\n\n  return (\n    next === undefined ||\n    next === '[' ||\n    next === '{' ||\n    next === '\"' ||\n    next === ']' ||\n    next === '-' ||\n    (next >= '0' && next <= '9') ||\n    next === 't' ||\n    next === 'f' ||\n    next === 'n'\n  );\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n *\n * If a reasoning tag is opened but not closed, treat the rest of the text as\n * reasoning. Returning no JSON is safer than extracting a valid-looking draft.\n */\nconst CLOSED_REASONING_BLOCK =\n  /<(think|thinking|reasoning|thought)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi;\nconst OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\\b[^>]*>/gi;\n\nexport function stripReasoning(text: string): string {\n  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, '');\n  OPEN_REASONING_TAG.lastIndex = 0;\n  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);\n\n  if (!unclosed) {\n    return withoutClosedBlocks;\n  }\n\n  return withoutClosedBlocks.slice(0, unclosed.index);\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  const blocks = fencedBlocks(cleaned);\n  candidates.push(...blocks);\n  for (const block of blocks) {\n    candidates.push(...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -54,8 +54,8 @@ declare function fencedBlocks(text: string): string[];
 
 /**
  * Find the substrings of complete, balanced JSON objects/arrays in `text`,
- * in document order. String-aware: braces and brackets inside JSON strings do
- * not affect nesting, so prose like `"the } char"` won't break the scan.
+ * in document order. String-aware and delimiter-aware: braces and brackets
+ * inside JSON strings do not affect nesting, and `[` must close with `]`.
  */
 declare function balancedSpans(text: string): string[];
 

package/dist/index.d.ts

@@ -54,8 +54,8 @@ declare function fencedBlocks(text: string): string[];
 
 /**
  * Find the substrings of complete, balanced JSON objects/arrays in `text`,
- * in document order. String-aware: braces and brackets inside JSON strings do
- * not affect nesting, so prose like `"the } char"` won't break the scan.
+ * in document order. String-aware and delimiter-aware: braces and brackets
+ * inside JSON strings do not affect nesting, and `[` must close with `]`.
  */
 declare function balancedSpans(text: string): string[];
 

package/dist/index.js

@@ -42,19 +42,21 @@ function balancedSpans(text) {
   while (i < text.length) {
     const ch = text[i];
     if (ch === "{" || ch === "[") {
-      const end = matchBalanced(text, i);
-      if (end !== -1) {
-        spans.push(text.slice(i, end));
-        i = end;
+      const match = matchBalanced(text, i);
+      if (match.end !== -1) {
+        spans.push(text.slice(i, match.end));
+        i = match.end;
         continue;
       }
+      i = Math.max(match.resume, i + 1);
+      continue;
     }
     i++;
   }
   return spans;
 }
 function matchBalanced(text, start) {
-  let depth = 0;
+  const expectedClosers = [];
   let inString = false;
   let escaped = false;
   for (let i = start; i < text.length; i++) {
@@ -71,22 +73,53 @@ function matchBalanced(text, start) {
     }
     if (ch === '"') {
       inString = true;
-    } else if (ch === "{" || ch === "[") {
-      depth++;
-    } else if (ch === "}" || ch === "]") {
-      depth--;
-      if (depth === 0) {
-        return i + 1;
+      continue;
+    }
+    if (ch === "{") {
+      expectedClosers.push("}");
+      continue;
+    }
+    if (ch === "[") {
+      expectedClosers.push("]");
+      continue;
+    }
+    if (ch === "}" || ch === "]") {
+      if (expectedClosers.pop() !== ch) {
+        return { end: -1, resume: i + 1 };
+      }
+      if (expectedClosers.length === 0) {
+        return { end: i + 1, resume: i + 1 };
       }
     }
   }
-  return -1;
+  return {
+    end: -1,
+    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1
+  };
+}
+function looksLikeJsonContainerStart(text, start) {
+  let index = start + 1;
+  while (index < text.length && /\s/.test(text[index])) {
+    index++;
+  }
+  const next = text[index];
+  if (text[start] === "{") {
+    return next === '"' || next === "}";
+  }
+  return next === void 0 || next === "[" || next === "{" || next === '"' || next === "]" || next === "-" || next >= "0" && next <= "9" || next === "t" || next === "f" || next === "n";
 }
 
 // src/strip.ts
-var REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\s\S]*?<\/\1>/gi;
+var CLOSED_REASONING_BLOCK = /<(think|thinking|reasoning|thought)\b[^>]*>[\s\S]*?<\/\1>/gi;
+var OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\b[^>]*>/gi;
 function stripReasoning(text) {
-  return text.replace(REASONING_TAGS, "");
+  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, "");
+  OPEN_REASONING_TAG.lastIndex = 0;
+  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);
+  if (!unclosed) {
+    return withoutClosedBlocks;
+  }
+  return withoutClosedBlocks.slice(0, unclosed.index);
 }
 var FENCE = /```[^\S\n]*([a-zA-Z0-9_+-]*)[^\S\n]*\n?([\s\S]*?)```/g;
 function fencedBlocks(text) {
@@ -144,8 +177,10 @@ function tryExtractJson(text, options = {}) {
   const expect = options.expect ?? "any";
   const cleaned = stripReasoning(text);
   const candidates = [];
-  for (const block of fencedBlocks(cleaned)) {
-    candidates.push(block, ...balancedSpans(block));
+  const blocks = fencedBlocks(cleaned);
+  candidates.push(...blocks);
+  for (const block of blocks) {
+    candidates.push(...balancedSpans(block));
   }
   candidates.push(...balancedSpans(cleaned));
   for (const candidate of candidates) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware: braces and brackets inside JSON strings do\n * not affect nesting, so prose like `\"the } char\"` won't break the scan.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const end = matchBalanced(text, i);\n      if (end !== -1) {\n        spans.push(text.slice(i, end));\n        i = end;\n        continue;\n      }\n    }\n    i++;\n  }\n  return spans;\n}\n\n/** Return the index just past the balanced value starting at `start`, or -1. */\nfunction matchBalanced(text: string, start: number): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n    } else if (ch === '{' || ch === '[') {\n      depth++;\n    } else if (ch === '}' || ch === ']') {\n      depth--;\n      if (depth === 0) {\n        return i + 1;\n      }\n    }\n  }\n\n  return -1;\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n */\nconst REASONING_TAGS = /<(think|thinking|reasoning|thought)>[\\s\\S]*?<\\/\\1>/gi;\n\nexport function stripReasoning(text: string): string {\n  return text.replace(REASONING_TAGS, '');\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  for (const block of fencedBlocks(cleaned)) {\n    candidates.push(block, ...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/repair.ts","../src/scan.ts","../src/strip.ts","../src/types.ts","../src/extract.ts"],"sourcesContent":["/**\n * Remove trailing commas (`{\"a\":1,}` → `{\"a\":1}`, `[1,2,]` → `[1,2]`), which\n * models emit frequently. String-aware: a comma inside a string value is never\n * touched, so this can only ever fix structure, never corrupt content.\n */\nexport function removeTrailingCommas(json: string): string {\n  let out = '';\n  let inString = false;\n  let escaped = false;\n\n  for (let i = 0; i < json.length; i++) {\n    const ch = json[i];\n\n    if (inString) {\n      out += ch;\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      out += ch;\n      continue;\n    }\n\n    if (ch === ',') {\n      let j = i + 1;\n      while (\n        j < json.length &&\n        (json[j] === ' ' ||\n          json[j] === '\\n' ||\n          json[j] === '\\r' ||\n          json[j] === '\\t')\n      ) {\n        j++;\n      }\n      if (json[j] === '}' || json[j] === ']') {\n        continue; // drop the trailing comma\n      }\n    }\n\n    out += ch;\n  }\n\n  return out;\n}\n","/**\n * Find the substrings of complete, balanced JSON objects/arrays in `text`,\n * in document order. String-aware and delimiter-aware: braces and brackets\n * inside JSON strings do not affect nesting, and `[` must close with `]`.\n */\nexport function balancedSpans(text: string): string[] {\n  const spans: string[] = [];\n  let i = 0;\n  while (i < text.length) {\n    const ch = text[i];\n    if (ch === '{' || ch === '[') {\n      const match = matchBalanced(text, i);\n      if (match.end !== -1) {\n        spans.push(text.slice(i, match.end));\n        i = match.end;\n        continue;\n      }\n\n      i = Math.max(match.resume, i + 1);\n      continue;\n    }\n    i++;\n  }\n  return spans;\n}\n\ninterface MatchResult {\n  /** Index just past the balanced value, or -1 when no complete value exists. */\n  end: number;\n  /** Next scan index after a malformed or incomplete candidate. */\n  resume: number;\n}\n\nfunction matchBalanced(text: string, start: number): MatchResult {\n  const expectedClosers: string[] = [];\n  let inString = false;\n  let escaped = false;\n\n  for (let i = start; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inString) {\n      if (escaped) {\n        escaped = false;\n      } else if (ch === '\\\\') {\n        escaped = true;\n      } else if (ch === '\"') {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (ch === '\"') {\n      inString = true;\n      continue;\n    }\n\n    if (ch === '{') {\n      expectedClosers.push('}');\n      continue;\n    }\n\n    if (ch === '[') {\n      expectedClosers.push(']');\n      continue;\n    }\n\n    if (ch === '}' || ch === ']') {\n      if (expectedClosers.pop() !== ch) {\n        return { end: -1, resume: i + 1 };\n      }\n      if (expectedClosers.length === 0) {\n        return { end: i + 1, resume: i + 1 };\n      }\n    }\n  }\n\n  return {\n    end: -1,\n    resume: looksLikeJsonContainerStart(text, start) ? text.length : start + 1,\n  };\n}\n\nfunction looksLikeJsonContainerStart(text: string, start: number): boolean {\n  let index = start + 1;\n  while (index < text.length && /\\s/.test(text[index])) {\n    index++;\n  }\n\n  const next = text[index];\n  if (text[start] === '{') {\n    return next === '\"' || next === '}';\n  }\n\n  return (\n    next === undefined ||\n    next === '[' ||\n    next === '{' ||\n    next === '\"' ||\n    next === ']' ||\n    next === '-' ||\n    (next >= '0' && next <= '9') ||\n    next === 't' ||\n    next === 'f' ||\n    next === 'n'\n  );\n}\n","/**\n * Remove model \"thinking\" / reasoning blocks. Reasoning models (DeepSeek R1,\n * Qwen, and prompted Claude/Gemini setups) emit `<think>…</think>` or\n * `<thinking>…</thinking>` before the answer, and that text frequently contains\n * brace-laden prose that would otherwise be mistaken for the payload.\n *\n * If a reasoning tag is opened but not closed, treat the rest of the text as\n * reasoning. Returning no JSON is safer than extracting a valid-looking draft.\n */\nconst CLOSED_REASONING_BLOCK =\n  /<(think|thinking|reasoning|thought)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi;\nconst OPEN_REASONING_TAG = /<(think|thinking|reasoning|thought)\\b[^>]*>/gi;\n\nexport function stripReasoning(text: string): string {\n  const withoutClosedBlocks = text.replace(CLOSED_REASONING_BLOCK, '');\n  OPEN_REASONING_TAG.lastIndex = 0;\n  const unclosed = OPEN_REASONING_TAG.exec(withoutClosedBlocks);\n\n  if (!unclosed) {\n    return withoutClosedBlocks;\n  }\n\n  return withoutClosedBlocks.slice(0, unclosed.index);\n}\n\n/**\n * Return the inner contents of fenced code blocks that could hold JSON: blocks\n * tagged ```json / ```jsonc / ```json5, or untagged ``` blocks. Other languages\n * (```python, ```ts) are skipped — they won't contain the answer JSON.\n */\nconst FENCE = /```[^\\S\\n]*([a-zA-Z0-9_+-]*)[^\\S\\n]*\\n?([\\s\\S]*?)```/g;\n\nexport function fencedBlocks(text: string): string[] {\n  const blocks: string[] = [];\n  FENCE.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = FENCE.exec(text)) !== null) {\n    const lang = match[1].toLowerCase();\n    const content = match[2].trim();\n    if (content.length > 0 && (lang === '' || lang.includes('json'))) {\n      blocks.push(content);\n    }\n  }\n  return blocks;\n}\n","/** Options for {@link extractJson} and {@link tryExtractJson}. */\nexport interface ExtractOptions {\n  /**\n   * Apply conservative, string-aware repairs before parsing — currently the\n   * removal of trailing commas, which models emit often. Never rewrites string\n   * contents. Default `true`.\n   */\n  repair?: boolean;\n  /**\n   * Restrict which top-level JSON value to accept: an `'object'`, an `'array'`,\n   * or `'any'` (the default).\n   */\n  expect?: 'object' | 'array' | 'any';\n}\n\n/** The result of {@link tryExtractJson}. */\nexport type ExtractResult<T> =\n  | { found: true; value: T }\n  | { found: false; value?: undefined };\n\n/** Thrown by {@link extractJson} when no JSON value can be recovered. */\nexport class JsonExtractionError extends Error {\n  constructor(\n    message: string,\n    /** The original text that no JSON could be extracted from. */\n    public readonly text: string,\n  ) {\n    super(message);\n    this.name = 'JsonExtractionError';\n  }\n}\n","import { removeTrailingCommas } from './repair.ts';\nimport { balancedSpans } from './scan.ts';\nimport { fencedBlocks, stripReasoning } from './strip.ts';\nimport { JsonExtractionError } from './types.ts';\nimport type { ExtractOptions, ExtractResult } from './types.ts';\n\nfunction parseCandidate(\n  candidate: string,\n  repair: boolean,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(candidate) };\n  } catch {\n    // fall through to repair\n  }\n  if (repair) {\n    try {\n      return { ok: true, value: JSON.parse(removeTrailingCommas(candidate)) };\n    } catch {\n      // unrecoverable\n    }\n  }\n  return { ok: false };\n}\n\nfunction matchesExpect(\n  value: unknown,\n  expect: 'object' | 'array' | 'any',\n): boolean {\n  if (expect === 'any') {\n    return true;\n  }\n  if (expect === 'array') {\n    return Array.isArray(value);\n  }\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract a JSON value from LLM output without throwing.\n *\n * Strips `<think>` / `<thinking>` reasoning blocks, prefers fenced ```json\n * code blocks, then scans for the first balanced object/array that parses\n * (applying conservative repair). Returns `{ found: false }` if nothing parses.\n *\n * @example\n * ```ts\n * const r = tryExtractJson<{ score: number }>('<think>...</think>\\n{\"score\":7}');\n * if (r.found) console.log(r.value.score); // 7\n * ```\n */\nexport function tryExtractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): ExtractResult<T> {\n  if (typeof text !== 'string' || text.length === 0) {\n    return { found: false };\n  }\n\n  const repair = options.repair ?? true;\n  const expect = options.expect ?? 'any';\n  const cleaned = stripReasoning(text);\n\n  // Candidate substrings, highest confidence first: fenced blocks (and any\n  // balanced values inside them), then balanced values anywhere in the text.\n  const candidates: string[] = [];\n  const blocks = fencedBlocks(cleaned);\n  candidates.push(...blocks);\n  for (const block of blocks) {\n    candidates.push(...balancedSpans(block));\n  }\n  candidates.push(...balancedSpans(cleaned));\n\n  for (const candidate of candidates) {\n    const parsed = parseCandidate(candidate, repair);\n    if (parsed.ok && matchesExpect(parsed.value, expect)) {\n      return { found: true, value: parsed.value as T };\n    }\n  }\n  return { found: false };\n}\n\n/**\n * Extract a JSON value from LLM output, throwing {@link JsonExtractionError}\n * if none can be recovered. See {@link tryExtractJson} for the algorithm.\n */\nexport function extractJson<T = unknown>(\n  text: string,\n  options: ExtractOptions = {},\n): T {\n  const result = tryExtractJson<T>(text, options);\n  if (!result.found) {\n    throw new JsonExtractionError(\n      'No JSON value could be extracted from the text.',\n      text,\n    );\n  }\n  return result.value;\n}\n"],"mappings":"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","names":[]}

package/fixtures/README.md

@@ -5,8 +5,12 @@ plain `JSON.parse`:
 
 - reasoning/thinking tags with brace-laden prose
 - fenced JSON blocks inside conversational text
+- multiple fenced blocks where a later complete payload should win
 - trailing commas in otherwise valid JSON
 - competing arrays/objects when callers expect a specific top-level type
+- malformed drafts before a final valid JSON answer
+- truncated stream output that contains nested draft fragments
+- unclosed reasoning tags that should not leak draft JSON
 - negative text with no recoverable JSON
 
 Each `.txt` file has a matching expected JSON file under `fixtures/expected/`.

package/fixtures/anthropic-prose-object.txt

@@ -0,0 +1,9 @@
+I'll return the object first so it is easy to parse.
+
+{
+  "provider": "anthropic",
+  "safe": true,
+  "note": "the literal } character is part of this string"
+}
+
+Let me know if you want the schema too.

package/fixtures/expected/anthropic-prose-object.json

@@ -0,0 +1,9 @@
+{
+  "found": true,
+  "expect": "object",
+  "value": {
+    "provider": "anthropic",
+    "safe": true,
+    "note": "the literal } character is part of this string"
+  }
+}

package/fixtures/expected/malformed-draft-valid-final.json

@@ -0,0 +1,8 @@
+{
+  "found": true,
+  "expect": "object",
+  "value": {
+    "score": 8,
+    "reason": "clear"
+  }
+}

package/fixtures/expected/multiple-fenced-final.json

@@ -0,0 +1,8 @@
+{
+  "found": true,
+  "expect": "object",
+  "value": {
+    "score": 8,
+    "draft": false
+  }
+}

package/fixtures/expected/openai-fenced-object.json

@@ -0,0 +1,11 @@
+{
+  "found": true,
+  "expect": "object",
+  "value": {
+    "provider": "openai",
+    "classification": {
+      "label": "ship",
+      "confidence": 0.92
+    }
+  }
+}

package/fixtures/expected/truncated-stream-no-json.json

@@ -0,0 +1,4 @@
+{
+  "found": false,
+  "expect": "object"
+}

package/fixtures/expected/unclosed-thinking-no-json.json

@@ -0,0 +1,4 @@
+{
+  "found": false,
+  "expect": "object"
+}

package/fixtures/malformed-draft-valid-final.txt

@@ -0,0 +1,7 @@
+Draft:
+
+{score: 7, reason: "rough"}
+
+Final JSON:
+
+{"score":8,"reason":"clear"}

package/fixtures/multiple-fenced-final.txt

@@ -0,0 +1,11 @@
+The first fenced block is a draft note, not the payload.
+
+```json
+The draft object was {"score": 4, "draft": true}, but do not use it.
+```
+
+Final JSON:
+
+```json
+{"score":8,"draft":false}
+```

package/fixtures/openai-fenced-object.txt

@@ -0,0 +1,11 @@
+Here is the JSON you requested:
+
+```json
+{
+  "provider": "openai",
+  "classification": {
+    "label": "ship",
+    "confidence": 0.92
+  }
+}
+```

package/fixtures/truncated-stream-no-json.txt

@@ -0,0 +1,6 @@
+The provider stream ended before the top-level object closed.
+
+```json
+{
+  "items": [
+    { "id": "draft", "score": 4 }

package/fixtures/unclosed-thinking-no-json.txt

@@ -0,0 +1,3 @@
+<thinking>
+{"draft": true, "score": 4}
+Still reasoning; no final answer was emitted.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-from-llm",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Extract valid JSON from an LLM response, even when it is wrapped in reasoning/thinking tags, markdown fences or prose. Zero dependencies.",
   "keywords": [
     "llm",