@saihm/shm 0.0.0-stage → 0.38.0

package/dist/service/handlers.js

@@ -0,0 +1,173 @@
+import { deriveActionCue } from "../inject/action_cue.js";
+import { DEFAULT_ANSWER_CONFIG } from "../answer/answer_layer.js";
+import { LatencyRecorder, SERVICE_TIERS, evaluateServiceLevel, evaluateTierLevel } from "./service_level.js";
+export class ServiceError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "ServiceError";
+    }
+}
+export function renderInjectionText(r) {
+    if (r.injected.length === 0)
+        return "";
+    const lines = r.injected.map((m) => `[${m.cellId}] ${m.text.replace(/\s+/g, " ").trim()}`);
+    return lines.join("\n");
+}
+const nonEmpty = (s, what) => {
+    if (typeof s !== "string" || s.trim() === "")
+        throw new ServiceError(400, `missing ${what}`);
+    return s.trim();
+};
+const SPEC_DIMENSIONS = ["threads", "kinds", "namespaces", "cellIds"];
+export function parseScopeSpec(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        throw new ServiceError(400, "spec must be an object");
+    const o = raw;
+    for (const key of Object.keys(o)) {
+        if (key !== "name" && !SPEC_DIMENSIONS.includes(key)) {
+            throw new ServiceError(400, `spec: unknown key \`${key}\` — a dimension that is not read would leave the scope wider than written`);
+        }
+    }
+    if (o["name"] !== undefined && typeof o["name"] !== "string")
+        throw new ServiceError(400, "spec.name must be a string");
+    const out = {};
+    if (typeof o["name"] === "string")
+        out["name"] = o["name"];
+    for (const dim of SPEC_DIMENSIONS) {
+        const v = o[dim];
+        if (v === undefined)
+            continue;
+        if (!Array.isArray(v) || !v.every((x) => typeof x === "string" && x.trim() !== "")) {
+            throw new ServiceError(400, `spec.${dim} must be a list of non-empty strings`);
+        }
+        out[dim] = [...v];
+    }
+    if (!SPEC_DIMENSIONS.some((dim) => dim in out)) {
+        throw new ServiceError(400, "spec names no dimension (threads, kinds, namespaces, cellIds) — send no spec at all for an unscoped read");
+    }
+    return out;
+}
+export class ServiceHandlers {
+    resident;
+    opts;
+    latency;
+    constructor(resident, opts = {}) {
+        this.resident = resident;
+        this.opts = opts;
+        this.latency = new LatencyRecorder(opts.latencyCapacity ?? 512);
+        if (opts.tierLevels !== undefined) {
+            const unknown = Object.keys(opts.tierLevels).filter((t) => !SERVICE_TIERS.includes(t));
+            if (unknown.length > 0)
+                throw new Error(`ServiceHandlers: tierLevels names unknown tier ${unknown.map((t) => JSON.stringify(t)).join(", ")} (the tiers are ${SERVICE_TIERS.join(", ")})`);
+            if (opts.tierLatency === undefined)
+                throw new Error("ServiceHandlers: tierLevels declared without tierLatency — pass the recorder the sessions were opened with");
+        }
+    }
+    health() {
+        const base = this.resident.health();
+        const levels = this.opts.serviceLevels;
+        const tierLevels = this.opts.tierLevels;
+        const tierLatency = this.opts.tierLatency;
+        if (levels === undefined && tierLevels === undefined)
+            return base;
+        const routeVerdicts = levels === undefined
+            ? undefined
+            : Object.keys(levels)
+                .sort()
+                .map((route) => evaluateServiceLevel(route, levels[route], this.latency.stats(route)));
+        const tierVerdicts = tierLevels === undefined || tierLatency === undefined
+            ? undefined
+            : SERVICE_TIERS.filter((t) => tierLevels[t] !== undefined).map((t) => evaluateTierLevel(t, tierLevels[t], tierLatency.stats(t)));
+        return { ...base, ...(routeVerdicts !== undefined ? { serviceLevels: routeVerdicts } : {}), ...(tierVerdicts !== undefined ? { tierLevels: tierVerdicts } : {}) };
+    }
+    async timed(route, body) {
+        const t0 = performance.now();
+        try {
+            return await body();
+        }
+        finally {
+            this.latency.record(route, performance.now() - t0);
+        }
+    }
+    async recall(req) {
+        return this.timed("recall", () => this.recallBody(req));
+    }
+    async recallBody(req) {
+        const q = nonEmpty(req.q, "q");
+        const k = Number.isFinite(req.k) && req.k >= 1 ? Math.floor(req.k) : DEFAULT_ANSWER_CONFIG.topK;
+        return this.resident.use(async (session) => {
+            const t0 = Date.now();
+            const selOpts = { maxK: k, ...(req.asOfEpoch !== undefined ? { asOfEpoch: req.asOfEpoch } : {}) };
+            const rr = session.answerRetriever;
+            if (typeof rr.selectDetailed === "function") {
+                const hits = await rr.selectDetailed(q, selOpts);
+                return {
+                    q,
+                    k,
+                    ms: Date.now() - t0,
+                    detailed: true,
+                    hits: hits.map((h, i) => ({
+                        cellId: h.cellId,
+                        rank: i + 1,
+                        ...(h.derived === true ? { derived: true } : {}),
+                        ...(h.supersededBy !== undefined ? { supersededBy: h.supersededBy } : {}),
+                        ...(h.retiredBy !== undefined ? { retiredBy: h.retiredBy } : {}),
+                    })),
+                };
+            }
+            const ids = await rr.select(q, selOpts);
+            return { q, k, ms: Date.now() - t0, detailed: false, hits: ids.map((cellId, i) => ({ cellId, rank: i + 1 })) };
+        });
+    }
+    async inject(req) {
+        return this.timed("inject", async () => {
+            const task = nonEmpty(req.taskContext, "taskContext");
+            const budget = req.budget ?? this.opts.injectBudget;
+            return this.resident.use((session) => session.proactiveInjector(budget !== undefined ? { budget } : {}).assemble(task));
+        });
+    }
+    async preact(req) {
+        return this.timed("preact", async () => {
+            const cue = deriveActionCue(req);
+            if (cue === "")
+                return undefined;
+            const budget = this.opts.preactBudget;
+            const result = await this.resident.use((session) => session.proactiveInjector(budget !== undefined ? { budget } : {}).assemble(cue, undefined, undefined, this.opts.guidanceScope));
+            if (result.injected.length === 0)
+                return undefined;
+            return { cue, result, rendered: renderInjectionText(result) };
+        });
+    }
+    async threads(req = {}) {
+        return this.timed("threads", async () => {
+            const spec = req.spec === undefined ? undefined : parseScopeSpec(req.spec);
+            return this.resident.use(async (session) => {
+                const under = spec === undefined ? {} : { scope: session.scope(spec) };
+                const rows = [...session.threads(under).entries()]
+                    .sort((a, b) => a[0].localeCompare(b[0]))
+                    .map(([slug, members]) => ({ slug, members, status: session.thread(slug, under).status ?? null }));
+                return under.scope === undefined ? { threads: rows } : { threads: rows, scope: under.scope.name };
+            });
+        });
+    }
+    async thread(req) {
+        return this.timed("thread", async () => {
+            const slug = nonEmpty(req.slug, "slug");
+            const spec = req.spec === undefined ? undefined : parseScopeSpec(req.spec);
+            const nowEpoch = this.opts.nowEpoch !== undefined ? this.opts.nowEpoch() : Math.floor(Date.now() / 3_600_000);
+            return this.resident.use(async (session) => session.thread(slug, spec === undefined ? { nowEpoch } : { nowEpoch, scope: session.scope(spec) }));
+        });
+    }
+    async census(spec) {
+        return this.timed("census", async () => {
+            const checked = parseScopeSpec(spec);
+            return this.resident.use(async (session) => {
+                const scope = session.scope(checked);
+                return { scope: scope.name, ...session.census(scope) };
+            });
+        });
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/service/handlers.js.map

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

package/dist/service/http.d.ts

@@ -0,0 +1,27 @@
+import { type Server } from "node:http";
+import { type ServiceHandlers } from "./handlers.js";
+import { type HostHookReply } from "../host/reply.js";
+export interface HostHookHandler {
+    handle(payload: unknown): Promise<HostHookReply<string> | undefined>;
+}
+export interface HttpServiceOptions {
+    readonly host?: string;
+    readonly port?: number;
+    readonly maxBodyBytes?: number;
+    readonly allowedHosts?: readonly string[];
+    readonly socketPath?: string;
+    readonly hook?: HostHookHandler;
+}
+export interface HttpService {
+    readonly server: Server;
+    readonly host: string;
+    readonly port: number;
+    readonly socketPath?: string;
+    close(): Promise<void>;
+}
+export declare function isLoopbackHost(host: string): boolean;
+export declare function requestRefusal(headers: Readonly<Record<string, string | string[] | undefined>>, allowedHostHeaders: ReadonlySet<string> | undefined): "browser-origin" | "host" | undefined;
+export declare function loopbackHostHeaders(bindHost: string, port: number, extra?: readonly string[]): Set<string>;
+export declare function listenOnSocket(server: Server, path: string): Promise<void>;
+export declare function serveHttp(handlers: ServiceHandlers, opts?: HttpServiceOptions): Promise<HttpService>;
+//# sourceMappingURL=http.d.ts.map

package/dist/service/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/service/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAGjG,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI1E,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAgCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAID,wBAAgB,cAAc,CAC5B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,EAChE,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,GAClD,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAMvC;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAW9G;AAiCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4H9G"}

package/dist/service/http.js

@@ -0,0 +1,261 @@
+import { lstatSync, statSync, unlinkSync, chmodSync } from "node:fs";
+import { createServer } from "node:http";
+import { connect } from "node:net";
+import { dirname, isAbsolute } from "node:path";
+import { ServiceError } from "./handlers.js";
+import { serializeHostReply } from "../host/reply.js";
+import { socketPathProblem } from "../host/socket_path.js";
+import { buildInjectionContext } from "../answer/context.js";
+async function readJson(req, maxBytes) {
+    const chunks = [];
+    let size = 0;
+    for await (const c of req) {
+        size += c.length;
+        if (size > maxBytes)
+            throw new ServiceError(413, `body exceeds ${maxBytes} bytes`);
+        chunks.push(c);
+    }
+    const text = Buffer.concat(chunks).toString("utf8");
+    if (text.trim() === "")
+        return {};
+    try {
+        const v = JSON.parse(text);
+        return typeof v === "object" && v !== null ? v : {};
+    }
+    catch {
+        throw new ServiceError(400, "body is not JSON");
+    }
+}
+function json(res, status, body) {
+    res.writeHead(status, { "content-type": "application/json" });
+    res.end(JSON.stringify(body) + "\n");
+}
+function noContent(res) {
+    res.writeHead(204);
+    res.end();
+}
+const LOOPBACK_V4 = /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/;
+export function isLoopbackHost(host) {
+    const h = host.trim().toLowerCase();
+    return h === "localhost" || h === "::1" || h === "[::1]" || LOOPBACK_V4.test(h);
+}
+const BROWSER_HEADERS = ["origin", "sec-fetch-site", "sec-fetch-dest", "sec-fetch-user"];
+export function requestRefusal(headers, allowedHostHeaders) {
+    for (const h of BROWSER_HEADERS)
+        if (headers[h] !== undefined)
+            return "browser-origin";
+    if (allowedHostHeaders === undefined)
+        return undefined;
+    const host = headers["host"];
+    if (typeof host !== "string" || !allowedHostHeaders.has(host.trim().toLowerCase()))
+        return "host";
+    return undefined;
+}
+export function loopbackHostHeaders(bindHost, port, extra = []) {
+    const names = new Set(["127.0.0.1", "localhost", "[::1]"]);
+    const b = bindHost.trim().toLowerCase();
+    if (LOOPBACK_V4.test(b))
+        names.add(b);
+    const out = new Set();
+    for (const n of names) {
+        out.add(`${n}:${port}`);
+        if (port === 80)
+            out.add(n);
+    }
+    for (const e of extra)
+        out.add(e.trim().toLowerCase());
+    return out;
+}
+function socketDirProblem(path) {
+    if (!isAbsolute(path))
+        return "socketPath must be absolute";
+    let st;
+    try {
+        st = statSync(dirname(path));
+    }
+    catch {
+        return "socketPath directory does not exist";
+    }
+    if (!st.isDirectory())
+        return "socketPath directory is not a directory";
+    if ((st.mode & 0o077) !== 0)
+        return "socketPath directory must be closed to group and others (mode 0700 or tighter)";
+    if (typeof process.getuid === "function" && st.uid !== process.getuid())
+        return "socketPath directory must be owned by this user";
+    return undefined;
+}
+async function clearStaleSocket(path) {
+    let st;
+    try {
+        st = lstatSync(path);
+    }
+    catch {
+        return;
+    }
+    if (!st.isSocket())
+        throw new Error("socketPath exists and is not a socket");
+    const live = await new Promise((resolve) => {
+        const s = connect({ path });
+        s.once("connect", () => { s.destroy(); resolve(true); });
+        s.once("error", () => resolve(false));
+    });
+    if (live)
+        throw new Error("socketPath is in use by a running service");
+    unlinkSync(path);
+}
+export function listenOnSocket(server, path) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(path, () => {
+            server.off("error", reject);
+            let there = false;
+            try {
+                there = lstatSync(path).isSocket();
+            }
+            catch {
+            }
+            if (there)
+                return resolve();
+            server.close();
+            reject(new Error("serveHttp: the runtime reported listening and no socket exists at socketPath — it bound another name; look for a stray socket in the directories above"));
+        });
+    });
+}
+export async function serveHttp(handlers, opts = {}) {
+    const host = opts.host ?? "127.0.0.1";
+    const maxBody = Number.isFinite(opts.maxBodyBytes) && opts.maxBodyBytes > 0 ? opts.maxBodyBytes : 1_048_576;
+    const socketPath = opts.socketPath;
+    if (socketPath !== undefined) {
+        const problem = socketPathProblem(socketPath) ?? socketDirProblem(socketPath);
+        if (problem !== undefined)
+            throw new Error(`serveHttp: ${problem}`);
+        await clearStaleSocket(socketPath);
+    }
+    else if (!isLoopbackHost(host) && (opts.allowedHosts === undefined || opts.allowedHosts.length === 0)) {
+        throw new Error("serveHttp: a non-loopback host needs allowedHosts — the Host header check cannot be derived for it");
+    }
+    let allowed = "pending";
+    const server = createServer(async (req, res) => {
+        if (allowed === "pending" || requestRefusal(req.headers, allowed === "socket" ? undefined : allowed) !== undefined) {
+            res.writeHead(403, { "content-type": "application/json", connection: "close" });
+            res.end('{"error":"forbidden"}\n');
+            return;
+        }
+        try {
+            const url = new URL(req.url ?? "/", "http://localhost");
+            const method = req.method ?? "GET";
+            if (method === "GET" && url.pathname === "/health")
+                return json(res, 200, handlers.health());
+            if (method === "GET" && url.pathname === "/recall") {
+                const kRaw = url.searchParams.get("k");
+                const asOfRaw = url.searchParams.get("asOfEpoch");
+                return json(res, 200, await handlers.recall({
+                    q: url.searchParams.get("q") ?? "",
+                    ...(kRaw !== null ? { k: Number(kRaw) } : {}),
+                    ...(asOfRaw !== null ? { asOfEpoch: Number(asOfRaw) } : {}),
+                }));
+            }
+            if (method === "POST" && url.pathname === "/hook" && opts.hook !== undefined) {
+                let payload;
+                try {
+                    payload = await readJson(req, maxBody);
+                }
+                catch {
+                    return noContent(res);
+                }
+                let reply;
+                try {
+                    reply = await opts.hook.handle(payload);
+                }
+                catch {
+                    reply = undefined;
+                }
+                if (reply === undefined)
+                    return noContent(res);
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(serializeHostReply(reply));
+                return;
+            }
+            if (method === "POST" && url.pathname === "/inject") {
+                const body = await readJson(req, maxBody);
+                const r = await handlers.inject({ taskContext: String(body["taskContext"] ?? "") });
+                if (r.injected.length === 0)
+                    return noContent(res);
+                return json(res, 200, r);
+            }
+            if (method === "POST" && url.pathname === "/preact") {
+                const body = await readJson(req, maxBody);
+                const name = typeof body["name"] === "string" ? body["name"] : typeof body["tool_name"] === "string" ? body["tool_name"] : "";
+                const input = "input" in body ? body["input"] : body["tool_input"];
+                const r = await handlers.preact({ name, input });
+                if (r === undefined)
+                    return noContent(res);
+                const fenced = buildInjectionContext(r.result.injected
+                    .filter((m) => /^[^<>=\s]+$/.test(m.cellId))
+                    .map((m) => ({ cellId: m.cellId, plaintext: m.text, epoch: m.epoch, tier: m.tier, partial: m.partial })));
+                if (fenced.prompt === "")
+                    return noContent(res);
+                return json(res, 200, { ...r, hookSpecificOutput: { hookEventName: "PreToolUse", additionalContext: fenced.prompt } });
+            }
+            if (method === "GET" && url.pathname === "/threads")
+                return json(res, 200, await handlers.threads());
+            if (method === "GET" && url.pathname === "/thread")
+                return json(res, 200, await handlers.thread({ slug: url.searchParams.get("slug") ?? "" }));
+            if (method === "POST" && url.pathname === "/threads") {
+                const body = await readJson(req, maxBody);
+                return json(res, 200, await handlers.threads("spec" in body ? { spec: body["spec"] } : {}));
+            }
+            if (method === "POST" && url.pathname === "/thread") {
+                const body = await readJson(req, maxBody);
+                const slug = typeof body["slug"] === "string" ? body["slug"] : "";
+                return json(res, 200, await handlers.thread("spec" in body ? { slug, spec: body["spec"] } : { slug }));
+            }
+            if (method === "POST" && url.pathname === "/census") {
+                const body = await readJson(req, maxBody);
+                return json(res, 200, await handlers.census(body["spec"]));
+            }
+            json(res, 404, { error: "not found" });
+        }
+        catch (e) {
+            if (e instanceof ServiceError)
+                return json(res, e.status, { error: e.message });
+            json(res, 500, { error: e.message });
+        }
+    });
+    return new Promise((resolve, reject) => {
+        const onListening = () => {
+            let port = 0;
+            if (socketPath !== undefined) {
+                try {
+                    chmodSync(socketPath, 0o600);
+                }
+                catch {
+                }
+                allowed = "socket";
+            }
+            else {
+                const addr = server.address();
+                port = typeof addr === "object" && addr !== null ? addr.port : (opts.port ?? 0);
+                allowed = loopbackHostHeaders(host, port, opts.allowedHosts ?? []);
+            }
+            resolve({
+                server,
+                host: socketPath !== undefined ? "" : host,
+                port,
+                ...(socketPath !== undefined ? { socketPath } : {}),
+                close: () => new Promise((done, fail) => server.close((err) => (err ? fail(err) : done()))),
+            });
+        };
+        if (socketPath !== undefined) {
+            listenOnSocket(server, socketPath).then(onListening, reject);
+        }
+        else {
+            server.once("error", reject);
+            server.listen(opts.port ?? 0, host, () => {
+                server.off("error", reject);
+                onListening();
+            });
+        }
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/service/http.js.map

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

package/dist/service/index.d.ts

@@ -0,0 +1,5 @@
+export { ResidentSession, type ResidentConfig, type ResidentHealth } from "./resident.js";
+export { ServiceHandlers, ServiceError, renderInjectionText, parseScopeSpec, type ServiceOptions, type RecallRequest, type RecallHit, type RecallResponse, type PreactRequest, type PreactResponse, type ThreadsResponse, type ServiceHealth, } from "./handlers.js";
+export { LatencyRecorder, evaluateServiceLevel, evaluateTierLevel, percentile, DEFAULT_MIN_SAMPLES, SERVICE_TIERS, type ServiceLevel, type LatencyStats, type ServiceLevelVerdict, type TierLevelVerdict } from "./service_level.js";
+export { serveHttp, isLoopbackHost, requestRefusal, loopbackHostHeaders, type HttpServiceOptions, type HttpService, type HostHookHandler } from "./http.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrO,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/service/index.js

@@ -0,0 +1,5 @@
+export { ResidentSession } from "./resident.js";
+export { ServiceHandlers, ServiceError, renderInjectionText, parseScopeSpec, } from "./handlers.js";
+export { LatencyRecorder, evaluateServiceLevel, evaluateTierLevel, percentile, DEFAULT_MIN_SAMPLES, SERVICE_TIERS } from "./service_level.js";
+export { serveHttp, isLoopbackHost, requestRefusal, loopbackHostHeaders } from "./http.js";
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA4C,MAAM,eAAe,CAAC;AAC1F,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,GASf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAyF,MAAM,oBAAoB,CAAC;AACrO,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAmE,MAAM,WAAW,CAAC"}

package/dist/service/resident.d.ts

@@ -0,0 +1,50 @@
+import type { MemorySession } from "../session/memory_session.js";
+import type { WarmBuildStats } from "../store/warm_index.js";
+export interface ResidentConfig {
+    readonly open: () => Promise<MemorySession>;
+    readonly freshness?: () => string | number;
+    readonly build?: string;
+    readonly retire?: (old: MemorySession) => Promise<void>;
+    readonly clock?: () => number;
+}
+export interface ResidentHealth {
+    readonly ok: true;
+    readonly build: string;
+    readonly startedAt: string;
+    readonly rebuilds: number;
+    readonly lastBuiltAt?: string;
+    readonly freshness?: string | number;
+    readonly degraded: boolean;
+    readonly retiring: number;
+    readonly lastError?: string;
+    readonly inFlight: boolean;
+    readonly warm?: WarmBuildStats;
+}
+export declare class ResidentSession {
+    private readonly cfg;
+    private live;
+    private builtToken;
+    private failedToken;
+    private inflight;
+    private rebuilds;
+    private lastBuiltAt;
+    private lastError;
+    private retireErrors;
+    private readonly leases;
+    private readonly draining;
+    private readonly retirements;
+    private readonly clock;
+    private readonly startedAtMs;
+    constructor(cfg: ResidentConfig);
+    start(): Promise<void>;
+    current(): MemorySession;
+    ensureFresh(): Promise<MemorySession>;
+    use<T>(fn: (session: MemorySession) => Promise<T>): Promise<T>;
+    refresh(): Promise<MemorySession>;
+    health(): ResidentHealth;
+    get retireFailures(): number;
+    close(): Promise<void>;
+    private rebuild;
+    private retire;
+}
+//# sourceMappingURL=resident.d.ts.map

package/dist/service/resident.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resident.d.ts","sourceRoot":"","sources":["../../src/service/resident.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,qBAAa,eAAe;IAed,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdhC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAER,GAAG,EAAE,cAAc;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,IAAI,aAAa;IAKlB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAiBrC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqB9D,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAKvC,MAAM,IAAI,cAAc;IAiBxB,IAAI,cAAc,IAAI,MAAM,CAE3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,OAAO;YAsCD,MAAM;CAOrB"}