fix(ui): external adapter selection, config field placement, and transcript parser freshness

- Fix external adapters (hermes, droid) not auto-selected when
  navigating with ?adapterType= param — was using a stale
  module-level Set built before async adapter registration
- Move SchemaConfigFields to render after thinking effort (same
  visual area as Claude's chrome toggle) instead of bottom of
  config section
- Extract SelectField into its own component to fix React hooks
  order violation when schema fields change between renders
- Add onAdapterChange() subscription in registry.ts so
  registerUIAdapter() notifies components when dynamic parsers
  load, fixing stale parser for old runs
- Add parserTick to both RunTranscriptView and
  useLiveRunTranscripts to force recomputation on parser change
This commit is contained in:
HenkDz 2026-04-01 21:56:19 +01:00
parent 69a1593ff8
commit 47f3cdc1bb
13 changed files with 473 additions and 55 deletions

View file

@ -5,6 +5,7 @@ export {
registerUIAdapter,
unregisterUIAdapter,
syncExternalAdapters,
onAdapterChange,
} from "./registry";
export { buildTranscript } from "./transcript";
export type {

View file

@ -26,6 +26,18 @@ export function listKnownAdapterTypes(): string[] {
* Unknown types (external adapters) are always considered enabled.
*/
export function isEnabledAdapterType(type: string): boolean {
// Known external adapter — always valid
if (listUIAdapters().some((a) => a.type === type)) return true;
return !getAdapterDisplay(type).comingSoon;
}
/**
* Check whether an adapter type is a valid choice for new agent creation.
* Includes all registered UI adapters (built-in + external) and
* any non-"coming soon" adapter from the display registry.
*/
export function isValidAdapterType(type: string): boolean {
if (listUIAdapters().some((a) => a.type === type)) return true;
return !getAdapterDisplay(type).comingSoon;
}

View file

@ -15,6 +15,20 @@ import { SchemaConfigFields, buildSchemaAdapterConfig } from "./schema-config-fi
const uiAdapters: UIAdapterModule[] = [];
const adaptersByType = new Map<string, UIAdapterModule>();
// Subscriber list — components can register to be notified when adapters change
// (e.g., when a dynamic parser replaces a placeholder).
const adapterChangeListeners = new Set<() => void>();
/** Subscribe to adapter registry changes. Returns unsubscribe function. */
export function onAdapterChange(fn: () => void): () => void {
adapterChangeListeners.add(fn);
return () => adapterChangeListeners.delete(fn);
}
function notifyAdapterChange(): void {
for (const fn of adapterChangeListeners) fn();
}
function registerBuiltInUIAdapters() {
for (const adapter of [
claudeLocalUIAdapter,
@ -40,6 +54,7 @@ export function registerUIAdapter(adapter: UIAdapterModule): void {
uiAdapters.push(adapter);
}
adaptersByType.set(adapter.type, adapter);
notifyAdapterChange();
}
export function unregisterUIAdapter(type: string): void {

View file

@ -1,4 +1,4 @@
import { useState, useEffect } from "react";
import { useState, useEffect, useRef, useCallback } from "react";
import type { AdapterConfigSchema, ConfigFieldSchema, CreateConfigValues } from "@paperclipai/adapter-utils";
@ -10,15 +10,197 @@ import {
DraftTextarea,
ToggleField,
} from "../components/agent-config-primitives";
import { Popover, PopoverContent, PopoverTrigger } from "../components/ui/popover";
import { ChevronDown } from "lucide-react";
// ── Select field (extracted to keep hooks at component top level) ──────
function SelectField({
value,
options,
onChange,
}: {
value: string;
options: Array<{ value: string; label: string }>;
onChange: (value: string) => void;
}) {
const [open, setOpen] = useState(false);
const selectedOpt = options.find((o) => o.value === value);
return (
<Popover open={open} onOpenChange={setOpen}>
<PopoverTrigger asChild>
<button className="inline-flex items-center gap-1.5 rounded-md border border-border px-2.5 py-1.5 text-sm hover:bg-accent/50 transition-colors w-full justify-between">
<span className={!value ? "text-muted-foreground" : ""}>
{selectedOpt?.label ?? value ?? "Select..."}
</span>
<ChevronDown className="h-3 w-3 text-muted-foreground" />
</button>
</PopoverTrigger>
<PopoverContent className="w-[var(--radix-popover-trigger-width)] p-1" align="start">
{options.map((opt) => (
<button
key={opt.value}
className={`flex items-center w-full px-2 py-1.5 text-sm rounded hover:bg-accent/50 ${opt.value === value ? "bg-accent" : ""}`}
onMouseDown={(e) => {
e.preventDefault();
onChange(opt.value);
setOpen(false);
}}
>
<span>{opt.label}</span>
</button>
))}
</PopoverContent>
</Popover>
);
}
const inputClass =
"w-full rounded-md border border-border px-2.5 py-1.5 bg-transparent outline-none text-sm font-mono placeholder:text-muted-foreground/40";
const selectClass =
"w-full rounded-md border border-border px-2.5 py-1.5 bg-transparent outline-none text-sm font-mono";
// ---------------------------------------------------------------------------
// Schema cache (module-level, survives re-renders)
// Combobox: type-to-filter dropdown with free text fallback
// ---------------------------------------------------------------------------
function ComboboxField({
value,
options,
onChange,
placeholder,
}: {
value: string;
options: { label: string; value: string; group?: string }[];
onChange: (val: string) => void;
placeholder?: string;
}) {
const [open, setOpen] = useState(false);
const [filter, setFilter] = useState("");
const inputRef = useRef<HTMLInputElement>(null);
// Sync filter with external value when it changes (e.g. provider switch resets model)
useEffect(() => {
setFilter("");
}, [value]);
const filtered = options.filter((opt) => {
if (!filter) return true;
const q = filter.toLowerCase();
return (
opt.value.toLowerCase().includes(q) ||
opt.label.toLowerCase().includes(q) ||
(opt.group && opt.group.toLowerCase().includes(q))
);
});
const selectedOpt = options.find((o) => o.value === value);
const displayValue = filter || selectedOpt?.value || value || "";
// Group filtered options by `group` field if present
const grouped = new Map<string, typeof filtered>();
for (const opt of filtered) {
const g = opt.group ?? "";
if (!grouped.has(g)) grouped.set(g, []);
grouped.get(g)!.push(opt);
}
const select = useCallback(
(val: string) => {
onChange(val);
setOpen(false);
setFilter("");
inputRef.current?.blur();
},
[onChange],
);
const handleKeyDown = (e: React.KeyboardEvent) => {
if (e.key === "Enter") {
e.preventDefault();
// If exactly one match, select it. Otherwise commit the typed value.
if (filtered.length === 1) {
select(filtered[0].value);
} else if (filter) {
select(filter);
}
} else if (e.key === "Escape") {
setOpen(false);
setFilter("");
} else if (e.key === "ArrowDown" && !open) {
e.preventDefault();
setOpen(true);
}
};
return (
<div className="relative">
<div className="flex items-center gap-0">
<input
ref={inputRef}
type="text"
className="flex-1 rounded-l-md border border-r-0 border-border px-2.5 py-1.5 bg-transparent outline-none text-sm font-mono placeholder:text-muted-foreground/40 focus:z-10"
value={displayValue}
placeholder={placeholder ?? "Type or select..."}
onChange={(e) => {
setFilter(e.target.value);
if (!open) setOpen(true);
}}
onFocus={() => {
if (!open) setOpen(true);
}}
onBlur={() => {
// Delay close to allow click on option to register
setTimeout(() => setOpen(false), 150);
}}
onKeyDown={handleKeyDown}
/>
<Popover open={open && filtered.length > 0} onOpenChange={setOpen}>
<PopoverTrigger asChild>
<button className="rounded-r-md border border-border px-2 py-1.5 hover:bg-accent/50 transition-colors">
<ChevronDown className="h-3 w-3 text-muted-foreground" />
</button>
</PopoverTrigger>
<PopoverContent
className="p-1 max-h-60 overflow-y-auto"
style={{ minWidth: 280 }}
align="start"
onOpenAutoFocus={(e) => e.preventDefault()}
>
{Array.from(grouped.entries()).map(([group, opts]) => (
<div key={group || "_ungrouped"}>
{group && (
<div className="px-2 py-1 text-xs font-medium text-muted-foreground">
{group}
</div>
)}
{opts.map((opt) => (
<button
key={opt.value}
className={`flex items-center w-full px-2 py-1.5 text-sm rounded hover:bg-accent/50 ${
opt.value === value ? "bg-accent" : ""
}`}
onMouseDown={(e) => {
e.preventDefault(); // prevent input blur
select(opt.value);
}}
>
<span className="truncate">{opt.label}</span>
</button>
))}
</div>
))}
{filter && filtered.length === 0 && (
<div className="px-2 py-1.5 text-sm text-muted-foreground">
Use &quot;{filter}&quot; as custom value (press Enter)
</div>
)}
</PopoverContent>
</Popover>
</div>
</div>
);
}
// ---------------------------------------------------------------------------
// SchemaConfigFields component
// ---------------------------------------------------------------------------
const schemaCache = new Map<string, AdapterConfigSchema | null>();
@ -146,14 +328,42 @@ export function SchemaConfigFields({
function writeValue(field: ConfigFieldSchema, value: unknown): void {
if (isCreate) {
set?.({
const next = {
adapterSchemaValues: {
...values?.adapterSchemaValues,
[field.key]: value,
},
});
};
// When provider changes, auto-clear model if it's not in the new provider's list
if (field.key === "provider" && schema) {
const modelField = schema.fields.find((f) => f.key === "model");
if (modelField?.meta?.providerModels) {
const modelsByProvider = modelField.meta.providerModels as Record<string, string[]>;
const providerModels = modelsByProvider[String(value)] ?? [];
const currentModel = values?.adapterSchemaValues?.model;
if (currentModel && String(value) !== "auto" && !providerModels.includes(String(currentModel))) {
next.adapterSchemaValues.model = "";
}
}
}
set?.(next);
} else {
mark("adapterConfig", field.key, value);
// Same logic for edit mode
if (field.key === "provider" && schema) {
const modelField = schema.fields.find((f) => f.key === "model");
if (modelField?.meta?.providerModels) {
const modelsByProvider = modelField.meta.providerModels as Record<string, string[]>;
const providerModels = modelsByProvider[String(value)] ?? [];
const currentModel = eff("adapterConfig", "model", "");
if (currentModel && String(value) !== "auto" && !providerModels.includes(String(currentModel))) {
mark("adapterConfig", "model", "");
}
}
}
}
}
@ -161,22 +371,18 @@ export function SchemaConfigFields({
<>
{schema.fields.map((field) => {
switch (field.type) {
case "select":
case "select": {
const currentVal = String(readValue(field) ?? "");
return (
<Field key={field.key} label={field.label} hint={field.hint}>
<select
className={selectClass}
value={String(readValue(field) ?? "")}
onChange={(e) => writeValue(field, e.target.value)}
>
{field.options?.map((opt) => (
<option key={opt.value} value={opt.value}>
{opt.label}
</option>
))}
</select>
<SelectField
value={currentVal}
options={field.options ?? []}
onChange={(v) => writeValue(field, v)}
/>
</Field>
);
}
case "toggle":
return (
@ -212,6 +418,48 @@ export function SchemaConfigFields({
</Field>
);
case "combobox": {
const currentVal = String(readValue(field) ?? "");
// Dynamic options: if meta.providerModels exists, compute options
// based on the current provider value
let comboboxOptions = field.options ?? [];
if (field.meta?.providerModels) {
const providerVal = String(readValue(schema.fields.find((f) => f.key === "provider")!) ?? "auto");
const modelsByProvider = field.meta.providerModels as Record<string, string[]>;
if (providerVal === "auto") {
// Auto: show all models from all providers, grouped by provider
const providerLabel = schema.fields.find((f) => f.key === "provider");
const providerOptions = providerLabel?.options ?? [];
comboboxOptions = Object.entries(modelsByProvider).flatMap(([prov, models]) =>
models.map((m) => ({
label: m,
value: m,
group: providerOptions.find((p) => p.value === prov)?.label ?? prov,
})),
);
} else {
const providerModels = modelsByProvider[providerVal] ?? [];
const providerLabel = schema.fields.find((f) => f.key === "provider");
const provName = providerLabel?.options?.find((p) => p.value === providerVal)?.label ?? providerVal;
comboboxOptions = providerModels.map((m) => ({
label: m,
value: m,
group: provName,
}));
}
}
return (
<Field key={field.key} label={field.label} hint={field.hint}>
<ComboboxField
value={currentVal}
options={comboboxOptions}
onChange={(v) => writeValue(field, v || undefined)}
placeholder={field.hint}
/>
</Field>
);
}
case "text":
default:
return (