@viewportai/daemon 0.1.0

package/dist/discovery/jsonl-reader.d.ts

@@ -0,0 +1,122 @@
+/**
+ * JSONL session reader — reads Claude Code session files from ~/.claude/projects/.
+ *
+ * Claude Code stores conversation history as JSONL files:
+ *   ~/.claude/projects/{encoded-path}/{session-id}.jsonl
+ *
+ * Each line is a JSON object with a `type` field:
+ *   - 'user'      — user message (message.content is text or content blocks)
+ *   - 'assistant'  — agent message (message.content is text or content blocks)
+ *   - 'progress'   — tool progress events
+ *   - 'system'     — system events
+ *   - 'file-history-snapshot' — file state snapshots
+ *
+ * Each line also carries: sessionId, cwd, timestamp, uuid, parentUuid.
+ */
+export interface SessionSummary {
+    sessionId: string;
+    /** First user message (truncated). */
+    summary: string;
+    /** Message count (user + assistant). */
+    messageCount: number;
+    /** Last activity ISO timestamp. */
+    lastActivity: string;
+    /** Working directory. */
+    cwd: string;
+    /** Git branch at session time. */
+    gitBranch?: string;
+    /** Whether session can be resumed via SDK. */
+    resumable: boolean;
+}
+export interface SessionMessage {
+    type: 'user' | 'assistant';
+    text: string;
+    timestamp: string;
+    uuid: string;
+}
+export type RichSessionMessage = {
+    kind: 'text';
+    role: 'user' | 'assistant';
+    text: string;
+    ts: string;
+    uuid: string;
+} | {
+    kind: 'tool_use';
+    toolName: string;
+    toolId: string;
+    input: Record<string, unknown>;
+    ts: string;
+    uuid: string;
+} | {
+    kind: 'tool_result';
+    toolId: string;
+    output: string;
+    isError: boolean;
+    ts: string;
+    uuid: string;
+} | {
+    kind: 'thinking';
+    text: string;
+    ts: string;
+    uuid: string;
+};
+/**
+ * Decode a Claude Code project directory name back to a filesystem path.
+ * Claude-style encoding:
+ *   '/'  -> '-'
+ *   '-'  -> '--'
+ * Example: /Users/dev-user/my-project -> -Users-dev--user-my--project
+ */
+export declare function decodeProjectDir(dirName: string): string;
+/**
+ * Encode a filesystem path to a Claude Code project directory name.
+ * '/'  -> '-'
+ * '-'  -> '--'
+ */
+export declare function encodeProjectDir(fsPath: string): string;
+/** Path to Claude Code's projects directory. */
+export declare function claudeProjectsDir(): string;
+/**
+ * List all Claude Code project directories.
+ * Returns decoded paths and their encoded directory names.
+ */
+export declare function listProjects(): Promise<Array<{
+    dirName: string;
+    fsPath: string;
+}>>;
+/**
+ * List sessions for a specific project directory.
+ * Reads JSONL files and extracts summary metadata.
+ * @param projectDirName - Encoded project directory name
+ * @param basePath - Override base path (defaults to ~/.claude/projects/)
+ */
+export declare function listProjectSessions(projectDirName: string, basePath?: string): Promise<SessionSummary[]>;
+/**
+ * Read full session messages from a JSONL file.
+ * Returns user and assistant messages in order (flat text only).
+ * @deprecated Use readSessionMessagesRich() for structured content blocks.
+ */
+export declare function readSessionMessages(projectDirName: string, sessionId: string, basePath?: string): Promise<SessionMessage[]>;
+/**
+ * Read full session messages from a JSONL file as structured content blocks.
+ * Each content block (text, tool_use, tool_result, thinking) becomes its own
+ * RichSessionMessage, preserving the order they appear in the JSONL.
+ *
+ * Delegates per-entry parsing to parseJSONLEntry().
+ */
+export declare function readSessionMessagesRich(projectDirName: string, sessionId: string, basePath?: string): Promise<RichSessionMessage[]>;
+/**
+ * Read rich session messages from an arbitrary JSONL file path.
+ * Supports both Claude JSONL and Codex session JSONL envelope formats.
+ */
+export declare function readRichSessionMessagesFromFile(filePath: string): Promise<RichSessionMessage[]>;
+/**
+ * Parse a single JSONL entry (already JSON.parsed) into RichSessionMessage blocks.
+ * A single entry may produce 0, 1, or many blocks (e.g. an assistant message
+ * with text + tool_use + thinking blocks).
+ *
+ * Extracted from readSessionMessagesRich() so both the full-file reader
+ * and the incremental tailer can share the same parsing logic.
+ */
+export declare function parseJSONLEntry(entry: unknown): RichSessionMessage[];
+//# sourceMappingURL=jsonl-reader.d.ts.map

package/dist/discovery/jsonl-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-reader.d.ts","sourceRoot":"","sources":["../../src/discovery/jsonl-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpF;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMjE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAavD;AAMD,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAuBxF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAiC3B;AAkFD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAG/B;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAmB/B;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAKpE"}