bernard-agent 0.8.1 → 0.9.0

package/dist/specialists.js

@@ -33,13 +33,64 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpecialistStore = void 0;
+exports.SpecialistStore = exports.MAX_EXAMPLES_PER_LIST = void 0;
+exports.getBuiltinSpecialistIds = getBuiltinSpecialistIds;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const paths_js_1 = require("./paths.js");
 const reserved_names_js_1 = require("./reserved-names.js");
+const fs_utils_js_1 = require("./fs-utils.js");
+/** Maximum examples retained per list (oldest drop-off during correction updates). */
+exports.MAX_EXAMPLES_PER_LIST = 10;
 const MAX_SPECIALISTS = 50;
 const ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,58}[a-z0-9])?$/;
+/** Marker file that prevents re-seeding bundled specialists on every start. */
+const SEED_MARKER = '.seeded-v1';
+/**
+ * Locates the bundled `builtin-specialists` directory sitting next to the
+ * compiled/loaded `specialists.js` (or `.ts` under tsx). Returns `null` when
+ * running in an environment where the bundle was not deployed (e.g. certain
+ * test harnesses).
+ */
+function findBuiltinSpecialistsDir() {
+    const candidate = path.join(__dirname, 'builtin-specialists');
+    try {
+        if (fs.statSync(candidate).isDirectory())
+            return candidate;
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+let cachedBuiltinIds = null;
+/**
+ * Returns the set of specialist IDs that ship bundled with Bernard. Used to
+ * distinguish seeded specialists from user-authored ones in the UI. Result is
+ * cached after the first call — the bundle is packaged alongside the binary
+ * and does not change at runtime.
+ */
+function getBuiltinSpecialistIds() {
+    if (cachedBuiltinIds)
+        return cachedBuiltinIds;
+    const ids = new Set();
+    const bundledDir = findBuiltinSpecialistsDir();
+    if (!bundledDir) {
+        cachedBuiltinIds = ids;
+        return ids;
+    }
+    try {
+        for (const file of fs.readdirSync(bundledDir)) {
+            if (file.endsWith('.json'))
+                ids.add(file.replace(/\.json$/, ''));
+        }
+    }
+    catch {
+        // fall through with whatever we collected
+    }
+    cachedBuiltinIds = ids;
+    return ids;
+}
 /**
  * Disk-backed store for named specialists (reusable expert profiles).
  *
@@ -49,6 +100,45 @@ const ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,58}[a-z0-9])?$/;
 class SpecialistStore {
     constructor() {
         fs.mkdirSync(paths_js_1.SPECIALISTS_DIR, { recursive: true });
+        this.seedBundledSpecialists();
+    }
+    /**
+     * Copies bundled specialists (shell-wrapper, file-wrapper, web-wrapper,
+     * correction-agent, specialist-creator) from the packaged `builtin-specialists`
+     * directory into the user's specialists dir on first run. A `.seeded-v1`
+     * marker prevents re-seeding on subsequent runs, so users can freely edit or
+     * delete the seeded files. Existing files with the same id are never
+     * overwritten.
+     */
+    seedBundledSpecialists() {
+        const markerPath = path.join(paths_js_1.SPECIALISTS_DIR, SEED_MARKER);
+        if (fs.existsSync(markerPath))
+            return;
+        const bundledDir = findBuiltinSpecialistsDir();
+        if (!bundledDir)
+            return;
+        try {
+            const files = fs.readdirSync(bundledDir).filter((f) => f.endsWith('.json'));
+            for (const file of files) {
+                const src = path.join(bundledDir, file);
+                const dest = path.join(paths_js_1.SPECIALISTS_DIR, file);
+                if (fs.existsSync(dest))
+                    continue; // never overwrite user-edited copies
+                try {
+                    const raw = fs.readFileSync(src, 'utf-8');
+                    // Parse once to catch obviously corrupt bundle files before seeding.
+                    JSON.parse(raw);
+                    (0, fs_utils_js_1.atomicWriteFileSync)(dest, raw);
+                }
+                catch {
+                    // skip individual bad files; continue seeding the rest
+                }
+            }
+            fs.writeFileSync(markerPath, new Date().toISOString(), 'utf-8');
+        }
+        catch {
+            // seed is best-effort; never block startup
+        }
     }
     /**
      * Validates a specialist ID.
@@ -105,27 +195,40 @@ class SpecialistStore {
      * @throws {Error} If the ID is invalid, reserved, already taken, or the max limit is reached.
      */
     create(id, name, description, systemPrompt, guidelines = [], provider, model) {
-        const idError = this.validateId(id);
+        return this.createFull({ id, name, description, systemPrompt, guidelines, provider, model });
+    }
+    /**
+     * Creates a new specialist from a full input object, supporting tool-wrapper
+     * fields (kind, targetTools, good/bad examples, structuredOutput).
+     * @throws {Error} If the ID is invalid, reserved, already taken, or the max limit is reached.
+     */
+    createFull(input) {
+        const idError = this.validateId(input.id);
         if (idError)
             throw new Error(idError);
-        if (this.exists(id))
-            throw new Error(`Specialist "${id}" already exists.`);
+        if (this.exists(input.id))
+            throw new Error(`Specialist "${input.id}" already exists.`);
         const count = this.list().length;
         if (count >= MAX_SPECIALISTS)
             throw new Error(`Maximum of ${MAX_SPECIALISTS} specialists reached.`);
         const now = new Date().toISOString();
         const specialist = {
-            id,
-            name,
-            description,
-            systemPrompt,
-            guidelines,
-            ...(provider !== undefined ? { provider } : {}),
-            ...(model !== undefined ? { model } : {}),
+            id: input.id,
+            name: input.name,
+            description: input.description,
+            systemPrompt: input.systemPrompt,
+            guidelines: input.guidelines ?? [],
+            ...(input.provider !== undefined ? { provider: input.provider } : {}),
+            ...(input.model !== undefined ? { model: input.model } : {}),
+            ...(input.kind !== undefined ? { kind: input.kind } : {}),
+            ...(input.targetTools !== undefined ? { targetTools: input.targetTools } : {}),
+            ...(input.goodExamples !== undefined ? { goodExamples: input.goodExamples } : {}),
+            ...(input.badExamples !== undefined ? { badExamples: input.badExamples } : {}),
+            ...(input.structuredOutput !== undefined ? { structuredOutput: input.structuredOutput } : {}),
             createdAt: now,
             updatedAt: now,
         };
-        this.atomicWrite(path.join(paths_js_1.SPECIALISTS_DIR, `${id}.json`), JSON.stringify(specialist, null, 2));
+        (0, fs_utils_js_1.atomicWriteFileSync)(path.join(paths_js_1.SPECIALISTS_DIR, `${input.id}.json`), JSON.stringify(specialist, null, 2));
         return specialist;
     }
     /**
@@ -163,10 +266,44 @@ class SpecialistStore {
                 specialist.model = updates.model;
             }
         }
+        if (updates.kind !== undefined)
+            specialist.kind = updates.kind;
+        if (updates.targetTools !== undefined)
+            specialist.targetTools = updates.targetTools;
+        if (updates.goodExamples !== undefined)
+            specialist.goodExamples = updates.goodExamples;
+        if (updates.badExamples !== undefined)
+            specialist.badExamples = updates.badExamples;
+        if (updates.structuredOutput !== undefined)
+            specialist.structuredOutput = updates.structuredOutput;
         specialist.updatedAt = new Date().toISOString();
-        this.atomicWrite(path.join(paths_js_1.SPECIALISTS_DIR, `${id}.json`), JSON.stringify(specialist, null, 2));
+        (0, fs_utils_js_1.atomicWriteFileSync)(path.join(paths_js_1.SPECIALISTS_DIR, `${id}.json`), JSON.stringify(specialist, null, 2));
         return specialist;
     }
+    /**
+     * Appends one good and one bad example to a specialist, dropping the oldest
+     * entries once the list exceeds {@link MAX_EXAMPLES_PER_LIST}. Used by the
+     * correction agent after a validated fix.
+     * @returns The updated specialist, or `undefined` if not found.
+     */
+    appendExamples(id, good, bad) {
+        const specialist = this.get(id);
+        if (!specialist)
+            return undefined;
+        const goodList = [...(specialist.goodExamples ?? [])];
+        const badList = [...(specialist.badExamples ?? [])];
+        if (good) {
+            goodList.push(good);
+            while (goodList.length > exports.MAX_EXAMPLES_PER_LIST)
+                goodList.shift();
+        }
+        if (bad) {
+            badList.push(bad);
+            while (badList.length > exports.MAX_EXAMPLES_PER_LIST)
+                badList.shift();
+        }
+        return this.update(id, { goodExamples: goodList, badExamples: badList });
+    }
     /** Removes a specialist by ID. Returns `true` if it existed and was deleted. */
     delete(id) {
         if (!ID_PATTERN.test(id))
@@ -179,20 +316,15 @@ class SpecialistStore {
     }
     /** Returns id + name + description + optional model info for all specialists, for system prompt injection. */
     getSummaries() {
-        return this.list().map(({ id, name, description, provider, model }) => ({
+        return this.list().map(({ id, name, description, provider, model, kind }) => ({
             id,
             name,
             description,
             ...(provider !== undefined ? { provider } : {}),
             ...(model !== undefined ? { model } : {}),
+            ...(kind !== undefined ? { kind } : {}),
         }));
     }
-    /** Writes data to a `.tmp` file then renames it into place for crash-safe persistence. */
-    atomicWrite(filePath, data) {
-        const tmp = filePath + '.tmp';
-        fs.writeFileSync(tmp, data, 'utf-8');
-        fs.renameSync(tmp, filePath);
-    }
 }
 exports.SpecialistStore = SpecialistStore;
 //# sourceMappingURL=specialists.js.map

package/dist/specialists.js.map

@@ -1 +1 @@
-{"version":3,"file":"specialists.js","sourceRoot":"","sources":["../src/specialists.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"specialists.js","sourceRoot":"","sources":["../src/specialists.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0HA,0DAiBC;AA3ID,4CAA8B;AAC9B,gDAAkC;AAClC,yCAA6C;AAC7C,2DAAqD;AACrD,+CAAoD;AAoDpD,sFAAsF;AACzE,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAkCxC,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,GAAG,wCAAwC,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC;;;;;GAKG;AACH,SAAS,yBAAyB;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,SAAS,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,gBAAgB,GAAuB,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,SAAgB,uBAAuB;IACrC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,UAAU,GAAG,yBAAyB,EAAE,CAAC;IAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,gBAAgB,GAAG,GAAG,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,gBAAgB,GAAG,GAAG,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAa,eAAe;IAC1B;QACE,EAAE,CAAC,SAAS,CAAC,0BAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACK,sBAAsB;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,WAAW,CAAC,CAAC;QAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO;QACtC,MAAM,UAAU,GAAG,yBAAyB,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,IAAI,CAAC,CAAC;gBAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAC,qCAAqC;gBACxE,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBAC1C,qEAAqE;oBACrE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAChB,IAAA,iCAAmB,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,uDAAuD;gBACzD,CAAC;YACH,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,gCAAgC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,+GAA+G,CAAC;QACzH,IAAI,kCAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,EAAE,+BAA+B,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mFAAmF;IACnF,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAAe,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,0BAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBACvE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,sEAAsE;IACtE,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAe,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,EAAU,EACV,IAAY,EACZ,WAAmB,EACnB,YAAoB,EACpB,aAAuB,EAAE,EACzB,QAAiB,EACjB,KAAc;QAEd,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,KAA4B;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QACjC,IAAI,KAAK,IAAI,eAAe;YAC1B,MAAM,IAAI,KAAK,CAAC,cAAc,eAAe,uBAAuB,CAAC,CAAC;QAExE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,UAAU,GAAe;YAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;YAClC,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,KAAK,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,IAAA,iCAAmB,EACjB,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,GAAG,KAAK,CAAC,EAAE,OAAO,CAAC,EAC9C,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CACpC,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAA0B;QAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC/D,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACpF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACvF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,UAAU,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACjF,mEAAmE;QACnE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;gBAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACzC,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;gBACzB,OAAO,UAAU,CAAC,KAAK,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACnC,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC/D,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACpF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACvF,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACpF,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS;YACxC,UAAU,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACzD,UAAU,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChD,IAAA,iCAAmB,EACjB,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,GAAG,EAAE,OAAO,CAAC,EACxC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CACpC,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CACZ,EAAU,EACV,IAAwB,EACxB,GAA0B;QAE1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,QAAQ,CAAC,MAAM,GAAG,6BAAqB;gBAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,GAAG,6BAAqB;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,0BAAe,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8GAA8G;IAC9G,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5E,EAAE;YACF,IAAI;YACJ,WAAW;YACX,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAnOD,0CAmOC"}

package/dist/structured-output.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+/**
+ * Scans a string for the first balanced JSON object starting at `start`
+ * (which must point at a `{`). Returns the slice containing the object,
+ * or `undefined` if no balanced block is found.
+ *
+ * Respects string literals so braces inside quoted strings don't break depth.
+ */
+export declare function extractJsonBlock(text: string, start: number): string | undefined;
+/**
+ * Attempts to parse a JSON object from `text` and validate it with `schema`.
+ *
+ * Strategy:
+ * 1. Try `JSON.parse` on the trimmed input directly.
+ * 2. Otherwise scan for each top-level `{` and try bracket-counted extraction.
+ *
+ * @returns The validated object on success, or `undefined` if nothing parses.
+ */
+export declare function parseStructuredOutput<T>(text: string, schema: z.ZodType<T>): T | undefined;
+/**
+ * Minimal structured result emitted by tool-wrapper specialists.
+ *
+ * Intentionally narrow (no confidence scores — models are poor at calibrating
+ * those; see issue #106 discussion). `reasoning` is the most valuable field
+ * for debugging — it explains why each tool call was made.
+ */
+export interface WrapperResult {
+    status: 'ok' | 'error';
+    result: unknown;
+    error?: string;
+    reasoning?: string[];
+}
+export declare const WrapperResultSchema: z.ZodObject<{
+    status: z.ZodEnum<["ok", "error"]>;
+    result: z.ZodAny;
+    error: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "error" | "ok";
+    reasoning?: string[] | undefined;
+    error?: string | undefined;
+    result?: any;
+}, {
+    status: "error" | "ok";
+    reasoning?: string[] | undefined;
+    error?: string | undefined;
+    result?: any;
+}>;
+/**
+ * Wraps raw specialist text output into a {@link WrapperResult}. Missing or
+ * malformed JSON becomes a structured error (not silent success).
+ */
+export declare function wrapWrapperResult(text: string): WrapperResult;
+/**
+ * Rules appended to a tool-wrapper specialist's system prompt. Instructs the
+ * child to emit a JSON object as its final message.
+ */
+export declare const STRUCTURED_OUTPUT_RULES = "\n\n## Output Format (STRICT)\n\nYour FINAL message MUST be a single valid JSON object with this shape and nothing else \u2014 no prose before or after, no markdown code fences:\n\n{\n  \"status\": \"ok\" | \"error\",\n  \"result\": <any valid JSON value representing the outcome>,\n  \"error\": \"<short error message, only when status is 'error'>\",\n  \"reasoning\": [\"<short rationale for each significant decision or tool call>\"]\n}\n\nRules:\n- Emit the JSON only once, as your last message.\n- `reasoning` is an array of short strings. One entry per significant tool call explaining WHY you chose it (not what it returned).\n- Never include confidence scores \u2014 the downstream pipeline ignores them.\n- If a tool call fails irrecoverably, set `status` to \"error\", put the cause in `error`, and still include your reasoning.";

package/dist/structured-output.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRUCTURED_OUTPUT_RULES = exports.WrapperResultSchema = void 0;
+exports.extractJsonBlock = extractJsonBlock;
+exports.parseStructuredOutput = parseStructuredOutput;
+exports.wrapWrapperResult = wrapWrapperResult;
+const zod_1 = require("zod");
+/**
+ * Scans a string for the first balanced JSON object starting at `start`
+ * (which must point at a `{`). Returns the slice containing the object,
+ * or `undefined` if no balanced block is found.
+ *
+ * Respects string literals so braces inside quoted strings don't break depth.
+ */
+function extractJsonBlock(text, start) {
+    if (text[start] !== '{')
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\' && inString) {
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === '{')
+            depth++;
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return undefined;
+}
+/**
+ * Attempts to parse a JSON object from `text` and validate it with `schema`.
+ *
+ * Strategy:
+ * 1. Try `JSON.parse` on the trimmed input directly.
+ * 2. Otherwise scan for each top-level `{` and try bracket-counted extraction.
+ *
+ * @returns The validated object on success, or `undefined` if nothing parses.
+ */
+function parseStructuredOutput(text, schema) {
+    const trimmed = text.trim();
+    // 1. Direct parse
+    try {
+        const parsed = JSON.parse(trimmed);
+        const result = schema.safeParse(parsed);
+        if (result.success)
+            return result.data;
+    }
+    catch {
+        // fall through
+    }
+    // 2. Scan forward for balanced blocks
+    for (let i = 0; i < trimmed.length; i++) {
+        if (trimmed[i] === '{') {
+            const block = extractJsonBlock(trimmed, i);
+            if (block) {
+                try {
+                    const parsed = JSON.parse(block);
+                    const result = schema.safeParse(parsed);
+                    if (result.success)
+                        return result.data;
+                }
+                catch {
+                    // try next
+                }
+                i += block.length - 1;
+            }
+        }
+    }
+    return undefined;
+}
+exports.WrapperResultSchema = zod_1.z.object({
+    status: zod_1.z.enum(['ok', 'error']),
+    result: zod_1.z.any(),
+    error: zod_1.z.string().optional(),
+    reasoning: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * Wraps raw specialist text output into a {@link WrapperResult}. Missing or
+ * malformed JSON becomes a structured error (not silent success).
+ */
+function wrapWrapperResult(text) {
+    const parsed = parseStructuredOutput(text, exports.WrapperResultSchema);
+    if (parsed) {
+        const { status, result, error, reasoning } = parsed;
+        const out = { status, result };
+        if (error !== undefined)
+            out.error = error;
+        if (reasoning !== undefined)
+            out.reasoning = reasoning;
+        return out;
+    }
+    return {
+        status: 'error',
+        result: 'Specialist did not produce valid structured output',
+        error: 'parse_failed',
+        reasoning: [text.trim().slice(0, 500)],
+    };
+}
+/**
+ * Rules appended to a tool-wrapper specialist's system prompt. Instructs the
+ * child to emit a JSON object as its final message.
+ */
+exports.STRUCTURED_OUTPUT_RULES = `
+
+## Output Format (STRICT)
+
+Your FINAL message MUST be a single valid JSON object with this shape and nothing else — no prose before or after, no markdown code fences:
+
+{
+  "status": "ok" | "error",
+  "result": <any valid JSON value representing the outcome>,
+  "error": "<short error message, only when status is 'error'>",
+  "reasoning": ["<short rationale for each significant decision or tool call>"]
+}
+
+Rules:
+- Emit the JSON only once, as your last message.
+- \`reasoning\` is an array of short strings. One entry per significant tool call explaining WHY you chose it (not what it returned).
+- Never include confidence scores — the downstream pipeline ignores them.
+- If a tool call fails irrecoverably, set \`status\` to "error", put the cause in \`error\`, and still include your reasoning.`;
+//# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

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

package/dist/theme.d.ts

@@ -25,6 +25,8 @@ export interface Theme {
     success: ColorFn;
     /** Dimmed color for de-emphasized content like conversation replays. */
     dim: ColorFn;
+    /** Dimmed italic variant, used for secondary blocks like the `think` tool output. */
+    dimItalic: ColorFn;
     /** Color for warning messages. */
     warning: ColorFn;
     /** Rotating palette of colors assigned to sub-agent prefixes. */

package/dist/theme.js

@@ -27,12 +27,13 @@ exports.THEMES = {
         error: chalk_1.default.red,
         success: chalk_1.default.green,
         dim: chalk_1.default.dim,
+        dimItalic: chalk_1.default.dim.italic,
         warning: chalk_1.default.yellow,
         prefixColors: [chalk_1.default.magenta, chalk_1.default.blue, chalk_1.default.green, chalk_1.default.yellow],
         ansi: {
             prompt: '\x1b[38;2;249;115;22m',
-            hintCmd: '\x1b[37m',
-            hintDesc: '\x1b[90m',
+            hintCmd: '\x1b[1;38;2;249;115;22m',
+            hintDesc: '\x1b[22;38;2;115;115;115m',
             warning: '\x1b[33m',
             reset: '\x1b[0m',
         },
@@ -48,6 +49,7 @@ exports.THEMES = {
         error: chalk_1.default.hex('#f87171'),
         success: chalk_1.default.hex('#34d399'),
         dim: chalk_1.default.dim,
+        dimItalic: chalk_1.default.dim.italic,
         warning: chalk_1.default.hex('#fbbf24'),
         prefixColors: [
             chalk_1.default.hex('#38bdf8'),
@@ -57,8 +59,8 @@ exports.THEMES = {
         ],
         ansi: {
             prompt: '\x1b[38;2;6;182;212m',
-            hintCmd: '\x1b[38;2;226;232;240m',
-            hintDesc: '\x1b[38;2;148;163;184m',
+            hintCmd: '\x1b[1;38;2;6;182;212m',
+            hintDesc: '\x1b[22;38;2;115;125;140m',
             warning: '\x1b[38;2;251;191;36m',
             reset: '\x1b[0m',
         },
@@ -74,6 +76,7 @@ exports.THEMES = {
         error: chalk_1.default.hex('#ef4444'),
         success: chalk_1.default.hex('#4ade80'),
         dim: chalk_1.default.dim,
+        dimItalic: chalk_1.default.dim.italic,
         warning: chalk_1.default.hex('#facc15'),
         prefixColors: [
             chalk_1.default.hex('#4ade80'),
@@ -83,8 +86,8 @@ exports.THEMES = {
         ],
         ansi: {
             prompt: '\x1b[38;2;34;197;94m',
-            hintCmd: '\x1b[38;2;229;229;229m',
-            hintDesc: '\x1b[38;2;163;163;163m',
+            hintCmd: '\x1b[1;38;2;34;197;94m',
+            hintDesc: '\x1b[22;38;2;115;115;115m',
             warning: '\x1b[38;2;250;204;21m',
             reset: '\x1b[0m',
         },
@@ -100,6 +103,7 @@ exports.THEMES = {
         error: chalk_1.default.hex('#fb7185'),
         success: chalk_1.default.hex('#34d399'),
         dim: chalk_1.default.dim,
+        dimItalic: chalk_1.default.dim.italic,
         warning: chalk_1.default.hex('#fde68a'),
         prefixColors: [
             chalk_1.default.hex('#f472b6'),
@@ -109,8 +113,8 @@ exports.THEMES = {
         ],
         ansi: {
             prompt: '\x1b[38;2;192;132;252m',
-            hintCmd: '\x1b[38;2;240;171;252m',
-            hintDesc: '\x1b[38;2;167;139;250m',
+            hintCmd: '\x1b[1;38;2;192;132;252m',
+            hintDesc: '\x1b[22;38;2;130;130;150m',
             warning: '\x1b[38;2;253;230;138m',
             reset: '\x1b[0m',
         },
@@ -126,6 +130,7 @@ exports.THEMES = {
         error: chalk_1.default.bold.redBright,
         success: chalk_1.default.bold.greenBright,
         dim: chalk_1.default.white,
+        dimItalic: chalk_1.default.white.italic,
         warning: chalk_1.default.bold.yellowBright,
         prefixColors: [
             chalk_1.default.bold.magentaBright,
@@ -135,8 +140,8 @@ exports.THEMES = {
         ],
         ansi: {
             prompt: '\x1b[1;97m',
-            hintCmd: '\x1b[97m',
-            hintDesc: '\x1b[97m',
+            hintCmd: '\x1b[1;93m',
+            hintDesc: '\x1b[22;37m',
             warning: '\x1b[1;93m',
             reset: '\x1b[0m',
         },
@@ -152,6 +157,7 @@ exports.THEMES = {
         error: chalk_1.default.hex('#DC267F'),
         success: chalk_1.default.hex('#648FFF'),
         dim: chalk_1.default.dim,
+        dimItalic: chalk_1.default.dim.italic,
         warning: chalk_1.default.hex('#FFB000'),
         prefixColors: [
             chalk_1.default.hex('#785EF0'),
@@ -161,8 +167,8 @@ exports.THEMES = {
         ],
         ansi: {
             prompt: '\x1b[38;2;100;143;255m',
-            hintCmd: '\x1b[38;2;224;224;224m',
-            hintDesc: '\x1b[38;2;176;176;176m',
+            hintCmd: '\x1b[1;38;2;100;143;255m',
+            hintDesc: '\x1b[22;38;2;130;130;130m',
             warning: '\x1b[38;2;255;176;0m',
             reset: '\x1b[0m',
         },

package/dist/theme.js.map

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

package/dist/tool-call-repair.d.ts

@@ -0,0 +1,29 @@
+import { type ToolCallRepairFunction, type ToolSet } from 'ai';
+import type { BernardConfig } from './config.js';
+/** Identifies which generateText site produced the failed tool call. */
+export type RepairLabel = 'main' | 'specialist' | 'subagent' | 'tool-wrapper' | 'cron';
+export interface MakeRepairHookOpts {
+    config: BernardConfig;
+    /** Provider to use for the repair call. Defaults to config.provider. */
+    provider?: string;
+    /** Model to use for the repair call. Defaults to config.model. */
+    model?: string;
+    label: RepairLabel;
+    /** Optional abort signal forwarded to the repair generateText call. */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Produces an `experimental_repairToolCall` hook for `generateText`. When the
+ * AI SDK fails to parse a model's tool-call arguments (or the model targets a
+ * nonexistent tool), the hook runs ONE focused generation asking the model to
+ * re-emit a valid tool call. Returns the corrected call, or `null` to let the
+ * SDK throw.
+ *
+ * The repair attempt is bounded to a single retry per failed tool call — no
+ * looping, no escalation. Failures are logged to the debug stream.
+ *
+ * Special-cases JSON truncation (the model packed too much content into a
+ * single string arg) by hinting at `file_write` + `shell` as the safe pattern
+ * for large payloads.
+ */
+export declare function makeRepairHook<TOOLS extends ToolSet>(opts: MakeRepairHookOpts): ToolCallRepairFunction<TOOLS>;