@opengeni/react 0.37.0 → 0.40.0

package/src/components/human-input-surface.tsx

@@ -0,0 +1,80 @@
+import type { SessionHumanInputRequest, SubmitHumanInputResponseRequest } from "@opengeni/sdk";
+import { useEffect, useMemo, useRef } from "react";
+import { cn } from "../lib/cn";
+import {
+  HumanInputForm,
+  type HumanInputFormMessages,
+  type HumanInputFormProps,
+} from "./human-input-form";
+
+export type HumanInputSurfaceProps = {
+  requests: SessionHumanInputRequest[];
+  onSubmit: (requestId: string, response: SubmitHumanInputResponseRequest) => void | Promise<void>;
+  respondingRequestId?: string | null | undefined;
+  error?: string | null | undefined;
+  messages?: Partial<HumanInputFormMessages> | undefined;
+  className?: string | undefined;
+  /** Forwarded to the active form. Defaults true. */
+  autoFocus?: boolean | undefined;
+};
+
+/**
+ * One decision shell for pending structured human-input requests. Parallel
+ * freezes are shown one at a time (oldest first) as “N of M”; Continue/Skip
+ * settles the active request and the next remaining set advances automatically
+ * when the authoritative pending list updates.
+ */
+export function HumanInputSurface({
+  requests,
+  onSubmit,
+  respondingRequestId = null,
+  error,
+  messages,
+  className,
+  autoFocus = true,
+}: HumanInputSurfaceProps) {
+  const batchTotalRef = useRef(0);
+
+  const ordered = useMemo(() => {
+    return [...requests].sort((a, b) => {
+      const aAt = a.createdAt ? Date.parse(a.createdAt) : 0;
+      const bAt = b.createdAt ? Date.parse(b.createdAt) : 0;
+      if (aAt !== bAt) return aAt - bAt;
+      return a.id.localeCompare(b.id);
+    });
+  }, [requests]);
+
+  useEffect(() => {
+    if (ordered.length === 0) {
+      batchTotalRef.current = 0;
+      return;
+    }
+    batchTotalRef.current =
+      batchTotalRef.current === 0
+        ? ordered.length
+        : Math.max(batchTotalRef.current, ordered.length);
+  }, [ordered]);
+
+  if (ordered.length === 0) return null;
+
+  const active = ordered[0]!;
+  const batchTotal = Math.max(batchTotalRef.current, ordered.length);
+  const position = batchTotal - ordered.length + 1;
+  const progressLabel = batchTotal > 1 ? `${position} of ${batchTotal}` : null;
+
+  const formProps: HumanInputFormProps = {
+    request: active,
+    submitting: respondingRequestId !== null,
+    error: error ?? null,
+    progressLabel,
+    autoFocus,
+    ...(messages ? { messages } : {}),
+    onSubmit: (response) => onSubmit(active.id, response),
+  };
+
+  return (
+    <div className={cn("w-full", className)} data-human-input-surface="">
+      <HumanInputForm {...formProps} />
+    </div>
+  );
+}

package/src/components/machine-input-display.ts

@@ -0,0 +1,83 @@
+import type { MachineInputMember } from "../timeline/types";
+
+export const MACHINE_INPUT_META: Record<MachineInputMember["kind"], string> = {
+  scheduled_occurrence: "Scheduled update",
+  goal_continuation: "Goal continued",
+  agent_message: "Agent update",
+  agent_steer_instruction: "Agent direction",
+  child_terminal_result: "Agent finished",
+};
+
+/**
+ * Collapsed landmark label for a coalesced machine-input batch.
+ * Same-kind batches get a natural plural; mixed kinds stay short.
+ */
+export function machineInputBatchLabel(members: readonly MachineInputMember[]): string {
+  if (members.length === 0) return "Updates";
+  const counts = new Map<MachineInputMember["kind"], number>();
+  for (const member of members) {
+    counts.set(member.kind, (counts.get(member.kind) ?? 0) + 1);
+  }
+  if (counts.size === 1) {
+    const kind = members[0]!.kind;
+    const n = members.length;
+    switch (kind) {
+      case "child_terminal_result":
+        return n === 1 ? "Agent finished" : `${n} agents finished`;
+      case "goal_continuation":
+        return n === 1 ? "Goal continued" : `${n} goal continuations`;
+      case "scheduled_occurrence":
+        return n === 1 ? "Scheduled update" : `${n} scheduled updates`;
+      case "agent_message":
+        return n === 1 ? "Agent update" : `${n} agent updates`;
+      case "agent_steer_instruction":
+        return n === 1 ? "Agent direction" : `${n} agent directions`;
+    }
+  }
+  const parts = [...counts.entries()].map(([kind, count]) => {
+    const label = MACHINE_INPUT_META[kind];
+    return count === 1 ? label : `${count}× ${label}`;
+  });
+  const preview = parts.slice(0, 2).join(", ");
+  const suffix = parts.length > 2 ? ", …" : "";
+  return `${members.length} updates · ${preview}${suffix}`;
+}
+
+/** Strip protocol prefixes and worker/session UUIDs from display summaries. */
+export function cleanMachineInputSummary(summary: string): string {
+  return summary
+    .replace(/^\[[A-Z][A-Z _-]*(?:\s+\d+\/\d+)?\]\s*/, "")
+    .replace(/\bWorker session id:\s*[0-9a-f]{8}-[0-9a-f-]{27,}\b/gi, "")
+    .replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, "")
+    .replace(/\(\s*\)/g, "")
+    .replace(/\s*[·|]\s*$/g, "")
+    .replace(/\s{2,}/g, " ")
+    .replace(/\s+([.,;:])/g, "$1")
+    .trim();
+}
+
+export function readableMachineInputSource(sourceId: string): string | null {
+  const value = sourceId.trim();
+  if (!value || /^[0-9a-f]{8}-[0-9a-f-]{27,}$/i.test(value)) return null;
+  if (/^(goal|schedule|system):/i.test(value)) return null;
+  return value.replaceAll("_", " ");
+}
+
+/** True when a cleaned single-member summary adds meaning beyond the pill label. */
+export function machineInputSummaryIsUseful(
+  kind: MachineInputMember["kind"],
+  cleanedSummary: string,
+): boolean {
+  if (!cleanedSummary) return false;
+  const label = MACHINE_INPUT_META[kind].toLowerCase();
+  const text = cleanedSummary.toLowerCase();
+  if (text === label || text === `${label}.`) return false;
+  // Generic child-finished boilerplate after UUID scrub is still noise.
+  if (
+    kind === "child_terminal_result" &&
+    /^a worker session you spawned has finished/i.test(cleanedSummary)
+  ) {
+    return false;
+  }
+  return true;
+}