@pi-harness/pi-harness 0.1.14 → 0.1.16

package/packages/client-web/src/modlens-view.ts

@@ -1,210 +0,0 @@
-export type ModlensModeView = "native" | "evidence";
-
-export interface ModlensImageView {
-  readonly mode: ModlensModeView;
-  readonly path: string;
-  readonly mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-  readonly bytes: number;
-  readonly cached: boolean;
-  readonly at: string;
-}
-
-export type ModlensStatusView =
-  | { readonly state: "idle" }
-  | { readonly state: "running"; readonly mode: ModlensModeView; readonly path: string; readonly at: string }
-  | ({ readonly state: "completed" } & ModlensImageView)
-  | {
-      readonly state: "failed" | "cancelled";
-      readonly mode: ModlensModeView;
-      readonly path: string;
-      readonly at: string;
-      readonly error: string;
-    };
-
-export interface ModlensPanelView {
-  readonly attached: boolean;
-  readonly image: ModlensImageView | null;
-  readonly status: ModlensStatusView;
-  readonly supportedTypes: readonly string[];
-  readonly limits: {
-    readonly imageBytes: number;
-    readonly pathCharacters: number;
-    readonly promptCharacters: number;
-    readonly evidenceBytes: number;
-    readonly agentTextBytes: number;
-    readonly timeoutMs: number;
-    readonly cacheEntries: number;
-  };
-  readonly truncated: boolean;
-}
-
-const supportedTypes = ["png", "jpeg", "jpg", "gif", "webp"] as const;
-const supportedTypeSet = new Set<string>(supportedTypes);
-const supportedMimeTypes = new Set<string>(["image/png", "image/jpeg", "image/gif", "image/webp"]);
-const maxErrorCharacters = 2_000;
-const defaults = {
-  imageBytes: 10_485_760,
-  pathCharacters: 4_096,
-  promptCharacters: 4_000,
-  evidenceBytes: 524_288,
-  agentTextBytes: 131_072,
-  timeoutMs: 180_000,
-  cacheEntries: 64,
-};
-const minimumTimeoutMs = 1_000;
-const maximumTimeoutMs = 300_000;
-
-function ownDataRecord(value: unknown): Record<string, unknown> | undefined {
-  try {
-    if (value === null || typeof value !== "object" || Array.isArray(value)) return undefined;
-    const prototype = Object.getPrototypeOf(value) as unknown;
-    if (prototype !== Object.prototype && prototype !== null) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value);
-    if (Reflect.ownKeys(descriptors).some((key) => typeof key !== "string")) return undefined;
-    const output = Object.create(null) as Record<string, unknown>;
-    for (const [key, descriptor] of Object.entries(descriptors)) {
-      if (!("value" in descriptor)) return undefined;
-      output[key] = descriptor.value;
-    }
-    return output;
-  } catch {
-    return undefined;
-  }
-}
-
-function cleanedText(value: unknown, maximum: number): { value: string | undefined; altered: boolean } {
-  if (typeof value !== "string") return { value: undefined, altered: true };
-  const sample = value.slice(0, maximum * 2 + 1);
-  const cleaned = sample
-    .replaceAll(/[\p{Cc}\p{Cf}]+/gu, " ")
-    .trim()
-    .slice(0, maximum);
-  return { value: cleaned === "" ? undefined : cleaned, altered: cleaned !== value };
-}
-
-function canonicalTimestamp(value: unknown): string | undefined {
-  if (typeof value !== "string") return undefined;
-  try {
-    return new Date(value).toISOString() === value ? value : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function imageMetadata(value: unknown, extraKeys: readonly string[] = []): { image: ModlensImageView | null; altered: boolean } {
-  const source = ownDataRecord(value);
-  if (source === undefined) return { image: null, altered: value !== null };
-  const mode = source.mode === "native" || source.mode === "evidence" ? source.mode : undefined;
-  const path = cleanedText(source.path, defaults.pathCharacters);
-  const mimeType =
-    typeof source.mimeType === "string" && supportedMimeTypes.has(source.mimeType) ? (source.mimeType as ModlensImageView["mimeType"]) : undefined;
-  const bytes =
-    typeof source.bytes === "number" && Number.isSafeInteger(source.bytes) && source.bytes >= 0 && source.bytes <= defaults.imageBytes
-      ? source.bytes
-      : undefined;
-  const cached = typeof source.cached === "boolean" && !(mode === "native" && source.cached) ? source.cached : undefined;
-  const at = canonicalTimestamp(source.at);
-  const expectedKeys = new Set(["mode", "path", "mimeType", "bytes", "cached", "at", ...extraKeys]);
-  const altered = path.altered || Object.keys(source).some((key) => !expectedKeys.has(key));
-  if (mode === undefined || path.value === undefined || mimeType === undefined || bytes === undefined || cached === undefined || at === undefined)
-    return { image: null, altered: true };
-  return { image: { mode, path: path.value, mimeType, bytes, cached, at }, altered };
-}
-
-function statusView(value: unknown): { status: ModlensStatusView; altered: boolean } {
-  const source = ownDataRecord(value);
-  if (source === undefined) return { status: { state: "idle" }, altered: true };
-  if (source.state === "idle") return { status: { state: "idle" }, altered: Object.keys(source).some((key) => key !== "state") };
-  if (source.state === "completed") {
-    const parsed = imageMetadata(source, ["state"]);
-    return parsed.image === null ? { status: { state: "idle" }, altered: true } : { status: { state: "completed", ...parsed.image }, altered: parsed.altered };
-  }
-  if (source.state !== "running" && source.state !== "failed" && source.state !== "cancelled") return { status: { state: "idle" }, altered: true };
-  const mode = source.mode === "native" || source.mode === "evidence" ? source.mode : undefined;
-  const path = cleanedText(source.path, defaults.pathCharacters);
-  const at = canonicalTimestamp(source.at);
-  if (mode === undefined || path.value === undefined || at === undefined) return { status: { state: "idle" }, altered: true };
-  if (source.state === "running") {
-    const altered = path.altered || Object.keys(source).some((key) => !new Set(["state", "mode", "path", "at"]).has(key));
-    return { status: { state: "running", mode, path: path.value, at }, altered };
-  }
-  const error = cleanedText(source.error, maxErrorCharacters);
-  if (error.value === undefined) return { status: { state: "idle" }, altered: true };
-  const altered = path.altered || error.altered || Object.keys(source).some((key) => !new Set(["state", "mode", "path", "at", "error"]).has(key));
-  return { status: { state: source.state, mode, path: path.value, at, error: error.value }, altered };
-}
-
-function exactSupportedTypes(value: unknown): boolean {
-  try {
-    if (!Array.isArray(value)) return false;
-    const lengthDescriptor = Object.getOwnPropertyDescriptor(value, "length");
-    if (lengthDescriptor === undefined || !("value" in lengthDescriptor) || lengthDescriptor.value !== supportedTypes.length) return false;
-    const seen = new Set<string>();
-    for (let index = 0; index < supportedTypes.length; index += 1) {
-      const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
-      if (descriptor === undefined || !("value" in descriptor) || typeof descriptor.value !== "string" || !supportedTypeSet.has(descriptor.value)) return false;
-      seen.add(descriptor.value);
-    }
-    return seen.size === supportedTypes.length;
-  } catch {
-    return false;
-  }
-}
-
-export function modlensPanelView(data: unknown): ModlensPanelView {
-  const source = ownDataRecord(data);
-  if (source === undefined) {
-    return {
-      attached: false,
-      image: null,
-      status: { state: "idle" },
-      supportedTypes: [...supportedTypes],
-      limits: { ...defaults },
-      truncated: true,
-    };
-  }
-  const parsedImage = imageMetadata(source.image);
-  const parsedStatus = statusView(source.status);
-  const completedStatusMatchesImage =
-    parsedStatus.status.state !== "completed" ||
-    (parsedImage.image !== null &&
-      parsedStatus.status.mode === parsedImage.image.mode &&
-      parsedStatus.status.path === parsedImage.image.path &&
-      parsedStatus.status.mimeType === parsedImage.image.mimeType &&
-      parsedStatus.status.bytes === parsedImage.image.bytes &&
-      parsedStatus.status.cached === parsedImage.image.cached &&
-      parsedStatus.status.at === parsedImage.image.at);
-  const rawLimits = ownDataRecord(source.limits);
-  const timeoutMs =
-    rawLimits !== undefined &&
-    typeof rawLimits.timeoutMs === "number" &&
-    Number.isSafeInteger(rawLimits.timeoutMs) &&
-    rawLimits.timeoutMs >= minimumTimeoutMs &&
-    rawLimits.timeoutMs <= maximumTimeoutMs
-      ? rawLimits.timeoutMs
-      : defaults.timeoutMs;
-  const fixedLimitKeys = ["imageBytes", "pathCharacters", "promptCharacters", "evidenceBytes", "agentTextBytes", "cacheEntries"] as const;
-  const limitsAltered =
-    rawLimits === undefined ||
-    fixedLimitKeys.some((key) => rawLimits[key] !== defaults[key]) ||
-    Object.keys(rawLimits).some((key) => ![...fixedLimitKeys, "timeoutMs"].includes(key)) ||
-    timeoutMs !== rawLimits.timeoutMs;
-  const attached = parsedImage.image !== null;
-  const expectedRootKeys = new Set(["attached", "image", "status", "supportedTypes", "limits"]);
-  const truncated =
-    parsedImage.altered ||
-    parsedStatus.altered ||
-    !completedStatusMatchesImage ||
-    limitsAltered ||
-    !exactSupportedTypes(source.supportedTypes) ||
-    source.attached !== attached ||
-    Object.keys(source).some((key) => !expectedRootKeys.has(key));
-  return {
-    attached,
-    image: parsedImage.image,
-    status: parsedStatus.status,
-    supportedTypes: [...supportedTypes],
-    limits: { ...defaults, timeoutMs },
-    truncated,
-  };
-}

package/packages/client-web/src/openpets-view.ts

@@ -1,67 +0,0 @@
-import { ownRecord } from "./panel-safe.js";
-
-export type OpenPetsMood = "idle" | "focused" | "happy" | "concerned";
-
-const defaults = { nameCharacters: 128, recoveryEntries: 10_000, persistenceErrorCharacters: 2_000 } as const;
-const moods = new Set<OpenPetsMood>(["idle", "focused", "happy", "concerned"]);
-const events = new Set(["session_start", "agent_start", "agent_end", "tool_execution_end", "feed", "play", "set_mood"]);
-
-function limit(value: unknown, fallback: number): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1 && value <= fallback ? value : fallback;
-}
-
-function nonNegativeInteger(value: unknown, fallback = 0): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : fallback;
-}
-
-function boundedString(value: unknown, maximum: number): string {
-  return typeof value === "string" ? value.slice(0, maximum) : "";
-}
-
-function timestamp(value: unknown): string | null {
-  if (typeof value !== "string" || value.length > 64) return null;
-  try {
-    return new Date(value).toISOString() === value ? value : null;
-  } catch {
-    return null;
-  }
-}
-
-export function openPetsPanelView(data: unknown) {
-  const source = ownRecord(data) ?? {};
-  const rawLimits = ownRecord(source.limits) ?? {};
-  const limits = {
-    nameCharacters: limit(rawLimits.nameCharacters, defaults.nameCharacters),
-    recoveryEntries: limit(rawLimits.recoveryEntries, defaults.recoveryEntries),
-    persistenceErrorCharacters: limit(rawLimits.persistenceErrorCharacters, defaults.persistenceErrorCharacters),
-  };
-  const rawRecovery = ownRecord(source.recovery) ?? {};
-  const sessionEntries = nonNegativeInteger(rawRecovery.sessionEntries);
-  const scanned = Math.min(sessionEntries, limits.recoveryEntries, nonNegativeInteger(rawRecovery.scanned));
-  const rawPersistence = ownRecord(source.persistence) ?? {};
-  const attempts = nonNegativeInteger(rawPersistence.attempts);
-  const name = boundedString(source.name, limits.nameCharacters);
-  const mood = typeof source.mood === "string" && moods.has(source.mood as OpenPetsMood) ? (source.mood as OpenPetsMood) : "idle";
-  const lastEvent = typeof source.lastEvent === "string" && events.has(source.lastEvent) ? source.lastEvent : "session_start";
-  const energy = typeof source.energy === "number" && Number.isSafeInteger(source.energy) && source.energy >= 0 && source.energy <= 100 ? source.energy : 80;
-  return {
-    name: name || "Pi",
-    mood,
-    energy,
-    interactions: nonNegativeInteger(source.interactions),
-    lastEvent,
-    updatedAt: timestamp(source.updatedAt),
-    recovery: {
-      sessionEntries,
-      scanned,
-      truncated: rawRecovery.truncated === true || sessionEntries > scanned,
-      restored: rawRecovery.restored === true,
-    },
-    persistence: {
-      attempts,
-      failures: Math.min(attempts, nonNegativeInteger(rawPersistence.failures)),
-      lastError: boundedString(rawPersistence.lastError, limits.persistenceErrorCharacters) || null,
-    },
-    limits,
-  };
-}

package/packages/client-web/src/panel-safe.ts

@@ -1,47 +0,0 @@
-/** Read only own data properties from an untrusted panel payload. */
-export function ownRecord(value: unknown): Record<string, unknown> | undefined {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return undefined;
-  try {
-    const prototype = Object.getPrototypeOf(value) as unknown;
-    if (prototype !== Object.prototype && prototype !== null) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value) as Record<string, PropertyDescriptor | undefined>;
-    if (Reflect.ownKeys(descriptors).some((key) => typeof key !== "string")) return undefined;
-    const result = Object.create(null) as Record<string, unknown>;
-    for (const [key, descriptor] of Object.entries(descriptors)) {
-      if (descriptor === undefined || !("value" in descriptor)) return undefined;
-      result[key] = descriptorValue(descriptor);
-    }
-    return result;
-  } catch {
-    return undefined;
-  }
-}
-
-/** Return a bounded dense array containing only own data properties. */
-export function ownArray(value: unknown, maximum = Number.MAX_SAFE_INTEGER): unknown[] | undefined {
-  if (!Array.isArray(value)) return undefined;
-  try {
-    const prototype = Object.getPrototypeOf(value) as unknown;
-    if (prototype !== Array.prototype && prototype !== null) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value) as Record<string, PropertyDescriptor | undefined>;
-    const lengthDescriptor = descriptors.length;
-    const lengthValue = descriptorValue(lengthDescriptor);
-    if (typeof lengthValue !== "number" || !Number.isSafeInteger(lengthValue) || lengthValue < 0) return undefined;
-    const length = lengthValue;
-    if (length > maximum) return Array.from({ length: maximum }, (_, index) => descriptorValue(descriptors[String(index)]));
-    if (Reflect.ownKeys(descriptors).some((key) => key !== "length" && (typeof key !== "string" || !/^(?:0|[1-9]\d*)$/u.test(key)))) return undefined;
-    const result: unknown[] = [];
-    for (let index = 0; index < length; index += 1) {
-      const descriptor = descriptors[String(index)];
-      if (descriptor === undefined || !("value" in descriptor)) return undefined;
-      result.push(descriptorValue(descriptor));
-    }
-    return result;
-  } catch {
-    return undefined;
-  }
-}
-
-function descriptorValue(descriptor: PropertyDescriptor | undefined): unknown {
-  return descriptor !== undefined && "value" in descriptor ? (descriptor.value as unknown) : undefined;
-}

package/packages/client-web/src/plugin-card.ts

@@ -1,22 +0,0 @@
-import type { ClientMarketplacePlugin, ClientPlugin } from "./control-room.js";
-
-export interface InstalledPluginCardContent {
-  readonly packageLabel: string;
-  readonly description: string;
-  readonly tags: readonly string[];
-}
-
-export function installedPluginCardContent(plugin: ClientPlugin, metadata: ClientMarketplacePlugin | undefined): InstalledPluginCardContent {
-  if (metadata) {
-    return {
-      packageLabel: `${plugin.name} · v${metadata.version}`,
-      description: metadata.description,
-      tags: [...metadata.capabilities, ...metadata.hooks.map((hook) => `hook:${hook}`)],
-    };
-  }
-  return {
-    packageLabel: plugin.name,
-    description: plugin.enabled ? "由当前运行时加载并启用，能力与 hook 已注册。" : "由当前运行时加载但已停用。",
-    tags: ["loader", plugin.state === "active" ? "active" : `state:${plugin.state}`],
-  };
-}

package/packages/client-web/src/plugin-dev-view.ts

@@ -1,39 +0,0 @@
-import { ownRecord } from "./panel-safe.js";
-
-export type PluginDevStatus = "idle" | "queued" | "running" | "reloaded" | "failed" | "cancelled";
-
-const defaults = { reasonCharacters: 1_000, errorCharacters: 2_000 } as const;
-const statuses = new Set<PluginDevStatus>(["idle", "queued", "running", "reloaded", "failed", "cancelled"]);
-
-function boundedString(value: unknown, maximum: number): string {
-  return typeof value === "string" ? value.slice(0, maximum) : "";
-}
-
-function optionalString(value: unknown, maximum: number): string | null {
-  const text = boundedString(value, maximum);
-  return text === "" ? null : text;
-}
-
-function limit(value: unknown, fallback: number): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1 && value <= fallback ? value : fallback;
-}
-
-export function pluginDevPanelView(data: unknown) {
-  const source = ownRecord(data) ?? {};
-  const rawLimits = ownRecord(source.limits) ?? {};
-  const limits = {
-    reasonCharacters: limit(rawLimits.reasonCharacters, defaults.reasonCharacters),
-    errorCharacters: limit(rawLimits.errorCharacters, defaults.errorCharacters),
-  };
-  const status = typeof source.status === "string" && statuses.has(source.status as PluginDevStatus) ? (source.status as PluginDevStatus) : "idle";
-  return {
-    status,
-    reason: boundedString(source.reason, limits.reasonCharacters),
-    requestedAt: optionalString(source.requestedAt, 64),
-    startedAt: optionalString(source.startedAt, 64),
-    reloadedAt: optionalString(source.reloadedAt, 64),
-    error: optionalString(source.error, limits.errorCharacters),
-    busy: status === "queued" || status === "running",
-    limits,
-  };
-}

package/packages/client-web/src/plugin-navigation.ts

@@ -1,9 +0,0 @@
-export function installedPluginDetailPath(packageName: string): string {
-  return `?page=plugins&plugin=${encodeURIComponent(packageName)}`;
-}
-
-export function readInstalledPluginDetailId(params: URLSearchParams): string | undefined {
-  if (params.get("page") !== "plugins") return undefined;
-  const id = params.get("plugin")?.trim();
-  return id || undefined;
-}

package/packages/client-web/src/plugin-search.ts

@@ -1,5 +0,0 @@
-export const matchesPluginQuery = (query: string, fields: readonly (string | undefined)[]): boolean => {
-  const normalized = query.trim().toLowerCase();
-  if (!normalized) return true;
-  return fields.some((field) => field?.toLowerCase().includes(normalized));
-};

package/packages/client-web/src/plugin-stars-view.ts

@@ -1,257 +0,0 @@
-export interface PluginStarsRowInput {
-  readonly fullName: string;
-  readonly name: string;
-  readonly stars: number;
-  readonly htmlUrl: string;
-  readonly updatedAt: string;
-}
-
-export interface PluginStarsRow extends PluginStarsRowInput {
-  readonly rank: number;
-}
-
-export interface PluginStarsPanelView {
-  readonly source: string;
-  readonly limit: number;
-  readonly timeoutMs: number;
-  readonly latest: {
-    readonly source: string;
-    readonly generatedAt: string;
-    readonly total: number;
-    readonly query: string;
-    readonly fetchedAt: string;
-    readonly results: readonly PluginStarsRow[];
-  } | null;
-  readonly inventory: { readonly total: number; readonly shown: number; readonly truncated: boolean };
-  readonly limits: {
-    readonly responseBytes: number;
-    readonly sourceItems: number;
-    readonly resultItems: number;
-    readonly panelItems: number;
-    readonly queryCharacters: number;
-    readonly timeoutMs: number;
-  };
-  readonly malformed: boolean;
-}
-
-const visibleRows = 8;
-const defaults = {
-  limit: 10,
-  timeoutMs: 15_000,
-  responseBytes: 2 * 1024 * 1024,
-  sourceItems: 1_000,
-  resultItems: 50,
-  panelItems: 20,
-  queryCharacters: 120,
-} as const;
-const rootKeys = new Set(["source", "limit", "timeoutMs", "latest", "inventory", "limits"]);
-const latestKeys = new Set(["source", "generatedAt", "total", "query", "fetchedAt", "results"]);
-const inventoryKeys = new Set(["total", "shown", "truncated"]);
-const limitsKeys = new Set(["responseBytes", "sourceItems", "resultItems", "panelItems", "queryCharacters", "timeoutMs"]);
-const rowKeys = new Set(["id", "name", "fullName", "description", "htmlUrl", "homepage", "npmName", "stars", "updatedAt", "license", "topics"]);
-const unsafeUnicode = /[\p{Cc}\p{Cf}\p{Cs}\u2028\u2029]/u;
-
-function ownDataRecord(value: unknown, allowed: ReadonlySet<string>): Record<string, unknown> | undefined {
-  try {
-    if (value === null || typeof value !== "object" || Array.isArray(value)) return undefined;
-    const prototype = Object.getPrototypeOf(value) as unknown;
-    if (prototype !== Object.prototype && prototype !== null) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value);
-    if (Reflect.ownKeys(descriptors).some((key) => typeof key !== "string" || !allowed.has(key))) return undefined;
-    const output = Object.create(null) as Record<string, unknown>;
-    for (const [key, descriptor] of Object.entries(descriptors)) {
-      if (!("value" in descriptor)) return undefined;
-      output[key] = descriptor.value;
-    }
-    return output;
-  } catch {
-    return undefined;
-  }
-}
-
-function exact(source: Record<string, unknown>, keys: ReadonlySet<string>): boolean {
-  const own = Object.keys(source);
-  return own.length === keys.size && own.every((key) => keys.has(key));
-}
-
-function ownDataArray(value: unknown, maximum: number): unknown[] | undefined {
-  try {
-    if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value) as unknown as PropertyDescriptorMap;
-    const lengthDescriptor = descriptors.length;
-    const length: unknown = lengthDescriptor !== undefined && "value" in lengthDescriptor ? lengthDescriptor.value : undefined;
-    if (!Number.isSafeInteger(length) || (length as number) < 0 || (length as number) > maximum) return undefined;
-    if (
-      Reflect.ownKeys(descriptors).some(
-        (key) => key !== "length" && (typeof key !== "string" || !/^\d+$/u.test(key) || Number(key) >= (length as number) || String(Number(key)) !== key),
-      ) ||
-      Object.values(descriptors).some((descriptor) => !("value" in descriptor))
-    )
-      return undefined;
-    const output: unknown[] = [];
-    for (let index = 0; index < (length as number); index += 1) {
-      const descriptor = descriptors[String(index)];
-      if (descriptor === undefined || !("value" in descriptor)) return undefined;
-      output.push(descriptor.value);
-    }
-    return output;
-  } catch {
-    return undefined;
-  }
-}
-
-function text(value: unknown, maximum: number, allowEmpty = true): string | undefined {
-  if (typeof value !== "string" || (!allowEmpty && value.length === 0) || unsafeUnicode.test(value)) return undefined;
-  if ([...value].length > maximum || new TextEncoder().encode(value).byteLength > maximum) return undefined;
-  return value;
-}
-
-function integer(value: unknown, minimum: number, maximum: number): number | undefined {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= minimum && value <= maximum ? value : undefined;
-}
-
-function row(value: unknown): PluginStarsRowInput | undefined {
-  const source = ownDataRecord(value, rowKeys);
-  if (source === undefined) return undefined;
-  const fullName = text(source.fullName, 512, false);
-  const name = text(source.name, 256, false);
-  const htmlUrl = text(source.htmlUrl, 4_096, false);
-  const updatedAt = text(source.updatedAt, 64);
-  const stars = integer(source.stars, 0, Number.MAX_SAFE_INTEGER);
-  if (
-    fullName === undefined ||
-    name === undefined ||
-    htmlUrl === undefined ||
-    updatedAt === undefined ||
-    stars === undefined ||
-    !/^[^/\s]+\/[^/\s]+$/u.test(fullName)
-  )
-    return undefined;
-  let repositoryUrl: URL;
-  try {
-    repositoryUrl = new URL(htmlUrl);
-  } catch {
-    return undefined;
-  }
-  if (
-    repositoryUrl.protocol !== "https:" ||
-    repositoryUrl.hostname.toLowerCase() !== "github.com" ||
-    repositoryUrl.username !== "" ||
-    repositoryUrl.password !== "" ||
-    repositoryUrl.port !== "" ||
-    repositoryUrl.search !== "" ||
-    repositoryUrl.hash !== "" ||
-    repositoryUrl.pathname.replace(/\/$/u, "").toLowerCase() !== `/${fullName}`.toLowerCase()
-  )
-    return undefined;
-  return { fullName, name, stars, htmlUrl: repositoryUrl.toString(), updatedAt };
-}
-
-export function pluginStarsRows(entries: readonly PluginStarsRowInput[], limit: number): readonly PluginStarsRow[] {
-  const normalizedLimit = Math.max(0, Math.min(50, Math.trunc(limit)));
-  return entries
-    .slice(0, 64)
-    .map(row)
-    .filter((entry): entry is PluginStarsRowInput => entry !== undefined)
-    .sort((left, right) => right.stars - left.stars || left.fullName.localeCompare(right.fullName))
-    .slice(0, normalizedLimit)
-    .map((entry, index) => ({ ...entry, rank: index + 1 }));
-}
-
-function limitsView(value: unknown): PluginStarsPanelView["limits"] | undefined {
-  const source = ownDataRecord(value, limitsKeys);
-  if (source === undefined || !exact(source, limitsKeys)) return undefined;
-  const responseBytes = integer(source.responseBytes, 1, defaults.responseBytes);
-  const sourceItems = integer(source.sourceItems, 1, defaults.sourceItems);
-  const resultItems = integer(source.resultItems, 1, defaults.resultItems);
-  const panelItems = integer(source.panelItems, 1, defaults.panelItems);
-  const queryCharacters = integer(source.queryCharacters, 1, defaults.queryCharacters);
-  const timeoutMs = integer(source.timeoutMs, 1_000, 60_000);
-  return responseBytes === undefined ||
-    sourceItems === undefined ||
-    resultItems === undefined ||
-    panelItems === undefined ||
-    queryCharacters === undefined ||
-    timeoutMs === undefined
-    ? undefined
-    : { responseBytes, sourceItems, resultItems, panelItems, queryCharacters, timeoutMs };
-}
-
-function malformedView(): PluginStarsPanelView {
-  return {
-    source: "",
-    limit: defaults.limit,
-    timeoutMs: defaults.timeoutMs,
-    latest: null,
-    inventory: { total: 0, shown: 0, truncated: false },
-    limits: defaults,
-    malformed: true,
-  };
-}
-
-export function pluginStarsPanelView(data: unknown): PluginStarsPanelView {
-  const source = ownDataRecord(data, rootKeys);
-  if (source === undefined || !exact(source, rootKeys)) return malformedView();
-  const sourceUrl = text(source.source, 2_048, false);
-  const limit = integer(source.limit, 1, 50);
-  const timeoutMs = integer(source.timeoutMs, 1_000, 60_000);
-  const limits = limitsView(source.limits);
-  const inventory = ownDataRecord(source.inventory, inventoryKeys);
-  if (
-    sourceUrl === undefined ||
-    limit === undefined ||
-    timeoutMs === undefined ||
-    limits === undefined ||
-    inventory === undefined ||
-    !exact(inventory, inventoryKeys)
-  )
-    return malformedView();
-  const total = integer(inventory.total, 0, limits.sourceItems);
-  const shown = integer(inventory.shown, 0, limits.panelItems);
-  if (total === undefined || shown === undefined || typeof inventory.truncated !== "boolean") return malformedView();
-  const rawLatest = source.latest;
-  let latest: PluginStarsPanelView["latest"] = null;
-  if (rawLatest !== null) {
-    const latestSource = ownDataRecord(rawLatest, latestKeys);
-    if (latestSource === undefined || !exact(latestSource, latestKeys)) return malformedView();
-    const latestName = text(latestSource.source, 256, false);
-    const generatedAt = text(latestSource.generatedAt, 64, false);
-    const query = text(latestSource.query, limits.queryCharacters);
-    const fetchedAt = text(latestSource.fetchedAt, 64, false);
-    const latestTotal = integer(latestSource.total, 0, limits.sourceItems);
-    const rawResults = ownDataArray(latestSource.results, limits.panelItems);
-    if (
-      latestName === undefined ||
-      generatedAt === undefined ||
-      query === undefined ||
-      fetchedAt === undefined ||
-      latestTotal === undefined ||
-      rawResults === undefined
-    )
-      return malformedView();
-    const results: PluginStarsRowInput[] = [];
-    for (const raw of rawResults) {
-      const item = row(raw);
-      if (item === undefined) return malformedView();
-      results.push(item);
-    }
-    latest = { source: latestName, generatedAt, total: latestTotal, query, fetchedAt, results: pluginStarsRows(results, visibleRows) };
-  }
-  const visibleResults = latest?.results ?? [];
-  if (
-    shown !== visibleResults.length ||
-    total < shown ||
-    (latest === null && (total !== 0 || shown !== 0)) ||
-    (latest !== null && latest.total < visibleResults.length)
-  )
-    return malformedView();
-  return {
-    source: sourceUrl,
-    limit,
-    timeoutMs,
-    latest,
-    inventory: { total, shown: visibleResults.length, truncated: inventory.truncated || total > visibleResults.length },
-    limits,
-    malformed: false,
-  };
-}