@sumeru/server 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 shazhou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/.build-fingerprint

@@ -0,0 +1 @@
+373997122015c31c248b73e9425555b23e813903bd21d21de38331e39e85fc1c

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import type { InstanceConfig } from "./types.js";
+/**
+ * Load and validate a `sumeru.yaml` file.
+ *
+ * Returns a fully-typed `InstanceConfig` on success. On any error — missing
+ * file, malformed YAML, missing required fields, wrong shapes — throws an
+ * `Error` whose message includes the offending field name (where applicable)
+ * and the source file path.
+ *
+ * Unknown keys at the top level and inside individual gateway entries are
+ * tolerated for forward-compatibility.
+ */
+export declare function loadConfig(path: string): Promise<InstanceConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGX,cAAc,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAItE"}

package/dist/config.js

@@ -0,0 +1,142 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+/**
+ * Load and validate a `sumeru.yaml` file.
+ *
+ * Returns a fully-typed `InstanceConfig` on success. On any error — missing
+ * file, malformed YAML, missing required fields, wrong shapes — throws an
+ * `Error` whose message includes the offending field name (where applicable)
+ * and the source file path.
+ *
+ * Unknown keys at the top level and inside individual gateway entries are
+ * tolerated for forward-compatibility.
+ */
+export async function loadConfig(path) {
+    const raw = await readFileSafely(path);
+    const doc = parseYamlSafely(raw, path);
+    return validateConfig(doc, path);
+}
+async function readFileSafely(path) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch (err) {
+        const code = err instanceof Error && "code" in err
+            ? err.code
+            : null;
+        if (code === "ENOENT") {
+            throw new Error(`Config file not found: ${path}`);
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Cannot read config file ${path}: ${msg}`);
+    }
+}
+function parseYamlSafely(raw, path) {
+    try {
+        return parseYaml(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid YAML in ${path}: ${msg}`);
+    }
+}
+function validateConfig(doc, path) {
+    if (doc === null || typeof doc !== "object" || Array.isArray(doc)) {
+        throw new Error(`Config ${path} must be a YAML mapping at the top level`);
+    }
+    const obj = doc;
+    const name = obj.name;
+    if (typeof name !== "string" || name.length === 0) {
+        throw new Error(`Config ${path} is missing required field "name" (must be a non-empty string)`);
+    }
+    const workspaceRoot = validateWorkspaceRoot(obj.workspaceRoot, path);
+    const gatewaysRaw = obj.gateways;
+    const gateways = {};
+    if (gatewaysRaw !== undefined && gatewaysRaw !== null) {
+        if (typeof gatewaysRaw !== "object" || Array.isArray(gatewaysRaw)) {
+            throw new Error(`Config ${path} field "gateways" must be a mapping (got ${describeShape(gatewaysRaw)})`);
+        }
+        for (const [key, entry] of Object.entries(gatewaysRaw)) {
+            gateways[key] = validateGatewayEntry(entry, key, path);
+        }
+    }
+    return { name, workspaceRoot, gateways };
+}
+/**
+ * Validate the optional top-level `workspaceRoot` field.
+ *
+ * Absent / undefined / null → `null`. Empty string → `null` (treated as
+ * "operator did not configure one"). Non-empty string → returned verbatim
+ * (no path resolution at this layer). Any other type → throws with the
+ * field name and source path.
+ */
+function validateWorkspaceRoot(raw, path) {
+    if (raw === undefined || raw === null)
+        return null;
+    if (typeof raw !== "string") {
+        throw new Error(`Config ${path} field "workspaceRoot" must be a string (got ${describeShape(raw)})`);
+    }
+    if (raw.length === 0)
+        return null;
+    return raw;
+}
+function validateGatewayEntry(entry, key, path) {
+    if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
+        throw new Error(`Config ${path} gateway "${key}" must be a mapping (got ${describeShape(entry)})`);
+    }
+    const obj = entry;
+    const adapter = obj.adapter;
+    if (typeof adapter !== "string" || adapter.length === 0) {
+        throw new Error(`Config ${path} gateway "${key}" is missing required field "adapter" (must be a non-empty string)`);
+    }
+    const capsRaw = obj.capabilities;
+    if (capsRaw === undefined || capsRaw === null) {
+        throw new Error(`Config ${path} gateway "${key}" is missing required field "capabilities"`);
+    }
+    const capabilities = validateCapabilities(capsRaw, key, path);
+    const config = validateGatewayConfigBlob(obj.config, key, path);
+    return { adapter, capabilities, config };
+}
+/**
+ * Validate the optional adapter-specific `config:` blob on a gateway entry.
+ *
+ * Absent / undefined → `null`. Explicit `null` → `null`. Mapping (object) →
+ * passed through verbatim with no key validation. Anything else (number,
+ * string, boolean, array) → throws with the path / gateway / field name and
+ * the actual shape.
+ *
+ * The contents of a mapping are NOT validated here — each adapter validates
+ * its own option keys at construction time. See
+ * `specs/config-load-gateway-config-blob.md`.
+ */
+function validateGatewayConfigBlob(raw, key, path) {
+    if (raw === undefined || raw === null)
+        return null;
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`Config ${path} gateway "${key}" field "config" must be a mapping (got ${describeShape(raw)})`);
+    }
+    return raw;
+}
+function validateCapabilities(raw, key, path) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        throw new Error(`Config ${path} gateway "${key}" field "capabilities" must be a mapping (got ${describeShape(raw)})`);
+    }
+    const obj = raw;
+    const resume = obj.resume;
+    if (typeof resume !== "boolean") {
+        throw new Error(`Config ${path} gateway "${key}" field "capabilities.resume" must be a boolean`);
+    }
+    const streaming = obj.streaming;
+    if (typeof streaming !== "boolean") {
+        throw new Error(`Config ${path} gateway "${key}" field "capabilities.streaming" must be a boolean`);
+    }
+    return { resume, streaming };
+}
+function describeShape(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/envelope.d.ts

@@ -0,0 +1,28 @@
+import type { Envelope, ErrorValue, Gateway, Instance, SearchResultValue, SessionListEntry, SessionWire } from "./types.js";
+/** Wrap a value in the ocas envelope shape. */
+export declare function envelope<T>(type: string, value: T): Envelope<T>;
+/** Build the `@sumeru/instance` envelope for `GET /`. */
+export declare function instanceEnvelope(instance: Instance): Envelope<Instance>;
+/** Build the `@sumeru/gateway-list` envelope for `GET /gateways`. */
+export declare function gatewayListEnvelope(gateways: Gateway[]): Envelope<Gateway[]>;
+/** Build the `@sumeru/gateway` envelope for `GET /gateways/:name`. */
+export declare function gatewayEnvelope(gateway: Gateway): Envelope<Gateway>;
+/**
+ * Build the `@sumeru/session` envelope for
+ * `POST /gateways/:name/sessions` (201) and
+ * `GET  /gateways/:name/sessions/:id` (200).
+ */
+export declare function sessionEnvelope(session: SessionWire): Envelope<SessionWire>;
+/**
+ * Build the `@sumeru/session-list` envelope for `GET /gateways/:name/sessions`.
+ * List entries omit `config` to keep listings compact.
+ */
+export declare function sessionListEnvelope(sessions: SessionListEntry[]): Envelope<SessionListEntry[]>;
+/** Build a `@sumeru/error` envelope for non-2xx responses. */
+export declare function errorEnvelope(error: string, message: string): Envelope<ErrorValue>;
+/**
+ * Build the `@sumeru/search-result` envelope for `GET /sessions?q=...` and
+ * `GET /gateways/:name/sessions?q=...`.
+ */
+export declare function searchResultEnvelope(value: SearchResultValue): Envelope<SearchResultValue>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,QAAQ,EACR,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE/D;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAEvE;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAE5E;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAE3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,gBAAgB,EAAE,GAC1B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAE9B;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACb,QAAQ,CAAC,UAAU,CAAC,CAEtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,iBAAiB,GACtB,QAAQ,CAAC,iBAAiB,CAAC,CAE7B"}

package/dist/envelope.js

@@ -0,0 +1,43 @@
+/** Wrap a value in the ocas envelope shape. */
+export function envelope(type, value) {
+    return { type, value };
+}
+/** Build the `@sumeru/instance` envelope for `GET /`. */
+export function instanceEnvelope(instance) {
+    return envelope("@sumeru/instance", instance);
+}
+/** Build the `@sumeru/gateway-list` envelope for `GET /gateways`. */
+export function gatewayListEnvelope(gateways) {
+    return envelope("@sumeru/gateway-list", gateways);
+}
+/** Build the `@sumeru/gateway` envelope for `GET /gateways/:name`. */
+export function gatewayEnvelope(gateway) {
+    return envelope("@sumeru/gateway", gateway);
+}
+/**
+ * Build the `@sumeru/session` envelope for
+ * `POST /gateways/:name/sessions` (201) and
+ * `GET  /gateways/:name/sessions/:id` (200).
+ */
+export function sessionEnvelope(session) {
+    return envelope("@sumeru/session", session);
+}
+/**
+ * Build the `@sumeru/session-list` envelope for `GET /gateways/:name/sessions`.
+ * List entries omit `config` to keep listings compact.
+ */
+export function sessionListEnvelope(sessions) {
+    return envelope("@sumeru/session-list", sessions);
+}
+/** Build a `@sumeru/error` envelope for non-2xx responses. */
+export function errorEnvelope(error, message) {
+    return envelope("@sumeru/error", { error, message });
+}
+/**
+ * Build the `@sumeru/search-result` envelope for `GET /sessions?q=...` and
+ * `GET /gateways/:name/sessions?q=...`.
+ */
+export function searchResultEnvelope(value) {
+    return envelope("@sumeru/search-result", value);
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAUA,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAI,IAAY,EAAE,KAAQ;IACjD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IAClD,OAAO,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,QAAmB;IACtD,OAAO,QAAQ,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC/C,OAAO,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IACnD,OAAO,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAA4B;IAE5B,OAAO,QAAQ,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAC5B,KAAa,EACb,OAAe;IAEf,OAAO,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CACnC,KAAwB;IAExB,OAAO,QAAQ,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/export/bundle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Phase 5 — session export.
+ *
+ * Builds a self-contained `tar.gz` from a session's recording (session-meta
+ * + every turn + their schema chain) using `@ocas/core.exportBundle`. The
+ * resulting bundle can be re-imported into another ocas store via
+ * `importBundle` to reproduce the recording bit-for-bit.
+ */
+import type { ServerResponse } from "node:http";
+import type { OcasConfig, Session } from "../types.js";
+/**
+ * Build a session export tar.gz on disk and return its path + node count.
+ *
+ * Caller is responsible for cleaning up the returned `tempDir`.
+ */
+export declare function buildSessionExport(session: Session, ocas: OcasConfig): Promise<{
+    tarGzPath: string;
+    tempDir: string;
+    nodes: number;
+}>;
+/**
+ * Stream a previously-built tar.gz to an HTTP response with the spec headers.
+ *
+ * The temp dir is removed after the response `finish` (or `close`) event so
+ * concurrent exports never leak.
+ */
+export declare function streamExportResponse(res: ServerResponse, sessionId: string, tarGzPath: string, tempDir: string, nodes: number, method: "POST" | "HEAD"): Promise<void>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/export/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/export/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,UAAU,GACd,OAAO,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC,CAaD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/export/bundle.js

@@ -0,0 +1,78 @@
+/**
+ * Phase 5 — session export.
+ *
+ * Builds a self-contained `tar.gz` from a session's recording (session-meta
+ * + every turn + their schema chain) using `@ocas/core.exportBundle`. The
+ * resulting bundle can be re-imported into another ocas store via
+ * `importBundle` to reproduce the recording bit-for-bit.
+ */
+import { createReadStream, mkdtempSync, statSync } from "node:fs";
+import { readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { gzipSync } from "node:zlib";
+import { exportBundle } from "@ocas/core";
+/**
+ * Build a session export tar.gz on disk and return its path + node count.
+ *
+ * Caller is responsible for cleaning up the returned `tempDir`.
+ */
+export async function buildSessionExport(session, ocas) {
+    const tempDir = mkdtempSync(join(tmpdir(), "sumeru-export-"));
+    const tarPath = join(tempDir, "bundle.tar");
+    const tarGzPath = `${tarPath}.gz`;
+    const roots = [session.metaHash, ...session.turnHashes];
+    const stats = await exportBundle(ocas.store, roots, tarPath);
+    const tarBytes = await readFile(tarPath);
+    const gzBytes = gzipSync(tarBytes, { level: 6 });
+    await writeFile(tarGzPath, gzBytes);
+    return { tarGzPath, tempDir, nodes: stats.nodes };
+}
+/**
+ * Stream a previously-built tar.gz to an HTTP response with the spec headers.
+ *
+ * The temp dir is removed after the response `finish` (or `close`) event so
+ * concurrent exports never leak.
+ */
+export async function streamExportResponse(res, sessionId, tarGzPath, tempDir, nodes, method) {
+    const size = statSync(tarGzPath).size;
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "application/gzip");
+    res.setHeader("Content-Disposition", `attachment; filename="${sessionId}.tar.gz"`);
+    res.setHeader("Cache-Control", "no-store");
+    res.setHeader("X-Sumeru-Export-Nodes", nodes.toString());
+    res.setHeader("X-Sumeru-Export-Session", sessionId);
+    res.setHeader("Content-Length", size.toString());
+    const cleanup = async () => {
+        try {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Best-effort.
+        }
+    };
+    res.once("close", () => {
+        void cleanup();
+    });
+    if (method === "HEAD") {
+        res.end();
+        await cleanup();
+        return;
+    }
+    await new Promise((resolve) => {
+        const stream = createReadStream(tarGzPath);
+        stream.on("error", () => {
+            res.end();
+            resolve();
+        });
+        res.on("finish", () => {
+            resolve();
+        });
+        res.on("close", () => {
+            resolve();
+        });
+        stream.pipe(res);
+    });
+    await cleanup();
+}
+//# sourceMappingURL=bundle.js.map

package/dist/export/bundle.js.map

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

package/dist/export/handler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Phase 5 — session export HTTP handler.
+ *
+ * Wired by `createHandler` for `POST /gateways/:name/sessions/:id/export`.
+ * The route returns a `tar.gz` of the session's recording (session-meta
+ * + every turn + the schema chain) built from the ocas store via
+ * `@ocas/core.exportBundle`.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { SessionStore } from "../session/index.js";
+import type { GatewayConfig, OcasConfig } from "../types.js";
+/**
+ * Handle `POST /gateways/:name/sessions/:id/export` (also `HEAD`).
+ */
+export declare function handleSessionExport(req: IncomingMessage, res: ServerResponse, method: string, path: string, parts: {
+    gatewayRaw: string;
+    idRaw: string;
+}, gateways: Record<string, GatewayConfig>, sessions: SessionStore, ocas: OcasConfig): Promise<void>;
+/** Path matcher for `/gateways/<name>/sessions/<id>/export` (with optional trailing slash). */
+export declare function matchSessionExport(path: string): {
+    gatewayRaw: string;
+    idRaw: string;
+} | null;
+//# sourceMappingURL=handler.d.ts.map

package/dist/export/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/export/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK7D;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,UAAU,GACd,OAAO,CAAC,IAAI,CAAC,CA6Ff;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa9C"}

package/dist/export/handler.js

@@ -0,0 +1,102 @@
+/**
+ * Phase 5 — session export HTTP handler.
+ *
+ * Wired by `createHandler` for `POST /gateways/:name/sessions/:id/export`.
+ * The route returns a `tar.gz` of the session's recording (session-meta
+ * + every turn + the schema chain) built from the ocas store via
+ * `@ocas/core.exportBundle`.
+ */
+import { errorEnvelope } from "../envelope.js";
+import { buildSessionExport, streamExportResponse } from "./bundle.js";
+const SOFT_NODE_CAP = 100_000;
+/**
+ * Handle `POST /gateways/:name/sessions/:id/export` (also `HEAD`).
+ */
+export async function handleSessionExport(req, res, method, path, parts, gateways, sessions, ocas) {
+    const gatewayName = decodePathSegment(parts.gatewayRaw);
+    if (gatewayName === null) {
+        writeJson(res, 404, errorEnvelope("gateway_not_found", `Gateway ${parts.gatewayRaw} not found`));
+        return;
+    }
+    if (gateways[gatewayName] === undefined) {
+        writeJson(res, 404, errorEnvelope("gateway_not_found", `Gateway ${gatewayName} not found`));
+        return;
+    }
+    const id = decodePathSegment(parts.idRaw);
+    if (id === null) {
+        writeJson(res, 404, errorEnvelope("session_not_found", `Session ${parts.idRaw} not found on gateway ${gatewayName}`));
+        return;
+    }
+    if (method !== "POST" && method !== "HEAD") {
+        res.setHeader("Allow", "POST");
+        writeJson(res, 405, errorEnvelope("method_not_allowed", `Method ${method} not allowed on ${path}`));
+        return;
+    }
+    const session = sessions.get(gatewayName, id);
+    if (session === null) {
+        writeJson(res, 404, errorEnvelope("session_not_found", `Session ${id} not found on gateway ${gatewayName}`));
+        return;
+    }
+    // Drain any incoming body so keep-alive works correctly. We read no fields.
+    await drainBody(req);
+    let exported;
+    try {
+        exported = await buildSessionExport(session, ocas);
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err.message : String(err);
+        writeJson(res, 500, errorEnvelope("export_failed", `Failed to build session export: ${truncate(cause, 500)}`));
+        return;
+    }
+    if (exported.nodes > SOFT_NODE_CAP) {
+        console.warn(`[sumeru] large export: ${session.id} nodes=${exported.nodes}`);
+    }
+    await streamExportResponse(res, session.id, exported.tarGzPath, exported.tempDir, exported.nodes, method === "HEAD" ? "HEAD" : "POST");
+}
+/** Path matcher for `/gateways/<name>/sessions/<id>/export` (with optional trailing slash). */
+export function matchSessionExport(path) {
+    const prefix = "/gateways/";
+    if (!path.startsWith(prefix))
+        return null;
+    const rest = path.slice(prefix.length);
+    const stripped = rest.endsWith("/") ? rest.slice(0, -1) : rest;
+    const parts = stripped.split("/");
+    if (parts.length !== 4)
+        return null;
+    const [gatewayRaw, sessionsLiteral, idRaw, exportLiteral] = parts;
+    if (gatewayRaw === undefined || sessionsLiteral !== "sessions")
+        return null;
+    if (idRaw === undefined || idRaw.length === 0)
+        return null;
+    if (exportLiteral !== "export")
+        return null;
+    if (gatewayRaw.length === 0)
+        return null;
+    return { gatewayRaw, idRaw };
+}
+function decodePathSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return null;
+    }
+}
+async function drainBody(req) {
+    for await (const _chunk of req) {
+        // discard
+    }
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max - 1)}…`;
+}
+function writeJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.statusCode = status;
+    res.setHeader("Content-Type", "application/json; charset=utf-8");
+    res.setHeader("Content-Length", Buffer.byteLength(payload).toString());
+    res.end(payload);
+}
+//# sourceMappingURL=handler.js.map

package/dist/export/handler.js.map

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

package/dist/export/index.d.ts

@@ -0,0 +1,3 @@
+export { buildSessionExport, streamExportResponse } from "./bundle.js";
+export { handleSessionExport, matchSessionExport } from "./handler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/export/index.js

@@ -0,0 +1,3 @@
+export { buildSessionExport, streamExportResponse } from "./bundle.js";
+export { handleSessionExport, matchSessionExport } from "./handler.js";
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerConfig } from "./types.js";
+/**
+ * Build the request handler for a server with the given config.
+ *
+ * Phase 1 routes:
+ *   GET    /                           → 200 @sumeru/instance envelope
+ *   GET    /gateways                   → 200 @sumeru/gateway-list envelope
+ *   GET    /gateways/:name             → 200 @sumeru/gateway envelope OR 404
+ *
+ * Phase 2 routes:
+ *   POST   /gateways/:name/sessions    → 201 @sumeru/session envelope OR 400/404
+ *   GET    /gateways/:name/sessions    → 200 @sumeru/session-list envelope OR 404
+ *   GET    /gateways/:name/sessions/:id    → 200 @sumeru/session OR 404
+ *   DELETE /gateways/:name/sessions/:id    → 204 No Content OR 404
+ *
+ * Phase 3 routes:
+ *   POST   /gateways/:name/sessions/:id/messages  → SSE (turn / heartbeat / done / error)
+ *
+ * All non-success bodies are `@sumeru/error` envelopes. Method mismatches
+ * return 405 with a populated `Allow` header.
+ */
+export declare function createHandler(config: ServerConfig): (req: IncomingMessage, res: ServerResponse) => void;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAyBjE,OAAO,KAAK,EAKX,YAAY,EAKZ,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,YAAY,GAClB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAqLrD"}