@cat-factory/agents 0.84.2 → 0.86.0

package/dist/providers/instrumented.js

@@ -4,14 +4,27 @@ import { catFactoryObservability, describeError, noopLogger, readInlineObservabi
 // observability tag from here; the canonical, dependency-free definition lives in the
 // kernel so any caller layer can build the tag without depending on this package.
 export { catFactoryObservability };
-// Instruments the INLINE (non-proxied) LLM calls so they reach the SAME trace sink as
-// the container-agent calls. Container calls go through the LLM proxy, which the
-// orchestration `LlmObservabilityService` fans out to the sink; inline calls
-// (requirements review/rework, the document planner, the fragment selector, the inline
-// agent executor) call the AI SDK directly. This decorator wraps every resolved model
-// with an AI SDK middleware that, after each generate, builds the SAME
-// {@link LlmGenerationEvent} and calls the SAME `sink.recordGeneration` — so adding the
-// inline feeder never means a second sink.
+// Instruments the INLINE (non-proxied) LLM calls so they reach the SAME sinks as the
+// container-agent calls. Container calls go through the LLM proxy (or, on a subscription
+// harness, the harness's own stream), and both feed the orchestration
+// `LlmObservabilityService`, which persists the call to `llm_call_metrics` and fans it out
+// to the external trace sink. Inline calls (requirements review/rework, the document
+// researcher/outliner/interviewer, the judges, consensus, the fragment selector, the inline
+// agent executor) call the AI SDK directly. This decorator wraps every resolved model with an
+// AI SDK middleware that, after each generate, feeds the same telemetry through one of two
+// exits — so adding the inline feeder never means a second sink OR a second store:
+//
+//   - `recordCall` (preferred) — the {@link InlineLlmCallRecorder} the facade builds off
+//     `LlmObservabilityService`. It persists the row AND owns the trace-sink fan-out, so an
+//     inline call recorded this way is visible to `ObservabilityPanel`, the per-step token
+//     rollups and `/api/v1/debug/*` exactly like a proxied one. Requires a workspace to file
+//     the row under.
+//   - `traceSink` — the direct emit, for a deployment that wires a sink but no metric store,
+//     and for the un-tagged call `recordCall` structurally cannot take (see below).
+//
+// EXACTLY ONE of the two runs per call. `recordCall`'s service already fans out to the sink
+// it was built with, so calling both would double every inline generation on Langfuse/OTel;
+// the facade therefore hands the SAME sink instance to both.
 //
 // The middleware is transparent: callers keep calling `generateText({ model })`
 // unchanged. To group a call under its run's trace and label it, a caller passes
@@ -72,25 +85,78 @@ function readOutputText(result) {
     }
     return '';
 }
+/** Extract the model's reasoning/thinking trace from a generate result, when it came separately. */
+function readReasoningText(result) {
+    const content = result?.content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((part) => part?.type === 'reasoning')
+        .map((part) => String(part.text ?? ''))
+        .join('');
+}
+/** How many chat messages the request carried (the store's chain uses this as the turn size). */
+function readMessageCount(params) {
+    const prompt = params?.prompt;
+    return Array.isArray(prompt) ? prompt.length : 0;
+}
+/** How many tools the request offered, across the SDK's array and record `tools` shapes. */
+function readToolCount(params) {
+    const tools = params?.tools;
+    if (Array.isArray(tools))
+        return tools.length;
+    if (tools && typeof tools === 'object')
+        return Object.keys(tools).length;
+    return 0;
+}
+/** The output ceiling the request asked for, or null when it named none. */
+function readRequestMaxTokens(params) {
+    const max = params?.maxOutputTokens;
+    return typeof max === 'number' ? max : null;
+}
+/**
+ * The call's finish reason, across the SDK's two shapes.
+ *
+ * The current (v3) spec reports an OBJECT — `{ unified, raw? }` — where `unified` is the
+ * provider-independent reason and `raw` whatever the vendor called it; only the older flat
+ * spec reports the bare string. Reading the string alone silently answered `null` for every
+ * real call, which is invisible in telemetry (a null finish reason reads as "the provider
+ * didn't say") and is why this has a test driving the SDK's own mock model rather than a
+ * hand-rolled stand-in that returned the shape the reader wanted.
+ *
+ * `unified` is the one stored: it is what makes `length` comparable across providers, which
+ * is the whole reason a truncated-output signal can be computed at all.
+ */
 function readFinishReason(result) {
     const reason = result?.finishReason;
-    return typeof reason === 'string' ? reason : null;
+    if (typeof reason === 'string')
+        return reason;
+    const unified = reason?.unified;
+    return typeof unified === 'string' ? unified : null;
 }
 /**
- * A {@link ModelProvider} that wraps every resolved model so inline LLM calls surface
- * on the trace sink. Build it only when a sink is wired AND the deployment opts in; an
- * unwrapped provider behaves exactly as before.
+ * A {@link ModelProvider} that wraps every resolved model so inline LLM calls surface on the
+ * telemetry store and/or the external trace sink. Build it only when at least one of those
+ * exits is wired AND the deployment opts in; an unwrapped provider behaves exactly as before.
  */
 export class InstrumentedModelProvider {
     inner;
     traceSink;
+    recordCall;
     recordPrompts;
     workspaceBodiesEnabled;
     now;
     log;
     constructor(deps) {
+        if (!deps.traceSink && !deps.recordCall) {
+            // A provider that instruments nothing is a wiring mistake wearing the instrumented
+            // wrapper's clothes: every call would pay the middleware and reach no sink, and the
+            // facade's `instanceof InstrumentedModelProvider` wiring assertions would still pass.
+            throw new Error('InstrumentedModelProvider needs at least one exit: a traceSink, a recordCall, or both.');
+        }
         this.inner = deps.inner;
         this.traceSink = deps.traceSink;
+        this.recordCall = deps.recordCall;
         this.recordPrompts = deps.recordPrompts ?? true;
         this.workspaceBodiesEnabled = deps.workspaceBodiesEnabled;
         this.now = deps.now ?? (() => Date.now());
@@ -131,11 +197,36 @@ export class InstrumentedModelProvider {
         const context = readInlineObservabilityContext(params);
         const usage = readUsage(result?.usage);
         const workspaceId = context.workspaceId ?? null;
+        const executionId = context.executionId ?? null;
+        const finishReason = ok ? readFinishReason(result) : null;
+        // The recorder is the richer exit AND owns the sink fan-out, so a workspace-scoped call
+        // takes it and stops. An un-tagged call (`workspaceId: null`) has no workspace to file a
+        // row under, so it falls through to the sink — which is also the whole story on a
+        // deployment that wires a sink but retains no metrics.
+        if (this.recordCall && workspaceId) {
+            this.record(this.recordCall, {
+                workspaceId,
+                executionId,
+                agentKind: context.agentKind,
+                ref,
+                params,
+                result,
+                usage,
+                durationMs: Math.max(0, endedAt - startedAt),
+                finishReason,
+                ok,
+                errMessage,
+            });
+            return;
+        }
+        if (!this.traceSink)
+            return;
+        const traceSink = this.traceSink;
         // Numeric telemetry + timing are recorded unconditionally, exactly as on the proxy
         // path; only the BODIES answer to the privacy gate below.
         const event = {
             workspaceId,
-            executionId: context.executionId ?? null,
+            executionId,
             agentKind: context.agentKind,
             provider: ref.provider,
             model: ref.model,
@@ -146,7 +237,7 @@ export class InstrumentedModelProvider {
             cacheWriteTokens: usage.cacheWrite,
             completionTokens: usage.completion,
             totalTokens: usage.total,
-            finishReason: ok ? readFinishReason(result) : null,
+            finishReason,
             ok,
             errorMessage: errMessage,
         };
@@ -158,13 +249,51 @@ export class InstrumentedModelProvider {
             // turns `storeAgentContext` off stops shipping bodies on its very next inline
             // call rather than when its scoped provider is next rebuilt.
             const recordBodies = await this.bodiesAllowed(workspaceId);
-            await this.traceSink.recordGeneration({
+            await traceSink.recordGeneration({
                 ...event,
                 input: recordBodies ? safeJson(params?.prompt) : '',
                 output: recordBodies && ok ? readOutputText(result) : '',
             });
         }, { workspaceId, executionId: event.executionId, source: 'inline' });
     }
+    /**
+     * Hand a workspace-scoped call to the metric recorder. Bodies are passed through
+     * UNGATED on purpose: the service behind the recorder scrubs them and applies the same
+     * `LLM_RECORD_PROMPTS` + `storeAgentContext` double gate this class applies to the sink
+     * exit — gating here as well would drop a body the service is entitled to store and put
+     * the rule in two places, which is how the sink half drifted open in the first place.
+     * They are handed over as THUNKS so keeping the gate on the far side costs nothing: a
+     * deployment with recording off never pays to serialise the prompt array.
+     *
+     * Best-effort and off the response path, exactly like the sink exit.
+     */
+    record(recordCall, call) {
+        const { workspaceId, executionId, ref, params, result, usage, ok } = call;
+        void runBestEffort(this.log, 'llmObservability.recordInlineCall', () => recordCall({
+            workspaceId,
+            executionId,
+            agentKind: call.agentKind,
+            provider: ref.provider,
+            model: ref.model,
+            messageCount: readMessageCount(params),
+            toolCount: readToolCount(params),
+            requestMaxTokens: readRequestMaxTokens(params),
+            promptTokens: usage.prompt,
+            cacheReadTokens: usage.cacheRead,
+            cacheWriteTokens: usage.cacheWrite,
+            completionTokens: usage.completion,
+            totalTokens: usage.total,
+            finishReason: call.finishReason,
+            durationMs: call.durationMs,
+            ok,
+            errorMessage: call.errMessage,
+            // Thunks: the service resolves a body only after its gate says it will be stored,
+            // so a prompts-off deployment never serialises a prompt array it then drops.
+            promptText: () => safeJson(params?.prompt),
+            responseText: () => (ok ? readOutputText(result) : ''),
+            reasoningText: () => (ok ? readReasoningText(result) : ''),
+        }), { workspaceId, executionId, source: 'inline' });
+    }
     /**
      * The double gate on prompt/response bodies: the deployment-wide `LLM_RECORD_PROMPTS`
      * switch AND the workspace's own `storeAgentContext` opt-out.

package/dist/providers/instrumented.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/agents",
-  "version": "0.84.2",
+  "version": "0.86.0",
   "description": "Agent catalog, routing, prompts and fragment library for the Agent Architecture Board.",
   "repository": {
     "type": "git",
@@ -32,14 +32,14 @@
     "handlebars": "^4.7.9",
     "p-map": "^7.0.6",
     "valibot": "^1.4.2",
-    "@cat-factory/contracts": "0.193.0",
-    "@cat-factory/kernel": "0.188.0",
-    "@cat-factory/prompt-fragments": "0.15.16"
+    "@cat-factory/contracts": "0.194.0",
+    "@cat-factory/kernel": "0.190.0",
+    "@cat-factory/prompt-fragments": "0.15.17"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/caching": "0.11.17"
+    "@cat-factory/caching": "0.11.19"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",