@molecule/api-ai-tools 1.9.10 → 1.9.11

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-18T06:52:09.924Z
+Generated: 2026-10-18T07:24:21.171Z
 -->
 
 # @molecule/api-ai-tools
@@ -455,7 +455,7 @@ interface TraceAction {
 
 #### `TraceArtifact`
 
-What one trace says: the test it belongs to, the requests it made, and its console errors.
+What one trace says: the test it belongs to, the requests it made, and its console lines.
 
 ```typescript
 interface TraceArtifact {
@@ -477,7 +477,11 @@ interface TraceArtifact {
    * Absent when the trace recorded neither, and on traces read before this field existed.
    */
   lead?: TraceRequest
-  /** The console errors and page errors the page raised. */
+  /**
+   * The console lines and page errors the page raised: its errors first, then a line that names a
+   * session decision or comes from a molecule package, then any other warning, then the browser's
+   * own resource error ({@link traceArtifactsScript}).
+   */
   console: string[]
   /**
    * The test's LAST user action before the failing assertion and the requests it caused — what the
@@ -1819,7 +1823,7 @@ function buildTools(backend: ExecutionBackend, config?: ToolBuildConfig): AITool
 
 The Node program the sandbox runs to read a failed run's traces: `node <script> <dir>` prints one
 `TRACE <json>` line per `trace.zip` under `<dir>` (newest first, {@link MAX_TRACE_ARTIFACTS} of
-them), each with the test it belongs to, the requests its page made and its console errors.
+them), each with the test it belongs to, the requests its page made and its console lines.
 
 It is a standalone program, not an import, for the reason `@molecule/api-code-sandbox` runs it:
 Playwright's own zip reader is not reachable from a project's `node_modules`, and a dependency
@@ -3221,7 +3225,8 @@ const MAX_TRACED_REQUESTS: 6
 
 #### `MAX_TRACED_CONSOLE`
 
-How many console errors one test's trace contributes.
+How many console lines one test's trace contributes: errors ahead of a session or molecule-package
+line, both ahead of a plain warning and of the browser's own resource error.
 
 ```typescript
 const MAX_TRACED_CONSOLE: 4

package/dist/trace-artifacts.d.ts

@@ -104,7 +104,7 @@ export interface TraceAction {
     /** When it finished, or null when the run ended before it did. */
     end: number | null;
 }
-/** What one trace says: the test it belongs to, the requests it made, and its console errors. */
+/** What one trace says: the test it belongs to, the requests it made, and its console lines. */
 export interface TraceArtifact {
     /** The failure's spec file, relative to the run's directory, when the trace names one. */
     spec: string | null;
@@ -124,7 +124,11 @@ export interface TraceArtifact {
      * Absent when the trace recorded neither, and on traces read before this field existed.
      */
     lead?: TraceRequest;
-    /** The console errors and page errors the page raised. */
+    /**
+     * The console lines and page errors the page raised: its errors first, then a line that names a
+     * session decision or comes from a molecule package, then any other warning, then the browser's
+     * own resource error ({@link traceArtifactsScript}).
+     */
     console: string[];
     /**
      * The test's LAST user action before the failing assertion and the requests it caused — what the
@@ -145,7 +149,10 @@ export interface TraceArtifact {
 export declare const MAX_TRACE_ARTIFACTS = 12;
 /** How many requests one test's trace contributes. */
 export declare const MAX_TRACED_REQUESTS = 6;
-/** How many console errors one test's trace contributes. */
+/**
+ * How many console lines one test's trace contributes: errors ahead of a session or molecule-package
+ * line, both ahead of a plain warning and of the browser's own resource error.
+ */
 export declare const MAX_TRACED_CONSOLE = 4;
 /** How many of the page's own actions one test's trace contributes, the LAST ones. */
 export declare const MAX_TRACED_ACTIONS = 40;
@@ -170,7 +177,7 @@ export declare const TRACE_NOTE_LEAD_GOT_CHARS = 200;
 /**
  * The Node program the sandbox runs to read a failed run's traces: `node <script> <dir>` prints one
  * `TRACE <json>` line per `trace.zip` under `<dir>` (newest first, {@link MAX_TRACE_ARTIFACTS} of
- * them), each with the test it belongs to, the requests its page made and its console errors.
+ * them), each with the test it belongs to, the requests its page made and its console lines.
  *
  * It is a standalone program, not an import, for the reason `@molecule/api-code-sandbox` runs it:
  * Playwright's own zip reader is not reachable from a project's `node_modules`, and a dependency
@@ -282,7 +289,7 @@ export declare function stalledDocumentSubresource(request: TraceRequest): boole
  * row falls back to {@link TraceArtifact.lead}: the page's last answered fetch/xhr.
  *
  * WHICH rows it spends is evidence, not artifact order (xr-molecule-flash-m112 +53:46): a row
- * needs a recorded response, a real failure or a console error ({@link traceRowEvidence}), rows are
+ * needs a recorded response, a real failure or a console line ({@link traceRowEvidence}), rows are
  * deduplicated by the test's location, and they are ordered real failure → repeated from an
  * earlier walk → the rest ({@link traceRowTier}). Without that the note spent all five rows on four
  * traces of one `afterEach` line whose every request was `-1`, and left the favorite cause — the

package/dist/trace-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B;;;;OAIG;IACH,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,oBAAoB,QAAO,MA8cvC,CAAA;AA8CD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAkCnE;AA2KD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAKnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAG5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAGhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAMzE;AAiQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,SAAS,MAAM,EAAO,EACvC,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,MAAM,GAAG,IAAI,CAoOf;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,8BAA8B,CAAA;AAwG/D,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5C,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2BjC"}
+{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"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"}

package/dist/trace-artifacts.js

@@ -33,7 +33,10 @@ import { isPlaywrightRunCommand, redactSecrets } from './utilities.js';
 export const MAX_TRACE_ARTIFACTS = 12;
 /** How many requests one test's trace contributes. */
 export const MAX_TRACED_REQUESTS = 6;
-/** How many console errors one test's trace contributes. */
+/**
+ * How many console lines one test's trace contributes: errors ahead of a session or molecule-package
+ * line, both ahead of a plain warning and of the browser's own resource error.
+ */
 export const MAX_TRACED_CONSOLE = 4;
 /** How many of the page's own actions one test's trace contributes, the LAST ones. */
 export const MAX_TRACED_ACTIONS = 40;
@@ -60,7 +63,7 @@ const TRACE_NOTE_FAILURE_CHARS = 120;
 /**
  * The Node program the sandbox runs to read a failed run's traces: `node <script> <dir>` prints one
  * `TRACE <json>` line per `trace.zip` under `<dir>` (newest first, {@link MAX_TRACE_ARTIFACTS} of
- * them), each with the test it belongs to, the requests its page made and its console errors.
+ * them), each with the test it belongs to, the requests its page made and its console lines.
  *
  * It is a standalone program, not an import, for the reason `@molecule/api-code-sandbox` runs it:
  * Playwright's own zip reader is not reachable from a project's `node_modules`, and a dependency
@@ -95,6 +98,20 @@ const MAX_CONSOLE = ${MAX_TRACED_CONSOLE}
 const MAX_ACTIONS = ${MAX_TRACED_ACTIONS}
 const MAX_BODY = ${MAX_TRACED_BODY_CHARS}
 const MAX_URL = 200
+// A console line that is not an error but still has to reach the note (m148): one a molecule
+// package wrote — it names the package, the \`[molecule/…]\` prefix, or the \`[scope]\` prefix
+// molecule's own logger writes for a named module ([auth], [http], [i18n]) — or one that names a
+// session decision in the page's own words. \`@molecule/app-auth\` logged "Token refresh failed,
+// logging out" at WARNING level, and this reader kept error entries only, so every trace note
+// carried the browser's generic "Failed to load resource: 401" while the platform's own package was
+// saying, in words, that it had signed the user out.
+const MOLECULE_CONSOLE = /@molecule\\/|\\[molecule[:\\/][^\\]]*\\]|^\\s*\\[[a-z][a-z0-9-]*\\]/
+const SESSION_CONSOLE = /\\b(?:auth(?:entication|enticated|orization|orized)?|session|token|sign(?:ed|ing)?[\\s-]?out|log(?:ged|ging)?[\\s-]?out|refresh(?:ed|ing)?\\s+failed|no\\s+provider)\\b/i
+
+// Whether a console line belongs in the note even though it is not at error level.
+function consoleSignal(text) {
+  return MOLECULE_CONSOLE.test(text) || SESSION_CONSOLE.test(text)
+}
 
 function walk(dir, depth, out) {
   if (depth < 0) return
@@ -508,13 +525,18 @@ for (const one of found.slice(0, MAX_TRACES)) {
     chosen.push(wire(r))
   }
   const consoleErrors = []
+  const consoleSignals = []
+  const consoleWarnings = []
   let spec = null
   let line = 0
   for (const entry of trace) {
     if (!entry) continue
-    if (entry.type === 'console' && entry.messageType === 'error' && typeof entry.text === 'string')
-      consoleErrors.push(entry.text)
-    else if (entry.type === 'event' && entry.method === 'pageError') {
+    if (entry.type === 'console' && typeof entry.text === 'string') {
+      if (entry.messageType === 'error') consoleErrors.push(entry.text)
+      else if (consoleSignal(entry.text)) consoleSignals.push(entry.text)
+      else if (entry.messageType === 'warning' || entry.messageType === 'warn')
+        consoleWarnings.push(entry.text)
+    } else if (entry.type === 'event' && entry.method === 'pageError') {
       const message = messageOf(entry.params)
       if (message) consoleErrors.push(message)
     } else if (entry.type === 'before' && Array.isArray(entry.stack) && entry.stack.length) {
@@ -526,9 +548,13 @@ for (const one of found.slice(0, MAX_TRACES)) {
     }
   }
   // Chromium reports every failed request as a console error too; where the page logged something
-  // of its own about it, that is the line worth reading.
+  // of its own about it, that is the line worth reading. Errors lead, then the lines that name a
+  // session decision or come from a molecule package (m148), then any other warning — the browser's
+  // resource error is last, because it is evidence of a failed request, not of a cause, and the
+  // platform's own package saying "logging out" must not be ranked below it.
   const specific = consoleErrors.filter(function (text) { return !/^Failed to load resource/.test(text) })
-  const keptConsole = specific.length > 0 ? specific : consoleErrors
+  const keptConsole = specific.concat(consoleSignals, consoleWarnings)
+  if (specific.length === 0) keptConsole.push.apply(keptConsole, consoleErrors)
   if (chosen.length === 0 && keptConsole.length === 0 && actions.length === 0) continue
   process.stdout.write('TRACE ' + JSON.stringify({
     dir: path.relative(ROOT, path.dirname(one.file)),
@@ -910,7 +936,7 @@ function repeatsEarlierFailure(item, earlier) {
 }
 /**
  * Whether a trace holds evidence the note can explain: a request that got a RECORDED response, a
- * real failure (4xx/5xx or a network error), or a console error. A request with no response is
+ * real failure (4xx/5xx or a network error), or a console line. A request with no response is
  * not evidence (m112 +53:46): four of the note's five rows were traces of one `afterEach` line
  * whose every request was `-1`, so the favorite cause — repeated in all three walks — stayed
  * hidden in "… and 7 more traced failures".
@@ -921,7 +947,7 @@ function repeatsEarlierFailure(item, earlier) {
  * `page.goto` timed out ({@link stalledDocumentSubresource}).
  *
  * @param item - One traced failure.
- * @returns True when the trace holds a request or console error worth a row.
+ * @returns True when the trace holds a request or console line worth a row.
  */
 function traceRowEvidence(item) {
     return (item.console.length > 0 ||
@@ -1112,7 +1138,7 @@ function missingApiPrefixSentence(request) {
  * row falls back to {@link TraceArtifact.lead}: the page's last answered fetch/xhr.
  *
  * WHICH rows it spends is evidence, not artifact order (xr-molecule-flash-m112 +53:46): a row
- * needs a recorded response, a real failure or a console error ({@link traceRowEvidence}), rows are
+ * needs a recorded response, a real failure or a console line ({@link traceRowEvidence}), rows are
  * deduplicated by the test's location, and they are ordered real failure → repeated from an
  * earlier walk → the rest ({@link traceRowTier}). Without that the note spent all five rows on four
  * traces of one `afterEach` line whose every request was `-1`, and left the favorite cause — the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-tools",
-  "version": "1.9.10",
+  "version": "1.9.11",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",