@bolt-foundry/gambit 0.8.3 → 0.8.5-rc.10

package/script/src/server_feedback_grading_routes.d.ts

@@ -0,0 +1,32 @@
+import type { SavedState } from "@bolt-foundry/gambit-core";
+import type { SessionMeta } from "./server_types.js";
+type JsonRecord = Record<string, unknown>;
+type HandleGradingReferenceRouteDeps = {
+    url: URL;
+    req: Request;
+    getWorkspaceIdFromBody: (body: JsonRecord) => string | undefined;
+    logWorkspaceBotRoot: (endpoint: string, workspaceId?: string) => Promise<void>;
+    readSessionState: (sessionId: string) => SavedState | undefined;
+    persistSessionState: (state: SavedState) => SavedState;
+    appendGradingLog: (state: SavedState, payload: JsonRecord) => void;
+    buildSessionMeta: (workspaceId: string, state: SavedState) => SessionMeta;
+    appendDurableStreamEvent: (streamId: string, payload: unknown) => void;
+    workspaceStreamId: string;
+    gradeStreamId: string;
+    parseFiniteInteger: (value: unknown) => number | undefined;
+    randomId: (prefix: string) => string;
+};
+export declare const handleGradingReferenceRoute: (deps: HandleGradingReferenceRouteDeps) => Promise<Response | null>;
+type HandleFeedbackRoutesDeps = {
+    url: URL;
+    req: Request;
+    sessionsRoot: string;
+    getWorkspaceIdFromBody: (body: JsonRecord) => string | undefined;
+    readSessionState: (sessionId: string) => SavedState | undefined;
+    persistSessionState: (state: SavedState) => SavedState;
+    appendFeedbackLog: (state: SavedState, payload: JsonRecord) => void;
+    appendSessionEvent: (state: SavedState, payload: JsonRecord) => void;
+};
+export declare const handleFeedbackRoutes: (deps: HandleFeedbackRoutesDeps) => Promise<Response | null>;
+export {};
+//# sourceMappingURL=server_feedback_grading_routes.d.ts.map

package/script/src/server_feedback_grading_routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_feedback_grading_routes.d.ts","sourceRoot":"","sources":["../../src/src/server_feedback_grading_routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,KAAK,+BAA+B,GAAG;IACrC,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,OAAO,CAAC;IACb,sBAAsB,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;IACjE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IAChE,mBAAmB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC;IACvD,gBAAgB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IACnE,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,WAAW,CAAC;IAC1E,wBAAwB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,MAAM,+BAA+B,KACpC,OAAO,CAAC,QAAQ,GAAG,IAAI,CA+NzB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;IACjE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IAChE,mBAAmB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC;IACvD,iBAAiB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IACpE,kBAAkB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,wBAAwB,KAC7B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAyJzB,CAAC"}

package/script/src/server_feedback_grading_routes.js

@@ -0,0 +1,343 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFeedbackRoutes = exports.handleGradingReferenceRoute = void 0;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const handleGradingReferenceRoute = async (deps) => {
+    const { url, req, getWorkspaceIdFromBody, logWorkspaceBotRoot, readSessionState, persistSessionState, appendGradingLog, buildSessionMeta, appendDurableStreamEvent, workspaceStreamId, gradeStreamId, parseFiniteInteger, randomId, } = deps;
+    if (url.pathname !== "/api/grading/reference")
+        return null;
+    if (req.method !== "POST") {
+        return new Response("Method not allowed", { status: 405 });
+    }
+    try {
+        const body = await req.json();
+        const workspaceId = getWorkspaceIdFromBody(body);
+        if (!workspaceId)
+            throw new Error("Missing workspaceId");
+        await logWorkspaceBotRoot("/api/grading/reference", workspaceId);
+        if (!body.runId)
+            throw new Error("Missing runId");
+        if (!body.referenceSample) {
+            throw new Error("Missing referenceSample");
+        }
+        const score = body.referenceSample.score;
+        if (typeof score !== "number" || Number.isNaN(score)) {
+            throw new Error("Invalid reference score");
+        }
+        const reason = body.referenceSample.reason;
+        if (typeof reason !== "string" || reason.trim().length === 0) {
+            throw new Error("Missing reference reason");
+        }
+        const evidence = Array.isArray(body.referenceSample.evidence)
+            ? body.referenceSample.evidence.filter((e) => typeof e === "string" && e.trim().length > 0)
+            : undefined;
+        const state = readSessionState(workspaceId);
+        if (!state)
+            throw new Error("Workspace not found");
+        const previousRuns = Array.isArray(state.meta?.gradingRuns)
+            ? (state.meta
+                .gradingRuns)
+            : Array.isArray(state.meta?.calibrationRuns)
+                ? state.meta?.calibrationRuns
+                : [];
+        const index = previousRuns.findIndex((run) => run.id === body.runId);
+        if (index < 0)
+            throw new Error("Run not found");
+        const run = previousRuns[index];
+        const nextRun = {
+            ...run,
+            id: run.id,
+            workspaceId,
+            gradingRunId: run.id,
+        };
+        const nextOffsetGuess = (parseFiniteInteger(state.meta
+            ?.lastAppliedOffset) ??
+            parseFiniteInteger(state.meta
+                ?.lastAppliedEventSeq) ??
+            -1) + 1;
+        if (typeof body.turnIndex === "number") {
+            const result = run.result;
+            const turnIndex = body.turnIndex;
+            if (!result || typeof result !== "object" ||
+                result.mode !== "turns" ||
+                !Array.isArray(result.turns)) {
+                throw new Error("Run does not support turn references");
+            }
+            const turns = result.turns.map((turn) => ({ ...turn }));
+            const targetIndex = turns.findIndex((turn) => turn.index === turnIndex);
+            if (targetIndex < 0) {
+                throw new Error("Turn not found");
+            }
+            const targetTurn = turns[targetIndex];
+            const messageRefId = typeof targetTurn.messageRefId === "string"
+                ? targetTurn.messageRefId
+                : undefined;
+            if (!messageRefId) {
+                throw new Error("Missing messageRefId for grading turn artifact");
+            }
+            const artifactRevisionId = randomId("grade-ref-rev");
+            const referenceRevision = {
+                artifactRevisionId,
+                workspaceId,
+                gradingRunId: run.id,
+                turnIndex,
+                messageRefId,
+                offset: nextOffsetGuess,
+                createdAt: new Date().toISOString(),
+                referenceSample: { score, reason, evidence },
+            };
+            const previousRevisions = Array.isArray(targetTurn.referenceSampleRevisions)
+                ? targetTurn.referenceSampleRevisions
+                : [];
+            turns[targetIndex] = {
+                ...targetTurn,
+                workspaceId,
+                gradingRunId: run.id,
+                turnIndex,
+                messageRefId,
+                artifactRevisionId,
+                referenceSample: {
+                    score,
+                    reason,
+                    evidence,
+                    artifactRevisionId,
+                    workspaceId,
+                    gradingRunId: run.id,
+                    turnIndex,
+                    messageRefId,
+                },
+                referenceSampleRevisions: [
+                    ...previousRevisions,
+                    referenceRevision,
+                ],
+            };
+            nextRun.result = { ...result, turns };
+        }
+        else {
+            const artifactRevisionId = randomId("grade-ref-rev");
+            const nextRunRecord = nextRun;
+            const previousRevisions = Array.isArray(nextRunRecord.referenceSampleRevisions)
+                ? nextRunRecord.referenceSampleRevisions
+                : [];
+            nextRun.artifactRevisionId =
+                artifactRevisionId;
+            nextRun.referenceSampleRevisions = [
+                ...previousRevisions,
+                {
+                    artifactRevisionId,
+                    workspaceId,
+                    gradingRunId: run.id,
+                    offset: nextOffsetGuess,
+                    createdAt: new Date().toISOString(),
+                    referenceSample: { score, reason, evidence },
+                },
+            ];
+            nextRun.referenceSample = {
+                score,
+                reason,
+                evidence,
+                artifactRevisionId,
+                workspaceId,
+                gradingRunId: run.id,
+            };
+        }
+        const nextRuns = previousRuns.map((entry, i) => i === index ? nextRun : entry);
+        const nextState = persistSessionState({
+            ...state,
+            meta: {
+                ...(state.meta ?? {}),
+                gradingRuns: nextRuns,
+            },
+        });
+        appendGradingLog(nextState, {
+            type: "grading.reference",
+            run: nextRun,
+            runId: body.runId,
+            turnIndex: body.turnIndex,
+            workspaceId,
+        });
+        const sessionMeta = buildSessionMeta(workspaceId, nextState);
+        appendDurableStreamEvent(workspaceStreamId, {
+            type: "calibrateSession",
+            workspaceId,
+            run: nextRun,
+            session: sessionMeta,
+        });
+        appendDurableStreamEvent(gradeStreamId, {
+            type: "calibrateSession",
+            workspaceId,
+            run: nextRun,
+            session: sessionMeta,
+        });
+        return new Response(JSON.stringify({
+            workspaceId,
+            run: nextRun,
+            session: sessionMeta,
+        }), { headers: { "content-type": "application/json" } });
+    }
+    catch (err) {
+        return new Response(JSON.stringify({
+            error: err instanceof Error ? err.message : String(err),
+        }), { status: 400, headers: { "content-type": "application/json" } });
+    }
+};
+exports.handleGradingReferenceRoute = handleGradingReferenceRoute;
+const handleFeedbackRoutes = async (deps) => {
+    const { url, req, sessionsRoot, getWorkspaceIdFromBody, readSessionState, persistSessionState, appendFeedbackLog, appendSessionEvent, } = deps;
+    if (url.pathname === "/api/feedback") {
+        if (req.method !== "GET") {
+            return new Response("Method not allowed", { status: 405 });
+        }
+        const deckPathParam = url.searchParams.get("deckPath");
+        if (!deckPathParam) {
+            return new Response(JSON.stringify({ error: "Missing deckPath" }), { status: 400, headers: { "content-type": "application/json" } });
+        }
+        const items = [];
+        try {
+            for await (const entry of dntShim.Deno.readDir(sessionsRoot)) {
+                if (!entry.isDirectory)
+                    continue;
+                const sessionId = entry.name;
+                const state = readSessionState(sessionId);
+                if (!state)
+                    continue;
+                if (state.meta?.deck !== deckPathParam)
+                    continue;
+                const feedbackList = Array.isArray(state.feedback)
+                    ? state.feedback
+                    : [];
+                feedbackList.forEach((fb) => {
+                    if (!fb || typeof fb !== "object")
+                        return;
+                    const messageRefId = fb
+                        .messageRefId;
+                    if (typeof messageRefId !== "string")
+                        return;
+                    let messageContent = undefined;
+                    if (Array.isArray(state.messageRefs) &&
+                        Array.isArray(state.messages)) {
+                        const idx = state.messageRefs.findIndex((ref) => ref?.id === messageRefId);
+                        if (idx >= 0) {
+                            messageContent = state.messages[idx]?.content;
+                        }
+                    }
+                    items.push({
+                        workspaceId: sessionId,
+                        deck: state.meta?.deck,
+                        sessionCreatedAt: state.meta?.sessionCreatedAt,
+                        messageRefId,
+                        score: fb.score,
+                        reason: fb.reason,
+                        createdAt: fb.createdAt,
+                        archivedAt: fb.archivedAt,
+                        messageContent,
+                    });
+                });
+            }
+        }
+        catch (err) {
+            return new Response(JSON.stringify({
+                error: err instanceof Error ? err.message : String(err),
+            }), { status: 400, headers: { "content-type": "application/json" } });
+        }
+        items.sort((a, b) => {
+            const aTime = String(a.createdAt ?? "") || "";
+            const bTime = String(b.createdAt ?? "") || "";
+            return bTime.localeCompare(aTime);
+        });
+        return new Response(JSON.stringify({ deckPath: deckPathParam, items }), {
+            headers: { "content-type": "application/json" },
+        });
+    }
+    if (url.pathname === "/api/feedback/archive" && req.method === "POST") {
+        try {
+            const body = await req.json();
+            const workspaceId = getWorkspaceIdFromBody(body);
+            if (!workspaceId || !body.messageRefId) {
+                throw new Error("Missing workspaceId or messageRefId");
+            }
+            const state = readSessionState(workspaceId);
+            if (!state || !Array.isArray(state.feedback)) {
+                throw new Error("Workspace not found");
+            }
+            const idx = state.feedback.findIndex((fb) => fb.messageRefId === body.messageRefId);
+            if (idx === -1)
+                throw new Error("Feedback not found");
+            const next = { ...state.feedback[idx] };
+            if (body.archived === false) {
+                delete next.archivedAt;
+            }
+            else {
+                next.archivedAt = new Date()
+                    .toISOString();
+            }
+            const nextFeedback = state.feedback.map((fb, i) => i === idx ? next : fb);
+            const updated = persistSessionState({
+                ...state,
+                feedback: nextFeedback,
+            });
+            appendFeedbackLog(updated, {
+                type: "feedback.archive",
+                messageRefId: body.messageRefId,
+                archivedAt: next.archivedAt,
+                archived: body.archived !== false,
+            });
+            appendSessionEvent(updated, {
+                type: "feedback.archive",
+                kind: "artifact",
+                category: "feedback",
+                workspaceId,
+                messageRefId: body.messageRefId,
+                archivedAt: next.archivedAt,
+                archived: body.archived !== false,
+            });
+            return new Response(JSON.stringify({
+                workspaceId,
+                messageRefId: body.messageRefId,
+                archivedAt: next.archivedAt,
+                saved: true,
+                feedbackCount: updated.feedback?.length ?? 0,
+            }), { headers: { "content-type": "application/json" } });
+        }
+        catch (err) {
+            return new Response(JSON.stringify({
+                error: err instanceof Error ? err.message : String(err),
+            }), { status: 400, headers: { "content-type": "application/json" } });
+        }
+    }
+    return null;
+};
+exports.handleFeedbackRoutes = handleFeedbackRoutes;

package/script/src/server_helpers.d.ts

@@ -0,0 +1,4 @@
+export declare function randomId(prefix: string): string;
+export declare function assertSafeBuildBotRoot(root: string, gambitBotSourceDir: string): void;
+export declare function resolveDefaultValue(raw: unknown): unknown;
+//# sourceMappingURL=server_helpers.d.ts.map

package/script/src/server_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_helpers.d.ts","sourceRoot":"","sources":["../../src/src/server_helpers.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG/C;AAOD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAiCN;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CASzD"}

package/script/src/server_helpers.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomId = randomId;
+exports.assertSafeBuildBotRoot = assertSafeBuildBotRoot;
+exports.resolveDefaultValue = resolveDefaultValue;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const path = __importStar(require("../deps/jsr.io/@std/path/1.1.4/mod.js"));
+function randomId(prefix) {
+    const suffix = crypto.randomUUID().replace(/-/g, "").slice(0, 24);
+    return `${prefix}-${suffix}`;
+}
+function isWithinPath(basePath, targetPath) {
+    const rel = path.relative(basePath, targetPath);
+    return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+}
+function assertSafeBuildBotRoot(root, gambitBotSourceDir) {
+    if (gambitBotSourceDir &&
+        (isWithinPath(root, gambitBotSourceDir) ||
+            isWithinPath(gambitBotSourceDir, root))) {
+        throw new Error(`Unsafe build bot root "${root}": overlaps Gambit Bot source directory "${gambitBotSourceDir}"`);
+    }
+    // Protect against writing into a copied/source Gambit Bot workspace even when
+    // the running CLI is sourced from a different install path.
+    const promptPath = path.join(root, "PROMPT.md");
+    try {
+        const prompt = dntShim.Deno.readTextFileSync(promptPath);
+        const looksLikeGambitBotSourceDeck = prompt.includes('path = "../actions/bot_write/PROMPT.md"') &&
+            prompt.includes('path = "./graders/deck_format_guard/PROMPT.md"');
+        if (looksLikeGambitBotSourceDeck) {
+            throw new Error(`Unsafe build bot root "${root}": appears to be the Gambit Bot source deck directory`);
+        }
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound ||
+            err instanceof dntShim.Deno.errors.IsADirectory) {
+            return;
+        }
+        throw err;
+    }
+}
+function resolveDefaultValue(raw) {
+    if (typeof raw === "function") {
+        try {
+            return raw();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return raw;
+}

package/script/src/server_session_store.d.ts

@@ -0,0 +1,87 @@
+import type { FeedbackEntry, SavedState, TraceEvent } from "@bolt-foundry/gambit-core";
+export type ScenarioRunSummary = {
+    scenarioRunId: string;
+    lastEventSeq: number;
+    updatedAt: string;
+    selectedScenarioDeckId: string;
+    selectedScenarioDeckLabel?: string;
+    scenarioConfigPath: string;
+};
+export type WorkspaceEventDomain = "build" | "test" | "grade" | "session";
+export type WorkspaceEventEnvelope = {
+    offset: number;
+    createdAt: string;
+    type: WorkspaceEventDomain;
+    data: Record<string, unknown>;
+};
+export type BuildProjectionRun = {
+    id: string;
+    status: "idle" | "running" | "completed" | "error" | "canceled";
+    error?: string;
+    startedAt?: string;
+    finishedAt?: string;
+    messages: Array<{
+        role: string;
+        content: string;
+        messageRefId?: string;
+        feedback?: FeedbackEntry;
+        respondStatus?: number;
+        respondCode?: string;
+        respondMessage?: string;
+        respondPayload?: unknown;
+        respondMeta?: Record<string, unknown>;
+    }>;
+    traces?: Array<TraceEvent>;
+    toolInserts?: Array<{
+        actionCallId?: string;
+        parentActionCallId?: string;
+        name?: string;
+        index: number;
+    }>;
+};
+export type BuildProjectionState = {
+    workspaceId: string;
+    lastAppliedOffset: number;
+    run: BuildProjectionRun;
+    state?: SavedState;
+};
+type SessionStoreDeps = {
+    sessionsRoot: string;
+    ensureDir: (dir: string) => void;
+    randomId: (prefix: string) => string;
+    logger: {
+        warn: (...args: Array<unknown>) => void;
+    };
+    enrichStateWithSession: (state: SavedState) => {
+        state: SavedState;
+        dir?: string;
+    };
+    workspaceStateSchemaVersion: string;
+    workspaceSchemaError: (workspaceId: string, foundVersion: string | null) => string;
+};
+export declare const createSessionStore: (deps: SessionStoreDeps) => {
+    parseFiniteInteger: (value: unknown) => number | undefined;
+    selectCanonicalScenarioRunSummary: (meta: Record<string, unknown>) => ScenarioRunSummary | null;
+    appendWorkspaceEnvelope: (state: SavedState, eventType: WorkspaceEventDomain, data: Record<string, unknown>) => WorkspaceEventEnvelope | null;
+    appendSessionEvent: (state: SavedState, payload: Record<string, unknown>) => WorkspaceEventEnvelope | null;
+    appendFeedbackLog: (state: SavedState, payload: Record<string, unknown>) => WorkspaceEventEnvelope | null;
+    appendGradingLog: (state: SavedState, payload: Record<string, unknown>) => WorkspaceEventEnvelope | null;
+    appendErrorLog: (state: SavedState, payload: Record<string, unknown>) => WorkspaceEventEnvelope | null;
+    appendServerErrorLog: (workspaceId: string | undefined, payload: {
+        endpoint: string;
+        status: number;
+        message: string;
+        method?: string;
+    }) => void;
+    persistSessionState: (state: SavedState) => SavedState;
+    readSessionStateStrict: (sessionId: string, opts?: {
+        withTraces?: boolean;
+    }) => SavedState | undefined;
+    readSessionState: (sessionId: string, opts?: {
+        withTraces?: boolean;
+    }) => SavedState | undefined;
+    readBuildState: (workspaceId: string) => BuildProjectionState | undefined;
+    replayBuildProjection: (workspaceId: string, envelopes: Array<WorkspaceEventEnvelope>) => BuildProjectionState;
+};
+export {};
+//# sourceMappingURL=server_session_store.d.ts.map

package/script/src/server_session_store.d.ts.map

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