@relkit/inspector-api 0.0.0

package/dist/runtime.js

@@ -0,0 +1,158 @@
+import { eventRuntimeList } from "./events-runtime.js";
+import { identity, isRecord, page, pick, resolveCollection, resolveItem, safeJson, safeSource, } from "./shared.js";
+export const RUNTIME_COLLECTIONS = Object.freeze([
+    "functions",
+    "jobs",
+    "events",
+    "buckets",
+    "cache",
+    "tools",
+    "agents",
+]);
+const RUNTIME_FIELDS = [
+    "id",
+    "functionId",
+    "jobId",
+    "instanceId",
+    "eventId",
+    "eventVersion",
+    "deliveryId",
+    "bucketId",
+    "cacheId",
+    "toolId",
+    "agentId",
+    "turnId",
+    "profile",
+    "status",
+    "state",
+    "outcome",
+    "approval",
+    "sideEffect",
+    "invocationId",
+    "requestId",
+    "traceId",
+    "triggerId",
+    "toolCallId",
+    "parentSpanId",
+    "step",
+    "attempt",
+    "acceptedAt",
+    "availableAt",
+    "leaseExpiresAt",
+    "idempotencyExpiresAt",
+    "nextRun",
+    "nextRunAt",
+    "nextFireAt",
+    "schedules",
+    "startedAt",
+    "completedAt",
+    "durationMs",
+    "timeoutMs",
+    "concurrency",
+    "declaredEdges",
+    "observedEdges",
+    "failure",
+    "errorId",
+    "occurredAt",
+    "capabilities",
+    "policy",
+    "schemaVersion",
+    "bytes",
+    "objects",
+    "entries",
+    "hits",
+    "misses",
+    "evictions",
+    "inFlight",
+    "inputBytes",
+    "outputBytes",
+];
+export class InspectorRuntimeError extends Error {
+    code;
+    status;
+    constructor(code, status) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.name = "InspectorRuntimeError";
+    }
+}
+export async function runtimeSnapshot(generation) {
+    const entries = await Promise.all(RUNTIME_COLLECTIONS.map(async (collection) => {
+        const items = await runtimeItems(generation, collection);
+        return [collection, { count: items.length, items }];
+    }));
+    return { ...identity(generation), state: Object.fromEntries(entries) };
+}
+export async function runtimeList(generation, collection, request) {
+    if (collection === "events")
+        return eventRuntimeList(generation, request);
+    const items = await runtimeItems(generation, collection);
+    return { ...identity(generation), ...page(items, request) };
+}
+export async function runtimeDetail(generation, collection, id) {
+    const source = runtimeSource(generation, collection);
+    let item = await resolveItem(source, id);
+    if (item === undefined)
+        item = (await runtimeItems(generation, collection)).find((value) => itemId(value) === id);
+    if (item === undefined)
+        throw new InspectorRuntimeError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    return { ...identity(generation), state: projectItem(item) };
+}
+async function runtimeItems(generation, collection) {
+    const source = runtimeSource(generation, collection);
+    if (source === undefined)
+        return [];
+    const value = await resolveCollection(source);
+    if (value === undefined || value === null)
+        return [];
+    const raw = Array.isArray(value)
+        ? value
+        : isRecord(value) && Array.isArray(value.items)
+            ? value.items
+            : isRecord(value)
+                ? [value]
+                : [];
+    return raw.flatMap((item) => {
+        const projected = projectItem(item);
+        return projected === undefined ? [] : [projected];
+    });
+}
+function runtimeSource(generation, collection) {
+    if (collection === "cache")
+        return generation.runtime?.cache ?? generation.runtime?.caches;
+    return generation.runtime?.[collection];
+}
+function projectItem(value) {
+    if (!isRecord(value))
+        return undefined;
+    const result = pick(value, RUNTIME_FIELDS);
+    const source = safeSource(value.source);
+    if (source !== undefined)
+        result.source = source;
+    const id = itemId(value);
+    if (id !== undefined)
+        result.id = id;
+    return safeJson(result);
+}
+function itemId(value) {
+    if (!isRecord(value))
+        return undefined;
+    for (const key of [
+        "id",
+        "functionId",
+        "jobId",
+        "instanceId",
+        "eventId",
+        "deliveryId",
+        "bucketId",
+        "cacheId",
+        "toolId",
+        "agentId",
+    ]) {
+        if (typeof value[key] === "string" && value[key].length > 0)
+            return value[key];
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,74 @@
+import { type JsonValue, type MaybePromise } from "@relkit/contracts";
+import { type RedactionPolicy } from "@relkit/observability";
+import type { InspectorActionServices } from "./actions.js";
+import type { InspectorCandidateGenerationSource, ResolvedCandidateGeneration } from "./generation-types.js";
+import type { InspectorResourceExplorers } from "./resource-explorer.js";
+export type InspectorMode = "development" | "test" | "production";
+export type InspectorValueSource<T = unknown> = T | (() => MaybePromise<T>);
+export interface InspectorRuntimeServices {
+    readonly functions?: unknown;
+    readonly jobs?: unknown;
+    readonly events?: unknown;
+    readonly buckets?: unknown;
+    readonly cache?: unknown;
+    readonly caches?: unknown;
+    readonly tools?: unknown;
+    readonly agents?: unknown;
+}
+export interface InspectorGenerationServices extends InspectorRuntimeServices {
+    readonly graph?: unknown;
+    readonly descriptors?: unknown;
+    readonly environment?: unknown;
+    readonly diagnostics?: unknown;
+    readonly candidate?: unknown;
+    readonly candidateGeneration?: unknown;
+    readonly observedEdges?: unknown;
+    readonly runtime?: InspectorRuntimeServices;
+    readonly actions?: InspectorValueSource<InspectorActionServices | undefined>;
+    readonly resources?: InspectorValueSource<InspectorResourceExplorers | undefined>;
+}
+export interface InspectorActiveGeneration extends InspectorGenerationServices {
+    readonly generationId?: string;
+    readonly id?: string;
+    readonly graphHash?: string;
+    readonly services?: InspectorGenerationServices;
+    readonly candidate?: InspectorCandidateGenerationSource;
+    readonly candidateGeneration?: InspectorCandidateGenerationSource;
+}
+export type InspectorActiveGenerationSource = InspectorActiveGeneration | (() => MaybePromise<InspectorActiveGeneration | undefined>);
+export interface ActiveGenerationOptions {
+    readonly activeGeneration?: InspectorActiveGenerationSource;
+    readonly generation?: InspectorActiveGenerationSource;
+    readonly getActiveGeneration?: () => MaybePromise<InspectorActiveGeneration | undefined>;
+}
+export interface ResolvedActiveGeneration {
+    readonly generationId: string;
+    readonly graphHash: string;
+    readonly graph?: unknown;
+    readonly descriptors?: unknown;
+    readonly diagnostics?: unknown;
+    readonly observedEdges?: unknown;
+    readonly runtime?: InspectorRuntimeServices;
+    readonly actions?: InspectorActionServices;
+    readonly resources?: InspectorResourceExplorers;
+    readonly candidate?: ResolvedCandidateGeneration;
+}
+export declare class InspectorQueryError extends TypeError {
+    constructor(message: string);
+}
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function resolveValue<T>(source: InspectorValueSource<T> | undefined): Promise<T | undefined>;
+export declare function resolveService(source: unknown): Promise<unknown>;
+export interface Page<T extends JsonValue = JsonValue> {
+    readonly items: readonly T[];
+    readonly nextCursor?: string;
+}
+export declare function page<T extends JsonValue>(items: readonly T[], request: Request): Page<T>;
+export declare function safeSource(value: unknown): JsonValue | undefined;
+export declare function safeJson(value: unknown, policy?: RedactionPolicy): JsonValue;
+export declare function pick(value: unknown, keys: readonly string[]): Record<string, unknown>;
+export declare function identity(generation: ResolvedActiveGeneration): Record<string, JsonValue>;
+export declare function resolveCollection(source: unknown): Promise<unknown>;
+export declare function resolveItem(source: unknown, id: string): Promise<unknown>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

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

package/dist/shared.js

@@ -0,0 +1,120 @@
+import { API_VERSION, normalizeSourceLocation, } from "@relkit/contracts";
+import { redactRecord } from "@relkit/observability";
+export class InspectorQueryError extends TypeError {
+    constructor(message) {
+        super(message);
+        this.name = "InspectorQueryError";
+    }
+}
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function stringValue(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
+}
+export async function resolveValue(source) {
+    return source === undefined
+        ? undefined
+        : typeof source === "function"
+            ? await source()
+            : source;
+}
+export async function resolveService(source) {
+    const value = await resolveValue(source);
+    if (isRecord(value) && typeof value.snapshot === "function")
+        return await value.snapshot();
+    return value;
+}
+export function page(items, request) {
+    const params = new URL(request.url).searchParams;
+    const search = readFilter(params.get("search"), "search");
+    const kind = readFilter(params.get("kind"), "kind");
+    const status = readFilter(params.get("status"), "status");
+    const filtered = items.filter((item) => (search === undefined || includesText(item, search.toLowerCase())) &&
+        (kind === undefined || matchesField(item, ["kind", "type", "method"], kind)) &&
+        (status === undefined || matchesField(item, ["status", "state", "outcome"], status)));
+    const cursor = readInteger(params.get("cursor"), "cursor", 0);
+    const limit = Math.min(readInteger(params.get("limit"), "limit", 50), 100);
+    const selected = filtered.slice(cursor, cursor + limit);
+    const next = cursor + selected.length;
+    return next < filtered.length
+        ? { items: selected, nextCursor: String(next) }
+        : { items: selected };
+}
+function readFilter(value, name) {
+    if (value === null || value.trim() === "")
+        return undefined;
+    if (value.length > 128)
+        throw new InspectorQueryError(`${name} is invalid`);
+    return value.trim();
+}
+function matchesField(value, names, expected) {
+    if (!isRecord(value))
+        return false;
+    return names.some((name) => value[name] === expected || (isRecord(value.config) && value.config[name] === expected));
+}
+function includesText(value, query) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return String(value).toLowerCase().includes(query);
+    }
+    if (Array.isArray(value))
+        return value.some((item) => includesText(item, query));
+    return (isRecord(value) && Object.values(value).some((item) => includesText(item, query)));
+}
+function readInteger(value, name, fallback) {
+    if (value === null)
+        return fallback;
+    if (!/^\d+$/.test(value))
+        throw new InspectorQueryError(`${name} is invalid`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || (name === "limit" && parsed < 1))
+        throw new InspectorQueryError(`${name} is invalid`);
+    return parsed;
+}
+export function safeSource(value) {
+    if (!isRecord(value) || typeof value.file !== "string")
+        return undefined;
+    if (!Number.isInteger(value.line) || !Number.isInteger(value.column))
+        return undefined;
+    try {
+        return normalizeSourceLocation(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function safeJson(value, policy) {
+    return redactRecord(value, policy);
+}
+export function pick(value, keys) {
+    if (!isRecord(value))
+        return {};
+    const result = {};
+    for (const key of keys)
+        if (value[key] !== undefined)
+            result[key] = value[key];
+    return result;
+}
+export function identity(generation) {
+    return {
+        protocol: "relkit.inspector",
+        version: API_VERSION,
+        generationId: generation.generationId,
+        graphHash: generation.graphHash,
+    };
+}
+export async function resolveCollection(source) {
+    const value = await resolveService(source);
+    if (isRecord(value) && typeof value.list === "function")
+        return await value.list();
+    if (isRecord(value) && typeof value.query === "function")
+        return await value.query({ limit: 100 });
+    return value;
+}
+export async function resolveItem(source, id) {
+    const value = await resolveService(source);
+    if (isRecord(value) && typeof value.get === "function")
+        return await value.get(id);
+    return undefined;
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@relkit/inspector-api",
+  "version": "0.0.0",
+  "description": "Unsupported internal API for the RELKIT inspector; use @relkit/cli.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/inspector-api"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@relkit/contracts": "0.0.0",
+    "@relkit/observability": "0.0.0",
+    "hono": "4.13.2"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}