ei-tui 0.6.0 → 0.6.1

package/tui/src/util/yaml-serializers.ts

@@ -1,1510 +1,9 @@
-import YAML from "yaml";
-import type {
-  PersonaEntity,
-  HumanEntity,
-  HumanSettings,
-  CeremonyConfig,
-  OpenCodeSettings,
-  BackupConfig,
-  Fact,
-  PersonaTrait,
-  Topic,
-  Person,
-  PersonIdentifier,
-  PersonaTopic,
-  ProviderAccount,
-  ProviderType,
-  Quote,
-  Message,
-  LLMRequest,
-  LLMRequestState,
-  LLMPriority,
-  ToolProvider,
-  ToolDefinition,
-  } from "../../../src/core/types.js";
-import { ContextStatus } from "../../../src/core/types.js";
-import type { ClaudeCodeSettings } from "../../../src/integrations/claude-code/types.js";
-import type { CursorSettings } from "../../../src/integrations/cursor/types.js";
-import { BUILT_IN_FACT_NAMES } from "../../../src/core/constants/built-in-facts.js";
-import { BUILT_IN_IDENTIFIER_TYPES } from "../../../src/core/constants/built-in-identifier-types.js";
-
-// =============================================================================
-// TYPES FOR YAML EDITING
-// =============================================================================
-
-interface EditableTopic extends Omit<Topic, 'persona_groups'> {
-  _delete?: boolean;
-  persona_groups?: Record<string, boolean>[];
-}
-
-interface EditableFact extends Omit<Fact, 'persona_groups'> {
-  _delete?: boolean;
-  persona_groups?: Record<string, boolean>[];
-}
-
-interface YAMLPersonIdentifier {
-  type: string;
-  value: string;
-  primary?: true;
-}
-
-interface EditablePersonYAML extends Omit<Person, 'identifiers' | 'persona_groups'> {
-  identifiers: YAMLPersonIdentifier[];
-  _delete?: boolean;
-  persona_groups?: Record<string, boolean>[];
-}
-
-interface EditablePersonaData {
-  display_name?: string;
-  aliases?: string[];
-  short_description?: string;
-  long_description?: string;
-  model?: string | null;
-  group_primary?: string | null;
-  groups_visible?: Record<string, boolean>[];
-  traits: YAMLTrait[];
-  topics: YAMLPersonaTopic[];
-  heartbeat_delay_ms?: string | number;
-  context_window_hours?: number;
-  is_paused?: boolean;
-  pause_until?: string;
-  is_static?: boolean;
-  include_message_timestamps?: boolean;
-  tools?: Record<string, Record<string, boolean>>;
-}
-
-interface EditableHumanData {
-  facts: EditableFact[];
-  topics: EditableTopic[];
-  people: EditablePersonYAML[];
-}
-
-// =============================================================================
-// PLACEHOLDER MARKERS (stripped on parse if unchanged)
-// =============================================================================
-
-const PLACEHOLDER_LONG_DESC = "Detailed description of this persona's personality, background, and role";
-
-// Placeholder types without id/_delete - these are for YAML display only
-interface YAMLTrait {
-  name: string;
-  description: string;
-  sentiment: number;
-  strength: number;
-}
-
-interface YAMLPersonaTopic {
-  name: string;
-  perspective: string;
-  approach: string;
-  personal_stake: string;
-  exposure_current: number;
-  exposure_desired: number;
-}
-
-const PLACEHOLDER_TRAIT: YAMLTrait = {
-  name: "Example Trait",
-  description: "Delete this placeholder or modify it to define a real trait",
-  sentiment: 0,
-  strength: 0.5,
-};
-const PLACEHOLDER_TOPIC: YAMLPersonaTopic = {
-  name: "Example Topic",
-  perspective: "How this persona views or thinks about this topic",
-  approach: "How this persona prefers to engage with this topic",
-  personal_stake: "Why this topic matters to this persona personally",
-  exposure_current: 0.5,
-  exposure_desired: 0.5,
-};
-
-// =============================================================================
-// TOOL MAP HELPERS (for persona YAML — human-readable grouped tool toggles)
-// =============================================================================
-
-/**
- * Build the nested tools map for YAML: { providerDisplayName: { toolDisplayName: bool } }
- * enabledToolIds = persona.tools (array of ToolDefinition IDs)
- */
-function buildPersonaToolsMap(
-  enabledToolIds: string[],
-  allTools: ToolDefinition[],
-  allProviders: import('../../../src/core/types.js').ToolProvider[]
-): Record<string, Record<string, boolean>> | undefined {
-  if (allTools.length === 0) return undefined;
-  const enabledSet = new Set(enabledToolIds);
-  const result: Record<string, Record<string, boolean>> = {};
-  for (const provider of allProviders.filter(p => p.enabled)) {
-    const providerTools = allTools.filter(t => t.provider_id === provider.id);
-    if (providerTools.length === 0) continue;
-    result[provider.display_name] = Object.fromEntries(
-      providerTools.map(t => [t.display_name, enabledSet.has(t.id)])
-    );
-  }
-  return Object.keys(result).length > 0 ? result : undefined;
-}
-
-/**
- * Flatten the nested tools map back to an array of ToolDefinition IDs.
- * toolsMap keys are provider display names; inner keys are tool display names.
- */
-function resolvePersonaToolsFromMap(
-  toolsMap: Record<string, Record<string, boolean>> | undefined,
-  allTools: ToolDefinition[],
-  allProviders: import('../../../src/core/types.js').ToolProvider[]
-): string[] | undefined {
-  if (!toolsMap) return undefined;
-  const enabledIds: string[] = [];
-  for (const [providerDisplayName, toolToggles] of Object.entries(toolsMap)) {
-    const provider = allProviders.find(p => p.display_name === providerDisplayName);
-    if (!provider) continue;
-    for (const [toolDisplayName, enabled] of Object.entries(toolToggles)) {
-      if (!enabled) continue;
-      const tool = allTools.find(t => t.provider_id === provider.id && t.display_name === toolDisplayName);
-      if (tool) enabledIds.push(tool.id);
-    }
-  }
-  return enabledIds.length > 0 ? enabledIds : [];
-}
-
-// =============================================================================
-// PERSONA SERIALIZATION
-// =============================================================================
-
-/**
- * Generate YAML skeleton for a NEW persona (doesn't exist yet)
- */
-export function newPersonaToYAML(name: string, allTools?: ToolDefinition[], allProviders?: import('../../../src/core/types.js').ToolProvider[]): string {
-  const toolsMap = buildPersonaToolsMap([], allTools ?? [], allProviders ?? []);
-
-  const data: EditablePersonaData = {
-    display_name: name,
-    long_description: PLACEHOLDER_LONG_DESC,
-    model: undefined,
-    group_primary: "General",
-    groups_visible: [{ General: true }],
-    traits: [PLACEHOLDER_TRAIT],
-    topics: [PLACEHOLDER_TOPIC],
-    tools: toolsMap,
-  };
-  
-  return YAML.stringify(data, { 
-    lineWidth: 0,
-  });
-}
-
-/**
- * Parse YAML for a NEW persona (creates PersonaEntity from scratch)
- */
-export function newPersonaFromYAML(yamlContent: string, allTools?: ToolDefinition[], allProviders?: import('../../../src/core/types.js').ToolProvider[]): Partial<PersonaEntity> {
-  const data = YAML.parse(yamlContent) as EditablePersonaData;
-  
-  const isTraitPlaceholder = (t: YAMLTrait) => 
-    t.name === PLACEHOLDER_TRAIT.name && 
-    t.description === PLACEHOLDER_TRAIT.description;
-
-  const traits: PersonaTrait[] = [];
-  for (const t of data.traits ?? []) {
-    if (isTraitPlaceholder(t)) {
-      continue;
-    }
-    traits.push({
-      id: crypto.randomUUID(),
-      name: t.name,
-      description: t.description,
-      sentiment: t.sentiment ?? 0,
-      strength: t.strength,
-      last_updated: new Date().toISOString(),
-    });
-  }
-  
-  const isTopicPlaceholder = (t: YAMLPersonaTopic) => 
-    t.name === PLACEHOLDER_TOPIC.name && 
-    t.perspective === PLACEHOLDER_TOPIC.perspective;
-
-  const topics: PersonaTopic[] = [];
-  for (const t of data.topics ?? []) {
-    if (isTopicPlaceholder(t)) {
-      continue;
-    }
-    topics.push({
-      id: crypto.randomUUID(),
-      name: t.name,
-      perspective: t.perspective,
-      approach: t.approach,
-      personal_stake: t.personal_stake,
-      sentiment: 0,
-      exposure_current: t.exposure_current,
-      exposure_desired: t.exposure_desired,
-      last_updated: new Date().toISOString(),
-    });
-  }
-  
-  const stripPlaceholder = (value: string | undefined, placeholder: string): string | undefined => {
-    return value === placeholder ? undefined : value;
-  };
-  
-  // Convert Record<string, boolean>[] to string[] - only include groups with true value
-  const groupsVisible: string[] = [];
-  for (const groupRecord of data.groups_visible ?? []) {
-    for (const [groupName, isVisible] of Object.entries(groupRecord)) {
-      if (isVisible) {
-        groupsVisible.push(groupName);
-      }
-    }
-  }
-  
-  return {
-    long_description: stripPlaceholder(data.long_description, PLACEHOLDER_LONG_DESC),
-    model: data.model ?? undefined,
-    group_primary: data.group_primary ?? "General",
-    groups_visible: groupsVisible.length > 0 ? groupsVisible : ["General"],
-    traits,
-    topics,
-    heartbeat_delay_ms: data.heartbeat_delay_ms,
-    context_window_hours: data.context_window_hours,
-    tools: resolvePersonaToolsFromMap(data.tools, allTools ?? [], allProviders ?? []),
-  };
-}
-
-export function personaToYAML(persona: PersonaEntity, allGroups?: string[], allTools?: ToolDefinition[], allProviders?: import('../../../src/core/types.js').ToolProvider[], accounts?: ProviderAccount[]): string {
-  const useTraitPlaceholder = persona.traits.length === 0;
-  const useTopicPlaceholder = persona.topics.length === 0;
-  
-  const groupsForYAML: Record<string, boolean>[] = [];
-  const visibleSet = new Set(persona.groups_visible ?? []);
-  const groupsToShow = allGroups ?? persona.groups_visible ?? [];
-  for (const groupName of groupsToShow) {
-    groupsForYAML.push({ [groupName]: visibleSet.has(groupName) });
-  }
-
-  const toolsMap = buildPersonaToolsMap(persona.tools ?? [], allTools ?? [], allProviders ?? []);
-
-  const modelDisplay = (persona.model && accounts && accounts.length > 0)
-    ? modelGuidToDisplay(persona.model, accounts)
-    : persona.model;
-  
-  const data: EditablePersonaData = {
-    display_name: persona.display_name,
-    aliases: persona.aliases,
-    short_description: persona.short_description,
-    long_description: persona.long_description || PLACEHOLDER_LONG_DESC,
-    model: modelDisplay ?? null,
-    group_primary: persona.group_primary,
-    groups_visible: groupsForYAML,
-    traits: useTraitPlaceholder 
-      ? [PLACEHOLDER_TRAIT]
-      : persona.traits.map(({ name, description, sentiment, strength }) => ({ name, description, sentiment: sentiment ?? 0, strength: strength ?? 0.5 })),
-    topics: useTopicPlaceholder
-      ? [PLACEHOLDER_TOPIC]
-      : persona.topics.map(({ name, perspective, approach, personal_stake, exposure_current, exposure_desired }) => ({ 
-          name, perspective, approach, personal_stake, exposure_current, exposure_desired 
-        })),
-    heartbeat_delay_ms: persona.heartbeat_delay_ms || 'default',
-    context_window_hours: persona.context_window_hours,
-    is_paused: persona.is_paused || undefined,
-    pause_until: persona.pause_until,
-    is_static: persona.is_static || undefined,
-    include_message_timestamps: persona.include_message_timestamps || undefined,
-    tools: toolsMap,
-  };
-  
-  return YAML.stringify(data, { 
-    lineWidth: 0,
-  });
-}
-
-export interface PersonaYAMLResult {
-  updates: Partial<PersonaEntity>;
-  deletedTraitIds: string[];
-  deletedTopicIds: string[];
-}
-
-export function personaFromYAML(yamlContent: string, original: PersonaEntity, allTools?: ToolDefinition[], allProviders?: import('../../../src/core/types.js').ToolProvider[], accounts?: ProviderAccount[]): PersonaYAMLResult {
-  const data = YAML.parse(yamlContent) as EditablePersonaData;
-  
-  const deletedTraitIds: string[] = [];
-  const deletedTopicIds: string[] = [];
-  
-  const isTraitPlaceholder = (t: YAMLTrait) => 
-    t.name === PLACEHOLDER_TRAIT.name && 
-    t.description === PLACEHOLDER_TRAIT.description;
-
-  const traits: PersonaTrait[] = [];
-  for (const t of data.traits ?? []) {
-    if (isTraitPlaceholder(t)) {
-      continue;
-    }
-    const existing = original.traits.find(orig => orig.name === t.name);
-    traits.push({
-      id: existing?.id ?? crypto.randomUUID(),
-      name: t.name,
-      description: t.description,
-      sentiment: t.sentiment ?? existing?.sentiment ?? 0,
-      strength: t.strength,
-      last_updated: new Date().toISOString(),
-    });
-  }
-  
-  for (const orig of original.traits) {
-    if (!traits.some(t => t.id === orig.id)) {
-      deletedTraitIds.push(orig.id);
-    }
-  }
-  
-  const isTopicPlaceholder = (t: YAMLPersonaTopic) => 
-    t.name === PLACEHOLDER_TOPIC.name && 
-    t.perspective === PLACEHOLDER_TOPIC.perspective;
-
-  const topics: PersonaTopic[] = [];
-  for (const t of data.topics ?? []) {
-    if (isTopicPlaceholder(t)) {
-      continue;
-    }
-    const existing = original.topics.find(orig => orig.name === t.name);
-    topics.push({
-      id: existing?.id ?? crypto.randomUUID(),
-      name: t.name,
-      perspective: t.perspective,
-      approach: t.approach,
-      personal_stake: t.personal_stake,
-      sentiment: existing?.sentiment ?? 0,
-      exposure_current: t.exposure_current,
-      exposure_desired: t.exposure_desired,
-      last_updated: new Date().toISOString(),
-    });
-  }
-  
-  for (const orig of original.topics) {
-    if (!topics.some(t => t.id === orig.id)) {
-      deletedTopicIds.push(orig.id);
-    }
-  }
-  
-  const stripPlaceholder = (value: string | undefined, placeholder: string): string | undefined => {
-    return value === placeholder ? undefined : value;
-  };
-  
-  const groupsVisible: string[] = [];
-  for (const groupRecord of data.groups_visible ?? []) {
-    for (const [groupName, isVisible] of Object.entries(groupRecord)) {
-      if (isVisible) {
-        groupsVisible.push(groupName);
-      }
-    }
-  }
-
-  let resolvedModel: string | undefined = data.model ?? undefined;
-  if (data.model && accounts && accounts.length > 0) {
-    const guid = displayToModelGuid(data.model, accounts);
-    if (guid !== undefined) {
-      resolvedModel = guid;
-    } else if (data.model.includes(':')) {
-      throw new Error(`Model "${data.model}" not found. Use "ProviderName:modelName" format with a valid provider and model.`);
-    }
-  }
-  
-  const updates: Partial<PersonaEntity> = {
-    display_name: data.display_name,
-    aliases: data.aliases,
-    short_description: data.short_description,
-    long_description: stripPlaceholder(data.long_description, PLACEHOLDER_LONG_DESC),
-    model: resolvedModel,
-    group_primary: data.group_primary,
-    groups_visible: groupsVisible,
-    traits,
-    topics,
-    heartbeat_delay_ms: stripPlaceholder(data.heartbeat_delay_ms as string | undefined, 'default'),
-    context_window_hours: data.context_window_hours,
-    is_paused: data.is_paused ?? false,
-    pause_until: data.pause_until,
-    is_static: data.is_static ?? false,
-    include_message_timestamps: data.include_message_timestamps ?? false,
-    tools: resolvePersonaToolsFromMap(data.tools, allTools ?? [], allProviders ?? []),
-    last_updated: new Date().toISOString(),
-  };
-  
-  return { updates, deletedTraitIds, deletedTopicIds };
-}
-
-// =============================================================================
-// HUMAN SERIALIZATION
-// =============================================================================
-
-function toYAMLIdentifiers(identifiers: PersonIdentifier[], personaLookup?: Map<string, string>): YAMLPersonIdentifier[] {
-  return identifiers.map(({ type, value, is_primary }) => {
-    const resolvedValue = type === 'Ei Persona' ? (personaLookup?.get(value) ?? value) : value;
-    const entry: YAMLPersonIdentifier = { type, value: resolvedValue };
-    if (is_primary) entry.primary = true;
-    return entry;
-  });
-}
-
-function knownTypesComment(personaLookup?: Map<string, string>): string {
-  const lines = [`# Valid types: ${BUILT_IN_IDENTIFIER_TYPES.join(', ')}`];
-  if (personaLookup && personaLookup.size > 0) {
-    lines.push(`# Personas: ${Array.from(personaLookup.values()).join(', ')}`);
-  }
-  return lines.join('\n');
-}
-
-type WithReadOnlyFields = {
-  learned_on?: string;
-  learned_by?: string;
-  last_updated: string;
-  last_changed_by?: string;
-  last_mentioned?: string;
-};
-
-function readOnlyToEnd<T extends WithReadOnlyFields>(item: T): T {
-  const { learned_on, learned_by, last_updated, last_changed_by, last_mentioned, ...rest } = item;
-  return { ...rest, learned_by, learned_on, last_changed_by, last_updated, last_mentioned } as T;
-}
-
-function buildGroupCheckboxMap(itemGroups: string[], allGroups: string[]): Record<string, boolean>[] {
-  const activeSet = new Set(itemGroups);
-  return [...new Set([...allGroups, ...itemGroups])].map(g => ({ [g]: activeSet.has(g) }));
-}
-
-export function humanToYAML(human: HumanEntity, personaLookup?: Map<string, string>, allGroups: string[] = []): string {
-  const data: EditableHumanData = {
-    facts: human.facts.map(f => { const { interested_personas: _ip, persona_groups, ...rest } = readOnlyToEnd(f); return { ...rest, persona_groups: buildGroupCheckboxMap(persona_groups ?? [], allGroups), _delete: false }; }),
-    topics: human.topics.map(t => { const { interested_personas: _ip, persona_groups, ...rest } = readOnlyToEnd(t); return { ...rest, persona_groups: buildGroupCheckboxMap(persona_groups ?? [], allGroups), _delete: false }; }),
-    people: human.people.map(p => {
-      const { identifiers, interested_personas: _ip, persona_groups, ...rest } = readOnlyToEnd(p);
-      return {
-        ...rest,
-        persona_groups: buildGroupCheckboxMap(persona_groups ?? [], allGroups),
-        identifiers: toYAMLIdentifiers(identifiers ?? [], personaLookup),
-        _delete: false as const,
-      };
-    }),
-  };
-  
-  const personComment = knownTypesComment(personaLookup);
-
-  return YAML.stringify(data, {
-    lineWidth: 0,
-  })
-  .replace(/^(\s+)(learned_by: )(.+)$/mg, (_, indent, key, val) => {
-    const trimmed = val.trim();
-    const displayName = personaLookup?.get(trimmed) ?? trimmed;
-    return `${indent}# [read-only] ${key}${displayName}`;
-  })
-  .replace(/^(\s+)(last_changed_by: )(.+)$/mg, (_, indent, key, val) => {
-    const trimmed = val.trim();
-    const displayName = personaLookup?.get(trimmed) ?? trimmed;
-    return `${indent}# [read-only] ${key}${displayName}`;
-  })
-  .replace(/^(\s+)(learned_on: .+)$/mg, '$1# [read-only] $2')
-  .replace(/^(\s+)(last_mentioned: .+)$/mg, '$1# [read-only] $2')
-  .replace(/^(\s+)(last_updated: .+)$/mg, '$1# [read-only] $2')
-  .replace(/^(\s+)(identifiers:)/mg, (_, indent, _key) => {
-    return `${indent}${personComment}\n${indent}identifiers:`;
-  });
-}
-
-export interface HumanYAMLResult {
-  facts: Fact[];
-  topics: Topic[];
-  people: Person[];
-  deletedFactIds: string[];
-  deletedTopicIds: string[];
-  deletedPersonIds: string[];
-}
-
-function parseGroupCheckboxMap(groups: Record<string, boolean>[] | undefined): string[] {
-  if (!groups) return [];
-  const result: string[] = [];
-  for (const record of groups) {
-    for (const [name, active] of Object.entries(record)) {
-      if (active) result.push(name);
-    }
-  }
-  return result;
-}
-
-export function humanFromYAML(yamlContent: string, original?: HumanEntity): HumanYAMLResult {
-  const stripped = yamlContent
-    .split('\n')
-    .filter(line => !/^\s*#\s*\[read-only\]/.test(line))
-    .join('\n');
-  const data = YAML.parse(stripped) as EditableHumanData;
-  
-  const deletedFactIds: string[] = [];
-  const deletedTopicIds: string[] = [];
-  const deletedPersonIds: string[] = [];
-  
-  const facts: Fact[] = [];
-  for (const f of data.facts ?? []) {
-    if (f._delete && !BUILT_IN_FACT_NAMES.has(f.name)) {
-      deletedFactIds.push(f.id);
-    } else {
-      const { _delete, persona_groups: groupMap, ...parsed } = f;
-      const originalFact = original?.facts.find(of => of.id === parsed.id);
-      const fact: Fact = originalFact
-        ? { ...originalFact, ...parsed, persona_groups: parseGroupCheckboxMap(groupMap) }
-        : { ...parsed, persona_groups: parseGroupCheckboxMap(groupMap) };
-      if (fact.description && !fact.validated_date) {
-        fact.validated_date = new Date().toISOString();
-      }
-      facts.push(fact);
-    }
-  }
-  
-  const topics: Topic[] = [];
-  for (const t of data.topics ?? []) {
-    if (t._delete) {
-      deletedTopicIds.push(t.id);
-    } else {
-      const { _delete, persona_groups: groupMap, ...parsed } = t;
-      const originalTopic = original?.topics.find(ot => ot.id === parsed.id);
-      const topic: Topic = originalTopic
-        ? { ...originalTopic, ...parsed, persona_groups: parseGroupCheckboxMap(groupMap) }
-        : { ...parsed, persona_groups: parseGroupCheckboxMap(groupMap) };
-      topics.push(topic);
-    }
-  }
-  
-  const people: Person[] = [];
-  for (const p of data.people ?? []) {
-    if (p._delete) {
-      deletedPersonIds.push(p.id);
-    } else {
-      const { _delete, identifiers: yamlIdentifiers, persona_groups: groupMap, ...parsed } = p;
-      const identifiers: PersonIdentifier[] = (yamlIdentifiers ?? []).map(({ type, value, primary }) => ({
-        type,
-        value,
-        ...(primary ? { is_primary: true } : {}),
-      }));
-      const originalPerson = original?.people.find(op => op.id === parsed.id);
-      const personBase: Person = originalPerson
-        ? { ...originalPerson, ...parsed, identifiers, persona_groups: parseGroupCheckboxMap(groupMap) }
-        : { ...parsed, identifiers, persona_groups: parseGroupCheckboxMap(groupMap) };
-      const person: Person = !personBase.validated_date
-        ? { ...personBase, validated_date: new Date().toISOString() }
-        : personBase;
-      people.push(person);
-    }
-  }
-  
-  return {
-    facts,
-    topics,
-    people,
-    deletedFactIds,
-    deletedTopicIds,
-    deletedPersonIds,
-  };
-}
-
-// =============================================================================
-// SETTINGS SERIALIZATION
-// =============================================================================
-
-interface EditableSettingsData {
-  default_model?: string | null;
-  oneshot_model?: string | null;
-  rewrite_model?: string | null;
-  time_mode?: "24h" | "12h" | "local" | "utc" | null;
-  name_display?: string | null;
-  default_heartbeat_ms?: number | null;
-  default_context_window_hours?: number | null;
-  message_min_count?: number | null;
-  message_max_age_days?: number | null;
-  ceremony?: {
-    time: string;
-    decay_rate?: number | null;
-    explore_threshold?: number | null;
-    dedup_threshold?: number | null;
-    event_window_hours?: number | null;
-  };
-  opencode?: {
-    integration?: boolean | null;
-    polling_interval_ms?: number | null;
-    last_sync?: string | null;
-    extraction_point?: string | null;
-    extraction_model?: string | null;
-  };
-  claudeCode?: {
-    integration?: boolean | null;
-    polling_interval_ms?: number | null;
-    last_sync?: string | null;
-    extraction_point?: string | null;
-    extraction_model?: string | null;
-  };
-  cursor?: {
-    integration?: boolean | null;
-    polling_interval_ms?: number | null;
-    last_sync?: string | null;
-    extraction_point?: string | null;
-  };
-  backup?: {
-    enabled?: boolean | null;
-    max_backups?: number | null;
-    interval_ms?: number | null;
-  };
-}
-
-export function settingsToYAML(settings: HumanSettings | undefined, accounts: ProviderAccount[]): string {
-  const guidToDisplay = (guid: string | undefined | null): string | null => {
-    if (!guid) return null;
-    return modelGuidToDisplay(guid, accounts);
-  };
-
-  // Always show all editable fields, using null for unset values so YAML displays them
-  const data: EditableSettingsData = {
-    default_model: guidToDisplay(settings?.default_model),
-    oneshot_model: guidToDisplay(settings?.oneshot_model),
-    rewrite_model: guidToDisplay(settings?.rewrite_model),
-    time_mode: settings?.time_mode ?? null,
-    name_display: settings?.name_display ?? null,
-    default_heartbeat_ms: settings?.default_heartbeat_ms ?? 1800000,
-    default_context_window_hours: settings?.default_context_window_hours ?? 8,
-    message_min_count: settings?.message_min_count ?? 200,
-    message_max_age_days: settings?.message_max_age_days ?? 14,
-    ceremony: {
-      time: settings?.ceremony?.time ?? "09:00",
-      decay_rate: settings?.ceremony?.decay_rate ?? null,
-      explore_threshold: settings?.ceremony?.explore_threshold ?? null,
-      dedup_threshold: settings?.ceremony?.dedup_threshold ?? null,
-      event_window_hours: settings?.ceremony?.event_window_hours ?? null,
-    },
-    opencode: {
-      integration: settings?.opencode?.integration ?? false,
-      polling_interval_ms: settings?.opencode?.polling_interval_ms ?? 60000,
-      extraction_model: guidToDisplay(settings?.opencode?.extraction_model) ?? 'default',
-      last_sync: settings?.opencode?.last_sync ?? null,
-      extraction_point: settings?.opencode?.extraction_point ?? null,
-    },
-    claudeCode: {
-      integration: settings?.claudeCode?.integration ?? false,
-      polling_interval_ms: settings?.claudeCode?.polling_interval_ms ?? 60000,
-      extraction_model: guidToDisplay(settings?.claudeCode?.extraction_model) ?? 'default',
-      last_sync: settings?.claudeCode?.last_sync ?? null,
-      extraction_point: settings?.claudeCode?.extraction_point ?? null,
-    },
-    cursor: {
-      integration: settings?.cursor?.integration ?? false,
-      polling_interval_ms: settings?.cursor?.polling_interval_ms ?? 60000,
-      last_sync: settings?.cursor?.last_sync ?? null,
-      extraction_point: settings?.cursor?.extraction_point ?? null,
-    },
-    backup: {
-      enabled: settings?.backup?.enabled ?? false,
-      max_backups: settings?.backup?.max_backups ?? 24,
-      interval_ms: settings?.backup?.interval_ms ?? 3600000,
-    },
-  };
-  
-  return YAML.stringify(data, {
-    lineWidth: 0,
-  })
-  .replace(/^(\s+)(last_sync: .+)$/mg, '$1# [read-only] $2')
-  .replace(/^(\s+)(extraction_point: .+)$/mg, '$1# [read-only] $2')
-  .replace(/^(\s+)(extraction_model: .+)$/mg, '$1$2 # e.g. Anthropic:claude-haiku-4-5');
-}
-export function settingsFromYAML(yamlContent: string, original: HumanSettings | undefined, accounts: ProviderAccount[]): HumanSettings {
-  const data = YAML.parse(yamlContent) as EditableSettingsData;
-  
-  const nullToUndefined = <T>(value: T | null | undefined): T | undefined => 
-    value === null ? undefined : value;
-
-  const displayToGuid = (display: string | null | undefined): string | undefined => {
-    if (!display || display === 'default') return undefined;
-    return displayToModelGuid(display, accounts) ?? display;
-  };
-  
-  let ceremony: CeremonyConfig | undefined;
-  if (data.ceremony) {
-    ceremony = {
-      time: data.ceremony.time,
-      decay_rate: nullToUndefined(data.ceremony.decay_rate),
-      explore_threshold: nullToUndefined(data.ceremony.explore_threshold),
-      dedup_threshold: nullToUndefined(data.ceremony.dedup_threshold),
-      event_window_hours: nullToUndefined(data.ceremony.event_window_hours),
-      last_ceremony: original?.ceremony?.last_ceremony,
-    };
-  }
-  
-  let opencode: OpenCodeSettings | undefined;
-  if (data.opencode) {
-    opencode = {
-      integration: nullToUndefined(data.opencode.integration),
-      polling_interval_ms: nullToUndefined(data.opencode.polling_interval_ms),
-      last_sync: original?.opencode?.last_sync,
-      extraction_point: original?.opencode?.extraction_point,
-      processed_sessions: original?.opencode?.processed_sessions,
-      extraction_model: displayToGuid(data.opencode.extraction_model),
-    };
-  }
-
-  let claudeCode: ClaudeCodeSettings | undefined;
-  if (data.claudeCode) {
-    claudeCode = {
-      integration: nullToUndefined(data.claudeCode.integration),
-      polling_interval_ms: nullToUndefined(data.claudeCode.polling_interval_ms),
-      last_sync: original?.claudeCode?.last_sync,
-      extraction_point: original?.claudeCode?.extraction_point,
-      processed_sessions: original?.claudeCode?.processed_sessions,
-      extraction_model: displayToGuid(data.claudeCode.extraction_model),
-    };
-  }
-
-  let cursor: CursorSettings | undefined;
-  if (data.cursor) {
-    cursor = {
-      integration: nullToUndefined(data.cursor.integration),
-      polling_interval_ms: nullToUndefined(data.cursor.polling_interval_ms),
-      last_sync: original?.cursor?.last_sync,
-      extraction_point: original?.cursor?.extraction_point,
-      processed_sessions: original?.cursor?.processed_sessions,
-    };
-  }
-
-  let backup: BackupConfig | undefined;
-  if (data.backup) {
-    backup = {
-      enabled: nullToUndefined(data.backup.enabled),
-      max_backups: nullToUndefined(data.backup.max_backups),
-      interval_ms: nullToUndefined(data.backup.interval_ms),
-      last_backup: original?.backup?.last_backup,
-    };
-  }
-  
-  return {
-    ...original,
-    default_model: displayToGuid(data.default_model),
-    oneshot_model: displayToGuid(data.oneshot_model),
-    rewrite_model: displayToGuid(data.rewrite_model),
-    time_mode: nullToUndefined(data.time_mode),
-    name_display: nullToUndefined(data.name_display),
-    default_heartbeat_ms: nullToUndefined(data.default_heartbeat_ms),
-    default_context_window_hours: nullToUndefined(data.default_context_window_hours),
-    message_min_count: nullToUndefined(data.message_min_count),
-    message_max_age_days: nullToUndefined(data.message_max_age_days),
-    ceremony,
-    opencode,
-    claudeCode,
-    cursor,
-    backup,
-  };
-}
-
-
-/**
- * Validate that a model spec (e.g. "Anthropic:sonnet") references a real provider.
- * Case-insensitive match — auto-corrects casing to the actual provider name.
- * Throws if no matching provider found (caller's catch triggers re-edit).
- */
-export function validateModelProvider(
-  modelSpec: string | undefined,
-  accounts: ProviderAccount[]
-): string | undefined {
-  if (!modelSpec) return undefined;
-  
-  const colonIdx = modelSpec.indexOf(":");
-  const providerPart = colonIdx >= 0 ? modelSpec.substring(0, colonIdx) : modelSpec;
-  const modelPart = colonIdx >= 0 ? modelSpec.substring(colonIdx + 1) : undefined;
-  
-  const match = accounts.find(a => a.name.toLowerCase() === providerPart.toLowerCase());
-  
-  if (!match) {
-    const available = accounts.map(a => a.name).join(", ");
-    throw new Error(
-      available
-        ? `No provider named "${providerPart}". Available: ${available}`
-        : `No provider named "${providerPart}". Create one with /provider new`
-    );
-  }
-  
-  return modelPart ? `${match.name}:${modelPart}` : match.name;
-}
-
-// =============================================================================
-// QUOTE SERIALIZATION
-// =============================================================================
-
-interface EditableQuote extends Quote {
-  _delete?: boolean;
-}
-
-interface EditableQuoteData {
-  quotes: EditableQuote[];
-}
-
-export function quotesToYAML(quotes: Quote[]): string {
-  const data: EditableQuoteData = {
-    quotes: quotes.map(q => ({
-      ...q,
-      _delete: false,
-    })),
-  };
-  
-  return YAML.stringify(data, {
-    lineWidth: 0,
-  });
-}
-
-export interface QuotesYAMLResult {
-  quotes: Quote[];
-  deletedQuoteIds: string[];
-}
-
-export function quotesFromYAML(yamlContent: string): QuotesYAMLResult {
-  const data = YAML.parse(yamlContent) as EditableQuoteData;
-  
-  const deletedQuoteIds: string[] = [];
-  const quotes: Quote[] = [];
-  
-  for (const q of data.quotes ?? []) {
-    if (q._delete) {
-      deletedQuoteIds.push(q.id);
-    } else {
-      const { _delete, ...quote } = q;
-      quotes.push(quote);
-    }
-  }
-  
-  return {
-    quotes,
-    deletedQuoteIds,
-  };
-}
-
-
-// =============================================================================
-// PROVIDER ACCOUNT SERIALIZATION
-// =============================================================================
-
-interface EditableModelData {
-  name: string;
-  token_limit?: number;
-  max_output_tokens?: number;
-  _delete?: boolean;
-}
-
-interface EditableProviderData {
-  name: string;
-  type: "llm" | "storage";
-  url: string;
-  api_key?: string;
-  default_model?: string;
-  token_limit?: number | null;
-  extra_headers?: Record<string, string>;
-  enabled?: boolean;
-  models?: EditableModelData[];
-  _delete?: boolean;
-}
-
-export interface ProviderYAMLResult {
-  account: ProviderAccount;
-  _delete: boolean;
-}
-
-function resolveEnvVar(value: string | undefined): string | undefined {
-  if (!value || !value.startsWith("$")) return value;
-  const varName = value.slice(1);
-  return process.env[varName] || value;
-}
-
-const PLACEHOLDER_PROVIDER_NAME = "My Provider";
-const PLACEHOLDER_PROVIDER_URL = "https://api.example.com/v1";
-const PLACEHOLDER_PROVIDER_API_KEY = "your-api-key-or-$ENVAR";
-const PLACEHOLDER_PROVIDER_DEFAULT_MODEL = "model-name";
-
-/**
- * Generate YAML template for a NEW provider account
- */
-export function newProviderToYAML(name?: string): string {
-  const placeholderData = {
-    name: name ?? PLACEHOLDER_PROVIDER_NAME,
-    type: "llm",
-    url: PLACEHOLDER_PROVIDER_URL,
-    api_key: PLACEHOLDER_PROVIDER_API_KEY,
-    default_model: PLACEHOLDER_PROVIDER_DEFAULT_MODEL,
-    token_limit: null,
-    extra_headers: {},
-    enabled: true,
-  };
-
-  const modelsYAML = [
-    "models:",
-    "  - name: (default)",
-    "    # _delete: true",
-    "# _delete: true   # Delete this entire provider",
-  ].join("\n");
-
-  return YAML.stringify(placeholderData, { lineWidth: 0 }).trimEnd() + "\n" + modelsYAML + "\n";
-}
-
-/**
- * Parse YAML for a NEW provider account
- */
-export function newProviderFromYAML(yamlContent: string): ProviderAccount {
-  const cleaned = yamlContent
-    .split('\n')
-    .filter(line => !/^\s*#/.test(line))
-    .join('\n');
-  const data = YAML.parse(cleaned) as EditableProviderData;
-  
-  if (!data.name || data.name === PLACEHOLDER_PROVIDER_NAME) {
-    throw new Error("Provider name is required");
-  }
-  if (!data.url || data.url === PLACEHOLDER_PROVIDER_URL) {
-    throw new Error("Provider URL is required");
-  }
-  if (data.api_key === PLACEHOLDER_PROVIDER_API_KEY) {
-    data.api_key = undefined;
-  }
-  if (data.default_model === PLACEHOLDER_PROVIDER_DEFAULT_MODEL) {
-    data.default_model = undefined;
-  }
-  
-  if (data.token_limit !== undefined && data.token_limit !== null && (typeof data.token_limit !== "number" || isNaN(data.token_limit))) {
-    throw new Error(`token_limit must be a number (got: ${JSON.stringify(data.token_limit)}). Note: underscore separators (100_000) are not valid in YAML.`);
-  }
-
-  // Parse models: filter out _delete:true items
-  const models = parseModels(data.models ?? []);
-
-  return {
-    id: crypto.randomUUID(),
-    name: data.name,
-    type: (data.type === "storage" ? "storage" : "llm") as ProviderType,
-    url: data.url,
-    api_key: resolveEnvVar(data.api_key),
-    default_model: data.default_model,
-    token_limit: data.token_limit ?? undefined,
-    extra_headers: data.extra_headers && Object.keys(data.extra_headers).length > 0 ? data.extra_headers : undefined,
-    enabled: data.enabled ?? true,
-    models: models.length > 0 ? models : undefined,
-    created_at: new Date().toISOString(),
-  };
-}
-
-/**
- * Parse EditableModelData[] into ModelConfig[], generating new GUIDs for models without one.
- * Filters out models with _delete: true.
- */
-function parseModels(editableModels: EditableModelData[]): import('../../../src/core/types.js').ModelConfig[] {
-  const result: import('../../../src/core/types.js').ModelConfig[] = [];
-  for (const m of editableModels) {
-    if (m._delete) continue;
-    result.push({
-      id: crypto.randomUUID(),
-      name: m.name,
-      token_limit: m.token_limit,
-      max_output_tokens: m.max_output_tokens,
-    });
-  }
-  return result;
-}
-/**
- * Serialize existing provider account to YAML for editing.
- * Shows models[] as a nested section with _delete comments.
- * Hides internal fields: id, total_calls, total_tokens_in, total_tokens_out, last_used.
- */
-export function providerToYAML(account: ProviderAccount): string {
-  const defaultModelDisplay = account.default_model
-    ? modelGuidToDisplay(account.default_model, [account])
-    : undefined;
-
-  const topData = {
-    name: account.name,
-    type: account.type as "llm" | "storage",
-    url: account.url,
-    api_key: account.api_key,
-    default_model: defaultModelDisplay,
-    token_limit: account.token_limit ?? null,
-    extra_headers: account.extra_headers,
-    enabled: account.enabled ?? true,
-  };
-
-  const topYAML = YAML.stringify(topData, { lineWidth: 0 }).trimEnd();
-
-  const modelLines: string[] = ["models:"];
-  const modelList = account.models ?? [];
-  if (modelList.length > 0) {
-    for (const m of modelList) {
-      modelLines.push(`  - name: ${m.name}`);
-      if (m.token_limit !== undefined) {
-        modelLines.push(`    token_limit: ${m.token_limit}`);
-      }
-      if (m.max_output_tokens !== undefined) {
-        modelLines.push(`    max_output_tokens: ${m.max_output_tokens}`);
-      }
-      modelLines.push(`    _delete: false`);
-    }
-  } else {
-    modelLines.push("  - name: (default)");
-    modelLines.push("    _delete: false");
-  }
-  modelLines.push("_delete: false   # Set to true to delete this entire provider");
-
-  return topYAML + "\n" + modelLines.join("\n") + "\n";
-}
-
-/**
- * Parse YAML for an existing provider account (preserves id and created_at).
- * Returns { account, _delete } where _delete signals the entire provider should be removed.
- * Model _delete flags cause individual models to be removed.
- * Preserves model GUIDs on round-trip; generates new GUIDs for new models.
- */
-export function providerFromYAML(yamlContent: string, original: ProviderAccount): ProviderYAMLResult {
-  // Strip comment lines before parsing (they encode _delete hints)
-  const cleaned = yamlContent
-    .split('\n')
-    .filter(line => !/^\s*#/.test(line))
-    .join('\n');
-  const data = YAML.parse(cleaned) as EditableProviderData;
-  
-  if (!data.name) {
-    throw new Error("Provider name is required");
-  }
-  if (!data.url) {
-    throw new Error("Provider URL is required");
-  }
-  
-  if (data.token_limit !== undefined && data.token_limit !== null && (typeof data.token_limit !== "number" || isNaN(data.token_limit))) {
-    throw new Error(`token_limit must be a number (got: ${JSON.stringify(data.token_limit)}). Note: underscore separators (100_000) are not valid in YAML.`);
-  }
-
-  // Root-level _delete → signal deletion of entire provider
-  if (data._delete) {
-    return {
-      account: original,
-      _delete: true,
-    };
-  }
-
-  // Parse models: preserve existing GUIDs by name match, generate new GUIDs for new models
-  const existingModels = original.models ?? [];
-  const parsedModels: import('../../../src/core/types.js').ModelConfig[] = [];
-  for (const m of data.models ?? []) {
-    if (m._delete) continue;
-    const existing = existingModels.find(em => em.name === m.name);
-    parsedModels.push({
-      id: existing?.id ?? crypto.randomUUID(),
-      name: m.name,
-      token_limit: m.token_limit,
-      max_output_tokens: m.max_output_tokens,
-      // Preserve usage counters from original if model matched
-      total_calls: existing?.total_calls,
-      total_tokens_in: existing?.total_tokens_in,
-      total_tokens_out: existing?.total_tokens_out,
-      last_used: existing?.last_used,
-    });
-  }
-
-  const account: ProviderAccount = {
-    id: original.id,
-    name: data.name,
-    type: (data.type === "storage" ? "storage" : "llm") as ProviderType,
-    url: data.url,
-    api_key: resolveEnvVar(data.api_key),
-    default_model: data.default_model,
-    token_limit: data.token_limit ?? undefined,
-    extra_headers: data.extra_headers && Object.keys(data.extra_headers).length > 0 ? data.extra_headers : undefined,
-    enabled: data.enabled ?? true,
-    models: parsedModels.length > 0 ? parsedModels : undefined,
-    created_at: original.created_at,
-  };
-
-  return { account, _delete: false };
-}
-
-// =============================================================================
-// GUID <-> DISPLAY NAME HELPERS
-// =============================================================================
-
-/**
- * Convert a model GUID to "ProviderName:modelName" display string.
- * Falls back to the raw GUID if the model is not found.
- */
-export function modelGuidToDisplay(guid: string, accounts: ProviderAccount[]): string {
-  for (const account of accounts) {
-    const model = (account.models ?? []).find(m => m.id === guid);
-    if (model) return `${account.name}:${model.name}`;
-  }
-  return guid; // fallback: return raw GUID if not found
-}
-
-/**
- * Resolve "ProviderName:modelName" display string back to a model GUID.
- * Returns undefined if no matching provider+model is found.
- * Handles colons in model names by treating everything after the first colon as the model name.
- */
-export function displayToModelGuid(display: string, accounts: ProviderAccount[]): string | undefined {
-  const colonIdx = display.indexOf(':');
-  if (colonIdx < 0) return undefined;
-  const providerName = display.substring(0, colonIdx);
-  const modelName = display.substring(colonIdx + 1);
-  const account = accounts.find(a => a.name === providerName);
-  const model = (account?.models ?? []).find(m => m.name === modelName);
-  return model?.id;
-}
-
-// =============================================================================
-// CONTEXT / MESSAGE SERIALIZATION
-// =============================================================================
-
-function getContent(m: { content?: string; verbal_response?: string; action_response?: string }): string {
-  if (m.content) return m.content;
-  const parts: string[] = [];
-  if (m.action_response) parts.push(`_${m.action_response}_`);
-  if (m.verbal_response) parts.push(m.verbal_response);
-  return parts.join('\n\n');
-}
-
-interface EditableMessage {
-  id: string;
-  role: "human" | "system";
-  timestamp: string;
-  context_status: ContextStatus;
-  _delete?: boolean;
-  // content | silence_reason
-  content?: string;
-  silence_reason?: string;
-}
-
-export function contextToYAML(messages: Message[]): string {
-  const header = [
-    "# context_status: default | always | never",
-    "# _delete: true — permanently removes the message",
-    "# content | silence_reason",
-  ].join("\n");
-
-  const data: EditableMessage[] = messages.map((m) => ({
-    id: m.id,
-    role: m.role,
-    timestamp: m.timestamp,
-    context_status: m.context_status,
-    _delete: false,
-    content: getContent(m) || undefined,
-    silence_reason: m.silence_reason,
-  }));
-
-  return header + "\n" + YAML.stringify(data, { lineWidth: 0 });
-}
-
-export interface ContextYAMLResult {
-  messages: Array<{ id: string; context_status: ContextStatus }>;
-  deletedMessageIds: string[];
-}
-
-export function contextFromYAML(yamlContent: string): ContextYAMLResult {
-  const data = YAML.parse(yamlContent) as EditableMessage[];
-
-  const deletedMessageIds: string[] = [];
-  const messages: Array<{ id: string; context_status: ContextStatus }> = [];
-
-  for (const m of data ?? []) {
-    if (m._delete) {
-      deletedMessageIds.push(m.id);
-    } else {
-      const normalized = (m.context_status ?? 'default').toString().toLowerCase() as ContextStatus;
-      messages.push({ id: m.id, context_status: normalized });
-    }
-  }
-
-  return { messages, deletedMessageIds };
-}
-
-
-// =============================================================================
-// QUEUE ITEM YAML
-// =============================================================================
-
-interface EditableQueueItem {
-  id: string;
-  state: LLMRequestState;
-  created_at: string;
-  attempts: number;
-  last_attempt?: string;
-  retry_after?: string;
-  type?: string;
-  priority?: LLMPriority;
-  next_step?: string;
-  model?: string;
-  data?: Record<string, unknown>;
-  _delete?: boolean;
-}
-
-export function queueItemsToYAML(items: LLMRequest[], accounts: ProviderAccount[]): string {
-  const data: EditableQueueItem[] = items.map(item => ({
-    id: item.id,
-    _delete: false,
-    state: item.state,
-    created_at: item.created_at,
-    attempts: item.attempts,
-    last_attempt: item.last_attempt,
-    retry_after: item.retry_after,
-    type: item.type,
-    priority: item.priority,
-    next_step: item.next_step,
-    model: item.model ? modelGuidToDisplay(item.model, accounts) : undefined,
-    data: item.data,
-    // NOTE: system/user prompts omitted (large); to requeue: set state='pending', attempts=0
-  }));
-  return YAML.stringify(data, { lineWidth: 0 });
-}
-
-export interface QueueItemUpdate {
-  id: string;
-  state: LLMRequestState;
-  attempts: number;
-  model?: string;
-  priority?: LLMPriority;
-  data?: Record<string, unknown>;
-}
-
-export interface QueueItemsYAMLResult {
-  updates: QueueItemUpdate[];
-  deletedIds: string[];
-}
-
-export function queueItemsFromYAML(yamlContent: string, accounts: ProviderAccount[]): QueueItemsYAMLResult {
-  const data = YAML.parse(yamlContent) as EditableQueueItem[];
-  if (!Array.isArray(data)) throw new Error("Expected a YAML array of queue items");
-
-  const deletedIds: string[] = [];
-  const updates: QueueItemUpdate[] = [];
-
-  for (const item of data) {
-    if (!item.id) throw new Error(`Queue item missing 'id' field`);
-    if (item._delete) {
-      deletedIds.push(item.id);
-      continue;
-    }
-    if (!item.state) throw new Error(`Queue item ${item.id} missing 'state' field`);
-    const validStates: LLMRequestState[] = ["pending", "processing", "dlq"];
-    if (!validStates.includes(item.state)) {
-      throw new Error(`Queue item ${item.id} has invalid state '${item.state}'. Valid: ${validStates.join(", ")}`);
-    }
-    updates.push({
-      id: item.id,
-      state: item.state,
-      attempts: typeof item.attempts === "number" ? item.attempts : 0,
-      model: item.model ? displayToModelGuid(item.model, accounts) ?? item.model : undefined,
-      priority: item.priority,
-      data: item.data,
-    });
-  }
-
-  return { updates, deletedIds };
-}
-
-// =============================================================================
-// TOOLKIT (ToolProvider) SERIALIZATION
-// =============================================================================
-
-interface EditableToolkitData {
-  display_name: string;
-  enabled: boolean;
-  config: Record<string, string>;
-  tools?: Record<string, boolean>;
-}
-
-/**
- * Serialize a ToolProvider + its tools to YAML for editing.
- * Shows config keys and per-tool enable toggles.
- */
-export function toolkitToYAML(provider: ToolProvider, tools: ToolDefinition[]): string {
-  const toolsMap = tools.length > 0
-    ? Object.fromEntries(tools.map(t => [t.display_name, t.enabled]))
-    : undefined;
-  if (provider.builtin) {
-    return YAML.stringify({ enabled: provider.enabled, tools: toolsMap }, { lineWidth: 0 });
-  }
-  const data: EditableToolkitData = {
-    display_name: provider.display_name,
-    enabled: provider.enabled,
-    config: { ...provider.config },
-    tools: toolsMap,
-  };
-  return YAML.stringify(data, { lineWidth: 0 });
-}
-
-export interface ToolkitYAMLResult {
-  updates: Partial<Omit<ToolProvider, 'id' | 'created_at'>>;
-  toolUpdates: Array<{ id: string; enabled: boolean }>;
-}
-
-/**
- * Parse edited YAML back into ToolProvider updates + per-tool enable changes.
- */
-export function toolkitFromYAML(yamlContent: string, original: ToolProvider, tools: ToolDefinition[]): ToolkitYAMLResult {
-  const data = YAML.parse(yamlContent) as EditableToolkitData;
-
-  if (!data.display_name) {
-    if (!original.display_name) throw new Error("display_name is required");
-    data.display_name = original.display_name;
-  }
-
-  const updates: Partial<Omit<ToolProvider, 'id' | 'created_at'>> = {
-    display_name: data.display_name,
-    enabled: data.enabled ?? original.enabled,
-    config: data.config ?? {},
-  };
-
-  const toolUpdates: Array<{ id: string; enabled: boolean }> = [];
-  if (data.tools) {
-    for (const [displayName, enabled] of Object.entries(data.tools)) {
-      const tool = tools.find(t => t.display_name === displayName);
-      if (tool) toolUpdates.push({ id: tool.id, enabled: Boolean(enabled) });
-    }
-  }
-
-  return { updates, toolUpdates };
-}
-
-// =============================================================================
-// PERSONA PREVIEW SERIALIZATION (from-person generation flow)
-// =============================================================================
-
-/**
- * YAML template for the first editor step in /persona new — description input.
- */
-export function descriptionEntryToYAML(personaName: string): string {
-  return `# New Persona: ${personaName}
-# Describe who this persona is. This will be used to generate traits and topics.
-# Save to generate • :q to cancel.
-
-description: |
-  
-`;
-}
-
-/**
- * Parse the description entry YAML.
- */
-export function descriptionFromYAML(content: string): { description: string; relationship?: string } {
-  const data = YAML.parse(content) as { description?: string; relationship?: string };
-  if (!data) throw new Error("Failed to parse YAML");
-
-  const description = (data.description ?? "").replace(/\n/g, " ").trim();
-  const relationship = data.relationship?.trim() || undefined;
-
-  return { description, relationship };
-}
-
-/**
- * YAML template for the traits/topics review editor step.
- */
-export function personaPreviewToYAML(
-  preview: import('../../../src/prompts/generation/types.js').PersonaGenerationResult,
-  personaName: string,
-  personName?: string,
-  previousLongDescription?: string
-): string {
-  const normalizeLine = (s: string) => s.replace(/\n/g, ' ').trim();
-
-  const headerLines: string[] = [
-    `# Persona Preview: ${personaName}`,
-  ];
-  if (personName) {
-    headerLines.push(`# Source: ${personName}`);
-  }
-  headerLines.push(`# Edit or delete entries. Save or quit to apply • :cq to cancel.`);
-  headerLines.push(``);
-  if (previousLongDescription) {
-    headerLines.push(`# Previously: ${normalizeLine(previousLongDescription)}`);
-  }
-
-  const longDescYAML = `long_description: ${JSON.stringify(normalizeLine(preview.long_description))}`;
-  const shortDescYAML = `short_description: ${JSON.stringify(normalizeLine(preview.short_description ?? ''))}`;
-  const aliasesLine = (preview.aliases && preview.aliases.length > 0)
-    ? `aliases: ${preview.aliases.join(', ')}`
-    : null;
-
-  const traitsYAML = YAML.stringify(
-    { traits: preview.traits.map(t => ({
-      name: t.name,
-      description: t.description,
-      sentiment: Math.round(t.sentiment * 100) / 100,
-      strength: Math.round(t.strength * 100) / 100,
-    }))},
-    { lineWidth: 0 }
-  );
-
-  const topicsYAML = YAML.stringify(
-    { topics: preview.topics.map(t => ({
-      name: t.name,
-      perspective: t.perspective,
-      approach: t.approach,
-      personal_stake: t.personal_stake,
-      sentiment: Math.round(t.sentiment * 100) / 100,
-      exposure_current: Math.round(t.exposure_current * 100) / 100,
-      exposure_desired: Math.round(t.exposure_desired * 100) / 100,
-    }))},
-    { lineWidth: 0 }
-  );
-
-  return [
-    headerLines.join('\n'),
-    longDescYAML,
-    shortDescYAML,
-    ...(aliasesLine ? [aliasesLine] : []),
-    traitsYAML.trimEnd(),
-    topicsYAML.trimEnd(),
-    '',
-  ].join('\n');
-}
-
-interface PreviewYAMLData {
-  long_description?: string;
-  short_description?: string;
-  traits?: Array<{
-    name: string;
-    description: string;
-    sentiment?: number;
-    strength?: number;
-  }>;
-  topics?: Array<{
-    name: string;
-    perspective: string;
-    approach: string;
-    personal_stake: string;
-    sentiment?: number;
-    exposure_current?: number;
-    exposure_desired?: number;
-  }>;
-}
-
-/**
- * Parse the preview YAML back into traits/topics with generated IDs.
- */
-export function personaPreviewFromYAML(content: string): { long_description: string; short_description?: string; aliases?: string[]; traits: PersonaTrait[]; topics: PersonaTopic[] } {
-  const data = YAML.parse(content) as PreviewYAMLData & { aliases?: string };
-  if (!data) throw new Error("Failed to parse YAML");
-
-  const long_description = (data.long_description ?? "").replace(/\n/g, ' ').trim();
-  const short_description = data.short_description?.replace(/\n/g, ' ').trim() || undefined;
-
-  const traits: PersonaTrait[] = (data.traits ?? []).map(t => ({
-    id: crypto.randomUUID(),
-    name: t.name,
-    description: t.description,
-    sentiment: t.sentiment ?? 0,
-    strength: t.strength ?? 0.5,
-    last_updated: new Date().toISOString(),
-  }));
-
-  const topics: PersonaTopic[] = (data.topics ?? []).map(t => ({
-    id: crypto.randomUUID(),
-    name: t.name,
-    perspective: t.perspective,
-    approach: t.approach,
-    personal_stake: t.personal_stake,
-    sentiment: t.sentiment ?? 0,
-    exposure_current: t.exposure_current ?? 0.5,
-    exposure_desired: t.exposure_desired ?? 0.5,
-    last_updated: new Date().toISOString(),
-  }));
-
-  const aliases = data.aliases
-    ? data.aliases.split(',').map((s: string) => s.trim()).filter(Boolean)
-    : undefined;
-
-  return { long_description, short_description, aliases, traits, topics };
-}
+export * from "./yaml-shared.js";
+export * from "./yaml-human.js";
+export * from "./yaml-persona.js";
+export * from "./yaml-settings.js";
+export * from "./yaml-provider.js";
+export * from "./yaml-quotes.js";
+export * from "./yaml-context.js";
+export * from "./yaml-queue.js";
+export * from "./yaml-toolkit.js";