@jamesaphoenix/tx-api-server 0.1.1

package/dist/routes/tasks.js

@@ -0,0 +1,167 @@
+/**
+ * Task Route Handlers
+ *
+ * Implements task endpoint handlers using Effect HttpApiBuilder.
+ * All responses return TaskWithDeps per Doctrine Rule 1.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { Effect } from "effect";
+import { isValidTaskStatus, TASK_STATUSES, serializeTask } from "@jamesaphoenix/tx-types";
+import { TaskService, ReadyService, DependencyService, HierarchyService } from "@jamesaphoenix/tx-core";
+import { TxApi, BadRequest, mapCoreError } from "../api.js";
+const parseCursor = (cursor) => {
+    const colonIndex = cursor.lastIndexOf(":");
+    if (colonIndex === -1)
+        return null;
+    const score = parseInt(cursor.slice(0, colonIndex), 10);
+    const id = cursor.slice(colonIndex + 1);
+    if (isNaN(score))
+        return null;
+    return { score, id };
+};
+const buildCursor = (task) => {
+    return `${task.score}:${task.id}`;
+};
+// -----------------------------------------------------------------------------
+// Handler Layer
+// -----------------------------------------------------------------------------
+export const TasksLive = HttpApiBuilder.group(TxApi, "tasks", (handlers) => handlers
+    .handle("listTasks", ({ urlParams }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    const limit = urlParams.limit ?? 20;
+    // Validate status filter
+    let statusFilter;
+    if (urlParams.status) {
+        const statuses = urlParams.status.split(",").filter(Boolean);
+        const invalidStatuses = statuses.filter(s => !isValidTaskStatus(s));
+        if (invalidStatuses.length > 0) {
+            return yield* Effect.fail(new BadRequest({ message: `Invalid status values: ${invalidStatuses.join(", ")}. Valid: ${TASK_STATUSES.join(", ")}` }));
+        }
+        statusFilter = statuses;
+    }
+    // Parse cursor for keyset pagination
+    let cursorObj;
+    if (urlParams.cursor) {
+        const parsed = parseCursor(urlParams.cursor);
+        if (parsed) {
+            cursorObj = { score: parsed.score, id: parsed.id };
+        }
+    }
+    const filter = {
+        status: statusFilter,
+        search: urlParams.search,
+        cursor: cursorObj,
+        limit: limit + 1,
+    };
+    const total = yield* taskService.count({
+        status: statusFilter,
+        search: urlParams.search,
+    });
+    const tasks = yield* taskService.listWithDeps(filter);
+    const hasMore = tasks.length > limit;
+    const resultTasks = hasMore ? tasks.slice(0, limit) : tasks;
+    return {
+        tasks: resultTasks.map(serializeTask),
+        nextCursor: hasMore && resultTasks.length > 0
+            ? buildCursor(resultTasks[resultTasks.length - 1])
+            : null,
+        hasMore,
+        total,
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("readyTasks", ({ urlParams }) => Effect.gen(function* () {
+    const readyService = yield* ReadyService;
+    const limit = urlParams.limit ?? 100;
+    const tasks = yield* readyService.getReady(limit);
+    return { tasks: tasks.map(serializeTask) };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getTask", ({ path }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    const task = yield* taskService.getWithDeps(path.id);
+    const blockedByTasks = yield* taskService.getWithDepsBatch(task.blockedBy);
+    const blocksTasks = yield* taskService.getWithDepsBatch(task.blocks);
+    const childTasks = yield* taskService.getWithDepsBatch(task.children);
+    return {
+        task: serializeTask(task),
+        blockedByTasks: blockedByTasks.map(serializeTask),
+        blocksTasks: blocksTasks.map(serializeTask),
+        childTasks: childTasks.map(serializeTask),
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("createTask", ({ payload }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    const created = yield* taskService.create({
+        title: payload.title,
+        description: payload.description,
+        parentId: payload.parentId,
+        score: payload.score,
+        metadata: payload.metadata,
+    });
+    const task = yield* taskService.getWithDeps(created.id);
+    return serializeTask(task);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("updateTask", ({ path, payload }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    yield* taskService.update(path.id, {
+        title: payload.title,
+        description: payload.description,
+        status: payload.status,
+        parentId: payload.parentId,
+        score: payload.score,
+        metadata: payload.metadata,
+    });
+    const task = yield* taskService.getWithDeps(path.id);
+    return serializeTask(task);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("completeTask", ({ path }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    const readyService = yield* ReadyService;
+    const blocking = yield* readyService.getBlocking(path.id);
+    yield* taskService.update(path.id, { status: "done" });
+    const completedTask = yield* taskService.getWithDeps(path.id);
+    const candidateIds = blocking
+        .filter(t => ["backlog", "ready", "planning"].includes(t.status))
+        .map(t => t.id);
+    const candidatesWithDeps = yield* taskService.getWithDepsBatch(candidateIds);
+    const nowReady = candidatesWithDeps.filter(t => t.isReady);
+    return {
+        task: serializeTask(completedTask),
+        nowReady: nowReady.map(serializeTask),
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("deleteTask", ({ path, urlParams }) => Effect.gen(function* () {
+    const taskService = yield* TaskService;
+    const cascade = urlParams.cascade === "true";
+    yield* taskService.remove(path.id, { cascade });
+    return { success: true, id: path.id };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("blockTask", ({ path, payload }) => Effect.gen(function* () {
+    const depService = yield* DependencyService;
+    const taskService = yield* TaskService;
+    yield* depService.addBlocker(path.id, payload.blockerId);
+    const task = yield* taskService.getWithDeps(path.id);
+    return serializeTask(task);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("unblockTask", ({ path }) => Effect.gen(function* () {
+    const depService = yield* DependencyService;
+    const taskService = yield* TaskService;
+    yield* depService.removeBlocker(path.id, path.blockerId);
+    const task = yield* taskService.getWithDeps(path.id);
+    return serializeTask(task);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getTaskTree", ({ path }) => Effect.gen(function* () {
+    const hierarchyService = yield* HierarchyService;
+    const taskService = yield* TaskService;
+    const tree = yield* hierarchyService.getTree(path.id);
+    const flattenTree = (node) => {
+        const ids = [node.task.id];
+        for (const child of node.children) {
+            ids.push(...flattenTree(child));
+        }
+        return ids;
+    };
+    const allIds = flattenTree(tree);
+    const tasks = yield* taskService.getWithDepsBatch(allIds);
+    return { tasks: tasks.map(serializeTask) };
+}).pipe(Effect.mapError(mapCoreError))));
+//# sourceMappingURL=tasks.js.map

package/dist/routes/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/routes/tasks.ts"],"names":[],"mappings":"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"}

package/dist/runtime.d.ts

@@ -0,0 +1,10 @@
+/**
+ * API Server Runtime
+ *
+ * Re-exports server layer factory for programmatic access.
+ * With the Effect HttpApi architecture, the server lifecycle is managed
+ * by Effect's runtime — no ManagedRuntime bridge needed.
+ */
+export { makeServerLive } from "./server-lib.js";
+export { TxApi } from "./api.js";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA"}

package/dist/runtime.js

@@ -0,0 +1,10 @@
+/**
+ * API Server Runtime
+ *
+ * Re-exports server layer factory for programmatic access.
+ * With the Effect HttpApi architecture, the server lifecycle is managed
+ * by Effect's runtime — no ManagedRuntime bridge needed.
+ */
+export { makeServerLive } from "./server-lib.js";
+export { TxApi } from "./api.js";
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA"}

package/dist/server-lib.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TX API Server Library
+ *
+ * REST/HTTP API server using Effect HttpApi.
+ * Provides HTTP interface for task management, learnings, runs, and sync.
+ *
+ * This module provides the library API. For CLI usage, see server.ts.
+ */
+import { Layer } from "effect";
+/**
+ * Create the full server Layer with all dependencies resolved.
+ *
+ * The returned Layer, when launched, starts the HTTP server and keeps
+ * it alive until the process receives a termination signal.
+ */
+export declare const makeServerLive: (options: {
+    port?: number;
+    dbPath?: string;
+    hostname?: string;
+}) => Layer.Layer<never, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").LlmUnavailableError | import("@jamesaphoenix/tx-core").AgentError | import("@effect/platform/HttpServerError").ServeError, never>;
+/**
+ * Parse command line arguments and launch the server.
+ * Exported for use by the CLI entry point.
+ */
+export declare const main: () => void;
+//# sourceMappingURL=server-lib.d.ts.map

package/dist/server-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-lib.d.ts","sourceRoot":"","sources":["../src/server-lib.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAwC9B;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,2OAeA,CAAA;AAiCD;;;GAGG;AACH,eAAO,MAAM,IAAI,QAAO,IA0CvB,CAAA"}

package/dist/server-lib.js

@@ -0,0 +1,123 @@
+/**
+ * TX API Server Library
+ *
+ * REST/HTTP API server using Effect HttpApi.
+ * Provides HTTP interface for task management, learnings, runs, and sync.
+ *
+ * This module provides the library API. For CLI usage, see server.ts.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { NodeHttpServer, NodeRuntime } from "@effect/platform-node";
+import { Layer } from "effect";
+import { createServer } from "node:http";
+import { makeAppLayer } from "@jamesaphoenix/tx-core";
+import { TasksLive } from "./routes/tasks.js";
+import { HealthLive } from "./routes/health.js";
+import { LearningsLive } from "./routes/learnings.js";
+import { RunsLive } from "./routes/runs.js";
+import { SyncLive } from "./routes/sync.js";
+import { DocsLive } from "./routes/docs.js";
+import { ClaimsLive } from "./routes/claims.js";
+import { AttemptsLive } from "./routes/attempts.js";
+import { InvariantsLive } from "./routes/invariants.js";
+import { TxApi } from "./api.js";
+import { authMiddleware, isAuthEnabled } from "./middleware/auth.js";
+import { bodyLimitMiddleware } from "./middleware/body-limit.js";
+import { getCorsConfig } from "./middleware/cors.js";
+// -----------------------------------------------------------------------------
+// API Implementation Layer
+// -----------------------------------------------------------------------------
+/**
+ * Combines all route handler groups into the full API implementation.
+ */
+const ApiLive = HttpApiBuilder.api(TxApi).pipe(Layer.provide(TasksLive), Layer.provide(HealthLive), Layer.provide(LearningsLive), Layer.provide(RunsLive), Layer.provide(SyncLive), Layer.provide(DocsLive), Layer.provide(ClaimsLive), Layer.provide(AttemptsLive), Layer.provide(InvariantsLive));
+// -----------------------------------------------------------------------------
+// Server Layer Factory
+// -----------------------------------------------------------------------------
+/**
+ * Create the full server Layer with all dependencies resolved.
+ *
+ * The returned Layer, when launched, starts the HTTP server and keeps
+ * it alive until the process receives a termination signal.
+ */
+export const makeServerLive = (options) => {
+    const port = options.port ?? parseInt(process.env.TX_API_PORT ?? "3001", 10);
+    const host = options.hostname ?? process.env.TX_API_HOST ?? "127.0.0.1";
+    const dbPath = options.dbPath ?? process.env.TX_DB_PATH ?? ".tx/tasks.db";
+    const appLayer = makeAppLayer(dbPath);
+    return HttpApiBuilder.serve().pipe(Layer.provide(HttpApiBuilder.middleware(bodyLimitMiddleware)), Layer.provide(HttpApiBuilder.middlewareCors(getCorsConfig())), Layer.provide(HttpApiBuilder.middleware(authMiddleware)), Layer.provide(ApiLive), Layer.provide(appLayer), Layer.provide(NodeHttpServer.layer(() => createServer(), { port, host })));
+};
+// -----------------------------------------------------------------------------
+// CLI Support
+// -----------------------------------------------------------------------------
+const HELP_TEXT = `
+tx-api - TX REST API Server
+
+Usage:
+  tx-api [options]
+
+Options:
+  --port, -p <port>  Port to listen on (default: 3001, env: TX_API_PORT)
+  --host <host>      Hostname to bind to (default: localhost, env: TX_API_HOST)
+  --db <path>        Path to SQLite database (default: .tx/tasks.db, env: TX_DB_PATH)
+  --help, -h         Show this help message
+
+Environment Variables:
+  TX_API_PORT              Server port (default: 3001)
+  TX_API_HOST              Server hostname (default: localhost)
+  TX_DB_PATH               Database path (default: .tx/tasks.db)
+  TX_API_KEY               API key for authentication (optional)
+  TX_API_CORS_ORIGIN       Allowed CORS origins (comma-separated, default: localhost only)
+                           Use "*" to allow all origins (not recommended for production)
+
+Examples:
+  tx-api                           # Start with defaults
+  tx-api --port 8080               # Start on port 8080
+  tx-api --db /path/to/tasks.db    # Use custom database
+  TX_API_KEY=secret tx-api         # Enable API key auth
+`;
+/**
+ * Parse command line arguments and launch the server.
+ * Exported for use by the CLI entry point.
+ */
+export const main = () => {
+    const args = process.argv.slice(2);
+    let port;
+    let dbPath;
+    let hostname;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const nextArg = args[i + 1];
+        if ((arg === "--port" || arg === "-p") && nextArg) {
+            port = parseInt(nextArg, 10);
+            i++;
+        }
+        else if (arg === "--db" && nextArg) {
+            dbPath = nextArg;
+            i++;
+        }
+        else if (arg === "--host") {
+            if (nextArg && !nextArg.startsWith("-")) {
+                hostname = nextArg;
+                i++;
+            }
+        }
+        else if (arg === "--help" || arg === "-h") {
+            console.log(HELP_TEXT);
+            process.exit(0);
+        }
+    }
+    const resolvedPort = port ?? parseInt(process.env.TX_API_PORT ?? "3001", 10);
+    const resolvedHost = hostname ?? process.env.TX_API_HOST ?? "127.0.0.1";
+    const resolvedDb = dbPath ?? process.env.TX_DB_PATH ?? ".tx/tasks.db";
+    const authStatus = isAuthEnabled() ? " (auth enabled)" : "";
+    console.log(`TX API Server running at http://${resolvedHost}:${resolvedPort}${authStatus}`);
+    console.log(`  Database: ${resolvedDb}`);
+    const ServerLive = makeServerLive({
+        port: resolvedPort,
+        dbPath: resolvedDb,
+        hostname: resolvedHost,
+    });
+    NodeRuntime.runMain(Layer.launch(ServerLive));
+};
+//# sourceMappingURL=server-lib.js.map

package/dist/server-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-lib.js","sourceRoot":"","sources":["../src/server-lib.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * TX API Server CLI Entry Point
+ *
+ * This module auto-starts the server when executed directly.
+ * For library usage without auto-start, import from '@tx/api-server' instead.
+ *
+ * Usage:
+ *   tx-api                      # Start with default settings
+ *   tx-api --port 3000          # Start on specific port
+ *   tx-api --db /path/to.db     # Start with custom database path
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/server.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * TX API Server CLI Entry Point
+ *
+ * This module auto-starts the server when executed directly.
+ * For library usage without auto-start, import from '@tx/api-server' instead.
+ *
+ * Usage:
+ *   tx-api                      # Start with default settings
+ *   tx-api --port 3000          # Start on specific port
+ *   tx-api --db /path/to.db     # Start with custom database path
+ */
+import { main } from "./server-lib.js";
+main();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,IAAI,EAAE,CAAA"}

package/dist/utils/log-reader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Log File Reader
+ *
+ * Safely reads per-run log files (stdout, stderr, context) from .tx/runs/ directories.
+ * Includes path traversal protection and tail support for large files.
+ */
+import { Effect } from "effect";
+/**
+ * Check if a resolved path is under the project's .tx/runs/ directory.
+ * Uses prefix match (startsWith) not substring match (includes) to prevent
+ * bypasses where /.tx/runs/ appears elsewhere in the path.
+ */
+export declare const isAllowedRunPath: (filePath: string) => boolean;
+/**
+ * Read a log file with optional tail support.
+ * Validates the path is under .tx/runs/ to prevent path traversal.
+ *
+ * @param filePath - Absolute path to the log file
+ * @param tailLines - If > 0, return only the last N lines
+ * @returns The file content and whether it was truncated
+ */
+export declare const readLogFile: (filePath: string, tailLines?: number) => Effect.Effect<{
+    content: string;
+    truncated: boolean;
+}, Error>;
+//# sourceMappingURL=log-reader.d.ts.map

package/dist/utils/log-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-reader.d.ts","sourceRoot":"","sources":["../../src/utils/log-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,OAInD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,YAAW,MAAU,KACpB,MAAM,CAAC,MAAM,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,CA6B3D,CAAA"}

package/dist/utils/log-reader.js

@@ -0,0 +1,52 @@
+/**
+ * Log File Reader
+ *
+ * Safely reads per-run log files (stdout, stderr, context) from .tx/runs/ directories.
+ * Includes path traversal protection and tail support for large files.
+ */
+import { Effect } from "effect";
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve, sep } from "node:path";
+/**
+ * Check if a resolved path is under the project's .tx/runs/ directory.
+ * Uses prefix match (startsWith) not substring match (includes) to prevent
+ * bypasses where /.tx/runs/ appears elsewhere in the path.
+ */
+export const isAllowedRunPath = (filePath) => {
+    const resolved = resolve(filePath);
+    const runsDir = resolve(process.cwd(), ".tx", "runs");
+    return resolved.startsWith(runsDir + sep);
+};
+/**
+ * Read a log file with optional tail support.
+ * Validates the path is under .tx/runs/ to prevent path traversal.
+ *
+ * @param filePath - Absolute path to the log file
+ * @param tailLines - If > 0, return only the last N lines
+ * @returns The file content and whether it was truncated
+ */
+export const readLogFile = (filePath, tailLines = 0) => Effect.gen(function* () {
+    if (!existsSync(filePath)) {
+        return { content: "", truncated: false };
+    }
+    // Security: ensure path is under .tx/runs/ (prefix match, not substring)
+    if (!isAllowedRunPath(filePath)) {
+        return yield* Effect.fail(new Error("Path traversal attempt: log path must be under .tx/runs/"));
+    }
+    const content = yield* Effect.tryPromise({
+        try: () => readFile(filePath, "utf-8"),
+        catch: (err) => new Error(`Failed to read log file: ${String(err)}`),
+    });
+    if (tailLines > 0) {
+        const lines = content.split("\n");
+        if (lines.length > tailLines) {
+            return {
+                content: lines.slice(-tailLines).join("\n"),
+                truncated: true,
+            };
+        }
+    }
+    return { content, truncated: false };
+});
+//# sourceMappingURL=log-reader.js.map

package/dist/utils/log-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-reader.js","sourceRoot":"","sources":["../../src/utils/log-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAW,EAAE;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACrD,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,CAAA;AAC3C,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAgB,EAChB,YAAoB,CAAC,EAC0C,EAAE,CACjE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC1C,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,KAAK,CAAC,0DAA0D,CAAC,CACtE,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QACtC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;KACrE,CAAC,CAAA;IAEF,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3C,SAAS,EAAE,IAAI;aAChB,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AACtC,CAAC,CAAC,CAAA"}

package/dist/utils/transcript-parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Transcript Parser for Claude JSONL files
+ *
+ * Parses Claude's conversation transcript files (~/.claude/projects/.../session.jsonl)
+ * and converts them to a format suitable for display in the dashboard.
+ */
+import { Effect } from "effect";
+export interface ChatMessage {
+    role: "user" | "assistant" | "system";
+    content: string | unknown;
+    type?: "tool_use" | "tool_result" | "text" | "thinking";
+    tool_name?: string;
+    timestamp?: string;
+}
+/**
+ * Validate that a transcript path is under an allowed directory.
+ * Prevents arbitrary file reads via path traversal.
+ *
+ * Allowed directories: ~/.claude/ and any .tx/ directory.
+ */
+export declare const isAllowedTranscriptPath: (filePath: string) => boolean;
+/**
+ * Parse a Claude transcript JSONL file and extract conversation messages
+ */
+export declare const parseTranscript: (path: string) => Effect.Effect<ChatMessage[], Error>;
+/**
+ * Check if a transcript file exists
+ */
+export declare const transcriptExists: (path: string) => boolean;
+/**
+ * Find a transcript file that matches a run's time window.
+ * Looks in ~/.claude/projects/<escaped-cwd>/ for JSONL files modified during the run.
+ *
+ * @param cwd - The working directory (used to find Claude's project directory)
+ * @param startedAt - When the run started
+ * @param endedAt - When the run ended (optional, uses now if not set)
+ * @returns Path to the matching transcript, or null if none found
+ */
+export declare const findMatchingTranscript: (cwd: string, startedAt: Date, endedAt?: Date | null) => Promise<string | null>;
+//# sourceMappingURL=transcript-parser.d.ts.map

package/dist/utils/transcript-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-parser.d.ts","sourceRoot":"","sources":["../../src/utils/transcript-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAgD/B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,CAAA;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,OAgB1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,CAyH7E,CAAA;AAEJ;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAG/C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,EACX,WAAW,IAAI,EACf,UAAU,IAAI,GAAG,IAAI,KACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAkDvB,CAAA"}