menuyukti-agents
LangGraph agents app (apps/agents): FastAPI, milestone run (preset subgraphs + eval), streaming chat ReAct, graphql_post. Use when adding preset graphs, routers, or agents-side GraphQL clients.
SKILL.md.agents/skills/menuyukti-agents/SKILL.md
GitHubMenuyukti: apps/agents
Python FastAPI service: LangChain / LangGraph and streaming chat. POST /milestones/{id}/run runs: fetch milestone context → dedicated preset subgraph (by milestone.data.presetId) → shared eval graph. Agents call GraphQL over HTTP only.
For monorepo boundaries and pnpm vs uv, see menuyukti-repo-orientation.
Companion skills
When implementing in apps/agents, follow these skills in addition to this doc and .cursor/rules/langgraph.mdc / .cursor/rules/langchain.mdc:
langgraph-fundamentals— LangGraph: graphs, state, nodes, streaming, Command, Send.langchain-fundamentals— LangChain agents, tools, middleware.python-design-patterns— Structure, layering, composition.
Layout
| Area | Path | Role |
|---|---|---|
| Milestone run | apps/agents/agents/core/milestone_run/ |
Outer graph, presets/registry.py, per-preset subgraphs, SSE streaming. |
| Milestone eval | apps/agents/agents/core/milestone_eval/ |
Criterion Send fan-out + synthesis; invoked from finalize_eval only. |
| Milestone data | apps/agents/agents/core/milestone_data/ |
GraphQL upsert for milestonedata JSON. |
| LLM helpers | apps/agents/agents/core/llm_invoke.py |
Retries + structured-output errors for preset/eval nodes. |
| Chat | apps/agents/agents/core/chat/ |
create_react_agent + checkpointer; CHAT_RECURSION_LIMIT. |
| Format MD | apps/agents/agents/core/format_markdown/ |
Preset-driven Markdown cleanup (POST /format-markdown). |
| Routers | apps/agents/routers/ |
FastAPI routes (chat, milestone_run, format-markdown, …). |
| GraphQL helper | apps/agents/agents/graphql_base.py |
graphql_post (with retry on transient failures). |
| Tests | apps/agents/tests/core/ |
Pytest for graphs, eval fan-in, stream adapter. |
Commands and ports: AGENTS.md.
Registered milestone presets
These presetId values must stay aligned with web MILESTONE_PRESET_IDS and register_preset_runner in graph.py:
presetId |
Subgraph module |
|---|---|
dates |
dates/ |
restaurant_campaign_brief |
campaign_brief/ |
promotion_candidates |
promotion_candidates/ |
menu_tagger |
menu_tagger/ |
menu_clusterer |
menu_clusterer/ |
culture_hooks |
culture_hooks/ |
ig_profile |
ig_profile/ |
ig_plan |
ig_plan/ |
ig_menu_picker |
ig_menu_picker/ |
ig_format |
ig_format/ |
ig_text |
ig_text/ |
scheduler |
scheduler/ |
Adding a preset
- Create
milestone_run/<preset_id>/withgraph.py,nodes.py,state.py,prompts.py(and tests undertests/core/test_<preset>_graph.py). - Register
build_<preset>_graphrunner ingraph.pyviaregister_preset_runner(preset_id, _run_<preset>). - Add eval helpers in
milestone_eval/<preset>_eval.pyif deterministic criterion checks apply. - Extend
output_schema.pyforvalidate_skill_output. - Use
structured_ainvoke_from_run_configfor LLM structured output (retries built in). - Web — add to
MILESTONE_PRESET_IDS,preset-definitions.ts, and preview / timeline UI components.
Legacy make_milestone_run_tools remains for unit tests only; production runs do not use ReAct tool loops.
Tracing and run persistence
- LangSmith:
LANGCHAIN_TRACING_V2,LANGCHAIN_API_KEY, optionalLANGCHAIN_PROJECT; run metadata includesmilestone_id,workflow_id,run_id. - Product DB:
startMilestoneAgentRun/completeMilestoneAgentRunon GraphQL (milestone_agent_runtable). - Distributed traces: web BFF forwards
traceparentto agents when present.
See apps/agents/README.md for env vars.
Checklist (agents-only)
graphql_post— env and headers ingraphql_base.py.- New preset — subgraph module +
register_preset_runner+ GraphQL client helpers if needed. - Persistence — preset
persist_result→milestone_dataupsert /validate_skill_output. - Tests — graph smoke tests + eval fan-in when touching
milestone_eval/graph.py.
Related
| Topic | Skill |
|---|---|
| GraphQL schema | menuyukti-graphql |
| Web UI | menuyukti-web |
| Analytics package | menuyukti-analytics |
| Monorepo map | menuyukti-repo-orientation |