@animalabs/connectome-host 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.7.2 — 2026-07-27
+
+### Added
+
+- **`LLM_CALLS_FULL_PAYLOADS` env flag** — retain the raw request on every
+  llm-call log entry, not only on refusal/error. Debugging aid; off by
+  default (the logs grow gigabytes fast with it on).
+
 ## 0.7.1 — 2026-07-26
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animalabs/connectome-host",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "General-purpose agent TUI host with recipe-based configuration",
   "type": "module",
   "scripts": {

package/src/logging-adapter.ts

@@ -43,6 +43,11 @@ export type ProviderCallObserver = (record: ProviderCallRecord) => void;
  *  system-prompt-append uses). */
 const OAUTH_SYSTEM_IDENTITY = "You are Claude Code, Anthropic's official CLI for Claude.";
 
+/** Truthy env-flag parse: unset/''/'0'/'false' (any case) are off. */
+function envFlag(value: string | undefined): boolean {
+  return value !== undefined && value !== '' && value !== '0' && value.toLowerCase() !== 'false';
+}
+
 export class LoggingAnthropicAdapter extends AnthropicAdapter {
   private readonly logPath: string;
   private readonly getReasoning?: ReasoningGetter;
@@ -50,6 +55,14 @@ export class LoggingAnthropicAdapter extends AnthropicAdapter {
   /** True when authenticated with an OAuth/Bearer token instead of an API
    *  key; requests then need the identity block prepended (see above). */
   private readonly oauthMode: boolean;
+  /** LLM_CALLS_FULL_PAYLOADS=1: retain the full raw request on EVERY call,
+   *  not just refusals/errors. Purpose: pass/refusal contrast corpora — a
+   *  refusal's payload is only interpretable next to the passing payloads
+   *  around it (classifier-forensics finding, 2026-07-27: verdicts are a
+   *  near-deterministic function of the payload, so adjacent pairs isolate
+   *  the differentiator). Costs disk, not memory (the raw request is already
+   *  captured per-call for the summary); pair with llm-calls rotation. */
+  private readonly fullPayloads: boolean = envFlag(process.env.LLM_CALLS_FULL_PAYLOADS);
 
   constructor(
     config: ConstructorParameters<typeof AnthropicAdapter>[0],
@@ -206,6 +219,7 @@ export class LoggingAnthropicAdapter extends AnthropicAdapter {
   }
 
   private refusalRawRequest(response: ProviderResponse, rawRequest: unknown): unknown {
+    if (this.fullPayloads) return rawRequest;
     const raw = (response as { raw?: { stop_reason?: string } }).raw;
     return raw?.stop_reason === 'refusal' ? rawRequest : undefined;
   }

package/test/logging-adapter.test.ts

@@ -100,6 +100,39 @@ describe('LoggingAnthropicAdapter request logging', () => {
     expect(internals.refusalRawRequest(refusal, rawRequest)).toBe(rawRequest);
   });
 
+  test('LLM_CALLS_FULL_PAYLOADS=1 retains the raw request on every call', () => {
+    const prev = process.env.LLM_CALLS_FULL_PAYLOADS;
+    process.env.LLM_CALLS_FULL_PAYLOADS = '1';
+    try {
+      const full = new LoggingAnthropicAdapter({ apiKey: 'test' }, '/dev/null');
+      const fi = full as unknown as typeof internals;
+      const rawRequest = { messages: ['forensic context'] };
+      const success = { raw: { stop_reason: 'end_turn' } } as unknown as ProviderResponse;
+      const refusal = { raw: { stop_reason: 'refusal' } } as unknown as ProviderResponse;
+      expect(fi.refusalRawRequest(success, rawRequest)).toBe(rawRequest);
+      expect(fi.refusalRawRequest(refusal, rawRequest)).toBe(rawRequest);
+    } finally {
+      if (prev === undefined) delete process.env.LLM_CALLS_FULL_PAYLOADS;
+      else process.env.LLM_CALLS_FULL_PAYLOADS = prev;
+    }
+  });
+
+  test('LLM_CALLS_FULL_PAYLOADS off-values keep refusal-only behavior', () => {
+    const prev = process.env.LLM_CALLS_FULL_PAYLOADS;
+    try {
+      for (const off of ['', '0', 'false', 'FALSE']) {
+        process.env.LLM_CALLS_FULL_PAYLOADS = off;
+        const a = new LoggingAnthropicAdapter({ apiKey: 'test' }, '/dev/null');
+        const ai = a as unknown as typeof internals;
+        const success = { raw: { stop_reason: 'end_turn' } } as unknown as ProviderResponse;
+        expect(ai.refusalRawRequest(success, { m: 1 })).toBeUndefined();
+      }
+    } finally {
+      if (prev === undefined) delete process.env.LLM_CALLS_FULL_PAYLOADS;
+      else process.env.LLM_CALLS_FULL_PAYLOADS = prev;
+    }
+  });
+
   test('forwards authoritative billing buckets from the provider response', () => {
     const calls: ProviderCallRecord[] = [];
     const observed = new LoggingAnthropicAdapter(