@pi-harness/pi-harness 0.1.14 → 0.1.16

package/packages/client-web/src/i18n-pair-view.ts

@@ -1,194 +0,0 @@
-export type I18nPairStatusState = "idle" | "running" | "completed" | "failed" | "cancelled" | "unknown";
-
-export interface I18nPairPanelView {
-  readonly status: { readonly state: I18nPairStatusState; readonly at: string | null; readonly error: string | null };
-  readonly report: {
-    readonly base: string;
-    readonly target: string;
-    readonly baseKeys: number;
-    readonly targetKeys: number;
-    readonly missing: readonly string[];
-    readonly extra: readonly string[];
-    readonly missingTotal: number;
-    readonly extraTotal: number;
-    readonly truncated: boolean;
-  } | null;
-  readonly malformed: boolean;
-  readonly limits: typeof defaults;
-}
-
-const visibleKeysPerSide = 50;
-const maxStatusErrorCharacters = 2_000;
-const visibleStatusErrorCharacters = 500;
-const defaults = {
-  fileBytes: 4_194_304,
-  depth: 128,
-  keysPerFile: 50_000,
-  flattenedKeyLength: 2_048,
-  pathLength: 4_096,
-  panelKeysPerSide: 100,
-} as const;
-const rootKeys = new Set(["status", "report", "limits"]);
-const statusKeys = new Set(["state", "at", "error"]);
-const reportKeys = new Set(["base", "target", "baseKeys", "targetKeys", "missing", "extra", "missingTotal", "extraTotal", "truncated"]);
-const limitKeys = new Set(Object.keys(defaults));
-const unsafeUnicode = /[\p{Cc}\p{Cf}\p{Cs}]/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 hasExactly(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 safeInteger(value: unknown, maximum: number): number | undefined {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= maximum ? value : undefined;
-}
-
-function safeText(value: unknown, maximum: number, allowEmpty = false): string | undefined {
-  if (typeof value !== "string" || (!allowEmpty && value.length === 0) || value !== value.trim() || unsafeUnicode.test(value)) return undefined;
-  if ([...value].length > maximum || new TextEncoder().encode(value).byteLength > maximum) return undefined;
-  return value;
-}
-
-function timestamp(value: unknown): string | undefined {
-  if (typeof value !== "string" || value.length > 64) return undefined;
-  const milliseconds = Date.parse(value);
-  if (!Number.isFinite(milliseconds)) return undefined;
-  try {
-    return new Date(milliseconds).toISOString() === value ? value : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function stringArray(value: unknown): string[] | undefined {
-  try {
-    if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return undefined;
-    const lengthDescriptor = Object.getOwnPropertyDescriptor(value, "length");
-    const length: unknown = lengthDescriptor !== undefined && "value" in lengthDescriptor ? lengthDescriptor.value : undefined;
-    if (!Number.isSafeInteger(length) || (length as number) < 0 || (length as number) > defaults.panelKeysPerSide) return undefined;
-    const descriptors = Object.getOwnPropertyDescriptors(value);
-    if (
-      Reflect.ownKeys(descriptors).some((key) => key !== "length" && (typeof key !== "string" || !/^\d+$/u.test(key))) ||
-      Object.values(descriptors).some((descriptor) => !("value" in descriptor))
-    )
-      return undefined;
-    const output: string[] = [];
-    for (let index = 0; index < (length as number); index += 1) {
-      const descriptor = descriptors[String(index)];
-      const item: unknown = descriptor !== undefined && "value" in descriptor ? descriptor.value : undefined;
-      const text = safeText(item, defaults.flattenedKeyLength, true);
-      if (text === undefined) return undefined;
-      output.push(text);
-    }
-    return output;
-  } catch {
-    return undefined;
-  }
-}
-
-function statusView(value: unknown): I18nPairPanelView["status"] | undefined {
-  const source = ownDataRecord(value, statusKeys);
-  if (source === undefined) return undefined;
-  if (source.state === "idle" && hasExactly(source, new Set(["state"]))) return { state: "idle", at: null, error: null };
-  if (source.state === "running" && hasExactly(source, new Set(["state"]))) return { state: "running", at: null, error: null };
-  const at = timestamp(source.at);
-  if (source.state === "completed" && at !== undefined && hasExactly(source, new Set(["state", "at"]))) return { state: "completed", at, error: null };
-  if ((source.state === "failed" || source.state === "cancelled") && at !== undefined && hasExactly(source, statusKeys)) {
-    const error = safeText(source.error, maxStatusErrorCharacters);
-    if (error !== undefined) return { state: source.state, at, error: [...error].slice(0, visibleStatusErrorCharacters).join("") };
-  }
-  return undefined;
-}
-
-function reportView(value: unknown): I18nPairPanelView["report"] | undefined {
-  const source = ownDataRecord(value, reportKeys);
-  if (source === undefined || !hasExactly(source, reportKeys)) return undefined;
-  const base = safeText(source.base, defaults.pathLength);
-  const target = safeText(source.target, defaults.pathLength);
-  const baseKeys = safeInteger(source.baseKeys, defaults.keysPerFile);
-  const targetKeys = safeInteger(source.targetKeys, defaults.keysPerFile);
-  const missing = stringArray(source.missing);
-  const extra = stringArray(source.extra);
-  const missingTotal = safeInteger(source.missingTotal, defaults.keysPerFile);
-  const extraTotal = safeInteger(source.extraTotal, defaults.keysPerFile);
-  if (
-    base === undefined ||
-    target === undefined ||
-    baseKeys === undefined ||
-    targetKeys === undefined ||
-    missing === undefined ||
-    extra === undefined ||
-    missingTotal === undefined ||
-    extraTotal === undefined ||
-    typeof source.truncated !== "boolean"
-  )
-    return undefined;
-  const expectedMissingLength = Math.min(missingTotal, defaults.panelKeysPerSide);
-  const expectedExtraLength = Math.min(extraTotal, defaults.panelKeysPerSide);
-  const expectedTruncated = expectedMissingLength < missingTotal || expectedExtraLength < extraTotal;
-  if (
-    missing.length !== expectedMissingLength ||
-    extra.length !== expectedExtraLength ||
-    source.truncated !== expectedTruncated ||
-    missingTotal > baseKeys ||
-    extraTotal > targetKeys ||
-    baseKeys - missingTotal !== targetKeys - extraTotal ||
-    new Set(missing).size !== missing.length ||
-    new Set(extra).size !== extra.length ||
-    missing.some((key) => extra.includes(key))
-  )
-    return undefined;
-  return {
-    base,
-    target,
-    baseKeys,
-    targetKeys,
-    missing: missing.slice(0, visibleKeysPerSide),
-    extra: extra.slice(0, visibleKeysPerSide),
-    missingTotal,
-    extraTotal,
-    truncated: expectedTruncated || missing.length > visibleKeysPerSide || extra.length > visibleKeysPerSide,
-  };
-}
-
-function validLimits(value: unknown): boolean {
-  const source = ownDataRecord(value, limitKeys);
-  return source !== undefined && hasExactly(source, limitKeys) && Object.entries(defaults).every(([key, expected]) => source[key] === expected);
-}
-
-function malformedView(): I18nPairPanelView {
-  return {
-    status: { state: "unknown", at: null, error: null },
-    report: null,
-    malformed: true,
-    limits: { ...defaults },
-  };
-}
-
-export function i18nPairPanelView(data: unknown): I18nPairPanelView {
-  const source = ownDataRecord(data, rootKeys);
-  if (source === undefined || !hasExactly(source, rootKeys) || !validLimits(source.limits)) return malformedView();
-  const status = statusView(source.status);
-  if (status === undefined) return malformedView();
-  const report = source.report === null ? null : reportView(source.report);
-  if (report === undefined || (status.state === "idle" && report !== null) || (status.state === "completed" && report === null)) return malformedView();
-  return { status, report, malformed: false, limits: { ...defaults } };
-}

package/packages/client-web/src/index.ts

@@ -1,34 +0,0 @@
-import { createElement } from "react";
-import { createRoot, type Root } from "react-dom/client";
-import { Context } from "@deepseek-ai/cordis";
-import { ControlRoomView } from "./react-room.js";
-import { createClientApi, type ClientApi } from "./control-room.js";
-
-declare module "@deepseek-ai/cordis" {
-  interface Context {
-    clientRoot: HTMLElement;
-    clientApi: ClientApi;
-  }
-}
-
-export class AppWebEntry {
-  readonly context: Context;
-  readonly root: HTMLElement;
-  readonly version?: string;
-  #reactRoot?: Root;
-  constructor(root: HTMLElement, options: { readonly version?: string } = {}) {
-    this.root = root;
-    this.version = options.version;
-    this.context = new Context();
-  }
-  run(): void {
-    this.context.provide("clientRoot", this.root);
-    this.context.provide("clientApi", createClientApi());
-    this.#reactRoot = createRoot(this.root);
-    this.#reactRoot.render(createElement(ControlRoomView, { api: this.context.clientApi, appVersion: this.version }));
-  }
-  async dispose(): Promise<void> {
-    this.#reactRoot?.unmount();
-    await this.context.fiber.dispose();
-  }
-}

package/packages/client-web/src/markdown.tsx

@@ -1,22 +0,0 @@
-import createDOMPurify from "dompurify";
-import { marked } from "marked";
-
-const markdownOptions = { gfm: true, breaks: true } as const;
-const purifier = typeof window === "undefined" ? undefined : createDOMPurify(window);
-
-function renderMarkdown(source: string): string {
-  const html = marked.parse(source, markdownOptions);
-  if (typeof html !== "string") return "";
-  return (
-    purifier?.sanitize(html, {
-      USE_PROFILES: { html: true },
-      ALLOWED_TAGS: ["a", "blockquote", "br", "code", "del", "em", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "li", "ol", "p", "pre", "strong", "ul"],
-      ALLOWED_ATTR: ["href", "rel", "target"],
-      FORBID_ATTR: ["style", "class", "id"],
-    }) ?? ""
-  );
-}
-
-export function MarkdownMessage({ text, onMouseUp }: { text: string; onMouseUp?: () => void }) {
-  return <div className="turn-markdown" dangerouslySetInnerHTML={{ __html: renderMarkdown(text) }} onMouseUp={onMouseUp} />;
-}

package/packages/client-web/src/marketplace-catalog.ts

@@ -1,10 +0,0 @@
-import type { ClientApi, ClientMarketplacePlugin } from "./control-room.js";
-
-export const loadMarketplaceCatalog = async (api: Pick<ClientApi, "listMarketplace">): Promise<readonly ClientMarketplacePlugin[]> => {
-  const items: ClientMarketplacePlugin[] = [];
-  for (let page = 0; ; page += 1) {
-    const result = await api.listMarketplace("", "", page, 100);
-    items.push(...result.items);
-    if (!result.hasNext || result.items.length === 0 || items.length >= result.total) return items;
-  }
-};

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

@@ -1,46 +0,0 @@
-export function marketplaceDetailPath(id: string): string {
-  return `?page=marketplace&plugin=${encodeURIComponent(id)}`;
-}
-
-export function readMarketplaceDetailId(params: URLSearchParams): string | undefined {
-  if (params.get("page") !== "marketplace") return undefined;
-  const id = params.get("plugin")?.trim();
-  return id || undefined;
-}
-
-export interface MarketplaceCategoryTab {
-  readonly id: string;
-  readonly label: string;
-  readonly count: number;
-}
-
-export function marketplaceCategoryTabs(categories: readonly MarketplaceCategoryTab[]): readonly MarketplaceCategoryTab[] {
-  const total = categories.reduce((sum, category) => sum + category.count, 0);
-  return [{ id: "", label: "全部", count: total }, ...categories];
-}
-
-export interface MarketplaceStatisticsInput {
-  readonly downloads30d?: number;
-  readonly quality?: number;
-  readonly updatedAt?: string;
-}
-
-export interface MarketplaceStatisticItem {
-  readonly label: string;
-  readonly value: string;
-}
-
-function compactDownloadCount(value: number): string {
-  if (value >= 10_000) return `${(value / 10_000).toFixed(1).replace(/\.0$/, "")} 万`;
-  return new Intl.NumberFormat("zh-CN").format(value);
-}
-
-export function marketplaceStatisticItems(statistics: MarketplaceStatisticsInput | undefined): readonly MarketplaceStatisticItem[] {
-  if (statistics === undefined) return [];
-  const items: MarketplaceStatisticItem[] = [];
-  if (statistics.downloads30d !== undefined) items.push({ label: "近 30 天下载量", value: compactDownloadCount(statistics.downloads30d) });
-  if (statistics.quality !== undefined) items.push({ label: "npm 质量分", value: String(Math.round(statistics.quality * 100)) });
-  if (statistics.updatedAt !== undefined && Number.isFinite(Date.parse(statistics.updatedAt)))
-    items.push({ label: "npm 更新时间", value: statistics.updatedAt.slice(0, 10) });
-  return items;
-}

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

@@ -1,122 +0,0 @@
-const visibleTools = 12;
-const visibleResources = 8;
-const visiblePrompts = 8;
-const visibleServers = 12;
-const defaults = {
-  responseBytes: 1_048_576,
-  commandArgs: 32,
-  argumentBytes: 4_096,
-  toolArgumentsBytes: 65_536,
-  toolArgumentDepth: 32,
-  requestTimeoutMs: 30_000,
-  panelItems: 20,
-  inventoryItems: 1_000,
-  paginationPages: 100,
-  stderrBytes: 8_192,
-  managedServers: 128,
-} as const;
-const serverStatuses = new Set(["running", "stopping", "stopped"]);
-
-function positive(value: unknown, fallback: number): number {
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallback;
-}
-
-function count(value: unknown, fallback: number): number {
-  return typeof value === "number" && Number.isFinite(value) && value >= fallback ? Math.trunc(value) : fallback;
-}
-
-function string(value: unknown, maximum: number): string | undefined {
-  return typeof value === "string" && value.length > 0 ? value.slice(0, maximum) : undefined;
-}
-
-function tool(value: unknown) {
-  const record = ownRecord(value);
-  if (record === undefined) return undefined;
-  const name = string(record.name, 512);
-  if (name === undefined) return undefined;
-  const description = string(record.description, 500);
-  return { name, ...(description === undefined ? {} : { description }) };
-}
-
-function resource(value: unknown) {
-  const record = ownRecord(value);
-  if (record === undefined) return undefined;
-  const uri = string(record.uri, 4_096);
-  if (uri === undefined) return undefined;
-  const name = string(record.name, 512);
-  const mimeType = string(record.mimeType, 256);
-  return { uri, ...(name === undefined ? {} : { name }), ...(mimeType === undefined ? {} : { mimeType }) };
-}
-
-function prompt(value: unknown) {
-  const record = ownRecord(value);
-  if (record === undefined) return undefined;
-  const name = string(record.name, 512);
-  if (name === undefined) return undefined;
-  const description = string(record.description, 500);
-  return { name, ...(description === undefined ? {} : { description }) };
-}
-
-function server(value: unknown) {
-  const record = ownRecord(value);
-  if (record === undefined) return undefined;
-  const id = string(record.id, 64);
-  if (id === undefined) return undefined;
-  const status = typeof record.status === "string" && serverStatuses.has(record.status) ? record.status : "unknown";
-  const startedAt = typeof record.startedAt === "number" && Number.isFinite(record.startedAt) && record.startedAt >= 0 ? Math.trunc(record.startedAt) : 0;
-  return { id, status, startedAt };
-}
-
-function items<T>(raw: unknown, visible: number, normalize: (value: unknown) => T | undefined): { values: T[]; clipped: boolean; rawLength: number } {
-  const source = ownArray(raw, visible + 2) ?? [];
-  const inspected = source;
-  const values = inspected
-    .map(normalize)
-    .filter((value): value is T => value !== undefined)
-    .slice(0, visible);
-  return { values, clipped: source.length > visible || source.length !== values.length, rawLength: source.length };
-}
-
-function inventory(raw: unknown, shown: number, clipped: boolean) {
-  const source = ownRecord(raw) ?? {};
-  const total = count(source.total, shown);
-  return { total, shown, truncated: source.truncated === true || clipped || total > shown };
-}
-
-export function mcpClientPanelView(data: unknown) {
-  const source = ownRecord(data) ?? {};
-  const normalizedTools = items(source.tools, visibleTools, tool);
-  const normalizedResources = items(source.resources, visibleResources, resource);
-  const normalizedPrompts = items(source.prompts, visiblePrompts, prompt);
-  const normalizedServers = items(source.servers, visibleServers, server);
-  const rawInventory = ownRecord(source.inventory) ?? {};
-  const rawLimits = ownRecord(source.limits) ?? {};
-  return {
-    server: source.server === null ? null : (string(source.server, 4_096) ?? null),
-    tools: normalizedTools.values,
-    resources: normalizedResources.values,
-    prompts: normalizedPrompts.values,
-    lastCall: source.lastCall === null ? null : (string(source.lastCall, 512) ?? null),
-    servers: normalizedServers.values,
-    inventory: {
-      tools: inventory(rawInventory.tools, normalizedTools.values.length, normalizedTools.clipped),
-      resources: inventory(rawInventory.resources, normalizedResources.values.length, normalizedResources.clipped),
-      prompts: inventory(rawInventory.prompts, normalizedPrompts.values.length, normalizedPrompts.clipped),
-      servers: inventory(rawInventory.servers, normalizedServers.values.length, normalizedServers.clipped),
-    },
-    limits: {
-      responseBytes: positive(rawLimits.responseBytes, defaults.responseBytes),
-      commandArgs: positive(rawLimits.commandArgs, defaults.commandArgs),
-      argumentBytes: positive(rawLimits.argumentBytes, defaults.argumentBytes),
-      toolArgumentsBytes: positive(rawLimits.toolArgumentsBytes, defaults.toolArgumentsBytes),
-      toolArgumentDepth: positive(rawLimits.toolArgumentDepth, defaults.toolArgumentDepth),
-      requestTimeoutMs: positive(rawLimits.requestTimeoutMs, defaults.requestTimeoutMs),
-      panelItems: positive(rawLimits.panelItems, defaults.panelItems),
-      inventoryItems: positive(rawLimits.inventoryItems, defaults.inventoryItems),
-      paginationPages: positive(rawLimits.paginationPages, defaults.paginationPages),
-      stderrBytes: positive(rawLimits.stderrBytes, defaults.stderrBytes),
-      managedServers: positive(rawLimits.managedServers, defaults.managedServers),
-    },
-  };
-}
-import { ownArray, ownRecord } from "./panel-safe.js";

package/packages/client-web/src/message-content.ts

@@ -1,51 +0,0 @@
-export function messageText(message: Record<string, unknown>): string {
-  const content = message.content;
-  if (typeof content === "string") return content;
-  if (!Array.isArray(content)) return "";
-  return content
-    .map((part) => {
-      if (typeof part === "string") return part;
-      if (typeof part !== "object" || part === null) return "";
-      const typedPart = part as { type?: unknown; text?: unknown };
-      return (typedPart.type === undefined || typedPart.type === "text") && typeof typedPart.text === "string" ? typedPart.text : "";
-    })
-    .join("");
-}
-
-export function messageThinking(message: Record<string, unknown>): string {
-  const content = message.content;
-  if (!Array.isArray(content)) return "";
-  return content
-    .map((part) => {
-      if (typeof part !== "object" || part === null) return "";
-      const typedPart = part as { type?: unknown; thinking?: unknown };
-      return typedPart.type === "thinking" && typeof typedPart.thinking === "string" ? typedPart.thinking : "";
-    })
-    .filter(Boolean)
-    .join("\n\n");
-}
-
-export interface ChatTurn {
-  readonly role: "user" | "assistant";
-  readonly text: string;
-  readonly thinking: string;
-}
-
-export function projectChatTurns(messages: readonly Record<string, unknown>[]): readonly ChatTurn[] {
-  const turns: ChatTurn[] = [];
-  for (const message of messages) {
-    if (message.role === "toolResult") continue;
-    const role = message.role === "user" ? "user" : message.role === "assistant" ? "assistant" : undefined;
-    if (!role) continue;
-    const text = messageText(message);
-    const thinking = role === "assistant" ? messageThinking(message) : "";
-    if (!text && !thinking) continue;
-    const previous = turns.at(-1);
-    if (role === "assistant" && previous?.role === "assistant") {
-      turns[turns.length - 1] = { role, text: previous.text + text, thinking: previous.thinking + thinking };
-    } else {
-      turns.push({ role, text, thinking });
-    }
-  }
-  return turns;
-}