@faithfulalabi/agent-lens 0.14.0 → 0.15.1

package/dist/src/db/read.js

@@ -139,7 +139,9 @@ const EVENT_COLUMNS = `id, turn_id, seq, kind, ts, request_id, block_index, name
      text, text_bytes, output_storage, spill_path, spill_bytes,
      model, tokens_in, tokens_out, tokens_cache_read, tokens_cache_write, est_cost,
      child_session_id, agent_type, agent_status, raw_type, raw_subtype, image_count,
-     json_extract(attrs, '$.renderedRole') AS rendered_role`;
+     json_extract(attrs, '$.renderedRole') AS rendered_role,
+     json_extract(attrs, '$.permissionSource') AS permission_source,
+     json_extract(attrs, '$.permissionReasonType') AS permission_reason_type`;
 export function buildEventPageSql(session_id, query) {
     return {
         sql: `SELECT ${EVENT_COLUMNS} FROM events WHERE session_id = ? AND seq >= ?` +
@@ -190,7 +192,7 @@ const SPILL_SNIPPET = `snippet(spill_fts, 3, '<mark>', '</mark>', '…', 12)`;
 function ftsPhrase(q) {
     return `"${q.replaceAll('"', '""')}"`;
 }
-const SEARCHABLE = `e.kind <> 'unknown'`;
+const SEARCHABLE = `(e.kind <> 'unknown' OR json_extract(e.attrs, '$.filename') IS NOT NULL)`;
 function searchSql(scoped) {
     const scope = scoped ? ' AND e.session_id = :session' : '';
     const events = `SELECT e.session_id AS session_id, s.title AS session_title, s.project_path AS project_path,` +

package/dist/src/db/schema.js

@@ -272,7 +272,8 @@ CREATE TABLE events (
   attrs              TEXT NOT NULL DEFAULT '{}'  -- ALLOWLIST ONLY: attributionSkill,
                                             -- attributionAgent, effort, permissionMode,
                                             -- compactMetadata, toolDenialKind, renderedRole,
-                                            -- unknown_fields[]
+                                            -- permissionSource, permissionReasonType,
+                                            -- filename, unknown_fields[]
 );
 CREATE UNIQUE INDEX idx_events_session_seq ON events(session_id, seq);
 CREATE INDEX        idx_events_turn        ON events(turn_id, seq);

package/dist/src/project/pipeline.js

@@ -2,7 +2,7 @@ import { asyncAgentLaunch, taskNotification } from '../transcript/agents.js';
 import { attachmentRecord } from '../transcript/attachments.js';
 import { contentBlocks, imageCount, resultText } from '../transcript/blocks.js';
 import { isHumanPrompt, MACHINERY_TAGS } from '../transcript/human.js';
-import { apiErrorText, foldControlLines, foldSessionEnvelope, permissionDecision, promptGroupId, toolDenialKind, turnDurationMs, } from '../transcript/line.js';
+import { apiErrorText, foldControlLines, foldSessionEnvelope, permissionDecision, permissionGrounds, promptGroupId, toolDenialKind, turnDurationMs, } from '../transcript/line.js';
 import { foldRequestGroup, groupByRequestId, modelOfRequestGroup, requestIdOf, } from '../transcript/usage.js';
 import { joinToolCalls, NO_INPUT, NO_WIRE_INPUT, toolInput, wireInput, } from './tools.js';
 import { wireInputOf } from '../transcript/wire.js';
@@ -138,6 +138,7 @@ export function runPipeline(lines, ctx) {
                 is_error: block.is_error,
                 denial: toolDenialKind(line),
                 decision: permissionDecision(line),
+                grounds: permissionGrounds(line),
                 launch: asyncAgentLaunch(line, output),
                 ts: line.timestamp ?? '',
                 result_offset: line.byte_offset,
@@ -180,7 +181,7 @@ export function runPipeline(lines, ctx) {
         const usage = usageAt.get(index);
         const record = blocks.length === 0 ? attachmentRecord(line) : undefined;
         const lineText = blocks.length === 0 ? (record?.text ?? apiErrorText(line)) : undefined;
-        const attrs = record?.role === undefined ? '{}' : JSON.stringify({ renderedRole: record.role });
+        const attrs = JSON.stringify({ renderedRole: record?.role, filename: record?.filename });
         let stamped = false;
         const emit = (block, blockIndex) => {
             if (block?.kind === 'unknown_block')

package/dist/src/project/tools.js

@@ -113,6 +113,14 @@ export function joinToolCalls(events, results, notifications, drift) {
             statedDenial(result.decision) !== (result.denial !== undefined)) {
             drift.notePermissionDecisionMismatch();
         }
+        const { source, reasonType } = result.grounds;
+        if (source !== undefined || reasonType !== undefined) {
+            event.attrs = JSON.stringify({
+                ...JSON.parse(event.attrs),
+                permissionSource: source,
+                permissionReasonType: reasonType,
+            });
+        }
         if (event.name === 'Agent' && result.launch !== undefined) {
             backPatch(event, answers.get(event.id));
             continue;

package/dist/src/transcript/attachments.js

@@ -6,12 +6,14 @@ function placeholder(subtype) {
 export function attachmentRecord(line) {
     if (line.kind !== 'attachment')
         return undefined;
-    const subtype = str(obj(line.raw.attachment, undefined)?.type, '');
+    const payload = obj(line.raw.attachment, undefined);
+    const subtype = str(payload?.type, '');
     const first = arr(line.raw.rendered, NO_ELEMENTS)[0];
     const rendered = str(obj(first, undefined)?.content, undefined);
     return {
         subtype,
         text: rendered ?? placeholder(subtype),
         role: str(line.raw.renderedRole, undefined),
+        filename: str(payload?.filename, undefined),
     };
 }

package/dist/src/transcript/blocks.js

@@ -73,7 +73,8 @@ export function classifyContent(content) {
 export function resultText(children) {
     const texts = children.flatMap((child) => (child.kind === 'text' ? [child.text] : []));
     const images = children.flatMap((child) => (child.kind === 'image' ? [child.placeholder] : []));
-    return [...texts, ...images].join('\n');
+    const refs = children.flatMap((child) => child.kind === 'tool_reference' ? [`[tool_reference ${child.name}]`] : []);
+    return [...texts, ...images, ...refs].join('\n');
 }
 export function contentBlocks(line) {
     return classifyContent(rawContent(line));

package/dist/src/transcript/line.js

@@ -308,6 +308,13 @@ export function permissionDecision(line) {
         return undefined;
     return str(obj(line.raw.permissionDecision, undefined)?.decision, '');
 }
+export function permissionGrounds(line) {
+    const stated = obj(line.raw.permissionDecision, undefined);
+    return {
+        source: str(stated?.source, '') || undefined,
+        reasonType: str(stated?.reasonType, '') || undefined,
+    };
+}
 export function turnDurationMs(line) {
     return line.kind === 'system' && line.subtype === 'turn_duration'
         ? num(line.raw.durationMs, undefined)

package/dist/src/transcript/version.js

@@ -1 +1 @@
-export const PROJECTOR_VERSION = 19;
+export const PROJECTOR_VERSION = 21;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faithfulalabi/agent-lens",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Local-first agentic tracing platform: inspect everything your agent did in a session.",
   "type": "module",
   "license": "MIT",