bare-agent 0.39.0 → 0.41.0

package/bareagent.context.md

@@ -1,7 +1,7 @@
 # bareagent — Integration Guide
 
 > For AI assistants and developers wiring bareagent into a project.
-> v0.39.0 | Node.js >= 18 | zero required deps (`bareguard >=0.9.0 <0.14.0` optional peer for governance) | Apache 2.0
+> v0.41.0 | Node.js >= 18 | zero required deps (`bareguard >=0.9.0 <0.14.0` optional peer for governance) | Apache 2.0
 >
 > Full human guide with composition examples, design philosophy, and recipes: [Usage Guide](docs/archive/usage-guide.md)
 

package/index.d.ts

@@ -1,3 +1,57 @@
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type ToolDef = import("./types").ToolDef;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type ToolCall = import("./types").ToolCall;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type Message = import("./types").Message;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type Provider = import("./types").Provider;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type GenerateResult = import("./types").GenerateResult;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type Usage = import("./types").Usage;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type RunMetrics = import("./types").RunMetrics;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type Store = import("./types").Store;
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ */
+export type Ctx = import("./types").Ctx;
 import { Loop } from "./src/loop";
 import { Planner } from "./src/planner";
 import { Evaluator } from "./src/evaluator";

package/index.js

@@ -1,5 +1,20 @@
 'use strict';
 
+/**
+ * Re-export the shared cross-cutting type shapes so adopters can name them when
+ * annotating their own wiring (tools arrays, providers, ctx, metrics). Declared
+ * in `types/index.d.ts`; surfaced here on the root entry so `types` resolves them.
+ * @typedef {import('./types').ToolDef} ToolDef
+ * @typedef {import('./types').ToolCall} ToolCall
+ * @typedef {import('./types').Message} Message
+ * @typedef {import('./types').Provider} Provider
+ * @typedef {import('./types').GenerateResult} GenerateResult
+ * @typedef {import('./types').Usage} Usage
+ * @typedef {import('./types').RunMetrics} RunMetrics
+ * @typedef {import('./types').Store} Store
+ * @typedef {import('./types').Ctx} Ctx
+ */
+
 const { Loop } = require('./src/loop');
 const { Planner } = require('./src/planner');
 const { Evaluator } = require('./src/evaluator');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-agent",
-  "version": "0.39.0",
+  "version": "0.41.0",
   "files": [
     "index.js",
     "index.d.ts",

package/src/evaluator.d.ts

@@ -29,6 +29,13 @@ export type Verdict = {
      * - Concrete fixes (rubric may populate; [] otherwise).
      */
     suggestions: string[];
+    /**
+     * - Rubric path only: `true` when the grader requested a pinned
+     * `temperature: 0` (its determinism knob) but the model rejected it and the provider silently retried at
+     * the model's DEFAULT (BA-10). Carries the fact the way `recurse` does — the grader ran non-deterministic;
+     * the caller decides what to do. Absent/`false` for predicate (no LLM) and agentic (no pinned temperature).
+     */
+    temperatureDropped?: boolean | undefined;
 };
 export type EvaluatorOptions = {
     /**

package/src/evaluator.js

@@ -20,6 +20,10 @@ const { Loop } = require('./loop');
  * @property {number|null} score - 0–10 for the rubric path; null for predicate (pass/fail only).
  * @property {string} critique - Why it failed / what to improve. '' when satisfied with no notes.
  * @property {string[]} suggestions - Concrete fixes (rubric may populate; [] otherwise).
+ * @property {boolean} [temperatureDropped] - Rubric path only: `true` when the grader requested a pinned
+ *   `temperature: 0` (its determinism knob) but the model rejected it and the provider silently retried at
+ *   the model's DEFAULT (BA-10). Carries the fact the way `recurse` does — the grader ran non-deterministic;
+ *   the caller decides what to do. Absent/`false` for predicate (no LLM) and agentic (no pinned temperature).
  */
 
 /**
@@ -199,7 +203,12 @@ class Evaluator {
       await opts.onLlmResult({ usage: out?.usage || null, model: (out && out.model) || this.provider.model || null, kind: 'evaluate' });
     }
 
-    return this._parse(out.text);
+    const verdict = this._parse(out.text);
+    // BA-10 honest receipt (mirrors recurse.js:900): the grader pinned `temperature: 0` for determinism. If
+    // the model rejected it, the provider ran at its DEFAULT and set `temperatureDropped`. Surface it so the
+    // caller is not silently handed a verdict from a non-deterministic grade — carry the fact, do not decide.
+    if (out.temperatureDropped === true) verdict.temperatureDropped = true;
+    return verdict;
   }
 
   /**

package/src/provider-clipipe.d.ts

@@ -1,6 +1,7 @@
 export type Message = import("../types").Message;
 export type ToolDef = import("../types").ToolDef;
 export type GenerateResult = import("../types").GenerateResult;
+export type ParsedEnvelope = import("./provider-clipipe-tools.js").ParsedEnvelope;
 export type CLIPipeOptions = {
     /**
      * - CLI command to spawn (required).
@@ -142,11 +143,11 @@ export class CLIPipeProvider {
     toolProtocol: {
         name: string;
         turnArgs(systemPrompt: string): string[];
-        parseResult(stdout: string): ParsedEnvelope;
+        parseResult(stdout: string): import("./provider-clipipe-tools").ParsedEnvelope;
         probe: {
             system: string;
             user: string;
-            isCapable: (parsed: ParsedEnvelope) => boolean;
+            isCapable: (parsed: import("./provider-clipipe-tools").ParsedEnvelope) => boolean;
         };
     } | null;
     probeCapability: boolean;

package/src/provider-clipipe.js

@@ -8,6 +8,12 @@ const { createBridge, resolveSessionError, runSession } = require('./provider-cl
 /** @typedef {import('../types').Message} Message */
 /** @typedef {import('../types').ToolDef} ToolDef */
 /** @typedef {import('../types').GenerateResult} GenerateResult */
+// `toolProtocol`'s inferred type references ParsedEnvelope, which is declared in
+// provider-clipipe-tools.js. Without this alias the name is not in scope when tsc
+// emits this file's .d.ts, so the declaration shipped a bare `ParsedEnvelope` that
+// adopters could not resolve (TS2304) — invisible here because our own tsconfig
+// sets skipLibCheck.
+/** @typedef {import('./provider-clipipe-tools.js').ParsedEnvelope} ParsedEnvelope */
 
 /**
  * @typedef {object} CLIPipeOptions