@kienmatu/inkos-core 0.1.0

package/dist/interaction/session-transcript.js

@@ -0,0 +1,164 @@
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { TranscriptEventSchema } from "./session-transcript-schema.js";
+const SESSIONS_DIR = ".inkos/sessions";
+const appendQueues = new Map();
+export function sessionsDir(projectRoot) {
+    return join(projectRoot, SESSIONS_DIR);
+}
+export function transcriptPath(projectRoot, sessionId) {
+    return join(sessionsDir(projectRoot), `${sessionId}.jsonl`);
+}
+export function legacyBookSessionPath(projectRoot, sessionId) {
+    return join(sessionsDir(projectRoot), `${sessionId}.json`);
+}
+export async function readTranscriptEvents(projectRoot, sessionId) {
+    let raw;
+    try {
+        raw = await readFile(transcriptPath(projectRoot, sessionId), "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const events = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = TranscriptEventSchema.safeParse(JSON.parse(line));
+            if (parsed.success)
+                events.push(parsed.data);
+        }
+        catch {
+            continue;
+        }
+    }
+    return events.sort((a, b) => a.seq - b.seq);
+}
+export async function nextTranscriptSeq(projectRoot, sessionId) {
+    const events = await readTranscriptEvents(projectRoot, sessionId);
+    return events.reduce((max, event) => Math.max(max, event.seq), 0) + 1;
+}
+export async function appendTranscriptEvent(projectRoot, event) {
+    await appendTranscriptEvents(projectRoot, event.sessionId, () => [event]);
+}
+export async function appendTranscriptEvents(projectRoot, sessionId, buildEvents) {
+    const key = `${projectRoot}:${sessionId}`;
+    const previous = appendQueues.get(key) ?? Promise.resolve();
+    let result = [];
+    const next = previous.then(async () => {
+        const events = await readTranscriptEvents(projectRoot, sessionId);
+        const nextSeq = events.reduce((max, event) => Math.max(max, event.seq), 0) + 1;
+        const built = await buildEvents({ events, nextSeq });
+        result = built.map((event) => TranscriptEventSchema.parse(event));
+        if (result.length === 0)
+            return;
+        await mkdir(sessionsDir(projectRoot), { recursive: true });
+        await appendFile(transcriptPath(projectRoot, sessionId), `${result.map((event) => JSON.stringify(event)).join("\n")}\n`, "utf-8");
+    });
+    appendQueues.set(key, next.catch(() => undefined));
+    await next;
+    return result;
+}
+function transcriptRoleForMessage(message) {
+    if (!message || typeof message !== "object" || !("role" in message))
+        return null;
+    const role = message.role;
+    return role === "user" || role === "assistant" || role === "toolResult" || role === "system"
+        ? role
+        : null;
+}
+function messageTimestamp(message) {
+    if (message && typeof message === "object") {
+        const timestamp = message.timestamp;
+        if (typeof timestamp === "number" && Number.isFinite(timestamp) && timestamp >= 0) {
+            return Math.floor(timestamp);
+        }
+    }
+    return Date.now();
+}
+function toolCallIdForMessage(message) {
+    if (!message || typeof message !== "object")
+        return undefined;
+    if (message.role === "toolResult") {
+        const toolCallId = message.toolCallId;
+        return typeof toolCallId === "string" && toolCallId.length > 0 ? toolCallId : undefined;
+    }
+    const content = message.content;
+    if (!Array.isArray(content))
+        return undefined;
+    const block = content.find((item) => !!item &&
+        typeof item === "object" &&
+        item.type === "toolCall" &&
+        typeof item.id === "string");
+    return block?.id;
+}
+export async function appendManualSessionMessages(projectRoot, sessionId, messages, input = "", options = {}) {
+    const persistedMessages = messages
+        .map((message) => ({ message, role: transcriptRoleForMessage(message) }))
+        .filter((entry) => entry.role !== null);
+    if (persistedMessages.length === 0)
+        return;
+    const requestId = randomUUID();
+    await appendTranscriptEvents(projectRoot, sessionId, ({ nextSeq }) => {
+        let seq = nextSeq;
+        const events = [{
+                type: "request_started",
+                version: 1,
+                sessionId,
+                requestId,
+                seq: seq++,
+                timestamp: Date.now(),
+                ...(options.sessionKind ? { sessionKind: options.sessionKind } : {}),
+                input,
+            }];
+        let parentUuid = null;
+        let lastAssistantUuid = null;
+        for (const { message, role } of persistedMessages) {
+            const uuid = randomUUID();
+            const isToolResult = role === "toolResult";
+            const toolCallId = toolCallIdForMessage(message);
+            const legacyDisplay = role === "assistant" && options.legacyDisplay
+                ? {
+                    ...(options.legacyDisplay.thinking ? { thinking: options.legacyDisplay.thinking } : {}),
+                    ...(options.legacyDisplay.toolExecutions?.length
+                        ? { toolExecutions: [...options.legacyDisplay.toolExecutions] }
+                        : {}),
+                }
+                : undefined;
+            events.push({
+                type: "message",
+                version: 1,
+                sessionId,
+                requestId,
+                uuid,
+                parentUuid: isToolResult && lastAssistantUuid ? lastAssistantUuid : parentUuid,
+                seq: seq++,
+                role,
+                timestamp: messageTimestamp(message),
+                ...(toolCallId ? { toolCallId } : {}),
+                ...(isToolResult && lastAssistantUuid
+                    ? { sourceToolAssistantUuid: lastAssistantUuid }
+                    : {}),
+                ...(legacyDisplay && (legacyDisplay.thinking || legacyDisplay.toolExecutions?.length)
+                    ? { legacyDisplay }
+                    : {}),
+                message,
+            });
+            if (role === "assistant")
+                lastAssistantUuid = uuid;
+            parentUuid = uuid;
+        }
+        events.push({
+            type: "request_committed",
+            version: 1,
+            sessionId,
+            requestId,
+            seq,
+            timestamp: Date.now(),
+        });
+        return events;
+    });
+}
+//# sourceMappingURL=session-transcript.js.map

package/dist/interaction/session-transcript.js.map

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