deepseek-harness/docs/graphs/package-topology.md

Package Topology By Group

Maintenance mode: generated from packages/*/*/package.json peer dependencies plus package group paths.

This graph complements module-graph.md: it keeps the same canonical peer-dependency edge source, but clusters packages by the packages/<group>/<pkg> hierarchy so layering and capability families are easier to scan.

flowchart TD
  subgraph group_util["packages/util"]
    pkg_brand["brand"]
  end
  subgraph group_llm["packages/llm"]
    pkg_llm["llm"]
    pkg_llm_deepseek["llm-deepseek"]
    pkg_llm_pi_ai["llm-pi-ai"]
  end
  subgraph group_core["packages/core"]
    pkg_agent["agent"]
    pkg_agent_core["agent-core"]
    pkg_agent_loop["agent-loop"]
    pkg_session["session"]
    pkg_system_prompt["system-prompt"]
    pkg_tools["tools"]
  end
  subgraph group_bash["packages/bash"]
    pkg_bash["bash"]
    pkg_bash_local["bash-local"]
    pkg_tool_bash["tool-bash"]
  end
  subgraph group_compact["packages/compact"]
    pkg_compact["compact"]
    pkg_compact_basic["compact-basic"]
  end
  subgraph group_subagent["packages/subagent"]
    pkg_subagent["subagent"]
    pkg_subagent_acp["subagent-acp"]
    pkg_subagent_fork["subagent-fork"]
    pkg_subagent_inprocess["subagent-inprocess"]
    pkg_subagent_spawn["subagent-spawn"]
    pkg_tool_subagent["tool-subagent"]
  end
  subgraph group_session_persistence["packages/session-persistence"]
    pkg_session_persistence["session-persistence"]
    pkg_session_persistence_jsonl["session-persistence-jsonl"]
    pkg_session_persistence_sqlite["session-persistence-sqlite"]
  end
  subgraph group_todo["packages/todo"]
    pkg_tool_todo["tool-todo"]
  end
  subgraph group_support["packages/support"]
    pkg_invariants["invariants"]
    pkg_llm_replay["llm-replay"]
    pkg_subagent_mock["subagent-mock"]
    pkg_ui_stdio["ui-stdio"]
  end
  subgraph group_ui["packages/ui"]
    pkg_acp["acp"]
    pkg_acp_agent["acp-agent"]
    pkg_stdio_agent["stdio-agent"]
  end
  pkg_llm --> pkg_brand
  pkg_bash --> pkg_brand
  pkg_llm_deepseek --> pkg_llm
  pkg_llm_pi_ai --> pkg_llm
  pkg_session --> pkg_brand
  pkg_session --> pkg_llm
  pkg_system_prompt --> pkg_llm
  pkg_bash_local --> pkg_bash
  pkg_agent --> pkg_brand
  pkg_agent --> pkg_llm
  pkg_agent --> pkg_session
  pkg_compact --> pkg_llm
  pkg_compact --> pkg_session
  pkg_session_persistence --> pkg_session
  pkg_llm_replay --> pkg_llm
  pkg_llm_replay --> pkg_session
  pkg_tools --> pkg_agent
  pkg_tools --> pkg_llm
  pkg_tools --> pkg_system_prompt
  pkg_compact_basic --> pkg_agent
  pkg_compact_basic --> pkg_compact
  pkg_compact_basic --> pkg_llm
  pkg_compact_basic --> pkg_session
  pkg_session_persistence_jsonl --> pkg_session
  pkg_session_persistence_jsonl --> pkg_session_persistence
  pkg_session_persistence_sqlite --> pkg_session
  pkg_session_persistence_sqlite --> pkg_session_persistence
  pkg_invariants --> pkg_agent
  pkg_invariants --> pkg_llm
  pkg_invariants --> pkg_session
  pkg_ui_stdio --> pkg_agent
  pkg_ui_stdio --> pkg_llm
  pkg_ui_stdio --> pkg_session
  pkg_agent_loop --> pkg_agent
  pkg_agent_loop --> pkg_llm
  pkg_agent_loop --> pkg_session
  pkg_agent_loop --> pkg_session_persistence
  pkg_agent_loop --> pkg_system_prompt
  pkg_agent_loop --> pkg_tools
  pkg_tool_bash --> pkg_agent
  pkg_tool_bash --> pkg_bash
  pkg_tool_bash --> pkg_llm
  pkg_tool_bash --> pkg_tools
  pkg_subagent --> pkg_agent
  pkg_subagent --> pkg_llm
  pkg_subagent --> pkg_tools
  pkg_tool_todo --> pkg_agent
  pkg_tool_todo --> pkg_session
  pkg_tool_todo --> pkg_tools
  pkg_acp --> pkg_agent
  pkg_acp --> pkg_llm
  pkg_acp --> pkg_session
  pkg_acp --> pkg_session_persistence
  pkg_acp --> pkg_tools
  pkg_agent_core --> pkg_agent
  pkg_agent_core --> pkg_agent_loop
  pkg_agent_core --> pkg_invariants
  pkg_agent_core --> pkg_llm
  pkg_agent_core --> pkg_session
  pkg_agent_core --> pkg_system_prompt
  pkg_agent_core --> pkg_tool_bash
  pkg_agent_core --> pkg_tools
  pkg_subagent_acp --> pkg_agent
  pkg_subagent_acp --> pkg_llm
  pkg_subagent_acp --> pkg_subagent
  pkg_subagent_inprocess --> pkg_agent
  pkg_subagent_inprocess --> pkg_llm
  pkg_subagent_inprocess --> pkg_session
  pkg_subagent_inprocess --> pkg_subagent
  pkg_tool_subagent --> pkg_agent
  pkg_tool_subagent --> pkg_llm
  pkg_tool_subagent --> pkg_subagent
  pkg_tool_subagent --> pkg_tools
  pkg_subagent_mock --> pkg_agent
  pkg_subagent_mock --> pkg_llm
  pkg_subagent_mock --> pkg_subagent
  pkg_subagent_fork --> pkg_agent
  pkg_subagent_fork --> pkg_session
  pkg_subagent_fork --> pkg_subagent
  pkg_subagent_fork --> pkg_subagent_inprocess
  pkg_subagent_spawn --> pkg_subagent
  pkg_subagent_spawn --> pkg_subagent_inprocess
  pkg_acp_agent --> pkg_acp
  pkg_acp_agent --> pkg_agent_core
  pkg_acp_agent --> pkg_session_persistence_jsonl
  pkg_stdio_agent --> pkg_agent
  pkg_stdio_agent --> pkg_agent_core
  pkg_stdio_agent --> pkg_session
  pkg_stdio_agent --> pkg_session_persistence_jsonl
  pkg_stdio_agent --> pkg_ui_stdio

Package	Group	Depends on
brand	util	-
llm	llm	brand
bash	bash	brand
llm-deepseek	llm	llm
llm-pi-ai	llm	llm
session	core	brand, llm
system-prompt	core	llm
bash-local	bash	bash
agent	core	brand, llm, session
compact	compact	llm, session
session-persistence	session-persistence	session
llm-replay	support	llm, session
tools	core	agent, llm, system-prompt
compact-basic	compact	agent, compact, llm, session
session-persistence-jsonl	session-persistence	session, session-persistence
session-persistence-sqlite	session-persistence	session, session-persistence
invariants	support	agent, llm, session
ui-stdio	support	agent, llm, session
agent-loop	core	agent, llm, session, session-persistence, system-prompt, tools
tool-bash	bash	agent, bash, llm, tools
subagent	subagent	agent, llm, tools
tool-todo	todo	agent, session, tools
acp	ui	agent, llm, session, session-persistence, tools
agent-core	core	agent, agent-loop, invariants, llm, session, system-prompt, tool-bash, tools
subagent-acp	subagent	agent, llm, subagent
subagent-inprocess	subagent	agent, llm, session, subagent
tool-subagent	subagent	agent, llm, subagent, tools
subagent-mock	support	agent, llm, subagent
subagent-fork	subagent	agent, session, subagent, subagent-inprocess
subagent-spawn	subagent	subagent, subagent-inprocess
acp-agent	ui	acp, agent-core, session-persistence-jsonl
stdio-agent	ui	agent, agent-core, session, session-persistence-jsonl, ui-stdio