@zintrust/trace 0.4.92 → 0.4.95

package/dist/build-manifest.json

@@ -1,15 +1,15 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.4.92",
-  "buildDate": "2026-04-10T08:41:38.521Z",
+  "version": "0.4.95",
+  "buildDate": "2026-04-11T17:50:25.235Z",
   "buildEnvironment": {
-    "node": "v20.20.2",
-    "platform": "linux",
-    "arch": "x64"
+    "node": "v22.22.1",
+    "platform": "darwin",
+    "arch": "arm64"
   },
   "git": {
-    "commit": "d195a996",
-    "branch": "master"
+    "commit": "8f4c9f2f",
+    "branch": "release"
   },
   "package": {
     "engines": {
@@ -21,6 +21,10 @@
     ]
   },
   "files": {
+    "build-manifest.json": {
+      "size": 14440,
+      "sha256": "cbd454ac88211f4242ab1d62b641b064452d5532792e5ecae7cbe2a49f4d652a"
+    },
     "cli-register.d.ts": {
       "size": 255,
       "sha256": "da8d689fe5ef32e97e755f28017e4d3cb1aa63489073a71907ea41ad5761ede9"
@@ -66,16 +70,16 @@
       "sha256": "4862b41e0477f01afa0dbb446d4553b65c22ed774cd1e2db3489059ced392f94"
     },
     "dashboard/ui.js": {
-      "size": 73577,
-      "sha256": "2903901d8c0c5076118aa691727daa79be7abe87fdb393c5b389a2b1a8fce170"
+      "size": 74630,
+      "sha256": "925ab75a6176dc4639d0772eda904f1401d73e866f0f0882450d9fd4e253ad89"
     },
     "index.d.ts": {
-      "size": 2470,
-      "sha256": "99c28d43f79dbb2b372bf6a8b611841c131f59f5066702b499915b874e9fa2b8"
+      "size": 2537,
+      "sha256": "1707d26322dbad17f6bf85938ae6fe2477e84c7fed3333760ce8d6eadfaaffd2"
     },
     "index.js": {
-      "size": 3255,
-      "sha256": "683151fa06b666ec62b150a4fda949c3d35221228b8538644ef740252b63587d"
+      "size": 3325,
+      "sha256": "3715aa0dca22638b15c2ec534e2463d7c82268e7648f75571c591d07edc9a0de"
     },
     "migrations/20260331000001_create_zin_trace_entries_table.d.ts": {
       "size": 304,
@@ -130,8 +134,24 @@
       "sha256": "71d366165dd36f1675aa253a76262b226fb6c62e5ab632746b8aea61c0c625fc"
     },
     "register.js": {
-      "size": 14225,
-      "sha256": "07e1643982cc93149c609d44beb11dea168ecf1cac3f78d95d6d22fedcafbc23"
+      "size": 14327,
+      "sha256": "efc9bb131b9eef7e81a6f85ea3338fd8ac74257f794aa0fc7c76efed636f99d8"
+    },
+    "storage/DebuggerStorage.d.ts": {
+      "size": 517,
+      "sha256": "c9c215aaa414f7b0c1fec6c82b054fc52bdf97af58f96f35c7f96672fb859c31"
+    },
+    "storage/DebuggerStorage.js": {
+      "size": 7442,
+      "sha256": "5ecce0fcfcf695df587a7b90a7a5c7efd2e64ad13c9f2d104b392f89f34f0dc4"
+    },
+    "storage/TraceContentBudget.d.ts": {
+      "size": 159,
+      "sha256": "d899a615e6cf2a5eea51f6200347cb81fbaae11979b801859f57135083aaf85b"
+    },
+    "storage/TraceContentBudget.js": {
+      "size": 4022,
+      "sha256": "4b1d4f0ad7da15caeaa1f9fe8b4edcd3000b0000c5bdc270601cd6db2eedce2e"
     },
     "storage/TraceContentRedaction.d.ts": {
       "size": 207,
@@ -314,8 +334,8 @@
       "sha256": "ce9a95a670f755193fd74ce721dbfa4b30f20c879a6566ebb35229b3b2435429"
     },
     "watchers/HttpWatcher.js": {
-      "size": 5916,
-      "sha256": "9b3fed08fd11f8a2bfe1f667293af437b00f11dcc66bfb545b2f77925394e611"
+      "size": 6165,
+      "sha256": "aa18bc520f5f17a73aa12b71e57d825f5fc75cddb909ebdb222c0ce03291685d"
     },
     "watchers/JobWatcher.d.ts": {
       "size": 441,
@@ -346,16 +366,16 @@
       "sha256": "5a28b472c835bd0f79ec9d3670516544bc5b6da9f1f1bed5159be0cba39304a1"
     },
     "watchers/MiddlewareWatcher.js": {
-      "size": 1133,
-      "sha256": "90cb56a6266e5793a6f1b93b769ad74caf83bef1cf80fa4cc67a87185c401d19"
+      "size": 1399,
+      "sha256": "54c7c2c7b1cbeaf3987a7e888b3494c12e8848bfb9d07be8be35934bd6a7c63d"
     },
     "watchers/ModelWatcher.d.ts": {
       "size": 285,
       "sha256": "4c05112af855a92b3f3f97c6b61bf1b07444bcb7d5a17f3e0ae19da4a85faf1c"
     },
     "watchers/ModelWatcher.js": {
-      "size": 1130,
-      "sha256": "de3d1e379c7b1289167fe0b1dbf2aa5a54137b841df17c8d397ee656d9ce37fd"
+      "size": 1381,
+      "sha256": "0ead883fad311762f8310a3748d4859d2913ad92c8fd0db48b7070fe4b5e9d70"
     },
     "watchers/NotificationWatcher.d.ts": {
       "size": 274,

package/dist/dashboard/ui.js

@@ -215,6 +215,19 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
       return ' method-other';
     };
 
+    const normalizeMethodLabel = (value) => {
+      const method = String(value || '').trim().toUpperCase();
+      if (method === '') return 'Request';
+      return method.charAt(0) + method.slice(1).toLowerCase();
+    };
+
+    const entryTypeLabel = (entry) => {
+      if (entry && entry.type === 'request') {
+        return normalizeMethodLabel(entry.content && entry.content.method);
+      }
+      return String(entry && entry.type || '');
+    };
+
     const typeClass = (entryOrType, maybeEntry) => {
       const entry = maybeEntry || (typeof entryOrType === 'object' ? entryOrType : null);
       const type = entry && entry.type ? entry.type : entryOrType;
@@ -427,7 +440,7 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
 
     const entrySummaryText = (entry) => {
       const content = entry && entry.content ? entry.content : {};
-      if (entry.type === 'request') return [content.responseStatus || '', content.method || '', content.uri || ''].filter(Boolean).join(' ');
+      if (entry.type === 'request') return [content.responseStatus || '', content.uri || ''].filter(Boolean).join(' ');
       if (entry.type === 'query') return String(content.sql || '').slice(0, 160);
       if (entry.type === 'exception') return [content.class || '', content.message || ''].filter(Boolean).join(': ');
       if (entry.type === 'log') return '[' + String(content.level || 'log') + '] ' + String(content.message || '').slice(0, 160);
@@ -624,8 +637,8 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
     const renderTraceItems = (entries, options = {}) => {
       if (entries.length === 0) return '<p class="trace-note">No related entries captured.</p>';
 
-      const collapsible = options.collapsible === true;
-      const isInitiallyOpen = options.collapsed !== true;
+      const collapsible = options.collapsible !== false;
+      const isInitiallyOpen = options.collapsed === false;
 
       return '<div class="trace-panel">' + entries.map((entry) => {
         if (collapsible) {
@@ -633,7 +646,7 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
             '<details class="trace-item trace-disclosure"' + (isInitiallyOpen ? ' open' : '') + '>',
             '<summary class="trace-item-head trace-summary">',
             '<span class="trace-summary-main">',
-            '<span><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></span>',
+            '<span><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></span>',
             '<span class="trace-summary-copy">' + entrySummaryInlineHtml(entry) + '</span>',
             '</span>',
             '<span class="activity-head">' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></span>',
@@ -650,7 +663,7 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
           '<section class="trace-item">',
           '<div class="trace-item-head">',
           '<div>',
-          '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span>',
+          '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span>',
           '</div>',
           '<div class="activity-head">' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div>',
           '</div>',
@@ -673,14 +686,16 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
         { id: 'headers', label: 'Headers' },
         { id: 'response', label: 'Response' },
         { id: 'queries', label: 'Queries', count: batchEntriesByType('query').length },
+        { id: 'middleware', label: 'Middleware', count: batchEntriesByType('middleware').length },
+        { id: 'models', label: 'Models', count: batchEntriesByType('model').length },
         { id: 'logs', label: 'Logs', count: batchEntriesByType('log').length },
         { id: 'exceptions', label: 'Exceptions', count: batchEntriesByType('exception').length },
         { id: 'http', label: 'HTTP', count: batchEntriesByType('client_request').length },
         { id: 'cache', label: 'Cache', count: batchEntriesByType('cache').length },
-        { id: 'other', label: 'Other', count: batchEntries().filter((item) => !['request','query','log','exception','client_request','cache'].includes(item.type)).length }
+        { id: 'other', label: 'Other', count: batchEntries().filter((item) => !['request','query','middleware','model','log','exception','client_request','cache'].includes(item.type)).length }
       ];
       const currentTab = traceTabs.some((tab) => tab.id === state.detailTab) ? state.detailTab : 'summary';
-      const otherEntries = batchEntries().filter((item) => !['request','query','log','exception','client_request','cache'].includes(item.type));
+      const otherEntries = batchEntries().filter((item) => !['request','query','middleware','model','log','exception','client_request','cache'].includes(item.type));
       const panels = {
         summary: [
           '<div class="detail-grid">',
@@ -699,12 +714,17 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
           renderMetricBox('Tags', [
             { label: 'Values', value: tagsHtml(entry.tags) || '<span class="activity-time">-</span>' }
           ]),
+          renderMetricBox('Route middleware', [
+            { label: 'Attached', value: escapeHtml(Array.isArray(content.middleware) && content.middleware.length > 0 ? content.middleware.join(', ') : 'None') }
+          ]),
           '</div>'
         ].join(''),
         payload: detailJson(content.payload || {}, 'Payload Json'),
         headers: '<div class="detail-stack">' + detailJson(content.headers || {}, 'Request Header Json') + detailJson(content.responseHeaders || {}, 'Response Header Json') + '</div>',
         response: '<div class="detail-stack"><div class="detail-grid">' + renderMetricBox('Status', [{ label: 'Response status', value: escapeHtml(content.responseStatus || '') }, { label: 'Duration', value: escapeHtml(formatDuration(getEntryDuration(entry))) }]) + '</div>' + (content.responseBody === undefined ? '<p class="trace-note">No response body was captured for this request.</p>' : detailJson(content.responseBody, 'Response Body Json')) + detailJson(content.responseHeaders || {}, 'Response Header Json') + '</div>',
-        queries: renderTraceItems(batchEntriesByType('query'), { collapsible: true, collapsed: true }),
+        queries: renderTraceItems(batchEntriesByType('query')),
+        middleware: renderTraceItems(batchEntriesByType('middleware')),
+        models: renderTraceItems(batchEntriesByType('model')),
         logs: renderTraceItems(batchEntriesByType('log')),
         exceptions: renderTraceItems(batchEntriesByType('exception')),
         http: renderTraceItems(batchEntriesByType('client_request')),
@@ -716,8 +736,8 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
         '<span class="back-link" data-action="close-detail"><- Back to entries</span>',
         '<section class="panel detail-card">',
         '<div>' + (entry.type === 'request'
-          ? '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span> <span class="' + typeClass(entry) + '">' + escapeHtml(content.responseStatus || '') + '</span> <span class="mono">' + escapeHtml(content.uri || '') + '</span> ' + tagsHtml(entry.tags)
-          : '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span> ' + tagsHtml(entry.tags)) + '</div>',
+          ? '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span> <span class="' + typeClass(entry) + '">' + escapeHtml(content.responseStatus || '') + '</span> <span class="mono">' + escapeHtml(content.uri || '') + '</span> ' + tagsHtml(entry.tags)
+          : '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span> ' + tagsHtml(entry.tags)) + '</div>',
         '<div class="detail-meta"><span>UUID <span class="mono">' + escapeHtml(entry.uuid) + '</span></span><span>Batch <span class="mono">' + escapeHtml(entry.batchId || '-') + '</span></span><span>' + durationHtml(entry) + '</span><span>' + escapeHtml(new Date(Number(entry.createdAt)).toISOString()) + '</span></div>',
         '<div class="trace-tabs">',
         traceTabs.map((tab) => '<button type="button" class="trace-tab' + (tab.id === currentTab ? ' active' : '') + '" data-action="detail-tab" data-tab="' + escapeHtml(tab.id) + '">' + escapeHtml(tab.label) + (tab.count !== undefined ? ' (' + escapeHtml(tab.count) + ')' : '') + '</button>').join(''),
@@ -743,10 +763,10 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
         const recentRows = recent.data || [];
         const recentTable = recentRows.length === 0
           ? '<div class="empty">No trace entries recorded.</div>'
-          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
+          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
         const activityList = recentRows.length === 0
           ? '<div class="empty">No recent activity.</div>'
-          : '<ul class="activity-list">' + recentRows.slice(0, 5).map((entry) => '<li class="activity-item"><div class="activity-head"><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span>' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div><div class="activity-summary">' + escapeHtml(entrySummaryText(entry)) + '</div></li>').join('') + '</ul>';
+          : '<ul class="activity-list">' + recentRows.slice(0, 5).map((entry) => '<li class="activity-item"><div class="activity-head"><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span>' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div><div class="activity-summary">' + escapeHtml(entrySummaryText(entry)) + '</div></li>').join('') + '</ul>';
 
         main.innerHTML = [
           statsCardsHtml(stats),
@@ -790,7 +810,7 @@ const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
         const total = Number(response.total || 0);
         const perPage = Number(response.perPage || 50);
         const totalPages = Math.max(1, Math.ceil(total / perPage));
-        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="mono">' + batchSnippet(entry.batchId) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
+        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="mono">' + batchSnippet(entry.batchId) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
 
         main.innerHTML = [
           '<section class="panel">',

package/dist/index.d.ts

@@ -8,6 +8,7 @@
 export { TraceConfig } from './config';
 export { TraceStorage } from './storage';
 export type { ITraceStorage } from './storage';
+export { TraceContentBudget } from './storage/TraceContentBudget';
 export { TraceContentRedaction } from './storage/TraceContentRedaction';
 export { TraceContext } from './context';
 export { registerTraceDashboard, registerTraceRoutes } from './dashboard/routes';

package/dist/index.js

@@ -14,6 +14,7 @@ export { TraceConfig } from './config.js';
 // Storage
 // ---------------------------------------------------------------------------
 export { TraceStorage } from './storage/index.js';
+export { TraceContentBudget } from './storage/TraceContentBudget.js';
 export { TraceContentRedaction } from './storage/TraceContentRedaction.js';
 // ---------------------------------------------------------------------------
 // Context

package/dist/register.js

@@ -22,6 +22,7 @@
 import { TraceConfig } from './config.js';
 import { TraceContext } from './context.js';
 import { TraceStorage } from './storage/index.js';
+import { TraceContentBudget } from './storage/TraceContentBudget.js';
 import { TraceContentRedaction } from './storage/TraceContentRedaction.js';
 import { TraceEntryFiltering } from './storage/TraceEntryFiltering.js';
 import { TraceWriteDiagnostics } from './storage/TraceWriteDiagnostics.js';
@@ -256,7 +257,7 @@ if (!traceAlreadyInitialized && Env) {
             envKey: 'TRACE_QUERY_CONNECTION',
         });
         await assertTraceStorageReady(core, storageDb, resolvedConnectionName);
-        const storage = TraceWriteDiagnostics.wrapStorage(TraceContentRedaction.wrapStorage(TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(storageDb), config), config.redaction), {
+        const storage = TraceWriteDiagnostics.wrapStorage(TraceContentBudget.wrapStorage(TraceContentRedaction.wrapStorage(TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(storageDb), config), config.redaction)), {
             connectionName: resolvedConnectionName,
             logger: core.Logger,
         });

package/dist/storage/DebuggerStorage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TraceStorage — sealed namespace wrapping the D1/SQLite driver.
+ * Resolves the correct IDatabase from the app config, then delegates all
+ * read/write operations to the trace storage facade.
+ */
+import type { IDatabase } from '@zintrust/core';
+import type { ITraceStorage } from '../types';
+export declare const TraceStorage: Readonly<{
+    resolveStorage: (db: IDatabase) => ITraceStorage;
+    reset: () => void;
+    familyHash: (input: string) => string;
+}>;
+export { type ITraceStorage } from '../types';

package/dist/storage/DebuggerStorage.js

@@ -0,0 +1,195 @@
+import { familyHash } from '../utils/familyHash.js';
+const TABLE_ENTRIES = 'zin_trace_entries';
+const TABLE_TAGS = 'zin_trace_entries_tags';
+const TABLE_MONITORING = 'zin_trace_monitoring';
+const generateUuid = () => crypto.randomUUID();
+const rowToEntry = (row, tags) => ({
+    uuid: row.uuid,
+    batchId: row.batch_id,
+    familyHash: row.family_hash ?? undefined,
+    type: row.type,
+    content: JSON.parse(row.content),
+    tags,
+    isLatest: Boolean(row.is_latest),
+    createdAt: row.created_at,
+});
+const insertTags = async (db, uuid, tags) => {
+    if (tags.length === 0)
+        return;
+    await Promise.all(tags.map(async (tag) => {
+        await db.execute(`INSERT OR IGNORE INTO ${TABLE_TAGS} (entry_uuid, tag) VALUES (?, ?)`, [
+            uuid,
+            tag,
+        ]);
+    }));
+};
+const buildEntryFilters = (opts) => {
+    const conditions = [];
+    const params = [];
+    if (opts.type) {
+        conditions.push('e.type = ?');
+        params.push(opts.type);
+    }
+    if (opts.batchId) {
+        conditions.push('e.batch_id = ?');
+        params.push(opts.batchId);
+    }
+    if (opts.from) {
+        conditions.push('e.created_at >= ?');
+        params.push(opts.from);
+    }
+    if (opts.to) {
+        conditions.push('e.created_at <= ?');
+        params.push(opts.to);
+    }
+    let joinClause = '';
+    if (opts.tag) {
+        joinClause = `INNER JOIN ${TABLE_TAGS} t ON t.entry_uuid = e.uuid AND t.tag = ?`;
+        params.unshift(opts.tag);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const countParams = opts.tag ? [opts.tag, ...params.slice(1)] : [...params];
+    return { joinClause, whereClause, params, countParams };
+};
+const loadTagsByUuid = async (db, uuids) => {
+    const tagsByUuid = new Map();
+    if (uuids.length === 0)
+        return tagsByUuid;
+    const tagRows = (await db.query(`SELECT entry_uuid, tag FROM ${TABLE_TAGS} WHERE entry_uuid IN (${uuids.map(() => '?').join(',')})`, uuids));
+    for (const tagRow of tagRows) {
+        const tags = tagsByUuid.get(tagRow.entry_uuid) ?? [];
+        tags.push(tagRow.tag);
+        tagsByUuid.set(tagRow.entry_uuid, tags);
+    }
+    return tagsByUuid;
+};
+// The storage facade intentionally groups related DB operations in one factory.
+// eslint-disable-next-line max-lines-per-function
+const createStorage = (db) => {
+    const writeEntry = async (entry) => {
+        const uuid = entry.uuid || generateUuid();
+        await db.execute(`INSERT INTO ${TABLE_ENTRIES} (uuid, batch_id, family_hash, type, content, is_latest, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            uuid,
+            entry.batchId,
+            entry.familyHash ?? null,
+            entry.type,
+            JSON.stringify(entry.content),
+            entry.isLatest ? 1 : 0,
+            entry.createdAt,
+        ]);
+        await insertTags(db, uuid, entry.tags);
+    };
+    const updateEntry = async (uuid, patch) => {
+        const sets = [];
+        const params = [];
+        if (patch.content !== undefined) {
+            sets.push('content = ?');
+            params.push(JSON.stringify(patch.content));
+        }
+        if (patch.isLatest !== undefined) {
+            sets.push('is_latest = ?');
+            params.push(patch.isLatest ? 1 : 0);
+        }
+        if (sets.length === 0)
+            return;
+        params.push(uuid);
+        await db.execute(`UPDATE ${TABLE_ENTRIES} SET ${sets.join(', ')} WHERE uuid = ?`, params);
+    };
+    const markFamilyStale = async (hash, exceptUuid) => {
+        await db.execute(`UPDATE ${TABLE_ENTRIES} SET is_latest = 0
+       WHERE family_hash = ? AND uuid != ? AND is_latest = 1`, [hash, exceptUuid]);
+    };
+    const queryEntries = async (opts) => {
+        const page = opts.page ?? 1;
+        const perPage = opts.perPage ?? 50;
+        const offset = (page - 1) * perPage;
+        const { joinClause, whereClause, params, countParams } = buildEntryFilters(opts);
+        const countResult = (await db.queryOne(`SELECT COUNT(*) as cnt FROM ${TABLE_ENTRIES} e ${joinClause} ${whereClause}`, countParams));
+        const total = countResult?.cnt ?? 0;
+        const rows = (await db.query(`SELECT e.id, e.uuid, e.batch_id, e.family_hash, e.type, e.content, e.is_latest, e.created_at
+       FROM ${TABLE_ENTRIES} e ${joinClause} ${whereClause}
+       ORDER BY e.created_at DESC, e.id DESC
+       LIMIT ? OFFSET ?`, [...params, perPage, offset]));
+        const tagsByUuid = await loadTagsByUuid(db, rows.map((row) => row.uuid));
+        return {
+            data: rows.map((row) => rowToEntry(row, tagsByUuid.get(row.uuid) ?? [])),
+            total,
+        };
+    };
+    const getEntry = async (uuid) => {
+        const row = (await db.queryOne(`SELECT id, uuid, batch_id, family_hash, type, content, is_latest, created_at
+       FROM ${TABLE_ENTRIES}
+       WHERE uuid = ?`, [uuid]));
+        if (!row)
+            return null;
+        const tags = (await db.query(`SELECT tag FROM ${TABLE_TAGS} WHERE entry_uuid = ?`, [
+            uuid,
+        ]));
+        return rowToEntry(row, tags.map((tag) => tag.tag));
+    };
+    const getBatch = async (batchId) => {
+        const rows = (await db.query(`SELECT id, uuid, batch_id, family_hash, type, content, is_latest, created_at
+       FROM ${TABLE_ENTRIES}
+       WHERE batch_id = ?
+       ORDER BY created_at ASC, id ASC`, [batchId]));
+        if (rows.length === 0)
+            return [];
+        const tagsByUuid = await loadTagsByUuid(db, rows.map((row) => row.uuid));
+        return rows.map((row) => rowToEntry(row, tagsByUuid.get(row.uuid) ?? []));
+    };
+    const prune = async (olderThanMs, keepExceptions = false) => {
+        const countResult = (await db.queryOne(`SELECT COUNT(*) as cnt FROM ${TABLE_ENTRIES}
+       WHERE created_at < ?
+       ${keepExceptions ? "AND type != 'exception'" : ''}`, [olderThanMs]));
+        const deleted = countResult?.cnt ?? 0;
+        if (deleted === 0)
+            return 0;
+        await db.execute(`DELETE FROM ${TABLE_ENTRIES}
+       WHERE created_at < ?
+       ${keepExceptions ? "AND type != 'exception'" : ''}`, [olderThanMs]);
+        return deleted;
+    };
+    const clear = async () => {
+        await db.execute(`DELETE FROM ${TABLE_ENTRIES}`, []);
+    };
+    const getMonitoring = async () => {
+        const rows = (await db.query(`SELECT tag FROM ${TABLE_MONITORING}`, []));
+        return rows.map((row) => row.tag);
+    };
+    const addMonitoring = async (tag) => {
+        await db.execute(`INSERT OR IGNORE INTO ${TABLE_MONITORING} (tag) VALUES (?)`, [tag]);
+    };
+    const removeMonitoring = async (tag) => {
+        await db.execute(`DELETE FROM ${TABLE_MONITORING} WHERE tag = ?`, [tag]);
+    };
+    const stats = async () => {
+        const rows = (await db.query(`SELECT type, COUNT(*) as cnt FROM ${TABLE_ENTRIES} GROUP BY type`, []));
+        const output = {};
+        for (const row of rows) {
+            output[row.type] = row.cnt;
+        }
+        return output;
+    };
+    return {
+        writeEntry,
+        updateEntry,
+        markFamilyStale,
+        queryEntries,
+        getEntry,
+        getBatch,
+        prune,
+        clear,
+        getMonitoring,
+        addMonitoring,
+        removeMonitoring,
+        stats,
+    };
+};
+const resolveStorage = (db) => {
+    return createStorage(db);
+};
+const reset = () => {
+    return;
+};
+export const TraceStorage = Object.freeze({ resolveStorage, reset, familyHash });

package/dist/storage/TraceContentBudget.d.ts

@@ -0,0 +1,4 @@
+import type { ITraceStorage } from '../types';
+export declare const TraceContentBudget: Readonly<{
+    wrapStorage(storage: ITraceStorage): ITraceStorage;
+}>;

package/dist/storage/TraceContentBudget.js

@@ -0,0 +1,114 @@
+const DEFAULT_MAX_ENTRY_BYTES = 64 * 1024;
+const DEFAULT_MAX_STRING_BYTES = 16 * 1024;
+const DEFAULT_MAX_ARRAY_ITEMS = 25;
+const DEFAULT_MAX_OBJECT_ENTRIES = 40;
+const DEFAULT_MAX_DEPTH = 6;
+const DROPPED_FIELD_MESSAGE = '[trace] Value dropped because the field exceeded the trace storage size limit.';
+const COMPACTED_CONTENT_MESSAGE = '[trace] Trace content was compacted because it exceeded the trace storage size limit.';
+const encoder = new TextEncoder();
+const serializedSize = (value) => {
+    try {
+        return encoder.encode(JSON.stringify(value)).length;
+    }
+    catch {
+        return Number.MAX_SAFE_INTEGER;
+    }
+};
+const describeValueType = (value) => {
+    if (Array.isArray(value))
+        return 'array';
+    if (value === null)
+        return 'null';
+    return typeof value;
+};
+const compactValue = (value, depth) => {
+    if (depth >= DEFAULT_MAX_DEPTH) {
+        return DROPPED_FIELD_MESSAGE;
+    }
+    if (typeof value === 'string') {
+        return serializedSize(value) > DEFAULT_MAX_STRING_BYTES ? DROPPED_FIELD_MESSAGE : value;
+    }
+    if (Array.isArray(value)) {
+        const next = value
+            .slice(0, DEFAULT_MAX_ARRAY_ITEMS)
+            .map((item) => compactValue(item, depth + 1));
+        if (value.length > DEFAULT_MAX_ARRAY_ITEMS) {
+            next.push(`[trace] ${String(value.length - DEFAULT_MAX_ARRAY_ITEMS)} additional items were dropped.`);
+        }
+        return next;
+    }
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    const entries = Object.entries(value);
+    const compactedEntries = entries
+        .slice(0, DEFAULT_MAX_OBJECT_ENTRIES)
+        .map(([key, entryValue]) => [key, compactValue(entryValue, depth + 1)]);
+    if (entries.length > DEFAULT_MAX_OBJECT_ENTRIES) {
+        compactedEntries.push([
+            '__traceNotice',
+            `[trace] ${String(entries.length - DEFAULT_MAX_OBJECT_ENTRIES)} additional fields were dropped.`,
+        ]);
+    }
+    return Object.fromEntries(compactedEntries);
+};
+const compactTopLevelObjectToBudget = (value) => {
+    const compacted = {
+        ...value,
+        __traceNotice: COMPACTED_CONTENT_MESSAGE,
+    };
+    const keysByDescendingSize = Object.keys(compacted)
+        .filter((key) => key !== '__traceNotice')
+        .sort((left, right) => serializedSize(compacted[right]) - serializedSize(compacted[left]));
+    for (const key of keysByDescendingSize) {
+        if (serializedSize(compacted) <= DEFAULT_MAX_ENTRY_BYTES)
+            break;
+        compacted[key] = DROPPED_FIELD_MESSAGE;
+    }
+    return compacted;
+};
+const fitContentToBudget = (content) => {
+    if (serializedSize(content) <= DEFAULT_MAX_ENTRY_BYTES) {
+        return content;
+    }
+    const compacted = compactValue(content, 0);
+    if (serializedSize(compacted) <= DEFAULT_MAX_ENTRY_BYTES) {
+        return compacted;
+    }
+    if (typeof compacted === 'object' && compacted !== null && !Array.isArray(compacted)) {
+        const topLevelCompacted = compactTopLevelObjectToBudget(compacted);
+        if (serializedSize(topLevelCompacted) <= DEFAULT_MAX_ENTRY_BYTES) {
+            return topLevelCompacted;
+        }
+    }
+    return {
+        __traceNotice: COMPACTED_CONTENT_MESSAGE,
+        dropped: true,
+        valueType: describeValueType(content),
+    };
+};
+const fitEntryToBudget = (entry) => ({
+    ...entry,
+    content: fitContentToBudget(entry.content),
+});
+const fitPatchToBudget = (patch) => {
+    if (patch.content === undefined)
+        return patch;
+    return {
+        ...patch,
+        content: fitContentToBudget(patch.content),
+    };
+};
+export const TraceContentBudget = Object.freeze({
+    wrapStorage(storage) {
+        return Object.freeze({
+            ...storage,
+            writeEntry: async (entry) => {
+                await storage.writeEntry(fitEntryToBudget(entry));
+            },
+            updateEntry: async (uuid, patch) => {
+                await storage.updateEntry(uuid, fitPatchToBudget(patch));
+            },
+        });
+    },
+});

package/dist/watchers/HttpWatcher.js

@@ -17,6 +17,12 @@ const normalizeHeaders = (headers) => {
 const normalizeHeaderValue = (value) => {
     return Array.isArray(value) ? value.join(', ') : value;
 };
+const resolveRouteMiddleware = (req) => {
+    const middleware = req.context?.['traceRouteMiddleware'];
+    return Array.isArray(middleware)
+        ? middleware.filter((value) => typeof value === 'string')
+        : [];
+};
 const resolveRequestPayload = (req, config) => {
     const redactFields = [...config.redaction.keys, ...config.redaction.body];
     const requestBody = typeof req.getBody === 'function' ? req.getBody() : req.body;
@@ -108,7 +114,7 @@ const buildEntry = (req, res, start, config, responseCapture) => {
         responseBody: responseCapture.body,
         duration: Date.now() - start,
         memory: TraceContext.getMemory(),
-        middleware: [],
+        middleware: resolveRouteMiddleware(req),
         hostname: TraceContext.getHostname(),
         userId: TraceContext.getUserId(),
     };

package/dist/watchers/MiddlewareWatcher.js

@@ -33,7 +33,12 @@ export const MiddlewareWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        globalThis.__zintrust_trace_middleware_emit__ = emit;
         return () => {
+            const globalState = globalThis;
+            if (globalState.__zintrust_trace_middleware_emit__ === emit) {
+                delete globalState.__zintrust_trace_middleware_emit__;
+            }
             _storage = null;
             _ignoreRoutes = [];
         };

package/dist/watchers/ModelWatcher.js

@@ -34,7 +34,12 @@ export const ModelWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        globalThis.__zintrust_trace_model_emit__ = emit;
         return () => {
+            const globalState = globalThis;
+            if (globalState.__zintrust_trace_model_emit__ === emit) {
+                delete globalState.__zintrust_trace_model_emit__;
+            }
             _storage = null;
             _ignoreRoutes = [];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.4.92",
+  "version": "0.4.95",
   "description": "Trace assistant for ZinTrust: logs requests, queries, exceptions, jobs, and more.",
   "private": false,
   "type": "module",
@@ -40,7 +40,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.4.91"
+    "@zintrust/core": "^0.4.94"
   },
   "publishConfig": {
     "access": "public"

package/src/dashboard/ui.ts

@@ -221,6 +221,19 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
       return ' method-other';
     };
 
+    const normalizeMethodLabel = (value) => {
+      const method = String(value || '').trim().toUpperCase();
+      if (method === '') return 'Request';
+      return method.charAt(0) + method.slice(1).toLowerCase();
+    };
+
+    const entryTypeLabel = (entry) => {
+      if (entry && entry.type === 'request') {
+        return normalizeMethodLabel(entry.content && entry.content.method);
+      }
+      return String(entry && entry.type || '');
+    };
+
     const typeClass = (entryOrType, maybeEntry) => {
       const entry = maybeEntry || (typeof entryOrType === 'object' ? entryOrType : null);
       const type = entry && entry.type ? entry.type : entryOrType;
@@ -433,7 +446,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
 
     const entrySummaryText = (entry) => {
       const content = entry && entry.content ? entry.content : {};
-      if (entry.type === 'request') return [content.responseStatus || '', content.method || '', content.uri || ''].filter(Boolean).join(' ');
+      if (entry.type === 'request') return [content.responseStatus || '', content.uri || ''].filter(Boolean).join(' ');
       if (entry.type === 'query') return String(content.sql || '').slice(0, 160);
       if (entry.type === 'exception') return [content.class || '', content.message || ''].filter(Boolean).join(': ');
       if (entry.type === 'log') return '[' + String(content.level || 'log') + '] ' + String(content.message || '').slice(0, 160);
@@ -630,8 +643,8 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
     const renderTraceItems = (entries, options = {}) => {
       if (entries.length === 0) return '<p class="trace-note">No related entries captured.</p>';
 
-      const collapsible = options.collapsible === true;
-      const isInitiallyOpen = options.collapsed !== true;
+      const collapsible = options.collapsible !== false;
+      const isInitiallyOpen = options.collapsed === false;
 
       return '<div class="trace-panel">' + entries.map((entry) => {
         if (collapsible) {
@@ -639,7 +652,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
             '<details class="trace-item trace-disclosure"' + (isInitiallyOpen ? ' open' : '') + '>',
             '<summary class="trace-item-head trace-summary">',
             '<span class="trace-summary-main">',
-            '<span><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></span>',
+            '<span><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></span>',
             '<span class="trace-summary-copy">' + entrySummaryInlineHtml(entry) + '</span>',
             '</span>',
             '<span class="activity-head">' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></span>',
@@ -656,7 +669,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
           '<section class="trace-item">',
           '<div class="trace-item-head">',
           '<div>',
-          '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span>',
+          '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span>',
           '</div>',
           '<div class="activity-head">' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div>',
           '</div>',
@@ -679,14 +692,16 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         { id: 'headers', label: 'Headers' },
         { id: 'response', label: 'Response' },
         { id: 'queries', label: 'Queries', count: batchEntriesByType('query').length },
+        { id: 'middleware', label: 'Middleware', count: batchEntriesByType('middleware').length },
+        { id: 'models', label: 'Models', count: batchEntriesByType('model').length },
         { id: 'logs', label: 'Logs', count: batchEntriesByType('log').length },
         { id: 'exceptions', label: 'Exceptions', count: batchEntriesByType('exception').length },
         { id: 'http', label: 'HTTP', count: batchEntriesByType('client_request').length },
         { id: 'cache', label: 'Cache', count: batchEntriesByType('cache').length },
-        { id: 'other', label: 'Other', count: batchEntries().filter((item) => !['request','query','log','exception','client_request','cache'].includes(item.type)).length }
+        { id: 'other', label: 'Other', count: batchEntries().filter((item) => !['request','query','middleware','model','log','exception','client_request','cache'].includes(item.type)).length }
       ];
       const currentTab = traceTabs.some((tab) => tab.id === state.detailTab) ? state.detailTab : 'summary';
-      const otherEntries = batchEntries().filter((item) => !['request','query','log','exception','client_request','cache'].includes(item.type));
+      const otherEntries = batchEntries().filter((item) => !['request','query','middleware','model','log','exception','client_request','cache'].includes(item.type));
       const panels = {
         summary: [
           '<div class="detail-grid">',
@@ -705,12 +720,17 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
           renderMetricBox('Tags', [
             { label: 'Values', value: tagsHtml(entry.tags) || '<span class="activity-time">-</span>' }
           ]),
+          renderMetricBox('Route middleware', [
+            { label: 'Attached', value: escapeHtml(Array.isArray(content.middleware) && content.middleware.length > 0 ? content.middleware.join(', ') : 'None') }
+          ]),
           '</div>'
         ].join(''),
         payload: detailJson(content.payload || {}, 'Payload Json'),
         headers: '<div class="detail-stack">' + detailJson(content.headers || {}, 'Request Header Json') + detailJson(content.responseHeaders || {}, 'Response Header Json') + '</div>',
         response: '<div class="detail-stack"><div class="detail-grid">' + renderMetricBox('Status', [{ label: 'Response status', value: escapeHtml(content.responseStatus || '') }, { label: 'Duration', value: escapeHtml(formatDuration(getEntryDuration(entry))) }]) + '</div>' + (content.responseBody === undefined ? '<p class="trace-note">No response body was captured for this request.</p>' : detailJson(content.responseBody, 'Response Body Json')) + detailJson(content.responseHeaders || {}, 'Response Header Json') + '</div>',
-        queries: renderTraceItems(batchEntriesByType('query'), { collapsible: true, collapsed: true }),
+        queries: renderTraceItems(batchEntriesByType('query')),
+        middleware: renderTraceItems(batchEntriesByType('middleware')),
+        models: renderTraceItems(batchEntriesByType('model')),
         logs: renderTraceItems(batchEntriesByType('log')),
         exceptions: renderTraceItems(batchEntriesByType('exception')),
         http: renderTraceItems(batchEntriesByType('client_request')),
@@ -722,8 +742,8 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         '<span class="back-link" data-action="close-detail"><- Back to entries</span>',
         '<section class="panel detail-card">',
         '<div>' + (entry.type === 'request'
-          ? '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span> <span class="' + typeClass(entry) + '">' + escapeHtml(content.responseStatus || '') + '</span> <span class="mono">' + escapeHtml(content.uri || '') + '</span> ' + tagsHtml(entry.tags)
-          : '<span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span> ' + tagsHtml(entry.tags)) + '</div>',
+          ? '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span> <span class="' + typeClass(entry) + '">' + escapeHtml(content.responseStatus || '') + '</span> <span class="mono">' + escapeHtml(content.uri || '') + '</span> ' + tagsHtml(entry.tags)
+          : '<span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span> ' + tagsHtml(entry.tags)) + '</div>',
         '<div class="detail-meta"><span>UUID <span class="mono">' + escapeHtml(entry.uuid) + '</span></span><span>Batch <span class="mono">' + escapeHtml(entry.batchId || '-') + '</span></span><span>' + durationHtml(entry) + '</span><span>' + escapeHtml(new Date(Number(entry.createdAt)).toISOString()) + '</span></div>',
         '<div class="trace-tabs">',
         traceTabs.map((tab) => '<button type="button" class="trace-tab' + (tab.id === currentTab ? ' active' : '') + '" data-action="detail-tab" data-tab="' + escapeHtml(tab.id) + '">' + escapeHtml(tab.label) + (tab.count !== undefined ? ' (' + escapeHtml(tab.count) + ')' : '') + '</button>').join(''),
@@ -749,10 +769,10 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         const recentRows = recent.data || [];
         const recentTable = recentRows.length === 0
           ? '<div class="empty">No trace entries recorded.</div>'
-          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
+          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
         const activityList = recentRows.length === 0
           ? '<div class="empty">No recent activity.</div>'
-          : '<ul class="activity-list">' + recentRows.slice(0, 5).map((entry) => '<li class="activity-item"><div class="activity-head"><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span>' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div><div class="activity-summary">' + escapeHtml(entrySummaryText(entry)) + '</div></li>').join('') + '</ul>';
+          : '<ul class="activity-list">' + recentRows.slice(0, 5).map((entry) => '<li class="activity-item"><div class="activity-head"><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span>' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div><div class="activity-summary">' + escapeHtml(entrySummaryText(entry)) + '</div></li>').join('') + '</ul>';
 
         main.innerHTML = [
           statsCardsHtml(stats),
@@ -796,7 +816,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         const total = Number(response.total || 0);
         const perPage = Number(response.perPage || 50);
         const totalPages = Math.max(1, Math.ceil(total / perPage));
-        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entry.type) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="mono">' + batchSnippet(entry.batchId) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
+        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="mono">' + batchSnippet(entry.batchId) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
 
         main.innerHTML = [
           '<section class="panel">',

package/src/index.ts

@@ -18,6 +18,7 @@ export { TraceConfig } from './config';
 // ---------------------------------------------------------------------------
 export { TraceStorage } from './storage';
 export type { ITraceStorage } from './storage';
+export { TraceContentBudget } from './storage/TraceContentBudget';
 export { TraceContentRedaction } from './storage/TraceContentRedaction';
 
 // ---------------------------------------------------------------------------

package/src/register.ts

@@ -22,6 +22,7 @@
 import { TraceConfig } from './config';
 import { TraceContext } from './context';
 import { TraceStorage } from './storage';
+import { TraceContentBudget } from './storage/TraceContentBudget';
 import { TraceContentRedaction } from './storage/TraceContentRedaction';
 import { TraceEntryFiltering } from './storage/TraceEntryFiltering';
 import { TraceWriteDiagnostics } from './storage/TraceWriteDiagnostics';
@@ -379,9 +380,11 @@ if (!traceAlreadyInitialized && Env) {
     await assertTraceStorageReady(core, storageDb, resolvedConnectionName);
 
     const storage = TraceWriteDiagnostics.wrapStorage(
-      TraceContentRedaction.wrapStorage(
-        TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(storageDb), config),
-        config.redaction
+      TraceContentBudget.wrapStorage(
+        TraceContentRedaction.wrapStorage(
+          TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(storageDb), config),
+          config.redaction
+        )
       ),
       {
         connectionName: resolvedConnectionName,

package/src/storage/TraceContentBudget.ts

@@ -0,0 +1,145 @@
+import type { ITraceEntry, ITraceStorage } from '../types';
+
+const DEFAULT_MAX_ENTRY_BYTES = 64 * 1024;
+const DEFAULT_MAX_STRING_BYTES = 16 * 1024;
+const DEFAULT_MAX_ARRAY_ITEMS = 25;
+const DEFAULT_MAX_OBJECT_ENTRIES = 40;
+const DEFAULT_MAX_DEPTH = 6;
+
+const DROPPED_FIELD_MESSAGE =
+  '[trace] Value dropped because the field exceeded the trace storage size limit.';
+const COMPACTED_CONTENT_MESSAGE =
+  '[trace] Trace content was compacted because it exceeded the trace storage size limit.';
+
+const encoder = new TextEncoder();
+
+const serializedSize = (value: unknown): number => {
+  try {
+    return encoder.encode(JSON.stringify(value)).length;
+  } catch {
+    return Number.MAX_SAFE_INTEGER;
+  }
+};
+
+const describeValueType = (value: unknown): string => {
+  if (Array.isArray(value)) return 'array';
+  if (value === null) return 'null';
+  return typeof value;
+};
+
+const compactValue = (value: unknown, depth: number): unknown => {
+  if (depth >= DEFAULT_MAX_DEPTH) {
+    return DROPPED_FIELD_MESSAGE;
+  }
+
+  if (typeof value === 'string') {
+    return serializedSize(value) > DEFAULT_MAX_STRING_BYTES ? DROPPED_FIELD_MESSAGE : value;
+  }
+
+  if (Array.isArray(value)) {
+    const next = value
+      .slice(0, DEFAULT_MAX_ARRAY_ITEMS)
+      .map((item) => compactValue(item, depth + 1));
+
+    if (value.length > DEFAULT_MAX_ARRAY_ITEMS) {
+      next.push(
+        `[trace] ${String(value.length - DEFAULT_MAX_ARRAY_ITEMS)} additional items were dropped.`
+      );
+    }
+
+    return next;
+  }
+
+  if (typeof value !== 'object' || value === null) {
+    return value;
+  }
+
+  const entries = Object.entries(value);
+  const compactedEntries = entries
+    .slice(0, DEFAULT_MAX_OBJECT_ENTRIES)
+    .map(([key, entryValue]) => [key, compactValue(entryValue, depth + 1)]);
+
+  if (entries.length > DEFAULT_MAX_OBJECT_ENTRIES) {
+    compactedEntries.push([
+      '__traceNotice',
+      `[trace] ${String(entries.length - DEFAULT_MAX_OBJECT_ENTRIES)} additional fields were dropped.`,
+    ]);
+  }
+
+  return Object.fromEntries(compactedEntries);
+};
+
+const compactTopLevelObjectToBudget = (value: Record<string, unknown>): Record<string, unknown> => {
+  const compacted: Record<string, unknown> = {
+    ...value,
+    __traceNotice: COMPACTED_CONTENT_MESSAGE,
+  };
+
+  const keysByDescendingSize = Object.keys(compacted)
+    .filter((key) => key !== '__traceNotice')
+    .sort((left, right) => serializedSize(compacted[right]) - serializedSize(compacted[left]));
+
+  for (const key of keysByDescendingSize) {
+    if (serializedSize(compacted) <= DEFAULT_MAX_ENTRY_BYTES) break;
+    compacted[key] = DROPPED_FIELD_MESSAGE;
+  }
+
+  return compacted;
+};
+
+const fitContentToBudget = (content: unknown): unknown => {
+  if (serializedSize(content) <= DEFAULT_MAX_ENTRY_BYTES) {
+    return content;
+  }
+
+  const compacted = compactValue(content, 0);
+  if (serializedSize(compacted) <= DEFAULT_MAX_ENTRY_BYTES) {
+    return compacted;
+  }
+
+  if (typeof compacted === 'object' && compacted !== null && !Array.isArray(compacted)) {
+    const topLevelCompacted = compactTopLevelObjectToBudget(compacted as Record<string, unknown>);
+    if (serializedSize(topLevelCompacted) <= DEFAULT_MAX_ENTRY_BYTES) {
+      return topLevelCompacted;
+    }
+  }
+
+  return {
+    __traceNotice: COMPACTED_CONTENT_MESSAGE,
+    dropped: true,
+    valueType: describeValueType(content),
+  };
+};
+
+const fitEntryToBudget = (entry: ITraceEntry): ITraceEntry => ({
+  ...entry,
+  content: fitContentToBudget(entry.content),
+});
+
+const fitPatchToBudget = (
+  patch: Partial<Pick<ITraceEntry, 'content' | 'isLatest'>>
+): Partial<Pick<ITraceEntry, 'content' | 'isLatest'>> => {
+  if (patch.content === undefined) return patch;
+
+  return {
+    ...patch,
+    content: fitContentToBudget(patch.content),
+  };
+};
+
+export const TraceContentBudget = Object.freeze({
+  wrapStorage(storage: ITraceStorage): ITraceStorage {
+    return Object.freeze({
+      ...storage,
+      writeEntry: async (entry: ITraceEntry): Promise<void> => {
+        await storage.writeEntry(fitEntryToBudget(entry));
+      },
+      updateEntry: async (
+        uuid: string,
+        patch: Partial<Pick<ITraceEntry, 'content' | 'isLatest'>>
+      ): Promise<void> => {
+        await storage.updateEntry(uuid, fitPatchToBudget(patch));
+      },
+    });
+  },
+});

package/src/watchers/HttpWatcher.ts

@@ -26,6 +26,13 @@ const normalizeHeaderValue = (value: string | string[]): string => {
   return Array.isArray(value) ? value.join(', ') : value;
 };
 
+const resolveRouteMiddleware = (req: IRequest): string[] => {
+  const middleware = req.context?.['traceRouteMiddleware'];
+  return Array.isArray(middleware)
+    ? middleware.filter((value): value is string => typeof value === 'string')
+    : [];
+};
+
 const resolveRequestPayload = (req: IRequest, config: ITraceConfig): unknown => {
   const redactFields = [...config.redaction.keys, ...config.redaction.body];
   const requestBody = typeof req.getBody === 'function' ? req.getBody() : req.body;
@@ -150,7 +157,7 @@ const buildEntry = (
     responseBody: responseCapture.body,
     duration: Date.now() - start,
     memory: TraceContext.getMemory(),
-    middleware: [],
+    middleware: resolveRouteMiddleware(req),
     hostname: TraceContext.getHostname(),
     userId: TraceContext.getUserId(),
   };

package/src/watchers/MiddlewareWatcher.ts

@@ -6,6 +6,10 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
 
+type GlobalMiddlewareTraceState = {
+  __zintrust_trace_middleware_emit__?: typeof emit;
+};
+
 const emit = (name: string, event: MiddlewareContent['event'], duration?: number): void => {
   if (!_storage) return;
   if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
@@ -34,7 +38,12 @@ export const MiddlewareWatcher: ITraceWatcher & { emit: typeof emit } = Object.f
     if (config.watchers.middleware === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    (globalThis as unknown as GlobalMiddlewareTraceState).__zintrust_trace_middleware_emit__ = emit;
     return () => {
+      const globalState = globalThis as unknown as GlobalMiddlewareTraceState;
+      if (globalState.__zintrust_trace_middleware_emit__ === emit) {
+        delete globalState.__zintrust_trace_middleware_emit__;
+      }
       _storage = null;
       _ignoreRoutes = [];
     };

package/src/watchers/ModelWatcher.ts

@@ -6,6 +6,10 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
 
+type GlobalModelTraceState = {
+  __zintrust_trace_model_emit__?: typeof emit;
+};
+
 const emit = (
   action: ModelContent['action'],
   model: string,
@@ -40,7 +44,12 @@ export const ModelWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     if (config.watchers.model === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    (globalThis as unknown as GlobalModelTraceState).__zintrust_trace_model_emit__ = emit;
     return () => {
+      const globalState = globalThis as unknown as GlobalModelTraceState;
+      if (globalState.__zintrust_trace_model_emit__ === emit) {
+        delete globalState.__zintrust_trace_model_emit__;
+      }
       _storage = null;
       _ignoreRoutes = [];
     };