md / _PRD / framework / assistant-system.md
Molino⺢Pro

assistant-system

Master Codebase Guidebook
Markdown + HTML Dev-Docs Renderer - Frontend Client Module

Default Index
Open README.md
Root: README.mdframework
Milestones
⬆ Parent folder📁 archive📁 seeds📝 16DecTuesdayWeekGoals📝 20260320_molino_mlv_mvp_brief📝 20260416_molino-guidebook📝 20260418_FastProductionSAP_MLV📝 20260420_molino.architecture📝 assistant-system📝 dev-prompts📝 README
H1Assistant System

Status: schema-backed AI orchestration layer with route-aware surface registry.

The assistant system already exists in Prisma and should be documented as a structured orchestration layer, not as app truth.

H2Schema entities
  • AssistantThread
  • AssistantMessage
  • AIContext
  • AIPersona
H2Role
  • manage structured assistant conversations
  • route assistant behavior by persona and context
  • support drafting, planning, and content generation
H2Rule
  • AI does not mutate domain entities directly.
  • AI emits structured outputs and intents only.
  • server actions own persistence.
H2Practical use
  • document drafting
  • trip planning support
  • content generation
  • structured guidance for operators
H2Route-aware registry

Assistant UI should now resolve through the shared registry in app/assistant/registry/ and app/assistant/core/resolveAssistantSurface.ts.

  • assistantSurfaceRegistry maps route domains to default mode, surface, pipeline, tools, adapter, and prompt policy.
  • assistantToolRegistry keeps sidebar tool keys stable across documents, trips, ideas, and future domains.
  • AssistantPanel is the shared client chat/settings shell for sidebar, inline, and floating-dock surfaces.
  • Domain adapters still own behavior: document prompts use applyAssistantToDocument, trip prompts use the structured trip planner actions, and ideas use the traceable IdeaRepo flow.

The registry is a wrapper layer, not a new authority. Existing server actions remain the only place that can persist domain changes.

H2Model path

Model IDs are now centralized through app/assistant/lib/modelRegistry.ts.

  • compat preserves gpt-4.1.
  • frontier points to gpt-5.5.
  • balanced points to gpt-5.4.
  • fast points to gpt-5.4-mini.
  • cheap points to gpt-5.4-nano.

The default remains compatibility-first until each route chooses a profile deliberately.

H2Session Note - 2026-04-29

Implemented the first non-destructive assistant standardization pass:

  • added route-aware assistant surface and tool registries
  • completed MODE_CATALOG as lifecycle/authority metadata while preserving MODE_REGISTRY
  • added the shared AssistantPanel shell
  • adapted document and trip assistant panels to use the shared shell without changing their server-action authority
  • routed ideas through the shared Responses API wrapper while preserving IdeaRepo persistence