@dtlabs/ai-toolkit 0.14.3 → 0.15.1

package/CHANGELOG.md

@@ -1,4 +1,26 @@
 ## 0.1.4 (2026-07-21)
+## [0.15.1](https://github.com/dtlab-tech/ai-toolkit/compare/v0.15.0...v0.15.1) (2026-10-01)
+
+
+### Bug Fixes
+
+* **workflows:** recover ```json structured output wrapped around a ne… ([a96add9](https://github.com/dtlab-tech/ai-toolkit/commit/a96add902195ea0a125e0fbbc9be06126dfbd602))
+* **workflows:** recover ```json structured output wrapped around a nested untagged fence ([6e92dd2](https://github.com/dtlab-tech/ai-toolkit/commit/6e92dd28bf96f6e96947b45bcc7c8e54d7cb9c38))
+
+## [0.15.0](https://github.com/dtlab-tech/ai-toolkit/compare/v0.14.3...v0.15.0) (2026-10-01)
+
+
+### Features
+
+* Add isolated parallel task execution and task checkpoints documentation ([e17121f](https://github.com/dtlab-tech/ai-toolkit/commit/e17121fbf118673831634f981294d58e1a665d49))
+
+
+### Bug Fixes
+
+* **workflows:** never fail-closed inside extractJsonDocument itself ([dd5f0ce](https://github.com/dtlab-tech/ai-toolkit/commit/dd5f0ce07b7145ef73e29479e4282105000cfd42))
+* **workflows:** recover JSON worker output wrapped in prose or a code fence ([b7a0d08](https://github.com/dtlab-tech/ai-toolkit/commit/b7a0d0817cf6056893906aacff87b40578c6625b))
+* **workflows:** recover JSON worker output wrapped in prose or a code fence ([0dbaece](https://github.com/dtlab-tech/ai-toolkit/commit/0dbaeceb193521c2aca59a15de3762def4881935))
+
 ## [0.14.3](https://github.com/dtlab-tech/ai-toolkit/compare/v0.14.2...v0.14.3) (2026-10-01)
 
 

package/lib/workflow-control.js

@@ -217,7 +217,7 @@ function createControl(options) {
       if (outputTarget) {
         const content = opts.schema ? payload.report : payload;
         if (typeof content !== 'string' || !content.trim()) throw new Error('Worker output content missing or empty: ' + id);
-        writeOutput(outputTarget, content);
+        writeOutput(outputTarget, /\.json$/i.test(outputTarget) ? extractJsonDocument(content) : content);
       }
       evidence.save({ outcome: 'done', completedAt: new Date().toISOString() });
       return payload;
@@ -307,6 +307,19 @@ function extractDelimitedStructuredOutput(text, schema) {
   if (tagMatch) candidates.push(tagMatch[1]);
   const fenceMatches = [...text.matchAll(/```json\s*([\s\S]*?)```/gi)];
   if (fenceMatches.length) candidates.push(fenceMatches[fenceMatches.length - 1][1]);
+  // The non-greedy fence match above stops at the FIRST ``` following ```json, which is
+  // wrong when a schema string field (e.g. a "report") legitimately embeds its own
+  // untagged ``` ... ``` example (a markdown table, say) before the real closing fence —
+  // observed empirically with gaia-validate-feature-docs. Recover with a brace-balance
+  // span instead of a fence-delimiter match, anchored after the last ```json marker so it
+  // is immune to backtick nesting inside string values.
+  const lastJsonFence = text.lastIndexOf('```json');
+  if (lastJsonFence !== -1) {
+    const tail = text.slice(lastJsonFence + '```json'.length);
+    const first = tail.indexOf('{');
+    const last = tail.lastIndexOf('}');
+    if (first !== -1 && last > first) candidates.push(tail.slice(first, last + 1));
+  }
   for (const raw of candidates) {
     try {
       const parsed = JSON.parse(raw.trim());
@@ -317,6 +330,36 @@ function extractDelimitedStructuredOutput(text, schema) {
   return null;
 }
 
+// A worker with a declared JSON output has no Write tool (see worker()'s own comment on why):
+// its entire response text becomes the file verbatim. Some models still wrap that deliverable
+// in conversational prose and/or a Markdown code fence despite being told not to (observed
+// empirically with gaia-generate-work-breakdown on haiku: "Perfect. I have all the necessary
+// information..." before the JSON), which is a hard JSON.parse failure for every downstream
+// consumer of this file. Recover the document with the same "try each known convention, always
+// re-validate as parseable JSON, never a blind substring guess" discipline as
+// extractDelimitedStructuredOutput: the content as-is first, then the last fenced code block,
+// then the outermost brace/bracket span. Never throws — genuinely malformed JSON (not merely
+// wrapped) is passed through unchanged so the downstream deterministic validator (wb-validate.js)
+// remains the one thing that fails closed on it; this function only undoes wrapping, it is not
+// itself a validation gate.
+function extractJsonDocument(text) {
+  const tryParse = candidate => { try { JSON.parse(candidate); return candidate; } catch (e) { return null; } };
+  const whole = tryParse(text.trim());
+  if (whole != null) return whole;
+  const fenceMatches = [...text.matchAll(/```(?:json)?\s*([\s\S]*?)```/gi)];
+  for (let i = fenceMatches.length - 1; i >= 0; i--) {
+    const candidate = tryParse(fenceMatches[i][1].trim());
+    if (candidate != null) return candidate;
+  }
+  const first = text.search(/[[{]/);
+  const last = Math.max(text.lastIndexOf('}'), text.lastIndexOf(']'));
+  if (first >= 0 && last > first) {
+    const candidate = tryParse(text.slice(first, last + 1).trim());
+    if (candidate != null) return candidate;
+  }
+  return text;
+}
+
 function validateSchema(value, schema) {
   if (schema.type === 'object') {
     if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid structured object');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtlabs/ai-toolkit",
-  "version": "0.14.3",
+  "version": "0.15.1",
   "description": "AI Toolkit — reusable agents and procedures for developers to build AI-powered applications.",
   "files": [
     "docs/",