@relkit/inspector-api 0.0.0

package/dist/resource-explorer.d.ts.map

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

package/dist/resource-explorer.js

@@ -0,0 +1,119 @@
+import { InspectorEndpointError } from "./router-utils.js";
+import { identity, isRecord, safeJson } from "./shared.js";
+export async function bucketObjects(generation, bucketId, request) {
+    const explorer = generation.resources?.buckets;
+    if (explorer === undefined || !(await explorer.supports(bucketId)))
+        return unsupported(generation);
+    const query = queryFor(request);
+    const result = await explorer.list({ bucketId, ...query, signal: request.signal });
+    return safeJson({ ...identity(generation), supported: true, ...result });
+}
+export async function bucketPreview(generation, bucketId, request, maximumBytes) {
+    const explorer = generation.resources?.buckets;
+    if (explorer === undefined || !(await explorer.supports(bucketId)))
+        return unsupported(generation);
+    const params = new URL(request.url).searchParams;
+    const key = requiredText(params.get("key"), "key", 1_024);
+    const offset = integer(params.get("offset"), "offset", 0, Number.MAX_SAFE_INTEGER);
+    const limit = integer(params.get("limit"), "limit", maximumBytes, maximumBytes);
+    const result = await explorer.preview({ bucketId, key, offset, limit, signal: request.signal });
+    if (result === undefined)
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    const metadata = safeJson(result.metadata ?? {});
+    const contentType = mediaType(metadata);
+    const totalBytes = result.totalBytes ?? result.bytes.byteLength;
+    return {
+        ...identity(generation),
+        supported: true,
+        key,
+        metadata,
+        totalBytes,
+        truncated: offset + result.bytes.byteLength < totalBytes,
+        ...previewContent(result.bytes, contentType),
+    };
+}
+export async function cacheKeys(generation, cacheId, request) {
+    const explorer = generation.resources?.cache;
+    if (explorer === undefined || !(await explorer.supports(cacheId)))
+        return unsupported(generation);
+    const query = queryFor(request);
+    const result = await explorer.scan({ cacheId, ...query, signal: request.signal });
+    return safeJson({ ...identity(generation), supported: true, ...result });
+}
+export async function cacheValue(generation, cacheId, request, maximumBytes) {
+    const explorer = generation.resources?.cache;
+    if (explorer === undefined || !(await explorer.supports(cacheId)))
+        return unsupported(generation);
+    const params = new URL(request.url).searchParams;
+    const key = requiredText(params.get("key"), "key", 2_048);
+    const limit = integer(params.get("limit"), "limit", maximumBytes, maximumBytes);
+    const result = await explorer.value({ cacheId, key, limit, signal: request.signal });
+    if (result === undefined)
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    const projected = safeJson(result);
+    return {
+        ...identity(generation),
+        supported: true,
+        ...(isRecord(projected) ? projected : {}),
+        ...(isRecord(result) && "value" in result ? { value: safeJson(result.value) } : {}),
+    };
+}
+function queryFor(request) {
+    const params = new URL(request.url).searchParams;
+    const prefix = optionalText(params.get("prefix"), "prefix", 1_024);
+    const search = optionalText(params.get("search"), "search", 256);
+    const cursor = optionalText(params.get("cursor"), "cursor", 512);
+    const limit = integer(params.get("limit"), "limit", 50, 200);
+    return {
+        limit,
+        ...(prefix === undefined ? {} : { prefix }),
+        ...(search === undefined ? {} : { search }),
+        ...(cursor === undefined ? {} : { cursor }),
+    };
+}
+function previewContent(bytes, contentType) {
+    if (contentType === "text/html" || contentType === "image/svg+xml") {
+        return { kind: "metadata-only" };
+    }
+    if (contentType === "application/json" || contentType.startsWith("text/")) {
+        return {
+            kind: contentType === "application/json" ? "json" : "text",
+            content: new TextDecoder().decode(bytes),
+        };
+    }
+    if (contentType === "application/pdf" || /^image\/(png|jpeg|gif|webp)$/.test(contentType)) {
+        return {
+            kind: contentType === "application/pdf" ? "pdf" : "image",
+            content: Buffer.from(bytes).toString("base64"),
+        };
+    }
+    return { kind: "metadata-only" };
+}
+function mediaType(value) {
+    return typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        "contentType" in value &&
+        typeof value.contentType === "string"
+        ? value.contentType.split(";", 1)[0].toLowerCase()
+        : "application/octet-stream";
+}
+function unsupported(generation) {
+    return { ...identity(generation), supported: false, reason: "unsupported", items: [] };
+}
+function optionalText(value, name, max) {
+    return value === null || value === "" ? undefined : requiredText(value, name, max);
+}
+function requiredText(value, name, max) {
+    if (value === null || value === "" || value.length > max)
+        throw new InspectorEndpointError(`RELKIT_INSPECTOR_${name.toUpperCase()}_INVALID`, 400);
+    return value;
+}
+function integer(value, name, fallback, max) {
+    if (value === null)
+        return fallback;
+    if (!/^\d+$/.test(value) || Number(value) > max)
+        throw new InspectorEndpointError(`RELKIT_INSPECTOR_${name.toUpperCase()}_INVALID`, 400);
+    return Number(value);
+}
+//# sourceMappingURL=resource-explorer.js.map

package/dist/resource-explorer.js.map

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

package/dist/resource-routes.d.ts

@@ -0,0 +1,6 @@
+import type { Context, Hono } from "hono";
+import type { ResolvedActiveGeneration } from "./shared.js";
+type Guard = (handler: (context: Context, generation?: ResolvedActiveGeneration) => Promise<Response>, includeGeneration?: boolean) => (context: Context) => Promise<Response>;
+export declare function installResourceExplorerEndpoints(app: Hono, guard: Guard, maxPreviewBytes: number): void;
+export {};
+//# sourceMappingURL=resource-routes.d.ts.map

package/dist/resource-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-routes.d.ts","sourceRoot":"","sources":["../src/resource-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,KAAK,KAAK,GAAG,CACX,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC,QAAQ,CAAC,EACvF,iBAAiB,CAAC,EAAE,OAAO,KACxB,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7C,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,MAAM,GACtB,IAAI,CAmDN"}

package/dist/resource-routes.js

@@ -0,0 +1,10 @@
+import { API_BASE_PATH } from "@relkit/contracts";
+import { bucketObjects, bucketPreview, cacheKeys, cacheValue } from "./resource-explorer.js";
+import { json, required, requiredParam } from "./router-utils.js";
+export function installResourceExplorerEndpoints(app, guard, maxPreviewBytes) {
+    app.get(`${API_BASE_PATH}/runtime/buckets/:id/objects`, guard(async (context, generation) => json(await bucketObjects(await required(generation), requiredParam(context, "id"), context.req.raw))));
+    app.get(`${API_BASE_PATH}/runtime/buckets/:id/objects/preview`, guard(async (context, generation) => json(await bucketPreview(await required(generation), requiredParam(context, "id"), context.req.raw, maxPreviewBytes), 200, { "content-disposition": "inline", "content-security-policy": "sandbox" })));
+    app.get(`${API_BASE_PATH}/runtime/cache/:id/keys`, guard(async (context, generation) => json(await cacheKeys(await required(generation), requiredParam(context, "id"), context.req.raw))));
+    app.get(`${API_BASE_PATH}/runtime/cache/:id/keys/value`, guard(async (context, generation) => json(await cacheValue(await required(generation), requiredParam(context, "id"), context.req.raw, maxPreviewBytes), 200, { "content-disposition": "inline", "content-security-policy": "sandbox" })));
+}
+//# sourceMappingURL=resource-routes.js.map

package/dist/resource-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-routes.js","sourceRoot":"","sources":["../src/resource-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQlE,MAAM,UAAU,gCAAgC,CAC9C,GAAS,EACT,KAAY,EACZ,eAAuB;IAEvB,GAAG,CAAC,GAAG,CACL,GAAG,aAAa,8BAA8B,EAC9C,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAClC,IAAI,CACF,MAAM,aAAa,CACjB,MAAM,QAAQ,CAAC,UAAU,CAAC,EAC1B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAChB,CACF,CACF,CACF,CAAC;IACF,GAAG,CAAC,GAAG,CACL,GAAG,aAAa,sCAAsC,EACtD,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAClC,IAAI,CACF,MAAM,aAAa,CACjB,MAAM,QAAQ,CAAC,UAAU,CAAC,EAC1B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EACf,eAAe,CAChB,EACD,GAAG,EACH,EAAE,qBAAqB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,SAAS,EAAE,CAC1E,CACF,CACF,CAAC;IACF,GAAG,CAAC,GAAG,CACL,GAAG,aAAa,yBAAyB,EACzC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAClC,IAAI,CACF,MAAM,SAAS,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAC3F,CACF,CACF,CAAC;IACF,GAAG,CAAC,GAAG,CACL,GAAG,aAAa,+BAA+B,EAC/C,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAClC,IAAI,CACF,MAAM,UAAU,CACd,MAAM,QAAQ,CAAC,UAAU,CAAC,EAC1B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EACf,eAAe,CAChB,EACD,GAAG,EACH,EAAE,qBAAqB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,SAAS,EAAE,CAC1E,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/router-utils.d.ts

@@ -0,0 +1,26 @@
+import type { Hono } from "hono";
+import { type InspectorMode, type ResolvedActiveGeneration } from "./shared.js";
+import type { InspectorApiOptions } from "./router.js";
+export declare class InspectorEndpointConfigurationError extends TypeError {
+    constructor(message: string);
+}
+export declare class InspectorEndpointError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, status: number);
+}
+export declare function validateConfiguration(mode: InspectorMode, enabled: boolean, options: InspectorApiOptions): void;
+export declare function authorized(request: Request, options: InspectorApiOptions): Promise<boolean>;
+export declare function negotiate(request: Request): void;
+export declare function negotiateHeaders(request: Request): void;
+export declare function withGeneration<T>(generation: ResolvedActiveGeneration | undefined, handler: (generation: ResolvedActiveGeneration) => Promise<T>): Promise<T>;
+export declare function required(generation: ResolvedActiveGeneration | undefined): ResolvedActiveGeneration;
+export declare function requiredParam(context: {
+    req: {
+        param(name: string): string | undefined;
+    };
+}, name: string): string;
+export declare function installObservability(app: Hono, options: InspectorApiOptions, mode: InspectorMode): void;
+export declare function json(value: unknown, status?: number, headers?: Record<string, string>): Response;
+export declare function errorResponse(error: unknown): Response;
+//# sourceMappingURL=router-utils.d.ts.map

package/dist/router-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-utils.d.ts","sourceRoot":"","sources":["../src/router-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,mCAAoC,SAAQ,SAAS;gBACpD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAE7C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAK1B;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CAsBN;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAajG;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWvD;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,UAAU,EAAE,wBAAwB,GAAG,SAAS,EAChD,OAAO,EAAE,CAAC,UAAU,EAAE,wBAAwB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5D,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,wBAAwB,GAAG,SAAS,GAC/C,wBAAwB,CAI1B;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IAAE,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,EAC7D,IAAI,EAAE,MAAM,GACX,MAAM,CAKR;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,aAAa,GAClB,IAAI,CAeN;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,QAAQ,CAejG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAOtD"}

package/dist/router-utils.js

@@ -0,0 +1,129 @@
+import { API_VERSION, canonicalJson } from "@relkit/contracts";
+import { installObservabilityEndpoints, INSPECTOR_API_PROTOCOL } from "./observability.js";
+import { InspectorGraphError } from "./graph.js";
+import { InspectorRuntimeError } from "./runtime.js";
+import { InspectorQueryError, } from "./shared.js";
+export class InspectorEndpointConfigurationError extends TypeError {
+    constructor(message) {
+        super(message);
+        this.name = "InspectorEndpointConfigurationError";
+    }
+}
+export class InspectorEndpointError extends Error {
+    code;
+    status;
+    constructor(code, status) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.name = "InspectorEndpointError";
+    }
+}
+export function validateConfiguration(mode, enabled, options) {
+    if (!(mode === "development" || mode === "test" || mode === "production"))
+        throw new InspectorEndpointConfigurationError("mode is invalid");
+    if (mode === "production" &&
+        enabled &&
+        options.bearerToken === undefined &&
+        options.authorize === undefined)
+        throw new InspectorEndpointConfigurationError("Production inspector endpoints require bearerToken or authorize protection.");
+    if (options.bearerToken !== undefined && options.bearerToken.trim().length === 0)
+        throw new InspectorEndpointConfigurationError("bearerToken must not be empty");
+    if ((options.query === undefined) !== (options.stream === undefined))
+        throw new InspectorEndpointConfigurationError("query and stream must be configured together");
+    if (options.maxPreviewBytes !== undefined &&
+        (!Number.isSafeInteger(options.maxPreviewBytes) || options.maxPreviewBytes < 1)) {
+        throw new InspectorEndpointConfigurationError("maxPreviewBytes must be a positive integer");
+    }
+}
+export async function authorized(request, options) {
+    if (options.authorize !== undefined) {
+        try {
+            if (await options.authorize(request))
+                return true;
+        }
+        catch {
+            return false;
+        }
+        if (options.bearerToken === undefined)
+            return false;
+    }
+    return (options.bearerToken === undefined ||
+        request.headers.get("authorization") === `Bearer ${options.bearerToken}`);
+}
+export function negotiate(request) {
+    const url = new URL(request.url);
+    negotiateHeaders(request);
+    const requested = [url.searchParams.get("version")].filter((value) => value !== null);
+    if (requested.some((value) => !/^\d+$/.test(value) || Number(value) !== API_VERSION))
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_API_VERSION_UNSUPPORTED", 400);
+    const protocol = url.searchParams.get("protocol") ?? request.headers.get("x-relkit-api-protocol");
+    if (protocol !== null && protocol !== INSPECTOR_API_PROTOCOL)
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_PROTOCOL_UNSUPPORTED", 400);
+}
+export function negotiateHeaders(request) {
+    const requested = [request.headers.get("x-relkit-api-version")].filter((value) => value !== null);
+    const accepted = request.headers.get("accept")?.match(/(?:^|[;,\s])version=(\d+)/)?.[1];
+    if (accepted !== undefined)
+        requested.push(accepted);
+    if (requested.some((value) => !/^\d+$/.test(value) || Number(value) !== API_VERSION))
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_API_VERSION_UNSUPPORTED", 400);
+    const protocol = request.headers.get("x-relkit-api-protocol");
+    if (protocol !== null && protocol !== INSPECTOR_API_PROTOCOL)
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_PROTOCOL_UNSUPPORTED", 400);
+}
+export async function withGeneration(generation, handler) {
+    return handler(required(generation));
+}
+export function required(generation) {
+    if (generation === undefined)
+        throw new InspectorGraphError("RELKIT_INSPECTOR_GRAPH_UNAVAILABLE", 503);
+    return generation;
+}
+export function requiredParam(context, name) {
+    const value = context.req.param(name);
+    if (value === undefined || value.length === 0)
+        throw new InspectorEndpointError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    return value;
+}
+export function installObservability(app, options, mode) {
+    const configured = options.observability ??
+        (options.query && options.stream
+            ? { query: options.query, stream: options.stream }
+            : undefined);
+    if (configured === undefined)
+        return;
+    installObservabilityEndpoints(app, {
+        query: configured.query,
+        stream: configured.stream,
+        mode,
+        enabled: true,
+        ...(options.bearerToken === undefined ? {} : { bearerToken: options.bearerToken }),
+        ...(options.authorize === undefined ? {} : { authorize: options.authorize }),
+    });
+}
+export function json(value, status = 200, headers = {}) {
+    const payload = value === null || typeof value !== "object" || Array.isArray(value)
+        ? { protocol: INSPECTOR_API_PROTOCOL, version: API_VERSION, data: value }
+        : { protocol: INSPECTOR_API_PROTOCOL, version: API_VERSION, ...value };
+    return new Response(canonicalJson(payload), {
+        status,
+        headers: {
+            "cache-control": "no-store",
+            "content-type": "application/json; charset=utf-8",
+            "x-content-type-options": "nosniff",
+            "x-relkit-api-version": String(API_VERSION),
+            ...headers,
+        },
+    });
+}
+export function errorResponse(error) {
+    if (error instanceof InspectorEndpointError)
+        return json({ error: error.code }, error.status);
+    if (error instanceof InspectorGraphError || error instanceof InspectorRuntimeError)
+        return json({ error: error.code }, error.status);
+    if (error instanceof InspectorQueryError)
+        return json({ error: "RELKIT_INSPECTOR_QUERY_INVALID" }, 400);
+    return json({ error: "RELKIT_INSPECTOR_INTERNAL" }, 500);
+}
+//# sourceMappingURL=router-utils.js.map

package/dist/router-utils.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,23 @@
+import { type MaybePromise } from "@relkit/contracts";
+import type { ObservabilityQuery, ObservabilityStream } from "@relkit/observability";
+import { type ActiveGenerationOptions, type InspectorMode } from "./shared.js";
+import type { Hono } from "hono";
+export declare const INSPECTOR_API_PATHS: readonly ["/_relkit/v1", "/_relkit/v1/health/live", "/_relkit/v1/health/ready", "/_relkit/v1/graph", "/_relkit/v1/graph/descriptors", "/_relkit/v1/graph/descriptors/:id", "/_relkit/v1/source/:id", "/_relkit/v1/graph/source/:id", "/_relkit/v1/env", "/_relkit/v1/diagnostics", "/_relkit/v1/runtime", ...string[], "/_relkit/v1/runtime/buckets/:id/objects", "/_relkit/v1/runtime/buckets/:id/objects/preview", "/_relkit/v1/runtime/cache/:id/keys", "/_relkit/v1/runtime/cache/:id/keys/value", "/_relkit/v1/requests", "/_relkit/v1/requests/:requestId", "/_relkit/v1/logs", "/_relkit/v1/traces", "/_relkit/v1/traces/:traceId", "/_relkit/v1/stream", "/_relkit/v1/actions/functions/:id/invoke", "/_relkit/v1/actions/jobs/:id/retry", "/_relkit/v1/actions/jobs/:id/cancel", "/_relkit/v1/actions/events/:id/retry", "/_relkit/v1/actions/events/:id/cancel", "/_relkit/v1/actions/tools/:id/approval", "/_relkit/v1/actions/tools/:id/approve", "/_relkit/v1/actions/tools/:id/deny"];
+export declare const INSPECTOR_ENDPOINT_PATHS: readonly ["/_relkit/v1", "/_relkit/v1/health/live", "/_relkit/v1/health/ready", "/_relkit/v1/graph", "/_relkit/v1/graph/descriptors", "/_relkit/v1/graph/descriptors/:id", "/_relkit/v1/source/:id", "/_relkit/v1/graph/source/:id", "/_relkit/v1/env", "/_relkit/v1/diagnostics", "/_relkit/v1/runtime", ...string[], "/_relkit/v1/runtime/buckets/:id/objects", "/_relkit/v1/runtime/buckets/:id/objects/preview", "/_relkit/v1/runtime/cache/:id/keys", "/_relkit/v1/runtime/cache/:id/keys/value", "/_relkit/v1/requests", "/_relkit/v1/requests/:requestId", "/_relkit/v1/logs", "/_relkit/v1/traces", "/_relkit/v1/traces/:traceId", "/_relkit/v1/stream", "/_relkit/v1/actions/functions/:id/invoke", "/_relkit/v1/actions/jobs/:id/retry", "/_relkit/v1/actions/jobs/:id/cancel", "/_relkit/v1/actions/events/:id/retry", "/_relkit/v1/actions/events/:id/cancel", "/_relkit/v1/actions/tools/:id/approval", "/_relkit/v1/actions/tools/:id/approve", "/_relkit/v1/actions/tools/:id/deny"];
+export interface InspectorApiOptions extends ActiveGenerationOptions {
+    readonly mode?: InspectorMode;
+    readonly environment?: InspectorMode;
+    readonly enabled?: boolean;
+    readonly bearerToken?: string;
+    readonly authorize?: (request: Request) => MaybePromise<boolean>;
+    readonly query?: ObservabilityQuery;
+    readonly stream?: ObservabilityStream;
+    readonly observability?: {
+        readonly query: ObservabilityQuery;
+        readonly stream: ObservabilityStream;
+    };
+    readonly maxPreviewBytes?: number;
+}
+export { InspectorEndpointConfigurationError } from "./router-utils.js";
+export declare function installInspectorEndpoints(app: Hono, options?: InspectorApiOptions): void;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAkBrF,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,eAAO,MAAM,mBAAmB,q8BA2BrB,CAAC;AACZ,eAAO,MAAM,wBAAwB,q8BAAsB,CAAC;AAC5D,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;QACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AACD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAC;AACxE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CA+H5F"}

package/dist/router.js

@@ -0,0 +1,94 @@
+import { API_BASE_PATH } from "@relkit/contracts";
+import { graphDetail, graphList, graphSnapshot, sourceDetail, GRAPH_COLLECTIONS } from "./graph.js";
+import { environmentMetadata } from "./environment.js";
+import { diagnostics } from "./diagnostics.js";
+import { runtimeDetail, runtimeList, runtimeSnapshot, RUNTIME_COLLECTIONS } from "./runtime.js";
+import { INSPECTOR_ACTION_PATHS, installInspectorActionEndpoints } from "./actions.js";
+import { OBSERVABILITY_ENDPOINT_PATHS } from "./observability.js";
+import { authorized, errorResponse, installObservability, json, negotiate, required, requiredParam, withGeneration, validateConfiguration, } from "./router-utils.js";
+import { identity, } from "./shared.js";
+import { resolveActiveGeneration } from "./generation.js";
+import { installResourceExplorerEndpoints } from "./resource-routes.js";
+export const INSPECTOR_API_PATHS = Object.freeze([
+    API_BASE_PATH,
+    `${API_BASE_PATH}/health/live`,
+    `${API_BASE_PATH}/health/ready`,
+    `${API_BASE_PATH}/graph`,
+    `${API_BASE_PATH}/graph/descriptors`,
+    `${API_BASE_PATH}/graph/descriptors/:id`,
+    `${API_BASE_PATH}/source/:id`,
+    `${API_BASE_PATH}/graph/source/:id`,
+    `${API_BASE_PATH}/env`,
+    `${API_BASE_PATH}/diagnostics`,
+    `${API_BASE_PATH}/runtime`,
+    ...GRAPH_COLLECTIONS.flatMap((collection) => [
+        `${API_BASE_PATH}/${collection}`,
+        `${API_BASE_PATH}/${collection}/:id`,
+    ]),
+    `${API_BASE_PATH}/runtime/state`,
+    ...RUNTIME_COLLECTIONS.flatMap((collection) => [
+        `${API_BASE_PATH}/runtime/${collection}`,
+        `${API_BASE_PATH}/runtime/${collection}/:id`,
+    ]),
+    `${API_BASE_PATH}/runtime/buckets/:id/objects`,
+    `${API_BASE_PATH}/runtime/buckets/:id/objects/preview`,
+    `${API_BASE_PATH}/runtime/cache/:id/keys`,
+    `${API_BASE_PATH}/runtime/cache/:id/keys/value`,
+    ...OBSERVABILITY_ENDPOINT_PATHS,
+    ...INSPECTOR_ACTION_PATHS,
+]);
+export const INSPECTOR_ENDPOINT_PATHS = INSPECTOR_API_PATHS;
+export { InspectorEndpointConfigurationError } from "./router-utils.js";
+export function installInspectorEndpoints(app, options = {}) {
+    const mode = options.environment ?? options.mode ?? "development";
+    const enabled = options.enabled ?? mode !== "production";
+    validateConfiguration(mode, enabled, options);
+    if (!enabled)
+        return;
+    const guard = (handler, includeGeneration = true) => async (context) => {
+        if (!(await authorized(context.req.raw, options)))
+            return json({ error: "RELKIT_INSPECTOR_UNAUTHORIZED" }, 401, {
+                "www-authenticate": "Bearer",
+            });
+        try {
+            negotiate(context.req.raw);
+            return await handler(context, includeGeneration ? await resolveActiveGeneration(options) : undefined);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    };
+    app.get(API_BASE_PATH, guard(async () => json({ capabilities: INSPECTOR_API_PATHS }), false));
+    app.get(`${API_BASE_PATH}/health/live`, guard(async () => json({ status: "ok" }), false));
+    app.get(`${API_BASE_PATH}/health/ready`, guard(async (_context, generation) => {
+        if (generation === undefined)
+            return json({ status: "not-ready", reason: "no-active-generation" }, 503);
+        return json({ ...identity(generation), status: "ready" });
+    }));
+    app.get(`${API_BASE_PATH}/graph`, guard(async (_context, generation) => json(await withGeneration(generation, graphSnapshot))));
+    app.get(`${API_BASE_PATH}/graph/descriptors`, guard(async (context, generation) => json(await graphList(await required(generation), "descriptors", context.req.raw))));
+    app.get(`${API_BASE_PATH}/graph/descriptors/:id`, guard(async (context, generation) => json(graphDetail(await required(generation), "descriptors", requiredParam(context, "id")))));
+    app.get(`${API_BASE_PATH}/env`, guard(async (context, generation) => json(environmentMetadata(await required(generation), context.req.raw))));
+    app.get(`${API_BASE_PATH}/diagnostics`, guard(async (context, generation) => json(await diagnostics(await required(generation), context.req.raw))));
+    app.get(`${API_BASE_PATH}/source/:id`, guard(async (context, generation) => json(sourceDetail(await required(generation), requiredParam(context, "id")))));
+    app.get(`${API_BASE_PATH}/graph/source/:id`, guard(async (context, generation) => json(sourceDetail(await required(generation), requiredParam(context, "id")))));
+    for (const collection of GRAPH_COLLECTIONS) {
+        app.get(`${API_BASE_PATH}/${collection}`, guard(async (context, generation) => json(await graphList(await required(generation), collection, context.req.raw))));
+        app.get(`${API_BASE_PATH}/${collection}/:id`, guard(async (context, generation) => json(graphDetail(await required(generation), collection, requiredParam(context, "id")))));
+    }
+    app.get(`${API_BASE_PATH}/runtime`, guard(async (_context, generation) => json(await withGeneration(generation, runtimeSnapshot))));
+    app.get(`${API_BASE_PATH}/runtime/state`, guard(async (_context, generation) => json(await withGeneration(generation, runtimeSnapshot))));
+    for (const collection of RUNTIME_COLLECTIONS) {
+        app.get(`${API_BASE_PATH}/runtime/${collection}`, guard(async (context, generation) => json(await runtimeList(await required(generation), collection, context.req.raw))));
+        app.get(`${API_BASE_PATH}/runtime/${collection}/:id`, guard(async (context, generation) => json(await runtimeDetail(await required(generation), collection, requiredParam(context, "id")))));
+    }
+    installResourceExplorerEndpoints(app, guard, options.maxPreviewBytes ?? 1_048_576);
+    installObservability(app, options, mode);
+    installInspectorActionEndpoints(app, {
+        mode,
+        enabled,
+        authorize: (request) => authorized(request, options),
+        getGeneration: () => resolveActiveGeneration(options),
+    });
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,13 @@
+import type { JsonValue } from "@relkit/contracts";
+import { type ResolvedActiveGeneration } from "./shared.js";
+export declare const RUNTIME_COLLECTIONS: readonly ["functions", "jobs", "events", "buckets", "cache", "tools", "agents"];
+export type RuntimeCollection = (typeof RUNTIME_COLLECTIONS)[number];
+export declare class InspectorRuntimeError extends Error {
+    readonly code: "RELKIT_INSPECTOR_RUNTIME_UNAVAILABLE" | "RELKIT_INSPECTOR_NOT_FOUND";
+    readonly status: 404 | 503;
+    constructor(code: "RELKIT_INSPECTOR_RUNTIME_UNAVAILABLE" | "RELKIT_INSPECTOR_NOT_FOUND", status: 404 | 503);
+}
+export declare function runtimeSnapshot(generation: ResolvedActiveGeneration): Promise<JsonValue>;
+export declare function runtimeList(generation: ResolvedActiveGeneration, collection: RuntimeCollection, request: Request): Promise<JsonValue>;
+export declare function runtimeDetail(generation: ResolvedActiveGeneration, collection: RuntimeCollection, id: string): Promise<JsonValue>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EASL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,mBAAmB,iFAQrB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AA6DrE,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EAAE,sCAAsC,GAAG,4BAA4B;IACpF,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;gBADjB,IAAI,EAAE,sCAAsC,GAAG,4BAA4B,EAC3E,MAAM,EAAE,GAAG,GAAG,GAAG;CAK7B;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ9F;AAED,wBAAsB,WAAW,CAC/B,UAAU,EAAE,wBAAwB,EACpC,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,CAAC,CAIpB;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,wBAAwB,EACpC,UAAU,EAAE,iBAAiB,EAC7B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,SAAS,CAAC,CAOpB"}