@sumeru/server 0.1.0

package/dist/search/types.js

@@ -0,0 +1,10 @@
+/**
+ * Phase 5 — search index types.
+ *
+ * These types are shared by the index module and the HTTP endpoints. The
+ * `SearchIndex` is a closure carrying the SQLite handle; consumers obtain
+ * one from `openSumeruOcas` via the new `searchIndex` slice on the result
+ * (mirrored on `OcasConfig`).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/session/cwd.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Resolve a per-session `config.cwd` against the instance `workspaceRoot`.
+ *
+ * Single source of truth for the cwd-resolution policy used by
+ * `POST /gateways/:name/sessions`. Both the HTTP handler and tests import
+ * this helper.
+ *
+ * Rules:
+ *
+ *   - `rawCwd` is `undefined` / `null`           → `{ ok: true, cwd: null }`
+ *   - `rawCwd` is the empty string               → `{ ok: true, cwd: null }`
+ *   - `rawCwd` is not a string (and not absent)  → `{ ok: false, … }`
+ *   - non-empty string AND workspaceRoot set     → `path.resolve(root, raw)`,
+ *                                                  rejected if it escapes root
+ *   - non-empty string AND workspaceRoot null    → must be absolute (verbatim);
+ *                                                  relative is rejected
+ *
+ * The resolved value is the absolute path the adapter should be told to use
+ * (replacing the user-supplied `cwd` in the opaque config blob). The wire
+ * envelope returned to the client is left untouched — only the adapter sees
+ * the resolved form.
+ */
+export type ResolveCwdResult = {
+    ok: true;
+    cwd: string | null;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function resolveSessionCwd(workspaceRoot: string | null, rawCwd: unknown): ResolveCwdResult;
+//# sourceMappingURL=cwd.d.ts.map

package/dist/session/cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd.d.ts","sourceRoot":"","sources":["../../src/session/cwd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,MAAM,gBAAgB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,OAAO,GACb,gBAAgB,CA+BlB"}

package/dist/session/cwd.js

@@ -0,0 +1,54 @@
+/**
+ * Resolve a per-session `config.cwd` against the instance `workspaceRoot`.
+ *
+ * Single source of truth for the cwd-resolution policy used by
+ * `POST /gateways/:name/sessions`. Both the HTTP handler and tests import
+ * this helper.
+ *
+ * Rules:
+ *
+ *   - `rawCwd` is `undefined` / `null`           → `{ ok: true, cwd: null }`
+ *   - `rawCwd` is the empty string               → `{ ok: true, cwd: null }`
+ *   - `rawCwd` is not a string (and not absent)  → `{ ok: false, … }`
+ *   - non-empty string AND workspaceRoot set     → `path.resolve(root, raw)`,
+ *                                                  rejected if it escapes root
+ *   - non-empty string AND workspaceRoot null    → must be absolute (verbatim);
+ *                                                  relative is rejected
+ *
+ * The resolved value is the absolute path the adapter should be told to use
+ * (replacing the user-supplied `cwd` in the opaque config blob). The wire
+ * envelope returned to the client is left untouched — only the adapter sees
+ * the resolved form.
+ */
+import { isAbsolute, resolve as pathResolve, sep } from "node:path";
+export function resolveSessionCwd(workspaceRoot, rawCwd) {
+    if (rawCwd === undefined || rawCwd === null) {
+        return { ok: true, cwd: null };
+    }
+    if (typeof rawCwd !== "string") {
+        return { ok: false, message: "config.cwd must be a string" };
+    }
+    if (rawCwd.length === 0) {
+        return { ok: true, cwd: null };
+    }
+    if (workspaceRoot !== null) {
+        const root = pathResolve(workspaceRoot);
+        const resolved = pathResolve(root, rawCwd);
+        if (resolved !== root && !resolved.startsWith(root + sep)) {
+            return {
+                ok: false,
+                message: `config.cwd '${rawCwd}' resolves outside workspaceRoot '${workspaceRoot}'`,
+            };
+        }
+        return { ok: true, cwd: resolved };
+    }
+    // No workspaceRoot configured — only absolute paths are accepted.
+    if (!isAbsolute(rawCwd)) {
+        return {
+            ok: false,
+            message: `config.cwd '${rawCwd}' must be absolute when no workspaceRoot is configured`,
+        };
+    }
+    return { ok: true, cwd: rawCwd };
+}
+//# sourceMappingURL=cwd.js.map

package/dist/session/cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd.js","sourceRoot":"","sources":["../../src/session/cwd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,WAAW,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAMpE,MAAM,UAAU,iBAAiB,CAChC,aAA4B,EAC5B,MAAe;IAEf,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YAC3D,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,eAAe,MAAM,qCAAqC,aAAa,GAAG;aACnF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO;YACN,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,eAAe,MAAM,wDAAwD;SACtF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/session/id.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a Sumeru session ID: `ses_` followed by a 26-character ULID
+ * (Crockford Base32, uppercase).
+ *
+ * - Total length: 30 (4 prefix + 26 body).
+ * - Body matches `^[0-9A-HJKMNP-TV-Z]{26}$`.
+ * - First 10 body characters encode milliseconds since the Unix epoch.
+ * - Subsequent calls within the same millisecond emit a strictly increasing
+ *   randomness component (monotonic ULID), guaranteeing distinct ids.
+ */
+export declare function generateSessionId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/session/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/session/id.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/session/id.js

@@ -0,0 +1,76 @@
+import { randomBytes } from "node:crypto";
+/**
+ * Crockford Base32 alphabet (excludes I, L, O, U).
+ * Used by ULID for both timestamp and randomness components.
+ */
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+/** Length of the timestamp portion of a ULID (in Crockford chars). */
+const TIME_LEN = 10;
+/** Length of the randomness portion of a ULID. */
+const RAND_LEN = 16;
+/** State for monotonic ULID generation when timestamps collide. */
+let lastTime = 0;
+let lastRandom = new Array(RAND_LEN).fill(0);
+/**
+ * Generate a Sumeru session ID: `ses_` followed by a 26-character ULID
+ * (Crockford Base32, uppercase).
+ *
+ * - Total length: 30 (4 prefix + 26 body).
+ * - Body matches `^[0-9A-HJKMNP-TV-Z]{26}$`.
+ * - First 10 body characters encode milliseconds since the Unix epoch.
+ * - Subsequent calls within the same millisecond emit a strictly increasing
+ *   randomness component (monotonic ULID), guaranteeing distinct ids.
+ */
+export function generateSessionId() {
+    return `ses_${generateUlid()}`;
+}
+function generateUlid() {
+    const now = Date.now();
+    const random = now === lastTime ? incrementRandom(lastRandom) : freshRandom();
+    lastTime = now;
+    lastRandom = random;
+    return `${encodeTime(now)}${encodeRandom(random)}`;
+}
+function encodeTime(ms) {
+    const out = new Array(TIME_LEN).fill("0");
+    let value = ms;
+    for (let i = TIME_LEN - 1; i >= 0; i -= 1) {
+        const mod = value % 32;
+        // Crockford alphabet has length 32, so mod is always in range.
+        out[i] = CROCKFORD.charAt(mod);
+        value = Math.floor(value / 32);
+    }
+    return out.join("");
+}
+function freshRandom() {
+    const buf = randomBytes(RAND_LEN);
+    const out = new Array(RAND_LEN).fill(0);
+    for (let i = 0; i < RAND_LEN; i += 1) {
+        // 0–31 (5-bit) values for Crockford Base32.
+        out[i] = (buf[i] ?? 0) & 0x1f;
+    }
+    return out;
+}
+function incrementRandom(prev) {
+    const out = prev.slice();
+    for (let i = RAND_LEN - 1; i >= 0; i -= 1) {
+        const v = out[i] ?? 0;
+        if (v < 31) {
+            out[i] = v + 1;
+            return out;
+        }
+        out[i] = 0;
+    }
+    // Overflow within a single millisecond is astronomically unlikely; fall back
+    // to a fresh random vector rather than failing the call.
+    return freshRandom();
+}
+function encodeRandom(values) {
+    const out = new Array(RAND_LEN).fill("0");
+    for (let i = 0; i < RAND_LEN; i += 1) {
+        const v = values[i] ?? 0;
+        out[i] = CROCKFORD.charAt(v);
+    }
+    return out.join("");
+}
+//# sourceMappingURL=id.js.map

package/dist/session/id.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,5 @@
+export { type ResolveCwdResult, resolveSessionCwd } from "./cwd.js";
+export { generateSessionId } from "./id.js";
+export type { SessionStore, TransitionResult } from "./store.js";
+export { createSessionStore } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,4 @@
+export { resolveSessionCwd } from "./cwd.js";
+export { generateSessionId } from "./id.js";
+export { createSessionStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/session/store.d.ts

@@ -0,0 +1,89 @@
+import type { Hash } from "@ocas/core";
+import type { NativeSessionRef } from "@sumeru/core";
+import type { OcasConfig, Session, SessionWire, UserSessionConfig } from "../types.js";
+/**
+ * In-memory session store.
+ *
+ * Phase 2: persistence is per-process and lost on restart. Adapter-level
+ * persistence lands in a later phase when the message endpoint is wired up.
+ *
+ * Phase 3: each session also tracks an internal `NativeSessionRef` produced
+ * by the adapter when the session was created. The `NativeSessionRef` is
+ * NEVER exposed in HTTP envelopes — only `getNativeRef` makes it visible
+ * to internal callers (the message handler, the close path).
+ *
+ * Phase 4: each session carries a `metaHash` (set on create) and a
+ * `turnHashes` array that grows as turns are recorded. Both are internal
+ * — they are NEVER serialized into HTTP envelopes; `toWire` strips them.
+ *
+ * Sessions are scoped to their gateway: lookups always include the gateway
+ * name, and a session created on `hermes` is invisible from `claude-code`.
+ *
+ * The store is a closure over a `Map<gateway, Map<id, Session>>`. Insertion
+ * order is preserved on the inner maps, which makes listings deterministic
+ * (chronological by createdAt ascending).
+ */
+export type SessionStore = {
+    /**
+     * Create a new session on `gateway`. The id is generated server-side.
+     * Writes the corresponding `@sumeru/session-meta` node to ocas BEFORE
+     * the in-memory session is registered. Throws if the meta-write fails.
+     *
+     * `resolvedCwd` is the absolute path produced by `resolveSessionCwd`
+     * (issue #27) — the value the server already forwarded to the adapter
+     * under `config.cwd`. `null` means no cwd hint was supplied. The opaque
+     * `config` blob is preserved verbatim and is NOT mutated here.
+     */
+    create: (gateway: string, adapter: string, config: UserSessionConfig, nativeRef: NativeSessionRef | null, resolvedCwd: string | null) => Session;
+    /** List sessions on a gateway in insertion order (chronological). */
+    list: (gateway: string) => Session[];
+    /** Look up a single session, scoped by gateway. */
+    get: (gateway: string, id: string) => Session | null;
+    /** Internal-only: retrieve the NativeSessionRef recorded at create time. */
+    getNativeRef: (gateway: string, id: string) => NativeSessionRef | null;
+    /**
+     * Append a turn hash to a session's turn list. Used by the message
+     * endpoint as turns are recorded in ocas. No-op if the session is gone.
+     */
+    appendTurnHash: (gateway: string, id: string, hash: Hash) => void;
+    /**
+     * Mark a session closed. Returns:
+     *   - `closed`         if the status flipped from idle/active to closed
+     *   - `already_closed` if it was already closed (idempotent no-op)
+     *   - `not_found`      if no such session exists on the gateway
+     */
+    close: (gateway: string, id: string) => "closed" | "already_closed" | "not_found";
+    /** Number of non-closed sessions on a gateway. */
+    activeCount: (gateway: string) => number;
+    /**
+     * Try to mark a session active (idle → active). Reserved for the future
+     * message endpoint; exposed now so the 409 contract is testable.
+     */
+    tryActivate: (gateway: string, id: string) => TransitionResult<"busy" | "closed" | "not_found">;
+    /**
+     * Mark a session idle (active → idle). Used at the end of a message
+     * exchange. Forward-compat for the message endpoint.
+     */
+    markIdle: (gateway: string, id: string) => TransitionResult<"not_active" | "not_found">;
+};
+export type TransitionResult<R extends string> = {
+    ok: true;
+    session: Session;
+} | {
+    ok: false;
+    reason: R;
+};
+/**
+ * Strip internal-only fields (`metaHash`, `turnHashes`) from a `Session` so
+ * the result matches the HTTP wire envelope.
+ */
+export declare function toWire(session: Session): SessionWire;
+/**
+ * Build a fresh, empty session store.
+ *
+ * The store needs `ocas` so it can write `@sumeru/session-meta` nodes on
+ * `create`. The hash is recorded on the in-memory session for later
+ * cross-reference by the `/ocas/:hash` endpoint.
+ */
+export declare function createSessionStore(ocas: OcasConfig): SessionStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/session/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EACX,UAAU,EACV,OAAO,EAEP,WAAW,EACX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,YAAY,GAAG;IAC1B;;;;;;;;;OASG;IACH,MAAM,EAAE,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,WAAW,EAAE,MAAM,GAAG,IAAI,KACtB,OAAO,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;IACrC,mDAAmD;IACnD,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IACrD,4EAA4E;IAC5E,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAAC;IACvE;;;OAGG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAClE;;;;;OAKG;IACH,KAAK,EAAE,CACN,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,KACN,QAAQ,GAAG,gBAAgB,GAAG,WAAW,CAAC;IAC/C,kDAAkD;IAClD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC;;;OAGG;IACH,WAAW,EAAE,CACZ,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,KACN,gBAAgB,CAAC,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;IACvD;;;OAGG;IACH,QAAQ,EAAE,CACT,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,KACN,gBAAgB,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAC1C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAE5B;;;GAGG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAQpD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAwPjE"}

package/dist/session/store.js

@@ -0,0 +1,258 @@
+import { recordPayload } from "../ocas/index.js";
+import { generateSessionId } from "./id.js";
+/**
+ * Strip internal-only fields (`metaHash`, `turnHashes`) from a `Session` so
+ * the result matches the HTTP wire envelope.
+ */
+export function toWire(session) {
+    return {
+        id: session.id,
+        gateway: session.gateway,
+        status: session.status,
+        createdAt: session.createdAt,
+        config: session.config,
+    };
+}
+/**
+ * Build a fresh, empty session store.
+ *
+ * The store needs `ocas` so it can write `@sumeru/session-meta` nodes on
+ * `create`. The hash is recorded on the in-memory session for later
+ * cross-reference by the `/ocas/:hash` endpoint.
+ */
+export function createSessionStore(ocas) {
+    const byGateway = new Map();
+    const nativeRefs = new Map();
+    function ensureGatewayMap(gateway) {
+        let inner = byGateway.get(gateway);
+        if (inner === undefined) {
+            inner = new Map();
+            byGateway.set(gateway, inner);
+        }
+        return inner;
+    }
+    function nowIso() {
+        return new Date().toISOString();
+    }
+    function refKey(gateway, id) {
+        return `${gateway}\u0000${id}`;
+    }
+    /**
+     * Phase 6 (Refs #399): rebuild `byGateway` from disk BEFORE serving any
+     * request, so a restarted process recovers previously-recorded sessions
+     * and their ordered turn-list pointers. Reads:
+     *   1. every `sumeru_session_index` row (ordered by `created_at ASC`), and
+     *   2. the per-session turn hashes in one bulk query.
+     * `config` is recovered from the immutable `@sumeru/session-meta` node at
+     * `metaHash`; a missing/unreadable meta node falls back to `config: {}`
+     * with a structured warning. `nativeRef` is intentionally NOT restored —
+     * a rehydrated session is read-complete but not resumable for new sends.
+     */
+    function rehydrate() {
+        let sessionCount = 0;
+        let turnCount = 0;
+        let rows;
+        let turnsBySession;
+        try {
+            rows = ocas.searchIndex.loadSessionRows();
+            turnsBySession = ocas.searchIndex.loadSessionTurnsBulk();
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err.message : String(err);
+            console.warn(`[sumeru] session rehydrate failed: ${cause}`);
+            return;
+        }
+        for (const row of rows) {
+            const inner = ensureGatewayMap(row.gateway);
+            const config = recoverConfig(row.sessionId, row.metaHash);
+            const turnHashes = turnsBySession.get(row.sessionId) ?? [];
+            const session = {
+                id: row.sessionId,
+                gateway: row.gateway,
+                status: row.status,
+                createdAt: row.createdAt,
+                config,
+                metaHash: row.metaHash ?? "",
+                turnHashes: [...turnHashes],
+            };
+            inner.set(session.id, session);
+            sessionCount += 1;
+            turnCount += turnHashes.length;
+        }
+        if (sessionCount > 0) {
+            console.log(`[sumeru] rehydrated ${sessionCount} sessions, ${turnCount} turns`);
+        }
+    }
+    /**
+     * Read a session's opaque `config` from its immutable `@sumeru/session-meta`
+     * node. Falls back to `{}` (with a warning) when `metaHash` is `null` or the
+     * node is missing/malformed — turn history is the priority, not config.
+     */
+    function recoverConfig(sessionId, metaHash) {
+        if (metaHash === null) {
+            console.warn(`[sumeru] session ${sessionId} has no meta_hash; config falls back to {}`);
+            return {};
+        }
+        const node = ocas.store.cas.get(metaHash);
+        if (node === null) {
+            console.warn(`[sumeru] session ${sessionId} meta node ${metaHash} missing; config falls back to {}`);
+            return {};
+        }
+        const payload = node.payload;
+        const config = payload.config;
+        if (config === undefined || config === null || typeof config !== "object") {
+            return {};
+        }
+        return config;
+    }
+    function create(gateway, adapter, config, nativeRef, resolvedCwd) {
+        const inner = ensureGatewayMap(gateway);
+        const id = generateSessionId();
+        const createdAt = nowIso();
+        // Record session-meta to ocas FIRST. If validation/IO fails, the
+        // in-memory session is never created — the caller propagates a 500.
+        const metaHash = recordPayload(ocas.store, ocas.sessionMetaSchemaHash, {
+            id,
+            gateway,
+            adapter,
+            createdAt,
+            config,
+            resolvedCwd,
+        });
+        // Phase 5: seed the search index. Failures here do NOT roll back the
+        // ocas write — the index can always be rebuilt from the meta node.
+        // Phase 6 (Refs #399): persist `metaHash` so a restart can re-read
+        // `config` from the immutable `@sumeru/session-meta` node.
+        try {
+            ocas.searchIndex.indexSessionMeta({
+                sessionId: id,
+                gateway,
+                adapter,
+                createdAt,
+                metaHash,
+            });
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err.message : String(err);
+            console.warn(`[sumeru] search index seed failed: ${cause}`);
+        }
+        const session = {
+            id,
+            gateway,
+            status: "idle",
+            createdAt,
+            config,
+            metaHash,
+            turnHashes: [],
+        };
+        inner.set(session.id, session);
+        if (nativeRef !== null) {
+            nativeRefs.set(refKey(gateway, session.id), nativeRef);
+        }
+        return session;
+    }
+    function list(gateway) {
+        const inner = byGateway.get(gateway);
+        if (inner === undefined)
+            return [];
+        return Array.from(inner.values());
+    }
+    function get(gateway, id) {
+        const inner = byGateway.get(gateway);
+        if (inner === undefined)
+            return null;
+        return inner.get(id) ?? null;
+    }
+    function getNativeRef(gateway, id) {
+        return nativeRefs.get(refKey(gateway, id)) ?? null;
+    }
+    function appendTurnHash(gateway, id, hash) {
+        const session = get(gateway, id);
+        if (session === null)
+            return;
+        // Phase 6 (Refs #399): persist the list pointer BEFORE mutating memory
+        // so disk never lags behind memory. `turn_index` is the 0-based append
+        // position (the array length before the push). The write is idempotent
+        // on (session_id, turn_index); a persistence failure propagates so the
+        // caller's existing error handling (sse/messages.ts) can react — we do
+        // NOT silently diverge memory from disk.
+        const turnIndex = session.turnHashes.length;
+        ocas.searchIndex.appendSessionTurn(session.id, turnIndex, hash);
+        session.turnHashes.push(hash);
+    }
+    function close(gateway, id) {
+        const session = get(gateway, id);
+        if (session === null)
+            return "not_found";
+        if (session.status === "closed")
+            return "already_closed";
+        session.status = "closed";
+        // Best-effort: mark the search-index row closed too. Failures are
+        // logged inside markSessionClosed; the in-memory flip is the source
+        // of truth on the wire.
+        ocas.searchIndex.markSessionClosed(id);
+        return "closed";
+    }
+    function activeCount(gateway) {
+        const inner = byGateway.get(gateway);
+        if (inner === undefined)
+            return 0;
+        let n = 0;
+        for (const s of inner.values()) {
+            if (s.status !== "closed")
+                n += 1;
+        }
+        return n;
+    }
+    function tryActivate(gateway, id) {
+        const session = get(gateway, id);
+        if (session === null)
+            return { ok: false, reason: "not_found" };
+        const next = transitionTo(session.status, "active");
+        if (next === "busy" || next === "closed") {
+            return { ok: false, reason: next };
+        }
+        session.status = "active";
+        return { ok: true, session };
+    }
+    function markIdle(gateway, id) {
+        const session = get(gateway, id);
+        if (session === null)
+            return { ok: false, reason: "not_found" };
+        if (session.status !== "active") {
+            return { ok: false, reason: "not_active" };
+        }
+        session.status = "idle";
+        return { ok: true, session };
+    }
+    // Phase 6 (Refs #399): recover persisted sessions + turn-list pointers from
+    // disk before the store serves any request.
+    rehydrate();
+    return {
+        create,
+        list,
+        get,
+        getNativeRef,
+        appendTurnHash,
+        close,
+        activeCount,
+        tryActivate,
+        markIdle,
+    };
+}
+/**
+ * Transition table for `tryActivate`-style edges. Returns the literal `"ok"`
+ * if the transition is allowed, or a string reason if it is not.
+ */
+function transitionTo(from, to) {
+    if (to === "active") {
+        if (from === "idle")
+            return "ok";
+        if (from === "active")
+            return "busy";
+        return "closed"; // from === "closed"
+    }
+    // Exhaustive: only "active" is a valid `to` here.
+    return "ok";
+}
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

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

package/dist/sse/buffer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Per-send in-memory ring buffer for SSE resume support.
+ *
+ * Each `POST /gateways/:name/sessions/:id/messages` call creates a fresh
+ * buffer keyed by `(gateway, sessionId, sendNonce)`. Events are appended in
+ * id order; the most-recent N events are retained (N = `sseBufferSize`,
+ * default 1024). After `event: done` the buffer is held for `retentionMs`
+ * (default 30_000) to allow late clients to resume.
+ *
+ * Resume is a pure replay — `adapter.send` is NOT called twice. The buffer
+ * is the canonical record of what the original send produced.
+ */
+export type SseEvent = {
+    id: number;
+    event: string;
+    /** Stringified data line — already JSON-serialized envelope. */
+    data: string;
+};
+export type SseBuffer = {
+    gateway: string;
+    sessionId: string;
+    nonce: string;
+    events: SseEvent[];
+    maxId: number;
+    doneAt: number | null;
+    maxSize: number;
+    /** Resolved when the underlying send is finished (success or failure). */
+    finished: boolean;
+};
+export type SseBufferStore = {
+    create: (gateway: string, sessionId: string) => SseBuffer;
+    getLatestForSession: (gateway: string, sessionId: string) => SseBuffer | null;
+    finish: (buf: SseBuffer) => void;
+    purgeExpired: (now: number) => void;
+    wasRecentlyExpired: (gateway: string, sessionId: string) => boolean;
+};
+export type SseBufferOptions = {
+    maxSize: number;
+    retentionMs: number;
+};
+export declare function createSseBufferStore(options: SseBufferOptions): SseBufferStore;
+/** Append an event to a buffer, maintaining `maxSize` ring semantics. */
+export declare function appendEvent(buf: SseBuffer, event: string, data: string): SseEvent;
+/** Wire-format an event: `id: ...\nevent: ...\ndata: ...\n\n`. */
+export declare function formatEvent(evt: SseEvent): string;
+/** Range-replay events whose id is strictly greater than `since`. */
+export declare function eventsAfter(buf: SseBuffer, since: number): SseEvent[];
+/**
+ * Lowest still-buffered event id, or 0 when empty. Useful when computing
+ * whether a Last-Event-ID predates the ring's current window.
+ */
+export declare function lowestId(buf: SseBuffer): number;
+//# sourceMappingURL=buffer.d.ts.map

package/dist/sse/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/sse/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1D,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC;IAC9E,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AASF,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,gBAAgB,GACvB,cAAc,CAiFhB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAC1B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,QAAQ,CASV;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAGrE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAG/C"}