@1agents/session-reader 0.6.1 → 0.7.0

package/dist/src/store/schema.js

@@ -7,7 +7,7 @@
  * the behaviour — never derive them from a git hash, `dist` ships without git.
  */
 /** DDL layout. A bump drops and rebuilds the whole database. */
-export const SCHEMA_VERSION = 1;
+export const SCHEMA_VERSION = 2;
 /** L1 semantics — anything in `parsers/` that changes normalized events. */
 export const PARSER_VERSION = 3;
 /** L2 rules — `writes.ts` / `ledger.ts`. Re-derives facts from stored events. */

package/dist/src/store/write.js

@@ -1,3 +1,4 @@
+import { encodeText } from './nul.js';
 import fs from 'node:fs';
 import crypto from 'node:crypto';
 import { PARSER_VERSION } from './schema.js';
@@ -51,7 +52,7 @@ export function writeSession(db, session, fingerprint, turnCount) {
          id, provider, native_id, source_path, workspace, title, started_at, ended_at,
          event_count, turn_count, source_size, source_mtime_ms, head_hash, aux_fingerprint,
          parser_version, extractor_version, edge_version, indexed_at, artifacts_json, stats_json
-       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, 0, ?, ?, ?)`).run(id, session.ref.provider, session.ref.id, session.ref.path, session.ref.workspace ?? null, session.ref.title ?? null, session.ref.createdAt ?? null, session.ref.updatedAt ?? null, session.turns.length, turnCount, fingerprint.sourceSize, fingerprint.sourceMtimeMs, fingerprint.headHash, fingerprint.auxFingerprint ?? null, PARSER_VERSION, new Date().toISOString(), JSON.stringify(session.artifacts), JSON.stringify(session.stats));
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, 0, ?, ?, ?)`).run(id, session.ref.provider, session.ref.id, session.ref.path, session.ref.workspace ?? null, encodeText(session.ref.title), session.ref.createdAt ?? null, session.ref.updatedAt ?? null, session.turns.length, turnCount, fingerprint.sourceSize, fingerprint.sourceMtimeMs, fingerprint.headHash, fingerprint.auxFingerprint ?? null, PARSER_VERSION, new Date().toISOString(), JSON.stringify(session.artifacts), JSON.stringify(session.stats));
         const insert = db.prepare(`INSERT INTO events (
          session_id, idx, kind, text, tool_name, tool_args_json, tool_result, is_error,
          ts, source_index, exit_code, pid, duration_ms, provider_truncated
@@ -60,7 +61,7 @@ export function writeSession(db, session, fingerprint, turnCount) {
         // 0.08% and silently dropped search hits from long build logs — exactly
         // the kind of "looks complete, isn't" answer this store exists to remove.
         for (const event of session.turns) {
-            insert.run(id, event.index, event.kind, event.text ?? null, event.toolName ?? null, event.toolArgs ? JSON.stringify(event.toolArgs) : null, event.toolResult ?? null, event.isError === undefined ? null : event.isError ? 1 : 0, event.timestamp ?? null, event.sourceIndex ?? null, event.exitCode ?? null, event.processId ?? null, event.durationMs ?? null, event.truncated === undefined ? null : event.truncated ? 1 : 0);
+            insert.run(id, event.index, event.kind, encodeText(event.text), event.toolName ?? null, event.toolArgs ? JSON.stringify(event.toolArgs) : null, encodeText(event.toolResult), event.isError === undefined ? null : event.isError ? 1 : 0, event.timestamp ?? null, event.sourceIndex ?? null, event.exitCode ?? null, event.processId ?? null, event.durationMs ?? null, event.truncated === undefined ? null : event.truncated ? 1 : 0);
         }
         db.exec('COMMIT');
     }

package/dist/src/web/api.d.ts

@@ -0,0 +1,72 @@
+import type { ServerResponse } from 'node:http';
+import type { NormalizedSession } from '../types.js';
+export interface SessionApiOptions {
+    /** Used when the client asks for scope=cwd but does not send ?workspace=. */
+    fallbackCwd: string;
+}
+export declare function resolveListWorkspace(scope: string | null, workspace: string | null, fallbackCwd: string): string | undefined;
+/** Chat-preview turns. Built only after the user clicks a session. */
+export declare function previewTurns(normalized: NormalizedSession): {
+    no: number;
+    turn: number;
+    status: import("../types.js").TurnStatus;
+    prompt: string;
+    userPrompt: string;
+    outcome: string;
+    assistantReply: string;
+    thinking: string;
+    thinkingBlocks: string[];
+    toolCalls: any[];
+    files: string[];
+    commands: number;
+    errors: number;
+    startedAt: string | undefined;
+    endedAt: string | undefined;
+    durationMs: number | undefined;
+}[];
+export declare function sessionPreview(sessionId: string): Promise<{
+    ref: import("../types.js").SessionRef;
+    stats: import("../types.js").ProviderStats;
+    overview: import("../types.js").SessionOverview;
+    turns: {
+        no: number;
+        turn: number;
+        status: import("../types.js").TurnStatus;
+        prompt: string;
+        userPrompt: string;
+        outcome: string;
+        assistantReply: string;
+        thinking: string;
+        thinkingBlocks: string[];
+        toolCalls: any[];
+        files: string[];
+        commands: number;
+        errors: number;
+        startedAt: string | undefined;
+        endedAt: string | undefined;
+        durationMs: number | undefined;
+    }[];
+    files: {
+        displayPath: string;
+        path: string;
+        host?: string;
+        operation: string;
+        turn: number;
+        eventIndex: number;
+        timestamp?: string;
+        provenance: import("../types.js").Provenance;
+        extractor: string;
+        group: import("../types.js").FileGroup;
+    }[];
+}>;
+export declare function listSessionsForUi(options: {
+    limit?: number;
+    provider?: string;
+    since?: string;
+    workspace?: string;
+}): Promise<import("../types.js").SessionRef[]>;
+/**
+ * Shared JSON API used by the DSH plugin and `1session web`.
+ * Path is already stripped of `/api/session-reader`. Returns false if unmatched.
+ */
+export declare function handleSessionApi(pathname: string, url: URL, res: ServerResponse, options: SessionApiOptions): Promise<boolean>;

package/dist/src/web/api.js

@@ -0,0 +1,126 @@
+import { buildOverview, displayPath, fileLedger, listRecentSessions, loadSession, searchSessions, summarizeTurns, } from '../index.js';
+export function resolveListWorkspace(scope, workspace, fallbackCwd) {
+    if (scope === 'global')
+        return undefined;
+    if (workspace)
+        return workspace;
+    if (scope && scope !== 'cwd')
+        return scope;
+    return fallbackCwd;
+}
+/** Chat-preview turns. Built only after the user clicks a session. */
+export function previewTurns(normalized) {
+    return summarizeTurns(normalized).map((ts) => {
+        const evs = (normalized.turns || []).slice(ts.events[0], ts.events[1] + 1);
+        const thinkingEvents = evs.filter((e) => e.kind === 'thinking');
+        const assistantEvents = evs.filter((e) => e.kind === 'assistant');
+        const toolCalls = [];
+        for (let i = 0; i < evs.length; i++) {
+            const e = evs[i];
+            if (e.kind === 'tool_call') {
+                const result = evs.slice(i + 1).find((r) => r.kind === 'tool_result' && (r.toolName === e.toolName || !r.toolName));
+                toolCalls.push({
+                    id: e.id,
+                    toolName: e.toolName,
+                    args: e.toolArgs,
+                    result: result?.toolResult,
+                    exitCode: result?.exitCode,
+                    isError: result?.isError,
+                });
+            }
+        }
+        return {
+            no: ts.no,
+            turn: ts.no,
+            status: ts.status,
+            prompt: ts.prompt,
+            userPrompt: ts.prompt,
+            outcome: ts.outcome,
+            assistantReply: assistantEvents.map((a) => a.text).filter(Boolean).join('\n\n') || ts.outcome,
+            thinking: thinkingEvents.map((t) => t.text).filter(Boolean).join('\n\n'),
+            thinkingBlocks: thinkingEvents.map((t) => t.text).filter(Boolean),
+            toolCalls,
+            files: ts.files,
+            commands: ts.commands,
+            errors: ts.errors,
+            startedAt: ts.startedAt,
+            endedAt: ts.endedAt,
+            durationMs: ts.durationMs,
+        };
+    });
+}
+export async function sessionPreview(sessionId) {
+    const normalized = await loadSession(sessionId, { useIndex: true });
+    const workspace = normalized.ref.workspace;
+    return {
+        ref: normalized.ref,
+        stats: normalized.stats,
+        overview: buildOverview(normalized),
+        turns: previewTurns(normalized),
+        files: fileLedger(normalized).map((record) => ({
+            ...record,
+            displayPath: displayPath(record, workspace),
+        })),
+    };
+}
+export async function listSessionsForUi(options) {
+    const limit = options.limit ?? 50;
+    return listRecentSessions({
+        limit,
+        provider: options.provider,
+        since: options.since,
+        workspace: options.workspace,
+        useIndex: false,
+        scan: Math.min(Math.max(limit * 4, 80), 200),
+    });
+}
+function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.statusCode = status;
+    res.setHeader('Content-Type', 'application/json; charset=utf-8');
+    res.end(payload);
+}
+/**
+ * Shared JSON API used by the DSH plugin and `1session web`.
+ * Path is already stripped of `/api/session-reader`. Returns false if unmatched.
+ */
+export async function handleSessionApi(pathname, url, res, options) {
+    if (pathname === '/sessions' || pathname === '' || pathname === '/') {
+        const limit = url.searchParams.get('limit') ? Number(url.searchParams.get('limit')) : 50;
+        const scope = url.searchParams.get('scope');
+        const provider = url.searchParams.get('provider') || undefined;
+        const since = url.searchParams.get('since') ?? undefined;
+        const workspace = resolveListWorkspace(scope, url.searchParams.get('workspace'), options.fallbackCwd);
+        const sessions = await listSessionsForUi({ limit, provider, since, workspace });
+        sendJson(res, 200, { sessions });
+        return true;
+    }
+    if (pathname === '/search') {
+        const query = url.searchParams.get('q') ?? '';
+        const scope = url.searchParams.get('scope');
+        const since = url.searchParams.get('since') ?? undefined;
+        const provider = url.searchParams.get('provider') ?? undefined;
+        const limit = url.searchParams.get('limit') ? Number(url.searchParams.get('limit')) : 20;
+        const workspace = resolveListWorkspace(scope, url.searchParams.get('workspace'), options.fallbackCwd);
+        const hits = await searchSessions(query, { workspace, since, provider, limit });
+        sendJson(res, 200, { hits });
+        return true;
+    }
+    const matchSession = pathname.match(/^\/session\/([^/]+)$/);
+    if (matchSession) {
+        const sessionId = decodeURIComponent(matchSession[1]);
+        try {
+            sendJson(res, 200, await sessionPreview(sessionId));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/session not found/i.test(msg)) {
+                sendJson(res, 404, { error: `Session not found: ${sessionId}` });
+                return true;
+            }
+            throw err;
+        }
+        return true;
+    }
+    return false;
+}

package/dist/src/web/app.d.ts

@@ -0,0 +1 @@
+export {};